Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Português - 日本語 - Русский

Please note that the recommended version of Scilab is 6.0.0. This page might be outdated.
See the recommended documentation of this function

Aide de Scilab >> ATOMS > atomsInstall

atomsInstall

Install one or several external modules

Calling Sequence

result = atomsInstall(modules[,section])
result = atomsInstall(file)

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 "Intentionaly", "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("http://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
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 02 13:54:44 CEST 2014