diff --git a/content/logarithmplotter.fr.md b/content/logarithmplotter.fr.md index b6adabb..971dcfc 100644 --- a/content/logarithmplotter.fr.md +++ b/content/logarithmplotter.fr.md @@ -102,7 +102,7 @@ Download: Links: win: - Title: Logiciel d'installation (.exe) (64 bits) - Name: logarithmplotter-v-setup.exe (101,2Mio) + Name: logarithmplotter-v-setup.exe (100,9Mio) File: logarithmplotter-v-setup.exe macos: - Title: Archive d'Application (.dmg) @@ -116,11 +116,11 @@ Download: - Title: Launchpad (PPA) Index: logarithmplotter - Title: Debian / Ubuntu - Name: paquet debian (103,7Kio) + Name: python3-logarithmplotter_-1_all.deb (103,7Kio) File: python3-logarithmplotter_-1_all.deb all: - Title: Code source (.tar.gz) - Name: LogarithmPlotter-v.tar.gz (4,7Mio) + Name: logarithmPlotter-.tar.gz (187Kio) File: logarithmplotter-.tar.gz Footnote: | *LogarithmPlotter dépend [Python3](https://python.org/) avec [PySide2](https://pypi.org/project/PySide2/), et requiert qu'ils soient installés pour être lancé. diff --git a/content/logarithmplotter.md b/content/logarithmplotter.md index de0be20..9bc6245 100644 --- a/content/logarithmplotter.md +++ b/content/logarithmplotter.md @@ -105,7 +105,7 @@ Download: Links: win: - Title: Installer software (.exe) (64 bits) - Name: logarithmplotter-v-setup.exe (101.2MiB) + Name: logarithmplotter-v-setup.exe (100.9MiB) File: logarithmplotter-v-setup.exe macos: - Title: Application Archive (.dmg) @@ -119,13 +119,15 @@ Download: - Title: Launchpad (PPA) Index: logarithmplotter - Title: Debian / Ubuntu - Name: debian package (103.7KiB) + Name: python3-logarithmplotter_-1_all.deb (103.7KiB) File: python3-logarithmplotter_-1_all.deb all: - - Title: Source code (.tar.gz) - Name: LogarithmPlotter-v.tar.gz (4.7MiB) + - Title: Source code (.tar.gz)* + Name: LogarithmPlotter-v.tar.gz (187KiB) File: logarithmplotter-.tar.gz - Footnote: "*LogarithmPlotter requires [Python3](https://python.org/) with [PySide2](https://pypi.org/project/PySide2/) to be installed in order to be launched." + Footnote: | + LaTeX integration requires a valid TeX installation (from a distribution like [TeXLive](https://tug.org/texlive/)) with `latexmk`, `dvipng` and `fundus-calligra`. + *LogarithmPlotter requires [Python3](https://python.org/) with [PySide2](https://pypi.org/project/PySide2/) to be installed in order to be launched. --- diff --git a/data/metadata.json b/data/metadata.json index 5b24835..3181961 100644 --- a/data/metadata.json +++ b/data/metadata.json @@ -13,7 +13,7 @@ }, "logarithmplotter": { "name": "LogarithmPlotter", - "version": "0.1.8", + "version": "0.2.0", "languages": ["QML", "JavaScript", "Python"], "translated": ["en","fr","de","no","hu"], "platforms": ["Windows", "MacOSX", "Linux"], diff --git a/static/manuals/logarithmplotter/en/User-Manual.html b/static/manuals/logarithmplotter/en/User-Manual.html deleted file mode 100644 index c5bd017..0000000 --- a/static/manuals/logarithmplotter/en/User-Manual.html +++ /dev/null @@ -1,1199 +0,0 @@ - - - - User-Manual - - - -

User manual

-

Welcome to LogarithmPlotter's user manual. Here, we'll cover most features of LogarithmPlotter and how to use them.

-

Online version

-

-

Introduction: How LogarithmPlotter works

-

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:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconTypeWorks well in logarithmic scaleWorks well in non logarithmic scaleAllows pointer positioningComment
point symbolPoints✓✓✓
text symbolTexts✓✓✓Used as additional labels if necessary
function symbolFunctions✓✓X
bode magnitude symbolBode Magnitudes✓XX
bode phase symbolBode Phases✓X
x cursor symbolX Cursors✓✓✓Cursors on the x-axis
sequence symbolSequencesX✓XThere 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.
distribution symbolDistributions✓✓X
-

LogarithmPlotter will also create it's own objects automaticly when needed (for example, the sums of the bode gains and phases).

-

-

The Interface

-

First start

-

Image of the first start screen of LogarithmPlotter

-

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.

-
    -
  • "Check for updates on startup" does exactly what it sounds like. If enabled, LogarithmPlotter will check if a new version has been released everytime it starts up.
    • -
  • "Reset redo start when a new action is added to history": if disabled, if you go to a previous section of the history and make a change, the more recent changes in the redo section won't be overwritten.
    • -
-

Note that all of those settings can be changed at any moment from the "Settings" menu at the top of the window.

-

Overview of the main interface

-

Image of the main interface of LogarithmPlotter
-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.

-

Objects tab

-

Image of the objects tab in an example graph

-

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:

-
    -
  • Show or hide the object, by clicking the □ checkbox at the beginning.
    • -
  • (On objects that can be repositionned) Reposition the object by clicking on the position button.
    • -
  • Delete the object using the trash button.
    • -
  • Change the color of the object by clicking on the colored circle at the end of the line.
    • -
-

Settings tab

-

Image of the settings tab

-

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:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconNameDefault valueDefinition
X Zoom iconX Zoom100 - The zoom alongside the x-axis. -
    -
  • For non logarithmic scales, the number of pixels for a unit of 1.
    • -
  • For logarithmic scales, represent one decade divided by 2.3.
    • -
-
Y Zoom iconY Zoom10 - The zoom alongside the ordinate, equivalent to the number of pixels for a unit of 1. -
Minimum X iconMin X0.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. -
Maximum Y iconMax Y25 - Maximum value to be drawn on the y-axis. In other words, it's the value of y at the bottom of the graph. -
Maximum X iconMax XVariable - 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. -
    -
  • This value is dynamic depending on the width of the LogarithmPlotter window as well as the x zoom you've chosen.
    • -
  • Setting this value will change the value of the x zoom to fit exactly to the specified dimensions.
    • -
-
Minimum Y iconMin YVariable - Minimum value to be drawn on the y-axis. In other words, it's the value of y at the top of the graph. -
    -
  • This value is dynamic depending on the height of the LogarithmPlotter window as well as the y zoom you've chosen.
    • -
  • Setting this value will change the value of the y zoom to fit exactly to the specified dimensions.
    • -
-
X Axis Step iconX Axis Step4 - Step of the graduation for the x-axis. -
    -
  • Only for non logarithmic scale.
    • -
  • This value is an expression, you can use pi or e in it.
    • -
-
Y Axis Step iconY Axis Step4 - Step of the graduation for the y-axis. -
    -
  • This value is an expression, you can use pi or e in it.
    • -
-
Line width iconLine width1 - Width (percentage) of the the lines and circles of objects shown on the graph. -
    -
  • For lines, it's directly the width of the line.
    • -
  • For circles, the diameters are 8 + 2 × line width.
    • -
-
Text size iconText size (px)14 - Size in pixel of the text shown on the graph. -
X Label iconX LabelEmpty - Label to be used on the x-axis. -
    -
  • Example: "x", "ω (rad/s)"...
    • -
  • Editable, you can put any value you want, while maintaining an history of the previously used labels.
    • -
  • Note: this history is not saved with the file.
    • -
-
Y Label iconY LabelEmpty - Label to be used on the y-axis. -
    -
  • Example: "y", "Magnitude (dB)", "φ (°)", "φ (rad)", "φ (deg)"...
    • -
  • Editable, you can put any value you want, while maintaining an history of the previously used labels.
    • -
  • Note: this history is not saved with the file.
    • -
-
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:

-
    -
  • Copy to clipboard: -
      -
    • Copies an image of the graph to the clipboard.
      • -
    -
    • -
  • Save plot: -
      -
    • Saves the plot in the currently opened file, or prompts you to pick a location if non are open...
      • -
    -
    • -
  • Save plot as: -
      -
    • Prompts you to choose a location to save the plot at, and saves it.
      • -
    -
    • -
  • Load plot/Open plot: -
      -
    • Prompts you to choose an existing LogarithmPlotter diagram file and opens it in the current window.
      • -
    • IMPORTANT: All unsaved changes to the previous diagram WILL BE LOST if you open a new one.
      • -
    -
    • -
-

-

History tab

-

Image of the history tab

-

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:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SymbolTypeOccuranceColor (Light|Dark theme)
plus signObject creationWhen a new object is createdlime/green
cross signObject deletionWhen an existing object is deletionsalmon/dark red
Eye signShow/hide objectWhen an object's is shown or hiddenwhitesmoke|darkgray, light gray/dim gray
Double arrow signModify objectWhen an object's property is changedcyan/dark slate blue
Label signRename objectWhen an object's name is changedorange/dark orange
Appearance signColoring the objectWhen an object's color is changedplum/purple
-

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.

-

-

Editing object properties

-

Introduction

-

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.

-

-

Image of 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.

-

Type of properties

-

There exists a lot of properties, but each of them are separated in different kinds.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
TypeEditorExample(s)Comment
StringsInline text inputObject nameAt 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 inputLabel positionAll inputs other than digits, one optional minus at the start and a dot in the middle are forbidden.
ExpressionsInline text inputPoint position, function expressionLike 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 inputFunction domain and rangeUse 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)CheckboxShow graduation on ω0 for Bode Magnitude
Enumerations (set of predefined values)Combo boxLabel position and content, point style, bode pass
Other objectsCombo boxBode'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 inputsUnused at the momentSometimes 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 textSequence expression and default values, distribution default valuesSometimes 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.

-

Object properties

-

The following section is a reference for all object properties. It's currently up to date with LogarithmPlotter v0.1.8.

-

Reference:

- -

For all objects

- - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
label iconNamestringIt must not be the same for two objects.This value represents the object.
label iconLabel contentEnumeration -
    -
  • null: No label
    • -
  • name: Name of the object
    • -
  • name + value: Name of the object and it's value (generally in "name = value")
    • -
- 		It's generally used with a positioning property (Label position or Label's X position).
-

-

Icon Points

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Position iconXExpressionDefault: 1Position of the point on the x-axis.
Position iconYExpressionDefault: 0Position of the point on the y-axis.
All direction iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the point.
Appearance iconPoint styleEnumeration -
    -
  • ●
    • -
  • ✕
    • -
  • ＋
    • -
- Default: ● - 		Visual style of the point representation.
-

-

Icon Texts

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Position iconXExpressionDefault: 1Position of the text on the x-axis.
Position iconYExpressionDefault: 0Position of the text on the y-axis.
All direction iconLabel positionEnumeration -
    -
  • >|< Center
    • -
  • ↑ Top
    • -
  • ↓ Bottom
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Top left
    • -
  • ↗ Top right
    • -
  • ↙ Bottom left
    • -
  • ↘ Bottom right
    • -
- Default: >|< Center - 		Position of the label relative to the position.
Label iconContentstringDefault: New textContent of the text item.
-

-

Icon Functions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Expression iconExpressionExpressionDefault: xExpression of the function (depending on variable x).
Domain iconDomainDomainDefault: ℝ⁺*Domain (definition range) of the function.
Range iconRangeDomainDefault: ℝRange (destination range) of the function.
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the position.
Appearance iconDisplay modeEnumeration -
    -
  • - Application:
    - - - - - - - - - - - - - -
    name:domain↦range
    x→expression
    -
    • -
  • - Function:
    - name(x) = expression -
    • -
- Default: Application - 		Display style of the function's label.
Position iconLabel's X positionnumberDefault: 1Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis of the function.
Show pointsbooleanTrue 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 linesbooleanTrue 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 Bode Magnitude

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Angle iconω0PointBy 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.
Bode pass iconPassEnumeration -
    -
  • High
    • -
  • Low
    • -
- Default: High - 		Type of bode magnitude pass used for this this object.
Gain iconGainExpression - Default: 20 - Amount of decibels per decade used for the bode gain (should be positive for high pass, and negative for low pass).
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↓ Below - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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 ω0booleanTrue or false
- Default: false		When ticked, will show a vertical dashed line on top of the assigned ω0.
-

-

Icon Bode Magnitudes Sum

- - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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 Bode Phases

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Angle iconω0PointBy 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.
Angle iconPhaseExpression - Default: 90 - Amount of phase (defined in the unit below) used for the bode phase.
Angle iconUnit to useEnumeration -
    -
  • °
    • -
  • deg
    • -
  • rad
    • -
- Default: ° - 		Unit of the phase to be used (used for display).
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↓ Below - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis on the function.
-

-

Icon Bode Phases Sum

- - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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 X Cursors

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Position iconXExpressionDefault: 1Position of the cursor on the x-axis.
Target iconObject to targetExecutable 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. -
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ← Left - 		Position of the label relative to the position.
Show approximate valuebooleanTrue 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 iconRoundingnumberDefault: 3Rounding of the approximate value.
Arrows iconDisplay styleEnumeration -
    -
  •               
    • -
  •               
    • -
  • • • •
    • -
- Default:                - 		Style of the vertical bar of the cursor.
Position iconTarget's value positionEnumeration -
    -
  • Next to target
    • -
  • With label
    • -
  • Hidden
    • -
- Default: Next to target - 		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 Sequences

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Show pointsbooleanTrue 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 linesbooleanTrue 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 expressionDictionary (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 valuesDictionary (key is a number, value an expressionvar[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.
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ← Left - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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 Distributions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ← Left - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base position for the label of the distribution based on the specified x-axis position and it's corresponding y-axis of the distribution.
Probabilities listDictionary (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.
-

-

Positioning objects

-

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 Position icon button that can be seen on certain object rows.

-

List of supported objects:

-
    -
  • Points
    • -
  • Texts
    • -
  • X Cursors¹
    • -
-

Pointer interface screenshot

-

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.

-

Settings

-

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 deleted file mode 100644 index 3533c8c..0000000 --- a/static/manuals/logarithmplotter/en/User-Manual.md +++ /dev/null @@ -1,1259 +0,0 @@ -# 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: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconTypeWorks well in logarithmic scaleWorks well in non logarithmic scaleAllows pointer positioningComment
point symbolPoints✓✓✓
text symbolTexts✓✓✓Used as additional labels if necessary
function symbolFunctions✓✓X
bode magnitude symbolBode Magnitudes✓XX
bode phase symbolBode Phases✓X
x cursor symbolX Cursors✓✓✓Cursors on the x-axis
sequence symbolSequencesX✓XThere 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.
distribution symbolDistributions✓✓X
- -LogarithmPlotter will also create it's own objects automaticly when needed (for example, the sums of the bode gains and phases). - - -## The Interface -### First start -![Image of the first start screen of LogarithmPlotter](https://apps.ad5001.eu/img/en/logarithmplotter/welcome.png) - -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. - -- "Check for updates on startup" does exactly what it sounds like. If enabled, LogarithmPlotter will check if a new version has been released everytime it starts up. -- "Reset redo start when a new action is added to history": if disabled, if you go to a previous section of the [history](#history-tab) and make a change, the more recent changes in the redo section won't be overwritten. - -Note that all of those settings can be changed at any moment from the "Settings" menu at the top of the window. - - -### Overview of the main interface -![Image of the main interface of LogarithmPlotter](https://apps.ad5001.eu/img/en/logarithmplotter/empty.png) -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. - -### Objects tab -![Image of the objects tab in an example graph](https://apps.ad5001.eu/img/en/logarithmplotter/objects.webp) - -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](#User-Manual%3A-Chapter-2) 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: -- Show or hide the object, by clicking the □ checkbox at the beginning. -- (On objects that can be repositionned) Reposition the object by clicking on the ![position](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/common/position.svg) button. -- Delete the object using the ![trash](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/common/delete.svg) button. -- Change the color of the object by clicking on the colored circle at the end of the line. - -### Settings tab -![Image of the settings tab](https://apps.ad5001.eu/img/en/logarithmplotter/settings.webp) - -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: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconNameDefault valueDefinition
X Zoom iconX Zoom100 - The zoom alongside the x-axis. -
    -
  • For non logarithmic scales, the number of pixels for a unit of 1.
    • -
  • For logarithmic scales, represent one decade divided by 2.3.
    • -
-
Y Zoom iconY Zoom10 - The zoom alongside the ordinate, equivalent to the number of pixels for a unit of 1. -
Minimum X iconMin X0.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. -
Maximum Y iconMax Y25 - Maximum value to be drawn on the y-axis. In other words, it's the value of y at the bottom of the graph. -
Maximum X iconMax XVariable - 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. -
    -
  • This value is dynamic depending on the width of the LogarithmPlotter window as well as the x zoom you've chosen.
    • -
  • Setting this value will change the value of the x zoom to fit exactly to the specified dimensions.
    • -
-
Minimum Y iconMin YVariable - Minimum value to be drawn on the y-axis. In other words, it's the value of y at the top of the graph. -
    -
  • This value is dynamic depending on the height of the LogarithmPlotter window as well as the y zoom you've chosen.
    • -
  • Setting this value will change the value of the y zoom to fit exactly to the specified dimensions.
    • -
-
X Axis Step iconX Axis Step4 - Step of the graduation for the x-axis. -
    -
  • Only for non logarithmic scale.
    • -
  • This value is an expression, you can use pi or e in it.
    • -
-
Y Axis Step iconY Axis Step4 - Step of the graduation for the y-axis. -
    -
  • This value is an expression, you can use pi or e in it.
    • -
-
Line width iconLine width1 - Width (percentage) of the the lines and circles of objects shown on the graph. -
    -
  • For lines, it's directly the width of the line.
    • -
  • For circles, the diameters are 8 + 2 × line width.
    • -
-
Text size iconText size (px)14 - Size in pixel of the text shown on the graph. -
X Label iconX LabelEmpty - Label to be used on the x-axis. -
    -
  • Example: "x", "ω (rad/s)"...
    • -
  • Editable, you can put any value you want, while maintaining an history of the previously used labels.
    • -
  • Note: this history is not saved with the file.
    • -
-
Y Label iconY LabelEmpty - Label to be used on the y-axis. -
    -
  • Example: "y", "Magnitude (dB)", "φ (°)", "φ (rad)", "φ (deg)"...
    • -
  • Editable, you can put any value you want, while maintaining an history of the previously used labels.
    • -
  • Note: this history is not saved with the file.
    • -
-
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: -- Copy to clipboard: - - Copies an image of the graph to the clipboard. -- Save plot: - - Saves the plot in the currently opened file, or prompts you to pick a location if non are open... -- Save plot as: - - Prompts you to choose a location to save the plot at, and saves it. -- Load plot/Open plot: - - Prompts you to choose an existing LogarithmPlotter diagram file and opens it in the current window. - - **IMPORTANT**: All unsaved changes to the previous diagram WILL BE LOST if you open a new one. - - - - -### History tab -![Image of the history tab](https://apps.ad5001.eu/img/en/logarithmplotter/history.webp) - -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: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SymbolTypeOccuranceColor (Light|Dark theme)
plus signObject creationWhen a new object is createdlime/green
cross signObject deletionWhen an existing object is deletionsalmon/dark red
Eye signShow/hide objectWhen an object's is shown or hiddenwhitesmoke|darkgray, light gray/dim gray
Double arrow signModify objectWhen an object's property is changedcyan/dark slate blue
Label signRename objectWhen an object's name is changedorange/dark orange
Appearance signColoring the objectWhen an object's color is changedplum/purple
- -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. - - - -## Editing object properties -### Introduction -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. - -

- -![Image of the Object Property Editor dialog](https://apps.ad5001.eu/img/en/logarithmplotter/object-settings.webp) - -*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. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
TypeEditorExample(s)Comment
StringsInline text inputObject nameAt 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 inputLabel positionAll inputs other than digits, one optional minus at the start and a dot in the middle are forbidden.
ExpressionsInline text inputPoint position, function expressionLike 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 inputFunction domain and rangeUse 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)CheckboxShow graduation on ω0 for Bode Magnitude
Enumerations (set of predefined values)Combo boxLabel position and content, point style, bode pass
Other objectsCombo boxBode'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 inputsUnused at the momentSometimes 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 textSequence expression and default values, distribution default valuesSometimes 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. - -### Object properties -The following section is a reference for all object properties. It's currently up to date with LogarithmPlotter v0.1.8. - -Reference: - -- [All objects](#for-all-objects) -- [Points](#points) -- [Texts](#texts) -- [Functions](#functions) -- [Bode magnitudes](#bode-magnitudes) -- [Bode magnitudes sum](#bode-magnitudes-sum) -- [Bode phases](#bode-phases) -- [Bode phases sum](#bode-phases-sum) -- [X Cursors](#x-cursors) -- [Sequences](#sequences) -- [Distributions](#distributions) - -#### For all objects - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
label iconNamestringIt must not be the same for two objects.This value represents the object.
label iconLabel contentEnumeration -
    -
  • null: No label
    • -
  • name: Name of the object
    • -
  • name + value: Name of the object and it's value (generally in "name = value")
    • -
- 		It's generally used with a positioning property (Label position or Label's X position).
- - - - -#### ![Icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Point.svg) Points - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Position iconXExpressionDefault: 1Position of the point on the x-axis.
Position iconYExpressionDefault: 0Position of the point on the y-axis.
All direction iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the point.
Appearance iconPoint styleEnumeration -
    -
  • ●
    • -
  • ✕
    • -
  • ＋
    • -
- Default: ● - 		Visual style of the point representation.
- - - - -#### ![Icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Text.svg) Texts - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Position iconXExpressionDefault: 1Position of the text on the x-axis.
Position iconYExpressionDefault: 0Position of the text on the y-axis.
All direction iconLabel positionEnumeration -
    -
  • >|< Center
    • -
  • ↑ Top
    • -
  • ↓ Bottom
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Top left
    • -
  • ↗ Top right
    • -
  • ↙ Bottom left
    • -
  • ↘ Bottom right
    • -
- Default: >|< Center - 		Position of the label relative to the position.
Label iconContentstringDefault: New textContent of the text item.
- - - -#### ![Icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Function.svg) Functions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Expression iconExpressionExpressionDefault: xExpression of the function (depending on variable x).
Domain iconDomainDomainDefault: ℝ⁺*Domain (definition range) of the function.
Range iconRangeDomainDefault: ℝRange (destination range) of the function.
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the position.
Appearance iconDisplay modeEnumeration -
    -
  • - Application:
    - - - - - - - - - - - - - -
    name:domain↦range
    x→expression
    -
    • -
  • - Function:
    - name(x) = expression -
    • -
- Default: Application - 		Display style of the function's label.
Position iconLabel's X positionnumberDefault: 1Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis of the function.
Show pointsbooleanTrue 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 linesbooleanTrue 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Gain%20Bode.svg) Bode Magnitude - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Angle iconω0PointBy 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.
Bode pass iconPassEnumeration -
    -
  • High
    • -
  • Low
    • -
- Default: High - 		Type of bode magnitude pass used for this this object.
Gain iconGainExpression - Default: 20 - Amount of decibels per decade used for the bode gain (should be positive for high pass, and negative for low pass).
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↓ Below - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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 ω0booleanTrue or false
- Default: false		When ticked, will show a vertical dashed line on top of the assigned ω0.
- - -#### ![Icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Somme%20gains%20Bode.svg) Bode Magnitudes Sum - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Phase%20Bode.svg) Bode Phases - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Angle iconω0PointBy 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.
Angle iconPhaseExpression - Default: 90 - Amount of phase (defined in the unit below) used for the bode phase.
Angle iconUnit to useEnumeration -
    -
  • °
    • -
  • deg
    • -
  • rad
    • -
- Default: ° - 		Unit of the phase to be used (used for display).
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↓ Below - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base position for the label of the function based on the specified x-axis position and it's corresponding y-axis on the function.
- - - -#### ![Icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Somme%20phases%20Bode.svg) Bode Phases Sum - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ↑ Above - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/X%20Cursor.svg) X Cursors - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Position iconXExpressionDefault: 1Position of the cursor on the x-axis.
Target iconObject to targetExecutable 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. -
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ← Left - 		Position of the label relative to the position.
Show approximate valuebooleanTrue 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 iconRoundingnumberDefault: 3Rounding of the approximate value.
Arrows iconDisplay styleEnumeration -
    -
  •               
    • -
  •               
    • -
  • • • •
    • -
- Default:                - 		Style of the vertical bar of the cursor.
Position iconTarget's value positionEnumeration -
    -
  • Next to target
    • -
  • With label
    • -
  • Hidden
    • -
- Default: Next to target - 		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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Sequence.svg) Sequences - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Show pointsbooleanTrue 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 linesbooleanTrue 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 expressionDictionary (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 valuesDictionary (key is a number, value an expressionvar[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.
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ← Left - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Repartition.svg) Distributions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconPropertyTypeValueComment
Arrows iconLabel positionEnumeration -
    -
  • ↑ Above
    • -
  • ↓ Below
    • -
  • ← Left
    • -
  • → Right
    • -
  • ↖ Above left
    • -
  • ↗ Above right
    • -
  • ↙ Below left
    • -
  • ↘ Below right
    • -
- Default: ← Left - 		Position of the label relative to the position.
Position iconLabel's X positionnumberDefault: 1Base position for the label of the distribution based on the specified x-axis position and it's corresponding y-axis of the distribution.
Probabilities listDictionary (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.
- - - -## Positioning objects -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 ![Position icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/common/position.svg) button that can be seen on certain object rows. - -List of supported objects: - -- Points -- Texts -- X Cursors¹ - -![Pointer interface screenshot](https://apps.ad5001.eu/img/en/logarithmplotter/pointer.png) - -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. - -### Settings -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.pdf b/static/manuals/logarithmplotter/en/User-Manual.pdf deleted file mode 100644 index 5e55ad6..0000000 Binary files a/static/manuals/logarithmplotter/en/User-Manual.pdf and /dev/null differ diff --git a/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.html b/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.html deleted file mode 100644 index ede418d..0000000 --- a/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.html +++ /dev/null @@ -1,1200 +0,0 @@ - - - - Manuel-d'utilisation - - - -

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

-

-

Introduction : Comment fonctionne LogarithmPlotter

-

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 :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SymboleTypeFonctionne bien dans l'échelle logarithmiqueFonctionne bien dans l'échelle non logarithmiqueAutorise le positionnement du pointeurCommentaire
symbole de pointPoints✓✓✓
symbole de texteTextes✓✓✓Utilisés comme textes supplémentaires si nécessaire
symbole de fonctionFonctions✓✓X
symbole de gain de bodeGains de Bode✓XX
symbole de phase bodePhases de Bode✓XX
symbole du curseur xCurseurs X✓✓✓Curseurs sur l'axe des abscisses
symbole de suitesSuitesX✓XIl 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.
symbole de répartition(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).

-

-

L'interface

-

Premier démarrage

-

Image du premier écran de démarrage de LogarithmPlotter

-

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.

-
    -
  • L'option "Vérifier les mises à jour au démarage" fait exactement ce qu'elle dit faire. Si cette option est activée, LogarithmPlotter vérifiera si une nouvelle version a été publiée à chaque fois qu'il démarre.
    • -
  • "Réinitialiser la pile d'action "Rétablir" lorsqu'une nouvelle action est ajoutée à l'historique" : si cette option est désactivée, si vous vous rendez dans une section précédente de l'historique et effectuez une modification, les modifications plus récentes dans la section rétablir ne seront pas écrasées.
    • -
-

Notez que tous ces paramètres peuvent être modifiés à tout moment à partir du menu "Paramètres" en haut de la fenêtre.

-

Aperçu de l'interface principale

-

Image de l'interface principale de LogarithmPlotter

-

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.

-

Onglet Objets

-

Image de l'onglet objets dans un exemple de graphique

-

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 :

-
    -
  • Afficher ou masquer l'objet, en cliquant sur la □ case à cocher au début.
    • -
  • (Sur les objets qui peuvent être repositionnés) Repositionner l'objet en cliquant sur le bouton position.
    • -
  • Supprimez l'objet en utilisant le bouton poubelle.
    • -
  • Changer la couleur de l'objet en cliquant sur le cercle coloré à la fin de la ligne.
    • -
-

Onglet Paramètres

-

Image de l'onglet paramètres
-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ôneNomValeur par défautDéfinition
Icône de zoom en xZoom en X100 - Le zoom le long de l'axe des x. -
    -
  • Pour les échelles non logarithmiques, le nombre de pixels pour une unité de 1.
    • -
  • Pour les échelles logarithmiques, représente une décade divisée par 2,3.
    • -
-
Icône du zoom en YZoom en Y10 - Le zoom le long de l'ordonnée, équivalent au nombre de pixels pour une unité de 1. -
icône X minimumMin X0,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. -
icône de l'Y maximalMax Y25 - Valeur maximale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en bas du graphique. -
Icône du maximum XMax XVariable - 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. -
    -
  • Cette valeur est dynamique et dépend de la largeur de la fenêtre du LogarithmPlotter ainsi que du zoom en x que vous avez choisi.
    • -
  • Modifier de cette valeur aura pour effet de changer la valeur du zoom en x afin de s'adapter exactement aux dimensions spécifiées.
    • -
-
Icône de l'Y minimalMin YVariable - Valeur minimale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en haut du graphique. -
    -
  • Cette valeur est dynamique et dépend de la hauteur de la fenêtre du LogarithmPlotter ainsi que du zoom en y que vous avez choisi.
    • -
  • Modifier cette valeur changera la valeur du zoom y pour s'adapter exactement aux dimensions spécifiées.
    • -
-
Icône du pas de l'axe XPas de l'axe X4 - Pas de la graduation pour l'axe des abscisses. -
    -
  • Uniquement pour l'échelle non logarithmique.
    • -
  • Cette valeur est une expression, vous pouvez utiliser pi ou e dans celle-ci.
    • -
-
Icône du pas de l'axe YPas de l'axe Y4 - Pas de la graduation pour l'axe des y. -
    -
  • Cette valeur est une expression, vous pouvez utiliser pi ou e dans celle-ci.
    • -
-
Icône de largeur de ligneTaille des lignes1 - Largeur (pourcentage) des lignes et des cercles d'objets représentés sur le graphique. -
    -
  • Pour les lignes, il s'agit directement de la largeur de la ligne.
    • -
  • Pour les cercles, les diamètres sont de 8 + 2 × la taille des lignes.
    • -
-
Icône de la taille du texteTaille du texte (px)14 - Taille en pixel du texte affiché sur le graphique. -
Icône de l'étiquette de l'axe XLabel de l'axe XVide - Étiquette à utiliser sur l'axe des abscisses. -
    -
  • Par exemple "x", "ω (rad/s)"...
    • -
  • Modifiable, vous pouvez mettre la valeur que vous voulez, tout en conservant un historique des étiquettes précédemment utilisées.
    • -
  • Note : cet historique n'est pas sauvegardé avec le fichier.
    • -
-
Icône étiquette de l'axe YLabel de l'axe YVide - Étiquette à utiliser sur l'axe des ordonnées. -
    -
  • Par exemple: "y", "Magnitude (dB)", "φ (°)", "φ (rad)", "φ (deg)"...
    • -
  • Modifiable, vous pouvez mettre la valeur que vous voulez, tout en conservant un historique des étiquettes précédemment utilisées.
    • -
  • Note : cet historique n'est pas sauvegardé avec le fichier.
    • -
-
É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 :

-
    -
  • Copier dans le presse-papiers : -
      -
    • Copie une image du graphique dans le presse-papiers.
      • -
    -
    • -
  • Sauvegarder le graphe : -
      -
    • Sauvegarde le graphe dans le fichier actuellement ouvert, ou vous invite à choisir un emplacement si aucun fichier n'est ouvert...
      • -
    -
    • -
  • Sauvegarder le graphe sous : -
      -
    • Vous invite à choisir un emplacement pour sauvegarder le graphe, et le sauvegarde.
      • -
    -
    • -
  • Charger un graphe/Ouvrir un graphe : -
      -
    • Vous invite à choisir un fichier de diagramme LogarithmPlotter existant et l'ouvre dans la fenêtre actuelle.
      • -
    • IMPORTANT : Toutes les modifications non sauvegardées du diagramme précédent SERONT PERDUES si vous en ouvrez un nouveau.
      • -
    -
    • -
-

-

Onglet Historique

-

Image de l'onglet historique

-

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 :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SymboleTypeCondition d'apparitionCouleur (Thème clair|Foncé)
signe plusCréation d'objetLorsqu'un nouvel objet est créécitron vert/vert
signe de croixSuppression d'objetLorsqu'un objet existant est supprimésaumon/rouge foncé
Signe oculaireMontrer/cacher l'objetQuand celui d'un objet est affiché ou cachéwhitesmoke|darkgray, gris clair/gris foncé
Signe double flècheModifier un objetLorsque la propriété d'un objet est modifiéecyan/bleu ardoise foncé
Label signRenommer un objetLorsque le nom d'un objet est modifiéorange/orange foncé
Signe d'apparenceColoration de l'objetLorsque la couleur d'un objet est modifiéeprune/pourpre
-

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.

-

-

Modifier les propriétés d'un objet

-

Introduction

-

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.

-

-

Image du dialogue Editeur 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.

-

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ÉditeurExemple(s)Commentaire
Chaînes de caractèresSaisie de texte en ligneNom 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 lignePosition de l'étiquetteToutes les entrées autres que les chiffres, un moins optionnel au début et un point au milieu sont interdites.
ExpressionsSaisie de texte en lignePosition de point, expression de fonctionComme 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 ligneDomaine et plage de fonctionsUtiliser 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 à cocherMontrer la graduation sur ω0 pour la magnitude de Bode
Énumérations (ensemble de valeurs prédéfinies)Sélection de choixPosition et contenu de l'étiquette, style de point, passage de bode
Autres objetsSélection de choixLes ω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 ligneNon utilisé pour le momentParfois 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 texteExpressions et valeurs par défaut de suite, valeurs par défaut de fonction de répartitionParfois 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.

-

Propriétés des objets

-

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 :

- -

Pour tous les objets

- - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
icône d'étiquetteNomChaîne de caractèresNe doit pas être le même pour deux objets.Cette valeur représente l'objet.
icône d'étiquetteContenu de l'étiquetteÉnumération -
    -
  • vide: Étiquette caché
    • -
  • nom: Nom de l'objet
    • -
  • nom + valeur: Nom de l'objet et sa valeur (généralement en "nom = valeur")
    • -
- 		Généralement utilisé avec une propriété de positionnement (position de l'étiquette ou position X de l'étiquette).
-

-

Icône Points

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône de positionXExpressionPar défaut : 1La position du point sur l'axe des abscisses.
Icône de positionYExpressionPar défaut : 0La position du point sur l'axe des ordonnées.
Icône de toutes les directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Default: ↑ Above - 		Position de l'étiquette par rapport au point.
Appearance iconStyle du pointEnumeration -
    -
  • ●
    • -
  • ✕
    • -
  • ＋
    • -
- Par défaut : ● - 		Style visuel de la représentation des points.
-

-

Icône Textes

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône de positionXExpressionPar défaut : 1Position du texte sur l'axe des abscisses.
Icône de positionYExpressionPar défaut : 0Position du texte sur l'axe des ordonnées.
Icône de toutes les directionsPosition de l'étiquetteEnumeration -
    -
  • >|< Centré
    • -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : >|< Centré - 		Position de l'étiquette par rapport à la position.
Icône d'étiquetteContenuChaînePar défaut : Nouveau texteContenu de l'élément de texte.
-

-

Icône Fonctions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône d'expressionExpressionExpressionPar défaut : xExpression de la fonction (en fonction de la variable x).
Icône du domaine de définitionDomaine de définitionDomainePar défaut : ℝ⁺*Domaine de définition de la fonction.
Icône de portéePortéeDomainePar défaut : ℝPortée de la fonction
Icône de toutes directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↑ Au dessus - 		Position de l'étiquette par rapport à la position.
Icône d'apparenceMode d'affichageEnumeration -
    -
  • - Application:
    - - - - - - - - - - - - - -
    nom:domaine↦portée
    x→expression
    -
    • -
  • - Fonction:
    - nom(x) = expression -
    • -
- Par défaut : Application - 		Style d'affichage de l'étiquette de la fonction.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 pointsBooléenVrai 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éesBooléenVrai 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 Gain de Bode

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Angle iconω0PointPar 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.
Icône du passe de BodePasseEnumeration -
    -
  • Haut
    • -
  • Bas
    • -
- Par défaut : Haut - 		Type de passe de gain de Bode utilisé pour cet objet.
Icône de gainGainExpression - 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).
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↓ En dessous - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 ω0BooléenVrai ou faux
- Par defaut: faux		Si coché, montrera une ligne verticale en pointillés sur le dessus du ω0 assigné.
-

-

Icône Somme des gains de Bode

- - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↑ Au dessus - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 Phases de Bode

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône d'angleω0PointPar 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.
Icône d'anglePhaseExpression - Par défaut : 90 - Montant de phase (défini dans l'unité ci-dessous) utilisé pour la phase du bode.
Angle iconUnité à utiliserEnumeration -
    -
  • °
    • -
  • deg
    • -
  • rad
    • -
- Par défaut : ° - 		Unité de la phase à utiliser (utilisée pour l'affichage).
Arrows iconPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↓ En dessous - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 Somme des phases de Bode

- - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Default: ↑ Au dessus - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 Curseurs X

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône de positionXExpressionPar défaut : 1Position du curseur sur l'axe des abscisses.
Icône cibleObjet à ciblerObjet 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. -
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Default: ← À gauche - 		Position de l'étiquette par rapport à sa position.
Afficher la valeur approximativeBooléenVrai 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.
Icône d'arrondiArrondinombrePar défaut : 3Arrondi de la valeur approchée.
Arrows iconStyle d'affichageEnumeration -
    -
  •               
    • -
  •               
    • -
  • • • •
    • -
- Par défaut :                - 		Style de la barre verticale du curseur.
Icône de positionPosition de la valeur de la cibleEnumeration -
    -
  • À coté de la cible
    • -
  • Avec l'étiquette
    • -
  • Caché
    • -
- Par défaut : À coté de la cible - 		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 Suites

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Afficher les pointsBooléenVrai 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éesBooléenVrai 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..
ExpressionDictionnaire (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'initialisationDictionnaire (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.
Arrows iconPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ← À gauche - 		Position de l'étiquette par rapport à la position.
Position iconPosition en X de l'étiquettenombrePar défaut : 1Position 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.
-

-

Icon Répartitions

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ← À gauche - 		Position de l'étiquette par rapport à la position.
Position iconPosition en X de l'étiquettenombrePar défaut : 1Position 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ésDictionnaire (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.
-

-

Positionnement des objets

-

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 Icône de positionnement que l'on peut voir sur certaines lignes d'objets.

-

Liste des objets supportés :

-
    -
  • Points
    • -
  • Textes
    • -
  • X Curseurs¹
    • -
-

Capture d'écran de l'interface du pointeur

-

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.

-

Paramètres

-

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 deleted file mode 100644 index bed2a44..0000000 --- a/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.md +++ /dev/null @@ -1,1257 +0,0 @@ -# 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 : - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SymboleTypeFonctionne bien dans l'échelle logarithmiqueFonctionne bien dans l'échelle non logarithmiqueAutorise le positionnement du pointeurCommentaire
symbole de pointPoints✓✓✓
symbole de texteTextes✓✓✓Utilisés comme textes supplémentaires si nécessaire
symbole de fonctionFonctions✓✓X
symbole de gain de bodeGains de Bode✓XX
symbole de phase bodePhases de Bode✓XX
symbole du curseur xCurseurs X✓✓✓Curseurs sur l'axe des abscisses
symbole de suitesSuitesX✓XIl 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.
symbole de répartition(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). - - -## L'interface -### Premier démarrage -![Image du premier écran de démarrage de LogarithmPlotter](https://apps.ad5001.eu/img/fr/logarithmplotter/welcome.png) - -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. - -- L'option "Vérifier les mises à jour au démarage" fait exactement ce qu'elle dit faire. Si cette option est activée, LogarithmPlotter vérifiera si une nouvelle version a été publiée à chaque fois qu'il démarre. -- "Réinitialiser la pile d'action "Rétablir" lorsqu'une nouvelle action est ajoutée à l'historique" : si cette option est désactivée, si vous vous rendez dans une section précédente de l'[historique](#onglet-historique) et effectuez une modification, les modifications plus récentes dans la section rétablir ne seront pas écrasées. - -Notez que tous ces paramètres peuvent être modifiés à tout moment à partir du menu "Paramètres" en haut de la fenêtre. - - -### Aperçu de l'interface principale -![Image de l'interface principale de LogarithmPlotter](https://apps.ad5001.eu/img/fr/logarithmplotter/empty.png) - -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. - -### Onglet Objets -![Image de l'onglet objets dans un exemple de graphique](https://apps.ad5001.eu/img/fr/logarithmplotter/objects.webp) - -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](#Manuel-d'utilisation-%3A-Chapitre-2) 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 : -- Afficher ou masquer l'objet, en cliquant sur la □ case à cocher au début. -- (Sur les objets qui peuvent être repositionnés) Repositionner l'objet en cliquant sur le bouton ![position](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/common/position.svg). -- Supprimez l'objet en utilisant le bouton ![poubelle](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/common/delete.svg). -- Changer la couleur de l'objet en cliquant sur le cercle coloré à la fin de la ligne. - -### Onglet Paramètres -![Image de l'onglet paramètres](https://apps.ad5001.eu/img/fr/logarithmplotter/settings.webp) -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ôneNomValeur par défautDéfinition
Icône de zoom en xZoom en X100 - Le zoom le long de l'axe des x. -
    -
  • Pour les échelles non logarithmiques, le nombre de pixels pour une unité de 1.
    • -
  • Pour les échelles logarithmiques, représente une décade divisée par 2,3.
    • -
-
Icône du zoom en YZoom en Y10 - Le zoom le long de l'ordonnée, équivalent au nombre de pixels pour une unité de 1. -
icône X minimumMin X0,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. -
icône de l'Y maximalMax Y25 - Valeur maximale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en bas du graphique. -
Icône du maximum XMax XVariable - 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. -
    -
  • Cette valeur est dynamique et dépend de la largeur de la fenêtre du LogarithmPlotter ainsi que du zoom en x que vous avez choisi.
    • -
  • Modifier de cette valeur aura pour effet de changer la valeur du zoom en x afin de s'adapter exactement aux dimensions spécifiées.
    • -
-
Icône de l'Y minimalMin YVariable - Valeur minimale à dessiner sur l'axe des ordonnées. En d'autres termes, c'est la valeur de y en haut du graphique. -
    -
  • Cette valeur est dynamique et dépend de la hauteur de la fenêtre du LogarithmPlotter ainsi que du zoom en y que vous avez choisi.
    • -
  • Modifier cette valeur changera la valeur du zoom y pour s'adapter exactement aux dimensions spécifiées.
    • -
-
Icône du pas de l'axe XPas de l'axe X4 - Pas de la graduation pour l'axe des abscisses. -
    -
  • Uniquement pour l'échelle non logarithmique.
    • -
  • Cette valeur est une expression, vous pouvez utiliser pi ou e dans celle-ci.
    • -
-
Icône du pas de l'axe YPas de l'axe Y4 - Pas de la graduation pour l'axe des y. -
    -
  • Cette valeur est une expression, vous pouvez utiliser pi ou e dans celle-ci.
    • -
-
Icône de largeur de ligneTaille des lignes1 - Largeur (pourcentage) des lignes et des cercles d'objets représentés sur le graphique. -
    -
  • Pour les lignes, il s'agit directement de la largeur de la ligne.
    • -
  • Pour les cercles, les diamètres sont de 8 + 2 × la taille des lignes.
    • -
-
Icône de la taille du texteTaille du texte (px)14 - Taille en pixel du texte affiché sur le graphique. -
Icône de l'étiquette de l'axe XLabel de l'axe XVide - Étiquette à utiliser sur l'axe des abscisses. -
    -
  • Par exemple "x", "ω (rad/s)"...
    • -
  • Modifiable, vous pouvez mettre la valeur que vous voulez, tout en conservant un historique des étiquettes précédemment utilisées.
    • -
  • Note : cet historique n'est pas sauvegardé avec le fichier.
    • -
-
Icône étiquette de l'axe YLabel de l'axe YVide - Étiquette à utiliser sur l'axe des ordonnées. -
    -
  • Par exemple: "y", "Magnitude (dB)", "φ (°)", "φ (rad)", "φ (deg)"...
    • -
  • Modifiable, vous pouvez mettre la valeur que vous voulez, tout en conservant un historique des étiquettes précédemment utilisées.
    • -
  • Note : cet historique n'est pas sauvegardé avec le fichier.
    • -
-
É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 : -- Copier dans le presse-papiers : - - Copie une image du graphique dans le presse-papiers. -- Sauvegarder le graphe : - - Sauvegarde le graphe dans le fichier actuellement ouvert, ou vous invite à choisir un emplacement si aucun fichier n'est ouvert... -- Sauvegarder le graphe sous : - - Vous invite à choisir un emplacement pour sauvegarder le graphe, et le sauvegarde. -- Charger un graphe/Ouvrir un graphe : - - Vous invite à choisir un fichier de diagramme LogarithmPlotter existant et l'ouvre dans la fenêtre actuelle. - - **IMPORTANT** : Toutes les modifications non sauvegardées du diagramme précédent SERONT PERDUES si vous en ouvrez un nouveau. - - -### Onglet Historique -![Image de l'onglet historique](https://apps.ad5001.eu/img/fr/logarithmplotter/history.webp) - -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 : - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SymboleTypeCondition d'apparitionCouleur (Thème clair|Foncé)
signe plusCréation d'objetLorsqu'un nouvel objet est créécitron vert/vert
signe de croixSuppression d'objetLorsqu'un objet existant est supprimésaumon/rouge foncé
Signe oculaireMontrer/cacher l'objetQuand celui d'un objet est affiché ou cachéwhitesmoke|darkgray, gris clair/gris foncé
Signe double flècheModifier un objetLorsque la propriété d'un objet est modifiéecyan/bleu ardoise foncé
Label signRenommer un objetLorsque le nom d'un objet est modifiéorange/orange foncé
Signe d'apparenceColoration de l'objetLorsque la couleur d'un objet est modifiéeprune/pourpre
- -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. - - -## Modifier les propriétés d'un objet -### Introduction -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. - -

- -![Image du dialogue Editeur de Propriétés d'Objet](https://apps.ad5001.eu/img/en/logarithmplotter/object-settings.webp) - -*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ÉditeurExemple(s)Commentaire
Chaînes de caractèresSaisie de texte en ligneNom 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 lignePosition de l'étiquetteToutes les entrées autres que les chiffres, un moins optionnel au début et un point au milieu sont interdites.
ExpressionsSaisie de texte en lignePosition de point, expression de fonctionComme 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 ligneDomaine et plage de fonctionsUtiliser 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 à cocherMontrer la graduation sur ω0 pour la magnitude de Bode
Énumérations (ensemble de valeurs prédéfinies)Sélection de choixPosition et contenu de l'étiquette, style de point, passage de bode
Autres objetsSélection de choixLes ω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 ligneNon utilisé pour le momentParfois 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 texteExpressions et valeurs par défaut de suite, valeurs par défaut de fonction de répartitionParfois 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. - -### Propriétés des objets -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 : - -- [Tous les objets](#pour-tous-les-objets) -- [Points](#points) -- [Textes](#textes) -- [Fonctions](#fonctions) -- [Gains de Bode](#bode-magnitudes) -- [Somme des gain de Bode](#somme-des-gains-de-bode) -- [Phases de Bode](#bode-phases) -- [Somme des phases de Bode](#somme-des-phases-de-bode) -- [Curseurs X](#curseurs-x) -- [Suites](#suites) -- [Répartitions](#repartitions) - -#### Pour tous les objets - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
icône d'étiquetteNomChaîne de caractèresNe doit pas être le même pour deux objets.Cette valeur représente l'objet.
icône d'étiquetteContenu de l'étiquetteÉnumération -
    -
  • vide: Étiquette caché
    • -
  • nom: Nom de l'objet
    • -
  • nom + valeur: Nom de l'objet et sa valeur (généralement en "nom = valeur")
    • -
- 		Généralement utilisé avec une propriété de positionnement (position de l'étiquette ou position X de l'étiquette).
- - - -#### ![Icône](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Point.svg) Points - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône de positionXExpressionPar défaut : 1La position du point sur l'axe des abscisses.
Icône de positionYExpressionPar défaut : 0La position du point sur l'axe des ordonnées.
Icône de toutes les directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Default: ↑ Above - 		Position de l'étiquette par rapport au point.
Appearance iconStyle du pointEnumeration -
    -
  • ●
    • -
  • ✕
    • -
  • ＋
    • -
- Par défaut : ● - 		Style visuel de la représentation des points.
- - - -#### ![Icône](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Text.svg) Textes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône de positionXExpressionPar défaut : 1Position du texte sur l'axe des abscisses.
Icône de positionYExpressionPar défaut : 0Position du texte sur l'axe des ordonnées.
Icône de toutes les directionsPosition de l'étiquetteEnumeration -
    -
  • >|< Centré
    • -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : >|< Centré - 		Position de l'étiquette par rapport à la position.
Icône d'étiquetteContenuChaînePar défaut : Nouveau texteContenu de l'élément de texte.
- - - -#### ![Icône](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Function.svg) Fonctions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône d'expressionExpressionExpressionPar défaut : xExpression de la fonction (en fonction de la variable x).
Icône du domaine de définitionDomaine de définitionDomainePar défaut : ℝ⁺*Domaine de définition de la fonction.
Icône de portéePortéeDomainePar défaut : ℝPortée de la fonction
Icône de toutes directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↑ Au dessus - 		Position de l'étiquette par rapport à la position.
Icône d'apparenceMode d'affichageEnumeration -
    -
  • - Application:
    - - - - - - - - - - - - - -
    nom:domaine↦portée
    x→expression
    -
    • -
  • - Fonction:
    - nom(x) = expression -
    • -
- Par défaut : Application - 		Style d'affichage de l'étiquette de la fonction.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 pointsBooléenVrai 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éesBooléenVrai 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Gain%20Bode.svg) Gain de Bode - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Angle iconω0PointPar 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.
Icône du passe de BodePasseEnumeration -
    -
  • Haut
    • -
  • Bas
    • -
- Par défaut : Haut - 		Type de passe de gain de Bode utilisé pour cet objet.
Icône de gainGainExpression - 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).
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↓ En dessous - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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 ω0BooléenVrai ou faux
- Par defaut: faux		Si coché, montrera une ligne verticale en pointillés sur le dessus du ω0 assigné.
- - - -#### ![Icône](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Somme%20gains%20Bode.svg) Somme des gains de Bode - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↑ Au dessus - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Phase%20Bode.svg) Phases de Bode - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône d'angleω0PointPar 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.
Icône d'anglePhaseExpression - Par défaut : 90 - Montant de phase (défini dans l'unité ci-dessous) utilisé pour la phase du bode.
Angle iconUnité à utiliserEnumeration -
    -
  • °
    • -
  • deg
    • -
  • rad
    • -
- Par défaut : ° - 		Unité de la phase à utiliser (utilisée pour l'affichage).
Arrows iconPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ↓ En dessous - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Somme%20phases%20Bode.svg) Somme des phases de Bode - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Default: ↑ Au dessus - 		Position de l'étiquette par rapport à la position.
Icône de positionPosition en X de l'étiquettenombrePar défaut : 1Position 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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/X%20Cursor.svg) Curseurs X - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône de positionXExpressionPar défaut : 1Position du curseur sur l'axe des abscisses.
Icône cibleObjet à ciblerObjet 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. -
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Default: ← À gauche - 		Position de l'étiquette par rapport à sa position.
Afficher la valeur approximativeBooléenVrai 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.
Icône d'arrondiArrondinombrePar défaut : 3Arrondi de la valeur approchée.
Arrows iconStyle d'affichageEnumeration -
    -
  •               
    • -
  •               
    • -
  • • • •
    • -
- Par défaut :                - 		Style de la barre verticale du curseur.
Icône de positionPosition de la valeur de la cibleEnumeration -
    -
  • À coté de la cible
    • -
  • Avec l'étiquette
    • -
  • Caché
    • -
- Par défaut : À coté de la cible - 		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](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Sequence.svg) Suites - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Afficher les pointsBooléenVrai 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éesBooléenVrai 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..
ExpressionDictionnaire (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'initialisationDictionnaire (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.
Arrows iconPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ← À gauche - 		Position de l'étiquette par rapport à la position.
Position iconPosition en X de l'étiquettenombrePar défaut : 1Position 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.
- - - -#### ![Icon](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/objects/Repartition.svg) Répartitions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IcônePropriétéTypeValeurCommentaire
Icône directionsPosition de l'étiquetteEnumeration -
    -
  • ↑ Au dessus
    • -
  • ↓ En dessous
    • -
  • ← À gauche
    • -
  • → À droite
    • -
  • ↖ Au dessus à gauche
    • -
  • ↗ Au dessus à droite
    • -
  • ↙ En dessous à gauche
    • -
  • ↘ En dessous à droite
    • -
- Par défaut : ← À gauche - 		Position de l'étiquette par rapport à la position.
Position iconPosition en X de l'étiquettenombrePar défaut : 1Position 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ésDictionnaire (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.
- - -## Positionnement des objets -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 ![Icône de positionnement](https://git.ad5001.eu/Ad5001/LogarithmPlotter/raw/branch/master/LogarithmPlotter/qml/eu/ad5001/LogarithmPlotter/icons/common/position.svg) que l'on peut voir sur certaines lignes d'objets. - -Liste des objets supportés : - -- Points -- Textes -- X Curseurs¹ - -![Capture d'écran de l'interface du pointeur](https://apps.ad5001.eu/img/fr/logarithmplotter/pointer.png) - -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. - -### Paramètres -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.pdf b/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.pdf deleted file mode 100644 index 61694ab..0000000 Binary files a/static/manuals/logarithmplotter/fr/Manuel-d'utilisation.pdf and /dev/null differ