IAI AP-1600T-PMCL User manual

User Manual
AP-1600T-PMCL
Digital 3CMOS Progressive Scan
RGB Color Camera
Document Version: 1.2
AP-1600T-PMCL_Ver.1.2_Mar.2019
Thank you for purchasing this product.
Be sure to read this manual before use.
This manual includes important safety precautions and instructions on how to operate the unit. Be sure to read
this manual to ensure proper operation.
The contents of this manual are subject to change without notice for the purpose of improvement.
© 2018 JAI

Contents
— 2 —
AP-1600T-PMCL
Notice ..........................................................3
Warranty ......................................................3
Certifications................................................3
Warning .......................................................3
Usage Precautions........................................5
Features.......................................................6
Parts Identification.......................................7
Preparation ............................................ 11
Preparation Process.................................... 11
Step 1: Installing the Software (first time
only) ..........................................................11
Step 2: Connecting Devices ........................12
Step 3: Verifying Camera Operation ............ 14
Step 4: Verifying the Connection between the
Camera and PC...........................................14
Connecting the Camera to Control Tool .........14
Step 5: Changing the Camera Settings........18
Configuring the Output Format ....................18
Step 6: Adjusting the Image Quality ...........20
Displaying the Image .................................20
Adjusting the Gain .....................................20
Manual adjustment .................................20
Adjusting the White Balance .......................21
Automatic white balance adjustment .........21
Adjusting the Black Level ............................21
Step 7: Saving the Settings.........................22
To save user settings ..............................22
To load user settings ...............................23
Main Functions ....................................... 24
Basic Function Matrix .................................24
GPIO (Digital Input/Output Settings) ......... 24
Valid Input/Output Combinations .................24
Camera Output Formats .............................25
Image Acquisition Controls (Acquisition
Control)......................................................29
Changing the Frame Rate ...........................30
Maximum Frame Rate ................................30
Maximum frame rate period formula .........30
During continuous operation ([Frame Start]
trigger is [Off] or [ExposureMode] is
[Off]) ................................................32
When [Frame Start] trigger is [On] and
[TriggerOverLap] is [Off] ......................32
When [Frame Start] trigger is [On] and
[TriggerOverLap] is [Readout] ..............32
ExposureMode............................................33
Actual Exposure Times ...............................33
Trigger Control ...........................................33
Shortest Repetition Period for Triggers ..........34
Gain Control ...............................................41
Adjusting the Master Gain and Performing Fine
Adjustment with R and B (Master Mode) .......41
Adjusting the Gain Individually for RGB
(Individual Mode) ......................................42
Automatic Gain Level Control ......................42
Lookup Table (LUT) ....................................43
To use the LUT function ...........................43
LUT values .............................................43
Gamma Function ........................................44
To use the gamma function ......................44
LineStatus ..................................................44
BlemishCompensation ................................44
Automatic detection ................................44
Manual configuration ...............................45
ShadingCorrection...................................... 45
FlatShading ...........................................46
ColorShading .........................................46
To use the shading correction function ......47
Binning Function ........................................47
ROI (Regional Scanning Function) ..............47
ROI Settings .............................................47
Sequencer Function.................................... 50
ALC (Automatic Level Control) Function...... 52
To use the ALC function ...........................53
Color Space Conversion
(ColorTransformationControl) .....................53
Note on RGB(UserCustom) ......................53
Edge Enhancer, Color Enhancer...................54
CounterAndTimerControl Function..............54
Counter occurrence diagram ....................55
Internal camera blocks ............................55
To use the counter function .....................55
VideoProcessBypassMode........................... 56
Functions available in
VideoProcessBypassMode .....................56
To enable VideoProcessBypassMode ..........56
Settings List ........................................... 57
Feature Properties......................................57
Miscellaneous......................................... 68
Troubleshooting .........................................68
Specifications .............................................69
Frame Rate Reference ................................ 71
Spectral Response ......................................71
Dimensions ................................................72
Comparison of the Decibel Display and
Multiplier Display........................................ 73
User’s Record ............................................. 74
Index ..................................................... 75
Sensor Multi ROI Mode............................... 49

— 3 —
AP-1600T-PMCL
Notice
The material contained in this manual consists of information that is proprietary to JAI Ltd., Japan
and may only be used by the purchasers of the product. JAI Ltd., Japan makes no warranty for the
use of its product and assumes no responsibility for any errors which may appear or for damages
resulting from the use of the information contained herein. JAI Ltd., Japan reserves the right to
make changes without notice.
Company and product names mentioned in this manual are trademarks or registered trademarks of
their respective owners.
Warranty
For information about the warranty, please contact your factory representative.
Certifications
CE compliance
As defined by the Directive 2004/108/EC of the European Parliament and of the Council, EMC
(Electromagnetic compatibility), JAI Ltd., Japan declares that AP-1600T-PMCL complies with the
following provisions applying to its standards.
EN 61000-6-3 (Generic emission standard part 1)
EN 61000-6-2 (Generic immunity standard part 1)
FCC
This equipment has been tested and found to comply with the limits for a Class B digital device,
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection
against harmful interference in a residential installation. This equipment generates, uses and can
radiate radio frequency energy and, if not installed and used in accordance with the instructions,
may cause harmful interference to radio communications. However, there is no guarantee that
interference will not occur in a particular installation. If this equipment does cause harmful
interference to radio or television reception, which can be determined by turning the equipment off
and on, the user is encouraged to try to correct the interference by one or more of the following
measures:
• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
• Consult the dealer or an experienced radio/TV technician for help.
Warning
Changes or modifications to this unit not expressly approved by the party responsible for FCC
compliance could void the user’s authority to operate the equipment.
KC

— 4 —
GO-5000M-PGE
Supplement
The following statement is related to the regulation on “ Measures for the Administration
of the control of Pollution by Electronic Information Products “ , known as “ China RoHS “.
The table shows contained Hazardous Substances in this camera.
mark shows that the environment-friendly use period of contained Hazardous
Substances is 15 years.
嶷勣廣吭並㍻
嗤蕎嗤墾麗嵎賜圷殆兆各式根楚燕
功象嶄鯖繁酎慌才忽佚連恢匍何〆窮徨佚連恢瞳麟半陣崙砿尖一隈〇
云恢瞳ゞ 嗤蕎
嗤
墾麗嵎賜圷殆兆各式根楚燕 〃泌和
桟隠聞喘豚㍉
窮徨佚連恢瞳嶄根嗤議嗤蕎嗤墾麗嵎賜圷殆壓屎械聞喘議訳周和音氏窟伏翌
亶賜融延、窮徨佚連恢瞳喘薩聞喘乎窮徨佚連恢瞳音氏斤桟廠夛撹冢嶷麟半
賜斤児繁附、夏恢夛撹冢嶷鱒墾議豚㍉。
方忖仝15々葎豚㍉15定。
部件名称
有毒有害物质或元素
铅
(Pb)
汞
(Hg)
镉
(Cd)
六价铬
(Cr (VI))
多溴联苯
(PPB)
多溴二苯醚
(PBDE)
棱镜 ×○○○○○
光学滤镜 × ○ × ○ ○ ○
连接插头 × ○ ○ ○ ○ ○
电路板 ×○○○○○
······ ······ ······ ······ ······ ······ ······
AP-1600T-PMCL

— 5 —
Notes on attaching the lens
Usage Precautions
AP-1600T-PMCL
Notes on Camera Link cable connections
Secure the locking screws on the connector manually, and do not
use a driver. Do not secure the screws too tightly. Doing so may
wear down the screw threads on the camera. (Tightening torque:
0.291±0.049 N·m or less) Secure manually.
Do not secure too tightly.
Notes on cable configurations
The presence of lighting equipment and television receivers nearby may result in video noise.
In such cases, change the cable configurations or placement.
Avoiding dust particles
When attaching the lens to the camera, stray dust and other particles may adhere to the
sensor surface and rear surface of the lens. Be careful of the following when attaching the
lens.
• Work in a clean environment.
• Do not remove the caps from the camera and lens until immediately before you attach the
lens.
• To prevent dust from adhering to surfaces, point the camera and lens downward and do not
allow the lens surface to come into contact with your hands or other objects.
• Always use a blower brush to remove any dust that adheres.
Never use your hands or cloth, blow with your mouth, or use other methods to remove
dust.
Phenomena specific to CMOS image sensors
The following phenomena are known to occur on cameras equipped with CMOS image
sensors. These do not indicate malfunctions.
•Aliasing
When shooting straight lines, stripes, and similar patterns, vertical aliasing (zigzag
distortion) may appear on the monitor.
•Blooming
When strong light enters the camera, some pixels on the CMOS image sensor may receive
much more light than they are designed to hold, causing the accumulated signal charge to
overflow into surrounding pixels.
This “blooming” phenomenon can be seen in the image, but does not affect the operation of
the camera.
•Fixed pattern noise
When shooting dark objects in high-temperature conditions, fixed pattern noise may occur
throughout the entire video monitor screen.
•Defective pixels
Defective pixels (white and black pixels) of the CMOS image sensor are minimized at the
factory according to shipping standards. However, as this phenomenon can be affected by
the ambient temperature, camera settings (e.g., high sensitivity and long exposure), and
other factors, be sure to operate within the camera’s specified operating environment.
Notes on exportation
When exporting this product, please follow the export regulations of your country or region.

— 6 —
AP-1600T-PMCL
Features
Connection example:
External trigger
AC adapter
Frame grabber
board
Computer
DC IN/TRIG
POWER/TRIG
DIGITAL I/O-1
DIGITAL I/O-2
Camera
The AP-1600T-PMCL is an industrial progressive scan camera that uses three 1/2.9-inch
global shutter CMOS image sensors with 1456×1088 effective pixels.
It allows maximum frame rates of 126.1 fps at full resolution.
Enhanced color reproduction is achieved via the newly-developed compact-designed 1/2.9-
inch 3CMOS C-mount F1.8 prism optical system in addition to the internal color matrix
circuit. Even higher definition imaging is made possible by the shading correction and
gamma correction circuits.
The ROI and binning functions allow for even faster readout speeds.
The gain and exposure time can be configured individually for each CMOS sensor. A color
space conversion function is also supported.
Features overview
• Compliance with CameraLink and GenICam standards
• 1/2.9-inch 3CMOS progressive RGB color camera
• Lens mount: C-mount (flange back: 17.526 mm)
• Effective pixels: 1456 (H) × 1088 (V); pixel size: 3.45 × 3.45 um
• Maximum frame rates of 126.1 fps at full resolution possible
• 24-bit or 30-bit RGB output (36-bit RGB output possible in video process bypass mode)
• Gamma correction circuit that uses lookup tables
• Color matrix that allows faithful color reproduction
• Color space conversion function (sRGB, Adobe RGB, HSI, XYZ) support
• Internal test signal for settings configuration
• JAI SDK that supports Windows Vista, 7, 8, 10

— 7 —
AP-1600T-PMCL
Parts Identification
1Lens mount (C-mount)
2Mini Camera Link connector
DC IN/TRIG
POWER/TRIG
DIGITAL I/O-1
DIGITAL I/O-2
13 1
26 14
Camera side: HONDA HDR-EC26FYTG2-SL+
Port 1
Pin No. Input/output Signal Description
1, 26 Power Power
2(–), 15(+) Out X_OUT0 Data out
3(–), 16(+) Out X_OUT1
4(–), 17(+) Out X_OUT2
5(–), 18(+) Out X_Clk CL Clock
6(–), 19(+) Out X_OUT3 Data out
7(+), 20(–) In SerTC (RxD) LVDS Serial Control
8(–), 21(+) Out SerTFG (TxD)
9(–), 22(+) In CC1 (Trigger) JAI standard trigger
10(+), 23(–) In CC2 (Reserved)
11, 24 N.C
12, 25 N.C
13, 14 Shield Power Return
Mount a C-mount lens, microscope adapter, etc. here.
Before mounting a lens, be sure to refer to “Step 2: Connecting Devices” and confirm the
precautions for attaching a lens and the supported lens types.
Connect a cable that is compatible with Mini Camera Link (SDR) connectors here.
①
⑤
②
③
④
⑤

Port 2
Pin No. Input/output Signal Description
1, 26 Power Power
2(–), 15(+) Out Y_OUT0 Data out
3(–), 16(+) Out Y_OUT1
4(–), 17(+) Out Y_OUT2
5(–), 18(+) Out Y_Clk CL Clock
6(–), 19(+) Out Y_OUT3 Data out
7(+), 20(–) N.C
8(–), 21(+) Out Z_OUT0 Data out
9(–), 22(+) Out Z_OUT1
10(+), 23(–) Out Z_OUT2
11(–), 24(+) Out Z_Clk CL Clock
12(–), 25(+) Out Z_OUT3 Data out
13, 14 Shield Power Return
AP-1600T-PMCL
— 8 —
3Power/trigger LED
Indicates the power and trigger input status.
LED status and camera status
LED Light Status
Power / trigger LED Lit amber Camera initializing.
Lit green Operational and no triggers being input.
Blinking green Operational and triggers being input.
The blinking interval is not related to the actual input interval
of the external trigger.

— 9—
AP-1600T-PMCL
4DC IN / trigger IN connector (12-pin round)
Connect the cable for DC IN /trigger IN here.
HR-10A-10R-12PB (71) (Hirose Electric or equivalent)
Pin No. Input/
output Signal Description
1 GND
2 Power IN DC IN DC 12 V to 24 V ±10%
3 In Opto IN 2– Line 6
4 In Opto IN 2+
5 In Opto IN 1– Line 5
6 In Opto IN 1+
7 Out Opto OUT 1– Line 2
8 Out Opto OUT 1+
9 Out TTL OUT 1 Line 1
10
11 Power IN DC IN DC 12 V to 24 V ±10%
12 GND
Note
When DC power is supplied to either Pin 1/Pin 2 or Pin 11/Pin 12, the camera operates.
Recommended external input circuit diagram (reference example)
TLP2366
1
3
6
5
4
1SS400
180CS
BF545C
SD
G
IN
USER POWER1
+3.3V to +24V
CAMERA
side
User
side
+3.3V
Pin5 (Opto In 1-) (*2)
Pin6 (Opto In 1+) (*1)
When Opto In 2
(*1) Pin4 (Opto In 2+)
(*2) Pin3 (Opto In 2-)
JAI Camera Side
User Side

— 10 —
AP-1600T-PMCL
⑤Camera locking screw holes (M3, 3 mm depth)
Use these holes when attaching an MP-44 tripod adapter plate (optional) or mounting the
camera directly to a wall or other structural system.
Recommended external output circuit diagram (reference example)
Standard circuit diagram example
Pin8
(Opto OUT1 +)
Pin7
(Opto OUT1 -)
User Side JAI Camera Side
Characteristics of the recommended circuits for Opto OUT
OUTPUT LINE RESPONSE TIME
Output
Line
Voltage
Camera
Output
Signal
RT
TDR
TDF FT
90%
10%
Output LEVEL = User Vcc- (0.8 to 1.1)
User power (VCC)
3.3 V to 24 V
Time Delay Rise TDR (us) 0.5 to 0.7
Tisc Time RT (us) 1.2 to 3.0
Time Delay Fall TDF (us) 1.5 to 3.0
Fall Time FT (us) 4 to 7

— 11 —
AP-1600T-PMCL
Preparation
Preparation Process
Step 1 Installing the Software (first time only)
Install the software for configuring and controlling the camera (JAI SDK) on the computer.
Step 2 Connecting Devices
Connect the lens, LAN cable, AC adapter, computer, and other devices.
Step 3 Verifying Camera Operation
Verify whether the camera is turned on and ready for use.
Step 4 Verifying the Connection between the Camera and PC
Verify whether the camera is properly recognized via Control Tool.
Step 5 Changing the Camera Settings
Refer to the procedure for changing the output format setting as an example, and change
various settings as necessary.
Step 6 Adjusting the Image Quality
Refer to the procedures for adjusting the gain, white balance, and black level as examples,
and adjust the image quality.
Step 7 Saving the Settings
Save the current setting configurations in user memory.
Step 1: Installing the Software (first time only)
When using the camera for the first time, install the software for configuring and controlling
the camera (JAI SDK) on the computer.
When you install JAI SDK, JAI Camera Control Tool will also be installed.
1
Download the “JAI - Getting Started Guide” and JAI SDK from the JAI
website.
URL: http://www.jai.com/en/support/download-jai-software
2
Refer to the “JAI - Getting Started Guide,” and install JAI SDK on the
computer.
The computer will restart when installation is complete.
Note
When the JAI SDK is installed, a camera driver for the GigE interface is also part of the default
installation. This GigE Vision Filter Driver is added to every NIC/port on the host computer. As the driver
is also added to the NIC/port for Internet connection, it may, on some systems, affect Internet access
speed. If you think your Internet speed is affected, configure the following settings to disable the filter
driver on that port.
u Open [Control Panel] [Network and Internet] [Connect to a network], and right-click
the port used for Internet connection to open the properties dialog box.
Caution
JAI SDK Version 3.0.2 or later is required to use this camera model.

— 12 —
AP-1600T-PMCL
v Clear the [JAI GigE Vision Filter Driver] checkbox, and save.
Step 2: Connecting Devices
Connect the lens, LAN cable, AC adapter, and other devices.
Attach the lens in a clean environment to prevent dust from adhering to the unit.
Camera body
2 Direct connection
(or MP-44 tripod adapter plate)
6 DC IN / trigger IN
connection cable
(not supplied)
1 Lens
3 Camera Link Cable
5 Computer
to external trigger
or
7 AC adapter (not supplied)
1Lens
• C-mount lenses with lens mount protrusions of 4 mm or less can be attached.
4 mm or less Lens mount protrusion
Lens
• Use a lens designed for three-sensor cameras. Using a lens for single-sensor cameras
may hinder full performance of the camera.
• The diagonal of the camera’s CMOS image sensor is 6.27 mm, the size of standard
1/2.9-inch lenses. To prevent vignetting and to obtain the optimal resolution, use a lens
that will cover the 6.27 mm diagonal. Some lens manufacturers offer lenses with an 6.27
mm format. If not, a 1/2.9-inch lens is recommended.
4Frame grabber board

— 13 —
AP-1600T-PMCL
Caution
• The maximum performance of the camera may not be realized depending on the lens.
• Attaching a lens with a mount protrusion of 4 mm or longer may damage the lens or camera.
Note
The following formula can be used to estimate the focal length.
focal length = WD / (1 + W/w)
WD: Working distance (distance between lens and object)
W: Width of object
w: Width of sensor (5.02 mm on this camera)
2Direct connection (or MP-44 tripod adapter plate)
When mounting the camera directly to a wall or other device, use screws that match the
camera locking screw holes on the camera. (M3, depth: 3 mm)
Use the supplied screws to attach the tripod adapter plate.
Caution
For heavy lenses, be sure to support the lens itself. Do not use configurations in which its weight is
supported by the camera.
5Computer
Use a computer that meets the following requirements.
Operating system (OS):
Microsoft Windows Vista/7/8 32-bit/64-bit edition
CPU: Intel Core i3 or higher
Memory:
Windows Vista/7/8/10 32-bit edition: DDR3, 4 GB or higher
Windows Vista/7/8/10 64-bit edition: DDR3, 8 GB or higher
Graphics card: PCI-Express 3.0 or higher
Network card: We recommend using a network card that uses an Intel chip.
6DC IN / trigger IN connection cable
7AC adapter (power supply) (if necessary)
Connect the AC adapter and the round connector of the connection cable to the DC IN /
trigger IN connector on the camera.
3Camera Link cable
Connect the Camera Link cable to the Mini Camera Link connector.
•Use a cable that supports the Camera Link standard and is compatible with Mini Camera Link
(SDR) connectors.
•Refer to the specifications of the cable for details on its bend radius.
•For details on the cable, see “2 Mini Camera Link connector”.
Caution
Secure the locking screws on the connector manually, and do not use a
driver. Do not secure the screws too tightly. Doing so may wear down the
screw threads on the camera. (Tightening torque: 0.291±0.049 N·m or
less)
When power is supplied by PoCL, be sure to connect the camera link cable
to both DIGITAL I / O - 1 and DIGITAL I / O - 2 regardless of the setting.
Secure manually.
Do not secure too tightly.
4Frame grabber board
Refer to the operating instructions of the frame grabber board, and configure settings on the
computer as necessary.
The AC adapter is not required when using PoCL.

— 14 —
AP-1600T-PMCL
Step 3: Verifying Camera Operation
When power is supplied to the camera while the necessary equipment is connected, the POWER/
TRIG LED at the rear of the camera lights amber, and initialization of the camera starts.
When initialization is complete, the POWER/TRIG LED lights green.
Verify whether power is being supplied to the camera by checking the rear LED.
Lights green
When properly turned on
For details on how to read the LEDs, see “LED status and camera status” in the “Parts
Identification” section.
Step 4: Verifying the Connection between the Camera
and PC
Verify whether the camera is properly recognized via Control Tool.
Connecting the Camera to Control Tool
1
Start JAI Control Tool.
The JAI Control Tool startup screen appears.
DC IN/TRIG
POWER/TRIG
DIGITAL I/O-1
DIGITAL I/O-2

Check the settings when using Camera Link.
AP-1600T-PMCL supports GenICam and GenCP. If you want to control the camera with the
JAI SDK, check the following settings.
Confirmation of frame grabber board
In order to support GenCP, it is necessary to set the COM port on the frame grabber board.
For details, please refer to the instruction manual of each board maker.
Confirmation of JAI SDK
❶Start JAI Control Tool and click (Settings) in the upper right.
AP-1600T-PMCL
— 15—
AP-1600T-PMCL
AP-1600T-PMCL
AP-1600T-PMCL

❷The items of [JAI_GenCP_Camera_Link] and [Camera Link Transport Layer] are set
to the following settings Confirm that it is.
AP-1600T-PMCL
— 16 —

— 17—
AP-1600T-PMCL
2
Select the camera you want to configure.
3
Check that the settings of the selected camera are displayed.
Check that the settings information of the selected camera appears in the right area.
If a camera is not detected, right-click within the window and select [Search for Cameras].

— 18—
AP-1600T-PMCL
This completes the procedure for verifying whether the camera is properly recognized and
whether control and settings configuration are possible.
Step 5: Changing the Camera Settings
This section explains how to change settings by describing the procedure for changing the
output format as an example.
Configuring the Output Format
Item Default value
ImageFormatControl Width 1456
Height 1088
OffsetX (horizontal position) 0
OffsetY (vertical position) 0
Pixel Format RGB8
You can specify the image acquisition area. For details, see “ROI (Regional Scanning Function)” .
Item Default value
TransportLayerControl ClConfigurtion Medium
CameraLinkClockFrequency 74.3MHz
Configure the size, position, pixel format of the images、ClConfiguration and
CameraLinkClockFrequency to be acquired.
The factory settings are as follows. Change the settings as necessary.
Factory default values
AP-1600T-PMCL
AP-1600T-PMCL
AP-1600T-PMCL

— 19 —
AP-1600T-PMCL
1
Select the [FeatureProperties] tab, and select the item you want to
configure under [ImageFormatControl].
when a configurable item is selected.
Note
Settings can only be changed when image acquisition on the camera is stopped. If an item is grayed out
and does not appear even when you select it, click (Stop Acquisition) to stop image acquisition.
2
Click and change the setting value.
Example: When changing [Width]
Example: When changing [PixelFormat]
Note
Direct entry of numerical and text values is possible for some setting items.
AP-1600T-PMCL
AP-1600T-PMCL
RGB8
RGB10
RGB12

— 20 —
AP-1600T-PMCL
Step 6: Adjusting the Image Quality
Display the camera image and adjust the image quality.
Displaying the Image
Display the image captured by the camera.
Please display the image with the viewer on the frame grabber board application.
Adjusting the Gain
Adjust the image quality using the gain and white balance functions.
To adjust the image quality
The display level must be changed from [Beginner] to [Guru].
Adjust the sensitivity via the analog gain (i.e., master gain).
For details on gain control, see “Gain Control” in the “Main Functions” section.
■Manual adjustment
1
Expand [AnalogControl], and set [GainAuto] and [IndividualGainMode] to
[Off].
([Off] is the default setting.)
Table of contents
Other IAI Digital Camera manuals

IAI
IAI cm-140ge User manual

IAI
IAI GO-5000M-USB User manual

IAI
IAI cm-040ge User manual

IAI
IAI GOX-2402M-USB User manual

IAI
IAI SW-4010Q-MCL-M52 User manual

IAI
IAI WA-1000D-CL User manual

IAI
IAI SW-4000TL-10GE User manual

IAI
IAI GOX-5105M-PGE User manual

IAI
IAI SW-4000TL-PMCL Installation manual

IAI
IAI SW-4000T-MCL User manual