variable (str) – choose which variable to load, either ‘w_b’ for basal melt rate, ‘w_b_interp’,
for basal melt rate with interpolated values, and ‘w_b_uncert’ for uncertainty
Load a grid of basement topography.
Offshore and sub-Ross Ice Shelf basement topography.
from Tankersley et al.[2], Tankersley et al.[3] and
Lindeque et al.[4].
Elevations are referenced to WGS84 ellipsoid.
Parameters:
region (tuple[float, float, float, float], optional) – bounding region to clip the loaded grid to, by default doesn’t clip
spacing (float, optional) – grid spacing to resample the loaded grid to, by default 5e3
registration (str, optional) – change registration with either ‘p’ for pixel or ‘g’ for gridline registration,
by default is None.
Referenced to the EIGEN-6C4 geoid. To convert to be ellipsoid-referenced, we add
the geoid grid. use reference=’ellipsoid’ to include this conversion in the
fetch call.
Surface and ice thickness are in ice equivalents. Actual snow surface is from
REMA [6], and has had firn thickness added(?) to it to
get Bedmachine Surface.
To get snow surface: surface+firn
To get firn and ice thickness: thickness+firn
Here, icebase will return a grid of surface-thickness
This should be the same as snow-surface - (firn and ice thickness)
Parameters:
layer (str) – choose which layer to fetch:
‘bed’, ‘dataid’, ‘errbed’, ‘firn’, ‘geoid’, ‘mapping’, ‘mask’, ‘source’,
‘surface’, ‘thickness’; ‘icebase’ will give results of surface-thickness
reference (str) – choose whether heights are referenced to ‘eigen-6c4’ geoid or the
‘ellipsoid’ (WGS84), by default is eigen-6c4’
region (tuple[float, float, float, float], optional) – GMT-format region to clip the loaded grid to, by default doesn’t clip
spacing (str or int, optional) – grid spacing to resample the loaded grid to, by default 500m
registration (str, optional) – change registration with either ‘p’ for pixel or ‘g’ for gridline registration,
by default is None.
kwargs (Any) – additional kwargs to pass to resample_grid
Returns:
Returns a loaded, and optional clip/resampled grid of Bedmachine.
All grids are by default referenced to the EIGEN-GL04C geoid. Use the
reference=’ellipsoid’ to convert to the WGS-84 ellipsoid or reference=’eigen-6c4’ to
convert to the EIGEN-6c4 geoid.
Unlike Bedmachine data, Bedmap2 surface and icethickness contain NaN’s over the
ocean, instead of 0’s. To fill these NaN’s with 0’s, set fill_nans=True.
Note, this only makes since if the reference is the geoid, therefore, if
reference=’ellipsoid and fill_nans=True, the nan’s will be filled before
converting the results to the geoid (just for surface, since thickness isn’t
relative to anything).
Parameters:
layer (str) – choose which layer to fetch:
“bed”, “coverage”, “grounded_bed_uncertainty”, “icemask_grounded_and_shelves”,
“lakemask_vostok”, “rockmask”, “surface”, “thickness”,
“thickness_uncertainty_5km”, “gl04c_geiod_to_WGS84”, “icebase”
reference (str) – choose whether heights are referenced to the ‘eigen-6c4’ geoid, the WGS84
ellipsoid, ‘ellipsoid’, or by default the ‘eigen-gl04c’ geoid.
region (tuple[float, float, float, float], optional) – GMT-format region to clip the loaded grid to, by default doesn’t clip
spacing (str or int, optional) – grid spacing to resample the loaded grid to, by default 10e3
registration (str, optional,) – choose between ‘g’ (gridline) or ‘p’ (pixel) registration types, by default is
the original type of the grid
fill_nans (bool, optional,) – choose whether to fill nans in ‘surface’ and ‘thickness’ with 0. If converting
to reference to the geoid, will fill nan’s before conversion, by default is
False
kwargs (Any) – additional kwargs to pass to resample_grid
Returns:
Returns a loaded, and optional clip/resampled grid of Bedmap2.
version=’an-2015’
Crustal thickness (distance from solid (ice and rock) top to Moho discontinuity)
from An et al.[11].
Accessed from http://www.seismolab.org/model/antarctica/lithosphere/index.html#an1s
File is the AN1-CRUST model, paper states “Moho depths and crustal thicknesses
referred to below are the distance from the solid surface to the Moho. We note that
this definition of Moho depth is different from that in the compilation of AN-MOHO”.
Unclear, but seems moho depth is just negative of crustal thickness. Not sure if its
to the ice surface or ice base.
Parameters:
version (str) – Either ‘shen-2018’,
will add later: ‘lamb-2020’, ‘an-2015’, ‘baranov’, ‘chaput’, ‘crust1’,
‘szwillus’, ‘llubes’, ‘pappa’, ‘stal’
region (tuple[float, float, float, float], optional) – GMT-format region to clip the loaded grid to, by default doesn’t clip
spacing (int, optional) – grid spacing to resample the loaded grid to, by default spacing is read from
downloaded files
registration (str, optional) – change registration with either ‘p’ for pixel or ‘g’ for gridline registration,
by default is None.
Returns:
Returns a loaded, and optional clip/resampled grid of crustal thickness.
Loads a grid of Antarctic topography from ETOPO1 from ETOPO1 1 Arc-Minute Global Relief Model: Procedures, Data Sources and Analysis[14].
Originally at 10 arc-min resolution, reference to mean sea-level.
Loads a grid of Antarctic geoid heights derived from the EIGEN-6C4 from
Förste et al.[15] spherical harmonic model of Earth’s gravity field.
Originally at 10 arc-min resolution.
Negative values indicate the geoid is below the ellipsoid surface and vice-versa.
To convert a topographic grid which is referenced to the ellipsoid to be referenced
to the geoid, add this grid.
To convert a topographic grid which is referenced to the geoid to be reference to
the ellipsoid, subtract this grid.
version=’burton-johnson-2020’
From Burton-Johnson et al.[22].
Accessed from supplementary material
Choose for either of grid, or the point measurements
version=’losing-ebbing-2021’
From Lösing and Ebbing[23] and Lösing and Ebbing[24].
version=’aq1’
From Stål et al.[25] and Stål et al.[26].
Parameters:
version (str) – Either ‘burton-johnson-2020’, ‘losing-ebbing-2021’, ‘aq1’,
region (tuple[float, float, float, float], optional) – GMT-format region to clip the loaded grid to, by default doesn’t clip
spacing (int, optional) – grid spacing to resample the loaded grid to, by default spacing is read from
downloaded files
registration (str, optional) – change registration with either ‘p’ for pixel or ‘g’ for gridline registration,
by default is None.
kwargs (Any) – if version=’burton-johnson-2020’, then kwargs are passed to return point
measurements instead of the grid.
Returns:
Returns a loaded, and optional clip/resampled grid of GHF data.
version=’antgg-update’
Preliminary compilation of Antarctica gravity and gravity gradient data.
Updates on 2016 AntGG compilation.
Accessed from https://ftp.space.dtu.dk/pub/RF/4D-ANTARCTICA/
version (str) – choose which version of gravity data to fetch.
region (tuple[float, float, float, float], optional) – GMT-format region to clip the loaded grid to, by default doesn’t clip
spacing (str or int, optional) – grid spacing to resample the loaded grid to, by default 10e3
registration (str, optional) – change registration with either ‘p’ for pixel or ‘g’ for gridline registration,
by default is None.
kwargs (Any) – additional kwargs to pass to resample_grid and set the anomaly_type.
Keyword Arguments:
anomaly_type (str) – either ‘FA’ or ‘BA’, for free-air and bouguer anomalies, respectively. For
antgg-update can also be ‘DG’ for gravity disturbance, or ‘Err’ for error
estimates.
Returns:
Returns a loaded, and optional clip/resampled grid of either observed, free-air
or Bouguer gravity anomalies.
Ice-sheet height and thickness changes from ICESat to ICESat-2.
from Smith et al.[41].
Choose a version of the data to download with the format: “ais_VERSION_TYPE” where
VERSION is “dhdt” for total thickness change or “dmdt” for corrected for firn-air
content.
TYPE is “floating” or “grounded”
add “_filt” to retrieve a filtered version of the data.
version (str,) – choose which file to retrieve from the following list:
“Coastline”, “Basins_Antarctica”, “Basins_IMBIE”, “IceBoundaries”, “IceShelf”,
“Mask”
Load the MODIS MoA imagery in either “750m” or “125m” resolutions from
MODIS Mosaic of Antarctica 2008-2009 (MOA2009) Image Map, Version 2[42] and Scambos et al.[43].
version=’an-2015’
This is fetch.crustal_thickness(version=’an-2015)* -1
Documentation is unclear whether the An crust model from
An et al.[11] is crustal thickness or moho depths, or whether it
makes a big enough difference to matter.
version=’pappa-2019’
from Pappa et al.[44].
Accessed from supplement material
Parameters:
version (str) – Either ‘shen-2018’, ‘an-2015’, ‘pappa-2019’,
will add later: ‘lamb-2020’, ‘baranov’, ‘chaput’, ‘crust1’,
‘szwillus’, ‘llubes’,
region (tuple[float, float, float, float], optional) – GMT-format region to clip the loaded grid to, by default doesn’t clip
spacing (int, optional) – grid spacing to resample the loaded grid to, by default spacing is read from
downloaded files
registration (str, optional,) – choose between ‘g’ (gridline) or ‘p’ (pixel) registration types, by default is
the original type of the grid
Returns:
Returns a loaded, and optional clip/resampled grid of crustal thickness.
Load the REMA surface elevation data from Howat et al.[6]. The data
are in EPSG3031 and reference to the WGS84 ellipsoid. To convert the data to be
geoid-referenced, subtract a geoid model, which you can get from fetch.geoid().
Choose between “1km” or “500m” resolutions with parameter version.
Resample a grid to a new spacing, region, and/or registration. Method of resampling
depends on comparison with initial and supplied values for spacing, region, and
registration. If initial values not supplied, will try and extract them from the
grid.
Load either a shapefile of ROSETTA-ice flightlines, a dataframe of ROSETTA-Ice
airborne gravity data over the Ross Ice Shelf, or a dataframe of ROSETTA-Ice density
values from the density inversion.
from Tinto et al.[45].
Accessed from https://www.usap-dc.org/view/project/p0010035
This is only data from the first 2 of the 3 field seasons.
Columns:
Line Number: The ROSETTA-Ice survey line number, >1000 are tie lines
Latitude (degrees): Latitude decimal degrees WGS84
Longitude (degrees): Longitude decimal degrees WGS84
unixtime (seconds): The number of seconds that have elapsed since midnight
(00:00:00 UTC) on January 1st, 1970
Height (meters): Height above WGS84 ellipsoid
x (meters): Polar stereographic projected coordinates true to scale at 71° S
y (meters): Polar stereographic projected coordinates true to scale at 71° S
FAG_levelled (mGal): Levelled free air gravity
Load a dataframe of ROSETTA-Ice airborne magnetics data over the Ross Ice Shelf
from Tinto et al.[45].
Accessed from https://www.usap-dc.org/view/project/p0010035
Columns:
Line Number: The ROSETTA-Ice survey line number, >1000 are tie lines
Latitude (degrees): Latitude decimal degrees WGS84
Longitude (degrees): Longitude decimal degrees WGS84
unixtime (seconds): The number of seconds that have elapsed since midnight
(00:00:00 UTC) on January 1st, 1970
H_Ell (meters): Height above WGS84 ellipsoid
x (meters): Polar stereographic projected coordinates true to scale at 71° S
y (meters): Polar stereographic projected coordinates true to scale at 71° S
Mag_anomaly (nT): magnetic anomaly