You should use functions defined on N as a substitute if possible.
Welcome to LogarithmPlotter's user manual. Here, we'll cover most features of LogarithmPlotter and how to use them.
+ ++
LogarithmPlotter is a software to create plots and graphs with a logarithmic scale, the most well known kind being Bode plots, which LogarithmPlotter helps create in asymptotic form. While logarithmic scales in the primary interest of LogarithmPlotter, LogarithmPlotter also supports non logarithmic scales, which may be required to use certain features.
+To do that, LogarithmPlotter uses a system called Objects, which may seem familiar to you if you have used other plotting software like Geogebra.
+An "object" is anything that can be reprensented on the graph. LogarithmPlotter allows you to create 9 types of objects:
+| Icon | +Type | +Works well in logarithmic scale | +Works well in non logarithmic scale | +Allows pointer positioning | +Comment | +
|---|---|---|---|---|---|
|
+ Points | +✓ | +✓ | +✓ | ++ |
|
+ Texts | +✓ | +✓ | +✓ | +Used as additional labels if necessary | +
|
+ Functions | +✓ | +✓ | +X | ++ |
|
+ Bode Magnitudes | +✓ | +X | +X | ++ |
|
+ Bode Phases | +✓ | +X | ++ | |
|
+ X Cursors | +✓ | +✓ | +✓ | +Cursors on the x-axis | +
|
+ Sequences | +X | +✓ | +X | +There are several performance issues on the logarithmic scale related to having to calculate far to many values. You should use functions defined on N as a substitute if possible. |
+
|
+ Distributions | +✓ | +✓ | +X | ++ |
LogarithmPlotter will also create it's own objects automaticly when needed (for example, the sums of the bode gains and phases).
++
When LogarithmPlotter starts for the first time or when it's been updated, you will be greeted by a screen similar to this one. It allows you to see the changelog, as well as configure the global options of LogarithmPlotter.
+Note that all of those settings can be changed at any moment from the "Settings" menu at the top of the window.
+
+The main interface of LogarithmPlotter is divided into 2 sections, the side bar on the left, and the graph on the right.
+The sidebar allows you to modify the diagram and interact with objects while the graph is where you see your changes and objects applied.
The sidebar is composed of 3 tabs: Objects, Settings and History each of which will be explained in sections below.
+
The Object tab allows you to interact, create and delete with the objects of the graph.
+It is composed of two parts, the objects lists, and the object creation grid.
To create an object, you can click one of the buttons at the bottom of the tab, and it will open a object property editor for that object.
+You can reopen it at any time by clicking on the row associated with the object you want to edit.
+On that row, you can:
+
button.
button.
The Settings tab allows you to change how the diagram looks, and parameter the axes properly. It also features a few buttons you can also find in the menu bar.
+List of settings:
+| Icon | +Name | +Default value | +Definition | +
|---|---|---|---|
 |
+ X Zoom | +100 | +
+ The zoom alongside the x-axis.
+
|
+
 |
+ Y Zoom | +10 | ++ The zoom alongside the ordinate, equivalent to the number of pixels for a unit of 1. + | +
 |
+ Min X | +0.5 | ++ Minimum value to be drawn on the x-axis. In other words, it's the value of x on the left side of the graph. + | +
 |
+ Max Y | +25 | ++ Maximum value to be drawn on the y-axis. In other words, it's the value of y at the bottom of the graph. + | +
 |
+ Max X | +Variable | +
+ Minimum value to be drawn on the x-axis. In other words, it's the value of x on the right side of the graph.
+
|
+
 |
+ Min Y | +Variable | +
+ Minimum value to be drawn on the y-axis. In other words, it's the value of y at the top of the graph.
+
|
+
 |
+ X Axis Step | +4 | +
+ Step of the graduation for the x-axis.
+
|
+
 |
+ Y Axis Step | +4 | +
+ Step of the graduation for the y-axis.
+
|
+
 |
+ Line width | +1 | +
+ Width (percentage) of the the lines and circles of objects shown on the graph.
+
|
+
 |
+ Text size (px) | +14 | ++ Size in pixel of the text shown on the graph. + | +
 |
+ X Label | +Empty | +
+ Label to be used on the x-axis.
+
|
+
 |
+ Y Label | +Empty | +
+ Label to be used on the y-axis.
+
|
+
| + | X Log Scale | +✓ | ++ When checked, the x-axis is represented with a logarithmic scale, otherwise, it's represented with a non logarithmic scale. + | +
| + | Show X graduation | +✓ | ++ When checked, will show the labels alongside the x-axis (10¹, 10², ... or 4, 8, ...). Otherwise, they will be hidden. + | +
| + | Show Y graduation | +✓ | ++ When checked, will show the labels alongside the y-axis (0, 4, ...). Otherwise, they will be hidden. + | +
List of the buttons:
++
The history tab allows you to see the historical progression of graph broken down in "actions" pretaining to objects. The list in itself is read from top to bottom, from most recent to most ancient.
+The "Now" represents the point in history in which the graph is.
+Any action that happened before now are in the "Undo" section of the history, under the "Now". Similarly, the actions that happened after the now are in the "Redo" scection, above the "Now".
+Note: You can hover the actions with your mouse to see more details about them.
+If you want to undo/redo any action, click on it and it will undo/redo it after undoing/redoing the action in between them and the now.
+There exists 7 types of actions:
+| Symbol | +Type | +Occurance | +Color (Light|Dark theme) | +
|---|---|---|---|
 |
+ Object creation | +When a new object is created | +|
 |
+ Object deletion | +When an existing object is deletion | +|
 |
+ Show/hide object | +When an object's is shown or hidden | +|
 |
+ Modify object | +When an object's property is changed | +|
 |
+ Rename object | +When an object's name is changed | +|
 |
+ Coloring the object | +When an object's color is changed | +
You can also filter the actions of the history by using the "Filter..." search bar.
+Note: The changes in the settings tab are not kept in the history tab. This feature may come to a future version of LogarithmPlotter.
++
Each object (as seen in chapter 0) has properties, which are the core of the customisability of objects. There exists many different kind of properties for different things, like naming objects, the position of points, the expression and domains of functions...
+When creating an object, or when clicking on it on the object list, you open the Object Property Editor dialog.
++
Example dialog for a distribution
+ +This dialog contains all of the properties of the object that can be modified. Each property is updated in real time. You can drag the dialog away to see the consequences of your changes on the graph.
+That dialog can be closed by either closing the window or clicking the "OK" button. Both these options save all changes done.
+There exists a lot of properties, but each of them are separated in different kinds.
+| Type | +Editor | +Example(s) | +Comment | +
|---|---|---|---|
| Strings | +Inline text input | +Object name | +At the end of the input, the little "α" button allows to enter symbols (greek letters, and indices or supscripts letters and numbers). | +
| Numbers (integers and decimals) | +Inline text input | +Label position | +All inputs other than digits, one optional minus at the start and a dot in the middle are forbidden. | +
| Expressions | +Inline text input | +Point position, function expression | +Like strings, they have the symbol character input dialog. You can use values like e or pi (can also be noted π) in it. | +
| Domains & ranges (sets) | +Inline text input | +Function domain and range | +Use symbolic expressions (e.g R+* will translate to ℝ⁺*, the strictly positive integer set), ranges (e.g ]0;1[) or even sets (e.g {0;3;4}). | +
| Booleans (true or false) | +Checkbox | +Show graduation on ω0 for Bode Magnitude | ++ |
| Enumerations (set of predefined values) | +Combo box | +Label position and content, point style, bode pass | ++ |
| Other objects | +Combo box | +Bode's ω0, X Cursor's target objects. | +Contains a list of all objects created in required type, and allows to create a new one if needed. X Cursor target object is an exception as it can target several different types of objects. | +
| Lists (lists of values) | +List of inline text inputs | +Unused at the moment | +Sometimes allows the creation of values, at other the number of values is constant. | +
| Dictionaries (list of values associated with another value) | +List of lines having two text inputs separated by text | +Sequence expression and default values, distribution default values | +Sometimes allows the creation of values, at other the number of values is constant. | +
There can also be comments and notes in between properties to explain the specialities of certain non intuitive properties.
+The following section is a reference for all object properties. It's currently up to date with LogarithmPlotter v0.1.8.
+Reference:
+| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Name | +string | +It must not be the same for two objects. | +This value represents the object. | +
|
+ Label content | +Enumeration | +
+
|
+ It's generally used with a positioning property (Label position or Label's X position). | +
+
Points| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ X | +Expression | +Default: 1 | +Position of the point on the x-axis. | +
|
+ Y | +Expression | +Default: 0 | +Position of the point on the y-axis. | +
 |
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the point. | +
|
+ Point style | +Enumeration | +
+
|
+ Visual style of the point representation. | +
+
Texts| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ X | +Expression | +Default: 1 | +Position of the text on the x-axis. | +
|
+ Y | +Expression | +Default: 0 | +Position of the text on the y-axis. | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Content | +string | +Default: New text | +Content of the text item. | +
+
Functions| Icon | +Property | +Type | +Value | +Comment | +||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
 |
+ Expression | +Expression | +Default: x | +Expression of the function (depending on variable x). | +||||||||
 |
+ Domain | +Domain | +Default: ℝ⁺* | +Domain (definition range) of the function. | +||||||||
 |
+ Range | +Domain | +Default: ℝ | +Range (destination range) of the function. | +||||||||
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +||||||||
|
+ Display mode | +Enumeration | +
+
|
+ Display style of the function's label. | +||||||||
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis of the function. | +||||||||
| + | Show points | +boolean | +True or false + Default: true |
+ When using a non continous domain (for example ℕ, ℤ, sets like {0;3}) the function can be displayed using points at the points where the function is defined. Unticking this hides the points. | +||||||||
| + | Show dashed lines | +boolean | +True or false + Default: true |
+ When using a non continous domain (for example ℕ, ℤ, sets like {0;3}) the function can be displayed dashed lines between at the points where the function is defined. Unticking this hides the dashed lines. | +
+
Bode Magnitude| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
 |
+ ω0 | +Point | +By default, a newly created point prefixed by ω in (1,0). | +Used as the base for the beginning/end of the transitional side of the bode magnitude as well. | +
 |
+ Pass | +Enumeration | +
+
|
+ Type of bode magnitude pass used for this this object. | +
 |
+ Gain | +Expression | ++ Default: 20 + | +Amount of decibels per decade used for the bode gain (should be positive for high pass, and negative for low pass). | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis on the function. | +
| + | Show graduation on ω0 | +boolean | +True or false + Default: false |
+ When ticked, will show a vertical dashed line on top of the assigned ω0. | +
+
Bode Magnitudes Sum| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the bode magnitude based on the specified x-axis position and it's corresponding y-axis of the bode magnitude. | +
+
Bode Phases| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ ω0 | +Point | +By default, a newly created point prefixed by ω in (1,0). | +Used as the base for the beginning/end of the transitional side of the bode phase as well. | +
|
+ Phase | +Expression | ++ Default: 90 + | +Amount of phase (defined in the unit below) used for the bode phase. | +
|
+ Unit to use | +Enumeration | +
+
|
+ Unit of the phase to be used (used for display). | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis on the function. | +
+
Bode Phases Sum| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the bode phase based on the specified x-axis position and it's corresponding y-axis of the bode phase. | +
+
X Cursors| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ X | +Expression | +Default: 1 | +Position of the cursor on the x-axis. | +
 |
+ Object to target | +Executable object* | +Default: no object is selected. | +
+ Target object of which to show the value of through the X Cursor. + *Executable objects are objects which take values all along the x-axis with a corresponding y-axis value. Functions, bode magnitudes and phases, sequences and distributions qualify as such. + |
+
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
| + | Show approximate value | +boolean | +True or false + Default: true |
+ When ticked, will show an approximate version of the value of the targeted object at a the given x next to the value of the simplified expression. | +
 |
+ Rounding | +number | +Default: 3 | +Rounding of the approximate value. | +
|
+ Display style | +Enumeration | +
+
|
+ Style of the vertical bar of the cursor. | +
|
+ Target's value position | +Enumeration | +
+
|
+ Position of the target's value on the x cursor. When using "Next to target", it will be at the intersection between the target and the cursor vertical bar, while "With label" puts it just below the name of the cursor and it's position. | +
+
Sequences| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
| + | Show points | +boolean | +True or false + Default: true |
+ Sequences are be displayed using points at each integer the points where the sequence is defined. Unticking this hides the points. | +
| + | Show dashed lines | +boolean | +True or false + Default: true |
+ Sequences are displayed dashed lines between at the points where the sequence is defined. Unticking this hides the dashed lines. | +
| + | Default expression | +Dictionary (fixed length at 1, key is a number, value an expression) | +var[n+k] = expression + Default: var=u, k=1, expression=n u[n+1] = n |
+ Note: The expression is being defined through the n variable. You can use the array-syntax to access previous value. For example, for the variable u, you can define u[n+1] depending on u[n] or u[n+2] depending on u[n] and u[n+1] for recursive definition. | +
| + | Initialisation values | +Dictionary (key is a number, value an expression | +var[k] = expr + Default: var=u, k=0, expr=1 u[0] = 1 |
+ Note: You need as many initialisation values (which can be added through the "Add entry button" and removed with the trash buttons) as k. | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the sequence based on the specified x-axis position (integer) and it's corresponding y-axis of the sequence. | +
+
Distributions| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the distribution based on the specified x-axis position and it's corresponding y-axis of the distribution. | +
| + | Probabilities list | +Dictionary (key is a number, value an number) | +P(var=k) = value + Default: var=X, k=0, expr=1 P(X=0) = 0 |
+ Note: You need as many probabilities as needed (which can be added through the "Add entry button" and removed with the trash buttons) as k. The displayed graph will be the distribution function. | +
+
Several objects that rely on position can be placed on the graph with your mouse using the "Positioning" interface. This interface can be accessed using the button that can be seen on certain object rows.
List of supported objects:
+
Click on the desired location to apply it to the selected object.
+¹ Note: X Cursor only allow for X positioning so you will only see the vertical bar associated with it.
+There are two settings available on the interface:
+The "Pointer precision" setting allow you to set the amount of digits of precision of the cursor. For example, a pointer with a precision digit of 2 will round all pointed position to 2 digits after the decimal point. Setting a precision to 0 will tound all positions to integers.
The "Snap to grid" checkbox rounds the selected position to the nearest intersection of the grid. It's useful for logarithmic scales when you want to quicly select a rounded logarithmic location at a few hundreds or thousands.
+ + \ No newline at end of file diff --git a/static/manuals/logarithmplotter/en/User-Manual.md b/static/manuals/logarithmplotter/en/User-Manual.md new file mode 100644 index 0000000..3533c8c --- /dev/null +++ b/static/manuals/logarithmplotter/en/User-Manual.md @@ -0,0 +1,1259 @@ +# User manual + +Welcome to LogarithmPlotter's user manual. Here, we'll cover most features of LogarithmPlotter and how to use them. + + +[Online version](https://git.ad5001.eu/Ad5001/LogarithmPlotter/wiki/User-Manual) + + +## Introduction: How LogarithmPlotter works +LogarithmPlotter is a software to create plots and graphs with a [logarithmic scale](https://en.wikipedia.org/wiki/Logarithmic_scale), the most well known kind being [Bode plots](https://en.wikipedia.org/wiki/Bode_plot), which LogarithmPlotter helps create in asymptotic form. While logarithmic scales in the primary interest of LogarithmPlotter, LogarithmPlotter also supports non logarithmic scales, which may be required to use certain features. + + +To do that, LogarithmPlotter uses a system called Objects, which may seem familiar to you if you have used other plotting software like [Geogebra](https://geogebra.org). + +An "object" is anything that can be reprensented on the graph. LogarithmPlotter allows you to create 9 types of objects: +| Icon | +Type | +Works well in logarithmic scale | +Works well in non logarithmic scale | +Allows pointer positioning | +Comment | +
|---|---|---|---|---|---|
|
+ Points | +✓ | +✓ | +✓ | ++ |
|
+ Texts | +✓ | +✓ | +✓ | +Used as additional labels if necessary | +
|
+ Functions | +✓ | +✓ | +X | ++ |
|
+ Bode Magnitudes | +✓ | +X | +X | ++ |
|
+ Bode Phases | +✓ | +X | ++ | |
|
+ X Cursors | +✓ | +✓ | +✓ | +Cursors on the x-axis | +
|
+ Sequences | +X | +✓ | +X | +There are several performance issues on the logarithmic scale related to having to calculate far to many values. You should use functions defined on N as a substitute if possible. |
+
|
+ Distributions | +✓ | +✓ | +X | ++ |
| Icon | +Name | +Default value | +Definition | +
|---|---|---|---|
|
+ X Zoom | +100 | +
+ The zoom alongside the x-axis.
+
|
+
|
+ Y Zoom | +10 | ++ The zoom alongside the ordinate, equivalent to the number of pixels for a unit of 1. + | +
|
+ Min X | +0.5 | ++ Minimum value to be drawn on the x-axis. In other words, it's the value of x on the left side of the graph. + | +
|
+ Max Y | +25 | ++ Maximum value to be drawn on the y-axis. In other words, it's the value of y at the bottom of the graph. + | +
|
+ Max X | +Variable | +
+ Minimum value to be drawn on the x-axis. In other words, it's the value of x on the right side of the graph.
+
|
+
|
+ Min Y | +Variable | +
+ Minimum value to be drawn on the y-axis. In other words, it's the value of y at the top of the graph.
+
|
+
|
+ X Axis Step | +4 | +
+ Step of the graduation for the x-axis.
+
|
+
|
+ Y Axis Step | +4 | +
+ Step of the graduation for the y-axis.
+
|
+
|
+ Line width | +1 | +
+ Width (percentage) of the the lines and circles of objects shown on the graph.
+
|
+
|
+ Text size (px) | +14 | ++ Size in pixel of the text shown on the graph. + | +
|
+ X Label | +Empty | +
+ Label to be used on the x-axis.
+
|
+
|
+ Y Label | +Empty | +
+ Label to be used on the y-axis.
+
|
+
| + | X Log Scale | +✓ | ++ When checked, the x-axis is represented with a logarithmic scale, otherwise, it's represented with a non logarithmic scale. + | +
| + | Show X graduation | +✓ | ++ When checked, will show the labels alongside the x-axis (10¹, 10², ... or 4, 8, ...). Otherwise, they will be hidden. + | +
| + | Show Y graduation | +✓ | ++ When checked, will show the labels alongside the y-axis (0, 4, ...). Otherwise, they will be hidden. + | +
| Symbol | +Type | +Occurance | +Color (Light|Dark theme) | +
|---|---|---|---|
|
+ Object creation | +When a new object is created | +|
|
+ Object deletion | +When an existing object is deletion | +|
|
+ Show/hide object | +When an object's is shown or hidden | +|
|
+ Modify object | +When an object's property is changed | +|
|
+ Rename object | +When an object's name is changed | +|
|
+ Coloring the object | +When an object's color is changed | +
+ + + +*Example dialog for a distribution* + +
+ +This dialog contains all of the properties of the object that can be modified. Each property is updated in real time. You can drag the dialog away to see the consequences of your changes on the graph. + +That dialog can be closed by either closing the window or clicking the "OK" button. Both these options save all changes done. + +### Type of properties +There exists a lot of properties, but each of them are separated in different kinds. + +| Type | +Editor | +Example(s) | +Comment | +
|---|---|---|---|
| Strings | +Inline text input | +Object name | +At the end of the input, the little "α" button allows to enter symbols (greek letters, and indices or supscripts letters and numbers). | +
| Numbers (integers and decimals) | +Inline text input | +Label position | +All inputs other than digits, one optional minus at the start and a dot in the middle are forbidden. | +
| Expressions | +Inline text input | +Point position, function expression | +Like strings, they have the symbol character input dialog. You can use values like e or pi (can also be noted π) in it. | +
| Domains & ranges (sets) | +Inline text input | +Function domain and range | +Use symbolic expressions (e.g R+* will translate to ℝ⁺*, the strictly positive integer set), ranges (e.g ]0;1[) or even sets (e.g {0;3;4}). | +
| Booleans (true or false) | +Checkbox | +Show graduation on ω0 for Bode Magnitude | ++ |
| Enumerations (set of predefined values) | +Combo box | +Label position and content, point style, bode pass | ++ |
| Other objects | +Combo box | +Bode's ω0, X Cursor's target objects. | +Contains a list of all objects created in required type, and allows to create a new one if needed. X Cursor target object is an exception as it can target several different types of objects. | +
| Lists (lists of values) | +List of inline text inputs | +Unused at the moment | +Sometimes allows the creation of values, at other the number of values is constant. | +
| Dictionaries (list of values associated with another value) | +List of lines having two text inputs separated by text | +Sequence expression and default values, distribution default values | +Sometimes allows the creation of values, at other the number of values is constant. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Name | +string | +It must not be the same for two objects. | +This value represents the object. | +
|
+ Label content | +Enumeration | +
+
|
+ It's generally used with a positioning property (Label position or Label's X position). | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ X | +Expression | +Default: 1 | +Position of the point on the x-axis. | +
|
+ Y | +Expression | +Default: 0 | +Position of the point on the y-axis. | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the point. | +
|
+ Point style | +Enumeration | +
+
|
+ Visual style of the point representation. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ X | +Expression | +Default: 1 | +Position of the text on the x-axis. | +
|
+ Y | +Expression | +Default: 0 | +Position of the text on the y-axis. | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Content | +string | +Default: New text | +Content of the text item. | +
| Icon | +Property | +Type | +Value | +Comment | +||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
+ Expression | +Expression | +Default: x | +Expression of the function (depending on variable x). | +||||||||
|
+ Domain | +Domain | +Default: ℝ⁺* | +Domain (definition range) of the function. | +||||||||
|
+ Range | +Domain | +Default: ℝ | +Range (destination range) of the function. | +||||||||
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +||||||||
|
+ Display mode | +Enumeration | +
+
|
+ Display style of the function's label. | +||||||||
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis of the function. | +||||||||
| + | Show points | +boolean | +True or false + Default: true |
+ When using a non continous domain (for example ℕ, ℤ, sets like {0;3}) the function can be displayed using points at the points where the function is defined. Unticking this hides the points. | +||||||||
| + | Show dashed lines | +boolean | +True or false + Default: true |
+ When using a non continous domain (for example ℕ, ℤ, sets like {0;3}) the function can be displayed dashed lines between at the points where the function is defined. Unticking this hides the dashed lines. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ ω0 | +Point | +By default, a newly created point prefixed by ω in (1,0). | +Used as the base for the beginning/end of the transitional side of the bode magnitude as well. | +
|
+ Pass | +Enumeration | +
+
|
+ Type of bode magnitude pass used for this this object. | +
|
+ Gain | +Expression | ++ Default: 20 + | +Amount of decibels per decade used for the bode gain (should be positive for high pass, and negative for low pass). | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis on the function. | +
| + | Show graduation on ω0 | +boolean | +True or false + Default: false |
+ When ticked, will show a vertical dashed line on top of the assigned ω0. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the bode magnitude based on the specified x-axis position and it's corresponding y-axis of the bode magnitude. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ ω0 | +Point | +By default, a newly created point prefixed by ω in (1,0). | +Used as the base for the beginning/end of the transitional side of the bode phase as well. | +
|
+ Phase | +Expression | ++ Default: 90 + | +Amount of phase (defined in the unit below) used for the bode phase. | +
|
+ Unit to use | +Enumeration | +
+
|
+ Unit of the phase to be used (used for display). | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis on the function. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the bode phase based on the specified x-axis position and it's corresponding y-axis of the bode phase. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ X | +Expression | +Default: 1 | +Position of the cursor on the x-axis. | +
|
+ Object to target | +Executable object* | +Default: no object is selected. | +
+ Target object of which to show the value of through the X Cursor. + *Executable objects are objects which take values all along the x-axis with a corresponding y-axis value. Functions, bode magnitudes and phases, sequences and distributions qualify as such. + |
+
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
| + | Show approximate value | +boolean | +True or false + Default: true |
+ When ticked, will show an approximate version of the value of the targeted object at a the given x next to the value of the simplified expression. | +
|
+ Rounding | +number | +Default: 3 | +Rounding of the approximate value. | +
|
+ Display style | +Enumeration | +
+
|
+ Style of the vertical bar of the cursor. | +
|
+ Target's value position | +Enumeration | +
+
|
+ Position of the target's value on the x cursor. When using "Next to target", it will be at the intersection between the target and the cursor vertical bar, while "With label" puts it just below the name of the cursor and it's position. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
| + | Show points | +boolean | +True or false + Default: true |
+ Sequences are be displayed using points at each integer the points where the sequence is defined. Unticking this hides the points. | +
| + | Show dashed lines | +boolean | +True or false + Default: true |
+ Sequences are displayed dashed lines between at the points where the sequence is defined. Unticking this hides the dashed lines. | +
| + | Default expression | +Dictionary (fixed length at 1, key is a number, value an expression) | +var[n+k] = expression + Default: var=u, k=1, expression=n u[n+1] = n |
+ Note: The expression is being defined through the n variable. You can use the array-syntax to access previous value. For example, for the variable u, you can define u[n+1] depending on u[n] or u[n+2] depending on u[n] and u[n+1] for recursive definition. | +
| + | Initialisation values | +Dictionary (key is a number, value an expression | +var[k] = expr + Default: var=u, k=0, expr=1 u[0] = 1 |
+ Note: You need as many initialisation values (which can be added through the "Add entry button" and removed with the trash buttons) as k. | +
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the sequence based on the specified x-axis position (integer) and it's corresponding y-axis of the sequence. | +
| Icon | +Property | +Type | +Value | +Comment | +
|---|---|---|---|---|
|
+ Label position | +Enumeration | +
+
|
+ Position of the label relative to the position. | +
|
+ Label's X position | +number | +Default: 1 | +Base position for the label of the distribution based on the specified x-axis position and it's corresponding y-axis of the distribution. | +
| + | Probabilities list | +Dictionary (key is a number, value an number) | +P(var=k) = value + Default: var=X, k=0, expr=1 P(X=0) = 0 |
+ Note: You need as many probabilities as needed (which can be added through the "Add entry button" and removed with the trash buttons) as k. The displayed graph will be the distribution function. | +
Bienvenue dans le manuel d'utilisation de LogarithmPlotter. Nous allons couvrir ici la plupart des fonctionnalités de LogarithmPlotter et comment les utiliser.
+ ++
LogarithmPlotter est un logiciel permettant de créer des tracés et des graphiques avec une échelle logarithmique, le type le plus connu étant les diagrammes de Bode, que LogarithmPlotter aide à créer sous forme asymptotique. Bien que les échelles logarithmiques soient le principal intérêt de LogarithmPlotter, ce logiciel supporte également les échelles non logarithmiques, ce qui peut être nécessaire pour utiliser certaines fonctions.
+Pour ce faire, LogarithmPlotter utilise un système appelé Objets, qui peut vous sembler familier si vous avez utilisé d'autres logiciels de traçage comme Geogebra.
+Un "objet" est tout ce qui peut être représenté sur le graphique. LogarithmPlotter vous permet de créer 9 types d'objets :
+| Symbole | +Type | +Fonctionne bien dans l'échelle logarithmique | +Fonctionne bien dans l'échelle non logarithmique | +Autorise le positionnement du pointeur | +Commentaire | +
|---|---|---|---|---|---|
|
+ Points | +✓ | +✓ | +✓ | ++ |
|
+ Textes | +✓ | +✓ | +✓ | +Utilisés comme textes supplémentaires si nécessaire | +
|
+ Fonctions | +✓ | +✓ | +X | ++ |
|
+ Gains de Bode | +✓ | +X | +X | ++ |
|
+ Phases de Bode | +✓ | +X | +X | ++ |
|
+ Curseurs X | +✓ | +✓ | +✓ | +Curseurs sur l'axe des abscisses | +
|
+ Suites | +X | +✓ | +X | +Il y a plusieurs problèmes de performance sur l'échelle logarithmique liés au fait de devoir calculer beaucoup trop de valeurs. Vous devriez utiliser des fonctions définies sur N comme substitut si possible. |
+
|
+ (Fonctions de) Répartition | +✓ | +✓ | +X | ++ |
LogarithmPlotter créera également ses propres objets automatiquement lorsque cela est nécessaire (par exemple, les sommes des gains et des phases de bode).
++
Lorsque LogarithmPlotter démarre pour la première fois ou lorsqu'il a été mis à jour, vous serez accueilli par un écran similaire à celui-ci. Il vous permet de voir l'historique des modifications, ainsi que de configurer les options globales de LogarithmPlotter.
+Notez que tous ces paramètres peuvent être modifiés à tout moment à partir du menu "Paramètres" en haut de la fenêtre.
+
L'interface principale de LogarithmPlotter est divisée en 2 sections, la barre latérale à gauche, et le graphique à droite.
+La barre latérale vous permet de modifier le diagramme et d'interagir avec les objets tandis que le graphique est l'endroit où vous voyez vos modifications et les objets appliqués.
La barre latérale est composée de 3 onglets : Objets, Paramètres et Historique dont chacun sera expliqué dans les sections ci-dessous.
+
L'onglet Objets permet d'interagir, de créer et de supprimer les objets du graphique.
+Il est composé de deux parties, les listes d'objets, et la grille de création d'objets.
+Pour créer un objet, vous pouvez cliquer sur l'un des boutons en bas de l'onglet, ce qui ouvrira un éditeur de propriétés d'objets pour cet objet.
Vous pouvez le rouvrir à tout moment en cliquant sur la ligne associée à l'objet que vous souhaitez modifier.
+Sur cette ligne, vous pouvez :
+..
+L'onglet Paramètres vous permet de modifier l'apparence du diagramme et de paramétrer correctement les axes. Il comporte également quelques boutons que l'on retrouve également dans la barre de menu.
Liste des paramètres :
+| Icône | +Nom | +Valeur par défaut | +Définition | +
|---|---|---|---|
|
+ Zoom en X | +100 | +
+ Le zoom le long de l'axe des x.
+
|
+
|
+ Zoom en Y | +10 | ++ Le zoom le long de l'ordonnée, équivalent au nombre de pixels pour une unité de 1. + | +
|
+ Min X | +0,5 | ++ Valeur minimale à dessiner sur l'axe des abscisses. En d'autres termes, c'est la valeur de x sur le côté gauche du graphique. + | +
|
+ Max Y | +25 | ++ Valeur maximale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en bas du graphique. + | +
|
+ Max X | +Variable | +
+ Valeur minimale à dessiner sur l'axe des abscisses. En d'autres termes, c'est la valeur de x sur le côté droit du graphique.
+
|
+
|
+ Min Y | +Variable | +
+ Valeur minimale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en haut du graphique.
+
|
+
|
+ Pas de l'axe X | +4 | +
+ Pas de la graduation pour l'axe des abscisses.
+
|
+
|
+ Pas de l'axe Y | +4 | +
+ Pas de la graduation pour l'axe des y.
+
|
+
|
+ Taille des lignes | +1 | +
+ Largeur (pourcentage) des lignes et des cercles d'objets représentés sur le graphique.
+
|
+
|
+ Taille du texte (px) | +14 | ++ Taille en pixel du texte affiché sur le graphique. + | +
|
+ Label de l'axe X | +Vide | +
+ Étiquette à utiliser sur l'axe des abscisses.
+
|
+
|
+ Label de l'axe Y | +Vide | +
+ Étiquette à utiliser sur l'axe des ordonnées.
+
|
+
| + | Échelle logarithmique en X | +✓ | ++ Lorsque cette option est cochée, l'axe des abscisses est représenté avec une échelle logarithmique, sinon, il est représenté avec une échelle non logarithmique. + | +
| + | Montrer la graduation X | +✓ | ++ Si cette option est cochée, affichera les étiquettes à côté de l'axe des abscisses (10¹, 10², ... ou 4, 8, ...). Dans le cas contraire, elles seront cachées. + | +
| + | Montrer la graduation de l'axe Y | +✓ | ++ Si cette option est cochée, affichera les étiquettes à côté de l'axe des ordonnées (0, 4, ...). Dans le cas contraire, elles seront cachées. + | +
Liste des boutons :
++
L'onglet historique vous permet de voir la progression historique du graphique décomposé en "actions" relatives aux objets. La liste en elle-même se lit de haut en bas, du plus récent au plus ancien.
+L'État actuel représente le point de l'historique dans lequel se trouve le graphique.
+Toutes les actions qui se sont produites avant l'état actuel se trouvent dans la section "Annuler" de l'historique, sous l'état actuel. De même, les actions qui se sont produites après l'état actuel se trouvent dans la section "Rétablir", au-dessus de l'état actuel.
+Note : Vous pouvez survoler les actions avec votre souris pour voir plus de détails à leur sujet.
+Si vous voulez annuler/rétablir une action, cliquez dessus et elle sera annulée/rétablie après avoir annulé/rétabli l'action entre elles et l'état actuel.
+Il existe 7 types d'actions :
+| Symbole | +Type | +Condition d'apparition | +Couleur (Thème clair|Foncé) | +
|---|---|---|---|
|
+ Création d'objet | +Lorsqu'un nouvel objet est créé | +|
|
+ Suppression d'objet | +Lorsqu'un objet existant est supprimé | +|
|
+ Montrer/cacher l'objet | +Quand celui d'un objet est affiché ou caché | +|
|
+ Modifier un objet | +Lorsque la propriété d'un objet est modifiée | +|
|
+ Renommer un objet | +Lorsque le nom d'un objet est modifié | +|
|
+ Coloration de l'objet | +Lorsque la couleur d'un objet est modifiée | +
Vous pouvez également filtrer les actions de l'historique en utilisant la barre de recherche "Filtrer...".
+Note : Les changements dans l'onglet des paramètres ne sont pas conservés dans l'onglet de l'historique. Cette fonctionnalité pourrait arriver dans une version future de LogarithmPlotter.
++
Chaque objet (comme vu dans le chapitre 0) possède des propriétés, qui sont au cœur de la personnalisation des objets. Il existe de nombreux types de propriétés pour des choses différentes, comme le nom des objets, la position des points, l'expression et les domaines des fonctions...
+Lorsque vous créez un objet, ou lorsque vous cliquez dessus dans la liste des objets, vous ouvrez la boîte de dialogue Éditeur de Propriétés d'Objet.
++
Exemple de dialogue pour une fonction de répartition
+ +Cette boîte de dialogue contient toutes les propriétés de l'objet qui peuvent être modifiées. Chaque propriété est mise à jour en temps réel. Vous pouvez faire glisser le dialogue pour voir les conséquences de vos modifications sur le graphique.
+Ce dialogue peut être fermé soit en fermant la fenêtre, soit en cliquant sur le bouton "OK". Ces deux options permettent de sauvegarder toutes les modifications effectuées.
+Il existe beaucoup de propriétés, mais chacune d'entre elles est séparée en différents types.
+| Type | +Éditeur | +Exemple(s) | +Commentaire | +|
|---|---|---|---|---|
| Chaînes de caractères | +Saisie de texte en ligne | +Nom de l'objet | +À la fin de la saisie, le petit bouton "α" permet de saisir des symboles (lettres grecques et indices ou lettres et chiffres en indice ou en exposant). | +|
| Nombres (entiers et décimaux) | +Saisie de texte en ligne | +Position de l'étiquette | +Toutes les entrées autres que les chiffres, un moins optionnel au début et un point au milieu sont interdites. | +|
| Expressions | +Saisie de texte en ligne | +Position de point, expression de fonction | +Comme les chaînes de caractères, elles disposent du dialogue de saisie du caractère symbole. Vous pouvez y utiliser des valeurs comme e ou pi (peut aussi être noté π). | +|
| Domaines et plages (ensembles) | +Saisie de texte en ligne | +Domaine et plage de fonctions | +Utiliser des expressions symboliques (par exemple R+* se traduira par ℝ⁺*, l'ensemble des nombres entiers strictement positifs), des plages (par exemple ]0;1[) ou même des ensembles (par exemple {0;3;4}). | +|
| Booléens (vrai ou faux) | +Case à cocher | +Montrer la graduation sur ω0 pour la magnitude de Bode | ++ | |
| Énumérations (ensemble de valeurs prédéfinies) | +Sélection de choix | +Position et contenu de l'étiquette, style de point, passage de bode | ++ | |
| Autres objets | +Sélection de choix | +Les ω0 de Bode, les objets cibles du curseur X. | + | Contient une liste de tous les objets créés dans le type requis, et permet d'en créer un nouveau si nécessaire. L'objet cible du curseur X est une exception, car il peut cibler plusieurs types d'objets différents. | +
| Listes (listes de valeurs) | +Liste d'entrées de texte en ligne | +Non utilisé pour le moment | +Parfois permet la création de valeurs, à d'autres le nombre de valeurs est constant. | +|
| Dictionnaires (liste de valeurs associées à une autre valeur) | +Liste de lignes ayant deux entrées de texte séparées par du texte | +Expressions et valeurs par défaut de suite, valeurs par défaut de fonction de répartition | +Parfois permet la création de valeurs, à d'autres le nombre de valeurs est constant. | +
Il peut également y avoir des commentaires et des notes entre les propriétés pour expliquer les particularités de certaines propriétés non intuitives.
+La section suivante est une référence pour toutes les propriétés des objets. Elle est actuellement à jour avec LogarithmPlotter v0.1.8.
+Référence :
+| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Nom | +Chaîne de caractères | +Ne doit pas être le même pour deux objets. | +Cette valeur représente l'objet. | +
|
+ Contenu de l'étiquette | +Énumération | +
+
|
+ Généralement utilisé avec une propriété de positionnement (position de l'étiquette ou position X de l'étiquette). | +
+
Points| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ X | +Expression | +Par défaut : 1 | +La position du point sur l'axe des abscisses. | +
|
+ Y | +Expression | +Par défaut : 0 | +La position du point sur l'axe des ordonnées. | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport au point. | +
|
+ Style du point | +Enumeration | +
+
|
+ Style visuel de la représentation des points. | +
+
Textes| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ X | +Expression | +Par défaut : 1 | +Position du texte sur l'axe des abscisses. | +
|
+ Y | +Expression | +Par défaut : 0 | +Position du texte sur l'axe des ordonnées. | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Contenu | +Chaîne | +Par défaut : Nouveau texte | +Contenu de l'élément de texte. | +
+
Fonctions| Icône | +Propriété | +Type | +Valeur | +Commentaire | +||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
+ Expression | +Expression | +Par défaut : x | +Expression de la fonction (en fonction de la variable x). | +||||||||
|
+ Domaine de définition | +Domaine | +Par défaut : ℝ⁺* | +Domaine de définition de la fonction. | +||||||||
|
+ Portée | +Domaine | +Par défaut : ℝ | +Portée de la fonction | +||||||||
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +||||||||
|
+ Mode d'affichage | +Enumeration | +
+
|
+ Style d'affichage de l'étiquette de la fonction. | +||||||||
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour le label de la fonction en fonction de la position de l'axe des abscisses spécifiée et de son axe des ordonnées correspondant de la fonction. | +||||||||
| + | Afficher les points | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Quand un domaine non continu est utilisé (par exemple ℕ, ℤ, des ensembles comme {0;3}), la fonction peut être affichée en utilisant des points aux endroits où la fonction est définie. En décochant cette option, les points sont masqués. | +||||||||
| + | Afficher les pointillées | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Lorsque le domaine utilisé n'est pas continu (par exemple ℕ, ℤ, des ensembles comme {0;3}) la fonction peut être affichée en pointillés entre aux points où la fonction est définie. En décochant cette option, les lignes en pointillés sont masquées. | +
+
Gain de Bode| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ ω0 | +Point | +Par défaut, un point nouvellement créé préfixé par ω dans (1,0). | +Utilisé comme base pour le début/la fin du côté transitionnel de la gain de Bode également. | +
|
+ Passe | +Enumeration | +
+
|
+ Type de passe de gain de Bode utilisé pour cet objet. | +
|
+ Gain | +Expression | ++ Par défaut : 20 + | +Nombre de décibels par décennie utilisés pour le gain de bode (doit être positif pour un passe haut, et négatif pour un passe bas). | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour le label de la fonction en fonction de la position de l'axe des abscisses spécifiée et de son axe des ordonnées correspondant sur la fonction. | +
| + | Afficher la graduation sur ω0 | +Booléen | +Vrai ou faux + Par defaut: faux |
+ Si coché, montrera une ligne verticale en pointillés sur le dessus du ω0 assigné. | +
+
Somme des gains de Bode| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la magnitude du bode sur la base de la position spécifiée de l'axe des abscisses et de son axe des ordonnées correspondant du gain du bode. | +
+
Phases de Bode| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ ω0 | +Point | +Par défaut, un point nouvellement créé préfixé par ω dans (1,0). | +Utilisé comme base pour le début/fin du côté transitionnel de la phase de bode également. | +
|
+ Phase | +Expression | ++ Par défaut : 90 + | +Montant de phase (défini dans l'unité ci-dessous) utilisé pour la phase du bode. | +
|
+ Unité à utiliser | +Enumeration | +
+
|
+ Unité de la phase à utiliser (utilisée pour l'affichage). | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour le label de la fonction en fonction de la position de l'axe des abscisses spécifiée et de son axe des ordonnées correspondant sur la fonction. | +
+
Somme des phases de Bode| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la phase de bode sur la base de la position spécifiée de l'axe des abscisses et de son axe y correspondant de la phase de bode. | +
+
Curseurs X| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ X | +Expression | +Par défaut : 1 | +Position du curseur sur l'axe des abscisses. | +
|
+ Objet à cibler | +Objet exécutable* | +Par défaut : aucun objet n'est sélectionné. | +
+ Objet cible dont il faut afficher la valeur par l'intermédiaire du curseur X. + *Les objets exécutables sont des objets qui prennent des valeurs tout au long de l'axe des abscisses avec une valeur correspondante sur l'axe des ordonnées. Les fonctions, les gains et les phases de bode, les séquences et les distributions sont qualifiées comme telles. + |
+
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à sa position. | +
| + | Afficher la valeur approximative | +Booléen | +Vrai ou faux + Par défaut : vrai |
+ Lorsque cette option est cochée, le curseur affichera une version approximative de la valeur de l'objet ciblé à un x donné à côté de la valeur de l'expression simplifiée. | +
|
+ Arrondi | +nombre | +Par défaut : 3 | +Arrondi de la valeur approchée. | +
|
+ Style d'affichage | +Enumeration | +
+
|
+ Style de la barre verticale du curseur. | +
|
+ Position de la valeur de la cible | +Enumeration | +
+
|
+ Position de la valeur de la cible sur le curseur x. Si vous utilisez "À coté de la cible", elle se trouvera à l'intersection entre la cible et la barre verticale du curseur, tandis que "Avec l'étiquette" la place juste en dessous du nom et de la position du curseur. | +
+
Suites| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
| + | Afficher les points | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Les suites sont affichées en utilisant des points à chaque entier des points où la suite est définie. En décochant cette case, les points sont cachés.. | +
| + | Afficher les pointillées | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Les suites sont affichées en pointillés entre les points où la suite est définie. En décochant cette option, les lignes en pointillés sont masquées.. | +
| + | Expression | +Dictionnaire (longueur fixe à 1, la clé est un nombre, la valeur une expression) | +var[n+k] = expression + Par défaut : var=u, k=1, expression=n u[n+1] = n |
+ Remarque : L'expression est définie par la variable n. Vous pouvez utiliser la syntaxe array pour accéder aux valeurs précédentes. Par exemple, pour la variable u, vous pouvez définir u[n+1] en fonction de u[n] ou u[n+2] en fonction de u[n] et u[n+1] pour une définition récursive. | +
| + | Valeurs d'initialisation | +Dictionnaire (la clé est un nombre, la valeur une expression) | +var[k] = expr + Par défaut : var=u, k=0, expr=1 u[0] = 1 |
+ Remarque : Vous avez besoin d'autant de valeurs d'initialisation (qui peuvent être ajoutées à l'aide du bouton "Ajouter une entrée" et supprimées à l'aide des boutons "poubelle") que k. | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la suite basée sur la position spécifiée de l'axe x (entier) et de l'axe y correspondant de la suite. | +
+
Répartitions| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la distribution en fonction de la position spécifiée de l'axe x et de son axe y correspondant de la distribution. | +
| + | Liste de probabilités | +Dictionnaire (la clé est un nombre, la valeur un nombre) | +P(var=k) = valeur + Default: var=X, k=0, expr=1 P(X=0) = 0 |
+ Note : Vous avez besoin d'autant de probabilités que nécessaire (qui peuvent être ajoutées grâce au bouton "Ajouter une entrée" et supprimées avec les boutons poubelle) que k. Le graphique affiché sera la fonction de distribution. | +
+
Plusieurs objets qui dépendent de la position peuvent être placés sur le graphique avec votre souris en utilisant l'interface "Positionnement". Cette interface est accessible par le bouton que l'on peut voir sur certaines lignes d'objets.
Liste des objets supportés :
+
Cliquez sur l'emplacement souhaité pour l'appliquer à l'objet sélectionné.
+¹ Remarque : le curseur X ne permet que le positionnement en X ; vous ne verrez donc que la barre verticale qui lui est associée.
+Deux paramètres sont disponibles sur l'interface :
+Le paramètre "Précision du pointeur" vous permet de définir le nombre de chiffres de précision du curseur. Par exemple, un pointeur avec une précision de 2 arrondira toutes les positions pointées à 2 chiffres après la virgule. Si vous définissez une précision de 0, toutes les positions seront arrondies à des nombres entiers.
La case à cocher "Placement sur la grille" arrondit la position sélectionnée à l'intersection la plus proche de la grille. C'est utile pour les échelles logarithmiques lorsque vous voulez sélectionner rapidement une position logarithmique arrondie à quelques centaines ou milliers.
+ + \ No newline at end of file diff --git a/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.md b/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.md new file mode 100644 index 0000000..bed2a44 --- /dev/null +++ b/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.md @@ -0,0 +1,1257 @@ +# Manuel d'utilisation + +Bienvenue dans le manuel d'utilisation de LogarithmPlotter. Nous allons couvrir ici la plupart des fonctionnalités de LogarithmPlotter et comment les utiliser. + + +[Online version](https://git.ad5001.eu/Ad5001/LogarithmPlotter/wiki/Manuel-d'utilisation) + + +## Introduction : Comment fonctionne LogarithmPlotter +LogarithmPlotter est un logiciel permettant de créer des tracés et des graphiques avec une [échelle logarithmique](https://en.wikipedia.org/wiki/Logarithmic_scale), le type le plus connu étant les [diagrammes de Bode](https://en.wikipedia.org/wiki/Bode_plot), que LogarithmPlotter aide à créer sous forme asymptotique. Bien que les échelles logarithmiques soient le principal intérêt de LogarithmPlotter, ce logiciel supporte également les échelles non logarithmiques, ce qui peut être nécessaire pour utiliser certaines fonctions. + + +Pour ce faire, LogarithmPlotter utilise un système appelé Objets, qui peut vous sembler familier si vous avez utilisé d'autres logiciels de traçage comme [Geogebra](https://geogebra.org). + +Un "objet" est tout ce qui peut être représenté sur le graphique. LogarithmPlotter vous permet de créer 9 types d'objets : + + +| Symbole | +Type | +Fonctionne bien dans l'échelle logarithmique | +Fonctionne bien dans l'échelle non logarithmique | +Autorise le positionnement du pointeur | +Commentaire | +
|---|---|---|---|---|---|
|
+ Points | +✓ | +✓ | +✓ | ++ |
|
+ Textes | +✓ | +✓ | +✓ | +Utilisés comme textes supplémentaires si nécessaire | +
|
+ Fonctions | +✓ | +✓ | +X | ++ |
|
+ Gains de Bode | +✓ | +X | +X | ++ |
|
+ Phases de Bode | +✓ | +X | +X | ++ |
|
+ Curseurs X | +✓ | +✓ | +✓ | +Curseurs sur l'axe des abscisses | +
|
+ Suites | +X | +✓ | +X | +Il y a plusieurs problèmes de performance sur l'échelle logarithmique liés au fait de devoir calculer beaucoup trop de valeurs. Vous devriez utiliser des fonctions définies sur N comme substitut si possible. |
+
|
+ (Fonctions de) Répartition | +✓ | +✓ | +X | ++ |
| Icône | +Nom | +Valeur par défaut | +Définition | +
|---|---|---|---|
|
+ Zoom en X | +100 | +
+ Le zoom le long de l'axe des x.
+
|
+
|
+ Zoom en Y | +10 | ++ Le zoom le long de l'ordonnée, équivalent au nombre de pixels pour une unité de 1. + | +
|
+ Min X | +0,5 | ++ Valeur minimale à dessiner sur l'axe des abscisses. En d'autres termes, c'est la valeur de x sur le côté gauche du graphique. + | +
|
+ Max Y | +25 | ++ Valeur maximale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en bas du graphique. + | +
|
+ Max X | +Variable | +
+ Valeur minimale à dessiner sur l'axe des abscisses. En d'autres termes, c'est la valeur de x sur le côté droit du graphique.
+
|
+
|
+ Min Y | +Variable | +
+ Valeur minimale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en haut du graphique.
+
|
+
|
+ Pas de l'axe X | +4 | +
+ Pas de la graduation pour l'axe des abscisses.
+
|
+
|
+ Pas de l'axe Y | +4 | +
+ Pas de la graduation pour l'axe des y.
+
|
+
|
+ Taille des lignes | +1 | +
+ Largeur (pourcentage) des lignes et des cercles d'objets représentés sur le graphique.
+
|
+
|
+ Taille du texte (px) | +14 | ++ Taille en pixel du texte affiché sur le graphique. + | +
|
+ Label de l'axe X | +Vide | +
+ Étiquette à utiliser sur l'axe des abscisses.
+
|
+
|
+ Label de l'axe Y | +Vide | +
+ Étiquette à utiliser sur l'axe des ordonnées.
+
|
+
| + | Échelle logarithmique en X | +✓ | ++ Lorsque cette option est cochée, l'axe des abscisses est représenté avec une échelle logarithmique, sinon, il est représenté avec une échelle non logarithmique. + | +
| + | Montrer la graduation X | +✓ | ++ Si cette option est cochée, affichera les étiquettes à côté de l'axe des abscisses (10¹, 10², ... ou 4, 8, ...). Dans le cas contraire, elles seront cachées. + | +
| + | Montrer la graduation de l'axe Y | +✓ | ++ Si cette option est cochée, affichera les étiquettes à côté de l'axe des ordonnées (0, 4, ...). Dans le cas contraire, elles seront cachées. + | +
| Symbole | +Type | +Condition d'apparition | +Couleur (Thème clair|Foncé) | +
|---|---|---|---|
|
+ Création d'objet | +Lorsqu'un nouvel objet est créé | +|
|
+ Suppression d'objet | +Lorsqu'un objet existant est supprimé | +|
|
+ Montrer/cacher l'objet | +Quand celui d'un objet est affiché ou caché | +|
|
+ Modifier un objet | +Lorsque la propriété d'un objet est modifiée | +|
|
+ Renommer un objet | +Lorsque le nom d'un objet est modifié | +|
|
+ Coloration de l'objet | +Lorsque la couleur d'un objet est modifiée | +
+ + + +*Exemple de dialogue pour une fonction de répartition* + +
+ +Cette boîte de dialogue contient toutes les propriétés de l'objet qui peuvent être modifiées. Chaque propriété est mise à jour en temps réel. Vous pouvez faire glisser le dialogue pour voir les conséquences de vos modifications sur le graphique. + +Ce dialogue peut être fermé soit en fermant la fenêtre, soit en cliquant sur le bouton "OK". Ces deux options permettent de sauvegarder toutes les modifications effectuées. + +### Types de propriétés +Il existe beaucoup de propriétés, mais chacune d'entre elles est séparée en différents types. + +| Type | +Éditeur | +Exemple(s) | +Commentaire | +|
|---|---|---|---|---|
| Chaînes de caractères | +Saisie de texte en ligne | +Nom de l'objet | +À la fin de la saisie, le petit bouton "α" permet de saisir des symboles (lettres grecques et indices ou lettres et chiffres en indice ou en exposant). | +|
| Nombres (entiers et décimaux) | +Saisie de texte en ligne | +Position de l'étiquette | +Toutes les entrées autres que les chiffres, un moins optionnel au début et un point au milieu sont interdites. | +|
| Expressions | +Saisie de texte en ligne | +Position de point, expression de fonction | +Comme les chaînes de caractères, elles disposent du dialogue de saisie du caractère symbole. Vous pouvez y utiliser des valeurs comme e ou pi (peut aussi être noté π). | +|
| Domaines et plages (ensembles) | +Saisie de texte en ligne | +Domaine et plage de fonctions | +Utiliser des expressions symboliques (par exemple R+* se traduira par ℝ⁺*, l'ensemble des nombres entiers strictement positifs), des plages (par exemple ]0;1[) ou même des ensembles (par exemple {0;3;4}). | +|
| Booléens (vrai ou faux) | +Case à cocher | +Montrer la graduation sur ω0 pour la magnitude de Bode | ++ | |
| Énumérations (ensemble de valeurs prédéfinies) | +Sélection de choix | +Position et contenu de l'étiquette, style de point, passage de bode | ++ | |
| Autres objets | +Sélection de choix | +Les ω0 de Bode, les objets cibles du curseur X. | + | Contient une liste de tous les objets créés dans le type requis, et permet d'en créer un nouveau si nécessaire. L'objet cible du curseur X est une exception, car il peut cibler plusieurs types d'objets différents. | +
| Listes (listes de valeurs) | +Liste d'entrées de texte en ligne | +Non utilisé pour le moment | +Parfois permet la création de valeurs, à d'autres le nombre de valeurs est constant. | +|
| Dictionnaires (liste de valeurs associées à une autre valeur) | +Liste de lignes ayant deux entrées de texte séparées par du texte | +Expressions et valeurs par défaut de suite, valeurs par défaut de fonction de répartition | +Parfois permet la création de valeurs, à d'autres le nombre de valeurs est constant. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Nom | +Chaîne de caractères | +Ne doit pas être le même pour deux objets. | +Cette valeur représente l'objet. | +
|
+ Contenu de l'étiquette | +Énumération | +
+
|
+ Généralement utilisé avec une propriété de positionnement (position de l'étiquette ou position X de l'étiquette). | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ X | +Expression | +Par défaut : 1 | +La position du point sur l'axe des abscisses. | +
|
+ Y | +Expression | +Par défaut : 0 | +La position du point sur l'axe des ordonnées. | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport au point. | +
|
+ Style du point | +Enumeration | +
+
|
+ Style visuel de la représentation des points. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ X | +Expression | +Par défaut : 1 | +Position du texte sur l'axe des abscisses. | +
|
+ Y | +Expression | +Par défaut : 0 | +Position du texte sur l'axe des ordonnées. | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Contenu | +Chaîne | +Par défaut : Nouveau texte | +Contenu de l'élément de texte. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
+ Expression | +Expression | +Par défaut : x | +Expression de la fonction (en fonction de la variable x). | +||||||||
|
+ Domaine de définition | +Domaine | +Par défaut : ℝ⁺* | +Domaine de définition de la fonction. | +||||||||
|
+ Portée | +Domaine | +Par défaut : ℝ | +Portée de la fonction | +||||||||
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +||||||||
|
+ Mode d'affichage | +Enumeration | +
+
|
+ Style d'affichage de l'étiquette de la fonction. | +||||||||
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour le label de la fonction en fonction de la position de l'axe des abscisses spécifiée et de son axe des ordonnées correspondant de la fonction. | +||||||||
| + | Afficher les points | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Quand un domaine non continu est utilisé (par exemple ℕ, ℤ, des ensembles comme {0;3}), la fonction peut être affichée en utilisant des points aux endroits où la fonction est définie. En décochant cette option, les points sont masqués. | +||||||||
| + | Afficher les pointillées | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Lorsque le domaine utilisé n'est pas continu (par exemple ℕ, ℤ, des ensembles comme {0;3}) la fonction peut être affichée en pointillés entre aux points où la fonction est définie. En décochant cette option, les lignes en pointillés sont masquées. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ ω0 | +Point | +Par défaut, un point nouvellement créé préfixé par ω dans (1,0). | +Utilisé comme base pour le début/la fin du côté transitionnel de la gain de Bode également. | +
|
+ Passe | +Enumeration | +
+
|
+ Type de passe de gain de Bode utilisé pour cet objet. | +
|
+ Gain | +Expression | ++ Par défaut : 20 + | +Nombre de décibels par décennie utilisés pour le gain de bode (doit être positif pour un passe haut, et négatif pour un passe bas). | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour le label de la fonction en fonction de la position de l'axe des abscisses spécifiée et de son axe des ordonnées correspondant sur la fonction. | +
| + | Afficher la graduation sur ω0 | +Booléen | +Vrai ou faux + Par defaut: faux |
+ Si coché, montrera une ligne verticale en pointillés sur le dessus du ω0 assigné. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la magnitude du bode sur la base de la position spécifiée de l'axe des abscisses et de son axe des ordonnées correspondant du gain du bode. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ ω0 | +Point | +Par défaut, un point nouvellement créé préfixé par ω dans (1,0). | +Utilisé comme base pour le début/fin du côté transitionnel de la phase de bode également. | +
|
+ Phase | +Expression | ++ Par défaut : 90 + | +Montant de phase (défini dans l'unité ci-dessous) utilisé pour la phase du bode. | +
|
+ Unité à utiliser | +Enumeration | +
+
|
+ Unité de la phase à utiliser (utilisée pour l'affichage). | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour le label de la fonction en fonction de la position de l'axe des abscisses spécifiée et de son axe des ordonnées correspondant sur la fonction. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la phase de bode sur la base de la position spécifiée de l'axe des abscisses et de son axe y correspondant de la phase de bode. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ X | +Expression | +Par défaut : 1 | +Position du curseur sur l'axe des abscisses. | +
|
+ Objet à cibler | +Objet exécutable* | +Par défaut : aucun objet n'est sélectionné. | +
+ Objet cible dont il faut afficher la valeur par l'intermédiaire du curseur X. + *Les objets exécutables sont des objets qui prennent des valeurs tout au long de l'axe des abscisses avec une valeur correspondante sur l'axe des ordonnées. Les fonctions, les gains et les phases de bode, les séquences et les distributions sont qualifiées comme telles. + |
+
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à sa position. | +
| + | Afficher la valeur approximative | +Booléen | +Vrai ou faux + Par défaut : vrai |
+ Lorsque cette option est cochée, le curseur affichera une version approximative de la valeur de l'objet ciblé à un x donné à côté de la valeur de l'expression simplifiée. | +
|
+ Arrondi | +nombre | +Par défaut : 3 | +Arrondi de la valeur approchée. | +
|
+ Style d'affichage | +Enumeration | +
+
|
+ Style de la barre verticale du curseur. | +
|
+ Position de la valeur de la cible | +Enumeration | +
+
|
+ Position de la valeur de la cible sur le curseur x. Si vous utilisez "À coté de la cible", elle se trouvera à l'intersection entre la cible et la barre verticale du curseur, tandis que "Avec l'étiquette" la place juste en dessous du nom et de la position du curseur. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
| + | Afficher les points | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Les suites sont affichées en utilisant des points à chaque entier des points où la suite est définie. En décochant cette case, les points sont cachés.. | +
| + | Afficher les pointillées | +Booléen | +Vrai de faux + Par défaut : vrai |
+ Les suites sont affichées en pointillés entre les points où la suite est définie. En décochant cette option, les lignes en pointillés sont masquées.. | +
| + | Expression | +Dictionnaire (longueur fixe à 1, la clé est un nombre, la valeur une expression) | +var[n+k] = expression + Par défaut : var=u, k=1, expression=n u[n+1] = n |
+ Remarque : L'expression est définie par la variable n. Vous pouvez utiliser la syntaxe array pour accéder aux valeurs précédentes. Par exemple, pour la variable u, vous pouvez définir u[n+1] en fonction de u[n] ou u[n+2] en fonction de u[n] et u[n+1] pour une définition récursive. | +
| + | Valeurs d'initialisation | +Dictionnaire (la clé est un nombre, la valeur une expression) | +var[k] = expr + Par défaut : var=u, k=0, expr=1 u[0] = 1 |
+ Remarque : Vous avez besoin d'autant de valeurs d'initialisation (qui peuvent être ajoutées à l'aide du bouton "Ajouter une entrée" et supprimées à l'aide des boutons "poubelle") que k. | +
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la suite basée sur la position spécifiée de l'axe x (entier) et de l'axe y correspondant de la suite. | +
| Icône | +Propriété | +Type | +Valeur | +Commentaire | +
|---|---|---|---|---|
|
+ Position de l'étiquette | +Enumeration | +
+
|
+ Position de l'étiquette par rapport à la position. | +
|
+ Position en X de l'étiquette | +nombre | +Par défaut : 1 | +Position de base pour l'étiquette de la distribution en fonction de la position spécifiée de l'axe x et de son axe y correspondant de la distribution. | +
| + | Liste de probabilités | +Dictionnaire (la clé est un nombre, la valeur un nombre) | +P(var=k) = valeur + Default: var=X, k=0, expr=1 P(X=0) = 0 |
+ Note : Vous avez besoin d'autant de probabilités que nécessaire (qui peuvent être ajoutées grâce au bouton "Ajouter une entrée" et supprimées avec les boutons poubelle) que k. Le graphique affiché sera la fonction de distribution. | +