note

Feeder Load Analysis is a new feature and may have some issues. If you encounter any problems or have questions, please contact Zepben support.

Feeder Load Analysis (Segment Level Loading)

Feeder level analysis, also known as Segment Level Loading is a tool that is built for finding the key parameters for a given list of feeders and/or substations.

Key Results:

• Maxmimum demand
• Maximum export
• Minimum usage/export (smallest absolute value that is not zero)

How to run

This guide assumes you have the basic set up configured. For more information on how to set up the basic configuration, see the How to Run a Work Package guide.

1. Clone the repo 'ewb-sdk-examples-python'.

2. As per the readme, install the required dependencies by running the command pip install -e .. If you encounter any issues with installing the dependencies, please talk to your System Administrator for assistance.

3. Open the file request_feeder_load_analysis_study.py in your IDE of choice and modify the parameters to match your needs (see below).

4. Run the file.

Here is an example of a feeder load analysis input that can be used to run the analysis:

class FeederLoadAnalysisInput:
    feeders=["feeder1", "feeder2"],
    substations=None,
    subGeographicalRegions=None,
    geographicalRegions=None,
    startDate="2022-04-01",
    endDate="2022-12-31",
    fetchLvNetwork=True,
    processFeederLoads=True,
    processCoincidentLoads=True,
    aggregateAtFeederLevel=False,
    output="TestResults1"

Configuration Parameters

Field	Type	Description
feeders	[List[str]]	Optional (must have at least 1 of these 4 parameters) - The mRIDs of feeders to solve for feeder load analysis
substations	[List[str]]	Optional (must have at least 1 of these 4 parameters) - The mRIDs of substations to solve for feeder load analysis
subGeographicalRegions	[List[str]]	Optional (must have at least 1 of these 4 parameters) - The mRIDs of sub-Geographical Region to solve for feeder load analysis
geographicalRegions	[List[str]]	Optional (must have at least 1 of these 4 parameters) - The mRIDs of Geographical Region to solve for feeder load analysis
startDate	str	Start date for this analysis
endDate	str	End date for this analysis
fetchLvNetwork	bool	Whether to stop analysis at distribution transformer
processFeederLoads	bool	Whether to include values corresponding to feeder event time points in the report
processCoincidentLoads	bool	Whether to include values corresponding to conductor event time points in the report
aggregateAtFeederLevel	bool	Request for a report which aggregate all downstream load at the feeder level
output	str	The file name of the resulting study

Report Outputs

Field Name	Description
ID	mRID / unique identifier for the asset or segment
ASSET_TYPE	Type of asset (e.g., transformer, feeder)
FEEDER_LARGEST_IMPORTED_KVA	Demand of this asset at its feeders peak demand, in kVA
FEEDER_LARGEST_IMPORT_TIME	Timestamp of the feeder peak demand, in ISO 8601 time format (local time)
COINCIDENT_LARGEST_IMPORTED_KVA	The name is possibly confusing, it refers to the peak demand of this individual asset, in kVA
COINCIDENT_LARGEST_IMPORT_TIME	Timestamp of the individual asset peak demand, in ISO 8601 time format (local time)
FEEDER_LARGEST_EXPORT_KVA	Demand of this asset at its feeders peak export, in kVA
FEEDER_LARGEST_EXPORT_TIME	Timestamp of the feeder peak export, in ISO 8601 time format (local time)
COINCIDENT_LARGEST_EXPORTED_KVA	The name is possibly confusing, it refers to the peak export of this individual asset, in kVA
COINCIDENT_LARGEST_EXPORT_TIME	Timestamp of the individual asset peak export, in ISO 8601 time format (local time)
FEEDER_LEAST_UTILIZATION_READING	When the feeder is least utilized (non-zero), what is the load of this asset, in kVA
FEEDER_LEAST_UTILIZATION_TIME	Timestamp of the minimum absolute utilization (non-zero) reading at the feeder head
COINCIDENT_LEAST_UTILIZATION_READING	The name is possibly confusing, it refers to the lowest load of this individual asset, in kVA
COINCIDENT_LEAST_UTILIZATION_TIME	Timestamp of the minimum absolute utilization reading at the this individual asset level
FEEDER_LARGEST_IMPORT_UTILIZATION_PERCENTAGE	Maximum import utilization percentage at the feeder level
COINCIDENT_LARGEST_IMPORT_UTILIZATION_PERCENTAGE	Maximum import utilization percentage at the individual asset level
FEEDER_LARGEST_EXPORT_UTILIZATION_PERCENTAGE	Maximum export utilization percentage at the feeder level
COINCIDENT_LARGEST_EXPORT_UTILIZATION_PERCENTAGE	Maximum export utilization percentage at the individual asset level
FEEDER_LEAST_UTILIZATION_PERCENTAGE	Minimum utilization percentage at the feeder level
COINCIDENT_LEAST_UTILIZATION_PERCENTAGE	Minimum utilization percentage at the individual asset level
RATING_KVA	Rated kVA capacity of the asset
OPERATING_VOLTAGE	Operating voltage of the asset
STATUS	Status of the asset (e.g., in service, out of service, etc)
FEEDER	Name or identifier of the feeder this asset belongs to
LENGTH	Length of the asset (e.g., conductor length in meters (or kilometers, if configured this way, consult System Administrator for details))

note

Field names have been kept as is for compatibility reasons, however, some names may not do what you expect. Please Contact Zepben Support if using this feature and are unsure about any of the field names or outputs.