🐟 ADFG Commercial Dataset

✅ DATASET UPDATED - JANUARY 2025
This ADF&G Commercial Escapement dataset was updated on January 15, 2025 with time format consistency fixes and manifest structure improvements. Contains 61 years of commercial escapement data (1965-2025) from 48 monitoring stations across Alaska.

Last Updated: January 15, 2025

ADFG Commercial Fish Count Dataset - 61 years of commercial escapement data (1965-2025) across 48 locations and 6 species

Official fish count data from Alaska Department of Fish & Game (ADFG) commercial monitoring stations following AFCA Location Codes Framework

📊 Dataset Statistics

• Total Files: 2,605 JSON files
• Total Locations: 48 locations with data
• ID Range: 1000-1999 (AFCA Commercial Framework)
• Year Range: 1965-2025 (61 years)
• Species: 6 species (Chinook, Sockeye, Coho, Pink, Chum, Run)
• Framework: AFCA Location Codes Framework
• Time Format: Consistent "Month, DD YYYY 00:00:00" format across all files
• Manifest Structure: Flat organized[locationId][speciesId][year] for history page compatibility

🎯 About This Repository

This repository contains official commercial escapement data from 48 monitoring stations across Alaska, operated by the Alaska Department of Fish & Game (ADF&G). The data is organized according to the official AFCA Location Codes Framework and serves as the data source for the Alaska Fish Count App.

📋 AFCA Location Codes Framework (Commercial: 1000-1999)

This dataset follows the official AFCA Location Codes Framework for commercial fishing locations:

Location ID Range: 1000-1999

• 1000-1099: Southwest Alaska (Bristol Bay, Kuskokwim areas)
• 1100-1199: Interior Alaska (Yukon River, Tanana areas)
• 1200-1299: Northwest Alaska (Nome, Kotzebue areas)

📁 Repository Structure

adfg-commercial-dataset/
├── manifest.json          # Dataset manifest and metadata
├── README.md             # This documentation
├── 1001/                 # Location ID 1001 (George River)
│   ├── 410/              # Species ID 410 (Chinook Salmon)
│   │   ├── 1996-george-river-escapement-chinook.json
│   │   └── ...
│   ├── 420/              # Species ID 420 (Sockeye Salmon)
│   │   └── ...
│   └── ...
├── 1002/                 # Location ID 1002 (Goodnews River)
│   └── ...
└── ...                   # Additional locations (up to 1218)

📋 File Naming Convention

• Format: YEAR-location-slug-escapement-species-slug.json
• Example: 1996-george-river-escapement-chinook.json
• Location Slug: Lowercase, hyphenated location name
• Species Slug: Lowercase, hyphenated species name

🐟 Supported Species

📍 Complete Location Directory (48 Locations)

This dataset contains 48 locations across Alaska with commercial escapement data. Each location is organized by AFCA Location Codes Framework (1000-1999 range).

All Commercial Monitoring Locations

This table shows all 48 locations in the commercial dataset following AFCA Location Codes Framework (1000-1999 range). Each location folder contains species-specific subdirectories with commercial escapement data.

📊 Data Format

All files follow the ADFG standard format with consistent column structure:

{
  "COLUMNS": [
     "YEAR",
    "COUNTDATE",
    "FISHCOUNT",
    "SPECIESID",
    "COUNTLOCATIONID",
    "COUNTLOCATION",
    "SPECIES"
  ],
  "DATA": [
    [
      1996,
      "June, 15 1996 0:00:00",
      0,
      410,
      1001,
      "George River",
      "Chinook"
    ]
  ],
  "metadata": {
    "location_id": 1001,
    "species_id": "410",
    "year": "1996",
    "totalRecords": 3687,
    "totalCount": 7021641,
    "source": "ADFG Commercial Dataset",
    "last_updated": "1996-12-31T00:00:00"
  }
}

🏔️ Regional Organization

All COMMERCIAL locations use AFCA IDs 1000–1999. Regional grouping:

• 1000-1099: Southwest Alaska (Bristol Bay, Kuskokwim areas)
• 1100-1199: Interior Alaska (Yukon River, Tanana areas)
• 1200-1299: Northwest Alaska (Nome, Kotzebue areas)

🔄 Related Datasets

• Sport Dataset: Current sport fishing data (0-999 range)
• SASAP Dataset: Historical escapement data (2000-2999 range)
• Commercial Dataset: Commercial escapement data (1000-1999 range) - This dataset

🆕 Recent Updates (January 2025)

✅ Time Format Consistency

• Fixed: All datasets now use consistent "Month, DD YYYY 00:00:00" time format
• Impact: Ensures proper chart visualization and date parsing across all datasets
• Files Updated: All 2,605 JSON files maintain consistent time formatting

✅ Manifest Structure Optimization

• Fixed: Converted manifest from nested to flat structure for history page compatibility
• Structure: Changed from organized[locationId].species[speciesId].files[year] to organized[locationId][speciesId][year]
• Impact: History page now loads COMM data correctly with improved performance
• Files Updated: Manifest.json restructured with 2,605 file mappings

✅ Repository Status

• Status: All changes successfully pushed to GitHub public repository
• Compatibility: Full compatibility with Alaska Fish Count App history page
• Data Integrity: All location names verified against master-locations.json

📄 License & Attribution

This data is in the Public Domain and available for unrestricted use.

When using this data, please attribute:

• Data Source: Alaska Department of Fish & Game (ADF&G)
• Repository: alaskafishcounts/adfg-commercial-dataset
• Application: Alaska Fish Count App
• Framework: AFCA Location Codes Framework

📞 Contact Support

• GitHub Issues: Report problems via repository Issues
• Data Source: Alaska Department of Fish & Game
• Repository: alaskafishcounts/adfg-commercial-dataset

Last Updated: January 15, 2025
Version: AFCA v1.0.1
Data Source: Alaska Department of Fish & Game (ADF&G)
Framework: AFCA Location Codes Framework
Repository: alaskafishcounts/adfg-commercial-dataset