Mapping package: Difference between revisions

From Octave
Jump to navigation Jump to search
(→‎Missing functions: remove newly implemented function validateLengthUnit)
 
(60 intermediate revisions by 8 users not shown)
Line 1: Line 1:
The {{Forge|mapping|mapping package}} is part of the octave-forge project.
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 the current development 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 [https://sourceforge.net/p/octave/mapping/ development sources] before adding it.}}
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.}}


=== Missing functions ===
==== 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
* arcgridread '''[1]'''
* aer2enu
* aer2geodetic
* aer2ned
* angl2str
* antipode
* arcgridread
* areaint
* areaint
* areamat
* areamat
* areaquad
* areaquad '''*'''
* avhrrgoode
* avhrrgoode
* avhrrlambert
* avhrrlambert
* axes2ecc
* axesm
* axesm
* axesmui
* axesmui
Line 33: Line 42:
* clipdata
* clipdata
* clma
* clma
* closePolygonParts
* clrmenu
* clrmenu
* contour3m
* contour3m
Line 41: Line 49:
* contourm
* contourm
* defaultm
* defaultm
* deg2km
* deg2nm
* deg2sm
* degrees2dm
* degrees2dms
* degtorad
* demcmap
* demcmap
* demdataui
* demdataui
* departure
* distortcalc
* distortcalc
* dm2degrees
* dms2degrees
* 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
* extractfield
* flat2ecc
* flatearthpoly
* flatearthpoly
* framem
* framem
* fromDegrees
* fromRadians
* gc2sc
* gcm
* gcm
* gcpmap
* gcpmap
* gcxgc
* gcxsc
* geocentricLatitude
* geodetic2aer
* geodetic2ecef
* geodetic2enu
* geodetic2ned
* geodeticLatitudeFromGeocentric
* geodeticLatitudeFromParametric
* geoloc2grid
* geoloc2grid
* geopoint
* geopoint
Line 99: Line 70:
* geoshow
* geoshow
* geotiff2mstruct
* geotiff2mstruct
* geotiffinfo
* geotiffinfo '''[2]'''
* geotiffread
* geotiffread '''[1]'''
* geotiffwrite
* geotiffwrite
* getm
* getm
Line 106: Line 77:
* globedem
* globedem
* globedems
* globedems
* gpxread
* gradientm
* gradientm
* grid2image
* grid2image
Line 116: Line 86:
* handlem
* handlem
* imbedm
* imbedm
* imread
* imwrite
* ingeoquad
* ingeoquad
* inputm
* inputm
Line 125: Line 93:
* intrplon
* intrplon
* ismap
* ismap
* ispolycw
* ispolycw '''4'''
* isShapeMultipart
* ispolyccw '''[4]'''
* km2nm
* km2rad
* km2sm
* kmlwrite
* kmlwrite
* kmlwriteline
* kmlwriteline
Line 140: Line 105:
* ltln2val
* ltln2val
* lv2ecef
* lv2ecef
* majaxis
* makeattribspec
* makeattribspec
* makedbfspec
* makedbfspec
* makerefmat
* makerefmat
* makesymbolspec
* 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 159: Line 122:
* maps
* maps
* mapshape
* mapshape
* mapshow
* mapshow '''[3]'''
* maptool
* maptool
* maptrim
* maptrim
Line 167: Line 130:
* 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
* nm2deg
* nm2km
* nm2rad
* nm2sm
* northarrow
* northarrow
* oblateSpheroid
* oblateSpheroid
Line 193: Line 145:
* panzoom
* panzoom
* parallelui
* parallelui
* parametricLatitude
* pcolorm
* pcolorm
* plabel
* plabel
Line 199: 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 213: Line 164:
* quiver3m
* quiver3m
* quiverm
* quiverm
* rad2km
* rad2nm
* rad2sm
* radtodeg
* rcurve
* reducem
* reducem
* referenceEllipsoid
* referenceSphere
* refmatToGeoRasterReference
* refmatToGeoRasterReference
* refmatToMapRasterReference
* refmatToMapRasterReference
* refmatToWorldFileMatrix
* refmatToWorldFileMatrix
* refvecToGeoRasterReference
* refvecToGeoRasterReference
* removeExtraNanSeparators
* resizem
* resizem
* rhxrh
* rhxrh
Line 238: Line 181:
* scircleg
* scircleg
* scirclui
* scirclui
* scxsc
* sdtsdemread '''[1]'''
* sdtsdemread
* sdtsinfo '''[2]'''
* sdtsinfo
* sectorg
* sectorg
* setm
* setm
* shaderel
* shaderel
* shapeinfo
* shaperead
* shapewrite
* showaxes
* showaxes
* sm2deg
* sm2km
* sm2nm
* sm2rad
* stem3m
* stem3m
* str2angle
* surfacem
* surfacem
* surflm
* surflm
Line 262: Line 196:
* tightmap
* tightmap
* tissot
* tissot
* toDegrees
* toRadians
* track1
* track1
* track2
* track2
* trackg
* trackg
* trackui
* trackui
* unitsratio
* unwrapMultipart
* unwrapMultipart
* usamap
* usamap
Line 275: Line 206:
* usgsdems
* usgsdems
* utmgeoid
* utmgeoid
* utmzone
* utmzoneui
* utmzoneui
* vec2mtx
* vec2mtx
Line 287: Line 217:
* webmap
* webmap
* WebMapServer
* WebMapServer
* wgs84Ellipsoid
* wmcenter
* wmcenter
* wmclose
* wmclose
Line 307: Line 236:
* worldfilewrite
* worldfilewrite
* worldmap
* worldmap
* wrapTo180
* wrapTo2Pi
* wrapTo360
* wrapToPi
* 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 ====
(needs update relative to table above and newer mapping toolbox releases)
(see numbered notes above)
{| class="wikitable"
| arcgridread '''[1]'''||File Import and Export||Standard File Formats
|-
| geotiff2mstruct||File Import and Export||Standard File Formats
|-
| geotiffinfo '''[2]'''||File Import and Export||Standard File Formats
|-
| geotiffread '''[1]'''||File Import and Export||Standard File Formats
|-
| geotiffwrite||File Import and Export||Standard File Formats
|-
| sdtsdemread '''[1]'''||File Import and Export||Standard File Formats
|-
| sdtsinfo '''[2]'''||File Import and Export||Standard File Formats
|-
| worldfileread||File Import and Export||Standard File Formats
|-
| worldfilewrite||File Import and Export||Standard File Formats
|-
| getworldfilename||File Import and Export||Standard File Formats
|-
| kmlwrite||File Import and Export||Standard File Formats
|-
| kmlwriteline||File Import and Export||Standard File Formats
|-
| kmlwritepoint||File Import and Export||Standard File Formats
|-
| makeattribspec||File Import and Export||Standard File Formats
|-
| makedbfspec||File Import and Export||Standard File Formats
|-
| imread '''[5]'''||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
|-
| dted||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| dteds||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| etopo||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| etopo5||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| globedem||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| globedems||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| gtopo30||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| gtopo30s||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| satbath||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| tbase||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| usgs24kdem||File Import and Export||Gridded Terrain and Bathymetry Products
|-
| usgsdem '''[1]'''||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
|-
| avhrrlambert||File Import and Export||Specific Vector and Gridded Data Products
|-
| gshhs||File Import and Export||Specific Vector and Gridded Data Products
|-
| vmap0data||File Import and Export||Specific Vector and Gridded Data Products
|-
| vmap0read||File Import and Export||Specific Vector and Gridded Data Products
|-
| vmap0rhead||File Import and Export||Specific Vector and Gridded Data Products
|-
| vmap0ui||File Import and Export||Specific Vector and Gridded Data Products
|-
| WebMapServer||Web Maps||Web Map Service
|-
| WMSCapabilities||Web Maps||Web Map Service
|-
| WMSLayer||Web Maps||Web Map Service
|-
| WMSMapRequest||Web Maps||Web Map Service
|-
| wmsfind||Web Maps||Web Map Service
|-
| wmsinfo||Web Maps||Web Map Service
|-
| wmsread||Web Maps||Web Map Service
|-
| wmsupdate||Web Maps||Web Map Service
|-
| webmap||Web Maps||Web Map Display
|-
| wmclose||Web Maps||Web Map Display
|-
| wmprint||Web Maps||Web Map Display
|-
| wmmarker||Web Maps||Web Map Display
|-
| wmline||Web Maps||Web Map Display
|-
| wmremove||Web Maps||Web Map Display
|-
| wmcenter||Web Maps||Web Map Display
|-
| wmzoom||Web Maps||Web Map Display
|-
| wmlimits||Web Maps||Web Map Display
|-
| axesm||Map Display||Map Layout and Axes
|-
| axesmui||Map Display||Map Layout and Axes
|-
| clma||Map Display||Map Layout and Axes
|-
| gcm||Map Display||Map Layout and Axes
|-
| getm||Map Display||Map Layout and Axes
|-
| handlem||Map Display||Map Layout and Axes
|-
| handlem-ui||Map Display||Map Layout and Axes
|-
| ismap||Map Display||Map Layout and Axes
|-
| setm||Map Display||Map Layout and Axes
|-
| showaxes||Map Display||Map Layout and Axes
|-
| tightmap||Map Display||Map Layout and Axes
|-
| usamap||Map Display||Map Layout and Axes
|-
| worldmap||Map Display||Map Layout and Axes
|-
| namem||Map Display||Map Layout and Axes
|-
| tagm||Map Display||Map Layout and Axes
|-
| framem||Map Display||Map Layout and Axes
|-
| ingeoquad||Map Display||Map Layout and Axes
|-
| gridm||Map Display||Map Layout and Axes
|-
| angl2str||Map Display||Map Layout and Axes
|-
| mlabel||Map Display||Map Layout and Axes
|-
| mlabelzero22pi||Map Display||Map Layout and Axes
|-
| northarrow||Map Display||Map Layout and Axes
|-
| plabel||Map Display||Map Layout and Axes
|-
| rotatetext||Map Display||Map Layout and Axes
|-
| scaleruler||Map Display||Map Layout and Axes
|-
| geoshow||Map Display||Vector and Raster Map Display
|-
| grid2image||Map Display||Vector and Raster Map Display
|-
| linem||Map Display||Vector and Raster Map Display
|-
| mapshow '''[3]'''||Map Display||Vector and Raster Map Display
|-
| meshm||Map Display||Vector and Raster Map Display
|-
| pcolorm||Map Display||Vector and Raster Map Display
|-
| plotm||Map Display||Vector and Raster Map Display
|-
| plot3m||Map Display||Vector and Raster Map Display
|-
| surfm||Map Display||Vector and Raster Map Display
|-
| usamap||Map Display||Vector and Raster Map Display
|-
| worldmap||Map Display||Vector and Raster Map Display
|-
| camposm||Map Display||3-D Map Display
|-
| camtargm||Map Display||3-D Map Display
|-
| camupm||Map Display||3-D Map Display
|-
| daspectm||Map Display||3-D Map Display
|-
| demcmap||Map Display||3-D Map Display
|-
| lightm||Map Display||3-D Map Display
|-
| lightmui||Map Display||3-D Map Display
|-
| meshlsrm||Map Display||3-D Map Display
|-
| shaderel||Map Display||3-D Map Display
|-
| surflm||Map Display||3-D Map Display
|-
| surflsrm||Map Display||3-D Map Display
|-
| surfacem||Map Display||3-D Map Display
|-
| zdatam||Map Display||3-D Map Display
|-
| clabelm||Map Display||Contour Maps
|-
| clegendm||Map Display||Contour Maps
|-
| contourcbar||Map Display||Contour Maps
|-
| contourcmap||Map Display||Contour Maps
|-
| contourm||Map Display||Contour Maps
|-
| contour3m||Map Display||Contour Maps
|-
| contourfm||Map Display||Contour Maps
|-
| quiverm||Map Display||Thematic Maps
|-
| quiver3m||Map Display||Thematic Maps
|-
| scatterm||Map Display||Thematic Maps
|-
| stem3m||Map Display||Thematic Maps
|-
| symbolm||Map Display||Thematic Maps
|-
| clrmenu||Map Display||Interaction with Maps
|-
| gcpmap||Map Display||Interaction with Maps
|-
| gtextm||Map Display||Interaction with Maps
|-
| inputm||Map Display||Interaction with Maps
|-
| maptool||Map Display||Interaction with Maps
|-
| maptrim||Map Display||Interaction with Maps
|-
| mapview||Map Display||Interaction with Maps
|-
| originui||Map Display||Interaction with Maps
|-
| parallelui||Map Display||Interaction with Maps
|-
| bufferm||Data Analysis||Vector Data
|-
| closePolygonParts||Data Analysis||Vector Data
|-
| extractfield||Data Analysis||Vector Data
|-
| flatearthpoly||Data Analysis||Vector Data
|-
| interpm||Data Analysis||Vector Data
|-
| intrplat||Data Analysis||Vector Data
|-
| intrplon||Data Analysis||Vector Data
|-
| linecirc||Data Analysis||Vector Data
|-
| polcmap||Data Analysis||Vector Data
|-
| polyjoin||Data Analysis||Vector Data
|-
| polymerge||Data Analysis||Vector Data
|-
| polysplit||Data Analysis||Vector Data
|-
| reducem||Data Analysis||Vector Data
|-
| removeExtraNanSeparators||Data Analysis||Vector Data
|-
| ispolycw||Data Analysis||Vector Data
|-
| poly2ccw||Data Analysis||Vector Data
|-
| poly2cw||Data Analysis||Vector Data
|-
| poly2fv||Data Analysis||Vector Data
|-
| polybool '''[4]'''||Data Analysis||Vector Data
|-
| polyxpoly||Data Analysis||Vector Data
|-
| geopoint||Data Analysis||Vector Data
|-
| geoshape||Data Analysis||Vector Data
|-
| mappoint||Data Analysis||Vector Data
|-
| mapshape||Data Analysis||Vector Data
|-
| map.rasterref.GeographicRasterReference||Data Analysis||Raster Data and Representations
|-
| map.rasterref.MapRasterReference||Data Analysis||Raster Data and Representations
|-
| geoloc2grid||Data Analysis||Raster Data and Representations
|-
| imbedm||Data Analysis||Raster Data and Representations
|-
| ltln2val||Data Analysis||Raster Data and Representations
|-
| mapoutline||Data Analysis||Raster Data and Representations
|-
| resizem||Data Analysis||Raster Data and Representations
|-
| limitm||Data Analysis||Raster Data and Representations
|-
| georasterref||Data Analysis||Raster Data and Representations
|-
| makerefmat||Data Analysis||Raster Data and Representations
|-
| maprasterref||Data Analysis||Raster Data and Representations
|-
| refmatToGeoRasterReference||Data Analysis||Raster Data and Representations
|-
| refmatToMapRasterReference||Data Analysis||Raster Data and Representations
|-
| refmatToWorldFileMatrix||Data Analysis||Raster Data and Representations
|-
| refvecToGeoRasterReference||Data Analysis||Raster Data and Representations
|-
| worldFileMatrixToRefmat||Data Analysis||Raster Data and Representations
|-
| mapprofile||Data Analysis||Conversion Between Vector and Raster Data
|-
| vec2mtx||Data Analysis||Conversion Between Vector and Raster Data
|-
| gradientm||Data Analysis||Terrain Data Analysis
|-
| los2||Data Analysis||Terrain Data Analysis
|-
| viewshed||Data Analysis||Terrain Data Analysis
|-
| earthRadius||Coordinates, Geodesy, and Projections||Modeling the Earth
|-
| rsphere||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.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
|-
| map.geodesy.isdegree||Coordinates, Geodesy, and Projections||Lengths and Angles
|-
| azimuth||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
|-
| rhxrh||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines
|-
| track1||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines
|-
| track2||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines
|-
| trackg||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines
|-
| trackui||Coordinates, Geodesy, and Projections||Great Circles, Geodesics, and Rhumb Lines
|-
| ellipse1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance
|-
| scircle1||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance
|-
| scircle2||Coordinates, Geodesy, and Projections||Small Circles, Ellipses, and Spherical Distance
|-
| scircleg||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
|-
| areaint||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
|-
| geoquadline||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas
|-
| geoquadpt||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas
|-
| ingeoquad||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas
|-
| intersectgeoquad||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas
|-
| outlinegeoquad||Coordinates, Geodesy, and Projections||Zones, Lunes, Quadrangles, and Other Areas
|-
| map.rasterref.GeographicRasterReference||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| map.rasterref.MapRasterReference||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| antipode||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| mfwdtran||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| minvtran||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| newpole||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| org2pol||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| projfwd||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| projinv||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| putpole||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| rotatem||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| defaultm||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| geotiff2mstruct||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| maplist||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| maps||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| mfwdtran||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| minvtran||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| projlist||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| vfwdtran||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| vinvtran||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| clipdata||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| distortcalc||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| maptriml||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| maptrimp||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| maptrims||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| mdistort||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| tissot||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| utmgeoid||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
| utmzoneui||Coordinates, Geodesy, and Projections||Coordinate Systems
|-
|}


=== Missing options ===
=== Missing options ===
TBD


=== Contributing ===
* 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-Forge]]
[[Category:Octave Forge]]
[[Category:Missing functions]]

Latest revision as of 21:39, 7 June 2022

The mapping package is part of the Octave Forge project.

Development[edit]

Roadmap[edit]

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[edit]

Follows an incomplete list of stuff missing in the mapping package to be matlab compatible. Bugs are not listed here, search and 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 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.

Info icon.svg
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 sources, see esp. the INDEX file, before adding it.

Alphabetical list[edit]

  • arcgridread [1]
  • areaint
  • areamat
  • areaquad *
  • avhrrgoode
  • avhrrlambert
  • axesm
  • axesmui
  • bufferm
  • bufgeoquad
  • camposm
  • camtargm
  • camupm
  • clabelm
  • clegendm
  • clipdata
  • clma
  • clrmenu
  • contour3m
  • contourcbar
  • contourcmap
  • contourfm
  • contourm
  • defaultm
  • demcmap
  • demdataui
  • distortcalc
  • dted
  • dteds
  • ecef2lv
  • ellipse1
  • etopo
  • etopo5
  • flatearthpoly
  • framem
  • gcm
  • gcpmap
  • geoloc2grid
  • geopoint
  • geoquadline
  • geoquadpt
  • georasterref
  • geoshape
  • geoshow
  • geotiff2mstruct
  • geotiffinfo [2]
  • geotiffread [1]
  • geotiffwrite
  • getm
  • getworldfilename
  • globedem
  • globedems
  • gradientm
  • grid2image
  • gridm
  • gshhs
  • gtextm
  • gtopo30
  • gtopo30s
  • handlem
  • imbedm
  • ingeoquad
  • inputm
  • interpm
  • intersectgeoquad
  • intrplat
  • intrplon
  • ismap
  • ispolycw 4
  • ispolyccw [4]
  • kmlwrite
  • kmlwriteline
  • kmlwritepoint
  • lightm
  • lightmui
  • linecirc
  • linem
  • los2
  • ltln2val
  • lv2ecef
  • makeattribspec
  • makedbfspec
  • makerefmat
  • map.geodesy.AuthalicLatitudeConverter [6]
  • map.geodesy.ConformalLatitudeConverter [6]
  • map.geodesy.IsometricLatitudeConverter [6]
  • map.geodesy.RectifyingLatitudeConverter [6]
  • map.geodesy.isdegree
  • map.rasterref.GeographicRasterReference
  • map.rasterref.MapRasterReference
  • maplist
  • mapoutline
  • mappoint
  • mapprofile
  • maprasterref
  • maps
  • mapshape
  • mapshow [3]
  • maptool
  • maptrim
  • maptriml
  • maptrimp
  • maptrims
  • mapview
  • mdistort
  • meridianfwd
  • meshlsrm
  • meshm
  • mfwdtran
  • minvtran
  • mlabel
  • mlabelzero22pi
  • newpole
  • northarrow
  • oblateSpheroid
  • org2pol
  • originui
  • outlinegeoquad
  • panzoom
  • parallelui
  • pcolorm
  • plabel
  • plot3m
  • plotm
  • polcmap
  • poly2ccw [4]
  • poly2cw [4]
  • poly2fv
  • polybool [4]
  • polyjoin [4]
  • polymerge
  • polysplit [4]
  • polyxpoly
  • projfwd
  • projinv
  • projlist
  • putpole
  • quiver3m
  • quiverm
  • reducem
  • refmatToGeoRasterReference
  • refmatToMapRasterReference
  • refmatToWorldFileMatrix
  • refvecToGeoRasterReference
  • resizem
  • rhxrh
  • rotatem
  • rotatetext
  • rsphere
  • satbath
  • scaleruler
  • scatterm
  • scircle1
  • scircle2
  • scircleg
  • scirclui
  • sdtsdemread [1]
  • sdtsinfo [2]
  • sectorg
  • setm
  • shaderel
  • showaxes
  • stem3m
  • surfacem
  • surflm
  • surflsrm
  • surfm
  • symbolm
  • tbase
  • tightmap
  • tissot
  • track1
  • track2
  • trackg
  • trackui
  • unwrapMultipart
  • usamap
  • usgs24kdem
  • usgsdem
  • usgsdems
  • utmgeoid
  • utmzoneui
  • vec2mtx
  • vfwdtran
  • viewshed
  • vinvtran
  • vmap0data
  • vmap0read
  • vmap0rhead
  • vmap0ui
  • webmap
  • WebMapServer
  • wmcenter
  • wmclose
  • wmlimits
  • wmline
  • wmmarker
  • wmprint
  • wmremove
  • WMSCapabilities
  • wmsfind
  • wmsinfo
  • WMSLayer
  • WMSMapRequest
  • wmsread
  • wmsupdate
  • wmzoom
  • worldFileMatrixToRefmat
  • worldfileread
  • worldfilewrite
  • worldmap
  • zdatam
  • [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[edit]

(needs update relative to table above and newer mapping toolbox releases) (see numbered notes above)

arcgridread [1] File Import and Export Standard File Formats
geotiff2mstruct File Import and Export Standard File Formats
geotiffinfo [2] File Import and Export Standard File Formats
geotiffread [1] File Import and Export Standard File Formats
geotiffwrite File Import and Export Standard File Formats
sdtsdemread [1] File Import and Export Standard File Formats
sdtsinfo [2] File Import and Export Standard File Formats
worldfileread File Import and Export Standard File Formats
worldfilewrite File Import and Export Standard File Formats
getworldfilename File Import and Export Standard File Formats
kmlwrite File Import and Export Standard File Formats
kmlwriteline File Import and Export Standard File Formats
kmlwritepoint File Import and Export Standard File Formats
makeattribspec File Import and Export Standard File Formats
makedbfspec File Import and Export Standard File Formats
imread [5] 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
dted File Import and Export Gridded Terrain and Bathymetry Products
dteds File Import and Export Gridded Terrain and Bathymetry Products
etopo File Import and Export Gridded Terrain and Bathymetry Products
etopo5 File Import and Export Gridded Terrain and Bathymetry Products
globedem File Import and Export Gridded Terrain and Bathymetry Products
globedems File Import and Export Gridded Terrain and Bathymetry Products
gtopo30 File Import and Export Gridded Terrain and Bathymetry Products
gtopo30s File Import and Export Gridded Terrain and Bathymetry Products
satbath File Import and Export Gridded Terrain and Bathymetry Products
tbase File Import and Export Gridded Terrain and Bathymetry Products
usgs24kdem File Import and Export Gridded Terrain and Bathymetry Products
usgsdem [1] 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
avhrrlambert File Import and Export Specific Vector and Gridded Data Products
gshhs File Import and Export Specific Vector and Gridded Data Products
vmap0data File Import and Export Specific Vector and Gridded Data Products
vmap0read File Import and Export Specific Vector and Gridded Data Products
vmap0rhead File Import and Export Specific Vector and Gridded Data Products
vmap0ui File Import and Export Specific Vector and Gridded Data Products
WebMapServer Web Maps Web Map Service
WMSCapabilities Web Maps Web Map Service
WMSLayer Web Maps Web Map Service
WMSMapRequest Web Maps Web Map Service
wmsfind Web Maps Web Map Service
wmsinfo Web Maps Web Map Service
wmsread Web Maps Web Map Service
wmsupdate Web Maps Web Map Service
webmap Web Maps Web Map Display
wmclose Web Maps Web Map Display
wmprint Web Maps Web Map Display
wmmarker Web Maps Web Map Display
wmline Web Maps Web Map Display
wmremove Web Maps Web Map Display
wmcenter Web Maps Web Map Display
wmzoom Web Maps Web Map Display
wmlimits Web Maps Web Map Display
axesm Map Display Map Layout and Axes
axesmui Map Display Map Layout and Axes
clma Map Display Map Layout and Axes
gcm Map Display Map Layout and Axes
getm Map Display Map Layout and Axes
handlem Map Display Map Layout and Axes
handlem-ui Map Display Map Layout and Axes
ismap Map Display Map Layout and Axes
setm Map Display Map Layout and Axes
showaxes Map Display Map Layout and Axes
tightmap Map Display Map Layout and Axes
usamap Map Display Map Layout and Axes
worldmap Map Display Map Layout and Axes
namem Map Display Map Layout and Axes
tagm Map Display Map Layout and Axes
framem Map Display Map Layout and Axes
ingeoquad Map Display Map Layout and Axes
gridm Map Display Map Layout and Axes
angl2str Map Display Map Layout and Axes
mlabel Map Display Map Layout and Axes
mlabelzero22pi Map Display Map Layout and Axes
northarrow Map Display Map Layout and Axes
plabel Map Display Map Layout and Axes
rotatetext Map Display Map Layout and Axes
scaleruler Map Display Map Layout and Axes
geoshow Map Display Vector and Raster Map Display
grid2image Map Display Vector and Raster Map Display
linem Map Display Vector and Raster Map Display
mapshow [3] Map Display Vector and Raster Map Display
meshm Map Display Vector and Raster Map Display
pcolorm Map Display Vector and Raster Map Display
plotm Map Display Vector and Raster Map Display
plot3m Map Display Vector and Raster Map Display
surfm Map Display Vector and Raster Map Display
usamap Map Display Vector and Raster Map Display
worldmap Map Display Vector and Raster Map Display
camposm Map Display 3-D Map Display
camtargm Map Display 3-D Map Display
camupm Map Display 3-D Map Display
daspectm Map Display 3-D Map Display
demcmap Map Display 3-D Map Display
lightm Map Display 3-D Map Display
lightmui Map Display 3-D Map Display
meshlsrm Map Display 3-D Map Display
shaderel Map Display 3-D Map Display
surflm Map Display 3-D Map Display
surflsrm Map Display 3-D Map Display
surfacem Map Display 3-D Map Display
zdatam Map Display 3-D Map Display
clabelm Map Display Contour Maps
clegendm Map Display Contour Maps
contourcbar Map Display Contour Maps
contourcmap Map Display Contour Maps
contourm Map Display Contour Maps
contour3m Map Display Contour Maps
contourfm Map Display Contour Maps
quiverm Map Display Thematic Maps
quiver3m Map Display Thematic Maps
scatterm Map Display Thematic Maps
stem3m Map Display Thematic Maps
symbolm Map Display Thematic Maps
clrmenu Map Display Interaction with Maps
gcpmap Map Display Interaction with Maps
gtextm Map Display Interaction with Maps
inputm Map Display Interaction with Maps
maptool Map Display Interaction with Maps
maptrim Map Display Interaction with Maps
mapview Map Display Interaction with Maps
originui Map Display Interaction with Maps
parallelui Map Display Interaction with Maps
bufferm Data Analysis Vector Data
closePolygonParts Data Analysis Vector Data
extractfield Data Analysis Vector Data
flatearthpoly Data Analysis Vector Data
interpm Data Analysis Vector Data
intrplat Data Analysis Vector Data
intrplon Data Analysis Vector Data
linecirc Data Analysis Vector Data
polcmap Data Analysis Vector Data
polyjoin Data Analysis Vector Data
polymerge Data Analysis Vector Data
polysplit Data Analysis Vector Data
reducem Data Analysis Vector Data
removeExtraNanSeparators Data Analysis Vector Data
ispolycw Data Analysis Vector Data
poly2ccw Data Analysis Vector Data
poly2cw Data Analysis Vector Data
poly2fv Data Analysis Vector Data
polybool [4] Data Analysis Vector Data
polyxpoly Data Analysis Vector Data
geopoint Data Analysis Vector Data
geoshape Data Analysis Vector Data
mappoint Data Analysis Vector Data
mapshape Data Analysis Vector Data
map.rasterref.GeographicRasterReference Data Analysis Raster Data and Representations
map.rasterref.MapRasterReference Data Analysis Raster Data and Representations
geoloc2grid Data Analysis Raster Data and Representations
imbedm Data Analysis Raster Data and Representations
ltln2val Data Analysis Raster Data and Representations
mapoutline Data Analysis Raster Data and Representations
resizem Data Analysis Raster Data and Representations
limitm Data Analysis Raster Data and Representations
georasterref Data Analysis Raster Data and Representations
makerefmat Data Analysis Raster Data and Representations
maprasterref Data Analysis Raster Data and Representations
refmatToGeoRasterReference Data Analysis Raster Data and Representations
refmatToMapRasterReference Data Analysis Raster Data and Representations
refmatToWorldFileMatrix Data Analysis Raster Data and Representations
refvecToGeoRasterReference Data Analysis Raster Data and Representations
worldFileMatrixToRefmat Data Analysis Raster Data and Representations
mapprofile Data Analysis Conversion Between Vector and Raster Data
vec2mtx Data Analysis Conversion Between Vector and Raster Data
gradientm Data Analysis Terrain Data Analysis
los2 Data Analysis Terrain Data Analysis
viewshed Data Analysis Terrain Data Analysis
earthRadius Coordinates, Geodesy, and Projections Modeling the Earth
rsphere 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.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
map.geodesy.isdegree Coordinates, Geodesy, and Projections Lengths and Angles
azimuth 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
rhxrh Coordinates, Geodesy, and Projections Great Circles, Geodesics, and Rhumb Lines
track1 Coordinates, Geodesy, and Projections Great Circles, Geodesics, and Rhumb Lines
track2 Coordinates, Geodesy, and Projections Great Circles, Geodesics, and Rhumb Lines
trackg Coordinates, Geodesy, and Projections Great Circles, Geodesics, and Rhumb Lines
trackui Coordinates, Geodesy, and Projections Great Circles, Geodesics, and Rhumb Lines
ellipse1 Coordinates, Geodesy, and Projections Small Circles, Ellipses, and Spherical Distance
scircle1 Coordinates, Geodesy, and Projections Small Circles, Ellipses, and Spherical Distance
scircle2 Coordinates, Geodesy, and Projections Small Circles, Ellipses, and Spherical Distance
scircleg 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
areaint 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
geoquadline Coordinates, Geodesy, and Projections Zones, Lunes, Quadrangles, and Other Areas
geoquadpt Coordinates, Geodesy, and Projections Zones, Lunes, Quadrangles, and Other Areas
ingeoquad Coordinates, Geodesy, and Projections Zones, Lunes, Quadrangles, and Other Areas
intersectgeoquad Coordinates, Geodesy, and Projections Zones, Lunes, Quadrangles, and Other Areas
outlinegeoquad Coordinates, Geodesy, and Projections Zones, Lunes, Quadrangles, and Other Areas
map.rasterref.GeographicRasterReference Coordinates, Geodesy, and Projections Coordinate Systems
map.rasterref.MapRasterReference Coordinates, Geodesy, and Projections Coordinate Systems
antipode Coordinates, Geodesy, and Projections Coordinate Systems
mfwdtran Coordinates, Geodesy, and Projections Coordinate Systems
minvtran Coordinates, Geodesy, and Projections Coordinate Systems
newpole Coordinates, Geodesy, and Projections Coordinate Systems
org2pol Coordinates, Geodesy, and Projections Coordinate Systems
projfwd Coordinates, Geodesy, and Projections Coordinate Systems
projinv Coordinates, Geodesy, and Projections Coordinate Systems
putpole Coordinates, Geodesy, and Projections Coordinate Systems
rotatem Coordinates, Geodesy, and Projections Coordinate Systems
defaultm Coordinates, Geodesy, and Projections Coordinate Systems
geotiff2mstruct Coordinates, Geodesy, and Projections Coordinate Systems
maplist Coordinates, Geodesy, and Projections Coordinate Systems
maps Coordinates, Geodesy, and Projections Coordinate Systems
mfwdtran Coordinates, Geodesy, and Projections Coordinate Systems
minvtran Coordinates, Geodesy, and Projections Coordinate Systems
projlist Coordinates, Geodesy, and Projections Coordinate Systems
vfwdtran Coordinates, Geodesy, and Projections Coordinate Systems
vinvtran Coordinates, Geodesy, and Projections Coordinate Systems
clipdata Coordinates, Geodesy, and Projections Coordinate Systems
distortcalc Coordinates, Geodesy, and Projections Coordinate Systems
maptriml Coordinates, Geodesy, and Projections Coordinate Systems
maptrimp Coordinates, Geodesy, and Projections Coordinate Systems
maptrims Coordinates, Geodesy, and Projections Coordinate Systems
mdistort Coordinates, Geodesy, and Projections Coordinate Systems
tissot Coordinates, Geodesy, and Projections Coordinate Systems
utmgeoid Coordinates, Geodesy, and Projections Coordinate Systems
utmzoneui Coordinates, Geodesy, and Projections Coordinate Systems

Missing options[edit]

TBD

Contributing[edit]

Retrieved from "https://wiki.octave.org/wiki/index.php?title=Mapping_package&oldid=14377"