Available with Advanced license.
In ArcGIS Pro, you can photogrammetrically correct satellite imagery to remove geometric distortions induced by the platform and terrain displacement. After removing these distortions, you can generate ArcGIS Reality for ArcGIS Pro products, including digital surface model (DSM) and a DSM mesh. In this tutorial, you will generate a high-resolution DSM.
First, you will set up a Reality mapping workspace to manage your satellite imagery collection. Next, you will perform a block adjustment, followed by a refined adjustment using ground control points. Finally, you'll generate a DSM.
ArcGIS Pro can process satellite images from many sensor platforms, as long as the image orientation is described by a rational polynomial coefficients (RPC) model or a rigorous sensor model. This model is typically embedded in the image file or included as a separate metadata file.
Create a Reality mapping workspace
A Reality mapping workspace is an ArcGIS Pro subproject that is dedicated to reality mapping workflows. It is a container within an ArcGIS Pro project folder that stores the resources and derived files that belong to a single image collection in a Reality mapping task.
The imagery packaged for this tutorial was collected and provided by Maxar Technologies. It includes a pair of multispectral and panchromatic images, a table of ground control points, and a DEM.
- Download the tutorial dataset and save it to C:\sampledata\RM_satellite_tutorial.
- Unzip the data.
- In ArcGIS Pro, create a project using the Map template and sign in to your ArcGIS Online account if necessary.
- On the Imagery tab, in the Reality Mapping group, click the New Workspace drop-down menu and choose New Workspace.
- On the Workspace Configuration page, type a name for the workspace.
- Ensure that the Workspace Type option is set to Reality Mapping.
- From the Sensor Data Type drop-down list, choose Satellite.
- Optionally, from the Basemap drop-down list, choose a basemap as a backdrop for the image collection.
- Optionally, check the Allow adjustment reset check box for the option of reverting your workspace to a previous state.
- Click Next.
- In the Image Collection window, under the Sensor Type drop-down menu, choose GeoEye-1.
- Under Folder Containing Images, click the Browse button and browse to the tutorial data folder on your machine and choose the imagery folder (GeoEye_NAD83_UTM10N).
- Under Spatial Reference, click the Browse button .
- In the Spatial Reference window, under Current XY, set the spatial reference to NAD 83 UTM Zone 10N (WKID 26910).
- Under Current Z, expand Vertical Coordinate System and under Gravity-related, expand World and choose EGM96 Geoid.
- Click OK to close the Spatial Reference window and click Next.
- In the Data Loader window, under Elevation Source, choose DEM. Under DEM, browse to the DEM provided with the tutorial dataset.
This DEM will be used to support the block adjustment process.
- Most elevation data uses orthometric heights, so you will need to apply a geoid correction. Under Geoid correction, ensure EGM96 is selected.
- Under Processing Template, choose Panchomatic.
- Ensure Estimate Statistics option is checked.
- Expand Pre-processing and check the box next to Calculate Statistics.
This will expose the Calculate Statistics options.
- Set the Number of Columns to Skip and Number of Rows to Skip values as 5.
- Accept all other defaults and click Finish.
Once the workspace has been created, the images and image footprints will be displayed in the map. A Reality Mapping category has also been added to the Contents pane, where the source imagery data and derived Reality mapping products will be stored.
The initial display of imagery in the workspace confirms that all images and necessary metadata were provided to initiate the workspace. The images have not been aligned or adjusted, so the mosaic may not appear geometrically correct.
A new Reality Mapping tab will be added to the ArcGIS Pro main menu. Clicking this tab will expose a series of tools and workflows dedicated to Reality mapping. In the Product category, all the buttons are unavailable because the images are not yet adjusted.
Satellite image © 2020 Maxar Technologies
Next, you will remove the NoData areas surrounding the valid satellite imagery.
- On the main menu, click the Analysis tab, then click Tools in the Geoprocessing group.
The Geoprocessing pane appears.
- In the Geoprocessing pane search window, type build footprint.
The Build Footprints geoprocessing tool dialog box appears.
- For Mosaic Dataset, choose the image collection from the drop-down list.
- Accept all other defaults and click Run.
Once complete, the NoData areas are removed and the image footprint updates accordingly.
After you have created your Reality mapping workspace, the next step is to perform block adjustment using the tools in the Adjust and Refine groups. The block adjustment will first calculate tie points, which are common points in areas of image overlap. The tie points will be used to calculate the orientation of each image, known as exterior orientation in photogrammetry.
- On the Reality Mapping tab, in the Adjust group, click Adjust .
- In the Adjust window, under Transformation Type, choose RPC. The Rational Polynomial Coefficients (RPC) transformation will be applied in the adjustment, which is used for satellite imagery that contains RPC information within the metadata.
- In the Adjust window, under Blunder Point Threshold, set a value of 3. Tie points with a residual error greater than this value will not be used in computing the adjustment. The unit of measure is pixels.
- Check the box next to Reproject Tie Points.
This will ensure that the tie point map coordinates are calculated.
- Under Tie Point Matching in the Adjust pane, ensure your parameter settings match those in the example below.
- Click Run to perform block adjustment.
- After the adjustment is complete, turn on the Tie Points layer in the Contents pane to view the distribution of generated tie points on the map. Your tie point distribution may differ from that shown below.
- Tie point residuals or accuracy reporting can be viewed in the logs file. On the Reality Mapping tab, in the Review group, click Logs to access Logs file. Tie point residuals are displayed in the row labeled RMSE_Tie_Image(x,y). The units for tie point RSME is pixels.
Your residual may differ slightly from the example below.
Add ground control points
Ground control points (GCPs) are points with known x,y,z ground coordinates. They are often obtained from ground survey or existing data and used to ensure that the images will be accurately georeferenced in the ground coordinate system. Block adjustment can be applied without GCPs and still ensure relative accuracy, but adding GCPs increases the absolute accuracy of the adjusted imagery. If you do not have GCPs from a ground survey, but you have a georeferenced raster layer (raster dataset, mosaic dataset, or image service), you can add it as a reference to compute GCPs.
GCPs selected from a reference layer and saved in a text file can also be imported and used to enhance adjustment accuracy. For this tutorial, you'll use this import method to add GCPs to the project
To import GCPs, complete the following steps:
- On the Reality Mapping tab, in the Refine group, click Manage GCPs to open the GCP Manager.
- In the GCP Manager window, click the Import GCPs button .
- In the Import GCPs window, browse to and select the GCP file (Vancouver_NAD83-UTM10N.csv). Click OK.
- Under Set GCP Spatial Reference, click the Browse button . For Current XY, expand Layers, and choose NAD 1983 UTM Zone 10N. Accept all other defaults and click OK to accept the changes and close the Spatial Reference window.
The Current Z, or vertical coordinate system (VCS), was not set because the digital elevation model used to extract height values for the GCPs did not have a VCS defined. If the DEM you used had a defined VCS, the Current Z (VCS) would have been set with matching coordinates.
- For Geographic Transformations, accept the defaults. No transformations are required, as the horizontal spatial reference of the GCPs and the workspace are the same.
- Ensure the field mappings are correct.
- Click the browse button below GCP Photo Location and browse to and select the folder containing the images of the GCP locations. Click OK.
- For Photo File Extension, choose PNG from the drop-down list.
- Click OK to import the GCPs.
Once the GCPs have been imported, the table in the GCP Manager will be populated.
In GCP Manager, the first GCP in the list will be selected by default, and a preview of the image where the GCP is located is displayed in the Preview section.
- To add tie points for the selected GCP, in the Preview section, click the View GCP Photo button to display the GCP image chip. Use the mouse wheel to zoom in on the image chip to see the GCP location indicated by a red arrow.
- Click the Add Tie Point button to add a tie point in the image viewer for each image. The tie points for other images will be automatically calculated by the image matching algorithm where possible, although each tie point should be checked for accuracy. If the tie point is not automatically identified, add the tie point manually by selecting the appropriate location in the image.
- Repeat steps 10 and 11 to select and add tie points for the remaining GCPs.
- After each GCP has been measured with tie points, select point PP_GCP02 and right-click to change it a Check Point. This point will not be used in the adjustment process due to uncertainty in its exact location.
- After adding GCPs and checkpoints, the adjustment must be run again to incorporate these points. Click Adjust.
Review adjustment results
Adjustment quality results can be viewed in GCP Manager by analyzing the residuals for each GCP. Residuals represent the difference between the measured and computed position of a point. They are measured in the units of the project spatial referencing system. After completing adjustment with GCPs, three new fields, dX, dY, and dZ, are added to the GCP Manager table and display the residuals for each GCP. The quality of the fit between the adjusted block and the map coordinate system can be evaluated using these values. The Root Mean Square Error (RMSE) of the residuals can be viewed by expanding the Residual Overview section of GCP Manager.
Additional adjustment statistics are provided in the adjustment report. To generate the report, under the Reality Mapping tab, in the Review group, click Adjustment Report.
Generate a digital surface model (DSM)
Once the block adjustment is complete, 2D imagery products can be generated using the tools in the Product group on the Reality Mapping tab. Multiple products can be generated simultaneously using the Multiple Products wizard, or individually by selecting the applicable product tool from the Product group. The types of products that can be generated from satellite sensor data includes a DSM, and a DSM mesh. Only a DSM will be generated in this tutorial.
A DSM is a first surface product which includes the elevations of trees, buildings, and other above-ground features.
To generate a DSM from satellite imagery using the DSM wizard, follow the steps below.
- On the Reality Mapping tab, in the Product group, click the DSM button to open the Reality Mapping Products wizard.
- Click Shared Advanced Settings to open the dialog box, where you can define parameters that will impact the Reality mapping products to be generated.
The Quality and Scenario values are set automatically and should not be changed to ensure optimum performance and product quality. If you want to generate a reduced-resolution product, the Quality value can be lowered. See Shared Advanced Settings for more information about the impact of various quality settings on product generation.
- Ensure that Quality is set to Ultra.
- Accept the Pixel Size default value to generate the DSM at source image resolution.
- For Product Boundary, accept the default settings so the entire project area will be processed.
It is recommended that you provide a product boundary for the following reasons:
- Define the proper output extent—When a product boundary is not defined, the application automatically defines an extent based on various dataset parameters that may not match the project extent.
- Reduce processing time—If the required product extent is smaller than the image collection extent, defining a product boundary reduces the processing duration and automatically clips the output to the boundary extent.
- For Waterbody Features, select SatTut_WaterBody.shp from the tutorial data location.
- Accept all the other default values and click OK.
The Advanced Products Settings dialog box closes, and returns you to the Products Generation Settings pane in the Reality Mapping Products wizard.
- Click Next to go to the DSM Settings pane. Ensure your settings matches the following:
- Output Type—Mosaic
- Format—Cloud Raster Format
- Click Finish to start the product generation process.
Once processing is complete, the DSM product is added to the Contents pane in the Data Products category, and the 2D map view. It is also added to the Catalog pane in the Reality Mapping container, and the DEMs folder.
The default vertical coordinate system (VCS) of the output DSM is WGS84 (ellipsoidal height). If you need to convert the output to a different projection or coordinate system, use the Project tool.
In this tutorial, you created a Reality mapping workspace for satellite imagery and used tools on the Reality Mapping tab to apply a photogrammetric adjustment with ground control points. You then used the Reality Mapping DSM wizard to generate a high-resolution DSM.
The satellite imagery used in this tutorial was acquired and provided by Maxar Technologies.
- Reality mapping in ArcGIS Pro
- Perform a Reality mapping block adjustment
- Adjustment options for Reality mapping satellite imagery
- Manage tie points in a Reality mapping workspace
- ArcGIS Reality mapping product generation
- Generate a DSM using ArcGIS Reality for ArcGIS Pro
- Generate elevation data using the DEMs wizard
- Introduction to the ArcGIS Reality for ArcGIS Pro extension