Reference

Reference

Mimi.@defcompMacro.
defcomp(comp_name::Symbol, ex::Expr)

Define a Mimi component comp_name with the expressions in ex. The following types of expressions are supported:

  1. dimension_name = Index() # defines a dimension
  2. parameter = Parameter(index = [dimension_name], units = "unit_name", default = default_value) # defines a parameter with optional arguments
  3. variable = Variable(index = [dimension_name], units = "unit_name") # defines a variable with optional arguments
  4. init(p, v, d) # defines an init function for the component
  5. run_timestep(p, v, d, t) # defines a run_timestep function for the component

Parses a @defcomp definition, converting it into a series of function calls that create the corresponding ComponentDef instance. At model build time, the ModelDef (including its ComponentDefs) will be converted to a runnable model.

source
MarginalModel

A Mimi Model whose results are obtained by subtracting results of one base Model from those of another marginal Modelthat has a difference ofdelta`.

source
Mimi.ModelType.
Model

A user-facing API containing a ModelInstance (mi) and a ModelDef (md). This Model can be created with the optional keyword argument number_type indicating the default type of number used for the ModelDef. If not specified the Model assumes a number_type of Float64.

source
Mimi.add_comp!Function.
add_comp!(md::ModelDef, comp_def::ComponentDef, comp_name::Symbol=comp_def.comp_id.comp_name; 
          first=nothing, last=nothing, before=nothing, after=nothing)

Add the component indicated by comp_def to the model indcated by md. The component is added at the end of the list unless one of the keywords, first, last, before, after. If the comp_name differs from that in the comp_def, a copy of comp_def is made and assigned the new name.

source
add_comp!(md::ModelDef, comp_id::ComponentId; comp_name::Symbol=comp_id.comp_name, 
    first=nothing, last=nothing, before=nothing, after=nothing)

Add the component indicated by comp_id to the model indicated by md. The component is added at the end of the list unless one of the keywords, first, last, before, after. If the comp_name differs from that in the comp_def, a copy of comp_def is made and assigned the new name.

source
add_comp!(mi::ModelInstance, ci::ComponentInstance)

Add the component ci to the ModelInstance mi's list of components, and add the first and last of mi to the ends of the firsts and lasts lists of mi, respectively.

source
add_comp!(m::Model, comp_id::ComponentId; comp_name::Symbol=comp_id.comp_name;
    first=nothing, last=nothing, before=nothing, after=nothing)

Add the component indicated by comp_id to the model indicated by m. The component is added at the end of the list unless one of the keywords, first, last, before, after. If the comp_name differs from that in the comp_id, a copy of comp_id is made and assigned the new name.

source
Mimi.componentsFunction.
components(mi::ModelInstance)

Return an iterator on the components in model instance mi.

source
components(m::Model)

Return an iterator on the components in model m.

source
Mimi.connect_param!Function.
connect_param!(md::ModelDef, comp_name::Symbol, param_name::Symbol, ext_param_name::Symbol)

Connect a parameter param_name in the component comp_name of model md to the external parameter ext_param_name.

source
connect_param!(md::ModelDef, dst_comp_name::Symbol, dst_par_name::Symbol, 
    src_comp_name::Symbol, src_var_name::Symbol backup::Union{Nothing, Array}=nothing; 
    ignoreunits::Bool=false, offset::Int=0)

Bind the parameter dst_par_name of one component dst_comp_name of model md to a variable src_var_name in another component src_comp_name of the same model using backup to provide default values and the ignoreunits flag to indicate the need to check match units between the two. The offset argument indicates the offset between the destination and the source ie. the value would be 1 if the destination component parameter should only be calculated for the second timestep and beyond.

source
connect_param!(md::ModelDef, dst::Pair{Symbol, Symbol}, src::Pair{Symbol, Symbol}, 
    backup::Union{Nothing, Array}=nothing; ignoreunits::Bool=false, offset::Int=0)

Bind the parameter dst[2] of one component dst[1] of model md to a variable src[2] in another component src[1] of the same model using backup to provide default values and the ignoreunits flag to indicate the need to check match units between the two. The offset argument indicates the offset between the destination and the source ie. the value would be 1 if the destination component parameter should only be calculated for the second timestep and beyond.

source
connect_param!(dst::ComponentReference, dst_name::Symbol, src::ComponentReference, src_name::Symbol)

Connect two components as connect_param!(dst, dst_name, src, src_name).

source
connect_param!(dst::ComponentReference, src::ComponentReference, name::Symbol)

Connect two components with the same name as connect_param!(dst, src, name).

source
connect_param!(m::Model, dst_comp_name::Symbol, dst_par_name::Symbol, src_comp_name::Symbol, 
    src_var_name::Symbol, backup::Union{Nothing, Array}=nothing; ignoreunits::Bool=false, offset::Int=0)

Bind the parameter dst_par_name of one component dst_comp_name of model md to a variable src_var_name in another component src_comp_name of the same model using backup to provide default values and the ignoreunits flag to indicate the need to check match units between the two. The offset argument indicates the offset between the destination and the source ie. the value would be 1 if the destination component parameter should only be calculated for the second timestep and beyond.

source
connect_param!(m::Model, dst::Pair{Symbol, Symbol}, src::Pair{Symbol, Symbol}, backup::Array; ignoreunits::Bool=false)

Bind the parameter dst[2] of one component dst[1] of model md to a variable src[2] in another component src[1] of the same model using backup to provide default values and the ignoreunits flag to indicate the need to check match units between the two. The offset argument indicates the offset between the destination and the source ie. the value would be 1 if the destination component parameter should only be calculated for the second timestep and beyond.

source
create_marginal_model(base::Model, delta::Float64=1.0)

Create a MarginalModel where base is the baseline model and delta is the difference used to create the marginal model. Return the resulting MarginaModel which shares the internal ModelDef between the base and marginal.

source
Mimi.dim_countFunction.
dim_count(md::ModelDef, name::Symbol)

Return the size of index name in model definition md.

source
dim_count(mi::ModelInstance, dim_name::Symbol)

Return the size of index dim_name in model instance mi.

source
dim_count(m::Model, dim_name::Symbol)

Return the size of index dim_name in model m.

source
Mimi.dim_keysFunction.
dim_keys(md::ModelDef, name::Symbol)

Return keys for dimension name in model definition md.

source
dim_keys(mi::ModelInstance, dim_name::Symbol)

Return keys for dimension dim_name in model instance mi.

source
dim_keys(m::Model, dim_name::Symbol)

Return keys for dimension dim-name in model m.

source
Mimi.dim_key_dictFunction.
dim_key_dict(md::ModelDef)

Return a dict of dimension keys for all dimensions in model definition md.

source
dim_key_dict(mi::ModelInstance)

Return a dict of dimension keys for all dimensions in model instance mi.

source
dim_key_dict(m::Model)

Return a dict of dimension keys for all dimensions in model m.

source
disconnect_param!(md::ModelDef, comp_name::Symbol, param_name::Symbol)

Remove any parameter connections for a given parameter param_name in a given component comp_name of model md.

source
disconnect_param!(m::Model, comp_name::Symbol, param_name::Symbol)

Remove any parameter connections for a given parameter param_name in a given component comp_name of model m.

source
Mimi.exploreFunction.
explore(m::Model; title = "Electron")

Produce a UI to explore the parameters and variables of Model m in a Window with title title.

source
Mimi.generate_trials!Function.
generate_trials!(sim::Simulation{T}, samples::Int; filename::Union{String, Nothing}=nothing)

Generate trials for the given Simulation instance using the defined `samplesize. Call this before running the sim to pre-generate data to be used by all scenarios. Also saves inputs if a filename is given.

source
Mimi.getdataframeFunction.
getdataframe(m::Model, comp_name::Symbol, pairs::Pair{Symbol, Symbol}...)

Return a DataFrame with values for the given variables or parameters of model m indicated by pairs, where each pair is of the form comp_name => item_name. If more than one pair is provided, all must refer to items with the same dimensions, which are used to join the respective item values.

source
getdataframe(m::Model, pair::Pair{Symbol, NTuple{N, Symbol}})

Return a DataFrame with values for the given variables or parameters indicated by pairs, where each pair is of the form comp_name => item_name. If more than one pair is provided, all must refer to items with the same dimensions, which are used to join the respective item values.

source
getdataframe(m::Model, comp_name::Symbol, item_name::Symbol)

Return the values for variable or parameter item_name in comp_name of model m as a DataFrame.

source
Mimi.gettimeFunction.
gettime(ts::FixedTimestep)

Return the time (year) represented by Timestep ts

source
gettime(ts::VariableTimestep)

Return the time (year) represented by Timestep ts

source
gettime(c::Clock)

Return the current time of the timestep held by the c clock.

source
Mimi.get_param_valueFunction.
get_param_value(ci::ComponentInstance, name::Symbol)

Return the value of parameter name in component ci.

source
Mimi.get_var_valueFunction.
get_var_value(ci::ComponentInstance, name::Symbol)

Return the value of variable name in component ci.

source
Mimi.hasvalueFunction.
hasvalue(arr::TimestepArray, ts::FixedTimestep)

Return true or false, true if the TimestepArray arr contains the Timestep ts.

source
hasvalue(arr::TimestepArray, ts::VariableTimestep)

Return true or false, true if the TimestepArray arr contains the Timestep ts.

source
hasvalue(arr::TimestepArray, ts::FixedTimestep, idxs::Int...)

Return true or false, true if the TimestepArray arr contains the Timestep ts within indices idxs. Used when Array and Timestep have different FIRST, validating all dimensions.

source
hasvalue(arr::TimestepArray, ts::VariableTimestep, idxs::Int...)

Return true or false, true if the TimestepArray arr contains the Timestep ts within indices idxs. Used when Array and Timestep different TIMES, validating all dimensions.

source
Mimi.is_firstFunction.
is_first(ts::AbstractTimestep)

Return true or false, true if ts is the first timestep to be run.

source
Mimi.is_lastFunction.
is_last(ts::FixedTimestep)

Return true or false, true if ts is the last timestep to be run.

source
is_last(ts::VariableTimestep)

Return true or false, true if ts is the last timestep to be run. Note that you may run next_timestep on ts, as ths final timestep has not been run through yet.

source
Mimi.is_timeFunction.
is_time(ts::AbstractTimestep, t::Int)

Return true or false, true if the current time (year) for ts is t

source
Mimi.is_timestepFunction.
is_timestep(ts::AbstractTimestep, t::Int)

Return true or false, true if ts timestep is step t.

source
Mimi.load_compsFunction.
load_comps(dirname::String="./components")

Call include() on all the files in the indicated directory dirname. This avoids having modelers create a long list of include() statements. Just put all the components in a directory.

source
Mimi.modeldefFunction.
modeldef(mi)

Return the ModelDef contained by ModelInstance mi.

source
modeldef(m)

Return the ModelDef contained by Model m.

source
Mimi.nameFunction.
name(def::NamedDef) = def.name

Return the name of def. Possible NamedDefs include DatumDef, and ComponentDef.

source
name(ci::ComponentInstance)

Return the name of the component ci.

source
Mimi.parametersFunction.
parameters(comp_def::ComponentDef)

Return a list of the parameter definitions for comp_def.

source
parameters(comp_id::ComponentDef)

Return a list of the parameter definitions for comp_id.

source
parameters(mi::ModelInstance, comp_name::Symbol)

Return the ComponentInstanceParameters for comp_name in ModelInstance 'mi'.

source
parameters(ci::ComponentInstance)

Return an iterable over the parameters in ci.

source
parameters(m::Model, comp_name::Symbol)

Return a list of the parameter definitions for comp_name in model m.

source
Mimi.parameter_namesFunction.
parameter_names(md::ModelDef, comp_name::Symbol)

Return a list of all parameter names for a given component comp_name in a model def md.

source
parameter_dimensions(md::ModelDef, comp_name::Symbol, param_name::Symbol)

Return a vector of the dimensions of param_name in component comp_name in model md

source
Mimi.plot_comp_graphFunction.
plot_comp_graph(m::Model, filename::Union{Nothing, Symbol} = nothing)

Plot the DAG of component connections within model m and save to filename. If no filename is given, plot will simply display.

source
Mimi.replace_comp!Function.
replace_comp!(md::ModelDef, comp_id::ComponentId, comp_name::Symbol=comp_id.comp_name;
    first::NothingInt=nothing, last::NothingInt=nothing,
    before::NothingSymbol=nothing, after::NothingSymbol=nothing,
    reconnect::Bool=true)

Replace the component with name comp_name in model definition md with the component comp_id using the same name. The component is added in the same position as the old component, unless one of the keywords before or after is specified. The component is added with the same first and last values, unless the keywords first or last are specified. Optional boolean argument reconnect with default value true indicates whether the existing parameter connections should be maintained in the new component.

source
replace_comp!(m::Model, comp_id::ComponentId, comp_name::Symbol=comp_id.comp_name;
    first::NothingSymbol=nothing, last::NothingSymbol=nothing,
    before::NothingSymbol=nothing, after::NothingSymbol=nothing,
    reconnect::Bool=true)

Replace the component with name comp_name in model m with the component comp_id using the same name. The component is added in the same position as the old component, unless one of the keywords before or after is specified. The component is added with the same first and last values, unless the keywords first or last are specified. Optional boolean argument reconnect with default value true indicates whether the existing parameter connections should be maintained in the new component.

source
Mimi.run_simFunction.
run_sim(sim::Simulation{T}; 
        trials::Union{Nothing, Int, Vector{Int}, AbstractRange{Int}}=nothing,
        models_to_run::Int=length(sim.models),
        ntimesteps::Int=typemax(Int), 
        output_dir::Union{Nothing, AbstractString}=nothing, 
        pre_trial_func::Union{Nothing, Function}=nothing, 
        post_trial_func::Union{Nothing, Function}=nothing,
        scenario_func::Union{Nothing, Function}=nothing,
        scenario_placement::ScenarioLoopPlacement=OUTER,
        scenario_args=nothing)

Optionally run the first indicated trials, which indicates the number of trials to run starting from the first one. The first models_to_run associated models are run for ntimesteps, if specified, else to the maximum defined time period. Note that trial data are applied to all the associated models even when running only a portion of them.

If pre_trial_func or post_trial_func are defined, the designated functions are called just before or after (respectively) running a trial. The functions must have the signature:

fn(sim::Simulation, trialnum::Int, ntimesteps::Int, tup::Tuple)

where tup is a tuple of scenario arguments representing one element in the cross-product of all scenario value vectors. In situations in which you want the simulation loop to run only some of the models, the remainder of the runs can be handled using a pre_trial_func or post_trial_func.

If provided, scenario_args must be a Vector{Pair}, where each Pair is a symbol and a Vector of arbitrary values that will be meaningful to scenario_func, which must have the signature:

scenario_func(sim::Simulation, tup::Tuple)

By default, the scenario loop encloses the simulation loop, but the scenario loop can be placed inside the simulation loop by specifying scenario_placement=INNER. When INNER is specified, the scenario_func is called after any pre_trial_func but before the model is run.

source
Mimi.set_dimension!Function.
set_dimension!(md::ModelDef, name::Symbol, keys::Union{Int, Vector, Tuple, Range})

Set the values of md dimension name to integers 1 through count, if keys is an integer; or to the values in the vector or range if keys is either of those types.

source
set_dimension!(m::Model, name::Symbol, keys::Union{Vector, Tuple, AbstractRange})

Set the values of m dimension name to integers 1 through count, if keysis an integer; or to the values in the vector or range ifkeys`` is either of those types.

source
set_leftover_params!(m::Model, parameters::Dict)

Set all of the parameters in model m that don't have a value and are not connected to some other component to a value from a dictionary parameters. This method assumes the dictionary keys are strings that match the names of unset parameters in the model.

source
Mimi.set_models!Function.
    set_models!(sim::Simulation{T}, models::Vector{Model})

Set the `models` to be used by the `sim` Simulation.
source

set_models!(sim::Simulation{T}, m::Model)

Set the model `m` to be used by the `sim` Simulation.
source

set_models!(sim::Simulation{T}, mm::MarginalModel)

Set the models to be used by the `sim` Simulation to be `mm.base` and `mm.marginal`
which make up the MarginalModel `mm`.
source
Mimi.set_param!Function.
set_param!(m::ModelDef, comp_name::Symbol, name::Symbol, value, dims=nothing)

Set the parameter name of a component comp_name in a model m to a given value. The value can by a scalar, an array, or a NamedAray. Optional argument 'dims' is a list of the dimension names ofthe provided data, and will be used to check that they match the model's index labels.

source
set_param!(ref::ComponentReference, name::Symbol, value)

Set a component parameter as set_param!(reference, name, value).

source
set_param!(m::Model, comp_name::Symbol, name::Symbol, value, dims=nothing)

Set the parameter of a component comp_name in a model m to a given value. The value can by a scalar, an array, or a NamedAray. Optional argument 'dims' is a list of the dimension names of the provided data, and will be used to check that they match the model's index labels.

source
Mimi.variablesFunction.
variables(mi::ModelInstance, comp_name::Symbol)

Return the ComponentInstanceVariables for comp_name in ModelInstance 'mi'.

source
variables(m::Model, comp_name::Symbol)

Return a list of the variable definitions for comp_name in model m.

source
parameter_dimensions(md::ModelDef, comp_name::Symbol, param_name::Symbol)

Return a vector of the dimensions of var_name in component comp_name in model md

source
Mimi.variable_namesFunction.
variable_names(md::ModelDef, comp_name::Symbol)

Return a list of all variable names for a given component comp_name in a model def md.

source
Mimi.update_param!Function.
update_param!(md::ModelDef, name::Symbol, value; update_timesteps = false)

Update the value of an external model parameter in ModelDef md, referenced by name. Optional boolean argument update_timesteps with default value false indicates whether to update the time keys associated with the parameter values to match the model's time index.

source
update_param!(m::Model, name::Symbol, value; update_timesteps = false)

Update the value of an external model parameter in model m, referenced by name. Optional boolean argument update_timesteps with default value false indicates whether to update the time keys associated with the parameter values to match the model's time index.

source
Mimi.update_params!Function.
update_params!(md::ModelDef, parameters::Dict{T, Any}; update_timesteps = false) where T

For each (k, v) in the provided parameters dictionary, update_param! is called to update the external parameter by name k to value v, with optional Boolean argument update_timesteps. Each key k must be a symbol or convert to a symbol matching the name of an external parameter that already exists in the model definition.

source
update_params!(m::Model, parameters::Dict{T, Any}; update_timesteps = false) where T

For each (k, v) in the provided parameters dictionary, update_param!` is called to update the external parameter by name k to value v, with optional Boolean argument update_timesteps. Each key k must be a symbol or convert to a symbol matching the name of an external parameter that already exists in the model definition.

source