powersimdata.design package

Subpackages

• powersimdata.design.compare package
  • Submodules
  • powersimdata.design.compare.generation module
    • calculate_plant_difference()
  • powersimdata.design.compare.helpers module
  • powersimdata.design.compare.transmission module
    • calculate_branch_difference()
    • calculate_dcline_difference()
  • Module contents
• powersimdata.design.generation package
  • Subpackages
    • powersimdata.design.generation.tests package
      • Submodules
      • powersimdata.design.generation.tests.test_clean_capacity_scaling module
      • powersimdata.design.generation.tests.test_cost_curves module
      • powersimdata.design.generation.tests.test_curtailment module
      • Module contents
  • Submodules
  • powersimdata.design.generation.clean_capacity_scaling module
    • add_demand_to_targets()
    • add_new_capacities_collaborative()
    • add_new_capacities_independent()
    • add_resource_data_to_targets()
    • add_shortfall_to_targets()
    • calculate_clean_capacity_scaling()
    • calculate_overall_shortfall()
    • create_change_table()
    • load_targets_from_csv()
  • powersimdata.design.generation.cost_curves module
    • build_supply_curve()
    • check_supply_data()
    • get_supply_data()
    • ks_test()
    • lower_bound_index()
    • plot_capacity_vs_price()
    • plot_linear_vs_quadratic_terms()
  • powersimdata.design.generation.curtailment module
    • temporal_curtailment()
  • Module contents
• powersimdata.design.investment package
  • Subpackages
    • powersimdata.design.investment.tests package
      • Submodules
      • powersimdata.design.investment.tests.test_investment_costs module
      • Module contents
  • Submodules
  • powersimdata.design.investment.const module
  • powersimdata.design.investment.create_mapping_files module
    • bus_to_neem_reg()
    • bus_to_reeds_reg()
    • points_to_polys()
    • sjoin_nearest()
    • write_bus_neem_map()
    • write_bus_reeds_map()
    • write_poly_shapefile()
  • powersimdata.design.investment.inflation module
    • calculate_inflation()
  • powersimdata.design.investment.investment_costs module
    • append_keep_index_name()
    • calculate_ac_inv_costs()
    • calculate_dc_inv_costs()
    • calculate_gen_inv_costs()
    • merge_keep_index()
  • Module contents
• powersimdata.design.tests package
  • Submodules
  • powersimdata.design.tests.test_scenario_info module
    • TestScenarioInfo
      • TestScenarioInfo.setUp()
      • TestScenarioInfo.test_get_available_resource()
      • TestScenarioInfo.test_get_capacity()
      • TestScenarioInfo.test_get_capacity_factor()
      • TestScenarioInfo.test_get_curtailment()
      • TestScenarioInfo.test_get_demand()
      • TestScenarioInfo.test_get_generation()
      • TestScenarioInfo.test_get_no_congest_capacity_factor()
      • TestScenarioInfo.test_get_profile_resource()
  • Module contents
• powersimdata.design.transmission package
  • Subpackages
    • powersimdata.design.transmission.tests package
      • Submodules
      • powersimdata.design.transmission.tests.test_mwmiles module
      • powersimdata.design.transmission.tests.test_statelines module
      • powersimdata.design.transmission.tests.test_substations module
      • powersimdata.design.transmission.tests.test_upgrade module
      • Module contents
  • Submodules
  • powersimdata.design.transmission.mwmiles module
    • calculate_mw_miles()
  • powersimdata.design.transmission.statelines module
    • classify_interstate_intrastate()
  • powersimdata.design.transmission.substations module
    • calculate_substation_capacity()
  • powersimdata.design.transmission.upgrade module
    • get_branches_by_area()
    • scale_congested_mesh_branches()
    • scale_renewable_stubs()
  • powersimdata.design.transmission.zones module
    • calculate_interzone_capacity()
  • Module contents

Submodules

powersimdata.design.mimic_grid module

powersimdata.design.mimic_grid.mimic_generation_capacity(base_grid, ref_grid)

Given a base grid and a reference grid, determine zone and plant scaling factors such that the combination, when applied to the base grid, produces the reference grid.

Parameters:

• base_grid (powersimdata.input.grid.Grid) – the base grid (unscaled).

• ref_grid (powersimdata.input.grid.Grid) – the base grid (unscaled).

Returns:

(dict) – dictionary of plant/zone scaling factors in a format matching ct in powersimdata.input.change_table.ChangeTable.

powersimdata.design.scenario_info module

class powersimdata.design.scenario_info.ScenarioInfo(scenario)

Bases: object

Gather information from previous scenarios for capacity scaling.

Parameters:

scenario (powersimdata.scenario.scenario.Scenario) – scenario instance

Raises:

TypeError – if the scenario is not in ‘analyze’ state.

area_to_loadzone(area, area_type=None)

Map the query area to a list of loadzones. For more info, see

powersimdata.network.model.area_to_loadzone().

Parameters:

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(set) – set of loadzones associated to the query area

get_available_resource(area, area_type=None)

Find the available resources of a specific area in the grid of the

given scenario

Parameters:

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(list) – a list of available resources in the query area

get_capacity(gentype, area, area_type=None)

Calculate the total capacity of the query gentype in the query area

of the given scenario

Parameters:

• gentype (str) – type of generator

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – total capacity (in MW) based on the specified parameters

get_capacity_factor(gentype, area, start_time, end_time, area_type=None)

Calculate the capacity factor of the query gentype in the

query area during the query time range of the given scenario

Parameters:

• gentype (str) – type of generator

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• start_time (str) – start timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• end_time (str) – end timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – capacity factor based on the specified parameters

Raises:

ZeroDivisionError – if no generator of gentype is found in the area

get_curtailment(gentype, area, start_time, end_time, area_type=None)

Calculate the curtailment of the query gentype in the query

area during the query time range of the given scenario

Parameters:

• gentype (str) – type of generator

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• start_time (str) – start timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• end_time (str) – end timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – curtailment percentage (rounded up to two decimals) based on the specified parameters

get_demand(area, start_time, end_time, area_type=None)

Calculate the total demand of the query area during the query time

range of the given scenario

Parameters:

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• start_time (str) – start timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• end_time (str) – end timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – total demand (in MWh) based on the specified parameters

get_generation(gentype, area, start_time, end_time, area_type=None)

Calculate the total generation of the query gentype in the query

area during the query time range of the given scenario

Parameters:

• gentype (str) – type of generator

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• start_time (str) – start timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• end_time (str) – end timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – total generation (in MWh) based on the specified parameters

get_no_congest_capacity_factor(gentype, area, start_time, end_time, area_type=None)

Calculate the no congestion capacity factor of the query gentype

in the query area during the query time range of the given scenario

Parameters:

• gentype (str) – type of generator

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• start_time (str) – start timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• end_time (str) – end timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – no congestion capacity factor based on the specified parameters

get_profile_resource(gentype, area, start_time, end_time, area_type=None)

Calculate the total resource from profile of the query gentype in

the query area during the query time range of the given scenario

Parameters:

• gentype (str) – type of generator

• area (str) – one of: loadzone, state, state abbreviation, interconnect, ‘all’

• start_time (str) – start timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• end_time (str) – end timestamp in the format ‘YYYY-MM-DD HH:MM:SS’

• area_type (str) – one of: ‘loadzone’, ‘state’, ‘state_abbr’, ‘interconnect’

Returns:

(float) – total resource from profile (in MWh) based on the specified parameters

Raises:

ValueError – if the resource type is invalid

Module contents