Frequently asked questions (FAQ)
How are fluxes calculated?
We provide details on the flux calculation approach implemented in PhysioFit in the Method section.
How many measurements should I use to calculate fluxes?
As in any model-based fitting procedure, more data usually means more accurate and precise flux estimates. The minimal number of measurements depend on the model used for flux calculation. For instance, for steady-state built-in models provided with PhysioFit, we recommend using at least 6 to 8 time points, which should provide reliable and meaningful estimates in most situations.
Still, the exact answer to this question strongly depends on the uptake/production/growth rates of your (micro)organism in the conditions you are investigating, on the sampling time interval, on the questions you are addressing, on the model used for flux calculation, and on many other parameters! You can make some tests by calculating fluxes from (published or theoretical) datasets similar to those you have in mind.
Can I calculate fluxes in case of missing values?
Yes, fluxes can still be calculated if some measurement(s) are missing. In this case, leave empty the corresponding field of the input data file.
What units should be used for input data?
Input data (biomass concentration, metabolites concentrations, and time) can be provided to PhysioFit using any unit. Still, we recommend using units for which values are as close to unity as possible to ensure numerical stability (e.g. 3 mM instead of 3.10-3 M). Importantly, units of the estimated fluxes depend on units of time and metabolites and biomass concentrations. The concentration of different metabolites can be provided using different units, but a single unit must be used for all measurements of a given metabolite.
See also
What are the flux units?
Flux units depend on the units of time and concentrations (of biomass and metabolites) provided in the input data file. For instance, if biomass units are in grams of cell dry weight by liter (gCDW/L), metabolite concentrations are in millimolar (mM) and time is in hours (h), the estimated fluxes will be in mmol/gCDW/h. Units should thus be carefully selected, and calculated fluxes must be interpreted consistently with the concentration units.
An error has been raised. What should I do?
The first thing to do is to read the error message which might contain information on how to resolve it. If not, check the FAQ section (yes, this one) to see if the error has been explained in more depth. If the error persists or if you do not understand the error, please post it in the “issues” section on GitHub. We will try to respond as quickly as possible to solve your problem.
What parameters values should I use?
Details on PhysioFit parameters can be found in the Tutorial section.
Which model should I use?
The choice of the model depends on the biological question you are addressing, the data you have, and the assumptions you are willing to make. We provide a set of models in PhysioFit, each with its own assumptions and requirements.
As a starting point, we recommend using the most relevant model based on the type of experiment you have conducted. Begin with the simplest model that fits your data and evaluate the quality of the fit based on the χ² test results and the plots of experimental vs. simulated data. If the fit is not satisfactory, you may try more complex models. However, keep in mind that more complex models often require more data, include more assumptions, and may lead to overfitting.
If different models fit your data, a good practice for comparing them is to use the AIC (Akaike Information Criterion). For more information, please refer to the section “Model comparison” from the Method page.
How can I check if my data has been fitted correctly?
The quality of the fit can be evaluated based on:
the plots of experimental vs simulated data for the best fit, which should be as close as possible,
the χ² statistical test results given in the stat ouput file (see below for help on interpreting the results).
My data hasn’t been correctly fitted. Why?
A possible reason to explain a bad fit is that standard deviations on measurements (concentration biomass and metabolites) is under-estimated, thereby making the χ² test too stringent. In this case, plots of measured and fitted data should be in agreement. Reliable estimated of standard deviation on measurements must be provided to PhysioFit (have a look to the Tutorial section to see how to check and adjust this parameter).
Another possible reason to explain a bad fit is that a key asumption of the flux calculation method is not respected. For instance, if you use a steady-state model shipped with PhysioFit, cells might not be strictly in metabolic steady-state, i.e. with constant fluxes during the whole experiment. If this key asumption does not occur (e.g. cells are continuously adapting to their environment and fluxes change over time), PhysioFit will not be able to fit the data satisfactorily. In this case, evaluate wether the deviation is significant or not (e.g. based on the detailed χ² statistics or on the plot of fitted vs measured data), and evaluate the potential biases that would be introduced by interpreting (or not) these flux values.
In rare situations, it may also be because some parameters have to be tweaked to help PhysioFit fit the measurements, which results in obviously aberrant fits (e.g. with flat time-course profiles for all metabolites). This might happen for instance if some measurements are provided in units far from unity (e.g. 1.10-5 M instead of 10 µM). If this situation happens, we suggest modifying the initial values of fluxes, or changing the units of input data, and re-run the flux calculation. For more info on the run parameters and how they may affect the fitting process, please refer to section Flux calculation parameters.
If you think the problem is in PhysioFit, we would greatly appreciate if you could open a new issue on our issue tracker.
I cannot start PhysioFit graphical user interface, can you help me?
If you installed PhysioFit following our standard procedure and that you are unable
to start PhysioFit by opening a terminal and typing physiofit, then there is indeed
something wrong. Do not panic, we are here to help!
Please follow this simple procedure:
The first step of the debugging process will be to get a traceback, i.e. a message telling us what is actually going wrong. You should see this message in the terminal you opened.
Read the traceback and try to understand what is going wrong:
If it is related to your system or your Python installation, you will need to ask some help from your local system administrator or your IT department so they could guide you toward a clean installation. Tell them that you wanted “to use the graphical user interface of PhysioFit, a Python 3.9 software” and what you did so far (installation), give them the traceback and a link toward the documentation. They should know what to do.
If you believe the problem is in PhysioFit or that your local system administrator told you so, then you probably have found a bug! We would greatly appreciate if you could open a new issue on our issue tracker.
I have trouble finding PhysioFit on the Workflow4Metabolomics Galaxy instance
To help users navigate through the Workflow4Metabolomics Galaxy instance, we have prepared a short tutorial on how to find and use PhysioFit. You can find it in the Quick start section. If you still have trouble finding PhysioFit, a search bar is available on the top left of the page. You can type “PhysioFit” in the search bar and click on the result to access the tool.
I have develop a new model, can you include it in PhysioFit distribution?
If you have developed a new flux model, we would be happy to include it in PhysioFit! Open a new issue on our issue tracker, and let’s discuss about your model and how we could include it! :)
How using PhysioFit programmatically?
Examples of how to use PhysioFit programmatically can be found in the section Test the model, which offers demonstrations on running simulations and flux calculations.
I would like a new feature.
We would be glad to improve PhysioFit. Please get in touch with us here so we could discuss your problem.