Skip to content

Commit

Permalink
added public links
Browse files Browse the repository at this point in the history
  • Loading branch information
[email protected] committed Dec 23, 2021
1 parent ac0829b commit c14fa24
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 65 deletions.
66 changes: 2 additions & 64 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,8 @@
A new tool for nuclear libraries V&V.
Brought to you by NIER, University of Bologna (UNIBO) and Fusion For Energy (F4E).

A more detailed documentation can be accessed from [\docs\build\html\index.html](./docs/build/html/index.html).

JADE is an open-source software licensed under the [GNU GPLv3](./LICENSE) license. When using JADE for scientific publications you are kindly encouraged to cite the following papers:
- Davide Laghi et al, 2020, "JADE, a new software tool for nuclear fusion data libraries verification & validation", Fusion Engineering and Design, doi: https://doi.org/10.1016/j.fusengdes.2020.112075.
Check [JADE official documentation](https://jade-a-nuclear-data-libraries-vv-tool.readthedocs.io/en/latest/)
for more detailed information on how to use the tool.

For additional information contact: [email protected]

Expand All @@ -19,65 +17,5 @@ For additional information contact: [email protected]
- Anaconda or Miniconda distribution (Python 3);
- Microsoft Office suite (Excel and Word);

## Installation
1) extract the zip into a folder of choice (from now on <JADE_root>);
2) rename the folder containing the Python scripts as 'Code' (<JADE_root>\Code);
3) open the global configuration file: <JADE_root>\Code\Configuration\Config.xlsx; here you need to properly set the environment variables specified in the 'MAIN Config.' sheet (i.e. xsdir Path, and multithread options);
4) Open an anaconda prompt shell and change directory to ``<JADE_root>\Code``. Then create a virtual
environment specific for jade:

```
conda env create --name jade --file=environment.yml
```

This ensures that all dependencies are satisfied. The environment can be activated using:

```
conda activate jade
```

And deactivated simply using:

```
conda deactivate
```

5) Finally, when the environment is activated, in order to start JADE type:

```
python main.py
```

6) on the first usage the rest of the folders architecture is initialized.

## Usage!

JADE is a consolle based software where different menu can be accessed through direct typing into the shell.
### Main Menu
The main menu is divided into two sections, the first one let the user open the specific 2nd level menus of one of the main JADE functions, while the second one allows to directly execute some auxiliary functions.
#### Main Functions
- 'qual': open the quality checks menu (not implemented);
- 'comp': open the computational benchmarks menu;
- 'exp': open the experimental benchmark menu (not implemented);
- 'post': open the post-processing menu.
#### Utilities
- 'printlib': print to video all the libreries available in the xsdir file specified in the <JADE_root>\Code\Configuration\Config.xlsx file. Those are the libraries that can be assessed;
- 'trans': select an MCNP input file (absolute full path is required) and translate it to a selected library among the available ones; the results can be found in <JADE_root>\Utilities\Translations;
- 'printmat': select an MCNP input file (absolute full path is required) and print an excel that summarizes its material cards information; the results can be found in <JADE_root>\Utilities\Materials Infos;
- 'generate': select an MCNP input file (absolute full path is required); from this file, a number of materials can be selected and a new material will be created using user-specified fraction of them; the resulting material (in MCNP format) can be found in <JADE_root>\Utilities\Generated Materials;
- 'exit': leave the application freezing the log file that is saved in <JADE_root>\Utilities\Log Files
### Computational Benchmark Menu
- printlib: print to video all the libreries available in the xsdir file specified in the <JADE_root>\Code\Configuration\Config.xlsx file. Those are the libraries that can be assessed;
- assess: assess the selected library, the suite is run following the corresponding setup sheet in <JADE_root>\Code\Configuration\Config.xlsx; The MCNP input and output files can be found in <JADE_root>\Tests\MCNP simulations
- continue: continue an unfinished assessesment of the selected library;
- back: go back to the main menu;
- 'exit': leave the application freezing the log file that is saved in <JADE_root>\Utilities\Log Files
### Post Processing Menu
- printlib: print to video all the libreries that have been already assessed and can be post-processed.
- pp: post-process a single selected library, the results can be found in <JADE_root>\Tests\Post-Processing\Single Libraries;
- compare: compare two or more selected libraries, the first indicated will be considered as the reference one; the results can be found in <JADE_root>\Tests\Post-Processing\Comparisons
- back: go back to the main menu;
- 'exit': leave the application freezing the log file that is saved in <JADE_root>\Utilities\Log Files

## LICENSE
JADE is an open-source software licensed under the [GNU GPLv3](./LICENSE) license.
2 changes: 1 addition & 1 deletion docs/source/nutshell.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,4 @@ When using JADE for scientific publications you are kindly encouraged to cite th
For additional information contact: [email protected]

For additional information on future developments please check the issues list on the
GitHub repository [link].
GitHub repository https://github.com/dodu94/JADE.

0 comments on commit c14fa24

Please sign in to comment.