MultiPointsResetExt

Description

The MutliPointsResetExt extension is used to apply a settable function to the value of a point to calculate the output value. The extension has an interactive view to easily define the curve profile to apply. It is generally used for water laws.

Implementation

• Drag and drop the extension into a numeric point.

• On the view:

  • Click once to create a point. If a point already exists on the same X coordinate, the new point will not be created.

  • Double-click on an existing point to delete it.

  • To move a point, click and hold on the point and move it to the workspace. A point cannot be placed more to the left than the point that precedes it, and no more to the right than the point that follows it on the X axis.

  • Save the view so that the points are saved in the station.

  • A crosshairs appears with the value of the calculated output in real time.

The points define the function applied to calculate the output. A linear interpolation between the two nearest points on the x-axis is performed.

Properties

Extension Properties

• Status: Indicates the status of the extension ("ok" or "fault")

• FaultCause: Indicates the nature of the fault when the extension is in the "fault" state. This can happen in the following cases:

  • If XMin is greater than XMax.

  • If YMin is greater than YMax.

  • If a point has an X coordinate greater than XMax or less than XMin.

  • If a point has a Y coordinate greater than YMax or less than YMin.

  • If two or more points have the same value on the x-axis. There can be only one point for a given x.

  • ProfileTitle: The title of the curve profile can be modified by the user.

  • LivePointTitle: The title of the point is updated in real time.

  • DefaultProfileTitle: The title of the default curve profile

  • XTitle: The title of the X axis.

  • YTitle: The title of the Y axis.

  • XMin: The minimum value allowed on the X axis.

  • XMax: The maximum value allowed on the X axis.

  • YMin: The minimum value allowed on the Y axis.

  • YMax: The maximum value allowed on the Y axis.

  • XFacets: The unit of the X axis (added automatically to the XTitle)

  • YFacets: The unit of the Y axis (added automatically to the YTitle)

  • DefaultProfile: A component used to create a default curve profile, visible but not editable from the view, on which it is possible to re-initialize the curve modified by the user. To add points, right-click on the component and launch the setPointCount() action that works in the same way as the extension.

Advanced configuration properties

• AllowPointCreation: Enables or disables the creation and deletion of points from the view.

• AllowXTranslation: Enables or disables the movement of X-axis points from the view.

Actions

Extension actions

• setPointCount: Creates as many points as the number entered in the input field that appears when the action is launched. Note that if the extension already has a point, entering 2 in the input field will only create 1. And entering 0 will remove all existing points in the extension. By default, all the points created by this action will have coordinates of (0;0), the extension will generate an error, and the points will have to be modified.

• ResetToDefaultProfile: Resets the curve profile of the extension to the default profile.

DefaultProfile action

• setPointCount: Action identical to the parent component.

Specific case:

Tablet and phone:

On tablet and phone, point removal is a bit more difficult. There is a button "Delete mode enabled" to facilitate this task. When the mode is activated, just touch a point to delete it. By default this mode is "false" and changes to "true" by pressing the button.