------------------------------------------------------------------------
README
------------------------------------------------------------------------
Micro Rain Radar (MRR) data
Center for Western Weather and Water Extremes (CW3E)
Scripps Institution of Oceanography, UC San Diego
Contact: Peter Yao (peyao [at] ucsd [dot] edu)
Last updated: 2025-02-20

For more info on the MRRs, please see our website:
https://cw3e.ucsd.edu/cw3e_observations_mrrs/

Data is available at: https://cw3e-datashare.ucsd.edu/CW3E_MRR/

------------------------------------------------------------------------
ACTIVE STATIONS
------------------------------------------------------------------------

The following stations are currently telemetered and running in real time
Note: there may be some gaps in the listed date ranges, or ongoing outages that are not listed here

Site | Site Name               | Watershed      | Start Date | End Date  | Lat     | Lon       | Elev
-------------------------------------------------------------------------------------------------------
HDW  | Headworks               | Green/Duwamish | Oct 2023   | Present   | 47.3089 | -121.8558 | 269m
BBY  | Bodega Bay              | Russian        | Jan 2017   | Present   | 38.3183 | -123.0729 | 13m
PVC  | Potter Valley Central   | Russian        | Jan 2017   | Present   | 39.3209 | -123.1028 | 290m
CAT  | Catalina Island         | Santa Ana      | Sep 2021   | Present   | 33.4462 | -118.4828 | 37m
SOD  | Seven Oaks Dam          | Santa Ana      | Feb 2020   | Present   | 34.1148 | -117.0875 | 787m
GPO  | Granite Portal          | Tuolumne       | Jan 2022   | Present   | 37.9077 | -119.9531 | 1312m
WPO  | West Portal             | Tuolumne       | Aug 2021   | Present   | 37.8133 | -120.2874 | 630m
DLA  | Downieville             | Yuba/Feather   | Nov 2019   | Present   | 39.5633 | -120.8243 | 906m
NBB  | New Bullards Bar Dam    | Yuba/Feather   | Dec 2019   | Present   | 39.3964 | -121.1435 | 632m

The following stations transmit snow level data only via GOES,
so the full data and plots are not updated in real time

Site | Site Name               | Watershed      | Start Date | End Date  | Lat     | Lon       | Elev
-------------------------------------------------------------------------------------------------------
YLI  | BNSF Y-Line             | Green/Duwamish | Sep 2023   | Present   | 47.2108 | -121.4878 | 482m

------------------------------------------------------------------------
NO LONGER ACTIVE STATIONS
------------------------------------------------------------------------

The following stations were temporary installations

Site | Site Name               | Watershed      | Start Date | End Date  | Lat     | Lon       | Elev
-------------------------------------------------------------------------------------------------------
BIJ  | Bijou, South Lake Tahoe | Lake Tahoe     | Mar 2021   | Nov 2021  | 38.9419 | -119.9634 | 1910m
TRK  | Martis Creek, Truckee   | Yuba/Feather   | Mar 2020   | Jul 2020  | 39.3285 | -120.1223 | 1789m

------------------------------------------------------------------------
DATA DESCRIPTION
------------------------------------------------------------------------

data: Condensed NetCDF files containing only several most commonly used variables from the processed files (e.g. reflectivity and vertical velocity).
In addition, the data is reindexed so that all files are standard length, and resampled to 5 min intervals.

plots: Plotted timeheights of processed reflectivity and velocity. Note, plots are created using the original processed 1 min time step data,
which are not currently available on the datashare site. There are 2 plot versions: one showing the hourly bright band heights, and one showing
the new 15 min resolution bright band heights. 

raintype_bbheight: CSV files containing the bright band height and raintype determined from the algorithm based on White et al. 2003.
Bright band height is a useful proxy for the elevation of the snow level in the atmosphere. There are 2 versions available: hourly and 15 min resolution
values. The 15 min version is new (Aug 2024) and should be treated as experimental and subject to continued changes.
Time is in UTC, and values are given in units of meters MSL and feet MSL.

------------------------------------------------------------------------
CHANGE LOG
------------------------------------------------------------------------

Mar 31, 2021:
- Added condensed data to ftp site
- Shared files are now saved to /data/CW3E_data/CW3E_DataShare, and symbolic links are created in /data/CW3E_data/CW3E_MRR_Archive

June 9, 2021:
- Added brightband height files to ftp site

June 18, 2021:
- Updated processing code to IMProToo v0.104 (mainly made the netCDF headers more detailed)
- Reprocessed all files (everything is now netCDF4 format)
- Updated plots (added time arrow and several other minor adjustments)
- Added plots to ftp site

June 21, 2021:
- Recondensed all files (updated netCDF headers to make more detailed)

Aug 5, 2021:
- Added West Portal (WPO)

Mar 6, 2024:
- Updated station table, clarified text

Aug 5, 2024:
- Added info about 15 min bright band data and plots

Feb 20, 2025:
- Bright band height CSV files were updated