Merge pull request #29 from TaskarCenterAtUW/utils-update-1

Updating utilities.

- Delete `update-quest-ids.ps1`
No longer needed. Long Form Quest Definition Schema 3.0.0 includes new quest_id numbering schema.

- Delete `update-exif-recursive.ps1`
No longer needed. Merged into `update-exif.ps1`.

- Update `update-exif.ps1`
Merge in `-Recursive` functionality from old `update-exif-recursive.ps1`

---

Standardize documentation and formatting:

- Update `gtfs-to-tdei-converter.ps1`
- Update `sli-guardian.ps1`
- Update `workspaces-export.ps1`
- Update `workspaces-josm.ps1`

---

- Update `update-exif.ps1`
Replace "GoInfoGame" with "TDEI Tools" and sync version number

- Update `README.md`
Replace "GoInfoGame" with "AVIV ScoutRoute" or "TDEI Tools", fix links

Author: uw-amy-bordenave

README.md

@@ -8,7 +8,7 @@ Documentation files, schema definitions, and examples.
 
 ### [Imagery Layers](docs/imagery-layer)
 
-[Schema](docs/imagery-layer/schema.json) and [example](docs/imagery-layer/example.json) for imagery layers for use in GoInfoGame.
+[Schema](docs/imagery-layer/schema.json) and [example](docs/imagery-layer/example.json) for imagery layers for use in AVIV ScoutRoute.
 
 ### [Quest Definitions](docs/quest-definition)
 
@@ -18,22 +18,20 @@ Additional documentation and guides can be found on the [TCAT Wiki](https://task
 
 ## [Images](images)
 
-Images of pedestrian infrastructure and related features, intended to be used in GoInfoGame long form quest definitions. Uncropped original non-annotated images are included, and all of the images in the `/images/` directory and its subdirectories are CC0-licensed and free to use by anyone for any purpose.
+Images of pedestrian infrastructure and related features, intended to be used in AVIV ScoutRoute long form quest definitions. Uncropped original non-annotated images are included, and all of the images in the `/images/` directory and its subdirectories are CC0-licensed and free to use by anyone for any purpose.
 
-Note that the intent of this resource is to facilitate the functioning of the GoInfoGame app. If you have images that you think would be useful to add - please upload them to [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page)!
+Note that the intent of this resource is to facilitate the functioning of the AVIV ScoutRoute app. If you have images that you think would be useful to add - please upload them to [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page)!
 
 ## [Quests](quests)
 
-GoInfoGame Long Form Quest JSON Definitions for use in [TDEI Workspaces](https://workspaces.sidewalks.washington.edu/), sorted by Environment and Project Group.
+AVIV ScoutRoute Long Form Quest JSON Definitions for use in [TDEI Workspaces](https://workspaces.sidewalks.washington.edu/), sorted by Environment and Project Group.
 
 ## [Utilities](utilities)
 
 Utilities related to the TDEI.
 
-- **[GoInfoGame Images Exif Data Update Script](utilities/update-exif.ps1)**
-- **[GoInfoGame Images Exif Data Update Script (Recursive)](utilities/update-exif-recursive.ps1)**
+- **[TDEI Tools Images Exif Data Update Script](utilities/update-exif.ps1)**
 - **[GTFS-to-TDEI Converter Script](utilities/gtfs-to-tdei-converter.ps1)**
-- **[Quest ID Update Script](utilities/update-quest-ids.ps1)**
 - **[SLI Guardian](utilities/sli-guardian.ps1)**
-- **[Workspaces Export Script](utilities/workspace-export.ps1)**
-- **[Workspaces JOSM Settings Script](utilities/workspace-josm.ps1)**
+- **[Workspaces Export Script](utilities/workspaces-export.ps1)**
+- **[Workspaces JOSM Settings Script](utilities/workspaces-josm.ps1)**

utilities/gtfs-to-tdei-converter.ps1

@@ -1,46 +1,36 @@
+#!/usr/bin/env pwsh
+# This script is designed to be run in a PowerShell environment.
+
 # Name: GTFS-to-TDEI Converter Script
-# Version: 3.0.0
-# Description: This script takes a GTFS archive, processes it to convert stops.txt to stops.geojson, and zips the result into an archive ready for upload to TDEI.
+# Version: 4.0.0
+# Date: 2025-09-23
 # Author: Amy Bordenave, Taskar Center for Accessible Technology, University of Washington
-# Date: 2025-09-09
 # License: CC-BY-ND 4.0 International
 
 <#
 .SYNOPSIS
-    Converts GTFS stops.txt to TDEI-compatible GeoJSON format.
+    Converts GTFS stops.txt to TDEI-compatible GeoJSON format
 
 .DESCRIPTION
     This script takes a GTFS archive, extracts the stops.txt file, converts it to 
     OpenSidewalks-compatible GeoJSON format, and packages it as a ZIP file ready 
     for upload to the TDEI (Transportation Data Exchange Initiative).
 
-    The script validates the input GTFS data, ensures required fields are present,
-    and validates coordinate values before conversion.
-
 .PARAMETER InputZip
     Path to the GTFS ZIP archive containing stops.txt file.
-    This parameter is mandatory.
 
 .PARAMETER OutputDir
     Directory where the output stops.zip file will be created.
-    If not specified, uses the current working directory.
-    The directory will be created if it doesn't exist.
+    If not specified, uses the current working directory by default.
 
 .EXAMPLE
-    .\gtfs-to-tdei-converter.ps1 -InputZip "C:\data\gtfs.zip"
-    
+    .\gtfs-to-tdei-converter.ps1 -InputZip "C:\example\gtfs.zip"
     Converts the GTFS archive and saves stops.zip in the current directory.
 
 .EXAMPLE
-    .\gtfs-to-tdei-converter.ps1 -InputZip "C:\data\gtfs.zip" -OutputDir "C:\output"
-    
+    .\gtfs-to-tdei-converter.ps1 -InputZip "C:\example\ingest\gtfs.zip" -OutputDir "C:\example\export"
     Converts the GTFS archive and saves stops.zip in the specified output directory.
 
-.EXAMPLE
-    Get-Help .\gtfs-to-tdei-converter.ps1 -Detailed
-    
-    Shows detailed help including parameter descriptions and examples.
-
 .NOTES
     Required GTFS fields: stop_id, stop_lat, stop_lon
     Output format: OpenSidewalks 0.2 schema compatible GeoJSON
@@ -54,8 +44,6 @@
     https://github.com/TaskarCenterAtUW/tdei-tools
 #>
 
-# This script is designed to be run in a PowerShell environment.
-
 param(
     [Parameter(Mandatory = $true, HelpMessage = "Path to the GTFS zip archive")]
     [string]$InputZip,
@@ -71,7 +59,7 @@ $OUTPUT_GEOJSON_FILENAME = 'stops.geojson'
 $OUTPUT_ZIP_FILENAME = 'stops.zip'
 $GTFS_STOPS_FILENAME = 'stops.txt'
 
-Write-Host "GTFS-to-TDEI Converter Script v3.0.0" -ForegroundColor DarkBlue
+Write-Host "GTFS-to-TDEI Converter Script v4.0.0" -ForegroundColor DarkBlue
 Write-Host ""
 
 # Check if input ZIP exists

utilities/sli-guardian.ps1

@@ -1,20 +1,88 @@
+#!/usr/bin/env pwsh
+# This script is designed to be run in a PowerShell environment.
+
 # Name: SLI Guardian
-# Version: 5.0
-# Description: This script applies an overlay to images, designed for use with pedestrian-perspective street-level imagery from a GoPro Max
+# Version: 6.0.0
+# Date: 2025-09-23
 # Author: Amy Bordenave, Taskar Center for Accessible Technology, University of Washington
-# Date: 2025-09-03
 # License: CC-BY-ND 4.0 International
-#
-# This script is designed to be run in a PowerShell environment.
-# Prerequisites: ImageMagick and ExifTool must be installed and in PATH
-#
-# Usage:
-#   .\sli-guardian.ps1 -inputDir <input_directory> -outputDir <output_directory> -overlay <overlay_file> -maxParallel <n> -batchSize <n> -jpegQuality <n>
-#
-# Examples:
-#   .\sli-guardian.ps1
-#   .\sli-guardian.ps1 -inputDir ".\input" -outputDir ".\output" -overlay ".\overlay.png" -maxParallel 8 -batchSize 50 -jpegQuality 90
-#   .\sli-guardian.ps1 -inputDir "C:\TCAT GoPro\ingest\2025-07-25\101\1" -outputDir "C:\TCAT GoPro\export\2025-07-25\101\1" -overlay "C:\TCAT GoPro\overlay\tcat-purple.png" -jpegQuality 85
+
+<#
+.SYNOPSIS
+    Applies overlay images to street-level imagery
+
+.DESCRIPTION
+    This script applies an overlay to images, designed for use with pedestrian-perspective 
+    street-level imagery from devices like GoPro Max cameras. It processes images in 
+    parallel batches for optimal performance, copying input images to an output directory, 
+    applying the specified overlay, and preserving EXIF metadata from the original files.
+    
+    The script supports various image formats and includes validation for overlay 
+    compatibility, progress reporting, and comprehensive error handling.
+
+.PARAMETER InputDir
+    Path to the directory containing input images to process
+
+.PARAMETER OutputDir
+    Path to the directory where processed images will be saved
+
+.PARAMETER Overlay
+    Path to the PNG overlay file to apply to all images
+
+.PARAMETER MaxParallel
+    Maximum number of parallel processing jobs
+
+.PARAMETER BatchSize
+    Number of images to process in each batch
+    Default: 50
+
+.PARAMETER JpegQuality
+    JPEG compression quality (1-100) for JPEG output files
+    Default: 70
+
+.PARAMETER SkipExif
+    Skip copying EXIF metadata from original files
+
+.EXAMPLE
+    .\sli-guardian.ps1 -inputDir ".\input" -outputDir ".\output" -overlay ".\overlay.png"
+    
+    Processes images from .\input directory using default settings
+
+.EXAMPLE
+    .\sli-guardian.ps1 -inputDir "C:\TCAT GoPro\ingest\2025-07-25\101\1" -outputDir "C:\TCAT GoPro\export\2025-07-25\101\1" -overlay "C:\TCAT GoPro\overlay\tcat-purple.png" -jpegQuality 85
+    
+    Processes images with custom parallel processing and quality settings
+
+.NOTES
+    Prerequisites:
+    - ImageMagick must be installed and available in PATH
+    - ExifTool must be installed and available in PATH (unless -skipExif is used)
+    
+    Supported image formats:
+    - Input: .jpg, .jpeg, .png, .gif, .bmp, .tiff, .tif
+    - Overlay: .png only
+    
+    The script performs these operations:
+    1. Validates all inputs and prerequisites
+    2. Copies input images to output directory
+    3. Validates overlay dimensions match image dimensions
+    4. Applies overlay to images in parallel batches
+    5. Preserves EXIF metadata from original files (unless -skipExif)
+    6. Provides detailed progress reporting and error handling
+    
+    JPEG handling:
+    - JPEG files are processed with quality settings
+    - Extensions are normalized to lowercase .jpg
+    - Non-JPEG files are processed without quality settings
+    
+    Exit codes:
+    - 0: All images processed successfully
+    - 1: No images processed (validation errors or no input images)
+    - 2: Some images failed processing (partial success)
+
+.LINK
+    https://github.com/TaskarCenterAtUW/tdei-tools
+#>
 
 param(
     [Parameter(Mandatory = $true)]
@@ -34,7 +102,7 @@ param(
 
     [Parameter(Mandatory = $false)]
     [ValidateRange(1, 100)]
-    [int]$jpegQuality = 70,
+    [int]$jpegQuality = 90,
 
     [Parameter(Mandatory = $false)]
     [switch]$skipExif
@@ -44,7 +112,7 @@ param(
 $script:ImageExtensions = @('.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.tif')
 $script:JpegExtensions = @('.jpg', '.jpeg')
 
-Write-Host "SLI Guardian v5.0" -ForegroundColor Cyan
+Write-Host "SLI Guardian v6.0.0" -ForegroundColor Cyan
 Write-Host "Max Parallel Jobs: $maxParallel | Batch Size: $batchSize | JPEG Quality: $jpegQuality" -ForegroundColor Cyan
 
 # Step 1: Validation