crepuscularEdit: Edit crepuscular segments

In slisovski/TwGeos: Basic data processing for light-level geolocation archival tags

Edit crepuscular segments

Description

Interactively edit crepuscular intervals

Usage

crepuscularEdit(tagdata, twilights, offset = 0, extend = 6,
  threshold = NULL, lmax = 64, zlim = c(0, lmax), point.cex = 0.5,
  width = 12, height = 4, palette = defaultPalette[c(5, 2, 9, 3, 4, 1,
  1)])

Arguments

tagdata	a dataframe with columns Date and Light that are the sequence of sample times (as POSIXct) and light levels recorded by the tag.
twilights	dataframe of twilight times as generated by findCrepuscular.
offset	the starting hour for the vertical axes.
extend	the period (in hours) before and after twilight for which the light profile should be plotted.
threshold	the light threshold that defines twilight.
lmax	the maximum light level to plot.
zlim	the range of light levels to plot in images.
point.cex	expansion factor for plot points.
width	width of the interface windows.
height	height of the interface windows.
palette	a colour palette of 8 colours.

Details

Interactively edit the crepuscular intervals based on the light profile. A plot of the estimated sunrise and sunset intervals is displayed, and the user can select the twilight to be edited with a left mouse click.

The light profile for the selected twilight is shown in a separate window, and the selected segments of the light profile are highlighted. The corresponding light profiles from the preceeding and following days are also shown for reference.

The user may select a new candidate interval by clicking and dragging with the left mouse button. Individual points may be selected or deselected with the right mouse button.

Note however, no actual change to the selection is made until the candidate edits are accepted depressing the 'a' key.

Each twilight may be marked with the an integer 0 to 9 with the numeric keys. By default each day is given the mark 0.

In either window

'q'	Quits, returning the dataframe of edited twilight segments
'a'	Accepts the candidate edit
'r'	Resets the selection
'i'	Toggles the display of the light image
'p'	Toggles the display of individual points
'l'	Toggles the display of surrounding profiles
'+'/'-'	Zoom in or out
'Left arrow'	Jump to previous twilight
'Right arrow'	Jump to next twilight
'0'-'9'	Mark this twilight

Value

the dataframe of edited twilights, with columns

Twilight	edited times of twilight
Rise	logical indicating sunrise
Start	date of first observation in the crepuscular segment
End	date of last observation in the crepuscular segment

See Also

preprocessLight

slisovski/TwGeos documentation built on Jan. 27, 2024, 10:43 a.m.