Prepping for release

Author: gregorgorjanc

README.md

@@ -2,12 +2,13 @@
 
 ## Overview
 
-Tskit enables performant storage, manipulation, and analysis of ancestral
+`Tskit` enables performant storage, manipulation, and analysis of ancestral
 recombination graphs (ARGs) using succinct tree sequence encoding.
 See https://tskit.dev for project news, documentation, and tutorials.
-Tskit provides Python, C, and Rust APIs. The Python API can be called from R
-via the `reticulate` R package to seamlessly load and analyse a tree sequence,
-as described at https://tskit.dev/tutorials/RcppTskit.html.
+`Tskit` provides Python, C, and Rust application programming interfaces (APIs).
+The Python API can be called from R via the `reticulate` R package to
+seamlessly load and analyse a tree sequence, as described at
+https://tskit.dev/tutorials/RcppTskit.html.
 `RcppTskit` provides R access to the `tskit` C API for use cases where the
 `reticulate` option is not optimal. For example, for high-performance and
 low-level work with tree sequences. Currently, `RcppTskit` provides a limited

RcppTskit/.Rbuildignore

@@ -10,6 +10,7 @@
 ^\.covrignore$
 ^\.github$
 ^codecov\.yaml$
+^cran-comments\.md$
 ^inst/examples/create_test\.trees\.R$
 ^inst/examples/create_test\.trees\.py$
 ^notes_pkg_dev\.Rmd$

RcppTskit/DESCRIPTION

@@ -1,18 +1,22 @@
 Type: Package
 Package: RcppTskit
-Title: R access to the tskit C API
+Title: R Access to the Tskit C API
 Version: 0.1.0
-Date: 2026-01-2607
-Authors@R:
-    person("Gregor", "Gorjanc", , "gregor.gorjanc@gmail.com", role = c("aut", "cre"),
-           comment = c(ORCID = "0000-0001-8008-2787"))
-Description: Tskit enables performant storage, manipulation, and analysis
-    of ancestral recombination graphs (ARGs) using succinct tree sequence
-    encoding.  See https://tskit.dev for project news, documentation, and
-    tutorials.  Tskit provides Python, C, and Rust APIs. The Python API
-    can be called from R via the `reticulate` R package to seamlessly load
-    and analyse a tree sequence as described at
-    https://tskit.dev/tutorials/RcppTskit.html. `RcppTskit` provides R
+Date: 2026-01-27
+Authors@R: c(
+    person("Gregor", "Gorjanc", , "gregor.gorjanc@gmail.com", role = c("aut", "cre", "cph"),
+           comment = c(ORCID = "0000-0001-8008-2787")),
+    person("Tskit Developers", role = "cph",
+           comment = "Authors of included tskit C library")
+  )
+Description: `Tskit` enables performant storage, manipulation, and
+    analysis of ancestral recombination graphs (ARGs) using succinct tree
+    sequence encoding. See https://tskit.dev for project news,
+    documentation, and tutorials. `Tskit` provides Python, C, and Rust
+    application programming interfaces (APIs). The Python API can be
+    called from R via the `reticulate` R package to seamlessly load and
+    analyse a tree sequence as described at
+    https://tskit.dev/tutorials/tskitr.html. `RcppTskit` provides R
     access to the `tskit` C API for use cases where the `reticulate`
     option is not optimal. For example, for high-performance and low-level
     work with tree sequences. Currently, `RcppTskit` provides a limited

RcppTskit/LICENSE

@@ -1,2 +1,2 @@
-YEAR: 2025
+YEAR: 2026
 COPYRIGHT HOLDER: Gregor Gorjanc

RcppTskit/LICENSE.note

@@ -0,0 +1,2 @@
+The tskit C library is distributed under the MIT license.
+Full copies of the license are included in `inst/include/tskit/LICENSE` and `src/tskit/LICENSE.

RcppTskit/R/Class-TreeSequence.R

@@ -71,8 +71,8 @@ TreeSequence <- R6Class(
     },
 
     #' @description Alias for \code{\link[=TreeSequence]{TreeSequence$dump}}.
-    #' @param file see
-    #' @param options see
+    #' @param file see \code{\link[=TreeSequence]{TreeSequence$dump}}.
+    #' @param options see \code{\link[=TreeSequence]{TreeSequence$dump}}.
     write = function(file, options = 0L) {
       self$dump(file = file, options = options)
     },
@@ -120,107 +120,137 @@ TreeSequence <- R6Class(
     },
 
     #' @description Get the number of provenances in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_provenances(ts)
+    #' ts$num_provenances()
     num_provenances = function() {
       ts_num_provenances_ptr(self$pointer)
     },
 
     #' @description Get the number of populations in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_populations(ts)
+    #' ts$num_populations()
     num_populations = function() {
       ts_num_populations_ptr(self$pointer)
     },
 
     #' @description Get the number of migrations in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_migrations(ts)
+    #' ts$num_migrations()
     num_migrations = function() {
       ts_num_migrations_ptr(self$pointer)
     },
 
     #' @description Get the number of individuals in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_individuals(ts)
+    #' ts$num_individuals()
     num_individuals = function() {
       ts_num_individuals_ptr(self$pointer)
     },
 
     #' @description Get the number of samples (of nodes) in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_samples(ts)
+    #' ts$num_samples()
     num_samples = function() {
       ts_num_samples_ptr(self$pointer)
     },
 
     #' @description Get the number of nodes in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_nodes(ts)
+    #' ts$num_nodes()
     num_nodes = function() {
       ts_num_nodes_ptr(self$pointer)
     },
 
     #' @description Get the number of edges in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_edges(ts)
+    #' ts$num_edges()
     num_edges = function() {
       ts_num_edges_ptr(self$pointer)
     },
 
     #' @description Get the number of trees in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_trees(ts)
+    #' ts$num_trees()
     num_trees = function() {
       ts_num_trees_ptr(self$pointer)
     },
 
     #' @description Get the number of sites in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_sites(ts)
+    #' ts$num_sites()
     num_sites = function() {
       ts_num_sites_ptr(self$pointer)
     },
 
     #' @description Get the number of mutations in a tree sequence.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_num_mutations(ts)
+    #' ts$num_mutations()
     num_mutations = function() {
       ts_num_mutations_ptr(self$pointer)
     },
 
     #' @description Get the sequence length.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_sequence_length(ts)
+    #' ts$sequence_length()
     sequence_length = function() {
       ts_sequence_length_ptr(self$pointer)
     },
 
     #' @description Get the time units string.
+    #' @examples
     #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #' ts_time_units(ts)
+    #' ts$time_units()
     time_units = function() {
       ts_time_units_ptr(self$pointer)
     },
 
+    #' @description Get the min time in node table and mutation table.
+    #' @examples
+    #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
+    #' ts <- ts_load(ts_file)
+    #' ts$min_time()
+    min_time = function() {
+      ts_min_time_ptr(self$pointer)
+    },
+
+    #' @description Get the max time in node table and mutation table.
+    #' @examples
+    #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
+    #' ts <- ts_load(ts_file)
+    #' ts$max_time()
+    max_time = function() {
+      ts_max_time_ptr(self$pointer)
+    },
+
     #' @description Get the length of metadata in a tree sequence and its tables.
     #' @return A named list with the length of metadata.
     #' @examples
-    #'ts_file <- system.file("examples/test.trees", package = "RcppTskit")
+    #' ts_file <- system.file("examples/test.trees", package = "RcppTskit")
     #' ts <- ts_load(ts_file)
-    #'ts$metadata_length()
+    #' ts$metadata_length()
     metadata_length = function() {
       ts_metadata_length_ptr(self$pointer)
     }

RcppTskit/R/RcppExports.R

@@ -95,10 +95,6 @@ ts_metadata_length_ptr <- function(ts) {
     .Call(`_RcppTskit_ts_metadata_length_ptr`, ts)
 }
 
-ts_grow <- function(ts) {
-    .Call(`_RcppTskit_ts_grow`, ts)
-}
-
 test_tsk_bug_assert_c <- function() {
     invisible(.Call(`_RcppTskit_test_tsk_bug_assert_c`))
 }

RcppTskit/R/RcppTskit-package.R

@@ -1,12 +1,13 @@
 # Contains the package description and .onLoad() function
 
 #' @description
-#' Tskit enables performant storage, manipulation, and analysis of
+#' `Tskit` enables performant storage, manipulation, and analysis of
 #' ancestral recombination graphs (ARGs) using succinct tree sequence encoding.
 #' See https://tskit.dev for project news, documentation, and tutorials.
-#' Tskit provides Python, C, and Rust APIs. The Python API can be called from R
-#' via the `reticulate` R package to seamlessly load and analyse a tree sequence
-#' as described at https://tskit.dev/tutorials/tskitr.html.
+#' `Tskit` provides Python, C, and Rust application programming interfaces (APIs).
+#' The Python API can be called from R via the `reticulate` R package to
+#' seamlessly load and analyse a tree sequence as described at
+#' https://tskit.dev/tutorials/tskitr.html.
 #' `RcppTskit` provides R access to the `tskit` C API for use cases where the
 #' `reticulate` option is not optimal. For example, for high-performance
 #' and low-level work with tree sequences. Currently, `RcppTskit` provides a

RcppTskit/cran-comments.md

@@ -0,0 +1,5 @@
+## R CMD check results
+
+0 errors | 0 warnings | 1 note
+
+* This is a new release.