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 (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:
import platrock
Using poetry
PlatRock uses poetry as packaging/dependency manager. You can install PlatRock using poetry. First install poetry 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:
import platrock
Examples
Examples for all PlatRock simulation models are available on PlatRock gitlab.
Source code
The source code of platrock is also available on the gitlab repository. 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
1 maintainer
Metadata
1 maintainer
Release files for platrock 0.4.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| platrock-0.4.6.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| platrock-0.4.6-cp312-cp312-manylinux_2_39_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.39+ x86-64 | Details |
Total release size: 2.7 MB
Release files / platrock-0.4.6.tar.gz
| Download URL | platrock-0.4.6.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fdad8541c827a5aac3b66146197163bec55309e2a58100a380c1b4284bcad096
|
|
BLAKE2b-256 checksum How to use checksums |
e74e9443fdc24f415f5c91d3acd85d90434c50dd7332295fa45d627a29cc0c9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.12.3 Linux/6.8.0-45-generic
|
Release files / platrock-0.4.6-cp312-cp312-manylinux_2_39_x86_64.whl
| Download URL | platrock-0.4.6-cp312-cp312-manylinux_2_39_x86_64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.12 Linux glibc 2.39+ x86-64 |
|
SHA-256 checksum How to use checksums |
6ea8e03d05b8609a7e34ee53216a6339ad0ca7e6976082f2f6cc76c9a4886d9a
|
|
BLAKE2b-256 checksum How to use checksums |
c0a87c7111c0232b271c27df06092c4e4ce7db19fa6fa6af30a5645e8fbec303
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.3 CPython/3.12.3 Linux/6.8.0-45-generic
|
