Share 3D point files for user download

The optional fifth stage is to expose data files for download. This is an option for organizations with a need to share lidar data in 3D point format with their users. For users who need access to the 3D point data, the raster surfaces in the managed collection are used to visualize and identify the required AOI, and then the source files can be downloaded for further processing in ArcGIS for Desktop or other local applications.

Access to the original LAS or zLAS files may be limited to your organization or open to a larger user community, including the public. Two options are described for enabling download:

Host files for download via a mosaic dataset and ArcGIS for Server

This method uses a mosaic dataset to publish an image service through ArcGIS for Server, configured to allow source file download. This is the simplest workflow if your end users are using ArcGIS for Desktop or a custom web app (with the ability to make REST requests for image services) to access the data. This method also requires the lidar data to be maintained on storage accessible to ArcGIS for Server. If your organization does not have ArcGIS for Server or you would prefer to store the lidar data in low-cost cloud storage, see the alternate workflow below.

Serving LAS or zLAS files for download
Serving LAS or zLAS files for download

Create a mosaic dataset

Unless a mosaic dataset was created above under Mosaic dataset to define DTM and DSM, a new mosaic dataset should be created and then published as an image service to support lidar file download. Presuming your organization will have numerous lidar projects, it is recommended to use a name such as Lidar_XXXX_for_Download, where XXXX is a project identifier meaningful to your organization (perhaps a project area name, ID number, or combination). Use the coordinate system of the lidar data for this new mosaic dataset.

Add rasters

Add the LAS dataset containing your lidar source data files into this mosaic dataset.

Steps:
  1. Set Raster Type to LAS Dataset.
  2. Use these settings on the LAS Dataset tab of the Raster Type Properties page.
    1. Set the number of cached surfaces to 10 (default).
    2. Other settings may be left as default values (for example, any returns and any class code) depending on your preference.
    3. Set Pixel size to approximately 10 times the value used for the DTM. (You do not need to create a detailed raster surface from the mosaic dataset, so this value can be larger than the full-resolution DTM.)
    4. Choose Binning, with Aggregation Type set to Mean and Void Filling set to None. Leave Maximum width blank.
  3. On the Add Rasters properties page, do the following.
    1. Enter the path and name for your LAS dataset.
    2. Deselect Update Cell Size Ranges to turn it off.

After you run the Add Rasters tool, load the resulting mosaic dataset into ArcMap. You should see the footprint of the full data collection, but no surfaces should render. This may be verified by opening the Footprint table to confirm that MinPS and MaxPS are both <NULL>. If not, you can use the Field Calculator to set MinPS and MaxPS to 0.

Open the mosaic dataset properties page in ArcCatalog, and on the Defaults tab under Download Properties, note that the Maximum Number of Items Downloadable Per Request is 20 by default. You can change this value to restrict downloads to fewer than 20 items, or alternatively allow a larger number if desired.

Publish a mosaic dataset as an image service

Next you will publish the mosaic dataset as an image service, following standard publishing methods.

Steps:
  1. First, analyze the mosaic dataset and resolve any High Severity items, but note if MinPS and MaxPS in the attribute table are <NULL>, you will see a warning reported in the analysis. This warning can be ignored. If you have set these values to zero, no error should appear.
  2. Register the source data directories (for the mosaic dataset and also the lidar data) with the server.
  3. Right-click the mosaic dataset in ArcCatalog and run Share as Image Service.
  4. Give the service an appropriate name, for example, Lidar_Project_XX_Download.
  5. Run the Image Service Analyzer and resolve any High Severity items.
  6. Enter the appropriate summary, tags, credits, and so forth, on the Item Description page.
  7. Note one important setting: In the Service Editor UI under Capabilities/Imaging, turn the checkbook on to allow download (the default setting is off). This will allow users to select and download lidar source files when published.

Complete the publishing process, and then continue below to verify the download is working properly.

Verify download from the image service

This method of hosting files allows download using ArcMap as the client, or using a custom web app built using the ArcGIS APIs. To verify the download capability, do the following:

Steps:
  1. Connect to the image service and load it into ArcMap.
  2. In the table of contents, right-click to select Zoom to Layer, right-click the layer again, and click Selection > Select All. You should see the footprint for the full collection of lidar files in the LAS dataset.
  3. Right-click the layer and click Data > Download Selected Rasters. This should populate a dialog box with a list of lidar files, but note that you have selected the entire collection. This will typically exceed the Maximum Number of Items Downloadable Per Request property set above and generate an error message.
  4. Use the map to zoom in to an area with a small number of lidar files, and then on the Download Selected Rasters dialog box, find Clip Rasters, and choose Clip to data from extent. This presents a list of only those LAS or zLAS files touching the current area of interest. On this dialog box, choose Convert only when necessary to download the original LAS or zLAS files. If this selection is set to Always convert, the server will generate TIFF files representing the surface defined by the lidar points (either DSM or DTM, depending on the configuration of the point class filters defined when the image service was created).

Download from multiple lidar projects

One final note with regard to serving lidar files for download: the discussion above describes hosting files from a single project, but presuming you have multiple projects, you will typically not want to host numerous services to support download from each. Using the same approach detailed in the Elevation workflow (as discussed in Create mosaic datasets and serve the raster data), multiple source mosaic datasets can be combined into a derived mosaic, which can be shared as described here to enable download of all lidar data from a single source.

Host files in the cloud for download via a feature service on ArcGIS Online

The workflow described above for enabling download of lidar files from a mosaic dataset requires your organization to run ArcGIS for Server. It also requires the lidar source files to be stored locally, accessible to the server. If you would prefer to host a simple service in ArcGIS Online, or you are seeking to use lower-cost cloud storage for your lidar files, the following workflow provides an alternative: using a feature service to show lidar file boundaries and exposing a URL for download of each file. This can reduce costs associated with storage, presuming your users need frequent access to the elevation data but infrequent access to the lidar in 3D point format.

Hosting files in the cloud for download
Hosting files in the cloud for download

Host lidar files for download

You will need a hyperlink to each lidar file, so first prepare the download location. Copy your lidar data to an appropriate site that is accessible to your user community. Since the data volumes are high, and usage requirements may be infrequent, many organizations store LAS or zLAS data in low-cost storage, typically in a public cloud service, where every file is accessible via a unique URL. Ensure permissions are set to allow public download of the data files, or establish an appropriate user account.

Build a table that lists each file name as well as its URL, and label the name column with FileName and the URL column with URL_to_download.

Table with file name and URL columns

Save this table to link into the feature service below.

Create a feature class with lidar file names and boundaries

In the archive of tools available in LAS Custom GP Tools for ArcGIS 10.2, you will find LAS File Extent As Polygon, a geoprocessing tool that will create a feature class from your LAS or zLAS files, listing each source file as a separate record with the extents of each file. This feature class will be used as the source for a feature service.

Alternatively, for files in LAS or zLAS format, you can run the Point File Information tool to create this feature class. Note that you will need version 10.3 to support the zLAS format.

Add links to the feature class

After creating the feature class with LAS or zLAS file extents and file names in the attribute table, run the Join Field geoprocessing tool.

Steps:
  1. The Input Table is your new feature class.
  2. For Input Join Field, choose Name.
  3. For Join Table, use the table created from your download location.
  4. For Output Join Field, choose FileName.
  5. For Join Fields, choose URL_to_download.

This will add your download URL for each file into the feature class defining file extents.

Create a feature service

You can now add your feature class to a blank map document, save the .mxd file, and click Share As Feature Service.

  • If you are publishing through ArcGIS for Server, on the Choose a connection dialog box, you can choose your localhost server and publish.
  • If you do not have ArcGIS for Server, you can use ArcGIS Online by clicking My Hosted Services.

    NoteNote:

    You must be logged in to ArcGIS Online when you publish the feature service.

This feature service can then be shared via an appropriate web app, allowing users to select and download multiple files via the URL_to_download field in the attribute table of the feature service.

3/25/2015