You are on page 1of 13

CSV file format

Date: 2018-09-28
ADR CSV file format Version: 2.0

The Ampacimon software generates several CSV files for each overhead line
- Sag Data: contains the sag results for each span/sensor of the line
- Ampacity Data: contains the ampacity results for each span/sensor of the line
- Line Ampacity Data : contains the ampacity results for the line

The CSV use the “;” column separator and the “.” for decimal separator. The date are encoded using the long ISO 8601 format including
time zone (YYYY-MM-DDThh:mm:ss.sTZD)

The following sections describe each file format.

Sag Data

A sag data file is generated for each span/sensor and each day. The file contains records only when the sensor is up and running. The file
name is

[SPAN-ID].MID_[SENSOR_ID]/SagData/[YEAR]-[MONTH]/[YEAR][MONTH][DAY]-[LINE_ID]-[SPAN_ID]-[SENSOR_ID]-span-sag-data-
[CSV-FILE-VERSION].csv

For instance: SP_2-3.MID_12/SagData/2013-01/20130103-ELIA_150.16-SP_2-3-12-span-sag-data-v001.csv

Field name Description Data Type Sample Since version


lineId The id of the line String aLine V1
spanId The id of the span String aSpan V1
ampacimonId The id of the Ampacimon sensor String 1 V1
measurementTime The time of the sag measurement in DateTime 2013-01-02T23:00:57.278Z V1
[UTC] UTC
measurementTime The time of the sag measurement in DateTime 2013-01- V1
[Local] local time 03T00:00:57.278+01:00
computationTime [UTC] The time of the sag computation in DateTime 2013-11-26T17:40:54.104Z V1
UTC. If the computation has been
done in an offline simulation, the
computation time is the time of the
simulation.
computationTime The time of the sag computation in DateTime 2013-11- V1
[Local] local time 26T18:40:54.104+01:00
sag [m] The sag measured in meter [m] Real 12.05 V1
quality The quality of the sag. 0=valid; and Integer 0 V1
invalid otherwise
qualityReason A reason for the quality String V1

Ampacity Data file

An ampacity data file is generated for each span/sensor and each day. The file contains a record every five minutes. The file name is

[SPAN-ID].MID_[SENSOR_ID]/AmpacityData/[YEAR]-[MONTH]/[YEAR][MONTH][DAY]-[LINE_ID]-[SPAN_ID]-[SENSOR_ID]-span-
ampacity-data-[CSV-FILE-VERSION].csv

For instance: SP_2-3.MID_12/AmpacityData/2013-01/20130103-ELIA_150.16-SP_2-3-12-span-ampacity-data-v002.csv

Field name Description Data Type Sample Since version


lineId The id of the line String aLine V1
spanId The id of the span String aSpan V1
ampacimonId The id of the Ampacimon sensor String 1 V1
measurementTime [UTC] The time of the ampacity value in DateTime 2013-01-02T23:00:57.278Z V1
UTC
measurementTime [Local] The time of the ampacity value in DateTime 2013-01- V1
local time 03T00:00:57.278+01:00
computationTime [UTC] The time of the ampacity DateTime 2013-11-26T17:40:54.104Z V1
computation in UTC. If the
computation has been done in an
offline simulation, the
computation time is the time of
the simulation.
computationTime [Local] The time of the ampacity DateTime 2013-11- V1
computation in local time 26T18:40:54.104+01:00
sag [m] The sag measured in meter [m] Real 12.05 V1
temperatureFromSag [Celsius Temperature of the conductor in Real 31.2 V6
degree] Celsius degree [°C]. This
temperature is derived from the
sag through the state change
equation.
smoothedAmpacity [Ampere] The real time ampacity in Real 532.0 V1
Ampere
smoothedAmpacity [MVA]] The real time ampacity in MVA Real 532.0 V1
ampacityAmbientTemperature The real-time ampacity only Real 532.0 V1
[Ampere] based on ambient temperature
in Ampere
ampacityAmbientTemperature The real-time ampacity only Real 532.0 V1
[MVA] based on ambient temperature
in MVA
lineCurrent [Ampere] The line current used to compute Real 532.0 V1
the ampacity in Ampere
lineCurrent [MVA] The line current used to compute Real 532.0 V1
the ampacity in MVA
staticRating [Ampere] The line static rating in Ampere Real 532.0 V1
staticRating [MVA] The line static rating in MVA Real 532.0 V1
initialPerpendicularWindSpeed The initial perpendicular wind Real 5.3 V4
[Meter per second] speed used to compute the
Ampacity in m/s. For future use.
Not filled by default.
initialAmbientTemperature The initial ambient temperature Real 532.0 V1
[Celsius degree] used to compute the Ampacity in
Celsius degree
initialSolarRadiation [Watt per The initial solar radiation used to Real 532.0 V1
square meter] compute the Ampacity in Watt
per square meter.
ampacity5min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 5 minutes
in Ampere. Fill only for ADR
Transient license.
ampacity5min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 5 minutes
in MVA. Fill only for ADR
Transient license.
ampacity10min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 10
minutes in Ampere. Fill only for
ADR Transient license.
ampacity10min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 10
minutes in MVA. Fill only for
ADR Transient license.
ampacity15min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 15
minutes in Ampere. Fill only for
ADR Transient license.
ampacity15min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 15
minutes in MVA. Fill only for
ADR Transient license.
ampacity20min [Ampere] The transient ampacity that can Real 532.0 V4
be maintained during 20
minutes in Ampere. Fill only for
ADR Transient license.
ampacity20min [MVA] The transient ampacity that can Real 532.0 V4
be maintained during 20
minutes in MVA. Fill only for
ADR Transient license.
ampacity30min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 30
minutes in Ampere. Fill only for
ADR Transient license.
ampacity30min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 30
minutes in MVA . Fill only for
ADR Transient license.
ampacity45min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 45
minutes in Ampere. Fill only for
ADR Transient license.
ampacity45min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 45
minutes in MVA. Fill only for
ADR Transient license.
sagAlarm Alarm if the sag reaches a given Boolean 0 V3
value.
conductorTemperatureAlarm Alarm if the conductor Boolean 0 V3
temperature reaches a given
value.
lineCurrentAlarm Alarm if the line current reaches Boolean 0 V3
a given value.
iceAlarm Alarm if ice accretion is detected. Boolean 0 V3
For future use.
quality The quality flag. 0=valid; and Integer 0 V1
invalid otherwise
qualityReason A reason for the quality String V1
iceWeigth The estimated weight of the ice Real 1.23 V5
accretion. For future use.
lineVoltage The line voltage used to compute Real 400 V7
the rating in MVA. Contains the
the real-time voltage if received
from the SCADA or the nominal
voltage otherwise. Voltage
express in kilo-volt [kV]
clearanceAtGivenLocation Clearance in [m] at a configured Real 12.0 V8
location under the span based on
sag value and span geometry.
Not filled by default.

Line Ampacity

A line ampacity data file is generated for the line for each day. The file contains a record every five minutes. The file name is

LineResults/[YEAR]-[MONTH]/[YEAR][MONTH][DAY]-[LINE_ID]-line-results -[CSV-FILE-VERSION].csv

For instance: LineResults/2013-01/20130103-ELIA_150.16-line-results-v002.csv


Field name Description Data Sample Since
Type version
lineId The id of the line String aLine V1
measurementTime [UTC] The time of the ampacity value DateTime 2013-01-02T23:00:57.278Z V1
in UTC
measurementTime [Local] The time of the ampacity value DateTime 2013-01- V1
in local time 03T00:00:57.278+01:00
computationTime [UTC] The time of the ampacity DateTime 2013-11-26T17:40:54.104Z V1
computation in UTC. If the
computation has been done in
an offline simulation, the
computation time is the time of
the simulation.
computationTime [Local] The time of the ampacity DateTime 2013-11- V1
computation in local time 26T18:40:54.104+01:00
ampacity [Ampere] The real time ampacity in Real 532.0 V1
Ampere
ampacity [MVA] The real time ampacity in MVA Real 532.0 V1
operational ampacity [Ampere] The rating updated every 30 Real 532.0 V1
min to be below the real time
rating in 98% of the time in
Ampere
operational ampacity [MVA] The rating updated every 30 Real 532.0 V1
min to be below the real time
rating in 98% of the time in
MVA
forecast30m [Ampere] The 30 minutes ampacity Real 532.0 V1
forecast in Ampere. Fill only for
ADR Trends license.
forecast30m [MVA] The 30 minutes ampacity Real 532.0 V1
forecast in MVA. Fill only for
ADR Trends license.
forecast1h [Ampere] The 1 hour ampacity forecast in Real 532.0 V1
Ampere. Fill only for ADR
Trends license.
forecast1h [MVA] The 1 hour ampacity forecast in Real 532.0 V1
MVA. Fill only for ADR Trends
license.
forecast2h [Ampere] The 2 hours ampacity forecast Real 532.0 V1
in Ampere. Fill only for ADR
Trends license.
forecast2h [MVA] The 2 hours ampacity forecast Real 532.0 V1
in MVA. Fill only for ADR Trends
license.
forecast4h [Ampere] The 4 hours ampacity forecast Real 532.0 V1
in Ampere. Fill only for ADR
Trends license.
forecast4h [MVA] The 4 hours ampacity forecast Real 532.0 V1
in MVA. Fill only for ADR Trends
license.
staticRating [Ampere] The line static rating in Ampere Real 532.0 V1
staticRating [MVA] The line static rating in MVA Real 532.0 V1
lineCurrent [Ampere] The line current used to Real 532.0 V1
compute the ampacity in
Ampere
lineCurrent [MVA] The line current used to Real 532.0 V1
compute the ampacity in MVA
criticalSpans The list of the critical spans id String SP_T1_T2 V1
i.e. the span(s) that limit(s) the
line Ampacity
ampacity5min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 5 minutes
in Ampere. Fill only for ADR
Transient license.
ampacity5min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 5 minutes
in MVA. Fill only for ADR
Transient license.
ampacity10min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 10
minutes in Ampere. Fill only for
ADR Transient license.
ampacity10min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 10
minutes in MVA. Fill only for
ADR Transient license.
ampacity15min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 15
minutes in Ampere. Fill only for
ADR Transient license.
ampacity15min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 15
minutes in MVA. Fill only for
ADR Transient license.
ampacity20min [Ampere] The transient ampacity that can Real 532.0 V4
be maintained during 20
minutes in Ampere. Fill only for
ADR Transient license.
ampacity20min [MVA] The transient ampacity that can Real 532.0 V4
be maintained during 20
minutes in MVA. Fill only for
ADR Transient license.
ampacity30min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 30
minutes in Ampere. Fill only for
ADR Transient license.
ampacity30min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 30
minutes in MVA. Fill only for
ADR Transient license.
ampacity45min [Ampere] The transient ampacity that can Real 532.0 V2
be maintained during 45
minutes in Ampere. Fill only for
ADR Transient license.
ampacity45min [MVA] The transient ampacity that can Real 532.0 V2
be maintained during 45
minutes in MVA. Fill only for
ADR Transient license.
forecast30mQuality The quality flag of the Integer 0 V3
forecast30m. 0=valid; and
invalid otherwise. Fill only for
ADR Trends license.
forecast1hQuality The quality flag of the Integer 0 V3
forecast1h. 0=valid; and invalid
otherwise. Fill only for ADR
Trends license.
forecast2hQuality The quality flag of the Integer 0 V3
forecast2h. 0=valid; and invalid
otherwise. Fill only for ADR
Trends license.
forecast4hQuality The quality flag of the Integer 0 V3
forecast4h. 0=valid; and invalid
otherwise. Fill only for ADR
Trends license.
forecast6hQuality The quality flag of the Integer 0 V3
forecast6h. 0=valid; and invalid
otherwise. Fill only for ADR
Trends license.
sagAlarm Alarm (= 1) if the sag reaches a Boolean 0 V3
given value.
conductorTemperatureAlarm Alarm if the conductor Boolean 0 V3
temperature reaches a given
value.
lineCurrentAlarm Alarm if the line current reaches Boolean 0 V3
a given value.
iceAlarm Alarm if ice accretion is detected Boolean 0 V3
For future use.
qualityReason A reason for the quality String “INVALID” V1
quality The quality flag. 0=valid; and Integer 0 V1
invalid otherwise
iceAlarmSpans List of spans with iceAlarm=1 String “T1-T2, T3-T4” V5
sagAlarmSpans List of spans with sagAlarm=1 String “T1-T2, T3-T4” V5
conductorTemperatureAlarmSpans List of spans with String “T1-T2, T3-T4” V5
conductorTemperatureAlarm
=1
maxConductorTemperature The maximum of each span Real 32.3 V5
conductor temperature
lineVoltage The line voltage used to Real 400.0 V6
compute the rating in MVA.
Contains the the real-time
voltage if received from the
SCADA or the nominal voltage
otherwise. Voltage express in
kilo-volt [kV]

Ampacity forecast and transient ampacity are only available if the product license (ADR Trends) is activated for the line.

Day ahead line ampacity forecast (only for ADR Horizon license)

A line ampacity forecast data file is generated for the line for each new weather forecast reception (usually, 4 times per da y). The file
contains a record every hour for the next 54-60 hours (depending on the weather model computation time and horizon) and for each
degradation threshold (P50, P80, P95, P98). The file name is

LongTermLineForecastAmpacityData/[YEAR]-[MONTH]/[YEAR][MONTH][DAY]-[RUN-ID][LINE_ID]-FOLineAmpacity-[CSV-FILE-
VERSION].csv

For instance: LongTermLineForecastAmpacityData /2014-12/ 20141201-060000-ELIA_380.80-FOLineAmpacity-v001.csv

Field name Description Data Type Sample Since version


lineId The id of the line String aLine V1
computationTime [UTC] The time of the weather forecast DateTime 2014-12-01T00:00:00.000Z V1
computation in UTC.
measurementTime [UTC] The time of the ampacity forecast DateTime 2014-12-01T01:00:00.000Z V1
value in UTC. This time is in the
future and corresponds to the time
when the forecast ampacity
applied.
receivedTime [UTC] The time when the ampacity DateTime 2014-12-01T06:40:54.104Z V1
forecast has been computed by the
server or the offline simulation.
finalForecastAmpacity The ampacity forecast in Ampere Real 532.0 V1
[Ampere]
degradationThreshold The confident degradation integer 98 V1
threshold: 50, 80,95,98

You might also like