GRAPH WINDOW NAVIGATION

Opening Data in a Graph  

The Graph Window appears when data is downloaded from a RAD7, or opened from either the computer's disk or the CAPTURE CLOUD Browser. To open a RAD7 data file from disk, either choose "Open Data File..." from the File menu, or click the Open Data File button on the Main Window toolbar, which is shown in Figure 1, below. To open a RAD7 data from CAPTURE CLOUD, go to the CAPTURE CLOUD Browser and double-click on an item in the list of search results.

The Home panel in CAPTURE's Main Window contains an Open Data File button and an Open Recent pop-up menu. A list of recently opened files appears when this button is clicked. This list is also available through the Open Recent command in the File menu. Up to ten recently opened files will be remembered, with the newest items placed at the top of the list. R7RAW or R7CDT data files may also be opened by dragging them onto the CAPTURE icon, or by simply double-clicking them.

 
Figure 1: The Main Window Toolbar containig the Open Data File... button.

RAD7 data files are selected using the standard system Open dialog box. RAD7 data files will typically be identified by a R7RAW or R7CDT file name extension and a corresponding icon. (Information on the various types of RAD7 Data Files is available in the File Formats section.) Once a RAD7 data file has been chosen, it will be opened in a new Graph Window.

If you wish to open one of the included sample RAD7 data files, choose Open Sample RAD7 Data File from the File menu, and use the submenu to select one of the available built-in sample files.

If there are problems with the RAD7 data but it is still usable, CAPTURE will graph only the valid RAD7 Data records, and a list of errors will be made available. More information on handling problematic RAD7 Data is available in the Radon Data Errors section.

  The Graph Window may appear when new RAD7 Data is downloaded or when an existing RAD7 Data File is opened. The Graph Window consists of several interface components, plus side panels containing navigational controls, a Spectrum display, and Statistics. Each of these elements are described below.

The Graph Window  

The Graph Window consists of several interface components, including side panels containing navigation controls, a Spectrum display, and Statistics. Each of these elements are described below.

The Graph Window displays radon data along a coordinate plane, with the X axis representing time, and the Y axis indicating the radon concentration in any of several different unit types. RAD7 data itself appears as a black line, or as a red line in areas of high relative humidity (Relative humidity is abbreviated RH. The line color can be changed in the preferences.) Other graph lines representing such things as thoron, air temperature, and humidity, may be toggled on and off within the Graph Controls panel, which appears along the left side of the Graph Window. This is explained further below. Gaps in the data occur in areas where no radon samples were recorded.


Figure 1: The Graph Window

Basic Navigation  

The Graph Window contains simple but powerful navigational controls which make it possible to select data points, scroll horizontally through data, and zoom the graph.

Selecting Data

To view a specific portion of the graph in detail, it is first necessary to adjust the selection. The vertical blue lines in the above screen are called Selection Bars. These lines frame the selected area. Information pertaining to the selected area is displayed in a panel in the Statistics panel, which is located alongside the Graph Window. To create a new selection, simply drag the mouse across a portion of the graph. The selection can then by modified by dragging either of the Selection Bars. Dragging while holding the Alt (Option) key will cause the selection to grow from the center.

Zooming the Graph

Drag the selection bars to the desired locations and double-click to zoom the view to the selected region. Once the view has been magnified, the selected data will be visible in greater detail, and a red bar will appear under the Selection Bars. Double-clicking on the Selection Bars when they are red causes the view to zoom out to its previous state. If the red Selection Bars are dragged, they will turn blue again and the selection may be changed. At that point, double clicking will cause the view to zoom in further for still greater detail.

Zooming in and out may also be achieved by using the Zoom Slider which is located on the floating Graph Controls panel, which appears to the left of the Graph Window by default. (The Graph Controls panel is described in greater depth below.) Additionally, the View menu in the menu bar contains Zoom In and Zoom Out commands, which can be used repeatedly to move in and out through a wide range of zoom states.

Scrolling the Graph

Whenever the graph is zoomed in, the scroll bar at the bottom of the window will become enabled, and it will be possible to navigate forwards and backwards through time.

It is also possible to scroll the graph using the Selection Bars. Position the cursor between the Selection Bars, and hold the Shift key. With the Shift Key pressed, drag the mouse to the left or right, off the edge of the graph. The graph will scroll to keep up with the movement of the mouse.


Graph Controls Panel  




The Graph Controls panel is used the to navigate the graph and change its behavior and appearance. Although much of its functionality is also accessible from within the menu bar, you may find that the Graph Controls panel provides easier access to commonly used functions. This scrollable panel consists of a series of sub-panels, labeled Configuration, Appearance, Navigation, Graph Lines, and Windows and Panels. Each may be expanded or collapsed by clicking on its heading. The panels are described below.

Configuration Panel


Figure 2: The Configuration Controls Panel

RAD7 Profile Pop-Up Menu

RAD7 Profiles contain sensitivity information and spill factor values that allow RAD7 data to be more accurately parsed and presented. CAPTURE maintains a collection of RAD7 Profiles, and they are created automatically as needed. When a RAD7 data file is opened, CAPTURE will select an appropriate profile, with respect to which RAD7 produced the data, and when the data was recorded. This selection may be overridden if desired using the RAD7 Profile pop-up menu. The collection of RAD7 Profiles may be edited in the Preferences Window, as described in the Preferences Window section.

Concentration Units Pop-Up Menu

Determines the unit of measurement used to denote radon and thoron concentrations on the graph. The available options include Automatic, Bq/L, Bq/m3, dpm/L, and pCi/L. The Automatic option causes radon and thoron concentrations to be presented in the unit in which they were originally recorded inside the RAD7.

Temperature Units Pop-Up Menu

Determines the unit of measurement used to denote air and water temperatures on the graph. The available options include Automatic, Celsius, Fahrenheit, and Kelvin. The Automatic option causes temperatures to be presented in the unit in which they were originally recorded inside the RAD7.

Forced SNIFF Mode Checkbox

Determines whether the graph data is forced to be displayed as if it was recorded in SNIFF Mode. This checkbox is enabled whenever there exists at least one record that truly was recorded in SNIFF Mode. Such records are analyzed to determine the necessary SNIFF sensitivity data.

Correct For Humidity Checkbox

Determines whether the graph data is corrected for humidity. When relative humidity is high, radon concentration values are often underreported. Humidity correction compensates for this.

Correct for B to A Spill Checkbox

Determines whether correction is applied based on the spill from the B to A windows. Significant spill occurs when the thoron concentration is high relative to the radon concentration. Under these conditions it is recommended that the data be corrected to compensate.

Appearance Panel


Figure 3: The Appearance Controls Panel

Point Style Pop-Up Menu

Determines the appearance of the data points on the graph. The options are Normal, Shapes, B&W (Black and White) Shapes, and Hidden. The B&W Shapes option causes the graph to be rendered in black and white, which is useful when graph image is printed on a non-color printer.

Line Weight Pop-Up Menu

Determines the thickness of the graph lines, as measured in pixels. This value may range from 1 to 4, or the graph lines may be hidden. A thicker line may be easier to read, but is somewhat less precise than a single-pixel line.

Smoothing Pop-Up Menu

Determines the degree of smoothing applied to the graph line. This value may range from 1 (no smoothing) to 9 (high smoothing). When the degree of smoothing is greater than 1, the original, non-smoothed graph line appears faded in the background.

Show Grid Lines Checkbox

Determines whether horizontal and vertical grid lines are visible on the background of the graph. Grid lines are drawn at regular intervals, with vertical lines representing time intervals, and horizontal lines representing concentrations, temperatures, and humidity levels.

Show Graph Legend Checkbox

Determines whether the legend is visible on the Graph Window. The legend indicates the significance of the colors that appear on the graph. To the right of the Show Graph Legend Checkbox is a small control for setting the position of the Graph Legend. It may be placed in any of the four corners of the graph image.

Show Error Bars Checkbox

Determines whether error bars are visible on the graph. Error bars are vertical line segments which pass through data points, indicating the uncertainty of radon and thoron readings.

Show Selection Average Checkbox

Determines whether a representation of the average of the selection is displayed between the Selection Bars. A horizontal line represents the average of the selection, and a shaded region represents the uncertainty of the average. Separate representations appear for Radon, Thoron, Radon in Water, and Thoron in Water.

Show Selection Slope Checkbox

Determines whether the Selection Slope Line is visible on the graph. This checkbox may be checked or unchecked, or it may be set to an intermediate partially checked state, in which case the Selection Slope Line only appears if the selection contains a series of fairly evenly distributed data points. The Selection Slope Line starts at the first Selection Bar and ends at the second Selection Bar. The default angle of the Selection Slope Line is based on a linear regression formula accounting for the distribution of the selected data points. However the line's endpoints may be dragged manually to modify the position and angle of the line if desired. If the line is adjusted manually, it will change from blue to red to indicate that a modification was made. The line's slope is stated in the Statistics panel, where it is expressed as a change in radon or thoron concentration per unit of time. The pop-up menu control to the right of the Show Selection Slope Checkbox is used to specify the time unit used in this expression. The time unit may be set to either Automatic, Months, Days, Hours, Minutes, or Seconds.

Navigation Panel


Figure 4: The Navigation Controls Panel

Graph Zoom Slider

Zooms the radon graph in and out. When this slider is dragged all the way to the left, the entire collection of data is made visible, and no horizontal scrolling is required to see data points.

Scale Pop-Up Menus

The Radon Concentration Scale pop-up menu determines whether the Y scale of the radon graph is determined automatically or manually. If Automatic is selected, the graph's Y scale will be configured such that the visible radon points will occupy the entire available vertical space. Selecting Manual makes it possible to control the Y scale region yourself.

Also appearing in the Navigation panel are pop-up menus for specifying the Thoron Concentration Scale, the Temperature Scale, and the Relative Humidity scale. Each behaves similarly to the Radon Concentration Scale pop-up menu, and may be set to either Automatic or Manual.

Concentration Scale High and Low Fields

When a Scale pop-up menu is set to Manual, a set of controls for specifying the scale parameters appears. The High and Low fields represent the highest and lowest element values visible on the graph respectively. Separate sets of High and Low fields are present for radon, thoron, temperature, and relative humidity.

Concentration Zoom and Scroll Sliders

To the right of each pair of High and Low fields are a set of controls for zooming and scrolling the graph's Y Scale. The Zoom Slider, on the left, is controlled by clicking or dragging the filled region to the desired level; higher levels represent increased zoom. The Scroll Slider, on the right, operates like any scroll bar; simply drag the box up or down until the desired region scrolls into view. The height of the scroll box is proportional to the scope of the currently visible region. As with the High and Low fields, separate sets of Zoom and Scroll sliders are present for radon, thoron, temperature, and relative humidity.

Graph Lines Panel


Figure 5: The Graph Lines Controls Panel

Radon Checkbox

Determines whether radon data is shown on the graph. The values of the radon data points may be affected by any corrections applied in the Configuration panel, as described above.

Thoron Checkbox

Determines whether Thoron data is shown on the graph. When displaying thoron for the first time, a dialog box may appear entitled "RAD7 Profile: Thoron Settings", where you will be prompted to enter Thoron calibration values for the current graphing session. If you are graphing data for the first time, and are simply learning how to use the program, it is OK to accept the suggested default values. However we urge you to contact DURRIDGE Company to receive the optimal Thoron calibration values consistent with the serial number of your specific RAD7 device. Once these values are known, a series of RAD7 Profiles may be established, as described in the Preferences Window section.

If Thoron data does not appear when this box is checked, a button labeled "Thoron Details" will appear at the upper right corner of the Graph Window. Clicking this button will provide an explanation as to exactly why Thoron is not visible, and the option to display Thoron anyway will be made available.

Radon In Water Checkbox

Determines whether radon in water data is shown on the graph. This checkbox is only enabled if a temperature data file containing water temperature information has been loaded along with the basic RAD7 data. This is because it is impossible to determine how much radon is in water without knowing the water's temperature.

Thoron In Water Checkbox

Determines whether thoron in water data is shown on the graph. As with the Show Thoron checkbox, clicking this box may result in the "RAD7 Profile: Thoron Settings" dialog or "Thoron Details" button appearing. As with the Radon In Water checkbox, this box is only enabled if a temperature data file containing water temperature information has been loaded along with the basic RAD7 data.

Air Temperature Checkbox

Determines whether air temperature data points are visible on the graph. The temperature unit used here may be set in the Configuration panel, as described above.

Water Temperature Checkbox

Determines whether water temperature data is visible on the graph. As with the Radon In Water checkbox, this box is only enabled if a temperature data file containing water temperature information has been loaded along with the basic RAD7 data.

Relative Humidity Checkbox

Determines whether relative humidity data is visible on the graph. Relative humidity values are stored as whole integers. Areas of excessive humidity will be identified with a differently colored radon graph line.

Meaningful Thoron Threshold Checkbox

Determines whether a shaded area will appear representing the area outside the meaningful thoron concentration range. A thoron reading may only be considered meaningful if the data point appears above this shaded area. If one or more thoron data points are found to be under the minimum concentration threshold, a dialog box will appear explaining the situation. Non-meaningful thoron data has high uncertainty, resulting from excessive spill between the RAD7's C and B windows. The Meaningful Thoron Threshold checkbox is only enabled if Thoron or Thoron in Water points are being displayed on the graph. If both Thoron and Thoron in Water points are visible, two shaded regions will be rendered.

Windows and Panels


Figure 6: The Windows and Panels Controls Panel

Show Log Window Checkbox

Determines whether the Log Window is visible. This window contains a listing of all of the actions that CAPTURE has performed since the application was launched, plus a record of the data that has arrived through each serial port.

Show Spectrum

Determines whether the Spectrum panel is visible. This panel displays a graph emulating the spectrum printed out by the RAD7.

Show Statistics

Determines whether the Statistics panel is visible. This panel displays a range of information on the data being displayed on the graph, as well as whichever data lies within the selected portion of the graph.


Statistics Panel  

The Statistics panel consists of four sub-panels, labeled RAD7, Entire Data Range, Selected Area, and Point Nearest to Cursor. Each of these may be independently expanded or collapsed as viewing area permits. The Statistics panel itself may be resized and scrolled as desired. The contents of each panel are described below.

RAD7 Statistics Panel


Figure 7: The RAD7 Statistics Panel

The first sub-panel in the Statistics panel shows information about the RAD7 from which the current graph data was obtained. Its heading contains the RAD7's serial number, if it is known. Note that this and other items may be listed as '[Unknown]' because not all RAD7 data files contain supplementary information with details on the device itself. Generally files with the R7CDT file name extension offer this supplementary data, while files with the R7RAW file name extension do not. The exception to this occurs when a R7RAW data file is exported as "Cleaned Up Data"; in this case the resulting R7CDT file contains only what was able to be synthesized from the original R7RAW data.

The Sensitivity and Spill Factor values displayed in this panel are generally obtained from the RAD7 data file, but they may also be obtained from an applied RAD7 Profile. If a Sensitivity or Spill Factor value is obtained from a RAD7 Profile and it differs from the value present in the RAD7 data file (or if no such value is present in the RAD7 data, as is the case with .R7RAW files), then the stated value will be marked with an asterisk (*).

Entire Data Range Statistics Panel

The second sub-panel in the Statistics panel contains information on the application and platform used to obtain the data, and a summary of the entire range of data represented in the graph, including the average radon concentration, thoron concentration (if applicable), temperature, and humidity, as well as the total number of data points and time duration of the data set.


Figure 8: The Entire Data Range Statistics Panel

Selected Area Panel

The third sub-panel in the Statistics panel displays information on the selected records, i.e. those lying between the two Selection Bars. This includes the selection's average radon concentration, average thoron concentration (if applicable), average temperature, and average humidity, as well as information on the Selection Slope, the number of data points selected, and the time duration of the selected range.

Note that the average concentration of the selected data points is also reported along the top of the Graph Window, directly above the graph image. Clicking on this text toggles between displaying the average concentration of the selection and the standard deviation of the selection. The standard deviation indicates the amount of variation between the selected data points.


Figure 9: The Selected Area Statistics Panel

Point Nearest To Cursor Panel

The fourth sub-panel in the Statistics panel displays statistics on the data record that is closest to the mouse cursor. This includes the record's date, record number, run number, and cycle number, plus radon and thoron concentrations and counts, as well as temperature and relative humidity data. Information on the state of the RAD7 at the time of the test is also provided. If the graph contains raw RAD7 data lacking supplementary information, the Run and Cycle values will not be listed. Any problems with the data point will be reported in the bottom section of the panel.


Figure 10: The Point Nearest to Cursor Statistics Panel

Spectrum Panel  

The Spectrum panel displays a histogram or bar graph indicating the distribution of counts across a range of channels or windows. It contains buttons for toggling between three display formats:

  1. Spectrum histogram for the selected data points
  2. Cumulative Spectrum histogram for the selected Run
  3. Bar Graph for the selected data points

The Spectrum histogram for the selected data points resembles the spectrum printed by the RAD7's infrared printer at the end of each run, except it only applies to the selected points, rather than the entire run. The Cumulative Spectrum matches the one printed by the RAD7's infrared printer at the end of each run. The bar graph for the selected data points shows the relative numbers of counts that were recorded in each of the main windows, A, B, C, D, and O.

The Spectrum histogram for selected data points is only available if CAPTURE was open and the Chart Recorder was running when the selected data cycles were recorded. This is because the spectrum count data increments in the RAD7's memory at the end of each cycle, and the Chart Recorder captures this spectrum data and saves it before it is overwritten. The Cumulative Spectrum display option is available in cases where CAPTURE downloads the data after the completion of the selected run, and before the start of the next run. The Bar Graph display option is available in all cases.

The histogram displays show all of the channels relevant to radon and thoron measurements. The "Low Noise" Channels 1 through 80 are omitted from the display, but Channels 81 through 200, which encompass windows A, B, C, and D, are displayed in full detail whenever possible, revealing the total counts in each channel for either the selected data points or the selected run. The count rate is displayed under each peak, and the name of the polonium isotope whose decays contributed to the peak is indicated at the top.

CAPTURE's Spectrum display is useful for visualizing the growth of counts in window C as time progresses in a measurement run. It is also useful for identifying a pathological spectrum that may be generated by a malfunctioning RAD7. In a pathological spectrum the peaks may not be in their correct positions, and there may be spurious points within and outside the primary windows that are distributed randomly across the entire spectrum, as described in section 3.13.4 of the RAD7 manual. More information on the spectrum is available in the RAD7 User's Manual, Chapter 3.7.

Note that the Spectrum panel should not be confused with the contents of the Chart Recorder Spectrum Window, which displays a spectrum representing the current state of a RAD7 connected to the computer.


Figure 11: The Spectrum Panel showing a histogram for the selected data points


Figure 12: The Spectrum Panel showing a bar graph for the selected data points

Annotations

An annotation is a text note that can be pinned to a particular data point, or to specified date on the graph timeline. Figure 13 shows an annotation that has been pinned to a data point. To create an annotation, use the Add Annotation command in the File Menu, or right-click on the desired part of the graph (Control-click on macOS) and choose Add Annotation from the contextual menu. The Edit Annotation Window will appear as shown in Figure 14, below.

In the Edit Annotation Window, specify the desired name, color, text content, and date parameters. The specified name will appear at the top of the annotation in a white title bar, and the chosen color will appear behind the underlying text content, as shown in Figure 13. If the Pin to Data Point radio button is selected in the Edit Annotation Window, the annotation will contain a triangular arrow pointing to the data point and element types that are specified in the accompanying pop-up menus. If the Pin to Date radio button is selected, the Annotation will appear at the top of graph image, at the specified date and time.

The Create searchable Data Tag based on Annotation Name checkbox is used to add a data tag that makes the RAD7 data file easier to find in the CAPTURE CLOUD Browser. For more on data tags, see Searching With Data Tags in the Browsing CAPTURE CLOUD Data section. When finished specifying the annotation properties, click the OK button.

To edit or remove an existing annotation, click its edit button, which is located at the top right corner of the annotation on the graph. The Edit Annotation Window will reappear. It contains a Delete Annotation button that can be used to remove the annotation. After an annotation has been added, modified, or deleted, the Save command will be enabled in the File menu. When the file is saved, the included annotations will be preserved, and will be visible when the file is reopened.


Figure 13: An annotation pinned to a graph data point.


Figure 14: The Edit Annotation Window