User’s Guide Standard Data Format Utilities Version B.02.01 Manufacturing Part Number: 5963-1715 Printed in USA December 1994 © Copyright 1989, 1991-94, 2005 Agilent Technologies, Inc..
Legal Information The information contained in this document is subject to change without notice. Agilent Technologies makes no warranty of any kind with regard to this material, including but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Agilent Technologies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Notice Hewlett-Packard to Agilent Technologies Transition This manual may contain references to HP or Hewlett-Packard. Please note that HewlettPackard’s former test and measurement, semiconductor products and chemical analysis businesses are now part of Agilent Technologies. To reduce potential confusion, the only change to product numbers and names has been in the company name prefix: where a product name/number was HP XXXX the current name/number is now Agilent XXXX.
TABLE OF CONTENTS CHAPTER 1: General Information Converting Files Between LIF Format and DOS Format . . . . . . . . . . . . . . . . . . 1-4 README.TXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Data Sharing Between Analyzers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Batch Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Displaying Analyzer Data on a Personal Computer . . . . . . . . . . . . . .
Table of Contents 60TOSDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 63TCSDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 63TOSDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 660TOSDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8 69TOSDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents File menu (if Type is ASCII) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10 Display menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 Active menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12 Format menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 Trace menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents SdfCommentHdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20 SdfCommentRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21 SdfCommentWrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22 CHAPTER 7: MATLAB MEX-Files & M-Files filtrsdf.mex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 matdemo.tim . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents 60_MX.BAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7 60_PLOT.BAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8 60_SDF.BAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-9 69_ML.BAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-10 69_MX.BAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 General Information Introduction Standard Data Format Utilities is a group of MS-DOS® programs for doing the following things (see figure 1-1, on the following page): • • • • Converting files between LIF format and DOS format. Sharing data between HP DSA analyzers. Displaying analyzer data on your PC. Reading data from files into a program. (MS-DOS is a U.S.
General Information Figure 1-1.
General Information Notice in figure 1-1 that the data from some analyzers, such as the HP 3563A, must be converted first from LIF to DOS, then to SDF format. For some other analyzers, such as the HP 3566A, no conversions are necessary—these analysers save data in SDF format directly.
General Information Converting Files Between LIF Format and DOS Format Converting Files Between LIF Format and DOS Format LIF (Logical Interchange Format) is the Hewlett-Packard standard disk format that may be used to exchange files among various HP computer systems and instruments. The LIF programs in the Standard Data Format Utilities make it possible for personal computer users to translate LIF files into DOS file format, and DOS files into LIF format.
General Information Data Sharing Between Analyzers Data Sharing Between Analyzers These utilities make it possible to take data with one analyzer and recall it into another analyzer for post-processing. (Chapter 4 describes these utilities in detail.) For example, you can make a frequency response measurement with an HP 3560A, transfer the data to your PC, convert it to SDF format, then recall it into an HP 35665A for curve fitting. Cable # HP24542G to 25 pin RS 232 HP 24542U to 9-pin RS 232 Figure 1-2.
General Information Data Sharing Between Analyzers You can compare old data from an HP 3562A to new data from an HP 35665A, as shown in figure 1-3. You can convert the HP 3562A data from LIF to DOS, then from HP 3562A format into SDF, then recall it into an HP 35665A for comparison. Or you can convert HP 35665A data from SDF format to HP 3562A format, then convert it from LIF to DOS, then recall it into an HP 3562A for comparison. Figure 1-3.
General Information Displaying Analyzer Data on a Personal Computer Displaying Analyzer Data on a Personal Computer The Viewdata utility allows you to display data graphically on your PC. You can display up to three traces of data from the same or different analyzers. For example, you can display a frequency response from an HP 3563A on trace A, a frequency response from an HP 35665A on trace B, and a frequency response from an HP 3566A/3567A on trace C. Chapter 5 describes the Viewdata utility in detail.
General Information Displaying Analyzer Data on a Personal Computer Figure 1-4.
General Information Reading Data from Files into a Program Reading Data from Files into a Program The functions in the SDF Libraries allow you to write your own C programs accessing SDF data via function calls. Chapter 6 describes libraries and includes a sample program. Minimum Requirements To run the utilities, you need the following: • • An IBM PC compatible and MS-DOS 2.1 (or greater).
General Information Installation Installation To install the Standard Data Format Utilities, copy all files on the two disks to any directory on your PC. Or, if you do not have a hard disk, you can insert the disk in an internal drive and type commands from there. Note If you are running the utilities from a floppy drive, you cannot address LIF files in that drive. The following files are on the disks: 60_ML.BAT 89TOSDF.EXE SDFPRINT.EXE 60_MX.BAT ASCTOSDF.EXE SDFTEXT.EXE 60_PLOT.BAT DEFECT.
2 What is Standard Data Format? Introduction Standard Data Format, SDF, is a data format that allows measurement and analysis data to be shared among several HP analyzers (see chapter 1 for a list of the supported analyzers). See appendix B for a complete description of each field in the SDF file. SDF supports analyzers with a very broad range of functionality. Not all the supported analyzers use SDF’s full capabilities. The rest of this chapter describes some of these differences.
What is Standard Data Format? Measurement (Data) Results Measurement (Data) Results Some analyzers save a complete set of measurement results. Others save an individual trace. For example, when you save data from an HP 3566A/67A frequency response measurement, the file includes five measurement results (or measurement data): FRF, coherence, input power, output power, and cross power.
What is Standard Data Format? Number of Input Channels (Rows) Number of Input Channels (Rows) Another difference between SDF files is the number of input channels. For example, the HP 3566A and HP 3567A are multi-channel analyzers with up to 16 input channels, and the other supported analyzers have only one or two input channels. In the SDF file, these are called ‘’rows.’’ Figure 2-2.
What is Standard Data Format? Waterfalls and Maps (Scans) Waterfalls and Maps (Scans) Some of the supported analyzers allow you to save waterfalls or maps—a number of spectra. These may be the waterfall steps for an HP 35665A measurement or map lines for an HP 3566A/67A rpm spectral map, for example. In the SDF file, these are called ‘’scans.’’ Figure 2-3. Waterfall or Map Scans Use SDFTOSDF /S to select the scan (map line or waterfall step) of interest.
What is Standard Data Format? Time Capture (Scans) Time Capture (Scans) Some of the supported analyzers allow you to capture long streams of raw time data and then later replay the data into a measurement in the instrument. The HP 3566A/3567A, HP 35665A, HP 35670A, HP 89410A, HP 89440A, and HP 3587S support this capability. The time data in the file is broken up into scans in the same manner as with waterfalls and maps (see the preceding section).
3 File System Conversion (LIF/DOS) Description LIF (Logical Interchange Format) is the Hewlett-Packard standard disk format that may be used to exchange files among various HP computer systems and instruments. The LIF programs in the Standard Data Format Utilities make it possible for personal computer users to translate LIF files into DOS file format, and DOS files into LIF format. The utilities support file conversion for both internal drives and external drives (connected on the HP-IB).
File System Conversion (LIF/DOS) Hardware and Software Requirements Hardware and Software Requirements Use of these utilities requires an IBM PC compatible with the MS-DOS 2.1 operating system (or greater). If you wish to translate or format LIF files located on an external drive you must have an SS/80 drive connected to your PC with an HP-IB card. The LIF utilities recognize all HP SS/80 drives including the HP 9122, HP 9133 (D,H,L), HP 9127A and HP 9153A.
File System Conversion (LIF/DOS) Online Help Online Help Online Help is available for each LIF utility command. For a description of a particular command and a list of its options, simply type the command name and /U. Then press return.
File System Conversion (LIF/DOS) LIF LIF Main program for LIF access. The first parameter specifies operation. Each operation has its own set of files/options. For more help on a particular command, see the rest of this chapter.
File System Conversion (LIF/DOS) LIF SCAN LIF SCAN Checks the PC for internal floppy drives and for HP-IB interface boards and then looks for disk drives (capable of reading LIF disks) connected to HP-IB. This command displays the drive specifiers of all valid disk drives which may contain LIF files. Either a Hewlett-Packard HP-IB card or a National Instrument GPIB-PCII (or AT-GPIB) card (or compatible) will be recognized.
File System Conversion (LIF/DOS) LIF SCAN Discussion ‘’702:’’ identifies a disk drive at address 2 and unit 0 connected to an HP card at select code 7. If both an HP card and an National Instrument card are connected to the same select code, then only the HP card will be recognized. This is usually not a problem since the customary select code of the HP card is 7, and the customary board name for the National Instrument card is ‘’GPIB0’’ (select code 1).
File System Conversion (LIF/DOS) LIF CHK LIF CHK Verifies that the disk inserted in the specified drive is fully readable by the LIF program. This serves two functions: first, to verify that the disk has no bad sectors (to minimize the possibility of corrupted data), and second, to verify that possible spared tracks on the disk will not interfere with the disk’s usage on the PC’s internal disk drives.
File System Conversion (LIF/DOS) LIF LS LIF LS Lists the contents of the LIF directory contained on a designated drive. All files are listed in the order that they are contained on the disk. Syntax LIF LS : [/U] [/L] [/A] [/W] or LIF DIR : [/U] [/L] [/A] [/W] Options The default option lists all normal (not PURGED) files. : The drive specifier, e.g., 702: or 70201: for an external drive, A: or B: for an internal drive. /U Show usage information for this command.
File System Conversion (LIF/DOS) LIF LS Example List directory in long format: LIF LS 702: /L Route directory listing to a file in your home directory: LIF LS 702: /A > FILELIST Discussion HP 3563A (or HP 3562A) files are all of type BDAT and the first two letters of the file name specifies the file type as follows: A1-A5 AM Aseq1 through Aseq5 Amath CF Cv Fit (S domain Curve Fit) CS Capture DA Data DM Demod (Delete Frequency) FL Fault (Fault Log) SE State ST Synth (S domain) TS Thrupt
File System Conversion (LIF/DOS) LIF CP LIF CP Copies a LIF file to a DOS file, a DOS file to a LIF file, or a LIF file to another LIF file. is the source file name and is the destination file name. The full path name must be specified for a LIF file. LIF ASCII and BDAT formats are automatically converted to DOS format. All other files are copied with no conversion. At least one of the files must be in a LIF directory (source or destination file).
File System Conversion (LIF/DOS) LIF CP Example LIF to DOS copy from an external drive to your current PC directory: LIF CP 702:DAFREQ DSK_FREQ DOS to LIF copy from home directory to external drive. /N option is used to allow the LIF file name to begin with a number. If /N were not typed the file name would be X77PSD. Note Invalid LIF filenames may cause files to be inaccessible by another LIF system, e.g., Pascal workstations or HP BASIC.
File System Conversion (LIF/DOS) LIF CP If a directory is specified as a destination, then a file with the same name as the source file will be created. If only a directory is specified as a source, then all files in the directory will be copied. For a DOS to LIF file copy, the file will be converted to either ASCII or BDAT automatically if no format conversion is specified (/A, /B, or /R).
File System Conversion (LIF/DOS) LIF CP 3-13
File System Conversion (LIF/DOS) LIF CP Example 1 Copy all the DOS files in the directory \DOSdir to the LIF disk at 702: LIF CP a:\DOSdir 702: Example 2 Copy all the DOS files with the suffix ‘’.doc’’ to LIF disk at 702: LIF CP *.doc 702: Example 3 Copy all HP 3562A data files (prefix ‘’DA’’) from a LIF disk at 702: to the current DOS directory, changing the ‘’DA’’ prefix to a ‘’.63’’ suffix. LIF CP 702:DA* *.
File System Conversion (LIF/DOS) LIF RM LIF RM Removes (deletes) the specified file from the LIF directory. Syntax LIF RM [/U] [/N] [/F] [/W] or LIF DEL [/U] [/N] [/F] [/W] Options File name. Must include drive specifier (702:, A:, etc.). /U Show usage information for this command. /N Do not translate to valid LIF file name. /F Force remove (i.e., external DOS directory). /W Wait for keyboard prompt before and after performing operation.
File System Conversion (LIF/DOS) LIF RM Discussion When you type in the name of a file (except where /N is specified), this utility automatically converts a valid LIF file name as follows: • • • • • Shifts lower to upper case. Allows ‘’_’’, ‘’.’’, and digits (0-9). Translates all other characters to the letter ‘’X’’. If the first character is not a letter, then the file name will be preceded by the letter ‘’X’’. Truncates file names to 10 characters.
File System Conversion (LIF/DOS) LIF INIT LIF INIT The command LIF INIT optionally formats and initializes a new directory on a LIF disk. Syntax LIF INIT :[name] [/U] [/F] [/O:] [/I:] [/W] Options : Drive specifier (702:, A:). [name] Optional new LIF directory name (up to 6 characters). /U Show usage information for this command. /F Format disk before initializing directory. This operation may take a few minutes to complete.
File System Conversion (LIF/DOS) LIF INIT Example Format a disk in an external drive: LIF INIT 702:MIKE /F Format a single-sided disk on an HP 9122D: LIF INIT 702:HALL /F /O:4 /I:2 Discussion The [name] specified (in this case ‘’HALL’’) is the new LIF directory’s volume name and is automatically translated to contain a valid LIF volume name as follows: • • • • • Shifts lower to upper case. Allows ‘’_’’, ‘’.’’, and digits (0-9). Translates all other characters to the letter ‘’X’’.
File System Conversion (LIF/DOS) LIF INIT HP 9122D Formatting Options If you have an HP 9122D and wish to use it to format and initialize disks with the LIF program, make sure you use the following format options.
File System Conversion (LIF/DOS) LIFDIAG LIFDIAG LIFDIAG contains diagnostic functions useful for recovering data from damaged/corrupted disks and to perform fast full LIF to LIF disk backups. The menu line for LIFDIAG contains a menu name followed by a set of command words on the top line on the display. Each command has one letter in red on a color display (bright white on monochrome display) indicating the hot key for that command. Pressing the hot key causes the command to be executed.
File System Conversion (LIF/DOS) LIFDIAG EDIT Menu: Edit: Hot Keys: Read Next Prev Find Modify Write Log Help Quit R N P F M O H Q W Read Read/display the logical sector specified. Logical sectors are always 256 bytes even though physical sectors may be 256, 512 or 1024 bytes long. For example, if the disk has 1024 byte physical sectors, then physical sector 0 is contained in logical sectors 0 through 3.
File System Conversion (LIF/DOS) LIFDIAG Log Specifies a log file where the displayed hex/ASCII sector contents will be appended to. For example, ‘’prn’’ specifies the printer. Help Display command summary on the display. Quit Quit editing this disk. Caution 3-22 Always select ‘’Quit’’ and ‘’Edit’’ again before editing a new disk. The size & characteristics of the disk are only determined when the disk is initially edited.
File System Conversion (LIF/DOS) LIFDIAG BACKUP Menu: Backup: Hot Keys: Go Source Dest Length Errors Log Help Quit G S D L E O H Q Go Start the backup. If the source and destination disks are the same, then you will be prompted to swap source/dest disks. During the backup, the PROGRESS window shows how much of the backup operation has been completed. A backup may be aborted at any time by pressing the ‘’ESC’’ key. Source Specify the external (e.g. 102:) or internal (e.g.
File System Conversion (LIF/DOS) Error Messages Error Messages Cannot format internal disk The internal disks on the PC cannot be formatted by LIF INIT. Use an HP-IB disk drive to format your disks, if available, or format your disks on another machine. Disk access (Check media) Access errors can occur on media that is possibly corrupted. Immediately, try to copy all files off the disk, or just dispose of the disk and use a backup disk. The disk may be salvageable (not the data) if it is re-formatted.
File System Conversion (LIF/DOS) Error Messages Disk timeout The external disk drive did not respond in the time allowed. This can occur if no disk drive is at the specified address, the disk is not connected properly, the disk drive is not turned on, or another device on the HP-IB is interfering with communication. DOS directory The external disk drive contains a DOS directory (it actually is a valid LIF directory which contains one file, which is the DOS directory). Be very careful with this directory.
File System Conversion (LIF/DOS) Error Messages Not a valid LIF file system The disk does not contain a valid LIF volume header. Check your disk, it is either a DOS disk, or the disk is corrupt. Not a valid format option The format option specified on the LIF INIT command is not valid for this disk drive. For example, only the format options 0 through 4 are valid on an HP 9122 disk drive. Refer to your disk drive operator’s manual for allowable format options.
4 Sharing Data Between Analyzers Introduction The Standard Data Format Utilities are programs that translate data files from the HP 35665A, HP 3560A, HP 3563A, HP 3562A, HP 3566A, HP 3567A, HP 3588A, or HP 3589A analyzers to Standard Data Format or formats compatible with ASCII, Data Set 58, PC-MATLAB, and MATRIXx. Conversions from Standard Data Format to STARModal and STARAcoustics formats are available from Structural Measurement Systems.
Sharing Data Between Analyzers The utilities are as follows: 60TOSDF Convert an HP 3560A data file to an SDF data file. 63TCSDF Convert the data portion of a binary capture/throughput file from the HP 3563A (or HP 3562A) to SDF time capture format. 63TOSDF Convert an HP 3563A (or HP 3562A) data file to an SDF data file. 660TOSDF Convert an HP 35660A data file to an SDF data file. 69TOSDF Convert an HP 3569A data file to an SDF data file. 88TOSDF Convert an HP 3588A data file to an SDF data file.
Sharing Data Between Analyzers SDFTO63 Convert a single measurement result from an SDF data file to an HP 3563A (or HP 3562A) data file. SDFTOASC Convert an SDF data file to an ASCII data file. SDFTOBIN Convert an SDF data file to a raw binary data file. SDFTOML Convert data from the SDF format to the format used in PC-MATLAB. SDFTOMX Convert data from the SDF format to the format used in MATRIXx. SDFTOSDF Extract a subset of results from an SDF file and create another SDF file.
Sharing Data Between Analyzers Hardware and Software Requirements Use of these utilities requires an IBM PC compatible with the MS-DOS 2.1 operating system (or greater). HP 3563A/3562A File Format When the HP 3563A/3562A saves measurement data or instrument states to an HP-IB disk drive, the files are saved in a non-standard binary format used by the instrument. Typically, you need to transfer three pieces of information: your setup state, file header information, and measurement data.
Sharing Data Between Analyzers 60TOSDF 60TOSDF Convert data from the HP 3560A source data file and put results in the destination SDF file. The destination SDF filename is chosen based on the register value that was used in the HP 3560A and is of the form .DAT (for example 1.DAT). Syntax 60TOSDF [/U] [/O] [/H] [/A] [/P:] Options Input HP 3560A data file name. /U Show help (usage information) for this program. /O Overwrite if it exists.
Sharing Data Between Analyzers 63TCSDF 63TCSDF Convert the data portion of a binary capture/throughput file from the HP 3563A (or HP 3562A) to SDF time capture format (16-bit integer data). The binary capture/throughput file contains digital filter data. The HP 3563A/62A capture files on a LIF file system start with the letters ‘’CS’’. Throughput files start with ‘’TS’’. Syntax 63TCSDF [/U] [/O] Options Input HP 3563A/62A capture or throughput file name.
Sharing Data Between Analyzers 63TOSDF 63TOSDF Convert an HP 3563A (or HP 3562A) data file to an SDF data file and outputs to . HP 3563A/62A data files on a LIF file system start with the letters ‘’DA.’’ Syntax 63TOSDF [/U] [/O] Options Input HP 3563A/62A data file name. Output SDF file name. /U Show help (usage information) for this program. /O Overwrite if it exists.
Sharing Data Between Analyzers 660TOSDF 660TOSDF Extract data from an HP 35660A data file and put results in the SDF data file . Syntax 660TOSDF [/U] [/O] [/H] [/A] Options Input HP 35660A data file name. Output SDF file name. /U Show help (usage information) for this program. /O Overwrite if it exists. /H Print headers to the screen. /A Print headers and data to the screen.
Sharing Data Between Analyzers 69TOSDF 69TOSDF Convert data from the HP 3569A source data file and put results in the destination SDF file. If [dfile] is not specified, the destination SDF filename is chosen based on the filename that was used in the HP 3569A and is of the form .DAT (for example, 1.DAT). If the input X32 file contains more than 1 HP 3569A trace file (SAVE/RECALL, XFER ALL TRACES), then each trace will be put in a different file with the same base name as used on the HP 3569A.
Sharing Data Between Analyzers 69TOSDF Example Transfer an HP 3569A data file (which is in Intel Hex-32 format) to a file (FREQ.X32) on a personal computer using the RS-232 port. Convert the Intel Hex-32 file to a binary data file (FREQ.BIN) and then convert the binary file to an SDF data file (FREQ.DAT). DOWNLOAD /B:19200 /P:2 FREQ.X32 X32TOBIN FREQ.X32 FREQ.BIN 69TOSDF FREQ.BIN FREQ.DAT See also the batch file ‘’69_SDF.BAT’’ in appendix C.
Sharing Data Between Analyzers 88TOSDF 88TOSDF Converts an HP 3588A data file to an SDF data file and outputs to . An HP 3588A setup state file can be optionally specified which will allow more complete parameter conversion into the SDF data file. Syntax 88TOSDF [/O] [/U] [/F ] Options Input HP 3588A data file name. Output SDF file name. /O Overwrite if it already exists. /U Show help (usage information) for this program.
Sharing Data Between Analyzers 88TOSDF Discussion When using the /F option, the setup state file must contain the analyzer state information that represents the setup whenever the measurement data was saved to disk. If the /F option is not used in the conversion or the setup state file does not reflect the setup whenever the measurement data was saved, the following fields may not be set properly in the SDF file .
Sharing Data Between Analyzers 89TOSDF 89TOSDF Converts an HP 3589A data file to an SDF data file and outputs to . An HP 3589A setup state file can be optionally specified which will allow more complete parameter conversion into the SDF data file. Syntax 89TOSDF [/O] [/U] [/F ] Options Input HP 3589A measurement data path and file name. Output SDF path and file name. /O Overwrite if it already exists.
Sharing Data Between Analyzers 89TOSDF Discussion When using the /F option, the setup state file must contain the analyzer state information that represents the setup whenever the measurement data was saved to disk. If the /F option is not used in the conversion or the setup state file does not reflect the setup whenever the measurement data was saved, the following fields may not be set properly in the SDF file .
Sharing Data Between Analyzers ASCTOSDF ASCTOSDF Convert the source file to the destination file and place the result in the destination file. The following options are only valid when used with the /T (template SDF file) option; /D, /R, /C, /S. The options described after the /T option are only used if a template SDF file is not specified.
Sharing Data Between Analyzers ASCTOSDF /B: Block size. Use this when the header type is Time. The default is the number of points in the file. /L: Frequency lines. Use this when the header type is not Time. The default is the number of lines in the file. /Z: Turn on zoom and set Center Frequency (use when header type is TIME) /X:[,L] Generate X data. Start and Delta values are required. The optional [L] signifies log. Otherwise linear is used.
Sharing Data Between Analyzers BINTOX32 BINTOX32 Convert data from the HP 3569A source binary file and put the results in the destination Intel Hex-32 data file. Syntax BINTOX32 [/U] [/O] Options Input binary file name. Output Hex-32 file name. /U Show help (usage information) for this program. /O Overwrite if it exists. Example Convert an HP 3569A binary data file (FREQ.BIN) to an Intel Hex-32 file (FREQ.X32): BINTOX32 FREQ.BIN FREQ.
Sharing Data Between Analyzers DFDATA63 DFDATA63 Converts the data portion of a binary capture/throughput file (containing digital filter time data) from the HP 3563A (or HP 3562A) to a PC-MATLAB MAT-file, a MATRIXx file, or an ASCII file. Since capture/throughput data can be very long, the /B and /P options can be used to select only a portion of the data in a file. The /C option only needs to be specified for a 2 channel throughput file to select channel 2 as the source of data.
Sharing Data Between Analyzers DFDATA63 Example 1 Convert up to 4096 points of your file (GLITCH) to a PC-MATLAB file (GLITCH.MAT); includes X-axis data points. Note the PC-MATLAB searches for a file with the suffix ‘’.MAT’’ if no suffix is specified. See appendix for more information on loading a file into PC-MATLAB. DFDATA63 GLITCH C:GLITCH.MAT /L /X /P:4096 Example 2 Output channel 2 data (THRUPUT) to an ASCII file (THRUPT.
Sharing Data Between Analyzers DFHDR63 DFHDR63 Converts the header portion of a binary capture/throughput file (containing digital filter data) from the HP 3563A (or HP 3562A) to an ASCII form . Refer to the HP 3563A or HP 3562A Programming Manual for descriptions of the individual fields in the capture/throughput file. HP 3563A/62A capture files on a LIF file system start with the letters ‘’CS’’; throughput files start with the letters ‘’TS.
Sharing Data Between Analyzers DFHDR63 Example After copying the capture/throughput file to your PC,using the LIF CP command (LIF CP 702:CSGLITCH GLITCH), type: DFHDR63 GLITCH GLITCH.ASC The file GLITCH.ASC will include a list such as the following. Complex_data)_flag False Bytes_per_point 2 Points_per_record 2048 Channel_type.
Sharing Data Between Analyzers DOWNLOAD DOWNLOAD Transfer data over the personal computer’s RS-232 port and place it in the destination file. Syntax DOWNLOAD [/U] [/O] [/B:] [/P:] Options Output file name. /U Show help (usage information) for this program. /O Overwrite if it exists. /B: Select the baud rate for the communications port. Valid baud rates are 110, 150, 300, 600, 1200, 2400, 4800, 9600, or 19200. The default value is 9600.
Sharing Data Between Analyzers HEADER63 HEADER63 Converts the data header portion of a binary data file from the HP 3563A (or HP 3562A) to an ASCII form [dfile]. Refer to the HP 3563A or HP 3562A Programming Manual for descriptions of the individual fields in the data file. HP 3563A and HP 3562A data files on a LIF file system start with the letters ‘’DA.’’ Syntax HEADER63 [dfile] [/U] [/O] [/L:] [/E:] Options Input HP 3563A/62A data file name.
Sharing Data Between Analyzers HEADER63 Example After copying the data file to your PC, using the LIF CP command (LIF CP 702:DAFREQ FREQ1), type: HEADER63 FREQ1 FREQ1.ASC /L:0 The file FREQ1.ASC will include a list, such as the following. Power_spectrum_1 801 801 1 Channel_1 No_channel 87 Freq uency RMS Volts_squared Hertz “AUTO MATH” “” “” “” True Fa lse Discussion The destination file contains one line for each field in the data header.
Sharing Data Between Analyzers HPIB63 HPIB63 Transfer the active trace data from an HP 3562A/63A over the personal computer’s HP-IB and place it in the destination file. Use 63TOSDF.EXE to convert the file to SDF. If /A is not specified, then HP-IB will be scanned for the first instrument that is an HP 3562A or HP 3563A. Syntax HPIB63 [/U] [/O] [/I] [/A:] Options Destination HP 3562A/63A file name /U Show this usage. /O Overwrite if it exists.
Sharing Data Between Analyzers REPEAT REPEAT Repeatedly calls the specified program, varying the file name (with wild cards) and the destination file name, or all the results/rows/columns/scans in the specified file(s). Syntax REPEAT [/U] [/I] [/E] [/A] [] [/D:*] [/R:*] [/C:*] [/S:*] [(dfile)] Options Program to REPEAT. /U Show this usage. /I Ignore errors. /E Echo commands before executing program. /A Append to destination path. /D:* Repeat for all data results.
Sharing Data Between Analyzers REPEAT Example To convert all the scans in MAP.DAT to ASCII and put each scan in a different file (e.g. 0.asc, 1.asc, etc.): REPEAT SDFTOASC /S:* MAP.DAT (#.ASC) Same as above, but append all ASCII data to one file (e.g. map.asc): REPEAT /A SDFTOASC /S:* MAP.DAT (MAP.ASC) Plot all results/rows/scans in all *.dat files and put all plotted results for each file in a plot file with the same base name as the data file (e.g. *.plt): REPEAT /A VIEWDATA /D:* /R:* /S:* *.DAT /P:(*.
Sharing Data Between Analyzers SDFEDIT SDFEDIT Edit (change) header fields in an SDF file. Fields are not case sensitive and may be abbreviated. Multiple fields and Multiple SDF header types may be specified. If no field is specified, then all fields in the header are displayed. Syntax SDFEDIT [/U] [/I] [/F] [/M] [/D:] [/V:] [/C:] [/S] [/T:] [/B:] [/N:] [/Q:] = ... Options SDF file to edit. /U Show this usage.
Sharing Data Between Analyzers SDFEDIT Example To change the point and/or direction on an already existing SDF file, see the following SDFEDIT example: To change the point number for channel 0 in the file test.dat to point 52 type: sdfedit test.dat /c:0 point=52 To see the current point number type: sdfedit test.dat /c:0 point To see the choices for direction for channel 0 type: sdfedit test.dat /c:0 direction= or sdfedit test.dat /c:0 dir= You can abbreviate field names.
Sharing Data Between Analyzers SDFPRINT SDFPRINT Converts the contents of the input SDF file to ASCII and prints all or portions of it. Either the SDF record headers (default) and/or the data associated with the SDF_SCAN_HDR, XDATA, YDATA, and comment records may be printed. Syntax SDFPRINT [dfile] [/U] [/O] [/I] [/V] [/H] [/T:] [/A] [N:<#perLine>] [/D:] [/S:] [/R:] [/C:] [/P:] [/E:] [/W:] Options Input file name for SDF file.
Sharing Data Between Analyzers SDFPRINT /C:
Print data only for the specified column. If not specified, then all columns in will be selected. /P: If is non-zero, print SDF record titles (default on). /E: If is non-zero, expand enums to labels (default on). /W: If is non-zero, scale the data for the window and engineering units. (default on).Sharing Data Between Analyzers SDFPRINT To print all the headers to this SDF file type: SDFPRINT SINEARB.DAT To print only the data for ‘’Normalized Variance’’ channel 2 (row 0 is channel 1, row 1 is channel 2) type: SDFPRINT SINEARB.DAT /D:1 /R:1 To now print this data in pure ASCII with no record headers: SDFPRINT SINEARB.DAT /D:1 /R:1 /P:0 Discussion The HP 3566A/67A generally puts all results from a measurement in a single file (see example above).
Sharing Data Between Analyzers SDFPRINT SDF_COMMENT_HDR Contains comments about the data. XDATA Contains the X-axis data needed to reconstruct a trace. This can be used by Swept Sine or Order Analysis measurements. YDATA Contains the Y-axis data needed to reconstruct any trace.
Sharing Data Between Analyzers SDFTEXT SDFTEXT Modify/print SDF file comment text data. If [cfile] is specified then the comment in the SDF file is modified, otherwise the comment is printed. If the /A option is not specified, then the previous comment in the file is replaced with [cfile]. If there is not enough space in the specified comment for the text, then the text will be truncated.
Sharing Data Between Analyzers SDFTO58 SDFTO58 Convert SDF file to the Data Set 58 format. The result is placed in an output file [dfile] if specified; otherwise the result is sent to the screen. Syntax SDFTO58 [dfile] [/U] [/O] [/I] [/A] [/H] [/D:N1[-N2]] [/R:N1[-N2]] [/C:N1[-N2]] [/S:N1[-N2]] Options Input SDF file name. [dfile] Optional output file name for ASCII information. If no file name is specified, output to display.
Sharing Data Between Analyzers SDFTO63 SDFTO63 Converts a single measurement result from an SDF data file to an HP 3563A (or HP 3562A) data file . HP 3563A/62A data files on a LIF system start with the letters ‘’DA.’’ Syntax SDFTO63 [/U] [/O] [/I] [/D:] [/S:] [/R:] [/C:] Options Input SDF file name. Output file name for HP 3563A/62A data file.
Sharing Data Between Analyzers SDFTO63 Example 1 To find out what results are available in an SDF measurement results file from HP 3566A/67A swept sine measurement: SDFTO63 /I SINEARB.
Sharing Data Between Analyzers SDFTO63 Example 2 To convert the ‘’Normalized Variance’’ channel 2 (row 0 is channel 1, row 1 is channel 2) to HP 3563A format, perform the following steps: 1. Convert the file to Linear spaced data (SDFTOSDF). SDFTOSDF SINEARB.DAT SINELIN.DAT /P (convert to linear spacing) 2. Extract the result with SDFTO63. SDFTO63 SINELIN.DAT VAR2.63 /D:1 /R:1 (/R:1 is channel 2) 3. Copy the HP 3563A data file to a LIF formatted disk (to be read by HP 3563A): LIF CP VAR2.
Sharing Data Between Analyzers SDFTOASC SDFTOASC Convert an SDF data file to an ASCII data file and place the result in the destination file ( if it is entered). Otherwise view the result on the screen. Note All header information is lost when you convert to ASCII format.
Sharing Data Between Analyzers SDFTOASC /R: [-] [,C] Select data for the specified row range. The default is 0. If ‘’C’’ is specified, then the row data will be arranged as one row per column. /C: Select data for the specified column. The default is 0. /S: [-] [,C] Select data for the specified scan range. The default is 0 (1 scan). If ‘’C’’ is specified, then the scan data will be arranged as one scan per column. /L Orient the output data in lines instead of columns.
Sharing Data Between Analyzers SDFTOASC Example 4 Convert the complex data to dB, phase (instead of the default real, imaginary), and phase is in radians. SDFTOASC FRF.DAT FRF.TXT /T:D,P /Y:A Example 5 Convert a waterfall to a format which a spreadsheet can read in as 1 column per spectrum. SDFTOASC WFAL.DAT WFAL.TXT /S:0−1000,C If the ending scan that is selected is too large for the waterfall, then the ending scan is set to the last scan in the waterfall.
Sharing Data Between Analyzers SDFTOBIN SDFTOBIN Convert the source SDF file to the destination binary file. The binary data has the bytes swapped in the same direction as the rest of the DOS environment. Syntax SDFTOBIN [/U] [/O] [/I] [/A] [/X] [/T:,] [/Y:] [/M:] [/G:] [/D:] [/R:] [/C:] [/S[:[− ]]] [/F:] Options Input SDF file. Output binary file. /U Show this usage.
Sharing Data Between Analyzers SDFTOBIN /G:] Magnitude value used as a reference for dB type of coordinates. If /G with no parameter, then default is 20E−6 (dBSPL). /D:] Select data for the specified SDF_DATA_HDR (default is 0). /R:] Select data for the specified row (default is 0). /C:] Select data for the specified column (default is 0). /S[: [−]] Select data for the specified scan range (default is 0).
Sharing Data Between Analyzers SDFTOML SDFTOML Converts data from an SDF format file to the format used in the PC-MATLAB program. The created file or files have the suffix ‘’.MAT’’ if no destination file is specified. If the batch file naming convention is used or an output file is specified, then only one measurement result is translated. The batch file naming convention clears the suffix and adds a MAT suffix.
Sharing Data Between Analyzers SDFTOML /S: Extract data only for the specified data scans (default all scans). For example: /S:0 means scan 0 only, /S:0-4 means scans 0 through 4. /Y: Y units, one or more of the following: L=Linear, P=Power, D=Density, R=RMS See the batch files ‘’60_ML.BAT’’ and ‘’63_ML.BAT’’ in appendix C. Example Convert a spectrum SDF data file to PC-Mathlab file. (converting data to Vrms^2/Hz (PsD)) SDFTOML SPEC.
Sharing Data Between Analyzers SDFTOMX SDFTOMX Converts data from the SDF format to the format used in the MATRIXx program. The created file or files have the suffix ‘’.MAT’’ if no destination file is specified. If the batch file naming convention is used or an output file is specified, then only one measurement result is translated. The batch file naming convention clears the suffix and adds a MAT suffix.
Sharing Data Between Analyzers SDFTOMX /S: Extract data only for the specified data scans (default all scans). For example: /S:0 means scan 0 only, /S:0-4 means scans 0 through 4. /Y: Y units, one or more of the following: L=Linear, P=Power, D=Density, R=RMS See the batch files ‘’60_MX.BAT’’ and ‘’63_MX.BAT’’ in appendix C. Example Convert a spectrum SDF data file to a MATRIXx file (converting data to Vrms^2/Hz (PSD)). SDFTOMX SPEC.
Sharing Data Between Analyzers SDFTOMX Naming Conventions for Matrix Files If the destination file is not specified and the /B option is not specified, then the output filenames are derived from the measurement result names used in the analyzer. The extension .MAT is added. For example, frequency response data is saved to a file called FREQRESP.MAT. For data which includes more than one measurement result a separate file is used for each result. For example Histogram data is saved to HISTOGRA.MAT, PDF.
Sharing Data Between Analyzers SDFTOMX Naming Conventions for X-axis Variables If you choose the /X option the program does will create a variable of the form: x for each Y-axis variable. is the Y-axis variable name as described in the table above.
Sharing Data Between Analyzers SDFTOSDF SDFTOSDF Extracts a subset of results from an SDF file and creates another SDF file . The type of spacing and number of points for the results may be modified through resampling using polynomial or spline interpolation. (See chapter 2.
Sharing Data Between Analyzers SDFTOSDF /P: Interpolate to the specified number of linear spaced points. If the number of points is not specified, then the original number of points in the data result is maintained. This is useful if you want to do math or curve fit swept sine data, or examine results with a large number of lines of resolution on analyzer that is limited to fewer lines. /L: Interpolate to the specified number of log spaced points.
Sharing Data Between Analyzers SDFTOSDF Example 1 To find out what results are available in an SDF measurement results file from HP 3566A/67A (swept sine measurement): SDFTOSDF /I SINEARB.DAT This will produce a list on the display such as the following.
Sharing Data Between Analyzers SDFTOSDF Discussion The HP 3566A/67A generally puts all results from a measurement in a single file (see example above). If no options are selected that specify which data to convert, then all results are selected. This has the effect of copying everything in the source SDF file to the destination SDF file (and resampling all data results, if specified).
Sharing Data Between Analyzers SDFYDATA SDFYDATA Modify/print SDF file Y data. If [afile] or /Y option is specified then the Y data in the SDF file is modified, otherwise the data is printed. Syntax SDFYDATA [afile] [/U] [/I] [/D:] [/S:] [/R:] [/C:] [/O:[,]] [/L:[,]] [/Y:[,]] SDF file. [afile] Input ASCII file with numbers. /U Show this usage. /I Info only on (that is, measurement results available).
Sharing Data Between Analyzers SETUP63 SETUP63 Converts a binary setup state file from the HP 3563A (or HP 3562A) to an ASCII form (written to destination file). Refer to the HP 3563A or HP 3562A programming manual for descriptions of the individual fields in the setup state file. HP 3563A/62A setup state files on a LIF file system start with the letters ‘’SE.’’ Syntax SETUP63 [dfile] [/U] [/O] [/L:] [/E:] Options Input HP 3563A/62A setup state file name.
Sharing Data Between Analyzers SETUP63 Example After copying your HP 3563A/62A file from LIF to DOS using the LIF CP command (LIF CP A:SEFREQ FREQ), type: SETUP63 FREQ FREQ.ASC /E:0 FREQ.ASC will contain a list of setup parameters.
Sharing Data Between Analyzers SETUP88 SETUP88 Converts a binary setup state file from the HP 3588A to an ASCII form written to a destination file. Syntax SETUP88 [dfile] [/O] [/U] [/M ] [/L:] [/E:] Options Input HP 3588A setup state path and file name. [dfile] Optional destination path and file name. If no file is specified, it outputs to the display. /O Overwrite [dfile] if it already exists. /U Show help (usage information) for this program.
Sharing Data Between Analyzers SETUP88 Example Copy a setup state file from the HP 3588A LIF formatted disk and convert it to ASCII format: LIF CP B:STATE1 STATE1.88 SETUP88 STATE1.88 STATE1.ASC State1.ASC will contain a list of setup parameters. The following is an example list. Measurement_mode Swept Spectrum Low_distortion Off Oversweep On Peak_detector On Center_frequency 7.505e+007 Span 1.499e+008 Start_frequency 100000 Stop_frequency 1.5e+008 Manual_frequency 7.
Sharing Data Between Analyzers SETUP89 SETUP89 Converts a binary setup state file from the HP 3589A to an ASCII form written to a destination file. Syntax SETUP89 [dfile] [/O] [/U] [/M ] [/L:] [/E:] Options Input HP 3589A setup state path and file name. [dfile] Optional destination path and file name. If no file is specified, it outputs to the display. /O Overwrite [dfile] if it already exists. /U Show help (usage information) for this program.
Sharing Data Between Analyzers SETUP89 Example Copy a setup state file from the HP 3589A LIF formatted disk and convert it to ASCII format: LIF CP B:STATE1 STATE1.89 SETUP89 STATE1.89 STATE1.ASC State1.ASC will contain a list of setup parameters. The following is an example list. Measurement_mode Swept Spectrum Low_distortion Off Oversweep Off Peak_detector Off Center_frequency 7.505e+007 Span 1.499e+008 Start_frequency 100000 Stop_frequency 1.
Sharing Data Between Analyzers SOFTCOPY SOFTCOPY Transfers data from the HP-IB (IEEE-488 bus) to a file. Allows your PC to emulate a hardcopy device such as a plotter or printer, so screen dumps from various instruments can be captured. Hardcopy from HP-IB Instrument can be routed to an RS-232 printer or plotter by specifying PRN for the output file. Requires an HP 82335A interface card, or National Instrument GPIB-PC interface card.
Sharing Data Between Analyzers SYNTH63 SYNTH63 Converts a binary synthesis file from the HP 3563A or HP 3562A to an ASCII file, a PC-MATLAB file, or a MATRIXx file. HP 3563A/62A synthesis files on a LIF file system start with the letters ‘’ST’’ (Z-domain ‘’ZT’’); curve fit files start with the letters ‘’CV’’ (Z-domain ‘’ZF’’). Syntax SYNTH63 [/U] [/O] [/L] [/M] [/R] Options Input HP 3563A/62A synthesis file name. Output file name.
Sharing Data Between Analyzers SYNTH63 Discussion A synthesis table contains a maximum of 22 poles/zeros, poles/residues, or numerators/denominators (polynomial). It also contains the time delay, system gain, and either scale frequency (s-domain) or sample frequency and z power sign (z-domain). The first 4 lines of the ASCII file contain the time delay, system gain, scale or sample frequency, and z power sign, respectively.
Sharing Data Between Analyzers X32TOBIN X32TOBIN Convert data from Intel Hex-32 source data file and put the results in the destination binary file. Syntax X32TOBIN [/U] [/O] Options Input Hex-32 data file. Output binary file. /U Show help (usage information) for this program. /O Overwrite if it exists. Example Convert an Intel Hex-32 file (FREQ.X32) to a binary data file (FREQ.BIN). X32TOBIN FREQ.X32 FREQ.
Sharing Data Between Analyzers Error Messages Error Messages Cannot open output file This error is generated if the output file cannot be opened with write permissions. Check for a valid path/file name. Also, check to see if the file is write protected. Cannot open input file This error is generated if the input file cannot be opened with read permissions. Check for a valid path/file name. Also, check to see if the file is read protected.
5 Viewdata Introduction The Viewdata utility allows you to display data graphically on your PC. You can display up to three traces of data from the same or different analyzers. For example, you can display a frequency response from an HP 3563A on trace A, a frequency response from an HP 35665A on trace B, and an FRF from an HP 3566A/3567A on trace C. You can also display a waterfall (or map) of results from an HP 35665A or HP 3566A/3567A.
Viewdata Note No file conversions are necessary for SDF or ASCII data. HP 3562A/3563A data must be converted from LIF to DOS format (see chapter 3), but need not be converted to SDF. If you set the file type to ‘’Auto,’’ Viewdata will read data in any of these formats. For data from any other supported analyzers, you must first convert the data to SDF format, then read it into Viewdata. The utility includes marker, scale, zoom, and scroll functions. You can also plot or print the display.
Viewdata The menu line for Viewdata contains a menu name followed by a set of command words on the top line on the display. Each command has one letter in red on a color display (bright white on monochrome display) indicating the hot key for that command. The currently selected command is in inverse video (on color display, entire word in bright white on monochrome display). There are two ways to execute a command: • Press the hot key.
Viewdata When you change to the Output menu, the screen displays information on the output setup. Figure 5-4.
Viewdata VIEWDATA Syntax VIEWDATA [/D:] [/S:] [/R:] [] [] [] [/U] [/T:] [/K:<keyfile>] [/E:<echofile>] [/P] [/P:<plotfile>] [/I:<inifile>] [/A:<ascfile>] [/O:<ovlfile>] [/W:<widecnt>] [/H:<highcnt>] [/N:<pltnum>] [/M:<time>] /D:<data> Specify data result in file (default is result 0 if /P) /R:<row> Specify row in file (default is row 0 if /P) /S:<scans> Specify scan in file (default is scan 0 if /P).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-124.html>PAGE 124</a></h6><p>Viewdata /H:<highcnt> The number of plots per page high. /N:<pltnum> Which plot this is (relative to /W and /H). If not set when /W or /H used, then the plot number is automatically incremented & stored in ‘VIEWDATA.INX’ for the next plot. /M:<time> Display trace, wait <time> seconds, and exit program.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-125.html>PAGE 125</a></h6><p>Viewdata VIEWDATA menu Viewdata: File Display Output Save Help Quit Hot Keys: F D O S H Q File Set the file type and read data from a file. Display Set up the display parameters (format, coordinates, scaling). Output Set the output device (plotter/printer) characteristics. Save Save the program configuration to a file. Help Display help information. Quit Quit the Viewdata program.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-126.html>PAGE 126</a></h6><p>Viewdata File menu (if Type is Auto or HP 3563A/3562A) File: Hot Keys: Type Read Help Quit T R H Q Type Set the type of file (ASCII, SDF, or 3563/2 data file). Read Read a data file. It may contain any data. Neither Capture nor Throughput files may be read directly (use DFDATA63 to extract data from these files). Help Display help information. Quit Quit the File menu and return to the Viewdata main menu. Note 5-8 If Type is Auto and the name specified has a suffix of ‘’.BIN’’ or ‘’.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-127.html>PAGE 127</a></h6><p>Viewdata File menu (if Type is SDF) File: Hot Keys: Type Read Header Help Quit T R D H Q Type Set the type of file (ASCII, SDF, or HP 3563A/3562A data file). Read Read an SDF binary data file. ASCII SDF data files are not supported. An SDF file may contain multiple results of data where each result may have multiple rows, columns, or scans of data.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-128.html>PAGE 128</a></h6><p>Viewdata File menu (if Type is ASCII) File: Hot Keys: Type Read Points Offset Xvalues Scans Help Quit T R P O X S H Q Type Set the type of file (ASCII, SDF, or 3563/2 data file). Read Read an ASCII file containing numbers. Numbers must be delimited by comma or Viewdata will not read the imaginary data . (Use option “/B ,” for SDFTOASC when reading ASCII data into Viewdata.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-129.html>PAGE 129</a></h6><p>Viewdata Display menu Display: Hot Keys: ShowTrace Active Format Trace Coords Xscale Yscale Data Help Quit S C H Q A F T X Y D ShowTrace Display the data (with X marker). Active Specify A, B, or C as the active trace. The marker and zoom commands in the ShowTrace menu affect only the active trace. For multi-scan data, you can also specify which scan you want displayed in the trace. Format Specify that you want to display one, two, or three traces, or a waterfall on the screen.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-130.html>PAGE 130</a></h6><p>Viewdata Active menu File: A B C A&B A/B/C Scan Help Hot Keys: A B C & / H S A Make trace A active. B Make trace B active. C Make trace C active. A&B Set the active Trace to the A & B traces. Any changes to the display attributes of the A trace are also changed for the B trace. In this mode, markers are moved on the A trace. A/B/C Set the active Trace to the A & B & C traces. Any changes to the display attributes of the A trace are also changed for the B & C traces.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-131.html>PAGE 131</a></h6><p>Viewdata Format menu File: Hot Keys: Auto Single Upper/Lowe Up/Mid/Low Front/Back Overlay Waterfall A_vs_B Help r A U S M F O W V H Auto Determine the format from the data in the traces. If only one trace has data and it is the active trace, the format is single for single-scan data or waterfall for multi-scan data. If two traces have data, the format is upper/lower. If all three traces have data, the format is up/mid/low. Single Display one trace (the active trace).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-132.html>PAGE 132</a></h6><p>Viewdata Trace menu Trace: Hot Keys: Data Grid TitleType UserTitle Help Quit D G T U H Q Data Set the data drawing to Auto, Points, Lines, Bars. Grid Sets the type of grid for the trace to None, Ticks, Dots, Lines, or Blank. If grids are turned on (Ticks, Dots, or Lines), then the type of grid that is drawn depends upon the coordinates. For LogMag, log spaced major & minor divisions are drawn. For Nyquist, the unit circle is drawn and horizontal/vertical lines crossing the origin.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-133.html>PAGE 133</a></h6><p>Viewdata TitleType menu Title Type: Hot Keys: Auto Auto User Meas ResBW Date Point A U M R D P Use the other options from this menu in the following order: 1. 2. 3. 4. If a user title has been defined, use it. If there is a measurement title with the data, use it. If the resolution bandwidth for the data is defined, use it. If none of these are available, use no title. User Use the title specified under ‘’UserTitle.’’ Meas Use the SDF measurement title.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-134.html>PAGE 134</a></h6><p>Viewdata TraceData menu TraceData: Hot Keys: Auto Points Lines Bars A B P L Auto Auto sets the type of drawing based upon the data. If the data is Octave data, the drawing is set to Bars. For other data the drawing is set to Lines. Points Points draws points only at the actual data points. Lines Lines draws connecting lines between data points. Bars Bars draws horizontal/vertical lines connecting data points (appears as bars).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-135.html>PAGE 135</a></h6><p>Viewdata Grid menu Grid: Hot Keys: None Ticks Dots Lines Blank N L B T D None Do not display a grid. Ticks Ticks only draws short marks at the edge of the grid (and no unit circle). Dots Dots draws dotted lines across the grid. (When you plot the display dotted lines will plot as solid lines.) Lines Lines draws solid lines across the grid. Blank Turns off the square around the trace display and the active trace letter (e.g. ‘A’ in upper left corner).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-136.html>PAGE 136</a></h6><p>Viewdata Coordinates menu Coordinates: Hot Keys: Auto Real Imag Mag Log dB dBm Inten Phs UnwrpPhs Nyquist Nichol Help A R I M L D B T P U Y N H Auto Set the coordinate based upon the data. If the data type is intensity, then Intensity is chosen. If the data is frequency domain (X-axis units of Hz, RPM, or Orders), then dB is chosen. If the data is orbit data, then Nyquist is chosen. If the data is complex, then Mag is chosen. Otherwise, Real is chosen. Real Show the real part of the data.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-137.html>PAGE 137</a></h6><p>Viewdata Xscale menu Xscale: Hot Keys: Type Left Right Spacing Help Quit T L R S H Q Type Set auto or fixed scale for the X-axis. Left Specify an X limit for the left side of the screen (only if the scale type is fixed). Right Specify an X limit for the right side of the screen (only if the scale type is fixed). Spacing Set auto, linear, or logarithmic X-axis spacing. Help Display help information. Quit Quit the Xscale menu and return to the Display menu.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-138.html>PAGE 138</a></h6><p>Viewdata Xscale Spacing menu Xscale: Hot Keys: Auto Linear Log A L G Auto Set X-axis spacing to be the same as the resolution of the data. If the data resolution is arbitrary, then linear X-axis is used. Linear Use a linear X-axis. Log Use a logarithmic X-axis.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-139.html>PAGE 139</a></h6><p>Viewdata Xscale Type menu Xscale: Hot Keys: Auto Fixed A F Auto Show all of the data. Whenever new data is read, the X scale is set to auto. Fixed Show only the data between the specified Left and Right X values.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-140.html>PAGE 140</a></h6><p>Viewdata Yscale menu Yscale: Hot Keys: Type Top Bottom Units WfallHeight Help Quit T P B U W H Q Type Set auto or fixed Y-axis scaling for the displayed data. Top Specify a Y-axis limit for the top part of the screen. Bottom Specify a Y-axis limit for the bottom part of the screen. Units Specify the Y-axis units for frequency domain data. WfallHeight Specify how much the traces in the waterfall display should overlap (in percent of total trace height).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-141.html>PAGE 141</a></h6><p>Viewdata Yscale Type menu Yscale: Hot Keys: Auto Fixed A F Auto Show all of the data. Whenever new data is read, the Y-axis scale is set to auto. Fixed Show only the data between the specified Top and Bottom Y-axis values.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-142.html>PAGE 142</a></h6><p>Viewdata Units menu Units: Hot Keys: Peak/RMS Power Density dBmType dBmReference UserReference Quit P T W D R U Q Peak/RMS Specify whether the data will be displayed in peak or rms units. If you choose Auto, the units will be the same as the data. SDF files are always peak. HP 3563A/62A data may be peak or rms. Power Specify the power of the Y-axis units (volts or volts^2). If you choose Auto, the displayed unit power is the same as the data unit power.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-143.html>PAGE 143</a></h6><p>Viewdata Data menu Data: Hot Keys: CopyTo Remove Help Quit C R H Q CopyTo Copy the active trace to either of the 2 other traces. All trace display attributes associated with the trace are copied to the destination trace with the data. Any data that was previously in the destination trace is removed. Remove Remove all data associated with the specified trace. It does not affect any display attributes associated with the specified trace. Help Display help information.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-144.html>PAGE 144</a></h6><p>Viewdata ShowTrace menu Display: Hot Keys: Display: Hot Keys: Xpos Peak Min X P M Mkr Zoom ∑ ∑ Home <pgup move pgdn> End + Menu – Ins Mkr Del Output Quit Home PgUp + Ins O PgDn End – Del Q A Make trace A active. B Make trace B active. C Make trace C active. S Specify the active scan. Xpos Enter a new X-axis value for the marker. The marker moves to that value in the active trace. Peak Move the marker to the largest Y-axis value in the trace.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-145.html>PAGE 145</a></h6><p>Viewdata Home Move to beginning of the data when the display is zoomed. PgUp Scroll half a screen towards beginning of the data when the display is zoomed. PgDn Scroll half a screen towards end of the data when the display is zoomed. End Move to end of the data when the display is zoomed. + Turn the menu on. - Turn the menu off. This command is useful if you want to print the screen (using the DOS Print Screen function) without extraneous information. Ins Turn the marker on.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-146.html>PAGE 146</a></h6><p>Viewdata User Entered Graphics With the ‘G’ command in the trace display mode, graphic lines and graphic (vector) text may be overlayed anywhere upon the trace display. This allows the user to point to some region of interest (using a simple line with an arrow) and entering text of any size and orientation (45 degree increments). In addition, any HP-GL file may be imported and displayed anywhere on the trace display.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-147.html>PAGE 147</a></h6><p>Viewdata R Mouse Button Same as ‘Del’, I Import text/graphics from a file. The information is scaled to fit between the marker & reference marker, T Enter text at marker position, A Set angle of entered text (multiples of 45 deg), S Set size (height/width) of entered text (where 1.0 is normal size), Home Top of page, End Bottom of page, F2 Delete all graphics, Esc Quit graphics mode and return to the ShowTrace menu.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-148.html>PAGE 148</a></h6><p>Viewdata User Entered Text With the ‘T’ command in the trace display mode, text may be overlayed anywhere upon the trace display. This allows the user to enter information anywhere within the text grid area, and also the ability to overwrite any existing annotation. You can overwrite existing annotation by moving the cursor to the annotation (using the arrow keys or the mouse) and typing text over the annotation or erase the annotation by typing spaces.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-149.html>PAGE 149</a></h6><p>Viewdata Output menu Output: Hot Keys: Type Device Baud Paging Speed SolidLine Rotate s Pens P1,P2 Help Quit T G S L P 1 H D B R Q When the trace is displayed, pressing the ‘’O’’ key will output the screen to the selected printer or plotter. This menu selects the parameters controlling output to the plot/print device. Type Set the type of output device (printer, plotter, or PrintScreen printer).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-150.html>PAGE 150</a></h6><p>Viewdata Rotate Specify whether the plot or print output will be rotated 90 degrees. On a plotter, this uses the ‘’RO’’ command. This setting does not affect the DOS PrintScreen function. Pens Set the plotter pen number to be used in plotting the following information: Grid Data trace Marker All other Annotation. A pen number of zero will cause the selected field to be NOT plotted. P1,P2 Set the P1,P2 plotter limits. The actual numbers entered are P1x,P1y,P2x,P2y.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-151.html>PAGE 151</a></h6><p>Viewdata Save menu Save: Hot Keys: Config Config Quit C Q Save the current configuration to the file ‘’VIEWDATA.INI’’ in the same directory as ‘’VIEWDATA.EXE’’. If you want to make a permanent copy of a configuration file, use the DOS copy command to copy VIEWDATA.INI to another file name. Then when you start Viewdata, you can specify that file name with the /I: option. For example, copy VIEWDATA.INI to FRF.INI. Then start Viewdata by typing: VIEWDATA /I:FRF.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-152.html>PAGE 152</a></h6><p></p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-153.html>PAGE 153</a></h6><p>6 Using SDF Data with C Programs SDF Library Functions This chapter provides information on the SDF library functions. These functions are located in \SDFLIB\SDFUTIL.LIB. The SDF library functions are written on a much higher level to help you more easily get at the data that you need. When using these functions, include these include files (located in \SDFLIB) in your C programs: • • • SDF_COMM.H SDF_BASI.H SDF_UTIL.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-154.html>PAGE 154</a></h6><p>Using SDF Data with C Programs The Standard Data Format All measurement data stored by the HP 3566A, HP 3567A, HP 35665A, HP 35670A, HP 89410A, and HP 89440A is in a file format called Standard Data Format (SDF). Data saved in Standard Data Format is the pure measurement data, with no engineering units or window corrections applied to it. It is stored in binary, along with accompanying header information, and represents the highest resolution data available from the analyzer.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-155.html>PAGE 155</a></h6><p>Using SDF Data with C Programs SdfOpen SdfOpen Syntax short SdfOpen (char far *filename); Returns an integer(short) between 0 and 5 containing a file number. A return of 0 indicates an error; 1 to 5 indicates a valid file. This function attempts to open an SDF file with the indicated file name. If the file is found, the format type of the file is read. If it is a binary SDF file, the file number is recorded in the current list of open SDF files and returned.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-156.html>PAGE 156</a></h6><p>Using SDF Data with C Programs SdfClose SdfClose Syntax int SdfClose (short fn); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function closes an open file with the indicated file number and decrements the current list of open SDF files.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-157.html>PAGE 157</a></h6><p>Using SDF Data with C Programs SdfFileHdr SdfFileHdr Syntax int SdfFileHdr (short fn, struct SDF_FILE_HDR far *fileHdr); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads the file-header information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen). The information is put in the SDF_FILE_HDR structure, where fileHdr is the pointer to the structure.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-158.html>PAGE 158</a></h6><p>Using SDF Data with C Programs SdfMeasHdr SdfMeasHdr Syntax int SdfMeasHdr (short fn, struct SDF_MEAS_HDR far *measHdr ); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads the measurement-header information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen). The information is put in the SDF_MEAS_HDR structure, where measHdr is the pointer to the structure.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-159.html>PAGE 159</a></h6><p>Using SDF Data with C Programs SdfDataHdr SdfDataHdr Syntax int SdfDataHdr (short fn, short dataNo , struct SDF_DATA_HDR far *dataHdr); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads the data-header information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen). The information is put in the SDF_DATA_HDR structure, where dataHdr is the pointer to the structure.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-160.html>PAGE 160</a></h6><p>Using SDF Data with C Programs SdfVectHdr SdfVectHdr Syntax int SdfVectHdr (short fn, short dataNo, short rowNo, short colNo, struct SDF_VECTOR_HDR far *vectHdr); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads the vector-header information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-161.html>PAGE 161</a></h6><p>Using SDF Data with C Programs SdfChanHdr SdfChanHdr Syntax int SdfChanHdr (short fn, short chanNo, struct SDF_CHANNEL_HDR far *chanHdr); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads the channel-header information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen). The information is put in the SDF_CHANNEL_HDR structure, where chanHdr is the pointer to the structure.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-162.html>PAGE 162</a></h6><p>Using SDF Data with C Programs SdfScanStruct SdfScanStruct Syntax int SdfScanStruct (short fn, struct SDF_SCAN_STRUCT far *scanStruct); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads scan information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen). The information is put in the SDF_SCAN_STRUCT structure, where scanStruct is the pointer to the structure.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-163.html>PAGE 163</a></h6><p>Using SDF Data with C Programs SdfScanBig SdfScanBig Syntax int SdfScanBig (short fn, struct SDF_SCAN_BIG far *scanBig); Returns an integer (short) of greater than zero, zero, or minus one. A return of greater than zero indicates that an SDF_SCAN_BIG header was found (returns SDF_SCAN_BIG_TYPE) or one was created from an SDF_SCAN_STRUCT (returns SDF_SCAN_STRUCT_TYPE). A return of 0 indicates that no scan header of any type was found. A return of −1 indicates an error.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-164.html>PAGE 164</a></h6><p>Using SDF Data with C Programs SdfScanVar SdfScanVar Syntax int SdfScanVar (short fn, short varInx, struct SDF_SCAN_VAR far *scanVar); Returns an integer (short) of zero or minus one. A return of 0 indicates no error; a return of −1 indicates an error. This function reads the scan variable information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen). The information is put in the SDF_SCAN_VAR structure, where scanVar is the pointer to the structure.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-165.html>PAGE 165</a></h6><p>Using SDF Data with C Programs SdfScansUsed SdfScansUsed Syntax long SdfScansUsed (short fn); Returns A long integer of greater than or equal to minus one. The return value is the number of scans in the SDF file. A return of 0 indicates no scan data; a return of −1 indicates an error. This function returns the number of scans in an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-166.html>PAGE 166</a></h6><p>Using SDF Data with C Programs SdfYdata SdfYdata Syntax int SdfYdata (short fn, long offset, short dataNo, short rowNo, short colNo, long scanNo, long pnts, short dataType, float far *y); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads Y-axis data from an open SDF file and puts it in an array, where y is the pointer to the array, and fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-167.html>PAGE 167</a></h6><p>Using SDF Data with C Programs SdfYdata The dataType is the size of the data block (the format of the data in memory), as shown in the following table.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-168.html>PAGE 168</a></h6><p>Using SDF Data with C Programs SdfYdataWrite SdfYdataWrite Syntax int SdfYdataWrite (short fn, long offset, short dataNo, short rowNo, short colNo, long scanNo, long pnts, short dataType, float far *y); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function writesY-axis data from an array and puts it in an open SDF file , where y is the pointer to the array, and fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-169.html>PAGE 169</a></h6><p>Using SDF Data with C Programs SdfXdata SdfXdata Syntax int SdfXdata (short fn, long offset, short dataNo, short rowNo, short colNo, long pnts, short dataType, float far *x); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads X-axis data from an open SDF file and puts it in an array, where x is the pointer to the array, and fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-170.html>PAGE 170</a></h6><p>Using SDF Data with C Programs SdfScanData SdfScanData Syntax int SdfScanData (short fn, long offset, short varInx, long pnts, short dataType, float far *s); Returns an integer(short) of zero or minus one. A return of 0 indicates no error; a return of -1 indicates an error. This function reads scan data from an open SDF file and puts it in an array, where s is the pointer to the array, and fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-171.html>PAGE 171</a></h6><p>Using SDF Data with C Programs SdfTrunc SdfTrunc Syntax long SdfTrunc (short fn); Returns a long integer or minus one (-1 indicates an error). This function returns a long integer. This integer is the accumulated number of times that data was truncated by any of these functions: • • • • SdfYdata() SdfYdataWrite() SdfXdata() SdfScanData() Separate truncation counts are kept for each open file.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-172.html>PAGE 172</a></h6><p>Using SDF Data with C Programs SdfCommentHdr SdfCommentHdr Syntax int SdfCommentHdr (short fn, short commNo, struct SDF_COMMENT_HDR far *commHdr); Returns an integer (short) of zero or minus one. A return of 0 indicates no error; a return of −1 indicates an error. This function read the comment-header information from an open SDF file, where fn is the number of the open SDF file (for details, see SdfOpen).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-173.html>PAGE 173</a></h6><p>Using SDF Data with C Programs SdfCommentRead SdfCommentRead Syntax long SdfCommentRead (short fn, short commNo, long offset, long size, char far *buf); Returns a long integer of greater than or equal to minus one. The return value is the number of characters of comment actually read; a return of −1 indicates an error.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-174.html>PAGE 174</a></h6><p>Using SDF Data with C Programs SdfCommentWrite SdfCommentWrite Syntax long SdfCommentWrite (short fn, short commNo, long offset, long size, char far *buf); Returns a long integer of greater than or equal to minus one. The return value is the number of characters of comment actually written; a return of −1 indicates an error.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-175.html>PAGE 175</a></h6><p>7 MATLAB MEX-Files & M-Files Overview MATLAB lets you call user programs (MEX-files) from MATLAB as if they were built-in MATLAB functions. MEX-files are usable only on PC-MATLAB or AT-MATLAB. They do not work on 386-MATLAB. Note MATLAB, PC-MATLAB, and AT-MATLAB are trademarks of The MathWorks, Inc. M-files are command scripts. MATLAB executes the commands found in M-files, instead of getting input from the keyboard. This section describes the MEX-files and M-files for MATLAB that operate on SDF data.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-176.html>PAGE 176</a></h6><p>MATLAB MEX-Files & M-Files filtrsdf.mex filtrsdf.mex Syntax filtersdf (b, a, name, dataNo, rowNo, colNo) Returns not applicable This MATLAB subroutine digitally filters SDF data (time capture data). Caution This MEX-file will modify your SDF file. You may want to make a back up copy of the SDF file before using this subroutine.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-177.html>PAGE 177</a></h6><p>MATLAB MEX-Files & M-Files matdemo.tim matdemo.tim This file contains data that can be used by the tcdemo.m M-file. The data represents a 4 channel, 12,800 Hertz , baseband, time capture with broadband noise on all 4 channels.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-178.html>PAGE 178</a></h6><p>MATLAB MEX-Files & M-Files tcdemo.m tcdemo.m This M-file is a demonstration. It shows you how to digitally filter HP3566A/67A time-capture data using the MATLAB Signal Processing Toolbox. This demonstration assumes that matdemo.tim exists in \analyzer\tc, and that it is • • Note 7-4 A 4 channel time-capture file, with a span of 12,800 Hertz. This demonstration overwrites the data in matdemo.tim with refiltered data. Therefore, make a backup copy of matdemo.tim if you want to preserve its contents.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-179.html>PAGE 179</a></h6><p>MATLAB MEX-Files & M-Files tcdemo2.m tcdemo2.m This M-file is a demonstration. It shows you how to compare the FRF measurement results of the digitally filtered, HP3566/67A time-capture data and the orginal filter shapes generated by the PC-MATLAB Signal Processing Toolbox. This demonstration requires these files: • • \analyzer\data\matfrf.dat \analyzer\utils\sdftoml.exe The file sdftoml.exe is provided with the SDF utilities; the file matfrf.dat is not. You must create matfrf.dat on your HP3566/67A.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-180.html>PAGE 180</a></h6><p></p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-181.html>PAGE 181</a></h6><p>8 Mathcad® Examples Mathcad is a registered trademark of MathSoft, Inc., 201 Broadway, Cambridge MA 02139. Overview The Mathcad examples described in this chapter are in the mathcad directory. From within Mathcad, you can read and/or print the files in that directory for more detailed information about these examples. The mathcad directory contains several example Mathcad 4.0 files that demonstrate how to create waveforms and filters for use with the HP89410A and HP89440A (including option AYA).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-182.html>PAGE 182</a></h6><p>Mathcad® Examples mathcad\signals\qpsk.mcd This file contains an example of how to create a pulsed QPSK waveform for use with the HP894x0A arbitrary source. The waveform is filtered using a root-raised cosine ISI filter. mathcad\filters\gauss.mcd This file contains an example of how to create a custom gaussian filter for use with the AYA (Digital demodulation) option for the HP894x0A Vector Signal Analyzer. mathcad\filters\raiscos.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-183.html>PAGE 183</a></h6><p>A SDF to PC-MATLAB and MATRIXx examples Introduction The following examples demonstrate: • How to move an HP 3563A (or HP 3562A) file to MATRIXx or PC-MATLAB file format. • How to load a converted file into MATRIXx. • How to load a converted file into PC-MATLAB.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-184.html>PAGE 184</a></h6><p>SDF to PC-MATLAB and MATRIXx examples HP 3563A to MATRIXx or PC-MATLAB file formats HP 3563A to MATRIXx or PC-MATLAB file formats 1. Save measurement setup and data from the HP 3563A to a LIF disk. 2. Insert the disk into a drive attached to your PC. Use the command LIF SCAN to identify disk (simply type LIF SCAN from the directory which contains your LIF utilities).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-185.html>PAGE 185</a></h6><p>SDF to PC-MATLAB and MATRIXx examples HP 3563A to MATRIXx or PC-MATLAB file formats Loading a File into PC-MATLAB 1. To load FREQRESP.MAT, start the PC-MATLAB program and type: load a:FREQRESP.MAT 2. To get a list of the variables that were loaded, type: who To get a list of the variables including size and whether it is complex, type: whos To see the X-axis values of data converted with the x option, type: o2i1x To see the Y-axis values, type: o2i1 3.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-186.html>PAGE 186</a></h6><p>SDF to PC-MATLAB and MATRIXx examples HP 3563A to MATRIXx or PC-MATLAB file formats Loading a File into MATRIXx 1. To load FREQRESP.MAT, start MATRIXx and type: load (‘FREQRESP.MAT’) 2. To see X-axis values, type: o2i1x To see Y-axis values, type: o2i1 3. To plot x and y values on the screen (real data), type: plot(o2i1x, o2i1) To plot x and y values on the screen (imaginary data), type: plot(o2i1x,imag(o2i1)) To display dB on Y-axis: plot(o2i1x,10*.434294482*log(o2i1.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-187.html>PAGE 187</a></h6><p>B Standard Data Format (SDF) This appendix describes the organization of files that use the Standard Data Format (SDF). SDF files contain both measurement data and the settings of important instrument parameters when the data was taken. For more information on SDF data see chapter 2 and chapter 6.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-188.html>PAGE 188</a></h6><p>Standard Data Format (SDF) Records—the Basic SDF Units An SDF file consists of a number of smaller units called records: one “master,” called the File Header, followed by a variable number of additional records. A record contains a group of related parameters and data. For example, a record called the Channel Header contains all channel-specific information for one of the channels used in a measurement. There are eleven common records defined for SDF files: File Header: Provides an index to the file.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-189.html>PAGE 189</a></h6><p>Standard Data Format (SDF) Record Order Each measurement file begins with two ASCII characters followed by the File Header. Fields in the File Header tell you how many additional records follow and their order in the file. The order of records is always the same (although some files may not contain all record types). Figure B-5.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-190.html>PAGE 190</a></h6><p>Standard Data Format (SDF) Figure B-6.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-191.html>PAGE 191</a></h6><p>Standard Data Format (SDF) The two ASCII characters at the beginning of the file identify it as an SDF file. The first character is B, the second is \0 (null). Special Fields in a Record All records contain two special fields: recordType: A number that uniquely identifies the type of data contained in the record. recordSize: A number that specifies the length of the record (in bytes). The following table shows you the recordType and recordSize values for the eight common records: Table B-1.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-192.html>PAGE 192</a></h6><p>Standard Data Format (SDF) Record and Structure Descriptions The following tables describes the individual records and structures from which the SDF files are built. Each table includes: • • • • • A field index. A binary index. A description of each field. A description of the data type used in each field. The range of values for data in the field. The fields in SDF records and structures use the following data types: Char[n]: This data type consists of a series of ASCII-encoded bytes.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-193.html>PAGE 193</a></h6><p>Standard Data Format (SDF) Figure B-7. IEEE Data Type Definition Figure B-8.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-194.html>PAGE 194</a></h6><p>Standard Data Format (SDF) Table B-2. SDF_FILE_HDR (File Header record) Field Binary Index Index* Data Type Range/ Units 1 1:2 recordType short 10 2 3:6 recordSize long 80 bytes 3 7:8 revisionNum — measurement file version number. short 0:32767 short −99:32767 4 B-8 Field Name/Description 9:10 applic — file saved from this instrument or application.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-195.html>PAGE 195</a></h6><p>Standard Data Format (SDF) Table B-2. SDF_FILE_HDR (File Header record), continued Field Binary Index Index* Field Name/Description Data Type Range/ Units 10 27:28 num_of_VECTOR_record — total Vector Header records. short 0:32767 11 29:30 num_of_CHANNEL_record — total Channel Header records. short 0:32767 12 31:32 num_of_UNIQUE_record — total Unique records. short 0:32767 13 33:34 num_of_SCAN_STRUCT_record — total Scan Structure records.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-196.html>PAGE 196</a></h6><p>Standard Data Format (SDF) * Bytes B-10 i.d.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-197.html>PAGE 197</a></h6><p>Standard Data Format (SDF) Table B-3a. SDF_MEAS_HDR (Measurement Header record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 11 2 3:6 recordSize long 156 bytes 3 7:10 unique_record — byte offset from the beginning of the file long to a record containing an instrument-specific measurement header. This field may be ignored when the file is recalled if it is recalled into an instrument type other than that used to create it.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-198.html>PAGE 198</a></h6><p>Standard Data Format (SDF) Table B-3b. SDF_MEAS_HDR (Measurement Header record) Field Binary Index Index* Data Type Range/ Units 15 103:110 centerFreq — center frequency double unit is Hz range is i.d. 16 111:118 spanFreq — frequency span double unit is Hz range is i.d. 17 119:126 sweepFreq — current frequency for a swept measurement double unit is Hz range is i.d.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-199.html>PAGE 199</a></h6><p>Standard Data Format (SDF) Table B-4a. SDF_DATA_HDR (Data Header record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 12 2 3:6 recordSize long 148 bytes long −1:(231)-1 3 7:10 unique_record — byte offset from the beginning of the file to a record containing an instrument-specific data header. May be ignored if recalled into a different type instrument. 4 11:26 dataTitle — instrument- or user-supplied name for data type. char[16] i.d.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-200.html>PAGE 200</a></h6><p>Standard Data Format (SDF) * Bytes i.d. = instrument-dependent Table B-4b. SDF_DATA_HDR (Data Header record) Field Binary Index Index* 6 (cont.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-201.html>PAGE 201</a></h6><p>Standard Data Format (SDF) Table B-4c. SDF_DATA_HDR (Data Header record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 11 43:44 xResolution_type — tells you how to find x-axis values for this short Data Header record’s traces.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-202.html>PAGE 202</a></h6><p>Standard Data Format (SDF) Table B-4d.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-203.html>PAGE 203</a></h6><p>Standard Data Format (SDF) 34 147:148 multiPassDecimations — > 0 = the number of decimations included in the multi-pass data. *Bytes short 0:32767 i.d. = instrument-dependent Table B-5. SDF_VECTOR_HDR (Vector Header record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 13 2 3:6 recordSize long 18 bytes 3 7:10 unique_record — byte offset from the beginning of the file to a record containing an instrument-specific vector header.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-204.html>PAGE 204</a></h6><p>Standard Data Format (SDF) Table B-6a. SDF_CHANNEL_HDR (Channel Header record) Field Binary Index Index* Data Type Field Name/Description Range/ Units 1 1:2 recordType short 14 2 3:6 recordSize long 212 bytes long −1:(231)-1 3 7:10 unique_record — byte offset from the beginning of the file to a record containing an instrument-specific vector header. May be ignored if recalled into a different type instrument. 4 11:40 channelLabel — channel documentation char[30] i.d.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-205.html>PAGE 205</a></h6><p>Standard Data Format (SDF) B-19</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-206.html>PAGE 206</a></h6><p>Standard Data Format (SDF) Table B-6b. SDF_CHANNEL_HDR (Channel Header record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 17 143:146 inputImpedance — Input impedance float unit ohm, range i.d.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-207.html>PAGE 207</a></h6><p>Standard Data Format (SDF) Table B-7. SDF_SCAN_STRUCT (Scan Structure record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 15 2 3:6 recordSize long variable 3 7:8 num_of_scan — number of times the instrument collected a complete set of x- and y-axis vectors for all scan-based data types.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-208.html>PAGE 208</a></h6><p>Standard Data Format (SDF) Table B-8. SDF_SCANS_BIG (Scan big record) Field Binary Index Index* Data Type Range/ Units 1 1:2 recordType short 18 2 3:6 recordSize long 20 long −1:(231)-1 4 11:14 num_of_scan — number of times the instrument collected a long complete set of x- and y-axis vectors for all scan-based data types. −1:(231)-1 5 15:18 last_scan_index — index of the last valid scan.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-209.html>PAGE 209</a></h6><p>Standard Data Format (SDF) Table B-9. SDF_SCAN_VAR (Scan variable record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 19 2 3:6 recordSize long variable long −1:(231)-1 3 7:10 unique_record — byte offset from the beginning of the file to a record containing an instrument-specific scan variable header. May be ignored if recalled into a different type instrument.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-210.html>PAGE 210</a></h6><p>Standard Data Format (SDF) Table B-10. SDF_COMMENT_HDR (Comment record) Field Binary Index Index* Field Name/Description Range/ Units 1 1:2 recordType short 20 2 3:6 recordSize long variable long −1:(231)-1 3 7:10 unique_record — byte offset from the beginning of the file to a record containing an instrument-specific comment header. May be ignored if recalled into a different type instrument. 4 11:14 headersize — size of the header portion of this record (excluding long the comment text).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-211.html>PAGE 211</a></h6><p>Standard Data Format (SDF) Table B-11. SDF_XDATA_HDR (X-axis Data record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 16 2 3:6 recordSize long Variable X data values start here. *Bytes Table B-12. SDF_YDATA_HDR (Y-axis Data record) Field Binary Index Index* Field Name/Description Data Type Range/ Units 1 1:2 recordType short 17 2 3:6 recordSize long Variable Y data values start here. *Bytes Table B-13.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-212.html>PAGE 212</a></h6><p>Standard Data Format (SDF) Table B-14.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-213.html>PAGE 213</a></h6><p>Standard Data Format (SDF) Reconstructing a Trace The simplest SDF file defines a single trace. A trace consists of a series of discrete points, each defined by an X-axis value and a Y-axis value. This section tells you how to locate or calculate a single trace’s X-axis and Y-axis values. X-axis Values A trace’s X-axis values are stored in one of two SDF records: the Data Header record, or the X-axis Data record.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-214.html>PAGE 214</a></h6><p>Standard Data Format (SDF) You can calculate X-axis values this way when xResolution_type is 1 (logarithmic resolution): x0 = abscissa_firstX x1 = x0 * abscissa_deltaX 2 x2 = x0 * abscissa_deltaX 3 x3 = x0 * abscissa_deltaX . . . n xn = x0 * abscissa_deltaX (where n = num_of_points −1) When consecutive trace points are not evenly spaced along the X-axis (xResolution_type = 2, 3, or 4), the SDF file includes an X-axis Data record.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-215.html>PAGE 215</a></h6><p>Standard Data Format (SDF) Y-axis Values A trace’s Y-axis values are always stored in an SDF file’s Y-axis Data record. And when the file defines a single trace, that record includes just one vector of Y-axis values. Reading this vector of values is similar to reading a vector of X-axis values from the X-axis Data record. Four fields in the Data Header record tell you how to read Y-axis values from the Y-axis Data record: num_of_points: tells you how many discrete points the trace is composed of.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-216.html>PAGE 216</a></h6><p>Standard Data Format (SDF) Correcting Y-axis Data Y-axis data is stored in the instrument’s internal unit (usually volts) with all calibration corrections applied. Two other kinds of correction, however, are left for you to apply: • • Engineering unit (EU) correction. Window correction. (Necessary only for FREQ or ORDER domain data) Note Do not apply a window correction factor if it has already been applied by the instrument.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-217.html>PAGE 217</a></h6><p>Standard Data Format (SDF) Role of the Vector Header The Vector Header record contains the information you need to link a trace to the appropriate correction factors. First, it tells you which channels were used to gather raw data for the trace. It is the correction factor for these channels that you will apply to the trace. Second, it tells you how the raw channel data was processed to create the trace data.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-218.html>PAGE 218</a></h6><p>Standard Data Format (SDF) What values would a Vector Header record contain for this frequency response trace? Here is an example record: recordType: 13 recordSize: 18 unique_record: -1 the_CHANNEL_record[0]: 5 the_CHANNEL_record[1]: 2 pwrOfChan[0]: 48 pwrOfChan[1]: -48 Two fields in the record — the_CHANNEL_record[0] and the_CHANNEL_record[1] — tell you which channels were used to measure response and excitation.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-219.html>PAGE 219</a></h6><p>Standard Data Format (SDF) Creating the Correction Factor As you have seen in this section, the Vector Header record and its associated Channel Header records contain all the information you need to create a correction factor for a trace’s Y-axis data. Just complete the following steps: 1. Determine which channels were used to gather data for the trace. (Look at the Vector Header record’s the_CHANNEL_record fields.) 2. Determine which window correction factor (if any) was used for each channel.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-220.html>PAGE 220</a></h6><p>Standard Data Format (SDF) Locating a Vector of Y-axis Data When an SDF file defines just one trace, the Y-axis Data record contains a single vector of Y-axis data. However, when the file defines more than one trace, the record contains many vectors — one for each trace. This section tells you how to locate one Y-axis vector in a block of many.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-221.html>PAGE 221</a></h6><p>Standard Data Format (SDF) Here are the two ways the vectors could be organized in the Y-axis data block: scan_type is Scan (1): scan_type is Depth (0): S0.D0. V0 S0.D0. V0 V1 V1 V2 V2 D1. V3 S1.D0. V0 V4 V1 V5 V2 V6 S0.D1. V3 S1.D0. V0 V4 V1 V5 V2 V6 D1. V3 S1.D1.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-222.html>PAGE 222</a></h6><p>Standard Data Format (SDF) Time Capture Data A time capture data contains long streams of raw time data captured by an instrument. The files contains some or all of the following results. Time Data Time data is identified in a time capture file with the following SDF_DATA_HDR attributes: dataType 0 (time data) ydata_type SHORT16 or LONG32 scanData 1 The time data should always be the first result in a time capture file.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-223.html>PAGE 223</a></h6><p>Standard Data Format (SDF) Frequency Correction Data Frequency Correction Data is identified in a time capture file with the following SDF_DATA_HDR attributes: dataType 34 (frequency corrections) scanData 0 This data result contains the frequency domain corrections for the time capture data. It is the same size as the instrument’s Spectrum data result. There is one of these results for each channel of a time capture.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-224.html>PAGE 224</a></h6><p>Standard Data Format (SDF) Tachometer Data Tachometer data is identified in a time capture file with the following SDF_DATA_HDR attributes: dataType 37 (tachometer data) ydata_type LONG32 yIsComplex 0 scanData 0 Each point in the tachometer data is a 32 tachometer counter value which represents time. To interpret the tachometer data, you need to know how many tachometer points are in the tachometer data, the tachometer frequency, and the number of tachometer pulses per revolution.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-225.html>PAGE 225</a></h6><p>Standard Data Format (SDF) External Trigger Data External trigger data is identified in a time capture file with the following SDF_DATA_HDR attributes: dataType 48 (external trigger data) ydata_type LONG32 yIsComplex 0 scanData 0 If the trigger mode is set to be the external trigger at the time the capture was acquired and the tachometer is turned on, then this data result may be present. Each point in the external trigger data is a 32 external trigger counter value which represents time.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-226.html>PAGE 226</a></h6><p>Standard Data Format (SDF) Waterfall/Map/MultiSpectrum/Spectrogram Data Many instrument create multiple scans of data and display them as a waterfall, a map, a multispectrum, or a spectrogram. In an SDF data file, this appears as multiple scans of a data result. When this type of data is in the file, the scanData field in the SDF_DATA_HDR for a result is set to TRUE (1) and the SDF_FILE _HDR indicates that either an SDF_SCAN_STRUCT record or an SDF_SCAN_BIG record is in the file (or both).</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-227.html>PAGE 227</a></h6><p>Standard Data Format (SDF) Bit Meaning when bit is set 0 row channel overload 1 column channel overload 8 questionable data 9 uncalibrated data 15 real-time data 16 digital demodulation sync search is on 17 digital demodulation pulse search is on 24 digital demodulation sync found (only valid if sync search is on) 25 digital demodulation pulse found (only valid if pulse search is on) B-41</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-228.html>PAGE 228</a></h6><p>Standard Data Format (SDF) Example File The following multi-page illustration shows the contents of a simple measurement file (of the SDF 1.) It defines just one trace. The trace’s Y-axis values are contained in a vector of data at the end of the file (in the record SDF_YDATA_HDR). The trace’s X-axis values are calculated from information in the record SDF_DATA_HDR. File power.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-229.html>PAGE 229</a></h6><p>Standard Data Format (SDF) stopFreqIndex: 400 averageType: 1 averageNum: 10 pctOverlap: 0.000000E+00 measTitle: videoBandWidth: 0.000000E+00 SDF_DATA_HDR 0 recordType: 12 recordSize: 114 unique_record: −1 dataTitle: Power Spectrum domain: 0 dataType: 2 num_of_points: 513 last_valid_index: 512 abscissa_firstX: 0.000000E+00 abscissa_deltaX: 1.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-230.html>PAGE 230</a></h6><p>Standard Data Format (SDF) 0 0 0 0 0 0 0 0 SDF_VECTOR_HDR 0 recordType: 13 recordSize: 18 unique_record: −1 the_CHANNEL_record[0]: 0 the_CHANNEL_record[1]: −1 pwrOfChan[0]: 96 pwrOfChan[1]: 0 SDF_CHANNEL_HDR 0 recordType: 14 recordSize: 146 unique_record: −1 channelLabel: Chan 1 moduleId: serialNum: P46.464646 windowType: 1 windowCorrMode: 0 windowBandWidth: 1.500000E+00 windowTimeConst: 0.000000E+00 windowTrunc: 0.000000E+00 wideBandCorr: 1.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-231.html>PAGE 231</a></h6><p>Standard Data Format (SDF) 0 2 −4 0 0 0 0 0 int2engrUnit: 1.000000E-02 inputImpedance: 1.000000E+06 SDF_YDATA_HDR recordType: 17 recordSize: 2058 7.688535E-03: 513 real points 1.922215E-03: | 9.141845E-10: V . . . 2.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-232.html>PAGE 232</a></h6><p></p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-233.html>PAGE 233</a></h6><p>C Batch Files Introduction This chapter documents the batch files included with the Standard Data Format Utilities. These files ‘’automate’’ some procedures by performing the two or three steps required. For example, ‘’63_SDF.BAT’’ performs both the LIF-to-DOS conversion and the HP 3563A-to-SDF conversion for all HP 3563A/62A files on the specified drive. You can use the batch files as they are, or copy and modify them to fit your particular needs. The batch files included are: 63_ML.BAT 60_ML.BAT 69_ML.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-234.html>PAGE 234</a></h6><p>Batch Files 63_ML.BAT 63_ML.BAT Convert all HP 3563A/62A data files on the specified LIF disk drive to PC-MATLAB Mat-file format. Destination is *.MAT where ‘’*’’ is the same name as the LIF file on the source disk drive. Default drive is ‘’b:’’. Syntax 63_ML [drive:] @echo off set drv63=%1 set dir63=tmp63 set dirsdf=tmpsdf set file63=*.DAT set tmp63=%dir63%\%file63% set tmpsdf=%dirsdf%\%file63% set tmpmat=%dirsdf%\*.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-235.html>PAGE 235</a></h6><p>Batch Files 63_MX.BAT 63_MX.BAT Convert all HP 3563A/62A data files on the specified LIF disk drive to MATRIXx Mat-file format. Destination is *.MAT where ‘’*’’ is the same name as the LIF file on the source disk drive. Default drive is ‘’b:’’. Syntax 63_MX [drive:] @echo off setdrv63=%1 set dir63=tmp63 set dirsdf=tmpsdf set file63=*.DAT set tmp63=%dir63%\%file63% set tmpsdf=%dirsdf%\%file63% set tmpmat=%dirsdf%\*.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-236.html>PAGE 236</a></h6><p>Batch Files 63_PLOT.BAT 63_PLOT.BAT Plot all HP 3563A/62A data files on the specified LIF disk drive. Default drive is ‘’b:’’. Syntax 63_PLOT [drive:] @echo off set drv63=%1 set dir63=tmp63 set file63=*.63 set tmp63=%dir63%\%file63% if ‘%drv63%’==’’ set drv63=b: mkdir %dir63% if exist %tmp63% del %tmp63% echo Copy HP 3563A/62A LIF data files from %drv63% lif cp %drv63%DA* %tmp63% /o REM plot all *.63 files chdir %dir63% for %%f in (%file63%) do viewdata %%f /t:%%f /p chdir ..</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-237.html>PAGE 237</a></h6><p>Batch Files 63_SDF.BAT 63_SDF.BAT Convert all HP 3563A/62A data files on the specified LIF disk drive to SDF. Default drive is ‘’b:’’. Syntax 63_SDF.BAT [drive:] @echo off set drv63=%1 set dir63=tmp63 set file63=*.DAT set tmp63=%dir63%\%file63% if ‘%drv63%’==’’ set drv63=b: mkdir %dir63% if exist %tmp63% del %tmp63% echo Copy HP 3563A/62A LIF data files from %drv63% lif cp %drv63%DA* %tmp63% /o chdir %dir63% echo Convert HP 3563A/62A data files to SDF for %%f in (%file63%) do 63tosdf %%f ..</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-238.html>PAGE 238</a></h6><p>Batch Files 60_ML.BAT 60_ML.BAT Convert all HP 3560A data files that are transferred over the RS-232 port to PC-MATLAB Mat-file format. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 60_ML.BAT [port] [baud] @echo off set port60=%1 set baud60=%2 set temp60=temp60 set dire60=tempsdf if ‘%port60%’==’’ set port60=1 if ‘%baud60%’==’’ set baud60=9600 mkdir %dire60% chdir %dire60% echo y | del %dire60% download /o %temp60%.x32 /p%port60% /b%baud% x32tobin /o %temp60%.x32 %temp60%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-239.html>PAGE 239</a></h6><p>Batch Files 60_MX.BAT 60_MX.BAT Convert all HP 3560A data files that are transferred over the RS-232 port to MATRIXx Mat-file format. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 60_MX.BAT [port] [baud] @echo off set port60=%1 set baud60=%2 set temp60=temp60 set dire60=tempsdf if ‘%port60%’==’’ set port60=1 if ‘%baud60%’==’’ set baud60=9600 mkdir %dire60% chdir %dire60% echo y | del %dire60% download /o %temp60%.x32 /p%port60% /b%baud% x32tobin /o %temp60%.x32 %temp60%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-240.html>PAGE 240</a></h6><p>Batch Files 60_PLOT.BAT 60_PLOT.BAT Plot all HP 3560A data files that are transferred over the RS-232 port. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 60_PLOT.BAT [port] [baud] @echo off set port60=%1 set baud60=%2 set temp60=temp60 set dire60=tempsdf if ‘%port60%’==’’ set port60=1 if ‘%baud60%’==’’ set baud60=9600 mkdir %dire60% chdir %dire60% echo y | del %dire60% download /o %temp60%.x32 /p%port60% /b%baud% x32tobin /o %temp60%.x32 %temp60%.bin del %temp60%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-241.html>PAGE 241</a></h6><p>Batch Files 60_SDF.BAT 60_SDF.BAT Convert all HP 3560A data files that are transferred over the RS-232 port to SDF. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 60_SDF.BAT [port] [baud] @echo off set port60=%1 set baud60=%2 set temp60=temp60 if ‘%port60%’==’’ set port60=1 if ‘%baud60%’==’’ set baud60=9600 download /o %temp60%.x32 /p%port60% /b%baud% x32tobin /o %temp60%.x32 %temp60%.bin del %temp60%.x32 60tosdf /o %temp60%.bin del %temp60%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-242.html>PAGE 242</a></h6><p>Batch Files 69_ML.BAT 69_ML.BAT Convert all HP 3569A data files that are transferred over the RS-232 port to PC-MATLAB Mat-file format. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 69_ML.BAT [port] [baud] @echo off set port69=%1 set baud69=%2 set temp69=temp69 set dire69=tempsdf if ‘%port69%’==’’ set port69=1 if ‘%baud69%’==’’ set baud69=9600 mkdir %dire69% chdir %dire69% echo y | del %dire69% download /o %temp69%.x32 /p%port69% /b%baud% x32tobin /o %temp69%.x32 %temp69%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-243.html>PAGE 243</a></h6><p>Batch Files 69_MX.BAT 69_MX.BAT Convert all HP 3569A data files that are transferred over the RS-232 port to MATRIXx Mat-file format. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 69_MX.BAT [port] [baud] @echo off set port69=%1 set baud69=%2 set temp69=temp69 set dire69=tempsdf if ‘%port69%’==’’ set port69=1 if ‘%baud69%’==’’ set baud69=9600 mkdir %dire69% chdir %dire69% echo y | del %dire69% download /o %temp69%.x32 /p%port69% /b%baud% x32tobin /o %temp69%.x32 %temp69%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-244.html>PAGE 244</a></h6><p>Batch Files 69_PLOT.BAT 69_PLOT.BAT Plot all HP 3569A data files that are transferred over the RS-232 port. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 69_PLOT.BAT [port] [baud] @echo off set port69=%1 set baud69=%2 set temp69=temp69 set dire69=tempsdf if ‘%port69%’==’’ set port69=1 if ‘%baud69%’==’’ set baud69=9600 mkdir %dire69% chdir %dire69% echo y | del %dire69% download /o %temp69%.x32 /p%port69% /b%baud% x32tobin /o %temp69%.x32 %temp69%.bin del %temp69%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-245.html>PAGE 245</a></h6><p>Batch Files 69_SDF.BAT 69_SDF.BAT Convert all HP 3569A data files that are transferred over the RS-232 port to SDF. The default port is ‘’1’’ (COM1). The default baud rate is ‘’9600’’. Syntax 69_SDF.BAT [port] [baud] @echo off set port69=%1 set baud69=%2 set temp69=temp69 if ‘%port69%’==’’ set port69=1 if ‘%baud69%’==’’ set baud69=9600 download /o %temp69%.x32 /p%port69% /b%baud% x32tobin /o %temp69%.x32 %temp69%.bin del %temp69%.x32 69tosdf /o %temp69%.bin del %temp69%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-246.html>PAGE 246</a></h6><p>Batch Files IB63_ML.BAT IB63_ML.BAT Upload HP 3563A/62A active trace via HP-IB and convert it to PC-MATLAB Mat-file format. Syntax IB63_ML.BAT [filename] @echo off set file63=%1 if ‘%file63%’==’’ set file63=HP3563 hpib63 %file63%.63 /o 63tosdf %file63%.63 %file63%.DAT /o del %file63%.63 sdftoml %file63%.DAT /b /o >nul del %file63%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-247.html>PAGE 247</a></h6><p>Batch Files IB63_MX.BAT IB63_MX.BAT Upload HP 3563A/62A active trace via HP-IB and convert it to MATRIXx Mat-file format. Syntax IB63_MX.BAT [filename] @echo off set file63=%1 if ‘%file63%’==’’ set file63=HP3563 hpib63 %file63%.63 /o 63tosdf %file63%.63 %file63%.DAT /o del %file63%.63 sdftomx %file63%.DAT /b /o >nul del %file63%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-248.html>PAGE 248</a></h6><p>Batch Files IB63_PLT.BAT IB63_PLT.BAT Upload HP 3563A/62A active trace via HP-IB and plot it. Syntax IB63_PLT @echo off set file63=HP3563 hpib63 %file63%.63 /o viewdata %file63%.63 /p del %file63%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-249.html>PAGE 249</a></h6><p>Batch Files IB63_SDF.BAT IB63_SDF.BAT Upload HP 3563A/62A active trace via HI-IB and convert it to SDF format. Syntax IB63_SDF [filename] @echo off set file63=%1 if ‘%file63%’==’’ set file63=HP3563 hpib63 %file63%.63 /o 63tosdf %file63%.63 %file63%.DAT /o del %file63%.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-250.html>PAGE 250</a></h6><p></p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-251.html>PAGE 251</a></h6><p>INDEX ! 60TOSDF 63TOSDF 660TOSDF 69TOSDF 88TOSDF 89TOSDF F 4-5 4-7 4-8 4-9 4-11 4-13 filter gaussian 8-2 raised cosine 8-2 root-raised cosine 8-2 filtrsdf.mex 7-2 formatting LIF directory 3-17 A G ASCII file converting to SDF 4-15 ASCTOSDF 4-15 gauss.mcd (Mathcad) 8-2 gaussian filter 8-2 Gaussian MSK waveform 8-1 gmsk.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-252.html>PAGE 252</a></h6><p>Index (Continued) converting to ASCII 4-59 HP894x0A with Mathcad 8-1 I initializing LIF directory 3-17 installing SDF libraries 1-10 installing SDF Utilities 1-10 L LIF CHECK 3-7 LIF CHK 3-7 LIF COPY 3-10 LIF CP 3-10 LIF DEL 3-15 LIF DIR 3-8 LIF files deleting 3-15 LIF INIT 3-17 LIF LS 3-8 LIF RM 3-15 LIF SCAN 3-5 LIF to DOS conversion 3-10 LIFDIAG 3-20 Locating a Vector B-34 M map 2-4 Map Data B-40 matdemo.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-253.html>PAGE 253</a></h6><p>Index (Continued) SdfYdataWrite 6-16 SETUP63 4-55 SETUP88 4-57 SETUP89 4-59 signals (Mathcad) 8-1 Spectrogram Data B-40 Standard Data Format 6-2, B-1 Structure descriptions B-6 SYNTH63 4-62 T tcdemo.m 7-4 tcdemo2.</p></li><li><h6><a class="text-decoration-none text-link fw-bold" href=/manual/agilent-technologies/3588a/user-s-guide-english/page-254.html>PAGE 254</a></h6><p></p></li></ul></nav></div></section></section></main><footer class=page-footer><div class="container flex-column py-3 py-sm-4"><div class="row mb-1 mb-sm-2 mb-md-5"><a href=/ class="brand offset-sm-0 col-sm-4 col-md-3 col-lg-2 offset-2 col-8 text-center text-md-start"><img class=logo-small src=/assets/img/brand-large.png alt=Manualshelf></a></div><div class=row><dl class="text-center text-sm-start col-sm-3"><dt class=fw-bold>Who We Are</dt><dd><a class=text-decoration-none href=/about>About Us</a></dd><dd><a class=text-decoration-none href=/company>Company</a></dd><dd><a class=text-decoration-none href=/careers>Careers</a></dd><dd><a class=text-decoration-none href=/terms>Terms & Privacy</a></dd></dl><dl class="text-center text-sm-start col-sm-3"><dt class=fw-bold>Resources</dt><dd><a class=text-decoration-none href=/brands>List of Manufacturers</a></dd><dd><a href=/ class=text-decoration-none>Support</a></dd><dd><a class=text-decoration-none href=/press>For the Press</a></dd><dd><a class=text-decoration-none href=/press#assets>Media assets</a></dd><dd><a class=text-decoration-none href=/faq>FAQ</a></dd></dl><dl class="text-center text-sm-start col-sm-3"><dt class=fw-bold>Get in touch</dt><dd><a class=text-decoration-none href=#>Blog</a></dd><dd><a class=text-decoration-none href=#>Email</a></dd><dd><a class=text-decoration-none href=/dmca>DMCA</a></dd></dl></div><div class=row><div class="text-center text-sm-start col-sm-4 pe-sm-0"><a href=https://www.facebook.com/pages/ManualShelf/1488826334681423 class="fs-5 text-center d-inline-block social rounded-2 align-middle text-decoration-none me-2"><i class="fab fa-facebook-f"></i></a><a href=https://www.twitter.com/ManualShelf class="fs-5 text-center d-inline-block social rounded-2 align-middle text-decoration-none me-2"><i class="fab fa-twitter"></i></a><a href=https://plus.google.com/+ManualShelf class="fs-5 text-center d-inline-block social rounded-2 align-middle text-decoration-none me-2"><i class="fab fa-google-plus-g"></i></a><a href=http://www.pinterest.com/ManualShelf class="fs-5 text-center d-inline-block social rounded-2 align-middle text-decoration-none"><i class="fab fa-pinterest-p"></i></a></div><div class="col col-sm-8 d-flex flex-column align-items-center flex-sm-row flex-wrap flex-sm-nowrap justify-content-center justify-content-sm-end"><div class="copy w-auto d-flex align-items-center justify-content-center justify-content-sm-end mt-2 mt-sm-0 me-2">ManualShelf © 2013-2025</div><select class="form-select form-select-sm w-auto mt-2 mt-sm-0"><option value=usa>USA</option></select><div></div></div><div id=pixel><script>
googletag.cmd.push(function() { googletag.display('pixel'); });
</script></div></footer><script src=/assets/js/jquery-3.3.1.min.js></script><script src=/assets/js/bootstrap.bundle.min.js></script><script src=/assets/js/jquery.autocomplete.min.js></script><script type=text/javascript>
$.extend({
redirectPost: function(location, args) {
var form = '';
$.each(args, function(key, value) {
form += '<input type="hidden" name="' + key + '" value="' + value + '">';
});
form = '<form id="s1" action="' + location + '" method="POST">' + form + '</form>';
$(document.body).append(form);
$("#s1").submit();
}
});
$(document).ready(function(){
$("#query").autocomplete({
minChars: 3,
groupBy: 'type',
paramName: 'q',
dataType: 'json',
serviceUrl: '/autocomplete',
noCache: true,
showNoSuggestionNotice: true,
noSuggestionNotice: 'Zarro results found',
onSelect: function (suggestion) {
$.redirectPost(suggestion.data.url, {highlight: encodeURIComponent(JSON.stringify(suggestion.data.hls))});
}
});
var toc = $('.toc-selector');
if (toc.length) {
var slideParams = { duration: 800, easing: 'linear' };
toc.click(function() {
$(this).toggleClass('open');
var section = $('.toc-content');
var isCollapsed = section.attr('data-collapsed') === 'true';
if (isCollapsed) {
section.slideDown(slideParams)
section.attr('data-collapsed', 'false')
} else {
section.slideUp(slideParams);
section.attr('data-collapsed', 'true')
}
});
}
});
var lastSmall = $(window).width() < 576;
$(window).resize(function() {
var newSmall = $(window).width() < 576;
if (lastSmall != newSmall) {
lastSmall = newSmall;
window.location.href = window.location.href;
}
});
</script></body></html>
