ospsuite 12.1.0
Warning: Simulations saved with this pre-release (and all versions >=12) with saveSimulation() cannot be opened with MoBi versions >12! Currently, only a non-qualified development version 12 of MoBi is available.
Major Changes
- The package fully supports Linux.
- The package loses dependency
{rClr}and gains{rSharp}. - The package does not require a local installation of PK-Sim any more. All required
dependencies are shipped with the package.
ospsuite 12.0.0
Breaking Changes
- Based on the Open Systems Pharmacology Suite v12
- The single argument of the
getBaseUnit()function is now named
quantityOrDimension(wasdimensionpreviously). It can now use objects
of classQuantityas inputs, to be consistent with thetoBaseUnit()
function.
Major Changes
- The package gains
{openxlsx}and{lifecyle}dependencies. - Added a function
getSteadyState()to calculate steady state values for
simulations. This function is of particular use for models of endogenous
substrates, where changing a parameter value (e.g., the production rate)
will change the steady-state values of the substrate. The steady-state is
considered to be the last values of the molecules amounts and state variable
parameters in the simulation with sufficiently long simulation time, i.e.,
where the rates of the processes do not (significantly) change. The
steady-state is NOT analytically calculated or estimated in any other way
than simulating for the given time. - Added a function
exportSteadyStateToXLS()to export steady state values
calculated for one simulation using thegetSteadyState()to an Excel file
that can be imported in MoBi. - Lower limit of quantification (LLOQ) is plotted as dotted lines for
plotIndividualTimeProfile()andplotPopulationTimeProfile(). plotPopulationTimeProfile()provides two new aggregations methods:
arithmeticandgeometricaverage and the ability to chose the number of
standard deviations to display around the mean through thensdargument.- Function
calculateResiduals()uses natural logarithm (log()) when
calculating residuals withscaling = "log"as opposed tolog10()as it
was done before. This also affects figures created by
plotObservedVsSimulated(),plotResidualsVsSimulated(), and
plotResidualsVsTime(). (#1091, #1087). plotPopulationTimeProfile()has a newaggregationargument that allow
the user to choose between quantiles, arithmetic and geometric aggregations
of y.
Minor improvements and bug fixes
- Named
Simulationlists can be passed torunSimulations()so that the
results are returned as a named list using the same names instead of the
simulation id. If no name is provided, the simulation id is used as before.
(#1383) - The order of columns of the data frame returned by
DataCombined$toDataFrame()has changed. DataCombined$toDataFrame()
shows the data in the order as the data sets were added and not
alphabetically sorted.DataCombined$removeGroupAssignment()does not show a warning if specified name is
not present in theDataCombined.DataCombined$removeGroupAssignment()
does not produce an error if specified names are not unique.- Fixed Passing font size options from plotConfiguration objects to tlf
objects (#1198) - Legend now have transparent background by default and can be customized
through newDefaultPlotConfigurationfields (#1216) plotObsVsPred()now have foldDistance argument set toNULLby default
(previously 2). The function will not add any fold lines on the plot by
default but display identity line. Set this argument toFALSEto not draw
any lines.DefaultPlotConfigurationhas a new setting:displayLLOQ(default TRUE)
to control plotting of LLOQ lines.DefaultPlotConfiguration'sxLimitsandyLimitsarguments are
deprecated and replaced byxAxisLimitsandyAxisLimits. Use them to zoom
in the plot while preserving all data points. UsexValuesLimitsand
yValuesLimitsto filter out data point outside of these range. More
detailed explanations
here.addSimulationResultsandaddDataSetsmethods of theDataCombinedclass
now support an optionalsilentargument which silences the checks for data
set names. If you expect to replace data sets inDataCombinedobjects
repeatedly, consider switching the parameter from the defaultFALSEvalue
toTRUE.simulationResultsToDataFrame()is faster than before (#1317, @Felixmil).DataCombinedgets a new methodsetDataTypes()to change data types
(observed or simulated) for existing data sets. This method is useful when
you want to enforce a certain data type, e.g., for adding artificial data
set as simulated results.- New function
setOutputs()to change outputs ofSimulationBatchobjects.
It combinesclearOutputs()andsetOutputs()in one function. - New simulations life cycle flowcharts in the
vignette("efficient-calculations")vignette. - New internal function
.setEndSimulationTime()to set the end time of the
simulation. The function will either extend or shorten the simulation time to the specified end time. - Using
runSimulation()is now soft deprecated in favor ofrunSimulations().