.. _overview_components: Overview ======== ``Model`` is the primary central object which aggregate components based on a broader perspective of what they describe, namely Scope (``Time``, ``Space``), ``System`` , ``Consequence``, ``Problem``. Scope ----- These components define the extent of the system under consideration, and the fidelity of data. - ``Time``, with ``Periods`` and ``TemporalScales`` defining the discretization - ``Space``, with ``Location`` and ``Linkage`` serving as nodes and edges The most sparsely discretized ``Periods`` serves as the temporal ``horizon``, and the most encompassing ``Location`` (which are nested) is the ``network`` Measurement ----------- These provide a basis for measurement and conversion, scaling them appropriately. - ``Unit`` can be defined in terms of other ``Unit`` s Some commonly used units can be found in ``energia.library.components``, namely ``si_units`` which are subset of `SI Units `_ and ``misc_units`` which include some `US Customary Units `_ Streams ------- These quantify flow within the system, as well as interactions with the external environment. - ``Commodity`` which includes ``Resource``, and subsets ``Currency``, ``Land``, ``Emission``, ``Material``, etc. - ``Indicator`` categories such as ``Environ``, ``Social``, and ``Economic`` ``Commodity`` streams belong to ``System``, whereas ``Indicators`` inform the ``Consequence``. Operational ----------- Decisions pertaining to these generate and direct ``Commodity`` streams. - ``Process`` for commodity conversion - ``Transport`` to import and export certain commodities - ``Storage`` to charge and discharge inventory ``Storage`` is actually a combination of two ``Process`` es (for charging and discharging) and an ``Inventory`` space. Game ----- These suggest ownership and strategic interactions between independent actors (``Player`` s). - ``Player`` is an independent actor - ``Couple`` represents a link between two ``Player`` s Aspect ------ The facets being modeled, categorized broadly into: - ``State`` (in Energia) are restricted to operational conditions - ``Control`` or decision variables - ``Stream``, also a ``State`` that quantify ``Commodity`` streams - ``Impact`` which quantify ``Indicator`` streams - ``Loss``, a general variable to describe loss and (or) degradation Note that users can choose to model sans ``Control`` variables and model ``State`` directly. These are defined using ``Recipes`` which provide a structured way to define the context of an ``Aspect``. Constraint ----------- Data provided either: - ``Bind`` or restrict any given ``Aspect`` or - ``Calculate`` a dependent ``Aspect`` such as ``Stream``, ``Impact``, or ``Loss`` Consistency is maintained by generating implicit constraints: - ``Balance`` for general resource balance and - ``Map`` to scale and sum streams across spatiotemporal domains Parameter --------- No special parameter types exist of bind and calculations. However,: - ``Conversion`` serves as general parameter that dictates conversion efficiency and material use for setup Disposition ----------- Essentially ordered indices that describe both the fidelity and specificity of a modeling element. - ``Domain`` is an ordered index set Objective --------- Multiple objectives can be provided. Infact the lower and upperbounds of any ``Aspect`` with regards to a specific component within some spatiotemporal context can be determined.