Best Practices for Ladybug5
Technical Application Note TAN2015008
Revised June 29, 2016
Technical Application Note (TAN2015008): Best Practices for Ladybug5
The purpose of this application note is to describe a series of settings and hardware configurations to optimize Ladybug5 image quality.
Before you use your Point Grey camera, we recommend that you are aware of the following resources available from the Point Grey Downloads page:
SDK bug fixes and performance improvements happen often. Visit the Point Grey downloads site regularly to update your SDK and take advantage of the latest improvements to achieve the best performance from your Ladybug5.
Because of Ladybug5’s high demand on bandwidth during the capture phase, it is important to match the camera’s requirements with the capacity of your system. This table lists the recommended minimum system requirements. See the Ladybug5 Technical Reference manual for operating modes and expected data rates.
|CPU||Intel Core i3 or equivalent processor||Intel Core i7 or equivalent processor|
Windows 7 64-bit
|Windows 7 64-bit|
|RAM||4 GB||8 GB|
|Storage||RAID array or SSD capable of sequential data write speed of up to 240 MB/s.
Depends on actual streaming bandwidth of the camera.
|Video Card||Intel HD4000 Graphics or newer||NVIDIA GTX 560 or newer|
|Host Adaptor||USB3 host adaptor|
Included with Ladybug5
|1 meter USB 3 cable (ACC-01-2303)
3 meter USB3 cable with locking screws (ACC-01-2300)
5 meter USB3 cable with locking screws (ACC-01-2301)
Included with Ladybug5
|6 meter 12-pin GPIO power cable and wiring harness
The Ladybug5 requires 12 – 24 volts of power which must be provided by an external power supply connected to the GPIO cable.
|Driver||PGRxHCI 126.96.36.199 or later for dedicated host adaptors
PGRUSBCam 188.8.131.52 or later for onboard USB3 port
|Software||Ladybug SDK 1.14 or later||
Ladybug SDK 1.14 or later
|Firmware||Use the latest firmware available from the Point Grey downloads page.||Use the latest firmware available from the Point Grey downloads page.|
Ladybug5 comes with the following accessories:
Although a shorter cable (5 meters or less) is recommended, a hub and active cables may be used to extend the cable length beyond 5 meters and to improve connectivity. Point Grey recommends using a hub when using a laptop or when using cables longer than 3 meters.
The Ladybug5 has worked successfully with the following systems:
The Ladybug SDK is required to capture and process images from the Ladybug5.
After installation, to manage and update drivers, use the DriverControlGUI utility in the SDK.
There are a number of options to optimize the results when capturing images. Some settings must be established before capture and are not available at the processing stage.
There are two windows which provide access to the camera controls:
To open the Ladybug Recorder:
Start Menu → All Programs → Point Grey Ladybug SDK → Ladybug Recorder.
The Ladybug Recorder provides access to these options:
To open LadybugCapPro:
Start Menu → All Programs → Point Grey Ladybug SDK→ LadybugCapPro→
LadybugCapPro main toolbar provides access to the following options discussed in Optimizing Post Processing:
For information on all of the features of LadybugCapPro, see Ladybug5 Technical Reference.
Use Ladybug Recorder to set the following options prior to starting image capture.
There are two options that relate to pixel depth and post processing controls:
|8-bit Pixel formats||On-Camera Processing||
|Post Processing on PC||
12-bit Pixel Formats
|Post Processing on PC||
There are three preset shutter range modes. Choose the shutter range according to the conditions of use, as defined below:
When using 12-bit mode, gamma correction is done at the post processing stage.
When using 8-bit mode, the gamma option must be turned on before you start the capture process. It cannot be changed once this process has begun.
AWB is a system of color correction used for different lighting conditions. It is adjusted by modifying the relative gain of R, G, and B to keep white areas looking white under changing lighting conditions. If you write your own collect software, make the API call for AWB every 20 frames.
When using 12-bit mode, AWB is adjusted during post processing.
When using 8-bit mode, the AWB can only be set during the capture stage. In Ladybug Recorder, click the AWB button occasionally while capturing to adjust for changes in lighting conditions.
Turn on GPS and set the data update interval time before capture. Set the interval for double the output rate of the GPS. For example, if GPS sends out data every 1 second, set the interval to 500 ms.
To turn on the GPS option for one use, use Ladybug Recorder:
To turn on the GPS option every time LadybugCapPro is started:
There are a number of options to set during post processing to improve image results. Access the following controls using LadybugCapPro main toolbar.
To improve the color processing results:
This selection must be made every time LadybugCapPro is started.
The Image Processing window shows the default settings, which are the recommended settings for best image quality. Tone Mapping is not turned on as a default setting, but should be turned on to improve quality. To access these controls, from the Settings menu, select Image Processing.
The captured images are “stitched” together using an algorithm that examines the image overlap along each seam and determines various ranges values along it. There are three settings to control stitching, including two options for dynamic stitching. Click the button for the drop-down menu of settings as follows:
To improve the speed for this option:
To improve the processing time of the pattern-matching algorithm, narrow the range, for example, to 4 meters – 20 meters.
Follow these guidelines to help protect Ladybug5 from damage:
Do not open the camera housing. This voids the warranty.