@@ -278,83 +278,83 @@ def _titration(
278278 return titrant_mass , emf , temperature , analyte_mass , totals , k_constants
279279
280280
281- def titration (
282- alkalinity ,
283- analyte_mass = 0.1 ,
284- dic = 0 ,
285- emf0 = 600 ,
286- fCO2_air = default .fCO2_air ,
287- k_dic_loss = None ,
288- salinity = 35 ,
289- temperature = 25 ,
290- titrant_mass_start = 0 ,
291- titrant_mass_step = 0.15e-3 ,
292- titrant_mass_stop = 4.2e-3 ,
293- titrant_molinity = 0.1 ,
294- least_squares_kwargs = default .least_squares_kwargs ,
295- pH_range = default .pH_range ,
296- ** pyco2sys_kwargs ,
297- ):
298- """Simulate a titration and return a calibrated and solved `Titration`.
281+ # def titration(
282+ # alkalinity,
283+ # analyte_mass=0.1,
284+ # dic=0,
285+ # emf0=600,
286+ # fCO2_air=default.fCO2_air,
287+ # k_dic_loss=None,
288+ # salinity=35,
289+ # temperature=25,
290+ # titrant_mass_start=0,
291+ # titrant_mass_step=0.15e-3,
292+ # titrant_mass_stop=4.2e-3,
293+ # titrant_molinity=0.1,
294+ # least_squares_kwargs=default.least_squares_kwargs,
295+ # pH_range=default.pH_range,
296+ # **pyco2sys_kwargs,
297+ # ):
298+ # """Simulate a titration and return a calibrated and solved `Titration`.
299299
300- Parameters
301- ----------
302- alkalinity : float
303- Total alkalinity content of the analyte in µmol/kg.
304- analyte_mass : float, optional
305- Mass of the analyte in kg, by default 0.1 kg.
306- dic : float, optional
307- Dissolved inorganic carbon of the analyte in µmol/kg, by default 0 µmol/kg.
308- emf0 : float, optional
309- EMF0 of the electrode in mV, by default 600 mV.
310- salinity : float, optional
311- Practical salinity of the analyte, by default 35.
312- temperature : float, optional
313- Temperature of the analyte in °C, by default 25 °C.
314- titrant_mass_start : float, optional
315- Mass of titrant at the start of the titration in kg, by default 0 kg.
316- titrant_mass_step : float, optional
317- Mass of each titrant addition step in kg, by default 0.15e-3 kg.
318- titrant_mass_stop : float, optional
319- Mass at which to stop the titration (exclusive) in kg, by default 4.2e-3 kg.
320- titrant_molinity : float, optional
321- Molinity of the titrant in mol/kg, by default 0.1 mol/kg.
322- least_squares_kwargs : dict, optional
323- Additional kwargs passed on to the least-squares solver.
324- pH_range : tuple, optional
325- Range of pH values to determine alkalinity within, by default (3, 4).
326- **pyco2sys_kwargs
327- Additional kwargs passed on to PyCO2SYS.
300+ # Parameters
301+ # ----------
302+ # alkalinity : float
303+ # Total alkalinity content of the analyte in µmol/kg.
304+ # analyte_mass : float, optional
305+ # Mass of the analyte in kg, by default 0.1 kg.
306+ # dic : float, optional
307+ # Dissolved inorganic carbon of the analyte in µmol/kg, by default 0 µmol/kg.
308+ # emf0 : float, optional
309+ # EMF0 of the electrode in mV, by default 600 mV.
310+ # salinity : float, optional
311+ # Practical salinity of the analyte, by default 35.
312+ # temperature : float, optional
313+ # Temperature of the analyte in °C, by default 25 °C.
314+ # titrant_mass_start : float, optional
315+ # Mass of titrant at the start of the titration in kg, by default 0 kg.
316+ # titrant_mass_step : float, optional
317+ # Mass of each titrant addition step in kg, by default 0.15e-3 kg.
318+ # titrant_mass_stop : float, optional
319+ # Mass at which to stop the titration (exclusive) in kg, by default 4.2e-3 kg.
320+ # titrant_molinity : float, optional
321+ # Molinity of the titrant in mol/kg, by default 0.1 mol/kg.
322+ # least_squares_kwargs : dict, optional
323+ # Additional kwargs passed on to the least-squares solver.
324+ # pH_range : tuple, optional
325+ # Range of pH values to determine alkalinity within, by default (3, 4).
326+ # **pyco2sys_kwargs
327+ # Additional kwargs passed on to PyCO2SYS.
328328
329- Returns
330- -------
331- calkulate.Titration
332- A self-calibrated and solved titration dataset.
333- """
334- tt = Titration (
335- salinity = salinity ,
336- analyte_mass = analyte_mass ,
337- simulate_alkalinity = alkalinity ,
338- simulate_kwargs = dict (
339- dic = dic ,
340- emf0 = emf0 ,
341- fCO2_air = fCO2_air ,
342- k_dic_loss = k_dic_loss ,
343- salinity = salinity ,
344- temperature = temperature ,
345- titrant_mass_start = titrant_mass_start ,
346- titrant_mass_step = titrant_mass_step ,
347- titrant_mass_stop = titrant_mass_stop ,
348- titrant_molinity = titrant_molinity ,
349- ** pyco2sys_kwargs ,
350- ),
351- )
352- tt .calkulate (
353- alkalinity ,
354- analyte_total_sulfate = None , # H2SO4 simulations not implemented yet
355- least_squares_kwargs = least_squares_kwargs ,
356- pH_range = pH_range ,
357- titrant_molinity_guess = titrant_molinity ,
358- titrant = "HCl" , # H2SO4 simulations not implemented yet
359- )
360- return tt
329+ # Returns
330+ # -------
331+ # calkulate.Titration
332+ # A self-calibrated and solved titration dataset.
333+ # """
334+ # tt = Titration(
335+ # salinity=salinity,
336+ # analyte_mass=analyte_mass,
337+ # simulate_alkalinity=alkalinity,
338+ # simulate_kwargs=dict(
339+ # dic=dic,
340+ # emf0=emf0,
341+ # fCO2_air=fCO2_air,
342+ # k_dic_loss=k_dic_loss,
343+ # salinity=salinity,
344+ # temperature=temperature,
345+ # titrant_mass_start=titrant_mass_start,
346+ # titrant_mass_step=titrant_mass_step,
347+ # titrant_mass_stop=titrant_mass_stop,
348+ # titrant_molinity=titrant_molinity,
349+ # **pyco2sys_kwargs,
350+ # ),
351+ # )
352+ # tt.calkulate(
353+ # alkalinity,
354+ # analyte_total_sulfate=None, # H2SO4 simulations not implemented yet
355+ # least_squares_kwargs=least_squares_kwargs,
356+ # pH_range=pH_range,
357+ # titrant_molinity_guess=titrant_molinity,
358+ # titrant="HCl", # H2SO4 simulations not implemented yet
359+ # )
360+ # return tt
0 commit comments