Skip to content

Commit 4087414

Browse files
authored
Update glossary (#952)
Adding consumer and distinction between assets and devices. Fixes #650
2 parents c87358b + 72a5076 commit 4087414

File tree

1 file changed

+42
-20
lines changed

1 file changed

+42
-20
lines changed

docs/user-guide/glossary.md

Lines changed: 42 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -61,13 +61,25 @@ components](#component-category) together. It can be connected to the public
6161
[grid](#grid), or be completely isolated, in which case it is known as an
6262
island.
6363

64+
Components can be grouped into [assets](#Assets) and [devices](#Devices).
65+
Assets are core components like generators or storage systems that are crucial from a business perspective,
66+
whereas devices are the supporting infrastructure essential for the functionality of these assets.
67+
6468
### Component Category
6569

6670
The category [components](#component) of a [microgrid](#microgrid) belong to.
6771

6872
[Components](#component) of the same category have the same characteristics
6973
(for example offer the same set of [metrics](#metric)).
7074

75+
Examples of categories are meters, inverters or batteries.
76+
77+
A category can be further divided into types.
78+
For instance, PV inverters and battery inverters are types under the inverter category.
79+
80+
81+
### Assets
82+
7183
#### Battery
7284

7385
A storage system for electrical energy.
@@ -77,14 +89,13 @@ A storage system for electrical energy.
7789
A generator that produces combined heat and power ([CHP](#chp)). Usually
7890
powered via combustion of some form of fuel.
7991

80-
#### Converter
81-
82-
Generally refers to [DC-to-DC converter](#dc-to-dc-converter).
83-
84-
#### DC-to-DC Converter
92+
#### Consumer
8593

86-
An electronic circuit or electromechanical device that converts a source of
87-
[DC](#dc) from one voltage level to another.
94+
Typically used in context with a metric, i.e. consumer power or consumer current.
95+
This aggregates all remaining electrical energy [consumption](#consumption) in a microgrid that are not covered by other asset types and components.
96+
Under normal circumstances this is expected to correspond to the [gross consumption](#gross-consumption) of the site excluding active parts and battery.
97+
In [Passive-sign convention](#passive-sign-convention) consumer power is usually positive, but negative values can occur in
98+
exotic site topologies (e.g. unidentified generators) and or due to sudden short-term effects.
8899

89100
#### EV Charger
90101

@@ -99,6 +110,30 @@ A device that converts water into hydrogen and oxygen.
99110
A point where the local [microgrid](#microgrid) is connected to the public
100111
electricity grid.
101112

113+
#### PV Array
114+
115+
A collection of [PV](#pv) panels.
116+
117+
#### Solar Panel
118+
119+
A panel with [PV](#pv) cells that generates [DC](#dc) electricity from
120+
sunlight.
121+
122+
#### Wind Turbine
123+
124+
A device that converts the wind's kinetic energy into electrical energy.
125+
126+
### Devices
127+
128+
#### Converter
129+
130+
Generally refers to [DC-to-DC converter](#dc-to-dc-converter).
131+
132+
#### DC-to-DC Converter
133+
134+
An electronic circuit or electromechanical device that converts a source of
135+
[DC](#dc) from one voltage level to another.
136+
102137
#### Inverter
103138

104139
A device or circuitry that converts [DC](#dc) electricity to [AC](#ac)
@@ -109,10 +144,6 @@ electricity.
109144
A device for measuring electrical [metrics](#metrics) (for example current,
110145
voltage, etc.).
111146

112-
#### PV Array
113-
114-
A collection of [PV](#pv) panels.
115-
116147
#### Pre-charge module
117148

118149
A device that gradually ramp the [DC](#dc) voltage up to prevent any potential
@@ -136,15 +167,6 @@ They are generally placed in front of another [component](#component), e.g., an
136167
A device for [measuring](#measurement] ambient [metrics](#metric) (for example
137168
temperature, humidity, etc.).
138169

139-
#### Solar Panel
140-
141-
A panel with [PV](#pv) cells that generates [DC](#dc) electricity from
142-
sunlight.
143-
144-
#### Wind Turbine
145-
146-
A device that converts the wind's kinetic energy into electrical energy.
147-
148170
### Component
149171

150172
A device (of a particular [category](#component-category)) within

0 commit comments

Comments
 (0)