E-DAS Ambient ATX Data Manager Guide v2005-1116.pdf · Data Manager Guide Version 3.9 While every...

TIN: 2005-1116

E-DAS Ambient ATX Data Manager Guide

Version 3.9

While every effort has been made to ensure that the information in this document is complete, accurate, and up to date, ESC reserves the right to expand, alter, or clarify the various sections of this manual as necessary. ESC makes no warranty and assumes no liability for the correctness of the information contained herein.

ESC grants the software licensee the right to print this document for internal, non-commercial reference purposes only.

Copyright © 2005 Environmental Systems Corporation. All rights reserved. Printed in the USA.

Windows, Microsoft SQL Server, MS Access, and MS Excel are registered trademarks of Microsoft Corporation.

ATX Technical Support: (865) 688-7900 E-mail: [email protected]

Fax: (865) 687-8977

Environmental Systems Corporation

200 Tech Center Drive Knoxville, TN 37912

December 2005

mailto:[email protected]

E-DAS Ambient ATX iii

Contents

Introduction ......................................................................................................................v About This Data Manager Guide.............................................................................................................. v Overview of ATX System ........................................................................................................................ v

Use of Popular RDBMS..................................................................................................................... v Advanced Technology........................................................................................................................ v Client/Server Architecture.................................................................................................................. v Scalability.......................................................................................................................................... vi Data Retrieval.................................................................................................................................... vi Familiar User Interface...................................................................................................................... vi Graphical Data Display ..................................................................................................................... vi Maintaining Data............................................................................................................................... vi Data Import/ Export .......................................................................................................................... vi Reporting.......................................................................................................................................... vii Report Output................................................................................................................................... vii Scheduled Reports............................................................................................................................ vii

Help from ESC........................................................................................................................................ vii Diagnostic Information .................................................................................................................... vii

Chapter 1 Starting and Navigating ATX .....................................................................1 How Do I Access ATX? ........................................................................................................................... 1

Login .................................................................................................................................................. 1 Glossary of Terms..................................................................................................................................... 1 What Is the ATX Launch Pad and How Do I Use It?............................................................................... 2

Starting the Launch Pad ..................................................................................................................... 2 Using the Menu Tree.......................................................................................................................... 2 Automatic Recording of Launch Pad Appearance ............................................................................. 4 Adding Programs to Favorites............................................................................................................ 4 Launch Pad Menu Bar........................................................................................................................ 4 Launch Pad Toolbar ........................................................................................................................... 7 Launch Pad Status Bar ....................................................................................................................... 7

Resolving Problems within ATX: The Exception Window...................................................................... 7 Backup Strategies ..................................................................................................................................... 8 Data Logger Console Window ................................................................................................................. 8

Chapter 2 ATX Data......................................................................................................9 What Are the Types of ATX Data? .......................................................................................................... 9 Glossary Terms ......................................................................................................................................... 9 What Are Readings Data?......................................................................................................................... 9

Sites, Parameters and Perspectives..................................................................................................... 9 Foundation Readings........................................................................................................................ 10 Ambient Readings ............................................................................................................................ 10 Ambient Flags .................................................................................................................................. 10 Annotations ...................................................................................................................................... 12

What Are Non-Readings Data? .............................................................................................................. 12 Site Data ........................................................................................................................................... 12 Calibration Data ............................................................................................................................... 12

Contents E-DAS Ambient E-DAS Ambient ATX Data Manager Guide

iv E-DAS Ambient ATX

Parameter Basics......................................................................................................................................13 Understanding Annexes ....................................................................................................................13

Chapter 3 Criteria Windows...................................................................................... 15 What Are Criteria Windows? ..................................................................................................................15 Using Criteria Windows ..........................................................................................................................15

Sources of Data .................................................................................................................................17 Time Range for Data.........................................................................................................................18 Print Properties..................................................................................................................................19 Criteria Window Menu Bar Options .................................................................................................20

Reusing Criteria Settings .........................................................................................................................21 Copy/Paste Criteria Settings .............................................................................................................21 Save Criteria Settings as a File..........................................................................................................21

Positioning the Criteria Window .............................................................................................................22 Understanding ATX Reports ...................................................................................................................22

Missing and Invalid Readings...........................................................................................................22 Using the Viewer Utility ...................................................................................................................23

Chapter 4 Ambient Data Management ..................................................................... 27 What Is Ambient Data Management?......................................................................................................27 Editing Ambient Readings and Flags ......................................................................................................27

Edit Values Only ...............................................................................................................................28 Batch Edit Data .................................................................................................................................29 Edit Values & Flags ..........................................................................................................................31 Edit Records......................................................................................................................................31 Ambient Readings Editor..................................................................................................................32 Rebuild from Foundation ..................................................................................................................36

Deleting Data...........................................................................................................................................37 Delete Readings ................................................................................................................................37 Delete Calibrations............................................................................................................................38 Delete Site Recordings......................................................................................................................39

Editing the AIRNow Forecast .................................................................................................................39 Viewing the Alarm Monitor ....................................................................................................................40 Configuring Unscheduled Polling ...........................................................................................................40 Importing and Exporting Data .................................................................................................................42

Importing Readings Data ..................................................................................................................42 Exporting Readings Data ..................................................................................................................43

AIRS Auto-Coding ..................................................................................................................................45 Enabling AIRS Auto-Coding ............................................................................................................45 Auto-Coding When Editing Readings...............................................................................................45 Auto-Coding When Editing Flags.....................................................................................................45 Auto-Coding When Polling Readings...............................................................................................46

AIRS Null Code Configuration ...............................................................................................................46 Showing Flags in Reports........................................................................................................................48

Report Fill Characters .......................................................................................................................48 Scheduling CLAIRE Data Export ...........................................................................................................49

Exporting ATX Data into CLAIRE ..................................................................................................49

Index ............................................................................................................................... 51

E-DAS Ambient ATX v

Introduction

About This Data Manager Guide The E-DAS Ambient ATX Data Manager Guide is designed as a reference guide. If you need details about ATX reports, please see the E-DAS Ambient ATX User Guide.

This introduction provides an overview of ATX (Advanced Technology eXecutive). Information is organized in the following topics:

• Starting and Navigating ATX – Chapter 1

• ATX Data – Chapter 2

• Criteria Windows – Chapter 3

• Ambient Data Management – Chapter 4

Overview of ATX System ATX is a powerful data acquisition, processing, and reporting tool with an easy-to-use operating environment. ATX is the link between raw materials and usable end products of Ambient air quality monitoring. Raw materials are electrical signals from instruments (meteorological and air quality). The usable end product is information that is easily accessible by users, and appropriately presented to meet user’s reporting requirements.

As a Data Manager, the menu tree presented to you in the Launch Pad contains report and display programs, plus the data management programs and import/export programs (see Chapter 4, “Ambient Data Management”).

Use of Popular RDBMS ATX employs ODBC (Open DataBase Connectivity) technology to capitalize on the power of today’s popular RDBMS (Relational Database Management Systems). Directly supported RDBMS options include Microsoft SQL Server 2000, and MSDE.

Advanced Technology ATX has the performance of a true native 32-bit application built using the most up-to-date development tools and techniques, and offers customers a wide range of data storage options. It is also convenient to be able to plug ATX directly into an installed RDBMS, which means that ATX users can apply flexible third-party report generators and query tools directly to quality assured data.

Client/Server Architecture The backbone of the ATX system is a true client/server architecture providing efficient distribution of processing. Client software can access server components from the server itself or via LAN, dialup networking or internet connection.

Introduction E-DAS Ambient ATX Data Manager Guide

vi E-DAS Ambient ATX

Scalability ATX is designed to adapt to changing monitoring requirements, and can run efficiently on modestly configured hardware. ATX can meet the most demanding requirements of volume memory, multiple processors, and distributed computers. The amount of sites, parameters, and other configured elements is limited only by the underlying hardware resources.

Data Retrieval ATX is capable of coordinating data retrieval from directly connected data loggers, or from remote data loggers via modem(s). Polling is scheduled by the ATX Administrator.

In addition to regularly schedule polling of data loggers, unscheduled polling can also be performed when needed (see page 40 “Configuring Unscheduled Polling”).

Familiar User Interface ATX uses a familiar Windows-style interface, convenient toolbars and menu bars, and the familiar tree structure for program functions and utilities.

Graphical Data Display Data can be viewed in a graphical format for analysis and troubleshooting.

Maintaining Data Data and flags can be edited, deleted, or restored from Foundation readings for individual readings, blocks of readings, or entire parameters at multiple sites (see page 27 “Editing Ambient Readings and Flags”).

AIRS codes are assigned automatically when data is retrieved using the advanced AIRS Auto-Coding options (see page 45 “AIRS Auto-Coding”).

The Alarm Monitor tracks all alarm activity and proceeds according to your configured instructions (see page 40 “Viewing the Alarm Monitor”).

Unscheduled polling can be configured and performed quickly when needed (see page 40 “Configuring Unscheduled Polling”).

Data Import/ Export Data can be imported to or exported from ATX in several file formats. Imported data can come from other ATX systems, U.S. EPA AIRS format, or other ESC E-DAS Ambient or Digi-Trend systems.

Data can be exported from ATX either as a formatted report saved to a file, or as an ASCII type file. ASCII files can be delimited using one of a variety of delimiters. The file is saved as RPTDUMP.TXT and stored in the \Dnc\Temp folder.

See page 42 “Importing and Exporting Data” for more detailed information on data import/export.

E-DAS Ambient ATX Data Manager Guide Introduction

E-DAS Ambient ATX vii

Reporting Data reporting is provided for both air quality and meteorology applications. Standard air quality reports include AIRS, AQS (Air Quality Subsystem), and AQI. General tabular output is also available as well as daily, monthly, quarterly, and annual summaries. See the E-DAS Ambient ATX User Guide for more details.

Report Output All report output can be viewed, optionally edited, then printed, or channeled directly to local or remote printers. It is also possible to route report output with custom-authored scripts to support e-mail, fax, network, FTP, or other distribution. See the E-DAS Ambient ATX User Guide for more details.

Scheduled Reports You can schedule any report to run unassisted with specified criteria (date/time range, site, parameter, etc.) and output path.

Specialized reporting needs can be accomplished easily, as well. In addition, if the AIRNow Forecast is modified, it can be scheduled for sending with future AIRNow reports (see page 39 “Editing the AIRNow Forecast” for details). See your ATX Administrator for more information on scheduling reports.

Help from ESC To quickly provide the best possible solution to a problem, we ask that a few guidelines be observed calling technical support at ESC:

1. See your ATX Administrator first for initial advice on all errors.

2. Try to record details about the circumstances of the problem (as many as possible) while they are fresh in your mind.

3. Include the program name and release number (as reported by the program) in any report. This is available in the About box (via Help menu) or in the exception window (see page 7, "Resolving Problems within ATX: The Exception Window”).

4. Include as much diagnostic information as the system provides (see the following section).

Diagnostic Information Diagnostic information is available to help in determining the nature of a problem. This information is also helpful when reporting a problem to technical support. Some of the program types below are accessible only by the ATX Administrator.

Client Programs When a client program encounters an error, the exception window appears. This window indicates the severity of the error (Fatal, Error, or Warning) and presents a text description of the condition. This information can be copy/pasted into a document for printing or into an e-mail for reporting to ESC Technical Support. See page 7 “Resolving Problems within ATX: The Exception Window” for more details.

Introduction E-DAS Ambient ATX Data Manager Guide

viii E-DAS Ambient ATX

Scheduled Programs When a scheduled program encounters an error, instead of displaying an exception window, it appends error information to the file Dnc\bgLog.txt. This file can be printed or e-mailed to ESC Technical Support personnel. However, log files can become quite large, and often only the most recent entries are important. Before emailing large files to ATX technical support, examine the file to determine which sections are necessary for ATX technical support to solve the problem.

Executive Startup As the Executive starts up, it records its progress and any errors in the Startup Status Log (AtxSS.txt). This file is located in the root of the x: drive that is running the Executive (where x is the drive on which the Executive is installed). It can be accessed from the menu bar in the Executive Monitor by selecting Tools Startup Status File. This file may be large and it is likely that only the last few lines are of importance.

Executive A running Executive reports periodic messages to the daily log file. This log file can be monitored by the ATX Administrator with the Executive Monitor program.

Reports can be extracted from the log files using Miscellaneous Reports Log Record. This is particularly convenient because the log report can be used to isolate only certain log messages, such as for a certain manager, date range, or log notification level.

The log files are excellent sources of diagnostic information about the Executive. Remember that a log file or a log report can be very large, and might require time to send in an e-mail.

E-DAS Ambient ATX 1

Chapter 1 Starting and Navigating ATX

How Do I Access ATX? Depending upon choices made during installation, an ATX program may begin automatically at login. If not, an ATX icon was probably set up on either the desktop or in the Windows Start menu.

Login To access network resources, you must provide a login id and password to Windows. ATX borrows this login id to identify users of ATX resources.

Windows NT 4.0 and Windows 2000 Login A computer running Windows NT or Windows 2000 presents a login dialog during startup and each time a user logs off. This login dialog requests a user id, a password, and possibly a domain name. A valid user id and password must be entered. If a domain is requested, it must be the domain through which the ATX server can be accessed. Your ATX Administrator can answer questions about your user account, password, and domain.

If an invalid user id/password/domain is entered, Windows NT issues an error message, and allow another login attempt.

Windows 95 Login A computer running Windows 98 or 95 presents the login dialog similar to that for Windows NT, but only if configured to access a Microsoft Windows Network. Windows 95 does not ask for the domain to be identified since the user id and password are not authorized until the network is actually accessed.

If a valid user id and password are not entered, Windows 95 might allow access to the computer but not the network. This can be confusing since many users expect access to the computer to mean all facilities are accessible. It may be necessary to logout, then login again.

Restricted Access It is possible that the ATX Administrator has assigned a given user a special category that has no sub-categories. If that is the case, the right pane displays the program icons that are set up for you to access.

Glossary of Terms ATX – Advanced Technology Executive.

Delimiter – a character that separates units of data in an ASCII string.

Chapter 1 Starting and Navigating ATX E-DAS Ambient ATX Data Manager Guide

2 E-DAS Ambient ATX

Window – any of the areas into which a computer display may be divided and on which distinctly different types of information are displayed.

What Is the ATX Launch Pad and How Do I Use It? The Launch Pad is the main window you use to access all functions. The Launch Pad structure and content can be customized by your ATX Administrator. This section describes the use of the Launch Pad as it is installed without customization.

Starting the Launch Pad Users familiar with Windows will recognize the “Explorer-style” structure of the Launch Pad.

To start the Launch Pad:

1. Double-click the ATX icon on the desktop, or select Start ATX.

A splash panel appears (unless it is disabled), and identify the version of ATX you are running and certain facility information as well. After a few seconds, the Launch Pad window appears.

2. From here, you can access all ATX programs.

The Launch Pad includes a menu bar at the top of the screen, a toolbar just below the menu bar, and a status bar (with time and date) at the bottom of the screen. Below the toolbar are two large panes: the left side displays the menu tree, and the right side contains program buttons for the menu item selected in the tree.

Using the Menu Tree The menu tree is used like Windows Explorer. Tree options that contain additional options have a plus sign (+) next to them.

E-DAS Ambient ATX Data Manager Guide Chapter 1 Starting and Navigating ATX

E-DAS Ambient ATX 3

Click the plus sign (+) to display the sub-options, or the minus sign (-) to contract the list of sub-options. Clicking a menu option also displays its program buttons in the right pane of the Launch Pad.

ATX The highest level option on the Launch Pad menu is ATX, which has no plus/minus box because it typically should be expanded.

Restricted Access The ATX Administrator can assign a given user a special menu option that may contain sub-options or only particular programs. If that is the case, the right pane displays the program icons to which you have access.

Favorites The topmost icon is the Favorites option. It has no sub-options but contains any programs the given user has designated as favorites. See page 4 “Adding Programs to Favorites” for instructions.

History Just below Favorites is the History option. This has no sub-options but does contain programs that have been previously run in this Launch Pad session. Once ATX is exited, the history is erased.

Report Categories ATX report options are listed beneath the History option. Report options include:

• General Output

• Periodic Reports

• Ambient Reports

• Conditional Reports

• Meteorological Reports

• Miscellaneous Reports

See the E-DAS Ambient ATX User Guide for more details.

Ambient Data Management This menu includes options for the following:

• Editing Ambient data and flags

• Deleting data

• Editing the AIRNow Forecast

• Performing Unscheduled Polling

• Viewing the Alarm Monitor


4 E-DAS Ambient ATX

• Import/Export

See Chapter 4, “Ambient Data Management” for details.

Automatic Recording of Launch Pad Appearance Each time the Launch Pad is closed, ATX records user preferences, then tries to reuse them when ATX is started next. These preferences include:

• The location of the window

• The size of the window

• The horizontal location of the vertical bar that divides the left and right panes

• The expanded menu categories

• The selected menu category

• Whether or not the toolbar was hidden

• Whether or not the status bar was hidden

• Whether or not programs are run with their windows aligned with the right pane

Adding Programs to Favorites Any program appearing in the right pane of the Launch Pad can be added to the Favorites folder at the top of the menu tree options list.

1. Select the option in the menu tree that contains the desired program.

2. Right-click the program’s button and select Add to Favorites from the popup menu. The program’s button is copied to the Favorites menu and appears in the right pane whenever Favorites is clicked.

Arranging Favorites To arrange the order of program buttons in Favorites, right-click a button then select Move to Start to move the program to the upper-left corner, or select Move to End to move the program to the end of the programs in the right pane.

The right-click menu contains the following additional three options:

Option Function

Remove from Favorites

Removes the program from the Favorites only.

Copy Copies the program button properties to Windows Clipboard, which can be pasted to other editing programs (such as Notepad).

Properties Displays the properties of the program button.

Launch Pad Menu Bar The menu bar contains four menus:

• File


E-DAS Ambient ATX 5

• View

• Launch

• Help

File Menu The only option here is Exit, which closes the ATX program.

View Menu If an option is checked, it appears on the screen. Any of the options may be selected independently by clicking it with the mouse. This menu has five options.

View Menu Option

Explanation

Toolbar Check this option for the toolbar to appear directly below the menu bar.

Status Bar Check this option for status bar to appear at the bottom of the window. This bar contains the current date and time.

Large Icons Check this option for the tree to appear with large icons instead of the default small ones. This works the same as the Large Icons button on the toolbar.

Menu Tree Check this option for the tree to appear. This works the same as the Show Menu Tree button on the toolbar.

Background Image

Select this option to modify the background image in the program button portion of the screen (right side). Use the Select File option to select a .bmp image from the \Dnc\Images folder as the background image. Select Tile and Stretch to duplicate the image to fill the background area, or stretch a single image to fill the background area.

Launch Menu The Aligned option is used to position program windows on the screen. If Aligned is checked when a program is started, the program window appears in the right pane of the Launch Pad. If Aligned is not checked, the program window appears in the same position it was in before it was last closed.

Help Menu This menu currently presents three options: Contents, Q & A, and About.

Help Menu Option Explanation

Contents This option is not currently implemented.

Q & A Select this option to enter a word or phrase in the Keyword field. Click the Go button to view topics related to the keyword entry.

About This option displays a screen with the release number of your ATX product. The Properties button displays a three tab window with details on your ATX installation (see “ATX Properties Window” for details).


6 E-DAS Ambient ATX

ATX Properties Window The ATX Properties window is available from any client program through the Help About menu bar option. The Properties window has three tabs of information. The information in these tabs can be modified only by the ATX Administrator, and can be useful troubleshooting system errors or problems.

ATX Information Tab This tab shows the current software release, the current user, the Executive server and the ODBC data source name.

The Root Folders fields show the Run-time (Rt) folder and the Data-n-Config (Dnc) folder.

System Information Tab This tab identifies the current computer, the number and type of processors, the current directory and the command line used to execute this program.

ATX Resources Tab This tab lists each ATX resource, along with each of their indices and value. By default, this table is sorted alphabetically by resource name. Click any column heading to sort the table by that column’s contents.

These settings are configured only by the ATX Administrator, and can be very useful in troubleshooting system errors or problems.


E-DAS Ambient ATX 7

Launch Pad Toolbar The toolbar includes two options for controlling the option tree.

The Show Menu Tree button shows or hides the menu tree on the left side of the Launch Pad.

The Large Icons button toggles the menu tree items to large icons or small icons.

Launch Pad Status Bar If Status Bar is checked in the View menu, the bar at the bottom of the Launch Pad window shows the current date and time. The status bar is constantly updated when ATX is running.

Resolving Problems within ATX: The Exception Window

ATX displays an exception window when an exceptional condition is encountered. The exception window usually describes the condition of the problem or exception, and provides a possible cause for the condition. This makes resolving problems easier.

The exception window shows a title bar caption describing the problem. It shows an icon in the upper left corner followed by text to indicate the type of exception. Below the type is a text box with a message about the condition.

The “exceptional condition” could be any of the following types:

Type of Condition Reason

Question The program needs a simple yes or no answer from you.

Information The program is giving you information, but no real problem exists.


8 E-DAS Ambient ATX

Type of Condition Reason

Warning A condition exists that could be a problem, but the program cannot make that determination.

Error A real problem exists, but the program tries to continue operation.

Fatal Error An error that prevents the program from continuing.

Below the message text are a series of buttons:

Option Button Function

OK Click the OK button to close the exception window, and return control to the program.

Cancel Click the Cancel button to close the exception window. Depending upon the situation, the program will or will not continue the operation.

Show Details If applicable, a Show Details button is displayed. Click this button to open up a second text box showing details of the exception. The detailed information is intended for use by an analyst to resolve the problem.

Copy Click the Copy button to copy the exception to the Windows Clipboard. This copies the following information in order to record the problem for a technical support analyst to review:

• The date/time of the exception

• The program name

• The software release

• The context of the exception (taken from the exception title bar)

• The message text

• The details text if present

Backup Strategies Third-party tools should be used to handle data backup. When older data is purged, it may be “archived” to a file or “deleted.” This, however, does not backup all configurations and data on a regular basis to compensate for unplanned occurrences such as computer hardware failure.

Data Logger Console Window You can emulate a data logger console using the HyperTerminal (which is a part of Windows) to make a serial link to a data logger and view the data logger console in the HyperTerminal window.

E-DAS Ambient ATX 9

Chapter 2 ATX Data

What Are the Types of ATX Data? This section is dedicated to background on the Ambient ATX System required by a data manager.

ATX data is made up of the following types:

• Readings data

• Non-readings data

The structure of each of these data types is discussed in detail in the following sections.

Glossary Terms Annex – a means of grouping like parameters (from different sites) into pollutant groups for the purposes of setting index limits, reporting, and analysis.

Ambient data – readings data (with flags) generated from Foundation readings, data is modifiable.

Annotation – a text note attached to one or more Ambient readings.

Foundation data – raw readings (with flags) received from the data logger, data is not modifiable.

Parameter – a monitored pollutant, meteorological event, or other measured entity.

Perspective – averaging intervals associated with a specific parameter.

What Are Readings Data? There are two sets of readings data: Foundation readings and Ambient readings.

• Foundation readings are the unedited raw readings acquired from the data logger.

• Ambient readings and flags are generated from Foundation readings and flags, and may be edited for accuracy.

Sites, Parameters and Perspectives The Configuration program in ATX includes a model of the data acquisition system (DAS). Configuration Explorer uses a familiar Windows tree structure to organize all the following DAS items:

• Systems

• Sites associated with each system

• Parameters associated with each site

• Parameter perspectives (average intervals) associated with each parameter

The Configuration tree also includes other site information such as the following:

• Calibrations (including calibration-affected parameters)

Chapter 2 ATX Data E-DAS Ambient ATX Data Manager Guide

10 E-DAS Ambient ATX

• Digital inputs/outputs

• Digital events

• Average and calibration alarms

Data readings are stored as they are acquired, each associated with a parameter perspective.

Foundation Readings This data is maintained separately from Ambient readings, and is rarely included in reports. Each parameter reading received from the data logger is recorded as a date/time stamped value along with the associated flags. These raw readings are stored directly in the ATX database in the Foundation table along with the acquisition date/time, which can be different from the date/time stamp.

You cannot edit Foundation readings within ATX. They remain an intact reference to the actual data acquired. Ambient readings are the data that can be edited. However, Foundation readings may be used to rebuild Ambient data that has become corrupted or otherwise lost (see page 36 “Rebuild from Foundation”).

Ambient Readings Other than very limited uses for Foundation readings, ATX functions are based almost entirely on Ambient readings.

Just after a Foundation record is written, a corresponding Ambient reading is generated and stored in the Ambient tables. Readings are rounded according to the number of decimal places set in the parameter properties.

Ambient readings have extended flags (stored in the database as Yes/No fields for easier reporting) plus an associated AIRS null-code and validity flag. For details on AIRS null-codes, see 11 “AIRS Null Code.” For details on editing values or flags for Ambient Readings, see page 27 “Editing Ambient Readings and Flags.”

Annotations, or text notes, can also be added to each Ambient data record. See page 35 “Adding/Editing Annotations to Data Points” for details.

Ambient Flags Each of the parameter’s configurations has a set of data logger flags that are to be mapped to each ambient flag. For the given parameter perspective, Ambient data flags are set during the import of data logger response strings based on their association with data logger flags.

The 22 ambient flags are defined as follows:

One-Character Name Three-Character Name Description M MIS Missing

I INV Invalid

S SUS Suspect

C CAL Calibration

N MNT Maintenance

E-DAS Ambient ATX Data Manager Guide Chapter 2 ATX Data

E-DAS Ambient ATX 11

One-Character Name Three-Character Name Description D DIS Disabled

P PWR Power fail

A ADJ Adjusted

Q QAV Quality Assured Validated

E EDT Edited

R RET Retrieved from Archive

L LOC Locked

0 UD0 User-defined 0










Note: One-character names for flags appear most commonly in reports and editors. Also, it is possible for the ATX Administrator to reassign different character names, attach labels to user-defined flags, and redefine flag priority. Consult the ATX Administrator if problems occur with flags.

By default, user-defined flags are considered non-priority flags, while all others are considered priority flags. In certain instances, a distinction is made between priority and non-priority flags.

AIRS Validity Flag The AIRS Validity flag is set to 0 (zero) for all valid data, and 9 for all invalid data.

AIRS Null Code All valid data is assigned an AIRS null code of 0000 by default. All invalid data is assigned a null code of “####.” However, the Ambient Null Code Lookup table associates a character with each null code (see page 46 “AIRS Null Code Configuration” for instructions on using the Ambient Null Code Lookup table).

If the record has an ambient flag set, and the flag corresponds to a null code, then that null code is assigned to the record. If more than one ambient flag corresponds to a null code, then the null code of the highest priority flag is assigned to the record. Ambient flag priority can only be modified by the ATX Administrator.

Chapter 2 ATX Data E-DAS Ambient ATX Data Manager Guide


Data Logger Flags Data logger flags are currently translated into Ambient flags, then the AIRS fields are filled with defaults. The translation of flags is based on the configuration of each parameter perspective’s map of data logger flags to Ambient flags.

Values are assigned in real-time when:

• values are acquired

• data logger response strings are imported

• they are requested for resetting ambient edits

Annotations Annotations are text notes attached to one or more Ambient readings.

ATX software supports annotations entered in the Ambient Readings Editor, which is used by all the following data editing programs:

• Edit Values Only

• Edit Values & Flags

• Edit Records

These data editing programs are available under the Ambient Data Management option of the Launch Pad tree. See page 35 “Adding/Editing Annotations to Data Points” for more detail on Annotations.

What Are Non-Readings Data? “Non-readings” data include calibration data and site data, which are not the result of analyzer readings. This type of data results from settings and information configured by the ATX Administrator.

Site Data Site data are a collective term used for all data gathered from the site and that remains associated with the site, but site data is not readings or calibration data. Site data includes the following types:

• Digital Transitions – These are stored one record per transition. The record stores the association to the configured site:digital, transition date/time, and the transition-to value.

• User Messages – These are stored one record per message. The records store the association to the site, registered date/time, and the message text of up to 248 characters.

• Power Failure Records – These are stored one record per failure event. The records store the association to the site, and start and end date/times.

Calibration Data ATX stores calibration results in database tables with one record per calibration sequence:phase:channel. For example, a single calibration with two data phases and three affected channels per phase would result in 6 records. The records store the association to the sequence, phase, channel, cal start and end date/time, actual value, expected value, and the two highest

E-DAS Ambient ATX Data Manager Guide Chapter 2 ATX Data


priority data logger flags. A variety of additional information is calculated dynamically at report time.

Parameter Basics A parameter is one of three types:

• Monitored pollutant (e.g., SO2 or NOX)

• Meteorological event (e.g., temperature, wind speed)

• Other measured entity (e.g., PM-10)

Understanding Annexes Annexes are a way of grouping parameters together for reporting purposes. For example, you use the AIRNow annex to link or group ozone parameters from multiple sites. This is helpful especially if a parameter has been spelled differently from site to site, it would be impossible for the system to identify the parameters as the same. For example, ozone may be spelled OZONE at one site, O3 at another site, and OZ at yet another site.

The most common types of annexes used are: AIRNow, AQI (Air Quality Index), MET (Meteorological), AIRS (Aerometric Information Retrieval System), and VOS (Violation of Standards). In an AQI annex, you can set index limits, and link multiple parameters from multiple sites.

For instance, in the case of an index-type annex, the values of a parameter would be subject to linear interpolation to the index breakpoints of the associated annex parameter. Changes to the annex parameter are automatically reflected in all associated parameters.

A site parameter can be associated with as many annex parameters as is needed and in as many annexes as needed.

Annexes are typically configured by the ATX Administrator.


Chapter 3 Criteria Windows

What Are Criteria Windows? Criteria windows are multi-field selection screens that allow you to determine what data will be used for a particular task. criteria windows are used by programs for editing data, importing/exporting data, and generating reports. When one of these programs is selected, its criteria window appears.

The fields presented depend on the specific program selected, but the following sections cover the most common cases.

The selection fields usually include:

• Source (i.e., site, Site:Parameter, Annex:Parameter, or Cal Affected Parameter)

• Method (i.e., 001m, 001d, etc.)

• Begin Date/Time and End Date/Time

• Other output specific options based on the operation being performed (such as the options for Batch Edit, Delimiter, or Print Properties)

Fields specific to a particular task are explained in the section covering that task.

Using Criteria Windows Criteria settings are selected from scrollable pick lists, check boxes, and date fields.

Note: Other fields and settings may appear in the criteria window respective to the report that you are running; however, the majority of criteria window fields and functions are covered in this section.

Chapter 3 Criteria Windows E-DAS Ambient ATX Data Manager Guide


Complete the following steps to select data for data editing, or generating reports or other output.

1. Select one or more data sources from the scrollable list box. Sources may be labeled Site, Annex:Site, Site:Parameter, Annex:Parameter, or other names depending on the program you have selected. See page 17 “Sources of Data” for more detail.

2. Select the Method for the desired data. The options listed are the averaging methods used for most parameters (1m, 5m, 6m, 15m, 1h, and 1d being the defaults). The Method field is not used by all programs. Most programs allow only one method to be selected at a time.

Note: The list of available methods may be modified by the ATX Administrator. See the ATX Administrator for assistance.

3. Select the time span for data to be included using the Begin Date/Time and End Date/Time fields. The initial Begin Date/Time and End Date/Time are the current date and time. For a full explanation of all time selection options, see page 18 “Time Range for Data.”

4. Select whether or not to format the output (reports and other outputs only). Click to check the Format box to leave the output formatted, or uncheck the Format box to output the data to an unformatted file.

If the report is going to be interpreted by another program, select Unformatted. Unformatted output is the same information as formatted output except a delimiter is used to separate information, and the page headers and footers are not used.

5. Select a Delimiter if unformatted output is requested. This indicates the field delimiter to be used in the output file.

There are four field delimiter options:

• Comma

• Semicolon

• Colon

• Tab

Tab-delimited text is the most common selection for import into popular spreadsheets or pasting into applications from the Windows Clipboard. You may also want to consider exporting data in other formats (see page 43 “Exporting Readings Data” for details).

6. For reports, click the Print Properties button to adjust the printer settings (see page 19 “Print Properties” for option details). When changes to the settings are complete, use one of the following:

Option Function

OK Saves the settings and returns to the criteria window.

Cancel Ignores the settings changes and returns to the criteria window.

Reset Restores the settings to what they were when you opened the Print Properties window.

Defaults Returns all settings to the system default values.

7. Once the criteria window selections have been entered, click OK to continue. The next screen to appear depends on the program in use (such as editing data or printing a report). For information on saving, copying, and re-using criteria window settings, see page 21 “Reusing Criteria Settings.”

E-DAS Ambient ATX Data Manager Guide Chapter 3 Criteria Windows


Some programs may take a short while to process after the OK button is clicked. In such cases, the image on the OK button animates to indicate processing. Click the Cancel button to exit the criteria window and return to the ATX Launch Pad.

Sources of Data Click on the desired sources of data in the list to highlight them. Sources may include Site, Site:Parameter, Annex:Parameter, or Cal Affected Parameter depending on the program you are using.

The buttons at the bottom left of the list box are used to expand your selection.

Select – This button selects all items in the list.

De-select – This button de-selects all items in the list.

Invert – This button reverses the current selection status for all items on the list. In other words, it selects all items that were unselected and de-select all items that were selected. This can be useful when all but a few items need to be selected. Select the few you don’t need, then use the invert button to de-select these and select all the other items.

The buttons at the bottom right of the list box are used to expand a single selection to include those with a similar source.

• Site – This button expands a selection to include all items within the highlighted item’s site. For example, if the site:parameter EASTSIDE:O3 is selected, clicking the Site button highlights all parameters for the site EASTSIDE.

• Parm – This button expands a selection to include all items for the highlighted item’s parameter. For example, if site:parameter EASTSIDE:O3 is selected, clicking the Parm button highlights all items with a parameter name of O3.

Note: The Parm button only selects parameters that have exactly the same name. In other words, it there are ozone parameters at two sites, but one is named O3 and the other is named OZONE, the Parm button views them as different parameters.

• Annex – This button, if available, expands a selection to include all items within the highlighted item’s Annex (pollutant). If the item EASTSIDE:O3:OZONE (site:parameter:annex format) is selected, click the Annex button to highlight all items that show OZONE for the annex. Annexes are configured by the ATX Administrator for various reporting, such as AIRNow, AQI reporting, or Frequency Distribution Index reports.



Time Range for Data The date and time of data to be used in the various criteria windows can be specified in three ways:

• Adjusting Begin and End Date/Times

• Modifying the Date/Time Interval

• Selecting a Date/Time Range

Adjusting Begin and End Date/Times There are several ways to adjust the begin and end date/times.

Click one of the specific fields (year, month, day, hour, minute) in either date/time box and type in the desired value.

Use the up/down arrows to the left of each field to scroll the highlighted portion of the date/time up or down. For example, if the month is highlighted (click in the date/time field to select the month for highlight) then the arrow buttons scroll the month.

Use the double up-arrow to the right of the Begin Date/Time field to increase both the begin and end date/times by one “interval”.

Use the double down-arrow to the right of the End Date/Time field to decrease both the begin and end dates by one “interval”.

The interval used can be viewed or changed in the Select Date/Time Interval window (see “Modifying the Date/Time Interval” for details).

Select a date range for data using the Select Date/Time Range dialog box (for details, see page 19 “Selecting a Date/Time Range”).

Modifying the Date/Time Interval Display the Select Day/Time Interval dialog box by clicking either the left or right arrow button to the right side of the date/time fields ( or ).

Type in a date/time interval using the standard time designators (1d equals one day, 1h equals one hour, etc.). Use the up/down arrow buttons to increase or decrease the interval by one minute per click. The standard time designators may be combined to create custom intervals.



Example:

When designating a Date/Time Interval, 1d creates an interval of one day:

1d4h creates an interval of one day and 4 hours

1h6m creates an interval of one hour and six minutes, etc.

Select Fix at End or Fix at Beginning using the button in the lower right portion of the window. The button toggles from Fix at End to Fix at Beginning.

• Fix at Beginning mode – Click Fix at Beginning to insert the current date and time in the Beginning Date/Time field, to add the Date/Time Interval to the Beginning Date/Time, which derives the End Date/Time.

• Fix at End mode – Click Fix at End to insert the current date and time in the End Date/Time field, to subtract the Date/Time Interval from the End Date/Time, which derives the Beginning Date/Time.

Selecting a Date/Time Range Click the button with two facing arrows ( ) in the criteria window to display the Select Date/Time Range window for selection of a range of data.

Click the Range Type desired, then click and drag a range of times or dates in the Select Range. This indicates the beginning of the range.

Click OK to return to the criteria window.

Print Properties The Print Properties button in the criteria window displays the Print Properties window. This window contains a variety of options for controlling your output.



• Title – This text appears in the report and on the title bar of the criteria window.

• Criteria Cover Sheet – Check to include the criteria cover sheet in the output. The criteria cover sheet has information common to all pages of the report. This may include the criteria used to generate the output and legends for specific flags and codes that appear in the report.

• Font Size – Choose a font size from 6 to 12 points.

• Orientation – Choose portrait or landscape page orientation. The resulting page dimensions are displayed in characters by lines in the font/orientation frame. Reports are adjusted to best-fit on the page dimensions.

• Form – Select Letter for 8 ½ by 11, Legal for 8 ½ by 14, or Wide for 11 long by 14 wide (US Fanfold).

• Printer – Select a printer for the report.

• Command – Select the output for the report. Standard choices include:

• UtlViewer – Select this option to view and modify the report, and then optionally print the output or save it to a file.

• UtlPrinter – Select this option to send the report directly to the indicated printer without user intervention.

• NONE – Select this option to write the report to a file without further processing.

Note: The ATX Administrator may have added commands to this list, and will be the best source of information on their use.

• Arguments – Include any command line arguments you want added to the selected Send To command. The default commands, UtlViewer, UtlPrinter, and NONE do not require any arguments; however, customized commands might require an argument. For example, an added Send To command that redirects a report to e-mail may accept an e-mail address as an argument.

Note: Use the NOFARGS argument when sending a report to Excel. The NOFARGS argument allows the file to be sent to Excel without formatting arguments like Font or Font Size. These arguments will cause Excel to generate runtime errors.

• Output File and Folder – Specify the file name under which you want to save the output. By default, the output is written to a file in the Dnc\Temp directory under the name of the program.

Criteria Window Menu Bar Options Each criteria window has a menu bar with these standard options:

Menu Options

File Open – Opens a previously saved criteria file. Save – Saves modified criteria setting to its file. Save as – Saves criteria settings to a new file. Exit – Closes the criteria window.

Edit Copy – Copies the criteria settings to the Windows Clipboard. Paste – Pastes whatever is on the Windows Clipboard to this criteria



Menu Options window. Structure – Displays the field structure for this criteria window, and allows temporarily adding or eliminating fields from the window.

Help Options here are the same as Help on the Launch Pad menu bar (see page 5 “Help Menu”).

Reusing Criteria Settings Once the criteria window is completed, the settings can be:

• Copied/pasted from one criteria window to another

• Saved to a file that can be recalled in any criteria window

Copy/Paste Criteria Settings To copy/paste settings from one criteria window to another, complete the following steps:

1. After you have made your settings in a criteria window, select Edit Copy on the menu bar.

The settings are immediately copied to the Windows Clipboard, and can be pasted to another criteria window or anywhere text can be pasted.

2. Select another report or other output option. When the criteria window is displayed, select Edit Paste.

All matching field selections that were copied from the prior criteria window are pasted into the current criteria window. If the receiving criteria window has more fields that the criteria window from which the settings were copied, you will need to complete the unmatched fields. If the receiving criteria window has fewer fields than the original criteria window, the unmatched fields aree ignored.

Save Criteria Settings as a File Saving criteria settings to a file can be useful if certain reports need to be run with the identical settings each time. You can save as many criteria files as desired.

To save criteria settings to a file for use at a later time, complete the following steps:

1. After you have made your settings in a criteria window, select File Save As.

The Criteria Save As dialog box opens and prompts you to enter a name for the criteria file (maximum 16 characters). The default name is usually the name of the program currently running (i.e., RptHSiteDet for the Hourly Site Detail report).

2. Accept the default name, or enter a new name, and then click OK.

The criteria file is saved under the name specified.



To retrieve a criteria file when in a criteria window:

3. Select File Open Criteria.

The Open Criteria dialog box opens and displays a list of previously saved criteria files.

4. Select the desired criteria file, and then click OK.

If Apply Structure is checked, then the criteria window takes on the appearance of the saved criteria. For example, if a Columnar report’s criteria (RptColumnar) is opened in the AIRS Report’s criteria window, the fields change to match those in the Columnar criteria. This feature is rarely used.

The criteria window automatically changes to reflect the retrieved criteria.

Note: If you make changes to the retrieved criteria, and you wish to save the changes to the same filename, use the File Save command.

Positioning the Criteria Window To position the criteria window on your screen, select Launch on the Launch Pad menu bar. If Aligned is checked, all criteria or program windows open aligned in the right pane of the Launch Pad. If Aligned is not checked, all criteria or program windows open in the same location as when they were last closed.

Understanding ATX Reports This section describes the various report programs and other output programs that function similarly.

All reports have commonly structured page headers with the title of the report in the upper left corner, and the page number in the upper right. Note that the report title can be customized. The “Generated Date/Time” appears in every page header, just below the report title, as well as at the top of the Criteria Cover Sheet (if used). The date/time includes seconds, which can be used to match up any stray report pages.

A Criteria Cover Sheet can be printed with each report, which prints a copy of the criteria used to generate the report, as well as any legends required for interpreting the report.

Missing and Invalid Readings You may see the following characters on the reports instead of data. However, these characters are set by default, and can be changed by the ATX Administrator.



Character Meaning … missing records (null)

!!! invalid records

*** have data, but flagged as missing

### valid data, but does not fit in allocated space

If there are no records matching the given criteria, the report is blank, or contains the message “NO DATA.”

Using the Viewer Utility By default, text reports are channeled to the Viewer Utility.This program allows you to view the output, and print the report if desired.

The Viewer Utility has capabilities that go beyond view and print. Access these added features from the menu bar and toolbar.

Task How to To print the report: Select File Print, or click the printer icon on the toolbar.

To search for text: Select Edit Find, Find Selected, or Find Next, or highlight text, and press Ctrl and F3.

To save the report: Select File Save.

To change printers, page orientation, point size, etc:

Select File Print Properties.

Note: In the case of particularly long reports, the Viewer Utility displays a user interface while the text is still loading. The scroll bar continues to move while the text is loading.

To send the report directly to the Windows Print Manager without viewing it in the Viewer Utility, change the Send To criteria in the Print Properties dialog from UtlViewer to UtlPrinter.

Viewer Utility Menu Bar The Viewer Utility menu bar contains File, Edit, View, and Help menus. The following tables detail the menu options.

File Menu Other functions also appear as toolbar buttons, and are as follows:

File Menu Option Function

New Opens a new blank file.

Open Opens any other existing report or file.

Exit Closes the Viewer Utility and returns to the criteria window.



Edit Menu Many of these options also appear as toolbar options.

Edit Menu Option

Function

Cut Cuts highlighted text from the screen and copies it to the Windows Clipboard.

Copy Copies the highlighted text to the Windows Clipboard.

Paste Pastes text from the Windows Clipboard to the cursor location.

Delete Deletes highlighted text from the screen.

Select All Highlights (selects) everything in the Viewer.

View Menu The Resize Window option returns the window to its default dimensions if it has been resized manually (by clicking and dragging the corners).

Help Menu This is the same as the Launch Pad Help menu.

Toolbar The toolbar includes many of the same options as the menu bar.

Toolbar Option Icon Function

New Opens a new blank file.

Open Opens any other existing report file.

Save Saves the displayed Viewer content, using the file name shown in the window’s title bar, usually the report’s name.

Print Displays the Print Properties window. Click OK to print, or change by selecting File Print Properties on the Viewer Utility’s menu bar.

Cut Cuts highlighted text from the screen and copies it to the Windows Clipboard.

Copy Copies the highlighted text to the Windows Clipboard.

Paste Pastes text from the Windows Clipboard to the cursor location.

Delete Deletes highlighted text from the screen.

Find Text Displays a search criteria dialog for entry of text to be found.

Find next occurrence of selected text

Searches for the next occurrence of the text currently selected (highlighted) in the Viewer.



Toolbar Option Icon Function

Find next occurrence of search string

Searches for the next occurrence of the text entered in the search criteria dialog (Find Text option).


Chapter 4 Ambient Data Management

What Is Ambient Data Management? Managing your Ambient data involves editing, deleting, and acquiring the data. You can manage Ambient data using the options that are available in the Ambient Data Management menu. On the Launch Pad, select Ambient Data Management from the menu tree. The following programs are available:

• Editing Ambient Readings and Flags

• Deleting Data

• Editing the AIRNow Forecast

• Configuring Unscheduled Polling

• Viewing the Alarm Monitor

• Importing and Exporting Data

The Ambient Data Management window contains program buttons for each of these functions, which are explained in the following sections.

Editing Ambient Readings and Flags There are a number of reasons data may need to be edited, such as the following:

• Data from the data logger has been purged prior to polling, but the data exists in printed format so you can enter the data

• Scaling of the data is incorrect due to some configuration issue

• Parameters have been assigned to the wrong channel

• Flags have been configured incorrectly

• AIRS codes must be assigned to missing data

Each of these conditions can be addressed with the Ambient Readings Editor. The Ambient Readings Editor can be accessed through three programs designed for editing polled data:

• Edit Values Only

• Edit Values & Flags

• Edit Records

When any of these programs are accessed, data values for the selected sites/parameters, average/calculation method, and time span appears in a spreadsheet format.

The only difference between the three programs is the number of columns displayed when the Readings Editor initially opens. The three programs allow you to select one that best suits your

Chapter 4 Ambient Data Management E-DAS Ambient ATX Data Manager Guide


needs; however, there are six buttons on the Readings Editor toolbar that you can use to change which columns are displayed.

• View Values

• View Priority Flags

• View Non-Priority Flags

• View Null Codes

• View Validity Flags

• View Annotation Counts

The following table shows which toolbar options are invoked when each program is opened.

Options Activated Edit Values Only Edit Values & Flags Edit Records

View Values x x x

View Priority Flags x x

View Null Codes x

View Validity Flags x

View Annotation Counts x

The option View Non-Priority Flags is not activated in any of the three programs, but it is available on the View menu.

The “Edit Values Only” program is explained in detail in the following section. The other two edit programs use the same criteria window and Readings Editor screen. The only difference is the data columns displayed when the Readings Editor screen initially opens.

For information on the Batch Edit feature for modifying large amounts of data for multiple sites/parameters at the same time, see page 29 “Batch Edit Data.”

Edit Values Only Select Edit Values Only from the Ambient Data Management menu if you only want to see data values and not flags. The criteria window appears. This criteria window is very similar to those used for reporting, and is explained in detail on page 15 “Using Criteria Windows.”

E-DAS Ambient ATX Data Manager Guide Chapter 4 Ambient Data Management


To select data for editing, complete the following steps:

1. Select the desired Site:Parameters.

See page 17 “Sources of Data” for more detail on use of the buttons below the Site:Parameter list box.

2. Select the Method for the data to be edited.

The options listed are the averaging methods used for most parameters (1m, 5m, 6m, 15m, 1h, and 1d being the defaults).

Note: Your ATX Administrator can modify the list of available Methods by adding the CRIT_METHODS resource in the Resource Editor program.

3. Select the time span for values to be loaded into the Readings Editor using the Begin Date/Time and End Date/Time fields. The initial Begin Date/Time and End Date/Time are the current date and time.

See page 18 “Time Range for Data” for more detail on the criteria window options used to select the date/time range for data. See page 21 “Reusing Criteria Settings” for information on saving criteria settings for reuse later.

4. Click to select the Batch Edit option if you want to edit all data values and flags for the selected criteria at one time. See “Batch Edit Data” for details on this feature.

Once all selections have been made in the criteria window, click OK to display the Ambient Readings Editor (if Batch Edit was not selected). For details on using the Ambient Readings Editor, see page 32 “Ambient Readings Editor.”

Batch Edit Data The criteria window used by each of the data editing programs includes a Batch Edit option. This allows you to edit large segments of data at one time, which can be useful in many situations.

Example:

In the case of a parameter being scaled incorrectly, Batch Edit lets you double-click the Value field, select Linear Translation, and enter the correct slope. All data selected are correctly scaled.

Another case scenario would be storm damage to the shelter or a type of situation that results in missing data. You will need to report an AIRS null code to explain this missing data. Check the



Populate Missing Records option, and enter the correct AIRS null code (right-click the field in the Null column to view a list of configured null codes). If AIRS Auto-Coding has been enabled (see page 45 for details), a 9 automatically appears in AIRS Validity Flag column (Vld). If AIRS Auto-Coding is not enabled, manually enter a 9 in the Batch Edit screen’s Vld field. This correctly flags all data for the selected criteria.

To use Batch Edit, complete the following steps:

1. Select any one of the ‘Edit’ program buttons in Ambient Data Management.

The criteria window for the Readings Editor appears.

2. After making your criteria selections (see page 28 “Edit Values Only” for details on the criteria window), click the Batch Edit check box, and then click OK.

The Batch Edit window appears. This window contains a single data line with a single Value field, followed by the standard flag options. Question marks indicate that the actual data may not be the same.

3. Enter the desired value directly in the Value field, or double-click the Value field (or right-

click the Value field and select Edit) to display a Value Editor screen with several options for changing the value. See “Value Editor” for details.

4. Select or clear the Populate Missing Records check box. This check box, if selected, causes the value and flags entered here to replace any missing values within the selected criteria.

Note: The Populate Missing Records check box is selected by default. Your ATX Administrator can change this default setting by editing the EDIT_BATCH_DFL_POP resource in the Resource Editor.

5. Click OK to apply the value and flag selections to all readings for the selected sites/parameters in the selected date/time range. Any field that was not changed will have no change applied.

Value Editor This screen appears when the Value field is double-clicked in the Batch Edit screen or in any Edit screen.

• Specific Value – Use this option to enter a specific value and apply it to the selected data.

• Minimum Detectable – Use this option to replace selected data with the minimum detectable value in each parameter’s configuration.

• Maximum Detectable – Use this option to replace selected data with the maximum detectable value in each parameter’s configuration.



• Linear Translation (slope/intercept) – Use this option to apply the specified slope and intercept to the existing value in the standard linear interpolation equation (value times slope plus intercept, or mx+b). This is helpful when scaling and/or offsetting of the value is necessary.

Click OK to apply the entries to the selected field, or click Cancel to return to the Readings Editor window without making any change to the value.

Edit Values & Flags Select Edit Values & Flags in the Ambient Data Management window to edit flags along with values. The Readings Editor displays the Value column and all priority flag columns.

The criteria window appears. This criteria window is very similar to those used for reporting.


1. Select the desired site(s’) parameters.



3. Select the time span for values to be loaded into the Readings Editor using the Begin Date/Time and End Date/Time fields. The default Begin Date/Time and End Date/Time are the current date and time.

4. Click to select the Batch Edit option if you want to edit all data values and flags for the selected criteria at one time (see “Batch Edit Data” on page 29).

Edit Records Select Edit Records in the Ambient Data Management window to edit the following data:

• Value

• All priority flags

• AIRS Null code



• Validity flag

• Annotation count

The criteria window appears. This criteria window is very similar to those used for reporting.


1. Select the desired site(s’) parameters.



3. Select the time span for values to be loaded into the Readings Editor using the Begin Date/Time and End Date/Time fields. The default Begin Date/Time and End Date/Time are the current date and time.

4. Click to select the Batch Edit option if you want to edit all data values and flags for the selected criteria at one time (see “Batch Edit Data” on page 29).

Ambient Readings Editor The Reading Editor displays data in a spreadsheet-like format. The date and time are listed down the left side of the spreadsheet, with the sites and parameters across the top.

The type of editing being conducted (Edit Values Only, Edit Values and Flags, or Edit Data) determines how many columns of data are displayed when the Reading Editor opens, though this can be adjusted using the toolbar buttons for different flag types.

Each of the fields is explained in “Readings Editor Data Fields.”



Readings Editor Data Fields

Data appears in columns arranged across the editor, ordered by source (i.e., Site, Site:Parameter):

• Value – Click the desired cell then type in the desired value. Double-click the cell for the Value Editor to display (see “Value Editor” on page 30 for details).

To edit multiple records, click and drag the mouse to highlight the desired cells, then select the Block Modify button on the toolbar (see page 35 “Readings Editor Toolbar Options”) or Edit Block Modify from the menu bar (see page 34 “Readings Editor Menu Bar Options”). When the Block Edit dialog appears, type in the desired value, or double-click the Value field to display the Value Editor.

To modify the Value field for all records in the Readings Editor at one time, double-click the Value column header. The Value Editor appears. Entries affect all records.

• Flags – An ‘active’ flag cell contains an X, while an inactive cell is blank.

To modify a flag for a single value, double-click the cell. You can also right-click the cell and select either On (active), Off (inactive), or Toggle (switches active to inactive, or inactive to active).

To modify a flag for all values (the entire flag column), right-click the header for the desired column. As before, select either On (all cells in the column become active), Off (all cells in the column become inactive), or Toggle (switches active cells to inactive, and inactive cells to active). You can also toggle an entire flag column by double-clicking the column header.

To modify a flag for a range of values, but less than the entire column, click and drag the mouse to highlight the desired flag cells. Next, select the Block Modify button on the toolbar or Edit Block Modify from the menu bar. When the Block Edit dialog appears, double-click the flag cell to the desired active or inactive status.

To modify multiple flags at the same time, whether for one value or multiple values, you must use the Block Modify mode. Click and drag to select the desired values, then select Block Modify (Block Modify button on the toolbar or Edit Block Modify on the menu bar). When the Block Edit dialog appears, any of the columns displayed may be modified for all the selected values.

• Null Code/Validity – A Null Code or Validity Flag can only be altered one cell at a time, except in Block Modify mode (see “Readings Editor Menu Bar Options” for details).



To change a Null Code cell, right-click on it and select the desired code from the pop-up list (see the ATX Administrator for details on Airs Null Codes Configuration). When a Null Code is entered, the Validity Flag is set to 9 automatically, indicating an invalid value

When a Null Code is deleted and the Validity Flag is 9, the Validity Flag is deleted as well. For information on AIRS Auto-Coding, see page 45 “AIRS Auto-Coding”.

When data changes are complete, select File Exit to close the Ambient Readings Editor (you will be prompted to save your changes) and return to the criteria window to select additional data for editing, or to click Cancel and close the criteria window.

Readings Editor Menu Bar Options The following options are available on the menu bar in the Readings Editor:

File Menu

Option Function

Save Saves any changes made to the data.

Refresh Null Codes List

Implements any changes made to the AIRS Null Codes list since the Edit window was opened.

Edit Menu

Option Function

Select All Use to select all cells displayed in the Readings Editor.

Block Modify Select data by clicking and dragging the mouse on the spreadsheet to highlight data to be modified. After data has been highlighted, select the Block Modify option to display a window similar to the Batch Edit function on the criteria window (see page 29 “Batch Edit Data” for details), with two exceptions: - There is no Populate Missing Records option. - Only the columns displayed in the Readings Editor appear for modification. When the Block Modify dialog appears, make the desired entries for the data and/or flags to be changed.

Rebuild from Foundation

Use to rebuild Ambient readings from Foundation readings and perform AIRS Auto-coding. See page 36 “Rebuild from Foundation” for more detail on this procedure.

Annotation Use to edit the annotation for all highlighted data values. See page 35 “Adding/Editing Annotations to Data Points” for details on annotation notes.

Null Code List This displays the Lookup Table Configuration window for editing the list of configured AIRS Null Codes. See page 46 “AIRS Null Code Configuration” for details on this process.

View Menu These options correspond to the toolbar buttons for viewing data columns. See “Readings Editor Toolbar Options” for details.



Help Menu This menu is the same as the Launch Pad Help menu. See page 5 “Help Menu” for details.

Readings Editor Toolbar Options Buttons appear on the Readings Editor toolbar for the following options:

Toolbar Button Function

Save Changes Saves changes made to values or flags without leaving the Readings Editor window.

Select All Fields Selects (highlights) all value and flag cells in the Readings Editor spreadsheet.

Block Modify Select a range of data to be modified by clicking and dragging the mouse pointer across the spreadsheet. After data has been highlighted, select the Block Modify button. This is similar to the Batch Edit window (see page 29 “Batch Edit Data” for details), with two exceptions: - There is no Populate Missing Records option. - Only the columns displayed in the Readings Editor appear in the Block Modify window. Once the desired changes are made in the Block Modify window, click OK to apply the changes to data highlighted in the Readings Editor.

View Values Click this option to toggle the Value column on or off. This column is appears in all of the ‘Edit’ programs.

View Priority Flags Click this button to toggle the ‘Priority Flags’ columns on or off. This column appears in the “Edit Values & Flags” and the “Edit Records” programs.

View Non-Priority Flags Click this button to toggle the ‘Non-Priority Flags’ columns on or off. These are the only columns that do not appear in any of the Edit programs.

View Null Codes Click this button to toggle the Null Codes column on or off. This column appears in the Edit Records program.

View Validity Flags Click this button to toggle the Validity Flag’s column on or off. This column appears in the Edit Records program.

View Annotation Count Click this button to toggle the Annotation Count column (Ant) on or off. This column appears in the Edit Records program.

Adding/Editing Annotations to Data Points Annotations may be added to any data value, or to multiple data values, in the Readings Editor. Annotations are stored along with a registered date/time, the author, an applied time interval (if the annotation is attached to a range of readings), and a category. Annotations may contain up to 248 characters.



If the Annotations Count column is not visible, use the menu bar option View Annotations or the View Annotations Count toolbar button to display the column. To add an annotation to data, complete the following steps:

1. If the Annotations Count column is not visible, use the menu bar option View Annotations or the View Annotations Count toolbar button to display the column.

2. Click the Annotation Count field for the desired data value, then right-click the field and select New Annotation. If you are editing an existing annotation, then select Edit Annotation.

To add an annotation to a range of data values, click the topmost value’s Annotation Count field, then drag the mouse pointer down to the bottom field in the desired range. This should highlight a vertical range of Annotation Count fields.

3. Now select Edit Annotation from the menu bar, then select either Add Annotation or Edit Annotation, as needed. If changes have yet to be saved for this editing session, you will be reminded to do so.

4. When the Annotation Editor window appears, it shows the Site:Parameter selected, along with the date(s) involved and the author (current user). Enter a Category, then Annotation Text (up to 256 characters).

5. Click OK to save the annotation and return to the Readings Editor.

Rebuild from Foundation The Readings Editor allows you to rebuild selected Ambient readings from the original Foundation readings. This option is available on the Reading Editor menu Edit Rebuild from Foundation.

All readings polled from the data loggers arrive as Foundation readings (data logger values and flags), and they are stored in tables that cannot be edited. These Foundation readings are used to generate Ambient readings (rounded values, ambient flags), which are then stored in tables accessed by the Readings Editor.



It may become necessary (e.g. due to inadvertent editing) to rebuild the Ambient readings records from the Foundation readings. This may be done for a selected data range by selecting the desired readings, then selecting Edit Rebuild from Foundation on the menu bar.

Excepting Data from Rebuild It is common to rebuild a broad range of data, yet prevent rebuilding certain data within the range. A form is provided to identify the rebuild exceptions.

• No rebuild for readings flagged – Check the flag types for data that will not be rebuilt.

• Retain readings that have no foundation – If this option is unchecked, readings with no associated Foundation record will be initialized to a missing record. This includes readings where the Foundation has been deleted or archived, but excludes records that are excepted with flags, as described above.

• Rule Defaults – The most common exceptions are called "Rule Defaults." These selections are made automatically when the rebuild option is first invoked. If any selections are changed, the Rule Defaults button becomes active, and clicking it restores the default selections. Specifically, these defaults are readings that are flagged as Locked (L), Retrieved from Archive (R), or Quality Assured (Q).

When selections are made, click OK to rebuild the data, or click Cancel to return to the Readings Editor screen without rebuilding data.

Deleting Data ATX has the following three options for deleting selected data:

• Delete Readings

• Delete Calibrations

• Delete Site Recordings

Each option invokes a criteria window for selecting data to be deleted. Once selections are made, you will be required to confirm the deletion before it actually takes place.

Delete Readings Use this command option on the Ambient Data Management screen to delete selected data for selected sites/parameters for a selected date range.

When this option is selected, a criteria window appears. The criteria window is the same as the screen explained in “Edit Values Only” (see page 28).



Once the criteria are selected, click OK to process the deletion, or select Cancel to exit this screen without deleting data. You will be asked to confirm the deletion. Click OK to process the deletion, or select Cancel to return to the criteria window without deleting data.

Delete Calibrations Use this program in Ambient Data Management to delete selected calibration data.

When this option is selected, a criteria window appears that lists all Cal Affected Parameters for all enabled sites. The criteria window is explained on page 15 “Using Criteria Windows.” Click to select the calibration spans to be deleted.

Use the multiple selection buttons below the list, if desired:

• Site – Selects all items whose site name matches the site name of the highlighted item.

• Seq – Selects all items whose sequence name matches the sequence name of the highlighted item (such as Hourly, Daily, CAL1, etc.).

• Phs – Selects all items whose phase name matches the phase name of the highlighted item (i.e., Zero, Phase1, etc.).

• Parm – Selects all items whose parameter name matches the parameter name in the highlighted item.

The date/time span fields work the same as in other criteria windows.



Once the criteria are specified, click OK to process the deletion, or select Cancel to exit this screen without deleting data.

When OK is selected, you be asked to confirm your desire to delete data. Again, click OK to process the deletion, or select Cancel to return to the criteria window without deleting data.

Delete Site Recordings Use this program in the Ambient Data Management to delete data for an entire site(s) at one time.

When this option is selected, a criteria window appears. The criteria window is explained on page 15 “Using Criteria Windows.”

Click to highlight the desired site(s), then specify the desired time span for data to be deleted.

Once criteria are specified, click OK to process the deletion, or select Cancel to exit this screen without deleting data.

When OK is clicked, you will be asked to confirm your desire to delete data. Again, click OK to process the deletion, or select Cancel to return to the criteria window without deleting data.

Editing the AIRNow Forecast Use this program option on the Ambient Data Management screen to edit ozone forecasts for the current day and the next two days. The parameters listed are those set up in the AIRNow Annex as being of the type OZONE. For more detail on setting up the AIRNow Annex, see “Annex Configuration” in Chapter 4 of the E-DAS Ambient ATX Administrator Guide.

The large text box on the lower portion of the screen allows you to enter expanded text to be included with the forecast for today.

The sending options in the lower right portion of the screen determine when the forecast is sent:

Option Function

Do Not Send Does not include the forecast information.

Already Sent Does not include the forecast information in any new reports.

Send Next Includes the forecast information the next time the AIRNow report is created.

Send After Includes forecast information in reports generated after the designated date/time.



Viewing the Alarm Monitor Use this program option on the Ambient Data Management screen to view the Alarm Monitor, which displays a list of alarms as they occur in the ATX system. The monitor includes two panels.

The top panel lists all unresolved alarms and related information, including:

• Alarm

• Description

• Message

• ID

• Alarm Date/Time

• Return Date/Time

• Acknowledgment Date/Time

• User

The lower panel shows a grid where the alarm events log can be traced in the same manner as the system event log. Alarm events include the usual (alarm, return-to-normal, acknowledge), plus the startup and shutdown of the Alarm Manager.

Configuring Unscheduled Polling Use this program option on the Ambient Data Management screen to view the Alarm Monitor, which displays a list of alarms as they occur in the ATX system. The monitor includes two panels.

To conduct an unscheduled poll, complete the following steps:

1. Select Ambient Monitor and Control in the Launch Pad tree, and click the Unscheduled Polling program button. A criteria window is displayed.



2. Complete the criteria window selections as follows:

• Data Source – Select the site(s) to be polled by clicking the desire site(s) in the Data Source list. See page 17 “Sources of Data” for more detail on use of the buttons below the Data Source list.

• Poll – Select the data to be polled:

• Averages

• Calibration

• User Messages

• Digital Transitions

• Power Fail

• Time Sync

• Method – This field appears only if Averages was selected in the Poll field. Select the desired data to be polled.

• Sequence – This field appears only if Calibrations is selected in the Poll field. Type in the type of sequence to poll (i.e., SPAN1), or enter ALL to poll all sequences.

• Begin Date/Time and End Date/Time – These fields bracket the time frame to be polled. If the time frame extends past the current time, an error message results. See page 18 “Time Range for Data” for more detail on setting date/time ranges.

• When to Execute – If Now is selected, the poll begins immediately when the Issue button is clicked. If Later is selected, an additional date/time field appears so you can specify when to begin the poll. In this case, the begin and end dates must both be earlier than the poll date/time.

3. Click the Issue button to issue the poll instructions as configured.



Importing and Exporting Data The Import Export menu option within Ambient Data Management allows importing Ambient data readings that are stored in ASCII text files, and exporting ATX data to ASCII text files.

The Import options allow importing data in any of the following four ASCII formats:

• ATX – Data exported from an Ambient ATX system

• AIRS – U.S. EPA AIRS format

• Type G – Custom format not available in most systems

• E-DAS – Data exported from an E-DAS Ambient or DigiTrend system

The most common needs for importing data include the following:

• Combining data from multiple systems or databases

• Adding data exported from an E-DAS Ambient or DigiTrend system

• Restoring data that was exported previously as a back-up measure

The Export Readings option will by default export ATX data to an ASCII text file (RPTDUMP.TXT to be saved in the \Dnc\Temp folder). A formatted report can be output by checking the Format option in the criteria window (this works the same as the Dump Report). See the E-DAS Ambient ATX User Guide for more details.

Importing Readings Data To import a data file, the following conditions must be met:

• The file(s) to be imported must reside in the \Dnc\Import folder

• The file name(s) must begin with IMP (not case sensitive)

• The file(s) must have an extension of .TXT (not case sensitive)

To import data from an external file, click the program button for the type of import desired:

• Import ATX Format

• Import AIRS Format

• Import Type G Format (custom)

• Import E-DAS Format

The initial criteria window appears with a list of the files available in the \Dnc\Import folder.



Note: Errors encountered by the import program, even ‘acceptable’ errors, generates messages

to the screen each time they occur. Errors may instead be written to the file bgLog.txt in the Dnc folder by setting the resource IMPORT_BG_ERROR = YES. This can speed up an import that involves numerous acceptable errors. See the ATX Administrator or review the E-DAS Ambient ATX Administrator Guide for assistance.

To import a file, complete the following steps:

1. Click to highlight the desired file(s) to import. Files being imported must begin with the letters IMP (not case sensitive). The Show All Files button displays all files in the \Dnc\Import folder regardless of name, type, or three letter extension.

2. Click to check the Flag as “Retrieved from Archive” option to mark imported records with an R (Retrieved from Archive) flag.

3. Click to check the Specify a Date and Time option if you need to import only for a specified time span.

This activates the Begin Date/Time and End Date/Time fields for the data to be imported. The system imports only data within the specified time span.

4. When all criteria is set as desired, click Import to import the specified data from the specified file(s).

Note: To speed up the import of large amounts of data (such as a larger site with two or more weeks of minute data, or two or more months of hourly data), your ATX Administrator can use the Resource Editor to set the resource CLIENT_UID_CACHE to 1000.

Exporting Readings Data Use one of the import programs to import specific file types. When this option is selected, the Export Readings criteria window that appears is similar to the other criteria windows in ATX, and is used to select the parameters for which readings will be exported.



To run the report, complete the following steps:

1. To select parameters for the data to be exported, click to highlight them in the Site:Parameter list box. The selection buttons below the list box work as described on page 17 “Sources of Data.”

2. Specify the averaging Method for selecting the data to be exported. The averaging methods listed by default are 001m, 001h, and 001d.

Note: Your ATX Administrator can modify the Methods list using the CRIT_METHODS resource in the Resource Editor.

3. Specify the time span for data to be exported using the Begin Date/Time and End Date/Time fields. For details on time span selection, see page 18 “Time Range for Data.”

4. If you wish to generate a formatted report rather than an ASCII file, click to check the Format selection box. This generates a report form with headings and data arranged in columns rather than a delimited ASCII file.

5. If the output will be an ASCII file, click to specify a Delimiter.

The four field delimiter options are as follows:

• Comma

• Semicolon

• Colon

• Tab

Tab-delimited text is the most common selection for import into popular spreadsheets or pasting into applications from the Windows Clipboard.

6. Use the Print Properties button to make the selections for output (see page 19 “Print Properties” for detailed instructions). The default is filename = RPTDUMP.TXT and is saved in the \Dnc\Temp folder, with the output (whether a report or ASCII file) also appearing on screen in the ATX Viewer.



After all necessary selections have been made, click the OK button to return to the criteria window.

7. After all selections have been made, click OK to generate the output.

AIRS Auto-Coding Use this feature if you want ATX to automatically assign AIRS null codes and Validity flags to Ambient readings. The three primary occasions when this feature is useful are:

• Editing Ambient readings

• Editing Ambient reading flags

• Polling Ambient readings

After AIRS null codes have been configured and associated with an ambient flag (see page 11 “AIRS Null Code” for details), the flags can be updated. If several configured flags are set for the same reading, the highest priority flag is used to determine the Null Code.

Enabling AIRS Auto-Coding AIRS Auto-Coding is not enabled when ATX is first installed. Your ATX Administrator must edit a resource in the Resource Editor to enable it in the mode(s) desired.

Auto-Coding When Editing Readings To edit AIRS null codes in the Readings Editor, right-click the Null field for the desired data record. A menu of available AIRS null codes appears. Click to select the desired null code. The AIRS validity flag (Vld column) for this data automatically changes to ‘9’.

Note: Entering a new AIRS null code that is not on the list of configured codes results in the new code being temporarily added to the right-click list, but it will not be added to the permanent Lookup Table for AIRS Null Codes. To add null codes to the Lookup Table, see page 46 “AIRS Null Code Configuration” for details.

To modify null codes for multiple data values at the same time:

1. Click and drag the cursor to highlight multiple consecutive fields in the Null column.

2. Select Edit Block Modify on the menu bar (or click the Block Modify toolbar button).

3. In the Block Edit dialog box, right-click the Null field to display a list of available AIRS null codes, then click the desired null code.

4. Click OK to apply the selections and return to the Readings Editor window.

The selected null code now appears in the Null column for the selected readings, and the AIRS validity flag (the Vld column) is automatically set to ‘9’ for invalid.

Auto-Coding When Editing Flags The Ambient Readings Editor can be used to edit flags, either in the screen grid or in the block-modify mode. If a flag change causes invalidation of the data, and the flag is associated with an AIRS Null Code, and auto-coding is enabled, the null code is automatically applied to that data and the AIRS Validity flag is set to ‘9’ for invalid.



Auto-Coding When Polling Readings During polling, if the Ambient Manager encounters readings that are invalidated with a flag, and the flag is associated with an AIRS Null Code, and auto-coding is enabled, the null code will automatically be applied to that data. The AIRS Validity flag will also be automatically set to ‘9’ for invalid.

AIRS Null Code Configuration AIRS null codes are entered and modified in a Lookup Table Configuration editor. To access this editor, select Configuration from the tree on the Launch Pad by, then click the AIRS Null Codes program button, or within Configuration Explorer, use the toolbar option Tools Null Codes.

To add a new code, complete the following steps:

1. Click the blank field at the bottom of the Code column, then enter the two-digit code desired (see table ).

2. Click on the Ch column next to the desired AIRS code, and enter the flag to be attached to data when it is designated as Invalid.

3. Click in the description field to the right of the desired Code, then enter the Description desired.

To delete a code, right-click on the gray left-most column for the code to be removed, then select Delete.

4. Click OK when changes to the codes are complete.

For information on having AIRS codes assigned to data automatically, see page 45 “AIRS Auto-Coding.”

The following table lists all AIRS codes available.

New Code

Item Code

Item Description

AA 9967 Sample pressure out of limits

AB 9968 Technician unavailable

AC 9969 Construction/Repairs in area

AD 9970 Shelter Storm Damage

AE 9971 Shelter Temperature Outside limits



New Code

Item Code

Item Description

AF 9972 SCHEDULED BUT NOT COLLECTED

AG 9973 SAMPLE TIME OUOT OF LIMITS

AH 9974 SAMPLE FLOW RATE OUT OF LIMITS

AI 9975 INSUFFICIENT DATA (CAN’T CALCULATE)

AJ 9976 FILTER DAMAGE

AK 9977 FILTER LEAK

AL 9978 VOIDED BY OPERATOR

AM 9979 MISCELLANEAOUS VOID

AN 9980 MACHINE MALFUNCTION

AO 9981 BAD WEATHER

AP 9982 VANDALISM

AQ 9983 COLLECTION ERROR

AR 9984 LAB ERROR

AS 9985 POOR QUALITY ASSURANCE RESULTS

AT 9986 CALIBRATION

AU 9987 MONITORING WAIVED

AV 9988 POWER FAILURE (POWR)

AW 9989 WOLDLIFE DAMAGE

AX 9990 PECISION CHECK (PREC)

AY 9991 Q C CONTROL POINTS (ZERO/SPAN)

AZ 9992 Q C AUDIT (AUDT)

BA 9993 MAINTENANCE/ROUTINE REPAIRS

BB 9994 UNABLE TO REACH SITE

BC 9995 MULTI-POINT CALIBRATION

BD 9996 AUTO CALIBRATION

BE 9997 BUILDING/SITE REPAIR

BF 9998 PRECISION/ZERO/SPAN

BG 9966 MISSING OZONE DATA NOT LIKELY TO EXCEED LEVEL OF STANDARD



Showing Flags in Reports Several of the ATX reports are capable of displaying flags in addition to displaying the values for readings. The reports that can display reading flags are:

• Daily Parameter Detail

• Daily Site Detail

• Columnar Readings

• Ranked Averages

• Met Site Detail

• Monthly Parameter Detail

The maximum number of flags displayed in a report is determined by a resource named RPT_FLAGS_SHOWN_ProgramName. If the resource is not set, the number of flags displayed is 3. If no flags are desired for the report, the resource should be set to 0 (zero). If all flags should be displayed, the resource can be set to ALL. See your ATX Administrator for assistance with resource settings.

The order of the flags is determined by the resource, AMB_FLAG_PRIORITY. The default order of flags is MISCNDPAQERL0123456789, as defined below.

Flag Definition M Missing

I Invalid

S Suspect

C Calibration

N Maintenance

D Disabled

P Power fail

A Adjusted

Q Quality assured

E Edited

R Retrieved from archive

L Locked

User-defined 0 – 9

Report Fill Characters When producing a report containing values, occasionally the values are not reportable. This may occur for a variety of reasons. ATX reporting attempts to give a visual cue as to why the value is not reportable by using specific replacement characters for the data. The replacement character used is specified through resources set up by the ATX Administrator.



The default settings for fill characters are as follows:

Resource Default Replacement Character

When used

NUL_FILL_CHR period (.) If the non-reportable value’s record does not exist in the database (the value is considered “NULL”).

MIS_FILL_CHR asterisk (*) If the non-reportable value is flagged as missing.

INV_FILL_CHR exclamation point (!) If the non-reportable value is flagged as invalid.

OFLO_FILL_CHR number sign (#) If the non-reportable value is good, but the report’s designated field width is too small.

Scheduling CLAIRE Data Export ESC’s CLAIRE (Computerized Local Air Index REporting) System for Windows® provides up-to-date air quality information over the telephone (using a recorded voice message) to members of the public, the news media, or government officials. A caller dials the number, and selects from a number of voice menu options by using their telephone keypad. The system responds with a message based on how the CLAIRE has been configured, which may include air quality index information for selected areas, descriptions of the index, pollen count, or forecast data.

Exporting ATX Data into CLAIRE To export data files required for CLAIRE, you will need to schedule a system job that translates ATX data into a format that CLAIRE can read such as the VoiceAQI file (see the E-DAS Ambient ATX Administrator Guide for instructions on scheduling jobs). This program can be a batch file (.bat), otherwise known as a script. See “Sample Batch File” on page 50. Scripts are normally scheduled to run hourly, and are stored in the Dnc\Programs (Default) folder.

The script on page 50 “Sample Batch File” sets variables to:

• Retrieve programs from x:\EscFw\Rt\Programs, and write the data files to x:\EscFw\Dnc\Temp.

• Retrieve annex parameters: 8 hour CO, 1 hour NO2, 1 hour Ozone, and 8 hour Ozone, all from the site. (The site name in the Sample Batch File below is “NEWTOWN”)

• Create unformatted, comma-delimited text with no post processing.

The script below in “Sample Batch File” runs the Index Report program three times to create STANDARD, CURRENT, and RANGE output in the files; CLstdAQI.txt, CLcurAQI.txt and CLragAQI.txt respectively. Then, it runs CLAIRE to draw all the AQI data together into the VoiceAQI file for CLAIRE. This script should be scheduled to run hourly.

CLAIRE categorizes AQI information into the following categories:

Category Description RANGE last 24 hours

STANDARD hours in the current day

CURRENT last hour



ATX is capable of generating output matching these categories, but not all at one time. To support providing all three categories of data to CLAIRE at one time, CLAIRE can accept three different text files through the command line arguments -ra<RANGE data file>, -cu<CURRENT data file>, -st<STANDARD data file>.

Sample Batch File @echo off REM Clair.bat REM 2000-04-27 REM Establish the location of programs and files Set RTPRG_PATH=C:\EscFw\Rt\Programs Set RPT_PATH=C:\EscFw\Dnc\Temp REM Establish the data involved Set AQI=[AQI]NEWTOWN:CO:CO-8h,NEWTOWN:NO2:NO2-1h,NEWTOWN:O3:OZ-1h,NEWTOWN:O3:OZ-8h,NEWTOWN:SO2:SO2-24h REM Establish the criteria common to all categories Set COMMONCRIT=DELIMITER=C;FORMAT=N;SENDTO=NONE REM Generate STANDARD AQI data %RTPRG_PATH%\RptIndex -bg -fc -dt -cr(ANNEXPARM=%AQI%;BEGDT=h-23h;ENDDT=h-1h;%COMMONCRIT%;OUTFILE=CLstdAQI.txt) REM Generate CURRENT AQI data %RTPRG_PATH%\RptIndex -bg -fc -dt -cr(ANNEXPARM=%AQI%;BEGDT=h-1h;ENDDT=h-1s;%COMMONCRIT%;OUTFILE=CLcurAQI.txt) REM Generate RANGE AQI data %RTPRG_PATH%\RptIndex -bg -fc -dt -cr(ANNEXPARM=%AQI%;BEGDT=t;ENDDT=h-1h;%COMMONCRIT%;OUTFILE=CLragAQI.txt) REM Pass all AQI data to CLAIRE %RTPRG_PATH%\UtlClaire -cu%RPT_PATH%\CLcurAQI.txt -st%RPT_PATH%\CLstdAQI.txt -ra%RPT_PATH%\CLragAQI.txt

Multiple Annex Parameters from One Parameter in CLAIRE CLAIRE handles multiple annex parameters associated with the same base parameter, use channel numbers to identify reported quantities, and associate an “Alternate CLAIRE Channel” with any parameter, in particular annex parameters.

For example, one-hour ozone and eight-hour ozone annex parameters can be drawn from the same hourly ozone parameter. To keep CLAIRE from identifying the two ozone annex parameters with the same channel number, the eight-hour ozone can be configured with the Alternate CLAIRE Channel that is set to an unused channel number (99 for example).

The Alternate CLAIRE Channel field appears at the bottom of the Definition tab in the Annex Configuration Editor, which is accessed through the Tools menu in the Configuration Explorer (see the ATX Administrator for details).


Index

AIRNow edit forecast, 39

AIRS, vii AIRS autocoding

enable, 45 manually edit flags, 45 polling, 46

AIRS Auto-Coding, 30 overview, 45

AIRS null codes, 34 configuring, 46 listing of codes, 46

alarm monitor starting, 40

ambient data readings, 10

Ambient Data Management, 3 ambient flags, 10 ambient readings editor, 27 annex

configuration, 13 overview, 13

annotations, 12 add to data, 35 edit, 34 view count, 35

AQI, vii AQS, vii ATX Administrator, 1, 3 calibration, 12

delete data, 38 CLAIRE

batch file, 49 scheduling data export, 49

configuration CLAIRE export, 49

Configuration Explorer, 9 criteria cover sheet, 22 criteria window

begin date, end date, 18 date/time interval, 19 date/time range interval, 19 menu bar, 20 positioning, 22 reusing settings, 21

criteria window settings copy and paste, 21 reusing, 21 save as file, 21

data batch edit, 29, 30 block modify, 35 delete readings, 37 delete site recordings, 39 edit ambient readings, 27 edit values only, 28, 31, 32 export, vi, 42 foundation readings, 37 import, vi, 42 rebuild Ambient from Foundation, 34 rebuild from foundation, 36 site, 12 structure, 9

data structure non-readings, 12

date/time interval selecting, 18

date/time range selecting, 19

delete calibrations, 38 readings, 37 site recordings, 39

delimiter, vi, 1, 15, 16, 44 diagnostics

client programs, vii Executive, viii Executive startup, viii

digital transitions, 12 edit data

ambient readings, 27 ambient readings and flags, 27 annotations, 35 batch edit, 29, 30 block modify, 35 edit annotations, 34 edit records, 31 linear translation, 31 maximum detectable, 30 minimum detectable, 30 populate missing records, 30, 34, 35

Index E-DAS Ambient ATX Data Manager Guide


values & flags, 31 values only, 28

exception window, 7, 8 Executive

diagnostics, viii export data, vi, 42 favorites, 3, 4 Favorites

adding programs to, 4 flags

ambient, 10 editing, 27 in reports, 48 non-priority, 35 null codes, 35 priority, 35 validity, 35

foundation readings, 10, 37 rebuild from, 34

history, 3 import data, vi, 42 Invalid, 22 Launch Pad, 2

menu bar, 4 preferences, 4

menu bar readings editor, 34

menu tree, 2 meteorological, v missing records

populate during batch edit, 30 non-priority flags, 35 null codes, 33, 34

configuring, 46 ODBC, v, 6 parameter

types, 13

password, 1 power failure

records, 12 Print Properties, 23 priority flags, 35 Properties window, 6 RDBMS, v readings

ambient, 9, 10 foundation, 9 structure, 9

readings editor ambient, 27 menu bar, 34 overview, 32 toolbar, 35

reporting fill characters, 48

reports criteria cover sheet, 22 output, vii

status bar, 2, 4 Launch Pad, 7

toolbar, 2, 4 Launch Pad, 7 Viewer Utility, 24

unscheduled polling configure, 40 data source, 41 method, 41 sequence, 41 when to execute, 41

user messages, 12 validity flag, 33 value editor, 30 Viewer Utility, 23

E-DAS Ambient ATX Data Manager Guide v2005-1116.pdf · Data Manager Guide Version 3.9 While every...

Documents

Transcript of E-DAS Ambient ATX Data Manager Guide v2005-1116.pdf · Data Manager Guide Version 3.9 While every...