-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
4 additions
and
61 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,51 +1,10 @@ | ||
# Yet Another Particle Transport IDE - converter | ||
|
||
## Developer documentation | ||
[Developer documentation](https://yaptide.github.io/for_developers/converter/) | ||
|
||
## About converter | ||
The Converter of the project file (JSON file generated by the frontend part) into a set of input files for particle transport simulators: | ||
|
||
- SHIELD-HIT12A (beam.dat, mat.dat, geo.dat and detect.dat). | ||
- Fluka | ||
|
||
## Installation | ||
|
||
Project make use of poetry for dependency management. If you do not have it installed, check official [poetry installation guide](https://python-poetry.org/docs/). | ||
Project is configured to create virtual environment for you, so you do not need to worry about it. | ||
Virtual environment is created in `.venv` folder in the root of the project. | ||
|
||
To install the project clone the repository and run the following command in the project directory: | ||
|
||
```shell | ||
poetry install --without=test | ||
``` | ||
|
||
This will result in command `yaptide-converter` available inside the virtual environment. | ||
It can be accessed outside virtual environment by running `poetry run yaptide-converter`. | ||
Alternatively, you can run `poetry shell` to enter virtual environment or check more examples in [Poetry documentation section: Activating the virtual environment](https://python-poetry.org/docs/basic-usage#activating-the-virtual-environment). | ||
|
||
## Usage | ||
|
||
The converter comes with a command line application. | ||
It is capable of transforming the JSON project file (generated in the yaptide web interface) into a set of valid input files for SHIELD-HIT12A. | ||
|
||
To run the converter use the following command: | ||
|
||
```bash | ||
python converter/main.py tests/shieldhit/resources/project.json workspace | ||
``` | ||
|
||
## Testing | ||
|
||
To run the unit tests, you need to install test dependencies with: | ||
|
||
```shell | ||
poetry install | ||
``` | ||
|
||
Then you can run the tests with: | ||
|
||
```shell | ||
poetry run pytest | ||
``` | ||
|
||
## Credits | ||
|
||
This work was partially funded by EuroHPC PL Project, Smart Growth Operational Programme 4.2 |
This file was deleted.
Oops, something went wrong.