### Radar Product Suite Configuration (JSON)

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Defines radar product categories and shortcuts for a standard NEXRAD Super-Resolution site. Includes product IDs and provider requirements.

```json
// assets/json/radar_product_suite_superRes.json
// Load products for a standard NEXRAD Super-Resolution site
{
  "categories": [
    {
      "displayKey": "reflectivityProducts",
      "products": [
        {
          "displayKey": "WDTR-title",
          "ids": ["WDTR1", "WDTR2", "WDTR3", "WDTR4"],
          "requiredProviders": ["wdt"]        // only shown when WDT subscription is active
        },
        {
          "displayKey": "p94r-title",
          "ids": ["p94r0", "p94r1", "p94r2", "p94r3"]   // Super-Res Reflectivity tilts 0-3
        },
        { "id": "WDTP1", "requiredProviders": ["wdt"] }, // Precipitation Depiction
        { "id": "p37cr" }                                 // Composite Reflectivity
      ]
    },
    {
      "displayKey": "velocityProducts",
      "products": [
        {
          "displayKey": "WDTV-title",
          "ids": ["WDTV1", "WDTV2", "WDTV3", "WDTV4"],
          "requiredProviders": ["wdt"]
        },
        { "displayKey": "p99v-title", "ids": ["p99v0","p99v1","p99v2","p99v3"] },
        { "displayKey": "56rm-title", "ids": ["56rm0","56rm1","56rm2","56rm3"] } // Storm-Relative Velocity
      ]
    },
    {
      "displayKey": "dualPolProducts",
      "products": [
        { "displayKey": "159x-title", "ids": ["159x0","159x1","159x2","159x3"] }, // Differential Reflectivity (ZDR)
        { "displayKey": "161c-title", "ids": ["161c0","161c1","161c2","161c3"] }, // Correlation Coefficient (CC)
        { "displayKey": "163k-title", "ids": ["163k0","163k1","163k2","163k3"] }, // Specific Differential Phase (KDP)
        { "displayKey": "165h-title", "ids": ["165h0","165h1","165h2","165h3"] }, // Hydrometeor Classification (HC)
        { "id": "177hh" }                                                          // Hybrid Scan Hydrometeor Classification
      ]
    },
    {
      "displayKey": "rainfallProducts",
      "products": [
        { "id": "170aa" },  // Digital Accumulation Array
        { "id": "172dt" },  // Digital Storm Total Accumulation
        { "id": "174od" },  // Digital One-Hour Difference
        { "id": "175sd" },  // Digital Storm Total Difference
        { "id": "171st" }   // Storm Total Accumulation
      ]
    }
  ],
  "shortcuts": {
    "default": [
      { "displayKey": "p94r-title",  "ids": ["p94r0","p94r1","p94r2","p94r3"] },
      { "displayKey": "p99v-title",  "ids": ["p99v0","p99v1","p99v2","p99v3"] },
      { "displayKey": "159x-title",  "ids": ["159x0","159x1","159x2","159x3"] },
      { "displayKey": "161c-title",  "ids": ["161c0","161c1","161c2","161c3"] }
    ],
    "wdt": [
      { "displayKey": "WDTR-title", "ids": ["WDTR1","WDTR2","WDTR3","WDTR4"] },
      { "displayKey": "WDTV-title", "ids": ["WDTV1","WDTV2","WDTV3","WDTV4"] },
      { "displayKey": "159x-title", "ids": ["159x0","159x1","159x2","159x3"] },
      { "displayKey": "161c-title", "ids": ["161c0","161c1","161c2","161c3"] }
    ]
  }
}
```

--------------------------------

### AllisonHouse Settings Activity

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

References the settings activity for configuring AllisonHouse credentials. Displays success and error messages related to authorization.

```xml
<!-- Settings activity for provider credentials -->
<activity android:name="com.basevelocity.radarscope.settings.accounts.RsSettingsAllisonHouseActivity">
  <!-- User enters AllisonHouse username/private ID here -->
  <!-- On success, displays: -->
  <!-- "RadarScope is now configured to use your AllisonHouse account for radar data." -->
</activity>

<!-- AllisonHouse error strings for authorization failures -->
<string name="dialogTitleAHInvalidSub">AllisonHouse Error: 403 - Authorization Failed</string>
<string name="ahProviderConfigured">RadarScope is now configured to use your AllisonHouse account…</string>
```

--------------------------------

### Define Map Overlay Layer Display Names in strings.xml

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

This snippet defines string resources used for naming various map overlay layers. These keys correspond to data feeds from AllisonHouse and Spotter Network.

```xml
<!-- res/values/strings.xml — overlay layer display names -->
<string name="layerWarnings">Warnings</string>           <!-- NWS polygon warnings -->
<string name="layerWatches">Watches</string>             <!-- SPC watches -->
<string name="layerStormTracks">Storm Tracks</string>    <!-- Predicted storm paths -->
<string name="layerLightning">Lightning</string>         <!-- Earth Networks real-time lightning -->
<string name="layerStormReports">Storm Reports</string>  <!-- NWS LSR reports -->
<string name="layerSpotters">Spotters</string>           <!-- Live spotter locations -->
<string name="layerSpotterReports">Spotter Reports</string>
<string name="layerMpingReports">mPING Reports</string>
<string name="layerDiscussions">Mesoscale Discussions</string>
<string name="layerOutlooks">Outlooks</string>           <!-- SPC convective outlooks -->
<string name="layerDerivedContours">Derived Contours</string> <!-- Hail/tornado probability contours -->
<string name="layerCities">Cities</string>
<string name="layerHighways">Highways</string>
```

--------------------------------

### Declare Activities and Permissions in AndroidManifest.xml

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

This snippet shows the declaration of various activities for different screens and essential permissions like internet, location, and wake lock. It also includes the application's main entry point and services for Android Wear.

```xml
<!-- AndroidManifest.xml (excerpt) -->
<manifest package="com.basevelocity.radarscope"
          android:installLocation="auto">

  <!-- Required permissions -->
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WAKE_LOCK" />
  <uses-permission android:name="com.android.vending.BILLING" />

  <application android:name="com.basevelocity.radarscope.application.RadarScopeApp">

    <!-- Main radar map screen (launcher entry point) -->
    <activity android:name="com.basevelocity.radarscope.map.RsMapActivity"
              android:launchMode="singleTask"
              android:theme="@style/AppTheme.NoActionBar">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>

    <!-- Detail screens -->
    <activity android:name="com.basevelocity.radarscope.detail.RsWarningDetailActivity"  android:label="@string/warningDetail_name" />
    <activity android:name="com.basevelocity.radarscope.detail.RsStormCellDetailActivity" android:label="Storm Cell" />
    <activity android:name="com.basevelocity.radarscope.detail.RsDiscussionDetailActivity" android:label="Discussion Detail" />
    <activity android:name="com.basevelocity.radarscope.detail.RsSpotterDetailActivity"   android:label="@string/spotterDetail_name" />

    <!-- Settings screens -->
    <activity android:name="com.basevelocity.radarscope.settings.RsSettingsTabActivity"           android:label="@string/prefs_name" />
    <activity android:name="com.basevelocity.radarscope.settings.accounts.RsSettingsRadarScopeActivity" />
    <activity android:name="com.basevelocity.radarscope.settings.accounts.RsSettingsAllisonHouseActivity" />
    <activity android:name="com.basevelocity.radarscope.settings.accounts.RsSettingsSpotterNetworkActivity" />

    <!-- Android Wear services -->
    <service android:name="com.basevelocity.radarscope.wear.RsWearAnimateService" />
    <service android:name="com.basevelocity.radarscope.wear.RsWearMessageService">
      <intent-filter>
        <action android:name="com.google.android.gms.wearable.DATA_CHANGED"/>
        <action android:name="com.google.android.gms.wearable.MESSAGE_RECEIVED"/>
        <data android:scheme="wear" android:host="*" android:pathPrefix="/animate"/>
        <data android:scheme="wear" android:host="*" android:pathPrefix="/updateData"/>
      </intent-filter>
    </service>
  </application>
</manifest>
```

--------------------------------

### Subscription and Device Limit Messages

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Provides strings for messages related to subscription expiry and device limit enforcement for Pro accounts.

```xml
<!-- Subscription expiry message shown to lapsed subscribers -->
<string name="connectSubscriptionExpiredMessage">
  Your subscription has expired. Please renew your subscription to access
  features such as lightning, extended animation loops, and 30-day archive.
</string>

<!-- Device limit enforcement (Pro accounts have a device cap) -->
<string name="connectDeviceLimitExceededMessage">
  You have exceeded the maximum number of devices allowed for your RadarScope account.
</string>
<string name="deviceLimitReached">
  You have exceeded the allowed device quota for your RadarScope account.
  Please sign out from one of the other devices using this account and then
  click the "Reactivate Features" button below to access your features on this device.
</string>
```

--------------------------------

### TDWR Radar Product Suite Configuration

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

This JSON defines the product suite for Terminal Doppler Weather Radar (TDWR) sites, categorizing products by type (reflectivity, velocity, rainfall, etc.) and including default shortcuts. It specifies which products are available and how they are grouped for display.

```json
// assets/json/radar_product_suite_tdwr.json
{
  "categories": [
    {
      "displayKey": "reflectivityProductsTDWR",
      "products": [
        { "displayKey": "181r-title", "ids": ["181r0","181r1","181r2"] }, // Classic Refl. Tilts 1-3
        { "id": "p37cr" },   // Composite Reflectivity
        { "id": "186zl" }    // Long Range Reflectivity
      ]
    },
    {
      "displayKey": "velocityProductsTDWR",
      "products": [
        { "displayKey": "182v-title", "ids": ["182v0","182v1","182v2"] } // Base Velocity Tilts 1-3
      ]
    },
    {
      "displayKey": "rainfallProducts",
      "products": [
        { "id": "78ohp" },                                    // One-Hour Rainfall
        { "displayKey": "80stp-title", "id": "80stp" }        // Storm Total Rainfall
      ]
    },
    {
      "displayKey": "otherProducts",
      "products": [
        { "id": "57vil" },  // Vertically Integrated Liquid
        { "id": "p41et" }   // Echo Tops
      ]
    }
  ],
  "shortcuts": {
    "default": [
      { "displayKey": "181r-title", "ids": ["181r0","181r1","181r2"] },
      { "displayKey": "182v-title", "ids": ["182v0","182v1","182v2"] },
      { "id": "57vil" },
      { "id": "p41et" }
    ]
  }
}
```

--------------------------------

### Animation Frame Count Options

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Specifies the available options for the number of animation frames, ranging from 6 to 30. Some options are specific to Pro tiers.

```xml
<!-- res/values/strings.xml — animation frame count options -->
<string name="animationFrames6">6</string>
<string name="animationFrames8">8</string>
<string name="animationFrames10">10</string>
<string name="animationFrames12">12</string>
<string name="animationFrames14">14</string>
<string name="animationFrames16">16</string>
<string name="animationFrames18">18</string>
<string name="animationFrames20">20</string>  <!-- Max for standard; Pro allows up to 20 Level II super-res frames -->
<string name="animationFrames22">22</string>
<string name="animationFrames24">24</string>
<string name="animationFrames26">26</string>
<string name="animationFrames28">28</string>
<string name="animationFrames30">30</string>  <!-- Pro Tier 2 extended loop maximum -->
```

--------------------------------

### Canadian Radar Product Suite Configuration

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Defines the available radar products for Canadian sites, including long-range reflectivity, base reflectivity, and velocity tilts. It specifies display keys, product IDs, and required providers.

```json
// assets/json/radar_product_suite_can.json
{
  "categories": [
    {
      "products": [
        {
          "displayKey": "WDTCON-title",
          "ids": ["WDTCON1","WDTCON2","WDTCON3"],
          "requiredProviders": ["wdt"]   // Long Range Reflectivity Tilts 1-3
        },
        {
          "displayKey": "WDTCR-title",
          "ids": ["WDTCR1","WDTCR2","WDTCR3"],
          "requiredProviders": ["wdt"]   // Base Reflectivity Tilts 1-3
        },
        { "id": "WDTP1" },              // Precipitation Depiction
        {
          "displayKey": "WDTCV-title",
          "ids": ["WDTCV1","WDTCV2","WDTCV3"],
          "requiredProviders": ["wdt"]   // Base Velocity Tilts 1-3
        }
      ]
    }
  ],
  "shortcuts": {
    "default": [
      { "displayKey": "WDTCON-title", "ids": ["WDTCON1","WDTCON2","WDTCON3"] },
      { "displayKey": "WDTCR-title",  "ids": ["WDTCR1","WDTCR2","WDTCR3"] },
      { "displayKey": "WDTCV-title",  "ids": ["WDTCV1","WDTCV2","WDTCV3"] },
      { "id": "WDTP1" }
    ]
  }
}
```

--------------------------------

### mPING Android Activity Stack

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Defines the activity stack for the mPING reporting feature in Android, outlining the flow from category selection to description and submission.

```xml
<!-- AndroidManifest.xml — mPING activity stack -->
<!-- Category selection → Description → Submission flow -->
<activity android:name="com.basevelocity.radarscope.export.mping.MpingCategoryActivity"
          android:label="@string/pingReport" />
<activity android:name="com.basevelocity.radarscope.export.mping.MpingDescriptionActivity"
          android:parentActivityName="...MpingCategoryActivity" />
<activity android:name="com.basevelocity.radarscope.export.mping.MpingSubmitActivity"
          android:label="@string/ping" />
```

--------------------------------

### mPING Icon Map Configuration

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Maps server-side category IDs for mPING weather reports to their corresponding PNG image filenames. This is used to display the correct icon for user-submitted reports.

```json
// assets/json/mping_iconMap.json — maps server category ID → image filename
{
  "3":  "rain_o.png",
  "4":  "freezingrain_o.png",
  "5":  "drizzle_o.png",
  "7":  "sleet_o.png",
  "8":  "snow_o.png",
  "9":  "rainsnow_o.png",
  "13": "hail01_o.png",   // Pea-sized hail
  "16": "hail04_o.png",   // Quarter-sized hail
  "20": "hail08_o.png",   // Golf ball hail
  "33": "wind1_o.png",
  "38": "tornado_o.png",
  "40": "flood1_o.png",
  "44": "mudslide_o.png",
  "45": "fog_o.png",
  "46": "dust_o.png",
  "47": "blowingsnow_o.png"
}
```

--------------------------------

### In-App Purchase Product IDs

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Lists the product IDs for RadarScope Pro subscription tiers, including annual and monthly options for Tier 2.

```xml
<!-- res/values/strings.xml — In-App Purchase product IDs -->
<string name="com.basevelocity.radarscope.android.pro.tier2.annual">RadarScope Pro Tier 2 (Annual)</string>
<string name="com.basevelocity.radarscope.android.pro.tier2.monthly">RadarScope Pro Tier 2 (Monthly)</string>
```

--------------------------------

### Map TDWR/Canadian Product Codes to Super-Res Equivalents

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

This JSON file maps TDWR and Canadian radar product codes back to their closest super-resolution equivalents. It is used for display rendering validation to ensure consistency.

```json
// assets/json/radar_product_validation_superRes.json
{
  "181r0": "WDTR1",   // TDWR Classic Refl. Tilt 1 → Super-Res Refl. Tilt 1
  "181r1": "WDTR2",
  "181r2": "WDTR4",
  "182v0": "WDTV1",   // TDWR Velocity Tilt 1 → Super-Res Velocity Tilt 1
  "182v1": "WDTV2",
  "182v2": "WDTV3",
  "186zl": "WDTR1",   // Long Range Reflectivity → Super-Res Refl. Tilt 1
  "WDTCR1": "WDTR1",  // Canadian Base Refl. Tilt 1 → Super-Res Refl. Tilt 1
  "WDTCV1": "WDTV1"   // Canadian Base Velocity → Super-Res Velocity
}
```

--------------------------------

### Map Provider Radar Product Codes to NEXRAD IDs

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

This JSON file maps internal product codes from WDT and AllisonHouse data providers to standard NEXRAD product identifiers for UI display. It is used to translate provider-specific codes into a consistent format.

```json
// assets/json/radar_products_map.json
// Maps provider-specific codes → display product IDs
{
  "wdt": {
    "p19r0": "N0R",   // Base Reflectivity 0.5°
    "p94r0": "N0Q",   // Super-Res Reflectivity 0.5°
    "p94r1": "N1Q",
    "p94r2": "N2Q",
    "p94r3": "N3Q",
    "p99v0": "N0U",   // Super-Res Velocity 0.5°
    "159x0": "N0X",   // Differential Reflectivity 0.5°
    "161c0": "N0C",   // Correlation Coefficient 0.5°
    "163k0": "N0K",   // Specific Differential Phase 0.5°
    "165h0": "N0H",   // Hydrometeor Classification 0.5°
    "170aa": "DAA",   // Digital Accumulation Array
    "134il": "DVL",   // Digital Vertically Integrated Liquid
    "135et": "EET",   // Enhanced Echo Tops
    "177hh": "HHC",   // Hybrid Scan Hydrometeor Classification
    "WDTR1": "WDTR1", // WDT Super-Res Reflectivity Tilt 1 (Pro)
    "WDTV1": "WDTV1"  // WDT Super-Res Velocity Tilt 1 (Pro)
  },
  "ah": {
    "p94r0": "N0Q",
    "p99v0": "N0U",
    "181r0": "TR0",   // TDWR Reflectivity Tilt 1
    "182v0": "TV0"    // TDWR Velocity Tilt 1
  }
}
```

--------------------------------

### Spotter Network Category Definitions

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

Defines the categories and their associated descriptions for structured field reports submitted through Spotter Network. Includes options for narrative text and specific values for size/intensity.

```json
// assets/json/spotter_network_categories.json
{
  "results": [
    { "name": "Tornado",     "narrative": true },
    { "name": "Funnel Cloud","narrative": true },
    {
      "name": "Wall Cloud",
      "descriptions": [
        { "name": "Rotating",     "narrative": true },
        { "name": "Not Rotating", "narrative": true }
      ]
    },
    {
      "name": "Hail",
      "descriptions": [
        { "name": "Penny",      "value": 0.75 },
        { "name": "Quarter",    "value": 1.00 },
        { "name": "Golf Ball",  "value": 1.75 },
        { "name": "Baseball",   "value": 2.75 },
        { "name": "Softball",   "value": 4.50 },
        { "name": "Larger",     "narrative": true }
      ]
    },
    {
      "name": "Wind",
      "descriptions": [
        { "name": "50 mph", "value": 50.0 },
        { "name": "60 mph", "value": 60.0 },
        { "name": "70 mph", "value": 70.0 },
        { "name": "80+ mph","value": 80.0 }
      ]
    },
    { "name": "Flood",       "narrative": true },
    { "name": "Flash Flood", "narrative": true },
    { "name": "Other",       "narrative": true }
  ]
}
```

--------------------------------

### Radar Site Database Schema

Source: https://context7.com/johnlikescarrot/radarscope/llms.txt

This JSON array defines the format for individual radar site entries, including type, ICAO identifier, geographic coordinates, state, and city. It serves as a runtime mirror of the SQLite database.

```json
// assets/json/radar_sites.json — individual site entry format
[
  {
    "radarType": "superRes",         // site type: superRes | tdwr | canadian | korean | pacific | roc
    "radarId":   "ktlx",             // 4-character ICAO identifier
    "lat":        35.3331,           // site latitude (decimal degrees)
    "lon":       -97.2778,           // site longitude (decimal degrees)
    "state":     "OK",               // two-letter state/province code
    "city":      "Oklahoma City"     // display name
  },
  {
    "radarType": "superRes",
    "radarId":   "kffc",
    "lat":        33.3636,
    "lon":       -84.5658,
    "state":     "GA",
    "city":      "Atlanta"
  }
  // ... 160+ US sites, plus Canadian, Korean, Pacific, and ROC sites
]
```