ISSM is a large-scale thermo-mechanical 2D/3D parallelized multi-purpose finite-element software dedicated to ice sheet and sea-level modeling.
- Forum: https://issm.ess.uci.edu/forum
- GitHub: https://github.com/ISSMteam/ISSM
- Website: https://issm.jpl.nasa.gov
Navigate to the parent directory where you want the ISSM repository to be located. If you plan to make contributions to the code base, we recommend that you check out a copy via SSH with,
git clone [email protected]:ISSMteam/ISSM.git
Note that you will you first need to add an SSH key to your GitHub account.
If you plan only to use ISSM without making contributions, you also have the option of checking out a copy via HTTPS.
git clone https://github.com/ISSMteam/ISSM.git
Note that checkout via HTTPS does not require credentials, but does not allow commits without first setting up a personal access token.
A good basic workflow for committing changes to the repository is,
- Stash your local changes
git stash
- Update your local branch
git pull
- Merge your local changes
git stash apply
- Add, commit, and push your changes
git add [file]
git commit [-m "descriptive commit message"]
git push
-
If you have forked the ISSM repository, consider making sure that your commit passes CI workflows before submitting a pull request.
-
Submit a pull request via GitHub so that project admins can review your changes and merge them into the main branch.
If you find yourself making a lot of commits and pull requests, consider asking us to add you to the 'ISSM Contributors' group, which will allow you to make commits directly to the repository.
fatal: unable to access 'https://github.com/ISSMteam/ISSM.git/': The requested URL returned error: 403
If you get this error on commit to the repository, it means you originally cloned via HTTPS. You have two options here,
- Create a personal access token and use it in place of your password when prompted for credentials.
- Change the config for this clone of the repository to use the SSH protocol with,
git remote set-url origin [email protected]:ISSMteam/ISSM.git
Note that in the second case you will have to create an SSH key and add it to your GitHub account.