NREL-erad 0.0.0a0__py3-none-any.whl → 0.1.0__py3-none-any.whl

NREL_erad-0.0.0a0.dist-info/METADATA

@@ -1,61 +0,0 @@
-Metadata-Version: 2.1
-Name: NREL-erad
-Version: 0.0.0a0
-Summary: Graph based scalable tool for computing equitable         resilience metrics for distribution systems.
-Home-page: https://github.com/nrel/erad
-Author: Kapil Duwadi, Aadil Latif, Kwami Sedzro,  Sherin Ann Abraham, Bryan Palmintier
-Author-email: kapil.duwadi@nrel.gov, aadil.altif@nrel.gov, sherinann.abraham@nrel.gov, kwami.sedzro@nrel.gov, bryan.palmintier@nrel.gov
-Keywords: Resilience,Equity,Python,Power Distribution Systems,Earthquake,Flooding,Fire
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: pytest
-Requires-Dist: networkx
-Requires-Dist: pyyaml
-Requires-Dist: geojson
-Requires-Dist: neo4j-driver
-Requires-Dist: python-dotenv
-Requires-Dist: ditto.py
-Requires-Dist: boto3
-Requires-Dist: botocore
-Requires-Dist: OpenDSSDirect.py
-Requires-Dist: pandas
-Requires-Dist: matplotlib
-Requires-Dist: plotly
-Requires-Dist: shapely
-Requires-Dist: jupyter
-Requires-Dist: geopandas
-Requires-Dist: stateplane
-Requires-Dist: graphdatascience
-Requires-Dist: scipy
-Requires-Dist: geopy
-Requires-Dist: rasterio
-Requires-Dist: xmltodict
-Requires-Dist: pydantic
-Requires-Dist: requests
-Provides-Extra: dev
-Requires-Dist: mkdocs ; extra == 'dev'
-Requires-Dist: mkdocstrings[python] ; extra == 'dev'
-Requires-Dist: mkdocs-material ; extra == 'dev'
-Requires-Dist: mkdocs-jupyter ; extra == 'dev'
-Requires-Dist: pylint ; extra == 'dev'
-Requires-Dist: black ; extra == 'dev'
-
-# ERAD (Equitable Resilience Analysis For Power Distribution System)
-<p align="center"> 
-<img src="logo.svg" width="250" style="display:flex;justify-content:center;">
-<p align="center">Graph based python tool for computing equitable resilience. </p>
-</p>
-
-
-
-[Visit full documentation here.](https://nrel.github.io/erad/)
-
-Understanding the impact of disaster events on people's ability to access critical service is key to designing appropriate programs to minimize the overall impact. Flooded roads, downed power lines, flooded power substation etc. could impact access to critical servies like electricity, food, health and more. The field of disaster modeling is still evolving and so is our understanding of how these events would impact our critical infrastrctures such power grid, hospitals, groceries, banks etc.
-
-ERAD is a free, open-source Python toolkit for computing equity and resilience measures in the face of hazards like earthquakes and flooding. It uses graph database to store data and perform computation at the household level for a variety of critical services that are connected by power distribution network. It uses asset fragility curves, which are functions that relate hazard severity to survival probability for power system assets including cables, transformers, substations, roof-mounted solar panels, etc. recommended in top literature. Programs like undergrounding, microgrid, and electricity backup units for critical infrastructures may all be evaluated using metrics and compared across different neighborhoods to assess their effects on equity and resilience.
-
-ERAD is designed to be used by researchers, students, community stakeholders, distribution utilities to understand and possibly evaluate effectiveness of different post disaster programs to improve resilience and equity. It was funded by National Renewable Energy Laboratory (NREL) and made publicy available with open license.

NREL_erad-0.0.0a0.dist-info/RECORD

@@ -1,42 +0,0 @@
-erad/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/constants.py,sha256=ez019GSfgtzBoewDqMdMQ-5Sv_QCZ4w5rSUHyo50YXw,719
-erad/exceptions.py,sha256=D58HiKlePKLgNgF4bTfA9Wpup4_oazH5y6R_0XGV_Po,2209
-erad/cypher_queries/load_data_v1.cypher,sha256=pLwyaiil2bgJ3GSy0CLod1OcKR8SOroyNPS7iOM5jhE,8131
-erad/data/World_Earthquakes_1960_2016.csv,sha256=FTzg7XibKB6TbCWnLdbpJxK2cCTqpfo80mBYHNL9VVc,2386121
-erad/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/db/credential_model.py,sha256=yFb4aii9C5U46_BNL0hXWSCsKFpxTrUvq-hTbSJopHg,591
-erad/db/disaster_input_model.py,sha256=BVH_eqZ9Z6eUbuktK_AYUi06o6fsRQOUrWU95ULsXsI,637
-erad/db/inject_earthquake.py,sha256=k4bcnFkzBYgveHnCjDDEwwkCpEBG2N0GjZuUKnqNkCU,1700
-erad/db/inject_flooding.py,sha256=2c-BVAasG2Z4nULlXIuwHiMENi6PAH_AALlwQekfWM8,1769
-erad/db/neo4j_.py,sha256=hBzXVxvVatiPZdLVsSgzQhHnbHDxEEZJoJ_P40YVYB8,5223
-erad/db/utils.py,sha256=zbMVKShNK2uTrvQPIdDRlwZGIRdOAwbtGfkaG424piU,455
-erad/db/assets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/db/assets/critical_infras.py,sha256=6Gg39N-Z0L20OfC_1myFSGlohB6KALj7B2A7BPY4850,6072
-erad/db/assets/distribution_lines.py,sha256=QuSJKdQZyNr6hdjVZYu50A8FCQJ4KMDWuj0rN6N26uY,3547
-erad/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/metrics/check_microgrid.py,sha256=5XHGsOB-p1z7PCVW1G8OB5Ev0BS1NXexmj-UOy3Szac,7688
-erad/metrics/metric.py,sha256=Iyjj71FLWSvkOldK_HKvBLKDOzKNQh9qXi-K7urs4BQ,6147
-erad/programs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/programs/backup.py,sha256=-AXOMTsEi0G564A83HCVwnbu4oZjvY4ScaUcHB9nhdw,1971
-erad/programs/microgrid.py,sha256=iLmwrOy0u75BH_Y7eQ6drasULW9DyFJuXfBNDIRbkqI,1670
-erad/scenarios/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/scenarios/abstract_scenario.py,sha256=_Bu6rDYXw7iQdkI6zg83kko_88V8u9HEytZDS0V_4EA,4267
-erad/scenarios/common.py,sha256=SyqhD777TV9SiGxOVBC_YQvSHSpJEYRyEgAcLMW6Z4E,3022
-erad/scenarios/earthquake_scenario.py,sha256=S95ezPnOFHSRAlyU66QlbQeP2fp7DrfPwVdGN-XxmPs,8717
-erad/scenarios/fire_scenario.py,sha256=7L9HdSmZracW8cKS_6kyZmczk6JGehz6vnEHnj7AaPs,7244
-erad/scenarios/flood_scenario.py,sha256=ElHd2rfJjrfjiC9gmr7i8ApdcujoypEQb4s0Ie6jWg4,20336
-erad/scenarios/utilities.py,sha256=MJISX_TDItnvZOK1bJlcHSi455Ho4MgBk29tKn9zRRg,2753
-erad/scenarios/wind_scenario.py,sha256=_2NsBsOqiZ5FskcprbK8OTwp5k4uYVx0o_LRpgaz34s,3946
-erad/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/utils/ditto_utils.py,sha256=Qm2_QLj0O2N_nFp9OQ1zWWWccM6jJ6j_C9yhXxMWhg8,8138
-erad/utils/hifld_utils.py,sha256=IMqhxDZai-2_NrnMRXvzLPH9RF5kbAFDlXKTh2hh0PQ,4983
-erad/utils/opendss_utils.py,sha256=MQOJjSRcfvCFcjsp9IFf8IocsfqtM0ZkFiDSyCTGqbg,10912
-erad/utils/overpass.py,sha256=BiyEN7rDmrJmZ0u1ASiOHJGYf2aEo-Y0_UsWeHV8ERY,2106
-erad/utils/util.py,sha256=OepMubsVYBj_aTmc_qoArsLZLnb9qFkUXMqODp7TE_U,5153
-erad/visualization/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-erad/visualization/plot_graph.py,sha256=fIuicGN_P-ObQSvIwmzQUg9316ByEaOZqEQbinuUeHg,6777
-NREL_erad-0.0.0a0.dist-info/LICENSE.txt,sha256=YhE40B_XkokpkrkfYYs75IWapyRMl_Jdo__vzVWO7eY,1571
-NREL_erad-0.0.0a0.dist-info/METADATA,sha256=ZCpl782OD3xucSUpAyXJWxSYWOJOCT2-l77dUDIUXuY,3612
-NREL_erad-0.0.0a0.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
-NREL_erad-0.0.0a0.dist-info/top_level.txt,sha256=TR5AAzfVy08tAhcPCsDnwvQuVJ2oXZ334IFTb3iHj-k,5
-NREL_erad-0.0.0a0.dist-info/RECORD,,

erad/cypher_queries/load_data_v1.cypher

@@ -1,212 +0,0 @@
-LOAD CSV WITH HEADERS FROM 'file:///buses.csv' AS bus_row 
-WITH bus_row WHERE bus_row.name IS NOT NULL 
-MERGE (bus:Bus {name: bus_row.name, longitude: toFloat(bus_row.longitude), 
-latitude: toFloat(bus_row.latitude)});
-
-LOAD CSV WITH HEADERS FROM 'file:///loads.csv' AS load_row 
-WITH load_row WHERE load_row.name IS NOT NULL 
-MERGE (load:Load {name: load_row.name, kw: toFloat(load_row.kw), 
-kvar: toFloat(load_row.kvar), source: load_row.source, 
-critical_load_factor: toFloat(load_row.critical_load_factor)})
-MERGE (load_bus:Bus {name: load_row.source})
-MERGE (load)-[:CONSUMES_POWER_FROM]->(load_bus);
-
-LOAD CSV WITH HEADERS FROM 'file:///line_sections.csv' AS line_row 
-WITH line_row WHERE line_row.name IS NOT NULL 
-MERGE (from_bus:Bus {name: line_row.source})
-MERGE (to_bus:Bus {name: line_row.target})
-MERGE (from_bus)-[:CONNECTS_TO {name: line_row.name, source: line_row.source, 
-target: line_row.target,ampacity: toFloat(line_row.ampacity),
-height_m: toFloat(line_row.height_m), geom_type: line_row.geom_type}]->(to_bus);
-
-LOAD CSV WITH HEADERS FROM 'file:///transformers.csv' AS xfmr_row
-WITH xfmr_row WHERE xfmr_row.name IS NOT NULL 
-MERGE (from_bus:Bus {name: xfmr_row.source})
-MERGE (to_bus:Bus {name: xfmr_row.target})
-MERGE (from_bus)-[:CONNECTS_TO {name: xfmr_row.name, source: xfmr_row.source, 
-target: xfmr_row.target, kva: xfmr_row.kva, 
-height_m: toFloat(xfmr_row.height_m)}]->(to_bus);
-
-
-LOAD CSV WITH HEADERS FROM 'file:///pv_systems.csv' AS pv_row
-WITH pv_row WHERE pv_row.name IS NOT NULL 
-MERGE (sa:Solar {capacity: toFloat(pv_row.capacity), 
-    name: pv_row.name, owner: pv_row.owner})
-MERGE (ba:Bus {name: pv_row.bus})
-MERGE (lo:Load {name: pv_row.owner})
-MERGE (sa)-[:INJECTS_ACTIVE_POWER_TO]->(ba)
-MERGE (lo)-[:OWNS]->(sa);
-
-LOAD CSV WITH HEADERS FROM 'file:///energy_storage.csv' AS es_row
-WITH es_row WHERE es_row.name IS NOT NULL 
-MERGE (ea:EnergyStorage {kw: toFloat(es_row.kw), name: es_row.name, 
-     owner:es_row.owner})
-MERGE (ba:Bus {name: es_row.bus})
-MERGE (lo:Load {name: es_row.owner})
-MERGE (ea)-[:INJECTS_POWER]->(ba)
-MERGE (ba)-[:CONSUMES_POWER]->(ea)
-MERGE (lo)-[:OWNS]->(ea);
-
-LOAD CSV WITH HEADERS FROM 'file:///substation.csv' AS sub_row
-WITH sub_row WHERE sub_row.name IS NOT NULL 
-MERGE (b:Bus {name: sub_row.name}) 
-SET b:Substation;
-
-MATCH (b:Bus)-[CONSUMES_POWER]-(c:Load)
-SET c.longitude = b.longitude
-SET c.latitude = b.latitude;
-
-MATCH (c:Load)
-WHERE c.latitude IS NULL
-DETACH DELETE c;
-
-LOAD CSV WITH HEADERS FROM 'file:///pharmacies.csv' AS p_row
-WITH p_row WHERE p_row.name IS NOT NULL 
-MERGE (p:Pharmacy {name: (p_row.name + p_row.gid), source:p_row.source, 
-kw:toFloat(p_row.kw), kvar:toFloat(p_row.kvar), 
-backup_capacity_kw:toFloat(p_row.backup_capacity_kw),
-backup: toInteger(p_row.backup), 
-longitude: toFloat(p_row.longitude), latitude: toFloat(p_row.latitude)})
-WITH p
-     MATCH (lo:Load)
-     MERGE (lo)-[:VISITS_FOR_MEDICINE {distance: point.distance(
-        point({longitude: p.longitude, latitude:p.latitude}),
-        point({longitude: lo.longitude, latitude:lo.latitude})
-     )}]->(p);
-
-MATCH (p:Pharmacy)
-WITH p 
-    MATCH (b:Bus {name: p.source})
-    MERGE (b)<-[:GETS_POWER_FROM]-(p);
-
-LOAD CSV WITH HEADERS FROM 'file:///groceries.csv' AS g_row
-WITH g_row WHERE g_row.name IS NOT NULL 
-MERGE (g:Grocery {name: (g_row.name + g_row.gid), source:g_row.source, 
-kw:toFloat(g_row.kw), kvar:toFloat(g_row.kvar), 
-backup_capacity_kw:toFloat(g_row.backup_capacity_kw),
-backup: toInteger(g_row.backup),
-longitude: toFloat(g_row.longitude), latitude: toFloat(g_row.latitude)})
-WITH g
-    MATCH (lo:Load)
-    MERGE (lo)-[:VISITS_FOR_GROCERIES {distance: point.distance(
-       point({longitude: g.longitude, latitude:g.latitude}),
-       point({longitude: lo.longitude, latitude:lo.latitude})
-        )}]->(g);
-
-MATCH (g:Grocery)
-WITH g 
-    MATCH (b:Bus {name: g.source})
-    MERGE (b)<-[:GETS_POWER_FROM]-(g);
-
-LOAD CSV WITH HEADERS FROM 'file:///medical_centers.csv' AS m_row
-WITH m_row WHERE m_row.name IS NOT NULL 
-MERGE (m:Hospital {name: (m_row.name + m_row.gid),
-source:m_row.source, kw:toFloat(m_row.kw), kvar:toFloat(m_row.kvar), 
-backup_capacity_kw:toFloat(m_row.backup_capacity_kw),
-longitude: toFloat(m_row.longitude), 
-latitude: toFloat(m_row.latitude), backup: toInteger(m_row.backup)})
-WITH m
-    MATCH (lo:Load)
-    MERGE (lo)-[:VISITS_DURING_HEALTH_EMERGENCY {distance: point.distance(
-       point({longitude: m.longitude, latitude:m.latitude}),
-       point({longitude: lo.longitude, latitude:lo.latitude})
-        )}]->(m);
-
-MATCH (h:Hospital)
-WITH h 
-    MATCH (b:Bus {name: h.source})
-    MERGE (b)<-[:GETS_POWER_FROM]-(h);
-
-LOAD CSV WITH HEADERS FROM 'file:///banking.csv' AS b_row
-WITH b_row WHERE b_row.name IS NOT NULL 
-MERGE (b:Banking {name: (b_row.name + b_row.gid),
-source: b_row.source,kw:toFloat(b_row.kw), kvar:toFloat(b_row.kvar), 
-backup_capacity_kw:toFloat(b_row.backup_capacity_kw),
-backup: toInteger(b_row.backup),
-longitude: toFloat(b_row.longitude), latitude: toFloat(b_row.latitude)})
-WITH b
-    MATCH (lo:Load)
-    MERGE (lo)-[:VISITS_TO_WITHDRAW_OR_DEPOSIT_CURRENCY {distance: point.distance(
-       point({longitude: b.longitude, latitude:b.latitude}),
-       point({longitude: lo.longitude, latitude:lo.latitude})
-        )}]->(b);
-
-MATCH (b1:Banking)
-WITH b1
-    MATCH (b:Bus {name: b1.source})
-    MERGE (b)<-[:GETS_POWER_FROM]-(b1);
-
-LOAD CSV WITH HEADERS FROM 'file:///convenience.csv' AS c_row
-WITH c_row WHERE c_row.name IS NOT NULL 
-MERGE (c:Convenience {name: (c_row.name + c_row.gid), 
-source:c_row.source, kw:toFloat(c_row.kw), kvar:toFloat(c_row.kvar), 
-backup_capacity_kw:toFloat(c_row.backup_capacity_kw),
-backup: toInteger(c_row.backup),
-longitude: toFloat(c_row.longitude), latitude: toFloat(c_row.latitude)})
-WITH c
-    MATCH (lo:Load)
-    MERGE (lo)-[:VISITS_FOR_SERVICE {distance: point.distance(
-       point({longitude: c.longitude, latitude:c.latitude}),
-       point({longitude: lo.longitude, latitude:lo.latitude})
-        )}]->(c);
-
-MATCH (c:Convenience)
-WITH c
-    MATCH (b:Bus {name: c.source})
-    MERGE (b)<-[:GETS_POWER_FROM]-(c);
-
-LOAD CSV WITH HEADERS FROM 'file:///shelters.csv' AS s_row
-WITH s_row WHERE s_row.use_type IS NOT NULL 
-MERGE (s:Shelter {name: (s_row.use_type + s_row.gid), 
-backup: toInteger(s_row.backup), source: s_row.source, kw:toFloat(s_row.kw), 
-kvar:toFloat(s_row.kvar), 
-backup_capacity_kw:toFloat(s_row.backup_capacity_kw),
-longitude: toFloat(s_row.longitude), latitude: toFloat(s_row.latitude)})
-WITH s
-    MATCH (lo:Load)
-    MERGE (lo)-[:VISITS_FOR_SERVICE {distance: point.distance(
-       point({longitude: s.longitude, latitude:s.latitude}),
-       point({longitude: lo.longitude, latitude:lo.latitude})
-    )}]->(s);
-
-MATCH (s:Shelter)
-WITH s
-    MATCH (b:Bus {name: s.source})
-    MERGE (b)<-[:GETS_POWER_FROM]-(s);
-
-MATCH (b1:Bus)-[r:CONNECTS_TO]-(b2:Bus)
-SET r.longitude = (b1.longitude + b2.longitude)/2
-SET r.latitude = (b1.latitude + b2.latitude)/2;
-
-MATCH p=(sourceNode:Bus)-[r:CONNECTS_TO]-(targetNode:Bus)
-WHERE r.ampacity IS NOT NULL
-WITH r,sourceNode, CASE r.num_phase
-WHEN 3 THEN 1.732
-ELSE 1
-END AS multiplier
-SET r.kva = multiplier*r.ampacity*sourceNode.kv;
-
-MATCH p=(sourceNode:Bus)-[r:CONSUMES_POWER_FROM]-(targetNode:Load)
-SET targetNode.kw = toFloat(targetNode.kw)
-SET targetNode.kvar = toFloat(targetNode.kvar)
-SET r.kva = sqrt(targetNode.kw*targetNode.kw+targetNode.kvar*targetNode.kvar);
-
-MATCH p=(sourceNode:Bus)-[r:INJECTS_ACTIVE_POWER_TO]-(targetNode:Solar)
-SET targetNode.capacity = toFloat(targetNode.capacity)
-SET r.kva = targetNode.capacity;
-
-
-MATCH p=(sourceNode:Bus)-[r:INJECTS_POWER]-(targetNode:EnergyStorage)
-SET targetNode.kw = toFloat(targetNode.kw)
-SET r.kva = targetNode.kw;
-
-MATCH (sourceNode:Bus)-[r:CONNECTS_TO]-(targetNode:Bus)
-SET r.kva = toFloat(r.kva);
-
-MATCH p=()-[r:GETS_POWER_FROM]->()
-WHERE r.kva is null
-SET r.kva = 300;
-
-MATCH p=()-[r:CONNECTS_TO]->() 
-WHERE r.kva IS null
-SET r.kva = 300;