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 5: | Line 5: | ||
Targets for next mapping package releases: | Targets for next mapping package releases: | ||
* Add rasterwrite.m (complementary to rasterread) | * Add rasterwrite.m (complementary to rasterread). | ||
* 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. | ||
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. | ||
{{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.}} | |||
{{Note|this entire section is about version 1. | |||
==== 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 | |||
* antipode | |||
* arcgridread '''[1]''' | * arcgridread '''[1]''' | ||
* areaint | * areaint | ||
* areamat | * areamat | ||
* areaquad | * areaquad | ||
* avhrrgoode | * avhrrgoode | ||
* avhrrlambert | * avhrrlambert | ||
* axes2ecc | |||
* axesm | * axesm | ||
* axesmui | * axesmui | ||
Line 42: | Line 44: | ||
* clipdata | * clipdata | ||
* clma | * clma | ||
* closePolygonParts | |||
* clrmenu | * clrmenu | ||
* contour3m | * contour3m | ||
Line 49: | Line 52: | ||
* 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 108: | ||
* globedem | * globedem | ||
* globedems | * globedems | ||
* gpxread | |||
* gradientm | * gradientm | ||
* grid2image | * grid2image | ||
Line 93: | Line 125: | ||
* intrplon | * intrplon | ||
* ismap | * ismap | ||
* ispolycw | * ispolycw | ||
* | * isShapeMultipart | ||
* kmlwrite | * kmlwrite | ||
* kmlwriteline | * kmlwriteline | ||
Line 105: | Line 137: | ||
* 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 163: | ||
* 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 185: | ||
* panzoom | * panzoom | ||
* parallelui | * parallelui | ||
* parametricLatitude | |||
* pcolorm | * pcolorm | ||
* plabel | * plabel | ||
Line 150: | Line 191: | ||
* 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 205: | ||
* quiver3m | * quiver3m | ||
* quiverm | * quiverm | ||
* rad2km | |||
* rad2nm | |||
* rad2sm | |||
* rcurve | |||
* reducem | * reducem | ||
* referenceEllipsoid | |||
* referenceSphere | |||
* refmatToGeoRasterReference | * refmatToGeoRasterReference | ||
* refmatToMapRasterReference | * refmatToMapRasterReference | ||
Line 181: | Line 228: | ||
* scircleg | * scircleg | ||
* scirclui | * scirclui | ||
* scxsc | |||
* sdtsdemread '''[1]''' | * sdtsdemread '''[1]''' | ||
* sdtsinfo '''[2]''' | * sdtsinfo '''[2]''' | ||
Line 187: | Line 235: | ||
* shaderel | * shaderel | ||
* showaxes | * showaxes | ||
* sm2deg | |||
* sm2km | |||
* sm2nm | |||
* sm2rad | |||
* stem3m | * stem3m | ||
* str2angle | |||
* surfacem | * surfacem | ||
* surflm | * surflm | ||
Line 206: | Line 259: | ||
* usgsdems | * usgsdems | ||
* utmgeoid | * utmgeoid | ||
* utmzone | |||
* utmzoneui | * utmzoneui | ||
* vec2mtx | * vec2mtx | ||
Line 217: | Line 271: | ||
* webmap | * webmap | ||
* WebMapServer | * WebMapServer | ||
* wgs84Ellipsoid | |||
* wmcenter | * wmcenter | ||
* wmclose | * wmclose | ||
Line 239: | Line 294: | ||
</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'' | ||
==== 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 322: | ||
|- | |- | ||
| 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 370: | ||
|- | |- | ||
| 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 514: | Line 570: | ||
|- | |- | ||
| intrplon||Data Analysis||Vector Data | | intrplon||Data Analysis||Vector Data | ||
|- | |||
| isShapeMultipart||Data Analysis||Vector Data | |||
|- | |- | ||
| linecirc||Data Analysis||Vector Data | | linecirc||Data Analysis||Vector Data | ||
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 | ||
|- | |- | ||
| | | referenceEllipsoid||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| | | referenceSphere||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| map.geodesy. | | map.geodesy.AuthalicLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| map.geodesy.RectifyingLatitudeConverter||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.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]] | ||