v2.3 beta release: access ETN data from your local computer!

[PietrH]

Hello!

I'm happy to invite you to try out the newest experimental release of the etn R package. In summary, with this release you will be able to access the ETN data from your own computer without having to use the LifeWatch RStudio server. It would be great if you could try out some of your existing scripts, and check if the outputs are still in line with your expectations. Your feedback will be vital in making the transition for the larger user community as smooth as possible.

Two other major changes are:

• You no longer need to use connect_to_etn() to create a connection object, the package will ask you for your credentials once per session and store them automatically
• Because of this, you no longer need to provide a connection object to the functions in etn, it'll create and close connections for you automatically.

This is still an experimental release, which means that you need to use a slightly different command to install it:

install.packages("remotes")
remotes::install_github("inbo/[email protected]")

After this, you can check the version you have installed with packageVersion("etn") or by using the packages tab in RStudio:

In this screenshot, I have etn version 2.3.0 installed and loaded.

You can find an overview of the changes in the NEWS, or (very detailed!) in the changelog.

If you encounter any problems, or have any questions or comments big or small. You can contact me directly via email, or if you prefer, create an issue directly on Github. Don't hesitate to make any remarks, even if you feel it'll only effect your specific workflow, nothing is too small to mention and I'm here to help.

You can find this information, and an up to date list of questions and answers on this webpage.

Thank you for helping me out!

Pieter

---

Questions and answers

I will update this post as new questions come in. If your question is not here, feel welcome to contact me directly or to leave a comment!

How can I install the beta release?

You can install the new release of the etn package alongside, or in place of your current installation. If you want to start over from scratch, you can deinstall etn first by running remove.packages(etn) in the terminal although normally this should not be necessary. By default R will only allow you to install one version of a package at a time, and I think this is for the best.

To install the beta release directly from github, you can run the following code;

install.packages("remotes")
remotes::install_github("inbo/[email protected]")

After this, you can check the version you have installed with packageVersion("etn") or by using the packages tab in RStudio:

In this screenshot, I have etn version 2.3.0 installed and loaded.

If you ever want to go back to the latest official release, you can run: remotes::install_github("inbo/etn"). Let me know if you need help installing the beta or another specific version.

How can I tell what version of etn I'm using?

You can check what packages are currently loaded in R by running sessionInfo(), or you can also see it in RStudio in the packages tab (next to files, plots, help and viewer) where you can search for etn. The packages with ticks ☑ are loaded. You might need to click the refresh button if you made any changes since you opened the tab.

In this screenshot, I have etn version 2.3.0.9000 installed, but not loaded.

What has changed between 2.2.1 and this experimental release of 2.3?

You can find a summary of the changes here. But the jist of it is that you can now access the data from your local system, and that you don't need to use connection objects or connect_to_etn() anymore.

Should I be getting identical results using the API (by default) or when using a local connection (api = FALSE) ?

Ideally yes, but currently there are some known differences. This is due to changes in the r package since the API version of the code started development. This will be fixed before the API is made public to the broad user community.

Even though I'm aware of this particular discrepancy, I still appreciate any reports of unexpected results like this.

Will this beta release be faster than 2.2.1 on the RStudio Server?

No, using a local connection will be faster than using an internet connection. Let me know if something doesn't work or takes too long using v2.3, and I'll do my very best to speed things along.

How to provide feedback or report a bug or a problem

This is an experimental release, and I'm very grateful for your help in testing the changes that we've made since v2.2.1. It would be helpful if you could try to run some of your existing scripts to see if the results are still in line with what you'd expect.

You can get my attention by:

• emailing me directly
• Creating an issue
• Leaving a comment in this thread.

If you encounter any problems, or have any questions or comments please don't hesitate to make any remarks, even if you feel it'll only effect your specific workflow, nothing is too small to mention.