Estimate scale the scale range

Provides a rough estimate on the light loss and corresponding range of scale values to consider during optimization. The full A percentile parameter can be provided to remove outliers. It is recommended to first use `st_screen_twl()` to remove poor quality days.

stk_calibrate(df, percentile = 100, floor = 1.5, verbose = TRUE)

Arguments

df

a skytrackr dataframe

percentile

percentile of the spread of data to use in scale value evaluation (default = 100, the full range of values is considered)

floor

threshold to remove low (nighttime) values

verbose

Give detailed feedback (TRUE or FALSE, default = TRUE)

Value

An estimated range of scale values to be used in optimization. Values are not log transformed.

Examples

# Estimate the upper scale value for fitting routine
upper_scale_value <- cc876 |> stk_calibrate()
#> 
#> ══ Estimating suggested scale range ══════════════════════════ skytrackr v1.1 ══
#> 
#> → The suggested scale range is c(1,24)!
#> ℹ Note, these estimates are approximations! Always inspect your data (e.g. by
#>   using stk_filter()) and consider using the stk_screen_twl() to remove days
#>   with poor twilight and other characteristics.
#> ℹ Scale range values are not log transformed. You will need to take the log()
#>   of the scale range for use in skytrackr()