* Bug 15357 fixed: atomsGetInstalledPath() softer wrt name & version
[scilab.git] / scilab / modules / helptools / data / pages / homepage-en_US.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml">
4 <head>
5     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6     <title>Scilab Help Homepage</title>
7     <style type="text/css" media="all">
8         @import url("scilab_code.css");
9         @import url("xml_code.css");
10         @import url("c_code.css");
11         @import url("style.css");
12     </style>
13 </head>
15 <body>
16     <div class="manualnavbar" align="left">
17         <a href="https://www.scilab.org/" class="ulink">Scilab Homepage</a> |
18         <a href="https://help.scilab.org/" class="ulink">Online Help</a> |
19         <a href="https://wiki.scilab.org/" class="ulink">Wiki</a> |
20         <a href="https://bugzilla.scilab.org/" class="ulink">Bug Tracker</a> |
21         <a href="https://forge.scilab.org/" class="ulink">Forge</a> |
22         <a href="https://lists.scilab.org/" class="ulink">Mailing Lists Archives</a> |
23         <a href="https://atoms.scilab.org/" class="ulink">ATOMS</a> |
24         <a href="https://fileexchange.scilab.org/" class="ulink">File Exchange</a>
25         <hr />
26     </div>
27     <span class="path"><a href="index.html">Scilab help</a> &gt;&gt; Homepage</span>
28     <br />
29     <br />
30     <div class="refsection">
31         <h3 class="title">Welcome to Scilab 6.1</h3>
32         <p class="para">
33             Scilab 6.1 is a major new release of Scilab, the open-source
34             platform for numerical computation.
35         </p>
36         <p class="para">
37             Here is a tour of the changes between Scilab 6.0.2, &amp; 6.1.0.
38         </p>
39         <h2 class="title">Main new features</h2>
40         <p class="para">
41             In summary, the main new features are:
42             <ul>
43                 <li>Webtools utilities added for HTTP protocol, JSON data usage.</li>
44                 <li>Profiled values are available as Scilab values</li>
45                 <li>Values have a cleaner display:
46                     <ul>
47                         <li>they are displayed in order on assignment.</li>
48                         <li>strings are quoted</li>
49                         <li>complex numbers are aligned for matrices</li>
50                         <li>numbers (IEEE 754 double) are not rounded</li>
51                         <li>polynomials and rationals display is more compact</li>
52                         <li>In structures, nested lists or structures are now displayed recursively compactly and more explicitly.</li>
53                     </ul>
54                 </li>
55                 <li><code>importgui</code> function has been added to easily interface csvRead</li>
56             </ul>
57         </p>
58         <h2 class="title">Feature changes and additions</h2>
59         <ul>
60             <li><code>airy</code> is added: Evaluation of Airy functions of the first and second kind, and their first derivative,
61                 possibly scaled.</li>
62             <li>Empty strings are used as the default values on String allocation.</li>
63             <li>HTTP get, post, put, upload, patch, delete functions added.</li>
64             <li>JSON format compatibility through Scilab variables.</li>
65             <li>Memory invalid accesses have been greatly reduced thanks to :
66                 <ul>
67                     <li>PVS-Studio inspections blog report</li>
68                     <li>Coverity scan weekly source analysis</li>
69                 </ul>
70             </li>
71             <li><code>bitget</code> is upgraded:
72                 <ul>
73                     <li>It now accepts positive signed encoded integers.</li>
74                     <li>It now supports the new uint64 and int64 types of encoded integers.</li>
75                     <li>For decimal numbers: bits with indices > 52 can now be retrieved (up to <code>log2(number_properties("huge"))</code> = 1024).</li>
76                     <li>For decimal numbers <code>x &gt; 2^52</code>, queried bits below <code>%eps</code> (indices &lt; log2(x)-52) now return <code>Nan</code> instead of 0.</li>
77                     <li>Several bits can now be retrieved from each component of an input array.</li>
78                 </ul>
79             </li>
80             <li><code>bitset</code> is upgraded:
81                 <ul>
82                     <li>It now accepts positive Signed encoded integers.</li>
83                     <li>It now supports the new uint64 and int64 types of encoded integers.</li>
84                     <li>For decimal numbers: bits with indices > 32 can now be set (up to #1024).</li>
85                     <li>Several bits can now be set for each input component.</li>
86                     <li>Distributive scalar inputs are now accepted.</li>
87                 </ul>
88             </li>
89             <li><code>edit</code> now accepts a line number as text (like "23").</li>
90             <li><code>profileEnable, profileDisable, profileGetInfo</code> could be used to instrument functions and gather execution information within Scilab.</li>
91             <li><code>prettyprint</code> is upgraded:
92                 <ul>
93                     <li>Integer and Text input are now actually supported.</li>
94                     <li>Default input arguments can be skipped instead of still having to be provided.</li>
95                     <li>The result string is better formatted to be easily wrappable and indented.</li>
96                 </ul>
97             </li>
98             <li><code>mesh2d</code> has been introduced to compute a 2d mesh from vectors (x,y) of points.</li>
99             <li><code>loadmatfile</code> is upgraded:
100                 <ul>
101                     <li>Octave native text data files can now be read.</li>
102                     <li>Automatic detection of the input data format implemented.</li>
103                     <li><code>-toStruct</code> option added, to return results in a structure instead of in the calling environment.</li>
104                 </ul>
105             </li>
106             <li><code>jremove</code> is optional and <code>clear</code> could be used to release Java objects mapped to Scilab.</li>
107             <li><code>blockdiag</code> is introduced to improve, replace, and extend <code>sysdiag</code> to strings.</li>
108             <li><code>assert_checkequal</code> is upgraded:
109                 <ul>
110                     <li>support added for Nan and void in lists, Nan in sparses, implicit lists, graphic handles, macros, libraries, and built-in.</li>
111                     <li>For arrays of matching typeof and sizes, and for lists of matching lengths, the failure message now indicates the index and values of the first mismatching elements.</li>
112                 </ul>
113             </li>
114             <li><code>diophant</code> is upgraded:
115                 <ul>
116                     <li>Encoded integers are accepted, in addition to decimal numbers. Only integer solutions are then searched.</li>
117                     <li>When there is no solution, <code>[]</code> is returned.</li>
118                     <li>When there is an infinite number of solutions, the err flag has a specific value.</li>
119                     <li>The output size gets the input's size.</li>
120                 </ul>
121             </li>
122             <li><code>csvRead</code> and <code>csvTextScan</code> are now implemented without extra copies.</li>
123             <li><code>editvar</code> GUI support copy-paste of strings removing quotes.</li>
124             <li><code>calendar</code> can now display formatted calendars.</li>
125             <li><code>xmlSetValues</code> clones <code>setPreferencesValue</code> that is now obsolete.</li>
126             <li><code>unique</code> is upgraded:
127                 <ul>
128                     <li>return the number of occurrences of distinct entities found in the input array.</li>
129                     <li>return distinct entities in their initial order (rather than sorted), with the <code>"keepOrder"</code> option.</li>
130                     <li>consider all <code>Nan</code> values as the same one, with the <code>"uniqueNan"</code> option.</li>
131                 </ul>
132             </li>
133             <li><code>ellipj</code> function introduced, to compute the <code>sn, cn, dn, ns, nc and nd</code> Jacobi elliptic functions.</li>
134             <li><code>riccati</code> is upgraded:
135                 <ul>
136                     <li><code>riccati(H)</code> and <code>riccati(H, E)</code> syntaxes added, to describe the Riccati equation through its Hamiltonian H or (E,H) pencil.</li>
137                     <li>The residual is returned as a new 3rd output argument.</li>
138                     <li>When no solution is found, <code>X=[] | X1=[]</code> is returned instead of yielding an error.</li>
139                 </ul>
140             </li>
141             <li><code>hallchart</code> is upgraded:
142                 <ul>
143                     <li>The default set of modules is set automatically, according to data bounds.</li>
144                     <li>Handles of the grids and labels are returned. Post-processing them becomes easy.</li>
145                     <li>Named colors accepted; better default colors.</li>
146                     <li>Improved placement of labels.</li>
147                 </ul>
148             </li>
149             <li><code>playsnd</code> is upgraded:
150                 <ul>
151                     <li>the name of a wav file can now be specified (instead of the sound data).</li>
152                     <li>the input sound can now be repeated a given number of times.</li>
153                     <li>the modal/non-modal processing is improved.</li>
154                 </ul>
155             </li>
156             <li><code>nicholschart</code> is improved: more neutral default frame color; improved labels positioning; colors can now be specified by their predefined name or "#RRGGBB" hexa code; a structure of handles is now returned to easily post-process both subframes and the set of labels.</li>
157             <li><code>sciargs</code> returns a column instead of formerly a row.</li>
158             <li>Booleans and encoded integers can now be concatenated together, as in <code>[%f int8(-5)]</code>.</li>
159             <li><code>gsort</code> can now perform multilevel sorting. This noticeably allows sorting completely complex numbers.</li>
160             <li><code>factorial</code> can be used now from n=171 up to n=10^14.</li>
161             <li><code>intersect</code> now supports complex numbers.</li>
162             <li><code>setdiff</code> now supports complex numbers.</li>
163             <li><code>twinkle</code> can now blink together several hierarchically independent objects, like a curve and its labels, etc.</li>
164             <li><code>repmat</code> is improved: more neutral default frame color; improved labels positioning; colors can now be specified by their predefined name or "#RRGGBB" hexa code; a structure of handles is now returned to easily post-process both subframes and the set of labels.</li>
165             <li><code>plot</code> can now work in semi or bi-logarithmic mode with some input logflag.</li>
166             <li><code>plotimplicit</code> function added.</li>
167             </li>The default smarter grid_style value is now 7 instead of 3.</li>
168             <li><code>weekday</code> accepts new date formats and new syntaxes. A language option applying to the day names is now available.</li>
169             <li><code>vectorfind</code> is upgraded:
170                 <ul>
171                     <li><code>vectorfind(m, [])</code> now returns <code>[]</code> instead of an error.</li>
172                     <li>A too long needle now returns [] instead of an error.</li>
173                     <li>%nan values never matched. They are now regularly processed, as other values.</li>
174                     <li>A needle shorter than the haystack size can now be used.</li>
175                     <li>A wildcard value matching any value of the haystack can now be specified and used in the needle. Actual matching ranges can then be returned: Options `joker` and `matching` added.</li>
176                     <li>Hypermatrices are now accepted as haystack.</li>
177                     <li>The probing direction can now be numeric: 1, 2, ..</li>
178                     <li>Returned indices can now be formatted with the new option <code>indType</code>.</li>
179                     <li>There were no unit tests. More than 100 tests are added.</li>
180                 </ul>
181             </li>
182             <li><code>datafit</code> is now able to fit weighted data. It now supports any gap function vectorized for Data points, and so is much faster. It now accepts any matrix of parameters (not necessarily a colum). It now returns the average Mode-to-data distance, and the termination status for the quasi-Newton algo.</li>
183             <li><code>tree_show</code> is upgraded:
184                 <ul>
185                     <li>New <code>rootTitle</code> and <code>styles</code> optional inputs.</li>
186                     <li>New <code>arrayByFields</code> option, to allow displaying each array component as an object in its whole.</li>
187                     <li>Improved layout: detailled indices for 2D arrays, simplified symbols, etc.</li>
188                     <li>The content of implicitlist objects, and information for Scilab functions and libraries of functions are now displayed.</li>
189                 </ul>
190             </li>
191             <li><code>nchoosek</code> is introduced, to compute the binomial coefficients.</li>
192             <li>The left .\. and right ./. Kronecker divisions are now implemented, for arrays of decimal or complex numbers.</li>
193             <li><code>perms</code> can now build and return only unique permutations, without duplicates.</li>
194             <li>Most of graphic objects can be moved interactively in opened figures.</li>
195             <li><code>circshift</code> is introduced.</li>
196             <li><code>atomsGetInstalledPath</code> is no longer sensitive to the case or completeness of the modules names. Providing the modules versions is now optional.</li>
197         </ul>
198         <h2 class="title">Help pages</h2>
199         <ul>
200             <li>overhauled/rewritten: <code>bitget, edit, factorial, vectorfind, datafit</code></li>
201             <li>fixed / improved:  <code>bench_run, M_SWITCH, comet, comet3d</code></li>
202             <li>Rewritten: <code>weekday</code></li>
203             <li>Translations added:
204                 <ul>
205                     <li>ru_RU: <code>weekday</code></li>
206                 </ul>
207             </li>
208         </ul>
210         <h2 class="title">Bug fixes</h2>
211         <p class="para">
212             In this version, extra effort has been expended on bug fixing and stabilization.
213             Detailed information about those improvements can be found on the <a href="CHANGES.html">CHANGES</a> file.
214         </p>
215     </div>
216     <hr />
217     <br />
218     <div class="refsection">
219         <h3 class="title">Documentation and help</h3>
220         <p class="para">If you are new to Scilab, please use
221             the <a href="https://www.scilab.org/sites/default/files/Scilab_beginners_0.pdf">Scilab
222                 beginners tutorial</a>
223             and <a href="https://www.scilab.org/sites/default/files/Xcos_beginners_0.pdf">Xcos
224                 beginners tutorial</a> provided by the Scilab Team.</p>
225         <p class="para">The Scilab Team provides also
226             some <a href="https://www.scilab.org/tutorials">documentation
227                 and tutorials</a>.</p>
228         <br />
229     </div>
230     <hr />
231     <br />
232     <div class="refsection">
233         <h3 class="title">Other resources</h3>
234         <p class="para"><a href="https://www.scilab.org/" class="ulink">Scilab Homepage</a> - Consult Scilab official
235             website</p>
236         <p class="para"><a href="https://wiki.scilab.org/" class="ulink">Wiki</a> - Consult documentations, tricks, etc.
237         </p>
238         <p class="para"><a href="https://bugzilla.scilab.org/" class="ulink">Bug Tracker</a> - Report bugs and wishes
239             about Scilab</p>
240         <p class="para"><a href="https://forge.scilab.org/" class="ulink">Forge</a> - Browse and publish Scilab modules
241         </p>
242         <p class="para"><a href="https://www.scilab.org/about/community/mailing-lists" class="ulink">Mailing Lists</a> -
243             Communicate and exchange with the community</p>
244         <p class="para"><a href="https://atoms.scilab.org/" class="ulink">ATOMS</a> - Browse Scilab packaged modules</p>
245         <p class="para"><a href="https://fileexchange.scilab.org/" class="ulink">File Exchange</a> - Exchange your
246             scripts, results and files.</p>
247         <br />
248     </div>
249 </body>
251 </html>