-
Couldn't load subscription status.
- Fork 20
Glossary
A device in the microgrid. For example, inverter, battery, meter, etc.
A way to identify a particular instance of a component. It is always a int.
For example: Battery with component ID 5.
A measurable characteristic of a component.
For example: the capacity of a battery.
An individual value measured from a component instance metric. It is always float but it is expressed in some particular unit.
In the context of a Sample (see below) this is usually referred to as a sample value.
For example: A measurement of the capacity of battery with component ID 5 can be 400. The unit is typically Watt-hour (Wh).
A point in time. It is always a datetime.
A measurement taken at a particular point in time: a tuple (timestamp, measurement), or simply (timestamp, value).
For example: Getting the measurement of 400 from the capacity of a battery at 2022-01-01 22:00:00.000 UTC would be a sample (2022-01-01 22:00:00.000 UTC, 400).
A sequence of Samples. Normally time series should be sorted by timestamp and timestamps should be separated at regular intervals, but there can be also irregular (event-based) time series (in this case there could even possibly be multiple values with the same timestamp).
For example: Getting the measurement from the capacity of a battery at 2022-01-01 22:00:00.000 UTC every 1 second for 5 seconds would be a timeseries like:
(2022-01-01 22:00:00.000 UTC, 400)
(2022-01-01 22:00:01.000 UTC, 401)
(2022-01-01 22:00:02.000 UTC, 403)
(2022-01-01 22:00:03.000 UTC, 402)
(2022-01-01 22:00:04.000 UTC, 403)
A way to identify a component's metric. Usually a str.
For example, the metric ID of the capacity of a battery is just capacity.
A way to identify a timeseries that comes from a metric of a particular component instance. Usually a str, but coming from the tuple (component ID, metric ID) for components.
For example: A timeseries for the capacity of battery with component ID 5 has ID (component_id, metric_id) (or f"{component_id}_{metric_id}").
The level of charge of a battery relative to its capacity. The units of SoC are percentage points and it is calculated as the ratio between the remaining energy in the battery at a given time and the maximum possible energy with the same state of health conditions. Source
The ratio of peak power to nominal power. The peak power, based on present battery-pack conditions, is the maximum power that may be maintained constant for T seconds without violating preset operational design limits on battery voltage, SOC, power, or current.
This indicator is very important to ensure that the charge or discharge power does not exceed certain limits with the aim of using the battery as good as possible to extend its life expectancy. Also, in peak power applications this indicator can turn useful to define conditions in the battery to be able to make big charges or discharges.
The state of power depends highly on the state of charge, the capacity of the battery and its initial features, chemistry and battery voltage. Source