energy_data_retrieval.sources.tepco.client#

TEPCO Tokyo-area actual/estimated generation mix, in half-hour average MW.

energy_data_retrieval.sources.tepco.client.generation_urls(start, end, *, maximum_requests=24)[source]#

Plan the current TEPCO monthly export format (February 2024 onward).

Parameters:
  • start (date)

  • end (date)

  • maximum_requests (int)

Return type:

tuple[str, …]

energy_data_retrieval.sources.tepco.client.parse_generation_csv(data, *, include_flows=False, maximum_rows=1000000)[source]#

Parse the declared CSV units, preserving half-hour average power.

CSV starts with a physical-unit row and a Japanese header. Raw bytes may be CP932; no lossy replacement is used. MW averages are not interval MWh. Signed storage, net imports and curtailment are available only with include_flows; they retain explicit flow types. Demand and the supplied total are excluded.

Parameters:
  • data (bytes | str)

  • include_flows (bool)

  • maximum_rows (int)

Return type:

DataFrame

class energy_data_retrieval.sources.tepco.client.TEPCOClient(http, *, maximum_requests=24, maximum_rows=1000000)[source]#

Bases: object

Download bounded monthly native-encoding CSV files with byte provenance.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

generation(start, end, *, include_flows=False)[source]#

Fetch inclusive Japanese calendar dates; timestamps are interval starts.

Parameters:
  • start (date)

  • end (date)

  • include_flows (bool)

Return type:

GenerationResult