RTDAQ Revision: 3/12 C o p y r i g h t © 2 0 0 8 - 2 0 1 2 C a m p b e l l S c i e n t i f i c , I n c .
Campbell Scientific, Inc. Software End User License Agreement (EULA) NOTICE OF AGREEMENT: This software is copyrighted software. Please carefully read this EULA. By installing or using this software, you are agreeing to comply with the following terms and conditions. If you do not want to be bound by this EULA, you must promptly return the software, any copies, and accompanying documentation in its original packaging to Campbell Scientific or its representative.
WARRANTIES: The following warranties are in effect for ninety (90) days from the date of shipment of the original purchase. These warranties are not extended by the installation of upgrades or patches offered free of charge. Campbell Scientific warrants that the installation media on which the software is recorded and the documentation provided with it are free from physical defects in materials and workmanship under normal use.
RTDAQ Table of Contents PDF viewers: These page numbers refer to the printed version of this document. Use the PDF reader bookmarks tab for links to specific sections. Preface — What's New in RTDAQ? ................................ xi 1. Introduction...............................................................1-1 1.1 RTDAQ Overview................................................................................ 1-2 1.1.1 Main Screen .........................................................................
RTDAQ Table of Contents 4.3 4.4 4.5 4.6 4.7 4.2.3 Datalogger Settings ..................................................................... 4-4 4.2.3.1 Max Time Online............................................................... 4-5 4.2.4 Summary, Communications Test, and Clock Set ........................ 4-5 4.2.5 Send Program .............................................................................. 4-5 4.2.6 Editing and Deleting Dataloggers ...............................................
RTDAQ Table of Contents 5.1.4 CRBasic Programming ............................................................. 5-20 5.1.4.1 Programming Sequence................................................... 5-20 5.1.4.2 Program Declarations ...................................................... 5-21 5.1.4.3 Mathematical Expressions............................................... 5-21 5.1.4.4 Measurement and Output Processing Instructions .......... 5-22 5.1.4.5 Line Continuation.......................................
RTDAQ Table of Contents 5.3.5 Using Save and Send................................................................. 5-56 5.3.5.1 Download ........................................................................ 5-57 5.3.5.2 Run Options..................................................................... 5-58 5.3.5.3 Datalogger Response ....................................................... 5-58 6. View Pro.................................................................... 6-1 6.1 Overview................
RTDAQ Table of Contents 6.9 Printing Options.................................................................................. 6-33 6.9.1 Print Setup................................................................................. 6-33 6.9.2 Printing Text ............................................................................. 6-34 6.9.3 Printing Graphs ......................................................................... 6-34 6.10 View Pro Online Help .............................................
RTDAQ Table of Contents 7.6.4 Using the Graphical Display Area of the XY Plot .................... 7-40 7.6.5 Zooming with the XY Plot ........................................................ 7-41 7.6.6 Using the Special Options of the XY Plot................................. 7-42 7.6.6.1 Scaling Tab...................................................................... 7-43 7.6.6.2 Data Display Tab ............................................................. 7-44 7.6.6.3 Visual Display Tab ...............
RTDAQ Table of Contents 8. Real-Time Monitoring and Control Software..........8-1 8.1 Development Mode .............................................................................. 8-1 8.1.1 The RTMC Workspace ............................................................... 8-3 8.1.2 Single Datalogger RTMC Projects ............................................. 8-3 8.1.3 Display Components ................................................................... 8-3 8.1.4 Functions Available from the RTMC Menus..
RTDAQ Table of Contents 10. Utilities .................................................................. 10-1 10.1 CardConvert...................................................................................... 10-1 10.1.1 Input/Output File Settings ....................................................... 10-1 10.1.2 Destination File Options.......................................................... 10-2 10.1.2.1 File Format .................................................................... 10-2 10.1.2.
RTDAQ Table of Contents A.3.3 IEEE4........................................................................................ A-5 A.3.4 IEEE8........................................................................................ A-6 A.4 Converting Binary File Formats ......................................................... A-6 A.4.1 Split ........................................................................................... A-6 A.4.2 CardConvert.........................................................
RTDAQ Table of Contents x
Preface — What's New in RTDAQ? The most significant changes in RTDAQ 1.1 are in the Short Cut program generator. These include: • A new Datalogger step has been added to the Progress panel. In this step, you select the datalogger model and set the scan interval. When generating a program for a CR9000X, the CR9000X Configuration box also appears on this screen.
Preface — What's New in RTDAQ? In addition to these Short Cut changes, RTDAQ has some changes including: • The user can now select an image for the background of a Graph, Fast Graph, or XY Plot. • The Add, Delete, Delete All, and Trace Option buttons have been moved to a toolbar on the Graph, Fast Graph, and XY Plot. • You can now edit fields in the Table Monitor. • You can now toggle between data displays by pressing the data display type button (e.g.
Preface — What's New in RTDAQ? Undo/Redo List on File Save, Syntax Highlighting for Variables and Local Variables. • The CRBasic Editor also now has the capability to open a read-only copy of any file. This gives you the ability to open multiple copies of a program and examine multiple areas of a very large program at the same time.
Preface — What's New in RTDAQ? • The timestamp has been placed in the status bar and is displayed when the vertical cursor is used to step through values. • The Line Graph now has the ability to add a right Y-axis. Device Configuration Utility • The Device Configuration Utility has a new off-line mode which allows you to look at the settings for a certain device type without actually being connected to a device.
Section 1. Introduction RTDAQ (Real-time Data Acquisition) is a software application targeted to industrial and other high-speed data collection implementations which use Campbell Scientific’s dataloggers. RTDAQ replaces PC9000 as the company’s flagship product offering in the industrial marketplace. This software supports configuration, programming, communications, and data collection for the majority of dataloggers using the CRBasic datalogger programming language.
Section 1. Introduction 1.1 RTDAQ Overview 1.1.1 Main Screen The main screen of RTDAQ provides three tabs with datalogger interaction functions (Clock/Program, Monitor Data, and Collect Data), as well as a toolbar with buttons to launch frequently-used utilities and auxiliary applications.
Section 1. Introduction 1.1.2 Clock/Program and the EZSetup Wizard Setting up the RTDAQ datalogger network is a relatively simple process with the EZSetup Wizard, which guides you through the steps necessary to add and enter settings for dataloggers. Once a datalogger is added to the list, you to activate the Wizard again and can choose the Edit Datalogger button change those settings.
Section 1. Introduction 1-4 • The status of ports, flags, or any boolean variables can be monitored and controlled within the Ports and Flags window. • The Table Monitor allows quick numeric viewing of entire output tables. • With both the Graph and Fast Graph, graphical data traces from a datalogger can be monitored in a window width as small as 1 millisecond, with resolution support for individual points up to 100 KHz.
Section 1. Introduction • Histograms calculated by the datalogger can be shown as they are made available by program calculations and storage. • Display of rainflow-style histograms is also supported using the Rainflow viewer. This display works with programs utilizing the Rainflow output instruction in the CRBasic datalogger program.
Section 1. Introduction 1.1.4 Collect Data Once a program is storing data in the datalogger you can collect a copy of that data to a file on the PC. The Collect Data tab shows a list of tables in the datalogger as defined by the currently running program. You can retrieve the uncollected data, appending it to a file on the PC, or you can retrieve all of the data from the datalogger. You can also use other custom configurations for the collection.
Section 1. Introduction 1.1.5 Field Calibration and the Calibration Wizard RTDAQ includes the Calibration Wizard for performing real-time, nonintrusive calibration of measurements. Datalogger programs that use the FieldCal CRBasic instruction activate this Wizard for use. This feature allows calibration to occur within a simple interface, instead of requiring manual calibration via the numeric displays or with the keypad display at the datalogger site. 1.1.
Section 1. Introduction Execution of these screens is done with the RTMC Run-time program. Both programs can be started using buttons from the main RTDAQ interface. The Standard RTMC Development and RTMC Run-time applications are included with RTDAQ. RTMC Pro must be purchased and installed separately from RTDAQ, but will operate within the RTDAQ environment after installation. 1.1.
Section 1. Introduction View Pro can be launched from a button on RTDAQ’s main screen. View Pro is a simple analysis tool, and includes some basic printing and export capabilities. 1.1.8 Split Split is a stand-alone application used to post-process data files on the PC and generate reports. A button on RTDAQ’s main screen launches the Split . It can be used to merge data from multiple stations into one application file, perform calculations, and change date/time formats.
Section 1. Introduction Short Cut is also an excellent way to learn about the CRBasic programming language. The CRBasic programs created by Short Cut can be loaded directly into the CRBasic Editor for inspection or editing. 1.1.11 CRBasic Editor The CRBasic Editor is a program editor for CRBasic datalogger programs, including programs for the CR800, CR850, CR1000, CR3000, CR5000, and CR9000X. It is used to manually create programs or to edit existing or generated programs.
Section 1. Introduction CR9000X and CR5000 programs can be generated using a detailed, instruction-level interface resulting in extensive control over generated programs. 1.2 Getting Help for RTDAQ Applications Detailed descriptions of each application or tool are included in later sections of this manual. Each application also has its own built-in help system. Context sensitive help for an application can usually be accessed by moving the focus to (i.e.
Section 1. Introduction The most common methods for accessing functionality are: Menus – Text menus are displayed at the top of most windows. Menu items are accessed either by a left mouse click, or using a hot key combination (e.g., Alt+F opens the File menu). When the menu is opened, you can click on an item to select it, or use arrow keys to highlight it and press the Enter key, or just type the underlined letter.
Section 2. System Requirements 2.1 Hardware and Software RTDAQ is an integrated application of 32-bit programs designed to run on Intel-based computers running Microsoft Windows operating systems. Recommended platforms for running RTDAQ include Windows XP, Windows Vista, and Windows 7. RTDAQ also requires that TCP/IP support be installed on the PC.
Section 2.
Section 3. Installation, Operation and Backup Procedures 3.1 CD-ROM Installation The following instructions assume that drive D: is a CD-ROM drive on the computer from which the software is being installed. If the drive letter is different, substitute the appropriate drive letter. 1. Put the installation CD in the CD-ROM drive. The install application should come up automatically. Skip to step 3. 2. If the install does not start, then from the Windows system menu, select Start | Run. Type “d:\setup.
Section 3. Installation, Operation and Backup Procedures 3.2 RTDAQ Operations and Backup Procedures This section describes some of the concepts and procedures recommended for routine operation and security of the RTDAQ software. Since the occurrence of operational issues cannot be fully eliminated on most computer systems, the following guidelines and procedures are provided to help minimize possible problems that may occur. 3.2.1 RTDAQ Directory Structure and File Descriptions 3.2.1.
Section 3. Installation, Operation and Backup Procedures The following figure shows the typical working directories for RTDAQ if the default options were selected during installation: FIGURE 3.2-1. Typical Working Directories for RTDAQ 3.2.2 Backing up the Network Map and Data Files As with any computer system that contains important information, the data stored in the RTDAQ working directory should be backed up to a secure archive on a regular basis.
Section 3. Installation, Operation and Backup Procedures 3.2.2.1 Performing a Backup RTDAQ provides a simple way to back up the network map, the RTDAQ data cache, and the initialization files for the main application. The network map will restore all settings and data collection pointers for the dataloggers and other devices in the network. The data cache is the binary database which contains the collected data from the datalogger.
Section 4. The RTDAQ Main Screen This section provides an overview of RTDAQ, including a detailed description of the communications tabs, pull-down menus, and toolbar. An overview of RTDAQ’s troubleshooting tools is also provided. 4.1 Overview 4.1.1 Program Startup and Main Screen Functionality To start RTDAQ go to the Start menu of the computer and select the RTDAQ icon under Start | Programs | Campbell Scientific | RTDAQ.
Section 4. The RTDAQ Main Screen The RTDAQ main screen consists of a Title Bar, Menu Bar, Toolbar, Datalogger Network Map, Clock/Program tab, Monitor Data tab, Collect Data tab, and Status Bar as shown here: The Title Bar shows the RTDAQ application name and version, as well as the datalogger station name and model name currently highlighted for selection or connection. The Menu Bar, Toolbar, Clock/Program tab, Monitor Data tab, and Collect Data tab are described in more detail later in this chapter.
Section 4. The RTDAQ Main Screen via the buttons on the main screen or the pull-down menu selections under the Tools menu. More information about these tools is provided later in this manual. 4.1.2 Datalogger Connectivity, Help and Program Exit RTDAQ supports the major CRBasic dataloggers, including the CR800, CR850, CR1000, CR3000, CR5000, and CR9000X. RTDAQ supports one medium of communications for any given datalogger.
Section 4. The RTDAQ Main Screen Previous and Next buttons are provided for easy movement through the Wizard. Progress is shown by the blue arrow next to each step displayed on the left of the screen. Help is available from the Help button as well as the text displayed on the right side of the screen. 4.2.2 Communication Setup In the Communication Setup step you select the datalogger type and give it a name that will also become the default file name for data files collected from that datalogger.
Section 4. The RTDAQ Main Screen 4.2.3.1 Max Time Online Note that the default Max Time On-Line setting for most communications links is zero (“0 d 00 h 00 m”), which means that RTDAQ will never hang up until you click Disconnect. For telephone links, the default Max Time On-Line setting is 10 minutes in order to reduce the possibility of inadvertent and expensive long distance or cellular telephone charges.
Section 4. The RTDAQ Main Screen 4.3 Clock/Program Tab Selection of the Clock/Program tab brings up the Clock/Program screen. RTDAQ displays this tab by default when first executed. 4.3.1 Basic Operation In this screen you can see brief details about the currently selected datalogger, including its name in the Network Map, its station name, its connection information, and its response time settings.
Section 4. The RTDAQ Main Screen 4.4 Monitor Data Tab Once you’ve added and connected to a datalogger, you can monitor the values stored by the datalogger in real-time. Choose the Monitor Data tab to display the Monitor Data screen. 4.4.1 Field Monitor This screen contains the Field Monitor, which displays values from datalogger tables, including stored tables and the public table. Press the Add button to bring up a screen for selecting data table fields to be monitored in this screen.
Section 4. The RTDAQ Main Screen number itself until it turns yellow, then use the PC keyboard to enter a new value. Alternately, you can right-click the value, select View/Modify Value, and edit the value in the resulting dialog box. 4.4.3 Specialized Real-time Monitor Screens The Monitor Data screen is also used to access the specialized real-time data monitor screens. For more information about the Monitor Data screen, see Chapter 7 “Monitoring Data in Real-time”. 4.
Section 4. The RTDAQ Main Screen 4.6 Pull-down Menus Access to almost all of the buttons and tabs on RTDAQ’s screens is also available via pull-down menus. Many of these functions are described in detail in other sections of this manual. The File menu is used to save and retrieve global setting configurations and close the RTDAQ program. The View menu allows selection of languages other than English. The Datalogger menu is used for datalogger control functions, connections, and wizards.
Section 4. The RTDAQ Main Screen 4.6.3 Datalogger Menu 4.6.3.1 Connect/Disconnect This option provides the same function as the Connect/Disconnect button on the main toolbar (see Section 4.7). 4.6.3.2 Update Table Definitions When a CRBasic datalogger is configured for the first time or when a new program is sent, RTDAQ queries the datalogger for its table definitions. Whenever a new program is loaded into the datalogger, the table definitions will automatically be sent to RTDAQ.
Section 4. The RTDAQ Main Screen The Status Table display screen is shown below: This window has three tabs: Summary, Table Fill Times, and Status Table. 4.6.3.3.1 Summary Tab The Summary tab provides an overview of important status information from the datalogger, including information about the datalogger model and its firmware, current program details including error information (if any), battery voltage levels, and card memory (if one is present).
Section 4. The RTDAQ Main Screen 4.6.3.3.2 Table Fill Times The Table Fill Times tab lists the tables in the datalogger, along with the maximum number of records the table can hold, the estimated amount of time that it will take the table to fill, and the estimated date and time that the table will fill based on the time the datalogger program was downloaded and the table size. This fill information helps the user determine the collection schedule that should be performed on the datalogger.
Section 4. The RTDAQ Main Screen 4.6.3.4.1 Datalogger Devices Each datalogger will have a device designated as the CPU drive. If an add-in card is installed on the datalogger, you will also see the CRD storage device. The File Control window displays a list of files stored on each of its devices such as the CPU, PC card, or user-specified drive. The window on the left lists all of the data storage devices available for the selected datalogger (CPU, CRD, or USR).
Section 4. The RTDAQ Main Screen 4.6.3.4.3 Working with Files and Directories There are several options for working with the files and directories on the datalogger. Send is used to transfer files from the computer to the datalogger. Clicking the Send button brings up a standard file selection dialog box. A new file can be chosen and sent to the highlighted device. Datalogger programs, data files, and other ASCII files can be sent to the datalogger.
Section 4. The RTDAQ Main Screen dataloggers this setting can be selected when the program is sent to the datalogger. Run On Power-up sets the file to run when the datalogger is powered down and powered back up. A file set to Run Now and Run On Power-up will be shown as Run Always in the File Control window. Delete - Highlight a file and press the Delete button to remove the file from the datalogger's memory. A running program may not be deleted.
Section 4. The RTDAQ Main Screen 4.6.3.6 Terminal Emulator Terminal Emulator emulates a terminal connected to a datalogger or communications device. Terminal Emulator comes up showing a blank screen. Clicking on Select Device shows a list of devices known to RTDAQ. Selecting a device and baud rate, and then clicking Open Terminal causes RTDAQ to attempt to connect with that device.
Section 4. The RTDAQ Main Screen may ask you to use this method to manually dial through phone or RF modems, for example. You can close a connection to start another one by clicking the Close Terminal button. You can close the Terminal Emulator itself by clicking the [X] button in the upper right corner of the screen. 4.6.4 Network Menu 4.6.4.
Section 4. The RTDAQ Main Screen The CR800/850, CR1000 and CR3000 dataloggers keep track of the PakBus addresses of other devices that communicate with them, including PCs. If more than one PC is communicating with a single PakBus datalogger, it may be helpful to assign each PC its own PakBus address. PakBus addresses greater than 3999 are reserved for PCs or routers. Address 4095 is reserved for broadcast messages.
Section 4. The RTDAQ Main Screen 4.6.5.2 Options The following two options can be set to control the general operation of RTDAQ: Automatically Check Datalogger Status - This option allows you to determine when the datalogger status table is automatically checked. The options include After Connection, After Program Send, and/or On Interval.
Section 4. The RTDAQ Main Screen On the left side of the LogTool window is a display of all devices set up in RTDAQ. You can choose to show all messages or filter them to show only certain devices or dataloggers. RTDAQ can also store these messages to log files on the PC’s hard drive and will eventually overwrite these files to keep them from growing forever.
Section 4. The RTDAQ Main Screen supposed to be happening. Most users will only need to access these logs when requested to do so by Campbell Scientific support personnel. For more information about the content of these logs see Section 10. 4.6.5.4 PakBus Graph PakBus Graph is a utility that graphically depicts the connections in a PakBus datalogger network. It provides a look at RTDAQ's PakBus routing table. In addition, the utility can be used to change the settings of a PakBus device.
Section 4. The RTDAQ Main Screen 4.6.5.4.2 Dynamic and Static Links There are two types of links to PakBus dataloggers that the server recognizes: static links and dynamic links. Static links (depicted using red lines) are the communication links to dataloggers that have been set up in the software, but which have not been confirmed by communicating with the datalogger(s). You will see these dataloggers listed in the software's network map.
Section 4. The RTDAQ Main Screen 4.6.5.4.5 Discovering Probable Routes between Devices You can view the probable route that communication will take between two PakBus devices by sequentially clicking on the two devices in Pakbus Graph. The probable communication route will be highlighted in cyan. If the Show Hop Metrics check box is selected, the graph will include the time, in milliseconds, that communication takes between the two devices.
Section 4. The RTDAQ Main Screen RTMC Development. Opens RTMC Development for the setup or editing of RTMC projects. RTMC Run-time. Opens RTMC Run-time for the execution of RTMC projects. (RTDAQ must be in a connected state for this button to be enabled.) View Pro. Opens View Pro for viewing collected data files. Split. Opens Split for splitting collected data files based on timestamp or other criteria. Card Convert. Opens Card Convert to convert binary data, including data obtained from a removable card.
Section 5. Program Creation and Editing The CRBasic Editor is a programming tool which can be used with the CR1000, CR3000, CR800, CR850, CR5000, and CR9000X dataloggers. It is intended for use by experienced datalogger programmers who need more flexibility and control over the datalogger operation than what can be achieved using program generators such as SCWIN or the CR5000/CR9000X Program Generator (ProgGen).
Section 5. Program Creation and Editing 5.1.2 Inserting Instructions An instruction can be easily inserted into the program by highlighting it in the Instruction Panel list and pressing the Insert button or by double-clicking the instruction name. If an instruction has one or more parameters, an instruction dialog box will be displayed to facilitate editing the parameters. Complete the information in the parameter fields and press Insert to paste the instruction into the program.
Section 5. Program Creation and Editing Below is an example of the Parameter dialog box for the differential voltage instruction (VoltDiff). The Prev (Previous) and Next buttons can be used to move to the next (or previous) instruction with the parameter entry box opened. Short Cuts for Editing the Parameters Right-clicking or pressing F2 on a parameter that uses a variable as an input type will display a list of variables that have been defined in the program. A sample list is shown below.
Section 5. Program Creation and Editing Pressing F9 at any time will also bring up a list of variables. However, when a variable is chosen from the list brought up by F9, it will simply be inserted at the cursor without overwriting anything. Right-clicking or pressing F2 on a parameter that has a finite number of valid entries will bring up a list of those available options.
Section 5. Program Creation and Editing • Save as .CRB File: Saves highlighted text to a file with a *.CRB extension. This file is referred to as a “library file”. The file can then be reused by inserting it into another CRBasic program. • Insert File: Inserts a library file into the current program overwriting the highlighted text. 5.1.3 Toolbar The toolbar of the CRBasic Editor provides easy access to frequently used operations. New – Creates a new program window to start writing a new program.
Section 5. Program Creation and Editing Print Preview – Opens a Print Preview screen that will show what the program will look like when printed. You can check and set the margins and printer options. Undo – Each time the Undo button is clicked it will step back through the last changes made to the program. Redo – Cancels the undo and steps forward restoring the changes. Cut – Removes the selected part of the program and puts it on the clipboard to be pasted elsewhere.
Section 5. Program Creation and Editing Browse Bookmarks – Displays a list of all bookmarks in the program. When a bookmark is selected, the cursor moves to that line in the program. Clear Bookmarks – Erases all bookmarks from the program. GoTo – Moves the cursor to a particular section of the program. Choose the section type from the list box that appears. User-Defined Functions and Subroutines – Provides a list box containing all of the user-defined functions and subroutines.
Section 5. Program Creation and Editing 5.1.3.2 Compile, Save, and Send The CRBasic Editor allows you to send a program to a datalogger that has already been defined on the network map in LoggerNet, PC400, or RTDAQ. This only works if LoggerNet, PC400, or RTDAQ is running at the time you attempt to send the program. This function first checks the program for errors using the pre-compiler, then saves the program (using the current name, or by prompting the user for a name if the program is new).
Section 5. Program Creation and Editing The Select the destination list shows all dataloggers configured within LoggerNet, PC400, or RTDAQ that may receive a program matching the extension of the current CRBasic program to be sent. Assume, for example, that you have three CR1000s and some other dataloggers in your LoggerNet, PC400, or RTDAQ network map. When you send a *.CR1 program, this screen will show only the three CR1000 dataloggers.
Section 5. Program Creation and Editing CR9000(X)/CR5000 Datalogger Run Now Options The Run Now options and behavior for the CR9000(X) and CR5000 dataloggers are different from the CR1000, CR3000, and CR800 dataloggers. Below is a dialog box for a CR9000X datalogger. When Run Now is checked, the file will be sent with the Run Now attribute set. With this attribute, the program is compiled and run in the datalogger. All data tables on the CPU are erased.
Section 5. Program Creation and Editing Sending the Program To send the file and perform the associated functions you have selected in the screen, press the Send button. If LoggerNet, PC400, or RTDAQ is not running, an error message will appear indicating that there is no communications server currently running. If LoggerNet, PC400, or RTDAQ is running and the program compiles properly on the hardware, you will receive a message indicating that the program is now running on the datalogger.
Section 5. Program Creation and Editing Save as Default Template - Saves the comments and instructions in the active file as a template that will be used each time File | New is selected for that type of datalogger. Delete - When selected, a list of all dataloggers is displayed. Select a datalogger to open a dialog box containing a list of saved templates. A template can then be highlighted and deleted from disk. (Datalogger Types) - When a datalogger type is selected, a list of all templates is displayed.
Section 5. Program Creation and Editing 5.1.3.7 CRBasic Editor Edit Menu This menu item allows you to edit and manipulate the text currently being displayed in the Editor. Standard text editing functions such as Cut, Copy, Paste, Delete, Select All, Undo and Redo are found in this menu. 5.1.3.7.1 Other Options Create Compressed File – Creates a new file with a _str extension. All user comments and line spacing in the program are removed from the file.
Section 5. Program Creation and Editing The Vertical Spacing tab is used to set up the rules for the CRBasic Editor's Rebuild Indentation function (Edit | Rebuild Indentation). You can control whether blank lines are inserted before or after certain instructions, and how the CRBasic Editor will process multiple blank lines in the program. If Do Not Insert or Remove Any Blank Lines is selected, all other fields on this tab will be disabled.
Section 5. Program Creation and Editing The Syntax Highlighting tab sets up the appearance of different text elements in the program using different font styles and colors. You can customize the appearance of the text by giving normal text, keywords, comments, operators, numbers, strings, and parentheses each a different font style and color to make the program easier to read and edit. Text colors and styles can be disabled by clearing the Enable Syntax Highlighting check box.
Section 5. Program Creation and Editing Background Color - Displays a color selection dialog to set the color of the CRBasic program window. Wrap Text When Printing - When this option is selected, long lines that extend past the right margin will be wrapped to the next line. This option affects printing, as well as the Print Preview mode. A check mark will appear next to the option in the menu when it is selected.
Section 5. Program Creation and Editing 5.1.3.9.2 Constant Customization The Constant Customization feature allows you to define values for one or more constants in a program prior to performing a conditional compile (Compile | Conditional Compile and Save menu item). The constants can be set up with an edit box, a spin box field for selecting/entering a value, or with a list box. A step increase/decrease can be defined for the spin box, as well as maximum and minimum values.
Section 5. Program Creation and Editing The Constant Customization syntax may be best understood by looking at an example.
Section 5. Program Creation and Editing The constant SInterval is defined with a default value of 10, a maximum of 60 and a minimum of 5, with a step of 5 each time the up or down control is selected. The constant SUnits has a list box with sec and min; sec is the default. The constant Reps is defined with a default value of 1. It is an edit box, into which any value can be entered. The constant Number is defined with a default value of 0, a minimum of -100 and a maximum of 100.
Section 5. Program Creation and Editing 5.1.4 CRBasic Programming CRBasic is a programming language that has some similarities to a structured BASIC. There are special instructions for making measurements and for creating tables of output data. The results of all measurements are assigned variables (given names). Mathematical operations are written out much as they would be algebraically. This section provides a summary of a program, its syntax, structure, and sequence.
Section 5. Program Creation and Editing Program Set scan interval The program section defines the action of datalogging. The scan sets the interval for a series of measurements. Measurements Enter the measurements to make. Processing Enter any additional processing with the measurements. Call Data Table(s) The Data Table must be called to process output data. Initiate controls Check measurements and Initiate controls if necessary. NextScan Loop back (and wait if necessary) for the next scan.
Section 5. Program Creation and Editing As an example of Measurement Processing, to convert a thermocouple measurement from degrees Celsius to degrees Fahrenheit, you could use the following expression: TCTempF=TCTemp(1)*1.8+32 Logical Evaluation expressions could be used to determine the flow of a program: If TCTemp(1) > 100 Then Call Subroutine1 Else 'enter code for main program End If Many parameters will allow the entry of expressions.
Section 5. Program Creation and Editing Public Temp, RH, WindSp, WindDir, _ BatteryV, IntRH, IntTemp, RainTot, _ RainInt, Solar 5.1.4.6 Inserting Comments Into Program It is often useful to provide comments in your datalogger program so that when you review the program at a later date, you will know what each section of code does. Comments can be inserted into the program by preceding the text with a single quote.
Section 5. Program Creation and Editing 5.1.4.7 Example Program The following program will serve as a programming example in this section to illustrate the concepts and program structure. This is a program for a CR5000 datalogger. Note that other dataloggers may have slightly different parameters for some instructions.
Section 5. Program Creation and Editing The data table header may also have a row that lists units for the output values. The units must be declared for the datalogger to fill this row out (e.g., Units RefTemp = degC). The units are strictly for the user's documentation; the datalogger makes no checks on their accuracy.
Section 5. Program Creation and Editing The output processing instructions included in a data table declaration determine the values output in the table. The table must be called by the program using the CallTable (Tablename) instruction in order for the output processing to take. That is, each time a new measurement is made, the data table is called. When the table is called, the output processing instructions within the table process the current inputs.
Section 5. Program Creation and Editing The Scan instruction determines how frequently the measurements within the scan are made: Scan(Interval, Units, BufferOption, Count) Scan(1,MSEC,3,0) The Scan instruction has four parameters (the CR200 datalogger’s Scan instruction has only two). The Interval is the time between scans. Units are the time units for the interval. The BufferSize is the size (in the number of scans) of a buffer in RAM that holds the raw results of measurements.
Section 5. Program Creation and Editing TABLE 5.1-3. Synonyms for True and False Predefined Constant True (-1) False (0) Synonym High Low Synonym On Off Synonym Yes No Synonym Trigger Do Not Trigger Number ≠0 0 Digital port 5 Volts 0 Volts 5.1.4.11.2 Expression Evaluation Conditional tests require the datalogger to evaluate an expression and take one path if the expression is true and another if the expression is false.
Section 5. Program Creation and Editing 5.1.4.12 Flags Any variable can be used as a flag as far as logical tests in CRBasic are concerned. If the value of the variable is non-zero the flag is high. If the value of the variable is 0 the flag is low. LoggerNet, PC400, or RTDAQ looks for the variable array with the name Flag when the option to display flag status is selected from the Connect Screen.
Section 5. Program Creation and Editing DataTable(Name, TrigVar, Size) DataTable(Temp, TC(1)>100, 5000) Entering the trigger as the expression, TC(1)>100, will cause the trigger to be true and data to be stored whenever the temperature TC(1) is greater than 100. 5.1.4.13.
Section 5. Program Creation and Editing Tablename.record(1,n) = the record number of the record output n records ago. Tablename.output(1,1) = 1 if data were output to the table the last time the table was called, = 0 if data were not output. Tablename.
Section 5. Program Creation and Editing generate the program. Short Cut also generates a wiring diagram for connecting your sensors to the datalogger. Short Cut was designed to help the beginning datalogger programmer create datalogger programs quickly and easily. Short Cut effectively insulates the user from having to know the nuances of datalogger programming and the Edlog versus CRBasic programming languages.
Section 5. Program Creation and Editing 5.2.2.1 Step 1 – Create a New File or Open Existing File To begin creating a new program, press the New Program button. To open an existing program, press the Open Program button and select a file from the resulting browser window. 5.2.2.2 Step 2 – Select Datalogger and Specify Scan Interval Click the arrow next to Datalogger Model to display a list of Campbell Scientific dataloggers. Select the datalogger type.
Section 5. Program Creation and Editing If you are creating a program for a CR9000X, the CR9000X Configuration box will also appear on this screen. From this box, you indicate which CR9000X modules are inserted into which CR9000X slots. To add a module, select the module by clicking on it in the Available CR9000X Modules list, select the Slot by clicking on the slot number, then press the arrow key. To remove a module, select the slot containing it and then press the Remove Module button.
Section 5. Program Creation and Editing This dialog box will be displayed the very first time you create a program for a specific datalogger type; it will not be displayed thereafter. With each subsequent program you create, the integration you chose when the datalogger was initialized in Short Cut will be used. However, you can change the integration from the Program menu.
Section 5. Program Creation and Editing After making your selections, note that the title bar shows the datalogger type and scan interval. Once you have saved the file, the filename will replace “untitled.scw”. 5.2.2.3 Step 3 – Choose Sensors to Monitor In step 3, you tell Short Cut which sensors you’ll be measuring. Short Cut organizes sensors into application groups: Some major groups have subgroups. Double-clicking the Meteorological group folder shows several subgroups of meteorological sensors.
Section 5. Program Creation and Editing Measurement name Measurement units Notes specific to this sensor Note that this sensor not only offers a custom name field and units, but also allows you to correct for sea level, a common practice in measuring atmospheric pressure. In the middle of the screen, look over the notes (or refer to the Help for this sensor), for this sensor may require other sensors or have limitations.
Section 5.
Section 5. Program Creation and Editing Click on the Wiring tab of a sensor’s parameter form to show the wiring for the sensor (or the first sensor in a sensor group). Each wire’s caption/color is shown on the left side of the wire. The location where the wire will be connected to the device is shown on the right side (under the device). You can change a caption/color by clicking on the caption/color label. A wiring location can also be changed by clicking on the wiring location.
Section 5. Program Creation and Editing In addition to actual sensors, Short Cut provides functionality to perform various calculations and effect some simple control: Some of these calculations may require additional sensors, or sensor measurements stored in particular units. See the help for each calculation to determine the necessary inputs. Note that there is also a User Entered calculation available in the Calculations folder. With it you can enter your own custom calculation.
Section 5. Program Creation and Editing Short Cut provides you with a wiring diagram by clicking on Wiring Diagram on the left side of the Sensors window. In the example below, Short Cut was told to measure a CS105 Barometric Pressure sensor, an HMP45C Air Temperature and Relative Humidity sensor and a 05103 Wind Speed and Direction sensor. Each sensor was allocated the necessary terminals. Short Cut will not let you add more sensors than there are terminals on that datalogger or device.
Section 5. Program Creation and Editing Short Cut can also create programs for dataloggers using a variety of interface devices, including multiplexers and special interfaces for sensors. Add these devices by selecting them from the Devices folder in the Available Sensors and Devices tree.
Section 5. Program Creation and Editing 5.2.2.4 Step 4 – Setup Output Tables After selecting the sensors to be measured, you can choose what data to store from the outputs step: On the left, Short Cut will show the sensors you’ve added to be measured, with the measurement labels you’ve used. On the right is a multi-tabbed grid that shows the output tables.
Section 5. Program Creation and Editing Note that outputs for a sensor don’t have to be added in the same sequence as the measurement. You can even drag and drop the outputs to rearrange their order. Note also that multiple outputs can be added for any one sensor. For example, you may want to store the maximum and minimum air temperature as well as the average. NOTE Table-based dataloggers have a TableName field as opposed to an array ID.
Section 5. Program Creation and Editing The Advanced Output allows you to store data based on time, the state of a flag, the value of a measurement or a data event. Be cautious in using more than one check box, for the logic for the check boxes in the advanced mode are inclusive—that is, they must all be true in order for any output to be stored.
Section 5. Program Creation and Editing 5.2.2.5 Step 5 – Generate the Program in the Format Required by the Datalogger The Finish button completes the process. If you haven’t yet saved the program, Short Cut asks for a program name and offers the default directory within its program working directory (default is C:\Campbellsci\SCWin). Short Cut also displays a Results, Summary, and Advanced window: The Results tab provides information on the files that were created.
Section 5. Program Creation and Editing The Summary tab displays the information in the DEF file as described above. The Advanced tab (for CRBasic dataloggers) displays the CRBasic program that was generated. It includes a CRBasic Editor button which opens the program for editing in the CRBasic Editor. Note that any changes made to the generated program in the CRBasic Editor will not be reflected in Short Cut or future programs generated by Short Cut.
Section 5. Program Creation and Editing battery or loss of power condition. This may be useful when calculations are used to control devices. You may, for example, want to ensure that pumps or controls are off when a datalogger powers up so as to make the control decision based on a fresh measurement. See the datalogger manual for a full description of this feature. 5.2.3.
Section 5. Program Creation and Editing 5.2.3.6 Integration Some dataloggers have parameters available in their measurement instructions to provide integration for rejection of noise due to AC electrical signals. These parameters will be used by Short Cut if possible, but the frequency of this noise varies. In most of North America, the AC frequency is 60 Hz. However, in many countries the frequency is 50 Hz. If you know the frequency of this AC noise, you can select one or the other frequency.
Section 5. Program Creation and Editing 5.2.5 New Sensor Files Short Cut was designed with future flexibility in mind. Datalogger and sensor support is provided as individual files and not part of the SCWIN executable. As new dataloggers and sensors become available, new definition files will be created to add and modify the necessary features known to Short Cut. To update these files, you can download the latest version of Short Cut from the Campbell Scientific website: http://www.campbellsci.
Section 5. Program Creation and Editing files for both the CR5000 datalogger and the CR9000X (CR9032 CPU) datalogger. Creation of programs for the CR9000 datalogger (CR9031 CPU) is not supported. Use the RTDAQ Program Generator when you are familiar with the interface based on experience using the PC9000 software, or when you require detailed control over generated program parameters. 5.3.
Section 5. Program Creation and Editing The generator project type is given in the top left corner of the main generator screen and also in the title bar of the application. 5.3.3 Using the CR5000 or CR9000X Program Generator Upon opening an existing or new generator project, the main screen of the RTDAQ Program Generator application appears: You can access the functions of the CR5000 and CR9000X program generators by using the buttons that appear on the left side of the generator window.
Section 5. Program Creation and Editing Press the Save button to save the generator project to a file (*.GE9 for the CR9000X, *.GE5 for the CR5000) and also to create the CRBasic program based on the current generator’s settings (*.C9X for the CR9000X, *.CR5 for the CR5000). Use the Save and Send button to send a program generated from the current project to a datalogger defined in the main RTDAQ application. For more information about this process, see the section below, entitled Using Save and Send.
Section 5. Program Creation and Editing desired generator project and press Open. The generator window will be opened with your selected generator project loaded. NOTE Do not open a generated CRBasic program (*.C9X, *.CR5) into the program generator. Be sure to open a generator project file (*.GE9, *.GE5). 5.3.4.3 File | Save As Use File | Save As to save your current generator project (whether newly created or opened from an existing file) with a different name.
Section 5. Program Creation and Editing 5.3.4.6 File | Generator projects (*.GE5, *.GE9) which have been previously opened using the File | Open function will be listed at the bottom of the File menu to allow them to be opened again quickly in the future. 5.3.4.7 File | Exit Use File | Exit to end the RTDAQ Program Generator application.
Section 5. Program Creation and Editing 5.3.4.9 Edit | CR9000X Generator Options, Edit | CR5000 Generator Options You can find the Generator Options on the Edit menu for the particular kind of generator project you are currently using. Set the desired settings to be used by default when a program generator project is created or a CRBasic program is generated. Check the boxes next to the options that are desired or set the value of the drop-down box. Press Done to save the desired configuration.
Section 5. Program Creation and Editing When pressed, this button will save the current generator project, generate and save the associated CRBasic program code, and send that code to the datalogger you specify. 5.3.5.1 Download After you have selected Save and Send, you will see the Download dialog box similar to the one shown here: The Select the destination list shows all dataloggers configured within RTDAQ that can accept a program matching the extension of the current CRBasic program to be sent.
Section 5. Program Creation and Editing CR9000X’s and some other dataloggers in your RTDAQ Network Map. When you send a CR9000X program, this screen will show only the two CR9000X dataloggers. Any CR3000, CR1000, or CR5000 dataloggers will be excluded from the list, even when they are defined in the network map, because those dataloggers are not associated with CR9000X programs. 5.3.5.2 Run Options You may check the Run Now check box to run the program immediately after it has been sent to the datalogger.
Section 6. View Pro NOTE Although RTDAQ does not support the older “mixed-array” group of Campbell Scientific dataloggers (such as the CR10X, CR23X, and CR510), the Short Cut application included with RTDAQ is the same one included for use with LoggerNet and other Campbell Scientific support software. Because of this, the documentation included here contains references to mixed-array dataloggers. For most RTDAQ implementations these references can be ignored. 6.
Section 6. View Pro 6.2 The Toolbar Many of View Pro’s features can be accessed from the toolbar. The main View Pro toolbar includes the following icons: Open. Brings up a dialog box from which you can choose a data file to open. Copy. Copies selected text to the clipboard. Text is selected by dragging the mouse pointer across the desired selection. Multiple columns in a data file can be selected by dragging the mouse pointer across the column headings. Cascade.
Section 6. View Pro New XY Plot. Brings up an XY Plot window from which you can plot data values on the y-axis against another specified data value on the x-axis. New Rainflow Histogram. Brings up a Rainflow Histogram window from which you can view Rainflow Histogram data values. New FFT. Brings up an FFT window from which you can view FFT data values. Keep Selected Graph On Top.
Section 6. View Pro 6.3 Opening a File View Pro provides three ways to open a file. The one you use depends on the type of file being opened. Use File | Open to open a data file, File | Open as Text to open other types of files, or File | Open as Hex to view a binary or text file in hexadecimal format. A file that has been recently opened, can be quickly opened again by selecting it from the File | Recent Files list.
Section 6. View Pro 6.4.1 Selecting a Database The Select Database dialog box comes up the first time you select File | View LoggerNet Database Table. (After a database has been selected, this menu item will bring up the Select Table dialog box. To view a table from a different database, you will need to press the Change Database button on the Select Table dialog box.) View Pro supports SQL Server Compact, SQL Server, and MySQL databases.
Section 6. View Pro SQL Server To configure a connection to SQL Server you must select a SQL Server instance. The list of published SQL Server instances is shown in the Data Source combo box. You can also type into the Data Source combo box, because the desired server might not be published. Windows Authentication or SQL Server Authentication can be selected. Windows Authentication does not require a username and password, but rather uses Windows user accounts to authenticate valid users.
Section 6. View Pro MySQL The MySQL connection is an ODBC connection. You must use the Windows ODBC Data Source Administrator to configure the database connection. Currently only system data sources are supported and show in the Data Source combo box. The Login ID and Password may be optional. They will be set to blank in the connection string. It has been found that when set to blank, the login id and password configured in the system data source are used.
Section 6. View Pro 6.4.2 Selecting a Table The Select Table dialog box comes up once a database has been selected. Select the database table that you wish to view and then press the OK button. To select a table from a different database, press the Change Database button.
Section 6. View Pro 6.5 Importing a CSV File The File | Import CSV menu item can be used to import A CSV (Comma Separated Value) file into View Pro. When you select the File | Import CSV menu item, a browser will be displayed allowing you to browse to the CSV file to be imported. By default, only files with a .csv extension will be shown. If your file does not have a .csv extension, you will need to use the drop-down list box to select .txt files or all files. File The name of the file to be imported.
Section 6. View Pro the derived format can be corrected in this field. If the first column contains a timestamp, but does not have the common timestamp delimiters that allow View Pro to determine that it is a timestamp, you can manually check the Has Date/Time Column check box and then input the appropriate codes in the Derived Date/Time Format field to designate the format of the timestamp. If the first column of data does not contain a timestamp, leave the Has Date/Time Column check box unchecked.
Section 6. View Pro 6.6 Data View The initial display for data files in View Pro is as normal text in a grid format. The following figure shows the View Pro main screen with two data files open. The data file windows have been tiled horizontally. Array-based Data Files When opening a data file from an array-based datalogger, you will be given the option of loading an FSL (Final Storage Label) file. The FSL file will be used to provide column headings. (The *.
Section 6. View Pro Array-based data files do not contain timestamps. If an FSL file is associated with the data file, View Pro will try to extract timestamps from the appropriate columns. You can select Array Definitions from View Pro’s View menu to specify how the timestamps are created. Note that if no timestamps are used, data cannot be graphed. 6.6.1 Column Size When a data file is opened, the columns are autosized to fit the data.
Section 6. View Pro 6.6.7 Window Arrangement When multiple data files are opened, they are arranged so that the title bar of each window is visible and they cascade down and to the right starting from the upper left corner. Pressing the Cascade button or choosing Window | Cascade from the View Pro menu will return the data windows to this default arrangement at any time.
Section 6. View Pro Zoom Feature You can zoom in on a particular area of a graph by holding the left mouse button and dragging the mouse cursor from top-left to bottom-right over the area to be zoomed. Dragging the mouse cursor from bottom-right to top-left will undo the zoom. This can also be accomplished by pressing the Undo Zoom button on the toolbar. For a Rainflow Histogram or for a Histogram or FFT in 3D View, you can also zoom in and out by using the Page Down and Page Up buttons on your keyboard.
Section 6. View Pro 6.7.1.1 Selecting Data to be Graphed Data value(s) are added to a graph by clicking the column heading(s) in the data panel with a single mouse click. The selection will be highlighted and will automatically be added to the currently selected graph. (The currently selected graph is indicated on the main View Pro toolbar, and can be changed from the drop-down list.) Multiple columns can be added by holding the Ctrl key and dragging the mouse pointer over the column headings.
Section 6. View Pro 6.7.1.3 Scrolling You can scroll through the graph by using the scroll bar at the bottom of the graph window. Scrolling the graph will scroll the data on the data panel as well. Conversely, scrolling through a data panel will also scroll the currently selected graph. on the Graph scrolling can be disabled by pressing the Lock Scrolling icon toolbar. The icon will change to . Pressing the icon again will re-enable scrolling. When locked, the graph will not scroll.
Section 6. View Pro 6.7.1.5 Line Graph Toolbar The Line Graph toolbar includes the following icons: Statistics. Displays statistics for each trace including Average, Standard Deviation, Minimum and Maximum. Note that these statistics are for the data displayed in the graph. They are not statistics for the entire column(s) of data. Note that an asterisk next to a statistics value indicates that the trace contains one or more bad data values (i.e., NAN, INF, etc.).
Section 6. View Pro (Common) (Independent) Common/Independent Axes. When multiple data values are being graphed, determines whether they have common y-axes or independent y-axes. When using common y-axes, one scale will apply to all traces assigned to the left y-axis and one scale will apply to all traces assigned to the right y-axis. When using independent y-axes, the scale shown will apply only to the last selected trace assigned to that axis.
Section 6.
Section 6. View Pro 6.7.2.1 Selecting Data to be Viewed From a Histogram Screen When a Histogram screen is first opened with no histogram records selected in the data file, the Histogram Setup dialog box will open which allows you to set up the Histogram. The first option is a drop-down list that shows the available histograms in the currently selected data file. Select the histogram that you would like to view.
Section 6. View Pro NOTE All histogram records from the same histogram will have the same default name in the list. They can be distinguished by the colored boxes next to their names. Each box is the same color with which that histogram record is highlighted in the data file. It is also the color with which that histogram record is displayed if the “Use Selection Color” option is chosen in the Selection Properties dialog box.
Section 6. View Pro Show Table. Brings the main View Pro window in front of other windows, making the data file(s) visible. Show/Hide Gradient. A toggle button that turns on and off the gradient background of the Histogram. It may be useful to hide the gradient, when printing the Histogram. Modify Selection. Brings up the Histogram Setup dialog box from which you can change the options for the selection. Undo Zoom. Returns the Histogram to its original state after zooming. 6.7.
Section 6. View Pro 6.7.3.1 Selecting Data to be Plotted To select the data values to be plotted, highlight the column headings in the data file with a single mouse click. Each column that is selected in the data file, will be added to the XY Plot in both the X and Y drop-down lists. Select from the X and Y drop-down lists the values to be used for the X axis and Y axis, respectively. Additional series can be added to the XY Plot by pressing the New button.
Section 6. View Pro 6.7.4 Rainflow Histogram From the Rainflow Histogram screen, you can view rainflow histogram data. The Rainflow Histogram button on the toolbar will be enabled if there is at least one valid rainflow histogram in the currently selected data file. A Rainflow Histogram is a 3D representation based on the rainflow counting algorithm of Endo and Matsuishi which was first published in 1968.
Section 6. View Pro 6.7.4.1 Selecting Data to be View From a Rainflow Histogram Screen When a Rainflow Histogram screen is first opened with no rainflow histogram records selected in the data file, the Rainflow Histogram Setup dialog box will open which allows you to set up the Rainflow Histogram. The first option is a drop-down list that shows the available rainflow histograms in the currently selected data file. Select the rainflow histogram that you would like to view.
Section 6. View Pro histogram records can be selected before the Rainflow Histogram screen is opened with the Selected Graph set to None. When the Rainflow Histogram screen is opened, all selected rainflow histogram records will be listed on the left side of the Rainflow Histogram screen. A rainflow histogram record can then be displayed by clicking on it in the list.
Section 6. View Pro Show Table. Brings the main View Pro window in front of other windows, making the data file(s) visible. Show/Hide Gradient. A toggle button that turns on and off the gradient background of the Rainflow Histogram. It may be useful hide the gradient, when printing the Rainflow Histogram. Modify Selection. Brings up the Rainflow Histogram Setup dialog box from which you can change the options for the selection. Undo Zoom. Returns the Rainflow Histogram to its original state after zooming.
Section 6. View Pro 6.7.5 FFT From the FFT screen, you can view FFT data. The FFT button on the toolbar will be enabled if there is at least one valid FFT in the currently selected data file. 6-28 NOTE View Pro does not create FFT data from time series information. It only displays FFT data contained in a *.DAT file. FFT data in the *.DAT file is created by using the CRBasic FFT instruction in a CRBasic program Data Table. NOTE View Pro cannot display FFTs from a TOACI1 data file.
Section 6. View Pro 6.7.5.1 Selecting Data to be Graphed From an FFT Screen When an FFT screen is opened, a Fast Fourier Transform Setup dialog box will open which allows you to set up the FFT. The first option is a drop-down list that shows the available FFTs in the currently selected data file. Select the FFT that you would like to view. The second option allows you to choose which record of the FFT you would like to view initially.
Section 6. View Pro additional FFT records can be added to the FFT screen by selecting them in the data file as described above. NOTE All FFT records from the same FFT will have the same default name in the list. They can be distinguished by the colored boxes next to their names. Each box is the same color with which that FFT record is highlighted in the data file.
Section 6. View Pro FFT Options. Opens a dialog box from which you can set properties for the FFT including scaling, colors, margins, titles, etc. This dialog box can also be brought up by pressing the Options button. Show Table. Brings the main View Pro window in front of other windows, making the data file(s) visible. Show/Hide Gradient. A toggle button that turns on and off the gradient background of the FFT. It may be useful to hide the gradient, when printing the FFT. Modify Selection.
Section 6. View Pro The records included can be defined by initial and ending time, time span, initial and ending record, or record span. If any of the date/time or record number options are changed, the other options will automatically adjust to reflect the change. Note that changes to the records included will not be reflected in the data panel, until the Apply button is pressed. Copy Selection Copies selected text to the Windows clipboard.
Section 6. View Pro Goto Bookmark If the data panel contains one or more bookmarks, hovering over the Goto Bookmark menu item will bring up a list of the current bookmarks. Selecting a bookmark from the list will automatically move the data panel to that record. The shortcut Ctrl-n, where n is the number of the bookmark, can also be used to move the data file to the desired bookmark.
Section 6. View Pro 6.9.2 Printing Text To print numerical data, press the Print button or select File | Print from the menu. A dialog box will appear allowing you to choose the printer, print range, number of copies, etc. After setting the properties, press OK to print the data. or To preview your data before printing, press the Print Preview button select File | Print Preview from the menu. From Print Preview you can browse among the pages that will be printed and change the paper orientation if desired.
Section 7. Monitoring Data in Real-time RTDAQ provides extensive functionality for monitoring datalogger data in real-time. Multiple real-time windows can be opened to assist in data analysis tasks. 7.1 Using the Monitor Data Screen 7.1.1 Connect to Target Datalogger To begin monitoring data in real-time, ensure that you are connected to the datalogger whose data you wish to display.
Section 7. Monitoring Data in Real-time You may select the Monitor Data tab without connecting to a datalogger, and RTDAQ will automatically connect to the datalogger currently selected in the datalogger Network Map. The Monitor Data screen contains the Field Monitor, a built in numeric display window, as well as buttons used for opening other specialized real-time data displays. 7.1.2 Selecting Items for Display in the Monitor Data Screen To monitor numeric data in the main screen, press the Add button.
Section 7. Monitoring Data in Real-time You may list the items alphabetically by checking the List Alphabetically check box. When the List Alphabetically check box is not checked, the items will be listed in the order in which they were declared in the CRBasic datalogger program. Drag and drop your selection onto the grid of the Monitor Data screen, or after highlighting your selection, select the cell where the data value should appear, and press Paste.
Section 7. Monitoring Data in Real-time Hovering over the field name will display a pop-up indicating the source table, full field name, and current value of the display item. 7.1.4 Customizing the Display of Data in the Monitor Data Screen Numerous data items can be displayed simultaneously in the Monitor Data screen. You can adjust the separator between the field names and their current values by positioning the mouse over the dividing line and moving the line to the left or right.
Section 7. Monitoring Data in Real-time You may set options for all cells at once by right-clicking anywhere on the data display area, choosing Select All and then pressing the Options button. NOTE If no cells are selected when the Options button is pressed, only the Setup tab of the Field Monitor Options screen will be displayed. After customizing your Field Monitor Options you may save that configuration for easy retrieval at a later time from the Setup tab. 7.1.5.
Section 7. Monitoring Data in Real-time 7.1.5.2 Alarms Tab In the Alarms tab, you can set up alarm conditions. Check the Enable Alarms check box to make the alarm configuration active. Choose the High Alarm tab to set up an alarm when selected values in the grid become greater than a specified value. Enter the high threshold value in the Trigger Value box. Select a color for the cell background that will be displayed when the real-time value exceeds the value of the trigger.
Section 7. Monitoring Data in Real-time 7.1.5.3 Setup Tab In the Setup tab, you can configure the number of rows and columns to be displayed on the data grid. Press the Restore Default Configuration button to reconfigure the size of the grid to its default values. Press the Save Field Monitor Configuration button to save the current option settings for the Monitor Data window. Press the Load Field Monitor Configuration button to restore an option configuration state that has been previously saved. 7.1.
Section 7. Monitoring Data in Real-time You can open or select from multiple instances of these real-time screens by selecting the screen type from a drop-down list below the button. You can bring an open screen to the front or restore/maximize it by clicking the button again. For more information about each specialized data monitoring screen, see information given in later sections of this chapter. 7.
Section 7. Monitoring Data in Real-time window, any variables that are declared as boolean in the program will be displayed on the right side of the window. To return the Ports and Flags display to its original state, press the Defaults button. This will reset all labels to their original names, update the number of flags based on the currently running program, and remove any boolean values placed on the screen.
Section 7. Monitoring Data in Real-time Now you will see the Table Monitor window: You may create up to four Table Monitor windows in RTDAQ. After Table Monitor screens have been created, they can be brought to the front by using the drop-down list which becomes available on the Table Monitor button.
Section 7. Monitoring Data in Real-time 7.3.2 Displaying Tables on the Table Monitor Use the Select Table drop-down box to select the desired tables to be displayed. A list of tables available in the program currently running on the datalogger to which you are connected is shown. You may select up to three tables to be displayed, each in their own screen column.
Section 7. Monitoring Data in Real-time NOTE You can display the same table in more than one column of a single Table Monitor screen, or you can display the same table in multiple Table Monitor screens. In such cases, starting one column that displays the table with the Start button will start all of them. 7.3.2.2 Reset Table You can reset the table being displayed by pressing the Reset Table button.
Section 7. Monitoring Data in Real-time 7.3.2.4 Save | Load Configurations Right-click on any of the table displays to save a particular configuration of the Table Monitor screen, or retrieve settings for a configuration which was previously saved. 7.3.2.5 Saving Displayed Data to a File You can save the data being displayed instantaneously into a data file by using the Save to File check box individually for each table. This can be used to capture events of interest while they are being monitored.
Section 7. Monitoring Data in Real-time Choose the parent folder for the desired data file by pressing the Browse button. A folder within the chosen folder will be created using the Station Name of the datalogger for which data is being displayed. The data file will be named based on the name of the table and a timestamp representing the time when the data is first written to the file. The Save To File check box is automatically cleared each time the Stop button is pressed.
Section 7. Monitoring Data in Real-time Now you will see the Real Time Graph window: You may create multiple Graph windows in RTDAQ. After Graph screens have been created, they can be brought to the front by using the drop-down list that becomes available on the Graph button. You will also use this drop-down list to create Graph screens after at least one already exists, since pushing the Graph button at that point will bring the focus to an existing graph instead of creating a new one.
Section 7. Monitoring Data in Real-time 7.4.2 Adding Items for Display on the Graph Use the Add button to select the desired values to be graphed. The Add Selection screen appears for you to make your selections. Drag and drop the desired items into the Selected Fields area of the Graph window, or highlight the desired items, select the cell where the data value should appear, and press Paste. You may add one or more traces from same table, and also add traces from different tables.
Section 7. Monitoring Data in Real-time displays the Stop button in the same location when the Graph window is running. You can create a vertical line cursor on a stopped (i.e., paused) screen by double-clicking on the screen. If the Graph is running when you double-click, it will be stopped automatically. When the vertical cursor is moved around the screen, you can see the value for the current point in the Selected Fields data display area.
Section 7. Monitoring Data in Real-time 7.4.5 Zooming and Scaling the Graph Window You can zoom in on the graphical area of the RealTime Graph. Click and drag the mouse to define a rectangle that becomes the “zoomed to” display area after you release the mouse button. When you are zoomed in on the graph, the Undo Zoom button appears in the upper right corner of the display. Pressing this button will remove the zooming and return the graph to its original display configuration (zoom level).
Section 7. Monitoring Data in Real-time 7.4.6 Data Retrieval Methods used by the Graph Screen Choose whether to Graph All Data, Fill Graph Width, or graph only the Newest Records. If Graph All Data is selected, all data records will be collected and displayed in the graph. Multiple screens of uninterrupted data can be shown, but the display may fall behind real-time in faster applications. Eventually, after several screens of uninterrupted data, there may be a break in data.
Section 7. Monitoring Data in Real-time NOTE Care should be taken in choosing between these options when running a program with extremely fast data generation (i.e., several hundred records per second). As a general rule, Graph All Data should be used when looking at a large Graph Width (time span) with fast data generation. Fill Graph Width may be useful when looking at a smaller Graph Width with fast data generation. The best option will depend on your PC, datalogger, and datalogger program.
Section 7. Monitoring Data in Real-time Use the Drawing Mode section to decide how the graph will display data in its graphical area. When you choose the Strip Chart option (the default setting for the Graph window) the data will display across the area until the screen is full, and at that point the points on the screen will continuously shift back to make room for the newest points to show.
Section 7. Monitoring Data in Real-time You may choose the Print item to immediately send the current snapshot to the currently selected printer without pre-viewing it. The Clear, Fill and Stop, and Start/Stop items perform the same function as pressing the button (see descriptions given above). Select Save Configuration to save the current graph configuration (fields, options, etc.) to a file or Load Configuration to load a previously saved graph configuration.
Section 7. Monitoring Data in Real-time With the Scaling Option section you choose the method used for determining the maximum and minimum values on the current axis, as well as whether to use linear scaling (equal interval scaling) or logarithmic scaling. Maximum and minimum values can be chosen automatically depending on the data set currently displayed, or the user can specify what the maximum and minimum values should be.
Section 7. Monitoring Data in Real-time The Plotting Options section allows you to specify how the points of data will be drawn on the screen. Choose the Line Only option to display only lines on the graph that connect between the data points obtained from the datalogger. Choose the Points and Line option display both points and lines on the graph. Choose the Points Only option to display only the points obtained from the datalogger.
Section 7. Monitoring Data in Real-time 7.4.9.3 Visual Display Options Select the Visual Display tab to modify chart colors and configure the titles on the graph. The Chart Colors section allows you to set the color for the back wall of the graph, set the color of the Left Grid (scale), or set the color of the Right Grid. The Back Image field allows you to specify an image that will be used as the background for the graph. Select the Stretch check box to have the image stretched and fill the background.
Section 7. Monitoring Data in Real-time 7.4.9.4 Customizing the Traces on the Display 7.4.9.4.1 Individual Trace Options NOTE For the Trace tab to appear in the Graphing Options window, you must select an individual display field from the Selected Fields section of the main graph screen before pressing the Options button. You can also right-click on the individual field and choose Trace Options or press the Trace Options button .
Section 7. Monitoring Data in Real-time If you right-click on a field in the Selected Fields section of the Graph and choose Trace Options, a screen will appear like this: 7.4.9.4.2 Using Marks on the Graph You can select the Marks tab if you want markers to show on the graph and control how they are shown. Marks can contain information about a specific point, such as its value on the current y-axis or the timestamp that applies to that point. Check the Show Marks check box to use marks on the graph.
Section 7. Monitoring Data in Real-time 7.4.9.5 Using Saved Configurations Select the Save tab to load a previously saved configuration of the graph screen options, or to save the current option settings as a configuration to be retrieved at a later time. After you have used the available options in the graph screen for some time, you may find certain groups of settings which are useful to you again and again.
Section 7. Monitoring Data in Real-time 7.4.10 Accepting or Abandoning Changes to the Graph Options After setting the various options for the graph, press the Apply button to immediately put those changes into effect. The Options screen will not be closed, and the settings will be applied. Press the OK button if you would like to apply the settings and also exit the Options screen. Press Cancel if you would like to abandon any changes made to the settings since the screen was opened.
Section 7. Monitoring Data in Real-time 7.5.2 Similarity between the Real Time Graph and the Fast Graph The Fast Graph operates in a similar fashion to the Real Time Graph, except that it cannot display points on the lines it draws, and it will not attempt to draw lines or points that are redundant based on the current pixel resolution of the display screen. This increases the drawing speed of this screen, which may be needed for some high-speed applications.
Section 7. Monitoring Data in Real-time Now you will see the XY Plot window: You may create multiple XY Plot windows in RTDAQ. After XY Plot screens have been created, they can be brought to the front by using the drop-down list that becomes available on the XY Plot button. You can also use this dropdown list to create XY Plot screens after at least one already exists, since pushing the XY Plot button at that point will bring the focus to an existing plot instead of creating a new one.
Section 7. Monitoring Data in Real-time 7.6.2 Setting up the XY Plot for Display To set up values for display on the XY Plot, you can add one or more y-axis values and one x-axis value. The x-axis value will be used as the independent (horizontal) axis, and the y-axis values will be plotted with their values placed horizontally to match the x-axis value, and their actual values given as the y-axis values. 7.6.2.
Section 7. Monitoring Data in Real-time To remove a Y Axis Value after it has been added, highlight that measurement . by clicking on its name with the mouse and pressing the Delete button You can drag and drop a value to move it to another location on the Y Axis Values numeric display area. To add an X Axis Value to the graph, place a measurement into the numeric monitoring area labeled X-Axis Value. Only one measurement can be used for the x-axis since it represents the independent axis.
Section 7. Monitoring Data in Real-time The name of the measurement will appear, and the current value will be displayed next to it after the XY Plot window has been started. 7.6.2.2 Number of Points per Field You may set the Number of Points per Field displayed on the plot. This number represents how many points (x-y ordered pairs) will be placed onto the plot before each new point causes the oldest point to be removed.
Section 7. Monitoring Data in Real-time 7.6.2.3 Right-Click Functionality You can also access functionality by right-clicking on a selected y-value trace to obtain a menu. The Add Y function operates the same as pressing the Add . The Add X function operates the same as pressing the Add X button Value button. The Delete item will remove the currently selected y-value. Select All will select all y-values. Delete All will remove all y-values as currently configured.
Section 7. Monitoring Data in Real-time 7.6.3 Using the Control Buttons Once the proper y-axis and x-axis values have been selected, and the number of points per field has been properly set, begin displaying the x-y plot points by pressing the Start button. The points will begin displaying in the graphical area of the screen.
Section 7. Monitoring Data in Real-time In addition to the actual points, the scaling is also shown for the x and y axes. The vertical scale on the left corresponds to the default y-axis, and the horizontal scale at the bottom corresponds to the x-axis. A y-axis can also be shown to the right of the points, if the graph is configured that way.
Section 7. Monitoring Data in Real-time To clear the contents of the graphical x-y plot area while it is either stopped or started, press the Clear button. If the # Points per Field value is set to a very large number, and the measurement rate of the datalogger is very fast (a period faster than 1 msec, for example), the ability of the plot to display data in real-time may be reduced. This is because points are displayed on the XY Plot contiguously as received in time order from the datalogger.
Section 7.
Section 7. Monitoring Data in Real-time 7.6.4 Using the Graphical Display Area of the XY Plot You can right-click on the graphical display area of the XY Plot screen to access special functions. Use the Save As option to save the current graph to a windows bitmap file (*.bmp) or windows metafile (*.wmf) format. Use the Copy function to copy the current graph to the Windows clipboard. This copied bitmap can then be pasted into other programs. Select the Options function to change the Graphing Options.
Section 7. Monitoring Data in Real-time (An example of an XY Plot screen with its controls hidden.) Choose the Hide Controls option to temporarily remove all interface elements (buttons and display controls) used to configure the XY Plot window. This removes the Y Axis Values, X Axis Value, #of Points Per Field setting, and the Options, Clear, Sync Data and Start/Stop buttons. This will give more room on the screen for viewing the graphical display area.
Section 7. Monitoring Data in Real-time 7.6.6 Using the Special Options of the XY Plot Press the Options button to access the special options for the operation of the XY Plot. The Graphing Options screen will appear with the following main tabs: Scaling, Data Display, Visual Display, and Save. If one or more y-axis values are currently selected, a Trace tab will also be available, which applies only to the selected y-axis value(s).
Section 7. Monitoring Data in Real-time 7.6.6.1 Scaling Tab Use the Scaling tab to control how the X and Y axes are scaled for the display of data in the graphical area. You may select the Y-Axis tab to configure the y-axis used by default on the left side of the XY Plot’s graphical area. You may select the Right Y-Axis tab to configure the y-axis used on the right side of the XY Plot’s graphical area (if it is used). You may select the X-Axis tab to configure the x-axis used in the graphical area.
Section 7. Monitoring Data in Real-time 7.6.6.2 Data Display Tab Use the Data Display tab to control the plotting and precision schemes of the graphical display area. Use the Plotting Options to select how the points should be graphed on the screen. To see only points, choose Points Only. To draw lines between timeadjacent points, use Line Only, and to draw both points and lines, choose Points and Line.
Section 7. Monitoring Data in Real-time 7.6.6.3 Visual Display Tab Select the Visual Display tab to control various visual aspects of the XY Plot. Colors for parts of the display can be selected, including the background color of the display area, the color of the grid corresponding to the left y-axis, and the color of the grid corresponding to the right y-axis. You may also specify an image to be used as the background for the plot and whether the image is stretched to fill the background.
Section 7. Monitoring Data in Real-time Use the Marks tab to control whether or not each point will be marked in the graphical display area. Check the Show Marks check box to turn on marking. The Round Frame check box controls whether or not the pop-up box used to mark the points will have rounded corners. The Transparent box is used to control whether or not the marks will show up in a box on the display. When they are transparent, only the values are shown in the vicinity of the points.
Section 7. Monitoring Data in Real-time The Draw Every setting indicates how many points will actually have a mark as they appear on the screen. If the setting is set to 5, then only every fifth point will have a mark as it appears on the XY Plot. The Color option controls the background color of the box used to show the mark. This is only used when the Transparent setting is not checked. The Style check box selects what data will be displayed in the marking. The y-value, x-value or both can be displayed.
Section 7. Monitoring Data in Real-time 7.6.7 Applying Changes to the XY Plot Screen After you have set up the Graphing Options to the desired configuration, press the Apply button to save your changes for the current session of RTDAQ. The Graphing Options screen will remain open for further review and investigation of settings. Press OK to apply the changes and close the Options screen.
Section 7. Monitoring Data in Real-time monitor. This includes the use of the Histogram output instruction in one of the tables of the CRBasic program. 7.7.2 Displaying Histograms Connect to the desired logger in RTDAQ by clicking on the datalogger’s icon and pressing Connect. Now choose the Monitor Data tab to make the realtime displays available, and choose the FFT/Histo button. Now you will see the FFT/Histogram display window: You may create multiple histogram windows in RTDAQ.
Section 7. Monitoring Data in Real-time For more information about configuring the histogram window, see the section entitled: Configuration of FFT and Histogram windows later in this chapter. 7.8 Fast Fourier Transform Spectra RTDAQ can display Fast Fourier Transform spectra (FFT spectra) that have been created by the datalogger. The display will be updated as fast as new records are received from the datalogger. This often results in a real-time response.
Section 7. Monitoring Data in Real-time outputs, or in vector form (i.e., dual-valued outputs; two values per frequency range), such as Real-Imaginary or Amplitude-Phase output pairs. Campbell Scientific dataloggers can take a selected number of sampled points in the time domain and calculate the FFT spectrum for that set of points and store that spectrum into a table record. The number of sampled points in the time domain must be an even power of 2 (such as 32, 64, 128 and so on up to 65536).
Section 7. Monitoring Data in Real-time Now you will see the FFT/Histogram display window: You may create multiple FFT windows in RTDAQ. After FFT screens have been created, they can be brought to the front by using the drop-down list that becomes available on the FFT/Histo button. You will also use this drop-down list to create FFT screens after at least one already exists, since pushing the FFT button at that point will bring the focus to an existing FFT window instead of creating a new one.
Section 7. Monitoring Data in Real-time 7.9.1 Moving and Resizing the FFT/Histo Window The FFT/Histogram screen can be moved by dragging the title bar. You can resize an FFT/Histogram screen as desired by dragging the window corners. You can also maximize, restore, and minimize the screen using the standard buttons in the upper-right corner of the window, or by clicking on the window’s icon in the upper-left corner. When minimized, the FFT/Histogram screen shows as an icon on the task bar.
Section 7. Monitoring Data in Real-time 7.9.3 Using the Buttons Press the Start button to begin graphing the spectra or histograms from the datalogger. The FFT/Histogram screen displays data from the datalogger as quickly as it can. Spectra or histograms will be displayed in the graphical area of the FFT/Histogram screen. Press the Stop button to discontinue retrieving and graphing data.
Section 7. Monitoring Data in Real-time 7.9.4 3D View Select the 3D View check box if you would like to show a time history of FFT spectra or histograms on the screen. The Number of Plots value can be set to choose how many records will be shown on the screen at the same time. The newest record is shown at the front of the display with the oldest record at the back.
Section 7. Monitoring Data in Real-time Use the Zoom scroll bar to adjust the zoom level of the entire display when the window is in the 3D View mode. This will help move the FFT or histogram display and grid farther away or closer within the apparent view area, enabling labels to show more clearly or to be fully visible. The X-Rotation and Y-Rotation scroll bars are also enabled while in the 3D View mode.
Section 7. Monitoring Data in Real-time 7.9.5 X-Axis Mode The X-Axis Mode box allows you to set up how the frequency domain of the spectrum or the value ranges of the histogram bins will be represented on the display. Choose the Show Values option to show a frequency scale (in units of Hertz (i.e. Hz or cycles per second for FFT spectra, and in a measurement’s units for a histogram). Some of the locations along the x-axis will then have their values displayed, as space permits.
Section 7. Monitoring Data in Real-time 7.9.6 Zooming in on the Spectrum or Histogram You can zoom directly in on a particular location of the graph by clicking in the graphical display area and drawing a box. When you release the mouse button, the area within the box will become the full display area on the FFT display. Press the Undo Zoom button in the top right corner of the graph to return to the full scale display. 7.9.
Section 7. Monitoring Data in Real-time NOTE If the FFT/Histogram screen is in the “started” state when you choose Print Preview, the current snapshot will be displayed for printing and the display will continue to display newer data in the background. You may choose the Print item to immediately send the current snapshot to the selected printer without pre-viewing it.
Section 7. Monitoring Data in Real-time 7.9.8 Setting the Options for the FFT/Histogram Screen Set the options for the current FFT/Histogram screen by pressing the Options button, or by selecting Options from a right-click menu. The Graphing Options screen appears. 7.9.8.1 Scaling the Axes When data is displayed in the FFT/Histogram window, a scale is also displayed showing various values for frequency levels on the screen. You can control the y-axis scale on the left side of the graph.
Section 7. Monitoring Data in Real-time 7.9.8.2 Data Display Options Select the Data Display tab adjust the FFT/Histogram plotting options. The Plotting Options section allows you to specify how the data values will be drawn on the screen. Choose the Line Only option to display only lines on the display which connect between the data points obtained from the datalogger. Choose the Points and Line option to display both points and lines on the display.
Section 7. Monitoring Data in Real-time 7.9.8.3 Visual Display Options Select the Visual Display tab to modify chart colors and configure the titles on the spectrum or histogram display. The Chart Colors options allow you to set the color for the back wall of the FFT/Histogram display, set the color of the left grid (scale), or put the display into the Color Each Bin mode.
Section 7. Monitoring Data in Real-time 7.9.8.4 Individual Trace Options The Trace options are a tab on the main Options dialog box. They can also be opened by pressing the Trace Options button. 7.9.8.4.1 Display Tab The Trace tab on the Graphing Options window has two subtabs: Display and Marks. The Display tab is used to set the color used for the bins or lines on the FFT/Histogram display when Color Each Bin is not selected.
Section 7. Monitoring Data in Real-time 7.9.8.5 Using Saved Configurations Select the Save tab to load a previously saved configuration of the FFT/Histogram screen options, or to save the current option settings as a configuration to be retrieved at a later time.
Section 7. Monitoring Data in Real-time After you have used the available options in the FFT/Histogram options screen for some time, you may find certain groups of settings that are useful to you again and again. To facilitate the easy recall of such configurations, you may save all of the current option screen selections in a configuration file.
Section 7. Monitoring Data in Real-time 7.10 Rainflow Histogram Monitoring RTDAQ can display rainflow histograms that have been created by the datalogger. The display will be updated as quickly as data is received from the datalogger. For this to function properly, there must be a Rainflow output instruction defined in the CRBasic program that is running on the datalogger to which RTDAQ is connected. NOTE RTDAQ does not create rainflow histograms from time series measurements.
Section 7. Monitoring Data in Real-time Now you will see the Rainflow histogram display window: You can create multiple Rainflow windows in RTDAQ. After Rainflow screens have been created, they can be brought to the front by using the dropdown list that becomes available on the Rainflow button.
Section 7. Monitoring Data in Real-time 7.10.3 Movement and Resizing of the Rainflow Window The Rainflow screen can be moved by dragging the title bar. You can resize a Rainflow screen as desired by dragging the window corners. You can also maximize, restore and minimize the screen using the standard buttons in the upper-right corner of the window, or by clicking on the window’s icon in the upper-left corner. When minimized, the Rainflow screen shows as an icon on the Windows task bar.
Section 7. Monitoring Data in Real-time 7.10.5 Using the Buttons and Controls Press the Start button to begin graphing the histograms from the datalogger. RTDAQ retrieves data as quickly as it can from the datalogger. Histograms will be displayed in the graphical area of the Rainflow screen. Press the Stop button to discontinue retrieving and graphing data. The Rainflow window displays the Start button when the window is stopped, and displays the Stop button in the same location when the window is running.
Section 7. Monitoring Data in Real-time Check the Orthogonal check box if you would like to show an orthogonal view of the 3-D histogram. Then enter the desired angle of the 3D effect. Note that when Orthogonal mode is selected, no scroll bars are available to rotate the graph. Enter the desired Graph Depth percentage for the 3D effect. Use one for no graph depth and 100 for the maximum graph depth.
Section 7. Monitoring Data in Real-time Use the Zoom scroll bar to adjust the zoom level of the entire display. This will help move the rainflow display and grid farther away or closer within the apparent view area, enabling labels to show more clearly or to be fully visible. The X-Rotation and Y-Rotation scroll bars are also active along the left and bottom parts of the display. By scrolling these bars you can adjust the horizontal or vertical display angle for the 3D display.
Section 7. Monitoring Data in Real-time 7.10.6 X-Axis Mode The X-Axis Mode box allows you to set up how the amplitude bins of the histogram will be represented on the display. Choose the Show Values option to show the values for the Amplitude Bins. Only some of the locations along the x-axis may have their values displayed, as space permits. Choose the View Bins option to have the individual bins labeled with their unique order number. If space does not permit, only some of the bin numbers will be shown.
Section 7. Monitoring Data in Real-time 7.10.8 Save and Print Options When you right-click on the graph, a short cut menu is displayed from which you can access further options. Use the Save As option to save the current state of the display to a windows bitmap file (*.bmp) or windows metafile (*.wmf) format. Use the Copy function to copy the current display state as a graphical object to the Windows clipboard. This facilitates pasting the graphic into other programs.
Section 7. Monitoring Data in Real-time Select Save Configuration to save the current rainflow configuration (table, bin, options, etc.) to a file or Load Configuration to load a previously saved configuration. (An example of a Rainflow screen with its controls hidden.) Choose the Hide Controls option to temporarily remove all of the controls used to configure the Rainflow graph, including the Options, Clear and Start/Stop buttons. This will give more room on the screen for viewing the graph.
Section 7. Monitoring Data in Real-time 7.10.9 Setting the Options for the Rainflow Screen Set the options for the current Rainflow screen by pressing the Options button, or by selecting Options from a right-click menu. The Graphing Options screen appears. 7.10.9.1 Scaling the Axes When data is displayed on the Rainflow window, a scale is also displayed showing various values for bins on the screen. You can control the y-axis scale on the left side of the graph.
Section 7. Monitoring Data in Real-time 7.10.9.2 Visual Display Options Select the Visual Display tab to modify chart colors and configure the titles on the rainflow histogram display. The Chart Colors section allows you to set the color for the back wall of the Rainflow display, set the color of the left grid (scale), or put the display into the Color Each Bin mode.
Section 7. Monitoring Data in Real-time 7.10.9.3 Trace Options The Trace options are a tab on the main options dialog box. They can also be opened by pressing the Trace Options button. The Trace tab on the Graphing Options window has two subtabs: Display and Marks. The Display tab is used to set the color used for the bins on the Rainflow display. Use the Line Width setting to select the width of the line used to outline the bars showing bin values.
Section 7. Monitoring Data in Real-time 7.10.9.4 Using Saved Configurations Select the Save tab to load a previously saved configuration of the Rainflow screen options, or to save the current option settings as a configuration to be retrieved at a later time.
Section 7. Monitoring Data in Real-time After you have used the available options in the Rainflow options screen for some time, you may find certain groups of settings which are useful to you again and again. To facilitate the easy recall of such configurations, you can save all of the current option screen selections together into a configuration file.
Section 7. Monitoring Data in Real-time 7.11 Saving and Loading Configurations RTDAQ provides multiple options for customizing the functionality and operation of the software. You can save many of these custom options into a configuration file. These configuration files are stored on the computer and can be used as needed to re-load specific customizations.
Section 7. Monitoring Data in Real-time Except for two real-time data monitor screens, the configuration file management is located on the Save tab of the Options screen. For example, after opening a Graph screen, press the Options button. Now select the Save tab, and you will see two buttons, one called Save Configuration and one called Load Configuration. The basic process for using the saved configurations in a particular screen is as follows: (1) Open up the screen you wish to configure.
Section 7. Monitoring Data in Real-time 7.11.3 Using Configurations in the Table Monitors When using the Table Monitor, you can access the Save and Load functionality by right-clicking on the grid display: 7.11.4 Saving and Loading Global Configuration Files You can group together the configuration options of multiple screens by saving and loading global (i.e., master) configuration files. To do this, first connect to the datalogger for which you want to use a global configuration file.
Section 8. Real-Time Monitoring and Control Software NOTE Although RTDAQ only supports single datalogger projects in RTMC, the documentation included here applies to RTMC in all Campbell Scientific software products. Therefore, any references to multi-datalogger projects may be ignored for RTDAQ implementations. The Real-Time Monitoring and Control (RTMC) software provides the ability to create and run graphical screens to display real-time data as RTDAQ collects it from a datalogger.
Section 8. Real-Time Monitoring and Control Software Project Component List - The panel on the left shows the hierarchy of the display components and how they are associated with each other. Every component of the display screen is shown in this list and it provides a shortcut to get to any graphical component. Project Workspace - The middle panel is the display screen workspace. The graphic components are placed in the workspace, as they should appear on the final display.
Section 8. Real-Time Monitoring and Control Software used as well; these should be placed in the media library directory to make them available for RTMC's use. 8.1.1 The RTMC Workspace The RTMC workspace is a container for holding one or more display screens. As new display screens are added (Project | Add New Screen) they appear as tabs in the project. The size of the workspace (and the resulting run-time window) can be changed by selecting Project | Configure WorkSpace. 8.1.
Section 8. Real-Time Monitoring and Control Software selected when a component is first placed in the work area (and OK has not been pressed), the display component will be removed from the screen. Available Components The following is an overview of the display components available. The online help has detailed information about each of the components and their properties. Pointer returns the cursor to a normal selection tool. Status Bar depicts the selected data value as a single vertical bar.
Section 8. Real-Time Monitoring and Control Software SetPoint depicts the selected data value as a numeric value, text string, or Boolean. A data value can also be set to a new value by double-clicking the component and entering a new value in the resulting dialog box. Gauge displays the selected data value on a gauge. Table Display displays the data from a datalogger table in a row and column format.
Section 8. Real-Time Monitoring and Control Software 8.1.4.2 Edit Menu Cut/Copy/Paste are standard editing operations to take selected objects to an internal clipboard and paste back into RTMC. NOTE Cut/Copy does not go to the Windows clipboard so these objects are not available to paste into other applications. Undo cancels the last change made to the project. Redo repeats the change that was just undone. Select All selects all of the components in the workspace.
Section 8. Real-Time Monitoring and Control Software project. In this mode, you must use the right-click menus to add components and perform other functions available from RTMC’s toolbar. Press the Esc key to exit this mode. Show Project Tree hides or displays the RTMC Project Tree (left pane of the default window). Show Toolbox hides or displays the RTMC Component Toolbox.
Section 8. Real-Time Monitoring and Control Software Rename Screen brings up a dialog to change the name of the current screen. This is the name that appears on the screen tab in run-time mode. Paste places a copy of the RTMC clipboard content on the active screen. Insert New brings up a submenu allowing you select one of the components to insert on the screen. When the component is added to the screen the Properties window for the new component will come up. 8.1.4.
Section 8. Real-Time Monitoring and Control Software components by using the cursor to click and drag a bounding box around the desired components. The components can also be selected by selecting the first component and then selecting the other components while holding down the key. The last component is identified by dark blue handles and by dark blue highlighting in the Project Tree.
Section 8. Real-Time Monitoring and Control Software the mathematical expression after the defined data value. Using the above example, if the data value is defined as “Server:CR5000.TempData.Temp1” (“Source:datalogger.table.variable”), you would enter “Server:CR5000.TempData.Temp1” * 1.8 + 32 to convert the temperature reading from degrees Celsius to degrees Fahrenheit.
Section 8. Real-Time Monitoring and Control Software 1000.MyTable.Value"),30*nsecPerSec,0)ValueAtTime("Server:CR1000.MyTable.Value",TimeStamp("Server:CR1000. MyTable.Value"),60*nsecPerSec,0)))>10,1,0) can be replaced by: Alias(X,"Server:CR1000.MyTable.
Section 8. Real-Time Monitoring and Control Software NOTE Spaces must be used to delimit the predefined constants and functions. Operators allow but do not require spaces. NOTE An expression can include data values from multiple dataloggers. 8.1.5.1 Operators Operator Description () Prioritizes parts of an expression within the larger expression.
Section 8. Real-Time Monitoring and Control Software 8.1.5.3 Predefined Constants Constant Description e 2.718282 PI 3.141593 True -1 False 0 NOPLOT NAN NAN NAN INF INF 8.1.5.4 Predefined Time Constants These predefined time constants can be useful as a parameter for the Functions with State, where the interval parameter must be specified in nanoseconds.
Section 8. Real-Time Monitoring and Control Software 8-14 Function Description ATN2(y,x) Returns the arctangent of y/x. CEILING(x) Rounds a number up to an integer value. COS(x) Returns the cosine of a number. COSH(x) Returns the hyperbolic cosine of a number. CSGN(x) Changes the sign of a number by multiplying by -1.0. EXP(x) Returns e raised to the x power. FIX(x) Returns the integer portion of a number.
Section 8. Real-Time Monitoring and Control Software Function Description SINH(x) Returns the hyperbolic sine of a number. SQR(x) Returns the square root of a number. TAN(x) Returns the tangent of an angle. TANH(x) Returns the hyperbolic tangent of a number. 8.1.5.6 Logical Functions The following functions perform logical operations. Function Description (x)AND(y) Performs a logical conjunction on two numbers. (x)EQV(y) Performs a logical equivalence on two numbers.
Section 8. Real-Time Monitoring and Control Software Function Description Right Returns a substring that is a defined number of characters from the right side of the original string. RTrim Returns a copy of a string with no trailing spaces. Space Returns a string value that is filled with a defined number of spaces StrComp Compares two strings by subtracting the characters in one string from the characters in another. StrReverse Returns a copy of a string with the characters in reverse order.
Section 8. Real-Time Monitoring and Control Software Function Description StartAtOffsetFromNewest Attempts to start processing with the record at the specified offset back from the newest record in the table. StartAtRecord Attempts to start processing at the specified file mark and record number. If the specified record cannot be located, it starts processing at the oldest record in the source table. StartAtTime Attempts to start processing at the record that is closest to the specified timestamp.
Section 8. Real-Time Monitoring and Control Software Function Description MinRun Returns the minimum of all values that it has considered. MinRunOverTime Returns the minimum of all values whose timestamps are greater than the newest timestamp minus the specified interval. MinRunOverTimeWithReset Returns the minimum of all values since the function was reset.
Section 8. Real-Time Monitoring and Control Software When the run-time display screen is started, the display components will have a red exclamation point in the upper right corner until data is received from RTDAQ. If data is not displayed, check to see that you are connected to the proper datalogger. Once a project file has been created and saved, the display screen can be run without starting the RTMC Development application.
Section 8.
Section 9. Calibration and Zeroing 9.1 Calibration Essentials 9.1.1 Definition of Calibration Calibration, in general, refers to actions taken on a measurement system to increase its accuracy. This is usually done by matching the system’s outputs to known, “control” values in order to increase confidence in the measurement of future unknowns.
Section 9. Calibration and Zeroing 9.2 Writing Calibration Programs with the CRBasic Editor 9.2.1 The FieldCal Instruction If you wish to make measurements that will be calibrated as discussed above, you should use the FieldCal instruction within the CRBasic program. When the program is running in the datalogger, you can use the RTDAQ Calibration Wizard to perform the actual calibrations (in real-time) on the sensors that were previously designated for calibration.
Section 9. Calibration and Zeroing *.cal file), use the SampleFieldCal table output instruction with the NewFieldCal system variable as the trigger. For more information about how to use these instructions, refer to the FieldCal instruction topic of your datalogger manual, or use the online help topic for FieldCal within the CRBasic Editor. 9.2.
Section 9. Calibration and Zeroing NOTE Short Cut will not generate code to trigger calibration based on flags. That must be done manually in the CRBasic program or using the Program Generator for the CR5000 or CR9000X. 9.3.2 Offset Calibration Offset Calibration is the act of placing a sensor into a state where the output condition is known to be a certain value and then changing the measurement’s offset variable so that the sensor output reads as exactly that value.
Section 9. Calibration and Zeroing scale (5 lbs), this is the first condition in which the scale should give a “known” reading for its output. The calibration is triggered, the datalogger is informed of the value of the known weight, and the measurement is read. The datalogger then notifies the user that it is ready to measure the second point. The second known weight is placed on the scale (15 lbs), and this is the second condition in which the scale should give a known reading for its output.
Section 9. Calibration and Zeroing variables would be used after the FieldCal instruction in the CRBasic program to ensure that regular measurements return a calibrated value. To perform a zero basis point calibration, use an argument of 4 (the number four) for the calibration type in the FieldCal instruction of your CRBasic program.
Section 9. Calibration and Zeroing The following values of the mode variable are used to initiate a calibration process: NOTE 1 Start the calibration, OR start the first point of a two point calibration 4 Start the second point of a two point calibration For Zeroing and Offset calibration, a mode value of 4 is never used. The entire calibration process is initiated with the mode value being set to 1.
Section 9. Calibration and Zeroing b. A number less than 0 indicates that the calibration process encountered an error. Resolve the error before proceeding with the calibration then set the mode value to zero for a fresh start. 2. Place the sensor into the first known point condition. 3. Indicate the known value of the first point by changing the “known value” variable to that value. 4. Set the mode variable to 1 to initiate the first part of the calibration process. 5.
Section 9. Calibration and Zeroing 9.6 Using the Calibration Wizard with Running Programs The RTDAQ Calibration Wizard provides an easy to use interface which steps the user through the calibration process described above. By using simple screens to gather information, the proper changes to the mode variable and known measurements are performed automatically by the Wizard. The user only needs to set the sensors to the known value(s), and provide a few required inputs to the Wizard.
Section 9. Calibration and Zeroing The Introduction screen for the Wizard will appear. Review the instructions and press Next. Now select the kind of calibration you wish to perform, which in this case is Multiplier and Offset, and press Next. Now select which sensor it is that you wish to calibrate and press Next. You can select an entire array, or any single element of that array, as well as scalar (single-valued) variables. Any items that have been aliased (i.e.
Section 9. Calibration and Zeroing If the FieldCal’s Average parameter is a variable, then the next window will be displayed. Enter the number of measurements to be averaged for each step of the calibration process and press Next.
Section 9. Calibration and Zeroing The currently measured value for the sensor will be displayed in the next screen. Now place the sensor into the first known condition, and enter that known value into the First calibrated value box. Press Set First Value. Wait for the calibration process to measure the first value. The word Calibrating will be visible in the Current Value box until that process is complete.
Section 9. Calibration and Zeroing After the multiplier and offset have been calculated and set, the ending screen of the Wizard appears. You can conclude the calibration, or return to the starting point to perform more calibrations of the same or different sensors. 9.6.3 Using the Wizard to Perform Zeroing Calibrations In the Wizard, select Zero for the type of calibration.
Section 9. Calibration and Zeroing Select the sensor you wish to calibrate, press Next. If the variable is configured as an array of sensors, you may select an individual item to calibrate only that element, or you can select the entire array. Now you can monitor the reading on the sensor to be calibrated. Set the sensor to the zero condition, and press Calibrate. The Current Value box will be yellow during the calibration process.
Section 9. Calibration and Zeroing 9.6.4 Using the Wizard to Perform Offset Calibrations In the Wizard, select Offset for the type of calibration. Select the sensor you wish to calibrate, press Next.
Section 9. Calibration and Zeroing Now you can view the current reading on the sensor to be calibrated. Set the sensor to the known value (“calibrate to” value). Enter that value into the Enter Calibrated Value box. Press Calibrate. The current value will show Calibrating until the process is complete. You will then have the opportunity to press Finish, or press Previous to return and calibrate more sensors. 9.
Section 10. Utilities CardConvert is a utility that is used to quickly read and convert binary datalogger data that is retrieved from a compact flash or a PCMCIA card. The binary data can also be a file already saved to the user's PC. The binary data is converted to another format (such as TOA5) and saved on the user's PC. The Device Configuration Utility, or DevConfig, is a utility for setting up datalogger and communication peripherals for use in a datalogger network.
Section 10. Utilities formats and filemarks). For instance, the default name for a table called MyData stored in TOA5 format would be TOA5_MyData.dat. The destination directory or filename for a converted file can be changed on an individual file basis. Click on the row for the file that you wish to change. It will be highlighted. Select Options | Change Output File from the CardConvert menu, and browse for or type in a new path and/or filename.
Section 10. Utilities If an array ID is desired, select the Include Array ID check box and enter a value into the field. The value can range from 1 to 1023. The Array ID will be the first value in the array of data. Select the appropriate timestamp options for the type of timestamp to write to the file. Each time element will be output as a separate data value in the array and the data values will be separated by a comma. Selecting Year will output the year represented by four digits, YYYY (e.g., 2009).
Section 10. Utilities to determine the time frame for the data that goes into each file. Note that the Start Date and Time are not used to specify the actual time and date to begin processing the file; rather, they are used as a reference for the file interval. Processing always starts at the beginning of the file. When Use Filemarks, Use Removemarks, or Use Time is selected, the Create New Filenames option is disabled. New file names will always be created.
Section 10. Utilities Store Time Stamp - The time stamp can be omitted from the file by clearing the Store Time Stamp check box. 10.1.3 Converting the File Once the file and conversion settings are selected, press the Start Conversion button. CardConvert will begin processing the file. When the file is being processed, the estimated number of records and a percentage of the conversion completed will be displayed at the bottom edge of the window.
Section 10. Utilities When CardConvert comes to what it believes is the end of the data file during the repair process (the end of valid frames), it will stop and display a message. The message prompts the user either to continue searching the file for more good data frames or to stop the repair process. CardConvert displays the last time stamp for data in the repaired file. If you think there should be additional data on the card, you can continue to run the repair process.
Section 10. Utilities 10.2 Device Configuration Utility 10.2.1 Overview The Device Configuration Utility (DevConfig) is used to set up dataloggers and intelligent peripherals before those devices are deployed in the field and before the devices are added to networks in Campbell Scientific datalogger support software such as LoggerNet or RTDAQ. Some key features of DevConfig include: • DevConfig supports only direct serial connections between the PC and devices.
Section 10. Utilities 10.2.2 Main DevConfig Screen The DevConfig window is divided into two main sections: the device selection panel on the left side and tabs on the right side. After choosing a device on the left, you will then have a list of the serial ports (COM1, COM2, etc.) installed on your PC. You’ll be offered a choice of baud rates only if the device supports more than one baud rate in its configuration protocol.
Section 10. Utilities 10.2.3 Downloading an Operating System DevConfig can send operating systems from the Send OS tab to all Campbell Scientific devices with flash replaceable operating systems. An example for the CR1000 is shown below: The text at right describes any interface devices or cabling required to connect the PC to the device. Screens for other devices vary only in the text on the right side.
Section 10. Utilities When the operating system has been sent to the device, a message dialog will appear similar to the one shown below: The information in the dialog helps to corroborate the signature of the operating system sent.
Section 10. Utilities 10.2.4 Terminal Tab The Terminal tab will be available when the application is connected to any device type that can be communicated within a remote terminal mode. The Terminal tab offers a terminal emulator that can be useful in accessing settings or status information that are not exposed in other windows. For example, the status table in a CR1000 can also be accessed via a “3” command in terminal mode. This status information can provide important data for troubleshooting purposes.
Section 10. Utilities 10.2.5 The Unknown Device Type When the Unknown Device type is selected, a panel will be shown in the tab control similar to that shown below: Clicking Connect puts DevConfig into Terminal emulation mode on the Serial Port and at the Baud Rate selected. When you click on Identify Datalogger Type, DevConfig will attempt to identify the type of device that is connected on the specified serial port.
Section 10. Utilities 10.3 Split NOTE Although RTDAQ does not support the older “mixed-array” group of Campbell Scientiffic dataloggers (the CR10X, CR23X, or CR510), the Split application included with RTDAQ is the same one included for use with LoggerNet and other Campbell Scientific support software. Because of this, the documentation included here contains references to mixed-array data file processing within the Split program, and also the Edlog program editor.
Section 10. Utilities Output files generated by Split can be Field Formatted (default), Comma Separated ASCII, or Printable ASCII. Split can also create reports in ASCII as well as html formats, or send them directly to a printer. Split lends itself to experimentation. The processed data are displayed on the screen, giving immediate feedback as to the effect of changes or new entries to the parameter file. Split does not modify the original Input File. 10.3.
Section 10.
Section 10. Utilities When you start Split a blank template similar to the one above is shown. This template is used to enter the parameters that will define what data from the input file to include in the output file. The parameters entered on this template can be saved as a parameter file (*.PAR) and reused for other data. On the INPUT FILE tab you only need to specify the input file name, copy condition, and the data to select.
Section 10. Utilities In this example we want the hourly data (note the Output Interval at the bottom of the Data File Label window), so click array 60. To paste the desired values from this array into the Select box, select the field names while holding down the key. All of the values could be selected by clicking the first one and holding the mouse button down, and dragging to the end. Once the values you want have been selected click Paste.
Section 10. Utilities Note that the cursor in the INPUT FILE(S) screen must be in valid paste area (Copy or Select). If the cursor is in the File name box or in Start/Stop condition, you will get the error message “Cannot Paste There”. The Paste operation copied the numbers of each of the fields into the Select box. Notice also that it pasted the Array ID into the copy condition: 1[60] tells Split that in order to copy a line of data, the first value in that line must be 60.
Section 10. Utilities Maximum column heading width is one less than the number entered in the Default Column Width field. However, entering a number in the Width row for the column will set the column width for an individual column. Any FSL labels that are too long for Split column headings will be shown in red. They should be edited before running Split. To edit one of the labels, press the key or use a mouse to copy, cut, and paste.
Section 10. Utilities To run Split, select RUN | GO. The hourly data will be split out and stored in hourly.prn. The results are displayed on the screen as shown below. NOTE When Split is running on large files, the line counters will update only every 1000 lines. Close the Run window. If you wish to save this parameter file for future reports, choose FILE | SAVE. The file will be saved with a .PAR extension. 10.3.3 Split Parameter File Entries 10.3.3.
Section 10. Utilities In LoggerNet, mixed array datalogger files are stored in a simple comma separated ASCII format; tabled-based datalogger files are stored in TOA5 (a comma separated format with headers).
Section 10. Utilities Element 1 Element 2 Element 3 Element 4 Element 5 Element 6 Element 7 = = = = = = = Output Array ID# (115) Julian day (189) hour, minute average temperature in deg. F average soil temperature in deg. F average wind speed in mph wind direction in degrees TABLE ORIENTED ASCII "TOACI1","CR10T","15Minute" "TMSTAMP","RECNBR","TCTempF_MAX","BattVolt_MIN" "2002-02-26 10:30:00",0,73.97,13.99 "2002-02-26 10:45:00",1,74.03,13.98 "2002-02-26 11:00:00",2,74.53,13.98 "2002-02-26 11:15:00",3,74.
Section 10. Utilities bytes. If Offsets are not used, Auto Detect may be chosen and the file will be processed correctly. 10.3.3.1.2 File Offset/Options Start Offset None Select his check box to start reading the input file from the beginning. Last Count Each time Split runs a parameter file, it keeps track of the number of bytes it read from the input file and saves this information in the parameter file. Split can then start where it last left off.
Section 10. Utilities Specific By selecting the Specific option and entering a number, Split will "seek" that position in the file. This option saves time by starting (or stopping) part way through a large data file. The number specifies the number of bytes into the file to seek before processing data. A positive or negative number can be entered. If the number is positive, Split will start reading from the beginning of a file; if the number is negative, Split will start reading from the end of a file.
Section 10. Utilities Number of Values in Each Burst When processing a burst data file, enter the total number of values recorded for each Burst (this is the number of burst scans multiplied by the number of channels per scan). This number does not include the array ID or calibration data. To break the results into a column for each channel, enter the number of channels for the Break Arrays value (Output File Tab, Other button).
Section 10. Utilities This may be useful when adjusting for different time zones. NOTE The offset will not be applied to Date and Edate functions with only two parameters. (The two-parameter mode is backwards compatible with the original Date and Edate functions used in older versions of Split.) 10.3.3.1.3 Start Condition A starting point may be specified to begin processing data. If the Start Condition field is left blank, Split will start processing data at the beginning of the data file.
Section 10. Utilities Logical “and” and “or” statements can be used when specifying the Start Condition. A logical “and” statement means that all conditions must be true for the statement to be true. Up to three conditions can be connected with “and” statements. If too many “and” statements are used, an error message will be displayed when you run Split. The logical “or” statement means that if any of the conditions are true, then the statement is true.
Section 10. Utilities data file (day, hrmn, sec.) are different each time the data are collected, but by telling Split where to Start reading relative to the PC clock, the Start Conditions do not need to be changed. To accommodate variations in the data collection and reduction frequencies, an interval in minutes or seconds may be specified as shown in the examples below.
Section 10. Utilities NOTE • If the start time is a certain number of days prior to the PC time, the file will be processed beginning at midnight of the day specified. • To specify a start time in minutes from the current PC time, you must also specify a day parameter of [-0]. Otherwise, processing will begin at the first instance in the data file that the minutes parameter equals the current minutes. 10.3.3.1.4 Stop Condition The Stop Condition specifies when to stop processing data.
Section 10. Utilities • outputting data when engine RPM exceeds a limit The unconditional array data (the stop condition) would be output to a unique array when the engine is turned off. By processing the data with Split using the C option, the data collected during each test could be merged on to one line, with blanks inserted if a set of data didn't exist (e.g., if the engine temperature never exceeded the defined limit). • An Input File must be set up for each array ID in the test.
Section 10. Utilities data was output from arrays 100 and 102. During the third test, data was output from arrays 100 and 101. To process these files using the C option, the parameter file would be set up as follows (assuming the name of our data file is Data_1.DAT): First Input File = Data_1.DAT:1 Stop condition = C,1[200] Copy = 1[100] Select = 1,2,3,4 Second Input File = Data_1.DAT:2 Stop condition = C,1[200] Copy = 1[101] Select = 1,2,3 Third Input File = Data_1.
Section 10. Utilities processed that have a Stop Condition specified. If multiple files are being processed but it is desired that the function affect one or more⎯but not all⎯of the files, the F option is used in the Stop Condition field of the files that you want processed using the function. The syntax for the F option is: F,ei[vali]. A typical application for the Trigger on Stop Condition is to reduce days of hourly data into daily summaries.
Section 10. Utilities Only Output Arrays with hours 1300 and 1500, Table 10.3-1, conform to the above Copy conditions. NOTE The Copy Condition is used almost exclusively for mixed-array dataloggers, except when time-syncing two or more data files. See Section 10.3.3.1.15 Time Synchronization for additional information. Time Ranges When specifying a Copy condition, a range of time values can be specified instead of a single time.
Section 10. Utilities 10.3.3.1.7 Ranges Element numbers may be entered individually (e.g., 2,3,4,5,6,7), or, in groups (e.g., 2..7) if sequential. Range limits (lower to upper boundary conditions) may be placed on elements or groups of elements specified in the Select or Copy lines. For example, 3[3.7..5],4..7[5..10] implies that element 3 is selected only if it is between 3.7 and 5, inclusive, and elements 4,5,6, and 7 must be between 5 and 10, inclusive.
Section 10. Utilities NOTE In this instance, out of range data refers to data outside of the specified output range. It is not to be confused with out of range data generated by the logger. 10.3.3.1.8 Variables Variables can be assigned names in the Select line. For example, x = 4-5∗(6∗ 3.0) means that x is equal to element 6, times the number 3, times element 5, subtracted from element 4. A numeric value is distinguished from an array element by the inclusion of a decimal point.
Section 10. Utilities 10.3.3.1.10 Mathematical Functions, Details, and Examples TABLE 10.3-6. Split Operators and Math Functions OPERATORS ^ x Mod y ∗/ +- = raise to the power = Modulo divide of x by y = multiplication, division = addition, subtraction OPERATOR PRECEDENCE ORDER (3 = high, 1 = low) 3 2 2 1 EXAMPLES OF SYNTAX FOR MATHEMATICAL OPERATORS 3∗5 multiply element 3 by element 5 3/5 divide element 3 by element 5 (3..5)/(8..
Section 10. Utilities Exp(x) returns the exponential base e to the power of element x. Example: Exp(4) = .00037 Frac(x) returns the fractional value of the element x. Examples: Frac(4) = -.89 Frac(6+7) = .95 Int(x) returns the integer portion of the element x. Examples: Int(7) = 270 Int(5∗6) = 685 Ln(x) returns the natural log of element x. Examples: Ln(6) = 2.5217 Ln(7/6∗5/1) = 2.4337 Sin(x) returns the sine of element x in degrees. Examples: Sin(7) = -.99996 Sin(7-2+5) = .
Section 10. Utilities 10.3.3.1.11 Time Series Functions, Details, and Examples TABLE 10.3-7.
Section 10. Utilities The date( ) function can be used for the interval in a time series function to produce monthly output. Refer to the Monthly summary example in Section 10.3.3.1.12. NOTE When Date and Edate are used within other functions they must be used with the older format Date(doy;y) and Edate(doy;y) instead of using the extended date functions. For example AVG(1;Date(2;2002.0)). The decimal is needed to indicate a fixed number. Numbers without the decimal are interpreted as element IDs.
Section 10. Utilities Mt. Logan Weather Data Day 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 178 179 10-40 Time 100 200 300 400 500 600 700 800 900 1000 1100 1200 1300 1400 1500 1600 1700 1800 1900 2000 2100 2200 2300 0 Airtemp deg F 58.56 57.48 56.85 56.55 56.57 55.33 55.95 58.12 59.79 61.09 61.34 60.61 61.01 60.93 62.3 63.75 66.15 67.33 66.59 64.52 59.84 56.19 55.48 55.22 RH 17.42 17.65 17.76 18.89 19.6 23.32 24.79 23.98 23.46 24.12 25.03 27.46 25.44 25.
Section 10. Utilities NOTE Blanks and Count are functions designed for checking the integrity of the data file. A common use for these two functions is “100.*BLANKS(x;n)/BLANKS(x;n)+COUNT(x;n)” which gives the percentage of holes (bad data) in the file. Max(x;n) returns the maximum value of element x over a full data set or every nth value. Examples: Max(5) = 17.12 (max WS for day) Max(5;12) = 10.41 (max WS for 12 hours) 17.
Section 10. Utilities Smpl(x;n) returns a sample of element x every nth value. Examples: Smpl(4;8) = 23.98 (RH every 8 hours) 24.31 (RH every 8 hours) 37.13 (RH every 8 hours) SmplMax(x;y;n) looks for a maximum value in element x and samples element y when the maximum is found. If an nth value is specified then it outputs the sample on a maximum every nth value, otherwise it outputs the sample on a maximum at the end of file. Examples: SmplMax(5;(3)) = 55.
Section 10. Utilities 10.3.3.1.12 Special Functions, Details, and Examples TABLE 10.3-8. Split SPECIAL FUNCTIONS Crlf = Insert carriage return line feed in Output File. Date(“format”S;H;D;Y) = Convert day of year and time to a timestamp with calendar date and time, where format uses Windows conventions to specify output format. S=seconds, H = HoursMinutes, D = Day, Y = year. The output timestamp is quoted text. Date can be used to create monthly time series summaries.
Section 10. Utilities The Crlf is placed after the maximum temperature 67.33 so that the maximum RH is on the next line. NOTE A carriage return/line feed is recognized by Split as an element, and may throw the column headers off in the output file. "Label" returns a comment in the output file. This is a useful formatting function when labels are desired on the same line as the data. The label includes anything within the quote marks, the quote marks are not output but must be in the parameter file.
Section 10. Utilities 22 35.46 15.62 23 38.8 17.12 24 37.13 11.86 Smpl (Line;8), Smpl (4;8), Smpl (5;8) 1 23.98 6.588 2 24.31 8.88 3 37.13 11.86 smpl(.PA,n) Outputs the data to the printer or .RPT file with n lines per page. Examples: 2, 3, Smpl (.PA;12) = 100 58.56 200 57.48 . . . . . . 1100 61.34 1200 60.61 1300 61.01 1400 60.93 . . . . . . 2300 55.48 0 55.22 WDQ(n) Outputs the wind direction using an alphabetical abbreviation, based on 8 quadrants (N, S, E, W, NE, NW, SE, SW).
Section 10. Utilities specified, these will be assumed to be hour/minute, day, and year. When using the Date function for a table-based datalogger (e.g., a time stamp in the format "2002-02-03 21:16:00"), if the time stamp is the first element in the array, a 1 is used for all of the time stamp elements (S; H; D; Y). If "serial" is entered for the "format" string, a serial date will be output. Other special functions are "hourarray" and "dayofyear".
Section 10. Utilities If processing a table-based data file, use a 1 for all time elements (assuming the time stamp is the first element in the data file). For the examples above: date("mm/dd/yy, h:nn";1;1;1;1) "02/25/02, 4:10" edate("mm/dd/yy, hh:nn";1;1;1;1) 02/25/02, 04:10 edate(“yyyy”, “dayofyear”, “hhnn”;1;1;1;1) 2002, 56, 0410 Notice that this last example essentially creates an array-type of timestamp.
Section 10.
Section 10. Utilities The following screen shows the output file setup including the column headings and the units. This .PAR file produces a wind chill summary of the Mt. Logan Peak data set. The formula for calculating wind chill is given as follows: Te = 33-(h/22.066) where Te = Wind Chill equivalent temperature, degrees C h = ((100V)0.5 + 10.
Section 10. Utilities Wind Chill Report from Mt. Logan Temp deg C 14.756 14.156 13.806 13.639 13.65 12.961 13.306 14.511 15.439 16.161 16.3 15.894 16.117 16.072 16.833 17.639 18.972 19.628 19.217 18.067 15.467 13.439 13.044 12.9 Wind Speed m/s 2.6172 3.6967 3.4643 3.3972 4.6533 4.0185 4.2554 2.9448 2.4397 2.066 2.6489 3.0463 3.7325 4.8812 3.7682 3.9694 3.5626 3.0208 3.1648 3.9157 5.2791 6.9821 7.6526 5.3014 H 438.06 489.58 491.34 493.4 529.57 530.58 528.27 456.04 414.97 383.21 402.08 425.2 439.59 468.
Section 10. Utilities VALID EXPRESSION Arctan (2/3) Arctan (2/3, 3/4, 4/5) Arctan (COS(2)) INVALID EXPRESSION Arctan ((2/3)) Arctan ((2/3, 3/4), 4/5) Arctan (COS(2), COS(3)) • A single expression can operate on a set of elements. For example, the expression (3..6,8)/2.0 is the same as 3/2.0, 4/2.0, 5/2.0, 6/2.0, 8/2.0; (3..6)/(2..5) is the same as 3/2, 4/3, 5/4, 6/5. • The element or expression that is the argument of a math or Time Series function, must be enclosed in parentheses.
Section 10. Utilities specified in the Start Condition becomes simply a starting time with no time synchronization. Typically, the starting time specified must actually be found in the input file before the Start Condition is satisfied (e.g., if the input file starts at 1100 hrs and 1000 hrs is entered for the starting time, with no day specified, Split will skip over arrays until it reaches 1000 hrs the next day).
Section 10. Utilities 10.3.3.1.15.1 Time Synchronization and the Copy Condition To use the time synchronize function, time element(s) must be specified in the Start Condition. The user must also specify a time interval in the Copy condition. For instance, if the original data had 15 minute outputs and you only want hourly outputs, then an interval of 60 minutes must be specified following the element number. This is entered as (assuming hrmn is element number 3) “3[60]”.
Section 10. Utilities 10.3.3.2 Output Files To create an Output File, click the OUTPUT FILE tab. The file is created on the default drive or directory unless the file name is preceded with an alternative drive or directory. Use the Browse button to change directories. Split will assign this file an extension of .PRN if an extension is not specified by the user. Whenever an Output file name is entered, regardless of extension, an Output file is created only when the RUN | GO menu option is selected.
Section 10. Utilities 10.3.3.2.1 Description of Output Option Commands File Format There are five File Format options to choose from: No File, Field, Comma, Printable, and Custom. If No File is chosen, then only the .PRN file is saved to disk. The Field, Comma, and Printable options produce files formatted as Field Formatted, Comma Separated, and Printable ASCII, respectively. An example of each of these file types is given in Table 10.3-1 in the Input Files section.
Section 10. Utilities Screen Display The Screen Display field controls writing the processed data to the screen. To write to the screen, check the box. For faster execution, clear the box to omit writing to screen. The data will then be written to the file only. Report A report, with page and column headings, can be sent to a file or printer. There are three report options: File, Printer, HTML. One or more can be selected. A report sent to a file has the extension of .RPT.
Section 10. Utilities It allows the following settings to be modified: Replace bad data with - The text in the field, to the right of this option, is entered into the .PRN output file data set if data are blank, bad, or out of range. See Table 10.3-9 for definition of blank or bad data. Whatever text string the user enters in the field will be entered if a blank or question mark is in the data or if data are out of range.
Section 10. Utilities The Copy Condition determines the interval of your data. Therefore, to output data that occurs every 24 hours, you would use: Copy Condition = 1:1[1]:1:1 Because you have specified a time in the Start Condition, but not the day, Split assumes the first day of the year. Therefore, by default, you will have blank lines in your output file for each day from Jan 1st to Sept 9th. Using the Time Sync to First Record option will avoid these blank lines.
Section 10. Utilities summary of the left over values and the Time Series Heading from the report. No Date Advance - When processing a data file from a mixed array datalogger, if the time stamp uses midnight as 2400 with "today's" date, the date function will convert that time stamp to 0000 hours with "tomorrow's" date. (This is because the algorithm used by the date function is based on Windows' time format, and it does not support a 2400 time stamp.
Section 10. Utilities Heading and Column Headings from being printed at the bottom of the report. The "left over" summary data will still be printed. No Record Numbers from TOB Files - Split automatically converts TOB (binary) files to ASCII prior to being processed. When this check box is selected, the record numbers will not be included in the converted file. This will affect the element numbers used for the Start, Stop, Copy, or Select fields of the PAR (e.g.
Section 10. Utilities 10.3.5 Editing Commands Split supports the Windows Cut, Copy, and Paste commands. Text from any field in Split or other Windows applications can be Cut, Copied, or Pasted. 10.3.6 Running Split From a Command Line Existing parameter files can be executed using Splitr.exe which is a "run-time" version of the Split Report Generator. When Splitr.exe is run, the file is processed as if the user chose Run | Go from the Split menu. Splitr.
Section 10. Utilities 10.3.6.1.3 Running Multiple Copies of Splitr (/M Switch) Multiple copies of Splitr can be run at one time by using the /M switch. This switch must appear immediately after Splitr. For instance, a batch file containing the lines: SPLITR /M Logan/R SPLITR /M Sinks/R will open two copies of Splitr and process the two files simultaneously. NOTE When using the /M switch in a batch file, you must begin each line of the batch file that runs an instance of Splitr with the "start" command.
Section 10. Utilities If a parameter is to be left as it is in the parameter file, then space comma space ( , ) may be entered in the command line. For instance, if the parameter file LOGAN.PAR contained TEST1.DAT as an input file name, the following command line would leave the input file TEST1.DAT and change the output file to TEST.PRN. “SPLITR LOGAN/R , TEST.PRN” 10.3.6.3.
Section 10. Utilities /[text] Sets the text that will be used in the place of bad data. This is the same as the text string used in the Replace Bad Data field that is found under the Other button of the Output File tab. /M Compares two input files and creates an output file with a complete data set comprised of both files. This is the same at the Match Files option that is found under the Other button of the Output File tab. The two input file names are separated with a comma but no spaces.
Section 10. Utilities /H Removes the dashed lines from the heading of the RPT file. This is the same as choosing the No Dashes check box that is found under the Other button of the Output File tab. /U Removes the record number from TOB files that are processed with Split. This is the same as choosing the No Record Numbers from TOB Files check box that is found under the Other button of the Output File tab.
Section 10. Utilities /M Changes the value for midnight to 2400 instead of 0000. This is the same as selecting Midnight is 2400 Hours check box found under the Offsets/Options button of the Input File tab. Batch File Example "c:\Program Files\campbellsci\LoggerNet\splitr.exe" c:\Campbellsci\SplitW\switch-test.par input1a.dat Output.prn/E/H/W 4[1200]: , , 1..6 where PAR file: switch-test.par Input file: input1a.dat Output file: output.prn Other outputs: Output.
Section 10. Utilities 10.4 Log Files and the LogTool Application 10.4.1 Event Logging As RTDAQ performs its work, it can create records of various kinds of events and store them in ASCII log files. These logs can be very useful for troubleshooting problems and monitoring the operation of the datalogger network. You can monitor these logs using a built-in tool, called LogTool, accessible from the Tools | LogTool menu item, or open these log files in a simple text editor.
Section 10. Utilities into the File Count field. The size of the log files can also be changed by entering a new value into the File Size field. By default, RTDAQ stores five historical files of each type of log, each file 1.4 MB in size. After five files have been created, the oldest log file is deleted as a new one is begun. RTDAQ stores the most recent log records in a file that has a $ character in the place of the version number or “X” in the above file names.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text Message Parameters Message Meaning 1 Network device added Device Name 2 Network branch deleted Device Name 3 Network branch moved Device Name 5 Network logon succeeded Logon Name 6 Network logon failed Logon Name A new device was added to the network map.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text Message Parameters Message Meaning 14 Clock check failed Reason code: 3. Communication failure 4. Invalid datalogger security clearance 5. Invalid transaction number specified (already in use) 6. Communications are disabled for this device 7. The transaction was aborted by client request 8. The device is busy with another transaction The clock check/set failed for the reason specified in the reason code.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text 36 Logger table definitions have changed 40 Datalogger message Severity (S for Status, W for Warning, F for Fault); Message text. This is a message that has been generated by the datalogger (or in some cases the RF base on behalf of the datalogger).
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text 48 Set variable failed 50 Program file send start 51 Program file send status 52 Program file send complete 53 Program file send failed 54 Program file receive start 55 Program file receive status Program file receive complete 56 10-72 57 Program file receive failed 64 Device restore from file succeeded Message Parameters Message Meaning The datalogger failed to acknowledge the set variable message.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text Message Parameters 65 Device restore from file failed On server startup a device in the network map could not be restored. 66 Device save to file succeeded 67 Device save to file failed The update to the device configuration file was successful. The update to the device configuration file failed. 68 Packet delivery failed Fault code: 1. Incompatible BMP1 device or malformed packet 2.
Section 10. Utilities TABLE 10-4-1.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text 75 Logger locked 76 Logger unlocked 77 Null program sent 78 Server started 79 Server shut down 80 Collect area initialized Collect area removed 82 83 LgrNet restore failed 85 Data restore failed Message Parameters The server version Collect area name Message Meaning This message indicates the start of a transaction such as terminal emulation that will tie up the datalogger preventing other operations.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text Message Parameters Message Meaning 86 Manual poll transaction started Client logon name 87 Manual poll transaction complete 88 Manual poll aborted 89 Selective manual poll begun Collect area name 90 Selective manual poll complete Selective manual poll aborted Collect area name The listed client is starting a manual poll operation according to the scheduled collection settings.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text Message Parameters Message Meaning 94 Collect area polling complete Collect area name 95 Collect area polling failed Collect area name Data collection for the specified collect area has successfully completed. Data collection for the specified collect area failed.
Section 10. Utilities TABLE 10-4-1.
Section 10. Utilities TABLE 10-4-1.
Section 10. Utilities TABLE 10-4-1. Transaction Log Messages Code Message Text Message Parameters Message Meaning 108 Table reset The name of the table that was reset; The account name of the logged in client 110 Collect area setting changed The name of the collection area; The setting identifier for the setting that was changed; The new value of the setting; The account name of the logged in client.
Section 10. Utilities "2009-04-15 16:41:06.492","CR1000","41","Records received","TestFast","20769","20799","polling" "2009-04-15 16:41:06.507","CR1000","144","data file opened","TestFast","C:\Campbellsci\LoggerNet\CR1000_TestFast.dat" "2009-04-15 16:41:06.507","CR1000","21","Hole collected","TestFast","20769","20799" "2009-04-15 16:41:06.507","CR1000","41","Records received","TestFast","20800","20864","polling" "2009-04-15 16:41:06.
Section 10. Utilities TABLE 10.4-2. Communication Status Log Messages Message Text Serial packet X exchanged Classic;;Cmd BMP1 packet received RPC packet exchanged Datalogger did not respond to end command Invalid low level signature Provider opened Device dialed Provider closed Unable to Locate Serial synch byte 10-82 Message Meaning The low level serial BMP1 communication framing packet was sent and the response received from the device.
Section 10. Utilities 10.4.1.2.4 Object State Log Format The object state log includes two fields in addition to the timestamp and device name: Object Name - The name of the object from which the message is being generated. Typically this will be the name of an object method. Description - Any extra information associated with the event. Object State Log Example "2009-04-15 16:41:05.351","CR1000","starting BMP5 operation","manage comm resource" "2009-04-15 16:41:05.
Section 10. Utilities 10.4.2 CQR Log (RF Link) The CQR log contains information about the quality of communication each time an RFBase is dialed. (Note that information on an RFBase-TD link is not contained in the CQR log). The CQR log is written to the \Logs directory. By default, this is C:\Campbellsci\RTDAQ\Logs. Each time an RF link is shutdown, an entry will be written to the CQR Log.
Section 10. Utilities The SDM-CAN allows readings from a vehicle network to be transferred to a datalogger. This software helps those users move through the process of defining their vehicle network messaging within a datalogger program, so that the datalogger can read and store those values. SDM-CAN Helper will significantly reduce the amount of technical support required to operate this kind of a measurement system. There are two main parts to SDM-CAN Helper: 1.
Section 10.
Appendix A. Campbell Scientific File Formats Campbell Scientific, Inc. uses different formats for data that is stored on external PC cards, datalogger communication software, and in collected PC files. The data formats are, by default, written to the PC with a DAT extension (*.dat). The following sections will focus on the format of these PC files, discuss the data formats that exist in the datalogger and on PC cards, and describe methods for converting binary data formats. A.
Appendix A. Campbell Scientific File Formats An example showing a TOA5 file containing the optional timestamp and record number: "TOA5","CR1000","CR1000","1031","CR1000.Std.00.60","CPU:Test.CR1","4062","Test" "TIMESTAMP","RECORD","batt_volt_Min","PTemp" "TS","RN","Volts","C" "","","Min","Smp" "2004-11-11 15:03:45",0,13.7,24.92 "2004-11-11 15:04:00",1,13.7,24.95 "2004-11-11 15:04:15",2,13.7,24.98 A.1.2 TOB1 TOB1 files can be generated by RTDAQ when saving data files to the PC.
Appendix A. Campbell Scientific File Formats Header line two consists of a set of comma-delimited strings identifying the names of the fields in the table of the datalogger program. Header line three describes the units associated with each field in the record. Units are optional and are specified in the datalogger program, if included. If no units are provided in the program, then an empty string placeholder is left in this line for that specific field.
Appendix A. Campbell Scientific File Formats The TOB2 or TOB3 binary file format has the following structure with each header line terminated with a carriage return and line feed (CRLF): ASCII Header Line 1 ASCII Header Line 2 ASCII Header Line 3 ASCII Header Line 4 ASCII Header Line 5 ASCII Header Line 6 Frame Header Frame Body n Frame Footer Header line one describes the file environment with the following fields: • Data file type (TOB2 or TOB3). • Station name. • Model name of the datalogger.
Appendix A. Campbell Scientific File Formats Header line five describes the processing performed in the datalogger to produce the value for each field in the record; for example, sample, average, min, max, etc. If there is no known processing for a field, that field will be assigned an empty processing string. There will be one value on this line for each field name given on header line three.
Appendix A. Campbell Scientific File Formats A.3.4 IEEE8 A standard eight-byte floating-point number format used for certain values within a record. This format consists of a single sign bit, an 11-bit exponent, and a 52-bit mantissa. A.4 Converting Binary File Formats Campbell Scientific dataloggers not only use the previously mentioned binary file formats but users may also choose to use and access these binary formats on the PC.
Appendix B. Importing Files into Excel ASCII Data files saved by RTDAQ can be imported into a spreadsheet program for analysis or manipulation. Changing the extension of a TOA5 (comma separated ASCII) file from *.dat to *.csv will allow the file to be imported directly into Microsoft Excel with all of the header data included. Instructions are given below for importing TOA5 files into Microsoft Excel with more control over what header information should be included. B.
Appendix B. Importing Files into Excel Step 2 of 3 From the Delimiters group box, select Comma and Space. The Comma option directs Excel to place each data value, which is separated by a comma, into a separate column. The Space option will separate the Date and the Time into two columns. From the Text Qualifiers list box, select None. Select the Next button.
Appendix B. Importing Files into Excel Step 3 of 3 A quick look at the columns of data is provided in the Data Preview group box. Highlight the column with the year/month/day and from the Column Data Format group box, select the Date option. From the drop-down list box to the right of this option select the YMD format. To complete the import, select the Finish button. As imported, the Date and Time fields have a quotation mark in the field.
Appendix B. Importing Files into Excel The quotation marks can be removed by using Microsoft Excel's Search and Replace feature. From the Excel menu, select Edit | Replace. In the Find What field, type in a quotation mark ("). Leave the Replace With field blank, and select the Replace All button. If headers have been imported with the data, the column headings will be off by one since the date and time have been imported as two separate fields.
Campbell Scientific Companies Campbell Scientific, Inc. (CSI) 815 West 1800 North Logan, Utah 84321 UNITED STATES www.campbellsci.com • info@campbellsci.com Campbell Scientific Africa Pty. Ltd. (CSAf) PO Box 2450 Somerset West 7129 SOUTH AFRICA www.csafrica.co.za • cleroux@csafrica.co.za Campbell Scientific Australia Pty. Ltd. (CSA) PO Box 444 Thuringowa Central QLD 4812 AUSTRALIA www.campbellsci.com.au • info@campbellsci.com.au Campbell Scientific do Brazil Ltda.
