Contents.m 4.16 KB
Newer Older
Valentin Platzgummer's avatar
Valentin Platzgummer committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93
% GeographicLib toolbox
% Version 1.50 2019-09-19
%
%   This toolbox provides native MATLAB implementations of a subset of the
%   C++ library, GeographicLib.  Key components of this toolbox are
%
%     * Geodesics, direct, inverse, area calculations.
%     * Projections, transverse Mercator, polar stereographic, etc.
%     * Grid systems, UTM, UPS, MGRS.
%     * Geoid lookup, egm84, egm96, egm2008 geoids supported.
%     * Geometric transformations, geocentric, local cartesian.
%     * Great ellipse, direct, inverse, area calculations.
%
%   All the functions are vectorized and so offer speeds comparable to
%   compiled C++ code when operating on arrays.  Additional information is
%   available in the documentation for the GeographicLib, which is
%   available at
%
%       https://geographiclib.sourceforge.io/1.50
%
%   Some common features of these functions:
%     * Angles (latitude, longitude, azimuth, meridian convergence) are
%       measured in degrees.
%     * Distances are measured in meters, areas in meters^2.
%     * Latitudes must lie in [-90,90].  However most routines don't check
%       that this condition holds.  (Exceptions are the grid system and
%       geoid functions.  These return NaNs for invalid inputs.)
%     * The ellipsoid is specified as [a, e], where a = equatorial radius
%       and e = eccentricity.  The eccentricity can be pure imaginary to
%       denote a prolate ellipsoid.
%     * Keep abs(e) < 0.2 (i.e., abs(f) <= 1/50) for full double precision
%       accuracy.
%
%   There is some overlap between this toolbox and MATLAB's Mapping
%   Toolbox.  However, this toolbox offers:
%     * better accuracy;
%     * treatment of oblate and prolate ellipsoid;
%     * guaranteed convergence for geoddistance;
%     * calculation of area and differential properties of geodesics;
%     * ellipsoidal versions of the equidistant azimuthal and gnomonic
%       projections.
%
% Function summary:
%
% Geodesics
%   geoddistance     - Distance between points on an ellipsoid
%   geodreckon       - Point at specified azimuth, range on an ellipsoid
%   geodarea         - Surface area of polygon on an ellipsoid
%
% Projections
%   tranmerc_fwd     - Forward transverse Mercator projection
%   tranmerc_inv     - Inverse transverse Mercator projection
%   polarst_fwd      - Forward polar stereographic projection
%   polarst_inv      - Inverse polar stereographic projection
%   eqdazim_fwd      - Forward azimuthal equidistant projection
%   eqdazim_inv      - Inverse azimuthal equidistant projection
%   cassini_fwd      - Forward Cassini-Soldner projection
%   cassini_inv      - Inverse Cassini-Soldner projection
%   gnomonic_fwd     - Forward ellipsoidal gnomonic projection
%   gnomonic_inv     - Inverse ellipsoidal gnomonic projection
%
% Grid systems
%   utmups_fwd       - Convert to UTM/UPS system
%   utmups_inv       - Convert from UTM/UPS system
%   mgrs_fwd         - Convert UTM/UPS coordinates to MGRS
%   mgrs_inv         - Convert MGRS to UTM/UPS coordinates
%
% Geoid lookup
%   geoid_height     - Compute the height of the geoid above the ellipsoid
%   geoid_load       - Load a geoid model
%
% Geometric transformations
%   geocent_fwd      - Conversion from geographic to geocentric coordinates
%   geocent_inv      - Conversion from geocentric to geographic coordinates
%   loccart_fwd      - Convert geographic to local cartesian coordinates
%   loccart_inv      - Convert local cartesian to geographic coordinates
%
% Great ellipses
%   gedistance       - Great ellipse distance on an ellipsoid
%   gereckon         - Point along great ellipse at given azimuth and range
%
% Utility
%   defaultellipsoid - Return the WGS84 ellipsoid
%   ecc2flat         - Convert eccentricity to flattening
%   flat2ecc         - Convert flattening to eccentricity
%   geographiclib_test - The test suite for the geographiclib package
%
% Documentation
%   geoddoc          - Geodesics on an ellipsoid of revolution
%   projdoc          - Projections for an ellipsoid
%   gedoc            - Great ellipses on an ellipsoid of revolution

% Copyright (c) Charles Karney (2015-2019) <charles@karney.com>.