Skip to content

Commit 92c650f

Browse files
authored
removed n cores from readme, let people find that on their own if they want to get into the nitty gritty (#46)
1 parent 080fa14 commit 92c650f

1 file changed

Lines changed: 39 additions & 40 deletions

File tree

README.md

Lines changed: 39 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ See [`NEWS.md`](NEWS.md) for a history of user-facing changes across versions.
1414

1515
### For users
1616

17-
``` r
17+
```r
1818
# Install from GitHub using remotes
1919
install.packages("remotes")
2020
remotes::install_github("USACE-RMC/rfaR", build_vignettes = FALSE)
@@ -28,7 +28,7 @@ devtools::install_github("USACE-RMC/rfaR")
2828

2929
If you plan to modify the package source, clone the repository and use `devtools`:
3030

31-
``` r
31+
```r
3232
# After cloning the repo to disk (e.g., via git clone or GitHub Desktop):
3333
# - Open an R session in the repo root (or an RStudio project at the repo root)
3434

@@ -43,49 +43,49 @@ devtools::install()
4343
4444
## Example Data
4545

46-
The package includes example data from a hypothetical dam, John McGraw Dam (JMD, variables as "jmd_"):
46+
The package includes example data from a hypothetical dam, John McGraw Dam (JMD, variables as "jmd\_"):
4747

4848
#### Reservoir Model
4949

50-
- `jmd_resmodel` - Elevation-storage-discharge relationship
50+
- `jmd_resmodel` - Elevation-storage-discharge relationship
5151

5252
#### Stage & Inflow Records
5353

54-
- `jmd_wy1980_stage` - Daily reservoir stage (WY 1980–2024)
55-
- `jmd_por_inflow` - Daily inflow for the full period of record
54+
- `jmd_wy1980_stage` - Daily reservoir stage (WY 1980–2024)
55+
- `jmd_por_inflow` - Daily inflow for the full period of record
5656

5757
#### Flood Frequency
5858

59-
- `jmd_bf_parameter_sets` - 10,000 LP3 parameter sets from RMC-BestFit 2.0
60-
- `jmd_seasonality` - Flood seasonality analysis results
59+
- `jmd_bf_parameter_sets` - 10,000 LP3 parameter sets from RMC-BestFit 2.0
60+
- `jmd_seasonality` - Flood seasonality analysis results
6161

6262
#### Inflow Hydrographs
6363

64-
- `jmd_hydro_pmf` - Probable Maximum Flood (PMF)
65-
- `jmd_hydro_sdf` - Spillway Design Flood (SDF)
66-
- `jmd_hydro_jun1965` - June 1965 flood event
67-
- `jmd_hydro_jun1965_15min` - June 1965 flood event (15-minute intervals)
68-
- `jmd_hydro_may1955` - May 1955 flood event
69-
- `jmd_hydro_apr1999` - April 1999 flood event
70-
- `jmd_hydro_jun1921` - June 1921 flood event
64+
- `jmd_hydro_pmf` - Probable Maximum Flood (PMF)
65+
- `jmd_hydro_sdf` - Spillway Design Flood (SDF)
66+
- `jmd_hydro_jun1965` - June 1965 flood event
67+
- `jmd_hydro_jun1965_15min` - June 1965 flood event (15-minute intervals)
68+
- `jmd_hydro_may1955` - May 1955 flood event
69+
- `jmd_hydro_apr1999` - April 1999 flood event
70+
- `jmd_hydro_jun1921` - June 1921 flood event
7171

7272
#### Empirical & Benchmark Results
7373

74-
- `jmd_empirical_stage_wy1980_pt` - Observed stage-frequency with perception threshold
75-
- `jmd_rfa_expected` - RMC-RFA expected stage-frequency curve
76-
- `jmd_rfa_full` - RMC-RFA full uncertainty benchmark curve
74+
- `jmd_empirical_stage_wy1980_pt` - Observed stage-frequency with perception threshold
75+
- `jmd_rfa_expected` - RMC-RFA expected stage-frequency curve
76+
- `jmd_rfa_full` - RMC-RFA full uncertainty benchmark curve
7777

7878
#### Methodology Illustration
7979

80-
- `example_stratified` - Stratified sampling example across Uniform, Normal, and EV1 distributions
80+
- `example_stratified` - Stratified sampling example across Uniform, Normal, and EV1 distributions
8181

8282
## Quick Start
8383

84-
``` r
84+
```r
8585
# Load the package
8686
library(rfaR)
8787

88-
# Example stage timeseries data
88+
# Example stage timeseries data
8989
head(jmd_wy1980_stage)
9090

9191
# Example BestFit LP3 parameter sets (10,000 sets)
@@ -107,15 +107,15 @@ jmd_hydrographs <- hydrograph_setup(jmd_hydro_pmf,
107107
jmd_hydro_jun1921,
108108
critical_duration = 2,
109109
routing_days = 10)
110-
111-
# Expected Only
110+
111+
# Expected Only
112112
jmd_expected <- rfa_simulate(sim_type = "expected",
113113
bestfit_params = jmd_bf_parameter_sets,
114114
stage_ts = jmd_wy1980_stage,
115115
seasonality = jmd_seasonality$relative_frequency,
116116
hydrographs = jmd_hydrographs,
117117
resmodel = jmd_resmodel,
118-
Nbins = 50,
118+
Nbins = 50,
119119
events_per_bin = 200,
120120
sim_name = "jmd")
121121

@@ -126,11 +126,10 @@ jmd_fulluncert <- rfa_simulate(sim_type = "full",
126126
seasonality = jmd_seasonality$relative_frequency,
127127
hydrographs = jmd_hydrographs,
128128
resmodel = jmd_resmodel,
129-
Nbins = 50,
129+
Nbins = 50,
130130
events_per_bin = 200,
131-
sim_name = "jmd",
132-
Ncores = 26)
133-
131+
sim_name = "jmd")
132+
134133
```
135134

136135
## Quick Start Results
@@ -144,7 +143,7 @@ print(jmd_expected$stage_frequency)
144143

145144
<summary>Plotting Results</summary>
146145

147-
``` r
146+
```r
148147
# ggplot is contained in tidyverse
149148
library(tidyverse)
150149
# or
@@ -239,30 +238,30 @@ See both files for the complete terms.
239238

240239
#### RMC-RFA Methodology
241240

242-
- Smith, C. H. (2020). *RMC-RFA User's Guide* (v1.1). U.S. Army Corps of Engineers, Risk Management Center, Lakewood, CO.
241+
- Smith, C. H. (2020). _RMC-RFA User's Guide_ (v1.1). U.S. Army Corps of Engineers, Risk Management Center, Lakewood, CO.
243242

244243
#### Flood Frequency Analysis
245244

246-
- England, J. F., Cohn, T. A., Faber, B. A., Stedinger, J. R., Thomas, W. O., Veilleux, A. G., Kiang, J. E., & Mason, R. R. (2019). *Guidelines for Determining Flood Flow Frequency — Bulletin 17C* (Techniques and Methods 4–B5). U.S. Geological Survey. <https://doi.org/10.3133/tm4B5>
245+
- England, J. F., Cohn, T. A., Faber, B. A., Stedinger, J. R., Thomas, W. O., Veilleux, A. G., Kiang, J. E., & Mason, R. R. (2019). _Guidelines for Determining Flood Flow Frequency — Bulletin 17C_ (Techniques and Methods 4–B5). U.S. Geological Survey. <https://doi.org/10.3133/tm4B5>
247246

248247
#### Flood Routing
249248

250-
- U.S. Army Corps of Engineers, Hydrologic Engineering Center. (n.d.). Modified Puls Model. *HEC-HMS Technical Reference Manual*. <https://www.hec.usace.army.mil/confluence/hmsdocs/hmstrm/channel-flow/modified-puls-model>
249+
- U.S. Army Corps of Engineers, Hydrologic Engineering Center. (n.d.). Modified Puls Model. _HEC-HMS Technical Reference Manual_. <https://www.hec.usace.army.mil/confluence/hmsdocs/hmstrm/channel-flow/modified-puls-model>
251250

252251
#### Statistical Foundations
253252

254-
- Chow, V. T. (1954). The log-probability law and its engineering applications. *Proceedings of the ASCE*, 80, 1–25.
255-
- Efron, B. (1979). Bootstrap methods: another look at the jackknife. *The Annals of Statistics*, 7, 1–26.
256-
- Efron, B., & Tibshirani, R. J. (1998). *An Introduction to the Bootstrap*. CRC Press.
257-
- Nathan, R., et al. (2016). Estimating the exceedance probability of extreme rainfalls up to the probable maximum precipitation. *Journal of Hydrology*.
258-
- Nathan, R., & Weinmann, E. (2013). *Monte Carlo Simulation Techniques*. Australian Rainfall and Runoff Discussion Paper. Engineers Australia.
259-
- Vose, D. (2008). *Risk Analysis: A Quantitative Guide*. John Wiley & Sons, West Sussex, England.
253+
- Chow, V. T. (1954). The log-probability law and its engineering applications. _Proceedings of the ASCE_, 80, 1–25.
254+
- Efron, B. (1979). Bootstrap methods: another look at the jackknife. _The Annals of Statistics_, 7, 1–26.
255+
- Efron, B., & Tibshirani, R. J. (1998). _An Introduction to the Bootstrap_. CRC Press.
256+
- Nathan, R., et al. (2016). Estimating the exceedance probability of extreme rainfalls up to the probable maximum precipitation. _Journal of Hydrology_.
257+
- Nathan, R., & Weinmann, E. (2013). _Monte Carlo Simulation Techniques_. Australian Rainfall and Runoff Discussion Paper. Engineers Australia.
258+
- Vose, D. (2008). _Risk Analysis: A Quantitative Guide_. John Wiley & Sons, West Sussex, England.
260259

261260
<details>
262261

263262
<summary>Development References</summary>
264263

265-
- Wickham, H., & Bryan, J. (2023). *R Packages* (2nd ed.). O'Reilly. <https://r-pkgs.org/>
266-
- Wickham, H. (2019). *Advanced R* (2nd ed.). CRC Press. <https://adv-r.hadley.nz/>
264+
- Wickham, H., & Bryan, J. (2023). _R Packages_ (2nd ed.). O'Reilly. <https://r-pkgs.org/>
265+
- Wickham, H. (2019). _Advanced R_ (2nd ed.). CRC Press. <https://adv-r.hadley.nz/>
267266

268267
</details>

0 commit comments

Comments
 (0)