Thorlabs offers two platforms to drive our wide range of motion controllers: our Kinesis^® software package or the legacy APT™ (Advanced Positioning Technology) software package. Either package can be used to control devices in the Kinesis family, which covers a wide range of motion controllers ranging from small, low-powered, single-channel drivers (such as the K-Cubes™ and T-Cubes™) to high-power, multi-channel, modular 19" rack nanopositioning systems (the APT Rack System).

The Kinesis Software features .NET controls which can be used by 3rd party developers working in the latest C#, Visual Basic, LabVIEW™, or any .NET compatible languages to create custom applications. Low-level DLL libraries are included for applications not expected to use the .NET framework. A Central Sequence Manager supports integration and synchronization of all Thorlabs motion control hardware.

Kinesis GUI Screen

APT GUI Screen

Our legacy APT System Software platform offers ActiveX-based controls which can be used by 3rd party developers working on C#, Visual Basic, LabVIEW™, or any Active-X compatible languages to create custom applications and includes a simulator mode to assist in developing custom applications without requiring hardware.

By providing these common software platforms, Thorlabs has ensured that users can easily mix and match any of the Kinesis and APT controllers in a single application, while only having to learn a single set of software tools. In this way, it is perfectly feasible to combine any of the controllers from single-axis to multi-axis systems and control all from a single, PC-based unified software interface.

The software packages allow two methods of usage: graphical user interface (GUI) utilities for direct interaction with and control of the controllers 'out of the box', and a set of programming interfaces that allow custom-integrated positioning and alignment solutions to be easily programmed in the development language of choice.

A range of video tutorials is available to help explain our APT system software. These tutorials provide an overview of the software and the APT Config utility. Additionally, a tutorial video is available to explain how to select simulator mode within the software, which allows the user to experiment with the software without a controller connected. Please select the APT Tutorials tab above to view these videos.

Software

Kinesis Version 1.14.36

The Kinesis Software Package, which includes a GUI for control of Thorlabs' Kinesis and APT™ system controllers.

Also Available:

• Communications Protocol

Software

APT Version 3.21.5

The APT Software Package, which includes a GUI for control of Thorlabs' APT™ and Kinesis system controllers.

Also Available:

• Communications Protocol

Thorlabs' Kinesis^® software features new .NET controls which can be used by third-party developers working in the latest C#, Visual Basic, LabVIEW™, or any .NET compatible languages to create custom applications.

C#
This programming language is designed to allow multiple programming paradigms, or languages, to be used, thus allowing for complex problems to be solved in an easy or efficient manner. It encompasses typing, imperative, declarative, functional, generic, object-oriented, and component-oriented programming. By providing functionality with this common software platform, Thorlabs has ensured that users can easily mix and match any of the Kinesis controllers in a single application, while only having to learn a single set of software tools. In this way, it is perfectly feasible to combine any of the controllers from the low-powered, single-axis to the high-powered, multi-axis systems and control all from a single, PC-based unified software interface.

The Kinesis System Software allows two methods of usage: graphical user interface (GUI) utilities for direct interaction and control of the controllers 'out of the box', and a set of programming interfaces that allow custom-integrated positioning and alignment solutions to be easily programmed in the development language of choice.

For a collection of example projects that can be compiled and run to demonstrate the different ways in which developers can build on the Kinesis motion control libraries, click on the links below. Please note that a separate integrated development environment (IDE) (e.g., Microsoft Visual Studio) will be required to execute the Quick Start examples. The C# example projects can be executed using the included .NET controls in the Kinesis software package (see the Kinesis Software tab for details).

Click Here for the Kinesis with C# Quick Start Guide Click Here for C# Example Projects Click Here for Quick Start Device Control Examples

LabVIEW
LabVIEW can be used to communicate with any Kinesis- or APT-based controller via .NET controls. 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, provided below, provides some information on using the .NET controls to create control GUIs for Kinesis- and APT-driven devices within LabVIEW. It includes an overview with basic information about using controllers in LabVIEW and explains the setup procedure that needs to be completed before using a LabVIEW GUI to operate a device.

Click Here to View the LabVIEW Guide Click Here to View the Kinesis with LabVIEW Overview Page

The APT video tutorials available here fall into two main groups - one group covers using the supplied APT utilities and the second group covers programming the APT System using a selection of different programming environments.

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.

Every APT controller is supplied with the utilities APTUser and APTConfig. APTUser provides a quick and easy way of interacting with the APT control hardware using intuitive graphical control panels. APTConfig is an 'off-line' utility that allows various system wide settings to be made such as pre-selecting mechanical stage types and associating them with specific motion controllers.

APT User Utility

The first video below gives an overview of using the APTUser Utility. The OptoDriver single channel controller products can be operated via their front panel controls in the absence of a control PC. The stored settings relating to the operation of these front panel controls can be changed using the APTUser utility. The second video illustrates this process.

APT Config Utility

There are various APT system-wide settings that can be made using the APT Config utility, including setting up a simulated hardware configuration and associating mechanical stages with specific motor drive channels. The first video presents a brief overview of the APT Config application. More details on creating a simulated hardware configuration and making stage associations are present in the next two videos.

APT Programming

The APT Software System is implemented as a collection of ActiveX Controls. ActiveX Controls are language-independant software modules that provide both a graphical user interface and a programming interface. There is an ActiveX Control type for each type of hardware unit, e.g. a Motor ActiveX Control covers operation with any type of APT motor controller (DC or stepper). Many Windows software development environments and languages directly support ActiveX Controls, and, once such a Control is embedded into a custom application, all of the functionality it contains is immediately available to the application for automated operation. The videos below illustrate the basics of using the APT ActiveX Controls with LabVIEW, Visual Basic, and Visual C++. Note that many other languages support ActiveX including LabWindows CVI, C++ Builder, VB.NET, C#.NET, Office VBA, Matlab, HPVEE etc. Although these environments are not covered specifically by the tutorial videos, many of the ideas shown will still be relevant to using these other languages.

Visual Basic

Part 1 illustrates how to get an APT ActiveX Control running within Visual Basic, and Part 2 goes on to show how to program a custom positioning sequence.

LabVIEW

Full Active support is provided by LabVIEW and the series of tutorial videos below illustrate 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.

The following tutorial videos illustrate alternative ways of creating Method and Property nodes:

Visual C++

Part 1 illustrates how to get an APT ActiveX Control running within Visual C++, and Part 2 goes on to show how to program a custom positioning sequence.

MATLAB

For assistance when using MATLAB and ActiveX controls with the Thorlabs APT positioners, click here.

To further assist programmers, a guide to programming the APT software in LabVIEW is also available here.

Laser Safety and Classification

Safe practices and proper usage of safety equipment should be taken into consideration when operating lasers. The eye is susceptible to injury, even from very low levels of laser light. Thorlabs offers a range of laser safety accessories that can be used to reduce the risk of accidents or injuries. Laser emission in the visible and near infrared spectral ranges has the greatest potential for retinal injury, as the cornea and lens are transparent to those wavelengths, and the lens can focus the laser energy onto the retina. 

Safe Practices and Light Safety Accessories

• Laser safety eyewear must be worn whenever working with Class 3 or 4 lasers.
• Regardless of laser class, Thorlabs recommends the use of laser safety eyewear whenever working with laser beams with non-negligible powers, since metallic tools such as screwdrivers can accidentally redirect a beam.
• Laser goggles designed for specific wavelengths should be clearly available near laser setups to protect the wearer from unintentional laser reflections.
• Goggles are marked with the wavelength range over which protection is afforded and the minimum optical density within that range.
• Laser Safety Curtains and Laser Safety Fabric shield other parts of the lab from high energy lasers.
• Blackout Materials can prevent direct or reflected light from leaving the experimental setup area.
• Thorlabs' Enclosure Systems can be used to contain optical setups to isolate or minimize laser hazards.
• A fiber-pigtailed laser should always be turned off before connecting it to or disconnecting it from another fiber, especially when the laser is at power levels above 10 mW.
• All beams should be terminated at the edge of the table, and laboratory doors should be closed whenever a laser is in use.
• Do not place laser beams at eye level.
• Carry out experiments on an optical table such that all laser beams travel horizontally.
• Remove unnecessary reflective items such as reflective jewelry (e.g., rings, watches, etc.) while working near the beam path.
• Be aware that lenses and other optical devices may reflect a portion of the incident beam from the front or rear surface.
• Operate a laser at the minimum power necessary for any operation.
• If possible, reduce the output power of a laser during alignment procedures.
• Use beam shutters and filters to reduce the beam power.
• Post appropriate warning signs or labels near laser setups or rooms.
• Use a laser sign with a lightbox if operating Class 3R or 4 lasers (i.e., lasers requiring the use of a safety interlock).
• Do not use Laser Viewing Cards in place of a proper Beam Trap.

Laser Classification

Lasers are categorized into different classes according to their ability to cause eye and other damage. The International Electrotechnical Commission (IEC) is a global organization that prepares and publishes international standards for all electrical, electronic, and related technologies. The IEC document 60825-1 outlines the safety of laser products. A description of each class of laser is given below:

Class	Description	Warning Label
1	This class of laser is safe under all conditions of normal use, including use with optical instruments for intrabeam viewing. Lasers in this class do not emit radiation at levels that may cause injury during normal operation, and therefore the maximum permissible exposure (MPE) cannot be exceeded. Class 1 lasers can also include enclosed, high-power lasers where exposure to the radiation is not possible without opening or shutting down the laser.
1M	Class 1M lasers are safe except when used in conjunction with optical components such as telescopes and microscopes. Lasers belonging to this class emit large-diameter or divergent beams, and the MPE cannot normally be exceeded unless focusing or imaging optics are used to narrow the beam. However, if the beam is refocused, the hazard may be increased and the class may be changed accordingly.
2	Class 2 lasers, which are limited to 1 mW of visible continuous-wave radiation, are safe because the blink reflex will limit the exposure in the eye to 0.25 seconds. This category only applies to visible radiation (400 - 700 nm).
2M	Because of the blink reflex, this class of laser is classified as safe as long as the beam is not viewed through optical instruments. This laser class also applies to larger-diameter or diverging laser beams.
3R	Class 3R lasers produce visible and invisible light that is hazardous under direct and specular-reflection viewing conditions. Eye injuries may occur if you directly view the beam, especially when using optical instruments. Lasers in this class are considered safe as long as they are handled with restricted beam viewing. The MPE can be exceeded with this class of laser; however, this presents a low risk level to injury. Visible, continuous-wave lasers in this class are limited to 5 mW of output power.
3B	Class 3B lasers are hazardous to the eye if exposed directly. Diffuse reflections are usually not harmful, but may be when using higher-power Class 3B lasers. Safe handling of devices in this class includes wearing protective eyewear where direct viewing of the laser beam may occur. Lasers of this class must be equipped with a key switch and a safety interlock; moreover, laser safety signs should be used, such that the laser cannot be used without the safety light turning on. Laser products with power output near the upper range of Class 3B may also cause skin burns.
4	This class of laser may cause damage to the skin, and also to the eye, even from the viewing of diffuse reflections. These hazards may also apply to indirect or non-specular reflections of the beam, even from apparently matte surfaces. Great care must be taken when handling these lasers. They also represent a fire risk, because they may ignite combustible material. Class 4 lasers must be equipped with a key switch and a safety interlock.
All class 2 lasers (and higher) must display, in addition to the corresponding sign above, this triangular warning sign.