<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>By looking into the documentation messages I realized that we
already use "array" :</p>
<p>./locale/de_DE/LC_MESSAGES/scilab.po-e:msgid "%s: Wrong type for
input argument #%d: Array of double expected.\n"<br>
</p>
<p>S.<br>
</p>
<div class="moz-cite-prefix">Le 20/02/2021 à 17:21, Stéphane
Mottelet a écrit :<br>
</div>
<blockquote type="cite"
cite="mid:2b315ede-b290-133b-27b5-32560225c430@utc.fr">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<p>Hi Frederico,</p>
<p>In almost all other numerical software the object defined in
Scilab by a=zeros(3,3,3) is called an "array", m=zeros(3,3) a
"matrix" and x=zeros(1,3) or y=zeros(3,1) "vectors", and all of
them are called "arrays". BTW, now the "hyper" prefix sounds
like when it is used in "hyperspace"... To me, the documentation
should be revamped to always use "array" when the denoted object
can have any number of dimensions and use "matrix" only when the
array has to be a matrix. Concerning your remark about the
"constant vector or constant matrix", yes, this should be
changed by something more explicit, like "array of double". We
already use similar terms in error messages, i.e.</p>
<p>"%s: Wrong type for input argument #%d: A matrix of double
expected.\n"</p>
<p>Hence we could synchonize the uses of localized messages with
the documentation. When I say "we" it also includes "you",
Frederico. If you feel that Scilab could be improved by a better
documentation, please contribute. If you need some help to start
using the relevant tools (git, codereview) I would be glad to
help you.</p>
<p>S.<br>
</p>
<div class="moz-cite-prefix">Le 20/02/2021 à 01:29, Federico
Miyara a écrit :<br>
</div>
<blockquote type="cite"
cite="mid:3a72f7ad-e0ad-0ae9-a4a2-cc0d4189c382@fceia.unr.edu.ar">
<meta http-equiv="content-type" content="text/html;
charset=UTF-8">
<br>
<font face="Courier New">Dear all,<br>
<br>
In an old script where I needed to apply log10 to an
hyperarray I had implemented it as log(A)/log(10) with a
comment indicating that in that version </font><font
face="Courier New">log10() didn't work for hyperarrays </font><font
face="Courier New">(unfortunately </font><font face="Courier
New">I </font><font face="Courier New">don't recall </font><font
face="Courier New">what version it was).<br>
<br>
</font><font face="Courier New">In Version 6.1.0 it does work
for hyperarrays, but the documentation still says that it
applies to vectors or matrices:<br>
<br>
<a class="moz-txt-link-freetext"
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/help.scilab.org/docs/6.1.0/en_US/log10.html"
moz-do-not-send="true">https://help.scilab.org/docs/6.1.0/en_US/log10.html</a><br>
<br>
In some contexts "matrix" may be interpreted as an hyperarray
or hypermatrix (for instance when speaking of N-D matrices),
but for Scilab a matrix is formally a two-dimensional array:<br>
<br>
<a class="moz-txt-link-freetext"
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/help.scilab.org/docs/6.1.0/en_US/matrices.html"
moz-do-not-send="true">https://help.scilab.org/docs/6.1.0/en_US/matrices.html</a>
<br>
<br>
I think the documentation should indicate that it applies to
vectors, matrices and hypermatrices<br>
<br>
Another problem is regarding log(). It says that the input
argument is a "constant vector or constant matrix":<br>
<br>
<a class="moz-txt-link-freetext"
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/help.scilab.org/docs/6.1.0/en_US/log.html"
moz-do-not-send="true">https://help.scilab.org/docs/6.1.0/en_US/log.html</a><br>
<br>
However, it seems that "constant" has a specific meaning in
Scilab as a predefined variable:<br>
<br>
<a class="moz-txt-link-freetext"
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/help.scilab.org/docs/6.1.0/en_US/section_421ab29126e21a1e1e403ee27a18fda4.html"
moz-do-not-send="true">https://help.scilab.org/docs/6.1.0/en_US/section_421ab29126e21a1e1e403ee27a18fda4.html</a><br>
<br>
As it is worded, it seems that log() is applied to predefined
variables. I think it should refer more clearly to the type
double (it doesn't work, for instance, for integer types such
as int16(2)).<br>
<br>
In the case of log2() the description of arguments is even
stranger:<br>
<br>
<a class="moz-txt-link-freetext"
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/help.scilab.org/docs/6.1.0/en_US/log2.html"
moz-do-not-send="true">https://help.scilab.org/docs/6.1.0/en_US/log2.html</a><br>
<br>
It confuses the argument section with the description, and it
specifies decimal numbers which isn't a recognized type.<br>
<br>
The function exp(), on the other hand, doesn't indicate an
output argument.<br>
<br>
I think these functions are very similar and their
documentation pages should be consistent with one another<br>
<br>
Regards,<br>
<br>
Federico Miyara <br>
</font><font face="Courier New"> </font>
<div id="DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2"><br>
<table style="border-top: 1px solid #D3D4DE;">
<tbody>
<tr>
<td style="width: 55px; padding-top: 18px;"><a
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=emailclient"
target="_blank" moz-do-not-send="true"><img
src="https://ipmcdn.avast.com/images/icons/icon-envelope-tick-round-orange-animated-no-repeat-v1.gif"
alt="" style="width: 46px; height: 29px;"
moz-do-not-send="true" width="46" height="29"></a></td>
<td style="width: 470px; padding-top: 17px; color:
#41424e; font-size: 13px; font-family: Arial,
Helvetica, sans-serif; line-height: 18px;">Libre de
virus. <a
href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=emailclient"
target="_blank" style="color: #4453ea;"
moz-do-not-send="true">www.avast.com</a> </td>
</tr>
</tbody>
</table>
<a href="#DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2" width="1"
height="1" moz-do-not-send="true"> </a></div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
users mailing list
<a class="moz-txt-link-abbreviated" href="mailto:users@lists.scilab.org" moz-do-not-send="true">users@lists.scilab.org</a>
<a class="moz-txt-link-freetext" href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/antispam.utc.fr/proxy/1/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/lists.scilab.org/mailman/listinfo/users" moz-do-not-send="true">https://antispam.utc.fr/proxy/1/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/lists.scilab.org/mailman/listinfo/users</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">--
Stéphane Mottelet
Ingénieur de recherche
EA 4297 Transformations Intégrées de la Matière Renouvelable
Département Génie des Procédés Industriels
Sorbonne Universités - Université de Technologie de Compiègne
CS 60319, 60203 Compiègne cedex
Tel : +33(0)344234688
<a class="moz-txt-link-freetext" href="https://antispam.utc.fr/proxy/1/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/www.utc.fr/~mottelet" moz-do-not-send="true">http://www.utc.fr/~mottelet</a>
</pre>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
users mailing list
<a class="moz-txt-link-abbreviated" href="mailto:users@lists.scilab.org">users@lists.scilab.org</a>
<a class="moz-txt-link-freetext" href="https://antispam.utc.fr/proxy/1/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/lists.scilab.org/mailman/listinfo/users">https://antispam.utc.fr/proxy/1/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/lists.scilab.org/mailman/listinfo/users</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">--
Stéphane Mottelet
Ingénieur de recherche
EA 4297 Transformations Intégrées de la Matière Renouvelable
Département Génie des Procédés Industriels
Sorbonne Universités - Université de Technologie de Compiègne
CS 60319, 60203 Compiègne cedex
Tel : +33(0)344234688
<a class="moz-txt-link-freetext" href="http://www.utc.fr/~mottelet">http://www.utc.fr/~mottelet</a>
</pre>
</body>
</html>