energy_analysis.pv_database#

Reproducible statistics and browser exports from PV Parquet snapshots.

No live requests are made. Missing values remain unknown; group sums describe reported values, never an estimate of unreported capacity or market coverage.

energy_analysis.pv_database.field_profile(path)[source]#

Count known/missing values for every column, including all-null columns.

Completeness is non-null coverage, not accuracy or applicability. Empty lists are reported values. False and zero are known values.

Parameters:

path (Path)

Return type:

DataFrame

energy_analysis.pv_database.grouped_statistics(path, by, value)[source]#

Group records and a numeric field, retaining unknown groups and values.

reported_sum includes only known values (all-missing groups stay null). complete_sum is null unless every row in the group reports the field. Never add AC, DC, unspecified capacity or parent/phase records together.

Parameters:
  • path (Path)

  • by (str)

  • value (str)

Return type:

DataFrame

energy_analysis.pv_database.snapshot_overview(snapshot)[source]#

Read actual Parquet metadata for row/column counts and physical file sizes.

Parameters:

snapshot (Path)

Return type:

DataFrame

energy_analysis.pv_database.export_viewer_data(snapshot)[source]#

Export lossless browser projections of every table in a catalogue snapshot.

JSON is a derived delivery format, not an independently maintained database. All rows and populated fields are retained; omitted all-null columns are declared in the full schema and restored as null in the viewer. Lists stay lists and UTC timestamps use ISO 8601. Hashes bind each projection to Parquet. The snapshot must be trusted, generated by build_parquet.

Parameters:

snapshot (Path)

Return type:

dict[str, Any]