UTRANS Tools

utrans-tools provides command-line tools for working with UTRANS data.

Install for users

conda create --name utrans-tools --clone arcgispro-py3
conda activate utrans-tools
pip install ugrc-utrans-tools

Show help:

utrans --help

Upgrade to a new version:

pip install --upgrade ugrc-utrans-tools

Install for development

From this directory:

conda create --name utrans-tools --clone arcgispro-py3
pip install -e ".[dev]"

Upgrade these packages if you have troubles installing the dev version:

pip install --upgrade pathspec hatchling

Usage

Get Recent Edits

utrans get-recent-edits --county Carbon --update-features "Z:\Documents\gdb\Carbon20231019.gdb\Roads" --base-features "Z:\Documents\gdb\Carbon20230208.gdb\CC_Roads"

The output is written to the geodatabase containing --update-features.

Run utrans get-recent-edits --help for the complete option reference and supported county profiles.

ETL

Convert county roads to the UTRANS schema with explicit inputs:

utrans etl --county saltlake --source-features "Z:\Documents\gdb\SaltLake.gdb\RoadCenterline_Recents" --utrans-roads "Z:\schemas\UtahRoadsNGSchema.gdb\Roads_Edit" --county-boundaries "Database Connections\internal.sde\SGID.BOUNDARIES.Counties"

The output is written to the geodatabase containing --source-features. It contains complete road features that intersect the selected county boundary; it does not clip features at the boundary. Run utrans etl --help for all options.

Detect Changes

Process ETL output against a previous UTRANS road feature class:

utrans detect-changes --county Carbon --update-features "Z:\Documents\gdb\Carbon.gdb\county_etl" --utrans-features "Z:\Documents\gdb\UTRANS.gdb\Roads" --append-target "Database Connections\internal.sde\UTRANS.DFC_RESULT"

The command writes outputs to the geodatabase containing --update-features. It uses the NAME matching and comparison fields, adds DFC editor metadata, creates TEST_DFC_RESULT with NC and D changes excluded, and appends the filtered result to --append-target.

Run utrans detect-changes --help for the remaining options.