For the complete documentation index, see llms.txt. This page is also available as Markdown.

Measurements

Measurements

This document describes the measurement input specifications required for the Monthly Grid Intelligence tier.

DER Detection uses measurement data to identify Distributed Energy Resources such as:

  • Photovoltaics / Solar Panels

  • Battery Energy Storage Systems (BESS)

  • Electric Vehicles

  • HVAC systems


Supported Metrics

DER Detection supports the following mains meter metrics:

Metric
Description
Required

CSD

Electricity consumption measurements

Yes

CSR

Electricity return-to-grid measurements

Optional

Important Notes

  • CSD is required.

  • CSR is required when energy is produced or injected back to the grid.

  • CSR may be omitted if no energy is produced in the household.


Supported Granularity

The following granularities are supported:

  • 15 minutes

  • 60 minutes


Measurement Semantics

The uploaded measurements represent:

  • timestamped delta energy values

  • expressed per interval

Measurement values are expected to represent the consumed or produced energy during the interval starting from the provided timestamp until the next interval timestamp.


Supported Units

By default, measurement values are expected in:

Support for kWh can optionally be enabled through label-partner-specific configuration.


Timezone Requirements

Measurements are expected to correspond to the installation local timezone.

The timestamps inside the file are expected to be UNIX timestamps in milliseconds, expressed in UTC.


Data Exchange

Measurement files are exchanged through AWS S3.

DER input files must be uploaded under the der-measurements folder.

Once uploaded, DER Detection may be triggered, depending on the execution rules.


File Format

Measurement files must:

  • use CSV format

  • use UTF-8 encoding without BOM

  • use comma (,) as separator

  • use dot (.) as decimal separator

A header row is allowed but not required.


CSV Structure

Each row contains:

Field
Description

Timestamp

UNIX timestamp in milliseconds (UTC)

Value

Delta energy value


Example


Directory Structure

Path Format

Filename Format


Path and Filename Parameters

Parameter
Description

bucket_name

The AWS S3 bucket agreed between CUSTOMER and NET2GRID.

labelpartner

The label partner identifier provided by NET2GRID during onboarding.

external-installation-id

Unique identifier of the installation/household.

external-meter-id

Unique identifier of the meter providing the measurements.

start-date

Start date of the measurements contained in the file, in YYYYMMDD format.

stop-date

End date of the measurements contained in the file, in YYYYMMDD format.

metric

Metric identifier. Supported values: CSD, CSR.


DER Measurements Processing

File Rules

Each uploaded DER measurement file:

  • must correspond to a single installation

  • must correspond to a single metric

  • may contain measurements covering multiple days

  • may contain long continuous periods of measurements

  • must not contain measurements from multiple installations

A separate file is expected for:

  • each installation

  • each metric


DER Detection Execution Logic

Uploading DER measurements does not always trigger a DER Detection execution.

A DER Detection execution is triggered only when all the following conditions are met:

  • new measurement data has been uploaded

  • the installation has sufficient measurement history

  • at least one month has elapsed since the installation’s last successful DER Detection execution


Measurement History Requirement

DER Detection requires measurement data to be available for more than 3 months.

Ideally, one full year of measurement data should be available, as this improves the quality of the detection.


Execution Frequency Rule

DER Detection is controlled by a one-month execution gate.

  • If new measurements are uploaded and at least one month has elapsed since the last successful DER Detection execution, a new execution may be triggered.

  • If new measurements are uploaded before one full month has elapsed, no new DER Detection execution is performed.

  • Once one full month has elapsed, the next upload of DER measurements triggers a new DER Detection execution.

  • No execution is performed if no new measurement data is uploaded, even if the one-month period has elapsed.


Reporting Period

The DER Detection analysis period depends on the amount of available measurement data:

  • If a full year of measurement data is available, DER Detection uses the full year.

  • If less than one year is available, DER Detection uses the entire available measurement period.


Measurement Quality Expectations

The uploaded DER measurements are expected to:

  • contain valid timestamps

  • contain positive values

  • follow the expected granularity consistently

  • contain sufficiently complete data

Poor-quality measurements may lead to:

  • reduced detection accuracy

  • missing DER Detection reports


Measurements Overwrite Behavior

NET2GRID EnergyAI® imports measurements using a last-write-wins approach.

If multiple uploaded files contain measurements for the same installation, metric, and timestamps:

  • the latest uploaded measurements overwrite previously imported values

This mechanism allows:

  • correction of previously uploaded measurements

  • re-upload of improved-quality data

  • backfilling of historical periods


Permissions

NET2GRID creates the S3 bucket and grants the customer permissions to:

  • list objects

  • upload objects

  • retrieve objects

  • delete objects

NET2GRID also securely shares the required IAM credentials during onboarding.

Last updated

Was this helpful?