<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
pre
{mso-style-priority:99;
mso-style-link:"HTML Preformatted Char";
margin:0in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";}
span.HTMLPreformattedChar
{mso-style-name:"HTML Preformatted Char";
mso-style-priority:99;
mso-style-link:"HTML Preformatted";
font-family:Consolas;}
p.msonormal0, li.msonormal0, div.msonormal0
{mso-style-name:msonormal;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:8.5in 11.0in;
margin:70.85pt 70.85pt 70.85pt 70.85pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">Hello all,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Thanks for opening the discussion on this “new user”-related topic, this is always good to improve our help for existing user and new comers ; to let them havie a clear understanding of Scilab-lingua.
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">One important point to me is to have a proper distinction between “array” (as values organized in multiple dimensions) and more precise terms with more constraints on dimensions “horizontal vector”, “matrix”, etc… For keeping the rationale
up to date, I suggest you to edit the Localization wiki page [1].<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">In term of code update, I can help you finding duplicated messages but keep in mind that the build-system create .pot files from the source code. To look for duplicate, the more important is to upgrade the source code.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">[1]: https://wiki.scilab.org/Localization in English - Standard messages<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Note: AFAK the “constant” term has been removed on 6.0.0 documentation/error message as this is the default datatype, in case of advanced type management the term “decimal” can be used instead.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Regards,<o:p></o:p></p>
<p class="MsoNormal">Clément <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> users <users-bounces@lists.scilab.org> <b>On Behalf Of
</b>Stéphane Mottelet<br>
<b>Sent:</b> Saturday, February 20, 2021 5:35 PM<br>
<b>To:</b> users@lists.scilab.org<br>
<b>Subject:</b> Re: [Scilab-users] Some details on the documentation of log(), log10(), etc.<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p>By looking into the documentation messages I realized that we already use "array" :<o:p></o:p></p>
<p>./locale/de_DE/LC_MESSAGES/scilab.po-e:msgid "%s: Wrong type for input argument #%d: Array of double expected.\n"<o:p></o:p></p>
<p><span lang="FR">S.<o:p></o:p></span></p>
<div>
<p class="MsoNormal"><span lang="FR">Le 20/02/2021 à 17:21, Stéphane Mottelet a écrit :<o:p></o:p></span></p>
</div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<p>Hi Frederico,<o:p></o:p></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.<o:p></o:p></p>
<p>"%s: Wrong type for input argument #%d: A matrix of double expected.\n"<o:p></o:p></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.<o:p></o:p></p>
<p><span lang="FR">S.<o:p></o:p></span></p>
<div>
<p class="MsoNormal"><span lang="FR">Le 20/02/2021 à 01:29, Federico Miyara a écrit :<o:p></o:p></span></p>
</div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<p class="MsoNormal"><span lang="FR"><br>
</span><span style="font-family:"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 log10() didn't work for hyperarrays (unfortunately
</span>I <span style="font-family:"Courier New"">don't recall what version it was).<br>
<br>
In Version 6.1.0 it does work for hyperarrays, but the documentation still says that it applies to vectors or matrices:<br>
<br>
</span><a 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"><span style="font-family:"Courier New"">https://help.scilab.org/docs/6.1.0/en_US/log10.html</span></a><span style="font-family:"Courier New""><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>
</span><a 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"><span style="font-family:"Courier New"">https://help.scilab.org/docs/6.1.0/en_US/matrices.html</span></a><span style="font-family:"Courier New"">
<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>
</span><a 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"><span style="font-family:"Courier New"">https://help.scilab.org/docs/6.1.0/en_US/log.html</span></a><span style="font-family:"Courier New""><br>
<br>
However, it seems that "constant" has a specific meaning in Scilab as a predefined variable:<br>
<br>
</span><a 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"><span style="font-family:"Courier New"">https://help.scilab.org/docs/6.1.0/en_US/section_421ab29126e21a1e1e403ee27a18fda4.html</span></a><span style="font-family:"Courier New""><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>
</span><a 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"><span style="font-family:"Courier New"">https://help.scilab.org/docs/6.1.0/en_US/log2.html</span></a><span style="font-family:"Courier New""><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 </span><o:p></o:p></p>
<div id="DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2">
<p class="MsoNormal"><o:p> </o:p></p>
<table class="MsoNormalTable" border="1" cellpadding="0" style="border:none;border-top:solid #D3D4DE 1.0pt">
<tbody>
<tr>
<td width="55" style="width:41.25pt;border:none;padding:13.5pt .75pt .75pt .75pt">
<p class="MsoNormal"><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"><span style="border:solid windowtext 1.0pt;padding:0in;text-decoration:none"><img border="0" width="46" height="29" style="width:.4791in;height:.302in" id="Picture_x0020_1" src="cid:image001.jpg@01D708FF.3CF52360" alt="Image removed by sender."></span></a><o:p></o:p></p>
</td>
<td width="470" style="width:352.5pt;border:none;padding:12.75pt .75pt .75pt .75pt">
<p class="MsoNormal" style="line-height:13.5pt"><span lang="FR" style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#41424E">Libre de virus.
</span><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"><span lang="FR" style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#4453EA">www.avast.com</span></a><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#41424E">
<span lang="FR"><o:p></o:p></span></span></p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="MsoNormal"><span lang="FR"><br>
<br>
<o:p></o:p></span></p>
<pre>_______________________________________________<o:p></o:p></pre>
<pre>users mailing list<o:p></o:p></pre>
<pre><a href="mailto:users@lists.scilab.org">users@lists.scilab.org</a><o:p></o:p></pre>
<pre><a href="https://antispam.utc.fr/proxy/2/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/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><o:p></o:p></pre>
</blockquote>
<pre><span lang="FR">-- <o:p></o:p></span></pre>
<pre><span lang="FR">Stéphane Mottelet<o:p></o:p></span></pre>
<pre><span lang="FR">Ingénieur de recherche<o:p></o:p></span></pre>
<pre><span lang="FR">EA 4297 Transformations Intégrées de la Matière Renouvelable<o:p></o:p></span></pre>
<pre><span lang="FR">Département Génie des Procédés Industriels<o:p></o:p></span></pre>
<pre><span lang="FR">Sorbonne Universités - Université de Technologie de Compiègne<o:p></o:p></span></pre>
<pre><span lang="FR">CS 60319, 60203 Compiègne cedex<o:p></o:p></span></pre>
<pre><span lang="FR">Tel : +33(0)344234688<o:p></o:p></span></pre>
<pre><a href="https://antispam.utc.fr/proxy/1/c3RlcGhhbmUubW90dGVsZXRAdXRjLmZy/www.utc.fr/~mottelet"><span lang="FR">http://www.utc.fr/~mottelet</span></a><span lang="FR"><o:p></o:p></span></pre>
<p class="MsoNormal"><span lang="FR"><br>
<br>
<o:p></o:p></span></p>
<pre>_______________________________________________<o:p></o:p></pre>
<pre>users mailing list<o:p></o:p></pre>
<pre><a href="mailto:users@lists.scilab.org">users@lists.scilab.org</a><o:p></o:p></pre>
<pre><a 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><o:p></o:p></pre>
</blockquote>
<pre><span lang="FR">-- <o:p></o:p></span></pre>
<pre><span lang="FR">Stéphane Mottelet<o:p></o:p></span></pre>
<pre><span lang="FR">Ingénieur de recherche<o:p></o:p></span></pre>
<pre><span lang="FR">EA 4297 Transformations Intégrées de la Matière Renouvelable<o:p></o:p></span></pre>
<pre><span lang="FR">Département Génie des Procédés Industriels<o:p></o:p></span></pre>
<pre><span lang="FR">Sorbonne Universités - Université de Technologie de Compiègne<o:p></o:p></span></pre>
<pre><span lang="FR">CS 60319, 60203 Compiègne cedex<o:p></o:p></span></pre>
<pre><span lang="FR">Tel : +33(0)344234688<o:p></o:p></span></pre>
<pre><a href="http://www.utc.fr/~mottelet"><span lang="FR">http://www.utc.fr/~mottelet</span></a><span lang="FR"><o:p></o:p></span></pre>
</div>
</body>
</html>