# Description
PlatRock is a multi-model software for the numerical simulation of rockfalls. This scientific tool implements rock propagation algorithms on 2D and 3D terrain and gives statistical data about resulting trajectories.
All other dependencies should be automatically installed by pip.
# Installation
## Prerequisites
At the moment PlatRock is only tested on debian-based platform unix distros. Prior to PlatRock installation, please check that the following dependencies are satisfied.
* python >= 3.10, which is the default on modern linux distros ;
* [gdal](https://gdal.org/) (which can be installed on debian-based systems with `sudo apt install g++ python3-dev libgdal-dev`).
Modern python package uses python virtual environments, so do PlatRock. You can use the virtual environment manager you want, below are two examples.
In any case, don't forget to install the `libgdal-dev` package as mentionned above.
## Using pipx
Install pipx on your disto:
```
sudo apt install pipx
```
Then install PlatRock from pypi repository or gitlab:
```
pipx install platrock #the more stable release, from pipy
# OR
pipx install git+https://gitlab.com/platrock/platrock.git@dev #the latest development banch, may be unstable
```
You should normally be able to launch PlatRock by simply invoking it:
```
platrock myscript.py
```
You can also import it in your own python script, but in this case you must activate the corresponding venv created by pipx before:
```
pipx list #shows all pipx venv created, find platrock venv path
# Usually, the command to activate PlatRock venv would be:
source "/home/$USER/.local/share/pipx/venvs/platrock/bin/activate"
```
In your script:
```python
import platrock
```
## Using poetry
PlatRock uses poetry as packaging/dependency manager. You can install PlatRock using poetry. First install [poetry](https://python-poetry.org/docs/) and git.
Then download platrock:
```
git clone https://gitlab.com/platrock/platrock.git`
cd platrock
```
Install PlatRock in ./.venv/:
```
poetry install
```
Finally launch PlatRock:
```
poetry run platrock myscript.py
```
Or import PlatRock from your own script, don't forget to activate PlatRock venv first:
```
poetry shell
```
In your script:
```python
import platrock
```
# Examples
Examples for all PlatRock simulation models are available on [PlatRock gitlab](https://gitlab.com/platrock/platrock/-/tree/master/examples).
# Source code
The source code of platrock is also available on the [gitlab repository](https://gitlab.com/platrock/platrock). The master branch fits the version that is hosted on pypi.
# Licence
PlatRock is licenced under the GNU General Public License v3 (GPLv3).
# Contributors
* François Kneib
* Franck Bourrier
* David Toe
* Frédéric Berger
* Stéphane Lambert
Raw data
{
"_id": null,
"home_page": "http://platrock.org/",
"name": "platrock",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "rockfall, scientific, modeling",
"author": "Francois Kneib",
"author_email": "francois.kneib@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/e7/4e/9443fdc24f415f5c91d3acd85d90434c50dd7332295fa45d627a29cc0c9b/platrock-0.4.6.tar.gz",
"platform": null,
"description": "# Description\nPlatRock is a multi-model software for the numerical simulation of rockfalls. This scientific tool implements rock propagation algorithms on 2D and 3D terrain and gives statistical data about resulting trajectories.\n\n\n\nAll other dependencies should be automatically installed by pip.\n\n# Installation\n\n## Prerequisites\nAt the moment PlatRock is only tested on debian-based platform unix distros. Prior to PlatRock installation, please check that the following dependencies are satisfied. \n* python >= 3.10, which is the default on modern linux distros ;\n* [gdal](https://gdal.org/) (which can be installed on debian-based systems with `sudo apt install g++ python3-dev libgdal-dev`).\n\nModern python package uses python virtual environments, so do PlatRock. You can use the virtual environment manager you want, below are two examples.\n\nIn any case, don't forget to install the `libgdal-dev` package as mentionned above.\n\n## Using pipx\nInstall pipx on your disto:\n```\nsudo apt install pipx\n```\n\nThen install PlatRock from pypi repository or gitlab:\n```\npipx install platrock #the more stable release, from pipy\n # OR\npipx install git+https://gitlab.com/platrock/platrock.git@dev #the latest development banch, may be unstable\n```\n\nYou should normally be able to launch PlatRock by simply invoking it:\n```\nplatrock myscript.py\n```\n\nYou can also import it in your own python script, but in this case you must activate the corresponding venv created by pipx before:\n```\npipx list #shows all pipx venv created, find platrock venv path\n # Usually, the command to activate PlatRock venv would be:\nsource \"/home/$USER/.local/share/pipx/venvs/platrock/bin/activate\"\n```\n\nIn your script:\n```python\nimport platrock\n```\n\n\n## Using poetry\nPlatRock uses poetry as packaging/dependency manager. You can install PlatRock using poetry. First install [poetry](https://python-poetry.org/docs/) and git.\n\nThen download platrock:\n```\ngit clone https://gitlab.com/platrock/platrock.git`\ncd platrock\n```\n\nInstall PlatRock in ./.venv/:\n```\npoetry install\n```\n\nFinally launch PlatRock:\n```\npoetry run platrock myscript.py\n```\n\nOr import PlatRock from your own script, don't forget to activate PlatRock venv first:\n```\npoetry shell\n```\n\nIn your script:\n```python\nimport platrock\n```\n\n# Examples\nExamples for all PlatRock simulation models are available on [PlatRock gitlab](https://gitlab.com/platrock/platrock/-/tree/master/examples).\n \n\n# Source code\nThe source code of platrock is also available on the [gitlab repository](https://gitlab.com/platrock/platrock). The master branch fits the version that is hosted on pypi.\n\n# Licence\nPlatRock is licenced under the GNU General Public License v3 (GPLv3).\n\n# Contributors\n* Fran\u00e7ois Kneib\n* Franck Bourrier\n* David Toe\n* Fr\u00e9d\u00e9ric Berger\n* St\u00e9phane Lambert\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Scientific multi-model software for the numerical simulation of rockfalls.",
"version": "0.4.6",
"project_urls": {
"Homepage": "http://platrock.org/",
"Repository": "https://gitlab.com/platrock/platrock"
},
"split_keywords": [
"rockfall",
" scientific",
" modeling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c0a87c7111c0232b271c27df06092c4e4ce7db19fa6fa6af30a5645e8fbec303",
"md5": "fc7eb8a351b44136458709bd090b0b8d",
"sha256": "6ea8e03d05b8609a7e34ee53216a6339ad0ca7e6976082f2f6cc76c9a4886d9a"
},
"downloads": -1,
"filename": "platrock-0.4.6-cp312-cp312-manylinux_2_39_x86_64.whl",
"has_sig": false,
"md5_digest": "fc7eb8a351b44136458709bd090b0b8d",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": "<4.0,>=3.10",
"size": 1377697,
"upload_time": "2024-10-15T10:41:25",
"upload_time_iso_8601": "2024-10-15T10:41:25.764483Z",
"url": "https://files.pythonhosted.org/packages/c0/a8/7c7111c0232b271c27df06092c4e4ce7db19fa6fa6af30a5645e8fbec303/platrock-0.4.6-cp312-cp312-manylinux_2_39_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e74e9443fdc24f415f5c91d3acd85d90434c50dd7332295fa45d627a29cc0c9b",
"md5": "34cf5b0e44027bd69fde6fa73ee98a6e",
"sha256": "fdad8541c827a5aac3b66146197163bec55309e2a58100a380c1b4284bcad096"
},
"downloads": -1,
"filename": "platrock-0.4.6.tar.gz",
"has_sig": false,
"md5_digest": "34cf5b0e44027bd69fde6fa73ee98a6e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 1354366,
"upload_time": "2024-10-15T10:41:28",
"upload_time_iso_8601": "2024-10-15T10:41:28.487781Z",
"url": "https://files.pythonhosted.org/packages/e7/4e/9443fdc24f415f5c91d3acd85d90434c50dd7332295fa45d627a29cc0c9b/platrock-0.4.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-15 10:41:28",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "platrock",
"gitlab_project": "platrock",
"lcname": "platrock"
}
JSON