From 589c97cb31c94cdbe34d5208ecd2f40000ead09c Mon Sep 17 00:00:00 2001
From: Simon Garnier Simon
should go smoothly on all major operating systems (Mac, Windows, and
most major Linux distributions). There are a few steps to follow before
installing the package itself in order to prepare all the necessary
-external (i.e. non-R) dependencies for
OpenCV
.
OpenCV
. You should also make
+sure that your R version is 4.0 or higher. Support for older versions of
+R has been removed.
All installation steps are described below.
Before installing ROpenCVLite
, you will need to install
-the latest versions of CMake
and Rtools
.
Rtools
+and CMake
.
You will need to install the version of Rtools
that
+corresponds to your version of R. You can check your version of R by
+typing R.version
in the R console.
Use the winget
-utility to install Cmake
from the terminal/PowerShell:
Rtools40
.Rtools42
.Rtools43
.There are multiple ways to install Rtools
on
+Windows:
Use the convenience function provided by the installr
library:
+-if (!require("installr")) install.packages("installr") -installr::install.CMake()
During the installation process, make sure to tell the installer to -add
-CMake
to your “PATH”.
Download the CMake
installer for Windows at https://cmake.org/download/. Make
-sure to tell the installer to add CMake
to your “PATH”.
Note: If you install Rtools40
, make sure to
+tell the installer to add Rtools
to your “PATH” during the
+installation process. This is not required anymore with
+Rtools42
and Rtools43
.
If you have the rig
utility
+installed on your computer, you can install Rtools
from a
+terminal running PowerShell:
If you have the winget
+utility installed on your computer, you can install Rtools
+from a terminal running PowerShell:
Note: Only Rtools42
seems to be available
+through winget
at the moment.
You can manually download Rtools
at https://cran.r-project.org/bin/windows/Rtools/.
Note: If you install Rtools40
, make sure to
+tell the installer to add Rtools
to your “PATH” during the
+installation process. This is not required anymore with
+Rtools42
and Rtools43
.
Use the winget
-utility to install Cmake
from the terminal/PowerShell:
Installing Cmake
is only required if your R version
+starts with 4.0 or 4.1 and, therefore, you have installed
+Rtools40
. For newer versions of R, Cmake
is
+included in Rtools42
and Rtools43
and you can
+skip this step.
Any version of Cmake
3.24 or higher should work. There
+are multiple ways to install Cmake
on Windows:
Use the convenience function provided by the installr
library:
if (!require("installr"))
install.packages("installr")
-installr::install.Rtools()
During the installation process, make sure to tell the installer to
-add Rtools
to your “PATH”.
Download the latest “recommended” version of Rtools
at
-https://cran.r-project.org/bin/windows/Rtools/.
-Make sure to tell the installer to add Rtools
to your
-“PATH”.
CMake
to your “PATH”.
+If you have the winget
+utility installed on your computer, you can install Cmake
+from a terminal running PowerShell:
You can manually download the
+CMakeinstaller for Windows at [https://cmake.org/download/](https://cmake.org/download/). Make sure to tell the installer to add
CMake`
+to your “PATH” during the installation process.
Before installing ROpenCVLite
, you will need to install
-the latest version of CMake
.
CMake
. There are multiple
+ways to install Cmake
on Mac:
+If you have homebrew
installed, run the following command in your terminal:
If you have MacPorts
installed,
run the following command in your terminal:
Go to https://cmake.org/download/. Scroll down until you reach the “Latest Release” section. Download the installer for Mac OS X (.dmg file). Once the download is complete, @@ -210,6 +275,7 @@
It will ask for your administrator password.
Use your distribution’s package management system. For instance on -Ubuntu-like systems, you can install Cmake by typing the following -command in your terminal:
- +Ubuntu-like systems, you can installCmake
by typing the
+following command in your terminal:
+
Other distributions will have different package managers. Refer to the documentation of your distribution for finding the proper way to -install Cmake on your system.
+installCmake
on your system.
Before installing ROpenCVLite
, you will need to install
the devtools
package in R
.
+install.packages("devtools")
ROpenCVLite
You can install ROpenCVLite
from CRAN as follows:
-install.packages("ROpenCVLite")
Or you can install the latest latest development version (not -recommended) as follows:
+install.packages("ROpenCVLite")
Or you can install the latest development version (not recommended) +as follows:
+
devtools::install_github("swarm-lab/ROpenCVLite")
This will not install OpenCV
yet. You will be asked
whether you want to install it the first time you load the package.
+This step can take some time. Go make yourself a cup of coffee or two while
ROpenCVLite
downloads, compiles and installsOpenCV
on your system.In addition, you can also request the (re)installation of
-OpenCV
at any time as follows:diff --git a/docs/articles/usage.html b/docs/articles/usage.html index 55b5a87..ffac5d1 100644 --- a/docs/articles/usage.html +++ b/docs/articles/usage.html @@ -124,7 +124,6 @@+ROpenCVLite::installOpenCV()
+version of
ROpenCVLite
will also automatically detect when a new -version of OpenCV is available and will offer to update it for you.OpenCV
is available and will offer to update it +for you.Create a package using DESCRIPTION