From ceac4da2139bb071c6c7659a5c0ceb202270461f Mon Sep 17 00:00:00 2001 From: Daniel Muldrew Date: Thu, 2 Apr 2020 13:17:05 -0700 Subject: [PATCH] chore: create a design folder for capacity planning, design transmission, scenario info --- powersimdata/design/__init__.py | 1 + .../clean_capacity_scaling.py} | 4 +- .../demo/Eastern Scenario Take 2.csv | 0 .../demo/EasternCapacityScaling.ipynb | 0 .../{input => design}/design_transmission.py | 0 .../save_files/__init__.py | 0 .../{scenario => design}/scenario_info.py | 0 .../tests/__init__.py | 0 .../tests/test_case_input_output.csv | 0 .../tests/test_design_transmission.py | 2 +- .../tests/test_object_persistence.py | 2 +- .../tests/test_resource_target_manager.py | 2 +- .../tests/test_scenario_info.py | 2 +- .../tests/test_strategies.py | 2 +- .../tests/test_target_manager_input.py | 2 +- powersimdata/input/change_table.py | 6 +- powersimdata/scaling/__init__.py | 1 - .../clean_capacity_scaling/__init__.py | 1 - .../Capacity_Scaling_Western_Test_Case.xlsx | Bin 13777 -> 0 bytes .../Clean_Capacity_Scaling_TestCase_Data.xlsx | Bin 23103 -> 0 bytes ...ing Requirements for RenGen Scenarios.docx | Bin 15224 -> 0 bytes .../save_files/Pacific.json | 72 ------------------ .../save_files/Pacific.pkl | Bin 931 -> 0 bytes .../tests/test_bulk_input.xlsx | Bin 10928 -> 0 bytes .../tests/test_case_input_output.xlsx | Bin 14455 -> 0 bytes 25 files changed, 12 insertions(+), 85 deletions(-) create mode 100644 powersimdata/design/__init__.py rename powersimdata/{scaling/clean_capacity_scaling/auto_capacity_scaling.py => design/clean_capacity_scaling.py} (99%) rename powersimdata/{scaling/clean_capacity_scaling => design}/demo/Eastern Scenario Take 2.csv (100%) rename powersimdata/{scaling/clean_capacity_scaling => design}/demo/EasternCapacityScaling.ipynb (100%) rename powersimdata/{input => design}/design_transmission.py (100%) rename powersimdata/{scaling/clean_capacity_scaling => design}/save_files/__init__.py (100%) rename powersimdata/{scenario => design}/scenario_info.py (100%) rename powersimdata/{scaling/clean_capacity_scaling => design}/tests/__init__.py (100%) rename powersimdata/{scaling/clean_capacity_scaling => design}/tests/test_case_input_output.csv (100%) rename powersimdata/{input => design}/tests/test_design_transmission.py (99%) rename powersimdata/{scaling/clean_capacity_scaling => design}/tests/test_object_persistence.py (98%) rename powersimdata/{scaling/clean_capacity_scaling => design}/tests/test_resource_target_manager.py (98%) rename powersimdata/{scenario => design}/tests/test_scenario_info.py (99%) rename powersimdata/{scaling/clean_capacity_scaling => design}/tests/test_strategies.py (99%) rename powersimdata/{scaling/clean_capacity_scaling => design}/tests/test_target_manager_input.py (96%) delete mode 100644 powersimdata/scaling/__init__.py delete mode 100644 powersimdata/scaling/clean_capacity_scaling/__init__.py delete mode 100644 powersimdata/scaling/clean_capacity_scaling/data/Capacity_Scaling_Western_Test_Case.xlsx delete mode 100644 powersimdata/scaling/clean_capacity_scaling/data/Clean_Capacity_Scaling_TestCase_Data.xlsx delete mode 100644 powersimdata/scaling/clean_capacity_scaling/data/Coding Requirements for RenGen Scenarios.docx delete mode 100644 powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.json delete mode 100644 powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.pkl delete mode 100644 powersimdata/scaling/clean_capacity_scaling/tests/test_bulk_input.xlsx delete mode 100644 powersimdata/scaling/clean_capacity_scaling/tests/test_case_input_output.xlsx diff --git a/powersimdata/design/__init__.py b/powersimdata/design/__init__.py new file mode 100644 index 000000000..a9a2c5b3b --- /dev/null +++ b/powersimdata/design/__init__.py @@ -0,0 +1 @@ +__all__ = [] diff --git a/powersimdata/scaling/clean_capacity_scaling/auto_capacity_scaling.py b/powersimdata/design/clean_capacity_scaling.py similarity index 99% rename from powersimdata/scaling/clean_capacity_scaling/auto_capacity_scaling.py rename to powersimdata/design/clean_capacity_scaling.py index dac6c7f9d..44406125c 100644 --- a/powersimdata/scaling/clean_capacity_scaling/auto_capacity_scaling.py +++ b/powersimdata/design/clean_capacity_scaling.py @@ -1,4 +1,4 @@ -from powersimdata.scenario.scenario_info import ScenarioInfo +from powersimdata.design.scenario_info import ScenarioInfo import pandas as pd import jsonpickle import json @@ -555,7 +555,7 @@ def add_resource_manager(self, resource_manager): """ Sets the resources property equal to a resource manager object which contains scenario resource information - :param (powersimdata.scaling.clean_capacity_scaling + :param (powersimdata.scaling.generation .auto_capacity_scaling.ResourceManager) resource_manager: resource manager object with scenario resource information """ diff --git a/powersimdata/scaling/clean_capacity_scaling/demo/Eastern Scenario Take 2.csv b/powersimdata/design/demo/Eastern Scenario Take 2.csv similarity index 100% rename from powersimdata/scaling/clean_capacity_scaling/demo/Eastern Scenario Take 2.csv rename to powersimdata/design/demo/Eastern Scenario Take 2.csv diff --git a/powersimdata/scaling/clean_capacity_scaling/demo/EasternCapacityScaling.ipynb b/powersimdata/design/demo/EasternCapacityScaling.ipynb similarity index 100% rename from powersimdata/scaling/clean_capacity_scaling/demo/EasternCapacityScaling.ipynb rename to powersimdata/design/demo/EasternCapacityScaling.ipynb diff --git a/powersimdata/input/design_transmission.py b/powersimdata/design/design_transmission.py similarity index 100% rename from powersimdata/input/design_transmission.py rename to powersimdata/design/design_transmission.py diff --git a/powersimdata/scaling/clean_capacity_scaling/save_files/__init__.py b/powersimdata/design/save_files/__init__.py similarity index 100% rename from powersimdata/scaling/clean_capacity_scaling/save_files/__init__.py rename to powersimdata/design/save_files/__init__.py diff --git a/powersimdata/scenario/scenario_info.py b/powersimdata/design/scenario_info.py similarity index 100% rename from powersimdata/scenario/scenario_info.py rename to powersimdata/design/scenario_info.py diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/__init__.py b/powersimdata/design/tests/__init__.py similarity index 100% rename from powersimdata/scaling/clean_capacity_scaling/tests/__init__.py rename to powersimdata/design/tests/__init__.py diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_case_input_output.csv b/powersimdata/design/tests/test_case_input_output.csv similarity index 100% rename from powersimdata/scaling/clean_capacity_scaling/tests/test_case_input_output.csv rename to powersimdata/design/tests/test_case_input_output.csv diff --git a/powersimdata/input/tests/test_design_transmission.py b/powersimdata/design/tests/test_design_transmission.py similarity index 99% rename from powersimdata/input/tests/test_design_transmission.py rename to powersimdata/design/tests/test_design_transmission.py index 36b1499ff..cdb34fef3 100644 --- a/powersimdata/input/tests/test_design_transmission.py +++ b/powersimdata/design/tests/test_design_transmission.py @@ -6,7 +6,7 @@ from powersimdata.tests.mock_grid import MockGrid from postreise.tests.mock_scenario import MockScenario from powersimdata.tests.mock_change_table import MockChangeTable -from powersimdata.input.design_transmission import ( +from powersimdata.design.design_transmission import ( _find_branches_connected_to_bus, _find_first_degree_branches, _find_stub_degree, _find_capacity_at_bus, scale_renewable_stubs, _identify_mesh_branch_upgrades, _increment_branch_scaling) diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_object_persistence.py b/powersimdata/design/tests/test_object_persistence.py similarity index 98% rename from powersimdata/scaling/clean_capacity_scaling/tests/test_object_persistence.py rename to powersimdata/design/tests/test_object_persistence.py index 0e180ee07..665dbdcc7 100644 --- a/powersimdata/scaling/clean_capacity_scaling/tests/test_object_persistence.py +++ b/powersimdata/design/tests/test_object_persistence.py @@ -1,4 +1,4 @@ -from powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling \ +from powersimdata.design.clean_capacity_scaling \ import TargetManager, AbstractStrategyManager, Resource import jsonpickle import json diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_resource_target_manager.py b/powersimdata/design/tests/test_resource_target_manager.py similarity index 98% rename from powersimdata/scaling/clean_capacity_scaling/tests/test_resource_target_manager.py rename to powersimdata/design/tests/test_resource_target_manager.py index 2c6b54b1f..069c06e37 100644 --- a/powersimdata/scaling/clean_capacity_scaling/tests/test_resource_target_manager.py +++ b/powersimdata/design/tests/test_resource_target_manager.py @@ -1,4 +1,4 @@ -from powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling\ +from powersimdata.design.clean_capacity_scaling\ import Resource, TargetManager from pytest import approx from unittest.mock import patch diff --git a/powersimdata/scenario/tests/test_scenario_info.py b/powersimdata/design/tests/test_scenario_info.py similarity index 99% rename from powersimdata/scenario/tests/test_scenario_info.py rename to powersimdata/design/tests/test_scenario_info.py index d3035843e..b3f301bcf 100644 --- a/powersimdata/scenario/tests/test_scenario_info.py +++ b/powersimdata/design/tests/test_scenario_info.py @@ -1,7 +1,7 @@ import unittest import pandas as pd -from powersimdata.scenario.scenario_info import ScenarioInfo +from powersimdata.design.scenario_info import ScenarioInfo from postreise.tests.mock_scenario import MockScenario mock_plant = { diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_strategies.py b/powersimdata/design/tests/test_strategies.py similarity index 99% rename from powersimdata/scaling/clean_capacity_scaling/tests/test_strategies.py rename to powersimdata/design/tests/test_strategies.py index 310d6fff6..35f0c6247 100644 --- a/powersimdata/scaling/clean_capacity_scaling/tests/test_strategies.py +++ b/powersimdata/design/tests/test_strategies.py @@ -1,4 +1,4 @@ -from powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling\ +from powersimdata.design.clean_capacity_scaling\ import Resource, TargetManager, AbstractStrategyManager, \ IndependentStrategyManager, CollaborativeStrategyManager from pytest import approx, raises diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_target_manager_input.py b/powersimdata/design/tests/test_target_manager_input.py similarity index 96% rename from powersimdata/scaling/clean_capacity_scaling/tests/test_target_manager_input.py rename to powersimdata/design/tests/test_target_manager_input.py index 5876a94c8..40b7387e1 100644 --- a/powersimdata/scaling/clean_capacity_scaling/tests/test_target_manager_input.py +++ b/powersimdata/design/tests/test_target_manager_input.py @@ -1,4 +1,4 @@ -from powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling \ +from powersimdata.design.clean_capacity_scaling \ import AbstractStrategyManager, TargetManager import pandas as pd diff --git a/powersimdata/input/change_table.py b/powersimdata/input/change_table.py index 94a5c4176..a1841fc8b 100644 --- a/powersimdata/input/change_table.py +++ b/powersimdata/input/change_table.py @@ -1,7 +1,7 @@ import os import pickle -from powersimdata.input.design_transmission import ( +from powersimdata.design.design_transmission import ( scale_congested_mesh_branches, scale_renewable_stubs) from powersimdata.input.grid import Grid from powersimdata.utility import const @@ -296,7 +296,7 @@ def scale_demand(self, zone_name=None, zone_id=None): def scale_renewable_stubs(self, **kwargs): """Scales undersized stub branches connected to renewable generators. - Optional kwargs as documented in powersimdata.input.design_transmission + Optional kwargs as documented in powersimdata.design.design_transmission """ scale_renewable_stubs(self, **kwargs) @@ -304,7 +304,7 @@ def scale_congested_mesh_branches(self, ref_scenario, **kwargs): """Scales congested branches based on previous scenario results. :param powersimdata.scenario.scenario.Scenario ref_scenario: the reference scenario to be used in determining branch scaling. - Optional kwargs as documented in powersimdata.input.design_transmission + Optional kwargs as documented in powersimdata.design.design_transmission """ scale_congested_mesh_branches(self, ref_scenario, **kwargs) diff --git a/powersimdata/scaling/__init__.py b/powersimdata/scaling/__init__.py deleted file mode 100644 index 591a16aab..000000000 --- a/powersimdata/scaling/__init__.py +++ /dev/null @@ -1 +0,0 @@ -__all__ = ['clean_capacity_scaling'] diff --git a/powersimdata/scaling/clean_capacity_scaling/__init__.py b/powersimdata/scaling/clean_capacity_scaling/__init__.py deleted file mode 100644 index 5f64c3007..000000000 --- a/powersimdata/scaling/clean_capacity_scaling/__init__.py +++ /dev/null @@ -1 +0,0 @@ -__all__ = ['tests', 'data', 'demo', 'save_files'] diff --git a/powersimdata/scaling/clean_capacity_scaling/data/Capacity_Scaling_Western_Test_Case.xlsx b/powersimdata/scaling/clean_capacity_scaling/data/Capacity_Scaling_Western_Test_Case.xlsx deleted file mode 100644 index f77b1cc6808a5373d75f8c823339176ce03c187d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13777 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 Vtz{16c* z_SsKHo|E!Yz#u39U;q#R004vl&a9e6o`3)V!Jq&D$N&&PT0(ZV&L+0bddeR5CQdrE z?l#s0`5-_Pxd1>v?f>WaZ#)AP%9FA{3}y7(miaFvq-R)IAtvEFuf}MK1>t`4+M<8aE#dCE)_s0+x&z7K zS~3jee#0;|IxBZnczBf`%zG+CH$7{XNtR$_Ek>%BXnWj;6(XB5mG^>lT4S^gr1E1{ z0G2qINGD^?gM_bOKzaOT3h2KVcdL?&o#?A+LcCsiz{jPF#xc_a*j>_~nghqU))KHupB(L+*^Qj4|@jsVx}FArRi+ z;J+;E1;#U|T@GR@sNH#A4*e42BN(PC8)r!yPepDJ=M|l!<(VlcoQ(xJg?=-iZ{tkP zh(Jc%>*kyJQ?^J7KZk7({Yy8aJU{~Po3{~3Bkf{a{0Jxu7e_(#~t^Wx@j1VJe`0r7T1WnX`Z4fw{G z0ut=aZgLz1Wvn1zF~3gVkFoVl?wGR?!lymviYO!$F5)J)%FvWI2N!TkGRI_5hlFw&N#~QmXbWF(QRVU`CH*yglSqeEJ)@rsBR8XgQTQcWKkD_L zNkT=JgW>@U03i1xbMQYi<8DpoX6I;SXlG~jFHNgZ*|sZSNATr4{Q^HIZU=`tQiGt> z0flH2zbvzC-%Jsw0?*V(r8kpKEL;2j93qogzdTDi*A=$Dz~t>pdmYO3TVrXw6&IOy z$0qhRB@Su=rPFASm`!QlfQg@#noBM`qKTPBzML(N+VeFN<65d0B>C&waH0{8^S{p+Y zo=F$a-BznOhc}mTfYKHk=$}agwd3?xuT38%hmDLb3P;OGhOR3kyuf{m$?~W2=W8;s zhqD8kZ&zcfKDPj0`Dc6S*^OqMDR zitWZsH#ivuGujEXVMsg*qQ>L0u<8)O8OGn)J1O{Gy76?LIoE!V)(MbnRd2J8+LrDQ zCys3w77BH?VMgN1!@ED`qwjF9@O7jiVmmdnQ9B?rJqs>pg{-8>-d!U^L*xf0 z3aEPFQk-CTe91|x8N1c!b785!3hu9NeM_@^)8klgtMr@=w3|7vcT=YiAiZ|No3Q0iZ_1gr&5$xj$QTpY?Gh05w5ol*yZymX}< ztZu-}NhFXaYT%JInHqQI7f!3@7MT?+e%hB$X~BfGq`M@<6B0eb)l$^b?(NnFE`Xls z$*eg<+L)DbpUCPyDNYmcfIZZhO_Mz>FkQBuXXvuKOw2gpGCeYyUCAA-a^I@>EHo3o z@yUvB0?zIh6sW5Tk8lY@g1;zl&bSDAA}nAa-1x|_-V$oi%0D<}X5eM7nI?c_pPIFv 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 diff --git a/powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.json b/powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.json deleted file mode 100644 index 76159b997..000000000 --- a/powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.json +++ /dev/null @@ -1,72 +0,0 @@ -{ - "allowed_resources": [ - "solar", - "wind", - "geo" - ], - "ce_category": "renewables", - "ce_target": 50000.0, - "ce_target_fraction": 0.25, - "external_ce_historical_amount": 0, - "py/object": "powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling.TargetManager", - "region_name": "Pacific", - "resources": { - "geo": { - "addl_curtailment": 0, - "name": "geo", - "no_congestion_cap_factor": 1, - "prev_cap_factor": 1, - "prev_capacity": 4000, - "prev_curtailment": 0, - "prev_generation": 8000, - "prev_scenario_num": 3, - "py/object": "powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling.Resource" - }, - "hydro": { - "addl_curtailment": 0, - "name": "hydro", - "no_congestion_cap_factor": 1, - "prev_cap_factor": 1, - "prev_capacity": 3900, - "prev_curtailment": 0, - "prev_generation": 7000, - "prev_scenario_num": 3, - "py/object": "powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling.Resource" - }, - "nuclear": { - "addl_curtailment": 0, - "name": "nuclear", - "no_congestion_cap_factor": 1, - "prev_cap_factor": 1, - "prev_capacity": 4300, - "prev_curtailment": 0, - "prev_generation": 6500, - "prev_scenario_num": 3, - "py/object": "powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling.Resource" - }, - "solar": { - "addl_curtailment": 0, - "name": "solar", - "no_congestion_cap_factor": 0.25, - "prev_cap_factor": 0.215379, - "prev_capacity": 3700, - "prev_curtailment": 0.138483, - "prev_generation": 7000, - "prev_scenario_num": 3, - "py/object": "powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling.Resource" - }, - "wind": { - "addl_curtailment": 0, - "name": "wind", - "no_congestion_cap_factor": 0.4, - "prev_cap_factor": 0.347855, - "prev_capacity": 3600, - "prev_curtailment": 0.130363, - "prev_generation": 11000, - "prev_scenario_num": 3, - "py/object": "powersimdata.scaling.clean_capacity_scaling.auto_capacity_scaling.Resource" - } - }, - "solar_percentage": null, - "total_demand": 200000 -} \ No newline at end of file diff --git a/powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.pkl b/powersimdata/scaling/clean_capacity_scaling/save_files/Pacific.pkl deleted file mode 100644 index 4be452460628e61b4769d96a507a783da876a58a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 931 zcmb_bzi-n(6n02|(6mY10;Ne>3WY*oi24U0C5Ryskx_*hZb8ae(POQvG3@`(N35gN0@Fy_xd}&A|R&KD*@4fH4?|tw5r05Ohh^ZuueX40I@n{r^ zpyfr33fH4U>VsPe5X?`T4V#`2-W6j zcc7@J@fbMWZGXiKF0z7;zZJ03?fiN;N$lW@J=RPKWW@>|CR(ZxJ9lX;Q=y^MvxtpV ziHxXnhfH})XlxEv?~-+l(=BNV393TriZq7vy&~B{bpod< zMZl8W#C*W+01cH2wq|~ovCc3|Zw1sGT_M%E@Dx?=wm&|9X1(ek%+di9Oi?qWhC>?0 z-w9o+G!3H|Er#uG`@`EWM@z4NnmqM=oX}i;r)Q;oUgdd{7c$sw@=g50E;tJP{vuyT zyyn;yjuO7zzV-5;aL60Z?;9MM-@kcR|NP^aPe^P-axsHTIf*?X=@k%tT;+A#G@Q;Z z-|ktHdNW%-_LYP^gS?!6DBp?6) diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_bulk_input.xlsx b/powersimdata/scaling/clean_capacity_scaling/tests/test_bulk_input.xlsx deleted file mode 100644 index b7674f0140be8277d54d0f3c3c4534817f5a7870..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10928 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 ML)F;xSJVplf5&hW(EtDd diff --git a/powersimdata/scaling/clean_capacity_scaling/tests/test_case_input_output.xlsx b/powersimdata/scaling/clean_capacity_scaling/tests/test_case_input_output.xlsx deleted file mode 100644 index 5caca45b32d8aad1f480da65afcfd5c8ada4530a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14455 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