Base case feeder population

Module contents

Introduction

This is the feeder population module for the base test case. This file performs the pre-simulation step for running EV-Ecosim.

It takes in a base Gridlab-D Model (GLM) file (for example, IEEE123.glm), and modifies that file by including secondary distribution, home loads, and EV Charging station and transformers.

Once this script is done running, it reads and writes new GLM as <initial_glm_name>_populated.glm and <initial_glm_name>_secondary.glm, and saves them within the test case folder. These saved files are used to run the simulation. These files are saved in the ‘test_case_dir’ field specified in config.txt.

Input file description

Config config.txt: configuration file describing the pre-simulation parameters. This can be modified directly or with the help of our Graphic User Interface (GUI). The return outputs of this module are files that are read in to run the EV-Ecosim environment.

Output file description

real_power.csv - Real power; this is residential real load timeseries file per node_name/bus

reactive_power.csv - Reactive power; this is residential reactive load timeseries file per node_name/bus.

XXXX.glm - GridLabD model files. These are usually the synthetic feeders.

Submodules

test_cases.base_case.feeder_population.feeder_population module

test_cases.base_case.feeder_population.glm_mod_functions module

Functions for modifying GridLAB-D power system simulation models

test_cases.base_case.feeder_population.glm_mod_functions.load_base_glm(base_file_dir, base_glm_file)

Loads the glm as list and populates it into dict and returns the output

Parameters:
  • base_file_dir

  • base_glm_file

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.replace_load_w_meter(glm_dict, match_str, rep_str, obj_type)

Replace all instances of load in glm_dict with meter.

Parameters:
  • glm_dict

  • match_str

  • rep_str

  • obj_type

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.replace_load_w_meter_old(glm_dict, match_str, rep_str, obj_type)

Replace all instances of load in glm_dict with meter.

Parameters:
  • glm_dict

  • match_str

  • rep_str

  • obj_type

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.write_base_glm(glm_dict, obj_type, globals_list, include_list, out_dir, file_name, sync_list)

Writes the glm file from the dict structure.

Parameters:
  • glm_dict

  • obj_type

  • globals_list

  • include_list

  • out_dir

  • file_name

  • sync_list

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.write_class_dict(file, gld_dict, class_name)

Write dictionary corresponding to GLD class to .glm file.

Parameters:
  • file

  • gld_dict

  • class_name

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.write_clock_dict(file, gld_dict)

Write dictionary corresponding to GLD clock to .glm file.

Parameters:
  • file

  • gld_dict

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.write_filter_dict(file, gld_dict, class_name)

Write dictionary corresponding to GLD filter to .glm file.

Parameters:
  • file

  • gld_dict

  • class_name

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.write_mod_dict(file, gld_dict, mod_name)

Write dictionary corresponding to GLD module to .glm file.

Parameters:
  • file

  • gld_dict

  • mod_name

Returns:

test_cases.base_case.feeder_population.glm_mod_functions.write_obj_dict(file, gld_dict, dict_key, obj_type)

Write dictionary corresponding to GLD objects to .glm file.

Parameters:
  • file

  • gld_dict

  • dict_key

  • obj_type

Returns: