Changes to the tutorial articles on the website
Integration of a community survey on the website and Github Readme.
bright_dark_period() now maintains the date when
looping the data.
Added articles on Import & Cleaning,
Metrics, and Visualizations to the
website.
Added the option for more print rows of observation intervals
during import.
Added the option to set a length for the dataset starting from
the end in filter_Datetime() and family.
Added the function aggregate_Date() to aggregate
long datasets to one day per group.
New function gg_doubleplot() for … well, double
plots.
added import functions for nanoLambdaand
LightWatcher devices
new Logo!
fixed bug in interval2state() that would dismiss the
first state if it starts before the actual data
fixed a bug in interval2state() that would add other
columns then the State column present in the interval
dataset to the output dataset, but leave them empty. Added an example
that shows how to add multiple columns to the output dataset
correctly.
in aggregate_Datetime(), added the option to set the
dominant.epoch, i.e., the most common interval, as the
unit parameter, to effectively deal with irregular
data.
Added the functions dst_change_summary() and
dst_change_handler() to detect and deal with Daylight
Savings. The functionality is also integrated into the import functions,
so that a user can automatically apply it during the import
process.
Added Steffen Hartmeyer as a collaborator, who
added a number of light metrics from the lightdosimetry
package.
Added the import_adjustment() function for more
flexibility when importing light logger data that does not conform to
the standard format. This goes hand in hand with the
ll_import_expr list that contains specific expressions for
all supported devices.
lots of bug fixes and improvements
Bugfix for LiDo import
Added import support for new devices: LiDo,
DeLux, and Speccy
Removed minor inconsistencies in naming conventions. Also, all imported columns will have syntactic naming now
Added an option to all gap functions, to extend the
gapless Datetime range to full days.
Exports the up to now internal function
count_difftime() that is the basis for
dominant_epoch(). But whereas the latter gets only the most
common epoch, count_difftime() returns a table with the
counts of all epochs. This is useful in conjunction with
gap_finder(), to check the distribution of data
intervals.
Added the gg_days() function to visualize multiple
days of data in a single plot. Alongside come two helper functions,
Datetime_limits() and Datetime_breaks(), to
set the limits and breaks of the x-axis.
Added the filter_Datetime_multiple() function to
filter for multiple Datetime ranges depending on certain conditions,
e.g. different filter cutoffs for different participants. It wraps
around filter_Datetime() or
filter_Date().
Reworked the internals of the light logger data import functions.
They now use a more straightforward function factory approach. For users
the only visible change it that device specific functions now have the
form import$device() instead of the old
import.device().
Added the symlog_trans() function from a post on stack overflow.
This function leads to a better visualization of light logger data, as a
logarithmic transformation is necessary, but values of 0 are common. The
function was integrated as a default for gg_day() and will
likely be the basis of upcoming visualization functions.
Added the aggregate_Datetime() function to aggregate
data to a given time interval.
Added the gg_overview() function to get a sense for
the timeframe of measurement data.
Added the family of regularize functions to find and
deal with implicit missing data. These functions include
dominant_epoch(), gapless_Datetimes(),
gap_handler(), and gap_finder().
A ton of updates to documentation, unit tests, and bug fixes.
Added Unit tests and documentation for all new functions.
To filter_Datetime() and filter_Date()
added the option to filter for group specific dates.
Added the family of functions around States and
Reference to import, process, and add states to light
logger data, like sleep/wake times, wear times, or other data. This
family includes import_Statechanges(),
sc2interval(), ìnterval2state(),
data2reference(), sleep_int2Brown(),
Brown_check(), Brown_rec(), and
Brown2reference().
Added the Article/Vignette “What´s in a Day” to demonstrate the LightLogR workflow.
Added the convenience function create_Timedata() to
create a Time-of-Day column in datasets.
Added the family of filter_Datetime(),
filter_Date() and filter_Time() functions to
easily filter datasets.
Added unit tests for the first functions.
Added several helper functions to work with states like sleep or wear times.
Added an automatic ID creation at import and streamlined the
import functions.
Added the function join_datasets to combine imported
datasets with sensible constraints.
gg_day():Added major grid marks for the y-axis.
Added a message when using start or end dates to
make it clear, that only the Date portion of the input will be
used.
Changed the behavior, when there is already a Day.data column present in the data. It will only create a new column if none is present, otherwise it will use the existing column for faceting (after factorization)
Added the option to create an interactive plot by
feeding the plot to the [plotly] package.
NEWS.md file to track changes to the
package.