From afeec59b2e951dc6f21079c98f3bf3434c436426 Mon Sep 17 00:00:00 2001 From: Allan CORNET Date: Wed, 29 Nov 2023 19:22:16 +0100 Subject: [PATCH] v0.7.11 --- en/README.md | 2 +- en/SUMMARY.md | 35 +- en/changelogs/CHANGELOG.md | 35 + en/elementary_functions/README.md | 2 + en/elementary_functions/SUMMARY.md | 2 + en/elementary_functions/deal.md | 60 + en/elementary_functions/substruct.md | 37 + en/graphics/README.md | 7 + en/graphics/SUMMARY.md | 7 + en/graphics/bar.md | 92 + en/graphics/bar_1_ED314971.svg | 616 + en/graphics/bar_2_44FBF53F.svg | 616 + en/graphics/bar_3_1A531EA7.svg | 650 + en/graphics/bar_4_8986F29.svg | 675 + en/graphics/bar_5_105AE2EC.svg | 616 + en/graphics/fill.md | 113 + en/graphics/fill_1_139BD470.svg | 834 + en/graphics/fill_2_73FE3B21.svg | 588 + en/graphics/fill_3_9BC84302.svg | 772 + en/graphics/hist.md | 56 + en/graphics/hist_1_FD61AA81.svg | 3498 +++ en/graphics/patch.md | 15 + en/graphics/patch_4_F3B9E78.svg | 568 + en/graphics/pie.md | 83 + en/graphics/pie_1_802BD829.svg | 123 + en/graphics/pie_2_C81A99E7.svg | 179 + en/graphics/pie_3_F8E2731B.svg | 151 + en/graphics/pie_4_FB380473.svg | 322 + en/graphics/quiver.md | 4 +- en/graphics/scatter.md | 140 + en/graphics/scatter_1_CAF48F8D.svg | 7761 +++++++ en/graphics/scatter_2_220DC9DC.svg | 3746 +++ en/graphics/scatter_3_D671E61.svg | 5021 ++++ en/graphics/scatter_4_7C886888.svg | 3489 +++ en/graphics/scatter_5_E289BA04.svg | 2771 +++ en/graphics/scatter_6_1E831925.svg | 30741 +++++++++++++++++++++++++ en/graphics/stairs.md | 78 + en/graphics/stairs_1_F17087DF.svg | 596 + en/graphics/stairs_2_CF83A4A1.svg | 1920 ++ en/graphics/stem.md | 77 + en/graphics/stem_1_8A2709D0.svg | 956 + en/graphics/stem_2_B7720690.svg | 2041 ++ en/operators/README.md | 2 + en/operators/SUMMARY.md | 2 + en/operators/subsasgn.md | 45 + en/operators/subsref.md | 61 + en/overload/overloading.md | 2 +- en/stream_manager/fprintf.md | 7 + en/string/sprintf.md | 7 + fr/README.md | 2 +- fr/changelogs/CHANGELOG.md | 35 + 51 files changed, 70241 insertions(+), 17 deletions(-) create mode 100644 en/elementary_functions/deal.md create mode 100644 en/elementary_functions/substruct.md create mode 100644 en/graphics/bar.md create mode 100644 en/graphics/bar_1_ED314971.svg create mode 100644 en/graphics/bar_2_44FBF53F.svg create mode 100644 en/graphics/bar_3_1A531EA7.svg create mode 100644 en/graphics/bar_4_8986F29.svg create mode 100644 en/graphics/bar_5_105AE2EC.svg create mode 100644 en/graphics/fill.md create mode 100644 en/graphics/fill_1_139BD470.svg create mode 100644 en/graphics/fill_2_73FE3B21.svg create mode 100644 en/graphics/fill_3_9BC84302.svg create mode 100644 en/graphics/hist.md create mode 100644 en/graphics/hist_1_FD61AA81.svg create mode 100644 en/graphics/patch_4_F3B9E78.svg create mode 100644 en/graphics/pie.md create mode 100644 en/graphics/pie_1_802BD829.svg create mode 100644 en/graphics/pie_2_C81A99E7.svg create mode 100644 en/graphics/pie_3_F8E2731B.svg create mode 100644 en/graphics/pie_4_FB380473.svg create mode 100644 en/graphics/scatter.md create mode 100644 en/graphics/scatter_1_CAF48F8D.svg create mode 100644 en/graphics/scatter_2_220DC9DC.svg create mode 100644 en/graphics/scatter_3_D671E61.svg create mode 100644 en/graphics/scatter_4_7C886888.svg create mode 100644 en/graphics/scatter_5_E289BA04.svg create mode 100644 en/graphics/scatter_6_1E831925.svg create mode 100644 en/graphics/stairs.md create mode 100644 en/graphics/stairs_1_F17087DF.svg create mode 100644 en/graphics/stairs_2_CF83A4A1.svg create mode 100644 en/graphics/stem.md create mode 100644 en/graphics/stem_1_8A2709D0.svg create mode 100644 en/graphics/stem_2_B7720690.svg create mode 100644 en/operators/subsasgn.md create mode 100644 en/operators/subsref.md diff --git a/en/README.md b/en/README.md index 977c51dc..1ffde0f1 100644 --- a/en/README.md +++ b/en/README.md @@ -1,6 +1,6 @@ ![banner](banner_homepage.png) -### Nelson 0.7.10.0 +### Nelson 0.7.11.0 This is an pre-release of Nelson. diff --git a/en/SUMMARY.md b/en/SUMMARY.md index 4f10a943..d4ff42bd 100644 --- a/en/SUMMARY.md +++ b/en/SUMMARY.md @@ -333,7 +333,9 @@ - [rdivide](./operators/rdivide.md) - [shortcutand](./operators/shortcutand.md) - [shortcutor](./operators/shortcutor.md) + - [subsasgn](./operators/subsasgn.md) - [subsindex](./operators/subsindex.md) + - [subsref](./operators/subsref.md) - [mtimes](./operators/times.md) - [transpose](./operators/transpose.md) - [uminus](./operators/uminus.md) @@ -353,6 +355,7 @@ - [circshift](./elementary_functions/circshift.md) - [complex](./elementary_functions/complex.md) - [conj](./elementary_functions/conj.md) + - [deal](./elementary_functions/deal.md) - [dec2base](./elementary_functions/dec2base.md) - [dec2bin](./elementary_functions/dec2bin.md) - [dec2hex](./elementary_functions/dec2hex.md) @@ -420,6 +423,7 @@ - [sqrt](./elementary_functions/sqrt.md) - [squeeze](./elementary_functions/squeeze.md) - [sub2ind](./elementary_functions/sub2ind.md) + - [substruct](./elementary_functions/substruct.md) - [swapbytes](./elementary_functions/swapbytes.md) - [toeplitz](./elementary_functions/toeplitz.md) - [tril](./elementary_functions/tril.md) @@ -441,18 +445,6 @@ - [sort](./data_analysis/sort.md) - [sum](./data_analysis/sum.md) -- [special_functions](./special_functions/README.md) - - - [betainc](./special_functions/betainc.md) - - [cross](./special_functions/cross.md) - - [dot](./special_functions/dot.md) - - [factor](./special_functions/factor.md) - - [gamma](./special_functions/gamma.md) - - [gcd](./special_functions/gcd.md) - - [interp1](./special_functions/interp1.md) - - [peaks](./special_functions/peaks.md) - - [primes](./special_functions/primes.md) - - [trigonometric_functions](./trigonometric_functions/README.md) - [acos](./trigonometric_functions/acos.md) @@ -592,6 +584,18 @@ - [slicot_tb01id](./slicot/slicot_tb01id.md) - [slicot_tg01ad](./slicot/slicot_tg01ad.md) +- [special_functions](./special_functions/README.md) + + - [betainc](./special_functions/betainc.md) + - [cross](./special_functions/cross.md) + - [dot](./special_functions/dot.md) + - [factor](./special_functions/factor.md) + - [gamma](./special_functions/gamma.md) + - [gcd](./special_functions/gcd.md) + - [interp1](./special_functions/interp1.md) + - [peaks](./special_functions/peaks.md) + - [primes](./special_functions/primes.md) + - [fftw](./fftw/README.md) - [FFTW License](./fftw/About_FFTW_license.md) @@ -799,6 +803,7 @@ - [autumn](./graphics/autumn.md) - [axes](./graphics/axes.md) - [axis](./graphics/axis.md) + - [bar](./graphics/bar.md) - [bone](./graphics/bone.md) - [cla](./graphics/cla.md) - [clf](./graphics/clf.md) @@ -813,12 +818,14 @@ - [cylinder](./graphics/cylinder.md) - [drawnow](./graphics/drawnow.md) - [figure](./graphics/figure.md) + - [fill](./graphics/fill.md) - [gca](./graphics/gca.md) - [gcf](./graphics/gcf.md) - [gray](./graphics/gray.md) - [grid](./graphics/grid.md) - [groot](./graphics/groot.md) - [hggroup](./graphics/hggroup.md) + - [hist](./graphics/hist.md) - [hold](./graphics/hold.md) - [hot](./graphics/hot.md) - [image](./graphics/image.md) @@ -840,6 +847,7 @@ - [parula](./graphics/parula.md) - [patch](./graphics/patch.md) - [pcolor](./graphics/pcolor.md) + - [pie](./graphics/pie.md) - [pink](./graphics/pink.md) - [plot](./graphics/plot.md) - [plot3](./graphics/plot3.md) @@ -848,11 +856,14 @@ - [rgbplot](./graphics/rgbplot.md) - [ribbon](./graphics/ribbon.md) - [saveas](./graphics/saveas.md) + - [scatter](./graphics/scatter.md) - [semilogx](./graphics/semilogx.md) - [semilogy](./graphics/semilogy.md) - [sphere](./graphics/sphere.md) - [spring](./graphics/spring.md) - [spy](./graphics/spy.md) + - [stairs](./graphics/stairs.md) + - [stem](./graphics/stem.md) - [subplot](./graphics/subplot.md) - [summer](./graphics/summer.md) - [surf](./graphics/surf.md) diff --git a/en/changelogs/CHANGELOG.md b/en/changelogs/CHANGELOG.md index 39798265..f5563c86 100644 --- a/en/changelogs/CHANGELOG.md +++ b/en/changelogs/CHANGELOG.md @@ -4,6 +4,41 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). +## 0.7.11 (2023-11-29) + +### Added + +- `hist` Histogram plot. +- `bar` Bar graph. +- `scatter` Scatter plot. +- `stem` Plot discrete sequence data. +- `stairs` Stairstep graph. +- `fill` 2-D patch. +- `pie` legacy pie chart. +- `subsref` Subscripted reference. +- `subsasgn` Redefine subscripted assignment. +- `substruct` Create structure argument for subsasgn or subsref. +- `deal` Distribute inputs to outputs. +- Intel compiler support. + +### Changed + +- axis limits recalculate with `hggroup`. +- `axes` forces focus on current axe. +- function_handle parenthese precedence. +- `patch` and `fill` manages `FaceAlpha`. +- visibility title and labels. +- object constructor must be in '@' directory and no more in parent directory (compatibility). +- `subsref`, `subsasgn` compatibility with `substruct`. +- To display a percent sign, you need to use a double percent sign (%%) in the format string (compatibility). +- French translation updated (100%, Thanks to weblate contributors) +- [#997](http://github.com/Nelson-numerical-software/nelson/issues/997) Macos BigSur Github CI support removed. +- Qt 6.6.1 on win64 CI build. + +### Fixed + +- `A = []; A(false) = zeros(3, 0)` did not return an empty matrix but an error. + ## 0.7.10 (2023-10-27) ### Added diff --git a/en/elementary_functions/README.md b/en/elementary_functions/README.md index 79a48de1..e72475f5 100644 --- a/en/elementary_functions/README.md +++ b/en/elementary_functions/README.md @@ -17,6 +17,7 @@ elementary functions - [circshift](circshift.md) - Circular shift - [complex](complex.md) - Creates an complex number. - [conj](conj.md) - Complex conjugate +- [deal](deal.md) - Distribute inputs to outputs. - [dec2base](dec2base.md) - Convert decimal number to another base. - [dec2bin](dec2bin.md) - Convert decimal number to base 2. - [dec2hex](dec2hex.md) - Convert decimal number to base 16. @@ -84,6 +85,7 @@ elementary functions - [sqrt](sqrt.md) - Square root. - [squeeze](squeeze.md) - Remove dimensions of length 1. - [sub2ind](sub2ind.md) - Matrix subscript values to linear index +- [substruct](substruct.md) - Create structure argument for subsasgn or subsref - [swapbytes](swapbytes.md) - Swap byte ordering. - [toeplitz](toeplitz.md) - Toeplitz matrix - [tril](tril.md) - Lower triangular part of matrix diff --git a/en/elementary_functions/SUMMARY.md b/en/elementary_functions/SUMMARY.md index 9048bc7c..3b8bd894 100644 --- a/en/elementary_functions/SUMMARY.md +++ b/en/elementary_functions/SUMMARY.md @@ -10,6 +10,7 @@ - [circshift](circshift.md) - [complex](complex.md) - [conj](conj.md) + - [deal](deal.md) - [dec2base](dec2base.md) - [dec2bin](dec2bin.md) - [dec2hex](dec2hex.md) @@ -77,6 +78,7 @@ - [sqrt](sqrt.md) - [squeeze](squeeze.md) - [sub2ind](sub2ind.md) + - [substruct](substruct.md) - [swapbytes](swapbytes.md) - [toeplitz](toeplitz.md) - [tril](tril.md) diff --git a/en/elementary_functions/deal.md b/en/elementary_functions/deal.md new file mode 100644 index 00000000..2b824e6a --- /dev/null +++ b/en/elementary_functions/deal.md @@ -0,0 +1,60 @@ +# deal + +Distribute inputs to outputs. + +## Syntax + +- [R1, ... , Rn] = deal(A1, ... , An) +- [R1, ... , Rn] = deal(A) + +## Input argument + +- A1, ... , An - variables + +## Output argument + +- R1, ... , Rn - variables + +## Description + +

deal replicates the input parameters to the corresponding output parameters.

+

If a singular input parameter is provided, its value will be duplicated across all outputs.

+ +## Examples + +```matlab +[A1, A2, A3] = deal(pi) +``` + +```matlab +S = []; +S.A = []; +S(2).A = []; +S(3).A = []; +A1 = 200; +A2 = 'fifo'; +A3 = 1:11; +[S.A] = deal(A1, A2, A3) +``` + +```matlab +C = cell(1,3) +A1 = 200; +A2 = 'fifo'; +A3 = 1:11; +[C{:}] = deal(A1, A2, A3) +``` + +## See also + +[cell](../data_structures/cell.md), [struct](struc.html). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/elementary_functions/substruct.md b/en/elementary_functions/substruct.md new file mode 100644 index 00000000..36da45c2 --- /dev/null +++ b/en/elementary_functions/substruct.md @@ -0,0 +1,37 @@ +# substruct + +Create structure argument for subsasgn or subsref + +## Syntax + +- S = substruct(type1, subs1, type2, subs2, ...) + +## Description + +

S = substruct(type1, subs1, type2, subs2, ...) generates a structure containing fields necessary for an overloaded subsref or subsasgn method.

+

Each type char vector is limited to '.', '()', or '{}'.

+

The associated subs argument should be a field name (for the '.' type) or a cell array containing index vectors (for the '()' or '{}' types).

+ +## Example + +```matlab +S = struct('field1', 10, 'field2', 'Hello', 'field3', [1, 2, 3]); +% Create a substruct for accessing the 'field2' +s = substruct('.', 'field2'); +% Use subsref to get the value of 'field2' +value = subsref(S, s); +``` + +## See also + +[subsref](../operators/subsref.md), [subsasgn](../operators/subsasgn.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/README.md b/en/graphics/README.md index 630364d1..7204d00b 100644 --- a/en/graphics/README.md +++ b/en/graphics/README.md @@ -10,6 +10,7 @@ graphics functions - [autumn](autumn.md) - Autumn colormap array. - [axes](axes.md) - Create cartesian axes. - [axis](axis.md) - Set axis limits and aspect ratios. +- [bar](bar.md) - Bar graph. - [bone](bone.md) - Bone colormap array. - [cla](cla.md) - Clear axes. - [clf](clf.md) - Clear figure. @@ -24,12 +25,14 @@ graphics functions - [cylinder](cylinder.md) - Create cylinder. - [drawnow](drawnow.md) - Update figures and process callbacks - [figure](figure.md) - Creates an figure window. +- [fill](fill.md) - Create filled 2-D patches. - [gca](gca.md) - get current axes graphics object. - [gcf](gcf.md) - get current figure graphics object. - [gray](gray.md) - Gray colormap array. - [grid](grid.md) - Display or hide axes grid lines. - [groot](groot.md) - graphic root object. - [hggroup](hggroup.md) - Create group object. +- [hist](hist.md) - Histogram plot. - [hold](hold.md) - Retain current plot when adding new plots. - [hot](hot.md) - Hot colormap array. - [image](image.md) - Display image from array. @@ -51,6 +54,7 @@ graphics functions - [parula](parula.md) - Parula colormap array. - [patch](patch.md) - Create patches of colored polygons - [pcolor](pcolor.md) - Pseudocolor plot. +- [pie](pie.md) - Legacy pie chart. - [pink](pink.md) - Pink colormap array. - [plot](plot.md) - Linear 2-D plot. - [plot3](plot3.md) - 3-D line plot. @@ -59,11 +63,14 @@ graphics functions - [rgbplot](rgbplot.md) - Plot colormap. - [ribbon](ribbon.md) - Ribbon plot. - [saveas](saveas.md) - Save figure to specific file format. +- [scatter](scatter.md) - Scatter plot. - [semilogx](semilogx.md) - Semilog plot (x-axis has log scale). - [semilogy](semilogy.md) - Semilog plot (y-axis has log scale). - [sphere](sphere.md) - Create sphere. - [spring](spring.md) - Spring colormap array. - [spy](spy.md) - Visualize sparsity pattern of matrix. +- [stairs](stairs.md) - Stairstep graph. +- [stem](stem.md) - Plot discrete sequence data. - [subplot](subplot.md) - Create axes in tiled positions. - [summer](summer.md) - Summer colormap array. - [surf](surf.md) - surface plot. diff --git a/en/graphics/SUMMARY.md b/en/graphics/SUMMARY.md index 05b67bad..2e941c9e 100644 --- a/en/graphics/SUMMARY.md +++ b/en/graphics/SUMMARY.md @@ -3,6 +3,7 @@ - [autumn](autumn.md) - [axes](axes.md) - [axis](axis.md) + - [bar](bar.md) - [bone](bone.md) - [cla](cla.md) - [clf](clf.md) @@ -17,12 +18,14 @@ - [cylinder](cylinder.md) - [drawnow](drawnow.md) - [figure](figure.md) + - [fill](fill.md) - [gca](gca.md) - [gcf](gcf.md) - [gray](gray.md) - [grid](grid.md) - [groot](groot.md) - [hggroup](hggroup.md) + - [hist](hist.md) - [hold](hold.md) - [hot](hot.md) - [image](image.md) @@ -44,6 +47,7 @@ - [parula](parula.md) - [patch](patch.md) - [pcolor](pcolor.md) + - [pie](pie.md) - [pink](pink.md) - [plot](plot.md) - [plot3](plot3.md) @@ -52,11 +56,14 @@ - [rgbplot](rgbplot.md) - [ribbon](ribbon.md) - [saveas](saveas.md) + - [scatter](scatter.md) - [semilogx](semilogx.md) - [semilogy](semilogy.md) - [sphere](sphere.md) - [spring](spring.md) - [spy](spy.md) + - [stairs](stairs.md) + - [stem](stem.md) - [subplot](subplot.md) - [summer](summer.md) - [surf](surf.md) diff --git a/en/graphics/bar.md b/en/graphics/bar.md new file mode 100644 index 00000000..3cfe1597 --- /dev/null +++ b/en/graphics/bar.md @@ -0,0 +1,92 @@ +# bar + +Bar graph. + +## Syntax + +- bar(Y) +- bar(X, Y) +- bar(..., width) +- bar(..., color) +- bar(..., propertyName, propertyValue) +- bar(ax, ...) +- b = bar(...) + +## Input argument + +- X - x-coordinates: scalar, vector or string array. +- Y - y-coordinates: vector. +- width - scalar, 0.8 (default). +- color - a scalar string or row vector character: short name color. +- propertyName - a scalar string or row vector character. +- propertyValue - a value. +- ax - Axes object. + +## Output argument + +- b - patch graphics object. + +## Description + +

bar(X, Y) creates a bar graph using two sets of X-Y data vectors.

+

When only one argument is provided (Y), it is interpreted as a vector containing Y values, and the X coordinates are generated as a sequence from 1 to the number of elements in the Y vector.

+

You can optionally specify the width of the bars.

+

A value of 1.0 will make each bar exactly touch its neighboring bars, while the default width is set to 0.8.

+ +## Examples + +```matlab +f = figure(); +y = [ 91 75 123.5 105 150 131 203 179 249 226 281.5]; +bar(y); +``` + + + +```matlab +f = figure(); +y = [ 91 75 123.5 105 150 131 203 179 249 226 281.5]; +bar(y, 0.5); +``` + + + +```matlab +f = figure(); +x = 1900:10:2000; +y = [75 91 105 123.5 131 150 179 203 226 249 281.5]; +bar(x, y, 'r'); +``` + + + +```matlab +f = figure(); +x = [ "Summer", "Spring", "Winter", "Autumn"]; +y = [ 2 1 4 3]; +bar(x, y); +``` + + + +```matlab +f = figure(); +y = [91 75 123.5 105 150 131 203 179 249 226 281.5]; +bar(y, 'FaceColor', [0 .5 .5], 'EdgeColor', [0 .9 .9], 'LineWidth', 1.5) +``` + + + +## See also + +[hist](hist.md), [patch](patch.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/bar_1_ED314971.svg b/en/graphics/bar_1_ED314971.svg new file mode 100644 index 00000000..ae4a4fdf --- /dev/null +++ b/en/graphics/bar_1_ED314971.svg @@ -0,0 +1,616 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +12 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +100 + + + + + + + + + + + + + + + + + + + + +150 + + + + + + + + + + + + + + + + + + + + +200 + + + + + + + + + + + + + + + + + + + + +250 + + + + + + + + + + + + + + + + + + + + +300 + + + + + + + + + + + + + + + + diff --git a/en/graphics/bar_2_44FBF53F.svg b/en/graphics/bar_2_44FBF53F.svg new file mode 100644 index 00000000..0f2f159b --- /dev/null +++ b/en/graphics/bar_2_44FBF53F.svg @@ -0,0 +1,616 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +12 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +100 + + + + + + + + + + + + + + + + + + + + +150 + + + + + + + + + + + + + + + + + + + + +200 + + + + + + + + + + + + + + + + + + + + +250 + + + + + + + + + + + + + + + + + + + + +300 + + + + + + + + + + + + + + + + diff --git a/en/graphics/bar_3_1A531EA7.svg b/en/graphics/bar_3_1A531EA7.svg new file mode 100644 index 00000000..e4b18ac2 --- /dev/null +++ b/en/graphics/bar_3_1A531EA7.svg @@ -0,0 +1,650 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +1880 + + + + + + + + + + + + + + + + + + + + +1900 + + + + + + + + + + + + + + + + + + + + +1920 + + + + + + + + + + + + + + + + + + + + +1940 + + + + + + + + + + + + + + + + + + + + +1960 + + + + + + + + + + + + + + + + + + + + +1980 + + + + + + + + + + + + + + + + + + + + +2000 + + + + + + + + + + + + + + + + + + + + +2020 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +100 + + + + + + + + + + + + + + + + + + + + +150 + + + + + + + + + + + + + + + + + + + + +200 + + + + + + + + + + + + + + + + + + + + +250 + + + + + + + + + + + + + + + + + + + + +300 + + + + + + + + + + + + + + + + diff --git a/en/graphics/bar_4_8986F29.svg b/en/graphics/bar_4_8986F29.svg new file mode 100644 index 00000000..64261512 --- /dev/null +++ b/en/graphics/bar_4_8986F29.svg @@ -0,0 +1,675 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Summer + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Spring + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Winter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Autumn + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +2.5 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +3.5 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + diff --git a/en/graphics/bar_5_105AE2EC.svg b/en/graphics/bar_5_105AE2EC.svg new file mode 100644 index 00000000..998d529e --- /dev/null +++ b/en/graphics/bar_5_105AE2EC.svg @@ -0,0 +1,616 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +12 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +100 + + + + + + + + + + + + + + + + + + + + +150 + + + + + + + + + + + + + + + + + + + + +200 + + + + + + + + + + + + + + + + + + + + +250 + + + + + + + + + + + + + + + + + + + + +300 + + + + + + + + + + + + + + + + diff --git a/en/graphics/fill.md b/en/graphics/fill.md new file mode 100644 index 00000000..02ee327d --- /dev/null +++ b/en/graphics/fill.md @@ -0,0 +1,113 @@ +# fill + +Create filled 2-D patches. + +## Syntax + +- fill(X, Y, C) +- fill(..., propertyName, propertyValue) +- fill(ax, ...) +- go = fill(...) + +## Input argument + +- X - x-coordinates: vector or matrix. +- Y - y-coordinates: vector or matrix. +- C - Color array: scalar, vector, m-by-n-by-3 array of RGB triplets. +- ax - a scalar graphics object value: parent container, specified as a axes. +- propertyName - a scalar string or row vector character. +- propertyValue - a value. + +## Output argument + +- go - a graphics object: patch type. + +## Description + +

fill(X, Y, C) creates a 2D polygonal shape with vertices defined by X and Y coordinates, and fills the shape with color C.

+

fill(..., PropertyName, PropertyValue, ...) sets optional properties for the fill/patch object using name-value pairs.

+

go = fill(...) returns the handle go to the created patch object.

+

Property Name-Value Pairs:

+

+

'FaceColor': color of the filled shape. FaceColor can be a character vector or a 3-element RGB vector. Default: 'flat'.

+

'EdgeColor': color of the edges of the polygonal shape. EdgeColor can be a character vector or a 3-element RGB vector. Default: 'none'.

+

'LineWidth': width of the edges of the polygonal shape. Default: 0.5.

+

'LineStyle': style of the edges of the polygonal shape. LineStyle can be a character vector or a line style code. Default: '-'.

+

'FaceAlpha': transparency of the filled shape. FaceAlpha can be a scalar between 0 and 1. Default: 1.

+

'EdgeAlpha': transparency of the edges of the polygonal shape. EdgeAlpha can be a scalar between 0 and 1. Default: 1.

+

'Parent': handle of the parent object for the patch. Default: gca().

+

'Vertices': matrix of vertex coordinates. The matrix must have size N-by-2 or N-by-3, where N is the number of vertices. Default: the vertex coordinates are specified by the X, Y, and Z input arguments.

+ +## Examples + +```matlab +f = figure(); +outerX = [0, 0.3, 1, 0.7, 1, 0.3, 0, -0.3, -1, -0.7, -1, -0.3, 0]; +outerY = [1, 0.3, 0.3, 0, -0.3, -1, -0.3, -1, -0.3, 0, 0.3, 0.3, 1]; +innerX = [0, 0.2, 0.5, 0.35, 0.5, 0.2, 0, -0.2, -0.5, -0.35, -0.5, -0.2, 0]; +innerY = [0.6, 0.3, 0.3, 0, -0.3, -0.6, -0.3, -0.6, -0.3, 0, 0.3, 0.3, 0.6]; +fill(outerX, outerY, 'y'); +fill(innerX, innerY, 'r'); +``` + + + +```matlab +% Define the vertices of a colorful geometric pattern +x1 = [0, 1, 1, 0]; +y1 = [0, 0, 1, 1]; +x2 = [0.5, 1.5, 1.5, 0.5]; +y2 = [0.5, 0.5, 1.5, 1.5]; +x3 = [1, 2, 2, 1]; +y3 = [1, 1, 2, 2]; + +% Define colors for the polygons +colors = ['r', 'g', 'b']; + +% Create a figure with a white background +figure('Color', 'w'); + +% Fill the polygons with different colors +fill(x1, y1, colors(1)); +hold on; +fill(x2, y2, colors(2)); +fill(x3, y3, colors(3)); + +% Add labels to distinguish the regions +text(0.5, 0.5, 'Polygon 1', 'Color', 'w', 'HorizontalAlignment', 'center', 'FontWeight', 'bold'); +text(1.25, 1.25, 'Polygon 2', 'Color', 'w', 'HorizontalAlignment', 'center', 'FontWeight', 'bold'); +text(1.5, 0.5, 'Polygon 3', 'Color', 'w', 'HorizontalAlignment', 'center', 'FontWeight', 'bold'); + +axis equal; +title('Colorful Geometric Pattern'); +``` + + + +Alpha channel + +```matlab +f = figure(); +x = [10 30 40 30 10 0]; +y = [0 0 20 40 40 20]; +hold on +fill(x, y, 'cyan', 'FaceAlpha', 0.3); +fill(x + 2, y, 'magenta', 'FaceAlpha', 0.3); +fill(x + 1, y + 2, 'yellow', 'FaceAlpha', 0.3); +``` + + + +## See also + +[patch](patch.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/fill_1_139BD470.svg b/en/graphics/fill_1_139BD470.svg new file mode 100644 index 00000000..4300b23d --- /dev/null +++ b/en/graphics/fill_1_139BD470.svg @@ -0,0 +1,834 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.8 + + + + + + + + + + + + + + + + + + + + +-0.6 + + + + + + + + + + + + + + + + + + + + +-0.4 + + + + + + + + + + + + + + + + + + + + +-0.2 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.2 + + + + + + + + + + + + + + + + + + + + +0.4 + + + + + + + + + + + + + + + + + + + + +0.6 + + + + + + + + + + + + + + + + + + + + +0.8 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.8 + + + + + + + + + + + + + + + + + + + + +-0.6 + + + + + + + + + + + + + + + + + + + + +-0.4 + + + + + + + + + + + + + + + + + + + + +-0.2 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.2 + + + + + + + + + + + + + + + + + + + + +0.4 + + + + + + + + + + + + + + + + + + + + +0.6 + + + + + + + + + + + + + + + + + + + + +0.8 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + diff --git a/en/graphics/fill_2_73FE3B21.svg b/en/graphics/fill_2_73FE3B21.svg new file mode 100644 index 00000000..83fb524d --- /dev/null +++ b/en/graphics/fill_2_73FE3B21.svg @@ -0,0 +1,588 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Polygon 1 + + + + + + + + + + + + +Polygon 2 + + + + + + + + + + + + +Polygon 3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +2.5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +2.5 + + + + + + + + + + + + + + + + + + + +Colorful Geometric Pattern + + + + + + + + + diff --git a/en/graphics/fill_3_9BC84302.svg b/en/graphics/fill_3_9BC84302.svg new file mode 100644 index 00000000..c0893be4 --- /dev/null +++ b/en/graphics/fill_3_9BC84302.svg @@ -0,0 +1,772 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +15 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +25 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + + + + + +35 + + + + + + + + + + + + + + + + + + + + +40 + + + + + + + + + + + + + + + + + + + + +45 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +15 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +25 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + + + + + +35 + + + + + + + + + + + + + + + + + + + + +40 + + + + + + + + + + + + + + + + + + + + +45 + + + + + + + + + + + + + + + + diff --git a/en/graphics/hist.md b/en/graphics/hist.md new file mode 100644 index 00000000..b93456c6 --- /dev/null +++ b/en/graphics/hist.md @@ -0,0 +1,56 @@ +# hist + +Histogram plot. + +## Syntax + +- hist(x) +- hist(x, nbins) +- hist(ax, ...) +- counts = hist(...) +- [counts, centers] = hist(...) + +## Input argument + +- x - vector or matrix +- nbins - vector. +- ax - Axes object. + +## Output argument + +- counts - Counts of the number of elements in each bin: row vector. +- centers - Bin centers: vector. + +## Description + +

A histogram is a graphical representation that illustrates the distribution of data values.

+

When you use the hist function, it organizes the elements in the vector Y into 10 equally spaced containers and provides the count of elements in each container as a row vector.

+

hist(Y, x) with a vector x, the function will return the distribution of values in Y among bins determined by the length of x, with centers specified by the values in x.

+

For instance, if x is a 5-element vector, hist will categorize the elements of Y into five bins, each centered on the x-axis at the values specified in x.

+

When you use hist(...) without specifying any output arguments, it generates a histogram plot. The bins are distributed along the x-axis between the minimum and maximum values found in the input vector Y.

+ +## Example + +```matlab +f = figure(); +for i = 1:4 + subplot(2, 2, i) + hist(randn(1000, 1), 50) +end +``` + + + +## See also + +[bar](bar.md), [patch](patch.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/hist_1_FD61AA81.svg b/en/graphics/hist_1_FD61AA81.svg new file mode 100644 index 00000000..c55162a6 --- /dev/null +++ b/en/graphics/hist_1_FD61AA81.svg @@ -0,0 +1,3498 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-4 + + + + + + + + + + + + + + + + + + + + +-3 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + + + + + +40 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +60 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-4 + + + + + + + + + + + + + + + + + + + + +-3 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + + + + + +40 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +60 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-3 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + + + + + +40 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +60 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-4 + + + + + + + + + + + + + + + + + + + + +-3 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + + + + + +40 + + + + + + + + + + + + + + + + + + + + +50 + + + + + + + + + + + + + + + + + + + + +60 + + + + + + + + + + + + + + + + diff --git a/en/graphics/patch.md b/en/graphics/patch.md index 7594633f..f2c716a0 100644 --- a/en/graphics/patch.md +++ b/en/graphics/patch.md @@ -102,6 +102,21 @@ view([0, 0, 1]); +Alpha channel + +```matlab +x = [1 3 4 3 1 0]; +y = [0 0 2 4 4 2]; +z = [0 0 0 0 0 0]; +figure(); +hold on +patch(x,y,z,'cyan','FaceAlpha',0.3) +patch(x+2,y,z,'magenta','FaceAlpha',0.3) +patch(x+1,y+2,z,'yellow','FaceAlpha',0.3) +``` + + + ## See also [surf](surf.md), [colormap](colormap.md). diff --git a/en/graphics/patch_4_F3B9E78.svg b/en/graphics/patch_4_F3B9E78.svg new file mode 100644 index 00000000..9806be97 --- /dev/null +++ b/en/graphics/patch_4_F3B9E78.svg @@ -0,0 +1,568 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + diff --git a/en/graphics/pie.md b/en/graphics/pie.md new file mode 100644 index 00000000..931135e4 --- /dev/null +++ b/en/graphics/pie.md @@ -0,0 +1,83 @@ +# pie + +Legacy pie chart. + +## Syntax + +- pie(X) +- pie(X, explode) +- pie(X, labels) +- pie(X, explode, labels) +- pie(ax, ...) +- p = pie(...) + +## Input argument + +- X - vector or matrix. +- explode - Offset slices: numeric vector or matrix, logical vector and matrix, string array or cell array of character vectors. +- labels - '%.0f%%' (default) or array of text labels +- ax - Axes object. + +## Output argument + +- p - vector of patch and text objects. + +## Description + +

pie(X) generates a pie chart based on the data in the array variable X.

+

In cases where the sum of the elements in X is less than or equal to 1, the values in X directly represent the proportional areas of the pie slices.

+

If the sum of X is less than 1, the pie chart displays only a partial pie.

+

Alternatively, if the sum of X exceeds 1, the function normalizes the values by dividing each element by the sum of X.

+

This normalization ensures that the pie chart accurately reflects the relative proportions of the data.

+

In situations where X is a categorical variable, each slice of the pie corresponds to a category, and the area of each slice is determined by the ratio of the number of elements in the category to the total number of elements in X.

+ +## Examples + +```matlab +f = figure(); +p = pie ([3, 2, 1], [0, 0, 1]); +``` + + + +```matlab +f = figure(); +p = pie([5 9 4 6 3],[0 1 0 1 0]); +``` + + + +```matlab +f = figure(); +p = pie([3 4 6 2],[0 1 0 0],["part1", "part2", "part3", "part4"]); +``` + + + +```matlab +f = figure(); +y2010 = [50 0 100 95]; +y2011 = [65 22 97 120]; +ax1 = subplot(1, 2, 1); +p1 = pie(ax1, y2010) +title('2010') +ax2 = subplot(1, 2, 2); +p2 = pie(ax2, y2011) +title('2011') +``` + + + +## See also + +[patch](patch.md), [text](text.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/pie_1_802BD829.svg b/en/graphics/pie_1_802BD829.svg new file mode 100644 index 00000000..b1740cfd --- /dev/null +++ b/en/graphics/pie_1_802BD829.svg @@ -0,0 +1,123 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +50% + + + + + + + + + + + + + + + + +33% + + + + + + + + + + + + + + + + +17% + + + + + + + + + + + + diff --git a/en/graphics/pie_2_C81A99E7.svg b/en/graphics/pie_2_C81A99E7.svg new file mode 100644 index 00000000..bcbe623e --- /dev/null +++ b/en/graphics/pie_2_C81A99E7.svg @@ -0,0 +1,179 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +19% + + + + + + + + + + + + + + + + +33% + + + + + + + + + + + + + + + + +15% + + + + + + + + + + + + + + + + +22% + + + + + + + + + + + + + + + + +11% + + + + + + + + + + + + diff --git a/en/graphics/pie_3_F8E2731B.svg b/en/graphics/pie_3_F8E2731B.svg new file mode 100644 index 00000000..1d542907 --- /dev/null +++ b/en/graphics/pie_3_F8E2731B.svg @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +part1 + + + + + + + + + + + + + + + + +part2 + + + + + + + + + + + + + + + + +part3 + + + + + + + + + + + + + + + + +part4 + + + + + + + + + + + + diff --git a/en/graphics/pie_4_FB380473.svg b/en/graphics/pie_4_FB380473.svg new file mode 100644 index 00000000..5a071d19 --- /dev/null +++ b/en/graphics/pie_4_FB380473.svg @@ -0,0 +1,322 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +20% + + + + + + + + + + + + + + + + +0% + + + + + + + + + + + + + + + + +41% + + + + + + + + + + + + + + + + +39% + + + + + + + + + + + + + + + +2010 + + + + + + + + + + + + + + + + + + + + + + +21% + + + + + + + + + + + + + + + + +7% + + + + + + + + + + + + + + + + +32% + + + + + + + + + + + + + + + + +39% + + + + + + + + + + + + + + + +2011 + + + + + + + + + diff --git a/en/graphics/quiver.md b/en/graphics/quiver.md index b24c76ee..801a296b 100644 --- a/en/graphics/quiver.md +++ b/en/graphics/quiver.md @@ -9,7 +9,7 @@ Vector plot. - quiver(..., LineSpec) - quiver(..., propertyName, propertyValue) - quiver(parent, ...) -- go = quiver(...) +- gr = quiver(...) ## Input argument @@ -24,7 +24,7 @@ Vector plot. ## Output argument -- ax - list of graphics object: arrows. +- gr - group of graphics object: arrows. ## Description diff --git a/en/graphics/scatter.md b/en/graphics/scatter.md new file mode 100644 index 00000000..2ae5d470 --- /dev/null +++ b/en/graphics/scatter.md @@ -0,0 +1,140 @@ +# scatter + +Scatter plot. + +## Syntax + +- scatter(x, y) +- scatter(x, y, sz) +- scatter(x, y, sz, c) +- scatter(..., 'filled') +- scatter(..., marker) +- scatter(ax, ...) +- scatter(..., propertyName, propertyValue) +- s = scatter(...) + +## Input argument + +- X - x-coordinates: vector or matrix. +- Y - y-coordinates: vector or matrix. +- sz - Marker size: numeric scalar, vector, [] (default: 36) +- c - Marker color: color name, RGB triplet or vector of colormap indices +- ax - a scalar graphics object value: parent container, specified as a axes. +- propertyName - a scalar string or row vector character. see help of 'line' for property list. +- propertyValue - a value. + +## Output argument + +- s - a graphics object: line type or group of line. + +## Description + +

scatter(x, y) generates a scatter plot by placing circular markers at the coordinates defined by the vectors x and y.

+

If you intend to display a single dataset, ensure that both x and y are vectors of the same length.

+

To visualize multiple datasets on a shared set of axes, you can achieve this by using a matrix for either x or y, while keeping the other as a vector.

+

This allows you to overlay or compare multiple datasets within the same plot.

+

+

marker specifies the symbol to be drawn at each data point:

+

'o': Circle symbol

+

'x': Times symbol

+

'+': Plus symbol

+

'*': Asterisk symbol

+

'.': Dot symbol

+

's': Square symbol

+

'd': Diamond symbol

+

'v': Downward-pointing triangle symbol

+

'^': Upward-pointing triangle symbol

+

'>': Left-pointing triangle symbol

+

'<': Right-pointing triangle symbol

+

+

The ColorSpec specifies the marker color to use for each data series:

+

'k': Color Black

+

'y': Color Yellow

+

'm': Color Magenta

+

'c': Color Cyan

+

'r': Color Red

+

'b': Color Blue

+

'g': Color Green

+

+

see line for more information about properties

+ +## Examples + +```matlab +f = figure(); +theta = linspace(0,1,600); +x = exp(theta).*sin(110*theta); +y = exp(theta).*cos(110*theta); +s = scatter(x,y ,'filled'); +``` + + + +```matlab +f = figure(); +x = linspace(0,3*pi,255); +y = cos(x) + rand(1,255); +sz = 1:255; +c = 1:length(x); +scatter(x, y, sz, c, 'd', 'filled') +``` + + + +```matlab +f = figure(); +x = linspace(0, 3*pi, 255); +y = cos(x) + rand(1, 255); +c = linspace(1,10,length(x)); +scatter(x, y, [], c, 'filled') +``` + + + +```matlab +f = figure(); +theta = linspace(0,2*pi,244); +x = sin(theta) + 0.75*rand(1,244); +y = cos(theta) + 0.75*rand(1,244); +sz = 45; +scatter(x,y,sz,'MarkerEdgeColor',[0 .6 .5], 'MarkerFaceColor',[0 .6 .7], 'LineWidth',3.5) +``` + + + +```matlab +f = figure(), +x = linspace(0,3*pi,200); +y = cos(x) + rand(1,200); +% Top plot +ax1 = subplot(2,1, 1); +scatter(ax1,x,y) +% Bottom plot +ax2 = subplot(2,1, 2); +scatter(ax2,x,y,'filled','d') +``` + + + +```matlab +f = figure(); +x = rand(500,5); +y = randn(500,5) + (5:5:25); +s = scatter(x,y, 'filled'); +``` + + + +## See also + +[line](line.md), [plot](plot.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/scatter_1_CAF48F8D.svg b/en/graphics/scatter_1_CAF48F8D.svg new file mode 100644 index 00000000..ed8d1ef9 --- /dev/null +++ b/en/graphics/scatter_1_CAF48F8D.svg @@ -0,0 +1,7761 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-3 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +-3 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + diff --git a/en/graphics/scatter_2_220DC9DC.svg b/en/graphics/scatter_2_220DC9DC.svg new file mode 100644 index 00000000..30d9dbd0 --- /dev/null +++ b/en/graphics/scatter_2_220DC9DC.svg @@ -0,0 +1,3746 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +9 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + diff --git a/en/graphics/scatter_3_D671E61.svg b/en/graphics/scatter_3_D671E61.svg new file mode 100644 index 00000000..32d5ada2 --- /dev/null +++ b/en/graphics/scatter_3_D671E61.svg @@ -0,0 +1,5021 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +9 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + diff --git a/en/graphics/scatter_4_7C886888.svg b/en/graphics/scatter_4_7C886888.svg new file mode 100644 index 00000000..c6dfe514 --- /dev/null +++ b/en/graphics/scatter_4_7C886888.svg @@ -0,0 +1,3489 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + diff --git a/en/graphics/scatter_5_E289BA04.svg b/en/graphics/scatter_5_E289BA04.svg new file mode 100644 index 00000000..71bda3c6 --- /dev/null +++ b/en/graphics/scatter_5_E289BA04.svg @@ -0,0 +1,2771 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +9 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +9 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + diff --git a/en/graphics/scatter_6_1E831925.svg b/en/graphics/scatter_6_1E831925.svg new file mode 100644 index 00000000..6913a485 --- /dev/null +++ b/en/graphics/scatter_6_1E831925.svg @@ -0,0 +1,30741 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.1 + + + + + + + + + + + + + + + + + + + + +0.2 + + + + + + + + + + + + + + + + + + + + +0.3 + + + + + + + + + + + + + + + + + + + + +0.4 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +0.6 + + + + + + + + + + + + + + + + + + + + +0.7 + + + + + + + + + + + + + + + + + + + + +0.8 + + + + + + + + + + + + + + + + + + + + +0.9 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +15 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + + +25 + + + + + + + + + + + + + + + + + + + + +30 + + + + + + + + + + + + + + + + diff --git a/en/graphics/stairs.md b/en/graphics/stairs.md new file mode 100644 index 00000000..1528ad4c --- /dev/null +++ b/en/graphics/stairs.md @@ -0,0 +1,78 @@ +# stairs + +Stairstep graph. + +## Syntax + +- stairs(Y) +- stairs(X, Y) +- stairs(..., LineSpec) +- stairs(..., Name, Value) +- stairs(ax, ...) +- h = stairs(...) +- [xb, yb] = stairs(...) + +## Input argument + +- X - x values. +- Y - y values. +- LineSpec - Line style, marker and/or color: character vector or scalar string. +- propertyName - a scalar string or row vector character. +- propertyValue - a value. +- ax - Axes object. + +## Output argument + +- h - line object. +- xb - x values for use with plot +- yb - y values for use with plot + +## Description + +

Stairstep graphs are a valuable tool for creating time-history plots of digitally sampled data.

+

stairs(Y) function is used to generate such graphs by plotting the elements of the vector Y.

+

If Y is a matrix, it draws one line for each column, with the color of the lines determined by the ColorOrder property of the axes.

+

In the case of a vector Y, the x-axis scale spans from 1 to the length of Y, while for a matrix Y, the x-axis scale ranges from 1 to the number of rows in Y.

+

stairs(X, Y) allows you to plot the elements in Y at specific locations defined by the vector X.

+

It's important to note that the elements in X must be in a monotonic order to create a valid stairstep graph.

+ +## Examples + +```matlab +f = figure(); +f = figure(); +x1 = linspace(0,2*pi)'; +x2 = linspace(0,pi)'; +X = [x1,x2]; +Y = [sin(5*x1),exp(x2).*sin(5*x2)]; +ax = gca(); +stairs(ax, X,Y) +``` + + + +```matlab +X = linspace(0,1,45)'; +Y = [cos(3*X), exp(X).*sin(9*X)]; +h = stairs(X,Y); +h(1).Marker = 'o'; +h(1).MarkerSize = 5; +h(2).Marker = '+'; +h(2).MarkerFaceColor = 'm'; +``` + + + +## See also + +[plot](plot.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/stairs_1_F17087DF.svg b/en/graphics/stairs_1_F17087DF.svg new file mode 100644 index 00000000..6ba3b696 --- /dev/null +++ b/en/graphics/stairs_1_F17087DF.svg @@ -0,0 +1,596 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +-10 + + + + + + + + + + + + + + + + + + + + +-5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +15 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + diff --git a/en/graphics/stairs_2_CF83A4A1.svg b/en/graphics/stairs_2_CF83A4A1.svg new file mode 100644 index 00000000..2d923909 --- /dev/null +++ b/en/graphics/stairs_2_CF83A4A1.svg @@ -0,0 +1,1920 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.2 + + + + + + + + + + + + + + + + + + + + +0.4 + + + + + + + + + + + + + + + + + + + + +0.6 + + + + + + + + + + + + + + + + + + + + +0.8 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.2 + + + + + + + + + + + + + + + + + + + + +-2 + + + + + + + + + + + + + + + + + + + + +-1.5 + + + + + + + + + + + + + + + + + + + + +-1 + + + + + + + + + + + + + + + + + + + + +-0.5 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.5 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +1.5 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +2.5 + + + + + + + + + + + + + + + + diff --git a/en/graphics/stem.md b/en/graphics/stem.md new file mode 100644 index 00000000..537c435f --- /dev/null +++ b/en/graphics/stem.md @@ -0,0 +1,77 @@ +# stem + +Plot discrete sequence data. + +## Syntax + +- stem(Y) +- stem(X, Y) +- stem(..., 'filled') +- stem(..., LineSpec) +- stem(..., propertyName, propertyValue) +- stem(ax, ...) +- go = stem(...) + +## Input argument + +- X - Locations to plot data values in Y. +- Y - Data sequence to display. +- LineSpec - Line style, marker and/or color: character vector or scalar string. +- propertyName - a scalar string or row vector character. +- propertyValue - a value. +- ax - Axes object. + +## Output argument + +- gr - group of graphics object. + +## Description + +

A two-dimensional stem plot is a way to visualize data by representing it as lines extending from a horizontal baseline along the x-axis.

+

At the end of each line, there is a circle (which is the default marker), and the vertical position of this circle corresponds to the value of the data it represents.

+

stem(Y) creates a stem plot by taking the data sequence Y and drawing stems that extend from regularly spaced and automatically determined points along the x-axis.

+

If Y is a matrix, the stem function plots all elements in a row against the same x-value.

+

stem(X, Y) creates a stem plot that shows how X relates to the columns of Y.

+

Both X and Y can be vectors or matrices of the same size.

+

X can be either a row or a column vector, and Y should be a matrix with the same number of rows as the length of X.

+

If you want to specify whether to fill the circle at the end of each stem, you can use stem(...,'fill').

+

Moreover, by using stem(..., LineSpec), you can define the line style, marker symbol, and color for the stems and the top marker.

+

Refer to LineSpec for more details on how to customize the appearance of the stem plot.

+ +## Examples + +```matlab +f = figure(); +x = 1:10; +y = 2*x; +h = stem (x, y, 'MarkerFaceColor', [1 0 1]); +title('stem plot modified with property/value pair'); +``` + + + +```matlab +f =figure(); +% Defining base line - X input vector ranging from 0 to 2*pi +X = 0 : pi/100 : 2*pi; +% Defining the Y input vector as function of X +Y = exp(-3*X/4) .* cos(2*X); +% Third, we use the 'stem' function to plot discrete values +stem(X,Y) +``` + + + +## See also + +[plot](plot.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/graphics/stem_1_8A2709D0.svg b/en/graphics/stem_1_8A2709D0.svg new file mode 100644 index 00000000..18f184a4 --- /dev/null +++ b/en/graphics/stem_1_8A2709D0.svg @@ -0,0 +1,956 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +9 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +8 + + + + + + + + + + + + + + + + + + + + +10 + + + + + + + + + + + + + + + + + + + + +12 + + + + + + + + + + + + + + + + + + + + +14 + + + + + + + + + + + + + + + + + + + + +16 + + + + + + + + + + + + + + + + + + + + +18 + + + + + + + + + + + + + + + + + + + + +20 + + + + + + + + + + + + + + + + + + + +stem plot modified with property/value pair + + + + + + + + + diff --git a/en/graphics/stem_2_B7720690.svg b/en/graphics/stem_2_B7720690.svg new file mode 100644 index 00000000..0f5134fd --- /dev/null +++ b/en/graphics/stem_2_B7720690.svg @@ -0,0 +1,2041 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + + + + + +2 + + + + + + + + + + + + + + + + + + + + +3 + + + + + + + + + + + + + + + + + + + + +4 + + + + + + + + + + + + + + + + + + + + +5 + + + + + + + + + + + + + + + + + + + + +6 + + + + + + + + + + + + + + + + + + + + +7 + + + + + + + + + + + + + + + + + + + + +-0.4 + + + + + + + + + + + + + + + + + + + + +-0.2 + + + + + + + + + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + +0.2 + + + + + + + + + + + + + + + + + + + + +0.4 + + + + + + + + + + + + + + + + + + + + +0.6 + + + + + + + + + + + + + + + + + + + + +0.8 + + + + + + + + + + + + + + + + + + + + +1 + + + + + + + + + + + + + + + + diff --git a/en/operators/README.md b/en/operators/README.md index 7798e001..c100779e 100644 --- a/en/operators/README.md +++ b/en/operators/README.md @@ -36,7 +36,9 @@ Operators - [rdivide](rdivide.md) - Right division, ./ operator - [shortcutand](shortcutand.md) - Short circuit 'AND' operator, && - [shortcutor](shortcutor.md) - Short circuit 'OR' operator, || +- [subsasgn](subsasgn.md) - Redefine subscripted assignment. - [subsindex](subsindex.md) - Convert an object to an index vector. +- [subsref](subsref.md) - Subscripted reference. - [mtimes](times.md) - Element wise multiplication, .\* operator - [transpose](transpose.md) - Returns vector or matrix transpose: .' operator. - [uminus](uminus.md) - Unary minus, - operator diff --git a/en/operators/SUMMARY.md b/en/operators/SUMMARY.md index 6ad94fb0..c9e7b378 100644 --- a/en/operators/SUMMARY.md +++ b/en/operators/SUMMARY.md @@ -29,7 +29,9 @@ - [rdivide](rdivide.md) - [shortcutand](shortcutand.md) - [shortcutor](shortcutor.md) + - [subsasgn](subsasgn.md) - [subsindex](subsindex.md) + - [subsref](subsref.md) - [mtimes](times.md) - [transpose](transpose.md) - [uminus](uminus.md) diff --git a/en/operators/subsasgn.md b/en/operators/subsasgn.md new file mode 100644 index 00000000..c5620fd8 --- /dev/null +++ b/en/operators/subsasgn.md @@ -0,0 +1,45 @@ +# subsasgn + +Redefine subscripted assignment. + +## Syntax + +- B = subsasgn(A, S, B) + +## Input argument + +- A - Object used in indexing operation +- S - Structure with two fields: 'type' and 'subs'. +- B - The assigned value, located on the right side of the assignment statement. + +## Output argument + +- R - The outcome of the assignment statement is the object that has been modified, and this modified object is provided as the first argument. + +## Description + +

B = subsasgn(A, S, B) assigns a value to an element of a cell or matrix.

+ +## Example + +Parentheses Indexing + +```matlab +R1 = {1, 'GoodBye', [1, 2;3, 4]}; +S = substruct('{}', {1, 3}); +R2 = subsasgn(R1, S, 'Hello') +``` + +## See also + +[substruct](../elementary_functions/substruct.md). + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/operators/subsref.md b/en/operators/subsref.md new file mode 100644 index 00000000..131f201e --- /dev/null +++ b/en/operators/subsref.md @@ -0,0 +1,61 @@ +# subsref + +Subscripted reference. + +## Syntax + +- B = subsref(A, S) + +## Input argument + +- A - Indexed object array +- B - Indexing structure + +## Output argument + +- B - Result of indexing expression + +## Description + +

B = subsref(A, S) is invoked when using the syntax A(i), A{i}, or A.i with an object A.

+ +## Examples + +Parentheses Indexing + +```matlab +A = magic(5); +S.type='()'; +S.subs={1:2,':'}; +R = subsref(A, S) +``` + +Brace Indexing + +```matlab +C = {"one", 2, 'three'}; +S = []; +S.type = '{}'; +S.subs = {[1 2]}; +[R1, R2] = subsref(C, S); +``` + +Dot Indexing + +```matlab +A = struct('number', 10); +S = []; +S.type = '.'; +S.subs = 'number'; +R = subsref(A, S) +``` + +## History + +| Version | Description | +| ------- | --------------- | +| 1.0.0 | initial version | + +## Author + +Allan CORNET diff --git a/en/overload/overloading.md b/en/overload/overloading.md index 4178d5ab..fd9d42bc 100644 --- a/en/overload/overloading.md +++ b/en/overload/overloading.md @@ -189,7 +189,7 @@ end ## See also -[plus](../operators/plus.md), [minus](../operators/minus.md), [uminus](../operators/uminus.md), [uplus](../operators/uplus.md), [times](../operators/times.md), [mtimes](../operators/mtimes.md), [rdivide](../operators/rdivide.md), [ldivide](../operators/ldivide.md), [mrdivide](../operators/mrdivide.md), [mldivide](../operators/mldivide.md), [power](../operators/power.md), [mpower](../operators/mpower.md), [lt](../operators/lt.md), [gt](../operators/gt.md), [le](../operators/le.md), [ge](../operators/ge.md), [ne](../operators/ne.md), [eq](../operators/eq.md), [and](../operators/and.md), [or](../operators/or.md), [not](../operators/not.md), [colon](../operators/colon.md), [ctranspose](../operators/ctranspose.md), [transpose](../operators/transpose.md), [display](../display_format/display.md), [horzcat](../operators/horzcat.md), [vertcat](../operators/vertcat.md), [subsref](subsref.html), [subsasgn](subsasgn.html), [subsindex](../operators/subsindex.md). +[plus](../operators/plus.md), [minus](../operators/minus.md), [uminus](../operators/uminus.md), [uplus](../operators/uplus.md), [times](../operators/times.md), [mtimes](../operators/mtimes.md), [rdivide](../operators/rdivide.md), [ldivide](../operators/ldivide.md), [mrdivide](../operators/mrdivide.md), [mldivide](../operators/mldivide.md), [power](../operators/power.md), [mpower](../operators/mpower.md), [lt](../operators/lt.md), [gt](../operators/gt.md), [le](../operators/le.md), [ge](../operators/ge.md), [ne](../operators/ne.md), [eq](../operators/eq.md), [and](../operators/and.md), [or](../operators/or.md), [not](../operators/not.md), [colon](../operators/colon.md), [ctranspose](../operators/ctranspose.md), [transpose](../operators/transpose.md), [display](../display_format/display.md), [horzcat](../operators/horzcat.md), [vertcat](../operators/vertcat.md), [subsref](../operators/subsref.md), [subsasgn](../operators/subsasgn.md), [subsindex](../operators/subsindex.md). ## History diff --git a/en/stream_manager/fprintf.md b/en/stream_manager/fprintf.md index 234b3215..7be99605 100644 --- a/en/stream_manager/fprintf.md +++ b/en/stream_manager/fprintf.md @@ -97,6 +97,7 @@ Writes data to a file. Character vector. +

To display a percent sign, you need to use a double percent sign (%%) in the format string.

## Examples @@ -125,6 +126,12 @@ for idx = 1 : 100 end ``` +Display a percent sign + +```matlab +fprintf(1, '%d%%.', 95) +``` + ## See also [fopen](fopen.md), [fclose](fclose.md), [fread](fread.md). diff --git a/en/string/sprintf.md b/en/string/sprintf.md index 69b4a808..d54e36c7 100644 --- a/en/string/sprintf.md +++ b/en/string/sprintf.md @@ -87,6 +87,7 @@ Writes data to a string. Character vector. +

To display a percent sign, you need to use a double percent sign (%%) in the format string.

## Examples @@ -102,6 +103,12 @@ sprintf("an example of %s.", "text") sprintf('an value %g.', pi) ``` +Display a percent sign + +```matlab +sprintf('%d%%.', 95) +``` + ## See also [fprintf](../stream_manager/fprintf.md). diff --git a/fr/README.md b/fr/README.md index 4085b679..9e4f0be2 100644 --- a/fr/README.md +++ b/fr/README.md @@ -1,6 +1,6 @@ ![banner](banner_homepage.png) -### Nelson 0.7.10.0 +### Nelson 0.7.11.0 Ceci est une version alpha de Nelson. diff --git a/fr/changelogs/CHANGELOG.md b/fr/changelogs/CHANGELOG.md index 39798265..f5563c86 100644 --- a/fr/changelogs/CHANGELOG.md +++ b/fr/changelogs/CHANGELOG.md @@ -4,6 +4,41 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). +## 0.7.11 (2023-11-29) + +### Added + +- `hist` Histogram plot. +- `bar` Bar graph. +- `scatter` Scatter plot. +- `stem` Plot discrete sequence data. +- `stairs` Stairstep graph. +- `fill` 2-D patch. +- `pie` legacy pie chart. +- `subsref` Subscripted reference. +- `subsasgn` Redefine subscripted assignment. +- `substruct` Create structure argument for subsasgn or subsref. +- `deal` Distribute inputs to outputs. +- Intel compiler support. + +### Changed + +- axis limits recalculate with `hggroup`. +- `axes` forces focus on current axe. +- function_handle parenthese precedence. +- `patch` and `fill` manages `FaceAlpha`. +- visibility title and labels. +- object constructor must be in '@' directory and no more in parent directory (compatibility). +- `subsref`, `subsasgn` compatibility with `substruct`. +- To display a percent sign, you need to use a double percent sign (%%) in the format string (compatibility). +- French translation updated (100%, Thanks to weblate contributors) +- [#997](http://github.com/Nelson-numerical-software/nelson/issues/997) Macos BigSur Github CI support removed. +- Qt 6.6.1 on win64 CI build. + +### Fixed + +- `A = []; A(false) = zeros(3, 0)` did not return an empty matrix but an error. + ## 0.7.10 (2023-10-27) ### Added