Programming Image Services using the Silverlight Web API. Wenxue Ju, Hong Xu

Transcription

1 Programming Image Services using the Silverlight Web API Wenxue Ju, Hong Xu

2 Presentation Outline Introduction of image service Image service capabilities Developing image service web application - Discuss seven application patterns

3 What is an Image Service? An ArcGIS Server service that provides image data and the associated functionality through web application - A single image - A collection of images as a mosaic - A collection of images as a catalog - Dynamic processing New in 10.1 : image service cache Image service can be dynamic and static Server Sources

4 What Can Image Services Offer? Fast display Export data - Pixel value, raw image, and processed image Mosaicking and cataloging Dynamic image processing Image mensuration Image service editing - Add, delete, update Support OGC standard - WCS, WMS, WMTS, KML

5 Image Service Clients REST, SOAP Web APIs - Silverlight, Flex, JavaScript ArcGIS.com ArcGIS Desktop Clients ArcGIS Explorer Silverlight Java Flex Web APIs REST SOAP OGC Mobile Standards - WMS, WCS, WMTS, KML Server

6 Image Service Source Data Raster datasets - Including raster products Mosaic datasets - Requires ArcGIS Server Image Extension license Raster or mosaic layers - To control rendering - Predefined query Sources

7 What is the Mosaic Dataset? A data model used to catalog and mosaic your collections of imagery - Stored in geodatabase as a table - Each row references the image files On-the-fly processing and mosaicking Can be accessed as - A catalog - A mosaic Created with Geoprocessing tools

8 Mosaic Rules Mosaic Method defines the order - By Attribute - Closest to Center - Closest to Nadir - North-west (default) - Seamline Mosaic operators resolve the overlaps - First (Default) - Last/Min/Max - Mean/Blend

9 Raster Function Process definition stored in the dataset - Image enhancement - Combine bands - Orthorectification/Pan-sharpen - Shaded relief, hillshade Process applied as it is accessed Define on mosaic dataset or items Advantages - Provide on-the-fly image processing - Create multiple products from one source

10 Publish Image Service Improved desktop publishing user experience in Support copying data during publish Suggested workflows - Server has access to the image data - Register data path and publish - Server has no access to the image data (Linux or Cloud) - move the data to the server if the data volume is large - Let publishing to copy if data volume is small

11 Demo Publish an image service

12 Image Service REST API Operation ExportImage Query 10.0 Download 10.0 Identify 10.0 Measure 10.1 Add, Delete, Update 10.1 ComputeHistogram 10.1 Output An image in a supported format A list of catalog items A list of IDs Pixel values and lists of items Measurements, units, etc. Boolean and raster ID An histogram Resources: Tile, RasterCatalogItem, Colormap, RasterAttributeTable, Metadata, KeyProperties, File

13 Image Service Web APIs RenderingRule ArcGISImageServiceLayer MosaicRule Get (Colormap, AttributeTable, Histogram, KeyProperties) Get (RasterInfo, KeyProperties, Metadata, Thumbnail) Add/Update/Delete Rasters MensurationTask ArcGISTiledMapServcieLayer ImageServiceIdentifyTask QueryTask

14 Image Service Web Application Patterns Display dynamic service cached image service Dynamic processing (server raster function) Mosaic and cataloging Measure building height length, area, etc. Extract pixel value Identify Profile Editing service (Add/Delete/Update) Download/clip raw images Export process image

15 Dynamic image service Display Image Service var imagelayer = new ArcGISImageServiceLayer() { ID = "Image", BandIds = new int[] { 2, 1, 0 }, ImageFormat = ArcGISImageServiceLayer. ImageServiceImageFormat.JPGPNG, CompressionQuality = 75, Url = }; imagelayer.initialized += new EventHandler<EventArgs>(isLayer_Initialized); imagelayer.initializationfailed += new EventHandler<EventArgs>(isLayer_InitializationFailed); Map.Layers.Add(imageLayer); Image service cache - Same as access map service cache var imagelayer = new ArcGISTiledMaperviceLayer() { ID = "Image", Url = };

16 Demo Display dynamic and cached image services

17 Mosaicking and Cataloging ArcGISImageServiceLayer MosaicRule Apply to image service from mosaic dataset Use MosaicRule class for mosaicking - Set mosaic method - Set mosaic operator MosaicRule mrule = new MosaicRule() { MosaicMethod = "esrimosaicattribute", SortField = "YEAR", SortValue = 3000, Ascending = true, MosaicOperation = MT_FIRST }; islayer.mosaicrule = mrule; Mosaic methods: esrimosaiccenter esrimosaiclockraster esrimosaicattribute esrimosaicnorthwest esrimosaicnadir esrimosaicseamline esrimosaicviewpoint

18 Mosaicking and cataloging (Continue) To access the catalog use QueryTask QueryTask FeatureSet Query //Define query parameter Query query = new ESRI.ArcGIS.Client.Tasks.Query(); query.geometry = args.geometry; query.where = "Category = 1 order by Name"; query.returngeometry = true; query.outspatialreference = Map.SpatialReference; query.outfields.add("*"); //Create a query task QueryTask querytask = new QueryTask(imageserviceUrl); querytask.executecompleted += QueryTask_ExecuteCompleted; querytask.failed += QueryTask_Failed; //Excute query task with defined parameters querytask.executeasync(query);

19 Demo Mosaicking and cataloging

20 Server Raster Function A process definition on the server that is used to response to client call - On the fly processing images - Support many built-in functions Aspect, ShadedRelief, Slope, Hillshade Colormap, Statistic, Stretch, NDVI, Remap, Convolution Use RenderingRule class to send process request var renderingrule = new RenderingRule(); renderingrule.rasterfunctionname = "Hillshade"; var functionarguments = new Dictionary<string, object>(); functionarguments.add("azimuth", 315); functionarguments.add("altitude", 45); functionarguments.add("zfactor", 1); renderingrule.rasterfunctionarguments = functionarguments; islayer.renderingrule = renderingrule; ArcGISImageServiceLayer RedenderingRule

21 Extending Server Raster Function Expandable through raster function template - Create with ArcMap - Added to server during publishing - Support customized raster function (COM extensible) var renderingrule = new RenderingRule(); renderingrule.rasterfunctionname = MyRFTName"; IDictionary<string, object> functionarguments = new Dictionary<string, object>(); functionarguments.add( Param1", val1); functionarguments.add( Param2", val2); functionarguments.add( Param3", val3); renderingrule. RasterFunctionArguments = functionarguments; islayer.renderingrule = renderingrule;

22 Demo Create Raster Function Template Stretch Remap-Colormap-ColormapToRGB

23 Image Mensuration Measuring height/distance/area/location from image service Mensuration capabilities are defined when dataset is created from image metadata Enable mensuration capability during publishing the service

24 Image Mensuration API MensurationTask HeightFromBaseAndTopAsync, HeightFromTopAndTopShadowAsync, HeightFromBaseAndTopShadowAsync MensurationHeightParamter DistanceAndAngleAsync MensurationLengthParamter PointAsync MensurationPointParamter AreaAndPerimeterAsync MensurationAreaParamter var mensurationtask = new MensurationTask(isLayer.url); var mensurationparams = new MensurationHeightParameter() { MosaicRule = islayer.mosaicrule, LinearUnit = esriunits.esrimeters, PixelSize = new Size(1,1) } mensurationtask.heightfrombaseandtopcompleted += new EventHandler<MensurationHeightEventArgs>(measureCompleted); mensurationtask.heightfrombaseandtopasync((mappoint)fromgeometry, topoint, mensurationparams);

25 Demo Measure Washington Monument

26 Identifying and Profiling Identify pixel values on an image service using ImageServiceIdentifyTask Elevation profile - multiple requests Time-series profile - identify one point, return all pixel values at this location from time-series image collection var identifytask = new ImageServiceIdentifyTask(imageserviceUrl); var identifyparams = new ImageServiceIdentifyParameters(); identifyparams.geometry = point; identifyparams.mosaicrule = islayer.mosaicrule; identifytask.executecompleted += identifytask_executecompleted; identifytask.executeasync(identifyparams);

27 Demo Elevation Profile Temperature trend

28 Image Service Editing Allow add/delete/update images from image service The backend must be an SDE mosaic dataset - optional turn on editor tracking Enable editing capability - Set workspace on server - Set raster type - Extend using raster type template - Example: LAS Access control AGS users can add Owner can update delete

29 Image Service Editing APIs ArcGISImageServiceLayer AddRasters ImageServiceAddParameters UpdateRaster ImageServiceUpdateParameters DeleteRasters

30 Demo Uploading LAS files to an elevation service

31 Download and Export Image Download raw images from server - Applies to image service of mosaic dataset - Clip/Convert in pixel space/original image/maintain transformation Export image - Proccessed image - TIFF (GeoTIFF)

32 Downloading Capability Enable catalog and download capability during publishing - Download size - Maximum download - Download directory

33 Download and ExportImage REST API Download - RasterIds, clip extent, format - Use File resource to retrieve rasters - Subject to size/count limit per request ExportImage - Define band, extent, mosaic rule, etc - TIFF - Subject to size limit per request (4100x15000)

34 Demo Download and Export

35 Performance Background: Cached service; Dynamic access: JPGPNG Format, or jpg Identify: use ReturnCatalogItems, ReturnGeometry flags Hybrid use: cache for display; dynamic access for query, identify, mensuration

36 Help and Sample Services Imagery resource center Web API World Landsat service World elevation services beta elevation

37 Q&A Thank you! Please fill out the survey form