MATLAB MAPPING TOOLBOX RELEASE NOTES Guide de l'utilisateur

Mapping Toolbox™ Release Notes

x ContentsNow Possible to Retrieve Legend for WMS Map . . . . . . . . . 11-3Clipping Property Default Now Set to 'off' . . . . . . . . . . .

R2008b14-4• Merging the eastern and western sections of Wrangel Island near the Bering Strait(cut by the 180-degree meridian) into a single polygon wi

14-5lonlim = [western_limit eastern_limit]Original Syntax Replacement Syntaxh = pcolorm(Z)constructs a surface using the regulardata grid Z and a gra

R2008b14-6Original Syntax Replacement Syntaxh = surflm(Z,s)specifies the direction of the lightsource. s is a two- or three-elementvector that specifi

R2008aVersion: 2.7New FeaturesCompatibility Considerations

R2008a15-2Functions for Working with Geographic QuadranglesA geographic quadrangle is an area on the surface of a sphere or ellipsoid bounded on theea

15-3in longitude to overlap on both their eastern and western sides. This case, of course, isnot possible for bounding boxes in the plane.)Use outlin

R2008a15-4Improved Accuracy for the limitm and setpostn FunctionsIn previous releases, after calculating the latitude and longitude limits of the geog

15-5tsunamis.dbftsunamis.shptsunamis.shxtsunamis.txttsunamis.txt is not part of the shapefile set. It is a text file documenting the data set.The dat

R2008a15-6To use these options, input angles must be in degrees. That is, angl2str uses the stringunits to indicate both the units in which the angle

15-7referencing matrices or vectors). There are only a few Mapping Toolbox functions thatcan still generate display structures (by importing data fro

xiAutomatic Conversion of Latitude Limits to AscendingOrder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3

R2008a15-8Documentation for Functions tigermif and tigerp RemovedThe reference pages for following functions, which themselves were removed in R2007b,

15-9• unitstr• utmzone• utmzoneuiFor example, even with no map axes present, the command [mstruct, msg] = gcmreturned without error in R2007b and ear

R2007bVersion: 2.6New FeaturesCompatibility Considerations

R2007b16-2Exporting Vector Geodata to Earth Browserskmlwrite is a new function for exporting vector point data to a file in KML format. KMLstands for

16-3retained in Version 2.6 for backward compatibility. The functions degtorad, radtodeg,and unitsratio provide additional alternatives.Because it mu

R2007b16-4Four New Angle-Unit Conversion FunctionsThe following functions have been added for efficient conversion of angle units (degreesor radians)

16-5Interpretation of “Miles” Units has ChangedAs of R2007b, the following functions interpret distance units specified as 'miles' asIntern

R2007b16-6New Function to Unwrap Sequences of AnglesThe new unwrapMultipart function unwraps vectors of angles similarly to theMATLAB function unwrap,

16-7• You might need to manually set the renderer for proper display of some patch dataSee the release note “Map Axes Now Display Transparent Objects

xii ContentsFixes and Improvements to Function avhrrgoode . . . . . . . 15-3Improved Accuracy for the limitm and setpostnFunctions . . . . . . . . . .

R2007b16-8• boston_enhanced_pan.tifThe mapexenhance demo (“Enhancing Multispectral GeoTIFF Images”), which usedseveral of these images, has also been

16-9Change to avhrrlambert Function Behavior When No Data Is AvailableIn previous releases of the toolbox, avhrrlambert would error if the quadrangle

R2007b16-10 0Going forward from this release, the result is>> deg2rad(180i) ans = 0 + 3.1416i Degrees-Minutes-Seconds Conver

16-11Compatibility ConsiderationsDM and DMS representations are widely used in published reports and can occur ingeodata that you want to read into t

R2007b16-12angl2str distance histr putpole stdistangledim eastof imbedm rcurve stdmantipode elevation interpm reckon timezoneareaint ellipse1 intrplat

16-13• timedimCompatibility ConsiderationsThese functions now raise errors when they are invoked. They will be completelyremoved in a future version

R2007aVersion: 2.5New FeaturesCompatibility Considerations

R2007a17-2Performance Improvements for los2 and viewshedThis release includes a faster los2 function (which computes intervisibility betweenlocations

17-3• patchesm• patchm• pcolorm• plot3m• plotm• quiver3m• quiverm• scatterm• stem3m• surfacem• surflm• surfm• surflsrm• symbolm• textmCompatibility C

xiiiImprovements to Data Trimming in patchm andpatchesm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-6Higher Qua

R2007a17-4element and is integer-valued. The third column contains the “seconds” element, andmay have a nonzero fractional part. Similarly, DM inputs

17-5• rad2dm — Instead, call radtodeg or multiply input arguments by 180/pi, and thencall degrees2dm• rad2dms — Instead, call radtodeg or multiply in

R2007a17-6• hms2sec• hr2hm• hr2hms• hr2sec• mat2hms• sec2hm• sec2hms• sec2hr• time2str• timedimCompatibility ConsiderationsThese functions remain avai

R2006bVersion: 2.4New FeaturesCompatibility Considerations

R2006b18-2Standard Formulations of Five Major Map ProjectionsNew formulations of five conic map projections are provided. The existingimplementations

18-3Changes in Behavior of mapshow and geoshowIn addition to operating faster, the mapshow and geoshow functions now behave slightlydifferently regar

R2006b18-4• For geostruct input, an hggroup object is constructed; its handle is returned instead ofan array of handles to map graphic objects:• For p

18-5geoshow now creates a true 3-D surface if given a 'surface' DisplayType rather thansetting the ZData values to 0.Texturemap DisplayType

R2006b18-6

R2006aVersion: 2.3New FeaturesCompatibility Considerations

xiv ContentsNew Functions for Degrees-Minutes-Seconds Conversions 17-3Time Conversion Functions to be Removed . . . . . . . . . . . . . 17-5R2006b Sta

R2006a19-2Full Support for 64-Bit WindowsVersion 2.3 adds support for the mex- and library-based functions geotiffinfo,geotiffread, sdtsinfo, and sdts

19-3Version 2.3 Previous VersionsThe Zone field contains [] if the UTM zoneis not applicable or was missing from themetadata.The Zone field contained

R2006a19-4Plotting a 3-D Dome as a Mesh Over a GlobeIllustrates how to construct a 3-D feature in a system of local vertical coordinates, thentransfor

R14SP3Version: 2.2New FeaturesCompatibility Considerations

R14SP320-2Geodetic-Geocentric Coordinate Conversion FunctionsNew three-dimensional coordinate conversion functions (geodetic2ecef,ecef2geodetic, ecef2

20-3If you have vector map data sets that violate these conditions, the map display functionsgeoshow, mapshow, and mapview might not be capable of re

R14SP2Version: 2.1New FeaturesCompatibility Considerations

R14SP221-2New Function Reads Both 5-Minute and 2-Minute ETOPO DataThe new function etopo reads from either the 5-minute (ETOPO5) or the 2-minute(ETOPO

21-3Changes to Atlas Data and Associated FunctionsThrough Version 2.0.3, the toolbox included a set of atlas data with global geopoliticaldata embedd

xvThree New Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3Converting Coastline Data (GSHHS) to Shapefile Format . . 19

R14SP221-4In Version 2.1, worldmap supports only the first of these actions. A call to worldmapconstructs a map axes object and can easily be followed

21-5• The regiononly and stateonly syntax: a state or country name with the string'only' appended• All type options: 'none', &apo

R14SP221-6Mapping 1.x to 2.0.x Usage Mapping 2.1 Usagedemcmap(topo)load topoworldmap(topo,topolegend,'dem3d')load topoworldmap(topo,topolege

21-7Mapping 1.x to 2.0.x Usage Mapping 2.1 Usageload koreaworldmap(map,refvec,'meshonly')load koreaworldmap(map,refvec)meshm(map,refvec)loa

R14SP221-8Mapping 1.x to 2.0.x Usage Mapping 2.1 Usageload topoworldmap(topo,topolegend,'ldem3d')load topoworldmap(topo,topolegend)meshm(top

21-9Mapping 1.x to 2.0.x Usage Mapping 2.1 Usageload topoworldmap(topo,topolegend,'lmesh3d')load topoworldmap(topo,topolegend)meshm(topo,to

R14SP221-10Mapping 1.x to 2.0.x Usage Mapping 2.1 Usageload koreaworldmap(map, refvec)load koreaworldmap(map,refvec)land =shaperead('landares.shp

21-11Mapping 1.x to 2.0.x Usage Mapping 2.1 Usageload koreaworldmap(map,refvec,'patchonly')load koreaworldmap(map,refvec)land =shaperead(&a

R14SP221-12Atlas Data MAT-Files Removed in This ReleaseMAT-files containing Atlas Data have been removed in Version 2.1. Some of the datahas been reta

21-13• usahi.mat — Data moved to usastatehi.shpFunctions Being RemovedFunctionality What HappensWhen You Use ThisFunctionality?Use This Instead Compa

xvi ContentsData Files Added in This Release . . . . . . . . . . . . . . . . . . . . 21-11Atlas Data MAT-Files Removed in This Release . . . . . . . .

R14SP221-14Functionality What HappensWhen You Use ThisFunctionality?Use This Instead CompatibilityConsiderationsData sets have beenremoved.worldlo Err

R2015aVersion: 4.1New FeaturesBug Fixes

R2015a1-2Settable raster reference cell extent and sample spacing propertiesSeveral properties of the map.rasterref.MapRasterReference andmap.rasterre

1-3servers = layers.serversThe following specific updates have been made to the WMS Database since the lastrelease:• 1 new WMS server from the United

How to Contact MathWorksLatest news:www.mathworks.comSales and services:www.mathworks.com/sales_and_servicesUser community:www.mathworks.com/matlabcen

R2014bVersion: 4.0.2Bug FixesCompatibility Considerations

R2014b2-2WMS Database ModifiedThe WMS Database changes on a release-to-release basis, as some new servers areadded and other servers are removed becau

2-3• 169 new WMS servers from the Spatial Data Infrastructure Governmentof La Rioja (Spain). These servers provide data layers in basic topographicca

R2014b2-4copyobj does not work with certain Map graphicsSome functions in Mapping Toolbox return graphics that are a composite of standardMATLAB graph

R2014aVersion: 4.0.1New FeaturesBug FixesCompatibility Considerations

R2014a3-2Zoom via Standard MATLAB Tools and FunctionsIn the colorm, maptool, maptrim, and seedm interfaces, zoom and pan operations arenow provided th

3-3XLabel, YLabel, and Title removed from Map ViewerThe XLabel, YLabel, and Title menu items are no longer present in the Map ViewerInsert menu.Compa

R2014a3-4servers = layers.serversThe following specific updates have been made to the WMS Database since the lastrelease:• Three new WMS servers from

3-5• Over 60 layers form the National Renewable Energy Laboratory WMS server. Thisserver provides layers for solar and wind energy resource assessmen

iiiContentsR2015a Settable raster reference cell extent and sample spacingproperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

R2013bVersion: 4.0New FeaturesBug FixesCompatibility Considerations

R2013b4-2Web map display with dynamic base maps from OpenStreetMap andother sourcesThe new webmap function displays map base layers obtained from Web

4-3Class Name Coordinate SystemTypeRasterInterpretationCell Dimensionsmap.rasterref.GeographicPostingsReferencegeographic postings SampleSpacingInLat

R2013b4-4Compatibility ConsiderationsIt is no longer possible to set the RasterInterpretation property of a referencingobject once it has been created

4-5Existing Property Name New Property NameLonlim LongitudeLimitsAngleUnits AngleUnitMap Raster Reference ClassesXLimIntrinsic XIntrinsicLimitsYLimIn

R2013b4-6Existing Parameter Names New Parameter NamesYLimWorld YWorldLimitsMaps in the Stereographic Projection can extend more than 90 degreesfrom th

4-7If you want to find a server, use the server URL or a server URL search string withwmsfind to search for layers provided by the server or servers.

R2013b4-8Function Name What HappensWhen You Use theFunction?Use This Instead Compatibility Considerationsgeodetic2geocentricLatStill runs Usegeocentri

R2013aVersion: 3.7New FeaturesBug FixesCompatibility Considerations

iv ContentsStreamlined maptool Interface . . . . . . . . . . . . . . . . . . . . . . . . 3-2XLabel, YLabel, and Title removed from Map Viewer . . . .

R2013a5-2KML export for line featuresThe new kmlwriteline function writes a geographic line specified by latitude andlongitude coordinate vectors, and

5-3map.geodesy.authaliclatitudeconverterConvert between geodetic and authalic latitudesmap.geodesy.conformallatitudeconverterConvert between geodetic

R2013a5-4"Attempt to reference field in non-structure array."Support for PolarStereographic (Variant B) ProjectionThe functions geotiffinfo,

5-5Functions Being RemovedFunction Name What Happens WhenYou Use the Function?Use This Instead CompatibilityConsiderationscombntns Still runs nchoose

R2013a5-6Function Name What Happens WhenYou Use the Function?Use This Instead CompatibilityConsiderationsshapefile format, usingshapereadcolorui Warni

R2012bVersion: 3.6New FeaturesBug FixesCompatibility Considerations

R2012b6-2Dynamic representation of geographic line and polygon features withgeoshape classGeographic multi-point, line, and polygon features, in a geo

6-3Expanding latitude-longitude quadrangle with bufgeoquad functionThe bufgeoquad function expands the latitude and longitude limits of geographicqua

R2012b6-4• If a dynamic property is set with a cell array of values, the class type of the valuesare restricted to strings. In R2012a, the class type

6-5Compatibility ConsiderationsIn scripts, or other MATLAB files, that refer to it, the field name CrossGreenwichneeds to be changed to CrossesGreenw

vSpheroid objects display additional properties . . . . . . . . . . . 4-6WMS Database Modified . . . . . . . . . . . . . . . . . . . . . . . . . . . .

R2012b6-6If you want to find a server, use the server URL or a server URL search string withwmsfind to search for layers provided by the server or ser

6-7Search for equivalent layers in the USGS National Map server by using the followingurlSearchStrings:• 'nationalmap.gov*Ortho'• 'nat

R2012aVersion: 3.5New FeaturesCompatibility Considerations

R2012a7-2Data File Removal or Location ChangeThe following data files have been removed. (The data has been inlined in source code.)toolbox/map/mapdis

7-3geopoint Class to Hold Geographic Point DataThe new geopoint class provides a convenient, memory-efficient way to represent one ormore geographic

R2012a7-4You can easily construct a reference ellipsoid object for most commonly used coordinatesystems, including all those supported by the almanac

7-5etopo1_bed_c.fltetopo1_ice_c_f4.fltetopo1_bed_c_f4.fltetopo1_ice_c_i2.binetopo1_bed_c_i2.binImprovement to Functions usamap and worldmapIn the fun

R2012a7-6If you want to find a server, use the server URL or a server URL search stringwith wmsfind to search for layers provided by the server or ser

R2011bVersion: 3.4New FeaturesCompatibility Considerations

vi ContentsR2012b Dynamic representation of geographic line and polygonfeatures with geoshape class . . . . . . . . . . . . . . . . . . . . . . . . 6-

R2011b8-2New contourcbar Function Creates Color Bar for Filled Contour DisplayUse the contourcbar function to create a color bar associated with a fil

8-3http://hazardmap.service-section.com/cgi-bin/... mapserv?map=/map/UserRaster/alav2a_0312_1.maphttp://hyperquad.telascience.org/cgi-bin/jp_earthq

R2011b8-4Compatibility ConsiderationsIf you have scripts or functions that use specific identifiers, you must update the code touse the new identifier

8-5Compatibility ConsiderationsIn previous releases, the inverse flattening value used to calculate eccentricity wastruncated and therefore less prec

R2011aVersion: 3.3New FeaturesCompatibility Considerations

R2011a9-2Spatial Referencing ImprovementsRaster Referencing ClassesThe new spatialref.GeoRasterReference andspatialref.MapRasterReference classes rela

9-3GeoRasterReference class, use the conversion functions refvecToGeoRasterReferenceand refmatToGeoRasterReference as shown: R = refvecToGeoRasterRef

R2011a9-4• A new Mars Space Flight Facility MapServer:http://ms.mars.asu.edu/TES_TI_Putzig?• Two new servers from the Bureau of Land Management in par

9-5 'request=GetMap&layers=global_mosaic&srs=EPSG:4326&' ... 'format=image/jpeg&styles=visual&width=512&

viiR2012a Data File Removal or Location Change . . . . . . . . . . . . . . . . . 7-2geotiffinfo Now Handles Noncompliant GeoTIFF Files . . . . 7-2geop

R2011a9-6Comet Menu Item Removed from maptoolThe Comet menu item is no longer available in maptool. You can still call cometmdirectly from the command

R2010bVersion: 3.2New FeaturesCompatibility Considerations

R2010b10-2MATLAB Plot Selector Now Includes mapshow and geoshowThe Plot Selector workspace tool creates graphs of workspace variables. The mapshowand

10-3http://hdds.usgs.gov/arcgis/services/... 201004_OilSpill_GulfOfMexico/MapServer/... WMSServerand the 2010 earthquake in Haiti:http://hdds.usg

R2010b10-4load geoid;contourfm(geoid, geoidrefvec)R2010aR2010bCompatibility ConsiderationsIf you call any of the contouring functions, expect the beha

10-5Summary New Behavior Compatibility Considerationscontourm(Z,R,V) orcontourm(lat,lon,Z,V),contourm creates a plot with asingle contour at that lev

R2010b10-6Summary New Behavior Compatibility ConsiderationsContoursseparatingfilled areasBy default, the contourfmfunction now draws black contourline

10-7Now that contourfm produces correct results more consistently, it also takes somewhatlonger to run.clabelm No Longer Breaks Contour LinesIn previ

R2010b10-8Compatibility ConsiderationsWhen used with 'DisplayType', 'surface', in previous releases, geoshow set the'FaceColo

10-9Compatibility ConsiderationsIn earlier versions of MATLAB, you could do the following:load geoidworldmap worldcontour3m(geoid, geoidrefvec, 10)h

viii Contentsalmanac Function Now Returns More Precise EccentricityValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

R2010b10-10• When the axes contains Mapping Toolbox contour objects, cdelta is ignored and theresultant colormap contains the same number of colors as

10-11Change in Longitude Limits for WMSMapRequest and WMSLayerThe WMSMapRequest and WMSLayer objects now accept longitude limits from [0 360]or from

R2010aVersion: 3.1New FeaturesCompatibility Considerations

R2010a11-2WMS Database ModifiedThe WMS Database changes on a release-to-release basis, as some new servers are addedand some unavailable servers are r

11-3contains the highest resolution data. For information on downloading the ETOPO datasets, see Technical Note 2101: Accessing Geospatial Data on th

R2010a11-4Display Range Increased for eqdazim and eqaazim ProjectionsIn previous releases, the Equidistant Azimuthal (eqdazim) and Lambert AzimuthalEq

11-5Compatibility ConsiderationsBefore R2010a, the mlayers and mobjects GUIs had an EraseMode option, whichmade it possible to set the erase mode on

R2010a11-6[x,y] = polybool('union', [0 0 1 1], [0 1 1 0], [], [])The polybool function returns the first input pair: [0 0 1 1], [0 1 1 0]. N

R2009bVersion: 3.0New FeaturesCompatibility Considerations

ixKML Schema Updated to Version 2.2 . . . . . . . . . . . . . . . . . . 10-3Population Density Data Added to usastatelo.shp . . . . . . . . 10-3Elemen

R2009b12-2New Features for Creating Web Map Service MapsNew functions and classes now make it possible to interact with Web Map Service (WMS)servers a

12-3New Angle Conversion FunctionsTwo new functions, radtodeg and degtorad, replace older functions rad2deg anddeg2rad. They are functionally identic

R2009b12-4Compatibility ConsiderationsIn previous releases, if you entered the latitude limits of the 'MapLatLimit' propertyin descending or

12-5Name Stage Compatibility Considerationseastof Warns If you are using degrees, replaceeastof(lon, meridian, 'degrees')withmeridian + mod

R2009b12-6dms2deg hms2mat mat2hms time2str tigerpdms2dm hms2sec rad2dm timedim dms2mat hr2hm rad2dms contorm dms2rad hr2hms sec2hm contor3m The fun

R2009aVersion: 2.7.2New FeaturesCompatibility Considerations

R2009a13-2geoshow and mapshow Now Construct Ordinary Patch ObjectsWhen displaying polygons, instead of constructing graphics objects whose classes der

R2008bVersion: 2.7.1New FeaturesCompatibility Considerations

R2008b14-2Using the Map Axes Map Limit Properties with axesm, setm, anddefaultmChanges and enhancements have been made to axesm, setm, and defaultm wi

14-3The setm function now more effectively resets the projection, clearing out settings thatwere specific to the earlier projection, updating the map