Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2025.0.0 - Français


atomsInstall

Install one or several external modules

Syntax

result = atomsInstall(modules)
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 "Intentionally", "A" stands for "Automatically"

Description

atomsInstall installs one or several 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

History

VersionDescription
2023.0.0 When a module has no binary compiled for the running Scilab M.m version but has published (former) sources, atomsInstall automatically tries to compile them.
Report an issue
<< atomsGetLoadedPath ATOMS atomsIsInstalled >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 24 11:16:04 CEST 2024