Name | mosaik-api JSON |
Version |
3.0.3
JSON |
| download |
home_page | https://mosaik.offis.de |
Summary | Python implementation of the mosaik API. |
upload_time | 2022-12-14 15:52:03 |
maintainer | |
docs_url | None |
author | Stefan Scherfke |
requires_python | |
license | |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
Mosaik API for Python
=====================
This is an implementation of the mosaik API for simulators written in Python.
It hides all the messaging and networking related stuff and provides a simple
base class that you can implement.
Installation
------------
Just use `pip <https://pip.pypa.io>`_ to install it:
.. sourcecode:: bash
$ pip install mosaik-api
Documentation
-------------
Please refer to `mosaik’s documentation`__ of the API.
__ http://mosaik.readthedocs.org/en/latest/mosaik-api/high-level.html
Example Simulator
-----------------
This distribution contains an example simulator in the ``example_sim`` package.
It can be started via the ``pyexamplesim`` command; ``pyexamplesim --help``
shows you how to use it.
It can also be run in-process by importing and calling
``example_sim.mosaik.main()``.
Example MAS
-----------
This distribution contains an example "multi-agent system" that uses the
asyncronous remote calls to mosaik (``get_progress()``,
``get_related_entities()``, ``get_data()``, ``set_data()``).
It can be started via the ``pyexamplemas`` command; ``pyexamplemas --help``
shows you how to use it.
It can also be run in-process by importing and calling
``example_mas.mosaik.main()``.
Development setup
-----------------
To setup a devleopment environment, create a virtualenv and install the
packages from ``requirements.txt``:
.. code-block:: bash
$ mkvirtualenv --python=/usr/bin/python3 mosaik-api-python
(mosaik-api-python)$ pip install -r requirements.txt
To run the tests for the Python version you are currently using, execute
``py.test``. You should also add the test coverage check:
.. code-block:: bash
(mosaik-api-python)$ py.test --cov=example_mas --cov=example_sim --cov=mosaik_api
To run the tests for all supported Python versions, run ``tox``:
.. code-block:: bash
(mosaik-api-python)$ tox
Mosaik's `documentation
<https://mosaik.readthedocs.org/en/latest/dev/setup.html>`_ contains more
details.
Changelog
=========
3.0.3 - 2022-12-14
------------------
- [NEW] Add datetime utility
3.0.2 - 2022-06-01
------------------
- [CHANGE] Use internal mosaik-simpy-io>=0.2.4 instead of simpy.io
3.0.1 - 2022-04-22
------------------
- [CHANGE] Set external events via highlevel function call
3.0.0 - 2021-05-02
------------------
- [CHANGE] Added time_resolution to init function
- [CHANGE] Added max_advance to step function
- [NEW] Implemented set_events capability (external events)
2.4.2 - 2020-11-24
------------------
- [FIX] Constrain simpy to version <4 due to simpy.io incompatibility
2.4 - 2019-02-05
----------------
- [NEW] Simulator can now be started on a different node than mosaik, using the
remote flag "-r" and the timeout flag "-t". Mosaik can the integrate the simulator
using the "connect" method of the simmanager.
2.3 – 2019-01-24
----------------
- [BugFix] Bugfix Tests
2.2 – 2016-02-15
----------------
- [NEW] API version 2.2: Added an optional "setup_done()" method.
- [CHANGE] API version validation: The API version is no longer an integer but
a "major.minor" string. The *major* part has to math with mosaiks major
version. The *minor* part may be lower or equal to mosaik's minor version.
- [FIX] Various minor fixes and stability improvements.
2.1 – 2014-10-24
----------------
- [NEW] Allow extra API methods to be called. See
http://mosaik.readthedocs.org/en/2.0/mosaik-api/high-level.html#mosaik_api.Simulator
- [CHANGE] The *rel* entry in the entity description returned by *create()* is
now optional.
2.0 – 2014-09-22
----------------
- Initial release of the mosaik 2 Sim API for Python.
Authors
=======
The original concepts for the mosaik API were developed by Steffen Schütten and
Stefan Scherfke.
The author of the mosaik API version 2 is Stefan Scherfke.
The author of the mosaik API version 3 is Thomas Raub.
Additional contributors: André El-Ama, Okko Nannen, Annika Ofenloch, Thomas Raub, Eike Schulte, Jan Sören Schwarz, Cornelius Steinbrink
Raw data
{
"_id": null,
"home_page": "https://mosaik.offis.de",
"name": "mosaik-api",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Stefan Scherfke",
"author_email": "mosaik@offis.de",
"download_url": "https://files.pythonhosted.org/packages/28/3e/30a5bde1e5d4d0cffe1c88cb5a97dd83e6e47dfb22401fa5b6fe26a2fc86/mosaik-api-3.0.3.tar.gz",
"platform": null,
"description": "Mosaik API for Python\n=====================\n\nThis is an implementation of the mosaik API for simulators written in Python.\nIt hides all the messaging and networking related stuff and provides a simple\nbase class that you can implement.\n\n\nInstallation\n------------\n\nJust use `pip <https://pip.pypa.io>`_ to install it:\n\n.. sourcecode:: bash\n\n $ pip install mosaik-api\n\n\nDocumentation\n-------------\n\nPlease refer to `mosaik\u2019s documentation`__ of the API.\n\n__ http://mosaik.readthedocs.org/en/latest/mosaik-api/high-level.html\n\n\nExample Simulator\n-----------------\n\nThis distribution contains an example simulator in the ``example_sim`` package.\n\nIt can be started via the ``pyexamplesim`` command; ``pyexamplesim --help``\nshows you how to use it.\n\nIt can also be run in-process by importing and calling\n``example_sim.mosaik.main()``.\n\n\nExample MAS\n-----------\n\nThis distribution contains an example \"multi-agent system\" that uses the\nasyncronous remote calls to mosaik (``get_progress()``,\n``get_related_entities()``, ``get_data()``, ``set_data()``).\n\nIt can be started via the ``pyexamplemas`` command; ``pyexamplemas --help``\nshows you how to use it.\n\nIt can also be run in-process by importing and calling\n``example_mas.mosaik.main()``.\n\n\nDevelopment setup\n-----------------\n\nTo setup a devleopment environment, create a virtualenv and install the\npackages from ``requirements.txt``:\n\n.. code-block:: bash\n\n $ mkvirtualenv --python=/usr/bin/python3 mosaik-api-python\n (mosaik-api-python)$ pip install -r requirements.txt\n\nTo run the tests for the Python version you are currently using, execute\n``py.test``. You should also add the test coverage check:\n\n.. code-block:: bash\n\n (mosaik-api-python)$ py.test --cov=example_mas --cov=example_sim --cov=mosaik_api\n\nTo run the tests for all supported Python versions, run ``tox``:\n\n.. code-block:: bash\n\n (mosaik-api-python)$ tox\n\nMosaik's `documentation\n<https://mosaik.readthedocs.org/en/latest/dev/setup.html>`_ contains more\ndetails.\n\n\nChangelog\n=========\n\n3.0.3 - 2022-12-14\n------------------\n\n- [NEW] Add datetime utility\n\n3.0.2 - 2022-06-01\n------------------\n\n- [CHANGE] Use internal mosaik-simpy-io>=0.2.4 instead of simpy.io\n\n3.0.1 - 2022-04-22\n------------------\n\n- [CHANGE] Set external events via highlevel function call\n\n3.0.0 - 2021-05-02\n------------------\n\n- [CHANGE] Added time_resolution to init function\n- [CHANGE] Added max_advance to step function\n- [NEW] Implemented set_events capability (external events)\n\n2.4.2 - 2020-11-24\n------------------\n\n- [FIX] Constrain simpy to version <4 due to simpy.io incompatibility\n\n2.4 - 2019-02-05\n----------------\n\n- [NEW] Simulator can now be started on a different node than mosaik, using the\n remote flag \"-r\" and the timeout flag \"-t\". Mosaik can the integrate the simulator\n using the \"connect\" method of the simmanager.\n\n2.3 \u2013\u00a02019-01-24\n----------------\n\n- [BugFix] Bugfix Tests\n\n\n2.2 \u2013\u00a02016-02-15\n----------------\n\n- [NEW] API version 2.2: Added an optional \"setup_done()\" method.\n\n- [CHANGE]\u00a0API version validation: The API version is no longer an integer but\n a \"major.minor\" string. The *major* part has to math with mosaiks major\n version. The *minor* part may be lower or equal to mosaik's minor version.\n\n- [FIX] Various minor fixes and stability improvements.\n\n\n2.1 \u2013 2014-10-24\n----------------\n\n- [NEW]\u00a0Allow extra API methods to be called. See\n http://mosaik.readthedocs.org/en/2.0/mosaik-api/high-level.html#mosaik_api.Simulator\n\n- [CHANGE]\u00a0The *rel* entry in the entity description returned by *create()* is\n now optional.\n\n\n2.0 \u2013 2014-09-22\n----------------\n\n- Initial release of the mosaik 2 Sim API for Python.\n\n\nAuthors\n=======\n\nThe original concepts for the mosaik API were developed by Steffen Sch\u00fctten and\nStefan Scherfke.\n\nThe author of the mosaik API version 2 is Stefan Scherfke.\n\nThe author of the mosaik API version 3 is Thomas Raub.\n\nAdditional contributors: Andr\u00e9 El-Ama, Okko Nannen, Annika Ofenloch, Thomas Raub, Eike Schulte, Jan S\u00f6ren Schwarz, Cornelius Steinbrink\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Python implementation of the mosaik API.",
"version": "3.0.3",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "096f9f05f49d124006ce8c652881a905",
"sha256": "591dc8fe8ffc234a944eeb15bfcd878197933c17328cb0b3250f87f047c52fe1"
},
"downloads": -1,
"filename": "mosaik_api-3.0.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "096f9f05f49d124006ce8c652881a905",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 22428,
"upload_time": "2022-12-14T15:52:01",
"upload_time_iso_8601": "2022-12-14T15:52:01.457112Z",
"url": "https://files.pythonhosted.org/packages/fa/7b/efdcd87628f53dcc368539a8336656c8a5aead05d8c20c26c7d7b55a2e17/mosaik_api-3.0.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "506e2a3f2ecfdb5c3363bbb51ca1ba44",
"sha256": "65936c40a6f18e80510b3a5723e0c40eb09bb2cdc67eb7d12dc247c2c0da836d"
},
"downloads": -1,
"filename": "mosaik-api-3.0.3.tar.gz",
"has_sig": false,
"md5_digest": "506e2a3f2ecfdb5c3363bbb51ca1ba44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23116,
"upload_time": "2022-12-14T15:52:03",
"upload_time_iso_8601": "2022-12-14T15:52:03.514862Z",
"url": "https://files.pythonhosted.org/packages/28/3e/30a5bde1e5d4d0cffe1c88cb5a97dd83e6e47dfb22401fa5b6fe26a2fc86/mosaik-api-3.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-14 15:52:03",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "mosaik-api"
}