GifTools



Tools

GRAV3D v6.0 is a program library for carrying out 3D forward modelling and inversion of gravity data.

NeilBostrom / GifTools.cs. Last active Apr 20, 2020. Star 0 Fork 0; Star Code Revisions 2. What would you like to do? Embed Embed this gist in your website. Get started with GitHub Packages Safely publish packages, store your packages alongside your code, and share your packages privately with your team.

True model, gravity anomaly data and the recovered model.

Highlights of Grav3D v6.0¶

Many advancements have been made since the previous version of this coding package.Highlights of Grav3D v6.0 include:

  • the ability to forward model and invert surface, borehole, and airborne gravity data in 3D
  • sensitivity weighting so that targets recovered through inversion are placed at the correct depth
  • the ability to recover compact and/or blocky models using sparse norms, in additional to smooth models using a standard least-squares approach
  • implementing wavelet compression to reduce the storage cost of the sensitivity matrix and allow the user to solve larger problems

Sponsorship¶

The current improvements have been funded by the GIFtools Consortium which included “Potential fields and software for advanced inversion” (2012-2020) sponsored by Teck, Glencore, BHP Billiton, Vale, Cameco, Barrick, Rio Tinto, and Anglo American.

Contents¶

  • 1. Package overview
  • 2. Background theory
  • 3. Elements
  • 4. Running the programs
  • 5. Example

Warning

The GIFtools cookbook provides supporting documentation for proprietary software developed by the UBC Geophysical Inversion Facility. Currently, GIFtools software is only accessible by the consortium of companies which funded the GIFtools project. Plans to commercialize this software is underway.

To install GIFtools, you will need to go the the website and download thelatest installation executable(Log-in required). To obtained a login, please contact us

2.1. Installation notes¶

The two available executables are either GIFtools_vXpX_install orGIFtools_vXpX_offlineInstall. The only difference is that the off-lineinstall is much bigger to ensure that the Matlab run-time environment that isneeded is accessible if not already installed. The former installationexecutable will use the internet to call Matlab to check on the environmentand download if necessary. Either way, you will need administratorprivileges. Once downloaded here are the 7 steps to follow:

  1. Double click on executable, which will lead you to this screen (you can trust us…):

If you use a proxy server and you are using the GIFtools_vXpX_install.exe, you will need to click on the Connection Settings button and put the server name and port along with a user ID and password to access the internet.

  1. Click Next and choose the installation directory for GIFtools. This does not necessarily need to be in C:ProgramFilesGIF! If you have created another folder somewhere on your computer, you may install GIFtools there (e.g., D:GIFtools)

NOTE 1: If you have previous versions of GIFtools on your computer, you can put the latest version in the parent directory (e.g., C:ProgramFilesGIF). This directory will also be where you should place all of your executables (i.e. inversion executables, MeshTools3D, etc.) that GIFtools would require. Here is an example:

NOTE 2: If you chose the Addashortcuttothedesktop option, you will need to perform step 7 on that shortcut too!

  1. Click Next: One of two things will now happen, either (1) you will have to install the run-time compiler or (2) the compiler will already be installed. If (1), follow the on-screen instructions (most likely just keep clicking next) and this will lead you to step 5. If (2) this window will show up:

  1. You are ready for install! Click Install >. It will take a minute or two.

  1. If everything worked out, you will get to the screen below giving you step 7’s instructions. Click Finish and read below to finish the install so the link is not broken.

  1. Fix the Start-in directory link for GIFtools. Go to the Start menu and find GIFtools_vXpX and right-click and select properties:

Note that the Start in: field is blank. Copy and paste the Target: field to the Start in: field. Then remove GIFtools_vXpX.exe from the Start in field so that only the directory is present:

Click Apply and then OK. GIFtools is now installed and can be started from the Start menu

Tip

Why did we have to do step 7? Windows makes a copy in the registry and starts GIFtools there. The visualization package (VTK) that is used requires static Java libraries and therefore GIFtools needs to be started where those dynamic libraries are located.

Tip

Manual shortcuts to desktop do not require step 7! If you have gone into GIFtools application directory, right-clicked and chose Createshortcut, then the the shortcut (by default it will ask you if you want to put it on the desktop) will already have the Start in: field adjusted.

Gif about spicoli and tools

2.2. GIFtools system requirements¶

Below are the system requirements for GIFtools.

2.2.1. Operating System¶

  • Microsoft Windows 7

  • Microsoft Windows 8

  • Microsoft Windows 10

  • Linux (by request)

  • Mac (by request)

2.2.2. CPU type¶

  • 64-bit (Designed on Intel Core i7)

2.2.3. Disk size¶

  • Requires 275 MB of disk space (not including GIF Fortran executables)

2.2.4. Network¶

  • Deployment via GIFtools_vXpX_install requires internet

  • Deployment via GIFtools_vXpX_Offlineinstall

  • There is no license server for GIFtools

  • Tutorial links within GIFtools calls user-default internet browser

2.2.6. Display resolution¶

  • 1920 x 1080 with TrueColor

2.2.8. .NET framework¶

GifTools

  • Minimum .NET framework version 4.5.1

2.2.10. Browser¶

Gift tools for men

  • Calls user-selected default browser for tutorial links

2.3. Installing Fortran Modeling/Inversion Codes¶

Forward modeling, inversion and other specialized functionality is carried out using a set of externalexecutables written in Fortran. For each modeling code (Mag3D, DCIPoctree, E3DMT, etc…), there is a separatecoding package. Individual licenses must be purchased to use each Fortran coding package in addition to theGIFtools license. If the user is licensed to use particular Fortran coding package, the installation stepsare as follows:

  • Acquire the .zip file containing the Fortran coding package. Note that Consortium sponsors have specialized access and may login and download Fortran packages from the UBC-GIF website .

  • Unzip the file and place the contents into a desired folder.

  • Add the folder to your computer’s path variables. That is, go to your computer’s settings to ‘edit system environment variables’, and add the folder to the one called ‘PATH’. If this step is not completed, your computer will not find the necessary executables when running the Fortran code from the GUI.

2.4. Python Installation (Optional)¶

Starting from version 2.25, GIFtools has the option to run somefunctionalities from the open-source community; namely batch 2D DC/IP inversions. In order to get access tothese codes, users must install Python. This isdone through the Anaconda project

2.4.1. Part 1¶

If you do not already have Python 3.5 or greater already installed, please follow these steps to get setup:

  • Download the latest Miniconda

  • Run the installed executable

    • Let Anaconda set the Environment Path (check both boxes!!)

    • simpegEM1D and its dependencies

Full installation time (approx 15) min

Congratulation, you should now have access to the Python ecosystem!More packages can be installed through command lines:

Either with anaconda (recommended)> condainstallPackageName

or alternatively through pip> pipinstallPackageName

GifTools

2.4.2. Part 2¶

Now that you have Python installed, you must ensure that GIFtools can find Python when it is needed.To do this, you will need to edit your computer’s environment variables. For Windows computers,this is set through the control panel under Edit the System Environment Variables.

Gif Of Woman Using Power Tools

In the System Properties window, click the Environment Variables button. In the Environment Variables window that pops up,you will need to select the variable called PATH and click edit for either the user variables (whoever is logged in)or system variables (everyone). If there is no variable called PATH, you will need to create a new variable called PATH.

Gif Tools

When you click edit, the Edit Environment Variable window will pop up. You must add the path to Anaconda3 and the Librarybin subdirectory.In our case, these directories were C:Usersdevinanaconda3 and C:Usersdevinanaconda3Librarybin.