99
edits
Fgnievinski (talk | contribs) |
|||
(46 intermediate revisions by 7 users not shown) | |||
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 == | ||
=== Roadmap === | |||
Targets for next mapping package releases: | |||
* 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.). Matlab has arcgridread | |||
* Add more options to mapshow. | |||
* Implement support for projections and coordinate transformations. I (current mapping pkg maintainer) have little need nor much experience with this subject => help welcome! BTW there's an OF proj package that offers some of the functionality. | |||
* Add geodesy functions. Patches have been submitted and integrated. The current roadmap is to further integrate Felipe Nievinsky's geodesy toolbox, updated by M. Hirsch. | |||
Several functions in the current mapping package release (1.4.2) and upcoming (1.4.3?) haven't had much testing. Please try them out and report issues in the bug tracker with "[octave forge](mapping)" tag in the title. | |||
=== 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 | 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 was a discussion about which functions belong where. Matlab compatibility suggests the mapping package, but based on similar functionality the geometry package is probably a better home. | ||
Anyway the mapping package has the geometry package as a required dependency. | |||
Recent matlab 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.4.2 (released early 2022). 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 [http://hg.code.sf.net/p/octave/mapping/file sources], see esp. the INDEX file, 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"> | ||
* arcgridread '''[1]''' | |||
* arcgridread | |||
* areaint | * areaint | ||
* areamat | * areamat | ||
* areaquad | * areaquad '''*''' | ||
* avhrrgoode | * avhrrgoode | ||
* avhrrlambert | * avhrrlambert | ||
* axesm | * axesm | ||
* axesmui | * axesmui | ||
Line 34: | Line 42: | ||
* clipdata | * clipdata | ||
* clma | * clma | ||
* clrmenu | * clrmenu | ||
* contour3m | * contour3m | ||
Line 42: | Line 49: | ||
* contourm | * contourm | ||
* defaultm | * defaultm | ||
* demcmap | * demcmap | ||
* demdataui | * demdataui | ||
* distortcalc | * distortcalc | ||
* dted | * dted | ||
* dteds | * dteds | ||
* ecef2lv | * ecef2lv | ||
* ellipse1 | * ellipse1 | ||
* etopo | * etopo | ||
* etopo5 | * etopo5 | ||
* flatearthpoly | * flatearthpoly | ||
* framem | * framem | ||
* gcm | * gcm | ||
* gcpmap | * gcpmap | ||
* geoloc2grid | * geoloc2grid | ||
* geopoint | * geopoint | ||
Line 91: | Line 70: | ||
* geoshow | * geoshow | ||
* geotiff2mstruct | * geotiff2mstruct | ||
* geotiffinfo | * geotiffinfo '''[2]''' | ||
* geotiffread | * geotiffread '''[1]''' | ||
* geotiffwrite | * geotiffwrite | ||
* getm | * getm | ||
Line 98: | Line 77: | ||
* globedem | * globedem | ||
* globedems | * globedems | ||
* gradientm | * gradientm | ||
* grid2image | * grid2image | ||
Line 115: | Line 93: | ||
* intrplon | * intrplon | ||
* ismap | * ismap | ||
* ispolycw | * ispolycw '''4''' | ||
* | * ispolyccw '''[4]''' | ||
* kmlwrite | * kmlwrite | ||
* kmlwriteline | * kmlwriteline | ||
Line 130: | Line 105: | ||
* ltln2val | * ltln2val | ||
* lv2ecef | * lv2ecef | ||
* makeattribspec | * makeattribspec | ||
* makedbfspec | * makedbfspec | ||
* makerefmat | * makerefmat | ||
* map.geodesy.AuthalicLatitudeConverter [6] | |||
* map.geodesy.AuthalicLatitudeConverter | * map.geodesy.ConformalLatitudeConverter [6] | ||
* map.geodesy.ConformalLatitudeConverter | * map.geodesy.IsometricLatitudeConverter [6] | ||
* map.geodesy.IsometricLatitudeConverter | * map.geodesy.RectifyingLatitudeConverter [6] | ||
* map.geodesy.RectifyingLatitudeConverter | |||
* map.geodesy.isdegree | * map.geodesy.isdegree | ||
* map.rasterref.GeographicRasterReference | * map.rasterref.GeographicRasterReference | ||
Line 149: | Line 122: | ||
* maps | * maps | ||
* mapshape | * mapshape | ||
* mapshow | * mapshow '''[3]''' | ||
* maptool | * maptool | ||
* maptrim | * maptrim | ||
Line 157: | Line 130: | ||
* mapview | * mapview | ||
* mdistort | * mdistort | ||
* meridianfwd | * meridianfwd | ||
* meshlsrm | * meshlsrm | ||
* meshm | * meshm | ||
* mfwdtran | * mfwdtran | ||
* minvtran | * minvtran | ||
* mlabel | * mlabel | ||
* mlabelzero22pi | * mlabelzero22pi | ||
* newpole | * newpole | ||
* northarrow | * northarrow | ||
* oblateSpheroid | * oblateSpheroid | ||
Line 183: | Line 145: | ||
* panzoom | * panzoom | ||
* parallelui | * parallelui | ||
* pcolorm | * pcolorm | ||
* plabel | * plabel | ||
Line 189: | Line 150: | ||
* plotm | * plotm | ||
* polcmap | * polcmap | ||
* poly2ccw | * poly2ccw '''[4]''' | ||
* poly2cw | * poly2cw '''[4]''' | ||
* poly2fv | * poly2fv | ||
* polybool | * polybool '''[4]''' | ||
* polyjoin | * polyjoin '''[4]''' | ||
* polymerge | * polymerge | ||
* polysplit | * polysplit '''[4]''' | ||
* polyxpoly | * polyxpoly | ||
* projfwd | * projfwd | ||
Line 203: | Line 164: | ||
* quiver3m | * quiver3m | ||
* quiverm | * quiverm | ||
* reducem | * reducem | ||
* refmatToGeoRasterReference | * refmatToGeoRasterReference | ||
* refmatToMapRasterReference | * refmatToMapRasterReference | ||
* refmatToWorldFileMatrix | * refmatToWorldFileMatrix | ||
* refvecToGeoRasterReference | * refvecToGeoRasterReference | ||
* resizem | * resizem | ||
* rhxrh | * rhxrh | ||
Line 227: | Line 181: | ||
* scircleg | * scircleg | ||
* scirclui | * scirclui | ||
* sdtsdemread '''[1]''' | |||
* sdtsdemread | * sdtsinfo '''[2]''' | ||
* sdtsinfo | |||
* sectorg | * sectorg | ||
* setm | * setm | ||
* shaderel | * shaderel | ||
* showaxes | * showaxes | ||
* stem3m | * stem3m | ||
* surfacem | * surfacem | ||
* surflm | * surflm | ||
Line 261: | Line 206: | ||
* usgsdems | * usgsdems | ||
* utmgeoid | * utmgeoid | ||
* utmzoneui | * utmzoneui | ||
* vec2mtx | * vec2mtx | ||
Line 273: | Line 217: | ||
* webmap | * webmap | ||
* WebMapServer | * WebMapServer | ||
* wmcenter | * wmcenter | ||
* wmclose | * wmclose | ||
Line 293: | Line 236: | ||
* worldfilewrite | * worldfilewrite | ||
* worldmap | * worldmap | ||
* zdatam | * zdatam | ||
</div> | </div> | ||
* [1] ''As of 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.'' | |||
* [3] ''As of mapping-1.2.0, there's a basic mapshow.'' | |||
* [4] ''Implemented in OF geometry-4.0.0'' | |||
* [5] ''See OF image package'' | |||
* [6] ''Replacement function implemented'' | |||
* * ''Implemented in dev version'' | |||
==== Grouped list ==== | ==== Grouped list ==== | ||
{| | (needs update relative to table above and newer mapping toolbox releases) | ||
| arcgridread||File Import and Export||Standard File Formats | (see numbered notes above) | ||
{| class="wikitable" | |||
| arcgridread '''[1]'''||File Import and Export||Standard File Formats | |||
|- | |- | ||
| geotiff2mstruct||File Import and Export||Standard File Formats | | geotiff2mstruct||File Import and Export||Standard File Formats | ||
|- | |- | ||
| geotiffinfo||File Import and Export||Standard File Formats | | geotiffinfo '''[2]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
| geotiffread||File Import and Export||Standard File Formats | | geotiffread '''[1]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
| geotiffwrite||File Import and Export||Standard File Formats | | geotiffwrite||File Import and Export||Standard File Formats | ||
|- | |- | ||
| sdtsdemread||File Import and Export||Standard File Formats | | sdtsdemread '''[1]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
| sdtsinfo||File Import and Export||Standard File Formats | | sdtsinfo '''[2]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
| worldfileread||File Import and Export||Standard File Formats | | worldfileread||File Import and Export||Standard File Formats | ||
Line 321: | Line 270: | ||
|- | |- | ||
| getworldfilename||File Import and Export||Standard File Formats | | getworldfilename||File Import and Export||Standard File Formats | ||
|- | |- | ||
| kmlwrite||File Import and Export||Standard File Formats | | kmlwrite||File Import and Export||Standard File Formats | ||
Line 331: | Line 278: | ||
|- | |- | ||
| makeattribspec||File Import and Export||Standard File Formats | | makeattribspec||File Import and Export||Standard File Formats | ||
|- | |- | ||
| makedbfspec||File Import and Export||Standard File Formats | | makedbfspec||File Import and Export||Standard File Formats | ||
|- | |- | ||
| imread||File Import and Export||Standard File Formats | | imread '''[5]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
| imwrite||File Import and Export||Standard File Formats | | imwrite '''[5]'''||File Import and Export||Standard File Formats | ||
|- | |- | ||
| demdataui||File Import and Export||Gridded Terrain and Bathymetry Products | | demdataui||File Import and Export||Gridded Terrain and Bathymetry Products | ||
Line 368: | Line 309: | ||
| usgs24kdem||File Import and Export||Gridded Terrain and Bathymetry Products | | usgs24kdem||File Import and Export||Gridded Terrain and Bathymetry Products | ||
|- | |- | ||
| usgsdem||File Import and Export||Gridded Terrain and Bathymetry Products | | usgsdem '''[1]'''||File Import and Export||Gridded Terrain and Bathymetry Products | ||
|- | |- | ||
| usgsdems||File Import and Export||Gridded Terrain and Bathymetry Products | | usgsdems '''[1]'''||File Import and Export||Gridded Terrain and Bathymetry Products | ||
|- | |- | ||
| avhrrgoode||File Import and Export||Specific Vector and Gridded Data Products | | avhrrgoode||File Import and Export||Specific Vector and Gridded Data Products | ||
|- | |- | ||
| avhrrlambert||File Import and Export||Specific Vector and Gridded Data Products | | avhrrlambert||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 478: | Line 417: | ||
| linem||Map Display||Vector and Raster Map Display | | linem||Map Display||Vector and Raster Map Display | ||
|- | |- | ||
| mapshow '''[3]'''||Map Display||Vector and Raster Map Display | |||
| mapshow||Map Display||Vector and Raster Map Display | |||
|- | |- | ||
| meshm||Map Display||Vector and Raster Map Display | | meshm||Map Display||Vector and Raster Map Display | ||
Line 577: | Line 514: | ||
|- | |- | ||
| intrplon||Data Analysis||Vector Data | | intrplon||Data Analysis||Vector Data | ||
|- | |- | ||
| linecirc||Data Analysis||Vector Data | | linecirc||Data Analysis||Vector Data | ||
Line 602: | Line 537: | ||
| poly2fv||Data Analysis||Vector Data | | poly2fv||Data Analysis||Vector Data | ||
|- | |- | ||
| polybool||Data Analysis||Vector Data | | polybool '''[4]'''||Data Analysis||Vector Data | ||
|- | |- | ||
| polyxpoly||Data Analysis||Vector Data | | polyxpoly||Data Analysis||Vector Data | ||
Line 655: | Line 590: | ||
|- | |- | ||
| viewshed||Data Analysis||Terrain Data Analysis | | viewshed||Data Analysis||Terrain Data Analysis | ||
|- | |- | ||
| earthRadius||Coordinates, Geodesy, and Projections||Modeling the Earth | | earthRadius||Coordinates, Geodesy, and Projections||Modeling the Earth | ||
|- | |- | ||
| rsphere||Coordinates, Geodesy, and Projections||Modeling the Earth | | rsphere||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 [6] | |||
| map.geodesy.AuthalicLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth | |||
|- | |- | ||
| | | map.geodesy.ConformalLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth [6] | ||
|- | |- | ||
| | | map.geodesy.IsometricLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth [6] | ||
|- | |- | ||
| | | map.geodesy.RectifyingLatitudeConverter||Coordinates, Geodesy, and Projections||Modeling the Earth [6] | ||
|- | |- | ||
| unwrapMultipart||Coordinates, Geodesy, and Projections||Lengths and Angles | | unwrapMultipart||Coordinates, Geodesy, and Projections||Lengths and Angles | ||
|- | |- | ||
| map.geodesy.isdegree||Coordinates, Geodesy, and Projections||Lengths and Angles | | map.geodesy.isdegree||Coordinates, Geodesy, and Projections||Lengths and Angles | ||
|- | |- | ||
| azimuth||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | | azimuth||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 | ||
|- | |- | ||
| meridianfwd||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines | | meridianfwd||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 779: | Line 626: | ||
|- | |- | ||
| ellipse1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | | ellipse1||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 809: | Line 634: | ||
|- | |- | ||
| scirclui||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | | scirclui||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 | ||
|- | |- | ||
| areaint||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | | areaint||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | ||
|- | |- | ||
| areamat||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas | | areamat||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 891: | Line 708: | ||
|- | |- | ||
| utmgeoid||Coordinates, Geodesy, and Projections||Coordinate Systems | | utmgeoid||Coordinates, Geodesy, and Projections||Coordinate Systems | ||
|- | |- | ||
| utmzoneui||Coordinates, Geodesy, and Projections||Coordinate Systems | | utmzoneui||Coordinates, Geodesy, and Projections||Coordinate Systems | ||
|- | |- | ||
|} | |} | ||
Line 948: | Line 718: | ||
=== 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 from its author outside of File Exchange) | |||
[[Category:Octave | [[Category:Octave Forge]] | ||
[[Category:Missing functions]] |
edits