From 59f62b6818c8747753790be4e9e9fb0066a1c6d1 Mon Sep 17 00:00:00 2001
From: Johannes Zauner <112665672+JZauner@users.noreply.github.com>
Date: Mon, 16 Mar 2026 17:08:09 +0100
Subject: [PATCH 1/3] Increment version number to 0.10.2
---
DESCRIPTION | 2 +-
NEWS.md | 4 ++++
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/DESCRIPTION b/DESCRIPTION
index 30c5d1a..57a5e0d 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,6 +1,6 @@
Package: LightLogR
Title: Process Data from Wearable Light Loggers and Optical Radiation Dosimeters
-Version: 0.10.1
+Version: 0.10.2
Authors@R: c(
person("Johannes", "Zauner",
email = "johannes.zauner@tum.de", role = c("aut", "cre"),
diff --git a/NEWS.md b/NEWS.md
index ec10345..de58f8d 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,3 +1,7 @@
+# LightLogR 0.10.2
+
+* `add_states()` no longer creates duplicate observations at identical start/endpoints. The default behavior is now that the `start` is inclusive and `end` is exclusive. Adjust the new `bounds` argument for more options.
+
# LightLogR 0.10.1
* `extract_metric()` give more helpful error messages when using a base dataset without start/end columns.
From 3261d2fbf325ac1437766154955212f23862c01d Mon Sep 17 00:00:00 2001
From: Johannes Zauner <112665672+JZauner@users.noreply.github.com>
Date: Mon, 16 Mar 2026 17:15:24 +0100
Subject: [PATCH 2/3] update add_states
---
R/add_states.R | 15 +++++++++++++--
man/add_states.Rd | 6 ++++++
man/import_Dataset.Rd | 2 --
tests/testthat/test-extract_states.R | 4 ++--
4 files changed, 21 insertions(+), 6 deletions(-)
diff --git a/R/add_states.R b/R/add_states.R
index 6a171aa..b3308e2 100644
--- a/R/add_states.R
+++ b/R/add_states.R
@@ -36,6 +36,10 @@
#' will be forced to the same time zone as the `dataset` using
#' [lubridate::force_tz()]. If `FALSE` (default), the start and end times of
#' the `States.dataset` will be used as is.
+#' @param bounds How to treat the edge case, when a state start or endpoint
+#' falls onto a data point. See [dplyr::join_by()] for details on the bounds
+#' argument (Join types > Overlap joins > between). Basically `[` or `]`
+#' signal an inclusive joint, whereas `(` or `)` signal exclusivity.
#'
#' @returns a modified `dataset` with the states added. The states are added as
#' new columns to the `dataset`. The columns are named after the columns in
@@ -65,6 +69,7 @@ add_states <- function(dataset,
start.colname = start,
end.colname = end,
force.tz = FALSE,
+ bounds = c("[)", "[]", "(]", "()"),
leave.out = c("duration", "epoch")
){
# Initial Checks ----------------------------------------------------------
@@ -75,6 +80,8 @@ add_states <- function(dataset,
"States.dataset is not a dataframe" = is.data.frame(States.dataset)
)
+ bounds <- rlang::arg_match(bounds)
+
# Check if Datetime.colname is part of the dataset
Datetime.colname.defused <- colname.defused({{ Datetime.colname }})
if (!Datetime.colname.defused %in% names(dataset)) {
@@ -171,8 +178,12 @@ add_states <- function(dataset,
by =
dplyr::join_by(
!!!groups,
- {{ Datetime.colname }} >= {{ start.colname}},
- {{ Datetime.colname }} <= {{ end.colname }}
+ dplyr::between({{ Datetime.colname }},
+ {{ start.colname}},
+ {{ end.colname }},
+ bounds = !!bounds)
+ # {{ Datetime.colname }} >= {{ start.colname}},
+ # {{ Datetime.colname }} <= {{ end.colname }}
)
) |>
dplyr::select(-{{ start.colname}}, -{{ end.colname }})
diff --git a/man/add_states.Rd b/man/add_states.Rd
index 89741bf..370a9ed 100644
--- a/man/add_states.Rd
+++ b/man/add_states.Rd
@@ -11,6 +11,7 @@ add_states(
start.colname = start,
end.colname = end,
force.tz = FALSE,
+ bounds = c("[)", "[]", "(]", "()"),
leave.out = c("duration", "epoch")
)
}
@@ -35,6 +36,11 @@ will be forced to the same time zone as the \code{dataset} using
\code{\link[lubridate:force_tz]{lubridate::force_tz()}}. If \code{FALSE} (default), the start and end times of
the \code{States.dataset} will be used as is.}
+\item{bounds}{How to treat the edge case, when a state start or endpoint
+falls onto a data point. See \code{\link[dplyr:join_by]{dplyr::join_by()}} for details on the bounds
+argument (Join types > Overlap joins > between). Basically \code{[} or \verb{]}
+signal an inclusive joint, whereas \code{(} or \verb{)} signal exclusivity.}
+
\item{leave.out}{A character vector of columns that should not be carried
over to the \code{dataset}}
}
diff --git a/man/import_Dataset.Rd b/man/import_Dataset.Rd
index b3a23e0..d320f1a 100644
--- a/man/import_Dataset.Rd
+++ b/man/import_Dataset.Rd
@@ -321,7 +321,6 @@ such as the intervals between measurements or the start and end dates.
\if{html}{\out{
}}\preformatted{filepath <- system.file("extdata/205_actlumus_Log_1020_20230904101707532.txt.zip", package = "LightLogR")
dataset <- import_Dataset("ActLumus", filepath, auto.plot = FALSE)
-#> Multiple files in zip: reading '205_actlumus_Log_1020_20230904101707532.txt'
#>
#> Successfully read in 61'016 observations across 1 Ids from 1 ActLumus-file(s).
#> Timezone set is UTC.
@@ -339,7 +338,6 @@ dataset <- import_Dataset("ActLumus", filepath, auto.plot = FALSE)
Import functions can also be called directly:
\if{html}{\out{
}}\preformatted{dataset <- import$ActLumus(filepath, auto.plot = FALSE)
-#> Multiple files in zip: reading '205_actlumus_Log_1020_20230904101707532.txt'
#>
#> Successfully read in 61'016 observations across 1 Ids from 1 ActLumus-file(s).
#> Timezone set is UTC.
diff --git a/tests/testthat/test-extract_states.R b/tests/testthat/test-extract_states.R
index 5b3d975..dfbee06 100644
--- a/tests/testthat/test-extract_states.R
+++ b/tests/testthat/test-extract_states.R
@@ -195,7 +195,7 @@ test_that("add_states basic functionality", {
Intensity = c(5, 3)
) # No group needed if main has only one group that matches
- result <- add_states(main_data, states_data, Datetime.colname = Timestamp)
+ result <- add_states(main_data, states_data, Datetime.colname = Timestamp, bounds = "[]")
expect_s3_class(result, "tbl_df")
expect_equal(nrow(result), 4) # Same as main_data
@@ -226,7 +226,7 @@ test_that("add_states with multiple groups and NAs for non-matching times", {
StateInfo = c("StateA_Mid", "StateB_Start")
) %>% dplyr::group_by(Id) # Match grouping
- result <- add_states(main_data, states_data)
+ result <- add_states(main_data, states_data, bounds = "[]")
# For Id A: Datetime 0,1,2. State defined for 1h.
# For Id B: Datetime 0,1,2. State defined for 0h.
expect_equal(result$StateInfo[result$Id == "A"], c(NA, "StateA_Mid", NA))
From 8015f2b53c01d1cd76e7cbbdf551317e0a80e92e Mon Sep 17 00:00:00 2001
From: Johannes Zauner <112665672+JZauner@users.noreply.github.com>
Date: Fri, 27 Mar 2026 09:44:47 +0100
Subject: [PATCH 3/3] updated course flyer
---
.../pdf/Online_course_series_2025-26.pdf | Bin 4446643 -> 2186982 bytes
vignettes/articles/images/Day.png | Bin 565628 -> 565573 bytes
2 files changed, 0 insertions(+), 0 deletions(-)
diff --git a/pkgdown/assets/pdf/Online_course_series_2025-26.pdf b/pkgdown/assets/pdf/Online_course_series_2025-26.pdf
index 8b4bbb94900d43b544b2b37d607a416c26d03341..5d2c59bfef499c21e68014f578be982d02a995b0 100644
GIT binary patch
delta 1807083
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