Authors:
Vanderlei C. Oliveira Jr.1, Leonardo Uieda2, Kristoffer A. T. Hallam1 and Valéria C. F. Barbosa1
1Observatório Nacional, Rio de Janeiro, Brazil
2University of Hawai'i at Manoa, Honolulu, USA
This paper has been submitted for publication in the journal Geophysics.
A snapshot of this repository is archived at doi:10.5281/zenodo.1255306
The gravity anomaly is defined as the difference between the Earth's gravity on the geoid and the normal gravity on the reference ellipsoid. Because these quantities are not at the same point, the anomaly contains centrifugal accelerations and cannot be considered a harmonic function. The gravity disturbance is the difference between gravity and normal gravity at the same point. Consequently, the centrifugal effects can be neglected and the disturbance can be considered a harmonic function. This is the premise behind most potential-field data processing techniques (e.g., upward/downward continuation). Unlike the anomaly, the disturbance is due solely to the gravitational effects of geologic sources, making it the most appropriate for geophysical purposes. Use of the gravity anomaly in geophysics carries with it the implicit assumption that it is a good approximation for the gravity disturbance. However, bear in mind that the difference between the gravity disturbance and the free-air anomaly can be larger than 10 mGal worldwide. In fact, we argue that the assumptions made during gravity forward and inverse modeling imply that the quantity being modelled is the disturbance, not the anomaly.
Map of the difference between the gravity disturbance and the free-air anomaly worldwide.
This is the error committed when assuming that the free-anomaly is a good
approximation for the disturbance.
All source code used to generate the results and figures in the paper are in
the code
folder.
The calculations and figure generation are all run inside
Jupyter notebooks.
The data used in this study is provided in data
and the sources for the
manuscript text and figures are in manuscript
.
See the README.md
files in each directory for a full description.
You can download a copy of all the files in this repository by cloning the git repository:
git clone https://github.com/pinga-lab/use-the-disturbance.git
You'll need a working Python environment to run the code.
The recommended way to set up your environment is through the
Anaconda Python distribution which
provides the conda
package manager.
Anaconda can be installed in your user directory and does not interfere with
the system Python installation.
The required dependencies are specified in the file environment.yml
.
We use conda
virtual environments to manage the project dependencies in
isolation.
Thus, you can install our dependencies without causing conflicts with your
setup (even with different Python versions).
Run the following command in the repository folder (where environment.yml
is located) to create a separate environment and install all required
dependencies in it:
conda env create
Before running any code you must activate the conda environment:
source activate use-the-disturbance
or, if you're on Windows:
activate use-the-disturbance
This will enable the environment for your current terminal session. Any subsequent commands will use software that is installed in the environment.
You can explore the code by to executing the Jupyter notebooks individually. To do this, you must first start the notebook server by going into the repository top level and running:
jupyter notebook
This will start the server and open your default web browser to the Jupyter
interface. In the page, go into the code
folder and select the notebook that
you wish to view/run.
The notebook is divided into cells (some have text while other have code).
Each cell can be executed using Shift + Enter
.
Executing text cells does nothing and executing code cells runs the code
and produces it's output.
To execute the whole notebook, run all cells in order.
All source code is made available under a BSD 3-clause license. You can freely
use and modify the code, without warranty, so long as you provide attribution
to the authors. See LICENSE.md
for the full license text.
The manuscript text is not open source. The authors reserve the rights to the article content, which is currently submitted for publication in the journal Geophysics.