From 0a34aff37097d23b1e80522f42fc00066a0a1b97 Mon Sep 17 00:00:00 2001 From: July Pilowsky Date: Mon, 23 Sep 2024 10:35:32 -0400 Subject: [PATCH] Update README --- CRAN-SUBMISSION | 6 +-- README.Rmd | 13 +++++- README.md | 67 +++++++++++++++++++------------ man/figures/README-example-2.png | Bin 31463 -> 31463 bytes 4 files changed, 57 insertions(+), 29 deletions(-) diff --git a/CRAN-SUBMISSION b/CRAN-SUBMISSION index 2c662d9..0ee4bc6 100644 --- a/CRAN-SUBMISSION +++ b/CRAN-SUBMISSION @@ -1,3 +1,3 @@ -Version: 1.3.0 -Date: 2024-04-11 17:53:24 UTC -SHA: e0de3245e3f28c28c53d86beb987e03ca1a19f4a +Version: 1.3.1 +Date: 2024-09-19 16:57:12 UTC +SHA: e1ec880c397dcaaffc861be9dfe2996f1e3741c9 diff --git a/README.Rmd b/README.Rmd index b22e7d9..3bfb6d4 100644 --- a/README.Rmd +++ b/README.Rmd @@ -57,12 +57,23 @@ model simulators by utilizing its extendable (inheritable) base classes. ## Installation -You can install poems from [GitHub](https://github.com/) using: +You can install poems from the CRAN repository: + +``` r +install.packages("poems") +``` + +Or you can install the development version of poems from [GitHub](https://github.com/) using: ``` r # install.packages("devtools") remotes::install_github("GlobalEcologyLab/poems") ``` + +## The poemsverse + +`poems` can do spatial population models on its own, but it also provides the engine behind two extension packages: [paleopop](https://github.com/GlobalEcologyLab/paleopop) and [epizootic](https://github.com/viralemergence/epizootic). `paleopop` is an extension for simulating populations over very long timescales, and `epizootic` is an extension for simulating disease dynamics in wild populations. + ## Example The following simple example demonstrates how to run a single spatially explicit diff --git a/README.md b/README.md index 1d75b90..f564fc2 100644 --- a/README.md +++ b/README.md @@ -56,13 +56,30 @@ base classes. ## Installation -You can install poems from [GitHub](https://github.com/) using: +You can install poems from the CRAN repository: + +``` r +install.packages("poems") +``` + +Or you can install the development version of poems from +[GitHub](https://github.com/) using: ``` r # install.packages("devtools") remotes::install_github("GlobalEcologyLab/poems") ``` +## The poemsverse + +`poems` can do spatial population models on its own, but it also +provides the engine behind two extension packages: +[paleopop](https://github.com/GlobalEcologyLab/paleopop) and +[epizootic](https://github.com/viralemergence/epizootic). `paleopop` is +an extension for simulating populations over very long timescales, and +`epizootic` is an extension for simulating disease dynamics in wild +populations. + ## Example The following simple example demonstrates how to run a single spatially @@ -111,47 +128,47 @@ results <- population_simulator(pop_model) results # examine #> $all #> $all$abundance -#> [1] 977 1090 1238 1256 1341 +#> [1] 1010 1077 1229 1288 1405 #> #> $all$abundance_stages #> $all$abundance_stages[[1]] -#> [1] 574 643 755 731 847 +#> [1] 604 615 761 744 841 #> #> $all$abundance_stages[[2]] -#> [1] 403 447 483 525 494 +#> [1] 406 462 468 544 564 #> #> #> #> $abundance #> [,1] [,2] [,3] [,4] [,5] -#> [1,] 59 134 157 147 173 -#> [2,] 90 102 157 169 197 -#> [3,] 133 156 192 202 191 -#> [4,] 168 149 154 180 168 -#> [5,] 163 180 178 193 192 -#> [6,] 171 181 192 189 219 -#> [7,] 193 188 208 176 201 +#> [1,] 50 91 143 174 204 +#> [2,] 91 139 167 190 204 +#> [3,] 126 136 162 201 196 +#> [4,] 161 159 175 195 193 +#> [5,] 185 181 182 170 202 +#> [6,] 195 189 195 174 198 +#> [7,] 202 182 205 184 208 #> #> $abundance_stages #> $abundance_stages[[1]] #> [,1] [,2] [,3] [,4] [,5] -#> [1,] 28 76 100 83 108 -#> [2,] 55 56 103 94 133 -#> [3,] 83 91 108 121 115 -#> [4,] 101 96 82 129 86 -#> [5,] 95 109 113 102 141 -#> [6,] 103 105 115 93 132 -#> [7,] 109 110 134 109 132 +#> [1,] 33 54 90 107 134 +#> [2,] 56 83 100 113 126 +#> [3,] 64 79 98 111 103 +#> [4,] 102 82 110 115 114 +#> [5,] 100 113 109 103 118 +#> [6,] 125 107 118 88 126 +#> [7,] 124 97 136 107 120 #> #> $abundance_stages[[2]] #> [,1] [,2] [,3] [,4] [,5] -#> [1,] 31 58 57 64 65 -#> [2,] 35 46 54 75 64 -#> [3,] 50 65 84 81 76 -#> [4,] 67 53 72 51 82 -#> [5,] 68 71 65 91 51 -#> [6,] 68 76 77 96 87 -#> [7,] 84 78 74 67 69 +#> [1,] 17 37 53 67 70 +#> [2,] 35 56 67 77 78 +#> [3,] 62 57 64 90 93 +#> [4,] 59 77 65 80 79 +#> [5,] 85 68 73 67 84 +#> [6,] 70 82 77 86 72 +#> [7,] 78 85 69 77 88 raster::plot(region$raster_from_values(results$abundance[, 5]), main = "Final abundance", xlab = "Longitude (degrees)", ylab = "Latitude (degrees)", zlim = c(0, 300), colNA = "blue" diff --git a/man/figures/README-example-2.png b/man/figures/README-example-2.png index 274f76c4433f8af4cf785cd1e19c1dae5dfc4138..e33636c7b7f120085db5c960281ba488749e312b 100644 GIT binary patch delta 25458 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