Awesome
Charon | tcad-charon
Charon is an open-source semiconductor device modeling code, widely referred to as a TCAD (technology computer-aided design) code, developed at Sandia National Laboratories. It is written in C++ and relies on another Sandia open-source project, Trilinos, for supporting code, such as nonlinear and linear solvers, finite-element and finite-volume libraries, I/O, etc. In addition to running on most Linux-based computers, Charon also supports simulation of extremely large problems on massively parallel computing systems that support the MPI standard.
Contents
Getting Up and Running with Charon
Git Instruction
Charon uses the git version control system. If you are unfamiliar with how to use git and GitLab, the following resources will likely be beneficial:
Git LFS
Charon also uses git LFS in many of its repositories.
You must have git LFS installed and configured on your machine before you'll be able to work with Charon.
Visit this wiki page to read up on what it is, how to install it, and how to use it.
Set Up your Compiler Toolchain
Center 1400's Software Engineering Maintenance and Support group (SEMS) provides almost all the compilers and third-party libraries (TPLs) that Charon requires. These are now widely available on Sandia machines, including the SON, SRN, CEE LAN and HPC. This is our preferred standardized source for TPLs and they are consistent with our testing environment. See this page for instructions on how to gain access to the SEMS modules, and if you need help, contact the SEMS team for assistance.
Once you have access to the modules, you'll need to load the following:
- a compiler (gcc, intel, clang)
- OpenMPI
- CMake
- Python
- Boost
- HDF5
- NetCDF
Clone the Repositories
Getting all the Charon repositories set up in the right places is mostly automated. First, make sure you have SSH keys setup on cee-gitlab by following these instructions
Next clone this repository with
cd <someBaseDirectory>
git clone git@cee-gitlab.sandia.gov:Charon/tcad-charon
and then run the setup script with
cd tcad-charon
./scripts/setup
Follow the prompts as the script sets everything up for you. If you accept the default build directory location, you should have the following directory structure:
<someBaseDirectory>/ # a.k.a. ${WORKSPACE}
build/
configure
tcad-charon/
tcad-charon/
...
docs/
...
src/
test/
heavyTests/
heavyTestsOUO/
nightlyTests/
nightlyTestsOUO/
unitTests/
...
Trilinos/
Configure, Build, and Test
To configure Charon cd to a build directory, either the one that
was created above or one of your own. It is generally a good idea to
create another subdirectory utilizing a name representative of the
build you will be performing. For example, if you're using the GNU
compilers and building with debug support
cd ../build
mkdir gnu.dbg
cd gnu.dbg
You can then configure with
../../tcad-charon/scripts/build/all/build_charon.py
If the configure is successful, you can build with
make -j <numProcs>
Assuming the build is successful, you can run the test suite with
ctest -j <numProcs> -L nightly
additionally, if you build a debug version you'll want to run ctest like
ctest -j <numProcs> -L nightly -LE debugexclude
For futher details on the charon build script, build_charon.py, see
its associated wiki page.
Updating Charon
Any time you need to grab the latest from all the Charon repositories:
cd path/to/tcad-charon
gitdist checkout develop
gitdist pull
The gitdist
command will run those git commands across all of Charon's repositories. For
more details on what it is and how to use it, see this wiki
page.
Where to Ask Questions
If you need help with Charon, feel free to ask questions by creating an issue. Select the ~Question issue template, and that will pre-populate the Description field, giving you instructions on submitting the issue.
Contributing to Charon
If you're interested in contributing to Charon, we welcome your collaboration. Please read our contributing guidelines for details on our workflow, submitting merge requests, etc.
License
See Copyright.txt.