MATLAB Examples

scarloc documentation

scarloc is part of Antarctic Mapping Tools for Matlab (Greene et al., 2017). Click here for a complete list of functions in AMT.

The scarloc function returns coordinates of any of the 25,601 features identified by the Scientific Committee on Antarctic Research (SCAR).

Contents

Syntax

[lat,lon] = scarloc(FeatureNames)
latlon = scarloc(FeatureNames)
[x,y] = scarloc(FeatureNames,'xy')
xy = scarloc(FeatureNames,'xy')
[...] = scarloc(FeatureNames,'xy','km')

Description

[lat,lon] = scarloc(FeatureNames) returns the geo coordinate location(s) of an almost any feature(s) in Antarctica. FeatureNames can be string or cell array of multiple locations.

latlon = scarloc('Feature Name') returns geo coordinate location(s) of an almost any feature(s) in Antarctica. If only one output argument is used, column 1 corresponds to latitude and column 2 corresponds to longitude.

[x,y] = scarloc(FeatureNames,'xy') returns polar stereographic (true latitude 71°S) eastings and northings in meters.

[y = scarloc(FeatureNames,'xy') returns polar stereographic (true latitude 71°S) eastings and northings in meters. If only one output argument is used, column 1 corresponds to eastings and column 2 corresponds to northings.

[...] = scarloc(FeatureNames,'xy','km') returns polar stereographic kilometers instead of the default meters.

Example: Where is McMurdo Station?

[lat,lon] = scarloc('McMurdo Station')
lat =
  -77.8478
lon =
  166.6683

Example 2: Two-column output

If two outputs are requested as in Example 1, outputs are lat and lon. If one output is requested, latitudes populate column 1 and longitudes populate column 2:

latlon = scarloc('mcmurdo station')
latlon =
  -77.8478  166.6683

Example 3: Multiple locations

Multiple locations may be entered as a cell array of strings:

places = {'Byrd Camp';'Casey Station';'Pine Island Glacier'};
scarloc(places)
ans =
  -80.0833 -119.5333
  -66.2833  110.5194
  -75.1667 -100.0000

Example 4: Polar stereographic coordinates

If you want polar stereographic eastings and northings, include the 'xy' tag:

scarloc(places,'xy')
ans =
   1.0e+06 *
   -0.9397   -0.5324
    2.4470   -0.9159
   -1.5958   -0.2814

Example 5: Polar stereographic kilometers

Sometimes you want polar stereographic kilometers, but dividing meters by a thousand feels like far too much of a burden. Fortunately, scarloc'll do it for you:

scarloc(places,'xy','km')
ans =
   1.0e+03 *
   -0.9397   -0.5324
    2.4470   -0.9159
   -1.5958   -0.2814

Known Issues

Unfortunately, scarloc and scarlabel are plagued by problems with special characters. This includes letters with accents and umlauts. My sincerest apologies to our French, Norwegian, and just about everything aside from American friends.

Cite this dataset as:

Secretariat SCAR (1992, updated 2015). Composite Gazetteer of Antarctica, Scientific Committee on Antarctic Research. GCMD Metadata http://gcmd.nasa.gov/records/SCAR_Gazetteer.html

Citing AMT

If this function or any other part of Antarctic Mapping Tools is useful for you, please cite the paper that describes AMT.

Greene, C. A., Gwyther, D. E., & Blankenship, D. D. Antarctic Mapping Tools for Matlab. Computers & Geosciences. 104 (2017) pp.151-157. doi:10.1016/j.cageo.2016.08.003.

Author Info

This function and supporting documentation were written by Chad Greene of the University of Texas at Austin's Institute for Geophysics (UTIG). Feel free to contact me if you have any questions or comments.