Resulting Acquisition Line Rate#

The Resulting Acquisition Line Rate camera feature allows you to determine the estimated line rate with the current camera settings.

This is useful, for example, if you want to know how long you have to wait between triggers.

The line rate is expressed in hertz (Hz).

Using the Feature#

Why Check the Resulting Acquisition Line Rate#

Optimizing the Line Rate#

When the camera is configured for free run image acquisition and continuous acquisition, knowing the resulting acquisition line rate is useful if you want to optimize the line rate for your imaging application. You can adjust the camera settings limiting the line rate until the resulting acquisition line rate reaches the desired value.

Optimizing Triggered Image Acquisition#

When the camera is configured for triggered image acquisition, knowing the resulting acquisition line rate is useful if you want to trigger the camera as often as possible without overtriggering. You can calculate how long you must wait after each trigger signal by taking the reciprocal of the resulting acquisition line rate: 1 / Resulting Acquisition Line Rate.

Example: If the resulting acquisition line rate is 100000 Hz, you must wait for a minimum of 1/100000 = 10 µs after each trigger signal.

Checking the Resulting Acquisition Line Rate#

To check the resulting acquisition line rate, i.e., the estimated line rate with the current camera settings, get the value of the BslResultingAquisitionLineRate parameter. The value is expressed in hertz (Hz).

The parameter value takes all factors limiting the line rate into account.

Factors Limiting the Line Rate#

Several factors may limit the line rate on a Basler camera:

• Acquisition Line Rate: If the Acquisition Line Rate feature is enabled, the camera's line rate is limited by the acquisition line rate. For example, if you enable the Acquisition Line Rate feature and set an acquisition line rate of 100000 Hz, the camera's line rate will never be higher than 100000 Hz.
• Bandwidth Assigned: Bandwidth limitations can reduce the line rate, especially when more than one camera is connected to a computer. The extent of the reduction depends on the camera model, the number of cameras connected to the computer, and the computer's hardware.
• Binning: If available, sensor binning can increase the line rate.
• Camera Operation Mode: If the CameraOperationMode parameter is available and set to LongExposure, the line rate decreases.
• Device Link Throughput: If the DeviceLinkThroughputLimitMode parameter is available and set to On, it limits the available bandwidth for data transmission to the DeviceLinkThroughputLimit parameter value. This also limits the line rate.
• Exposure Time: If you use very long exposure times, you can acquire fewer lines per second.
• Field Output Mode: If available, using the Field 0 Output Mode or Field 1 Output Mode increases the camera's line rate.
• Image ROI: if you use a large image ROI, you can acquire fewer lines per second. On most cameras, decreasing the image ROI height increases the line rate. On some cameras, decreasing the image ROI width also increases the line rate.
• Parameter Limits: On some cameras, you can use the Remove Parameter Limits feature to remove the line rate limitation.
• Sensor Bit Depth: On some cameras, you can decrease the sensor bit depth to increase the line rate.
• Sensor Readout Mode: On some cameras, you can enable a fast sensor readout mode that allows you to increase the line rate. This can, however, have adverse effects on image quality.
• Sensor Shutter Mode: If the Global Reset Release shutter mode is selected, overlapped image acquisition is not possible. This decreases the camera's line rate.
• Stacked Zone Imaging: If available, using the Stacked Zone Imaging feature increases the line rate.
• Transfer Bit Depth: On some cameras, you can decrease the transfer bit depth to increase the line rate.

External Links#

• Basler Frame Rate Calculator (baslerweb.com)

Sample Code#

// Get the resulting acquisition line rate
double d = camera.BslResultingAcquisitionLineRate.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Get the resulting acquisition line rate
double d = CFloatParameter(nodemap, "BslResultingAcquisitionLineRate").GetValue();

// Get the resulting acquisition line rate
double d = camera.Parameters[PLCamera.BslResultingAcquisitionLineRate].GetValue();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
double d = 0;
/* Get the resulting acquisition line rate */
errRes = PylonDeviceGetFloatFeature(hdev, "BslResultingAcquisitionLineRate", &d);
CHECK(errRes);

# Get the resulting acquisition line rate
d = camera.BslResultingAcquisitionLineRate.Value

You can also use the pylon Viewer to easily set the parameters.