README.md

MatMap3d

Matlab coordinate conversions for geospace ecef enu eci. Similar to Python PyMap3D.

Usage

MatMap3D is setup as a Matlab package, which means import matmap3d statements allow scoped use of this code.

[x,y,z] = matmap3d.geodetic2ecef([],lat,lon,alt)

[az,el,range] = matmap3d.geodetic2aer(lat, lon, alt, observer_lat, observer_lon, observer_alt)

Optionally, run self-tests:

buildtool check test

Functions

Popular mapping & aerospace toolbox functions ported to Matlab, where the source coordinate system (before the "2") is converted to the desired coordinate system:

Abbreviations:

• AER: Azimuth, Elevation, Range
• ECEF: Earth-centered, Earth-fixed
• ECI: Earth-centered Inertial
• ENU: East North Up
• NED: North East Down
• radec: right ascension, declination

Caveats

• Atmospheric effects neglected in all functions not invoking AstroPy. Would need to update code to add these input parameters (just start a GitHub Issue to request).
• Planetary perturbations and nutation etc. not fully considered.

These functions present a similar API of a subset of functions in the Mathworks Matlab:

• Mapping Toolbox
• Aerospace Blockset

Notes

Python PyMap3d has more conversions. PyMap3d can be accessed from Matlab by commands like:

lla = py.pymap3d.geodetic2ecef(x,y,z)

GNU Octave

GNU Octave users should consider the Octave Mapping Toolbox, which added similar functions in version 1.4.2.