INSTALLATION
This version of STELLOPT makes use of make_***.inc files in the SHARE
subdirectory to set various options at compile time. The make.inc file
in the main directory is a script which picks these files based on what
is returned by the uname -n command on your machine. This can be
overridden by setting the environment variable MACHINE to the file you
wish to use. For example to use SHARE/make_bobdole.inc you would set
MACHINE=bobdole before calling the build scripts. It is also
important to set STELLOPT_PATH to the path to your current directory
where you've pulled the repository.
Once you configure the environment variables, you can begin to compile the code by
./build_all
By default, it will compile all the codes in the folder with the option clean_release.
You can customize the script by providing additional commandline arguments, like ./build_all -o release -j 4 STELLOPTV2. To check the options, type ./build_all -h.
There is also a Docker image available for use at https://hub.docker.com/r/zhucaoxiang/stellopt.
For more information, please view STELLOPT compilation.
EDITING CODE
Once a working copy is developed for your computer, you are welcome to push it back to the main repository for other users. You can ask for a write permission and push your changes into a remote branch. Then submit a pull request through GitHub.
Or you can share your changes via git fork, which doesn't require you have the write permission.
GitHub actions will be triggered by each push and pull-request. The code will be compiled with debug option and you can check the full log at GitHub actions.
UTILITIES
A Python interface using CTYPES is also included but it requires a
static shared build of LIBSTELL. This is still a highly experimental
option. You can find the python scripts at ./pySTEL.
There are also some other plotting packages developed by group members. Here are some examples.
- matlabVMEC: MATLAB packages for various codes.
- coilpy: Python package for toroidal Fourier surface, coils, FOCUS and STELLOPT.
If you are willing to share your code, please add your contributions here.
REPORT BUGS
If you find any bugs or have any suggestions, please submit an issue through GitHub issues. You are suggested to provide detailed description and assign someone when creating an issue.
DOCUMENTATION
You can find some wiki pages at
GitHub pages.
This is automatically generated from the markdown source files
in the gh-pages branch.
You are welcome to report/fix/update the wiki pages.