OPERATOR’S MANUAL Version 4.xx Laser Beam Analyzer Models LBA-300/400/500PC Models LBA-700/708/710/712/714PC For Windows® 2000 and Windows® XP Pro Spiricon, Inc. 60 W 1000 N Logan, Utah 84321 Phone 435-753-3729 Fax 435-753-5231 E-mail, Sales: sales@spiricon.com E-mail, Service: service@spiricon.com © Copyright 2005, Spiricon Inc., All rights reserved. Operator’s Manual Doc. No. 10654-001, Rev 4.
NOTICE Spiricon Inc. reserves the right to make improvements and changes to the product described in this manual at any time and without notice. While Spiricon Inc. has taken every precaution in the preparation of this product Spiricon Inc. assumes no responsibility for errors or omissions that might cause or contribute to a loss of data. Spiricon Inc.
Table of Contents OPERATOR’S MANUAL __________________ 1 Version 4.xx ____________________________________________ Laser Beam Analyzer __________________________________ Models LBA-300/400/500PC _____________________________ Models LBA-700/708/710/712/714PC __________________ 1 1 1 1 For Windows 2000 and Windows XP Pro ____________________ 1 © Copyright 2005, Spiricon Inc., All rights reserved. __________________ 1 NOTICE 2 Chapter 1 INTRODUCTION ___________________________________ 11 1.
2.6.1.3 2.6.1.4 Some Restrictions apply when interfaced to a Pyrocam I ______________________ 28 Image synchronization considerations _____________________________________ 29 2.6.2.1 2.6.2.2 2.6.2.3 Pyrocam I setup requirements:___________________________________________ 29 LBA-500/7XXPC-D Setup requirements: ____________________________________ 30 Image Synchronization Considerations _____________________________________ 31 2.6.
3.2.2 Aperture... display and define apertures ________________________________ 49 3.2.2.1 3.2.2.2 3.2.2.3 3.2.2.4 3.2.2.5 Aperture Shapes ______________________________________________________ How to create a Drawn Aperture _________________________________________ Drag and Drop Apertures _______________________________________________ Using Auto Apertures___________________________________________________ Display Beam Width ___________________________________________________ 49 50 50 51 51 3.2.3.1 3.
3.2.7.3 3.2.7.4 3.2.7.5 3.2.7.6 3.2.7.7 3.2.7.8 3.2.7.
4.2 The Beam Display Window ________________________________________ 106 4.3 The Results Display Window ______________________________________ 109 4.4 The Pan/Zoom Display Window ____________________________________ 111 4.2.1 4.2.2 4.3.1 4.4.
5.3 Integration Control ______________________________________________ 123 5.4 Digital Camera Operations ________________________________________ 124 5.3.1 Integration Operation ______________________________________________ 124 5.4.1 Digital Camera Control _____________________________________________ 124 5.4.1.1 5.4.1.2 5.4.1.3 5.4.1.4 5.4.1.
Chapter 7 DIGITAL CAMERA OPTION __________________________ 148 7.1 Digital Camera Option____________________________________________ 148 7.2 I/O Connections ________________________________________________ 148 7.3 Digital Camera Advanced Timing Setup ______________________________ 152 7.3.1 7.3.2 7.3.3 7.3.4 7.3.5 7.3.
9.3.2.5 9.3.2.6 9.3.2.7 9.3.3 9.4 Stop _______________________________________________________________ 170 Ultracal_____________________________________________________________ 170 Auto Exposure _______________________________________________________ 171 Events __________________________________________________________ 171 9.3.3.1 9.3.3.
Chapter 1 INTRODUCTION 1.1 General Information The Spiricon, Laser Beam Analyzer, Models LBA-300/400/500/700/708/710/712/714PC, is a low cost, PC based product for use in modern Pentium generation personal computers with high performance PCI bus architecture. It provides all the essential features needed for laser beam analysis. Some of these features are: • High-speed high-resolution false color beam intensity profile displays in both 2D and 3D.
f) A high resolution color monitor. g) Windows® 2000 or Windows® XP Professional operating system with at least 64MB of main memory. h) A CD-ROM Drive. i) A PC compatible mouse & keyboard. Pentium and Pentium Pro are registered trademarks of Intel Corporation. Windows 2000 and Windows XP Pro are registered trademarks of Microsoft Corporation. Notice: PC operating system, component and hardware manufactures are constantly revising their products. Therefore Spiricon, Inc.
1.4 Specifications ENVIRONMENTAL Operating Temperature: 0 °C to +50 °C Storage Temperature: -55 °C to +75 °C Humidity: 95% non-condensing POWER REQUIREMENTS PCI bus loading: Power consumption: +5 Vdc @ 350 mA., +3.3Vdc @ 50mA. +12 Vdc @ 140 mA.* (w/o camera) -12 Vdc @ 110 mA. 4.75 watts (w/o camera) *Total PCI load on +12 Vdc w/camera not to exceed 500 mA. WEIGHT Net: Shipping: Approximately 0.23 kg (0.5 lb.) Approximately 1.4 kg (3 lb.
1.5 Safety Considerations While the LBA-PC does not present the operator with any safety hazards, this instrument however is intended for use with laser systems. Therefore, the operator should be protected from any hazards that the laser system may present. The greatest hazards associated with laser systems are damage to the eyes and skin due to laser radiation. 1.5.
Chapter 2 EQUIPMENT SETUP 2.1 Equipment Setup This chapter describes how to get started using your LBA-PC. Follow these steps: Step 1) Install your LBA-PC frame grabber card into your PC. Step 2) Hook up your camera. Step 3) Turn on the system and setup your windows environment. Step 4) Launch the LBA-PC windows application. Step 5) Configure the LBA-PC for your camera type. Step 6) Begin collecting data from your camera.
Note: If you purchased the optional 4 camera adapter, or the optional digital adapter then make sure that the slot immediately to the left (viewed from the front of your PC) of the above PCI slot is also empty, and remove its rear filler bracket also. Figure 1 Carefully plug your LBA-PC frame grabber card into the PCI slot. Make sure that it is fully seated in the PCI connector. Secure the end bracket with the screw that held in the filler plate.
The optional adapters use the rear panel opening, but do not plug into any of the PC expansion slots. Rather it is provided with a short ribbon cable that plugs into the frame grabber card. (See figures below) Slide the adapter into the rear opening and plug its cable into the frame grabber card. Secure the adapter bracket to the rear panel with the screw that held in the filler plate. Four Camera Option Figure 3 Operator’s Manual Doc. No. 10654-001, Rev 4.
Digital Camera Option Figure 4 Replace the cover of your computer. Restore the AC power to your computer. Note: The location of the connectors may vary depending upon which frame grabber model is being installed. The older LBA-400/500 series has a slightly different arrangement but the concept remains the same. 2.1.2 Step 2 Camera Connections If you purchased a Pyrocam III to use with LBA-PC, disregard this section and refer to your Pyrocam III Installation Guide.
2.1.2.1 Analog Cameras Connect the video out from your camera to the BNC connector on the LBA-PC frame grabber card. This is the camera 1 input channel. If you have the 4-camera adapter option, then camera 2’s input is at the top, 3 in the middle, and 4 at the bottom of the adapter bracket assembly. If you purchased your camera from Spiricon, you may have been provided with a Camera Control Cable.
Step 7) Double click the file in the LBA-PC folder named “Setup.exe” to launch the install. (The windows file extensions, for this folder, must be set to viewable to see the “exe” extension.) Step 8) Follow the instructions in the installation dialogs. Step 9) Reboot when installation is complete. Step 10) LBA-PC should now be installed. Second Method (Windows 2000 or XP): Step 11) Start Windows. Step 12) Close all other Windows applications.
2.1.5 Step 5 Configure Camera Type You should now have the LBA-PC application window on your monitor. The default configuration is for a basic CW laser setup. This will allow you to verify that your camera and hardware are operating correctly. If you received any error or warning messages while starting the LBA-PC application, refer to the Error Messages section in this chapter before proceeding. Before you can begin to collect data from your camera you must select the correct camera type.
The factory-supplied configuration files are write protected, so that you cannot accidentally lose or overwrite them. Each of these file names begin with a ~ (tilde), for easy identification. Some examples of these files are: ~lbapc.cfg The original default configuration. ~cw_basc.cfg A CW laser setup w/ basic results. ~cw_gaus.cfg A CW laser setup w/ Gauss Fit results. ~cw_hist.cfg A CW laser setup w/ Histogram display. ~cw_fram.cfg A CW laser setup w/ 8 frame averaging. ~cw_elip.
• Click on the Sound, video and game controllers listing. • If the LBA-PC frame grabber was detected, and the device driver was not loaded you will see a category called Unknown in the edit box listing of the Device Manager. If this occurs, double click on the Unknown icon. You should see an entry called PCI Card. This indicates that the device driver was not properly installed. To correct this problem, re-install the LBA-PC software.
The device driver was unable to allocate enough memory in order to capture video frames. This may occur the first time you boot the computer after installing the Frame Grabber card. Try rebooting the computer. If the error continues to occur you will need to add memory to the computer. LBA-PC requires a minimum 256 MB of main memory, 512 MB is recommended. If the error occurs after adding memory then contact the Spiricon Service Department. Frame Grabber not found. LBA-PC set to Off-Line mode.
2.4.1 Camera Power If your camera is a low power CCD style that runs on +12Vdc, then it may be powered from connector J1 (J3 on LBA-3/4/500 frame grabbers) pin 6 (+12Vdc) and pin 5 (gnd). Caution: Do not attempt to power more than ONE camera from the LBA-PC. 2.4.2 Shutter Controls Signals The electronic shutter control signals are provided on as SHUT1, SHUT2, and SHUT3. These are TTL level drive outputs. The Logic is positive true.
2.4.3 Trigger Out Connector J2 (J5 on LBA-3/4/500 frame grabbers) pin 3 is the Trigger Out signal. This signal is factory set to output +5Vdc pulses. You can change this signal to +12Vdc level pulses by moving Jumper E1 (E4 on LBA-3/4/500 frame grabbers) to bridge pins 2-3. Note: Jumper E1 (E4) controls the output signal level for both Trigger Out and Pass/Fail Out. Jumper position 1-2 yields a +5Vdc level; position 2-3 yields a +12Vdc level. 2.4.
2.6 Special Setup for Pyrocam I Operation You must use special setups if you want to successfully interface your Pyrocam I with a Model LBA-PC frame grabber system. It is strongly recommended that you first become familiar with the operating characteristics of both your Pyrocam I and LBA-PC before attempting to operate them together. To operate your Pyrocam I with a model LBA-300PC or a LBA-400/500/708/710/712/714PC without a digital camera option, see section 2.12.1.
2.6.1.2 Setup requirements for LBA-PC with pyrocam cameras: Two files are provided for configuring the LBA to a Pyrocam I. They are ~PYROCAM.CFG and ~PYROCAM.CAM. 2.6.1.2.1 Setting up the Pyrocam Configuration. Go to File. . . Restore Config. . . and set the configuration to ~PYROCAM.CFG. 2.6.1.2.2 Setting the camera type to Pyrocam Go to Options. . . Camera dialog box and set the Camera selection to ~PYROCAM.CAM. This may already have happened when you did the previous step. The ~PYROCAM.
2.6.1.3.5 Camera settings restrictions Under no circumstances, make any changes to the Advanced. . . Camera settings for the Pyrocam I. 2.6.1.4 Image synchronization considerations The Pyrocam I’s CCIR video output is always producing video images at the rate of 25 frames per second. Furthermore, it only changes output image after acquiring and processing a new image.
2.6.2.1.1 Set video switch The Pyrocam must be set to output digital video. This is accomplished by setting the MONO/DIG/VGA switch to the LBA position. See Chapter 6 in your Pyrocam Operator’s Manual. 2.6.2.1.2 Connect cable Connect the Pyrocam’s digital output to the digital input connector of the LBA-500PC. A special interface cable is required to make this connection. If you ordered your Pyrocam I, LBA-PC and LBA-Digital Option together as a system, then a cable was supplied. 2.6.2.1.
2.6.2.3 Image Synchronization Considerations The Pyrocam I’s Digital Output only produces an image each time new data is available. It will not continuously output the same frame repeatedly. Thus, the rate of new output beam images is a function of the Pulse or Chopping rate and image processing time. For this reason, you should operate the LBA-500PC in Video Trigger mode only.
Chapter 3 MENUS AND DIALOG BOXES 3.1 File. . . Drop Down Menu Selections 3.1.1 File | Load. . . A saved data file can be loaded into the frame buffer for display and results processing. Four types of data file formats are supported and are delineated by their file extension labels. The results obtained from these file types are not all of equal merit, however. The origin and meaning of these file types are as follows: .
Beginning with release v2.50, any of the three .lb3, .lb4, and .lb5 file types can be read by any of the LBA-300/400/500PC model types. However, the new .lb4 and .lb5 file types cannot be read by software released prior to v2.5. Beginning with release v4.00, any of the three .lb3, .lb4, and .lb5 file types can be read by any of the LBA-7XXPC model types. However, the new .lb7 file types cannot be read by software released prior to v4.00. Data files can contain one or more frames of data.
If the file that you are loading contains multiple records, enter the starting number of the record that you want to begin loading from, in the edit box labeled Start Record. Enter the Number of Records that you want to Load. You can enter a value of 0, or 1 to the number of records in the file. A value of 0 means all the records in the file. Records can only be loaded sequentially from the Start Record position.
3.1.2.1 Save As … Dialog Box Enter the drive:\paths\ of the File that you want to save. Press Browse... if you want to append or overwrite an existing file, and you are not sure of the file’s name or location and wish to search for it. Figure 7 Enter the Start Frame buffer location from which you want to begin saving or appending frame data files. If you wish to save multiple records, enter the Number of Frames that you want to save or append.
entries. The Summed image is organized Horizontal data first, left to right, followed by a carriage return, and then the Vertical data, top to bottom. Note: Exported image files cannot be read back into the LBA-PC’s frame buffer. Use Save As... and Load... for retrievable data files. 3.1.3.1 Export Image… dialog box Enter the drive:\paths\and of the Export File Name that you want to create. Press Browse...
000000.cma;000001.cma;...NNNNNN.cma Click on the image file Export Format (or Formats) that you want to generate. 3.1.4 Save Config… to a file The current setup configuration of the LBA-PC can be saved to a disk file. All configuration files have the .cfg file extension. Whichever configuration was the last to be saved (or restored), will become the default configuration the next time the LBA-PC application is run.
3.1.7 Generate Gain Clicking this item will cause the LBA-PC to execute an automatic Gain Correction calculation cycle. The results of this operation will store a gain correction table that will be used to preprocess all data frames newly acquired from the Frame Grabber card. The status of the Gain Correction condition is visible in the Gain correction Enunciator shown here and at the bottom of the LBA-PC’s main display screen.
• The Hardware Zoom. • The Hardware Pan location. • The Camera Type or Resolution setting. • The Camera Electronic Shutter setting. • The Video Gain and/or Black Level settings. Warning: Gain Correction should be used with only one camera at a time. It will not correctly operate in conjunction with the for camera option when automatic camera cycling is enabled. 3.1.8 File | Load Gain… You can restore a previously saved .gai Gain Correction file from disk.
Results Logging files will have a .rlg file extension name. Results Logging files are for exporting numerical results to other applications, such as Spreadsheets or Math programs. Text editors can also view them. Results files are saved in ACSII. Export Logging files can be of four different file types, .bmp, .cma, .spa, .cur. Export Logging files are write only. They are created for logging images for use in other applications like spreadsheets or math programs such as MathCAD. Unlike the .
If you choose Results Logging, select the Format that you want the data to be logged in. Both formats will produce an ASCII text log with comma-delimited entries. The Spreadsheet format will precede the log with a single list of column headings. The Math Program format will precede each log entry with a binary number that indicates which results are enabled. Figure 9 If you choose Export Logging, select the Format that you want the data to be logged in. The .BMP format will produce bitmapped image files.
If you use the Frames or Time method, the logging operation will automatically Stop! when the Frame count or the Timer values have run out. To protect the log file from inadvertent additions, use the above described terminate method to secure your log file. When Logging is Frames or Time limited, the Rate display will indicate the number of frames to go, or the time remaining . 3.1.11.
Because of the flexibility in setting control options, it is possible to set conflicting control parameters. Therefore, it is essential that these various conflicts be resolved by a prioritized control scheme. Of course, a perceptive operator can avoid all of these possible conflicts. Nevertheless, owing to the complexity of these features, setup errors are almost a certainty.
If Results Logging and Statistics are both in play, and if the Statistics feature is in control: The Statistics results are recorded into the Results Log file when the Statistics collection cycle is completed. 3.1.13 File | Print… The Print dialog box is where you tell the LBA-PC what information you want it to print. You can only , located on the get here via the File, and Print... menu item.
specifying the From Start Frame location, and the Number of Frames to print. The Number of Frames can be 0, or 1 to the number of frames in the frame buffer. 0 means all the frames in the frame buffer. When printing multiple frames you will observe that the LBA will cycle through the designated frame locations. It will compute the required results for each frame and then print whatever is required. At the end of this process, the last frame printed and its results will be displayed.
3.1.16.1 Save FROG as…Dialog Box Enter the drive:\paths\and of the FROG File that you want to save. Press Browse… if you want to overwrite an existing file, and you are not sure of the file’s name or location and wish to search for it. The FROG file format can be of two types, without a header or with a header. We recommend that you use the header format to add to the unique identity of each FROG file.
3.1.16.2 FROG Data Orientation The FROG software has the ability to flip axial assignments and directions. There is, however, a legacy defined orientation that we use as a basis for defining our axial representations. This is also the FROG default condition. Looking into the front of the camera, the upper left corner defines a starting point for the vertical Spectrum axis and then the horizontal Delay axis. (See figure below).
• DO consider Frame Summing if the FROG pulses are too weak to yield sufficient amplitude. • DON’T use the pan and zoom features or you will mess up the scaling parameters. You can minimize the Pan/Zoom child window to reduce temptation. • DO consider Frame Averaging if the FROG pulses are noisy. • DON’T enable Convolution. • DO use the Video Trigger method if pulse amplitude is high enough. • DON’T use apertures.
3.2 Options... Drop Down Menu Selections 3.2.1 Hide/Show; Capture, Display, Aperture Toolbar The above three toolbars can be selectively displayed or hidden based upon operator preference. Check the action that applies. The Capture and Display toolbars can be user defined to match the operators needs. The Aperture toolbar is predefined and can not be altered by the operator. 3.2.2 Aperture... display and define apertures The LBA-PC can display three types of apertures in four different shapes.
3.2.2.2 How to create a Drawn Aperture You can create a Drawn aperture by using the Aperture dialog box, the Aperture toolbar, or by dragging and dropping the aperture in the 2D display window. Note: Before you can use the drag and drop method you must first select a Drawn aperture shape using either of the first two methods. The Aperture dialog box, and the Aperture toolbar offer the same choices for creating a Drawn aperture.
Move the arrow cursor over the display window and press and hold down the RIGHT mouse button. This will reveal the Drag, Drop and Rotate hot spots of the Drawn aperture. Move the arrow cursor onto one of these hot spots, release the RIGHT mouse button and press and hold down the LEFT button. The cursor will change shape indicating the selected Drag and Drop function. Now drag the mouse to see what happens to the aperture. The four cursor styles perform the following operations: Moves the aperture center.
3.2.3 Camera... selection and display resolution The Camera dialog box is where you make the following selections: • Identify current Camera type, or Create a New Camera type. • Select the maximum image Resolution. • Select how large the Frame Buffer will be. • Select the Sync Source of your camera. • Modify the Pixel Scale if needed. • Apply Gamma correction if needed. • Choose the Lens mode if your camera is so equipped. 3.2.3.1 Camera type selection. Find your camera...
• Type in the new camera pixel scale value. • Verify that the Pixel Units are set correctly, change as required. • Double-click inside the Camera type edit text control. • Type in a new 8 character file name. The .cam extension will automatically be added if you fail to include it. • Click on Save CAM... • If the file path and name specified is correct, click OK. • You will return to the Camera dialog box. Click OK. Your new camera is now active, and saved as a .cam type file.
The Full 1x resolution will create an image size equal to the Horizontal Size and Vertical Size shown in the Camera…, Advanced dialog box. This size is the maximum obtainable from the type of analog camera selected. Digital cameras do not follow the above resolution table. For digital cameras both the Full 1x and 1x resolutions produce image sizes equal to the Horizontal Size and Vertical Size shown in the Camera…, Advanced dialog box. The 2x, 4x,..etc.
to use virtual memory as Frame Buffer space. A little virtual memory assigned to the frame buffer is not too bad. A lot can make you wonder what kind of alien being has just taken over your hard drive. Also, Windows will allocate real memory first, and when it’s gone, begin allocating virtual memory. For this reason it is a good idea to run the LBA-PC application with no other application(s) operating in the background. This will free up as much real memory as possible for Frame Buffer use. 3.2.3.
3.2.3.7 Pixel Scale, Pixel Units For analog cameras that use the Genlock sync source, only the V..ertical Pixel Scale is set. The pixel scale value is derived from your camera’s detector specifications, or is user programmable to match the characteristics of your optical system. For the camera imager based scale setting, the value to enter is the minimum line pitch of the camera’s detector.
3.2.3.9 Lens Click on this box if your camera is fitted with a lens. When enabled the 2D image orientation is adjusted to depict the image as if the observer is standing and viewing the scene from behind the camera. When disabled, the 2D image is oriented as if the observer is standing in front of the camera looking at the surface of the detector. 3.2.3.10 Special Camera Settings The Special Camera Settings dialog box contains the electronic parameters that define a camera to the frame grabber board.
Figure 17 The user can assign certain of these capture control items to the Capture Toolbar. The assigned items will appear on the toolbar in essentially the same order that they are listed in this dialog box. The operation of each item from the Toolbar is identical to their operation from this dialog box. For simplicity, the following examples will refer only to the dialog box entries. Toolbar switch icons will be included in the titles when they exist. 3.2.4.
frame, and then Stop!. Successive clicks on Start! will each cause one additional frame to be acquired. The Interval setting has no effect. • Block: This method will cause a Block Length specified number of video frames to be acquired from the frame grabber. What is unique to this method is that the frames will not be displayed, nor have results computed during the acquisition time.
file record number, and the Number of frames or records to post process. The number of frames can be 0, or 1 to the number of frames in the frame buffer or file. 0 means all the frames. The resulting frames will be placed sequentially into the frame buffer, beginning at the current frame buffer location. Be careful that you do not overwrite something you intended to save. The post processing toolbar switch selecting the above file name.
Figure 19 Operating hints: • Increasing Video Gain also increases video noise. Use Video Gain sparingly, or not at all. Leave it set to 1 whenever possible. • The Black Level will be adjusted automatically each time you perform an Ultracal! calibration cycle. Therefore, it is best that you make no changes to this setting. If you alter the Black Level after an Ultracal!, the calibration will no longer be valid. 3.2.4.3.
3.2.4.3.3 Automatic Camera Switching Using the Four Camera Option With the four-camera option automatic switching between camera inputs is made possible by checking more than one camera enable at a time. Input data frames are repeatedly cycled into the frame buffer starting with the lowest numbered camera after clicking Start! Example: If cameras 1, 3 and 4 are checked; data will be placed into the frame buffer sequentially from camera 1,3,4,1,3,4…, etc.
• Trigger Out: If your laser is a pulsed type, and you would like the LBA-PC to provide an output pulse that will cause the laser to be fired, use this setting. See Trigger Out and Interval and Trigger Out Delay. • Video Trigger: With this mode selected, the input from your camera is continuously monitored, and when a laser pulse is detected, the frame is captured. The pulse detector has a programmable threshold that is settable in the Video Trigger Level edit control.
See Chapter 5 for additional information and examples regarding Triggering. 3.2.4.5 Processing The Processing panel is where you select how to process digitized frames of data. This processing determines how each frame that is stored in the frame buffer will be constructed. This processing occurs prior to the calculating of any numerical results. Figure 21 The Processing options are applicable to both newly input frames from the frame grabber card, and to recorded frames that are being Post Processed.
• Ultracal processing cannot be a part of a post processing operation. Gamma Correction is also a type of processing. Gamma Correction is controlled from the Camera dialog box, as it relates to a specific camera’s characteristics. Gamma correction can be part of a post processing operation. 3.2.4.6 Frame Summing Click on this item if you want the LBA to sum frames. Specify the Number of Frames that you want to sum into each frame placed in the frame buffer.
Note: This edit control is repeated in the Beam Display dialog box and is available in the Display Toolbar. • If the Set Reference Source item is set to Current Frame, the data in the currently viewed frame will be copied to the Reference frame. • If the Set Reference Source is set to Last Gauss, and the Gauss Fit item in the Computations... dialog box is checked, then the beam profile resulting from a computed Gaussian fit to the currently viewed frame will be copied to the Reference frame.
3.2.5.1 Logging This switch will launch you into the Data & Results Logging dialog box. 3.2.5.2 Print This switch will cause the selected print options to be printed on your configured printer. You will not get a chance to reconfigure your printer or print setup item when you click this tool, so be sure that you have set your options up in File, Print Setup... before you click here. 3.2.5.3 Write Protect This tool can be used to write protect any frame in the frame buffer.
Figure 23 If you enter an Energy of Beam value of 0 (zero) the energy related results items, such as, Total (energy), Peak (fluence), Min, Gauss Height, etc., will be computed in processed digitizer units. Processed digitizer units are called counts, and are dimensionless. In this case, no units will be displayed in the results window. Any non-zero entry will cause the displayed results to be reported in the units selected.
For a detailed discussion of the above items see Chapter 4, Results Display, and Chapter 6, Computations. 3.2.6.4 Beam Width Method The Beam Width Method edit selection will determine the technique used to compute the beam width results. The first two methods (4 Sigma and 90/10 Knife Edge) are computed based upon industry standard definitions. The remaining three choices are user definable, so use care in setting up and restoring their related options.
3.2.6.4.2 90/10 Knife Edge This Knife Edge method uses a fixed 90% and 10% of energy as the moving edge Clip% points. The correction Multiplier is fixed at 1.561. These settings will yield highly accurate second moment equivalent beam widths for beams that are predominantly TEM00 in mode content, and for many other mixed mode combinations. There are a few modes for which this method will not be as accurate, as well as Top Hat shaped beams.
3.2.6.5 Elliptical Check on the Elliptical box to cause elliptical calculations to be performed. Having Elliptical results enabled will cause the nature of other calculations to be modified. In particular, Beam Width results will now be computed based upon the orientation of the Major and Minor axes of the beam, instead of the X and Y axes, as will the aligned Gauss Fit and Divergence results. See Elliptical in Chapter 6 for additional details. 3.2.6.
Hints: Use Drawn apertures and avoid Auto apertures when making Top Hat measurements. Use Percent of Peak as your beam width method. Typical Percent of Peak Clip% settings are 50%, 80%, and 90%. Refer to the Top Hat section in Chapter 6 for additional details. 3.2.6.8 Divergence Two methods are provided for making divergence measurements of your laser beam. The preferred technique is the Focal Length method.
3.2.6.8.2 Far-Field Divergence Measurements The Far-Field method requires you to measure the beam widths of your laser at two known locations in the beams far-field. The change in size is used to compute the rate of beam divergence in mili-radians. First collect a pair of Reference beam widths. The Reference data should be acquired at the smaller beam width location. Click Stop!, and note the location of your camera in the beam path. Open the Options…Computations dialog box.
Figure 28 Enter the Bucket Size in the provided edit control. A good value to start with is 16, 64, 256 or 1024, depending upon which model frame grabber you are using; an 8, 10, 16, or 14 bit format respectively. Refer to the Histogram section in Chapter 6 for additional details. 3.2.6.10 Statistics Check this box to enable the addition of Statistical information in the Results window. Statistical results will be computed for every numerical results item that is appearing in the Results window.
from the point of interruption. Rather the cycle resets to the duration values set in the dialog box, but does not clear the prior accumulated stats. If you click on Start! after the frame count or timer has run out, the collection process will continue to add more data to the results until the cycle completes a second time. To reset statistical data operations you must turn Statistics off, click OK, and then turn Statistics back on.
3.2.7.1 Beam View Inside the Beam Display… dialog, click either the 2D or 3D radio button for the display mode that you want to view your beam in. You may also toggle beam display with the 2D/3D button on the toolbar. Note: In general 3D displays will run slower than 2D owing to the amount of computations involved with generating the wire frame. 3.2.7.2 Cursors You may choose to place cursors onto either a 2D or 3D display.
Note: You must have the Elliptical computations turned on to permit the Major/Minor orientations to operate correctly, otherwise it will revert to the X/Y operating mode. 3.2.7.4 Origin Location The beam display window will always have an X/Y origin from which all other positional data will be referenced. A red dot visible in the Pan/Zoom window will indicate where the Origin location is set. The operator can choose one of four defaults, or manually locate the origin.
3.2.7.5 Beam Colors Your choice of beam display colors depends upon which display mode you have selected. There are 3 choices available in both 2D and 3D modes, plus 2 additional choices in 3D mode. They are: • Color Bands: 16 colors plus white to indicate intensities at, or near, A/D converter saturation. Available in both 2D and 3D. • Color Continuous: 128 colors plus white to indicate intensities at, or near, A/D converter saturation. Available in both 2D and 3D.
Another Hint: A good time to use Z Axis Scaling is when you need to view the low energy down in the wings of your laser beam. Kick the scaling up to x8, leave the scale scroll bar at the bottom of the slider, and maybe add in a little video gain and some frame averaging to quiet the noise. You’ll be amazed at what you can see! 3.2.7.7 Beam Display You can change how your beam is displayed without actually changing how it is processed nor how it is stored in the frame buffer.
appear in the display. This profile is a projection of the Current beam plus the Reference beam. All projections are made from the Cursor positions. 3D The Current beam will be displayed in Red. The Current plus the Reference will be displayed in Blue. If cursors are enabled they will follow the contour of the Current beam. 3.2.7.7.4 Reference Alone: 2D You must have both Cursors and Cursor Profiles enabled for this feature to operate. The Reference beam alone will appear in the display.
• If the Set Reference Source is set to Auto Gauss, and the Gauss Fit item in the Computations dialog box is checked, then the beam profile resulting from a computed Gaussian fit to newly acquired frames will be automatically copied to the Reference frame. In this mode, setting a reference frame manually does not make any sense because the next frame brought into view will automatically update the contents of the reference frame.
3.2.7.11 Copy Image to Clipboard If you click on the above button, the currently displayed frame image will be copied to the Clipboard in a .bmp format. This is a handy method for quickly exporting images from the LBAPC application to another application without having to go through the Export Image process. 3.2.7.12 Copy Image to Wallpaper If you click on the above button, the currently displayed frame image will be copied to your Desktop Wallpaper.
• Peak: Crosshair will be displayed, and its location is automatically drawn at the peak energy location of the beam. Note: This operation will not function correctly if the results window is minimized. • Origin: The Crosshair will locate to the position of the Origin. Note: The Crosshair might not be displayed if the Origin location is outside the display window, or it might be in an upper or lower left corner. To manually position the Crosshair, use the mouse to drag and drop it.
the color style selected to a Light Gray. Only the Contour display will remain in the selected Beam Color. Hint: Use the Color Continuous Beam Color type when using the Contour display style. 3.2.7.14.3 Rotate and Tilt You can use these edit controls to set the Rotate and Tilt angles of the X, Y, and Z axes. These controls are a quick way to set specific rotate and tilt values, but the simplest way to change the viewing angles is to use the scroll controls in the Tilt and Rotate window.
Figure 33 Note: Whenever you do a Soft Zoom while in 3D mode, the Wire Density will go to the highest resolution value possible, based upon the camera resolution setting. For example, if your camera resolution is 256x240, and your Wire Frame setting is 64x60, the first time you Soft Zoom into the image the wire frame resolution will change to 128x120. 3.2.8 Beam Display Toolbar You can select which functions you want to appear on the Display Toolbar by checking the desired item.
Figure 34 Note: The LBA-PC program must be running, collecting data and non-minimized for the pointing stability program to collect data. 3.2.9.1 Main Controls The main controls are located in a toolbar in the upper left corner of the main window. These controls consist of buttons for Start, Pause, Reset, Printer Setup, Print, and Exit Program.
3.2.9.1.1 Start Button The Start Button begins data collection. However, if the LBA-PC is not collecting data in the background, then clicking this button will not result in data being plotted. In order for Beam Stability to work, the user must make sure that LBA-PC is open and collecting data in the background! 3.2.9.1.2 Pause Button The Pause button stops the data graphing but doesn’t reset the graphs, thus data is preserved from one pause operation to the next.
Figure 36 A sample of data is defined as; any results computed from a discrete beam image captured from LBA-PC. The beam stability window will compute it’s results based on samples taken from the time the Start arrow is closed 3.2.9.2.1 is clicked, until the beam display is Reset , or until the application and restarted. Sample Limit The strip chart display may become so compact that recent data points become visually indiscernible from the rest of the data in the strip chart.
Example: If the user has collected samples [1-1000] and the Sample limit it set to 100, samples [900-1000] will be the only samples visible in the strip chart. Statistical results will be computed using all the samples [1-1000]. 3.2.9.2.2 Samples The Samples indicator shows the total number of samples collected. 3.2.9.2.3 Check Boxes The Check Boxes allow the user to specify what results items are to be graphed on the strip chart.
to use it as it relates to pixel units on the detector array. If you choose to do pointing stability using spatial units such as mm or µm; the bins of the scatter/histogram plot and the horizontal and vertical grid lines will not have any correlation to the individual pixels on the detector. In other words, the bins in the histogram and the pixel grid of the detector will not have the same crosshatch granularity.
Figure 37 The Centroid and Peak Histogram windows now have horizontal and vertical plot scaling in units of pixel, with histogram bins the size of a single pixel. Note also that we have the same plot orientation as the LBA-PC beam window. In the Figure above we can see that most of the centroids are falling 232 pixels from the left and 247 pixels from the bottom (assuming that your origin is set to Window LL).
Figure 38 3.2.9.3.1 Zooming Histogram Plots The zooming feature for histogram plots works basically the same as it does for the strip chart window. (See Strip Chart Zooming) 3.2.9.3.2 Capture Resolution Settings. When setting capture resolutions to settings other than Full and 1X, it is important to note that the peak location scatter plot will not have peak locations on any pixel location in the array.
Figure 39 Note how peak locations seem to fall in a grid like pattern. This is to be expected when you are capturing every 4th pixel. 3.2.9.3.3 Real World Units Setting LBA-PC’s Quantitative results to real world units of length such as µm and mm may be accomplished by going to the main menu and choosing: Option > Camera Make the appropriate real world unit selection in the Pixel Units drop down box.
3.2.9.3.4 Increment Bins and Reset The centroid scatter-plot is also a histogram of the centroid location. The color bar between the Peak and Centroid plots provides the user insight about centroid location/frequency. Colors in the upper part of the bar indicate higher frequencies. When running, the user will notice that blocks of data points have the same color. These blocks of color represent the binning of the histogram.
Figure 40 Upon opening, the above two horizontal color bars will be black. The designer can create a new palette by placing seed colors into the upper bar and observing the resulting palette in the lower bar. Colors on the left represent low intensities while colors on the right represent high intensities. The upper bar contains entries for 128 individual colors, numbered from 0 on the left to 127 on the right.
Figure 41 The user can either select one of the basic colors from the set on the left of the dialog, or create a custom color using the controls on the right. Clicking OK will place the selected color into the upper bar. Continue to add seed colors until the displayed palette matches your desired effect. To remove a seed color from the upper bar simply right-click on it. 3.2.10.1 Saving the Palette Once you have the palette design looking the way you want it click the Save Palette button.
Note: Palettes saved as .pal file types cannot be loaded into the Palette Generation Tool (PaletteGen2.exe) for editing! 3.2.10.3 Load Colors The Load Colors button is used to load the seed colors from .sp2 files into the Palette Generation Tool for editing. Note: Users should save a .sp2 file for each .pal file they desire to tweak at some later date. 3.2.10.4 Clearing Colors Removes all seed colors and resets the palette display. Operator’s Manual Doc. No. 10654-001, Rev 4.
3.2.11 Password Lockout You can enter a Password that will cause all of the LBA-PC setup functions to become inaccessible. The password acts as a toggle. Type in the password once and all setup options will become disabled. Type it in a second time and setup capability will be restored. The password has been factory set. To find out your password call the Spiricon Service Department at 435-753-3729 between the hours of 9:00 am and 5:00 pm MST.
3.3.1.1 PASS or FAIL results The remaining Pass/Fail dialog boxes are used to set the Pass/Fail limits for the results items that you want to test and screen for. When you check an item, you turn on the Pass/Fail screening for that particular result. At the same time, you change how that result item will appear in the results window. If a results item is being tested and it fails the test limits, the displayed color will appear RED; if it passes the test limits, it will appear in GREEN. 3.3.1.
3.3.2.2 Centroid The Centroid Pass/Fail item allows you to define a circle that must contain the centroid of the beam energy. To implement this test you must define the location of the center of a circle in terms of its X and Y coordinate in the beam display window, and the Radius of the circle that must contain it. Both the X and Y Centroid location results will change color from GREEN to RED should the centroid fall outside this circle. 3.3.
3.3.5.1 Top Hat Fluence The Top Hat computational results displays a value for the Max and Min fluence observed in a Top Hat beam’s energy profile. This result is affected by which Top Hat method is being employed. The Top Hat Fluence Pass/Fail edit control items are applied to both the Max and Min fluence results. It is anticipated that the Minimum Pass/Fail limit is primarily applicable to the Min results, and that the Maximum Pass/Fail limit is primarily applied to the Max results.
3.4.1 Tile Click on the Tile item to force all of the LBA-PC child Windows to return to their default sizes and locations. 3.5 Start!/Stop!... A Toggle Menu Action Item Activating the Start! menu item will cause the LBA-PC to start collecting and processing frames of data. The source of the data frames can be either live video input to the Frame Grabber card, if installed, or from previously stored data files. Refer to the Capture Method section for source selection.
3.6.2 What Disables Ultracal! Ultracal will become DISABLED if certain data collection conditions, that were in effect when the Ultracal operation was executed, are no longer in effect. In all cases, these conditions are the result of an operators change to the spatial acquisition settings. The DISABLED condition will occur if you make changes to: • The Hardware Zoom. • The Hardware Pan location. • The Camera Type or Resolution setting. • The Camera Electronic Shutter setting.
Notice: Some cameras suffer a reduced operating dynamic range when very short exposure times are employed. This can be seen as a dramatic change in the camera baseline or as a reduction in the camera’s saturation level. If your camera reacts in one of these ways you may find that the AutoExposure technique will fail to yield optimum results.
Operator’s Manual Doc. No. 10654-001, Rev 4.
Chapter 4 DISPLAY WINDOWS 4.1 Main Window You will probably want to run the LBA-PC application main window in its maximized display size. This will allow you to cram as much information as possible onto your display. We recommend that you operate in a minimum 1024x768 mode, larger if your graphics hardware and monitor will support it. The Main Window is divided into 5 regions. They are laid out from top to bottom and are designated as: 1.
Figure 45 4.2.1 Frame Comment The Frame Comment is a text string label that you can attach to a data frame. It can be saved with the data file, and it will print as a title if you choose to print the associated frame. You can replace the number by double-clicking inside the Display Window’s title bar. The Frame Comment dialog box (see below) will appear.
number will appear. Both the comment and the data frame can, however, be Write Protected. If the Assign to All frames box is checked: This comment will be applied to all valid frames in the frame buffer. • Empty frames will not be commented. • New frames that are acquired will not be commented. • Write Protected frames will be commented.
4.2.2 Shortcuts In the Beam Window… Double left click to bring up the Beam Display dialog box. 4.3 The Results Display Window This window will display the computed results based upon the selections enabled in the Computations dialog box. You can minimize, maximize, or resize this window. The top title bar in this child window will indicate the Frame number associated with the current result values.
Figure 49 Hint: A short cut that will turn off the computed results is to minimize this window. 4.3.1 Shortcuts In the Results Display Window… Double left click to bring up the Computations dialog box. Right click to bring up a Shorthand Results selection pop-up window. This pop-up will allow you to enable or disable the individual results items, plus provides a quick way to Reset the Statistics results and also a method to save the current results to the Clipboard.
4.4 The Pan/Zoom Display Window This window provides you with a graphical representation of where and how the digitized image relates to the detector on your camera, and the tools to modify those setting. The regions indicated in this display are not drawn to scale. This window can be minimized but not resized. In this window you can: • Hardware Zoom-in and Zoom-out. • Soft Zoom-in and Zoom-out. • Pan the Window vertically and horizontally.
4.4.1.1 Analog Camera Zooming The chart below depicts the zooming process for an analog (non-digital) style camera. The starting point is based upon how you configured the image size and resolution in the Camera dialog box. First find your resolution factor in the top row. Then drop down to the display width size. In the example below the resolution is x8, and the width is 64. Each time you zoom in you’ll be following the arrows leaving each location and leading to the next.
4.4.1.2 Digital Camera Zooming Digital camera zoom image sizing does not follow the same powers-of-two rule that is shown above for analog cameras. For digital cameras both the Full 1x and the 1x resolutions are the same size, and that size is set to the maximum imager dimensions that the Spiricon frame grabber can reliably capture. This can vary from camera to camera based upon the pixel clock rate and other image framing characteristics unique to each camera design.
Figure 53 4.4.4 Zooming and Panning Constraints The Camera Resolution that you have set in the Camera dialog box will constrain how your displayed image can be positioned by the Panning and Zooming controls. For example: If you have set the Camera Resolution to 4x, then the image can only be positioned onto pixels whose locations are even multiples of 4, such as. . .0, 4, 8, 12, 16. . .128, . . .etc.
4.6 The Histogram Display Window This Histogram display window is visible only when the Histogram check box is enabled in the Computations dialog box. This window can be minimized and resized. This bar chart is a fluence Histogram of the currently displayed frame of data. Each bar in the display represents a fluence Bucket. Each Bucket describes a range of quantified fluence values.
4.7 Shortcuts using the Mouse A number of shortcuts are available that allow you to access some of the dialog boxes without going through the menu drop downs. These involve placing you mouse cursor into a region of a child window and then clicking either the right or left mouse button. These shortcuts methods are described below: 4.7.1 Shortcut to the Computations Dialog Box • Double-left-click in the Results window. • OR, Single-right-click to bring up a Shorthand Results selection pop-up window.
Operator’s Manual Doc. No. 10654-001, Rev 4.
Chapter 5 TRIGGERING TYPES & CAPTURING METHODS 5.1 Triggering the LBA-PC The LBA-PC can support four basic types of triggering: • CW (or no trigger required), for lasers whose light output is continuous or pulsed at such a rate as to appear continuous to a camera (typically faster than 1000 Hz). • Trigger Out, for lasers that can be pulsed by the LBA's trigger output. • Trigger In, for lasers that can supply a trigger pulse to the LBA's trigger input.
Since the perfect camera has not yet been found, we advise most LBA-PC users to operate pulsed lasers in Trigger Out mode whenever possible. Next best choice is the Video Trigger mode. These two modes will produce the most repeatable quantitative results. 5.1.2 Trigger Type CW The setup for CW timing is the least complex of the setups. Therefore, we recommend that you use CW mode to verify that your camera is correctly installed and is operational.
field rate of 60 Hz can cause a trigger pulse to output at a 30 Hz rate. A non-interlaced camera running at a frame rate of 60 Hz can produce a trigger output pulse at a 60 Hz rate. 5.1.3.2 Trigger Delay The LBA-PC will produce trigger output pulses at the programmed frame Interval rate. With the Trigger Delay check box deselected, the trigger output pulses will occur at vertical sync time.
5.1.3.7 CCD Frame and Interline Transfer Cameras, Non-interlaced (Progressive scan) These camera types can produce 1x high-resolution images. The video output from each laser pulse will occur during the next frame outputting immediately after the laser trigger arrives. 5.1.3.8 CMOS, CID Line Transfer and Tube Cameras, Non-Interlaced (Progressive scan) These camera types can produce 1x high-resolution images. Leave the Trigger Delay box disabled for all of these camera types. 5.1.
and ½ the maximum possible counts based on the number of A to D conversion bits. For example: If you are using an LBA-712PC frame grabber (a 12 bit digitizer) you have the following possible Video Trigger Level choices: 256, 512, 1024, 2048. If you set the level to 512, the LBA will capture a laser beam pulse as soon as it detects a pixel raw energy value of 512 or greater. Unless your camera is very noisy we recommend that you use the minimum level as a starting value. 5.1.5.
Example: With the Capture Interval set to 10, and a 30 Hz frame rate camera, the capture rate will be 3 fps. 5.2.1.2 With Trigger Type set to Trigger Out The frame rate of the camera and the Trigger and Capture Intervals will combine to determine the capture rate. Example: With the Capture Interval set to 10, and the Trigger Interval set to 5, the captures will occur once for each 50 frames. If your camera has a 25 Hz frame rate, the capture rate will be once every 2 seconds, or 1/2 Hz. 5.2.1.
Note: Do not confuse this type of integration control with features on high-end digital cameras that have externally programmable integration controls. These later types of cameras are programmed by issuing serial commands to the camera’s internal microprocessor. See section 5.4 for a discussion of these types of cameras. 5.3.1 Integration Operation The Integration control is found in the Options, Capture, dialog box.
operates in a binning mode compatible with the LBA application then we will often supply multiple camera configuration files, one for each bin format. Camera binning can occur in two different styles. When the pixels are binned equally in both the horizontal and vertical direction, the resulting image maintains its aspect ratio and is best for operating in the LBA-PC application.
this period exceeds 3 seconds then the Video sync enunciator may turn RED. Under this condition this signal can be ignored. The next frame should be captured when the next trigger pulse triggers the camera. 5.4.1.5 Digital Camera Gain and Black Level Control Most digital cameras have programmable gain and black levels. These settings often have default values that are not optimum for laser beam analysis. Usually the gain is too high and the black level is too low.
Operator’s Manual Doc. No. 10654-001, Rev 4.
Chapter 6 COMPUTATIONS 6.1 Computational Accuracy Once you have mastered the skill of acquiring your laser beam's profile on the screen of the LBA-PC, your next thoughts will usually be directed toward the accuracy of the quantitative results. The degree of accuracy of the computed results will be based primarily upon two factors. The first, and most significant, is the correct nulling of the background energy. The second has to do with optimizing the presentation of the beam display.
6.3 Beam Presentation Affects Results Effective beam presentation is essentially an attempt to improve accuracy by increasing the signal-tonoise property of the digitized data. Since the camera and the digitizing process primarily fix the noise level, most of our efforts will concentrate on increasing the signal content. Always try to optimize your beam's amplitude into the camera's dynamic operating range.
Ultracal! every 10 to 15 minutes, or whenever you think your camera may have strayed. This drift can be observed as changes in the background noise image. Un-illuminated areas will appear as gray and dark violet (almost black) random noise. If the background starts to look too gray then the baseline is drifting negative. If too dark, then the baseline is drifting positive. Note: These colors apply to the Continuous 128 color palette. They change depending upon the palette selection. 6.
energy results. The Units entry will determine the energy units that will appear behind the various energy displays, i.e., Peak mw/cm², etc. If you are using a Drawn Aperture (without an Auto Aperture), then the Total Energy is the amount of energy inside the Drawn Aperture. If you are using an Auto Aperture (with or without a Drawn Aperture), then the Total Energy is the amount of energy inside the Auto Aperture. Thus... An Auto Aperture takes precedent over a Drawn Aperture. 6.
The following equations describe the X and Y centroid locations from the collection of data points that satisfy the above energy clip level criteria. x centroid = ∑ ( X × z) ∑z y centroid = ∑ (Y × z ) ∑z Where: X = x locations of selected pixels. Y = y locations of selected pixels. z = value of selected pixels. 6.11 Beam Widths and Diameters To some extent, beam width is a term that describes how you have decided to measure the size of your laser beam.
The standard deviations are derived from the variances of the energy distributions and are equal to the standard deviations squared.
equivalent second moment width for TEM00 beams, and are a good approximation for many beams of mixed modes. The second Knife Edge selection will allow you to program your own Clip% and Multiplier values. This option will allow you to set up for beams requiring special settings, which could get you into all kinds of trouble, since you can set these values to just about anything you like.
The Orientation of an Elliptical beam is determined from the clip level. A smaller percent of peak or larger percent of energy will include more pixels, in the orientation calculation. A larger percent of peak or smaller percent of energy will include fewer pixels. Depending upon your laser beam this setting can have serious implications. The Orientation is defined as the angle formed between the Major axis and the horizontal, pointing to the right.
Amin = ∑∑ (Z xy − S xy ) 2 x y Where: Zxy = Amplitude of the pixel data at (x,y). Sxy = Amplitude of fitted surface at (x,y). 6.14 Whole Beam fit equations The bivariate normal equation is used to fit data in two locked directions, X and Y. The Whole Beam selection assumes the beam is round or elongated parallel to the horizontal or vertical axis.
for the Y or Minor axis J = J me m−m − 2 wm / 2 2 Where: = = Amplitude at the point m. Amplitude at the Gaussian center. = = wm * = Location of pixel. M location of the Gaussian center. Width at 1/e² of energy. J Jm* m m Parameters marked with an asterisk (*) are variables fitted. M & m are not the same as the displayed Centroid Major and Centroid Minor results. However, they are used to compute those results items.
becomes better and vice versa. The Correlation gives a relative feeling for how well the data matches a Gaussian surface. However, this result is relative, not absolute. A result of 0.8 tells us the data is a better Gaussian shape than a result of 0.7 and a worse Gaussian than 0.9, but it does not tell us how much more or less. A change from 0.85 to 0.9 tells us there was an improvement but does not tell how much. The definition of the Correlation can be seen in the equation below.
Notice: In general it is not advisable to use the Auto Aperture feature when making Top Hat measurements. 6.18.1 Top Hat Mean and Standard Deviation The computation of the Mean and Standard Deviation are described in the equations below: for the Mean, Z= ∑Z n Where: Z n ΣZ = = Mean intensity Number of summed pixels = Sum of the pixel intensities above the clip level, or in the area, or on the line being evaluated. for the Deviation, σ= ∑ (Z − Z) 2 n −1 Where: σ = std. deviation.
parameter to describe quality of a Top Hat’s energy distribution. A perfect Top Hat has a single fluence value that makes up 100 percent of energy and plots curve A. The area under this curve yields the Top Hat Factor value of 1.0. A Gaussian beam plots the curve labeled C. The area, and thus the Factor, for beam C is 0.5. Real-world Top Hat beams will plot curves somewhere between A and C, such as curve B. Thus, as the area under the curve approaches unity, the quality of the Top Hat is seen to improve.
Where: F = The Top Hat Factor (area under the curve) 6.20 Effective Area and Effective Diameter All of the pixels that are above the clip level are included in the Effective Area and Diameter results. If an aperture is present then the analysis is confined to just the pixels inside the aperture. The sum of the areas of all the pixels above the clip level is the Effective Area.
f = The focal length of the imaging optic at the wavelength of the laser. If you are not already versed in the theory behind the Focal Length method, we recommend the following reference document: Laser Far-Field Beam-Profile Measurements by the Focal Plane Technique, by G.W. Day and C.F. Stubenrauch, NBS Technical Note 1001, March 1978. This publication is no longer in print. A copy can be obtained from the Spiricon Sales or Service department. 6.21.
Figure 57 The numbers displayed along the left edge of the Histogram, indicate the lower value of each Bucket. The numbers along the right edge of the display is the total count of the number of pixels that have been placed into each of the Buckets. The length of the drawn bar represents the depth to which the Bucket is filled. Zero count is on the left.
for the Standard Deviation, ∑( n σ= S−s n =1 ) 2 n −1 Where: σ = = Σ(S - s )² = n std. deviation. number of samples. sum of the square of the differences between the mean and each sample. The Maximum and Minimum are just the largest and smallest values encountered in the samples. 6.24 Frame Averaging The signal to noise ratio of the digitized data can be improved by using Frame Averaging. The amount of the improvement is roughly the square root of the number of frames being averaged.
When Frame Summing is enabled, the display will update with the summed results only after all frames have been received. Any calculations will similarly be performed only after all frames have been received. Notice: When Frame Summing is enabled and you click on Stop!, the LBA will immediately abort the collection of frames for summing and will display the last completed set of summed data.
6.27 Convolution Convolution algorithms in the LBA-PC may take on a number of forms, some of which might not fit the exact description that is to follow. In the broadest sense, convolution refers to a general-purpose algorithm that can be used in performing a variety of area process transformations. One such generalpurpose algorithm will be described here. For the purpose of this description, the best way to understand a convolution is to think of it is a weighted summation process.
Figure 59 Operator’s Manual Doc. No. 10654-001, Rev 4.
Chapter 7 DIGITAL CAMERA OPTION 7.1 Digital Camera Option This section will discuss how to interface a Digital Camera with an LBA400/500/700/708/710/712/714PC-D equipped with the Digital Camera Option. This option is identified by the presence of a –D in the title bar model designation. The frame grabber will also be provided with a short ribbon cable adapter that plugs into the frame grabber and has a 50 pin connector attached to a PC mounting bracket. 7.
Digital Camera Connections for LBA-400/500 Model Frame Grabbers Figure 60 VD12+ VD13+ VD14+ VD15+ VD12VD13VD14VD15- Digital Camera Connections for LBA-7XX Model Frame Grabbers Figure 61 Operator’s Manual Doc. No. 10654-001, Rev 4.
Signal definitions are as follows: References to LBA settings are found in either the Camera or Camera Advanced dialog boxes. For digital cameras, set the Sync Source to Digital. PCLK+/Connect your camera’s pixel clock to this input. Either the rising or falling edge of this signal will denote the time when your camera’s pixel data should be sampled. If your camera data is to be sampled by the falling edge of PCLK+, set the ERC Polarity to Positive.
VD15-0+/-… LBA-7XX Connect the digital data signals to these inputs. VD11 is the MSB and VD0 is the LSB. Connect the LSB from your camera to VD0. Unused connections must always involve the MSB’s. VD+ must be a logic high to denote a true condition of a data bit. Set the Pixel Bits value to the number of data connections supported. Note: If the output from your digital camera is in a signed two’s compliment data format, connect the sign bit to the bit just above the cameras MSB data bit.
If your camera has fewer data output signals than the LBA has inputs, then use the upper most data inputs, starting at VD11, and cut open the following jumper traces: • For an LBA-500PC with a 10 bit digital camera, cut open E7 and E8. • For an LBA-500PC with an 8 bit digital camera, cut open E7, E8, E9 and E10 • For an LBA-400PC with an 8 bit digital camera, cut open E9 and E10. Note: Jumper cuts are made between square shaped circuit pads labeled with “E#” designators.
by 256 rows of video and then 20 rows of black, try a first value of 18 (24-6) for Vertical Start. If your camera is interlaced, and each frame outputs a total of 525 rows (i.e. 262.5 rows per field), and the first 32 rows of each frame are black, followed by 490 rows of video per frame, try a first value of 20 (32-12) for Vertical Start. 7.3.4 Vertical Size This value must always be an even number: Enter the number of rows that contain video data.
Adjust the Vertical Start value according to the following rules. (Remember you must input even values.) To move the image DOWN, decrease the Vertical Start value. To move the image UP, increase the Vertical Start value. Adjust the Horizontal Start value according to the following rules. (Remember you must input even values.) To move the image LEFT, decrease the Horizontal Start value. To move the image RIGHT, increase the Horizontal Start value. When the image is centered be sure to save a .
If your camera has a signed two’s compliment data format, the Ultracal! function will be disabled. Under this condition it is assumed that the camera is self-calibrating, or provides a calibration capability to the operator. Operator’s Manual Doc. No. 10654-001, Rev 4.
Chapter 8 REMOTE OPERATION 8.1 Remote Operation The LBA-PC has nearly full GPIB remote control capabilities and partial ActiveX remote control capabilities. During the installation phase you were asked if remote operation was required. If you answered yes to the query, the installation process will have loaded the appropriate device drivers that allow the LBA-PC to communicate with a National Instruments GPIB interface card. The ActiveX servers are always available.
Operator’s Manual Doc. No. 10654-001, Rev 4.
Chapter 9 ACTIVE X 9.1 Introduction The LBA-PC ActiveX server provides simple control of LBA-PC along with access to frame data, beam display image, results, statistics, and pass/fail indicators. The LBA-PC ActiveX server runs under Windows 2000 and Windows XP Professional.
2. Go to the Visual Basic Editor. On the Tools menu, select Macro, and then select Visual Basic Editor. A new VBA window will open. 3. Reference the LBA-PC ActiveX server. On the Tools menu, select References… Scroll down until you see LbapcActiveX EXE. Select the checkbox to the left of LbapcActiveX EXE. 4. For this example, we will use the LBA-PC ActiveX server in a form. Create a new form. On the Insert menu, select UserForm. A form is displayed in a new window. 5.
the next line, type “LbapcActiveX.Open” without the quotation marks. This statement initiates communication between the LBA-PC ActiveX control and LBA-PC. 5. Respond to LBA-PC ActiveX events. . In the left list box, select LbapcActiveX. A new subroutine called LbapcActiveX_OnNewFrame() is created. This subroutine is called every time the LBA-PC collects a new frame of data. An example Visual Basic project, LbapcActiveXExample.
9.3.1 Methods - Functions you can call to perform some operation Events - Notification when things happen Properties 9.3.1.1 AppInfo AppInfo is a two-dimensional array of integer packaged as a Variant. The leftmost dimension is 0 to 31 and the rightmost is 0 to 2. This array contains information about LBA-PC applications that are running and available for ActiveX connection. AppInfo is used to decide which application to connect to and which index to send to the OpenIndex method.
9.3.1.4 OperationError This property indicates any previous operation errors. This bit flag is defined as follows: 0x0001 Attempt to Start running while Ultracal or Auto Exposure 0x0002 Attempt to Ultracal or Auto Exposure while running 0x0004 LoadConfig method failed Values are added to this property but never removed. Write a 0 to reset this property. 9.3.1.
9.3.1.11 CrosshairX, CrosshairY, CrosshairZ These properties provide the crosshair x and y location, and the value of the pixel at the crosshair. 9.3.1.12 CursorDelta This property provides the straight-line distance from the cursor to the crosshair. 9.3.1.13 EnergyOfBeam This property lets you calibrate the LBA to the energy of your laser. Setting this property is identical to setting Energy of Beam in the LBA-PC Computations dialog. See sections 3.2.6.1 and 3.2.6.
9.3.1.16 Results This property provides all of the LBA-PC results, except statistics, in a one-dimensional array of doubles packaged as a Variant. The results are loaded into the array in the following order: 1. Quantitative 2. Elliptical 3. Gauss Fit – whole beam 4. Gauss Fit – major axis 5. Gauss Fit – minor axis 6. Top Hat – whole beam 7. Top Hat – major axis 8. Top Hat – minor axis 9. Divergence This is the same order as listed in sections 3.1.15 through 3.1.
QuantBeamWidthY Width X (Width Minor) QuantDiameter Diameter Note the QuantRadius property. This is a new result not displayed by LBA-PC. This result is the distance from the Origin to the Centroid. Since the centroid is already relative to the origin this result is defined as: Radius = (C 2 x × Cy 2 ) The Origin is specified in the Display dialog in the LBA-PC. See section 3.2.7.4 in the LBA-PC User’s Manual for more information.
GaussMajorCentroid Centroid X GaussMajorWidth Width X GaussMajorHeight Height X GaussMajorDeviation Deviation X GaussMajorCorrelation Correlation X GaussMinorCentroid Centroid Y GaussMinorWidth Width Y GaussMinorHeight Height Y GaussMinorDeviation Deviation Y GaussMinorCorrelation Correlation Y 9.3.1.20 Top Hat Results These properties provide individual Top Hat LBA-PC results. For more information, see chapter 6 in the LBA-PC Operator’s Manual.
TophatEffectiveArea Factor TophatEffectiveDiameter Effective Area TophatFactor Effective Diam 9.3.1.21 Divergence Results These properties provide individual Divergence Fit LBA-PC results. For more information, see chapter 6 in the LBA-PC Operator’s Manual. Property Name LBA-PC Result DivergenceX Divergence X DivergenceY Divergence Y 9.3.1.22 Statistics Results The Statistics property provides all of the LBA-PC statistical results in a two-dimensional array of doubles packaged as a Variant.
1 Standard Deviation 2 Minimum 3 Maximum All results values will be loaded into the array all the time. Results not enabled in the LBA-PC will be zero. Note there are three sets of Gauss Fit and Top Hat results. Either the whole beam section or the major and minor sections will contain valid results depending on how the LBA-PC is configured. 9.3.1.23 Pass/Fail Results The PassFailFlag and PassFail properties provide all of the LBA-PC pass/fail test results.
1 Pass All results values will be loaded into the array all the time. Results not enabled in the LBA-PC will be zero. Note there are three sets of Gauss Fit and Top Hat results. Either the whole beam section, or the major and minor sections will contain valid results depending on how the LBA-PC is configured. 9.3.2 Methods 9.3.2.1 LoadConfig This method causes the LBA-PC to load the specified configuration file.
0 OK 1 Other initialization error 9.3.2.3 OpenIndex This method initiates communication between the LBA-PC ActiveX control and LBA-PC. You must call this method, or the Open method, before calling any other method or accessing any of the properties. If you do not call this method, then all the properties will be zero, methods will have no effect, and no events will fire. OpenIndex takes one parameter, which is the index of the application you want to connect to.
-1 The LBA-PC is not available 0 OK 1 LBA-PC is collecting frames of data The Ultracal operation runs for unknown amount of time depending on the camera and the LBAPC configuration. Poll the OperationComplete property or respond to the OnOperationComplete event to determine when the Ultracal operation is complete. 9.3.2.7 Auto Exposure This method is identical to clicking AutoExposure! on the LBA-PC. This method has no effect if a previous Auto Exposure operation is not complete.
Capture Mode Single Shot N/A The LBA-PC stops after collecting one frame. Property values will not change until the LBAPC receives another Start command. Continuous FALSE The LBA-PC will continuously update property values. By the time a VI can read property values after the OnNewFrame event, the values have changed. Use this configuration if you do not care which frame the properties relate to. Continuous TRUE The LBA-PC will set property values that correspond to the same frame of data.
9.4.1 Remote Access 9.4.1.1 Server (LBA-PC) Computer To enable remote access to the LBA-PC computer, follow the steps in the section below for your operating system. 9.4.1.1.1 Windows 2000 1. Start DCOMCNFG. From the Start menu select Run…, type dcomcnfg and click OK. 2. Enable DCOM. On the Default Properties tab, select the Enable Distributed COM on this computer check box. 3. Configure LBA-PC ActiveX server. On the Applications tab, scroll down until you see LbapcActiveX EXE.
ii. Application Security. From the LbapcActiveX EXE | Properties window, click on the Security tab. Enable and edit the custom access and launch permissions to allow access from the remote computer. 9.4.1.2 Client (Application) Computer To enable remote access from the application computer, follow the steps in the section below for your operating system. 9.4.1.2.1 Windows 2000 1. Copy the LBA-PC ActiveX server. Place a copy of the files LbapcX.exe and LbapcX.tlb on your application computer.
9.4.1.2.3.1 Windows 2000 1. Start DCOMCNFG. From the Start menu select Run…, type dcomcnfg and click OK. 2. Configure the client computer for automatic remote access. On the Applications tab, scroll down until you see LbapcActiveX EXE. Click on LbapcActiveX EXE then click the Properties… button. Click on the Location tab. Unselect the Run application on this computer check box. Select the Run application on the following computer: check box.
Note: The Default Protocols tab in DCOMCNFG appear to be only guidelines. Network protocols can still cause DCOM problems even if they are removed from the Default Protocols list. You must remove the protocol from your network connection. • Use Microsoft resources. Search Microsoft articles and knowledge base for an error code or error message. The Microsoft Developer Network web site, msdn.microsoft.com, contains a wealth of information for developers. • Use National Instruments resources.
Chapter 10 REMOTE GPIB OPERATION 10.1 Introduction The LBA-PC can be controlled as a remote device via GPIB. For the most part, communications between the LBA-PC and the host controller will follow the data format and coding protocols outlined in the IEEE 488.1 and 488.2 standards. This manual will not attempt to fully describe the nuances of the GPIB bus operation nor to convey fully the operation of the IEEE 488.1 and 488.2 protocols.
5. Click on the Advanced tab, make sure that Automatic Serial Polling is not checked. 6. Click OK. NOTE: It is possible for the LBA-PC to generate many service requests per second and the NI-488.2M default is to queue service requests. For these reasons we suggest you disable Automatic Serial Polling on both the LBA-PC and the host controller.
10.4 Command Formats and Responses Commands to the LBA-PC will not normally generate a response back to the host controller, unless the command: • Changes remote/local mode • Is a query • Initiates an operation that produces results • Generates an error 10.4.1 IEEE 488.1 Command Support The LBA-PC in combination with an appropriate National Instruments GPIB board conforms to the IEEE 488.
DCL, GET, SDC, TCT 10.4.2 IEEE 488.2 Common Commands The following IEEE 488.2 common commands are supported by the LBA-PC. *IDN? - Identification Query *RST - Reset *CLS - Clear Status Registers *ESE - Event Status Enable Write *ESE? - Event Status Enable Query *ESR? - Event Status Register Query *SRE - Service Request Enable Write *SRE? - Service Request Enable Query *STB? - Status Byte Register Query All other IEEE 488.
value 10.4.4 = Value assigned to key (DAB) = 8 bit data byte in binary format (^END) = Indicates that EOI is asserted with the last byte sent. Establishing Remote Control Upon starting execution, the LBA-PC initializes itself in Local Mode. The LBA-PC enters Remote Mode when it receives a :REM command or is addressed to listen when the REN line is true. The LBA-PC responds with REM when it receives the :REM command. There is no response when the REN line is used to enter Remote Mode.
10.5 Configuration Commands Configuration commands allow you to do the following: Restore or Save configuration files Set or query all or part of a particular LBA-PC configuration 10.5.1 Restore and Save Configuration Files 10.5.1.1 LDC - Restore Config… To restore a LBA-PC configuration stored on disk, you must send the LDC command along with an optional parameter that identifies the configuration file name.
If the file name is not specified then the current value from the last previous restore File | Restore Config, LDC command, File | Save Config, or SDC command is used. The default configuration file name can be retrieved with the SDC? command. Note that the backslash character, “\”, has special meaning known as an escape sequence. To specify a single backslash you must send two. For example, “c:\\spiricon\\lba300pc\\config.cfg” is interpreted by the LBA-PC as, “c:\spiricon\lba300pc\config.cfg”.
I Integer. ASCII numeric value in integer format. B Boolean. ASCII numeric integer value. 0 = false. 1 = true. F Fixed/Floating. ASCII numeric value in fixed or floating point notation. S String. Series of ASCII characters. Note that the backslash, “\”, has special meaning in strings known as an escape sequence. To specify a single backslash, you must send two. For example: “c:\\spiricon\\lba300pc\\lbapc.cfg” is interpreted as “c:\spiricon\lba300pc\lbapc.cfg”.
Minor=7.500E+00; Rotation=0; DisplayShape=0; AutoAperture=1; Operator’s Manual Doc. No. 10654-001, Rev 4.
10.6 Transfer Commands Transfer commands allow you to do the following: Download raw data (whole frames or data at the cursors) Read, write, upload, or download data files Set or query conditions associated with a frame Download computational results Download pass/fail results Log data or results to the host The LBA-PC uses the IEEE 488.2 Definite Length Arbitrary Block Response Data specification to send and receive binary data. This specification has the form: #nd..
quantitative results, you will also have to retrieve that separately (see A.5.4.17 RDR?). If you wish to associate this information with a data frame, be sure to specify the same frame number for the data and status/results. Three commands allow you to download raw data or data at the cursors from any frame including the reference and gain frames.
Use the :FST? command to determine the specific fixed point format of pixels in a frame. The PixelBits parameter specifies the number of integer bits. The PixelBitsFraction parameter specifies the number of fraction bits. To convert a sixteen bit fixed point data word to a floating point value, divide the data word by 2 raised to the power of PixelBitsFraction (128, 32, 8, or 2 for the LBA-300/708PC, LBA-400/710PC, LBA-500/712PC, or LBA-714PC respectively).
RCC FrameNumber=19; Row=11; #3512(DAW)…(DAW)(^END) 10.6.1.2 RDD? - Read Frame Transfer To download a frame of data from the LBA-PC, you must send the RDD? command along with any optional parameter that identifies which frame you are requesting to transfer. The frame parameter is optional and is numbered from -1 to n. ‘n’ is the number of frames in the frame buffer. Frame -1 is the Gain Frame, 0 is the Reference frame, and frames 1 to n are data captured in the frame buffer.
# = ASCII pound character (0x23) n = ASCII decimal digit ranging from 1 to 9. This value specifies the number of digit elements, d..d, that follow. d..d = ASCII decimal integer that specifies the number of data words that follow. (DAW) = Data Word. Two 8-bit data bytes, low byte followed by high byte. The data is transmitted in a row and column sequence beginning at the display’s upper left-hand corner, proceeding row by row and ending at the lower right-hand corner.
FRM? - Download data file (remote to host) FRM - Upload data file (host to remote) LDD - File | Load… data file (loaded @ remote) SDD - File | Save As… data file (saved @ remote) The FRM command is used to download and upload LBA-PC data files. The transmitted data is in an internal binary form that is identical to a .LB3/4/5 data file. The format of this data is not documented. To use this command you must save and restore exactly what was received from the LBA-PC.
LBA-PC sends FRM FrameNumber=10; #532768(DAB)…(DAB) 10.6.2.2 FRM - Upload Data Frame To upload an LBA-PC data frame, you must send the FRM command with optional parameters that identify the frame number and whether to replace an existing configuration. The frame parameter is optional and is numbered from -1 to n. ‘n’ is the number of frames in the frame buffer. Frame -1 is the Gain Frame, 0 is the Reference frame, and frames 1 to n are data captured in the frame buffer.
FrameNumber=33; #6124928(DAB)…(DAB)(^END) The following example describes how the host uploads a data file to frame 25. The replace parameter is specified so the camera or camera resolution will be changed if the settings in the file are different than the current configuration. The pixel scale and energy calibration will also be changed to the file value if different than the current configuration. The file contains 124,928 bytes. Host sends FRM FrameNumber=25; Replace=1; #6124928(DAB)…(DAB)(^END) 10.6.
• If the replace parameter is false and the pixel scale is different, then the pixel scale is not changed and the file is stored in the frame buffer. • If the replace parameter is true and the energy calibration of the file is different than the current configuration, then the energy calibration is set to the value in the file and the file is stored in the frame buffer.
specified then the value from the last File | Restore Config, LDC command, File | Load, File | Save, LDD command, or SDD command is used. The file name is optional and is a string describing the drive, directory, file name, and extension. If no drive or directory is specified then the current Windows drive or directory is used. In Windows, the current drive and directory can be changed at any time by another program, some internal operation, or some user action. This is probably not what you want.
The following example describes how to download the current result values displayed in the results window: Host sends :RDR? (^END) LBA-PC sends RDR 3298655, 86.96, 1.776e+02, 2.288e+01, 1.846e+03, 1.950e+03, 1.696e+03, 1.519e+03, 3.842e+03, 3.781e+03, 3.812e+03(^END) The following example describes how to download the current labels and units displayed in the results window.
Centroid X, Centroid Y, Width X, Width Y, Diameter(^END) LBA-PC sends RDR ,%,,,um,um,um,um,um,um,um(^END) 10.6.2.6 LOG - Logging You can configure the LBA-PC to automatically send a FRM or RDD and RDR response each time new data is acquired. Remote logging is the fastest method available to transfer new frames from the LBA-PC. Use the File | Logging… dialog box or the LOG configuration command to specify logging new data or results to the host.
#516384(DAB)…(DAB)(^END) LBA-PC sends FRM FrameNumber=3; #516384(DAB)…(DAB)(^END) etc. 10.6.2.7 FST? - Transferring Status Information The commands RCC, RCR, and RDD will permit you to download raw binary data. This data does not tell you under what conditions the data was acquired. More information needs to be transferred from the LBA-PC if you hope to perform an analysis of this data. The LBA-PC takes a snapshot of existing conditions each time a frame of data is acquired.
• Turn on/off write protection The following example describes how to retrieve the frame status of frame number 27. Host sends :FST? FrameNumber=27(^END) LBA-PC sends FST FrameNumber=27; CameraInput=0; Date=11/24/97; Time=03:17:55.16; PixelBits=8; PixelHScale=1.300e+01; PixelVScale=1.300e+01; PixelUnits=1; Gamma=1.000e+00; Lens=0; PixelBitsFraction=7; CaptureLocation=32,44; CaptureSize=128,120; CaptureResolution=2; EnergyOfBeam=0.000e+00; EnergyOfFrame=0.
FrameNumber=52; CommentLine=This will appear in the title bar; WriteProtect=1(^END) 10.6.3 PFS? - Pass/Fail Status To retrieve the current pass/fail status, you must send the PFS? command. The LBA-PC responds by repeating PFS followed by a “key=value” parameter for each value that has pass/fail testing enabled. The ‘key’ is an ASCII text string identical to the label displayed in the lefthand column of the results window. The ‘value’ is a boolean, where 0 equals fail and 1 equals pass.
Frame Buffer Beam Window Frame Coordinates World Coordinates Pan/Zoom Window Capture Window Detector Coordinates Coordinate Systems Figure 62 10.7.2 Pan/Zoom Window Detector Coordinates Detector coordinates define locations on the camera detector. Detector coordinates are always positive integers. For a particular camera type, detector coordinates never change. The detector coordinate origin is always the upper left corner of the detector.
Detector coordinates are used to position the origin location which in turn defines the World Coordinate system. Detector coordinates also are used to define the location of the frame data capture windwo which in turn defines the Frame Coordinate system. 10.7.2.1 DIS - Set Manual Origin Location The Origin location can be set anywhere inside the :PNW? limits.
The PAN command is affected by the current capture resolution (zoom). Use the :PAN? command to retrieve the current capture window location and resolution. The capture resolution value is coded as a power of two. A capture resolution value of 0 represents 20 which equals 1, a value of 1 represents 21 = 2, 2 represents 22 = 4, etc. When the capture resolution is x1, x2, x4, etc., the LBA-PC samples every pixel, every other pixel, every 4th pixel, etc.
The following describes how to set the pan window to the lower right corner of the detector. In this example the lower right corner of the detector is at (744, 512). The frame data size is 32 X 30. The capture resolution value is 2, so we must multiply the data size by 22=4. Therefore the actual size of the capture window is 128 X 120. To put the capture window in the lower right corner we subtract the capture window size from the lower right limits, 744-128=616 and 512120=392.
See section 2.3.1.1 RCC?, RCR? - Read Cursor Transfer for additional information. 10.7.4 Beam Window World Coordinates Most parameters that specify spatial coordinates must be in LBA-PC world coordinates. World coordinates are used for locations in the current frame as displayed in the beam window with no magnification. World coordinates are displayed for computed centroid location and peak location results, aperture location, cursor and crosshair location, and pass/fail locations.
10.8 ERROR MESSAGES Since the LBA-PC is pretty much of a black box and the GPIB is not much better we have included descriptive error messages and other information to make debugging a little easier. The LBA-PC maintains two output queues, the response output queue and the error message queue. To enable the error message queue, you must send the ERR command with a parameter specifying verbose error reporting. The verbose parameter is optional and is a boolean with a value of 0 or 1 (i.e. false or true).
The second category of errors is LBA-PC execution errors. These error messages are normally displayed in a message box on the screen. The LBA-PC reroutes these error messages to the error message queue when the queue is enabled. Example of a category 2 error: Host sends :PAN X=0; Y=0(^END) Host sends *STB?(^END) LBA-PC sends STB #H08(^END) Host sends :ERR?(^END) LBA-PC sends !!! PAN - ‘X=0’ out of range (112,744)(^END) The third category of errors are either fatal or result from some local user action.
Host sends :ERR?(^END) LBA-PC sends !!! LDC - cannot load config while running(^END) Operator’s Manual 208 LBA-PC
10.9 SERVICE REQUEST 10.9.1 Service Request Response One of the provisions of the GPIB hardware bus is the ability to signal the host controller when an event has occurred. Under the direction of the host controller, the LBA-300PC can assert the SRQ line when new data is available, new results is available, a task has been completed, or an error has occurred. Under the IEEE standard, the controller performs a poll of the devices to determine who requested service and why.
Operator’s Manual 210 LBA-PC
Appendix A Remote Command/Error Message Operation The LBA-PC can be controlled as a remote device via GPIB. For the most part, communications between the LBA-PC and the host controller will follow the data format and coding protocols outlined in the IEEE 488.1 and 488.2 standards. A.1 IEEE 488.1 Command Support The LBA-PC in combination with an appropriate National Instruments GPIB board conforms to the IEEE 488.
A.2 IEEE 488.2 Common Commands The following IEEE 488.2 common and related commands are supported by the LBA-PC. Command Meaning Usage *IDN? Identification LBA-PC returns the string “Spiricon, LBAPC, ssss, v.vv” where ssss is the serial number of the board and v.vv is the software version number.
Command Meaning Usage *ESE Event Status Enable Sets mask to enable event status notification of corresponding bits set in ESR. *ESE? *ESR? Return ESE contents. Event Status Register Return and clear ESR contents: bit 7 - Power on. bit 6 - User Request (unused). bit 5 - Command Error flag, set when host sends a command that is not recognized. bit 4 - Execution Error flag, set when the host commands the LBA-PC to perform a task which is preempted by other conditions (e.g.
Command Meaning Usage bit 5 - Event Status bit, ESB, set whenever an unmasked event status condition exists (ESR & ESE). bit 4 - Message Available bit, MAV, set when a response to a query is available in the output queue. bit 3 - Error Message Available bit, EMAV, set when an error message has been posted to the error message queue (see :ERR). bit 2 - LBA-PC Event Status bit, LSB, set whenever an unmasked LBA-PC event status condition exists (ELR & ELE). bit 1 - unused bit 0 - unused All other IEEE 488.
Standard Event Status Enable Standard Event Status Register LB A-300PC Event Status Enable LB A-300PC Event Status Register *ESE, *ESE? *ESR? :ELE, :ELE? :ELR? 7 6 5 4 3 2 1 0 & & & & & & & & 7 power on 7 6 user request 6 5 com m and error 5 4 execution error 4 3 dependent error 3 2 query error 2 1 request control 1 0 op com plete 0 & 4 3 2 1 0 6 checksum error 5 & 4 & 3 & & & & 2 new fram e 1 results 0 pass/fail alarm 7 & M SS 6 RQ S X 5
A.3 LBA-PC Command and Data Formats The LBA-PC does not support the IEEE 488.2 specification of sending multiple commands separated by semicolons. Each command must be sent separately and terminated by asserting the EOI line with the last byte sent.
Type Description F Fixed/Floating. ASCII numeric value in fixed or floating point notation. S String. Series of ASCII characters. Note that the backslash, “\” has special meaning in strings known as an escape sequence. To specify a single backslash you must send two. For example: “c:\\spiricon\\lba300pc\\lbapc.cfg” is interpreted as “c:\spiricon\lba300pc\lbapc.cfg”. Although other escape sequences are recognized, there is no reason to use them with the LBA-PC. T Time.
Key Type Value Description appended. Maximum 256 characters. default = drive, path, and filename from last load or save config A.5.1.2 SDC - save configuration NOTE: There is no default path for this command. If you want the configuration to be saved in a particular path then send the path with the file name. :SDC 1,3 :SDC Key Type Value Description ConfigFileName6 S Name of configuration file to load. If no extension (i.e. no period) then .CFG is appended. Maximum 256 characters.
Key Type Value Description 1 to n. ‘n’ is the number of records in the file. NumberRecords I 0 = all records (up to frame buffer size) 1 to n. ‘n’ is the size of the frame buffer. forced to 1 when StartFrame < 1 StartFrame I First frame saved. -1 = gain frame 0 = reference frame 1 to n.
Key Type Value Description Maximum 256 characters. default = filename from last load or save data command NumberRecords I 0 = all records (up to frame buffer size) 1 to n. ‘n’ is the size of the frame buffer. forced to 1 when StartFrame < 1 StartFrame I First frame saved. -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer. default = current frame Append B Append existing file false = do not append The file will be created if it does not exist.
A.5.1.5 EXP - set export configuration & export image(s) :EXP 1 :EXP? Key Export Type Value Description 3 B false = set configuration only. true = set configuration then export images. Images cannot be exported while running. default = true Replace B Overwrite if file exists. default = false ExportFileName6 S Base name of export file. Extension automatically created by LBA-PC based on export file type. Maximum 256 characters. StartFrame I First frame to export. 1 to n.
Key Type Value Description DataLogging B Data logging enable. DataFileName S Name of data log file. If no extension (i.e., no period) then .LB3/4/5/7 is appended. Maximum 256 characters. If this key is set to “FRM” or “RDD” (case ignored) (or was previously set to FRM or RDD in the dialog) then data frames will be logged to the GPIB bus. Each time a new frame is captured the LBA-PC will automatically send a response as if you had sent “:FRM?” or “RDD?” respectively.
Key Type Value Description AsciiComma B .ASC logging enable. AsciiSpace B .ASP logging enable. CursorData B .CUR logging enable. ColumnSumRow B .SUM logging enable. LoggingMethod L Logging duration. 0 = continuous 1 = frames 2 = time NumberFrames I Number of frames to log, if LoggingMethod is frames. 1 to 100000. Time T Amount of time to log, if LoggingMethod is time. 0:0:1 to 999:59:59 PassFailFilter L Which frames to log. 0 = all 1 = passed 2 = failed A.5.1.
Key Type Value Description Print3 B start printing now default = true BeamImage B Print beam enable. Results B Print results enable. SeparatePages B Print beam and results on separate pages. CurrentOnly B Print current frame only. StartFrame I First frame to print. 1 to n. ‘n’ is the frame buffer size. default = current frame. NumberFrames I Number of frames to print. 0 = all frames 1 to n. ‘n’ is the frame buffer size. 2DdarkBackground A.5.2 A.5.2.
Key Type Value Description 2 = square 3 = ellipse 4 = rectangle AutoAperture A.5.2.2 B Auto aperture enable. CAM - set camera configuration A path may be included in the ‘File’ parameter. If a path is included in the ‘File’ parameter then the path where the LBA-PC looks for CAM files will also be changed. If a ‘File’ is specified the current settings for Resolution, FrameBufferSize, NumberFrames, and Lens are not changed. If a ‘File’ is specified then this file is read first.
Key Type Value Description 8 to 15, -8 to -15 PixelHScale F Horizontal pixel scale. Forced equal to vertical pixel scale if SyncSource is genlock PixelVScale4 F Vertical pixel scale. PixelUnits L Pixel scale units display. 0 = none 1 = µm 2 = mm 3 = cm 4=m 5 = in 6 = mils 7 = mrad Gamma F Camera gamma value. 0.1 to 10.0 Lens A.5.2.
Key Type Value Description CameraInput B Which camera input is in use. Cannot be set. To select which camera is in use, set only one of the CameraInput# below. 0, or 1 to 3 if you purchased the fourcamera option. CameraInput2 CameraInput3 CameraInput4 B Which camera input(s) to use. Valid only if you purchased the four-camera option. CameraShutter L Camera shutter setting for camera 1. 0 to 7. Effect depends on camera.
Key Type Value Description VideoTriggerLevel L Video trigger level for camera 1. 0 = 1/16 maximum pixel value 1 = 1/8 maximum pixel value 2 = 1/4 maximum pixel value 3 = 1/2 maximum pixel value VideoTriggerLevel2 Video trigger level for cameras 2 to 4. Valid only if you purchased the fourcamera option. VideoTriggerLevel3 VideoTriggerLevel4 0 = 1/16 maximum pixel value 1 = 1/8 maximum pixel value 2 = 1/4 maximum pixel value 3 = 1/2 maximum pixel value Summing B Sum frames enable.
Key Type Value Description 0 to NumZooms-1. NumZooms4 I Maximum zoom index value CaptureLocation I,I X,Y upper left corner of capture area (see PAN) CaptureSize4 I,I Width and height of frame 4 These values are set via ZoomIndex 4 CaptureResolution L Capture sample resolution. -1 = Full 1x 0 = 1x 1 = 2x 2 = 4x 3 = 8x 4 = 16x 5 = 32x This value is set via ZoomIndex. A.5.2.
Key Type Value Description 9 = pw 10 = fl Quant B Quantitative results enable. BeamWidthMethod L Beam width method. 0 = 4 sigma 1 = knife edge 90/10 2 = knife edge 3 = energy (uses ClipHigh) 4 = peak ClipLow F 1 to 99, < ClipHigh ClipHigh F 1 to 99, > ClipLow Multiplier F Knife edge multiplier 1 to 10 Ellip B Elliptical results enable. Gauss B Gauss fit enable. GaussMethod L Gauss fit method. 0 = whole 1 = x/y or major/minor Tophat B Tophat enable.
Key Type Value Description 0 to 1.0e12 Histogram B Histogram enable. Buckets I Histogram bucket width, 1 to 256 Statistics B Statistics enable. StatisticsMethod L Statistics method. 0 = continuous 1 = frames 2 = time Frames I Number of frames to collect, if statistics method is frames. 1 to 100,000 Time T Amount of time to collect statistics, if statistics method is time. 0:0:1 to 999:59:59 A.5.2.
Key Type Value Description 4 = window lower left ManualOrigin I X,Y detector location of manual origin. Range depends on camera. BeamColors L Beam display color. 0 = bands 1 = continuous 2 = gray scale 3 = user specified palette 4 = green 5 = yellow PaletteFileName Name of the color palette file. Maximum 256 characters. default = drive, path, name of lat palette file loaded. ScaleType L Beam display scale. 0 = x1 1 = x2 2 = x4 3 = x8 4 = x16 5 = auto BeamDisplay L What beams to display.
Key Type Value Description EnergyOfBeam=0) then the range is 0 to 255. If energy is calibrated then the range depends on the energy calibration. UpperThreshold F Upper color energy display threshold. If energy is uncalibrated (COM, EnergyOfBeam=0) then the range is 0 to 255. If energy is calibrated then the range depends on the energy calibration. ColorBar B Color bar display enable. CursorAxis L Cursor axis orientation. 0 = x/y 1 = major/minor Crosshair L Crosshair display enable.
A.5.2.6 PSW - enter password :PSW Key Type Value Description Password S See online help under Password Lockout for information about passwords. :PSW? Returns: PSW < configuration > Key Type Value Description Lockout B true = local lockout active A.5.3 Pass/Fail Menu A.5.3.1 PFF - set pass/fail master configuration :PFF 1 :PFF? 2 Key Type Value Description PassFail B Master Pass/Fail enable. TTL B TTL output on ‘When’ condition enable.
Key Type Value Description TotalMin F Total energy minimum. -1e12 to 1e12 TotalMax F Total energy maximum. -1e12 to 1e12 Percent B,B Min,Max test enable. PercentMin F Percent of energy minimum. 0 to 100 PercentMax F Percent of energy maximum. 0 to 100 PeakFluence B,B Min,Max test enable. PeakFluenceMin F Peak fluence minimum. -1e12 to 1e12 PeakFluenceMax F Peak fluence maximum. -1e12 to 1e12. ValleyFluence B,B Min,Max test enable. ValleyFluenceMin F Min fluence minimum.
Key Type Value Description Minor B,B Min,Max test enable. MinorMin F Minor axis minimum in world coordinates5. 0 to 1e12. MinorMax F Minor axis maximum in world coordinates5. 0 to 1e12. Diameter B,B Min,Max test enable. DiameterMin F Diameter minimum in world coordinates5. 0 to 1e12. DiameterMax F Diameter maximum in world coordinates5. 0 to 1e12. A.5.3.3 pass/fail elliptical configuration Key Type Value Description Roundness B,B Min,Max test enable.
Key Type Value Description -1e12 to 1e12. GaussCentroidYLoc F Y location in world coordinates5. -1e12 to 1e12. GaussCentroidRadius F Maximum distance from (CentroidXLoc, CentroidYLoc) in world coordinates5 0 to 1e12. GaussCentroidMinor B GaussCentroidRadiusMinor F Minor or Y axis centroid test enable. Maximum distance from GaussCentroidMinor in world coordinates5 0 to 1e12. GaussMajor B,B Min,Max test enable. GaussMajorMin F Major axis or Width X minimum in world coordinates5. 0 to 1e12.
Key Type Value Description GaussCorrelationMin F Gauss Correlation, Gauss Correlation Major, or Gauss Correlation X; minimum. 0 to 1. GaussCorrelationMax F Gauss Correlation, Gauss Correlation Major, or Gauss Correlation X; maximum. 0 to 1. GaussDeviation B,B Min,Max test enable. GaussDeviationMin F Gauss Deviation, Gauss Deviation. Major, or Gauss Deviation. X; minimum. 0 to 1e12. GaussDeviationMax F Gauss Deviation, Gauss Deviation Major, or Gauss Deviation X; maximum. 0 to 1e12.
Key Type Value Description 0 to 1e12. GaussDeviationMinorMax F Gauss Deviation Minor, or Gauss Deviation Y; maximum. 0 to 1e12. A.5.3.5 pass/fail top hat configuration Key Type Value Description TophatFluence B,B Min,Max test enable. TophatFluenceMin F Tophat Fluence, or Tophat Fluence X; minimum. -1e12 to 1e12. TophatFluenceMax F Tophat Fluence, or Tophat Fluence X; maximum. -1e12 to 1e12. TophatMean B,B Min,Max test enable. TophatMeanMin F Tophat Mean, or Tophat Mean X; minimum.
Key Type Value Description TophatSDMMax F Tophat SD/M, or Tophat SD/M X; maximum. 0 to 1e3. EffectiveArea B,B Min,Max test enable. EffectiveAreaMin F Effective area minimum. 0 to 1e12. EffectiveAreaMax F Effective area maximum. 0 to 1e12. EffectiveDiameter B,B Min,Max test enable. EffectiveDiameterMin F Effective diameter minimum. 0 to 1e12. EffectiveDiameterMax F Effective diameter maximum. 0 to 1e12. TophatFactor B,B Min,Max test enable. TophatFactorMin F Tophat factor minimum.
Key Type Value Description TophatSDMMinor B,B Min,Max test enable. TophatSDMMinorMin F Tophat SD/M Y minimum. 0 to 1e3. TophatSDMMinorMax F Tophat SD/M Y maximum. 0 to 1e3. A.5.3.6 pass/fail divergence configuration Key Type Value Description DivergenceMajor B,B Min,Max test enable. DivergenceMajorMin F Divergence X or Major min., in milliradians. 0.0 to 3142.0. DivergenceMajorMax F Divergence X or Major max., in milliradians. 0.0 to 3142.0. DivergenceMinor B,B Min,Max test enable.
Key Type Value Description UltracalOff B true = disable frame calibration default = false A.5.4.2 CHR - read/write cross hair location This command is valid only when cross hair is set to manual (see :DIS). The range of allowable values is returned by the WLD? command. :CHR Key Type Value Description X F x location in world coordinates5 Y F y location in world coordinates5 Cursor B true = snap the cross hair to the location of the cursor.
A.5.4.4 Key Type Value Description X F x location in world coordinates5 Y F y location in world coordinates5 Z F Value of pixel at cursor Delta F distance from cross hair to cursor DSF - display frame :DSF 3 :DSF? Key Type Value Description FrameNumber I frame number -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer default = current frame A.5.4.
queue can be monitored with the EMAV bit in the status byte register (STB). This bit is set when one or more messages is in the error message queue. This bit is cleared when the queue is empty. Note that you must set “:ERR Verbose=1” to receive error messages. If Verbose=0 then no messages will be put into the error message queue and EMAV will remain clear.
Message Error Type Description current configuration and Replace=false different camera EXECUTION_ERROR FRM,LDD,SDD - The specified resolution frame was captured at a different camera resolution than the current configuration and Replace=false cannot set while EXECUTION_ERROR The specified value(s) cannot running be set while the LBA-PC is running CAM file error EXECUTION_ERROR CAM - There was an error reading a specified CAM file (check path, filename, contents) file name contains illegal characters
Message Error Type Description crosshair mode not set to manual EXECUTION_ERROR CHR not in remote EXECUTION_ERROR SYC - Cannot synchronize with remote if GPIB interface is in local mode. (see SYC, LOC, REM) Following is a list of error messages that normally appear on the display. These messages are automatically rerouted to the error message queue when LBA-PC is in remote control mode. Message Generated By Cannot run Ultracal because all frames are write protected.
Message Generated By File name contains illegal characters File | Export Directory path does not exist File | Export Error in directory path or file name File | Export File error File | Export Error reading Gain file. File | Load Gain some value in the Gain file is greater than maximum allowed value of 2. Load Gain Aborted. File | Load Gain Some value in the Gain file is less than 0. Load Gain Aborted. File | Load Gain Error writing Gain file.
Message Generated By Cannot Load file because all frames are write protected. File | Load File camera does not match current camera. File | Load File record header does not match current configuration. File | Load This is not a valid LBA-PC data file. File | Load This is not a Demo file. File | Load Insufficient memory for dialog box. dialog Out of memory dialog TFileSaveDialog returned Error #%lx dialog TFileOpenDialog returned Error #%lx dialog You have changed the Camera.
Message Generated By Error in directory path or file name. File | Load File | Save As Start record (%ld) is beyond the end of the file (%ld). File | Load Start record plus number records (%ld) is beyond the end of the file (%ld). File | Load This is not a valid LBA-PC data file. File | Load File | Save As File's camera does not match configuration camera. File | Load Press OK to change the configuration camera. File's resolution (%d) does not match configuration File | Load resolution (%d).
Message Generated By %s detected but cannot be initialized. LBA-PC set to Off-Line mode. device driver Unable to load LCA program file (%s). device driver Press OK to stop Auto Calibration. ultracal A.5.4.6 FRM - upload/download a data frame Only one frame at a time can be uploaded or downloaded. :FRM will upload a frame of data from the controller to the LBA-PC, while :FRM? will download a frame of data from the LBA-PC to the controller.
n..n = (DAB) = number of data bytes data byte - 8-bit data byte Key Type Value Description FrameNumber I frame number -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer. default = current frame Replace B default = false true = replace If the camera or the camera resolution stored in the file do not match the current configuration then the LBA-PC must replace the current camera or change the resolution before the frame can be loaded.
Key Type Value Description FrameNumber I frame number -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer. default = current frame Date4 Time 4 CameraInput 4 D MM/DD/YY T HH:MM:SS.
Key Type Value Description 5 = 32x EnergyOfBeam4 F calibrated energy of beam entered in Computations dialog EnergyOfFrame4 F raw frame total equivalent to EnergyOfBeam EnergyUnits4 L 0=j 1 = mj 2 = uj 3 = nj u = pj 5=w 6 = mw 7 = uw 8 = nw 9 = pw 10 = fl AC4 L -1 = ultracal was on but capture location, frame size, or resolution did not match 0 = ultracal off >0 = ultracal subtracted RS4 L -1 = reference subtract was on but capture location, frame size, or resolution did not match 0 = referen
When in local control mode, any remote logging (:LOG) or synchronization (:SYC) is disabled, or cannot be enabled. The remote logging state is stored in the configuration. Remote logging is automatically re-enabled when the LBA-PC is returned to remote mode and the file name is FRM, RDD, or RDR. :LOC Returns: LOC A.5.4.9 ORG - set manual origin to cursor location This command is valid only when origin is set to manual (see :DIS). :ORG A.5.4.
Key Type Value Description -y = move up by y y = new location - see :PNW? for limits +y = move down by y C = center vertically ±x and ±y use units defined by the camera resolution in the current camera configuration. For example, if the camera resolution is x2 then ±x and ±y will move the capture window by ±2·x, ±2·y pixels. If the camera resolution is x8 then ±x and ±y will move the capture window by ±8·x, ±8·y pixels. Absolute locations will be snapped to integer multiples of the camera resolution.
NOTE: The detector origin is always the upper left corner so that y values increase going down and decrease going up. Returns: PNW 2 Key Type Value Description UpperLeft I,I X,Y - minimum allowable capture location LowerRight I,I X,Y - maximum allowable capture location. Note that the capture location plus the capture size times the capture resolution must be less than these values. A.5.4.
Key Type Value Description 1 to n. ‘n’ is the size of the frame buffer. default = current frame Column I 1 to w. ‘w’ is the frame width default = current cursor location Returns: RCC FrameNumber=f;Column=c;#dn..n(DAW)( DAW)…( DAW)( DAW) Where: f = frame number c = which column is being returned # = pound symbol d = number of digits to follow in n..n n..n = number of data words (i.e.
Key Type Value Description FrameNumber I Frame number -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer. default = current frame Row I 1 to h. ‘h’ is the frame height. default = current cursor location Returns: RCR FrameNumber=f;Row=r;#dn..n(DAW)( DAW)…(DAW)(DAW) Where: f = frame number r = which row is being returned # = pound symbol d = number of digits to follow in n..n n..n = number of data words (i.e.
Use the :FST? command to determine the specific fixed point format of pixels in a frame. The PixelBits parameter specifies the number of integer bits. The PixelBitsFraction parameter specifies the number of fraction bits. A.5.4.16 RDD? - read raw data Returns the binary frame data. :RDD? Key Type Value Description FrameNumber I frame number -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer.
Where: s = sign bit i = integer f = fraction Use the :FST? command to determine the specific fixed point format of pixels in a frame. The PixelBits parameter specifies the number of integer bits. The PixelBitsFraction parameter specifies the number of fraction bits. A.5.4.17 RDR? - read results :RDR? Key Type Value Description Labels B Return labels displayed in left-hand column of results window.
A.5.4.18 REM - go to remote When the REM message is sent or when the LBA-PC goes from local to remote via the REN line then local control is automatically locked out (equivalent to password lockout). Note that remote logging (:LOG) or synchronization (:SYC) are allowed only when remote is enabled. If remote logging was enabled in the configuration (i.e. file name was FRM, RDD, or RDR) and you set the LBA-PC to remote, then remote logging will be re-enabled.
Key Type Value Description default = false Results B true = synchronize remote results download Do not capture another frame until the controller sends a :RDR? command and reads the response data. false = normal operation default = false A.5.4.23 WLD? - read current frame boundaries This command returns the boundaries of the current frame as viewed in the beam window (i.e.
Key Type Value Description z = new zoom +z = zoom in :ZOM? Returns: ZOM Zoom=z A.5.4.25 ZMM - zoom information :ZMM? Returns: ZMM ;…;;; Where: Index = zoom = list of zooms by index. The “index” is an integer index used or returned by the ZOM command. The “zoom” is of the form “W x H x R”, W=width, H=height, R=resolution. For example: ZMM 0=128x120x4;1=128x120x2;2=128x120x1;3=64x60x1;4=32x30x1;; A.
2 Configuration query commands return all of the keys for the specified configuration in the following format: :CCC key=value;key=value;…key=value;key=value; 3 Cannot be set while LBA-PC is running. 4 Cannot be set, information only. 5 World coordinates are based on the frame size, capture resolution, origin location, and pixel scale. Use the WLD? command to determine frame current boundaries. World coordinate values will always be snapped to the nearest resolution pixel.
Appendix B LabVIEW Support B.1 Introduction LabVIEW is a product and registered trademark of National Instruments Corporation. LabVIEW is a general purpose programming system designed specifically for data acquisition and instrument control. LabVIEW programs are called Virtual Instruments (VI’s) because their appearance and operation can mimic other instruments such as the LBA-PC laser beam analyzer.
SUBVI.LLB You can either copy these library files to your LabVIEW development computer, or read these files from the Spiricon supplied CD. B.2 The Basic SubVI Library Examples SUBVI.LLB contains 22 basic functions that can be called by other VI’s. The functions of these SubVI’s are analogous to subroutines in other types of programming environments, such as C++ . The following list contains the library SubVI’s name, a brief description of what it does, and the standard Inputs and Outputs of the VI. B.2.
5. Error out B.2.4 Do Ultracal .vi Description: Turn Ultra calibration on and wait to be completed. Input Output 1. GPIB address 1. Error out 2. Error in B.2.5 Frame SRE .vi Description: Enable Service Requests for frame data. Input Output 1. GPIB address 1. Error out 2. Error in B.2.6 Get Basic Results .vi Description: Get current results from LBA-PC . Input Output 1. GPIB address 1. Results array 2. Error in 2. Error out B.2.7 Get Frame Status Info .
B.2.8 Get Palette .vi Description: Get color palette table from LBA-PC . Input Output 1. GPIB address 1. Color table 2. Error in 2. Error out B.2.9 Get Pan Location .vi Description: Get current pan location . Input Output 1. GPIB address 1. Left 2. Error in 2. Up 3. Width 4. Height 5. Capture resolution 6. Error out B.2.10 Get Tophat Results .vi Description: Get current tophat results from LBA-PC . Input Output 1. GPIB address 1. Tophat results array 2. Error in 2. Error out B.2.
B.2.12 Move Cursor .vi Description: Move cursor based on a click of one of four buttons. Input Output 1. GPIB address 1.Error out 2. Up button 3. Left button 4. Right button 5. Bottom button 6. Error in B.2.13 Move Pan .vi Description: Move pan based on a click of one of four buttons. Input Output 1. GPIB address 1.Error out 2. Up button 3. Left button 4. Right button 5. Down button 6. Error in B.2.14 Read Basic Cursor info .vi Description: Read cursor current location and it’s value.
Input Output 1. GPIB address 1. Row data array 2. Error in 2. Row # of elements 3. Column data array 4. Column # of elements 5. Error out B.2.16 Read Divergence Results .vi Description: Read peak and divergence x, y values in an array. Input Output 1. GPIB address 1. Value array 2. Error in 2. Error out B.2.17 Restore Configuration .vi Description: Restore a configuration file. Input Output 1. GPIB address 1. Error out 2. CFG file name string 3. Error in B.2.18 Results SRE .
Input Output 1. GPIB address 1. Error out 2. Run/Stop boolean 3. Error in B.2.20 Save Configuration .vi Description: Save a configuration file to remote machine. Input Output 1. GPIB address 1.Error out 2. CFG file name string 3. Error in B.2.21 Semicolon String to Array .vi Description: Translate a string with semicolon delimiters to an array. Input Output 1. Input string 1. The array 2. The total # of rows in the array B.2.22 Set Energy and Units .
B.3.1 Basic Results .vi This program shows the basic communication between LBA-PC and the local computer. It contains three buttons: “Run/Stop”, “Ultracal”, and “Auto Aper on/off” on the left side of the window. This VI shows all basic results on the right side. Basic Results Panel Figure 64 LabVIEW is a graphical computer language. In LabVIEW, user interfaces and displays are called “Panels” and a program is represented by a “Diagram”. Programming is accomplished by drawing diagrams.
• Get Basic Results .vi These VIs are easy to understand if one has some experience in LabVIEW programming. The processing sequence is controlled by the “Error In” and “Error Out” connection chain. That means a function unit is processed earlier if it is closer to the starting “Error In” connection. In other words, we use the “Error Out” to “Error In” connection sequence to link each operation in the process.
3. Check if the status of the cursor display has changed. 4. Check if any Cursor-Move button has been clicked. 5. Check if the ZoomIn and ZoomOut button has been clicked. Check if any Panbutton has been clicked. 6. Move Get current frame data and cursor location to display. B.3.3 Basic Divergence .vi This program is similar to the Basic Results .vi, but contains only those items needed to make divergence measurements.
B.3.9 Get Data .vi This VI will download a data frame from the LBA-PC into a file on one of the local computer’s hard drives. The operator must enter the file name and path, and the Frame Number that is to be transferred. B.3.10 Hotkeys .vi This VI provides a basic set of push-button operations including: Print, Write Protect, Reset, and Camera Shutter control. The “Reset” button will cause the LBA-PC application to restore the last saved configuration file. Operator’s Manual Doc. No. 10654-001, Rev 4.
Operator’s Manual 276 LBA-PC
INDEX 2D ........................................... 75, 82, 106 aperture............................................. 50 beam profiles ..................................... 81 button ............................................... 76 colors ................................................ 78 crosshair ............................................ 82 cursor .......................................... 76, 82 lens orientation................................... 57 multiple plots .................................
percent of energy ........................70, 134 percent of peak ...........................70, 134 top hat .............................................. 71 Beep ..................................................... 98 Black Level ......................61, 126, 129, 154 camera .............................................. 60 Bucket Size............................. 73, 115, 142 Camera advanced ......................................... 152 analog ............... 19, 53, 56, 61, 103, 112 auto exposure ....
shortcut ........................................... 110 statistics .....................................74, 143 top hat ............................................ 138 top hat factor ............................138, 139 total energy...................................... 130 whole beam fit ..........................135, 136 x/y & major/minor fit ........................ 136 Configuration camera .............................................. 21 restore...............................................
stability, inc bins ................................. 94 stability, peak & centroid ..................... 91 stability, zooming................................ 92 Interlaced Camera................................ 119 Knife Edge Method ............................... 133 LabVIEW ......................................160, 265 Lens ............................................... 21, 57 Live Video ............................................. 59 Load colors ................................................
equipment.......................................... 15 password ........................................... 98 print setup ................................... 45, 67 printer setup ...................................... 87 pyrocam I .......................................... 27 remote GPIB .................................... 177 restore configuration........................... 37 save configuration .............................. 37 setup printer button ............................ 87 setup.exe .............