energy_data_retrieval.sources.nist.client#

NIST native CSV/TOA5 import, after download through the public PV portal.

energy_data_retrieval.sources.nist.client.parse_generation_csv(content, *, array, power_column='InvPAC_kW_Avg', timestamp_column='TIMESTAMP', source_timezone='-05:00', resolution='one-minute', maximum_rows=1000000)[source]#

Read an inverter/meter AC power channel from a NIST native export.

NIST labels TIMESTAMP as local standard time (LST); Gaithersburg is fixed UTC-05:00. An explicit override supports exports that document another clock. One-minute averages and one-second samples remain distinct. Timestamp labels are retained without guessing which edge of the averaging interval they mark.

Parameters:
  • content (str | bytes)

  • array (str)

  • power_column (str)

  • timestamp_column (str)

  • source_timezone (str)

  • resolution (str)

  • maximum_rows (int)

Return type:

DataFrame

class energy_data_retrieval.sources.nist.client.NISTClient(maximum_rows=1000000)[source]#

Bases: object

Import a user-downloaded export; no account, portal token or form submission.

Parameters:

maximum_rows (int)

maximum_rows: int#
read_export(path, *, array, power_column='InvPAC_kW_Avg', timestamp_column='TIMESTAMP', source_timezone='-05:00', resolution='one-minute')[source]#

Normalize a downloaded CSV and record the exact input file’s SHA-256.

Parameters:
  • path (Path)

  • array (str)

  • power_column (str)

  • timestamp_column (str)

  • source_timezone (str)

  • resolution (str)

Return type:

GenerationResult