amici.parameter_mapping
Parameter mapping
When performing parameter inference, often parameters need to be mapped from simulation to estimation parameters, and parameters can differ between conditions. This can be handled using the ParameterMapping.
Note
While the parameter mapping can be used directly with AMICI, it was developed for usage together with PEtab, for which the whole workflow of generating the mapping is automatized.
Classes
|
Parameter mapping for multiple conditions. |
|
Parameter mapping for condition. |
Functions Summary
|
Convert amici scale id to petab scale id. |
|
Fill fixed and dynamic parameters into the edatas (in-place). |
|
Fill fixed and dynamic parameters into the edata for condition (in-place). |
|
Convert petab scale id to amici scale id. |
|
Bring parameter from linear scale to target scale. |
|
Bring parameters from linear scale to target scale. |
|
Bring parameter from scale to linear scale. |
|
Bring parameters from target scale to linear scale. |
Functions
- amici.parameter_mapping.amici_to_petab_scale(amici_scale)[source]
Convert amici scale id to petab scale id.
- Return type
- amici.parameter_mapping.fill_in_parameters(edatas, problem_parameters, scaled_parameters, parameter_mapping, amici_model)[source]
Fill fixed and dynamic parameters into the edatas (in-place).
- Parameters
edatas (
typing.List
[amici.swig_wrappers.ExpData
]) – List of experimental datasamici.amici.ExpData
with everything except parameters filled.problem_parameters (
typing.Dict
[str
,numbers.Number
]) – Problem parameters as parameterId=>value dict. Only parameters included here will be set. Remaining parameters will be used as currently set in amici_model.scaled_parameters (
bool
) – If True, problem_parameters are assumed to be on the scale provided in the parameter mapping. If False, they are assumed to be in linear scale.parameter_mapping (
amici.parameter_mapping.ParameterMapping
) – Parameter mapping for all conditions.amici_model (
typing.Union
[amici.amici.Model
,amici.amici.ModelPtr
]) – AMICI model.
- Return type
- amici.parameter_mapping.fill_in_parameters_for_condition(edata, problem_parameters, scaled_parameters, parameter_mapping, amici_model)[source]
Fill fixed and dynamic parameters into the edata for condition (in-place).
- Parameters
edata (
amici.swig_wrappers.ExpData
) – Experimental data object to fill parameters into.problem_parameters (
typing.Dict
[str
,numbers.Number
]) – Problem parameters as parameterId=>value dict. Only parameters included here will be set. Remaining parameters will be used as already set in amici_model and edata.scaled_parameters (
bool
) – If True, problem_parameters are assumed to be on the scale provided in the parameter mapping. If False, they are assumed to be in linear scale.parameter_mapping (
amici.parameter_mapping.ParameterMappingForCondition
) – Parameter mapping for current condition.amici_model (
typing.Union
[amici.amici.Model
,amici.amici.ModelPtr
]) – AMICI model
- Return type
- amici.parameter_mapping.petab_to_amici_scale(petab_scale)[source]
Convert petab scale id to amici scale id.
- Return type
- amici.parameter_mapping.scale_parameter(value, petab_scale)[source]
Bring parameter from linear scale to target scale.
- Parameters
value (
numbers.Number
) – Value to scalepetab_scale (
str
) – Target scale ofvalue
- Return type
- Returns
value
on target scale
- amici.parameter_mapping.scale_parameters_dict(value_dict, petab_scale_dict)[source]
Bring parameters from linear scale to target scale.
Bring values in
value_dict
from linear scale to the scale provided inpetab_scale_dict
(in-place). Both arguments are expected to have the same length and matching keys.- Parameters
value_dict (
typing.Dict
[typing.Any
,numbers.Number
]) – Values to scalepetab_scale_dict (
typing.Dict
[typing.Any
,str
]) – Target scales ofvalues
- Return type
- amici.parameter_mapping.unscale_parameter(value, petab_scale)[source]
Bring parameter from scale to linear scale.
- Parameters
value (
numbers.Number
) – Value to scalepetab_scale (
str
) – Target scale ofvalue
- Return type
- Returns
value
on linear scale
- amici.parameter_mapping.unscale_parameters_dict(value_dict, petab_scale_dict)[source]
Bring parameters from target scale to linear scale.
Bring values in
value_dict
from linear scale to the scale provided inpetab_scale_dict
(in-place). Both arguments are expected to have the same length and matching keys.- Parameters
value_dict (
typing.Dict
[typing.Any
,numbers.Number
]) – Values to scalepetab_scale_dict (
typing.Dict
[typing.Any
,str
]) – Target scales ofvalues
- Return type