Skip to content

Commit

Permalink
doc
Browse files Browse the repository at this point in the history
  • Loading branch information
ericward-noaa committed Feb 27, 2024
1 parent 9f8e792 commit 232e30e
Show file tree
Hide file tree
Showing 35 changed files with 173 additions and 107 deletions.
13 changes: 13 additions & 0 deletions .github/workflows/secretScan.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
name: gitleaks

on: [push, pull_request]

jobs:
gitleaks:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
fetch-depth: '0'
- name: gitleaks-action
uses: gitleaks/[email protected]
4 changes: 2 additions & 2 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Description: The 'salmix' package fits time-varying density curves to run
adult Pacific salmon, though could also be applied to other kinds
of data such as hydrographs, plant phenology (flowering, leaf out).
License: GPL (>=3)
URL: https://ericward-noaa.github.io/phenomix, https://github.com/ericward-noaa/phenomix
URL: https://noaa-nwfsc.github.io/phenomix, https://github.com/noaa-nwfsc/phenomix
Depends:
R (>= 4.0.0)
Imports:
Expand All @@ -42,5 +42,5 @@ ByteCompile: true
Encoding: UTF-8
LazyData: true
Roxygen: list(markdown = TRUE)
RoxygenNote: 7.2.3
RoxygenNote: 7.3.1
SystemRequirements: GNU make
8 changes: 4 additions & 4 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -17,16 +17,16 @@ knitr::opts_chunk$set(
# phenomix
R package for fitting distributions to run timing data via maximum likelihood

[![R build status](https://github.com/ericward-noaa/phenomix/workflows/R-CMD-check/badge.svg)](https://github.com/ericward-noaa/phenomix/actions)
[![R build status](https://github.com/noaa-nwfsc/phenomix/workflows/R-CMD-check/badge.svg)](https://github.com/noaa-nwfsc/phenomix/actions)

pkgdown site: [https://ericward-noaa.github.io/phenomix/](https://ericward-noaa.github.io/phenomix/)
pkgdown site: [https://noaa-nwfsc.github.io/phenomix/](https://noaa-nwfsc.github.io/phenomix/)

## Installation

You can install phenomix with:

```{r, eval=TRUE}
remotes::install_github("ericward-noaa/phenomix",build_vignettes = TRUE)
remotes::install_github("noaa-nwfsc/phenomix",build_vignettes = TRUE)
```

Load libraries
Expand Down Expand Up @@ -68,7 +68,7 @@ ggplot(df, aes(doy,exp(y),col=year,group=year)) +

## Examples

The main functions are `create_data()` and `fit()`. See `?create_data` and `?fit` for additional details and examples. A vignette includes additional detail, and examples of several models as well as function arguments available [https://ericward-noaa.github.io/phenomix/](https://ericward-noaa.github.io/phenomix/).
The main functions are `create_data()` and `fit()`. See `?create_data` and `?fit` for additional details and examples. A vignette includes additional detail, and examples of several models as well as function arguments available [https://noaa-nwfsc.github.io/phenomix/](https://noaa-nwfsc.github.io/phenomix/).

## References

Expand Down
39 changes: 29 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,52 +7,71 @@ R package for fitting distributions to run timing data via maximum
likelihood

[![R build
status](https://github.com/ericward-noaa/phenomix/workflows/R-CMD-check/badge.svg)](https://github.com/ericward-noaa/phenomix/actions)
status](https://github.com/noaa-nwfsc/phenomix/workflows/R-CMD-check/badge.svg)](https://github.com/noaa-nwfsc/phenomix/actions)

[![DOI](https://zenodo.org/badge/243336401.svg)](https://zenodo.org/badge/latestdoi/243336401)
pkgdown site: <https://ericward-noaa.github.io/phenomix/>
pkgdown site: <https://noaa-nwfsc.github.io/phenomix/>

## Installation

You can install phenomix with:

``` r
remotes::install_github("ericward-noaa/phenomix",build_vignettes = TRUE)
remotes::install_github("noaa-nwfsc/phenomix",build_vignettes = TRUE)
#> Downloading GitHub repo noaa-nwfsc/phenomix@HEAD
#>
#> ── R CMD build ─────────────────────────────────────────────────────────────────
#> checking for file ‘/private/var/folders/ts/4x6hzmfx7d52vbhjqmrs_3pw0000gp/T/RtmpmdCE3X/remotes13c339d5e769/noaa-nwfsc-phenomix-9f8e792/DESCRIPTION’ ... ✔ checking for file ‘/private/var/folders/ts/4x6hzmfx7d52vbhjqmrs_3pw0000gp/T/RtmpmdCE3X/remotes13c339d5e769/noaa-nwfsc-phenomix-9f8e792/DESCRIPTION’
#> ─ preparing ‘phenomix’:
#> checking DESCRIPTION meta-information ... ✔ checking DESCRIPTION meta-information
#> ─ cleaning src
#> ─ installing the package to build vignettes
#> creating vignettes ... ✔ creating vignettes (1m 39.8s)
#> ─ cleaning src
#> ─ checking for LF line-endings in source and make files and shell scripts
#> ─ checking for empty or unneeded directories
#> ─ building ‘phenomix_1.0.4.tar.gz’
#>
#>
```

Load libraries

``` r
library(phenomix)
library(ggplot2)
#> Warning: package 'ggplot2' was built under R version 4.3.2
```

## Functions

The package phenomix provides a suite of curve fitting to describe data
The package pheomix provides a suite of curve fitting to describe data
that may be generated from a process when distributions in time might be
concentrated (from fisheries, this occurs with counts over time of
salmon returning from the ocean to spawn or juvenile fish emigrating
from streams to the ocean).

![Predicted (black line) and observed counts (red dots) for hypothetical
dataset. Multiple observations may exist for some days, or no
observations on others.](README-figs/unnamed-chunk-5-1.png)
<figure>
<img src="README-figs/unnamed-chunk-5-1.png"
alt="Predicted (black line) and observed counts (red dots) for hypothetical dataset. Multiple observations may exist for some days, or no observations on others." />
<figcaption aria-hidden="true">Predicted (black line) and observed
counts (red dots) for hypothetical dataset. Multiple observations may
exist for some days, or no observations on others.</figcaption>
</figure>

In a given year, the curve might be described by a symmetric or
asymmetric Gaussian or Student-t distribution (shown here in log-scale
on the y-axis). Questions of interest might be - are the means (x-axis)
shifting through time? - are the variances shifting through time? - does
the model support a symmetric or asymmetric distribution?

![](man/figures/unnamed-chunk-6-1.png)<!-- -->
![](README-figs/unnamed-chunk-6-1.png)<!-- -->

## Examples

The main functions are `create_data()` and `fit()`. See `?create_data`
and `?fit` for additional details and examples. A vignette includes
additional detail, and examples of several models as well as function
arguments available <https://ericward-noaa.github.io/phenomix/>.
arguments available <https://noaa-nwfsc.github.io/phenomix/>.

## References

Expand Down
2 changes: 1 addition & 1 deletion docs/404.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 5 additions & 8 deletions docs/articles/a1_examples.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Binary file modified docs/articles/a1_examples_files/figure-html/unnamed-chunk-14-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/articles/a1_examples_files/figure-html/unnamed-chunk-16-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 5 additions & 8 deletions docs/articles/a2_covariates.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 5 additions & 8 deletions docs/articles/a3_troubleshooting.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 5 additions & 8 deletions docs/articles/a4_derived.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion docs/articles/index.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 232e30e

Please sign in to comment.