Editing Mapping package
Jump to navigation
Jump to search
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
The {{Forge|mapping|mapping package}} is part of the | The {{Forge|mapping|mapping package}} is part of the octave-forge project. | ||
== Development == | == Development == | ||
Line 6: | Line 6: | ||
Targets for next mapping package releases: | Targets for next mapping package releases: | ||
* Add rasterwrite.m (complementary to rasterread). Please contact package maintainer, there's already a C++ skeleton. | * Add rasterwrite.m (complementary to rasterread). Please contact package maintainer, there's already a C++ skeleton. | ||
* Maybe add wrapper functions around rasterread and rasterwrite (for e.g., geotiff, ASCII grid, etc.). | * Maybe add wrapper functions around rasterread and rasterwrite (for e.g., geotiff, ASCII grid, etc.). | ||
* Add more options to mapshow. | * Add more options to mapshow. | ||
* Implement support for projections | * Implement support for projections. I (current mapping pkg maintainer) have little need nor much experience with this subject => help welcome! | ||
* Add geodesy functions. Patches have been submitted | * Add geodesy functions. Patches have been submitted but not yet integrated. A suggested roadmap would be to integrate Felipe Nievinsky's geodesy toolbox as an upstream dependency but that toolbox needs documentation work. | ||
Several functions in the current mapping package release (1. | Several functions in the current mapping package release (1.2.1) haven't had much testing. Please try them out and report issues in the bug tracker with "[OF] mapping pkg:" tag in the title. | ||
=== Missing functions === | === Missing functions === | ||
Follows an incomplete list of stuff missing in the mapping package to be matlab compatible. Bugs are not listed here, [https://savannah.gnu.org/bugs/?func=search&group=octave search] and [https://savannah.gnu.org/bugs/?func=additem&group=octave report] them on the bug tracker instead. | Follows an incomplete list of stuff missing in the mapping package to be matlab compatible. Bugs are not listed here, [https://savannah.gnu.org/bugs/?func=search&group=octave search] and [https://savannah.gnu.org/bugs/?func=additem&group=octave report] them on the bug tracker instead. | ||
As a number of polygon functions in the mapping package relate to geometry stuff, chances are that some of that lacking functionality is already present in the [http://wiki.octave.org/Geometry_package geometry package]. In fact there | As a number of polygon functions in the mapping package relate to geometry stuff, chances are that some of that lacking functionality is already present in the [http://wiki.octave.org/Geometry_package geometry package]. In fact there is a discussion about which functions belong where. Matlab compatibility suggests the mapping package, but based on similar functionality the geometry package might also be a good home. | ||
Recent | Recent mapping toolbox versions are classdef-based. It is unclear yet if we need to follow this route as classdef support in Octave is still experimental and has no file I/O. | ||
{{Note|this entire section is about version 1. | {{Note|this entire section is about current version 1.2.1. If a Matlab function is missing from the list and does not appear on the current release of the package, confirm that is also missing in the [https://sourceforge.net/p/octave/mapping/development sources] before adding it.}} | ||
==== Alphabetical list ==== | ==== Alphabetical list ==== | ||
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4"> | <div style="column-count:4;-moz-column-count:4;-webkit-column-count:4"> | ||
* aer2ecef | |||
* aer2enu | |||
* aer2geodetic | |||
* aer2ned | |||
* angl2str | |||
* arcgridread '''[1]''' | * arcgridread '''[1]''' | ||
* areaint | * areaint | ||
* areamat | * areamat | ||
* areaquad | * areaquad | ||
* avhrrgoode | * avhrrgoode | ||
* avhrrlambert | * avhrrlambert | ||
* axes2ecc | |||
* axesm | * axesm | ||
* axesmui | * axesmui | ||
Line 42: | Line 47: | ||
* clipdata | * clipdata | ||
* clma | * clma | ||
* closePolygonParts | |||
* clrmenu | * clrmenu | ||
* contour3m | * contour3m | ||
Line 49: | Line 55: | ||
* contourm | * contourm | ||
* defaultm | * defaultm | ||
* deg2nm | |||
* deg2sm | |||
* demcmap | * demcmap | ||
* demdataui | * demdataui | ||
* departure | |||
* distortcalc | * distortcalc | ||
* dted | * dted | ||
* dteds | * dteds | ||
* earthRadius | |||
* ecc2flat | |||
* ecc2n | |||
* ecef2aer | |||
* ecef2enu | |||
* ecef2enuv | |||
* ecef2geodetic | |||
* ecef2lv | * ecef2lv | ||
* ecef2ned | |||
* ecef2nedv | |||
* egm96geoid | |||
* ellipse1 | * ellipse1 | ||
* enu2aer | |||
* enu2ecef | |||
* enu2ecefv | |||
* enu2geodetic | |||
* etopo | * etopo | ||
* etopo5 | * etopo5 | ||
* flat2ecc | |||
* flatearthpoly | * flatearthpoly | ||
* framem | * framem | ||
* gc2sc | |||
* gcm | * gcm | ||
* gcpmap | * gcpmap | ||
* gcxgc | |||
* gcxsc | |||
* geocentricLatitude | |||
* geodetic2aer | |||
* geodetic2ecef | |||
* geodetic2enu | |||
* geodetic2ned | |||
* geodeticLatitudeFromGeocentric | |||
* geodeticLatitudeFromParametric | |||
* geoloc2grid | * geoloc2grid | ||
* geopoint | * geopoint | ||
Line 77: | Line 111: | ||
* globedem | * globedem | ||
* globedems | * globedems | ||
* gpxread '''[6]''' | |||
* gradientm | * gradientm | ||
* grid2image | * grid2image | ||
Line 93: | Line 128: | ||
* intrplon | * intrplon | ||
* ismap | * ismap | ||
* ispolycw | * ispolycw | ||
* kmlwrite | * kmlwrite | ||
* kmlwriteline | * kmlwriteline | ||
Line 105: | Line 139: | ||
* ltln2val | * ltln2val | ||
* lv2ecef | * lv2ecef | ||
* majaxis | |||
* makeattribspec | * makeattribspec | ||
* makedbfspec | * makedbfspec | ||
* makerefmat | * makerefmat | ||
* map.geodesy.AuthalicLatitudeConverter | * map.geodesy.AuthalicLatitudeConverter | ||
* map.geodesy.ConformalLatitudeConverter | * map.geodesy.ConformalLatitudeConverter | ||
* map.geodesy.IsometricLatitudeConverter | * map.geodesy.IsometricLatitudeConverter | ||
* map.geodesy.RectifyingLatitudeConverter | * map.geodesy.RectifyingLatitudeConverter | ||
* map.geodesy.isdegree | * map.geodesy.isdegree | ||
* map.rasterref.GeographicRasterReference | * map.rasterref.GeographicRasterReference | ||
Line 130: | Line 165: | ||
* mapview | * mapview | ||
* mdistort | * mdistort | ||
* meridianarc | |||
* meridianfwd | * meridianfwd | ||
* meshlsrm | * meshlsrm | ||
* meshm | * meshm | ||
* mfwdtran | * mfwdtran | ||
* minaxis | |||
* minvtran | * minvtran | ||
* mlabel | * mlabel | ||
* mlabelzero22pi | * mlabelzero22pi | ||
* n2ecc | |||
* ned2aer | |||
* ned2ecef | |||
* ned2ecefv | |||
* ned2geodetic | |||
* newpole | * newpole | ||
* northarrow | * northarrow | ||
Line 145: | Line 187: | ||
* panzoom | * panzoom | ||
* parallelui | * parallelui | ||
* parametricLatitude | |||
* pcolorm | * pcolorm | ||
* plabel | * plabel | ||
Line 150: | Line 193: | ||
* plotm | * plotm | ||
* polcmap | * polcmap | ||
* poly2ccw | * poly2ccw | ||
* poly2cw | * poly2cw | ||
* poly2fv | * poly2fv | ||
* polybool '''[4]''' | * polybool '''[4]''' | ||
* polyjoin | * polyjoin | ||
* polymerge | * polymerge | ||
* polysplit | * polysplit | ||
* polyxpoly | * polyxpoly | ||
* projfwd | * projfwd | ||
Line 164: | Line 207: | ||
* quiver3m | * quiver3m | ||
* quiverm | * quiverm | ||
* rad2nm | |||
* rad2sm | |||
* rcurve | |||
* reducem | * reducem | ||
* referenceEllipsoid | |||
* referenceSphere | |||
* refmatToGeoRasterReference | * refmatToGeoRasterReference | ||
* refmatToMapRasterReference | * refmatToMapRasterReference | ||
Line 181: | Line 229: | ||
* scircleg | * scircleg | ||
* scirclui | * scirclui | ||
* scxsc | |||
* sdtsdemread '''[1]''' | * sdtsdemread '''[1]''' | ||
* sdtsinfo '''[2]''' | * sdtsinfo '''[2]''' | ||
Line 187: | Line 236: | ||
* shaderel | * shaderel | ||
* showaxes | * showaxes | ||
* sm2deg | |||
* sm2km | |||
* sm2nm | |||
* sm2rad | |||
* stem3m | * stem3m | ||
* str2angle | |||
* surfacem | * surfacem | ||
* surflm | * surflm | ||
Line 206: | Line 260: | ||
* usgsdems | * usgsdems | ||
* utmgeoid | * utmgeoid | ||
* utmzone | |||
* utmzoneui | * utmzoneui | ||
* vec2mtx | * vec2mtx | ||
Line 217: | Line 272: | ||
* webmap | * webmap | ||
* WebMapServer | * WebMapServer | ||
* wgs84Ellipsoid | |||
* wmcenter | * wmcenter | ||
* wmclose | * wmclose | ||
Line 239: | Line 295: | ||
</div> | </div> | ||
* [1] '' | * [1] ''In mapping-1.2.1, rasterread can read any raster file that the GDAL library supports; see http://www.gdal.org/frmt_various.html. No separate functions for individual file format are required. There's some work to do on unifying output formats.'' | ||
* [2] ''As [1], rasterinfo does the job.'' | * [2] ''As [1], rasterinfo does the job.'' | ||
* [3] ''As of mapping-1.2.0, there's a basic mapshow.'' | * [3] ''As of mapping-1.2.0, there's a basic mapshow.'' | ||
* [4] '' | * [4] ''See oc_polybool in the OF octclip package.'' | ||
* [5] ''See OF image package'' | * [5] ''See OF image package'' | ||
* [6] '' | * [6] ''There's a basic gpxread in the 1.2.2 version (to be released) | ||
==== Grouped list ==== | ==== Grouped list ==== | ||
(see numbered notes above) | (see numbered notes above) | ||
{| | {| {{table}} | ||
| arcgridread '''[1]'''||File Import and Export||Standard File Formats | | arcgridread '''[1]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
Line 270: | Line 324: | ||
|- | |- | ||
| getworldfilename||File Import and Export||Standard File Formats | | getworldfilename||File Import and Export||Standard File Formats | ||
|- | |||
| gpxread||File Import and Export||Standard File Formats | |||
|- | |- | ||
| kmlwrite||File Import and Export||Standard File Formats | | kmlwrite||File Import and Export||Standard File Formats | ||
Line 316: | Line 372: | ||
|- | |- | ||
| avhrrlambert||File Import and Export||Specific Vector and Gridded Data Products | | avhrrlambert||File Import and Export||Specific Vector and Gridded Data Products | ||
|- | |||
| egm96geoid||File Import and Export||Specific Vector and Gridded Data Products | |||
|- | |- | ||
| gshhs||File Import and Export||Specific Vector and Gridded Data Products | | gshhs||File Import and Export||Specific Vector and Gridded Data Products | ||
Line 590: | Line 648: | ||
|- | |- | ||
| viewshed||Data Analysis||Terrain Data Analysis | | viewshed||Data Analysis||Terrain Data Analysis | ||
|- | |||
| wgs84Ellipsoid||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |- | ||
| earthRadius||Coordinates, Geodesy, and Projections||Modeling the Earth | | earthRadius||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |||
| rcurve||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |- | ||
| rsphere||Coordinates, Geodesy, and Projections||Modeling the Earth | | rsphere||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |||
| geocentricLatitude||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| parametricLatitude||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| geodeticLatitudeFromGeocentric||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| geodeticLatitudeFromParametric||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| axes2ecc||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| majaxis||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| minaxis||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| ecc2flat||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| flat2ecc||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| ecc2n||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| n2ecc||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |- | ||
| oblateSpheroid||Coordinates, Geodesy, and Projections||Modeling the Earth | | oblateSpheroid||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| map.geodesy.AuthalicLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | | referenceEllipsoid||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |||
| referenceSphere||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |||
| map.geodesy.AuthalicLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |- | ||
| map.geodesy.ConformalLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | | map.geodesy.ConformalLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| map.geodesy.IsometricLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | | map.geodesy.IsometricLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| map.geodesy.RectifyingLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | | map.geodesy.RectifyingLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |||
| str2angle||Coordinates, Geodesy, and Projections||Lengths and Angles | |||
|- | |- | ||
| unwrapMultipart||Coordinates, Geodesy, and Projections||Lengths and Angles | | unwrapMultipart||Coordinates, Geodesy, and Projections||Lengths and Angles | ||
Line 610: | Line 700: | ||
|- | |- | ||
| azimuth||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | | azimuth||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | ||
|- | |||
| departure||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | |||
|- | |- | ||
| distance||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | | distance||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | ||
|- | |||
| gc2sc||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | |||
|- | |||
| gcxgc||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | |||
|- | |||
| gcxsc||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | |||
|- | |||
| meridianarc||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | |||
|- | |- | ||
| meridianfwd||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | | meridianfwd||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | ||
|- | |||
| reckon||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | |||
|- | |- | ||
| rhxrh||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | | rhxrh||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | ||
Line 626: | Line 728: | ||
|- | |- | ||
| ellipse1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | | ellipse1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | ||
|- | |||
| deg2km||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |||
| deg2nm||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |||
| deg2sm||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |||
| gcxsc||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |||
| rad2nm||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |||
| rad2sm||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |- | ||
| scircle1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | | scircle1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | ||
Line 634: | Line 748: | ||
|- | |- | ||
| scirclui||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | | scirclui||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | ||
|- | |||
| scxsc||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | |||
|- | |- | ||
| sectorg||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | | sectorg||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | ||
Line 640: | Line 756: | ||
|- | |- | ||
| areamat||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | | areamat||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | ||
|- | |||
| areaquad||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | |||
|- | |- | ||
| bufgeoquad||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | | bufgeoquad||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | ||
Line 708: | Line 826: | ||
|- | |- | ||
| utmgeoid||Coordinates, Geodesy, and Projections||Coordinate Systems | | utmgeoid||Coordinates, Geodesy, and Projections||Coordinate Systems | ||
|- | |||
| utmzone||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |- | ||
| utmzoneui||Coordinates, Geodesy, and Projections||Coordinate Systems | | utmzoneui||Coordinates, Geodesy, and Projections||Coordinate Systems | ||
|- | |- | ||
| ecef2geodetic||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| geodetic2ecef||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| geodetic2enu||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| geodetic2ned||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| geodetic2aer||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| enu2geodetic||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ned2geodetic||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| aer2geodetic||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ecef2enu||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ecef2ned||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ecef2aer||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| enu2ecef||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ned2ecef||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| aer2ecef||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| aer2enu||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| aer2ned||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| enu2aer||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ned2aer||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ecef2enuv||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ecef2nedv||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| enu2ecefv||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| ned2ecefv||Coordinates, Geodesy, and Projections||Coordinate Systems | |||
|- | |||
| | |||
|} | |} | ||
Line 718: | Line 883: | ||
=== Contributing === | === Contributing === | ||
* See for example [[User:Sandeepmv#Y:_Your_task]] | * See for example [[User:Sandeepmv#Y:_Your_task]] | ||
* geod toolbox [https://drive.google.com/file/d/0B-I95wETyqQidnZWbm5TbzZRcHc/edit?usp=sharing] (BSD-licensed, available | * geod toolbox [https://drive.google.com/file/d/0B-I95wETyqQidnZWbm5TbzZRcHc/edit?usp=sharing] (BSD-licensed, available by the author outside of File Exchange) | ||
[[Category:Octave Forge | [[Category:Octave-Forge]] | ||