# Installation

AMAPVox is an R package that embeds a Java Desktop Application. The Java part of AMAPVox is distributed as a set of JAR files (Java Archives) and is not included by default in the R package to keep it light. The R package handles the download of the JARs and manages multiple versions for the end user.

## System requirements

Operating system: Windows (7 or above), Linux-based, Mac OS X. 64-Bit.

Java: For AMAPVox v2 or above, Java is embedded with AMAPVox binaries. For AMAPVox v1 the system requires Java 1.8 64-Bit with JavaFX. In practice either Java 1.8 64-Bit Oracle or Java 1.8 64-Bit Corretto.

CPU: one required but multi-core CPU recommended for multithreading execution.

RAM: 1GB is enough for running the sample case. It will greatly depends on the dimension of the voxel space and the size of the LiDAR scans.

OpenGL: Version 3 or higher, for visualization only.

## AMAPVox R package

Install AMAPVox package latest stable version from source:

    # install "remotes" package if not already installed
    if (!any(grepl("remotes", rownames(installed.packages())))) install.packages("remotes")
    # install latest stable version from source
    remotes::install_github('umr-amap/AMAPVox')

    # load AMAPVox package
    library(AMAPVox)

## AMAPVox GUI

Install and run latest AMAPVox GUI (with active internet connection)

    AMAPVox::run()

After downloading latest version, AMAPVox GUI should start automatically:

For AMAPVox <= 1.10, if you get error(s) about java version, please read help page

    ? AMAPVox::run # section "Java 1.8 64-Bit with JavaFX"

List available remote versions:

    AMAPVox::getRemoteVersions()

Install specific version:

    AMAPVox::installVersion("1.7.6")
    # install and run specific version
    AMAPVox::run("1.6.4", check.update = FALSE)

List local versions:

    AMAPVox::getLocalVersions()

Uninstall local version:

    AMAPVox::removeVersion("1.7.6")