Submitting Author Name: Daniel Vartanian
Submitting Author Github Handle: @danielvartan
Repository: https://github.com/danielvartan/logolink
Version submitted: 1.0.0
Submission type: Standard
Editor: @jhollist
Reviewers: @jmaspons, @bitbacchus

Due date for @bitbacchus: 2026-03-20
Archive: TBD
Version accepted: TBD
Language: en

• Paste the full DESCRIPTION file inside a code block below:

Package: logolink
Title: An Interface for Running 'NetLogo' Simulations
Version: 1.0.0
Authors@R: c(
        person(
            given = "Daniel",
            family = "Vartanian",
            role = c("aut", "cre", "ccp", "cph"),
            email = "danielvartan@proton.me",
            comment = c(ORCID = "0000-0001-7782-759X")
        )
    )
Description: An interface for 'NetLogo' <https://www.netlogo.org> that enables
    programmatic setup and execution of simulations. Designed to facilitate
    integrating 'NetLogo' models into reproducible workflows by creating and
    running 'BehaviorSpace' experiments and retrieving their results.
License: GPL (>= 3)
URL: https://danielvartan.github.io/logolink/,
    https://github.com/danielvartan/logolink/
BugReports: https://github.com/danielvartan/logolink/issues/
Depends: R (>= 4.4)
Imports:
    checkmate (>= 2.3.3),
    cli (>= 3.6.5),
    dplyr (>= 1.1.4),
    fs (>= 1.6.6),
    glue (>= 1.8.0),
    janitor (>= 2.2.1),
    magrittr (>= 2.0.4),
    purrr (>= 1.2.0),
    readr (>= 2.0.0),
    tidyr (>= 1.3.1),
    stringr (>= 1.6.0),
    xml2 (>= 1.4.0)
Suggests:
    bslib (>= 0.9.0),
    colorspace (>= 2.1.2),
    covr (>= 3.6.5),
    curl (>= 7.0.0),
    ggplot2 (>= 4.0.1),
    ggimage (>= 0.3.4),
    ggtext (>= 0.1.2),
    here (>= 1.0.2),
    httr2 (>= 1.2.1),
    knitr (>= 1.50),
    lifecycle (>= 1.0.4),
    magick (>= 2.9.0),
    quarto (>= 1.5.1),
    ragg (>= 1.5.0),
    remotes (>= 2.5.0),
    rsvg (>= 2.7.0),
    scales (>= 1.4.0),
    spelling (>= 2.3.2),
    tibble (>= 3.3.0),
    testthat (>= 3.3.0)
VignetteBuilder: quarto
Config/testthat/edition: 3
Encoding: UTF-8
Language: en-US
Roxygen: list(markdown = TRUE)
RoxygenNote: 7.3.3
LazyData: true

Scope

• Please indicate which category or categories from our package fit policies this package falls under: (Please check an appropriate box below. If you are unsure, we suggest you make a pre-submission inquiry.):

  • data retrieval
  • data extraction
  • data munging
  • data deposition
  • data validation and testing
  • workflow automation
  • version control
  • citation management and bibliometrics
  • scientific software wrappers
  • field and lab reproducibility tools
  • database software bindings
  • geospatial data
  • translation

• Explain how and why the package falls under these categories (briefly, 1-2 sentences):

logolink is an R package that simplifies setting up and running NetLogo simulations directly from R (scientific software wrappers). It also includes routines for data tidying and parsing NetLogo data types (data munging).

• Who is the target audience and what are scientific applications of this package?

logolink was designed for researchers in complexity science, including ecology, epidemiology, social sciences, and economics, who work with agent-based modeling (ABM) and complex systems simulation. It enables reproducible computational experiments and analysis across any domain where NetLogo models are employed.

• Are there other R packages that accomplish the same thing? If so, how does yours differ or meet our criteria for best-in-category?

While other R packages connect R to NetLogo, logolink is currently the only one that fully supports the latest NetLogo release (Broader in functionality). It is actively maintained, follows tidyverse conventions, and is designed to be simple and straightforward to use (More open in licensing or development practices).

For context, RNetLogo supports only older versions (up to 6.0.0, released in December 2016) and has not been updated since June 2017. nlrx offers a powerful framework for managing experiments and results, but supports only up to NetLogo 6.3.0 (released in September 2022), requires additional system dependencies, uses its own internal conventions that diverge from NetLogo standards, and has many unresolved issues (Actively maintained while alternatives are poorly or no longer actively maintained) (Better in usability and performance).

logolink complements these packages by prioritizing simplicity, offering finer control over output, ensuring full compatibility with NetLogo 7, and integrating seamlessly with modern R workflows.

• (If applicable) Does your package comply with our guidance around Ethics, Data Privacy and Human Subjects Research?

Not applicable.

• If you made a pre-submission inquiry, please paste the link to the corresponding issue, forum post, or other discussion, or @tag the editor you contacted.

Not applicable.

• Explain reasons for any pkgcheck items which your package is unable to pass.

── logolink 1.0.0 ───────────────────────────────────────────────────────────────

✔ Package is already on CRAN.
✔ has a 'codemeta.json' file.
✔ has a 'contributing' file.
✔ uses 'roxygen2'.
✔ 'DESCRIPTION' has a URL field.
✔ 'DESCRIPTION' has a BugReports field.
✔ Package has at least one HTML vignette
✔ All functions have examples.
✔ Package has continuous integration checks.
✔ Package coverage is 100%.
✔ All goodpractice linters passed.
✔ R CMD check found no errors.
✔ R CMD check found no warnings.
ℹ Function names are duplicated in other packages
ℹ Examples should not use `\dontrun` unless really necessary.

ℹ Current status:
✔ A truly lovely set of check results!

[...]

✖ The following 3 function names are duplicated in other packages:
  • - `create_experiment` from previsionio, SigOptR, cometr, SqueakR
  • - `read_experiment` from Rtrack
  • - `run_experiment` from CAISEr, R6causal, banditsCI, calmr

There is minimal overlap in function names. These function names follow the Tidyverse Style Guide, making the package usage more intuitive and user-friendly.

Some examples must use \dontrun because CRAN runners do not have NetLogo installations or allow internet connectivity.

Technical checks

Confirm each of the following by checking the box.

• I have read the rOpenSci packaging guide.
• I have read the author guide and I expect to maintain this package for at least 2 years or to find a replacement.

This package:

• does not violate the Terms of Service of any service it interacts with.
• has a CRAN and OSI accepted license.
• contains a README with instructions for installing the development version.
• includes documentation with examples for all functions, created with roxygen2.
• contains a vignette with examples of its essential functions and uses.
• has a test suite.
• has continuous integration, including reporting of test coverage.

Publication options

• Do you intend for this package to go on CRAN?

• Do you intend for this package to go on Bioconductor?

• Do you wish to submit an Applications Article about your package to Methods in Ecology and Evolution? If so:

Code of conduct

• I agree to abide by rOpenSci's Code of Conduct during the review process and in maintaining my package should it be accepted.