Skip to content

Installing and starting

Requirements

Operating system Windows 10 or 11, 64-bit
Instrument A BARDOT instrument: plate camera, scatter (laser) camera, stage motors and the relays of the laser and the plate light
Camera driver Basler cameras need the Basler pylon Software Suite installed separately, with its USB camera driver
Serial ports One each for the motor controller, the relays, the heater and the Cytomat, as the instrument has them
Database Optional: a MySQL or MariaDB server, on this computer or on the network

BacBuster can also start with no instrument, to look at plates - see No-device mode below.

Installing

Download BacBuster_Setup.<version>.exe from the BacBuster web page and run it. It installs into C:\BacBuster\ rather than into Program Files, because BacBuster keeps the settings and the calibration files of its instrument beside the program:

Item Purpose
BacBuster.exe The program
BacBuster.map Symbols, for error reports
PylonC_v10.dll The C interface of Basler pylon, for Basler cameras
libmysql64.dll The database client
libsvm64.dll, Kapacb.dll Support libraries; Kapacb.dll runs the network that grades scatter images
FitSdk_x64.dll, IOSetting.ini The digital outputs of instruments that switch the laser and lights through them
WebView2Loader.dll The window this manual opens in

The models that grade scatter images are installed into C:\Users\Public\Documents\BacBuster\models\, and this manual into C:\Users\Public\Documents\BacBuster\Manual\. The Start menu group BacBuster has shortcuts to the program, to this manual, to the BacBuster web page and to the uninstaller. The installer can also create a desktop icon.

Basler pylon

The installer does not include the pylon Software Suite. Install it first, from Basler's web site, and make sure Windows has accepted its USB camera driver. pylon Viewer, which comes with it, is the quickest way to check that the cameras work.

Starting

Start BacBuster from the Start menu. A splash screen shows while the cameras and motors are found, then the main window opens and the stage moves to its parking position. The title bar shows the version and the device:

BacBuster Beta x64 12.33 Device Model: PUCL S/N 2

Only one BacBuster runs at a time; starting it again does nothing. If an earlier BacBuster got stuck while closing and still holds the cameras, BacBuster offers to end it.

The first start on a new computer

  • Which device? If the settings do not say which instrument this is, the Gizmo Selector asks you to pick one of the device configurations (*.cfg) in the program folder. See Devices and cameras.
  • Which camera? If a camera the settings name is not connected, BacBuster asks which of the connected cameras is the Plate Camera and which the Laser Camera.
  • Is it connected? Device #1 is not connected! means the motor controller did not answer: BacBuster carries on, but nothing moves. See Troubleshooting.

No-device mode

Ticking NoGizmo on the Service > Staff Only tab and restarting starts BacBuster with no instrument: the title bar says Device Model: NONE and the status bar Instrument: No Device. Plates can be opened, looked at, edited and saved, but the plate image and scanning buttons do nothing. Untick it and restart to use the instrument again.

Closing

Click the Exit button at the right end of the toolbar, or close the window. If the plate has not been saved, BacBuster asks whether to save it first. Before it closes, the stage goes home; if closing hangs for 20 seconds, BacBuster ends itself and leaves a note in its log.

Getting help

  • F1 opens the page of this manual about whatever is under the mouse - the tab, the image, the dialog you are in.
  • Help on the toolbar opens this manual at its front page.

The manual opens in its own window, with < / >, Contents and Open in Browser buttons. If Microsoft Edge WebView2 is not available, it opens in your default web browser instead. The manual is served by BacBuster itself, which is what makes its search box work; pages opened in a browser stop loading after you close BacBuster - reopen them from the Start menu shortcut BacBuster User Manual.

Where settings are kept

What Where
Which device and cameras, window layout C:\BacBuster\BacBuster.ini
The device's settings, positions and exposures C:\BacBuster\<device name>.ini
The device's calibration C:\BacBuster\<device name>.tab, .bgr, .cpt
Database connections, passwords included %APPDATA%\BaclAn\Servers.dat, shared with Baclan and ExpManager

See Files and folders for the rest.