pax1000-controller 0.0.1

A library to controlle the Thorlabs PAX1000 polarimeter

PAX1000-controller

Python wrapper for the Thorlabs PAX1000 polarimeter using ctypes and the official Thorlabs TLPAX DLL. It provides a minimal, direct interface for device initialization, configuration, and polarization measurements.

The creator of this package/repository is not affiliated with ThorLabs.

---

Features

• Automatic detection of connected PAX1000 devices
• Configuration of wavelength, scan rate, and measurement mode
• Single-shot polarization measurements
• Access to:
  • Azimuth
  • Ellipticity
  • Full Stokes parameters (S0–S3)
  • Degree of polarization (DoP)
  • Degree of linear polarization (DoLP)
  • Degree of circular polarization (DoCP)

---

Requirements

• Windows (64-bit)
• Python 3
• Thorlabs PAX1000 polarimeter
• Thorlabs VISA installation
• Thorlabs TLPAX DLL

Default DLL path used in the code:

C:\Program Files\IVI Foundation\VISA\Win64\Bin\TLPAX_64.dll

Python standard libraries used:

• ctypes
• time
• math
• copy

---

Installation

pip install pax1000_controller

---

Usage

Basic Example

from pax1000 import PAX1000

pax = PAX1000(
    wavelength=491e-9,
    scan_rate=60,
    measurement_mode=9
)

data = pax.measure()
print(data)

pax.close()

---

Class: PAX1000

Constructor

PAX1000(wavelength=491e-9, scan_rate=60, measurement_mode=9)

Parameters:

• wavelength (float): Measurement wavelength in meters
• scan_rate (float): Scan rate in Hz
• measurement_mode (int): PAX1000 measurement mode

The constructor:

• Searches for connected PAX1000 devices
• Connects to the first available device
• Applies the provided configuration

---

measure()

Performs a single polarization measurement.

Returns:

{
    "azimuth": float,        # degrees
    "ellipticity": float,    # degrees
    "S0": float,
    "S1": float,
    "S2": float,
    "S3": float,
    "dop": float,            # degree of polarization
    "dolp": float,           # degree of linear polarization
    "docp": float            # degree of circular polarization
}

---

close()

Closes the connection to the device and releases all resources.

pax.close()

---

Exceptions

• DeviceNotFound
  Raised if no PAX1000 device is detected.

• InitialisationError
  Raised if device initialization fails.

---

Notes

• Only the first detected PAX1000 device is used.
• Returned values are deep-copied to avoid side effects from reused ctypes objects.
• Based on the official Thorlabs ctypes example, adapted for Python 3.