APT with LabVIEW
![APT with LabVIEW](https://www.thorlabs.de/Images/GuideImages/8348_Actuators_4.jpg)
- Use APT with LabVIEW
- Download Example Virtual Instruments
MAX302
3-Axis NanoMax Stage with 4 mm Travel and Internal Piezos
MAX301 with a Stepper Motor, Thumbscrew, and Differential Actuator Attached to the X, Y, and Z Axes, Respectively
Virtual Instrument GUI for 2-Axis Alignment Optimization
![](../../images/loading-red.gif)
Please Wait
LabVIEW can be used to communicate with any APT-based controller via ActiveX technology. In LabVIEW, you build a user interface, known as a front panel, with a set of tools and objects and then add code using graphical representations of functions to control the front panel objects. The LabVIEW tutorial provides some information on using ActiveX to create control GUIs for APT-driven devices within LabVIEW. The LabVIEW tab provides an overview of some basic information about using APT-based controllers in LabVIEW. The Getting Started tab explains the basic setup procedure that needs to be completed before using a LabVIEW GUI to operate an APT-based device. The Basic VIs, Intermediate VIs, and Advanced VIs tabs provide a summary of LabVIEW virtual instrument (VI) examples provided by Thorlabs to help you get started with creating programs for your controllers in LabVIEW.
A comprehensive guide to using LabVIEW with APT can be downloaded here.
![LabVIEW GUI](https://www.thorlabs.de/images/tabimages/LabView_Screenshot_400.jpg)
Click to Enlarge
APT Controls can be placed in the LabVIEW environment.
Typically, a Windows® development system (such as LabVIEW) will allow a third-party ActiveX Control to be incorporated into the environment for ease of use by the software developer.
Once the control is placed on the front panel, it can be used in the same way as any other LabVIEW control. However, each APT Control must be activated by carrying out the following two steps. For detailed instructions, see the blue box titled Creating an ActiveX Property or Method in LabVIEW.
- The 'HWSerialNumber' property must be set to the correct (factory programmed) hardware unit serial number.
- The 'StartCtrl' method must be called in order to activate the control.
A guide to using the APT software within a LabVIEW environment can be found here.
Note: Thread allocation in LabVIEW is dynamic. The number of threads and the usage of thread allocation will vary with each application. If the thread allocation is important in your application, some information on multithreading is provided below.
Working virtual instrument (VI) files are available with basic, intermediate, and advanced examples of how to perform general programming tasks within a LabVIEW environment (see the Basic VIs, Intermediate VIs, and Advanced VIs tabs). Useful comments have been added to the software to further explain each step in the program. These examples, which can be run with either an actual hardware configuration or a simulated configuration, interact with the hardware via the APT Server, which is downloadable from our website. Note that while the simulated server can be used, some of the more advanced alignment operations will not function as with real hardware due to the requirement for 'real' power feedback signals which are not simulated. The examples do not contain extensive information on the installation and operation of the associated hardware and should be used in conjunction with the handbooks.
If you have any questions or comments about these examples, please contact techsupport@thorlabs.com.
LabVIEW Multithreading
LabVIEW allocates several different types of threads:
- User Interface Thread: This thread is used for screen drawing, keyboard/mouse input, and certain types of VI execution, such as attribute nodes and thread-unsafe CINs and DLLs.
- Timer Threads: A pair of these threads is used internally by LabVIEW (Windows NT allocates one additional thead to be used internally).
- Execution Threads: There are twenty of these threads used per CPU in your system. LabVIEW has five "execution systems", and each execution system allocates threads for four different normal priorities. This accounts for twenty threads, not counting the user interface thread, which can also be used for execution. Execution thread allocation is based on how many processors you have in your system, so a dual processor computer will have forty execution threads plus the other threads mentioned above.
On Windows NT, threads are dynamically allocated for certain operations using the ActiveX client interface to control LabVIEW. So, for a single processor system, 23 or 24 threads are allocated when the application starts. If you are using the ActiveX client interface, more may be allocated while running your VIs.
Priorities:
Subroutine VIs always use the execution system of their caller, since staying in the same execution system is the most efficient. The "background priority" does not normally have threads allocated for it. VIs running at this priority will use the next higher priority threads when nothing else is available to run.
APT and LabVIEW Threading Issues:
APT can only be accessed by a single threaded client application. As LabVIEW is inherently multithreaded, each access to the APT software must be constrained to a single execution thread. Property Nodes cause a switch to the UI thread in the LabVIEW environment as well as other LabVIEW-based ActiveX functionality. To ensure single-threaded access to the APT software, the VI must run in the user interface thread. Currently, without enforcing your VI to run in the user interface thread, LabVIEW cannot thread marshal access to the APT software and will result in the following LabVIEW error: “Error 3006 occurred at Automation Interface Execution System.”
Creating an ActiveX Property or Method in LabVIEW
A new 'Property Node' or 'Method Node" for an ActiveX object can be created directly within the block diagram without having to navigate the function palette. Property and Method Nodes can be added by using the drop down menu system within LabVIEW.
- Multiple Property Nodes and Method Nodes can be created for the same object.
- In LabVIEW, a Method Node is sometimes referred to as an Invoke Node.
To create a Property Node or Method Node for an ActiveX object:
- Right-click the ActiveX object and select 'Create Property' or 'Create Method' from the shortcut menu. The object can be a control on the front panel within an ActiveX container, an ActiveX refnum or a terminal from another VI, a function, or a node.
- On the block diagram, click where you want to place the Property Node or Method Node. A Property Node or Method Node appears on the block diagram where you clicked.
- Right-click in the white area of the Property Node or Method Node, and select the property or method to access it.
Examples of how to create Methods in LabVIEW are provided in the videos below.
Working with ActiveX Events in LabVIEW
ActiveX events allow all of the data to be stored for a specific action that occured as a result of an ActiveX communication. The following procedure shows how to create a VI that creates and waits on an ActiveX event queue and then destroys the event queue. (Note: An event queue is a tag that corresponds to an internal list of events that an ActiveX control receives.)
- On the block diagram, select Functions/Communication/ActiveX/ActiveX Events/Create ActiveX Event Queue.
- Wire the ActiveX Container refnum or the ActiveX Automation refnum to the Automation RefNum input of the 'Create ActiveX Event Queue VI'.
- Select Functions/Communication/ActiveX/ActiveX Events/Wait On ActiveX Event VI'.
- Wire the Event Queue output from the 'Create ActiveX Event Queue VI' to the Event Queue input of the 'Wait On ActiveX Event VI'.
- Select Functions/Communications/ActiveX/ActiveX Events/Destroy ActiveX Event Queue VI'.
- Wire the Event Queue output from the 'Wait On ActiveX Event VI' to the Event Queue input of the 'DestroyActiveX Event Queue VI'.
- When an event is fired, event data is returned from the Wait On ActiveX Event VI, which can be acted upon within the diagram.
Examples of how to create Properties in LabVIEW are provided in the videos below.
Tutorial Videos
Full ActiveX support is provided by LabVIEW and the series of tutorial videos below illustrates the basic building blocks in creating a custom APT motion control sequence. We start by showing how to call up the Thorlabs-supplied online help during software development. Part 2 illustrates how to create an APT ActiveX Control. ActiveX Controls provide both Methods (i.e. Functions) and Properties (i.e. Value Settings). Parts 3 and 4 show how to create and wire up both the methods and properties exposed by an ActiveX Control. Finally in Part 5 we pull everything together and show a completed LabVIEW example program that demonstrates a custom move sequence.
Disclaimer: The videos below were originally produced in Adobe Flash. Following the discontinuation of Flash after 2020, these tutorials were re-recorded for future use. The Flash Player controls still appear in the bottom of each video, but they are not functional.
Getting Started
The steps below outline the startup procedure for using the example virtual instruments (VIs) and connecting them to an APT-controlled device in your lab. Once you have finished this start up procedure, you can use the VIs outlined in the Basic VIs, Intermediate VIs, and Advanced VIs tabs.
- Download the Examples from the relevant section (Basic, Intermediate, or Advanced) to the desired location on your PC.
- Associate the Axes. To ensure that a particular stage is driven properly by the system, a number of parameters must first be set. These parameters relate to the physical characteristics of the stage being driven (e.g., min and max positions, leadscrew pitch, homing direction, etc.). To assist in setting these parameters correctly, it is possible to associate a specific stage type and axis with the motor controller channel using the APT Config utility. Once this association has been made, the APT server applies the suitable default parameter values automatically upon boot up of the software. See the APT Config Utility Helpfile for details on how to assign a stage type and axis.
- Setting the Serial Numbers. The routines are hard coded to run the following preconfigured serial numbers:
Motor - 20000001
Piezo - 21000001
NanoTrak® - 22000001
Basic Virtual Instrument (VI) Examples
These basic examples contain all the information needed to get started using the APT Server with LabVIEW, and are not intended to be used as the basis for any custom application. The use of each ActiveX control is demonstrated in a simple .vi file, which shows how the associated ActiveX methods and properties are used. Furthermore, if an error does occur from the server, a dialog box will pop up to inform the user of the error, and the VI will stop running.
The VI's are split into five sections dependent on the control with which they are associated: Motor, NanoTrak®, Piezo, Strain Gauge, or Solenoid.
Motor VIs
![Motor Move Relative Virtual Instrument](https://www.thorlabs.de/images/tabimages/TTLMotorMoveRelative_300.jpg)
Click to Enlarge
A Screenshot of the GUI Interface of TL Motor MoveHome.vi
![Motor Move Home Virtual Instrument](https://www.thorlabs.de/images/tabimages/TLMotorMoveHome_300.jpg)
Click to Enlarge
A Screenshot of the LabVIEW Code of TL Motor MoveHome.vi
A zipped file containing all of the Motor VIs can be downloaded here.
TL Motor MoveHome.vi
This VI Moves the axis of the stage to the Home position.
Each axis on the associated stage has settings for the Zero Offset and Minimum Position parameters. The Zero Offset is the distance between the negative limit switch and the end of travel. The Minimum Position is the minimum absolute position that can be set for the stage axis. Typically, when the TL Motor MoveHome.vi is run, the stage axis moves to its negative limit and then moves forward by a set distance (zero offset). The absolute position count is then reset to zero to provide the reference point for all subsequent absolute moves. If position is lost on a stage axis, the MoveHome method should be called to re-establish the zero (Home) position.
TL Motor MoveAbsolute.vi
This VI moves the axis of the stage to the specified absolute position. The position is measured from the Home position in millimeters.
TL Motor MoveRelative.vi
This VI moves the asix of the stage a specified distance, relative to the present position.
![Get Axis Stage Info](https://www.thorlabs.de/images/tabimages/TLMotorSetGetStageAxisInfo_300.jpg)
Click to Enlarge
A Screenshot of the LabVIEW Code layer of TL Motor SetGetStageAxisInfo.vi
![Get Axis Stage Info](https://www.thorlabs.de/images/tabimages/TLMotoGetSetStageAxisInfo_LV_300.jpg)
Click to Enlarge
A Screenshot of the GUI Interface of TL Motor SetGetStageAxisInfo.vi
TL Motor SetGetStageAxisInfo.vi
This VI sets and retrieves data describing the properties of the stage, producing settings that are specific to the design of the associated stage.
- The Units parameter contains the units of measure for stage motion in either millimeters or degrees, whichever is relevant.
- The MinPos and MaxPos parameters contain the positions of the minimum and maximum travel limits respectively, and are determined by their displacement from the Home position. MinPos is usually set to zero.
- The Pitch parameter returns the pitch of the motor leadscrew in mm or degrees per rev, which is used to calculate the distance moved for each revolution of the motor.
- The DirSense parameter is for future development and is not implemented at this time.
TL Motor SetGetVelParams.vi
This VI is applicable to moves initiated from software by running the TL Motor MoveRelative.vi or TL Motor MoveAbsolute.vi. It allows the trapezoidal velocity profile parameters to be set for all moves. Parameters are set in real world units (mm or degrees) dependent upon stage type.
TL Motor MoveComplete.vi
The TL Motor MoveComplete.vi must be run with a correctly entered serial number. The MoveComplete.vi presents the user with a motor GUI panel, which can be used to move motors by pressing the job buttons or entering a position in the display. When the move is complete, the MoveComplete CallBack.vi is called and run. This second VI displays a message in the Events dialog box to state that the move has completed.
NanoTrak® VIs
A zipped file containing all of the NanoTrak® VIs can be downloaded here.
TL NanoTrak LatchTrack.vi
This VI sets the tracking mode for the NanoTrak. When set to Latched, scanning is disabled and the piezo drives are held at the present position. When set to Track, scanning is enabled and the NanoTrak follows the position of maximum power.
TL NanoTrak SetGetCircDia.vi
This VI sets and retrieves the diameter of the NanoTrak scanning circle. The circle diameter is measured on a scale (NanoTrak units) such that 10 units is the width and height of the screen. If, for example, the NanoTrak is driving a 20 micron actuator, a circle diameter of 1 unit will result in a real diameter of 2 microns. The scanning circle diameter can have values in the range of 0 to 5 with a value of 5 corresponding to one half the range of piezo motion.
Note: If the NanoTrak is latched when this method is called, the circle diameter will not change. When the NanoTrak is set to Track mode, the circle diameter will change to the value set in this method.
TL NanoTrak SetGetCircDiaLUTVal.vi
This VI enables a look up table (LUT) of circle diameter values (in NanoTrak units) to be specified as a function of input range. The system then uses the values in this LUT to modify circle diameter in relation to the input range currently selected. This mode of adjustment allows the appropriate circle diameters to be applied on an application-specific basis.
TL NanoTrak SetGetCircleHomePos.vi
This VI sets and retrieves the circle home position. The present horizontal and vertical coordinates of the home position are displayed in the 'Initial Pos' field. Both position outputs can have values in the range of 0.0 to 10.0 (NanoTrak units), with (5.0, 5.0) representing the display's origin (screen center).
TL NanoTrak SetGetLoopGain.vi
This VI sets and retrieves the feedback loop gain. The gain setting is used to ensure that the DC level of the input (feedback loop) signal lies within the dynamic range of the input.The present gain value is displayed in the 'Initial Gain' field. The gain can be changed by entering a value (in the range 100 to 10,000) in the 'New Gain' field.
TL NanoTrak SetGetPhaseComp.vi
This VI sets and retrieves the phase compensation for the horizontal and vertical components of the circle path.
The feedback loop scenario in a typical NanoTrak application can involve the operation of various electronic and electromechanical components (e.g., power meters and piezo actuators) that could introduce phase shifts around the loop and thereby affect tracking efficiency and stability. These phase shifts can be cancelled by setting the 'Phase Compensation' factors. This VI sets and retrieves the phase compensation for the horizontal and vertical components of the circle path.
The present values are displayed in the 'Initial Phase Comp' field. These values can be changed by entering different values into the 'New Phase Comp' field. The values are specified in degrees and lie in the range -180.0 to 180.0 degrees.Typically, both phase offsets will be set the same, although some electromechanical systems may exhibit different phase lags in the different components of travel and so require different values.
TL NanoTrak SetGetRangingMode.vi
This VI sets and retrieves the ranging mode. The ranging mode currently selected is displayed in the first box of the 'Initial Ranging Mode' field. It can be set by entering a number 1 through 4:
- Changes the ranging mode to to Auto ranging at the range currently selected.
- Changes the ranging mode to Manual ranging at the range currently selected.
- Changes the ranging mode to manual ranging at the range set in the SetRange method (or the 'Settings' panel). When auto-ranging mode is selected, range changes occur whenever the relative input power signal reaches the upper or lower end of the currently set range.
- Changes the ranging mode to Auto ranging at the range set in the SetRange method (or the 'Settings' panel). When auto-ranging mode is selected, range changes occur whenever the relative input power signal reaches the upper or lower end of the currently set range.
The second box of the 'Initial Ranging Mode' field specifies how these range changes are implemented by the system:
- The unit visits all ranges when ranging between two input signal levels.
- Only odd numbered ranges between the two input signals will be visited.
- Only even numbered ranges between the two input signal levels will be visited. These latter two modes are useful when large rapid input signal fluctuations are anticipated. This is because the number of ranges visited is halved to give a more rapid resonse.
The ranging mode can be changed by entering different values into the 'New Ranging Mode' field.
Piezo VIs
A zipped file containing all of the Piezo VIs can be downloaded here.
TL Piezo GetMaxTravel.vi
In the case of actuators with built-in position sensing, the Piezoelectric Control Unit can detect the range of travel of the actuator since this information is programmed in the electronic circuit inside the actuator. This VI retrieves the maximum travel for the piezo actuator associated with the channel specified by the lChanID parameter, and returns a value (in microns) in the plMaxTravel parameter.
TL Piezo SetGetControlMode.vi
When in closed-loop mode, position is maintained by a feedback signal from the piezo actuator. This is only possible when using actuators equipped with position sensing. This VI sets the control loop status. For more details, please refer to the APT server help file (After APT installation, this can be found in Start/All Programs/Thorlabs/APT/Help).
TL Piezo SetGetPosOutput.vi
This VI sets and retrieves the position of the piezo actuator.
The current position of the actuator is displayed in the 'Initial Position' field. The position of the actuator is relative to the datum set for the arrangement using the ZeroPosition method. Once set, the extension of the actuator will be read and scaled automatically to a position in microns, for whichever actuator is connected to the control module. Note: The SetPosOutput VI is applicable only to actuators equipped with position sensing and operating in closed loop mode. Actuators fitted with feedback circuitry can be interrogated by the Piezo module for maximum travel in microns (see the GetMaxTravel.vi).
The position of the actuator can be changed by entering a different value in the 'New Position' field.
TL Piezo SetOutputLUTValue.vi
It is possible to use the controller in an arbitrary Waveform Generator Mode (WGM). Rather than the unit outputting an adjustable but static voltage or position, the WGM allows the user to define a voltage or position sequence to be output, either periodically or a fixed number of times, with a selectable interval between adjacent samples. This waveform generation function is particularly useful for operations such as scanning over a particular area, or in any other application that requires a predefined movement sequence.
The waveform is stored as values in an array, with a maximum of 8000 samples per channel which represent either voltage or position. If open loop operation is specified when the samples are output, then their meaning is voltage; if the channel is set to closed loop operation, the samples are interpreted as position values. If the waveform to be output requires less than 8000 samples, it is sufficient to download the desired number of samples.
Strain Gauge VI
A zipped file containing the Strain Gauge VI can be downloaded here.
TL Strain Gauge Reader GetReading.vi
This VI returns the current reading of the strain gauge associated with the Strain Gauge Reader.
The units applicable are dependent on the current operating mode. If the unit is operating in Position mode, then the vi returns a position value in microns. If the unit is in Voltage mode, then the vi returns a Voltage. If the controller is in ‘Force Sensing Mode’ then a force value in Newtons is returned. The returned data values are sampled at 500 Hz, which is particularly useful in touch probe or force sensing applications where rapid polling of the force reading is important.
All values are relative to the datum set for the arrangement.
Solenoid VI
A zipped file containing the Solenoid VI can be downloaded here.
TL SetOperatingMode.vi
This VI sets the operating mode of the Solenoid Controller unit. For more details, please refer to the APT server help file (After APT installation, this can be found in Start/All Programs/Thorlabs/APT/Help).
Intermediate Virtual Instrument (VI) Examples
The Intermediate Examples contain five routines, written using the APT Server. These are only intended to be used as examples when writing custom applications, and all parameters are hard coded. Before the examples can be used as the basis for any custom application development, parameters may need to be changed. For example, the scan routines may require different start point and interval values. The threshold for the power range to locate during a search may also be different. If an error occurs from the server, a dialog box will pop up to inform the user of the error, and the VI will stop running.
The function of each VI is explained briefly below. The files can be downloaded here.
![2 Dimensional Raster](https://www.thorlabs.de/images/tabimages/2D_Raster_Drawing.gif)
2D Raster Scan Pattern
Motor2DScan.vi
This VI shows a basic two-dimensional raster scan using a motor control, which is the most basic scan pattern. Coordinates are generated along the Y axis between a lower and upper search limit. Once the upper limit is reached, the search is stepped in the Z axis and begins again. The number of coordinates generated is dependent upon the search area and the step size.
MotorScan2DFindRange.vi
This VI is an extension of the Motor 2D scan. A NanoTrak® control is included, and the scan is exited when the signal being searched exceeds a predefined threshold value.
Piezo2DScan.vi
This VI shows a basic two-dimensional raster scan using a piezo control.
This is the most basic scan pattern. Coordinates are generated along the Y axis between a lower and upper search limit. Once the upper limit is reached, the search is stepped in the Z axis and begins again. The number of coordinates generated is dependent upon the search area and the step size.
PiezoNanoTrak2DScanFindRange.vi
This VI is an extension of the Piezo 2D scan. A NanoTrak control is included, and the scan is exited when the signal being searched exceeds a predefined threshold value.
MotorNanoTrak2DRevector.vi
In any application, when the NanoTrak is set to tracking mode, the NanoTrak is limited to the range of the piezos in order to track the signal. If, due to thermal drift or other external influences, the NanoTrak reaches the edge of its screen, it will lose the signal due to the range of the piezos. A revector routine checks the circle position, and if the circle position is not near the center of the NanoTrak's screen, motors are used to ensure that the NanoTrak has sufficient range to continue tracking the signal.
Advanced Virtual Instrument (VI) Examples
The Thorlabs approach to alignment is based on a combination of stepper motors (NanoSteps) and piezo positioners. The stepper motors provide coarser motion over a larger range whereas the piezos provide extremely fine motion over a smaller range. The piezos are driven from the NanoTrak®, an analog instrument that optimizes the piezo extension for maximum optical power.
The Advanced Examples contain five routines, written using the APT Server. These VIs are intended to be used as examples when writing custom applications. Before the examples can be used as the basis for any custom application development, some alteration of the code may be necessary. For example, the order and process in which optimization occurs may need altering. Furthermore, if an error occurs from the server, a dialog box will pop up to inform the user of the error, and the VI will stop running. In an end application more complex error handling may be needed. The function of each VI is explained below. A zipped folder containing all of the advanced example VIs can be downloaded here.
Note: These VIs contain sample code to illustrate optimization of alignment along several sets of axes. The code may be copied and pasted into another program, but more advanced error handling must be added before this example can be run as part of an end application.
![2-Axis Optimization Flow Chart](https://www.thorlabs.de/images/tabimages/2-Axis_Optimization_Flow_Chart.gif)
2-Axis Optimization
This virtual instrument optimizes the alignment of two parts of a system along 2 axes (for example, the alignment of two fiber tips to maximize the amount of light that is coupled from one to the other). A 2D spiral search is performed by the NanoStep motors to locate the initial (threshold) power; then the optimum power is located using the piezos, with revectoring as required. The procedure is outlined in the flow chart to the right.
A zipped folder containing all of the advanced example VIs can be downloaded here.
Setting Up the NanoMax Stage
For this example, we will set up a NanoMax Stage with two V-groove fiber holders as shown in the drawing below. The mechanical components are listed in the table to the right. The components that need alignment have been left out of the setup, since these will be user dependent. Connect the NanoMax stage to the PC as detailed in the handbook for your device.
![2-Axis Optimization Mechanical Setup](https://www.thorlabs.de/images/tabimages/2-Axis_Fiber_Alignment_A1-550.jpg)
Click to Enlarge
A NanoMax stage set up for the 2-Axis Optomization VI. A complete list of item #'s is provided in the table to the right.
Item # | Description | Quantity |
---|---|---|
MAX301 or MAX302 | NanoMax-HS 3-Axis Stage | 1 |
DRV001 | NanoStep Actuator | 2 |
DRV3 | Differential Micrometer | 1 |
AMA007 or AMA009 | Fixed World Bracket | 1 |
HFV001 | Standard V-Groove Fiber Holdera | 1 |
HFV002 | Tapered V-Groove Fiber Holdera | 1 |
HFC005 | Standard Fiber Chuck | 1 |
BNT001/IR | APT NanoTrak® Controller | 1 |
BSC202 | APT Stepper Motor Controller | 1 |
![APT 2-Axis Optimization](https://www.thorlabs.de/images/tabimages/2-Axis_Optimization_GUI.jpg)
2-Axis Optimization GUI
The 2-axis optimization VI GUI is shown to the right and a description of each field is provided in the table underneath. Instructions for running the GUI are as follows:
- Ensure your system is set up according to the instructions given on the Getting Started tab.
- Power up the equipment.
- Open LabVIEW and run the 2AxisOptimization.vi file.
- Enter the serial numbers of the Stepper Motor and NanoTrak unit in your system.
- Enter values for the Threshold Range and Threshold Relative Signal applicable to your application, then check the Threshold box.
- Enter values for the Search Range and Search Interval applicable to your application.
- Enter values for the Load Position and Initial Position (the default values should be satisfactory for most applications).
- Click the
button to start communication between the software and the hardware.
- Click the Home button then wait for the motors to complete the homing movement.
- Click the Load Position button then wait for the motors to move to the load position.
- Load the devices to be aligned.
- Click the Initial Position button then wait for the motors to move to the initial position.
- Select the desired Optimization Mode and click the Optimize button to start the optimization sequence.
- If a power threshold is not located, adjust the Threshold Range and Threshold Relative Signal to a lower setting.
General Notes:
- During the alignment, the maximum signal level located and its associated position, are displayed in the Max Signal and Max Signal Position fields.
- After the alignment sequence is completed, the NanoTrak is set to `latch' mode.
- If a large value is set in the Search Range field, and/or a small value is set in the Search Interval field, it may take a long time to generate the scan coordinates. The actual time taken to generate the coordinates is dependent upon PC performance.
Field Name | Description | |
---|---|---|
Max Signal | Displays the maximum power located during the search. The power is displayed as a relative signal and a range value. | |
Max Signal Position | Displays the position at which the maximum power was located. | |
Threshold Range and Relative Signal |
The combination of these two settings determines the power level to be located by the spiral search. The search is terminated when the threshold level is exceeded. The level set should be higher than the noise floor to ensure the NanoTrak® does not track to a false power peak. | |
Search Range and Interval | The range and interval (step size) of the search pattern (in mm). | |
Optimization Mode | The type of optimization to perform. Select from: | Full Optimization: A complete optimization including NanoTrak scan for max power. |
Stop Optimization Upon Threshold Signal: The optimization is stopped once the level of power found exceeds the threshold level set for the 2D scan. If no threshold level is set, a full 2D scan is performed. The system then moves to the position where max power was located. | ||
HWSerialNums | Enter the serial numbers of each APT unit in the system. | |
Load Position | Moves all the motors to the initial position. These are the safe positions where load or unload operations can be performed. The positions are measured in mm (or degrees) from the Home position. | |
Initial Position | The position of the motors immediately prior to the commencement of an optimization. The position is measured in mm (or degrees) from the Home position. | |
Home | Moves all motors to the Home position. | |
Load Position | Moves all motors to the initial position. | |
Optimize | Start button for the optimization. | |
Exit | Stops the current LabVIEW VI. To restart a VI, select 'Run' from the LabVIEW environment. | |
Intensity Map | Displays a graphical representation of the search results. | |
Motor Graphical Interface | Displays the GUI panel for the stepper motor controller unit whose serial number is selected in the HWSerialNums field. | |
NanoTrak® Graphical Interface | Displays the GUI panel for the NanoTrak unit whose serial number is selected in the HWSerialNums field. |
![3-Axis Optimization Flow Chart](https://www.thorlabs.de/images/tabimages/3-Axis_Optimization_Flow_Chart.gif)
3-Axis Optimization
This VI is used to optimize the alignment of 3 axes in a system. First, a 2D spiral search is performed by the NanoStep motors to locate the initial (threshold) power. Next, the optimum power is located using the piezos, with revectoring as required. Once max power is located in axes 1 and 2, the power is further optimized by adjusting the position in axis 3, while the position in axes 1 and 2 are maintained by 'nudging' the NanoTrak. The alignment is complete when a specified ceiling power is achieved.
A zipped folder containing all of the advanced example VIs can be downloaded here.
Setting Up the NanoMax Stage
For this example, we will set up a NanoMax Stage with two V-groove fiber holders as shown in the drawing below. The mechanical components are listed in the table to the right. The components that need alignment have been left out of the setup, since these will be user dependent. Connect the NanoMax stage to the PC as detailed in the handbook for your device.
![3-Axis Optimization Mechanical Setup](https://www.thorlabs.de/images/tabimages/3-Axis_Fiber_Alignment_A1-550.jpg)
Click to Enlarge
A NanoMax stage set up for the 3-Axis Optomization VI. A complete list of item #'s is provided in the table to the right.
Item # | Description | Quantity |
---|---|---|
MAX301 or MAX302 | NanoMax-HS 3-Axis Stage | 1 |
DRV001 | NanoStep Actuator | 3 |
AMA007 or AMA009 | Fixed World Bracket | 1 |
HFV001 | Standard V-Groove Fiber Holdera | 1 |
HFV002 | Tapered V-Groove Fiber Holdera | 1 |
HFC005 | Standard Fiber Chuck | 1 |
BNT001/IR | APT NanoTrak® Controller | 1 |
BSC202 | APT Stepper Motor Controller | 1 |
3-Axis Optimization GUI
The 3-axis optimization VI GUI is shown to the right and a description of each field is provided in the table underneath. Instructions for running the GUI are as follows:
![APT 2-Axis Optimization](https://www.thorlabs.de/images/tabimages/3-Axis_Optimization_GUI.jpg)
- Ensure your system is set up according to the instructions given on the Getting Started tab.
- Power up the equipment.
- Open LabVIEW and run the 2AxisOptimization.vi file.
- Enter the serial numbers of the Stepper Motor and NanoTrak unit in your system.
- Enter values for the Threshold Range A and Threshold Relative Signal A applicable to your application, then check the Threshold box.
- Enter values for the Search Range A and Search Interval A applicable to your application.
- Enter values for the Threshold Range B and Threshold Relative Signal B applicable to your application, then check the Threshold box.
- Enter values for the Search Range B and Search Interval B applicable to your application.
- Enter values for the Load Position and Initial Position (the default values should be satisfactory for most applications).
- Click the
button to start communication between the software and the hardware.
- Click the Home button then wait for the motors to complete the homing movement.
- Click the Load Position button then wait for the motors to move to the load position.
- Load the devices to be aligned.
- Click the Initial Position button then wait for the motors to move to the initial position.
- Select the desired Optimization Mode and click the Optimize button to start the optimization sequence.
- If a power threshold is not located, adjust the Threshold Range A and Threshold Relative Signal A to a lower setting.
General Notes:
- During the alignment, the maximum signal level located and its associated position, are displayed in the Max Signal and Max Signal Position fields.
- After the alignment sequence is completed, the NanoTrak is set to `latch' mode.
- If a large value is set in the Search Range field, and/or a small value is set in the Search Interval field, it may take a long time to generate the scan coordinates. The actual time taken to generate the coordinates is dependent upon PC performance.
Field Name | Description | |
---|---|---|
Max Signal | Displays the maximum power located during the search. The power is displayed as a relative signal and a range value. | |
Max Signal Position | Displays the position at which the maximum power was located. | |
Threshold Range A and Relative Signal A |
The combination of these two settings determines the signal level to be located by the spiral search on axes 1 and 2. The search is terminated when the threshold level is exceeded. The signal level set should be higher than the noise floor to ensure the NanoTrak® does not track to a false power peak. | |
Search Range A and Interval A | The range and interval (step size) of the search pattern (in mm). | |
Threshold Range B and Relative Signal B |
The combination of these two settings determines the signal level to be located by the step search on axis 3. The search is terminated when the threshold level is exceeded. The signal level set should be higher than that set for search A and less than or equal to the maximum signal level expected for the application. | |
Search Range B and Interval B | The range and interval (step size) of the step search (in mm). | |
Optimization Mode | The type of optimization to perform. Select from: | Full Optimization: A complete optimization including NanoTrak scan for max power. |
Stop Optimization Upon Threshold Signal: The optimization is stopped once the level of power found exceeds the threshold level set for the 2D scan. If no threshold level is set, a full 2D scan is performed. The system then moves to the position where max power was located. | ||
HWSerialNums | Enter the serial numbers of each APT unit in the system. | |
Load Position | Moves all the motors to the initial position. These are the safe positions where load or unload operations can be performed. The positions are measured in mm (or degrees) from the Home position. | |
Initial Position | The position of the motors immediately prior to the commencement of an optimization. The position is measured in mm (or degrees) from the Home position. | |
Home | Moves all motors to the Home position. | |
Load Position | Moves all motors to the initial position. | |
Optimize | Start button for the optimization. | |
Exit | Stops the current LabVIEW VI. To restart a VI, select 'Run' from the LabVIEW environment. | |
Intensity Map | Displays a graphical representation of the search results. | |
Motor Graphical Interface | Displays the GUI panel for the stepper motor controller unit whose serial number is selected in the HWSerialNums field. | |
NanoTrak® Graphical Interface | Displays the GUI panel for the NanoTrak unit whose serial number is selected in the HWSerialNums field. |
![4-Axis Optimization Flow Chart](https://www.thorlabs.de/images/tabimages/4-Axis_Optimization_Axes.gif)
4-Axis Optimization
This VI is useful for aligning two NanoMax stages, each along two axes. The figure to the right shows the breakdown of where each axis is located. 2D spiral search is performed on axes 1 and 2, and on axes 3 and 4, by the NanoStep motors. Once the initial (threshold) power is located, the power is optimized using the piezos, with revectoring as required. The tracking is performed simultaneously on 2 NanoTraks (set to different frequencies), one at each end of the device being aligned.
A zipped folder containing all of the advanced example VIs can be downloaded here.
Setting Up the NanoMax StageFor this example, we will set up a NanoMax Stage with two V-groove fiber holders as shown in the drawing below. The mechanical components are listed in the table to the right. The components that need alignment have been left out of the setup, since these will be user dependent. Connect the NanoMax stage to the PC as detailed in the handbook for your device.
![2-Axis Optimization Mechanical Setup](https://www.thorlabs.de/images/tabimages/4-Axis_Fiber_Alignment_A1-550.jpg)
Click to Enlarge
NanoMax stages set up for the 4-Axis Optomization VI. A complete list of item #'s is provided in the table to the right.
Item # | Description | Quantity |
---|---|---|
MAX301 or MAX302 | NanoMax-HS 3-Axis Stage | 2 |
DRV001 | NanoStep Actuator | 4 |
DRV3 | Differential Micrometer | 2 |
AMA029C | Fixed Platform | 1 |
HWV001 | Waveguide Mount with Vacuum Holddowna | 1 |
HFV002 | Tapered V-Groove Fiber Holdera | 1 |
BNT001/IR | APT NanoTrak® Controller | 2 |
BSC202 | APT Stepper Motor Controller | 2 |
4-Axis Optimization GUI
The 4-axis optimization VI GUI is shown to the right and a description of each field is provided in the table underneath. Instructions for running the GUI are as follows:
![APT 4-Axis Optimization](https://www.thorlabs.de/images/tabimages/4-Axis_Optimization_GUI.jpg)
- Ensure that your system is set up according to the instructions on the Getting Started tab.
- Power up the equipment.
- Open LabVIEW and run the file 4AxisOptimization.vi.
- Enter the serial numbers of the Stepper Motor and NanoTrak unit in your system.
- Enter values for the Threshold Range and Threshold Relative Signal applicable to your application, then check the Threshold box.
- Enter values for the Search Range and Search Interval applicable to your application.
- Enter values for the Load Position and Initial Position (the default values should be satisfactory for most applications).
- Click the
button to start communication between the software and the hardware.
- Click the Home button then wait for the motors to complete the homing movement.
- Click the Load Position button then wait for the motors to move to the load position.
- Load the devices to be aligned.
- Click the Initial Position button then wait for the motors to move to the initial position.
- Select the desired Optimization Mode and click the Optimize button to start the optimization sequence.
- If a power threshold is not located, adjust the Threshold Range and Threshold Relative Signal to a lower setting.
General Notes:
- During the alignment, the maximum signal level located and its associated position, are displayed in the Max Signal and Max Signal Position fields.
- After the alignment sequence is completed, the NanoTrak is set to `latch' mode.
- If a large value is set in the Search Range field, and/or a small value is set in the Search Interval field, it may take a long time to generate the scan coordinates. The actual time taken to generate the coordinates is dependent upon PC performance.
Field Name | Description | |
---|---|---|
Max Signal | Displays the maximum power located during the search. The power is displayed as a relative signal and a range value. | |
Max Signal Position | Displays the position at which the maximum power was located along each axis. | |
Threshold Range and Relative Signal |
The combination of these two settings determines the signal level to be located by the spiral search on axes 1 and 2. The search is terminated when the threshold level is exceeded. The signal level set should be higher than the noise floor to ensure the NanoTrak® does not track to a false power peak. | |
Search Range and Interval | The range and interval (step size) of the search pattern (in mm). | |
Optimization Mode | The type of optimization to perform. Select from: | Full Optimization: A complete optimization including NanoTrak scan for max power. |
Stop Optimization Upon Threshold Signal: The optimization is stopped once the level of power found exceeds the threshold level set for the 2D scan. If no threshold level is set, a full 2D scan is performed. The system then moves to the position where max power was located. | ||
HWSerialNums | Enter the serial numbers of each APT unit in the system. | |
Load Position | Moves all the motors to the initial position. These are the safe positions where load or unload operations can be performed. The positions are measured in mm (or degrees) from the Home position. | |
Initial Position | The position of the motors immediately prior to the commencement of an optimization. The position is measured in mm (or degrees) from the Home position. | |
Home | Moves all motors to the Home position. | |
Load Position | Moves all motors to the initial position. | |
Optimize | Start button for the optimization. | |
Exit | Stops the current LabVIEW VI. To restart a VI, select 'Run' from the LabVIEW environment. | |
Intensity Map | Displays a graphical representation of the search results. | |
Motor Graphical Interface | Displays the GUI panel for the stepper motor controller unit whose serial number is selected in the HWSerialNums field. | |
NanoTrak® Graphical Interface | Displays the GUI panel for the NanoTrak unit whose serial number is selected in the HWSerialNums field. |
6-Axis Optimization
This VI is useful for aligning two NanoMax stages, along 3 axes each, to a component in the middle. A 2D spiral search is performed on axis 1 and 2 and on axis 3 and 4 simultaneously. The NanoStep motors locate the initial (threshold) power; then the optimum power is located using the piezos, with revectoring as required. Once max power is located in axes 1, 2, 3, and 4, the power is further optimized by positioning in axis 5 and 6, while the positions along axes 1, 2, 3, and 4 are maintained by 'nudging' the NanoTrak.
The tracking is performed simultaneously on 2 NanoTraks (set to different frequencies), one at each end of the device being aligned. Similarly the nudging is performed on 4 axes to center the circle on both NanoTraks. The alignment is complete when the specified ceiling power is achieved.
A zipped folder containing all of the advanced example VIs can be downloaded here.
Setting Up the NanoMax StageFor this example, we will set up a NanoMax Stage with two V-groove fiber holders as shown in the drawing below. The mechanical components are listed in the table to the right. The components that need alignment have been left out of the setup, since these will be user dependent. Connect the NanoMax stage to the PC as detailed in the handbook for your device.
![6-Axis Optimization Mechanical Setup](https://www.thorlabs.de/images/tabimages/6-Axis_Fiber_Alignment_A1-550.jpg)
Click to Enlarge
NanoMax stages set up for the 6-Axis Optomization VI. A complete list of item #'s is provided in the table to the right.
Item # | Description | Quantity |
---|---|---|
MAX301 or MAX302 | NanoMax-HS 3-Axis Stage | 2 |
DRV001 | NanoStep Actuator | 6 |
AMA029C | Fixed Platform | 1 |
HWV001 | Waveguide with Vacuum Holddowna | 1 |
HFV002 | Tapered V-Groove Fiber Holdera | 2 |
HFC005 | Standard Fiber Chuck | 1 |
BNT001/IR | APT NanoTrak® Controller | 2 |
BSC202 | APT Stepper Motor Controller | 2 |
6-Axis Optimization GUI
The 6-axis optimization VI GUI is shown to the right and a description of each field is provided in the table underneath. Instructions for running the GUI are as follows:
![APT 6-Axis Optimization](https://www.thorlabs.de/images/tabimages/6-Axis_Optimization_GUI.jpg)
- Ensure your system is set up according to the instructions given on the Getting Started tab.
- Power up the equipment.
- Open LabVIEW and run the 6AxisOptimization.vi file.
- Enter the serial numbers of the Stepper Motor and NanoTrak unit in your system.
- Enter values for the Threshold Range A and Threshold Relative Signal A applicable to your application, then check the Threshold box.
- Enter values for the Search Range A and Search Interval A applicable to your application.
- Enter values for the Threshold Range B and Threshold Relative Signal B applicable to your application, then check the Threshold box.
- Enter values for the Search Range B and Search Interval B applicable to your application.
- Enter values for the Load Position and Initial Position (the default values should be satisfactory for most applications).
- Click the
button to start communication between the software and the hardware.
- Click the Home button then wait for the motors to complete the homing movement.
- Click the Load Position button then wait for the motors to move to the load position.
- Load the devices to be aligned.
- Click the Initial Position button then wait for the motors to move to the initial position.
- Select the desired Optimization Mode and click the Optimize button to start the optimization sequence.
- If a power threshold is not located, adjust the Threshold Range A and Threshold Relative Signal A to a lower setting.
General Notes:
- During the alignment, the maximum signal level located and its associated position, are displayed in the Max Signal and Max Signal Position fields.
- After the alignment sequence is completed, the NanoTrak is set to `latch' mode.
- If a large value is set in the Search Range field, and/or a small value is set in the Search Interval field, it may take a long time to generate the scan coordinates. The actual time taken to generate the coordinates is dependent upon PC performance.
Field Name | Description | |
---|---|---|
Max Signal | Displays the maximum power located during the search. The power is displayed as a relative signal and a range value. | |
Max Signal Position | Displays the position at which the maximum power was located. | |
Threshold Range A and Relative Signal A |
The combination of these two settings determines the signal level to be located by the spiral search on axes 1 and 2. The search is terminated when the threshold level is exceeded. The signal level set should be higher than the noise floor to ensure the NanoTrak® does not track to a false power peak. | |
Search Range A and Interval A | The range and interval (step size) of the search pattern (in mm). | |
Threshold Range B and Relative Signal B |
The combination of these two settings determines the signal level to be located by the step search on axis 3. The search is terminated when the threshold level is exceeded. The signal level set should be higher than that set for search A and less than or equal to the maximum signal level expected for the application. | |
Search Range B and Interval B | The range and interval (step size) of the step search (in mm). | |
Optimization Mode | The type of optimization to perform. Select from: | Full Optimization: A complete optimization including NanoTrak scan for max power. |
Stop Optimization Upon Threshold Signal: The optimization is stopped once the level of power found exceeds the threshold level set for the 2D scan. If no threshold level is set, a full 2D scan is performed. The system then moves to the position where max power was located. | ||
HWSerialNums | Enter the serial numbers of each APT unit in the system. | |
Load Position | Moves all the motors to the initial position. These are the safe positions where load or unload operations can be performed. The positions are measured in mm (or degrees) from the Home position. | |
Initial Position | The position of the motors immediately prior to the commencement of an optimization. The position is measured in mm (or degrees) from the Home position. | |
Home | Moves all motors to the Home position. | |
Load Position | Moves all motors to the initial position. | |
Optimize | Start button for the optimization. | |
Exit | Stops the current LabVIEW VI. To restart a VI, select 'Run' from the LabVIEW environment. | |
Intensity Map | Displays a graphical representation of the search results. | |
Motor Graphical Interface | Displays the GUI panel for the stepper motor controller unit whose serial number is selected in the HWSerialNums field. | |
NanoTrak® Graphical Interface | Displays the GUI panel for the NanoTrak unit whose serial number is selected in the HWSerialNums field. |
![MATLAB ActiveX Control](https://www.thorlabs.de/images/tabimages/APT_MATLAB_ActiveX_400.jpg)
Accessing an ActiveX Control in MATLAB
The APT System Software is implemented as a set of ActiveX controls that are added to the host PC control library when the APT Software is installed. These ActiveX controls typically have a user interface, which can be interacted with using one of several programming environments. The ability to use the controls within multiple programming environments is facilitated through the Microsoft® Component Object Model (COM), which is a binary-interface standard for implementing objects that can be used in an environment different from the one in which they are created; i.e., it allows objects to be reused without knowledge of their internal implementation. A Microsoft ActiveX control is a type of in-process COM server that requires a control container, which is an application capable of hosting ActiveX controls. Programming environments and languages such as MATLAB®, Visual C++, and C# can be used to create these control containers, thus allowing users to interact with the ActiveX controls for their own applications.
MATLAB®
A MATLAB figure window or a Simulink® model are types of control containers. In a typical scenario, MATLAB creates ActiveX controls in figure windows, which are manipulated by MATLAB through the controls’ properties, methods, and events. In this case, Thorlabs' APT ActiveX control is used as the server and MATLAB is used as the client. Graphical user interface (GUI) components are implemented as APT ActiveX controls. By creating an ActiveX object, MATLAB can control the hardware using the APT GUI components. For more details on using MATLAB and ActiveX controls with Thorlabs' APT positioners, click here.
Visual C++
Simply create a new C++ project for your application, display the main application dialog box, and select the required APT ActiveX controls from the library displayed. For more information, the videos below demonstrate how to get an APT ActiveX control running within Visual C++ and how to program a custom positioning sequence.
C#
Examples are available that contain sample programs to get started using the APT Server with C#. The use of each ActiveX control is demonstrated in an example project file, which can be opened in Visual Studio or another similar development package. The examples are split into four sections dependent on the control with which they are associated: Motor, NanoTrack®, Piezo, and Quad Detector. Examples can be downloaded here.
Posted Comments: | |
Hashim Ali
 (posted 2024-02-01 19:06:59.117) Hi. I am trying to make labview program for nanomax 300 with APT Piezo controller BPC 203. I want to move my sample along lateral and axial axis using labview. Could you send me the exact labview program for nanomax 300. do'neill
 (posted 2024-02-13 06:03:30.0) Thank you for reaching out. I will contact you directly with an example and to help with your application. Daniel E
 (posted 2023-01-24 05:26:11.433) Hi. I am interested in creating a GUI interface with Labview to control 3 devices: 1 LTS and 2 KDC 101. The KDCs will use Z825B Stepper Motors to move each stage along X and Y axis.
I will like to know if the Motor2DScan.vi can be used to implement that and if yes, how do I configure it? JReeder
 (posted 2023-01-25 11:34:00.0) Thanks for your enquiry. The example VIs such as Motor2DScan.vi are to enable you to get started with the functions and provide you with a starting point so you can get set up for your specific application quicker. The Motor2DScan VI shows a basic 2D raster scan using two motor controllers, not three. However adding in a third controller is the same as adding in a second controller, which this VI shows how to do. In order to get these examples configured, you will need to have installed the APT software and you will need to change the serial numbers to those of your devices. I would advise that you read through our documentation on how to set up these controls up in LabVIEW, further information can be found here: https://www.thorlabs.de/images/TabImages/GuideToLabVIEWandAPT.pdf Simon S.
 (posted 2021-07-27 10:12:48.23) It seems like for the Linear Travel Stages the StartCtrl outputs a 0 (not indicating an error) even if the stage is not connected to the PC. I followed the guide on error handling and also had a look at the Basic and Intermediate Example VIs you kindly made available.
Because the method StartCtrl does not indicate an error, I wonder how can I catch the exception and avoid runtime-errors?
Thank you! DJayasuriya
 (posted 2021-07-29 05:17:10.0) Thank you for your inquiry. We will get in touch with you directly to resolve your issue. Dmytro Afanasiev
 (posted 2021-05-31 17:05:33.28) I have an issue with the programming APT LabView interface. Actually it works fine with a single motor but once I run two instances of the APT interfaces it crashes giving me a lot of errors. Can I actually in one LabView .vi control two devices and if it is so than how?
Thanks a lot for your answer! jcater
 (posted 2021-06-02 07:10:15.0) Response from Jack at Thorlabs: Thank you for your feedback. You can use APT in LabVIEW to control multiple devices at once. You can create an ActiveX control for each individual device to control them individually, I will reach out to you with an example of how to do this. Emily R
 (posted 2021-02-04 17:55:02.713) Hi, I'm using the MFF101 with LabVIEW and every time I run my code, LabVIEW crashes. I saw another comment which stated LabVIEW would crash if IChanID was not set to 0, but this happens as soon at it reaches the "StartCtrl" property node, before IChanID is even specified. Previously, I was able to control the flipper with the ATP User application, but now ATP User does not load up at all while the flipper is connected to my computer. If I disconnect the flipper, ATP User loads up fine. cwright
 (posted 2021-02-05 11:12:19.0) Response from Charles at Thorlabs: Thank you for contacting us. We will reach out to you directly to help troubleshoot this. Gayatri Vasudevan Rajeswari
 (posted 2020-12-07 18:00:33.017) I would like to align fiber to the photonic integrated circuit using BNT001/IR stage. I wanted to program in LABVIEW to move to the desired position automatically using APT module. Initially, I was planning to use APT Active X MG17Nanotrak to achieve this, but later I found it out that the MG17 Nanotrak does not have an inbuilt 'move' function to move the piezo actuator to the desired position. So I thought of MG17Piezo ActiveX for this, but I am not able to achieve proper communication between the software and hardware. Kindly let me know does MG17 Piezo ActiveX be communicated to BNT001/IR device. If not please suggest an alternative way to achieve it. cwright
 (posted 2020-12-09 04:42:16.0) Response from Charles at Thorlabs: Thank you for your query. To communicate with the BNT001/IR one must use the MG17NanoTrack control, there is no 'move' command with the BNT001/IR as this is designed for an auto-alignment system. The piezo actuators will use the MG17Piezo control and the Piezo Inertial motors will use the MG17PZMotor control. To set the output voltage on the piezo actuator you can use the SetVoltOutput method. Setting the NanoTrack to 'Track' using the Track() function will automatically control the output voltage for the piezo actuators. Edit: it appears this request was misunderstood. The correct method to take is to use the SetCircHomePos method on the MG17NanoTrack control to move the circle around and hence set the piezo outputs. You should Latch the NanoTrak before doing this. xinxin xing
 (posted 2020-10-30 13:24:03.727) Hi, I'm using KDC101 on LabVIEW 2017 (64-bit windows). I have two Z825B Stepper Motors and I need to move the stage in raster scan (one motor along X and other along Y) like X stage will move 8 mm while Y waits then Y moves for 0.5 mm then the process repeats until a specified area (e.g 64 mm^2) is covered. When I try to use the Motor2DScan.vi example download from Thorlabs, LabVIEW breaks down. Then I have to reinstall the LabVIEW software. It happens several times. Is that a problem with LabVIEW or with the controller? thanks for your help. cwright
 (posted 2020-11-04 03:10:17.0) Response from Charles at Thorlabs: Hello and thank you for your query. While we have previously encountered an error which caused LabVIEW to crash, we have not heard of one which causes it to require reinstallation. We will reach out to you to get the details of your APT installation and to troubleshoot this with you. Update: The issue in this case was using the wrong channel number for the parameter "lChanID - the channel identifier". This channel ID should be 0 for single motor controllers. Spencer Nelson
 (posted 2020-10-29 17:33:57.73) I'm interfacing to the APT ActiveX controller with LabWindows/CVI. In debug mode, I get an intermittent "Fatal Run-Time Error. Unknown source position, thread id 0x00002C48 A non-debuggable tread caused a 'General Protection"' fault at address 0x590AEF90." Was occurring occasionally, but now at least 4 out of 5 times after a power cycle on the linear stage. Any help would be appreciated. Thanks. cwright
 (posted 2020-11-03 05:01:24.0) Response from Charles at Thorlabs: Hello Spencer and thank you for your query. While we have not been approached with this error before, and do not have any experience running LabWindows, we can see that this error has arisen and been addressed by NI. It appears to be an issue with how some versions of LabWindows load controls. We will reach out to you to discuss this and see if it solves your issue. Angeliki Vavladeli
 (posted 2020-08-03 05:30:50.23) I am using Thorlabs APT software through LabVIEW, to control a stepper motor (3 channels BSC203). For this purpose, I had referred to Thorlabs' Guide to LabVIEW and APT. My project requires me to use APT with certain settings as default, therefore I need to modify the default settings. While it is possible to "save” and ''load’' the settings as a template in the APT software, I am not able to access this file (no prompt window appears to see filepath) in order to apply the same APT settings through LabVIEW, or to save settings through APT LAbVIEW program.
Do you know where this settings file is most likely located in my PC?
Or do you know how I can change and save/load APT settings through LabVIEW? DJayasuriya
 (posted 2020-08-05 10:21:06.0) Thank you for your inquiry. You would be able to save the settings in APT and they get saved into the registry. The location its saved into is: Thorlabs >APT server> User. Please get in touch with us if directly if you have any have any questions. Wenquan Liu
 (posted 2020-05-21 20:40:35.507) Hi, I am using a KBD101 to control a DDSM100(/M) stage through the LabView 2009 (fairly old, and the OS is Windows XP). Could you provide us with the APT 32-Bit Software for 32-Bit Windows XP system? Thanks a lot. DJayasuriya
 (posted 2020-05-22 03:48:44.0) Thank you for your inquiry. Please have a look at this link to find APT 32-Bit Software for 32-Bit Windows:https://www.thorlabs.com/software_pages/ViewSoftwarePage.cfm?Code=Motion_Control&viewtab=0
If you have any other questions you can reach your local techsupport team on techsupport-cn@thorlabs.com DJayasuriya
 (posted 2020-05-22 03:48:44.0) Thank you for your inquiry. Please have a look at this link to find APT 32-Bit Software for 32-Bit Windows:https://www.thorlabs.com/software_pages/ViewSoftwarePage.cfm?Code=Motion_Control&viewtab=0
If you have any other questions you can reach your local techsupport team on techsupport-cn@thorlabs.com Victor de Bar
 (posted 2020-05-01 09:26:43.02) Hello Thorlabs,
Is it possible to simulate the Thorlabs Kinesis hardware in LabVIEW, is there a manual for this?
I know there is a Kinesis simulator tool but I cannot connect to the simulator through LabVIEW.
Unfortunately I do not have acces to the hardware at the moment so it would be really nice to check the code with the simulator.
I am using Kcube Stepper controller, Thorlabs, KST101 and a Microstepper stage, Thorlabs, LNR25ZFS
Kind regards,
Victor DJayasuriya
 (posted 2020-05-04 04:00:46.0) Thank you for your inquiry. Yes we do have a simulator that works with Labview. I will get in touch with you directly to resolve your issue. 15652586760
 (posted 2019-03-08 10:00:46.69) Hello, our LabView MG17motor's number is 123456 which is different from the number on the hardware . So the LabView cannot work even as the instructions you give. I hope you can give me some advice, thanks. rmiron
 (posted 2019-03-12 08:47:00.0) Response from Radu at Thorlabs: This probably means that the stage's EEPROM has not been correctly programmed, in which case I apologise on behalf of Thorlabs. If that is the situation, you would simply have to set the serial number property in LabVIEW to 123456. I will contact you directly to check whether that is indeed the case and to help you run your virtual instrument. protap.mahanta
 (posted 2019-02-06 12:46:20.31) Hi, I am trying to control Thorlab's BPC 303 controller using Labview. I am following the manual's guide to accomplish it, however, it shows the following error message:
A software call has been made to a control which is not currently communicating with any hardware! This may be because the control has not been started or wrong serial number or missing hardware!
I checked the controller is powered on, connected, serial no is right...Now, what should i cehck? Thanks! rmiron
 (posted 2019-02-07 05:36:52.0) Response from Radu at Thorlabs: This error can indicate that there are problems with the USB communication, or that the nodes are not called in the correct order. Your local tech support team will help you troubleshoot your application if you send them over a screenshot of your VI. They might also be interested in which node raises the error and in whether the controller is visible in Device Manager. pmillho
 (posted 2018-11-21 14:15:20.64) Hi there,
I'm wondering what version of LabVIEW (32-bit or 64-bit) your APT motor controller software works with?
We are using LTS300 and LTS150 stages, can these be controlled using 64-bit LabVIEW?
Thanks! rmiron
 (posted 2018-11-22 05:57:52.0) Response from Radu at Thorlabs: APT must have the same bit-version as LabVIEW in order for the provided ActiveX Controls to be successfully inserted in a VI. Therefore, you require a 64-bit version of APT. arne
 (posted 2018-10-09 13:48:16.167) Hi there,
I need to address and control Thorlabs "Rotation Stage with Resonant Piezoelectric Motor" ELL8K/M with LabVIEW. Is it possible to use the VIs provided here for a start. And which one would be the best. I guess the Piezo VIs, isn't it?
Thank you very much and best regard from the very south of Germany,
Arne Lüker, Ph.D. rmiron
 (posted 2018-10-12 10:01:17.0) Response from Radu at Thorlabs: Thank you for raising this question Arne. It is possible to control Elliptec device from LabVIEW, but not through our APT or Kinesis software packages. You require the Elliptec software for this. Furthermore, because we have yet to release a 32-bit for 64-bit OS version of Elliptec, the bit-version of LabVIEW needs to match the bit-version of your OS. At the moment we don't have any tutorials on the website for how to use the Elliptec .NET assembly. We are looking to add some in the near future. I will contact you directly in order to provide you with a suitable example VI. s.j.goodband
 (posted 2018-09-24 09:15:28.923) Hi,
I am using a KDC101 to control a Z825B stage.
I have written a labview script which gets the motor to step forward at a known speed (and known step size) - but I can't find a way to get it to step back as it won't allow negative steps. Can you think of any way to do this? rmiron
 (posted 2018-09-24 11:35:47.0) Response from Radu at Thorlabs: I will contact you directly in order to offer assistance. I think the solution lies in using MoveRelative() methods instead of Jog(). shenwb
 (posted 2018-08-03 21:24:13.66) Hi,
I am using Thorlabs KDC101 to control MTS50. How could I change the parameter like loop times and step length in your intermediate VIs examples?
Thank you! rmiron
 (posted 2018-08-06 10:43:09.0) Response from Radu at Thorlabs: If you look into the block diagram, you will see two controls labelled "Scale" and "Num of Steps". If you right-click on them and choose the "Show Control" option, they will reveal themselves on the front panel. By changing the value fed into "Scale" you will change the step length and by changing the value taken by "Num of Steps" you will change the loop times. I will contact you directly in case further assistance is required. djoyce
 (posted 2018-06-11 15:24:28.997) Have a Thorlabs nano rotation stage on a BSC201. I also have LabView 8.5-- fairly old (10 yr)
The LabView software won't seem to load the motor control-- a big blank area appears.
Is the LabView version too old? rmiron
 (posted 2018-06-15 07:24:48.0) Response from Radu at Thorlabs: Unless you already configured LabVIEW to use the 4.0 version of the Common Language Runtime, this behaviour is to be expected. In order to fix this issue, I suggest you follow the steps listed here: https://knowledge.ni.com/KnowledgeArticleDetails?id=kA00Z0000019LDcSAM
If adding that configuration file does not fix the problem, you might have compatibility issues because your operating system is too new. According to National Instruments, Windows Vista is the latest OS which is compatible with LabVIEW 8.5. peatkinson2
 (posted 2018-04-23 09:29:10.417) Hi,
I have a Thorlabs stepper motor K10CR1 and I'm trying to run it in labview. In APT User I can control the position accuracy to 0.01 degrees however using Active X to operate the motor in labview and the basic "move relative" and "move absolute" I am only able to control the position to the nearest degree? How might this be overcome in my labview programming?
Kind regards,
Peggy Atkinson (assistant researcher Lund University) rmiron
 (posted 2018-04-26 06:01:11.0) Response from Radu at Thorlabs: Dear Peggy, I am surprised to hear this given that the MoveAbsoluteRot and the SetAbsMovePos methods are meant to take real numbers as parameters specifying the position. The same applies to relative movements. Perhaps the numeric controls that you use to feed those parameters have integer representations. If that is the case, then right-clicking on them and selecting Representations\Double Precision, should fix this issue. If that is not the case, please contact one of our technical support teams. runarplu
 (posted 2017-01-20 04:35:38.513) Hi,
I have a Thorlabs stepper motor and the BSC103 controller currently running on the 32bit APT-software. I am using the sequencer and it works just fine. One question though:
- Is there an easy way to import the stage-position from this software directly into LabView without making a VI for the stage (https://www.thorlabs.com/images/TabImages/GuideToLabVIEWandAPT.pdf)?
- Can the stage movement history easily be logged in a .txt-file (updates continuously as new positions occur)?
Best regards
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Runar P. Dahl-Hansen
PhD Candidate
Dept. of Electronics and Telecom.
Norwegian University of Science and Technology (NTNU)
Trondheim, Norway
Mobile: +47 926 54821
www.ntnu.no
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . bhallewell
 (posted 2017-02-01 06:26:20.0) Response from Ben at Thorlabs: Thank you for your question here. An ActiveX object will need to be added into your VI in order to make use of the ActiveX methods which will control & enable you to access information from the stage. When you add in the ActiveX object, a GUI is built. It is possible to grey out & re-size this UI & title font within LabVIEW Front Panel however this unfortunately needs to exist. In terms of outputting positions to a text file, this can be done through use of the 'Write to Text File' function from the Programming > 'File I/O' palette within the LabVIEW block diagram. Through use of an iterative loop, you can open a text file, within each iteration write to text file, what is output from the GetPosition method. Some of the following may be of use to you.
https://www.thorlabs.com/images/TabImages/GuideToLabVIEWandAPT.pdf
https://zone.ni.com/reference/en-XX/help/371361H-01/glang/write_characters_to_file/
https://forums.ni.com/t5/LabVIEW/how-continuously-write-data-to-a-txt-file/td-p/1846549 |