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:
objectImport 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: