NREL-erad 1.0.0a0__tar.gz

NREL-erad-1.0.0a0/LICENSE.txt

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2023, Alliance for Sustainable Energy, LLC
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

NREL-erad-1.0.0a0/NREL_erad.egg-info/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.1
+Name: NREL-erad
+Version: 1.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@nre.gov, aadil.altif@nrel.gov, sherinann.abraham@nrel.gov, kwami.sedzro@nrel.gov, bryan.palmintier@nrel.gov
+Requires-Python: >=3.8
+Provides-Extra: dev
+License-File: LICENSE.txt

NREL-erad-1.0.0a0/NREL_erad.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE.txt
+README.md
+setup.py
+NREL_erad.egg-info/PKG-INFO
+NREL_erad.egg-info/SOURCES.txt
+NREL_erad.egg-info/dependency_links.txt
+NREL_erad.egg-info/requires.txt
+NREL_erad.egg-info/top_level.txt

NREL-erad-1.0.0a0/NREL_erad.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

NREL-erad-1.0.0a0/NREL_erad.egg-info/requires.txt

@@ -0,0 +1,32 @@
+pytest
+networkx
+pyyaml
+geojson
+neo4j-driver
+python-dotenv
+ditto.py
+boto3
+botocore
+OpenDSSDirect.py
+pandas
+matplotlib
+plotly
+shapely
+jupyter
+geopandas
+stateplane
+graphdatascience
+scipy
+geopy
+rasterio
+xmltodict
+pydantic
+requests
+
+[dev]
+mkdocs
+mkdocstrings[python]
+mkdocs-material
+mkdocs-jupyter
+pylint
+black

NREL-erad-1.0.0a0/NREL_erad.egg-info/top_level.txt

@@ -0,0 +1 @@
+

NREL-erad-1.0.0a0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.1
+Name: NREL-erad
+Version: 1.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@nre.gov, aadil.altif@nrel.gov, sherinann.abraham@nrel.gov, kwami.sedzro@nrel.gov, bryan.palmintier@nrel.gov
+Requires-Python: >=3.8
+Provides-Extra: dev
+License-File: LICENSE.txt

NREL-erad-1.0.0a0/README.md

@@ -0,0 +1,66 @@
+# erad
+Graph based python tool for computing equitable resilience 
+
+[Visit full documentation here](https://nrel.github.io/erad/)
+
+```
+### :point_right: Generating CSV data set to load to Graph database
+
+1. Downloading the SMARTDS opendss feeder model
+   
+Use the following code snippet to download the OpenDSS model for the region
+you are interested in. Just provide the region name and where you would like the downloaded files to be stored.
+
+```
+from utils.ditto_utils import download_smartds_data
+download_smartds_data('P4R',  r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\smartds_opendss_models')
+```
+
+2. Parsing generic opendss model to retrieve metadata
+
+The command below takes master opendss file and folder where you want to store the extracted data. It will generate csvs for distribution assets.
+
+```
+from utils.opendss_utils import extract_opendss_model
+extract_opendss_model(
+        r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\smartds_opendss_models\P4R__2018__SFO__oedi-data-lake_opendss_no_loadshapes\Master.dss',
+        r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\graph_csvs'
+    )
+```
+
+3. Preparing HIFLD data for the region you are interested in
+
+First download the HIFLD CSV data set and use the following command to get the subset of the csv for the region you are interedted in. First create a bounding box with 5km buffer. Then use the bounding box corners to filter the csv data set.
+
+```
+from utils.opendss_utils import get_bounding_box
+from utils.hifld import get_subset_of_hifld_data
+bounds = get_bounding_box(
+    r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\smartds_opendss_models\P4R__2018__SFO__oedi-data-lake_opendss_no_loadshapes\Master.dss', 
+    5000)
+
+get_subset_of_hifld_data(
+    r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\HIFLD Data\Emergency_Medical_Service_(EMS)_Stations.csv',
+    bounds,
+    r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\graph_csvs',
+    logitude_column_name='LONGITUDE',
+    latitude_column_name='LATITUDE',
+    columns_to_keep=['LONGITUDE', 'LATITUDE', 
+    'STATE', 'ZIP', 'CITY', 'COUNTY'],
+    name_of_csv_file='medical_centers.csv')
+```
+
+4. Creating relationship between HIFLD data and OpenDSS loads
+
+Use the following snippet to create a relationship csv between HIFLD data and OpenDSS loads
+
+```
+from utils.hifld import get_relationship_between_hifld_infrastructures
+get_relationship_between_hifld_infrastructures(
+        r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\graph_csvs\medical_centers.csv',
+        'Id',
+        r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\graph_csvs\loads.csv',
+        r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\graph_csvs\buses.csv',
+        r'C:\Users\KDUWADI\Desktop\NREL_Projects\RADS\graph_csvs\medical_relationships.csv'
+    )
+```

NREL-erad-1.0.0a0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

NREL-erad-1.0.0a0/setup.py

@@ -0,0 +1,35 @@
+
+#!/usr/bin/env python
+import io
+import os
+import re
+
+from setuptools import find_packages
+
+try:
+    from setuptools import setup, find_packages
+except ImportError:
+    from distutils.core import setup
+
+with open('requirements.txt') as f:
+    requirements = f.read().splitlines()
+
+with open('requirements_dev.txt') as f:
+    dev_requires = f.read().splitlines()
+
+
+setup(name='NREL-erad',
+    version="1.0.0-alpha", # MAJOR.MINOR.PATCH (https://semver.org/)
+    description='Graph based scalable tool for computing equitable \
+        resilience metrics for distribution systems.',
+    author='Kapil Duwadi, Aadil Latif, Kwami Sedzro,  Sherin Ann Abraham, Bryan Palmintier',
+    author_email='kapil.duwadi@nre.gov, aadil.altif@nrel.gov, sherinann.abraham@nrel.gov, kwami.sedzro@nrel.gov, bryan.palmintier@nrel.gov',
+    url='https://github.com/nrel/erad',
+    packages=find_packages("src"),
+    install_requires=requirements,
+    python_requires='>=3.8',
+    package_dir={"erad": "erad"},
+    extras_require={
+        "dev": dev_requires,
+    }
+)