Difference between revisions of "MC-Basic:pls.PLSPOSITION"

From SoftMC-Wiki
Jump to: navigation, search
m (Miborich moved page Axystems:MC-Basic:pls.PLSPOSITION to MC-Basic:pls.PLSPOSITION: Global renaming of Axystems: namespace into (Main):)
m
 
Line 10: Line 10:
  
 
|DESCRIPTION=
 
|DESCRIPTION=
Sets or queries individual PLS position values. When a PLS is defined, no PLS positions exist. A PLS position data structure must be created, using the CREATEPLSDATA command. This PPOS property is used to define PLS position values.
+
Sets or queries individual PLS position values. <br>
  
PLS positions units are depend in the plssource type.  
+
When a PLS is first defined, it does not have any associated positions. The ''CreatePLSData'' command is used to define the values for the PLS positions. <br>
<br/>For example - In case plssource is PCMD the units are given in user units and are affected by the axis displacement and position factor properties. In this case positions are absolute values (not incremental values).
+
An unlimited number of PLS positions can be defined, but the array must be monotonic increasing. <br>
<br/>In case of plssource from type PlsPercentage the units are % , and in case of PlsTime the units are msec.
 
  
The PLS position data must be monotonic or the PLS is not enabled.
+
PLS position values are always absolute (and not incremental). PLS positions are given in user units, and as such are affected by axis Displacement and ''PositionFactor'' properties.<br>
 +
PLS positions units are dependent upon the type of position defined by ''PLSSource''. For example, if ''PLSSource'' type is ''PlsPercentage'', the units are percentage. If ''PLSSource'' type is ''PlsTime'' the units are milliseconds.
  
 
|TYPE=
 
|TYPE=
Line 26: Line 26:
  
 
|UNITS=
 
|UNITS=
User axis position units, as given by <''axis''>.POSITIONFACTOR
+
Axis position units.
  
 
|DEFAULT=
 
|DEFAULT=
Line 35: Line 35:
  
 
|LIMITATIONS=
 
|LIMITATIONS=
The PLS position may be set only when the PLS is disabled.
+
Can be set only when PLS is disabled.
  
 
|EXAMPLE=
 
|EXAMPLE=

Latest revision as of 14:11, 10 October 2018

Sets or queries individual PLS position values.

When a PLS is first defined, it does not have any associated positions. The CreatePLSData command is used to define the values for the PLS positions.
An unlimited number of PLS positions can be defined, but the array must be monotonic increasing.

PLS position values are always absolute (and not incremental). PLS positions are given in user units, and as such are affected by axis Displacement and PositionFactor properties.
PLS positions units are dependent upon the type of position defined by PLSSource. For example, if PLSSource type is PlsPercentage, the units are percentage. If PLSSource type is PlsTime the units are milliseconds.

Short form

<pls>.Ppos

Syntax

<pls>.PlsPosition[<index>] = <PLS position>

Availability

All versions

Type

Double

Range

<index>: 1 to the size of PLS data structure
<PLS position>: ± MaxDouble

Units

Axis position units.

Default

0 (after the PLS data structure has been created)

Scope

Configuration, Task or Terminal

Limitations

Can be set only when PLS is disabled.

Examples

PLS1.PlsPosition[5] = 2076.56

See Also