Metadata-Version: 2.1
Name: powerdict
Version: 1.2.13
Summary: A power station dictionary that enables mapping between various naming conventions and associated plant metadata
Home-page: https://github.com/OSUKED/Power-Station-Dictionary
Author: Ayrton Bourn
Author-email: ayrtonbourn@outlook.com
License: UNKNOWN
Description: # Power Station Dictionary
        
        [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/OSUKED/Power-Station-Dictionary/main?urlpath=lab) [![DOI](https://zenodo.org/badge/322407102.svg)](https://zenodo.org/badge/latestdoi/322407102) [![PyPI version](https://badge.fury.io/py/powerdict.svg)](https://badge.fury.io/py/powerdict)
        
        <br>
        
        > A power station dictionary that enables mapping between various naming conventions and associated plant metadata
        
        <br>
        
        The core output of this project is a clean power plant dataset that includes relevant attributes such as location and capacity, as well as id mappings that can be used to connect them to other datasets. Currently the focus of this work are plants within the GB power system. The `powerdict` module provides a programmatic way in which to combine the raw datasets and apply any additional updates specified in the files contained within the three data directories:
        
        - _raw_ - source datasets as csvs
        - _updates_ - JSON mappings from an osuked_id to a new attribute value
        - _definitions_ - JSON specification of how to process the raw sources and what the output should look like
        
        CI/CD is set-up so that any changes in this repository will trigger a reconstruction of the output dataset, additionally a new GitHub release will automatically trigger a new release on Zenodo and produce an updated DOI. The output dataset can be found [here](https://github.com/OSUKED/Power-Station-Dictionary/blob/main/data/output/power_stations.csv). As with projects such as the [Global Power Plant Database](https://github.com/wri/global-power-plant-database), `powerdict` provides a clear data lineage from the raw sources/updates to the output. Furthermore, integrating this with GitHub enables version control of the underlying datasets and updates/corrections.
        
        <br>
        <br>
        
        ### Installation
        
        To install the `powerdict` library please run:
        
        ```bash
        pip install powerdict
        ```
        
        <br>
        
        ### Development Set-Up
        
        To set-up a new environment you can run the following from the batch_scripts directory
        
        ```bash
        pypi_publish
        ```
        
        Alternatively you can run these commands
        
        ```bash
        call conda env create -f environment.yml
        call conda activate PowerDict
        call ipython kernel install --user --name=PowerDict
        ```
        
        <br>
        
        ### Publishing to PyPi
        
        To publish the `powerdict` module to PyPi simply run the following from the batch_scripts directory
        
        ```bash
        pypi_publish
        ```
        
        or follow these commands
        
        ```bash
        call conda activate PowerDict
        call python setup.py sdist bdist_wheel
        call twine upload --skip-existing dist/*
        ```
        
        When prompted you should enter your PyPi username and password
        
        After this you will be able to install the latest version of powerdict using `pip install powerdict`
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
