| Name | opentnsim JSON |
| Version |
1.3.7
JSON |
| download |
| home_page | None |
| Summary | The OpenTNSim package aims to facilitate the analysis of network performance for different network configurations, fleet compositions and traffic rules. |
| upload_time | 2024-05-30 09:35:39 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | None |
| license | None |
| keywords |
opentnsim
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
[](https://opentnsim.readthedocs.io/)
[](https://github.com/TUDelft-CITG/Transport-Network-Analysis/blob/master/LICENSE.txt)
[](https://zenodo.org/badge/latestdoi/145843547)
[](https://circleci.com/gh/TUDelft-CITG/OpenTNSim)
[](https://artifact-getter.herokuapp.com/get_coverage_report?circle_url=https://circleci.com/gh/TUDelft-CITG/OpenTNSim&circle_token=727b95b70301407d3c0af44e1af2039fd9486f6f)
# OpenTNSim
**Open** source **T**ransport **N**etwork **Sim**ulation - Analysis of traffic behaviour on networks for different traffic scenarios and network configurations.
Documentation can be found: [here](https://opentnsim.readthedocs.io/)
## Book
<a href="https://happy-bush-0c5d10603.1.azurestaticapps.net"><img src="docs/_static/book.png" style="max-width: 50vw;"></a>
You can find the opentnsim book, based on the examples in the `notebooks` folder on the [opentnsim-book](https://happy-bush-0c5d10603.1.azurestaticapps.net/) website.
## Installation
To install OpenTNSim, run this command in your terminal:
``` bash
pip install opentnsim
```
To also install the extra dependencies used for testing you can use:
``` bash
pip install opentnsim[testing]
```
To install in development mode, you can use (from the source directory)
``` bash
pip install -e .
```
This is the preferred method to install OpenTNSim, as it will always install the most recent stable release.
If you don not have [pip](https://pip.pypa.io) installed, this [Python installation guide](http://docs.python-guide.org/en/latest/starting/installation/) can guide you through the process.
You can read the [documentation](https://opentnsim.readthedocs.io/en/latest/installation.html) for other installation methods.
## Testing
You can run the unit tests
```bash
pytest
```
Or you can run the notebook tests:
```bash
pytest --nbmake ./notebooks --nbmake-kernel=python3 --ignore ./notebooks/cleanup ./notebooks/students
```
Or you can run a specific test like this:
``` bash
pytest -k test_single_engine
```
`
## Examples
The benefit of OpenTNSim is the generic set-up. A number of examples are presented in a seperate [Jupyter Notebook repository](https://github.com/TUDelft-CITG/OpenTNSim-Notebooks). Information on how to use the notebooks is presented in that repository as well.
## Book
Based on the examples and docs a book can be generated using the commands `make book` and cleaned up using `make clean-book`. These commands are unix only.
## Code quality
Code quality is checked using sonarcloud. You can see results on the [sonarcloud](https://sonarcloud.io/project/overview?id=TUDelft-CITG_OpenTNSim) website. For now we have disabled coverage and duplication checks. These can be enabled when we include coverage measurements and reduce duplication by optimizing the tests.
## OpenCLSim
OpenTNSim makes use of the [OpenCLSim](https://github.com/TUDelft-CITG/OpenCLSim) code. Both packages are maintained by the same team of developers. There are some differences between packages (e.g. in logging approaches), but you can use them together. We are working towards further integrating these two software packages.
Raw data
{
"_id": null,
"home_page": null,
"name": "opentnsim",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "OpenTNSim",
"author": null,
"author_email": "Mark van Koningsveld <m.vankoningsveld@tudelft.nl>",
"download_url": "https://files.pythonhosted.org/packages/93/7e/b86bc42eeaf2de53956e1c8f4c686a6600b8571291c364c9d7df31632774/opentnsim-1.3.7.tar.gz",
"platform": null,
"description": "[](https://opentnsim.readthedocs.io/)\n[](https://github.com/TUDelft-CITG/Transport-Network-Analysis/blob/master/LICENSE.txt)\n[](https://zenodo.org/badge/latestdoi/145843547)\n\n[](https://circleci.com/gh/TUDelft-CITG/OpenTNSim)\n[](https://artifact-getter.herokuapp.com/get_coverage_report?circle_url=https://circleci.com/gh/TUDelft-CITG/OpenTNSim&circle_token=727b95b70301407d3c0af44e1af2039fd9486f6f)\n\n# OpenTNSim\n\n**Open** source **T**ransport **N**etwork **Sim**ulation - Analysis of traffic behaviour on networks for different traffic scenarios and network configurations.\n\nDocumentation can be found: [here](https://opentnsim.readthedocs.io/)\n\n## Book\n\n<a href=\"https://happy-bush-0c5d10603.1.azurestaticapps.net\"><img src=\"docs/_static/book.png\" style=\"max-width: 50vw;\"></a>\n\nYou can find the opentnsim book, based on the examples in the `notebooks` folder on the [opentnsim-book](https://happy-bush-0c5d10603.1.azurestaticapps.net/) website.\n\n\n## Installation\n\nTo install OpenTNSim, run this command in your terminal:\n\n``` bash\npip install opentnsim\n```\n\nTo also install the extra dependencies used for testing you can use:\n``` bash\npip install opentnsim[testing]\n```\n\nTo install in development mode, you can use (from the source directory)\n``` bash\npip install -e .\n```\n\n\n\nThis is the preferred method to install OpenTNSim, as it will always install the most recent stable release.\n\nIf you don not have [pip](https://pip.pypa.io) installed, this [Python installation guide](http://docs.python-guide.org/en/latest/starting/installation/) can guide you through the process.\n\nYou can read the [documentation](https://opentnsim.readthedocs.io/en/latest/installation.html) for other installation methods.\n\n\n## Testing\nYou can run the unit tests\n\n```bash\npytest\n```\n\nOr you can run the notebook tests:\n```bash\npytest --nbmake ./notebooks --nbmake-kernel=python3 --ignore ./notebooks/cleanup ./notebooks/students\n```\n\nOr you can run a specific test like this:\n\n``` bash\npytest -k test_single_engine\n```\n\n`\n\n\n## Examples\n\nThe benefit of OpenTNSim is the generic set-up. A number of examples are presented in a seperate [Jupyter Notebook repository](https://github.com/TUDelft-CITG/OpenTNSim-Notebooks). Information on how to use the notebooks is presented in that repository as well.\n\n## Book\n\nBased on the examples and docs a book can be generated using the commands `make book` and cleaned up using `make clean-book`. These commands are unix only.\n\n## Code quality\nCode quality is checked using sonarcloud. You can see results on the [sonarcloud](https://sonarcloud.io/project/overview?id=TUDelft-CITG_OpenTNSim) website. For now we have disabled coverage and duplication checks. These can be enabled when we include coverage measurements and reduce duplication by optimizing the tests.\n\n\n## OpenCLSim \nOpenTNSim makes use of the [OpenCLSim](https://github.com/TUDelft-CITG/OpenCLSim) code. Both packages are maintained by the same team of developers. There are some differences between packages (e.g. in logging approaches), but you can use them together. We are working towards further integrating these two software packages.\n",
"bugtrack_url": null,
"license": null,
"summary": "The OpenTNSim package aims to facilitate the analysis of network performance for different network configurations, fleet compositions and traffic rules.",
"version": "1.3.7",
"project_urls": {
"Homepage": "https://github.com/TUDelft-CITG/OpenTNSim"
},
"split_keywords": [
"opentnsim"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5b573a18aafb8e316f475f15f112d704cc391db7f2d069b21c5752d83fbf961a",
"md5": "dc8cac0a56ebc4f9b684d726c8aafb06",
"sha256": "a5e46fce42cff4bc98e63c867d7c990436b3f0f1b0943f59d79db61b9442e64a"
},
"downloads": -1,
"filename": "opentnsim-1.3.7-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "dc8cac0a56ebc4f9b684d726c8aafb06",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 144427,
"upload_time": "2024-05-30T09:35:38",
"upload_time_iso_8601": "2024-05-30T09:35:38.582548Z",
"url": "https://files.pythonhosted.org/packages/5b/57/3a18aafb8e316f475f15f112d704cc391db7f2d069b21c5752d83fbf961a/opentnsim-1.3.7-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "937eb86bc42eeaf2de53956e1c8f4c686a6600b8571291c364c9d7df31632774",
"md5": "be88aebfe37e9590cb7c37cf38d2e339",
"sha256": "2fbc35cd3e48fa4481a47aecbed0c776650d661846a7d62576c13adb6bb6971b"
},
"downloads": -1,
"filename": "opentnsim-1.3.7.tar.gz",
"has_sig": false,
"md5_digest": "be88aebfe37e9590cb7c37cf38d2e339",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 138791,
"upload_time": "2024-05-30T09:35:39",
"upload_time_iso_8601": "2024-05-30T09:35:39.797893Z",
"url": "https://files.pythonhosted.org/packages/93/7e/b86bc42eeaf2de53956e1c8f4c686a6600b8571291c364c9d7df31632774/opentnsim-1.3.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-30 09:35:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TUDelft-CITG",
"github_project": "OpenTNSim",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"circle": true,
"lcname": "opentnsim"
}
