atomsInstall

Arguments

modules

mx1, mx2 Matrix of strings:

1st Col.	Technical name	Mandatory
2nd Col.	Version	Optional	If this field is empty or is not present, the most recent version is used

file

mx1 Matrix of strings:

1st Col.

File-system path

Mandatory

section

This argument controls where the external module is installed.

section is a single-string and its value should be :

• "allusers": the external module is installed for all users of the computer and is located in SCI/contrib ("allusers zone").

• "user": the external module is only installed for the current user and is located in SCIHOME/atoms ("user zone").

If SCI/contrib is write accessible, "allusers" is the default value. Otherwise, the default value is "user".

result

5xn character string matrix:

1st Col.	Technical name
2nd Col.	Version
3rd Col.	Installation section	this parameter determines whether the module has been installed for all users or only for the current user.
4th Col.	Installation path
5th Col.	Status	"I" stands for "Intentionally", "A" stands for "Automatically"

Description

atomsInstall install one or more external modules.

Examples

Example 1: Installing a module from a repository

// Display some additional information
atomsSetConfig("Verbose","True");

// Load the test repository
atomsRepositoryAdd("https://scene1.test.atoms.scilab.org");

// Install a module
atomsInstall("toolbox_1");

// Install a specific version
atomsInstall(["toolbox_2" "2.0"]);

// Install several modules
atomsInstall(["toolbox_4" "1.0" ; "toolbox_2" "1.0"]);

// Install a module in the user section
atomsInstall(["toolbox_5"],"user");

// Install a module in the allusers section
// (write access on SCI directory is needed):
atomsInstall(["toolbox_6" "1.0";"toolbox_3" "1.0"], ..
             "allusers");

// Get the list of installed modules:
disp( atomsGetInstalled() );

// Cleaning :)
atomsRemove(["toolbox_1"; ..
             "toolbox_2"; ..
             "toolbox_3"; ..
             "toolbox_4"; ..
             "toolbox_5"; ..
             "toolbox_6"]);

Example 2: Installing a local module. As well as installing modules from the central repository, you can also install modules directly from your own machine.

// Display some additional information
atomsSetConfig("Verbose","True");

// Install a module
atomsInstall(SCI+"/modules/atoms/tests/unit_tests/toolbox_7_1.0-1.bin.zip");

// Get the list of installed modules:
disp( atomsGetInstalled() );

// Cleaning :)
atomsRemove("toolbox_7");

See also

• atomsIsInstalled — Determines whether the module is installed. Returns true if the module is installed, false otherwise.
• atomsGetInstalled — Get the list of installed external modules
• atomsRemove — Remove one or several modules