From 0345245e860375a32c9a437c4a9d9cae807134e9 Mon Sep 17 00:00:00 2001 From: Shashank Date: Mon, 29 May 2017 12:40:26 +0530 Subject: CMSCOPE changed --- modules/data_structures/help/en_US/addchapter.sce | 11 + modules/data_structures/help/en_US/boolean.xml | 87 +++++++ modules/data_structures/help/en_US/cell.xml | 164 +++++++++++++ .../data_structures/help/en_US/definedfields.xml | 78 ++++++ modules/data_structures/help/en_US/fieldnames.xml | 86 +++++++ modules/data_structures/help/en_US/getfield.xml | 76 ++++++ modules/data_structures/help/en_US/hypermat.xml | 92 ++++++++ .../data_structures/help/en_US/hypermatrices.xml | 80 +++++++ modules/data_structures/help/en_US/iscell.xml | 70 ++++++ modules/data_structures/help/en_US/iscellstr.xml | 76 ++++++ modules/data_structures/help/en_US/isfield.xml | 101 ++++++++ modules/data_structures/help/en_US/isstruct.xml | 72 ++++++ modules/data_structures/help/en_US/list.xml | 183 ++++++++++++++ modules/data_structures/help/en_US/lstcat.xml | 62 +++++ modules/data_structures/help/en_US/makecell.xml | 74 ++++++ modules/data_structures/help/en_US/matrices.xml | 75 ++++++ modules/data_structures/help/en_US/mlist.xml | 136 +++++++++++ modules/data_structures/help/en_US/null.xml | 35 +++ modules/data_structures/help/en_US/rlist.xml | 98 ++++++++ modules/data_structures/help/en_US/setfield.xml | 77 ++++++ modules/data_structures/help/en_US/struct.xml | 101 ++++++++ modules/data_structures/help/en_US/tlist.xml | 165 +++++++++++++ modules/data_structures/help/en_US/type.xml | 251 ++++++++++++++++++++ modules/data_structures/help/en_US/typename.xml | 97 ++++++++ modules/data_structures/help/en_US/typeof.xml | 244 +++++++++++++++++++ modules/data_structures/help/fr_FR/addchapter.sce | 11 + modules/data_structures/help/fr_FR/boolean.xml | 73 ++++++ modules/data_structures/help/fr_FR/fieldnames.xml | 93 ++++++++ modules/data_structures/help/fr_FR/getfield.xml | 63 +++++ modules/data_structures/help/fr_FR/hypermat.xml | 77 ++++++ .../data_structures/help/fr_FR/hypermatrices.xml | 69 ++++++ modules/data_structures/help/fr_FR/iscell.xml | 70 ++++++ modules/data_structures/help/fr_FR/iscellstr.xml | 78 ++++++ modules/data_structures/help/fr_FR/isfield.xml | 103 ++++++++ modules/data_structures/help/fr_FR/isstruct.xml | 72 ++++++ modules/data_structures/help/fr_FR/list.xml | 161 +++++++++++++ modules/data_structures/help/fr_FR/lstcat.xml | 51 ++++ modules/data_structures/help/fr_FR/matrices.xml | 60 +++++ modules/data_structures/help/fr_FR/mlist.xml | 107 +++++++++ modules/data_structures/help/fr_FR/null.xml | 35 +++ modules/data_structures/help/fr_FR/rlist.xml | 87 +++++++ modules/data_structures/help/fr_FR/setfield.xml | 64 +++++ modules/data_structures/help/fr_FR/struct.xml | 91 +++++++ modules/data_structures/help/fr_FR/tlist.xml | 154 ++++++++++++ modules/data_structures/help/fr_FR/type.xml | 262 +++++++++++++++++++++ modules/data_structures/help/fr_FR/typename.xml | 96 ++++++++ modules/data_structures/help/ja_JP/addchapter.sce | 11 + modules/data_structures/help/ja_JP/boolean.xml | 83 +++++++ modules/data_structures/help/ja_JP/cell.xml | 153 ++++++++++++ .../data_structures/help/ja_JP/definedfields.xml | 80 +++++++ modules/data_structures/help/ja_JP/fieldnames.xml | 76 ++++++ modules/data_structures/help/ja_JP/getfield.xml | 71 ++++++ modules/data_structures/help/ja_JP/hypermat.xml | 81 +++++++ .../data_structures/help/ja_JP/hypermatrices.xml | 76 ++++++ modules/data_structures/help/ja_JP/iscell.xml | 68 ++++++ modules/data_structures/help/ja_JP/iscellstr.xml | 74 ++++++ modules/data_structures/help/ja_JP/isfield.xml | 99 ++++++++ modules/data_structures/help/ja_JP/isstruct.xml | 70 ++++++ modules/data_structures/help/ja_JP/list.xml | 176 ++++++++++++++ modules/data_structures/help/ja_JP/lstcat.xml | 63 +++++ modules/data_structures/help/ja_JP/makecell.xml | 75 ++++++ modules/data_structures/help/ja_JP/matrices.xml | 61 +++++ modules/data_structures/help/ja_JP/mlist.xml | 130 ++++++++++ modules/data_structures/help/ja_JP/null.xml | 35 +++ modules/data_structures/help/ja_JP/rlist.xml | 48 ++++ modules/data_structures/help/ja_JP/setfield.xml | 71 ++++++ modules/data_structures/help/ja_JP/struct.xml | 70 ++++++ modules/data_structures/help/ja_JP/tlist.xml | 162 +++++++++++++ modules/data_structures/help/ja_JP/type.xml | 115 +++++++++ modules/data_structures/help/ja_JP/typename.xml | 90 +++++++ modules/data_structures/help/ja_JP/typeof.xml | 213 +++++++++++++++++ modules/data_structures/help/pt_BR/addchapter.sce | 11 + modules/data_structures/help/pt_BR/boolean.xml | 89 +++++++ modules/data_structures/help/pt_BR/cell.xml | 164 +++++++++++++ .../data_structures/help/pt_BR/definedfields.xml | 84 +++++++ modules/data_structures/help/pt_BR/getfield.xml | 72 ++++++ modules/data_structures/help/pt_BR/hypermat.xml | 91 +++++++ .../data_structures/help/pt_BR/hypermatrices.xml | 80 +++++++ modules/data_structures/help/pt_BR/iscell.xml | 70 ++++++ modules/data_structures/help/pt_BR/iscellstr.xml | 79 +++++++ modules/data_structures/help/pt_BR/isstruct.xml | 74 ++++++ modules/data_structures/help/pt_BR/list.xml | 175 ++++++++++++++ modules/data_structures/help/pt_BR/lstcat.xml | 63 +++++ modules/data_structures/help/pt_BR/matrices.xml | 58 +++++ modules/data_structures/help/pt_BR/mlist.xml | 138 +++++++++++ modules/data_structures/help/pt_BR/null.xml | 33 +++ modules/data_structures/help/pt_BR/rlist.xml | 48 ++++ modules/data_structures/help/pt_BR/setfield.xml | 73 ++++++ modules/data_structures/help/pt_BR/struct.xml | 76 ++++++ modules/data_structures/help/pt_BR/tlist.xml | 130 ++++++++++ modules/data_structures/help/pt_BR/type.xml | 66 ++++++ modules/data_structures/help/pt_BR/typename.xml | 91 +++++++ modules/data_structures/help/pt_BR/typeof.xml | 207 ++++++++++++++++ modules/data_structures/help/ru_RU/addchapter.sce | 11 + modules/data_structures/help/ru_RU/boolean.xml | 80 +++++++ modules/data_structures/help/ru_RU/cell.xml | 169 +++++++++++++ .../data_structures/help/ru_RU/definedfields.xml | 81 +++++++ modules/data_structures/help/ru_RU/fieldnames.xml | 81 +++++++ modules/data_structures/help/ru_RU/getfield.xml | 74 ++++++ modules/data_structures/help/ru_RU/hypermat.xml | 96 ++++++++ .../data_structures/help/ru_RU/hypermatrices.xml | 84 +++++++ modules/data_structures/help/ru_RU/iscell.xml | 70 ++++++ modules/data_structures/help/ru_RU/iscellstr.xml | 77 ++++++ modules/data_structures/help/ru_RU/isfield.xml | 78 ++++++ modules/data_structures/help/ru_RU/isstruct.xml | 73 ++++++ modules/data_structures/help/ru_RU/list.xml | 183 ++++++++++++++ modules/data_structures/help/ru_RU/lstcat.xml | 64 +++++ modules/data_structures/help/ru_RU/matrices.xml | 61 +++++ modules/data_structures/help/ru_RU/mlist.xml | 137 +++++++++++ modules/data_structures/help/ru_RU/null.xml | 35 +++ modules/data_structures/help/ru_RU/rlist.xml | 62 +++++ modules/data_structures/help/ru_RU/setfield.xml | 77 ++++++ modules/data_structures/help/ru_RU/struct.xml | 76 ++++++ modules/data_structures/help/ru_RU/tlist.xml | 163 +++++++++++++ modules/data_structures/help/ru_RU/type.xml | 241 +++++++++++++++++++ modules/data_structures/help/ru_RU/typename.xml | 90 +++++++ modules/data_structures/help/ru_RU/typeof.xml | 244 +++++++++++++++++++ 117 files changed, 11098 insertions(+) create mode 100755 modules/data_structures/help/en_US/addchapter.sce create mode 100755 modules/data_structures/help/en_US/boolean.xml create mode 100755 modules/data_structures/help/en_US/cell.xml create mode 100755 modules/data_structures/help/en_US/definedfields.xml create mode 100755 modules/data_structures/help/en_US/fieldnames.xml create mode 100755 modules/data_structures/help/en_US/getfield.xml create mode 100755 modules/data_structures/help/en_US/hypermat.xml create mode 100755 modules/data_structures/help/en_US/hypermatrices.xml create mode 100755 modules/data_structures/help/en_US/iscell.xml create mode 100755 modules/data_structures/help/en_US/iscellstr.xml create mode 100755 modules/data_structures/help/en_US/isfield.xml create mode 100755 modules/data_structures/help/en_US/isstruct.xml create mode 100755 modules/data_structures/help/en_US/list.xml create mode 100755 modules/data_structures/help/en_US/lstcat.xml create mode 100755 modules/data_structures/help/en_US/makecell.xml create mode 100755 modules/data_structures/help/en_US/matrices.xml create mode 100755 modules/data_structures/help/en_US/mlist.xml create mode 100755 modules/data_structures/help/en_US/null.xml create mode 100755 modules/data_structures/help/en_US/rlist.xml create mode 100755 modules/data_structures/help/en_US/setfield.xml create mode 100755 modules/data_structures/help/en_US/struct.xml create mode 100755 modules/data_structures/help/en_US/tlist.xml create mode 100755 modules/data_structures/help/en_US/type.xml create mode 100755 modules/data_structures/help/en_US/typename.xml create mode 100755 modules/data_structures/help/en_US/typeof.xml create mode 100755 modules/data_structures/help/fr_FR/addchapter.sce create mode 100755 modules/data_structures/help/fr_FR/boolean.xml create mode 100755 modules/data_structures/help/fr_FR/fieldnames.xml create mode 100755 modules/data_structures/help/fr_FR/getfield.xml create mode 100755 modules/data_structures/help/fr_FR/hypermat.xml create mode 100755 modules/data_structures/help/fr_FR/hypermatrices.xml create mode 100755 modules/data_structures/help/fr_FR/iscell.xml create mode 100755 modules/data_structures/help/fr_FR/iscellstr.xml create mode 100755 modules/data_structures/help/fr_FR/isfield.xml create mode 100755 modules/data_structures/help/fr_FR/isstruct.xml create mode 100755 modules/data_structures/help/fr_FR/list.xml create mode 100755 modules/data_structures/help/fr_FR/lstcat.xml create mode 100755 modules/data_structures/help/fr_FR/matrices.xml create mode 100755 modules/data_structures/help/fr_FR/mlist.xml create mode 100755 modules/data_structures/help/fr_FR/null.xml create mode 100755 modules/data_structures/help/fr_FR/rlist.xml create mode 100755 modules/data_structures/help/fr_FR/setfield.xml create mode 100755 modules/data_structures/help/fr_FR/struct.xml create mode 100755 modules/data_structures/help/fr_FR/tlist.xml create mode 100755 modules/data_structures/help/fr_FR/type.xml create mode 100755 modules/data_structures/help/fr_FR/typename.xml create mode 100755 modules/data_structures/help/ja_JP/addchapter.sce create mode 100755 modules/data_structures/help/ja_JP/boolean.xml create mode 100755 modules/data_structures/help/ja_JP/cell.xml create mode 100755 modules/data_structures/help/ja_JP/definedfields.xml create mode 100755 modules/data_structures/help/ja_JP/fieldnames.xml create mode 100755 modules/data_structures/help/ja_JP/getfield.xml create mode 100755 modules/data_structures/help/ja_JP/hypermat.xml create mode 100755 modules/data_structures/help/ja_JP/hypermatrices.xml create mode 100755 modules/data_structures/help/ja_JP/iscell.xml create mode 100755 modules/data_structures/help/ja_JP/iscellstr.xml create mode 100755 modules/data_structures/help/ja_JP/isfield.xml create mode 100755 modules/data_structures/help/ja_JP/isstruct.xml create mode 100755 modules/data_structures/help/ja_JP/list.xml create mode 100755 modules/data_structures/help/ja_JP/lstcat.xml create mode 100755 modules/data_structures/help/ja_JP/makecell.xml create mode 100755 modules/data_structures/help/ja_JP/matrices.xml create mode 100755 modules/data_structures/help/ja_JP/mlist.xml create mode 100755 modules/data_structures/help/ja_JP/null.xml create mode 100755 modules/data_structures/help/ja_JP/rlist.xml create mode 100755 modules/data_structures/help/ja_JP/setfield.xml create mode 100755 modules/data_structures/help/ja_JP/struct.xml create mode 100755 modules/data_structures/help/ja_JP/tlist.xml create mode 100755 modules/data_structures/help/ja_JP/type.xml create mode 100755 modules/data_structures/help/ja_JP/typename.xml create mode 100755 modules/data_structures/help/ja_JP/typeof.xml create mode 100755 modules/data_structures/help/pt_BR/addchapter.sce create mode 100755 modules/data_structures/help/pt_BR/boolean.xml create mode 100755 modules/data_structures/help/pt_BR/cell.xml create mode 100755 modules/data_structures/help/pt_BR/definedfields.xml create mode 100755 modules/data_structures/help/pt_BR/getfield.xml create mode 100755 modules/data_structures/help/pt_BR/hypermat.xml create mode 100755 modules/data_structures/help/pt_BR/hypermatrices.xml create mode 100755 modules/data_structures/help/pt_BR/iscell.xml create mode 100755 modules/data_structures/help/pt_BR/iscellstr.xml create mode 100755 modules/data_structures/help/pt_BR/isstruct.xml create mode 100755 modules/data_structures/help/pt_BR/list.xml create mode 100755 modules/data_structures/help/pt_BR/lstcat.xml create mode 100755 modules/data_structures/help/pt_BR/matrices.xml create mode 100755 modules/data_structures/help/pt_BR/mlist.xml create mode 100755 modules/data_structures/help/pt_BR/null.xml create mode 100755 modules/data_structures/help/pt_BR/rlist.xml create mode 100755 modules/data_structures/help/pt_BR/setfield.xml create mode 100755 modules/data_structures/help/pt_BR/struct.xml create mode 100755 modules/data_structures/help/pt_BR/tlist.xml create mode 100755 modules/data_structures/help/pt_BR/type.xml create mode 100755 modules/data_structures/help/pt_BR/typename.xml create mode 100755 modules/data_structures/help/pt_BR/typeof.xml create mode 100755 modules/data_structures/help/ru_RU/addchapter.sce create mode 100755 modules/data_structures/help/ru_RU/boolean.xml create mode 100755 modules/data_structures/help/ru_RU/cell.xml create mode 100755 modules/data_structures/help/ru_RU/definedfields.xml create mode 100755 modules/data_structures/help/ru_RU/fieldnames.xml create mode 100755 modules/data_structures/help/ru_RU/getfield.xml create mode 100755 modules/data_structures/help/ru_RU/hypermat.xml create mode 100755 modules/data_structures/help/ru_RU/hypermatrices.xml create mode 100755 modules/data_structures/help/ru_RU/iscell.xml create mode 100755 modules/data_structures/help/ru_RU/iscellstr.xml create mode 100755 modules/data_structures/help/ru_RU/isfield.xml create mode 100755 modules/data_structures/help/ru_RU/isstruct.xml create mode 100755 modules/data_structures/help/ru_RU/list.xml create mode 100755 modules/data_structures/help/ru_RU/lstcat.xml create mode 100755 modules/data_structures/help/ru_RU/matrices.xml create mode 100755 modules/data_structures/help/ru_RU/mlist.xml create mode 100755 modules/data_structures/help/ru_RU/null.xml create mode 100755 modules/data_structures/help/ru_RU/rlist.xml create mode 100755 modules/data_structures/help/ru_RU/setfield.xml create mode 100755 modules/data_structures/help/ru_RU/struct.xml create mode 100755 modules/data_structures/help/ru_RU/tlist.xml create mode 100755 modules/data_structures/help/ru_RU/type.xml create mode 100755 modules/data_structures/help/ru_RU/typename.xml create mode 100755 modules/data_structures/help/ru_RU/typeof.xml (limited to 'modules/data_structures/help') diff --git a/modules/data_structures/help/en_US/addchapter.sce b/modules/data_structures/help/en_US/addchapter.sce new file mode 100755 index 000000000..fe44d5579 --- /dev/null +++ b/modules/data_structures/help/en_US/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Data Structures",SCI+"/modules/data_structures/help/en_US",%T); + diff --git a/modules/data_structures/help/en_US/boolean.xml b/modules/data_structures/help/en_US/boolean.xml new file mode 100755 index 000000000..92cb66f82 --- /dev/null +++ b/modules/data_structures/help/en_US/boolean.xml @@ -0,0 +1,87 @@ + + + + + boolean + Scilab Objects, boolean variables and operators & | ~ + + + Description + + A boolean variable is %T (for "true") or %F (for "false"). These variables can be used to define matrices of booleans, with the usual syntax. Boolean matrices can be manipulated as ordinary matrices for elements extraction/insertion and concatenation. + + + + Note that other usual operations (+, *, -, ^, etc) are undefined for boolean matrices. Three special operators are defined for boolean matrices: + + + + + ~b + + + is the element-wise negation of boolean b (matrix). + + + + + b1 & b2 + + + is the element-wise logical and of + b1 and b2 + (matrices). + + + + + b1 | b2 + + + is the element-wise logical + or of b1 + and b2 (matrices). + + + + + + Boolean variables can be used for indexing matrices or vectors. For instance a([%T,%F,%T],:) returns the submatrix made of rows 1 and 3 of a. Boolean sparse matrices are supported. + + + + Examples + 2) +]]> + + + See Also + + + matrices + + + or + + + and + + + not + + + + diff --git a/modules/data_structures/help/en_US/cell.xml b/modules/data_structures/help/en_US/cell.xml new file mode 100755 index 000000000..120dc177f --- /dev/null +++ b/modules/data_structures/help/en_US/cell.xml @@ -0,0 +1,164 @@ + + + + + cell + creates a cell array of empty matrices + + + Calling Sequence + + c = cell() + c = cell(m1) + c = cell(m1, m2) + c = cell(m1, m2, ..., mn) + c = cell(x) + + + + Arguments + + + x + + + a vector containing the dimensions of the cell to create. + + + + + m1, m2, ..., mn + + + dimensions of the cell to create. + + + + + + + Description + + cell returns a cell array of empty matrices. + + + + cell() + + + returns a (0, 0) cell array of empty matrices. + + + + + cell(m1) + + + returns a (m1, m1) cell array of empty matrices. + + + + + cell(m1, m2) + + + returns a (m1, m2) cell array of empty matrices. + + + + + cell(m1,m2,..,mn) + + + creates a (m1, m2, ..., mn) cell array of empty matrices. + + + + + cell(x) + + + returns a cell array of empty matrices with: the first dimension of the cell array is x(1), the second dimension is x(2) and so on. + + + + + + + Remarks + + cell(x) is not the same size that x. + + + cell() is equivalent to cell(0). + + + If A is a cell array, you can access the contents of an element of A by using A(m1, m2, ..., mn).entries. The expression A(1,1) = zeros(2,2) is not valid, the right syntax is + A(1,1).entries = zeros(2,2). + + + If A is a cell array, you can get its dimensions by using A.dims which returns an int32 value that cannot be used as a subscript for the cell array. In this case, the best way to get the cell array dimensions is size(A). + + + + Examples + + + + See Also + + + eye + + + ones + + + zeros + + + + diff --git a/modules/data_structures/help/en_US/definedfields.xml b/modules/data_structures/help/en_US/definedfields.xml new file mode 100755 index 000000000..8bb0efa50 --- /dev/null +++ b/modules/data_structures/help/en_US/definedfields.xml @@ -0,0 +1,78 @@ + + + + + definedfields + returns an index of list's defined fields + + + Calling Sequence + k = definedfields(lst) + + + Arguments + + + lst + + a list, tlist or mlist variable. + + + + k + + a vector of index. + + + + + + Description + + If lst is a list, a tlist, a mlist k = definedfields(lst) returns in k the indices of the defined list fields. This function is useful because indexing undefined fields produces an error. + + + + Examples + + + + See Also + + + list + + + tlist + + + mlist + + + insertion + + + extraction + + + + diff --git a/modules/data_structures/help/en_US/fieldnames.xml b/modules/data_structures/help/en_US/fieldnames.xml new file mode 100755 index 000000000..ff371cc65 --- /dev/null +++ b/modules/data_structures/help/en_US/fieldnames.xml @@ -0,0 +1,86 @@ + + + + + fieldnames + get a tlist, mlist or struct fields names + + + Calling Sequence + f = fieldnames(lst) + + + Arguments + + + lst + + A tlist, mlist or struct variable. + + + + f + + Strings column vector of fields names. + + + + + + Description + + The fieldnames function returns field names + of a tlist, mlist or struct. fieldnames + does not work on cells. + + + As said in rational or syslin help pages, internal representation of + some Scilab objects is a tlist (or rlist), so using fieldnames with them will return the generic forms of these objects. + For example, for rationals, the function will return "num","den" and "dt". + + + + Examples + + fieldnames(tlist(['listtype', 'f1', 'f2'], [], [])) + fieldnames(mlist(['V', 'key', 'value'], ['a' 'b' ; 'c' 'd'], [1 2 ; 3 4])) + fieldnames(struct('f1', 25, 'month', 'DEC', 'year', 2006)) + obj.x = 3; + obj.y = 3; + fieldnames(obj) + fieldnames(1/%s) + fieldnames(tf2ss(1/%s)) + + + + See Also + + + extraction + + + getfield + + + tlist + + + mlist + + + struct + + + + diff --git a/modules/data_structures/help/en_US/getfield.xml b/modules/data_structures/help/en_US/getfield.xml new file mode 100755 index 000000000..f00ef1728 --- /dev/null +++ b/modules/data_structures/help/en_US/getfield.xml @@ -0,0 +1,76 @@ + + + + + getfield + list field extraction + + + Calling Sequence + [x,...] = getfield(i,l) + + + Arguments + + + x + + matrix of any possible types. + + + + l + + + list, tlist or mlist variable. + + + + + i + + + field index, see extraction for more details. + + + + + + + Description + + This function is an equivalent of [x,...]=l(i) syntax for field + extraction with the only difference that it also applies to + mlist objects. + + + + Examples + + + + See Also + + + extraction + + + + diff --git a/modules/data_structures/help/en_US/hypermat.xml b/modules/data_structures/help/en_US/hypermat.xml new file mode 100755 index 000000000..3fa5f2d2c --- /dev/null +++ b/modules/data_structures/help/en_US/hypermat.xml @@ -0,0 +1,92 @@ + + + + + hypermat + initializes an N dimensional matrix + + + Calling Sequence + M = hypermat(dims [,v]) + + + Arguments + + + dims + + a vector of hypermatrix dimensions. + + + + v + + + a vector of hypermatrix entries (default value zeros(prod(dims),1)). + + + + + + + Description + + The hypermat function initializes a hypermatrix whose dimensions are given in the vector dims and entries are given in optional argument v. + + + M data structure contains the vector of matrix dimensions + M('dims') and the vector of entries M('entries') such as + the leftmost subcripts vary first + [M(1,1,..);..;M(n1,1,..);...;M(1,n2,..);..;M(n1,n2,..);...] + + + + If you build your own hypermat, you must be careful. The M('dims') entry must be a row vector whereas the M('entries') must be a column vector. + + + + + Examples + + + + See Also + + + hypermatrices + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/en_US/hypermatrices.xml b/modules/data_structures/help/en_US/hypermatrices.xml new file mode 100755 index 000000000..7f592e1c4 --- /dev/null +++ b/modules/data_structures/help/en_US/hypermatrices.xml @@ -0,0 +1,80 @@ + + + + + hypermatrices + a Scilab object, N dimensional matrix in Scilab + + + Description + + Hypermatrix type allows to manipulate multidimensional arrays. + + + They can be defined by extension of 2D matrices as follows + a=[1 2;3 4];a(:,:,2)=rand(2,2) or directly using hypermat function. + + + Entries can be real or complex numbers, polynomials, + rationals, strings, booleans. + + + Hypermatrices are mlists: + mlist(['hm','dims','entries'],sz,v) where sz is the row + vector of dimensions and v the column vector of entries (first + dimension are stored first). + + + + The number of dimension of hypermatrices with right-most sizes equal to + 1 are automatically reduced. An hypermatrix with only two dimensions is + automatically changed to a regular matrix (type 1). + + + + + Examples + + + + See Also + + + hypermat + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/en_US/iscell.xml b/modules/data_structures/help/en_US/iscell.xml new file mode 100755 index 000000000..f30e1eb7f --- /dev/null +++ b/modules/data_structures/help/en_US/iscell.xml @@ -0,0 +1,70 @@ + + + + + iscell + checks if a variable is a cell array + + + Calling Sequence + bool = iscell(x) + + + Arguments + + + x + + a Scilab variable. + + + + bool + + a boolean. + + + + + + Description + + iscell(x) returns %tif + x is a cell array and %f otherwise. + + + + Examples + + + + See Also + + + cell + + + isstruct + + + + diff --git a/modules/data_structures/help/en_US/iscellstr.xml b/modules/data_structures/help/en_US/iscellstr.xml new file mode 100755 index 000000000..8a305e445 --- /dev/null +++ b/modules/data_structures/help/en_US/iscellstr.xml @@ -0,0 +1,76 @@ + + + + + iscellstr + checks if a variable is a cell array of strings + + + Calling Sequence + bool = iscellstr(x) + + + Arguments + + + x + + a Scilab variable. + + + + bool + + a boolean. + + + + + + Description + + iscellstr(x) returns %t if x is a cell array of + strings (or an empty cell array) and %f otherwise. + + + + Examples + + + + See Also + + + cell + + + iscell + + + isstruct + + + + diff --git a/modules/data_structures/help/en_US/isfield.xml b/modules/data_structures/help/en_US/isfield.xml new file mode 100755 index 000000000..4a0e6a655 --- /dev/null +++ b/modules/data_structures/help/en_US/isfield.xml @@ -0,0 +1,101 @@ + + + + + isfield + checks if the given fieldname exists in a structure or mlist or tlist + + + Calling Sequence + bool = isfield(s, fieldname) + + + Arguments + + + s + + a struct array, a tlist or a mlist. + + + + fieldname + + a matrix of strings: names of fields to be detected + + + + bool + + + a matrix of boolean (same format as fieldname>) + + + + + + + Description + + This function returns %t if the specified structure or tlist or mlist s includes the field fieldname, regardless of the corresponding value. For a structure, the hidden field dims is ignored. + + + + Examples + F T T (anonymous fields can be detected) + ]]> + + + See Also + + + struct + + + tlist + + + mlist + + + getfield + + + definedfields + + + + + History + + + 5.5 + + Extension to any mlist and tlist. + + + + + diff --git a/modules/data_structures/help/en_US/isstruct.xml b/modules/data_structures/help/en_US/isstruct.xml new file mode 100755 index 000000000..467583938 --- /dev/null +++ b/modules/data_structures/help/en_US/isstruct.xml @@ -0,0 +1,72 @@ + + + + + isstruct + checks if a variable is a structure array + + + Calling Sequence + bool = isstruct(x) + + + Arguments + + + x + + a Scilab variable. + + + + bool + + a boolean. + + + + + + Description + + isstruct(x) returns %t if + x is a struct array and %f otherwise. + + + + Examples + + + + See Also + + + struct + + + iscell + + + + diff --git a/modules/data_structures/help/en_US/list.xml b/modules/data_structures/help/en_US/list.xml new file mode 100755 index 000000000..91e420ede --- /dev/null +++ b/modules/data_structures/help/en_US/list.xml @@ -0,0 +1,183 @@ + + + + + list + a Scilab object and a list definition function + + + Calling Sequence + list(a1, ..., an) + + + Description + + Creates a list with elements + ai's which are arbitrary Scilab objects + (matrix, + list,...). Type of + list objects is 15. list() + creates the empty list (0 element). + + + + Operations on lists + + + extraction + + + [x,y,z,...]=L(v) where v is a vector of indices; + [x,y,z,...]=L(:) extracts all the elements. + + + + + insertion at index i + + + L(i)=a (note that it is not an + error to use L(i)=a with + 1 + size(L)]]> but + some list entries are then undefined and their + extraction gives raise to an error). + + + + + append an element in queue + + + L($+1)=e. + + + + + append an element in head + + + L(0)=e. + + After this + operation e is an index 1, + the initial elements being shifted on the + right. + + + + + + deletion + + + L(i)=null() removes the i-th element of the list L. + + + + + concatenation of two lists + + + L3 = lstcat(L1,L2). + + + + + number of elements of a list + + + you can use either nb_elm = size(L) + or nb_elm = length(L). + + + + + iterations with a list + + + it is possible to use a list L with a for loop: + for e=L,...,end is a loop with length(L) + iterations, the loop variable e being equal to L(i) + at the i-th iteration. + + + + + + + Remarks + + Scilab provides also other kinds of list, the tlist type (typed list) and + the mlist type which are useful to define a new data type with operator + overloading facilities (hypermatrices which are + multidimensional arrays in Scilab are in fact mlist). + + + Matlab struct are also available. + + + + Examples + + + + See Also + + + null + + + lstcat + + + tlist + + + mlist + + + insertion + + + extraction + + + size + + + length + + + + diff --git a/modules/data_structures/help/en_US/lstcat.xml b/modules/data_structures/help/en_US/lstcat.xml new file mode 100755 index 000000000..220c778c0 --- /dev/null +++ b/modules/data_structures/help/en_US/lstcat.xml @@ -0,0 +1,62 @@ + + + + + lstcat + list concatenation + + + Calling Sequence + lc = lstcat(l1, ..., ln) + + + Arguments + + + li + + a list or any other type of variable + + + + lc + + a list + + + + + + Description + + lc = lstcat(l1, ..., ln) concatenates components of li lists in a + single list lc. If the li are other type of variables they are simply + added to the resulting list. + + + + Examples + + + + See Also + + + list + + + + diff --git a/modules/data_structures/help/en_US/makecell.xml b/modules/data_structures/help/en_US/makecell.xml new file mode 100755 index 000000000..622f87b46 --- /dev/null +++ b/modules/data_structures/help/en_US/makecell.xml @@ -0,0 +1,74 @@ + + + + + makecell + Creates a cell array. + + + Calling Sequence + s = makecell(dims,a1,a2,...an) + + + Arguments + + + dims + + + a vector with positive integer elements, the cell array dimension + + + + + a1,a2,...,an + + + Sequence of Scilab variables, n must be equal to prod(dims) + + + + + s + + + resulting cell array + + + + + + + Description + + s= makecell(dims,a1,a2,...an) creates a cell + array of dimensions given by dims with the + given input arguments. The ai are stored + along the last dimension first. + + + + Examples + + + + See Also + + + cell + + + + diff --git a/modules/data_structures/help/en_US/matrices.xml b/modules/data_structures/help/en_US/matrices.xml new file mode 100755 index 000000000..c64667070 --- /dev/null +++ b/modules/data_structures/help/en_US/matrices.xml @@ -0,0 +1,75 @@ + + + + + matrices + Scilab objects, matrices in Scilab + + + Description + + Matrices are basic objects defined in Scilab. + They can be defined as follows: + + + + Entries eij can be real or complex numbers, polynomials, + rationals, strings, booleans. + + + Vectors are seen as matrices with one row or one column. + + + + Examples + + + + See Also + + + poly + + + string + + + boolean + + + rational + + + empty + + + hypermatrices + + + testmatrix + + + + diff --git a/modules/data_structures/help/en_US/mlist.xml b/modules/data_structures/help/en_US/mlist.xml new file mode 100755 index 000000000..531ca88c8 --- /dev/null +++ b/modules/data_structures/help/en_US/mlist.xml @@ -0,0 +1,136 @@ + + + + + mlist + Scilab object, matrix oriented typed list + definition + + + + Calling Sequence + mlist(typ, a1, ..., an) + + + Arguments + + + typ + + a vector of character strings. + + + + ai + + + any Scilab object (matrix, list, string, ...). + + + + + + + Description + + mlist object is very similar to tlist object. + The only difference concerns the extraction and insertion syntax: + if M is an mlist, for any index i which is + not a field name, M(i) is no more the i-th + field of the list. + + + The semantic of the extraction and insertion syntax should be given by + an overloading function. + + + The overloading function for extraction syntax b=a(i1, ..., in) + has the following calling sequence: b=%<type_of_a>_e_(i1, ..., in, a) + + and the syntax + [x1, ..., xm]=a(i1, ..., in) has the following calling sequence: + [x1, ..., xm]=%<type_of_a>_e_(i1, ..., in,a) + + + The overloading function associated to the insertion syntax + a(i1, ..., in)=b has the following calling sequence: + a=%<type_of_b>_i_<type_of_a>(i1, ..., in, b, a). + + + + mlist fields must then be designed by their names. They can also be + handled using the getfield and setfield + functions. + + + + Examples + + + + See Also + + + tlist + + + list + + + overloading + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/en_US/null.xml b/modules/data_structures/help/en_US/null.xml new file mode 100755 index 000000000..8e5ad8e2c --- /dev/null +++ b/modules/data_structures/help/en_US/null.xml @@ -0,0 +1,35 @@ + + + + null + delete an element in a list + + + Calling Sequence + l(i)=null() + + + Description + + Deletion of objects inside a list. + + + + Examples + + + + See Also + + + list + + + clear + + + + diff --git a/modules/data_structures/help/en_US/rlist.xml b/modules/data_structures/help/en_US/rlist.xml new file mode 100755 index 000000000..31f279b38 --- /dev/null +++ b/modules/data_structures/help/en_US/rlist.xml @@ -0,0 +1,98 @@ + + + + + rlist + Scilab rational fraction function definition + + + Calling Sequence + [r] = rlist() + [r] = rlist(N, D [,dom]) + + + + Arguments + + + N,D + + polynomial martices. + + + + dom + + + character string, or [] or a scalar. + + + + + r + + + tlist ("r" list) representing the rational fraction. + + + + + + + Description + + rlist(N, D, dom) is a shortcut to + tlist(['r','num','den','dt'], N, D, dom). + + + To correspond to the domain time of a linear system, dom + must be equal to 'c','d', [] or a scalar. + One the one hand, to be similar to functions as syslin, + and on the other, to use some functions as tf2ss, it + is necessary that dom is equal to these values. + + + + Examples + + + + See Also + + + tlist + + + syslin + + + rational + + + tf2ss + + + + diff --git a/modules/data_structures/help/en_US/setfield.xml b/modules/data_structures/help/en_US/setfield.xml new file mode 100755 index 000000000..fe691c1d1 --- /dev/null +++ b/modules/data_structures/help/en_US/setfield.xml @@ -0,0 +1,77 @@ + + + + + setfield + list field insertion + + + Calling Sequence + setfield(i, x, l) + + + Arguments + + + x + + a matrix of any possible types. + + + + l + + + a list, tlist or mlist variable. + + + + + i + + + a field index, see insertion for more details. + + + + + + + Description + + This function is an equivalent of l(i)=x syntax for field + extraction with the only difference that it also applies to + mlist objects. + + + + Examples + + + + See Also + + + insertion + + + + diff --git a/modules/data_structures/help/en_US/struct.xml b/modules/data_structures/help/en_US/struct.xml new file mode 100755 index 000000000..682b9ebac --- /dev/null +++ b/modules/data_structures/help/en_US/struct.xml @@ -0,0 +1,101 @@ + + + + + struct + create a struct + + + Calling Sequence + st = struct(field1, value1, field2, value2, ...) + + + Arguments + + + field1, field2, ... + + strings representing the fields names. + + + + value1, value2, ... + + + all data type (double, char, int, ...), representing the fields values. + + + + + + + Description + + This function returns a struct with the fields names + field1, field2, ..., and the fields values + corresponding value1, value2, ... + + + Note that type(st) returns 17, and typeof(st) returns st. + + + + Examples + + + + See Also + + + cell + + + mlist + + + tlist + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/en_US/tlist.xml b/modules/data_structures/help/en_US/tlist.xml new file mode 100755 index 000000000..a2f417fd5 --- /dev/null +++ b/modules/data_structures/help/en_US/tlist.xml @@ -0,0 +1,165 @@ + + + + + tlist + Scilab object and typed list definition. + + + Calling Sequence + tlist(typ, a1, ..., an) + + + Arguments + + + typ + + a character string or vector of character strings. + + + + ai + + + any Scilab object (matrix, list, + string, ...). + + + + + + + Description + + tlist(typ, a1, ..., an) creates a typed-list with elements ai's. The typ argument specifies the list type. Such typed-list allows the user to define new operations working on these object through Scilab functions. The only difference between typed-list and list is the value of the type (16 instead of 15). + + + typ(1) specifies the list type (character string used to define soft coded operations). + + + If specified typ(i) may give the (i+1)-th element formal name. + + + Standard Operations on list work similarly for typed-list: + + + extraction: + + + [x, y, z, ...]=l(v) where v is a vector of indices; + [x, y, z]=l(:) extracts all the elements. + + + insertion: + + + l(i)=a + + + deletion: + + + l(i)=null() removes the i-th + element of the tlist l. + + Note that the semantics of l.x=null() is undefined, but a definition can be given through the overloading mechanism. + + + + display. + + + Moreover if typ(2:n+1) are specified, user may + point elements by their names. + + + We give below examples where tlist are used. + + + Linear systems are represented by specific typed-list e.g. a + linear system [A,B,C,D] is represented by the tlist + Sys=tlist(['lss';'A';'B';'C';'D';'X0';'dt'],A,B,C,D,x0,'c') + and this specific list may be created by the function syslin. + + + Sys(2), Sys('A') or Sys.A is the state-matrix and Sys('dt') or Sys.dt is the time domain. + + + A rational matrix H is represented by the typed-list + H=rlist(Num,Den,[]) where Num and Den are two + polynomial matrices and a continuous time linear system with + transfer matrix H may be created by syslin('c',H). + + + H(2), H('num') or H.num is the transfer matrix numerator. + + + + Examples + f(1) + mprintf("Displaying a tlist of type: %s\n", typeof(mytlist)); + + mprintf("\n"); + + mprintf("-- Field ''%s'' --\n", f(1)); + mprintf("Contents: %s\n", sci2exp(mytlist(f(1)))); + + mprintf("\n"); + + mprintf("-- Field ''%s'' --\n", f(2)); + mprintf("Contents: %s\n", sci2exp(mytlist(f(2)))); +endfunction + +// Display using overloading function +disp(t) + ]]> + + + See Also + + + percent + + + syslin + + + list + + + mlist + + + + diff --git a/modules/data_structures/help/en_US/type.xml b/modules/data_structures/help/en_US/type.xml new file mode 100755 index 000000000..25af7d965 --- /dev/null +++ b/modules/data_structures/help/en_US/type.xml @@ -0,0 +1,251 @@ + + + + type + returns the type of a variable + + + Calling Sequence + [i]=type(x) + + + Arguments + + + x + + a Scilab object. + + + + i + + an integer. + + + + + + Description + + type(x) returns an integer which is the type of x as following: + + + + 1 + + a real or complex matrix of double. + + + + 2 + + + a polynomial matrix. + + + + + 4 + + + a boolean matrix. + + + + + 5 + + + a sparse matrix. + + + + + 6 + + + a sparse boolean matrix. + + + + + 7 + + Matlab sparse matrix + + + + 8 + + + a matrix of integers stored on 1 (int8), 2 (int16) or 4 (int32) bytes. + + + + + 9 + + + a matrix of graphic handles. + + + + + 10 + + + a matrix of character strings. + + + + + 11 + + + an un-compiled function (Scilab code). A function created with deff with argument 'n'. + + + + + 13 + + + a compiled function (Scilab code). + + + + + 14 + + + a function library. + + + + + 15 + + + a list. + + + + + 16 + + + a typed list (tlist). + + + + + 17 + + + a matrix oriented typed list (mlist). + + + + + 128 + + + a pointer (Use case: lufact). + + + + + 129 + + a size implicit polynomial used for indexing. + + + + 130 + + + a built-in Scilab function, called also gateway (C, C++ or Fortran code). + + + + + 0 + + a null variable. It is mainly used internally by + Scilab. If a function has no declared returned argument + like disp when it is called it returns + a null variable. If a function is called with an omitted + argument in the argument list like + foo(a,,b) the missing argument is + assigned to a null variable. + + + + Note that if a null variable is assigned to a name, it is removed. + x=disp(1) deletes x. + + + + + + + + Please note that, for some variables, type will return tlist + or mlist due to the internal data structure. This is the case of + rational and state-space matrices, + uitree, hypermat and struct. Please considering the use of + typeof instead. + + + + + Examples + + + + See Also + + + typeof + + + inttype + + + + diff --git a/modules/data_structures/help/en_US/typename.xml b/modules/data_structures/help/en_US/typename.xml new file mode 100755 index 000000000..31c2e611d --- /dev/null +++ b/modules/data_structures/help/en_US/typename.xml @@ -0,0 +1,97 @@ + + + + typename + associates a name to variable type + + + Calling Sequence + [types [ [,names]]=typename() + typename(name, type) + + + + Arguments + + + types + + an integer column vector: the types codes of each defined data types. + + + + names + + a column vector of strings: the names associated to type codes. + + + + type + + an integer: the type code of new data type. + + + + name + + a string: the name associated to the type code. + + + + + + Description + + The function and operator overloading make use of a formal name + associated to data types to form the name of the overloading function + (see overloading). The typename can be used to handle this + formal names for hard coded data types (the tlist or mlist + coded data types formal names are defined in an other way, see overloading). + + + Called without right hand side argument, typename returns + information on defined data types. + + + Called with right hand side argument, typename associates a name + to a data type code. + + + typename('',type) suppress the data type given by its code + type out of the table of known data types. + + Number max. of defined types is 50. + + + Examples + + + + + See Also + + + type + + + typeof + + + overloading + + + tlist + + + mlist + + + + diff --git a/modules/data_structures/help/en_US/typeof.xml b/modules/data_structures/help/en_US/typeof.xml new file mode 100755 index 000000000..21c346e9c --- /dev/null +++ b/modules/data_structures/help/en_US/typeof.xml @@ -0,0 +1,244 @@ + + + + + typeof + object type + + + Calling Sequence + [t]=typeof(object) + + + Arguments + + + object + + a Scilab object + + + + t + + a string + + + + + + Description + + t=typeof(object) returns one of the following + strings: + + + + "constant" + + + if object is a real or complex matrix of double. + + + + + "polynomial" + + + if object is a polynomial matrix. + + + + + "function" + + + if object is a function (Scilab code). See also deff. + + + + + "handle" + + + if object is an handle. + + + + + "string" + + + if object is a matrix made of character strings. + + + + + "boolean" + + + if object is a boolean matrix. + + + + + "list" + + + if object is a list. + + + + + "rational" + + + if object is a rational matrix (transfer matrix). + + + + + "state-space" + + + if object is a state-space model (see syslin). + + + + + "sparse" + + + if object is a (real) sparse matrix. + + + + + "boolean sparse" + + + if object is a boolean sparse matrix. + + + + + "hypermat" + + + if object is a hypermatrix (N-dimension array with . + + + + + "st" + + + if object is a structure. + + + + + "ce" + + + if object is a cell array. + + + + + "fptr" + + + if object is a built-in Scilab function, called also gateway (C, C++ or Fortran code). + + + + + "pointer" + + + if object is a pointer (See an use case: lufact). + + + + + "size implicit" + + + if object is a size implicit polynomial used for indexing. This a purely internal value. + + + + + "library" + + + if object is a function library. + + + + + "int8" or "uint8" or "int16" or "uint16" or "int32" or "uint32" + + + if object is a matrix of [unsigned] integers stored on 8, 16 or 32 bits. (See int) + + + + + + + Note that if the object is a tlist or mlist, typeof will return the first string in the first list entry. + + + + + Examples + + + + See Also + + + type + + + strings + + + syslin + + + poly + + + + diff --git a/modules/data_structures/help/fr_FR/addchapter.sce b/modules/data_structures/help/fr_FR/addchapter.sce new file mode 100755 index 000000000..2de3e8b9a --- /dev/null +++ b/modules/data_structures/help/fr_FR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Structures",SCI+"/modules/data_structures/help/fr_FR",%T); + diff --git a/modules/data_structures/help/fr_FR/boolean.xml b/modules/data_structures/help/fr_FR/boolean.xml new file mode 100755 index 000000000..ab4e253a4 --- /dev/null +++ b/modules/data_structures/help/fr_FR/boolean.xml @@ -0,0 +1,73 @@ + + + + boolean + Objets Scilab, variables booléennes et opérateurs & | ~ + + + Description + + Une variable booléenne est %T (pour "vrai"="true") ou %F (pour "faux"). + Ces variables permettent de définir des matrices de booléens avec la syntaxe habituelle. Ces matrices booléennes peuvent être manipulées comme des matrices ordinaires pour les opérations d'extraction/insertion et de concaténation. Notez que les autres opérations usuelles (+, *, -, ^, etc.) ne sont pas définies pour les matrices booléennes. Les seuls opérateurs valides sont les suivants : + + + + ~b + + + est la négation logique élément par élément de la matrice booléenne b. + + + + + b1&b2 + + + est la conjonction (et) logique élément par élément de b1 et b2 (matrices). + + + + + b1|b2 + + + est la disjonction (ou) logique élément par élément de b1 et b2 (matrices). + + + + + Les variables booléennes peuvent être utilisées comme indice pour les matrices et les vecteurs. + + + Par exemple a([%T,%F,%T],:) renvoie la sous-matrice composée des lignes 1 et 3 de a. Les matrices booléennes peuvent être creuses. + + + + + + + Exemples + 2) + ]]> + + + Voir aussi + + + matrices + + + or + + + and + + + not + + + + diff --git a/modules/data_structures/help/fr_FR/fieldnames.xml b/modules/data_structures/help/fr_FR/fieldnames.xml new file mode 100755 index 000000000..6ad10a2d1 --- /dev/null +++ b/modules/data_structures/help/fr_FR/fieldnames.xml @@ -0,0 +1,93 @@ + + + + + fieldnames + récupère le nom des champs d'une tlist, d'une mlist ou + d'une struct + + + + Séquence d'appel + f = fieldnames(lst) + + + Paramètres + + + lst + + Une variable de type tlist, mlist ou struct. + + + + f + + Un vecteur colonne de chaînes de caractères + représentant les noms des champs. + + + + + + + Description + + La fonction fieldnames retourne le nom des + champs d'une tlist, mlist ou + struct. fieldnames ne fonctionne pas sur le + type cell. + + + Comme expliqué dans les documentations de rational et + syslin, certains objets de Scilab sont construits à partir + de tlist (ou rlist). Autrement dit, la fonction fieldnames avec ceux-ci en paramètres + d'entrée va retourner comme résultat la forme générique de ces objets. Par exemple, pour un objet + de type rational, la fonction va renvoyer "num", "den" et "dt". + + + + Exemples + + fieldnames(tlist(['listtype', 'f1', 'f2'], [], [])) + fieldnames(mlist(['V', 'key', 'value'], ['a' 'b' ; 'c' 'd'], [1 2 ; 3 4])) + fieldnames(struct('f1', 25, 'month', 'DEC', 'year', 2006)) + obj.x = 3; + obj.y = 3; + fieldnames(obj) + fieldnames(1/%s) + fieldnames(tf2ss(1/%s)) + + + + Voir aussi + + + extraction + + + getfield + + + tlist + + + mlist + + + struct + + + + diff --git a/modules/data_structures/help/fr_FR/getfield.xml b/modules/data_structures/help/fr_FR/getfield.xml new file mode 100755 index 000000000..8d0e65412 --- /dev/null +++ b/modules/data_structures/help/fr_FR/getfield.xml @@ -0,0 +1,63 @@ + + + + getfield + extraction d'un champ d'une liste + + + Séquence d'appel + [x,...]=getfield(i,l) + + + Paramètres + + + x + + matrice de tout type + + + + + l + + variable de type list, tlist ou mlist + + + + + i + + + indice du champ, voir extraction pour plus de détails + + + + + + + Description + + Cette fonction est un équivalent de la syntaxe [x,...]=l(i) pour l'extraction de champs avec la seule différence qu'elle s'applique aussi aux objets de type mlist. + + + + Exemples + + + + Voir aussi + + + extraction + + + + diff --git a/modules/data_structures/help/fr_FR/hypermat.xml b/modules/data_structures/help/fr_FR/hypermat.xml new file mode 100755 index 000000000..45a6b1504 --- /dev/null +++ b/modules/data_structures/help/fr_FR/hypermat.xml @@ -0,0 +1,77 @@ + + + + hypermat + initialisation d'une matrice à N dimensions + + + Séquence d'appel + M=hypermat(dims [,v]) + + + Paramètres + + + dims + + vecteur des dimensions de l'hypermatrice + + + + + v + + + vecteur des termes de l'hypermatrice (valeur par défaut zeros(prod(dims),1)) + + + + + + + Description + + Initialisation d'une matrice à N dimensions dont les dimensions sont données dans le vecteur dims + et dont les termes sont éventuellement donnés dans un vecteur optionnel v. + + + La structure de données M contient un champ M('dims') contenant les dimensions de l'hypermatrice et un champ contenant le vecteur des termes M('entries'), rangés tel que l'indice + le plus à gauche varie en premier : + [M(1,1,..);..;M(n1,1,..);...;M(1,n2,..);..;M(n1,n2,..);...] + + Attention: Si vous construisez votre propre hypermat, vous devez faire attention. L'entrée M('dims') doit être un vecteur ligne alors que l'entrée M('entries') doit être un vecteur colonne. + + + + + Exemples + + + + See Also + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/fr_FR/hypermatrices.xml b/modules/data_structures/help/fr_FR/hypermatrices.xml new file mode 100755 index 000000000..5a07657e1 --- /dev/null +++ b/modules/data_structures/help/fr_FR/hypermatrices.xml @@ -0,0 +1,69 @@ + + + + hypermatrices + Objet Scilab, matrices à N dimensions + + + Description + + Le type Hypermatrice permet de manipuler des tableaux multidimensionnels. + Ce type d'objet peut être défini par extension des matrices 2D comme ceci : + + + a=[1 2;3 4];a(:,:,2)=rand(2,2) + + + ou directement en utilisant la fonction hypermat. + + + Les termes peuvent être réels, complexes, polynômiaux, rationnels, booléens + ou de type chaîne de caractères. + + + Les Hypermatrices sont des mlists : + mlist(['hm','dims','entries'],sz,v) où sz est + le vecteur ligne des dimensions et v le vecteur colonne des termes (rangés tel que + l'indice le plus à gauche varie en premier). + + NOTES: le nombre de dimensions des hypermatrices dont les dimensions les plus à droite sont egales + à 1 est automatiquement réduit. Une hypermatrice n'ayant que 2 dimensions + est automatiquement transformée en une matrice standard (de type 1). + + + + Exemples + + + + Voir aussi + + + hypermat + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/fr_FR/iscell.xml b/modules/data_structures/help/fr_FR/iscell.xml new file mode 100755 index 000000000..cbd10a97c --- /dev/null +++ b/modules/data_structures/help/fr_FR/iscell.xml @@ -0,0 +1,70 @@ + + + + + iscell + Check if a variable is a cell array + + + Calling Sequence + bool = iscell(x) + + + Parameters + + + x + + Scilab variable + + + + bool + + A boolean + + + + + + Description + + iscell(x) returns true if x is a cell array + and false otherwise. + + + + Examples + + + + See Also + + + cell + + + isstruct + + + + diff --git a/modules/data_structures/help/fr_FR/iscellstr.xml b/modules/data_structures/help/fr_FR/iscellstr.xml new file mode 100755 index 000000000..f98ff325d --- /dev/null +++ b/modules/data_structures/help/fr_FR/iscellstr.xml @@ -0,0 +1,78 @@ + + + + + iscellstr + Vérifie si une variable est une cell de chaînes de + caractères + + + + Séquence d'appel + bool = iscellstr(x) + + + Paramètres + + + x + + Variable Scilab + + + + bool + + Un booléen + + + + + + Description + + iscellstr(x) retourne vrai si x est une cell de + chaînes de caractères et faux sinon. + + + + Exemples + + + + Voir aussi + + + cell + + + iscell + + + isstruct + + + + diff --git a/modules/data_structures/help/fr_FR/isfield.xml b/modules/data_structures/help/fr_FR/isfield.xml new file mode 100755 index 000000000..e0deb48f1 --- /dev/null +++ b/modules/data_structures/help/fr_FR/isfield.xml @@ -0,0 +1,103 @@ + + + + + isfield + teste l'existence d'un ou plusieurs champs pour une structure, une tlist ou une mlist + + + Séquence d'appel + bool = isfield(s, fieldname) + + + Paramètres + + + s + + un tableau de structures, ou une liste typée tlist ou mlist + + + + fieldname + + matrice de textes : noms des champs à détecter + + + + bool + + + matrice booléenne (même format que fieldname) + + + + + + + Description + + bool(i,j) vaut %t si le champ nommé fieldname(i,j) existe pour le tableau de structure ou tlist ou mlist s(indépendamment de la valeur éventuellement affectée à ce champ). Si s est une structure, son champ caché dims est ignoré. + + + + Exemples + F T T (la présence de champs anonymes peut être détectée) + + ]]> + + + Voir aussi + + + struct + + + tlist + + + mlist + + + getfield + + + definedfields + + + + + Historique + + + 5.5 + + Extension aux mlist et tlist + + + + + diff --git a/modules/data_structures/help/fr_FR/isstruct.xml b/modules/data_structures/help/fr_FR/isstruct.xml new file mode 100755 index 000000000..c4e86a603 --- /dev/null +++ b/modules/data_structures/help/fr_FR/isstruct.xml @@ -0,0 +1,72 @@ + + + + + isstruct + Vérifie si une variable est une structure + + + Séquence d'appel + bool = isstruct(x) + + + Paramètres + + + x + + Variable Scilab + + + + bool + + Un booléen + + + + + + Description + + isstruct(x) retourne vrai si x est une structure + et faux sinon. + + + + Exemples + + + + Voir aussi + + + struct + + + iscell + + + + diff --git a/modules/data_structures/help/fr_FR/list.xml b/modules/data_structures/help/fr_FR/list.xml new file mode 100755 index 000000000..23ca2c3d5 --- /dev/null +++ b/modules/data_structures/help/fr_FR/list.xml @@ -0,0 +1,161 @@ + + + + list + Objet Scilab, Définition d'une liste + + + Séquence d'appel + list(a1,....an) + + + Description + + Crée une liste avec les éléments ai + qui sont des objets Scilab arbitraires (matrice, + liste, ... + + ). Le numéro de type des objets liste + (renvoyé par la fonction type) est 15. + + + list() crée une liste vide (0 élément). + + + + Operations sur les listes + + + extraction + + + [x,y,z...]=L(v) où v est un vecteur d'indices; + [x,y,z]=L(:) extrait tous les éléments. + + + + + insertion en position i + + + L(i)=a . Remarque : l'opération L(i)=a + avec i > 1 + size(L) ne génère pas d'erreur les + entrées en position 1 + size(L), ..., i-1 étant + alors indéfinies. Par contre l'extraction d'un élément + indéfini en génère une. + + + + + ajouter un élément en queue de liste + + + L($+1)=e. + + + + + ajouter un élément en tête de liste + + + L(0)=e. (remarque : après cette opération e est + en position 1, la position des éléments initiaux de la liste étant + décalée vers la droite). + + + + + suppression + + + L(i)=null() supprime l'élément en position i de la liste L. + + + + + concaténation de deux listes + + + L3 = lstcat(L1,L2). + + + + + nombre d'éléments d'une liste + + + vous pouvez utiliser nb_elm = size(L) + ou encore nb_elm = length(L). + + + + + itérer avec une liste + + + il est possible d'utiliser une liste L pour piloter une boucle for : + for e=L,...,end est une boucle avec length(L) + itérations, la variable e de la boucle prenant la valeur L(i) + à l'itération i. + + + + + + + Remarques + + Scilab propose deux autres sortes de liste, les tlist (pour listes typées) + et les mlist qui sont très utiles pour définir de nouveaux types de + données avec possibilité de surcharge des opérateurs classiques (voir overloading). + Les tableaux multidimensionnels de scilab (les hypermatrices) sont en fait + codés comme des mlist. + + + Les structures Matlab (struct) sont aussi utilisables. + + + + Exemples + + + + Voir aussi + + + null + + + lstcat + + + tlist + + + mlist + + + insertion + + + extraction + + + size + + + length + + + + diff --git a/modules/data_structures/help/fr_FR/lstcat.xml b/modules/data_structures/help/fr_FR/lstcat.xml new file mode 100755 index 000000000..f341c1725 --- /dev/null +++ b/modules/data_structures/help/fr_FR/lstcat.xml @@ -0,0 +1,51 @@ + + + + lstcat + concaténation de listes + + + Séquence d'appel + lc=lstcat(l1,..ln) + + + Paramètres + + + li + + une liste ou une variable de type indifférent + + + + + lc + + une liste + + + + + + + Description + + lc=lstcat(l1,..ln) concatène les composantes des listes li sous forme d'une liste unique. Si les li sont des variables d'un autre type elles sont tout simplement ajoutées comme termes supplémentaires dans la liste. + + + + Exemples + + + + Voir aussi + + + list + + + + diff --git a/modules/data_structures/help/fr_FR/matrices.xml b/modules/data_structures/help/fr_FR/matrices.xml new file mode 100755 index 000000000..6d689a3e2 --- /dev/null +++ b/modules/data_structures/help/fr_FR/matrices.xml @@ -0,0 +1,60 @@ + + + + matrices + Objet Scilab, matrices + + + Description + + Les matrices sont les objets de base dans Scilab. Elles peuvent être définies de la façon suivante : + + + + Les termes eij peuvent être des nombres complexes ou réels, des polynômes, + des fraction rationnelles, des chaînes de caractères ou des booléens. + + + Les vecteurs sont vus comme des matrices à une ligne ou une colonne. + + + + Exemples + + + + Voir aussi + + + poly + + + string + + + boolean + + + rational + + + empty + + + hypermatrices + + + + diff --git a/modules/data_structures/help/fr_FR/mlist.xml b/modules/data_structures/help/fr_FR/mlist.xml new file mode 100755 index 000000000..2bcd4817c --- /dev/null +++ b/modules/data_structures/help/fr_FR/mlist.xml @@ -0,0 +1,107 @@ + + + + mlist + Objet Scilab, définition d'une liste + typée + + + + Séquence d'appel + mlist(typ,a1,....an ) + + + Paramètres + + + typ + + vecteur de chaînes de caractères + + + + ai + + + objet Scilab (matrice, liste, chaîne...). + + + + + + + Description + + Les objets de type mlist sont très similaires aux objets + de type tlist. Si M est de type mlist, pour tout + indice i qui n'est pas le nom d'un champ de la liste, + M(i) n'est pas le i-ème champ de la liste mais + est interprété comme le i-ème terme de M vu + comme un vecteur. C'est la seule différence entre mlist et + tlist. + + + Les champs des mlist doivent donc être manipulés par leur noms. Il + peuvent aussi être manipulés avec les fonctions getfield et + setfield. + + + + + Exemples + + + + Voir aussi + + + tlist + + + list + + + overloading + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/fr_FR/null.xml b/modules/data_structures/help/fr_FR/null.xml new file mode 100755 index 000000000..8e32cf321 --- /dev/null +++ b/modules/data_structures/help/fr_FR/null.xml @@ -0,0 +1,35 @@ + + + + null + suppression d'un terme d'une liste + + + Séquence d'appel + l(i)=null() + + + Description + + Suppression d'un terme d'une liste + + + + Exemples + + + + Voir aussi + + + list + + + clear + + + + diff --git a/modules/data_structures/help/fr_FR/rlist.xml b/modules/data_structures/help/fr_FR/rlist.xml new file mode 100755 index 000000000..6d57967d0 --- /dev/null +++ b/modules/data_structures/help/fr_FR/rlist.xml @@ -0,0 +1,87 @@ + + + + rlist + définition d'une fraction rationnelle + + + Séquence d'appel + [r] = rlist() + [r] = rlist(N, D [,dom]) + + + + Arguments + + + N,D + + martices polynomiales. + + + + dom + + + chaîne de caractères ou [], ou un scalaire. + + + + + r + + + tlist (liste de type "r") représentant la fraction rationnelle. + + + + + + + Description + + [r] = rlist(N, D, dom) est équivalent à + tlist(['r','num','den','dt'], N, D, dom) + + + Pour correspondre au domaine temporel d'un système linéaire, dom doit être égale à + 'c','d', [] ou à un scalaire. + D'une part, par analogie à des fonctions comme syslin, + et d'autre part, pour être compatible avec des fonctions comme tf2ss, + il est nécessaire que dom soit égale à ces valeurs. + + + + Exemples + + + + Voir aussi + + + tlist + + + syslin + + + rational + + + tf2ss + + + + diff --git a/modules/data_structures/help/fr_FR/setfield.xml b/modules/data_structures/help/fr_FR/setfield.xml new file mode 100755 index 000000000..c31cb6d61 --- /dev/null +++ b/modules/data_structures/help/fr_FR/setfield.xml @@ -0,0 +1,64 @@ + + + + setfield + insertion dans un champ d'une liste + + + Séquence d'appel + setfield(i,x,l) + + + Paramètres + + + x + + matrice de tout type + + + + + l + + variable de type list, tlist ou mlist + + + + + i + + + indice de champ, voir insertion pour plus de détails. + + + + + + + Description + + Cette fonction est équivalente à la syntaxe l(i)=x pour l'extraction avec la seule différence qu'elle s'applique aussi aux objets de type mlist. + + + + Exemples + + + + Voir aussi + + + insertion + + + + diff --git a/modules/data_structures/help/fr_FR/struct.xml b/modules/data_structures/help/fr_FR/struct.xml new file mode 100755 index 000000000..fedbf1653 --- /dev/null +++ b/modules/data_structures/help/fr_FR/struct.xml @@ -0,0 +1,91 @@ + + + + struct + creer une struct + + + Séquence d'appel + st=struct(field1,value1,field2,value2, ...) + + + Paramètres + + + field1, field2, ... + + noms des champs (chaines de caracteres) + + + + value1, value2, ... + + les valeurs des champs (acceptent tous types de données + (double, matrice de doubles,des cells, char, ...) + + + + + + + Description + + La fonction struct retourne une struct avec des noms de + champs field1, field2, .., et dont les valeurs + respectives sont value1, value2, + ... + + + Notez que type(st) retourne 17 et que typeof(st) retourne st. + + + + Exemples + + + + Voir aussi + + + cell + + + mlist + + + tlist + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/fr_FR/tlist.xml b/modules/data_structures/help/fr_FR/tlist.xml new file mode 100755 index 000000000..ca96eafde --- /dev/null +++ b/modules/data_structures/help/fr_FR/tlist.xml @@ -0,0 +1,154 @@ + + + + tlist + Objet Scilab. Définition d'une liste typée + + + Séquence d'appel + tlist(typ,a1,....an ) + + + Paramètres + + + typ + + chaîne de caractères ou matrice de chaînes de caractères + + + + + ai + + + objet Scilab (matrice, liste, chaîne...). + + + + + + + Description + + Crée une liste typée avec les éléments ai. L'argument typ + spécifie le nom du type. L'utilisateur peut redéfinir + les opérateurs et primitives de Scilab pour ces nouveaux objets à l'aide de fonctions Scilab (voir overloading). La seule différence entre les listes typées et les listes (voir list) + est la valeur numérique du type (16 au lieu de 15). + + + typ(1) spécifie le nom du type (cette chaîne de caractères est utilisée dans les noms des fonctions surchargeant les opérateurs et primitives). + + + S'il est spécifié, typ(i) donne le nom formel de l'élément i+1 (voir plus bas dans les exemples). + + + Les opérations standard sur les listes fonctionnent similairement pour les listes typées (tlist). + + + extraction + : [x,y,z...]=l(v) ou v est un vecteur d'indices; + [x,y,z]=l(:) extrait tous les éléments. + + + insertion + : l(i)=a + + + suppression : l(i)=null() supprime le i-ème + élément de la tlist l. A noter que la + sémantique de l.x=null() n'est pas définie, + mais qu'il est possible de lui donner un sens par surcharge (voir + overloading). + + + affichage + + + De plus si les composantes typ(2:n+1) sont + spécifiées, les éléments peuvent être désignés par leur noms + formels. + + + Voici quelques exemples d'utilisation des liste typées : + + + Dans Scilab, les systèmes dynamiques linéaires sont définis par une liste typée : + le quadruplet [A,B,C,D] est représenté par la tlist + Sys=tlist(['lss';'A';'B';'C';'D';'X0';'dt'],A,B,C,D,x0,'c') + et cette tlist spécifique est créée par la fonction syslin. + + + Sys(2), Sys('A') ou Sys.A est la matrice d'état et Sys('dt') ou Sys.dt est le domaine temporel. + + + Une matrice rationnelle H est représentée par la tlist + H=rlist(Num,Den,[]) où Num et Den sont deux + matrices polynomiales et un système dynamique linéaire (en temps continu) peut être créé sous la forme d'une + matrice de transfert H par syslin('c',H). + + + H(2), H('num') ou H.num est le numérateur de la matrice de transfert + + + + Exemples + f(1) + mprintf("Displaying a tlist of type: %s\n", typeof(mytlist)); + + mprintf("\n"); + + mprintf("-- Field ''%s'' --\n", f(1)); + mprintf("Contents: %s\n", sci2exp(mytlist(f(1)))); + + mprintf("\n"); + + mprintf("-- Field ''%s'' --\n", f(2)); + mprintf("Contents: %s\n", sci2exp(mytlist(f(2)))); +endfunction + +// Display using overloading function +disp(t) + ]]> + + + Voir aussi + + + null + + + percent + + + syslin + + + list + + + mlist + + + + diff --git a/modules/data_structures/help/fr_FR/type.xml b/modules/data_structures/help/fr_FR/type.xml new file mode 100755 index 000000000..25b50b5df --- /dev/null +++ b/modules/data_structures/help/fr_FR/type.xml @@ -0,0 +1,262 @@ + + + + type + Retourne le type d'une variable + + + Séquence d'appel + i =type(x) + + + Paramètres + + + x + + + objet Scilab + + + + + i + + entier + + + + + + + Description + + type(x) renvoie un entier donnant le code + numérique du type de x définit comme suit + : + + + + 1 + + matrice réelle ou complexe.. + + + + 2 + + + matrice polynomiale. + + + + + 4 + + + matrice booléenne. + + + + + 5 + + + matrice creuse. + + + + + 6 + + + matrice creuse booléenne. + + + + + 7 + + matrice creuse au format Matlab + + + + 8 + + + matrice d'entiers codés + sur 1 (int8), 2 (int16) ou 4 (int32) octets. + + + + + 9 + + + matrice de "handle" sur les objets + graphiques. + + + + + 10 + + + matrice de chaînes de caractères. + + + + + 11 + + fonction non-compilée (code Scilab). Fonction créée + par deff avec l'argument + 'n'. + + + + + 13 + + + fonction compilée (code Scilab). + + + + + 14 + + bibliothèque de fonctions. + + + + 15 + + + liste. + + + + + 16 + + + Liste typée (tlist). + + + + + 17 + + + liste typée orientée matrice (mlist). + + + + + 128 + + + pointeur (Use case: lufact). + + + + + 129 + + polynôme implicite utilisé pour indexer. + + + + 130 + + + Fonction interne Scilab, aussi appellé primitive (Code C, C++ ou + Fortran). + + + + + 0 + + + variable + nulle + + .Ce type est principalement utilisé en + interne par Scilab. Si une fonction n'a pas pas d'argument + de retour déclaré comme disp, quand + elle est appelée elle retourne une variable nulle. Si une fonction + est appellée avec un argument de la liste des arguments + d'entrée omis comme foo(a,,b) + l'argument manquant est assigné à la variable nulle. + + + Note: Si une variable + nulle + + est affectée à un nom, ce nom est + supprimé de la liste des variables définies. + x=disp(1) détruit + x. + + + + + Note: pour certaines variables, à cause de la représentation + interne, type(x) retournera + tlist (16) ou mlist (17). C'est le cas de rational, state-space, +uitree, hypermat et struct. Merci de considérer l'utilisation + de typeof à la place. + + + + Exemples + + + + Voir aussi + + + typeof + + + inttype + + + + diff --git a/modules/data_structures/help/fr_FR/typename.xml b/modules/data_structures/help/fr_FR/typename.xml new file mode 100755 index 000000000..c5010d459 --- /dev/null +++ b/modules/data_structures/help/fr_FR/typename.xml @@ -0,0 +1,96 @@ + + + + typename + associe un nom à un type de variable + + + Séquence d'appel + [types [ [,names]]=typename() + typename(name,type) + + + + Paramètres + + + types + + vecteur colonne d'entiers, les codes des types de variables + + + + + names + + vecteur colonne de chaînes de caractères, les noms associés à chaque code + + + + + type + + entier, le code d'un nouveau type de variable + + + + + name + + chaîne de caractères, le nom associé au nouveau type + + + + + + + Description + + La surcharge des opérateurs et primitives utilise des noms formels associés à + chaque type de variable pour former les noms des fonctions de surcharge + (voir overloading). typename peut être utilisé pour gérer ces noms pour les types natifs de variables (les noms formels pour les types tlist ou mlist sont définis autrement, pour ceci voir overloading). + + + Sans argument d'entrée, typename renvoie les informations associées aux types de données déjà définis. + + + Avec les arguments d'entrée, typename associe un nom à un code de type de variable. + + + typename('',type) supprime le type de donnée défini par le code passé dans type dans la table des types de variables connus. + + Nombre max de types defini est 50. + + + Exemples + + + + + Voir aussi + + + type + + + typeof + + + overloading + + + tlist + + + mlist + + + + diff --git a/modules/data_structures/help/ja_JP/addchapter.sce b/modules/data_structures/help/ja_JP/addchapter.sce new file mode 100755 index 000000000..6a729d528 --- /dev/null +++ b/modules/data_structures/help/ja_JP/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Data Structures",SCI+"/modules/data_structures/help/ja_JP",%T); + diff --git a/modules/data_structures/help/ja_JP/boolean.xml b/modules/data_structures/help/ja_JP/boolean.xml new file mode 100755 index 000000000..03d6adda0 --- /dev/null +++ b/modules/data_structures/help/ja_JP/boolean.xml @@ -0,0 +1,83 @@ + + + + boolean + Scilab オブジェクト, 論理値(boolean)変数および演算子 & | ~ + + + 説明 + + 論理値(boolean)変数の値は %T (意味: "true") または + %F (意味: "false") です. + 　　これらの変数は,論理値の行列を定義する際に通常の構文として使用可能です. + 論理値行列は要素の展開/挿入/結合など通常の行列と同様に操作することができます. + 他の一般的な処理(+, *, -, ^,など)は + 論理値行列では定義されないことに注意してください. + 以下の3種類の特別な演算子が論理値行列に関して定義されています: + + + + ~b + + + は論理値b(行列)の要素毎の否定です. + + + + + b1&b2 + + + はb1 および b2 (行列)の + 要素毎の論理積(and) です. + + + + + b1|b2 + + + はb1 および b2 (行列)の + 要素毎の論理和(or) です. + + + + + 論理値変数は行列またはベクトルの添え字として使用できます. + + + 例えば, a([%T,%F,%T],:)は, + aの 1 行目と3行目 + からなる部分行列を返します. + 論理値の疎行列もサポートされています. + + + + + + + 例 + 2) + ]]> + + + 参照 + + + matrices + + + or + + + and + + + not + + + + diff --git a/modules/data_structures/help/ja_JP/cell.xml b/modules/data_structures/help/ja_JP/cell.xml new file mode 100755 index 000000000..b5926fd97 --- /dev/null +++ b/modules/data_structures/help/ja_JP/cell.xml @@ -0,0 +1,153 @@ + + + + + cell + 空行列のセル配列を作成する. + + + 呼び出し手順 + + c=cell() + c=cell(m1) + c=cell(m1, m2) + c=cell(m1, m2, ..., mn) + c=cell(x) + + + + パラメータ + + + x + + 作成するセル配列の次元のベクトル. + + + + m1, m2,.. + + 作成するセルの次元. + + + + + + 説明 + 空行列のセルを生成,返します. + + + cell() + + + 空行列の (0,0) セル配列を返します. + + + + + cell(m1) + + + (m1,m1) は空行列のセル配列を返します. + + + + + cell(m1,m2) + + + (m1,m2) は空行列のセル配列を返します. + + + + + cell(m1,m2,..,mn) + + + (m1,m2,..,mn) は空行列のセル配列を作成します. + + + + + cell(x) + + + 最初の次元がx(1), + 2番目の次元がx(2), ...となる + 空行列のセル配列を返します. + + + + + + + 注意 + + cell(x) は + xと同じ大きさになりません. + + + cell() は + cell(0)に等しくなりです. + + A がセル配列の場合, + A(m1, m2, ..., mn).entriesにより + Aの要素の内容にアクセスすることができます. + 式 A(1,1) = zeros(2,2) は有効ではなく, + A(1,1).entries = zeros(2,2)が正しい構文となります. + + A がセル配列の場合, + A.dimsによりその次元を得ることができます. + + + + 例 + + + + 参照 + + + eye + + + ones + + + zeros + + + + diff --git a/modules/data_structures/help/ja_JP/definedfields.xml b/modules/data_structures/help/ja_JP/definedfields.xml new file mode 100755 index 000000000..5a236258d --- /dev/null +++ b/modules/data_structures/help/ja_JP/definedfields.xml @@ -0,0 +1,80 @@ + + + + + definedfields + フィールド値が定義済みのリストの添え字を返す + + + 呼び出し手順 + k=definedfields(l) + + + パラメータ + + + l + + リスト , tlist またはmlist 変数. + + + + k + + 添え字のベクトル. + + + + + + 説明 + + l が list tlist + mlist の場合, k=definedfields(l) は + リストのフィールドが定義済みの添え字kを返します. + この関数は未定義のフィールドにアクセスするとエラーとなるため, + 有用です. + + + + 例 + + + + 参照 + + + list + + + tlist + + + mlist + + + insertion + + + extraction + + + + diff --git a/modules/data_structures/help/ja_JP/fieldnames.xml b/modules/data_structures/help/ja_JP/fieldnames.xml new file mode 100755 index 000000000..53b26cf25 --- /dev/null +++ b/modules/data_structures/help/ja_JP/fieldnames.xml @@ -0,0 +1,76 @@ + + + + + fieldnames + tlist, mlist または 構造体のフィールド名を取得します + + + 呼び出し手順 + f=fieldnames(x) + + + パラメータ + + + x + + tlistまたは mlist または構造体. + + + + f + + 文字列の列ベクトル + + + + + + 説明 + + この関数は tlist, mlist, cell または構造体のフィールド名を返します. + + + + 例 + + + + 参照 + + + extraction + + + getfield + + + tlist + + + mlist + + + struct + + + + diff --git a/modules/data_structures/help/ja_JP/getfield.xml b/modules/data_structures/help/ja_JP/getfield.xml new file mode 100755 index 000000000..ab676547e --- /dev/null +++ b/modules/data_structures/help/ja_JP/getfield.xml @@ -0,0 +1,71 @@ + + + + + getfield + リストのフィールドの展開 + + + 呼び出し手順 + [x,...]=getfield(i,l) + + + パラメータ + + + x + + 任意の型の行列 + + + + l + + list, tlist または mlist変数 + + + + i + + フィールド添え字, 詳細は extraction 参照. + + + + + + 説明 + + この関数は, フィールド展開用の [x,...]=l(i) 構文と等価ですが, + 唯一の違いは, mlist オブジェクトにも適用できる + ことです. + + + + 例 + + + + 参照 + + + extraction + + + + diff --git a/modules/data_structures/help/ja_JP/hypermat.xml b/modules/data_structures/help/ja_JP/hypermat.xml new file mode 100755 index 000000000..869627e22 --- /dev/null +++ b/modules/data_structures/help/ja_JP/hypermat.xml @@ -0,0 +1,81 @@ + + + + + hypermat + N 次元行列を初期化する + + + 呼び出し手順 + M=hypermat(dims [,v]) + + + パラメータ + + + dims + + ハイパー行列の次元のベクトル + + + + v + + + ハイパー行列のエントリのベクトル (デフォルト値: zeros(prod(dims),1)) + + + + + + + 説明 + + 次元をベクトル dims ,要素をオプション引数v + で指定してハイパー行列を初期化します. + + + データ構造体 M には,行列次元のベクトルM('dims')および + エントリのベクトルM('entries') + が含まれています. + このエントリのベクトルでは, + [M(1,1,..);..;M(n1,1,..);...;M(1,n2,..);..;M(n1,n2,..);...] のように最も左のサブスクリプトがまず変化します. + + + + 例 + + + + 参照 + + + hypermatrices + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/ja_JP/hypermatrices.xml b/modules/data_structures/help/ja_JP/hypermatrices.xml new file mode 100755 index 000000000..2432c114e --- /dev/null +++ b/modules/data_structures/help/ja_JP/hypermatrices.xml @@ -0,0 +1,76 @@ + + + + + hypermatrices + Scilab オブジェクト, Scilabの N 次元行列 + + + 説明 + + ハイパー行列型により多次元配列の操作が可能です. + + + ハイパー行列型は,2次元行列を以下のように拡張することにより, + a=[1 2;3 4];a(:,:,2)=rand(2,2) + + + または直接 hypermat 関数により定義できます. + + + エントリは,実数または複素数, 多項式, 有理数, 文字列, 論理値とすることができます. + + + ハイパー行列は,以下の mlists型となります: + mlist(['hm','dims','entries'],sz,v) ,ただし, + sz は次元を含む行ベクトル, + v はエントリを含む列ベクトル (最初の次元が最初に保存されます) + + 注意: ハイパー行列の最も右の次元の数が1となる場合, + 自動的に次元が縮小されます. + 次元が2つのみのハイパー行列は,自動的に通常の行列(タイプ1)に変換されます. + + + + 例 + + + + 参照 + + + hypermat + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/ja_JP/iscell.xml b/modules/data_structures/help/ja_JP/iscell.xml new file mode 100755 index 000000000..f71a5ca34 --- /dev/null +++ b/modules/data_structures/help/ja_JP/iscell.xml @@ -0,0 +1,68 @@ + + + + + iscell + 変数がセル配列かどうかを調べる + + + 呼び出し手順 + bool = iscell(x) + + + パラメータ + + + x + + Scilab 変数 + + + + bool + + A boolean + + + + + + Description + + iscell(x) は,xがセル配列の場合に真, + それ以外の場合に偽となります. + + + + 例 + + + + 参照 + + + cell + + + isstruct + + + + diff --git a/modules/data_structures/help/ja_JP/iscellstr.xml b/modules/data_structures/help/ja_JP/iscellstr.xml new file mode 100755 index 000000000..1fd673f3f --- /dev/null +++ b/modules/data_structures/help/ja_JP/iscellstr.xml @@ -0,0 +1,74 @@ + + + + + iscellstr + 変数が文字列のセル配列であるかどうか調べる + + + 呼び出し手順 + bool = iscellstr(x) + + + パラメータ + + + x + + Scilab 変数 + + + + bool + + 論理値 + + + + + + 説明 + + iscellstr(x) は x が文字列のセル配列 + (または空のセル配列)の場合にtrue, その他の場合に false + を返します. + + + + 例 + + + + 参照 + + + cell + + + iscell + + + isstruct + + + + diff --git a/modules/data_structures/help/ja_JP/isfield.xml b/modules/data_structures/help/ja_JP/isfield.xml new file mode 100755 index 000000000..e380cca54 --- /dev/null +++ b/modules/data_structures/help/ja_JP/isfield.xml @@ -0,0 +1,99 @@ + + + + + isfield + 指定したフィールド名が構造体またはmlistまたはtlistの中にあるかどうか調べる + + + 呼び出し手順 + bool = isfield(s,fieldname) + + + 引数 + + + s + + 構造体配列, tlist または mlist + + + + fieldname + + 文字列の行列: 検出するフィールド名 + + + + bool + + + 論理値の行列 (fieldname>と同じ形式). + + + + + + + 説明 + + This function returns %t if the specified structure or tlist or mlist s includes the field fieldname, regardless of the corresponding value. For a structure, the hidden field dims is ignored. + この関数は指定した構造体 "s" がその値によらず, + フィールド "field" を有する場合に true を返します. + + + + 例 + F T T (anonymous fields can be detected) + ]]> + + + 参照 + + + struct + + + tlist + + + mlist + + + getfield + + + definedfields + + + + + 履歴 + + + 5.5 + + mlistおよびtlist用の拡張モジュール + + + + + diff --git a/modules/data_structures/help/ja_JP/isstruct.xml b/modules/data_structures/help/ja_JP/isstruct.xml new file mode 100755 index 000000000..b84b2ddf1 --- /dev/null +++ b/modules/data_structures/help/ja_JP/isstruct.xml @@ -0,0 +1,70 @@ + + + + + isstruct + 変数が構造体配列であるかどうか調べる + + + 呼び出し手順 + bool = isstruct(x) + + + パラメータ + + + x + + Scilab変数 + + + + bool + + 論理値 + + + + + + 説明 + + isstruct(x) は x が構造体配列 + の場合にtrue, その他の場合に false + を返します. + + + + 例 + + + + 参照 + + + struct + + + iscell + + + + diff --git a/modules/data_structures/help/ja_JP/list.xml b/modules/data_structures/help/ja_JP/list.xml new file mode 100755 index 000000000..887fe9e90 --- /dev/null +++ b/modules/data_structures/help/ja_JP/list.xml @@ -0,0 +1,176 @@ + + + + + list + Scilab オブジェクトおよびリスト関数定義 + + + 呼出し手順 + list(a1,....an) + + + 説明 + + 要素 aiを有するリストを作成します． + その要素は任意のScilabオブジェクト(行列, リスト,...) + です.リストオブジェクトの型は 15 です. + list() は空の リスト (要素数0)を + 返します. + + + + リストの処理 + + + 展開 + + + [x,y,z...]=L(v) ただし, + v は添え字のベクトルです; + [x,y,z]=L(:) は全要素を展開します. + + + + + 添字iに挿入 + + + L(i)=a + (i > 1 + size(L) により + L(i)=aとしてもエラーとなりませんが, + この結果いくつかのリストのエントリが未定義となり, + これらを展開する時にエラーを発生することに注意してください). + + + + + 要素を末尾に追加 + + + L($+1)=e. + + + + + 要素を先頭に追加 + + + L(0)=e. + (この操作の後, eは添字1にあり, + 最初の要素は右にシフトすることに注意してください). + + + + + 削除 + + + L(i)=null() removes the i-th element of the list L. + + + + + 二つのリストを結合 + + + L3 = lstcat(L1,L2). + + + + + リストの要素数 + + + nb_elm = size(L) + または nb_elm = length(L)のどちらかを + 使用することができます. + + + + + リストで反復処理 + + + for ループでリストL + を使用することが可能です: + for e=L,...,end は length(L) + 回の反復処理を行うループで, + ループ変数e はi番目の反復で L(i) + となります. + + + + + + + 注記 + + Scilab では他の種類のリストである tlist + 型(型付のリスト),mlist型 + も提供されています. + これらのリストは,演算子 + オーバーロード機能を + 有する新しいデータ型を定義する際に有用です + (Scilabの多次元配列である + 超越行列 + は実際にはmlistです). + + + Matlab struct も利用可能です. + + + + 例 + + + + 参照 + + + null + + + lstcat + + + tlist + + + mlist + + + insertion + + + extraction + + + size + + + length + + + + diff --git a/modules/data_structures/help/ja_JP/lstcat.xml b/modules/data_structures/help/ja_JP/lstcat.xml new file mode 100755 index 000000000..25c5f8bb1 --- /dev/null +++ b/modules/data_structures/help/ja_JP/lstcat.xml @@ -0,0 +1,63 @@ + + + + + lstcat + リストの結合 + + + 呼び出し手順 + lc=lstcat(l1,..ln) + + + パラメータ + + + li + + リストまたは任意の型の変数 + + + + lc + + リスト + + + + + + 説明 + + lc=lstcat(l1,..ln) はリストliの + 要素を結合し, 単一のリストとします. + li が他の型の変数の場合, + 単純に追加され,結果はリストとなります. + + + + 例 + + + + 参照 + + + list + + + + diff --git a/modules/data_structures/help/ja_JP/makecell.xml b/modules/data_structures/help/ja_JP/makecell.xml new file mode 100755 index 000000000..5f4d34870 --- /dev/null +++ b/modules/data_structures/help/ja_JP/makecell.xml @@ -0,0 +1,75 @@ + + + + + makecell + セル配列を作成. + + + 呼び出し手順 + s = makecell(dims,a1,a2,...an) + + + 引数 + + + dims + + + 正の整数要素を有するベクトル, セル配列の次元 + + + + + a1,a2,...,an + + + 一連のScilab変数, n は prod(dims) + に等しい必要があります + + + + + s + + + 返されるセル配列 + + + + + + + 説明 + + s= makecell(dims,a1,a2,...an) は + 指定した入力引数においてdimsで指定された次元の + 配列です. + ai には,最後の次元が最初に保存されます. + + + + 例 + + + + 参照 + + + cell + + + + diff --git a/modules/data_structures/help/ja_JP/matrices.xml b/modules/data_structures/help/ja_JP/matrices.xml new file mode 100755 index 000000000..9210d8277 --- /dev/null +++ b/modules/data_structures/help/ja_JP/matrices.xml @@ -0,0 +1,61 @@ + + + + matrices + Scilab オブジェクト, Scilabの行列 + + + 説明 + + 行列は,Scilabで定義される基本的なオブジェクトです. + 行列は以下のように定義されます: + + + + エントリ eij は, + 実数または複素数, 多項式, 有理数, 文字列, 論理値とすることができます. + + + ベクトルは,1行または1列のみを有する行列として扱われます. + + + + 例 + + + + 参照 + + + poly + + + string + + + boolean + + + rational + + + empty + + + hypermatrices + + + + diff --git a/modules/data_structures/help/ja_JP/mlist.xml b/modules/data_structures/help/ja_JP/mlist.xml new file mode 100755 index 000000000..22a0bec78 --- /dev/null +++ b/modules/data_structures/help/ja_JP/mlist.xml @@ -0,0 +1,130 @@ + + + + + mlist + Scilab オブジェクト, 型付リスト定義に向いた行列. + + + 呼び出し手順 + mlist(typ,a1,....an ) + + + パラメータ + + + typ + + 文字列のベクトル + + + + ai + + + 任意のScilabオブジェクト (matrix, list,string...). + + + + + + + 説明 + + mlist オブジェクトは tlist オブジェクトに + 非常に良く似ています. 唯一の差異は, + 展開 および + insertion 挿入の構文です: + M が mlistの場合, フィールド名でない i に関して, + M(i) はリストの i番目のフィールドではありません. + + + 展開および挿入の構文の意味付けは, overloading + 関数で指定される必要があります. + + + overloading 関数の展開構文 b=a(i1,...,in) + は以下の呼び出し手順となります + : b=%<type_of_a>_e_(i1,...,in,a) + + そして構文 + [x1,..,xm]=a(i1,...,in) は以下の呼び出し手順となります: + [x1,..,xm]=%<type_of_a>_e_(i1,...,in,a) + + + 挿入構文に関連する overloading 関数 + a(i1,...,in)=b は以下の呼び出し手順となります: + a=%<type_of_b>_i_<type_of_a>(i1,...,in,b,a). + + + mlist フィールドはそれらの名前に基づき設計される必要があります. + getfield および setfield + 関数により処理することも可能です. + + + + 例 + + + + 参照 + + + tlist + + + list + + + overloading + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/ja_JP/null.xml b/modules/data_structures/help/ja_JP/null.xml new file mode 100755 index 000000000..8cdbf6266 --- /dev/null +++ b/modules/data_structures/help/ja_JP/null.xml @@ -0,0 +1,35 @@ + + + + null + リストの要素を削除する + + + 呼出し手順 + l(i)=null() + + + 説明 + + リスト内のオブジェクトを削除します. + + + + 例 + + + + 参照 + + + list + + + clear + + + + diff --git a/modules/data_structures/help/ja_JP/rlist.xml b/modules/data_structures/help/ja_JP/rlist.xml new file mode 100755 index 000000000..6e91f9890 --- /dev/null +++ b/modules/data_structures/help/ja_JP/rlist.xml @@ -0,0 +1,48 @@ + + + + + rlist + Scilab 有理関数定義 + + + 呼び出し手順 + rlist() + rlist(a1,....an) + + + + 説明 + + rlist(a1,....an) は + tlist(['r','num';'den','dt'], a1,....an)へのショートカットです. + + + ['r','num';'den','dt']を最初のエントリ, + aiを次のエントリといったようなエントリを有する + tlistを作成します. + aiの型も大きさも確認されません. + + + + 参照 + + + tlist + + + syslin + + + + diff --git a/modules/data_structures/help/ja_JP/setfield.xml b/modules/data_structures/help/ja_JP/setfield.xml new file mode 100755 index 000000000..10a8c22b4 --- /dev/null +++ b/modules/data_structures/help/ja_JP/setfield.xml @@ -0,0 +1,71 @@ + + + + + setfield + list フィールドの挿入 + + + 呼び出し手順 + setfield(i,x,l) + + + パラメータ + + + x + + 任意の型の行列 + + + + l + + list, tlist または mlist 変数 + + + + i + + フィールド添え字, 詳細は insertion 参照. + + + + + + 説明 + + この関数は,フィールド展開を行うl(i)=x構文と等価ですが, + 唯一の差異は,mlistオブジェクトにも適用可能なことです. + + + + 例 + + + + 参照 + + + insertion + + + + diff --git a/modules/data_structures/help/ja_JP/struct.xml b/modules/data_structures/help/ja_JP/struct.xml new file mode 100755 index 000000000..fbd331b35 --- /dev/null +++ b/modules/data_structures/help/ja_JP/struct.xml @@ -0,0 +1,70 @@ + + + + + struct + 構造体を作成する + + + 呼び出し手順 + st=struct(field1,value1,field2,value2...) + + + パラメータ + + + field1, field2, .. + + フィールド名を表す文字列 + + + + value1, value2, .. + + フィールドの値を表すデータ型 (double, char, int, ...) + + + + + + 説明 + この関数はフィールド名 + fields1, field2, ..., を有し， + その値がvalue1, value2, ... + となる構造体を返します. + + + + 例 + + + + 参照 + + + cell + + + + diff --git a/modules/data_structures/help/ja_JP/tlist.xml b/modules/data_structures/help/ja_JP/tlist.xml new file mode 100755 index 000000000..c4870a41b --- /dev/null +++ b/modules/data_structures/help/ja_JP/tlist.xml @@ -0,0 +1,162 @@ + + + + + tlist + Scilab オブジェクトおよび型付のリスト定義. + + + 呼び出し手順 + tlist(typ,a1,....an ) + + + パラメータ + + + typ + + 文字列または文字列のベクトル + + + + ai + + + Scilabオブジェクト (行列, リスト,文字列...). + + + + + + + 説明 + + 要素aiを有する + 型付のリスト を作成します. + typ引数はリストの型を指定する引数です. + この 型付のリスト により + ユーザはScilab関数によりこれらのオブジェクトで動作する + 新しい処理を定義できるようになります. + 型付のリスト と リスト + の唯一の差は型の値(15ではなく16)です. + + + typ(1) はリストの型を指定します + (ソフトコードされた処理を定義するために使用される文字列) + + + typ(i) が指定された場合, + i+1番目の形式要素の名前を指定します. + + + リストにおける標準処理は + 型付リストでも類似性があります: + + + 展開 + : [x,y,z...]=l(v) ただし v は添え字のベクトルです; + [x,y,z]=l(:) は全ての要素を展開します. + + + 挿入 + : l(i)=a + + + 削除 + : l(i)=null() はtlist lの i番目の要素を削除します. + + + 表示 + + + 更にtyp(2:n+1) が指定された場合, + ユーザは名前で要素を指定することができます + + + 以下に tlist の使用例を示します. + + + 線形システムは,特定の型付リストで表されます. + 例えば,線形システム [A,B,C,D]は + tlist Sys=tlist(['lss';'A';'B';'C';'D';'X0';'dt'],A,B,C,D,x0,'c') で表されこの特別のリストは関数syslinにより + 作成することが可能です. + + + Sys(2), Sys('A') または Sys.A は状態行列で, Sys('dt') または Sys.dt は + 時間領域です + + + 有理行列 H は型付リスト + H=rlist(Num,Den,[]) + により表されます. + ただし,Num および Den + は多項式行列です. + 伝達関数行列 H を有する(連続時間)線形システムは + syslin('c',H)で作成できます. + + + H(2), H('num') または H.num は伝達関数行列の分子です. + + + + 例 + f(1) + mprintf("Displaying a tlist of type: %s\n", typeof(mytlist)); + mprintf("\n"); + mprintf("-- Field ''%s'' --\n", f(1)); + mprintf("Contents: %s\n", sci2exp(mytlist(f(1)))); + mprintf("\n"); + mprintf("-- Field ''%s'' --\n", f(2)); + mprintf("Contents: %s\n", sci2exp(mytlist(f(2)))); +endfunction +// Display using overloading function +disp(t) + ]]> + + + 参照 + + + null + + + percent + + + syslin + + + list + + + mlist + + + + diff --git a/modules/data_structures/help/ja_JP/type.xml b/modules/data_structures/help/ja_JP/type.xml new file mode 100755 index 000000000..ed799c9a4 --- /dev/null +++ b/modules/data_structures/help/ja_JP/type.xml @@ -0,0 +1,115 @@ + + + + type + 変数の型を返す + + + 呼び出し手順 + [i]=type(x) + + + パラメータ + + + x + + Scilab オブジェクト + + + + i + + 整数 + + + + + + 説明 + + type(x) は,以下のように + xの型の種類を整数で返します : + + + 1 + : 実数または複素数の定数行列. + + + 2 + : 多項式行列. + + + 4 + : 論理値行列. + + + 5 + : 疎行列. + + + 6 + : 論理値疎行列. + + + 7 + : Matlab 疎行列. + + + 8 + : 1 2 または 4 バイトに保存される整数行列. + + + 9 + : グラフィックハンドルの行列. + + + 10 + : 文字列の行列. + + + 11 + : コンパイル前の関数 (Scilab コード). + + + 13 + : コンパイル済みの関数 (Scilab コード). + + + 14 + : 関数ライブラリ. + + + 15 + : リスト. + + + 16 + : 型付リスト (tlist). + + + 17 + : 行列の型付リスト (mlist). + + + 128 + : ポインタ (lufact参照). + + + 129 + : 添字に使用される暗黙の大きさの多項式. + + + 130 + : Scilab 内部コード (C または Fortran コード). + + + + 参照 + + + typeof + + + + diff --git a/modules/data_structures/help/ja_JP/typename.xml b/modules/data_structures/help/ja_JP/typename.xml new file mode 100755 index 000000000..d52537c3f --- /dev/null +++ b/modules/data_structures/help/ja_JP/typename.xml @@ -0,0 +1,90 @@ + + + + typename + 変数の型に名前を付ける + + + 呼出し手順 + [types [ [,names]]=typename() + typename(name,type) + + + + パラメータ + + + types + + 整数列ベクトル: 各定義済みのデータ型の型コード. + + + + names + + 文字列の列ベクトル: 型コードを指す名前. + + + + type + + 整数: 新しいデータ型の型コード. + + + + name + + 文字列: 型コードを指す名前 + + + + + + 説明 + + 関数および演算子のオーバーロードにおいて, + データ型に関連付けられた汎用名を + オーバーロード関数の名前を作成する際に指定できる + できるようになります(オーバーローディング参照). + typename は, + ハードコードされたデータ型に関して + この汎用名を処理する際に使用できます + (tlist または mlistにコード化されたデータ型の + 場合,汎用名は他の方法で定義されます, overloadingを参照ください). + + + 右辺の引数を指定せずにコールされた場合, typename は + 定義済みのデータ型に関する情報を返します. + + + 右辺の引数を指定してコールされると, typename は名前を + データ型コードに関連付けます. + + + typename('',type) は, + コード type で指定されるデータ型を + データ型のテーブルから削除します. + + 定義済みの型の最大数は 50です. + + + 参照 + + + type + + + typeof + + + overloading + + + tlist + + + mlist + + + + diff --git a/modules/data_structures/help/ja_JP/typeof.xml b/modules/data_structures/help/ja_JP/typeof.xml new file mode 100755 index 000000000..3cfb86bf4 --- /dev/null +++ b/modules/data_structures/help/ja_JP/typeof.xml @@ -0,0 +1,213 @@ + + + + + typeof + オブジェクトの型 + + + 呼び出し手順 + [t]=typeof(object) + + + パラメータ + + + object + + Scilabオブジェクト + + + + t + + 文字列 + + + + + + 説明 + + t=typeof(object) は以下の文字列のどれかを返します: + + + + "constant" + + オブジェクトが実数または複素数の定数行列の場合. + + + + "polynomial" + + オブジェクトが多項式行列の場合. + + + + "function" + + オブジェクトが関数の場合 (Scilab コード). + + + + "handle" + + オブジェクトがハンドルの場合. + + + + "string" + + オブジェクトが文字列からなる行列の場合. + + + + "boolean" + + オブジェクトが論理値行列の場合. + + + + "list" + + オブジェクトがリストの場合. + + + + "rational" + + オブジェクトが有理行列(伝達行列)の場合. + + + + "state-space" + + + オブジェクトが状態空間モデルの場合(syslin参照). + + + + + "sparse" + + オブジェクトが(実数)疎行列の場合. + + + + "boolean sparse" + + オブジェクトが論理値の疎行列の場合. + + + + "hypermat" + + + オブジェクトがハイパー行列の場合(N >=3 のN次元配列). + + + + + "st" + + オブジェクトが構造体配列の場合. + + + + "ce" + + オブジェクトがセル配列の場合. + + + + the first string in the first list entry + + オブジェクトtlistまたはmlistの場合. + + + + "fptr" + + オブジェクトがScilabイントリンシック(CまたはFortranコード)の場合. + + + + "pointer" + + + オブジェクトがポインタの場合 (lufact 参照). + + + + + "size implicit" + + + オブジェクトが + 添字に使用される大きさが不明な多項式の場合 + + + + + "library" + + オブジェクトが関数ライブラリの場合. + + + + "int8" または "uint8" または "int16" または "uint16" または "int32" または "uint32" + + + オブジェクトが 8,16または32ビットに保存される[符号なしの]整数の行列の場合. + int8参照) + + + + + + + 例 + + + + 参照 + + + type + + + strings + + + syslin + + + poly + + + + diff --git a/modules/data_structures/help/pt_BR/addchapter.sce b/modules/data_structures/help/pt_BR/addchapter.sce new file mode 100755 index 000000000..b41157012 --- /dev/null +++ b/modules/data_structures/help/pt_BR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Estruturas de Dados",SCI+"/modules/data_structures/help/pt_BR",%T); + diff --git a/modules/data_structures/help/pt_BR/boolean.xml b/modules/data_structures/help/pt_BR/boolean.xml new file mode 100755 index 000000000..299b51e5d --- /dev/null +++ b/modules/data_structures/help/pt_BR/boolean.xml @@ -0,0 +1,89 @@ + + + + boolean + objetos Scilab: variveis booleanas e operadores '&', '|' + e '~' + + + + Descrio + + Uma varivel booleana %T (para "true", + "verdadeiro") ou %F (for "false"). (para + "false","falso"). Estas variveis podem ser usadas para definir matrizes + de valores booleanos, com a sintaxe usual. Matrizes de valores booleanos + podem ser manipuladas como matrizes ordinrias para extrao/insero de + elementos e concatenao. Note que outras operaes usuais ( +, *, -, ^, + etc.) no so definidas para matrizes de valores booleanos. Trs + operadores especiais so definidos para estas matrizes: + + + + ~b + + + a negao elemento a elemento de b + (matriz). + + + + + b1&b2 + + + o and ("e") lgico elemento a elemento de + b1 e b2 (matrizes). + + + + + b1|b2 + + + o or ("ou") lgico elemento a elemento de + b1 e b2 (matrizes). + + + + + Variveis booleanas podem ser usadas para se indexar vetores ou + matrizes. + + + + Por exemplo a([%T,%F,%T],:) retorna a + submatriz feita das linhas 1 e + 3 de a. Matrizes esparsas de + valores booleanos so suportadas. + + + + + + + Exemplos + + + + Ver Tambm + + + matrices + + + or + + + and + + + not + + + + diff --git a/modules/data_structures/help/pt_BR/cell.xml b/modules/data_structures/help/pt_BR/cell.xml new file mode 100755 index 000000000..41d1dab95 --- /dev/null +++ b/modules/data_structures/help/pt_BR/cell.xml @@ -0,0 +1,164 @@ + + + + + cell + cria um cell (célula) de matrizes vazias + + + Seqüência de Chamamento + + c=cell() + c=cell(m1) + c=cell(m1, m2) + c=cell(m1, m2, ..., mn) + c=cell(x) + + + + Parâmetros + + + x + + vetor contendo as dimensões do cell a ser criado + + + + m1, m2,.. + + dimensões do cell a ser criado + + + + + + Descrição + retorna um cell de matrizes vazias + + + cell() + + + retorna um cell (0,0) de matrizes + vazias. + + + + + cell(m1) + + + retorna um cell (m1,m1) de matrizes + vazias. + + + + + cell(m1,m2) + + + retorna um cell (m1,m2) de matrizes + vazias. + + + + + cell(m1,m2,..,mn) + + + retorna um cell (m1,m2,..,mn) de matrizes + vazias. + + + + + cell(x) + + retorna um cell de matrizes vazias com: a primeira dimensão + sendo x(1), a segunda sendo x(2), + ... + + + + + + + + Observações + + cell(x) não possui o mesmo tamanho que + x. + + + cell() é equivalente a + cell(0). + + Se A for um cell, você pode acessar os conteúdos de um elemento de A + utilizando A(m1, m2, ..., mn).entries. A expressão + A(1,1) = zeros(2,2) não é válida, a sintaxe correta é + A(1,1).entries = zeros(2,2). + + Se A é um cell, você pode obter suas dimensões através de + A.dims. + + + + Exemplos + + + + Ver Também + + + eye + + + ones + + + zeros + + + + diff --git a/modules/data_structures/help/pt_BR/definedfields.xml b/modules/data_structures/help/pt_BR/definedfields.xml new file mode 100755 index 000000000..e0c97ddba --- /dev/null +++ b/modules/data_structures/help/pt_BR/definedfields.xml @@ -0,0 +1,84 @@ + + + + + definedfields + retorna o ndice dos campos definidos de uma + lista + + + + Seqncia de Chamamento + k=definedfields(l) + + + Parmetros + + + l + + uma lista, tlist ou mlist + + + + k + + um vetor de ndices . + + + + + + Descrio + + Se l do tipo list + tlist mlist + k=definedfields(l) retorna em k os + ndices dos campos definidos da lista. Esta funo til porque a + indexao de campos indefinidos acarreta erros. + + + + Exemplos + + + + Ver Tambm + + + list + + + tlist + + + mlist + + + insertion + + + extraction + + + + diff --git a/modules/data_structures/help/pt_BR/getfield.xml b/modules/data_structures/help/pt_BR/getfield.xml new file mode 100755 index 000000000..e2b626b0e --- /dev/null +++ b/modules/data_structures/help/pt_BR/getfield.xml @@ -0,0 +1,72 @@ + + + + + getfield + extrao de campos de listas + + + Seqncia de Chamamento + [x,...]=getfield(i,l) + + + Parmetros + + + x + + matriz de qualquer tipo possvel + + + + l + + lista, tlist ou mlist + + + + i + + ndice de campo, ver "extraction" para mais detalhes. + + + + + + Descrio + + Esta funo equivalente sintaxe [x,...]=l(i) + para extrao de campos com a nica diferena de que tambm se aplica a + objetos mlist. + + + + Exemplos + + + + Ver Tambm + + + extraction + + + + diff --git a/modules/data_structures/help/pt_BR/hypermat.xml b/modules/data_structures/help/pt_BR/hypermat.xml new file mode 100755 index 000000000..1a0c73472 --- /dev/null +++ b/modules/data_structures/help/pt_BR/hypermat.xml @@ -0,0 +1,91 @@ + + + + + hypermat + inicializa matrizes n-dimensionais + + + Seqncia de Chamamento + M=hypermat(dims [,v]) + + + Parmetros + + + dims + + vetor de dimenses da hipermatriz + + + + v + + vetor de entradas da hipermatriz (valor padro + zeros(prod(dims),1)) + + + + + + + Descrio + Incializa uma hipermatriz cujas dimenses so dadas pelo vetor dims + e as entradas so dadas pelo argumento opcional + v + + A estrutura de dados de M contm o vetor de dimenses da matriz + M('dims') e o vetor de entradas + M('entries') tais que os ndices subescritos mais + esquerda variam primeiro: + [M(1,1,..);..;M(n1,1,..);...;M(1,n2,..);..;M(n1,n2,..);...] + + + Warning: If you build your own hypermat, you must be careful. The M('dims') entry must be a row vector whereas the M('entries') must be a column vector. + + + + Exemplos + + + + See Also + + + hypermatrices + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/pt_BR/hypermatrices.xml b/modules/data_structures/help/pt_BR/hypermatrices.xml new file mode 100755 index 000000000..c9a08ce91 --- /dev/null +++ b/modules/data_structures/help/pt_BR/hypermatrices.xml @@ -0,0 +1,80 @@ + + + + + hypermatrices + objeto do Scilab: matrizes n-dimensionais + + + Descrio + O tipo hipermatriz ("hypermatrix") permite manipular arrays + multidimensionais. + + Hipermatrizes podem ser definidas por uma extenso das matrizes 2D + como segue: a=[1 2;3 4];a(:,:,2)=rand(2,2) + + + ou usando a funo hypermat diretamente. + + As entradas podem ser nmeros reais ou complexos, polinmios, razes + de polinmios, strings ou valores booleanos. + + + Hipermatrizes so mlists: + mlist(['hm','dims','entries'],sz,v) onde + sz o vetor linha de dimenses e v + o vetor coluna de entradas (as primeiras dimenses so armazenadas + primeiro) + + NOTAS: O nmero de dimenses de hipermatrizes com tamanhos mais + direita iguais a 1 automaticamente reduzido. Uma hipermatriz com apenas + duas dimenses automaticamente trocada por uma matriz regular (tipo + 1). + + + + Exemplos + + + + Ver Tambm + + + hypermat + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/pt_BR/iscell.xml b/modules/data_structures/help/pt_BR/iscell.xml new file mode 100755 index 000000000..8e447cca7 --- /dev/null +++ b/modules/data_structures/help/pt_BR/iscell.xml @@ -0,0 +1,70 @@ + + + + + iscell + verifica se um array é um cell (célula) + + + Seqüência de Chamamento + bool = iscell(x) + + + Parâmetros + + + x + + variável Scilab + + + + bool + + um booleano + + + + + + Descrição + + iscell(x) retorna %t (verdadeiro) se x é um cell + e %f (falso) em caso contrário. + + + + Exemplos + + + + Ver Também + + + cell + + + isstruct + + + + diff --git a/modules/data_structures/help/pt_BR/iscellstr.xml b/modules/data_structures/help/pt_BR/iscellstr.xml new file mode 100755 index 000000000..f20cf1909 --- /dev/null +++ b/modules/data_structures/help/pt_BR/iscellstr.xml @@ -0,0 +1,79 @@ + + + + + iscellstr + verifica se uma variável é um cell array de + strings + + + + Seqüência de Chamamento + bool = iscellstr(x) + + + Parâmetros + + + x + + variável Scilab + + + + bool + + um booleano + + + + + + Descrição + + iscellstr(x) retorna verdadeiro se x é um cell + array de strings (ou um cell array vazio) e falso em caso + contrário. + + + + Exemplos + + + + Ver Também + + + cell + + + iscell + + + isstruct + + + + diff --git a/modules/data_structures/help/pt_BR/isstruct.xml b/modules/data_structures/help/pt_BR/isstruct.xml new file mode 100755 index 000000000..de14771f9 --- /dev/null +++ b/modules/data_structures/help/pt_BR/isstruct.xml @@ -0,0 +1,74 @@ + + + + + isstruct + checa se uma variável é um struct array + (estrutura) + + + + Seqüência de Chamamento + bool = isstruct(x) + + + Parâmetros + + + x + + variável Scilab + + + + bool + + um booleano + + + + + + Descrição + + isstruct(x) retorna %t (verdadeiro) se x é um + struct array e %f em caso contrário. + + + + Exemplos + + + + Ver Também + + + struct + + + iscell + + + + diff --git a/modules/data_structures/help/pt_BR/list.xml b/modules/data_structures/help/pt_BR/list.xml new file mode 100755 index 000000000..4d680f298 --- /dev/null +++ b/modules/data_structures/help/pt_BR/list.xml @@ -0,0 +1,175 @@ + + + + + list + objeto do Scilab e definio de lists ("listas") + + + Seqncia de Chamamento + list(a1,....an) + + + Descrio + + Cria um list com elementos + ai's que so elementos Scilab arbitrrios + (matrix, list,...). O tipo de objetos + list 15. list() cria o + list vazio (0 elementos). + + + + Operaes em Listas + + + extrao + + + [x,y,z...]=L(v) onde v + um vetor de ndices; [x,y,z]=L(:) extrai todos + os elementos. + + + + + insero no ndice i + + + L(i)=a (note que no errado usar + L(i)=a com i > 1 + + size(L) + + mas algumas entradas de lista esto ento + indefinidas e sua extrao levanta um erro). + + + + + anexar elemento no fim da lista + + + L($+1)=e. + + + + + anexar elementos no incio da lista + + + L(0)=e. (note que aps esta operao e + est no ndice 1, os elementos iniciais foram movidos para a + direita). + + + + + deleo + + + L(i)=null() remove o i-simo elemento da + lista L. + + + + + concatenao de duas listas + + + L3 = lstcat(L1,L2). + + + + + nmero de elementos de uma lista + + + voc pode usar tanto nb_elm = size(L) ou + nb_elm = length(L). + + + + + iteraes com uma lista + + + possvel usar uma lista L com um lao + ("loop") for: for + e=L,...,end + + um lao com length(L) + iteraes, a varivel de lao e sendo igual a + L(i) na i-sima iterao. + + + + + + + Observaes + + O Scilab tambm possui outros tipos de listas, o tipo tlist (lista com tipo) e o tipo mlist que so teis para definir um novo tipo de + dado com o operador overloading + facilities (hypermatrices + (hipermatrizes), que so arrays multi-dimensionais no Scilab, so, na + verdade, mlist). + + + struct do Matlab tambm esto + disponveis. + + + + Exemplos + + + + Ver Tambm + + + null + + + lstcat + + + tlist + + + mlist + + + insertion + + + extraction + + + size + + + length + + + + diff --git a/modules/data_structures/help/pt_BR/lstcat.xml b/modules/data_structures/help/pt_BR/lstcat.xml new file mode 100755 index 000000000..6304e5aa5 --- /dev/null +++ b/modules/data_structures/help/pt_BR/lstcat.xml @@ -0,0 +1,63 @@ + + + + + lstcat + concatenao de listas + + + Seqncia de Chamamento + lc=lstcat(l1,..ln) + + + Parmetros + + + li + + lista ou qualquer outro tipo de varivel + + + + lc + + uma lista + + + + + + Descrio + + lc=lstcat(l1,..ln) concatena os componentes das + li listas em uma nica lista. Se os + li so outros tipos de variveis, eles simplesmente so + adicionados lista resultante. + + + + Exemplos + + + + Ver Tambm + + + list + + + + diff --git a/modules/data_structures/help/pt_BR/matrices.xml b/modules/data_structures/help/pt_BR/matrices.xml new file mode 100755 index 000000000..84bfcde05 --- /dev/null +++ b/modules/data_structures/help/pt_BR/matrices.xml @@ -0,0 +1,58 @@ + + + + matrices + objeto do Scilab: matrizes + + + Descrio + Matrizes so objetos bsicos definidos no Scilab. Elas podem ser + definidas como segue: + + + + As entradas eij podem ser nmeros reais, + complexos, polinmios, razes de polinmios, strings ou booleanos. + + Vetores so vistos como matrizes de uma linha ou uma coluna. + + + Exemplos + + + + Ver Tambm + + + poly + + + string + + + boolean + + + rational + + + empty + + + hypermatrices + + + + diff --git a/modules/data_structures/help/pt_BR/mlist.xml b/modules/data_structures/help/pt_BR/mlist.xml new file mode 100755 index 000000000..72c3a9bed --- /dev/null +++ b/modules/data_structures/help/pt_BR/mlist.xml @@ -0,0 +1,138 @@ + + + + + mlist + objeto Scilab, definio de listas com tipos orientadas + matricialmente + + + + Seqncia de Chamamento + mlist(typ,a1,....an ) + + + Parmetros + + + typ + + vector of character strings + + + + ai + + + any Scilab object (matrix, + list,string... + + ). + + + + + + + Descrio + + Objetos mlist so bastante semelhantes a objetos tlist objects. A nica diferena concerne s + sintaxes de extrao e insero (extraction e insertion): se M uma + mlist, para qualquer ndice i que no um campo de + nome, M(i) no mais o i-simo + campo da lista + + A semntica da sintaxe de extrao e insero deve ser dada por uma + funo de (sobrecarga) overloading. + + A funo de overloading para sintaxe de extrao + b=a(i1,...,in) tem a seguinte seqncia de chamamento: + b=%<tipo_de_a>_e_(i1,...,in,a) + + + e a sintaxe [x1,..,xm]=a(i1,...,in) tem a + seguinte seqncia de chamamento: + [x1,..,xm]=%<type_de_a>_e_(i1,...,in,a) + + + A funo de overloading associada sintaxe de insero + a(i1,...,in)=b tem a seguinte seqncia de chamamento: + a=%<type_de_b>_i_<type_de_a>(i1,...,in,b,a). + + + Os campos de um mlist devem, ento, ser designados por seus nomes. + Eles tambm podem ser manipulados usando-se as funes + getfield e setfield. + + + + Exemplos + + + + Ver Tambm + + + tlist + + + list + + + overloading + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/pt_BR/null.xml b/modules/data_structures/help/pt_BR/null.xml new file mode 100755 index 000000000..e5d4b3205 --- /dev/null +++ b/modules/data_structures/help/pt_BR/null.xml @@ -0,0 +1,33 @@ + + + + null + deleta um elemento em uma lista + + + Seqncia de Chamamento + l(i)=null() + + + Descrio + Deleta objetos dentro de uma lista. + + + Exemplos + + + + Ver Tambm + + + list + + + clear + + + + diff --git a/modules/data_structures/help/pt_BR/rlist.xml b/modules/data_structures/help/pt_BR/rlist.xml new file mode 100755 index 000000000..014d1c9b2 --- /dev/null +++ b/modules/data_structures/help/pt_BR/rlist.xml @@ -0,0 +1,48 @@ + + + + + rlist + definio de funo racional do Scilab + + + Seqncia de Chamamento + rlist() + rlist(a1,....an) + + + + Descrio + + rlist(a1,....an) um atalho para + tlist(['r','num';'den','dt'], a1,....an) + + + Cria um tlist com + ['r','num';'den','dt'] como primeira entrada e os + ai's como prximas entradas, se tiver algum. Nenhuma + verificao de tipo ou tamanho feita nos ai's. + + + + Ver Tambm + + + tlist + + + syslin + + + + diff --git a/modules/data_structures/help/pt_BR/setfield.xml b/modules/data_structures/help/pt_BR/setfield.xml new file mode 100755 index 000000000..209b20fdd --- /dev/null +++ b/modules/data_structures/help/pt_BR/setfield.xml @@ -0,0 +1,73 @@ + + + + + setfield + insero de campos de listas + + + Seqncia de Chamamento + setfield(i,x,l) + + + Parmetros + + + x + + matriz de qualquer tipo + + + + l + + lista, tlist ou mlist + + + + i + + ndice de campo, ver "insertion" para mais detalhes. + + + + + + Descrio + + Esta funo equivalente sintaxe l(i)=x spara + insero de campos, com a nica diferena de que tambm se aplica a + objetos mlist. + + + + Exemplos + + + + Ver Tambm + + + insertion + + + + diff --git a/modules/data_structures/help/pt_BR/struct.xml b/modules/data_structures/help/pt_BR/struct.xml new file mode 100755 index 000000000..967da4ae9 --- /dev/null +++ b/modules/data_structures/help/pt_BR/struct.xml @@ -0,0 +1,76 @@ + + + + + struct + criando um struct (estrutura) + + + Seqncia de Chamamento + st=struct(field1,value1,field2,value2...) + + + Parmetros + + + field1, field2, .. + + strings, representam os nomes dos campos + + + + value1, value2, .. + + todos os tipos de dados (double, char, int, ...), representam + os valores dos campos + + + + + + + Descrio + Esta funo retorna uma estrutura com campos de nomes + fields1, field2, ..., e valores + correspondentes value1, value2, + ... + + + + Exemplos + + + + Ver Tambm + + + cell + + + + diff --git a/modules/data_structures/help/pt_BR/tlist.xml b/modules/data_structures/help/pt_BR/tlist.xml new file mode 100755 index 000000000..63035a32b --- /dev/null +++ b/modules/data_structures/help/pt_BR/tlist.xml @@ -0,0 +1,130 @@ + + + + + tlist + objeto do Scilab e definio de listas com tipos ("typed + lists") + + + + Seqncia de Chamamento + tlist(typ,a1,....an ) + + + Parmetros + + + typ + + string ou vetor de strings + + + + ai + + + qualquer objeto Scilab (matrix, + list,string... + + ). + + + + + + + Descrio + + Cria um typed-list com elementos + ai's. O argumento typ especifica o + tipo da lista. Tais typed-list permitem ao usurio + definir novas operaes trabalhando nestes objetos atravs de funes do + Scilab. A nica diferena entre um typed-list e um + list (lista) o valor do tipo (16 ao invs de + 15). + + + typ(1) espeifica o tipo de lista (string usado + para definir operaes "soft-coded"). + + + Se especificado, typ(i) pode fornecer o nome + formal do i+1 -simo elemento. + + + Operaes padres em list operam de modo + semelhante para typed-list: + + + Extrao : [x,y,z...]=l(v) onde + v o vetor de ndices; [x,y,z]=l(:) + extrai todos os elementos. + + + Insero: l(i)=a + + + Deleo: l(i)=null() remove o i-simo elemento do + tlist l. + + Exibio. + + Alm disso, se typ(2:n+1) forem especificados, o + usurio pode apontar elementos por seus nomes. + + Abaixo fornecemos exemplos de onde tlists so usados: + Sistemas lineares so representados por + typed-list especficos, ex.: um sistema linear + [A,B,C,D] representado pelo tlist + Sys=tlist(['lss';'A';'B';'C';'D';'X0';'dt'],A,B,C,D,x0,'c') + e esta lista especfica pode ser criada pela funo + syslin. + + Sys(2), Sys('A') ou Sys.A a estado-matriz e Sys('dt') ou Sys.dt + o domnio de tempo + + + Uma matriz de razes de polinmios H + representada por um typed-list + H=rlist(Num,Den,[]) onde + Num e Den so duas matrizes de + polinmios e um sistema linear (ex.: de tempo contnuo) com matriz de + transferncia H possivelmente criada por + syslin('c',H). + + H(2), H('num') ou H.num o numerador da matriz de + transferncia + + + + Ver Tambm + + + null + + + percent + + + syslin + + + list + + + mlist + + + + diff --git a/modules/data_structures/help/pt_BR/type.xml b/modules/data_structures/help/pt_BR/type.xml new file mode 100755 index 000000000..f1bd93bbf --- /dev/null +++ b/modules/data_structures/help/pt_BR/type.xml @@ -0,0 +1,66 @@ + + + + type + tipo de varivel + + + Seqncia de Chamamento + [i]=type(x) + + + Parmetros + + + x + + objeto Scilab + + + + i + + inteiro + + + + + + Descrio + + type(x)retorna um inteiro que indica o tipo de + x como segue: + + 1 : uma matriz constante de reais ou complexos; + 2 : uma matriz de polinmios; + 4 : uma matriz de valores booleanos; + 5 : uma matriz esparsa; + 6 : uma matriz de valores booleanos esparsa; + 7 : uma matriz esparsa do Matlab. + 8 : uma matriz de inteiros armazenados em 1, 2 ou 4 bytes; + 9 : uma matriz de manipuladores grficos; + 10 : uma matriz de strings; + 11 : uma funo no-compilada (cdigo Scilab); + 13 : uma funo compilada (cdigo Scilab); + 14 : uma biblioteca de funes; + 15 : uma lista; + 16 : uma lista com tipo ("typed list" ou "tlist"); + 17 : uma lista com tipo orientada matricialmente (mlist); + + 128 : um ponteiro (ver lufact). + + 129 : polinmio de tamanho implcito, usado para indexao. + 130 : intrnseco do Scilab (cdigo C ou Fortran). + + + Ver Tambm + + + typeof + + + inttype + + + + diff --git a/modules/data_structures/help/pt_BR/typename.xml b/modules/data_structures/help/pt_BR/typename.xml new file mode 100755 index 000000000..8782768f4 --- /dev/null +++ b/modules/data_structures/help/pt_BR/typename.xml @@ -0,0 +1,91 @@ + + + + typename + associa um nome ao tipo de varivel + + + Calling Sequence + [types [ [,names]]=typename() + typename(name,type) + + + + Parameters + + + types + + vetor coluna de inteiros: os cdigos dos tipos de cada tipo de + dado definido. + + + + + names + + vetor coluna de strings: os nomes associados aos cdigos de + tipos. + + + + + type + + inteiro: o cdigo de tipo do novo tipo de dado. + + + + name + + string: o nome associado ao cdigo de tipo + + + + + + Descrio + O overloading de funes e operadores faz uso de nomes formais + associados aos tipos de dados para formar o nome da funo de overloading + (ver overloading). typename pode ser usado para + manipular esses nomes formais para tipos de dados "hard-coded" (os nomes + formais de tipos de dados codificados de tlist ou + mlist so definidos de outra forma, ver + overloading). + + + Chamado sem argumento do lado direito, typename + retorna informaes sobre tipos de dados definidos. + + + Chamado com argumento do lado direito, typename + associa um nome a um cdigo de tipo de dado. + + + typename('',type) suprime o tipo de dado + fornecido pelo seu cdigo type de tabelas de tipos de + dados conhecidos. + + Number max. of defined types is 50. + + + Ver Tambm + + + type + + + typeof + + + overloading + + + tlist + + + mlist + + + + diff --git a/modules/data_structures/help/pt_BR/typeof.xml b/modules/data_structures/help/pt_BR/typeof.xml new file mode 100755 index 000000000..5ced03a8e --- /dev/null +++ b/modules/data_structures/help/pt_BR/typeof.xml @@ -0,0 +1,207 @@ + + + + + typeof + tipo do objeto + + + Seqncia de Chamamento + [t]=typeof(object) + + + Parmetros + + + object + + objeto Scilab + + + + t + + string + + + + + + Descrio + + t=typeof(object) retorna um dos seguintes + strings: + + + + "constant" + + se o objeto uma matriz constante de reais ou + complexos + + + + + "polynomial" + + se o objeto uma matriz de polinmios + + + + "function" + + se o objeto uma funo (cdigo Scilab). + + + + "handle" + + se o objeto um manipulador ("ala") + + + + "string" + + se o objeto uma matriz de strings + + + + "boolean" + + se o objeto uma matriz de valores booleanos + + + + "list" + + se o objeto uma lista + + + + "rational" + + se o objeto a uma martriz de razes de polinmios (matriz + de transferncia) + + + + + "state-space" + + + se o objeto um modelo de espao de estados (ver syslin). + + + + + "sparse" + + se o objeto uma matriz (de reais) esparsa. + + + + "boolean sparse" + + se o objeto uma matriz de valores booleanos esparsa. + + + + "hypermat" + + se o objeto uma hipermatriz (array N-dimensional N + >=3). + + + + + "st" + + se o objeto um array de estrutura + + + + "ce" + + se o objeto um array de clulas + + + + the first string in the first list entry + + se o objeto um tlist ou mlist + + + + "fptr" + + se o objeto intrnseco ao Scilab (cdigo C ou + Fortran). + + + + + "pointer" + + + se o objeto um ponteiro (ver lufact). + + + + + "size implicit" + + se o objeto um polinmio de tamanho implcito para + indexao. + + + + + + + Exemplos + + + + Ver Tambm + + + type + + + strings + + + syslin + + + poly + + + + diff --git a/modules/data_structures/help/ru_RU/addchapter.sce b/modules/data_structures/help/ru_RU/addchapter.sce new file mode 100755 index 000000000..9331d2503 --- /dev/null +++ b/modules/data_structures/help/ru_RU/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Data Structures",SCI+"/modules/data_structures/help/ru_RU",%T); + diff --git a/modules/data_structures/help/ru_RU/boolean.xml b/modules/data_structures/help/ru_RU/boolean.xml new file mode 100755 index 000000000..8658f8914 --- /dev/null +++ b/modules/data_structures/help/ru_RU/boolean.xml @@ -0,0 +1,80 @@ + + + + + boolean + Объекты Scilab'а, логические переменные и операторы & | ~ + + + + Описание + + Логическими переменными являются %T, ИСТИНА (англ. "true"), и %F, ЛОЖЬ (англ. "false"). Эти переменные могут использоваться для определения матриц логических значений с помощью обычного синтаксиса. С матрицами логических значений можно обращаться как с обычными матрицами для выделения/вставки элементов и конкатенации. Заметим, что другие обычные операции(+, *, -, ^ и т. д.) не определены для матриц логических значений. Для матриц логических значений определены три специальных оператора: + + + + ~b + + + поэлементное логическое НЕ матрицы b. + + + + + b1 & b2 + + + поэлементное логическое И матриц b1 и b2. + + + + + b1 | b2 + + + поэлементное логическое ИЛИ матриц b1 и b2. + + + + + + Логические переменные могут использоваться для индексации матриц и векторов. Например, a([%T, %F, %T],:) возвращает подматрицу, составленную из строк 1 и 3 матрицы a. Поддерживаются разрежённые логические матрицы. + + + + Примеры + 2) +]]> + + + Смотрите также + + + матрицы + + + or + + + and + + + not + + + + + diff --git a/modules/data_structures/help/ru_RU/cell.xml b/modules/data_structures/help/ru_RU/cell.xml new file mode 100755 index 000000000..21b35a20f --- /dev/null +++ b/modules/data_structures/help/ru_RU/cell.xml @@ -0,0 +1,169 @@ + + + + + cell + создаёт cell-массив пустых матриц + + + Последовательность вызова + + c = cell() + c = cell(m1) + c = cell(m1, m2) + c = cell(m1, m2, ..., mn) + c = cell(x) + + + + Аргументы + + + x + + + целочисленный вектор, содержащий размеры cell-массива, который требуется создать. + + + + + m1, m2, ..., mn + + + целые числа: размеры cell-массива, который + требуется создать. + + + + + + + Описание + + Функция cell возвращает cell-массив пустых матриц. + + + + cell() + + + возвращает cell-массив размером 0 x 0 пустых матриц. + + + + + cell(m1) + + + возвращает cell-массив размером m1 x m1) пустых матриц. + + + + + cell(m1, m2) + + + возвращает cell-массив размером m1 x m2 пустых матриц. + + + + + cell(m1, m2, ..., mn) + + + создаёт cell-массив размером m1 x m2 x ... x mn пустых матриц. + + + + + cell(x) + + + возвращает cell-массив пустых матриц у которого первая размерность равна x(1), вторая размерность равна x(2) и так далее. + + + + + + + Примечания + + У cell(x) не такой же размер, как у x. + + + cell() эквивалентна cell(0). + + + Если A является cell-массивом, то у вас есть + допуск к содержимому элемента A с помощью + A(m1, m2, ..., mn).entries. Инструкция + A(1,1) = zeros(2,2) не допустима, правильным + синтаксисом является A(1,1).entries = zeros(2,2). + + + Если A является cell-массивом, то вы можете получить его размеры с помощью A.dims, которое возвращает значение типа int32 и которое нельзя использовать в качестве индекса в cell-массиве. В этом случае лучше всего использовать size(A). + + + + Примеры + + + + Смотрите также + + + eye + + + ones + + + zeros + + + + + diff --git a/modules/data_structures/help/ru_RU/definedfields.xml b/modules/data_structures/help/ru_RU/definedfields.xml new file mode 100755 index 000000000..f50b6f11b --- /dev/null +++ b/modules/data_structures/help/ru_RU/definedfields.xml @@ -0,0 +1,81 @@ + + + + + definedfields + + возвращает индекс определённых полей списков + + + + Последовательность вызова + k = definedfields(lst) + + + Аргументы + + + lst + + переменная типа list, tlist или mlist. + + + + k + + вектор индексов. + + + + + + Описание + + Если lst является списком list, типизированным списком + tlist, матричноориентированным списком mlist, то k = definedfields(lst) возвращает в k индексы определённых полей списка. Эта функция полезна, поскольку индексация неопределённых полей формирует ошибку. + + + + Примеры + + + + Смотрите также + + + list + + + tlist + + + mlist + + + вставка + + + выделение + + + + diff --git a/modules/data_structures/help/ru_RU/fieldnames.xml b/modules/data_structures/help/ru_RU/fieldnames.xml new file mode 100755 index 000000000..722ce99f1 --- /dev/null +++ b/modules/data_structures/help/ru_RU/fieldnames.xml @@ -0,0 +1,81 @@ + + + + + fieldnames + + получает имена полей переменных типа tlist, mlist или struct + + + + Последовательность вызова + f = fieldnames(lst) + + + Аргументы + + + lst + + + типизированный список (tlist), матричноориентированный список (mlist) или структура (struct). + + + + + f + + вектор-столбец имён полей. + + + + + + Описание + + Функция fieldnames возвращает имена полей типизированного списка (tlist), матричноориентированного списка (mlist) или структуры (struct). Функция fieldnames не работает с cell-массивами. + + + + Примеры + + + + Смотрите также + + + выделение + + + getfield + + + tlist + + + mlist + + + struct + + + + diff --git a/modules/data_structures/help/ru_RU/getfield.xml b/modules/data_structures/help/ru_RU/getfield.xml new file mode 100755 index 000000000..41277d78d --- /dev/null +++ b/modules/data_structures/help/ru_RU/getfield.xml @@ -0,0 +1,74 @@ + + + + + getfield + выделение поля списка + + + Последовательность вызова + [x,...] = getfield(i, l) + + + Аргументы + + + x + + матрица любого всевозможного типа. + + + + l + + + список (list), типизированный список (tlist) или матричноориентированный список (mlist). + + + + + i + + + целое число: индекс поля, см. подробности в документации по выделению. + + + + + + + Описание + + Инструкция [x,...] = getfield(i, l) эквивалентна [x,...] = l(i) для выделения поля с той лишь разницей, что она может также применяться к объектам типа mlist. + + + + Примеры + + + + Смотрите также + + + выделение + + + + diff --git a/modules/data_structures/help/ru_RU/hypermat.xml b/modules/data_structures/help/ru_RU/hypermat.xml new file mode 100755 index 000000000..1f8298d42 --- /dev/null +++ b/modules/data_structures/help/ru_RU/hypermat.xml @@ -0,0 +1,96 @@ + + + + + hypermat + инициализирует N-мерную матрицу + + + Последовательность вызова + M = hypermat(dims [,v]) + + + Аргументы + + + dims + + вектор размеров гиперматрицы. + + + + v + + + вектор элементов гиперматрицы (значение по умолчанию zeros(prod(dims),1)). + + + + + + + Описание + + Функция hypermat инициализирует гиперматрицу, чьи + размеры заданы в векторе dims, а элементы заданы в + необязательном аргументе v. + + + Структура данных M содержит вектор размеров + матрицы M('dims') и вектор элементов + M('entries') такие, что первыми изменяются самые левые + индексы [M(1,1,..);..;M(n1,1,..);...;M(1,n2,..);..;M(n1,n2,..);...] + + + + Если вы строите свою собственную hypermat, то вы + должны быть осторожны. Элемент M('dims') должен быть + вектор-строкой, а элемент M('entries') должен быть вектор-столбцом. + + + + + Примеры + + + + Смотрите также + + + hypermatrices + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/ru_RU/hypermatrices.xml b/modules/data_structures/help/ru_RU/hypermatrices.xml new file mode 100755 index 000000000..e38e77a8f --- /dev/null +++ b/modules/data_structures/help/ru_RU/hypermatrices.xml @@ -0,0 +1,84 @@ + + + + + hypermatrices + объект Scilab'а, N-мерная матрица в Scilab'е + + + Описание + + Тип гиперматрицы позволяет манипулировать многомерными массивами. + + + Они могут быть определены расширением двумерных матриц следующим + образом a=[1 2;3 4];a(:,:,2)=rand(2,2) или напрямую + с помощью функции hypermat. + + + Элементы могут быть вещественными или комплексными числами, + полиномами, рациональными числами, строковыми и логическими + значениями. + + + Гиперматрицы являются матричноориентированными списками mlists: + mlist(['hm','dims','entries'],sz,v), где + sz - вектор-строка размеров, а + v - вектор-столбец элементов (первая + размерность сохраняется первой). + + + + Число размерностей гиперматрицы с самыми правыми размерами, + равными 1, автоматически уменьшается. Гиперматрица, у которой + только две размерности, автоматически меняется на обычную матрицу + (тип 1). + + + + + Примеры + + + + Смотрите также + + + hypermat + + + zeros + + + ones + + + grand + + + matrix + + + + diff --git a/modules/data_structures/help/ru_RU/iscell.xml b/modules/data_structures/help/ru_RU/iscell.xml new file mode 100755 index 000000000..812c56021 --- /dev/null +++ b/modules/data_structures/help/ru_RU/iscell.xml @@ -0,0 +1,70 @@ + + + + + iscell + проверяет: является ли переменная cell-массивом + + + Последовательность вызова + bool = iscell(x) + + + Аргументы + + + x + + переменная Scilab'а. + + + + bool + + логическое значение. + + + + + + Описание + + iscell(x) возвращает %t, если + x является cell-массивом, и %f - в противном случае. + + + + Примеры + + + + Смотрите также + + + cell + + + isstruct + + + + diff --git a/modules/data_structures/help/ru_RU/iscellstr.xml b/modules/data_structures/help/ru_RU/iscellstr.xml new file mode 100755 index 000000000..c246b3dcc --- /dev/null +++ b/modules/data_structures/help/ru_RU/iscellstr.xml @@ -0,0 +1,77 @@ + + + + + iscellstr + проверяет: является ли переменная cell-массивом строковых значений + + + Последовательность вызова + bool = iscellstr(x) + + + Аргументы + + + x + + переменная Scilab'а. + + + + bool + + логическое значение. + + + + + + Описание + + iscellstr(x) возвращает %t, + если x являетя cell-массивом строковых + значений (или пустой cell-массив), и %f - в противном случае. + + + + Примеры + + + + Смотрите также + + + cell + + + iscell + + + isstruct + + + + diff --git a/modules/data_structures/help/ru_RU/isfield.xml b/modules/data_structures/help/ru_RU/isfield.xml new file mode 100755 index 000000000..3e44bd659 --- /dev/null +++ b/modules/data_structures/help/ru_RU/isfield.xml @@ -0,0 +1,78 @@ + + + + + isfield + проверяет: существует ли поле с указанным именем в структуре + + + Последовательность вызова + bool = isfield(s, fieldname) + + + Аргументы + + + s + + массив структуры. + + + + fieldname + + матрица строк. + + + + bool + + матрица логических значений. + + + + + + Описание + + Эта функция возвращает %t, если указанная + структура s содержит поле с именем fieldname, не взирая на его значение. + + + + Примеры + + + + Смотрите также + + + struct + + + getfield + + + definedfields + + + + diff --git a/modules/data_structures/help/ru_RU/isstruct.xml b/modules/data_structures/help/ru_RU/isstruct.xml new file mode 100755 index 000000000..f6a74477b --- /dev/null +++ b/modules/data_structures/help/ru_RU/isstruct.xml @@ -0,0 +1,73 @@ + + + + + isstruct + проверяет: является ли переменная массивом-структурой + + + Последовательность вызова + bool = isstruct(x) + + + Аргументы + + + x + + переменная Scilab'а. + + + + bool + + логическое значение. + + + + + + Описание + + isstruct(x) возвращает %t, если + x является массивом-структурой, и %f - в противном случае. + + + + Примеры + + + + Смотрите также + + + struct + + + iscell + + + + + diff --git a/modules/data_structures/help/ru_RU/list.xml b/modules/data_structures/help/ru_RU/list.xml new file mode 100755 index 000000000..02a9c71cd --- /dev/null +++ b/modules/data_structures/help/ru_RU/list.xml @@ -0,0 +1,183 @@ + + + + + list + объект Scilab'а и функция определения списка + + + Последовательность вызова + list(a1, ..., an) + + + Описание + + Создаёт список list с элементами + ai, которые являются произвольными объектами Scilab'а (matrix, + list,...). Тип объекта list равен 15. list() + создаёт пустой список (0 элементов). + + + + Операции со списками + + + выделение + + + [x,y,z,...]=L(v), где v - вектор индексов; + [x,y,z,...]=L(:) выделяет все элементы. + + + + + вставка на место индекса i + + + L(i)=a (заметьте, что это не ошибка использовать L(i)=a с + 1 + size(L)]]>, но + некоторые элементы списка тогда не определены, и их + выделение вызовет ошибку). + + + + + добавление элемента в хвост + + + L($+1)=e. + + + + + добавление элемента в начало + + + L(0)=e. + + После этой операции e имеет индекс 1, исходные элементы будут сдвинуты вправо. + + + + + + удаление + + + L(i)=null() удаляет i-тый элемент списка L. + + + + + конкатенация двух списков + + + L3 = lstcat(L1,L2). + + + + + число элементов списка + + + вы можете использовать либо nb_elm = size(L), либо nb_elm = length(L). + + + + + итерации со списками + + + можно использовать список L в цикле for: + for e=L,...,end - цикл с числом + итераций length(L), переменная + цикла e будет равна L(i) + на i-той итерации. + + + + + + + Примечания + + Scilab предлагает также другие виды списков, тип tlist (типизированный список) + и тип mlist + (матричноориентированный список), которые полезны для + определения нового типа данных с механизмом + перегрузки операторов + (гиперматрицы, которые + являются многомерными массивами, в Scilab'е на самом деле + имеют тип mlist). + + + Также доступны структуры struct Matlab'а. + + + + Примеры + + + + Смотрите также + + + null + + + lstcat + + + tlist + + + mlist + + + вставка + + + выделение + + + size + + + length + + + + diff --git a/modules/data_structures/help/ru_RU/lstcat.xml b/modules/data_structures/help/ru_RU/lstcat.xml new file mode 100755 index 000000000..8ed489de9 --- /dev/null +++ b/modules/data_structures/help/ru_RU/lstcat.xml @@ -0,0 +1,64 @@ + + + + + lstcat + конкатенация списков + + + Последовательность вызова + lc = lstcat(l1, ..., ln) + + + Аргументы + + + li + + список или иной тип переменной + + + + lc + + список + + + + + + Описание + + Инструкция lc = lstcat(l1, ..., ln) + конкатенирует компоненты списки li в + единый список lc. Если + li являются переменными иного типа, + то они просто добавляются к результирующему списку. + + + + Примеры + + + + Смотрите также + + + list + + + + diff --git a/modules/data_structures/help/ru_RU/matrices.xml b/modules/data_structures/help/ru_RU/matrices.xml new file mode 100755 index 000000000..d159ffb4c --- /dev/null +++ b/modules/data_structures/help/ru_RU/matrices.xml @@ -0,0 +1,61 @@ + + + + матрицы + объект Scilab'а, матрицы в Scilab'е + + + Описание + + Матрицы являются основными объектами, определёнными в Scilab'е. + Они могут определяться следующим образом: + + + + Элементы eij могут быть вещественными или комплексными числами, + полиномами, рациональными дробями, строками, логическими значениями. + + + Векторы представляются как матрицы с одной строкой или одним столбцом. + + + + Примеры + + + + Смотрите также + + + poly + + + string + + + boolean + + + rational + + + empty + + + гиперматрицы + + + + diff --git a/modules/data_structures/help/ru_RU/mlist.xml b/modules/data_structures/help/ru_RU/mlist.xml new file mode 100755 index 000000000..0d61267ac --- /dev/null +++ b/modules/data_structures/help/ru_RU/mlist.xml @@ -0,0 +1,137 @@ + + + + + mlist + объект Scilab'а, определение матричноориентированного типизированного списка + + + + Последовательность вызова + mlist(typ, a1, ..., an) + + + Аргументы + + + typ + + вектор символьных строк. + + + + ai + + + любой объект Scilab'а (матрица, список, строка, ...). + + + + + + + Описание + + Объект mlist очень похож на объект tlist. + Единственное отличие касается синтаксиса выделения и + вставки: + если M является mlist'ом, то для любого индекса i, который не является именем поля, M(i) более не является i-тым полем списка. + + + Семантика синтаксиса выделения и вставки должна задаваться + функцией перегрузки. + + + Функция перегрузки для синтаксиса выделения b=a(i1, ..., in) + имеет следующую последовательность вызова: b=%<тип_a>_e_(i1, ..., in, a). + + и синтаксис + [x1, ..., xm]=a(i1, ..., in) имеет следующую последовательность вызова: + [x1, ..., xm]=%<тип_a>_e_(i1, ..., in,a). + + + + Функция перегрузки, связанная с синтаксисом вставки + a(i1, ..., in)=b имеет следующую последовательность вызова: + a=%<тип_b>_i_<тип_a>(i1, ..., in, b, a). + + + + Поля mlist'а должны тогда обозначаться по их + именам. Они также могут обрабатываться с помощью функций + getfield и setfield. + + + + Примеры + + + + Смотрите также + + + tlist + + + list + + + перегрузка + + + getfield + + + setfield + + + + diff --git a/modules/data_structures/help/ru_RU/null.xml b/modules/data_structures/help/ru_RU/null.xml new file mode 100755 index 000000000..7fad3936c --- /dev/null +++ b/modules/data_structures/help/ru_RU/null.xml @@ -0,0 +1,35 @@ + + + + null + удаление элемента в списке + + + Последовательность вызова + l(i)=null() + + + Описание + + Удаление объектов внутри списка. + + + + Примеры + + + + Смотрите также + + + list + + + clear + + + + diff --git a/modules/data_structures/help/ru_RU/rlist.xml b/modules/data_structures/help/ru_RU/rlist.xml new file mode 100755 index 000000000..b7670b2d9 --- /dev/null +++ b/modules/data_structures/help/ru_RU/rlist.xml @@ -0,0 +1,62 @@ + + + + + rlist + + определение функции рационального деления Scilab + + + + Последовательность вызова + rlist() + rlist(a1 ,..., an) + + + + Описание + + rlist(a1, ..., an) - сокращённая запись для + tlist(['r','num';'den','dt'], a1, ..., an). + + + rlist(a1, ..., an) создаёт tlist с ['r','num';'den','dt'] в качестве первого элемента и ai-тыми в качестве последующих элементов, если они есть. Над ai-тыми элементами не делается проверка ни типа ни размера. + + + + Примеры + + + + Смотрите также + + + tlist + + + syslin + + + rational + + + + + diff --git a/modules/data_structures/help/ru_RU/setfield.xml b/modules/data_structures/help/ru_RU/setfield.xml new file mode 100755 index 000000000..86e2bf6c3 --- /dev/null +++ b/modules/data_structures/help/ru_RU/setfield.xml @@ -0,0 +1,77 @@ + + + + + setfield + внесение поля списка + + + Последовательность вызова + setfield(i, x, l) + + + Аргументы + + + x + + матрица всевозможного типа. + + + + l + + + переменная типа list, tlist или mlist. + + + + + i + + + индекс поля, см. справку по вставке. + + + + + + + Описание + + Эта функция является эквивалентом синтаксиса l(i)=x + для вставки поля с той лишь разницей, что она также применима к объектам mlist. + + + + Примеры + + + + Смотрите также + + + вставка + + + + + diff --git a/modules/data_structures/help/ru_RU/struct.xml b/modules/data_structures/help/ru_RU/struct.xml new file mode 100755 index 000000000..8dc25680f --- /dev/null +++ b/modules/data_structures/help/ru_RU/struct.xml @@ -0,0 +1,76 @@ + + + + + struct + создаёт структуру + + + Последовательность вызова + st = struct(field1, value1, field2, value2, ...) + + + Аргументы + + + field1, field2, ... + + строки, представляющие имена полей. + + + + value1, value2, ... + + + все типы данных (double, char, int, ...), представляющие значения полей. + + + + + + + Описание + + Эта функция возвращает структуру с именами полей + fields1, field2, ..., и значениями полей, соответственно, value1, value2, ... + + + + Примеры + + + + Смотрите также + + + cell + + + + + diff --git a/modules/data_structures/help/ru_RU/tlist.xml b/modules/data_structures/help/ru_RU/tlist.xml new file mode 100755 index 000000000..fff6205bd --- /dev/null +++ b/modules/data_structures/help/ru_RU/tlist.xml @@ -0,0 +1,163 @@ + + + + + tlist + объект Scilab'а и определение типизированного списка + + + Последовательность вызова + tlist(typ, a1, ..., an) + + + Аргументы + + + typ + + + символьная строка или вектор символьных строк. + + + + + ai + + + любой объект Scilab'а (matrix, list, + string, ...). + + + + + + + Описание + + tlist(typ, a1, ..., an) создаёт типизированный список tlist с элементами ai. Аргумент typ определяет тип списка. Такой типизированный список позволяет пользователю определять новые операции, действующие над этими объектами через функции Scilab-а. Единственная разница между tlist и list состоит в значении типа (16 вместо 15). + + + typ(1) определяет тип списка (символьная строка, используемая для определения запрограммированных действий). + + + Если это определено, то typ(i) может дать (i+1)-тому элементу формальное имя. + + + Стандартные операции, определённые над списками list работают и типизированными списками tlist: + + + извлечение: + + + [x, y, z, ...]=l(v), где v - вектор индексов; + [x, y, z]=l(:) извлекает все элементы. + + + вставка: + + + l(i)=a + + + удаление: + + + l(i)=null() удаляет i-тый + элемент типизированного списка l. + + Заметьте, что семантика инструкции l.x=null() не определена, а определение может быть дано через механизм перегрузки. + + + + вывод на экран. + + + Более того, если typ(2:n+1) определены, то пользователь может обращаться к элементам по их именам. + + + Ниже приводятся примеры, где используются tlist. + + + Линейные системы представляются особыми типизированными списками, например, линейная система [A,B,C,D] представляется типизированным списком Sys=tlist(['lss';'A';'B';'C';'D';'X0';'dt'],A,B,C,D,x0,'c') + и этот особый список можно создать с помощью функции syslin. + + + Sys(2), Sys('A') или Sys.A является матрицей состояний, а Sys('dt') или Sys.dt является временной областью. + + + Матрица рациональных значений H представляется типизированным списком + H=rlist(Num,Den,[]), где Num и Den являются матрицами полиномов, а линейная система непрерывного времени с передаточной матрицей H может быть создана с помощью syslin('c',H). + + + H(2), H('num') или H.num является числителем передаточной матрицы. + + + + Примеры + f(1) + mprintf("Отображение типизированного списка типа: %s\n", typeof(mytlist)); + + mprintf("\n"); + + mprintf("-- Поле ''%s'' --\n", f(1)); + mprintf("Содержимое: %s\n", sci2exp(mytlist(f(1)))); + + mprintf("\n"); + + mprintf("-- Поле ''%s'' --\n", f(2)); + mprintf("Содержимое: %s\n", sci2exp(mytlist(f(2)))); +endfunction + +// Отображение с помощью функции перегрузки +disp(t) + ]]> + + + Смотрите также + + + процент + + + syslin + + + list + + + mlist + + + + + diff --git a/modules/data_structures/help/ru_RU/type.xml b/modules/data_structures/help/ru_RU/type.xml new file mode 100755 index 000000000..234431f02 --- /dev/null +++ b/modules/data_structures/help/ru_RU/type.xml @@ -0,0 +1,241 @@ + + + + type + возвращает тип переменной + + + Последовательность вызова + [i]=type(x) + + + Аргументы + + + x + + объект Scilab'а. + + + + i + + целое число. + + + + + + Описание + + type(x) возвращает целое число, которое равно типу x: + + + + 1 + + матрица вещественных или комплексных значений удвоенной точности (double). + + + + 2 + + + матрица полиномов. + + + + + 4 + + + матрица логических значений. + + + + + 5 + + + разрежённая матрица. + + + + + 6 + + + разрежённая матрица логических значений. + + + + + 7 + + разрежённая матрица Matlab'а. + + + + 8 + + + матрица целочисленных значений, хранимых в 1 (int8), 2 (int16) или 4 (int32) байтах. + + + + + 9 + + + матрица графических дескрипторов. + + + + + 10 + + + матрица символьных строк. + + + + + 11 + + + некомпилированная функция (Scilab-код). Функция, созданная с помощью deff с аргументом 'n'. + + + + + 13 + + + компилированная функция (Scilab code). + + + + + 14 + + + библиотека функций. + + + + + 15 + + + список (list). + + + + + 16 + + + типизированный список (tlist). + + + + + 17 + + + матричноориентированный типизированный список (mlist). + + + + + 128 + + + указатель (используется в lufact). + + + + + 129 + + + размер неявного многочлена, используемый для индексации. + + + + + 130 + + + встроенная функция Scilab'а, называемая также шлюзом (код C, C++ или Fortran). + + + + + 0 + + + нуль-переменная. Она главным образом используется внутри Scilab'а. Если функция не имеет объявленных возвращаемых аргументов, как например disp, то, когда она вызывается, она возвращает нуль-переменную. Если функция вызвана с опущенным аргументом в списке аргументов, как например foo(a,,b), то пропущенный аргумент назначается нуль-переменной. + + + + Заметьте, что, если нуль-переменная назначается имени, то оно удаляется. + x=disp(1) удаляет x. + + + + + + + + Пожалуйста, заметьте, что для некоторых переменных type вернёт tlist + или mlist в зависимости от внутренней структуры данных. Это так же для случая матрицы с + рациональными значениями, матрицы с элементами пространства состояний, гиперматрицы и структуры. Пожалуйста, используйте вместо этого typeof. + + + + + Примеры + + + + Смотрите также + + + typeof + + + inttype + + + + + diff --git a/modules/data_structures/help/ru_RU/typename.xml b/modules/data_structures/help/ru_RU/typename.xml new file mode 100755 index 000000000..be4394fbd --- /dev/null +++ b/modules/data_structures/help/ru_RU/typename.xml @@ -0,0 +1,90 @@ + + + + typename + связывает имя и тип переменной + + + Последовательность вызова + [types [ [,names]]=typename() + typename(name, type) + + + + Аргументы + + + types + + вектор-столбец целочисленных значений: коды типов каждого из определённых типов данных. + + + + names + + вектор-столбец строк: имена, связанные с кодами типов. + + + + type + + целое число: код типа нового типа данных. + + + + name + + строковое значение: имя, связанное с кодом типа. + + + + + + Описание + + Перегрузка функции и оператора позволяет использовать формальное имя, связанное с типами данных для того, чтобы формировать имя функции перегрузки (см. перегрузку). Функция typename может быть использована для управления этими формальными именами для жёстко запрограммированных типов данных (типы данных, запрограммированных с помощью tlist или mlist, определяются по-другому, см. перегрузку). + + + В случае вызова без аргументов с правой стороны, функция typename вернёт информацию по определённым типам данных. + + + В случае вызова с аргументами с правой стороны, функция typename свяжет имя и код типа данных. + + + typename('',type) удаляет тип данных, указанный по его коду type из таблицы известных типов данных. + + Максимальное число определённых типов 50. + + + Примеры + + + + Смотрите также + + + type + + + typeof + + + перегрузка + + + tlist + + + mlist + + + + + diff --git a/modules/data_structures/help/ru_RU/typeof.xml b/modules/data_structures/help/ru_RU/typeof.xml new file mode 100755 index 000000000..9e1e0e732 --- /dev/null +++ b/modules/data_structures/help/ru_RU/typeof.xml @@ -0,0 +1,244 @@ + + + + + typeof + указывает тип объекта + + + Последовательность вызова + [t]=typeof(object) + + + Аргументы + + + object + + объект Scilab'а + + + + t + + строковое значение + + + + + + Описание + + Инструкция t = typeof(object) возвращает одну из следующих строк: + + + + "constant" + + + если object - матрица вещественных или комплексных значений удвоенной точности. + + + + + "polynomial" + + + если object матрица полиномов. + + + + + "function" + + + если object - функция (Scilab-код). См. также deff. + + + + + "handle" + + + если object - дескриптор. + + + + + "string" + + + если object - матрица, составленная из символьных строк. + + + + + "boolean" + + + если object - матрица логических значений. + + + + + "list" + + + если object - список. + + + + + "rational" + + + если object - матрица рациональных чисел (передаточная матрица). + + + + + "state-space" + + + если object - модель пространства состояний (см.syslin). + + + + + "sparse" + + + если object - (вещественная) разрежённая матрица. + + + + + "boolean sparse" + + + если object - разрежённая матрица логических значений. + + + + + "hypermat" + + + если object - гиперматрица (N-мерный массив . + + + + + "st" + + + если object - структура. + + + + + "ce" + + + если object - cell-массив. + + + + + "fptr" + + + если object - встроенная Scilab-функция, называемая также шлюзом (код C, C++ или Fortran). + + + + + "pointer" + + + если object - указатель (см. lufact). + + + + + "size implicit" + + + если object - размер неявного полинома, используемый для индексации. Это чисто внутреннее значение. + + + + + "library" + + + если object - библиотека функций. + + + + + "int8" или "uint8" или "int16" или "uint16" или "int32" или "uint32" + + + если object - матрица [беззнаковых] целых чисел, хранимых в 8, 16 или 32 битах. (См. int) + + + + + + + Заметьте, что, если объект object является tlist или mlist, то typeof вернёт первое строковое значение в первом элементе списка. + + + + + Примеры + + + + Смотрите также + + + type + + + strings + + + syslin + + + poly + + + + + -- cgit