Skip to contents

Installs everything ctFit(backend='julia') needs, in one call and without restarting R: the JuliaConnectoR bridge package, a Julia installation, and the Julia dependencies of the engine that ships inside ctsem. Any step that is already satisfied is skipped, so on a machine that already has Julia this only prepares the engine.

Usage

ctJuliaInstall(
  threads = NULL,
  version = NULL,
  agree = NULL,
  force = FALSE,
  quiet = FALSE
)

Arguments

threads

Number of Julia threads for the engine's subject loop. Julia fixes this when its process starts, so it applies to the session this call creates; see ctJuliaSetup.

version

Julia version to install. Defaults to the version ctsem's vendored engine was resolved against. The download is checksum-verified only for that default.

agree

TRUE to consent to the installs without being asked, FALSE to refuse them. NULL, the default, asks in an interactive session and refuses otherwise.

force

Reinstall Julia even if one is already available, and restart any running Julia session.

quiet

Suppress download and installation progress output.

Value

A Julia-engine status list, invisibly; see ctJuliaStatus.

Details

Each step that installs something asks first, naming the download and its destination. A non-interactive session has nobody to ask, so nothing is installed there unless agree = TRUE or the environment variable CTSEM_JULIA_AGREE=yes gave permission in advance.

Julia is downloaded only if none can be found. ctsem looks in JULIA_BINDIR, then at a Julia it installed itself, then on the PATH, then among juliaup's installations. A Julia that ctsem installs goes under tools::R_user_dir("ctsem", "data") and later sessions find it automatically – there is no environment variable to set, and no PATH or shell profile is modified. To use a different Julia afterwards, set JULIA_BINDIR.

Examples

if (FALSE) { # \dontrun{
ctJuliaInstall()            # ask, then install whatever is missing
ctJuliaInstall(threads = 4) # and start the Julia session with four threads
} # }