Skip to content

Commit

Permalink
cleanup (#217)
Browse files Browse the repository at this point in the history
  • Loading branch information
jagodek authored Nov 23, 2024
1 parent 1b1f0ca commit fa381ec
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 61 deletions.
49 changes: 4 additions & 45 deletions README.md
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
16 changes: 0 additions & 16 deletions tests/README.md

This file was deleted.

0 comments on commit fa381ec

Please sign in to comment.