matmap3d

KO | EN

gitlite — search

#python #javascript #nodejs #testing #bot #userscript #alfred #go #golang #terminal #dotfiles #visualization

★ 21 Open GitHub ↗

Matlab 3D coordinate conversions for geospace ecef enu ECI

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MatMap3d

[![DOI](https://zenodo.org/badge/144219717.svg)](https://zenodo.org/badge/latestdoi/144219717)
[![View matmap3d on File Exchange](https://www.mathworks.com/matlabcentral/images/matlab-file-exchange.svg)](https://www.mathworks.com/matlabcentral/fileexchange/68480-matmap3d)
[![ci](https://github.com/geospace-code/matmap3d/actions/workflows/ci.yml/badge.svg)](https://github.com/geospace-code/matmap3d/actions/workflows/ci.yml)

Matlab coordinate conversions for geospace ecef enu eci.
Similar to Python
[PyMap3D](https://github.com/geospace-code/pymap3d).

## Usage

MatMap3D is setup as a
[Matlab package](https://www.mathworks.com/help/matlab/matlab_oop/scoping-classes-with-packages.html),
which means `import matmap3d` statements allow scoped use of this code.

```matlab

[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:

```matlab
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](https://en.wikipedia.org/wiki/Spherical_coordinate_system)
* [ECEF: Earth-centered, Earth-fixed](https://en.wikipedia.org/wiki/ECEF)
* [ECI: Earth-centered Inertial](https://en.wikipedia.org/wiki/Earth-centered_inertial)
* [ENU: East North Up](https://en.wikipedia.org/wiki/Axes_conventions#Ground_reference_frames:_ENU_and_NED)
* [NED: North East Down](https://en.wikipedia.org/wiki/North_east_down)
* [radec: right ascension, declination](https://en.wikipedia.org/wiki/Right_ascension)

### 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](https://www.mathworks.com/products/mapping.html)
* [Aerospace Blockset](https://www.mathworks.com/products/aerospace-blockset.html)

## Notes

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

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

### GNU Octave

GNU Octave users should consider the
[Octave Mapping Toolbox](https://gnu-octave.github.io/packages/mapping/),
which added similar functions in
[version 1.4.2](https://sourceforge.net/p/octave/mapping/ci/Release-1.4.2/tree/NEWS).

matmap3d

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README