281
edits
No edit summary |
|||
(22 intermediate revisions by 4 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.). | |||
* Add more options to mapshow. | |||
* 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 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.2.1) 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 the | 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 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 current version 1.2.1; see notes below the list for dev version. 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"> | ||
Line 15: | Line 29: | ||
* aer2ned | * aer2ned | ||
* angl2str | * angl2str | ||
* arcgridread '''[1]''' | * arcgridread '''[1]''' | ||
* areaint | * areaint | ||
Line 22: | Line 35: | ||
* avhrrgoode | * avhrrgoode | ||
* avhrrlambert | * avhrrlambert | ||
* axes2ecc | * axes2ecc '''*''' | ||
* axesm | * axesm | ||
* axesmui | * axesmui | ||
Line 50: | Line 63: | ||
* dted | * dted | ||
* dteds | * dteds | ||
* earthRadius | * earthRadius '''*''' | ||
* ecc2flat | * ecc2flat '''*''' | ||
* ecc2n | * ecc2n '''*''' | ||
* ecef2aer | * ecef2aer | ||
* ecef2enu | * ecef2enu | ||
* ecef2enuv | * ecef2enuv | ||
* ecef2geodetic | * ecef2geodetic '''*''' | ||
* ecef2lv | * ecef2lv | ||
* ecef2ned | * ecef2ned | ||
Line 68: | Line 81: | ||
* etopo | * etopo | ||
* etopo5 | * etopo5 | ||
* flat2ecc | * flat2ecc '''*''' | ||
* flatearthpoly | * flatearthpoly | ||
* framem | * framem | ||
Line 76: | Line 89: | ||
* gcxgc | * gcxgc | ||
* gcxsc | * gcxsc | ||
* geocentricLatitude | * geocentricLatitude '''*''' | ||
* geodetic2aer | * geodetic2aer | ||
* geodetic2ecef | * geodetic2ecef '''*''' | ||
* geodetic2enu | * geodetic2enu | ||
* geodetic2ned | * geodetic2ned | ||
* geodeticLatitudeFromGeocentric | * geodeticLatitudeFromGeocentric '''*''' | ||
* geodeticLatitudeFromParametric | * geodeticLatitudeFromParametric '''*''' | ||
* geoloc2grid | * geoloc2grid | ||
* geopoint | * geopoint | ||
Line 98: | Line 111: | ||
* globedem | * globedem | ||
* globedems | * globedems | ||
* gpxread | * gpxread '''[6]''' | ||
* gradientm | * gradientm | ||
* grid2image | * grid2image | ||
Line 116: | Line 129: | ||
* ismap | * ismap | ||
* ispolycw | * ispolycw | ||
* kmlwrite | * kmlwrite | ||
* kmlwriteline | * kmlwriteline | ||
Line 130: | Line 139: | ||
* ltln2val | * ltln2val | ||
* lv2ecef | * lv2ecef | ||
* majaxis | * majaxis '''*''' | ||
* makeattribspec | * makeattribspec | ||
* makedbfspec | * makedbfspec | ||
* makerefmat | * makerefmat | ||
* map.geodesy.AuthalicLatitudeConverter | * map.geodesy.AuthalicLatitudeConverter | ||
* map.geodesy.ConformalLatitudeConverter | * map.geodesy.ConformalLatitudeConverter | ||
Line 162: | Line 170: | ||
* meshm | * meshm | ||
* mfwdtran | * mfwdtran | ||
* minaxis | * minaxis '''*''' | ||
* minvtran | * minvtran | ||
* mlabel | * mlabel | ||
* mlabelzero22pi | * mlabelzero22pi | ||
* n2ecc | * n2ecc '''*''' | ||
* ned2aer | * ned2aer | ||
* ned2ecef | * ned2ecef | ||
Line 172: | Line 180: | ||
* ned2geodetic | * ned2geodetic | ||
* newpole | * newpole | ||
* northarrow | * northarrow | ||
* oblateSpheroid | * oblateSpheroid | ||
Line 183: | Line 187: | ||
* panzoom | * panzoom | ||
* parallelui | * parallelui | ||
* parametricLatitude | * parametricLatitude '''*''' | ||
* pcolorm | * pcolorm | ||
* plabel | * plabel | ||
Line 203: | Line 207: | ||
* quiver3m | * quiver3m | ||
* quiverm | * quiverm | ||
* rad2nm | * rad2nm | ||
* rad2sm | * rad2sm | ||
* rcurve | * rcurve '''*''' | ||
* reducem | * reducem | ||
* referenceEllipsoid | * referenceEllipsoid '''*''' | ||
* referenceSphere | * referenceSphere | ||
* refmatToGeoRasterReference | * refmatToGeoRasterReference | ||
Line 214: | Line 217: | ||
* refmatToWorldFileMatrix | * refmatToWorldFileMatrix | ||
* refvecToGeoRasterReference | * refvecToGeoRasterReference | ||
* resizem | * resizem | ||
* rhxrh | * rhxrh | ||
Line 228: | Line 230: | ||
* scirclui | * scirclui | ||
* scxsc | * scxsc | ||
* sdtsdemread | * sdtsdemread '''[1]''' | ||
* sdtsinfo | * sdtsinfo '''[2]''' | ||
* sectorg | * sectorg | ||
* setm | * setm | ||
Line 270: | Line 272: | ||
* webmap | * webmap | ||
* WebMapServer | * WebMapServer | ||
* wgs84Ellipsoid | * wgs84Ellipsoid '''*''' | ||
* wmcenter | * wmcenter | ||
* wmclose | * wmclose | ||
Line 293: | Line 295: | ||
</div> | </div> | ||
* [1] In mapping-1.2.1, rasterread can read any raster file that the GDAL library supports. No separate functions for individual file format are required. There's some work to do on unifying output formats. | * [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] See oc_polybool in the OF octclip package. | * [4] ''See oc_polybool in the OF octclip package.'' | ||
* [5] ''See OF image package'' | |||
* [6] ''There's a basic gpxread in the 1.2.2 version (to be released)'' | |||
* * ''Implemented in dev version'' | |||
==== Grouped list ==== | ==== Grouped list ==== | ||
{| | (see numbered notes above) | ||
| arcgridread||File Import and Export||Standard File Formats | {| 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 329: | Line 335: | ||
|- | |- | ||
| 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 366: | Line 366: | ||
| 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 | ||
Line 476: | Line 476: | ||
| 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 575: | Line 573: | ||
|- | |- | ||
| intrplon||Data Analysis||Vector Data | | intrplon||Data Analysis||Vector Data | ||
|- | |- | ||
| linecirc||Data Analysis||Vector Data | | linecirc||Data Analysis||Vector Data | ||
Line 600: | Line 596: | ||
| 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 697: | Line 693: | ||
|- | |- | ||
| 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 | | str2angle||Coordinates, Geodesy, and Projections||Lengths and Angles | ||
|- | |- | ||
| 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 | ||
Line 785: | Line 737: | ||
|- | |- | ||
| gcxsc||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 | | rad2nm||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance | ||
Line 811: | Line 753: | ||
|- | |- | ||
| 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 | ||
Line 938: | Line 876: | ||
| ned2ecefv||Coordinates, Geodesy, and Projections||Coordinate Systems | | ned2ecefv||Coordinates, Geodesy, and Projections||Coordinate Systems | ||
|- | |- | ||
|} | |} | ||
Line 948: | Line 885: | ||
* geod toolbox [https://drive.google.com/file/d/0B-I95wETyqQidnZWbm5TbzZRcHc/edit?usp=sharing] (BSD-licensed, available by the author outside of File Exchange) | * 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 | [[Category:Octave Forge]] | ||
[[Category:Missing functions]] |
edits