Package: tigerasi
TigerASIa feature-rich Python interface for ASI Tiger Controllers.This driver was written to simplify the serial api to ASI'sTiger Controllerswhile reducing reliance on the fulldocumentationfor most users.
Many (but not all!) commands have been exposed and wrapped in a simplified, self-consistent interface and documented for easy usage.InstallationTo install this package fromPyPI, invoke:pip install TigerASI.To install this package from the Github in editable mode, from this directory invoke:pip install -e .To install this package in editable mode and build the docs locally, invoke:pip install -e .[dev]Intro and Basic Usagefromtigerasi.tiger_controllerimportTigerControllerbox=TigerController("COM4")The basic command syntax looks like this:box.zero_in_place('x','y')# Zero out the specified axes at their current location.box.move_absolute(x=1000,y=25)# Move to an absolute location in "stage units" (tenths of microns).box.move_relative(z=100)# Move z +100 stage units in the positive z direction.Syntax BasicsAll commands that reference stage axes accept a variable, optional number of arguments.box.zero_in_place('x')# only zeros the x axis. Other axes are ignored.Stage axes are also case-insensitive,box.zero_in_place('X','y','Z')# also okand the order doesn't matter.box.zero_in_place('y','z','x')# also okAll commands that query stage axes return a dict, keyed byupper-casestage axis.box.get_position('x','z','y')# {'X': 100.0, 'Y': 305.0, 'Z': 10000.0}Some commands can take an axis setting to be "current value" and another axis setting to be a specified value.
The syntax for these commands look like this:box.set_home('x','z',y=100.0)# Set x and z axes homing location to current spot. Set y axis to specific spot.box.set_home('z','y','x',m=100.0,n=200.0)# variable number of arguments ok! order and case don't matter.Some commands assumeallaxes if none are specified.box.zero_in_place()# will zero ALL lettered axes.box.reset_lower_travel_limits()# will reset ALL lettered axes.box.get_home()# will get ALL lettered axis home positions.box.get_lower_travel_limits()# will get ALL lettered axis lower travel limits.For setting values, this might not be your desired behavior, so it is safer to default to passing in axes explicitly.box.zero_in_place('x','y','z')# will zero only x, y, and z axes.box.reset_lower_travel_limits('x','y','z')# will reset only x, y, and z axes.When in doubt, check the docs.SimulationThis package also features a simulated version of the TigerControllerfromtigerasi.sim_tiger_controllerimportSimTigerControllerbox=SimTigerController()# ORbox=SimTigerController('COM4')# com port is ignored. # ORbox=SimTigerController(build_config={'Motor Axes':['X','Y','Z']})# This object tracks its internal state for position and speed.box.home_in_place('x','y','z')# home mocked axes.box.move_absolute(z=10)# move mocked axis.This feature can be useful for testing higher level code using the current api without the need to interact with real hardware.Advanced UsageMany (but not all!) of ASI's more advanced features have been made available via this simplified API.
This list includes joystick enabling/disabling and remapping, setting stage travel limits, queuing moves into the hardware buffer, and many other more nuanced features.
For a breakdown of what commands have been exposed, have a look at theexamples folderand the docs.DocumentationDocs can be generated via Sphinx but are also available onreadthedocs.Implementation DetailsBlocking or Non-Blocking?All commands to the Tigerbox return a reply.
Commands that query the Tigerbox state will also return data with that reply.Waiting for a reply introduces 10-20[ms] of execution time before the function returns an 'ACK'knowledgement.
By default, methodswill blockuntil receiving this acknowledgement unless otherwise specified, like this:box.move_absolute(x=1000,y=25,wait=False)# will not block.This behavior can only be used for commands to change the Tigerbox state.
Commands that query the Tigerbox state will always block until they receive a hardware reply.