Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,10 @@ authors:
given-names: "Brian"
affiliation: "Fariborz Maseeh Department of Mathematics and Statistics, Portland State University, Portland, Oregon, USA"
orcid: "https://orcid.org/0000-0002-2164-0301"
- family-names: "Niblett"
given-names: "Sadie"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
orcid: ""https://orcid.org/0009-0008-8588-4816""
contact:
- family-names: "Smith"
given-names: "C. Haden"
Expand Down
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -52,19 +52,22 @@ This project contains 8 time series elements from 4 USGS gaging stations:
4. The Project Explorer will show 8 elements under **Time Series Data**

![RMC-BestFit Project Explorer showing all 8 USGS time series elements](../images/usgs-project-explorer.png)

*Figure 1: Project Explorer with all USGS time series elements*

### Exploring Daily Discharge (Moose River)

1. Click **USGS - 01134500 - Daily Discharge** in the Project Explorer
2. The **Time Series** tab displays the full daily hydrograph
3. Click the **Seasonality** tab to see the annual cycle of streamflow -- note the spring snowmelt peak typical of New England rivers
4. Click the **ACF** and **PACF** tabs to view the autocorrelation structure of daily flows
2. The **Time Series** tab on the left displays the full daily hydrograph
3. Click the **Seasonality** tab on the left to see the annual cycle of streamflow -- note the spring snowmelt peak typical of New England rivers
4. Click the **ACF** and **PACF** tabs on the left to view the autocorrelation structure of daily flows

![Time series plot showing daily discharge for Moose River at Victory, VT](../images/usgs-daily-discharge-ts-plot.png)

*Figure 2: Daily discharge hydrograph for Moose River at Victory, VT (USGS 01134500)*

![Seasonality plot for Moose River daily discharge showing spring snowmelt peak](../images/usgs-daily-discharge-seasonality.png)

*Figure 3: Seasonality plot for Moose River*

### Exploring Instantaneous Data (Potomac River)
Expand All @@ -75,6 +78,7 @@ This project contains 8 time series elements from 4 USGS gaging stations:
4. Zoom in on individual flood events to see the high-resolution hydrograph shape

![Time series plot showing instantaneous discharge for Potomac River](../images/usgs-instantaneous-discharge-ts-plot.png)

*Figure 4: Instantaneous discharge for Potomac River near Washington, DC (USGS 01646500)*

### Exploring Peak Data (Back Creek)
Expand All @@ -85,6 +89,7 @@ This project contains 8 time series elements from 4 USGS gaging stations:
4. Click **USGS - 01614000 - Peak Stage** to see the corresponding annual peak gage heights

![Time series plot showing annual peak discharge for Back Creek near Jones Springs, WV](../images/usgs-peak-discharge-ts-plot.png)

*Figure 5: Annual peak discharge for Back Creek near Jones Springs, WV (USGS 01614000)*

### Exploring Measured Data (Susquehanna River)
Expand All @@ -94,6 +99,7 @@ This project contains 8 time series elements from 4 USGS gaging stations:
3. Measured discharge and stage pairs are commonly used for rating curve development

![Time series plot showing individual field measurements for Susquehanna River](../images/usgs-measured-discharge-ts-plot.png)

*Figure 6: Field-measured discharge for Susquehanna River at Harrisburg, PA (USGS 01570500)*

### Viewing the Properties Panel
Expand All @@ -106,14 +112,15 @@ This project contains 8 time series elements from 4 USGS gaging stations:
- **Download** button to refresh the data from USGS NWIS

![Properties panel showing USGS site number, data type dropdown, and Download button](../images/usgs-properties-panel.png)

*Figure 7: Properties panel for a USGS time series element*

### Downloading Your Own USGS Data

To create a new USGS time series element from scratch:

1. Right-click **Time Series Data** in the Project Explorer and select **Create New**
2. In the Properties panel, set **Entry Method** to **USGS**
1. Right-click **Time Series Data** in the Project Explorer and select **New Time Series**
2. After naming the time series, in the Properties panel, set **Entry Method** to **USGS**
3. Enter a valid **USGS Site Number** (8-15 digits). You can look up site numbers at https://waterdata.usgs.gov
4. Select the desired **Data Type** from the dropdown
5. Click **Download**
Expand Down
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -54,19 +54,22 @@ This project contains 2 time series elements from cooperative observer stations
4. The Project Explorer will show 2 elements under **Time Series Data**

![RMC-BestFit Project Explorer showing the 2 GHCN time series elements](../images/ghcn-project-explorer.png)

*Figure 1: Project Explorer with GHCN time series elements*

### Exploring Daily Precipitation (Big Bear Lake)

1. Click **GHCN - USC00040741 - Daily Precipitation** in the Project Explorer
2. The **Time Series** tab displays the daily precipitation record
2. The **Time Series** tab on the left displays the daily precipitation record
3. Notice the episodic nature of precipitation -- many zero values with occasional storms
4. Click the **Seasonality** tab to see the wet season (winter) and dry season (summer) pattern typical of California's Mediterranean climate
4. Click the **Seasonality** tab on the left to see the wet season (winter) and dry season (summer) pattern typical of California's Mediterranean climate

![Time series plot showing daily precipitation for Big Bear Lake, CA](../images/ghcn-precipitation-ts-plot.png)

*Figure 2: Daily precipitation for Big Bear Lake, CA (GHCN USC00040741)*

![Seasonality plot for Big Bear Lake precipitation showing winter wet season](../images/ghcn-precipitation-seasonality.png)
![Seasonality plot for Big Bear Lake precipitation showing winter wet season](../images/ghcn-precipitation-seasonality-plot.png)

*Figure 3: Seasonality plot -- California's Mediterranean climate with winter-dominant precipitation*

### Exploring Daily Snowfall (Paradise)
Expand All @@ -77,6 +80,7 @@ This project contains 2 time series elements from cooperative observer stations
4. The **Seasonality** tab clearly shows the November-March snow season

![Time series plot showing daily snowfall for Paradise, CA](../images/ghcn-snow-ts-plot.png)

*Figure 4: Daily snowfall for Paradise, CA (GHCN USC00046685)*

### Viewing the Properties Panel
Expand All @@ -90,14 +94,15 @@ This project contains 2 time series elements from cooperative observer stations
- **Download** button to refresh the data

![Properties panel showing GHCN site number, data type, depth unit, and Download button](../images/ghcn-properties-panel.png)

*Figure 5: Properties panel for a GHCN time series element*

### Downloading Your Own GHCN Data

To create a new GHCN time series element:

1. Right-click **Time Series Data** in the Project Explorer and select **Create New**
2. In the Properties panel, set **Entry Method** to **GHCN**
1. Right-click **Time Series Data** in the Project Explorer and select **New Time Series**
2. After naming the time series, in the Properties panel, set **Entry Method** to **GHCN**
3. Enter a valid **GHCN Station ID** (11 characters, e.g., `USC00040741`)
4. Select the **Data Type** (Daily Precipitation or Daily Snow)
5. Select the **Depth Unit** (Inches, Millimeters, or Centimeters)
Expand Down
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -61,20 +61,23 @@ This project contains 6 time series elements, all from the same station:
4. The Project Explorer will show 6 elements under **Time Series Data**

![RMC-BestFit Project Explorer showing all 6 CHMN time series elements for station 08MG005](../images/chmn-project-explorer.png)

*Figure 1: Project Explorer with all CHMN time series elements*

### Exploring Daily Discharge

1. Click **CHMN - 08MG005 - Daily Discharge** in the Project Explorer
2. The **Time Series** tab displays the daily streamflow record beginning in 1914
2. The **Time Series** tab on the left displays the daily streamflow record beginning in 1914
3. Notice the strong seasonal pattern: low winter baseflow and high summer flows from snowmelt and glacial melt
4. Click the **Seasonality** tab to see the annual flow cycle peaking in June-July
5. The **ACF** tab shows strong serial correlation typical of daily streamflow
4. Click the **Seasonality** on the left tab to see the annual flow cycle peaking in June-July
5. The **ACF** tab on the left shows strong serial correlation typical of daily streamflow

![Time series plot showing daily discharge for Lillooet River](../images/chmn-daily-discharge-ts-plot.png)

*Figure 2: Daily discharge for Lillooet River near Pemberton, BC (CHMN 08MG005)*

![Seasonality plot for Lillooet River showing summer snowmelt/glacial melt peak](../images/chmn-daily-discharge-seasonality.png)

*Figure 3: Seasonality plot -- glacial-fed river with June-July peak typical of Coast Mountain catchments*

### Exploring Peak Discharge
Expand All @@ -84,6 +87,7 @@ This project contains 6 time series elements, all from the same station:
3. Peak data is the most commonly used input for flood frequency analysis and can be used directly in a Univariate Analysis element without extracting annual maxima from daily data

![Time series plot showing annual peak discharge values for Lillooet River](../images/chmn-peak-discharge-ts-plot.png)

*Figure 4: Annual peak discharge for Lillooet River (CHMN 08MG005)*

### Exploring Instantaneous Data
Expand All @@ -94,6 +98,7 @@ This project contains 6 time series elements, all from the same station:
4. Note: instantaneous data from WSC is typically limited to the recent real-time period

![Time series plot showing 5-minute instantaneous discharge for Lillooet River](../images/chmn-instantaneous-discharge-ts-plot.png)

*Figure 5: Instantaneous (5-minute) discharge for Lillooet River (CHMN 08MG005)*

### Viewing the Properties Panel
Expand All @@ -106,14 +111,15 @@ This project contains 6 time series elements, all from the same station:
- **Download** button to refresh the data

![Properties panel showing CHMN site number, data type dropdown, and Download button](../images/chmn-properties-panel.png)

*Figure 6: Properties panel for a CHMN time series element*

### Downloading Your Own CHMN Data

To create a new CHMN time series element:

1. Right-click **Time Series Data** in the Project Explorer and select **Create New**
2. In the Properties panel, set **Entry Method** to **CHMN**
1. Right-click **Time Series Data** in the Project Explorer and select **New Time Series**
2. After naming the time series, in the Properties panel, set **Entry Method** to **CHMN**
3. Enter a valid **CHMN Station ID** (7 characters, e.g., `08MG005`)
4. Select the desired **Data Type** from the dropdown
5. Click **Download**
Expand Down
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -60,16 +60,18 @@ Some daily series from BOM may contain missing data (NaN values). This is common
4. The Project Explorer will show 6 elements under **Time Series Data**

![RMC-BestFit Project Explorer showing all 6 ABOM time series elements](../images/abom-project-explorer.png)

*Figure 1: Project Explorer with all ABOM time series elements*

### Exploring Daily Precipitation (Cotter River)

1. Click **ABOM - 410730 - Daily Precipitation** in the Project Explorer
2. The **Time Series** tab displays the daily rainfall record
2. The **Time Series** tab on the left displays the daily rainfall record
3. Notice the episodic rainfall pattern with occasional high-intensity events
4. Click the **Seasonality** tab to observe the seasonal rainfall distribution
4. Click the **Seasonality** tab on the left to observe the seasonal rainfall distribution

![Time series plot showing daily precipitation for Cotter River at Gingera](../images/abom-precipitation-ts-plot.png)

*Figure 2: Daily precipitation for Cotter River at Gingera, ACT (BOM 410730)*

### Exploring Daily Discharge (Cotter River)
Expand All @@ -79,6 +81,7 @@ Some daily series from BOM may contain missing data (NaN values). This is common
3. Click the **Seasonality** tab to see the seasonal flow pattern

![Time series plot showing daily discharge for Cotter River with visible data gaps](../images/abom-daily-discharge-ts-plot.png)

*Figure 3: Daily discharge for Cotter River at Gingera, ACT (BOM 410730)*

### Exploring Instantaneous Stage (Murray River)
Expand All @@ -88,6 +91,7 @@ Some daily series from BOM may contain missing data (NaN values). This is common
3. The Murray River at Tocumwal shows the regulated flow pattern of a major river system

![Time series plot showing instantaneous stage for Murray River at Tocumwal](../images/abom-instantaneous-stage-ts-plot.png)

*Figure 4: Instantaneous water level for Murray River at Tocumwal, NSW (BOM 409202)*

### Viewing the Properties Panel
Expand All @@ -101,14 +105,15 @@ Some daily series from BOM may contain missing data (NaN values). This is common
- **Download** button to refresh the data

![Properties panel showing ABOM site number, data type dropdown, and Download button](../images/abom-properties-panel.png)

*Figure 5: Properties panel for an ABOM time series element*

### Downloading Your Own ABOM Data

To create a new ABOM time series element:

1. Right-click **Time Series Data** in the Project Explorer and select **Create New**
2. In the Properties panel, set **Entry Method** to **ABOM**
1. Right-click **Time Series Data** in the Project Explorer and select **New Time Series**
2. After naming the time series, in the Properties panel, set **Entry Method** to **ABOM**
3. Enter a valid **ABOM Station ID** (6 digits, e.g., `410730`)
4. Select the desired **Data Type** from the dropdown
5. For Daily Precipitation, also select the **Depth Unit** (Millimeters, Centimeters, or Inches)
Expand Down
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ This dataset represents a reservoir routing simulation for Grapevine Dam (Trinit
4. The Project Explorer will show 2 elements under **Time Series Data**

![RMC-BestFit Project Explorer showing the 2 HEC-DSS time series elements](../images/hec-dss-project-explorer.png)

*Figure 1: Project Explorer with HEC-DSS time series elements*

### Exploring the Inflow Hydrograph
Expand All @@ -61,6 +62,7 @@ This dataset represents a reservoir routing simulation for Grapevine Dam (Trinit
3. Notice the sharp flood peak followed by a gradual recession

![Time series plot showing the hourly inflow hydrograph for Grapevine Dam](../images/hec-dss-inflow-ts-plot.png)

*Figure 2: Hourly inflow hydrograph for Grapevine Dam*

### Comparing Inflow and Outflow with Alternative Time Series
Expand All @@ -73,6 +75,7 @@ RMC-BestFit's **Alternative Time Series** feature lets you overlay another time
4. The outflow hydrograph will be overlaid on the inflow plot, visually demonstrating the reservoir's flood attenuation effect

![Time series plot showing inflow and outflow hydrographs overlaid using the Alternative Time Series feature](../images/hec-dss-inflow-outflow-comparison.png)

*Figure 3: Inflow vs. outflow -- the Alternative Time Series feature shows how the reservoir attenuates the flood peak*

### Viewing the Properties Panel
Expand All @@ -85,20 +88,22 @@ RMC-BestFit's **Alternative Time Series** feature lets you overlay another time
- **Import** button to re-import from the DSS file

![Properties panel showing HEC-DSS file path, DSS pathname, and Import button](../images/hec-dss-properties-panel.png)

*Figure 4: Properties panel for a HEC-DSS time series element*

### Importing Your Own HEC-DSS Data

To create a new HEC-DSS time series element:

1. Right-click **Time Series Data** in the Project Explorer and select **Create New**
2. In the Properties panel, set **Entry Method** to **HEC-DSS**
3. Click **Browse** to select a `.dss` file
4. The **DSS Path Selector** window will open, displaying all available pathnames in the file
5. Select the desired dataset and click **OK**
1. Right-click **Time Series Data** in the Project Explorer and select **New Time Series**
2. After naming the time series, in the Properties panel, set **Entry Method** to **HEC-DSS**
3. Click the three dots (...) to the right of the **DSS Filename Selector** to browse for a `.dss` file
4. After selecting the `.dss` file, click the three dots (...) to the right of the **DSS Path Selector** and a window will open, displaying all available pathnames in the file
5. Select the desired dataset and click **Set Path**
6. Click **Import** to load the data

![DSS Path Selector window showing available pathnames in the DSS file](../images/hec-dss-path-selector.png)

*Figure 5: DSS Path Selector window -- browse and select datasets from a HEC-DSS file*

## Key Settings
Expand Down
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@ This dataset is commonly used to demonstrate seasonal decomposition, trend-cycle
Open `manual-entry-example.bestfit` in RMC-BestFit. The Project Explorer shows three Time Series Data elements:

![Project Explorer showing the three manual entry elements: Airline Passengers, Nile River Flows, and Mauna Loa CO2](../images/manual-entry-project-explorer.png)

*Figure 1: Project Explorer with three manually entered time series*

Each element contains the full dataset already entered. Click on any element to view the time series plot and explore its statistical properties.
Expand All @@ -64,23 +65,27 @@ Each element contains the full dataset already entered. Click on any element to

### Exploring the Time Series Tabs

Click on an element to open it. The main view shows four tabs:
Click on an element to open it. The main view shows four tabs to the left:

1. **Time Series** -- The raw data plotted against time. Look for trend, seasonality, and level shifts.
2. **Seasonality** -- A seasonal subseries plot showing data grouped by month (or other period). Useful for identifying recurring patterns.
3. **ACF** -- Autocorrelation function. Slowly decaying ACF suggests trend or nonstationarity; periodic peaks suggest seasonality.
4. **PACF** -- Partial autocorrelation function. Helps identify AR order -- significant spikes at lags 1 through *p* suggest an AR(*p*) model.

![Time series plot of Airline Passengers showing upward trend with growing seasonal amplitude](../images/manual-entry-airline-ts-plot.png)

*Figure 2: Airline Passengers time series showing multiplicative seasonal pattern*

![ACF plot of Airline Passengers showing slowly decaying autocorrelation with seasonal peaks](../images/manual-entry-airline-acf.png)

*Figure 3: ACF of Airline Passengers -- periodic peaks at lags 12, 24, 36 indicate seasonality*

![Time series plot of Nile River Flows showing level shift around 1898](../images/manual-entry-nile-ts-plot.png)

*Figure 4: Nile River annual flows with visible level shift*

![Time series plot of Mauna Loa CO2 showing upward trend with seasonal cycle](../images/manual-entry-co2-ts-plot.png)

*Figure 5: Mauna Loa CO2 with accelerating trend and annual seasonal cycle*

### Viewing the Properties Panel
Expand All @@ -93,6 +98,7 @@ Open the Properties panel (click **Properties** in the toolbar or press **F4**)
- **Start Date** -- The date of the first observation

![Properties panel showing Entry Method = Manual, Time Interval = One Month, and Unit Label for Airline Passengers](../images/manual-entry-properties.png)

*Figure 6: Properties panel for a manually entered time series*

## Creating Your Own Manual Entry Element
Expand All @@ -102,7 +108,7 @@ To enter a new time series manually from a CSV file:
### 1. Create the Element

1. Right-click **Time Series Data** in the Project Explorer
2. Select **Create New**
2. Select **New Time Series**
3. Enter a descriptive name for the element

### 2. Configure the Properties
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Loading