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.
Page 4
2.6.1.3 Some Restrictions apply when interfaced to a Pyrocam I ______________________ 28 2.6.1.4 Image synchronization considerations _____________________________________ 29 2.6.2 Pyrocam I with Digital LBA-PC’s _______________________________________ 29 2.6.2.1 Pyrocam I setup requirements:___________________________________________ 29 2.6.2.2 LBA-500/7XXPC-D Setup requirements: ____________________________________ 30 2.6.2.3 Image Synchronization Considerations _____________________________________ 31 Chapter 3 MENUS AND DIALOG BOXES _________________________ 32 File.
Page 5
3.2.2 Aperture... display and define apertures ________________________________ 49 3.2.2.1 Aperture Shapes ______________________________________________________ 49 3.2.2.2 How to create a Drawn Aperture _________________________________________ 50 3.2.2.3 Drag and Drop Apertures _______________________________________________ 50 3.2.2.4 Using Auto Apertures___________________________________________________ 51 3.2.2.5 Display Beam Width ___________________________________________________ 51 3.2.3 Camera...
Page 6
3.2.7.3 Cursor Orientation _____________________________________________________ 76 3.2.7.4 Origin Location________________________________________________________ 77 3.2.7.5 Beam Colors__________________________________________________________ 78 3.2.7.6 Z Axis Scale __________________________________________________________ 78 3.2.7.7 Beam Display _________________________________________________________ 79 3.2.7.8 Set Reference Source __________________________________________________ 80 3.2.7.9 Display Thresholds_____________________________________________________ 81 3.2.7.10 Color Bar 3.2.7.11 Copy Image to Clipboard 3.2.7.12 Copy Image to Wallpaper 3.2.7.13...
Page 7
Shortcuts ________________________________________________________ 110 The Pan/Zoom Display Window ____________________________________ 111 4.4.1 Hardware Zooming ________________________________________________ 111 4.4.1.1 Analog Camera Zooming _______________________________________________ 112 4.4.1.2 Digital Camera Zooming _______________________________________________ 113 4.4.2 Soft Zooming _____________________________________________________ 113 4.4.3 Panning _________________________________________________________ 113 4.4.4 Zooming and Panning Constraints ____________________________________ 114...
Page 8
5.4.1.3 Digital Camera Exposure Controls________________________________________ 125 5.4.1.4 Digital Camera Triggering ______________________________________________ 125 5.4.1.5 Digital Camera Gain and Black Level Control _______________________________ 126 Chapter 6 COMPUTATIONS _________________________________ 128 Computational Accuracy __________________________________________ 128 Numerical Formats ______________________________________________ 128 Beam Presentation Affects Results__________________________________ 129 Manual Background Energy Nulling _________________________________ 129 6.4.1...
Page 9
Chapter 7 DIGITAL CAMERA OPTION __________________________ 148 Digital Camera Option____________________________________________ 148 I/O Connections ________________________________________________ 148 Digital Camera Advanced Timing Setup ______________________________ 152 7.3.1 Transfer Mode ____________________________________________________ 152 7.3.2 Scan Mode _______________________________________________________ 152 7.3.3 Vertical Start _____________________________________________________ 152 7.3.4 Vertical Size ______________________________________________________ 153 7.3.5...
Page 10
9.3.2.5 Stop _______________________________________________________________ 170 9.3.2.6 Ultracal_____________________________________________________________ 170 9.3.2.7 Auto Exposure _______________________________________________________ 171 9.3.3 Events __________________________________________________________ 171 9.3.3.1 OnNewFrame ________________________________________________________ 171 9.3.3.2 OnOperationComplete _________________________________________________ 172 DCOM ________________________________________________________ 172 9.4.1 Remote Access ___________________________________________________ 173 9.4.1.1 Server (LBA-PC) Computer _____________________________________________ 173 9.4.1.2 Client (Application) Computer ___________________________________________ 174 9.4.2 If you have a problem______________________________________________ 175 Chapter 10...
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: •...
1. Four-camera adapter, allows you to choose between 1 of 4 connected analog cameras or automatically cycle between them. 2. Digital Camera adapter, allows you to interface the output from an RS-422 or LVDS digital camera. 3. A printer with appropriate Windows compatible drivers.
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.
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.
Page 16
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.
Page 17
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.
If you purchased a Pyrocam III to use with LBA-PC, disregard this section and refer to your Pyrocam III Installation Guide. To use LBA-PC with your Pyrocam III you must launch LBA-PC from the Pyrocam III Control Console. Operator’s Manual Digital Camera Option Figure 4 LBA-PC...
2.1.2.2 Digital Cameras Connect the digital output from your camera to the SCSI-2 type connector on the digital camera adapter provided with the LBA-PC frame grabber card. If you purchased your camera from Spiricon, you may have been provided with a Camera Control Cable. The cable will provide the digital data connection to your camera, and may control signals for your camera’s electronic...
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.
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.
Video trigger mode for a pulsed laser w/ Top Hat results enabled. ~to5gaus.cfg A Trigger Output at 5 Hz to fire a pulsed laser w/ Gauss Fit results. ~PYROCAM.cfg For use with Pyrocam I’s w/o digital camera option. ~PYRODIG.cfg For use with Pyrocam I’s w/ digital camera option. 2.2 Error Messages The explanations of the following error messages assume that you are Windows savvy.
Page 23
• 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.
2.3 Optional Equipment Optional equipment can include the following items: License: Multi-user site software license Adapter: 4 Camera adapter Digital Camera adapter Camera: Selected camera, specify type Interface cable BNC cable Camera manual (if supplied by camera manufacturer) Camera power supply (if supplied by camera manufacturer)
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.
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.
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. To operate your Pyrocam I with model LBA-500PC-D or a model LBA-7XXPC-D, with the digital camera option, see section 2.12.2.
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.
Pyrocam were not equipped with digital outputs. If your Pyrocam I does not have a 50 pin connector on its rear cover it can not be interfaced as a digital camera. However, you can still interface it by using the analog method described in the LBA-300PC interface topic.
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.
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.
Is the native file extension denoting a data file created by the LBA-PC. The number indicates that the data was created by either the LBA-300 (8-bit frame grabber), -400 (10 bit frame grabber), –500 (12 bit frame grabber), or with a new –7XX (multi-format frame grabber). If the saved file was generated using Ultracal processing then the results obtained when loading and viewing this file type are of high quality.
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 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.
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.
3.1.2.1 Save As … Dialog Box Enter the drive:\paths\<filename> 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.
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.
<filename>000000.cma;<filename>000001.cma;...<filename>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.
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.
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.
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 or the time remaining .
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 get here via the File, and Print...
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.
3.1.16.1 Save FROG as…Dialog Box Enter the drive:\paths\and <filename> 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.
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.
Page 48
• 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. •...
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.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.
X and Y axes of the beam if Elliptical is OFF, and on the Major and Minor axes of the beam if Elliptical is ON. You should always enable Auto apertures whenever performing second moment D 4-Sigma beam width measurements.
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. •...
• 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.
The Frame Buffer is loaded in a sequential round robin fashion. Frames of data can be placed into the frame buffer by: • Digitizing the video input signal. • Transferring data from a digital camera. • Loading in data from disk files. • Post processing data already in the frame buffer.
Pixel Bits setting is –12. If your digital camera has more bits of resolution than can be accommodated by the LBA-PC, you must connect only the upper most significant bits. Any left over data bits will not be processed by the LBA-PC.
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.
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.
Page 59
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.
Page 61
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.
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;...
Page 63
• 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. •...
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.
• 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.
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. •...
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...
If you enter an Energy of Beam value of 0 (zero) the energy Total ( ), 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.
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.
Page 70
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 TEM content, and for many other mixed mode combinations.
Hat results are computed. These choices and their affects are: • Data: This method will include all data above the Clip% level. If you are using 4 Sigma, or one of the Knife Edge beam width methods, the Clip% level is forced to 80% of peak. •...
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.
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.
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.
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.
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.
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.
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.
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.
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 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.
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 LBA- PC 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.
Page 84
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.
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.
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...
Page 88
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 and restarted. 3.2.9.2.1 Sample Limit The strip chart display may become so compact that recent data points become visually...
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.
Page 90
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.
Page 91
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).
Page 92
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.
Page 93
Note how peak locations seem to fall in a grid like pattern. This is to be expected when you are capturing every 4 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 >...
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.
Page 95
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.
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.
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.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.
3.3.1.1 PASS or FAIL 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.
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.
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.
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.
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: •...
Page 104
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.
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.
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 <Frame>...
Page 108
<Frame> 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. •...
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.
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: •...
With the release of version 4.00 a new Full 1x camera resolution has been made available. This resolution makes the hardware zooming operate for an analog camera the same as if it were a digital camera. See the next section to learn how digital camera zooming operates. Operator’s Manual...
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.
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.
Bucket Size is based upon a single count of the 8/10/12/14/15 bit digitized output of the A to D converter or digital camera. The Bucket will be scaled if energy calibration is in use. See Histogram computations in Chapter 6.
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.
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). •...
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.
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.
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.
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.
5 seconds, or 1/5 Hz. 5.3 Integration Control If you have purchased the digital camera option then multiple frame integration can be performed when using certain select digital cameras. This feature is not usually required for laser beam analysis because most lasers are much too bright when compared to camera sensitivity.
1. This number represents the number of frame periods that the camera will use for each frame of output video. 5.4 Digital Camera Operations The largest growing segment of the camera market involves a rapid increase in the numbers and types of digital cameras available for both commercial and scientific uses.
5.4.1.2 Digital Camera ROI Formating Some digital cameras have a feature that allows then to readout only a defined Region Of Interest (ROI) of the focal plane array. This will reduce the data and increase the frame rate of the cameras operation.
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.
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.
6.3 Beam Presentation Affects Results Effective beam presentation is essentially an attempt to improve accuracy by increasing the signal-to- noise 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.
Effective Area. Depending upon the Beam Width Method, the clip level value is determined as follows: • With the 4-Sigma and Knife-Edge methods and with the Top Hat results disabled, the LBA energy totals the pixel values in descending order until it finds the pixel which causes the sum to exceed 86.5% of the total...
Clip% level. • If the 4 Sigma or one of the Knife Edge methods are chosen and the Top Hat calculations are not checked, the clip level is set to 86.5% of energy. If the Top Hat calculations are checked, then an 80% of Peak clip level is set.
This definition has grown out of laser beam propagation theory and is called the Second Moment, or D-4-Sigma beam width. (The D erroneously stands for Diameter.) Sigma refers to the common notation for standard deviation. Thus an X-axis beam Width is defined as 4 times the standard deviation of the spatial distribution of the beam’s...
The standard deviations are derived from the variances of the energy distributions and are equal to the standard deviations squared. The variances are: Where: Z = the intensity of the pixel x and y are the coordinates of the centroid Only beam propagation factors based on beam widths and divergence angles derived from the second moments of the energy density distribution function, will allow one to predict how a beam will propagate.
equivalent second moment width for TEM 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.
Where: = Amplitude of the pixel data at (x,y). = 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 Where: Parameters marked with an asterisk (*) are variables fitted. & are not the same as the displayed Centroid Major and Centroid Minor results. However, they are used to compute those results items. Note: There is some display limitations when using the Line Gaussian Fit results. If you have set your Reference Source to either Last Gauss or Auto Gauss, no full frame Gaussian beams will be available to be placed into the Reference frame buffer.
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.
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, Where: Σ...
Page 140
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.
Where: 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.
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 Stubenrauch, NBS Technical Note 1001, March 1978.
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.
for the Standard Deviation, Where: σ Σ(S - )² 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 general- purpose algorithm will be described here.
50 pin connector attached to a PC mounting bracket. 7.2 I/O Connections The digital camera connector is a 50 pin standard SCSI-2 style, however the circuit connections are NOT SCSI compatible. A typical compatible cable assembly is AMP 750254-2. Sample compatible connector / cable components are: •...
Page 149
Digital Camera Connections for LBA-400/500 Model Frame Grabbers VD12+ VD13+ VD14+ VD15+ Digital Camera Connections for LBA-7XX Model Frame Grabbers Operator’s Manual Doc. No. 10654-001, Rev 4.10 Figure 60 VD12- VD13- VD14- VD15- Figure 61 LBA-PC...
Page 150
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 VD11, and the MSB data to VD10.
Page 151
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.
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.
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.4 Digital Camera and Ultracal Operation The Ultracal! operation can be adversely affected by how your digital camera is adjusted. Some digital cameras will have their A to D converter black levels set such that some or all of the negative pixel energy is clipped at Zero.
Page 155
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.10 LBA-PC...
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.
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. Using the LBA-PC ActiveX server, you can: •...
Go to the Visual Basic Editor. On the Tools menu, select Macro, and then select Visual Basic Editor. A new VBA window will open. 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.
the next line, type “LbapcActiveX.Open” without the quotation marks. This statement initiates communication between the LBA-PC ActiveX control and LBA-PC. 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.
Methods - Functions you can call to perform some operation Events - Notification when things happen 9.3.1 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.
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.5 NewFrame, HoldNewFrame These properties can be used for polling when a new frame is collected by LBA-PC and to hold...
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 identical to setting Energy of Beam in the LBA-PC Computations dialog.
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: Quantitative Elliptical Gauss Fit – whole beam Gauss Fit –...
QuantBeamWidthY QuantDiameter 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: ×...
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. Property Name TophatWholeMean TophatWholeStdDev TophatWholeSDMean TophatWholeMin TophatWholeMax TophatMajorMean TophatMajorStdDev TophatMajorSDMean TophatMajorMin TophatMajorMax TophatMinorMean TophatMinorStdDev TophatMinorSDMean TophatMinorMin TophatMinorMax Operator’s Manual GaussMajorCentroid Centroid X...
TophatEffectiveArea TophatEffectiveDiameter TophatFactor 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. 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.
Standard Deviation Minimum 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.
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.
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.
The LBA-PC is not available LBA-PC is collecting frames of data The Ultracal operation runs for unknown amount of time depending on the camera and the LBA- PC 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.
Capture Mode Single Shot Continuous FALSE Continuous TRUE OnNewFrame.vi contains an example of reading property values after receiving an OnNewFrame event. All example VIs are packaged in LbapcActiveX.llb, which can be found in the “ActiveX\Examples\LabVIEW” directory under the LBA-PC installation directory. In Visual Basic you can read any desired properties during this event.
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.
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.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.
Page 176
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.
Chapter 10 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.
Page 178
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...
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...
value Value assigned to key (DAB) = 8 bit data byte in binary format (^END) = Indicates that EOI is asserted with the last byte sent. 10.4.4 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.
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.
Page 184
Integer. ASCII numeric value in integer format. Boolean. ASCII numeric integer value. 0 = false. 1 = true. Fixed/Floating. ASCII numeric value in fixed or floating point notation. String. Series of ASCII characters. Note that the backslash, “\”, has special meaning in strings known as an escape sequence.
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.
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.
Page 188
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). The LBA-PC responds to the query by repeating RCC or RCR followed by two parameters specifying the frame number and number of data rows or number of data columns.
2 raised to the power of PixelBitsFraction (128, 32, 8, or 2 for the LBA-300/708PC, LBA-400/710PC, or LBA-500/712PC, or LBA-714PC respectively). The LBA-PC responds to the query by repeating RDD followed by three parameters specifying the frame number, number of data columns, and number of data rows.
d..d (DAW) = 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. The following example describes how the host controller requests the current frame and receives the data.
FRM? Download data file Upload data file File | Load… data file File | Save As… data file 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.
LBA-PC sends 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.
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.
• 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.
Page 196
The following example describes how to download the current result values displayed in the results window: Host sends :RDR? (^END) LBA-PC sends 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 ,%,,,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.
#516384(DAB)…(DAB)(^END) LBA-PC sends 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.
Page 199
• 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 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.000e+00;...
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.
Pan/Zoom Window Capture Window 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. This origin does not start at x=0, y=0, rather it relates to electronic timing of the camera.
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.
Page 203
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 2 value of 1 represents 2 = 2, 2 represents 2 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 2 actual size of the capture window is 128 X 120.
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.
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.
Page 207
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;...
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.
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.1 standard according to the following Subset Codes:...
A.2 IEEE 488.2 Common Commands The following IEEE 488.2 common and related commands are supported by the LBA-PC. Command Meaning *IDN? Identification *RST Reset :CLR Clear Queues and Status Registers *CLS Clear Status Registers :ELE 300PC Event Status Enable :ELE? :ELR? 300PC Event Status...
Page 213
Command Meaning *ESE Event Status Enable *ESE? *ESR? Event Status Register *SRE Service Request Enable *SRE? *STB? Status Byte Operator’s Manual Doc. No. 10654-001, Rev 4.10 Usage Sets mask to enable event status notification of corresponding bits set in ESR. Return ESE contents.
Page 214
Command Meaning All other IEEE 488.2 common commands are not recognized by the LBA-PC and will return a Command Error. Operator’s Manual 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.
Page 215
Standard Event Status Enable *ESE, *ESE? & & & & & & & & L o g i c a l AN D & Status B yte Enable Register *SRE, *SRE? Operator’s Manual Doc. No. 10654-001, Rev 4.10 Standard LB A-300PC Event Status Event Status Register...
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. The following are some typical formats for command and response transmissions: cmd: *CCC(^END)
Page 217
Type Description Fixed/Floating. ASCII numeric value in fixed or floating point notation. 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”...
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 <configuration> :SDC ConfigFileName A.5.1.3 LDD - load data from file NOTE: There is no default path for this command.
Page 219
NumberRecords I StartFrame Replace A.5.1.4 SDD - save data to file NOTE: There is no default path for this command. If you want the to be saved in a particular path then send the path with the file name. :SDD <configuration> :SDD? FileName Operator’s Manual...
Page 220
NumberRecords I StartFrame Append Replace Operator’s Manual Type Value Description Maximum 256 characters. default = filename from last load or save data command 0 = all records (up to frame buffer size) 1 to n. ‘n’ is the size of the frame buffer. forced to 1 when StartFrame <...
Page 221
A.5.1.5 EXP - set export configuration & export image(s) :EXP <configuration> :EXP? Export Replace ExportFileName StartFrame NumberFrames AsciiComma AsciiSpace CursorData ColumnRowSum A.5.1.6 LOG - set logging configuration NOTE: There is no default path for this command. If you want the data log file, results log file, or export log file(s) to be saved in a particular path then send the path with the file name.
Page 222
DataLogging DataFileName ResultsLogging ResultsFileName ResultsFormat ExportLogging ExportFileName Operator’s Manual Type Value Description Data logging enable. 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.
Page 223
AsciiComma AsciiSpace CursorData ColumnSumRow LoggingMethod NumberFrames Time PassFailFilter A.5.1.7 GAI - generate gain frame This command is equivalent to selecting File | Generate Gain. To read or write the gain frame data use the RDD or FRM command with the StartFrame parameter set to -1. :GAI A.5.1.8 REF - set reference...
Print BeamImage Results SeparatePages CurrentOnly StartFrame NumberFrames 2DdarkBackground A.5.2 Options Menu A.5.2.1 APT - set aperture configuration :APT <configuration> :APT? DrawShape CenterXLoc CenterYLoc Major Minor Rotation DisplayShape Operator’s Manual Type Value Description start printing now default = true Print beam enable. Print results enable.
Page 225
AutoAperture A.5.2.2 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.
Page 226
PixelHScale PixelVScale4 PixelUnits Gamma Lens A.5.2.3 CAP - set capture configuration :CAP <configuration> :CAP? CaptureMethod CaptureInterval BlockLength Operator’s Manual Type Value Description 8 to 15, -8 to -15 Horizontal pixel scale. Forced equal to vertical pixel scale if SyncSource is genlock Vertical pixel scale.
Page 227
CameraInput CameraInput2 CameraInput3 CameraInput4 CameraShutter CameraShutter2 CameraShutter3 CameraShutter4 CameraGainEffect CameraGainEffect2 CameraGainEffect3 CameraGainEffect4 CameraBlack CameraBlack2 CameraBlack3 CameraBlack4 TriggerType TriggerOutAlways TriggerOutDelay TriggerPolarity TriggerInterval Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description Which camera input is in use. Cannot be set. To select which camera is in use, set only one of the CameraInput# below.
Page 228
VideoTriggerLevel VideoTriggerLevel2 VideoTriggerLevel3 VideoTriggerLevel4 Summing SummingFrames Average AverageFrames GainCorrect ReferenceSubtract ReferenceSource Convolution MaxFrameSize ZoomIndex Operator’s Manual Type Value Description 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 Video trigger level for cameras 2 to 4.
Page 229
NumZooms CaptureLocation CaptureSize CaptureResolution A.5.2.4 COM - set computations configuration :COM <configuration> :COM? EnergyOfBeam EnergyOfFrame4 EnergyUnits Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description 0 to NumZooms-1. Maximum zoom index value X,Y upper left corner of capture area (see PAN) Width and height of frame These values are set via ZoomIndex...
Page 230
Type Value Description 9 = pw 10 = fl Quantitative results enable. Beam width method. 0 = 4 sigma 1 = knife edge 90/10 2 = knife edge 3 = energy (uses ClipHigh) 4 = peak 1 to 99, < ClipHigh 1 to 99, >...
Page 231
Histogram Buckets Statistics StatisticsMethod Frames Time A.5.2.5 DIS - set display configuration :DIS <configuration> :DIS? BeamView2D Cursors CursorProfiles Origin Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description 0 to 1.0e12 Histogram enable. Histogram bucket width, 1 to 256 Statistics enable.
Page 232
ManualOrigin BeamColors PaletteFileName ScaleType BeamDisplay ReferenceSource LowerThreshold Operator’s Manual Type Value Description 4 = window lower left X,Y detector location of manual origin. Range depends on camera. Beam display color. 0 = bands 1 = continuous 2 = gray scale 3 = user specified palette 4 = green 5 = yellow...
Page 233
UpperThreshold ColorBar CursorAxis Crosshair Grid CrossHatch Contour WireFrame Rotate Tilt Slice Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description EnergyOfBeam=0) then the range is 0 to 255. energy is calibrated then the range energy depends on the calibration. energy Upper color display threshold.
Page 234
A.5.2.6 PSW - enter password :PSW <configuration> Password :PSW? Returns: PSW < configuration > Lockout A.5.3 Pass/Fail Menu A.5.3.1 PFF - set pass/fail master configuration :PFF <configuration> :PFF? PassFail Beep Stop When A.5.3.2 pass/fail quant configuration Total Operator’s Manual Type Value Description See online help under Password Lockout for information about passwords.
Page 235
TotalMin TotalMax Percent PercentMin PercentMax PeakFluence PeakFluenceMin PeakFluenceMax ValleyFluence ValleyFluenceMin ValleyFluenceMax Centroid CentroidXLoc CentroidYLoc CentroidRadius Major MajorMin MajorMax Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description energy Total minimum. -1e12 to 1e12 energy Total maximum. -1e12 to 1e12 Min,Max test enable.
Page 236
Minor MinorMin MinorMax Diameter DiameterMin DiameterMax A.5.3.3 pass/fail elliptical configuration Roundness RoundnessMin RoundnessMax Orientation RotateOrientation RotateRange A.5.3.4 pass/fail gauss configuration GaussCentroid GaussCentroidXLoc Operator’s Manual Type Value Description Min,Max test enable. Minor axis minimum in world coordinates 0 to 1e12. Minor axis maximum in world coordinates 0 to 1e12.
Page 237
GaussCentroidYLoc GaussCentroidRadius GaussCentroidMinor GaussCentroidRadiusMinor F GaussMajor GaussMajorMin GaussMajorMax GaussMinor GaussMinorMin GaussMinorMax GaussHeight GaussHeightMin GaussHeightMax GaussCorrelation Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description -1e12 to 1e12. Y location in world coordinates -1e12 to 1e12. Maximum distance from (CentroidXLoc, CentroidYLoc) in world coordinates 0 to 1e12.
Page 238
GaussCorrelationMin GaussCorrelationMax GaussDeviation GaussDeviationMin GaussDeviationMax GaussHeightMinor GaussHeightMinorMin GaussHeightMinorMax GaussCorrelationMinor GaussCorrelationMinorMin GaussCorrelationMinorMax F GaussDeviationMinor GaussDeviationMinorMin Operator’s Manual Type Value Description Gauss Correlation, Gauss Correlation Major, or Gauss Correlation X; minimum. 0 to 1. Gauss Correlation, Gauss Correlation Major, or Gauss Correlation X; maximum. 0 to 1.
Page 239
GaussDeviationMinorMax A.5.3.5 pass/fail top hat configuration TophatFluence TophatFluenceMin TophatFluenceMax TophatMean TophatMeanMin TophatMeanMax TophatDeviation TophatDeviationMin TophatDeviationMax TophatSDM TophatSDMMin Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description 0 to 1e12. Gauss Deviation Minor, or Gauss Deviation Y; maximum. 0 to 1e12. Type Value Description Min,Max test enable.
Page 240
TophatSDMMax EffectiveArea EffectiveAreaMin EffectiveAreaMax EffectiveDiameter EffectiveDiameterMin EffectiveDiameterMax TophatFactor TophatFactorMin TophatFactorMax TophatMeanMinor TophatMeanMinorMin TophatMeanMinorMax TophatFluenceMinor TophatFluenceMinorMin TophatFluenceMinorMax TophatDeviationMinor TophatDeviationMinorMin TophatDeviationMinorMax Operator’s Manual Type Value Description Tophat SD/M, or Tophat SD/M X; maximum. 0 to 1e3. Min,Max test enable. Effective area minimum. 0 to 1e12.
Page 241
TophatSDMMinor TophatSDMMinorMin TophatSDMMinorMax A.5.3.6 pass/fail divergence configuration DivergenceMajor DivergenceMajorMin DivergenceMajorMax DivergenceMinor DivergenceMinorMin DivergenceMinorMax A.5.4 Remote Specific Commands If a key is not specified with the command then the default value is the last value set (restore config, previous command) unless otherwise specified in the description. Range checking is performed on all values in key=value for each transmitted command.
Page 242
UltracalOff 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 <configuration> Cursor :CHR? Returns: CHR <configuration> If cross hair is set to centroid, peak, or origin then returns centroid, peak, or origin location respectively.
Page 243
Delta A.5.4.4 DSF - display frame :DSF <configuration> :DSF? FrameNumber A.5.4.5 ERR - error reporting :ERR <configuration> Verbose :ERR? A separate output queue is maintained for error messages. Each time :ERR? is received the LBA- PC returns the next message in the error message queue. If the queue is empty the LBA-PC returns the current verbose setting, i.e.
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.
Page 245
Message different camera resolution cannot set while running CAM file error file name contains illegal characters directory path does not exist error in directory path or file name file error file does not exist Not a valid LBA- PC data file cannot write to file created by previous version...
Page 246
Message crosshair mode not set to manual not in remote 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 Cannot run Ultracal because all frames are write protected.
Page 247
Message File name contains illegal characters Directory path does not exist Error in directory path or file name File error Error reading Gain file. some value in the Gain file is greater than maximum allowed value of 2. Load Gain Aborted. Some value in the Gain file is less than 0.
Page 248
Message Cannot Load file because all frames are write protected. File camera does not match current camera. File record header does not match current configuration. This is not a valid LBA-PC data file. This is not a Demo file. Insufficient memory for dialog box. Out of memory TFileSaveDialog returned Error #%lx TFileOpenDialog returned Error #%lx...
Page 249
Message Error in directory path or file name. Start record (%ld) is beyond the end of the file (%ld). Start record plus number records (%ld) is beyond the end of the file (%ld). This is not a valid LBA-PC data file. File's camera does not match configuration camera.
Page 250
Message %s detected but cannot be initialized. LBA-PC set to Off-Line mode. Unable to load LCA program file (%s). Press OK to stop Auto Calibration. 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.
Page 251
n..n number of data bytes (DAB) = data byte - 8-bit data byte FrameNumber Replace A.5.4.7 FST - frame status information :FST <configuration> :FST? [FrameNumber=f] Returns: FST <configuration> Operator’s Manual Doc. No. 10654-001, Rev 4.10 Type Value Description frame number -1 = gain frame 0 = reference frame 1 to n.
Page 252
FrameNumber Date Time CameraInput PixelBits PixelHScale PixelVScale PixelUnits Gamma Lens PixelBitsFraction CaptureLocation CaptureSize CaptureResolution Operator’s Manual Type Value Description frame number -1 = gain frame 0 = reference frame 1 to n. ‘n’ is the size of the frame buffer. default = current frame MM/DD/YY HH:MM:SS.DD...
Page 253
EnergyOfBeam EnergyOfFrame EnergyUnits CommentLine WriteProtect A.5.4.8 LOC - go to local When the LOC message is sent or when the LBA-PC goes from remote to local via the REN line then local control is restored (equivalent to password lockout being disabled). Operator’s Manual Doc.
Page 254
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.
Page 255
±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.
Page 256
NOTE: The detector origin is always the upper left corner so that y values increase going down and decrease going Returns: PNW <configuration> UpperLeft LowerRight A.5.4.13 PFS? - read pass/fail status :PFS? Returns: PFS <configuration> Note: Only results that are tested are returned. Label Status Example return:...
Page 257
Column Returns: RCC FrameNumber=f;Column=c;#dn..n(DAW)( DAW)…( DAW)( DAW) Where: frame number which column is being returned pound symbol number of digits to follow in n..n n..n number of data words (i.e. column height) (DAW) = data word is two 8-bit data bytes, low byte followed by high byte Each data word is a two’s complement fixed point value in one of the following formats: siiiiiii ifffffff siiiiiii iiifffff...
Page 258
FrameNumber Returns: RCR FrameNumber=f;Row=r;#dn..n(DAW)( DAW)…(DAW)(DAW) Where: frame number which row is being returned pound symbol number of digits to follow in n..n n..n number of data words (i.e. row length) (DAW) = data word is two 8-bit data bytes, low byte followed by high byte Each data word is a two’s complement fixed point value in one of the following formats: siiiiiii ifffffff siiiiiii iiifffff...
Page 259
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.
Page 260
Where: sign bit integer 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? <configuration>...
Page 261
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.
Page 262
Results 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., this is the range of values that will be displayed in the status bar if you move the cursors in the beam window from the upper left corner to the lower right corner).
Page 263
:ZOM? Returns: ZOM Zoom=z A.5.4.25 ZMM - zoom information :ZMM? Returns: ZMM <index=zoom>;…;<index=zoom>;; 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;;...
Page 264
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; Cannot be set while LBA-PC is running. Cannot be set, information only. World coordinates are based on the frame size, capture resolution, origin location, and pixel scale. Use the WLD? command to determine frame current boundaries.
Appendix B 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.
Page 266
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++ .
Page 267
B.2.4 Do Ultracal .vi Description: Turn Ultra calibration on and wait to be completed. Input 1. GPIB address 2. Error in B.2.5 Frame SRE .vi Description: Enable Service Requests for frame data. Input 1. GPIB address 2. Error in B.2.6 Get Basic Results .vi Description: Get current results from LBA-PC .
B.2.8 Get Palette .vi Description: Get color palette table from LBA-PC . Input 1. GPIB address 2. Error in B.2.9 Get Pan Location .vi Description: Get current pan location . Input 1. GPIB address 2. Error in B.2.10 Get Tophat Results .vi Description: Get current tophat results from LBA-PC .
B.2.12 Move Cursor .vi Description: Move cursor based on a click of one of four buttons. Input 1. GPIB address 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 1.
Input 1. GPIB address 2. Run/Stop boolean 3. Error in B.2.20 Save Configuration .vi Description: Save a configuration file to remote machine. Input 1. GPIB address 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.
Page 272
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. LabVIEW is a graphical computer language.
Page 273
• 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”...
Page 274
Check if the status of the cursor display has changed. Check if any Cursor-Move button has been clicked. Check if the ZoomIn and ZoomOut button has been clicked. Check if any Pan- button has been clicked. 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...
Page 275
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.
Page 278
Computations...128 90/10 knife edge ... 70 accuracy...128 beam width ...132 centroid location ...131 convolution...146 correlation of fit ...137 D4 Sigma ... 69, 132 deviation of fit...137 dialog box...109 divergence...141 effective area...141 effective diameter ...141 elliptical... 71, 134 energy calibration...67, 68 energy of beam...
Page 279
Crosshatch ... 83 Current and Reference ... 79 Cursor Files ... 35 Cursor Orientation... 76 Cursor Profiles ...78, 80, 82 D4-Sigma ... 132 Deviation of Fit ... 137 Device Driver ... 19, 22 Digital Cameras see camera, digital... 19 Display toolbar...
Page 280
FROG ... 45 gain ... 39 new camera type... 52 number of frames... 35 palette ... 96 reference data ... 37 Save As dialog box... 34 Save Configuration ...182 Set Reference... 37 Setup camera... 21 configuration files... 22 digital camera ...152 LBA-PC...
Need help?
Do you have a question about the LBA-300 and is the answer not in the manual?
Questions and answers