1. Quick Guide for Install and Run
NECP-X can be installed from installer or from source. If encounter any problem, please resort to Troubleshooting. If the problem cannot be resolved, you can contact necpx_help@groups.163.com.
| Installer | Operating system |
|---|---|
NECP-X_0.8.3_tianhe_hdf5_openmp |
Coming |
To install NECP-X:
· Uninstall previous installation
· Download the Linux installer:
| Installer | Operating system |
|---|---|
| NECP-X-0.8.3-MPI-CentOS | CentOS 7, with OpenMPI |
| NECP-X-0.8.3-MPI-Ubuntu | Ubuntu 14.04/16.04, with OpenMPI |
· Execute the script in terminal and install NECP-X. Then modify ~/.bashrc file as output information on screen. The path of NECP-X will be prepended to PATH variable and a new variable NECP_X_ROOT will be created. Once installed, you can run NECP-X from terminal anywhere.
To install NECP-X:
sudo NECP-X-0.8.0-MPI-CentOS.sh
NECP-X will be installed to the default path /usr/local/necp-x/NECP-X-0.8.0-Linux:
Modify ~/.bashrc file as output information on screen. For example:
Screen output information
To uninstall NECP-X:
· Remove the directory where NECP-X has been installed;
· Modify ~/.bashrc file back to original.
The commands to uninstall NECP-X in Ubuntu in default install path are shown below:
rm /usr/local/necp-x -rf
Delete information what has been added in ~/.bashrc file.
NECP-X can be run in neutronics calculation mode or plot mode. If run in neutronics calculation mode, NECP-X will run the problem described by the input file. If run in plot mode, NECP-X will only plot the figure.
1.2.1. Neutronics calculation mode
· Open a new terminal (Linux or macOS);
· Go to directory containing the input file you want to run;
cd /path/containing/input/file
· Run NECP-X in neutronics calculation mode
/openmpi/bin/mpirun -np ncpus necp-x input_file
· Open a new terminal (Linux or macOS);
· Go to directory containing the input file you want to run;
cd /path/containing/input/file
· Run NECP-X in plot mode to get 3D figure
necp-x input_file -p3
· Use Paraview to open vtk file generated by NECP-X and plot
1.3.1. necp-x: command not found
When running necp-x in terminal for the first time, the error necp-x: command not found may occur. This is because the system doesn’t know the change of environment variable yet. To fix this problem, just open a new terminal and re-run necp-x.