There are two ways to download the software, i.e. by using Git and GitHub or by downloading a zip file:
|Setup GIT/GitHub (recommended)||Download .zip file directly|
Downloading the zip file will create a local copy on your computer which is fully decoupled from the new developments taking place. It is therefore recommended to use Git (a software version control system) instead, which allows you to 1) pull in the latest changes as they become available, 2) potentially join in with development and push changes to the project. Read more on how to use git below.
Make sure the GIBBON folder is in a location where you have full read/write permissions!
The steps below guide you through a streamlined installation procedure using the
*If you prefer manual installation do the following: 1) Add the GIBBON folder (with subfolders) to the path and save the path definitions, 2) Run
createHelpDemoDocumentation.m to integrate the help and documentation, 3) For the 3rd party packages: 3a) Add the
export_fig folder to the path and save the path definitions, 3b) Go to the config folder in ../GIBBON/config and edit the FEBioPath.txt file to contain the full path to the FEBio executable
Skip this step if finite element analysis and figure exporting are not required.
||FEBio is a finite element solver and is used in GIBBON for all finite element analysis. Use of FEBio is featured in many of the
||No||Get via GitHub
Is used for tetrahedral meshing (and possibly constrained 3D Delaunay tessellation). See for instance
|Yes||For other versions: TetGen website|
installGibbon.m the GIBBON, FEBio, and export_fig path definitions will be added and saved to MATLAB. The help and documentation will also be integrated. Once finished you will be asked to restart MATLAB.
installGibbon.m can be found in the main GIBBON folder.
Below is a very basic set of instructions for using Git (which skips over advanced Git features). If you are new to Git you may want to search for tutorials online, also check out these learning resources and this 10 min. GIT tutorial.
Make sure you have git installed, browse to a suitable folder location (one where you have read/write permissions) and run:
git init git clone https://github.com/gibbonCode/GIBBON.git
This will create a local clone on your system. Git will keep track of new developments on the remote version (GitHub repository) version and also changes you make locally.
To view changes, e.g. new files, modifications, rename events, and deletions, use:
If you want to remove all changes you’ve made to GIBBON locally (e.g. to avoid merge conflicts) you can force Git to remove your changes and revert back to the version you cloned by using:
git reset --hard HEAD
Note the above operation only removes your changes. To get the latest version from the remote repository you still need to do
To pull changes available on the remote version (the GitHub repository). Run the following:
Pulling in changes is quick and easy if you haven’t made conflicting changes, i.e. if you made changes to files locally that are also changed on the remote version. If changes have occurred there may be so called “merge conflicts” (note that changes may naturally in your GIBBON folder, e.g. as part of installation, or by making minor or even accidental changes to files as one uses GIBBON). Users comfortable with Git may be able to easy resolve such conflicts (by merging the changes from the remote and the local). If the changes listed are not relevant and can be reverted you can do a reset as described in the previous step. If this is done you may have to run
installGibbon.m again (as some of the changes may be due to documentation integration on your system). You can verify everything is up to date with the remote repository by running