ArcGIS Pro Setup

This guide covers the specific steps for setting up the RMI 360 Workflow in ArcGIS Pro.

Prerequisites

  • ArcGIS Pro 3.4.0 or later (tested with 3.4.3 and 3.5.0)

  • Standard or Advanced license for Oriented Imagery Dataset (OID) tools

  • Basic license is sufficient for image processing and enhancement tools

Environment Verification

Before adding the main toolbox, verify your Python environment has all required packages.

  1. Add the Environment Checker

    • Open ArcGIS Pro and load a project (.aprx file)

    • In the Catalog pane, right-click Toolboxes

    • Select Add Toolbox

    • Navigate to and select rmi_360_env_checker.pyt

  2. Run Environment Check

    • Expand the RMI 360 Environment Checker toolbox

    • Double-click Check Required Python Packages

    • Review the output to see which packages are available

    • Note any missing packages for installation

  3. Install Missing Packages

    If packages are missing, install them using one of these methods:

    Method 1: ArcGIS Pro Package Manager

    • Go to Project → Python → Manage Environments

    • Select your active environment

    • Click Add Packages

    • Search for and install missing packages

    Method 2: Command Line (if available)

    # Activate ArcGIS Pro environment
conda activate arcgispro-py3

# Install packages
conda install pyyaml boto3 keyring matplotlib

Adding the Main Toolbox

  1. Add RMI 360 Workflow Toolbox

    • In the Catalog pane, right-click Toolboxes

    • Select Add Toolbox

    • Navigate to and select rmi_360_workflow.pyt

  2. Verify Toolbox Structure

    You should see the following organization:

    RMI 360 Workflow
├── Setup
│   ├── Create OID Template Tool
│   └── Set AWS Keyring Credentials
├── Individual Tools
│   ├── Run Mosaic Processor Tool
│   ├── Rename and Tag Images
│   ├── Enhance Images Tool
│   ├── Smooth GPS Noise Tool
│   ├── Geocode Images Tool
│   ├── Create OID Tool
│   ├── Add Images to OID Tool
│   ├── Build OID Footprints Tool
│   ├── Update Linear and Custom Tool
│   ├── Generate OID Service Tool
│   ├── Copy to AWS Tool
│   └── Generate Report Tool
└── Orchestrator
    └── Process Mosaic 360 Workflow

Troubleshooting

Warning Icon (❗) on Toolbox

If you see a warning icon when the toolbox loads:

  1. Right-click the toolbox and select Remove

  2. Re-add the toolbox using Add Toolbox

  3. This typically resolves loading issues

Tool Parameters Not Loading

If tool parameters appear blank or don’t load:

  1. Ensure your ArcGIS Pro project is saved

  2. Check that you have appropriate license level

  3. Verify Python environment has required packages

  4. Try closing and reopening ArcGIS Pro

Python Environment Issues

If you encounter Python-related errors:

  1. Verify your ArcGIS Pro Python environment is active

  2. Check Python package installation status

  3. Consider creating a fresh environment clone

  4. Contact your IT administrator if you lack installation permissions

License Requirements

Different tools have different license requirements:

Basic License (Minimum) - Image processing and enhancement - GPS smoothing and geocoding - File renaming and metadata tagging - Report generation - AWS upload tools

Standard/Advanced License Required - Create OID Tool - Add Images to OID Tool - Build OID Footprints Tool - Generate OID Service Tool - Any Oriented Imagery Dataset operations

Project Setup Recommendations

ArcGIS Pro Project Configuration

  1. Create a dedicated project for 360° processing workflows

  2. Set appropriate coordinate system matching your project area

  3. Add necessary base maps for spatial reference

  4. Configure folder connections to your processing directories

Workspace Organization

Your_360_Project.aprx
├── Maps/
│   ├── Processing_Overview    # For monitoring progress
│   └── Results_Review        # For reviewing outputs
├── Folder Connections/
│   ├── Process360_Data/      # Main processing directory
│   └── Config_Files/         # Configuration files
└── Toolboxes/
    ├── rmi_360_workflow.pyt  # Main workflow
    └── rmi_360_env_checker.pyt  # Environment checker

Performance Considerations

  • Close unnecessary applications during processing

  • Ensure adequate disk space (processing can require significant storage)

  • Use local drives rather than network drives when possible

  • Monitor system resources during long-running operations

Next Steps

After successful ArcGIS Pro setup:

  1. Proceed to Configuration to set up your project configuration

  2. Follow the Quick Start Guide guide for your first workflow

  3. Review Tools Overview for detailed tool documentation

For additional support, consult your ArcGIS Pro documentation or contact Esri technical support for platform-specific issues.