Metadata-Version: 2.0
Name: mosaik-pypower
Version: 0.6.3
Summary: An adapter to use PYPOWER with mosaik.
Home-page: https://bitbucket.org/mosaik/mosaik-pypower
Author: Stefan Scherfke
Author-email: stefan.scherfke@offis.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Scientific/Engineering
Requires-Dist: PYPOWER (>=4.1)
Requires-Dist: mosaik-api (>=2.0)
Requires-Dist: numpy (>=1.6)
Requires-Dist: scipy (>=0.9)
Requires-Dist: xlrd (>=0.9.2)

mosaik-pypower
==============

This package contains the Adapter to connect *PYPOWER* to *mosaik*.


Installation
------------

You can install mosaik-pypower via pip::

   $ pip install mosaik-pypower

You can run the tests with::

    $ hg clone https://bitbucket.org/mosaik/mosaik-pypower
    $ cd mosaik-pypower
    $ pip install -r requirements.txt
    $ py.test


Input File Format
-----------------

The adapter uses a simple JSON based format for input files::

    {
        "base_mva": <global_base_mva>,
        "bus": [
            ["<bus_id>", "<bus_type>", <base_kv>],
        ...
        ],
        "trafo": [
            ["<trafo_id>", "<from_bus_id>", "<to_bus_id>", <Sr_MVA>, <v1_%>,
            <P1_MW>, <Imax_p_A>, <Imax_s_A>],
        ...
        ],
        "branch": [
            ["<branch_id>", "<from_bus_id>", "<to_bus_id>", <length_km>,
             <R'_ohm/km>, <X'_ohm/km>, <C'_nF/km>, <I_max_A>],
            ...
        ]
    }


where:

- *<bus_id>*, *<trafo_id>*, *<branch_id>* need to be unique names
- *<bus_type>* may be *"PQ"*, *"PV"* or *"REF"*
- There may only be one *REF* bus and it must be the first in the list

.. note:: Generators and PV buses are not yet supported.


Changelog
=========

0.6.3 – 2014-09-22
------------------

- [CHANGE] Updated to mosaik-api 2.0.


0.6.2 – 2014-07-31
------------------

- [CHANGE] Chache xlsx files to improve performance
- [CHANGE] Updated to mosaik-api 2.0a4.


0.6.1 – 2014-06-30
------------------

- [NEW] Added *I_max_p* [A] and *I_max_s* [A] to the transformer data.


0.6 – 2014-06-26
----------------

- [NEW] Can import grids from Excel files (xlsx)
- [NEW] New import format for JSON files (the old format is still supported)
- [CHANGE] Massive internal refactoring.
- [CHANGE] Updated to mosaik-api 2.0a3.


0.5 – 2014-03-26
----------------

- Initial release


Authors
=======

The mosaik-pypower is developed by Stefan Scherfke.


