Python API
Overview
The python API can be used:
- directly in the system console, using a general python interpret
- in the Pixet program integrated python console
The base is pypixet object. It has methods for initialize and deinitialize, can create the pixet object.
The pixet object have device list, can create device objects and allows access to global properties.
A device objects have methods for acquisions and allows access to device parameters.
The pypxproc object is intended for use to processing of a data.
The pygui object allows you to create your own graphical interface. It can be used only if a script is run from the Pixet program.
Small code example for using in the system console or other third-party environment, with the Python 3.7.9 (With all auxilliary files in the directory with the script):
import pypixet
print("pixet core init...")
pypixet.start()
pixet=pypixet.pixet
devices = pixet.devicesByType(pixet.PX_DEVTYPE_TPX3)
dev = devices[0]
dev.setOperationMode(pixet.PX_TPX3_OPM_EVENT_ITOT)
print("dev.doSimpleAcquisition (3 frames @ 1 sec) - start")
rc = dev.doSimpleAcquisition(3, 1, pixet.PX_FTYPE_AUTODETECT, "example.png")
print("dev.doSimpleAcquisition - end:", rc, "(0 is OK)")
pixet.exitPixet() # save settings, correct stop devices and core exit
pypixet.exit() # both lines important if third-party debug environment used
Small code example for using in the system console or other third-party environment, with the Python 3.7.9 (With all auxilliary files in other directory, the Pixet directory for example):
PIXETDIR="C:\\Program Files\\PIXet Pro"
import os
os.chdir(PIXETDIR)
import pypixet
print("pixet core init...")
pypixet.start()
pixet=pypixet.pixet
devices = pixet.devicesByType(pixet.PX_DEVTYPE_TPX3)
dev = devices[0]
dev.setOperationMode(pixet.PX_TPX3_OPM_EVENT_ITOT)
print("dev.doSimpleAcquisition (3 frames @ 1 sec) - start")
rc = dev.doSimpleAcquisition(3, 1, pixet.PX_FTYPE_AUTODETECT, "c:\\test-files\\example.png")
print("dev.doSimpleAcquisition - end:", rc, "(0 is OK)")
pixet.exitPixet() # save settings, correct stop devices and core exit
pypixet.exit() # both lines important if third-party debug environment used
Small code example for using in the Pixet python console with integrated Python:
# do not create the pypixet and pixet, they exist by default
devices = pixet.devicesByType(pixet.PX_DEVTYPE_TPX3)
dev = devices[0]
dev.setOperationMode(pixet.PX_TPX3_OPM_EVENT_ITOT)
print("dev.doSimpleAcquisition (3 frames @ 1 sec) - start")
rc = dev.doSimpleAcquisition(3, 1, pixet.PX_FTYPE_AUTODETECT, "example.png")
print("dev.doSimpleAcquisition - end: %i (0 is OK)" % rc)
# do not execute the pixet.exitPixet(), it will cause whole the Pixet program to exit
Requirements
The Pixet Python API can be used from the Python interpreter integrated in the Pixet program or from commandline with external Python without the Pixet.
For starting from the Pixet Python scripting plugin are not need any special files.
If you want to run scripts without the Pixet, need additional files:
API functions using of pypixet.pyd and pypxproc.pyd and need Python versions 2.7 to 3.9, for Windows the Pixet core dlls: pxcore.dll, pxproc.dll, or linux .so ekvivalents.
The Pixet core need the pixet.ini file with proper hwlibs list inside, necessary hardware dll files (eq minipix.dll), subdirectory “configs” with config files for all present imaging chips (eq MiniPIX-I08-W0060.xml).
The Pixet API packages Files in the Pixet API package for Windows  Files in Pixet API package for Linux Download at advacam.com/downloads/ |
pxcore.dll (or lib...so) pxcore.lib pxproc.dll (or lib...so) |
Binary libraries (pxcore.lib is only for Windows binary compile) |
|---|---|---|
| pypixet.pyd (or .so) pypxproc.pyd (or .so) |
Python core and processing libraries See Python API | |
| pxcapi.h | Header for the binary compile with pxcore.dll See Binary core API | |
| pixet.ini | Pixet core configuration file See: Files and directories of the Pixet and SDK - pixet.ini file | |
| main.cpp SampleProject.vcxproj SampleProject.sln |
Sample Visual studio project (Windows package only) | |
| *.rbf *.bit | Firmware files | |
| install_driver_rules.sh 60-opalkelly.rules 60-pixet.rules |
Linux drivers installer and it's helper files | |
| okFrontPanel.dll libokFrontPanel.so |
Helper library of the zem.dll/so hwlib | |
| other files .dll (or .so - no lib...so) |
Hwlib files (can be in separate directory) | |
| lic.info | License file for the Pixet core - not importatnt in this version, but may be in future | |
| pdf files | Binary and python APIs manuals |
Pixet core on Windows need more Microsoft Visual Studio .NET standard dlls (vccorlib140.dll etc).
Project and auxilliary files examples
 |
This is the directory and the pixet.ini file of the minimalistic python project. Using only with the Minipix device and can be run on computer with properly installed MS Visual Studio or it's auxiliary files installed by other way. The "factory" directory contains the factory config file.
|
If the MS VS auxilliary files are not accesible from the project directory, you can copy it from the Pixet program directory. In this image you can see all the auxiliary files marked, including MS VS dlls, firmware files for all our devices, hwlibs directories, ... Copying it to a python project should always make it ready to work, but not all are always needed.
Auxilliary files details
see:
- Small: Pixet SDK: Auxilliary files
- Details: Main directory of the API-using programs, independent on the Pixet
Basic troubleshooting
If normal error occured, like as function returns negative return code:
- Use the device.lastError() to get error message and print or log it.
If You want contact technical support
- Send us Your program, contents of the "logs" directory, the return code, error message and what do You want to do with the detector device.
If a problem like as "DLL load failed" occured and you want contact technical support
- Use the dir command and send us Your program, the error message, version of Python that is installed on the computer and the dir output.
- Tip: Use DIR with subdirs, redirected to file and python version redirected to file, than send us the files:
dir /s > dir.txt python -c "import sys; print(sys.version_info)" > pyVersion.txt
Examples
- Single examples
- General (commandline)
- https://advacam.com/examples/dirs+configs+calibs.py
- (For clarification on various auxiliary directories, configurations and calibrations)
- https://advacam.com/examples/device-tpx3-frames-manyCallbacks.py
- (All callbacks possible od Minipix-Tpx3 used)
- https://advacam.com/examples/testFrames.py
- (Library used in some frames-using examples)
- Tpx (commandline) (obsolete)
- https://advacam.com/examples/device-tpx-frames-manyAcqs.py
- (Tpx version of device-tpx3-frames-manyAcqs.py)
- Tpx3 (commandline)
- Tpx3 Frames with subframes examle
- (Acquisition on Tpx3 usually produces data in two subframes, and the data in the base frame are artifacts of raw frame processing.)
- https://advacam.com/examples/device-tpx3-dataDriven.py
- (data-driven measuring and using callbacks)
- https://advacam.com/examples/device-tpx3-frames-manyAcqs.py
- (frame acquisitions by many ways with and without callbacks)
- Requires: https://advacam.com/examples/testFrames.py
- Mpx3 (commandline)
- Mpx3 frames with subframes examle: https://advacam.com/examples/device-mpx3-frames-SFRs.py
- Mpx3 synchronization in multidev example: https://advacam.com/examples/device-mpx3-frames-sync.py
- Mpx3 integral measuring example: https://advacam.com/examples/device-mpx3-frames-integral.py
- Pygui (run from Python IDE in Pixet)
- https://advacam.com/examples/pygui-GridLayout.py
- https://advacam.com/examples/pygui-Plot.py
- https://advacam.com/examples/pygui-Plot-caldata.py
- https://advacam.com/examples/pygui-PropertyTreeView.py
- https://advacam.com/examples/pygui-PropertyTreeView+MpxFramePanel.py
- https://advacam.com/examples/pygui-MpxFrame-Tpx.py
- https://advacam.com/examples/pygui-MpxFrame-Tpx3.py
- https://advacam.com/examples/pygui-MpxFrame-Mpx3.py
- https://advacam.com/examples/pygui-MpxFrame-Mpx3-multiDev.py
- Examples packages
-
- Pxproc (commandline)
- Spectral imaging API examples: https://advacam.com/examples/API-Python-pxproc-spectraimg.rar
- Clustering API examples: https://advacam.com/examples/API-Python-pxproc-clustering.rar
Auxilliary scripts
- Single scripts
- Single T3PA from Advapix-Quad to four "single-chip" files:
- Export ABCT calibration files from multichip devs:
- Spectral imaging offline parallel process multichip data:
Documentation
The documentation of the Python API is in a PDF file located in the API package.
Download at: https://advacam.com/downloads/