π¦ Installation
VIMuRe v0.1.1 (latest)
If you use VIMuRe
in your research, please cite (De Bacco et al. 2023).
VIMuRe is available in both R and Python. The R implementation is a wrapper around the Python implementation. Both packages are in active development and are not yet on CRAN or PyPI. Use the installation instructions below to install the latest development version.
If your preferred language is R, we would like to hear from you. Please add a message to this discussion to tell us whether you would like to see an easier installation process for R.
Choose your language:
Step 01: Install reticulate
Step 01: Install reticulate
Open your R console and type the following command:
install.packages("reticulate")
Our core code is written in python, so we use
reticulate
to integrate our model in R. This package allows you to use Python within your R session in a seamless, high-performance interoperable way.reticulate
will look for the python installed on your computer. If for some reason it cannot find it, you may be prompted to download and install miniconda.miniconda is the recommended installation method for most users, as it is easier to ensure that the newly installed python is isolated from other python installs you have in your system.
If you initially declined the miniconda installation prompt, you can later manually install miniconda by running
reticulate::install_miniconda()
.
Step 02: Install the latest vimure
(v0.1)
Step 02: Install the latest vimure
(v0.1)
In your R console, type the following commands:
require(devtools)
::install_github("latentnetworks/vimure", subdir="src/R", ref="main") devtools
Check out devtools package documentation if you are not familiar with it.
Step 03: Install the Python package
Step 03: Install the Python package
You must install the python package before using the R package. This is because the R package is a wrapper around the Python package. You can do this without leaving R, though. Just type the following command in your R console:
require(vimure)
::install_vimure() vimure
If you are not using RStudio, i.e., you are using R in the terminal, you may need to restart your R session after installing the Python package.
Not a fan of having to do this python setup? Please add a message to this discussion to tell us you would like to see an easier installation process for R.
Step 04: Check the installation
Step 04: Check the installation
To confirm that the installation was successful, run the following command:
library(vimure)
::vm_config() vimure
You should see something like the following:
#> Loaded vimure version
#> Vimure v (...)
#> Python v3.x (...)
vimure
is not yet available on PyPI, so to install the latest development version, follow the instructions below.
Install the latest vimure
(v0.1) with the following command:
pip install "git+https://github.com/latentnetworks/vimure.git#egg=vimure&subdirectory=src/python/"
This Python package was tested on Python >= 3.8, and it is expected to work fine in all OSes.
Read more about the Python setup for development here.