You can create a new imagery project using the guided workflow in ArcGIS Excalibur. The guided workflow walks you through each step to ensure that all resources required to create an imagery project are addressed. In addition to the guided workflow, there is an advanced option to create an imagery project in a single step by uploading an imagery project definition file.
Guided workflow
You can create a new imagery project using the guided workflow in ArcGIS Excalibur. The guided workflow walks you through each step to ensure that all resources required to create an imagery project are addressed.
You can cancel the guided workflow or return to a previous step at any time. You can also ignore optional steps if you don't need them for your imagery project.
Identify imagery
The first step in creating an imagery project is identifying the imagery to be used in the project. If you already have imagery from the Queued Images tab in the imagery catalog search or from the imagery exploitation canvas, you can start the guided workflow at Select a project type. If you don't have imagery for your project identified, complete the following steps:
- In the Create a New Imagery Project view, select an imagery layer from the Imagery Layer Selector.
Note:
The imagery layers in the selector are the image services that are available to you from your content and your organization's content in your portal.
- Click Select.
The imagery search catalog opens, where a search is automatically run on the selected imagery layer.
- Select the images on the Search Results tab to add them to the Queued Images tab.
- Click the Queued Images tab and click the Create New Project button to begin creating your project.
Select a project type
Select a project type. A project type provides a focused set of tools you can use when working on the imagery project.
- Click the imagery project type check box for the project type you want to use.
- Click the Next Step button.
Define project details
Provide information that describes your imagery project and what needs to be accomplished.
- Provide information for the following parameters:
- Title (required)
- Summary (optional)
- Instructions(required)
- Tags (required)
- Choose to share your project with your organization or to keep it private.
- Click Next Step.
Select a web map
You can optionally choose a web map to include in your project. A web map can contain reference layers that provide context for your imagery task. This is an optional step; if you don't choose a web map, the default web map from your portal is used.
- Choose a web map using the web map picker.
Only one web map can be chosen.
- Click Next Step.
- Alternatively, if you don't want to include a specific web map, click Skip Step.
Select observation layers
If you chose an observation imagery project type, you must select at least one observation layer by choosing an existing observation layer or creating a new observation layer. If you chose a base imagery project type, this step is not included in the guided workflow you'll move on to Project summary.
Select existing observation layers
If you chose an existing observation layer, the observation layer picker will appear containing available feature layers that have the observation layer required fields and are properly tagged with the observation layer tag. One or more observation layers can be selected from this list
- After clicking the existing observation layer option, choose at least one observation layer using the observation layer picker.
- Click Next Step.
Create a new observation layer
If you chose to create a new observation layer, you will step through an experience that allows you to either choose the base observation layer schema or to add additional fields to the base schema to quickly get started with your observation collection tasks.
- After clicking the create new observation layer option, enter in a name for the new observation layer.
- Choose a type of geometry for your observation layer.
Note:
The spatial reference of your new observation layer will be set to the spatial reference of your selected imagery in your project. - If the base observation layer schema is all that is desired, click Next Step.
- Optionally, you can begin adding an additional field to the base schema by providing a Name, Alias, and field Type.
- If desired, you can define a picklist (domain of coded values or range) for the new field by selecting Coded Values or Range.
Note:
A Range domain cannot be made for a new field of type String. - Enter a Name and Code for each domain in your picklist ensuring you add each domain to the list.
- After all domains are added to the new field, click Add Field.
- Repeat steps 4-7 until all additional fields are added to the base schema.
- Click Next Step when
finished.
Your new observation layer is created.
Project summary
This is the last step in the guided workflow. It is a summary of what you've chosen for your imagery project. If any edits need to be made, click the Previous Step button to make the appropriate changes. Once everything is confirmed, complete the following steps to create your imagery project:
- Click the Next Step button.
Your new imagery project is created.
- Click the project to open it or to view the projects list.
Upload an imagery project definition file
In addition to the guided workflow, there is an advanced option to create an imagery project in a single step by uploading an imagery project definition file. A properly formatted JSON file must be provided to successfully create an imagery project.
To upload an imagery project definition file, complete the following steps:
- Open the Create A: New Imagery Project view either from the ArcGIS Excalibur home page or using the left-side navigation.
- In the Create a New Imagery Project view, click the Advanced Option button.
- Click Browse for an Imagery Project Definition file and browse to the properly formatted JSON file.
- Click the project to open it or to view the projects list.
The examples below provide sample JSON correctly formatted for the base and observation imagery project types.
Base imagery project JSON
The formatted JSON example of a base imagery project type below includes the following:
- Project details
- Project instructions
- Image from an image service
{
"itemInfo": {
"title": "Title of project",
"summary": "Summary of project.",
"projectType": "base"
},
"itemData": {
"instructions": "Project instructions.",
"rasterIds": [1],
"serviceUrl": "Imagery Web Service URL"
},
"version": "1.0"
}Observation imagery project JSON
The formatted JSON example of an observation imagery project type below includes the following:
- Project details
- Project instructions
- Image from an image service
- Web map
- Project details
- Editable collection layer
{
"itemInfo": {
"title": "Title of project",
"summary": "Summary of project.",
"projectType": "observation"
},
"itemData": {
"instructions": "Project instructions",
"rasterIds": [1, 4, 7],
"observationLayers": [{
"itemId": "Observation layer item ID",
"type": "Feature Layer"
}],
"serviceUrl": "Imagery Web Service URL",
"webmapId": "Web Map item ID"
},
"version": "1.0"
}