====== Command:HERE (H) ======

The 'here' command differs on a TGPMT card from our other systems. 

--> Actuators, Piezos, MicroMirror etc ^

--> MS2000 or RM2000 syntax ^
The HERE command sets the current reported position(s) of the axis(es) provided. 


^Shortcut  |H   | 
^Format  |HERE [axis]=[position in 1/10 microns]… |
^Units    |1/10 microns|
^Remembered |Automatically |

<--

--> Tiger syntax ^

^Shortcut  |H   | 
^Format  |HERE [axis]=[position in 1/10 microns] or see below for clocked devices|
^Units    |1/10 microns|
^Type    |Axis-Specific  |
^Remembered |Automatically |

<--

Assign the specified number to the axis’s current position buffer. If no position is specified, 0 is assumed. For non-clocked devices, the unit of measurement is in tenths of microns.  This defines the current position to be a specific distance from the origin (0). 

**Clocked Devices: **

On clocked devices (filter slider, turret, mirrored port switch, etc), you can //change position #1// or you can //change the spacing between positions//.\\ \\
Change position #1"
  - Remove all axes from either the joystick or a knob (for example, the Z-axis from the Z-knob <wrap cmd> J Z=0</wrap>).
  - Assign the clocked device axis to that joystick or knob (for example, the M-axis to the Z-knob <wrap cmd> J M=22</wrap>).
  - Use the joystick or knob to adjust the axis to the desired position.
  - Issue the 'here' command to set the position (for example, the M-axis <wrap cmd> H M=1</wrap>).
  - Restore (assign and unassign) the desired axes to the joystick / knobs as desired (for example, the M-axis from and the Z-axis to the Z-knob <wrap cmd> J M=0 Z=22</wrap>). \\ \\
Change the spacing between positions:\\
  - Move to position #2 (for example, the M-axis <wrap cmd> M M=2</wrap>).
  - Remove all axes from either the joystick or a knob (for example, the Z-axis from the Z-knob <wrap cmd> J Z=0</wrap>).
  - Assign the clocked device axis to that joystick or knob (for example, the M-axis to the Z-knob <wrap cmd> J M=22</wrap>).
  - Use the joystick or knob to adjust the axis to the desired position.
  - Issue the 'here' command to set the spacing (for example, the M-axis <wrap cmd> H M+</wrap>. 
  - Restore (assign and unassign) the desired axes to the joystick / knobs as desired (for example, the M-axis from and the Z-axis to the Z-knob <wrap cmd> J M=0 Z=22</wrap>).

Only available on MS2000 version 9.2m and above, TG1000 version 3.28 and above.  

If there are no errors, the positive reply <wrap reply> :A </wrap> will be sent back from the controller

<WRAP center round important 60%>
DOES NOT WORK FOR PIEZOS AND MICROMIRRORS. <del> DOES NOT WORK FOR “CLOCKED DEVICES” SUCH AS FILTER SLIDERS AND TURRETS.</del>
</WRAP>


__//Example//__
	
<asi> $ H X=1234 Y=4321 Z
:A</asi>

The X position will change to 123.4 microns from the origin, Y will change to 432.1 microns, and the Z will be zeroed.  
__//Example//__
	
<asi> $ H X=1234 Y=4321 Z
:A</asi>

The X position will change to 123.4 microns from the origin, Y will change to 432.1 microns, and the Z will be zeroed.

<--


--> TGPMT usage ^

^Shortcut  |H   | 
^Format  |''HERE [axis]'' or \\ ''HERE [axis]=0'' |
^Type    |Axis-Specific  |
^Remembered |Automatically |

On a TGPMT card, this command this used to Zero the PMT signal reported by the [[commands:rdadc|RDADC command]]. When this command is issue, the current PMT signal is saved, and the controller begins subtracting it from the current PMT signal. Users can use this as a background subtract or offset feature. 

User can cancel the zeroing by issuing ''HERE [axis]=0''. Readings reported by [[commands:rdadc|RDADC command]] will not be altered anymore. 

Only the readings reported by the [[commands:rdadc|RDADC command]] are altered. 0-4V Analog PMT signal on the BNC connector is not altered. 

This is a card wide-settings, both PMT0 and PMT1's reading are altered.

More details [[:tgpmt#adc_specification|here]].

__//Example//__

<asi> $ h m
:A</asi>

If the TGPMT card axis char is **m**. Saves the current PMTs readings and starts subtracting them from RDADC commands reported readings. 

<asi> $ h m=0
:A</asi>

If the TGPMT card axis char is **m**. Clears the saved PMTs readings and stops subtracting them from RDADC commands reported readings. 



<--


{{tag>commands tiger ms2000 tgpmt}}