RadiaCode 10X Series Nuclear Radiation Detector and Spectrometer User Manual

: June 25, 2024
: RadiaCode

Table of Contents

RadiaCode 10X Series Nuclear Radiation Detector and Spectrometer
Product Information
Product Usage Instructions
FAQs
Introduction
Graphical interface
Appendices
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

RadiaCode 10X Series Nuclear Radiation Detector and Spectrometer

Product Information

Specifications:

Product Name: Windows PC User Manual
Operating System Compatibility: Windows
Interface: Graphical User Interface

Product Usage Instructions

Chapter I: Introduction

This chapter provides an overview of the system requirements and developer information for the Windows PC User Manual.

1. System Requirements:

The system requirements outline the necessary specifications for the product to function correctly. Ensure your Windows PC meets these requirements before proceeding.

2. Developer Information:

This section contains information relevant to developers who may be working with the product.

Chapter II: Graphical Interface

This chapter delves into the graphical interface of the Windows PC User Manual, including various windows and menus available.

1. Radiacode Windows:

Describes the Radiacode window interface for users to navigate and interact with.

2. Main Menu of Radiacode:

Details the file menu, view menu, and Radiacode options dialog box, providing users with access to different settings and configurations.

– File Menu:

Instructions on utilizing the file menu, including configuration files.

– View Menu:

Explains how to use the view menu and configure different options within it.

– Radiacode Options Dialog Box:

Provides insights into the device tab, program settings tab, environment dialog box, key mappings tab, toolbar tab, and misc tab within the Radiacode options dialog box for customization.

FAQs

Q: What are the system requirements for the Windows PC User Manual?
- A: The system requirements are detailed in Chapter I of the user manual.
Q: How do I access the Radiacode Options Dialog Box?
- A: You can access the Radiacode Options Dialog Box through the main menu of Radiacode as explained in Chapter II.

\Chapter
I

Introduction

1 Introduction

The RadiaCode program is designed to control the RadiaCode-10X dosimeter under Windows. Using the program you can view the device event log, delete log entries, export the log to .html and .csv files, manage the device settings, view graphs of the scheduled measurement values, etc.
1.1 System requirements
Device software RadiaCode-10X works under the following operating systems:

Operating system
Windows XP
Windows Vista
W indows 7,8,10,11

32-bit

64-bit

1.2 Developer information
RADIACODE LTD 3 Thaleias Street 3011 Limassol, Cyprus Phone No.: +357 94 207 695 / +357 99 020 336 https://radiacode.com e-mail: support@radiacode.com

Chapter
II

Graphical interface 4
2

Graphical interface

This section contains the description of windows, menus and dialogs of the program RadiaCode. Device status indicator On the left on the control bar of the home window RadiaCode there is a status indicator of the device, which graphically shows its current state.

2.1 RadiaCode windows
In the main RadiaCode program window, there are windows that can be opened through the “View” home window menu item and with the buttons on the control bar.
There is a drop-down list on the left side of the control bar:
This drop-down list lists the serial numbers of the devices, the data of which is in the database. If more than one RadiaCode-10Xdevice is connected, then here you can select which device to work with.
Only the records of the device selected in this list are displayed in the log window.

Next to the serial number field there are buttons that control the device power on/off, sounds, vibration, and LEDs on the device body.

2.1.1

“Event log” window “Spectrum” window “View Spectrum” window Spectrogram window “Current value graphs” window “Message console” window “Variables” window
“Event log” window
This window is designed to work with the device log database. Use this window to view and delete event and measurement records, perform searches, export measurement data, and perform other operations.

The list displays only the records of the device whose serial number is selected in the drop down list on the control bar of the home window RadiaCode. You should keep this in mind if you are working with more than one instance of RadiaCode-10X.

When the device is connected to the computer, the program automatically reads the accumulated log entries from the device, and they appear in the window. The records read from the device are deleted from the device.

5 Graphical interface To quickly switch to the Journal window, click its button on the control bar of the home window RadiaCode:
The most commonly used window-related commands can be executed using the buttons on the window control bar. You can get the full list of commands by invoking the local menu of the window by right-clicking in the window:
The information in the window is displayed as a table. The right panel displays the information associated with the line selected in the left panel. To change the order of columns in a table, you can drag columns left to right behind the column title. The local menu command “Window display options” or the “Settings” button opens a dialog where you can select which columns to show in the window and in what order. The information in the window is sorted by the contents of one of the columns. To change the column, the contents of which are being sorted, click on its title. Clicks again to reverse the sort order. Some commands of the window let you work with several selected records. To select multiple entries, click on them while holding down the Ctrl or Shift key, as is common in the Windows interface. You can use the Ctrl+A key combination to mark all entries. There is a quick search box on the left-hand control bar of the log window. If you click on this box and start entering text, the window will display a line containing this text in any of the columns:
© 2024 Radiacode Ltd.

Graphical interface 6
If the typed string is missing in all fields of the base, the background of the search field will become pink. To the right of the Quick Search field is the field for selecting the serial number of the device, the records of which will be displayed in the window. This field can be used if the database has records from different instances of the RadiaCode-10X. You can choose to display both the records of one specific device and the display of all records of all devices. Window commands Edit record comment Window display options Search database Records filter Delete record(s) Deleting records that are older than… HTML report Save selected records to Excel csv file 2.1.1.1 Edit record comment Set or change a custom comment for the current entry or for all selected entries:
© 2024 Radiacode Ltd.

7 Graphical interface Comments are displayed in the log window in the “Comment” column, and are also output in .html and .csv files, which are created by the corresponding window commands. If more than one record is selected, the check mark at the bottom of the comment window indicates whether to set the comment for all selected records or just the current record.
2.1.1.2 Display settings Using the “Settings” button on the window control bar, you can specify which fields should be displayed in the window and in what order:
The “Database window display options” dialog box opens:
The fields marked with a checkmark in the list are displayed in the window. Using the “Move up” and “Move down” buttons one can control the order of the fields in the window: the higher the field
© 2024 Radiacode Ltd.

Graphical interface 8 is in the list, the further to the left it will be in the window. Use the Ctrl and Shift keys to select more than one field at a time. One can also change the order of the fields in the table directly in the window by dragging the field titles with the mouse. 2.1.1.3 Search database Use this function to perform an advanced search for a data in the database. To search, click the “Search” button on the window control bar:
A dialog box opens where you can set the search conditions and the way the results are displayed:
· In the “Search for” field enter a substring to search for. · In the “Search in” list mark where to search the entered row. · In the “Search direction” list specify the direction of the search. · In the “Match criteria” list select how the search string-argument should be compared to the
contents of the field. · If the “Case-sensitive search” option is enabled, large and small letters are considered different,
when comparing. To start a search, click the “Search”.
© 2024 Radiacode Ltd.

9 Graphical interface The “Highlight all found” searches and highlights all fields that satisfy the search condition with a green background:
The “Select all found” searches and marks all lines containing fields that satisfy the search condition:
© 2024 Radiacode Ltd.

Graphical interface 10 You can then perform a group operation with the marked entries, such as deleting them or saving them as a table in an HTML file. 2.1.1.4 Records filter Record filter is an advanced function, which allows displaying in the window only those records, which meet the specified conditions. For example, you can set the filter so that only measurement records with alarms made between certain dates are displayed. To set the filter conditions, click the “Filter” button on the window control bar:
The “Database filter settings” dialog box opens:
Enable the filter. The “Insert condition” and other buttons to the right of the “Filter condition” field will become available. The “Insert condition” button opens a dialog box where one can set a filter condition:
© 2024 Radiacode Ltd.

11 Graphical interface
At the top, one can set the database record field to be filtered. To do this, click the arrow to the right of the field (only those fields that appear in the window will be listed. Configuration of the window view is described in the “Display settings”):
Next, specify which condition will be used for filtering. The list of conditions depends on the field type: for text fields it will be as shown in the picture below, for numeric fields you can specify the value, for date – select the date and time.
In the bottom entry field, which also depends on the type of database field selected for filtering, you shall enter or select from the suggested list what its contents are compared with:
© 2024 Radiacode Ltd.

Graphical interface 12 Click the “OK” button. Condition will be added to the list of conditions:
If you add more conditions in a similar way, the list of conditions might look like this:
© 2024 Radiacode Ltd.

13 Graphical interface
As you can easily guess, the three conditions entered are linked by “AND”, i.e. records that satisfy all three conditions at the same time will be displayed in the window. To change from “AND” to “OR”, click on the line with the letter “AND” in the list on the left, and then click on the “AND” <–> “OR”. Now the condition is that the window will display entries that satisfy the first and at least one of the second and third conditions. If there are enough conditions, you may need to prioritize comparison operations. For this purpose the buttons “Insert ‘)'” and “Insert ‘(‘”, which insert brackets in the conditions. When the filter is enabled, all window entries are highlighted with a yellow background so that you don’t forget that the filter enabled. The filter condition is displayed in the window title:
2.1.1.5 Delete record(s) To delete an entry, make it the current entry by selecting it in the window and clicking the “Delete” button on the window’s control bar:
© 2024 Radiacode Ltd.

Graphical interface 14
A prompt is given to confirm the deletion. Several marked entries can be deleted at the same time. 2.1.1.6 Delete records older than… This command is available through the local menu of the window called by the right mouse button:
After confirmation, records, the date of which is older than the one selected in the list, are deleted from the database. 2.1.1.7 HTML report Use this function to save the log as a table in an HTML file. The saved HTML file can then, for example, be downloaded to Microsoft Word or Excel for editing, printed or emailed. To execute the command, click the “HTML” button on the window control bar:
If several records are selected in the window (records are selected with Ctrl and Shift), only they are saved. If nothing is selected, all logs are saved in the html file. Only those fields are saved and in the order they are displayed in the window at the time the command is called. Configuration of the window view is described in the “Display settings”. This will open a dialog where you need to specify the name of the HTML file to be saved. Example of a table in an HTML file:
© 2024 Radiacode Ltd.

15 Graphical interface
2.1.1.8 Save selected records to Excel csv file Use this function to save selected log entries in a .csv file for later analysis in Excel. To execute the command, click the “CSV” button on the window control bar: Only selected records are saved in the .csv file (records are selected with Ctrl and Shift). If nothing is selected, only the current entry is saved in the .csv file. Before saving, one can select which table fields to save and in what order:
© 2024 Radiacode Ltd.

Graphical interface 16

In addition to the visible table fields, the .csv file saves the measurement parameter values in “raw” format, i.e. in numerical format accepted in Excel. This makes it possible to analyze measurement results and build graphs using Excel tools.

2.1.2

To simplify the search and selection of entries, one can use a record filter.
“Spectrum” window
This window displays the energy spectrum of the photon (gamma and X-ray) radiation, typed by the device over a certain period of time. When you connect the device to the program, it reads the spectrum data from the device. Subsequently, the spectrum graph is updated either automatically at the interval specified in the settings, or manually.

Additionally, a background spectrum graph can be plotted on the spectrum graph.

To quickly switch to the Spectrum window, click its button on the control bar of the RadiaCode:

17 Graphical interface
The graph is drawn as contiguous rectangles (histogram), each of which has a height corresponding to the number of pulses in the channel. The most recent channel includes not only the data of this channel itself, but also all the data outside the area displayed on the graph. At the top right of the graph, the time for which the spectrum data was accumulated is displayed, in the format HH:MM:SS. Below is the average pulse count rate, i.e. the sum of the number of pulses for all channels, divided by the time of data accumulation. The method of updating the graph is displayed even lower. Depending on the settings, the X-axis can display either channel numbers or photon energy. The Yaxis can display either the number of pulses or the count rate. The Y-axis scale can be linear or logarithmic. When you move the pointer over the graph, the lines of the marker with the numbers that correspond to the values on the axes are displayed. In the above picture, channel number 57 corresponds to the number of pulses equal to 19.
© 2024 Radiacode Ltd.

Graphical interface 18
Several settings control the graph display. The most commonly used settings are placed on the window control bar. Buttons Lin. and Log. switch the display scale on the Y-axis between linear and logarithmic. “Settings” button or the local menu command “Window display options” opens the spectrum window settings dialog box. “Restart” button or local menu command “Restart accumulation…” after confirmation resets the accumulated data and the accumulation process starts again. “Refresh” button or local menu command “Refresh spectrum data” reads spectrum data from the device and refreshes the window. This button can also be used in the automatic spectrum data update mode for immediate updating. XML button or the local menu command “Export spectrum data to .xml file…” allows you to save the spectrum, possibly with a background, in an XML file for later viewing in programs like Becquerel-Monitor. You are prompted to select where to save the file. CSV button or the local menu command “Export spectrum data to .csv file…” allows you to save the spectrum in a simple text csv format. File name is generated by the program in the “YYYYY-MM-DD hh-mm- ss_Ns.csv” format, where “YYYY-MM-DD hh-mm-ss” is the current date/time and “N” is
© 2024 Radiacode Ltd.

19 Graphical interface
the accumulation time in seconds at the time the file was saved. You are prompted to select the folder where to save the file.
“Save” button or “Save Spectrum to Library…” local menu command: save the spectrum in the database. In the future, the spectrum can be used as a background, exported, viewed, etc. If the “Set as current background” option is left enabled in the spectrum saving request dialog, the saved spectrum is selected as the background to be displayed together with the spectrum. The name of the background is displayed at the top of the graph.
“Library” Button or the “Open Spectrum Library” local menu command opens spectra library.
Amplification and filtering
At the bottom of the spectrum window there is a slider that controls “enhancement” of a histogram. A curve of the following type is superimposed on the graph:

This allows subtle peaks to appear on the graph. For each channel, the value is calculated by the formula Vn = Vn An F + 1, where:
n – channel number Vn – spectrum value (number of pulses or count rate) in channel n An – the value at the corresponding point of the amplifying curve F – gain factor, which is set by the slider, from 0 to 5.
In amplification mode with F >= 1, the digitization of the Y axis is not displayed.
Filter Engine applies a smoothing algorithm to the spectrum graph. The higher the filter value, the more the graph is smoothed.

2.1.2.1 “Spectrum window settings” dialog box. In this dialog box you can select different display options for the “Spectrum” window.

Dialog item Y-axis scale
Y-axis units
X-axis units
Spectrum and background overlay

Description
Selects linear or logarithmic scale of the Y-axis.
Select either the number of pulses or the count rate, i.e. the number of pulses divided by the spectrum data accumulation time, as the units of the Y-axis.
Select either the number of the spectrum channel or the energy of this channel as units of the X-axis.
Display only spectrum or spectrum and background. On backgrounds, see Spectra library.

Graphical interface 20

Drawing the

Choose how to draw the graph: both fill with color and stroke with a line, or fill

spectrum/backgr only or stroke only.

ound

Graph updating

Choose how the graph is updated: either automatically at a specified interval (in seconds), or manually with the button button on the window control bar.

Here one can specify the coefficients a0, a1, a2 used to calibrate the spectrum by emission energy. When opening the dialog box, the coefficients read from the device are displayed.

Spectrum calibration is performed to convert the number of the spectrum

Calibrating

channel to the value of the emission energy in keV using a polynomial of the

spectrum by

2nd degree of the form:

emission energy

E = a0 + a1X + a2X2, where x – channel number; a0, a1, a2 – calibration factors.

Reset to factory Set the default values for the calibration coefficients. defaults

Isotope Library

If you select “Embedded”, the Spectrum and View Spectrum windows will use isotope library, which is built into the program RadiaCode. If “Custom” is selected, the isotope information is taken from the specified file.

Draw isotope lines

Draw the pink energy lines of isotopes on the graph. Disabling this option does not disable the display of isotope information at the top of the window.

Draw a polyline instead of a histogram

Instead of rectangular bars (histogram), draw a polyline that connects the midpoints of the tops of the bars. The graph is not entirely “true”, because the accumulation of the spectrum is still discrete for each channel.

Using the local menu command “Properties” -> “Colors” you can set the colors of the window graphs and panels:

21 Graphical interface
2.1.2.2 Background Usage and Spectra Library In the application RadiaCode it is possible to display on the graph not only the spectrum of accumulated emission, but also to compare the spectrum with the previously measured background spectrum. You can display spectrum and background graphs simultaneously in overlay mode. To use a background, you first need to measure this background with the device over a period of time. Then you need to save the resulting spectrum to the spectrum library using the “Save” button on the window control bar or the “Save Spectrum to Library” local menu command. When you save the spectrum, you will be prompted to name the spectrum. The spectrum will be displayed with this name in the library list. If you leave the “Set as Current Background” option enabled, then after saving the spectrum will be displayed on the graph as a background. You can also select the background from the spectra library in future. If using spectrum and background from different devices for superposition RadiaCode, it should be borne in mind that different devices have different calibration factors. When overlaying spectra graphs, the application compares them per channel (the first channel with the first channel, the second channel with the second channel, etc.). Different devices have different emission energies corresponding to the same spectral channels, therefore, when the graphs from different devices are superimposed, differences in the positions of the peaks corresponding to the same emission energy will appear. If the program detects such a situation, then at the bottom of the window, in the engines panel will give the appropriate warning. Device RadiaCode is identified by its serial number.
Spectra library
The library of spectra is called by the item “Spectra library” of the local menu of the window “Spectrum”, the window “Spectra Viewer” or the command “Spectra library” of the menu “Tools” of the main application window. The list of saved spectra is displayed:
© 2024 Radiacode Ltd.

Graphical interface 22

The graph of the spectrum selected for display is shown in green.

For each saved spectrum, its graph in logarithmic scale and information about spectrum parameters is displayed.

Dialog buttons perform actions on the selected spectrum or spectra in the list:

· Set as current background: Select the spectrum to display as a background in the Spectrum and View Spectrum windows.
· Load to view: Load the spectrum for viewing in the View Spectrum window. · Rename spectrum: Set a new name for the spectrum. · Delete: Delete the data of a spectrum or several selected spectra from the library. · Edit calibration factors: A dialog window opens where you can set calibration factors a0, a1 and
a2 for the selected spectrum or spectra. This can be useful if the device, with which the spectrum/spectra was/were taken, was recalibrated.

Spectrum calibration is performed to convert the number of the spectrum channel to the value of the emission energy in keV using a polynomial of the 2nd degree of the form:

where

E = a0 + a1X + a2X2,

23 Graphical interface
x – channel number; a0, a1, a2 – calibration factors. · CSV export: Save the spectrum in a csv text file. · XML export: Save the spectrum in an xml text file. · XML import: Load into the library the spectrum/background from an XML file that was previously
saved when exporting from the application RadiaCode or from an app RadiaCode on the smartphone. See also: Export and import of spectra
2.1.2.3 Displaying isotope information As you move the cursor along the graph, information about the radioactive isotope whose energy corresponds to the cursor position is displayed at the top of the graph:
The name of the isotope, its corresponding energy, the energy corresponding to the cursor line on the spectrum graph, and the name of the decay chain for the isotope are displayed in square brackets. The thick pink line on the spectrum graph marks the position of the energy line of the isotope. If an isotope has accompanying lines, they are shown by thin pink lines. If there are several isotopes with close energies, then information about that isotope is displayed, the energy line of which is closest to the value of the energy corresponding to the cursor. In the spectrum settings, the display of isotope information can be turned off. The RadiaCode has a built-in isotope library. In the spectrum settings, you can select your own isotope library file.
Connecting an external isotope library
To make the application use an external isotope library instead of the built- in one, you need to create a text file with isotope information and select it in the spectrum settings. Every time you start the application RadiaCode copies its internal isotope table to the file AppIsotopes.csv in the same folder as the program’s executable file. The AppIsotopes.csv file can be used as a template for adding custom isotopes. The library file with isotope information is in text format. One line in the file describes one isotope. Fields in a line are separated by semicolons. Example: U-235;U-238;750,1001;190 Lu-176;;55,307;202 In Microsoft Excel, these lines look like this:
© 2024 Radiacode Ltd.

Graphical interface 24
· Field 1: Isotope name (required) · Field 2: Isotope decay chain name (optional) · Field 3: Energy of accompanying lines, separated by commas (optional) · Field 4: Isotope line energy (required)
When loading a file, the application checks the correctness of the information and, in case of errors, displays the appropriate messages. Please note that empty fields must still end with a semicolon so that the number of fields is exactly 4. 2.1.2.4 Export and import of spectra
Exporting a spectrum is saving its data to a csv or xml text file. To perform export there are corresponding commands in the local menus of the “Spectrum” and “View Spectrum” windows, as well as buttons in the dialog box “Spectra library”.
Two formats are supported: xml and csv. Both formats are supported by the popular Becquerel Monitor software.
A file in xml format can simultaneously include a spectrum and a background and contains all information about them – names, number of channels, spectrum accumulation time, calibration factors and the serial number of the device on which the spectrum and background were taken. This format is self-sufficient and does not require the user to perform additional import steps.
A csv file is a text file with a .csv extension that can be used not only with the Becquerel monitor, but also with other applications due to the simplicity of its format. Only pairs of values ?”channel number, number of pulses” are written to the file. The file name is formed as “Spectrum<Current date/time>s.csv”, for example, Spectrum_2021-05-12_13-5355_1426s.csv.
For spectrum and background overlapping from different devices RadiaCode read here.
Importing a spectrum to the library
You can import a spectrum into the spectrum library from an xml file that was previously saved by exporting from the application RadiaCode on your computer or smartphone.

2.1.3

“View Spectrum” window
This window has the same functions as the spectrum window, but it displays not the current spectrum of the instrument, but the spectrum from the spectra library.

To load a spectrum for viewing, open the Spectrum Library, select the desired spectrum, and click the “Load to View” button in the Spectrum Library.

The spectrum view window has its own set of display settings. You can specify different settings for the spectrum window and the view window, except for the isotope library.

2.1.4

Spectrogram window
This window displays the spectrogram of the registered radiation. A spectrogram is a visual representation of the energy spectrum of photon (gamma and X-ray) radiation varying with time. Displays a plot of either the spectrogram currently being recorded or the spectrogram loaded from

25 Graphical interface the Spectrogram Library. There is no separate window for viewing spectrograms, as there is for viewing spectra. To quickly switch to the Spectrogram window, click its button on the control bar of the RadiaCode:
Each line on the vertical (Y scale) is a separate spectrum typed in the “Capture Interval”. The size of the interval can be set in the settings. The horizontal (X scale) shows either spectrum channel numbers or photon energy calculated by analogy with the Spectrum window. The count rate in each individual channel (Z scale, similar to the Y scale in the Spectrum and View windows) is converted to a brightness or color scale, which can be zoomed using the sliders below the spectrogram. By pressing the the scale is automatically zoomed by the minimum and maximum values of the recorded or selected from the library of spectrogram. The energy lines on the spectrogram will look like vertical bands. The appearance of new bands will indicate a change in the spectral composition of the registered radiation. The Y-axis can display calendar time, spectrogram accumulation time or countdown number. The total spectrogram accumulation time and capture interval are displayed at the top left.
When you move the pointer over the graph, the lines of the marker with the numbers that correspond to the values on the axes are displayed. In the above picture, the energy of 654 keV corresponds to 1 pulse, and the spectrum was captured 1 minute 44 seconds after the spectrogram recording began. The Record button on the control bar of the window starts recording the spectrogram. Recording continues until it is stopped with the Stop button. Once the recording has been stopped, it cannot
© 2024 Radiacode Ltd.

Graphical interface 26

be resumed. Loading a spectrogram from the library does not stop the recording of the spectrogram, it continues in the background.
2.1.4.1 “Spectrogram window settings” dialog box. In this dialog box you can select different display options for the spectrogram window.

Dialog item
Spectrum capture interval
Maxim um number of sam ples
Scope

Description
At what frequency the spectrum “snapshots” (counts) are taken. Each sample (spectrum) is shown on the plot by a number of horizontal squares. Acceptable values are from 1 to 600 seconds. Since the timer of the instrument is not synchronized exactly with the timer of the smartphone, the intervals of accumulation of spectra received from the instrument can have a scatter of ±1 second.
Spectrogram buffer capacity. If the number of counts in the recorded spectrogram is equal to the specified value, the oldest count is deleted before adding a count. The maximum buffer capacity is 10,000 counts.
The count rate limits for the engine at the bottom of the window, which controls the brightness/palette of the plot. The squares of counts for which the count rate value is outside the specified values are displayed with border colors (start/end of the color scale). The minimum and maximum values of the scale can be automatically corrected by the application if the calculated

Scale
X-axis Units Y-axis Units
Palette Draw isotope lines Isotope Library

values exceed the limits Brightness button.

specified in the settings when you press the Auto

If you select the logarithmic scale, the decimal logarithm is taken from the value of its count rate before calculating the brightness/color of the square. Quickly switch the scale with the “Lin.” and “Log.” icons on the control bar of the window.

Select either the number of the spectrum channel or the energy of this channel as units of the X-axis.

You can select the calendar time (counted from the spectrogram recording start), spectrogram accumulation time (in hours:minutes:seconds) or count number (counts are numbered from zero).

When selecting the “Brightness” option, only grayscale is used to display the count rate on the plot. The other two options are a choice between color palettes.

Draw the pink energy lines of isotopes on the graph. Disabling this option does not disable the display of isotope information at the top of the window.

If you select “Built-in”, the Spectrum and View Spectrum windows will use isotope library, which is built into the program RadiaCode. If “Custom” is selected, the isotope information is taken from the specified file.

2.1.4.2 Spectrogram Library
Spectrogram Library
The Spectrogram Library is called by the Spectrogram Library item of the Spectrogram local menu of the Spectrogram window or by the Spectrogram Library command of the Tools menu of the main application window. A list of saved spectrograms is displayed:
© 2024 Radiacode Ltd.

27 Graphical interface

Dialog buttons perform actions on the selected spectrum or spectra in the list:

2.1.5

· Load into window: Load a spectrogram for viewing in the Spectrogram window. If a spectrogram is currently being recorded, it continues in the background. To return to the graph of the recorded spectrogram, click the Close button on the control bar of the Spectrogram window.
· Rename: Set a new name for the spectrogram. · Delete: Delete the data of a spectrogram or several selected spectrograms from the library. · Export .rcspg: Export spectrogram data to a text file with the .rcspg extension. .rcspg files can be
exchanged between applications RadiaCode for Windows and Android. · Import .rcspg: Import spectrogram data from a file with the .rcspg extension to the library.
“Current value graphs” window
The pulse count rate and dose rate graphs are displayed in this window. The data for the display is taken from the database and supplemented with real- time data from the device. The Y scale of the display is logarithmic.

At the top of the window information about the accumulated radiation dose and time of its accumulation is displayed, as well as the device temperature.

Graphical interface 28

At the top of the graph, the start and end date/time of the data section loaded into the application memory from the database are displayed in blue. This piece of data is available for display on graphs. At the top in the middle the time scale is displayed, in the picture it is 1 minute. I.e., the graph shows the data for 1 minute. You can change the scale using the magnifying glass icons on the window control bar.
You can specify in the program settings whether the program should always connect the points on the graph with a line. You can set the time interval in such a way that points on the graph that are spaced from each other in time by a value greater than the interval will not be connected by a line, but will be displayed with breaks. In the picture to the left, there are two circles that correspond to two single measurements.
The buttons on the window’s control bar duplicate the commands of the local right-click menu:

Menu item
Graph settings
Zoom in time (Xaxis)

Description Opens the graph settings dialog box. Stretch the image horizontally.

29 Graphical interface

Zoom out time (Xaxis) Find the previous m easurem ent
Find the next m easurem ent

Shrink the image horizontally.
Search for the previous/next piece of data after a gap in time. If the “Always connect graph points with a line” option is selected in the graph settings, these commands just flip backward/forward on one page. If the option to connect the points with a line is selected, if they are separated by no more than the specified interval, there may be gaps in the data on the graph, and these commands move the graph to the previous/next data section.

2.1.5.1 “Current value graph settings” dialog box In this dialog box one can set the options for displaying the graph window of current values.

Dialog item
Connect the graph points with a line
Graph line thickness Graph colors

Description
· Always – Connect neighboring points on the count rate and dose rate graphs with lines.
· Only if the time difference between the points is less than (hh:mm:ss) – If two adjacent points on the graph are more than the specified time apart, they are not connected by a line and there will be a gap in the graph.
You can select one of three values for the thickness of the graph line.
Click the black button with the horizontal color line to select the color of the corresponding graph.

2.1.6 “Message console” window

The “Message console” window displays RadiaCodeprogram messages that have been issued in the process. Error messages are displayed in red, information messages are displayed in black.

The “Message console” window saves the last 1024 messages, even when it is closed. You can open it at any time and see the messages and get help for each message.

The selected message is highlighted with the specified background color. To select another message, click it or use the cursor keys.

Local menu

Command Description

Clear window Deletes all messages from the window.

Message help Opens the help window for the selected message.

Dark window Toggle window colors between light (white background) and dark (black

them e

background) color themes.

Graphical interface 30

2.1.7

“Variables” window
The “Variables” window allows viewing the values of special function registers (SFR) of the device, as well as change these values.

The “Variables” window you just opened contains a single tab called “Main”. You can add more tabs (with the “Add new page” local menu command) and you can also change the name of any of the existing ones. The tabs work independently of each other, each tab is equivalent to a separate “Variables” window. You can also open multiple “Variables” windows.

When you add a new register (“variable”) to this window, RadiaCode places it on the active tab of the active “Variables” window. You can use Ins or the Ctrl+A hotkeys to add a variable to the “Variables” window.

The window will highlight the selected object in color. To select another object, click on it or use the cursor keys.

Display options

There are vertical and horizontal grids in the window, which can be enabled/disabled separately.

When the vertical grid is enabled, the data in the window is arranged in columns and each column has a title in the form of a button. Pressing Name, Type and Address buttons opens the “Display options” dialog box for the selected variable in the window. Pressing the Value button opens the “Change value” dialog box for the selected variable.

When the vertical grid is disabled, double-clicking on the line with the object opens the “Change value” dialog box for that variable.

To enable/disable the vertical or horizontal grid, use the corresponding checkbox in the “Fonts” tab (“Configuration” menu, “Environment” command).

Local menu

The local window menu contains the following commands, each command has a button on the window toolbar:

Com m and
© 2024 Radiacode Ltd.

Description

31 Graphical interface

Add variable/expression Delete watch Delete all watches Modify
Move watch up Move watch down Display options
Add new page
Window help Properties

Adds one or more objects to the window. Opens the Add a variable to the window to select an object by name.
Removes the selected object from the window.
Removes all objects from the window.
Opens the “Modify”dialog box, to set a new value for the selected variable. You can do the same thing by just starting to type a new value on the keyboard.
Moves the highlighted object in the list one line up.
Moves the highlighted object in the list one line down.
Opens “Display options” dialog box to change the display parameters of the selected object, as well as to add or remove tabs in the window.
Operates in the same way as the “Add page”button of the “Display options” dialog box.
Calls this contextual help.
Controls window properties – font, colors, etc.

2.1.7.1 “Display options” dialog box
This dialog box controls the options for displaying the selected variable or expression in the “Variables”window, and adds or removes tabs in this window.

Dialog item

Description

Variable name

Contains the name of the selected variable.

Display format

Specifies the representation format for the selected variable: binary, hexadecimal, decimal, or ASCII.

Pop-up description

Enables pop-up descriptions for special purpose registers.

Display bitmap

Includes pop-up descriptions of special-purpose register bitmaps, if any.

Display bit descriptions

Enables pop-up descriptions for special purpose register bits, if any.

Automatic name field size

When this option is checked and the vertical grid is enabled (see note below), the window automatically adjusts the “Name” column Name to the longest record in the column.

Pages

List of tabs in the window.

Add page

Opens the “Add new page to Variables window”dialog box, to enter the name of a new tab. Window creates new tab by pressing “OK”.

Delete page

Deletes the tab highlighted in the “Tabs” list.

Edit page

Opens the “Set page name”dialog box, to edit the tab name.

Graphical interface 32
Note. To enable a vertical grid, use the “Configuration”menu, “Environment”, box, “Font”tab, checkbox in the “Grid”.
2.2 Main menu of RadiaCode
“File” menu “View” menu “Configure” menu “Tools” menu “Window” menu “Help” menu
To open a menu, use the mouse or an “Alt+letter” keyboard shortcut, where “letter” is the underlined letter in the name of a menu item or command.
© 2024 Radiacode Ltd.

33 Graphical interface

2.2.1 “File” menu

Menu item New file Open…
button Save as…
Print…
Properties… Configuratio n files Exit

Action Opens the Editor window without loading any file. Opens the “Open file” dialog box. The file selected here will be opened in the “Editor” window. Saves the file from the active “Editor” window to disk. Queries a new name for the file from the active “Editor” window and saves that file with the new name to disk. Opens the default “Print” dialog box for the default printer. You can print the whole file or a selected text block. Opens the standard “Properties” dialog box for a file. Opens a submenu for actions with configuration files..
Closes the session RadiaCode. You may also use the Alt+F4 or Alt+X keys to finish your work.

Graphical interface 34

2.2.1.1 Configuration files

At the end of the session, RadiaCodeautomatically saves its configuration parameters in several files. At the beginning of a new session, it opens these previously saved files. Also, at any time any of these files can be saved or loaded independently of each other through the “File” menuwith the “Configuration files”. You can have several sets of configuration files with different settings of RadiaCode, and load them “on the fly”.

· Screen configuration file (Desktop) contains the on-screen display option values, location, sizes, colors, and fonts of all of the debugger specialized windows. The extension of this file is .dsk.

· Options file (Options) stores the settings of RadiaCodethat are displayed, when the settings dialog box is called.The extension of this file is .opt.

These two files can be given arbitrary names. On completion of work, RadiaCode saves them to the folder,

and from which they were downloaded, or to which they were saved last time. These two configuration files can

be individually loaded or saved using the “File”

Configurationfiles

In addition to these,RadiaCode uses thesession file, which contains the session data and indicates which screen configuration file and options file to load at the beginning of the next session. This file can be loaded or saved with the “Load session” and “Save session” commands from the”Configuration files”submenu. The extension of this file is .ses.

2.2.2 “Edit” menu
Here are the commands for working with the text editor built into RadiaCode.
The commands in this menu apply to the currently active Editor window.

The

Command

“Ad

file”

Return

Copy block Delete block Insert block

Clipboard history/Repository
Append block to clipboard

Description
Cancels the last text editing operation in this window. The number of steps that the Undo function covers is set in the “Configuration” menu in the “Editor options” tab of the “Editor options”.
Copies the selected block to the clipboard. The format of the text in the buffer is standard, and this block is available to other programs.
Deletes the selected block and places it on the clipboard.
Copies a block from the clipboard starting with the cursor. If the block to be copied was placed on the clipboard from the RadiaCode, program, the block type will not change (line, vertical, or streaming). Blocks from other applications, will be of the standard streaming type.
Opens the Clipboard history/Repository
Copies the selected block of text and adds it to the end of the current clipboard contents.

35 Graphical interface

Delete block and append to clipboard
Text search

Deletes the highlighted block and adds it to the end of the current clipboard contents.
Opens the “Text search”.

Repeat search
“Find/Replace text” dialog box
“Show search results by file”
Go to the line with number
Set tab

Repeats the search with the same parameters that were set for the previous search.
Opens the “Find/Replace text”.
Repeatedly shows search results through multiple files in the “Show search results by file”.
Opens the “Display from a new line”. The original text will be shown starting from the specified line.
Opens the “Set tab” dialog box for local tabs

Restore tab

Opens the “Restore tab” dialog box for local tabs.

Condensed text mode

Switches the Condensed text mode .

Condensed mode setup Opens the “Condensed mode setup”.

Find a pair for the bracket/comment
Restore the editing context
User scripts

Finds a paired bracket or comment tag for a bracket or tag at the cursor position. If a pair is found, the cursor will move to it.
The brackets can be: round ( or ), square [ or ] and curly { or }. Tags can be / or /.
Activates the “Editor” window of the previous edit and sets the cursor at the place of the last edit. If this “Editor” window was already closed, then RadiaCode reopens it.RadiaCode During debugging, you usually need to switch between multiple files frequently. This command helps you to quickly jump to the location of the last edit.
Additional menu for accessing the text editing automation functions.

2.2.2.1 “Search for text” dialog box

The dialog box sets the search parameters for the text phrase in the files. The same parameters in this dialog box and the “Find/Replace text” dialog box are equivalent. You can specify file names with one or more wildcard characters. You can specify a path along with the file name. Also, you can search several files at once, using the options in the “Multi-file search results” panel.

Dialog item
Search line Match case

Description
Specifies a fragment of text to search for (search line). Enables letter case matching. Disabled by default.

Graphical interface 36

Whole words only
Regular expressions Entire area Selected text only From cursor position Entire scope Perform multi-file search and replace Search wildcards
Search in subdirectories Initial path

Search only whole words: a line will be considered found only if it is between punctuation marks or delimiters (spaces, tabs, commas, quotation marks, etc.). Disabled by default.
Indicates that the line you are looking for is the search expression. Disabled by default.
Search in the entire file. Enabled by default.
Search only through the selected text.
Search starting from the current cursor position
Search from the beginning or the end of the file (depending on the search direction). Enabled by default.
Enables searching through multiple project files (see notes below). If the checkbox is unchecked, the search will be performed only in the active “Editor” window.
Contains a wildcard or wildcards of file names to search through. If there are several wildcards, they should be separated by semicolons. To specify long names as accepted by Windows, you do not need to put quotation marks. Example: .txt;.c;c:prog.h.
Search in subdirectories of all folders specified by wildcards.
Start the search from the folder you specify here. This folder serves as a shared path and is convenient when you need to substitute several wildcards of the following kind: c:progtextsource.txt;c:progtextsource.doc In this case, use wildcards (.txt;*.doc) and shared path (c:progtextsource).

Notes
1. If you set a search in a file opened in the Editor window, the searchwill be performed in the window buffer, not in the file on disk.

2.2.2.2 “Find/Replace text” dialog box
The dialog box sets the search parameters for the text phrase in the files. The same parameters in this dialog box and the “Find/Replace text” dialog box are equivalent. You can specify file names with one or more wildcard characters. You can specify a path along with the file name. Also, you can search several files at once, using the options in the “Multi-file search results” panel.

Dialog item
Search line Replace with

Description
Specifies a fragment of text to search for (search line). Sets the fragment of text to be substituted for the one found.

37 Graphical interface

Match case Whole words only
Regular expressions
Confirm replacement
Entire area Selected text only From cursor position Entire scope
Perform multi-file search and replace
Search wildcards

Enables letter case matching. Disabled by default.
Search only whole words: a line will be considered found only if it is between punctuation marks or delimiters (spaces, tabs, commas, quotation marks, etc.). Disabled by default.
Indicates that the line you are looking for is the search expression. Disabled by default.
Indicates to open the “Confirm replacement” dialog box to confirm the replacement of this found text fragment. Enabled by default.
Search in the entire file. Enabled by default.
Search only through the selected text.
Search starting from the current cursor position
Search from the beginning or the end of the file (depending on the search direction). Enabled by default.
Enables searching through multiple project files (see notes below). If the checkbox is unchecked, the search will be performed only in the active “Editor” window.
Contains a wildcard or wildcards of file names to search through. If there are several wildcards, they should be separated by semicolons. To specify long names as accepted by Windows, you do not need to put quotation marks. Example: .txt;.c;c:prog*.h.

Search in subdirectories Search in subdirectories of all folders specified by wildcards.

Initial path

Start the search from the folder you specify here. This folder serves as a shared path and is convenient when you need to substitute several wildcards of the following kind:
c:progtextsource.txt;c:progtextsource.doc
In this case, use wildcards (.txt;.doc) and shared path (c:progtextsource).

Replaces the first found instance of the line searched for.

“Replace all”

Replace all found instances of the searched line.

Notes
1. If you set a search in a file opened in the Editor window, the searchwill be performed in the window buffer, not in the file on disk.
2. If you search in several files, the “Confirm replacement” dialog box opens at the end of the search.

2.2.2.3 “Confirm replacement” dialog box
This dialog asks for confirmation to replace the found instance of the searched line. To enable or disable this dialog box, use the “Confirm replacement” checkbox in the “Find/Replace text”.
© 2024 Radiacode Ltd.

Graphical interface 38

The “Add file”
Yes No
Non-Stop Cancel Skip this file Replace in all files Move cursor to the “Yes/No” buttons

Function
Replace the given instance of the line you are looking for.
Do not replace. If the procedure was started with the “Replace all” button for all found lines in the search area, the search and replacement process will continue. From now on, replace all lines found in this file without asking for confirmation. Stops the search and replace process. Stop searching through this file and go to the next file. Replace all lines found in all other files without asking for confirmation.
When this checkbox is checked, the cursor will automatically be set to the “Yes” button in each request to confirm the replacement, to make the work easier.

2.2.2.4 “Multi-file search results” dialog box
This dialog box displays search results through multiple files. Learn more about searching through multiple files in the chapter “Text search”.
File list, in which a line is found, contains all files where the line was found: the file name on the left and its folder on the right. The line with the green text directly below this list displays information about the file selected in the list. The entry “File in memory” means that the file is open in the “Editor”. If this line shows general data about the file (according to the file system), it means that this file is not loaded into memory. “Line” panel shows the line of the source file containing the fragment you are looking for.
The “Sort files by” switch box sets the sorting method. When the “Consider directory”checkbox is checked, the files in the list will be sorted according to their folders.
The “Add file” “Edit” button opens the selected file in a new “Editor” window and puts the cursor in the line with the found fragment. The found fragment will be marked with a background color. To check if there are other instances of the searched fragment in this file, click Ctrl+R or use the “Editor”menu, “Repeat search”.
The “Add file” “Close” button closes the dialog box, but the search results are not lost. To reopen this dialog box, use the “Show search results by file” button at the “Editor”toolbar, Shift+F5 Shift+F5 or the “Editor”. In this case, the files in the “File list” File list, in which a line is found,opened in the “Editor”?windows are marked with an asterisk on the left.

2.2.2.5 Regular expressions

The text editor supports so-called “regular expressions” that can be used for special text strings. Regular expressions contain control characters in the searched text string:

Means one of any characters in that position. Example: if you set ?ell. as the line you are

looking for, the words “bell”, “tell”, “cell”, etc. will be found.

Denotes the beginning of a line. The characters following “%” shall start at position 1.

Example: %Counter–find the word “Counter” that starts at the first position in the line.

39 Graphical interface

Line end. Characters preceded by “$” shall be in the last positions in the line. Example:

Counter$–find the word “Counter” at the end of the lines.

Find a character directly; “@” allows setting control characters as regular letters.

Example: @?find the question mark.

xNN

Hexadecimal value of the symbol. Example: xA7–find a character with hexadecimal code A7.

Undefined number of units of the previous character. For example, if you specify 1T+2,

the editor will find lines containing “1” followed by “2”, with any number of letters T in

between.

[c1-c2]

Equals any character between c1 and c2. Example: [A-Z]. means any letter from A to Z.

[~c1-c2]

Equals any character that does not lie between c1 and c2, i.e., 0 to c11 or from c2+1 to 255. Example: [~A-Z] means any character except uppercase letters.

text1|text2

The symbol “|” indicates a logical OR and the editor will search text1 or text2. Example: LPT|COM|CON–Find “LPT” or “COM” or “CON”.

Don’t forget that to use regular expressions, you have to check the corresponding checkbox in the dialog box.

2.2.2.6 “Set tab/Restore tab” dialog boxes
Bookmarks are used to return to the marked cursor position in the source file at a later time. There are local and global tabs. Local tabs are valid within a single file. Global bookmarks store not only the cursor position but also the file name.
Up to 10 local bookmarks can be defined and used with these dialogs. Each local bookmark is assigned an individual button with a number.
To open the “Set bookmark” dialog box, press Alt+[. To open the “Restore bookmark” dialog box, press Alt+]. To set a bookmark or go to it, click its button with the number. The number of the line in which the bookmark is set, the bookmark position in the line (in brackets) and the text of the line are displayed to the right of the button.
Local bookmarks are stored in the configuration file, and you can return to them in the next session.
The “Add file” button opens the corresponding dialog box “Set/Restore global bookmark”.

2.2.2.7 “Set/Restore global tab” dialog boxes
Bookmarks are used to return to the marked cursor position in the source file at a later time. There are local and global tabs. Local tabs are valid within a single file. Global bookmarks store not only the cursor position but also the file name. When you navigate to a global bookmark and the corresponding source file is not open in the “Editor”, RadiaCodeopens it and places the cursor in the position marked by the bookmark. The “Add file” Delete removes the selected bookmark from the list. Global bookmarks are stored in the configuration file and can be returned to in the next session.

2.2.2.8 Condensed text mode
In Condensed text mode, only lines satisfying the specified criterion are displayed in the window. There are a total of two criteria:
© 2024 Radiacode Ltd.

Graphical interface 40

· The string shall contain a specified fragment (sequence of characters).
· The first character in the line that is not a space shall be in the specified position.
Examples: (a) the first of the criteria and “counter” fragment is set, result- only lines with the word “counter” in them will be displayed; (b) the second criterion is set and position 4, result–only lines with text starting at position 4 will be displayed.
The condensed text mode “puts together” strings with a common attribute. For example, if you strictly adhere to the rule of starting data declarations at position 2, procedures–at position 3, and interrupt handlers.–at position 4, then the condensed text mode will really speed up the search for the desired ad. If you comment certain places in the text with the same character string and use the condensed text mode with the specified fragment, this style helps you to find the necessary parts of the text easily. In the condensed text mode you can move the cursor in the same way as in the normal mode.
How to control
The criterion for displaying lines is set in the “Condensed text mode options” Condensed mode setup. To enable or disable condensed text mode, use the “Editor” menu command, or the “Condensed text mode” button at the “editor” toolbar,, or F11 Key. To exit the condensed text mode, press Esc. In this case, when you exit this mode, the cursor goes back to where it was before this mode was enabled. To keep the cursor in the row where you placed it when you exit the mode while the mode was enabled, press “Enter” or start editing this line.

2.2.2.9 “Condensed mode setup” dialog box

This dialog box controls the condensed text mode options in the”Editor”.

“Display lines of text” switch box sets one of the two available criteria:

1. “Containing string” sets the display of lines with the text fragment specified in the text field. In addition, you may check the case of letters, search only for whole words, or use regular expressions.

2. “Where first non-blank column is…” sets the display of lines, in which the text (the first character not equal to space) starts from the position specified in the “Column” field. Obligatory parameters additionally characterize the criterion:

· “Equal to” the first character of the text shall be exactly in the specified position. For example, if the 2nd position is set, the window will display only the lines where the text starts from the 2nd position.

· “Not equal to”

the first character of the text shall be in any position other than the specified one.

For example, if the 2nd position is set, the window will display only lines where the text starts NOT from

the 2nd position.

· “Less than” one.

display only lines, where the text starts from a position lower than the specified

· “Greater than” one.

display only lines, where the text starts from a position greater than the specified

After clicking “OK”, the “Editor” window switches to the condensed text mode.

2.2.2.10 Clipboard history/Repository

Dialog item

Description

Clipboard history

List of records on the clipboard since the start of RadiaCode, records are collected regardless of the applications, from which they were copied. The clipboard history is lost after exiting RadiaCode.

Paste

Paste the selected text into the active “Editor” window.

41 Graphical interface

Max records in history:
Do not memorize records more than: Clipboard repository
Paste
Add branch Remove branch/item Edit Move up Move down

The maximum number of records that can be stored in the clipboard history. When the maximum number of records is reached, the oldest record is deleted.
Sets the maximum size of a text block that can be written to the clipboard history. If the size of the block to be written exceeds the set size, the writing of that block will be ignored.
A clipboard repository is a persistent set of clipboard records (blocks of text) represented as a tree. You can add records to the repository for later use. Records can be arranged as “branches” (“folders”). Use “drag and drop” operations to organize “folders” and records.
Paste the text of the selected repository record into the active “Editor” window.
Add a “branch” (“folder”) to the active repository record.
Delete the selected branch or record.
Edit the name of the selected branch.
Move the selected branch or record up the tree.
Move the selected branch or record down the tree.

2.2.2.11 “Editor” toolbar
At the “Editor” toolbar, there are buttons for the main editing operations, which correspond to the “Editor” menu commands. Almost all buttons are available only when the “Editor” window is active. Information messages sent by the editor are duplicated in the editor information panel.
The editor toolbar commands are represented by several icons (Copy Block, Find Text, Set Bookmark, etc.). You can adjust the commands to your convenience. After that, only the buttons you select will be visible.
To select the “Environment” dialog box you should right-click on the empty right side of the top panel. In the popup window, select Customize… You can access the “Environment” dialog box (via the “Configure”menu). In the right panel of the dialog box, you can mark which buttons on the Editor toolbar you need for your work.

2.2.3

“View” menu
You can use this menu to open windows of RadiaCode.. If a window of a certain type is already open, a second instance of the window is not opened and the already open window becomes active.

2.2.4 “Configure” menu
Comman Action d

Graphical interface 42

Options of Opens the “Configuration” dialog box RadiaCode. RadiaCod e.

Environme Opens the “Environment” dialog box with the following tabs “Fonts”, “Colors”, “Key

nt…

assignment”, “Control bar” and “Miscellaneous”.

2.2.4.1 “RadiaCode options” dialog box Various settings related to the device, measurement modes, schedules, etc.

2.2.4.1.1 “Device” tab
Device settings. These settings are also accessible from the menu of the device itself. When you connect the device to the program, the settings are read from the device; when you click “OK” in the settings dialog box, all settings are written to the device.

Dialog item

Description

Indication

Enable sounds

Allow the device to produce sounds. Different sounds can be controlled by individual options, see below. Disable “Enable sounds” option disables all device sounds regardless of the individual option settings.

Enable vibration

The device will vibrate for alarms as well as certain events. Vibration can be enabled or disabled individually for each alarm and event. Disabling the “Enable vibration” option disables device vibration regardless of the individual option settings.

Enable light indication

Allow the device to display lights using the LEDs built into the enclosure.

Alarm thresholds

Dose and dose rate values above which alarms are issued. Threshold values are specified in the units selected in the “Units of measure” group (Roentgens/Zyverts) in the “Program settings” tab. For each alarm, you can enable the sound and vibration of the device.

Alarms mode

Select the alarm sound mode: · Once – the audio alarm sounds once when there is an alarm. · Continuously – the audio alarm sounds continuously when there is an
alarm.

Signals

When you click on the button,

the device will acknowledge with sounds and/or vibrations, when the buttons on its body are pressed.

When registering particles

Output click sounds. The frequency of the clicks tells you the approximate registered radiation level.

When

connecting/disconne Emit sounds when the device is connected to the application RadiaCode

cting with an

on your smartphone via Bluetooth and when disconnecting from it.

application

43 Graphical interface

When switching on/off

Output sounds when switching on/off.

Display backlight

Disabled

The device display backlight is never enabled.

Enabled every time Pressing any button on the device body enables the backlight for the time the button is pressed defined in the “Disable” field.

Enabled depending Pressing any button on the device body enables the backlight for the time on the illumination defined in the “Disable” field if the device considers it is in low light mode.

Disabling

The time after which the device screen will be disabled if no key is pressed on the device.

Brightness

Brightness level of the device display backlight, from 0 to 9.

Miscellaneous

Display rotation

· Automatically: the device itself selects the orientation of the display according to the built-in accelerometer.
· Only normal orientation: Orient the device display to control the buttons with the right hand.
· Only inverted orientation: Orient the device display to control the buttons with the left hand.

Device language

You can select the language of the device interface.

2.2.4.1.2 “Program settings” tab

Dialog item

Description

Unit of measure

Choose in which units the information about registered radiation level (Roentgens/Zyverts) is displayed in the program.

Database integrity Perform a database test, when the program starts. The test can take

test on startup

some time.

Create log file

Record device events in a text file on your computer disk in approximately the same form as they appear in the log window.

Log file mode

Here you can choose whether to create the log file anew, when the program starts, or to attach new entries to the end of the log file if it already exists.

Log file name

Here you can specify the full path to the log file.

How many days to keep backups of the base

If since the last startup of RadiaCode more than 24 hours have passed, the program creates a backup database file, so that the file could be restored manually if it fails. In this field you can specify how many backups to keep.

Graphical interface 44

2.2.4.2 “Environment” dialog box
In tabs of this dialog box, one can adjust appearance of windows RadiaCode and other interface elements, as well as define “hotkeys” for quick access to commands of the main menu and RadiaCode windows.
“Fonts” tab “Colors” tab “Key mappings” tab “Toolbar” tabDisplayOptions_Toolbar “Misc” tab
2.2.4.2.1 “Fonts” tab

The “Fonts”tab of the “Environment” dialog box controls the fonts in the program windows RadiaCode. The “Window” list contains all types of windows. To set parameters for a certain window type, select it in the list. The new settings apply to all windows of the selected type, including those already open.

Dialog item Description

The window has a title

Includes a title bar for windows of this type. When the checkbox is unchecked, the windows are made smaller by the lack of a title. Also, see notes below.

Window control bar

Controls the position of the toolbar in the window of this type.

Grid

Enables the display of a vertical and horizontal grid in the window and allows column widths to be changed (if vertical grid is enabled).

Line spacing

Sets the line spacing, which will be added to the standard line spacing. The new value can be printed or selected from a list of recently used values.

Select font

Opens the “Font” dialog box. The selected font will take effect for all windows of that type.

This font is for Uses the font set for windows of this type for all windows in the program all windows RadiaCode.

Notes
1. To move a window that has no title bar, place the mouse cursor on the portion of that window’s toolbar that has no buttons, and then act as if the toolbar were a title bar. Also, one can access the window control functions through its system menu, by pressing the Alt+”gray minus” key combination. 2. Each window has a “Properties” item in the local menu. The “Window title” and “Control bar” items of the “Properties” submenu toggle the title bar and toolbar for that particular window.

2.2.4.2.2 “Colors” tab

“Colors” tab of the “Environment” dialog box controls the color in the program windows RadiaCode.

Dialog item

Description

45 Graphical interface

Color scheme Colors

Specifies the name of the color scheme. It can be printed or selected a recently used one from the list with the button. The “Add file” button saves the scheme in use to the disk. The “Add file” Delete deletes it.
List of color group names. Each group consists of several colors.

Inherit Windows color

When the checkbox is checked, the selected color is taken from Windows. If you later change the Windows colors through the control panel, this color will change accordingly.

Use inverted text/background color

When the checkbox is checked, RadiaCode inverts the selected window colors
(for text and background). For example, if in the “Variables” window the background color is white and the text color is black, then the line with the selected variable will be highlighted with a black background and white text.

“Select…” button

Opens the “Color”, if checkboxes Inherit Windows color and Use inverted text/background color are unchecked for windows of this type.
“Color” dialog box also opens if you double-click on a color in the list Colors. .

“Default color(s)” button

Sets the color selected in the list as the default color. If not a color, but a group of colors, such as “Database window”, is selected in the list,
all window colors will be set to default values.

“Set for all” button

Specifies the use of this color in all windowsRadiaCode. This feature is useful for text and background colors. For example, if you select blue background and yellow text for the “Editor” window and then click the “Set for all”button, these colors will be set for the background and text in all windows.

Font

For some colors it is possible to set additional font attributes: “Bold” and “Italic”.

2.2.4.2.3 “Key mappings” tab
The “Key mappings” tab of the “Environment” dialog box allows assigning keyboard shortcuts to any command in RadiaCode, including local window menus. Column “Menu commands” displays a tree-like command system. Columns Key 1 (Key 2) contain the corresponding key combinations assigned to the commands. All actions in this tab relate to the selected command.

Dialog item

Description

Set key 1 Set key 2

Opens the Set key combination. In the dialog box, press the key combination you are going to assign to the command, or press Cancel. Also, you can open this dialog box by double-clicking in the “cell” where the row of this command intersects the column Key 1 or Key 2.

Graphical interface 46

Delete key 1 Delete key 2

Cancels the assigned keyboard shortcut for a given command. Also, to cancel the combination, you can right-click in the “cell” where the row of this command intersects the column Key 1 or Key 2.

2.2.4.2.4 “Toolbar” tab
“Colors” tab of the “Environment” dialog box includes window toolbar RadiaCode and their buttons.

Dialog item

Description

Groups

Contains a list of all program toolbarsRadiaCode. To enable/disable the toolbar, check its checkbox in the list.

Buttons / Com m ands

List of buttons for the toolbar highlighted in the list GroupsTo show/remove a panel button, check its checkbox in the list.

Flat window control bars.

Switches the appearance of the buttons between flat and quasi-3D for the toolbar of specialized windows in the program RadiaCode. Toolbar buttons of the window RadiaCode are always flat.

Control bar settings Make the control bar settings “global”. are the same for all screen files

2.2.4.2.5 “Misc” tab
The “Misc” tab of the “Environment” dialog box controls different window functions and message parameters in the RadiaCode. It is designed for comfortable work with RadiaCode.

Dialog item

Description

Status bar of the home window

Controls the presence and location of the status bar of the program window RadiaCode.

Highlight the title of the

Enables current tab highlighting (MS Windows style) in windows with

active page in the windows tabs.

Double-click on checkboxes and switch boxes in dialog boxes == single-click + “Ok” button

Specifies the double-click function, which is equivalent to singleclicking the corresponding dialog item and pressing the “OK” button in this dialog box.

Show “hotkeys” in popup descriptions

Enables/disables the display of shortcut key combinations in the toolbar button tooltip.

Do not display message dialogs if a console window is open

Sends all messages to the “Message console”window if it is open.
If closed, the message will be sent in a separate box.

47 Graphical interface

Always display message dialogs
The cursor is positioned on the “OK” button
Sound notification for error messages
Write messages to the log file
Start the log file from the beginning at every start Write messages to the end of the file

Displays all messages in separate boxes. “Message console” window also displays these messages.
If the checkbox is checked, then in every open message window the cursor is automatically placed on the “OK” button of this window. This function can be disabled if you prefer to press the “Enter”button, not click the “OK” button with the mouse.
Enables the sound for error messages. Information messages are always issued without sound.
Sets the log file name. All messages are recorded in this file. The recording method is selected by a switch box that has the following positions:
Specifies to create a new file for each session and to delete the previous file if it exists.
Specifies whether to add messages to the end of an existing file. With this the file size will grow indefinitely.

2.2.4.3 “Editor options” dialog box 2.2.4.3.1 “Editor options” tab

The dialog box Editor options tab of the Editor options sets the options common to the open windows of the Editor (Editor window).

Dialog item

Description

Backspace merges leading spaces

Switches Backspace Unindent mode. Cm. Note 2.

Leave end spaces

When this checkbox is checked, it indicates whether spaces at the end of lines should be kept when copying the text to the buffer or saving it to disk. If the checkbox is unchecked, these spaces will be removed.

Vertical blocks

Enables vertical block mode for block actions.

Constant blocks

Enables Persistent Blocks mode for block actions.

Creates a .BAK file.

This checkbox indicates to create a *.BAK file each time you save a file in the “Editor”.

Horizontal cursor

The checkbox checked enables the display of the cursor as a horizontal line.

CR/LF at the end of the file

The checkbox checked enables adding a blank line to the end of the file when saving the file to disk, if there is no such line.

Syntax highlighting in color

The checkbox checked enables the syntax highlighting of language constructions.

Highlight multiline comments

This checkbox checked enables the highlighting of multiline comments. By default, the window highlights only single-line comments.

Graphical interface 48

Full path in the window title

This checkbox checked enables displaying the full path of the opened file in the “Editor”.

Clear clipboard before copying

When unchecked, copying to the clipboard does not delete its previous contents.

Convert keyboard input to OEM

When this checkbox is checked, the “Editor” window converts the characters you enter in the window from MS Windows encoding to OEM (national) encoding corresponding to your national version of Windows.
Cm. Note 1.

Highlight the paired “(” and “{” “)” “}”

When this checkbox is checked, after entering the symbol “)” or “}”, the Editor automatically finds and highlights the text fragment from the entered bracket to the appropriate opening one.

Autosave files every … min

Sets the time interval for saving the file automatically. Enter the value in minutes in the field on the right.

Tab size

Sets the tab width for displaying text. Valid values range from 1 to 32. If there are ASCII tab characters in the open file, they will be replaced by spaces according to the specified tab width.

Return counter

Sets the maximum available number of return steps (512 by default). If this is not enough, you can set the number of steps up to 10000. However, larger values require more memory for the editor.

Auto indent

Toggles the automatic indentation options for a new line created by pressing the “Enter”.

If another application has modified the file

Sets the behavior when another application changes the file opened in the “Editor” window.

Tab size

Sets the tab size in spaces.

Return counter

Sets the size of the return stack used in the “Return” operation of the Editor.

Highlight Russian letters with color

The checkbox checked enables the selection of Russian letters that are not inside comments or not enclosed in quotation marks.

Note.
1. Checkbox Convert keyboard input to OEM should be checked only if you are going to change the text of the file in the Editor in OEM encoding. If you only want to view such a file, set the Terminal font for the “Editor” window in the “Fonts” tab of the “Environment”. To do this, select the “Editor” item in the “Window” list and press the “Select font”.
2. The Backspace Unindent mode sets the result of Backspace key pressing:

Backspace Unindent enabled

Backspace Unindent disabled

Insert mode Overwrite mode

All spaces to the left of the cursor are deleted.

Removes one space to the left of the cursor. The cursor and the rest of the line to the right of the cursor are moved one position to the left.

The cursor moves to the first position in Only shifts the cursor one position to the the line. The text in the line stays where left. The text in the line stays where it is. it is.

49 Graphical interface

2.2.4.3.2 “Key mappings” tab
With the “Key mappings” tab of the “Editor options” dialog box it is possible to manipulate the list of available editor commands: add new commands to the editor, delete them, assign and reassign keyboard shortcuts for new and built- in commands.
In the “Command description” window, the left column of the list contains command descriptions. The second column shows the command type (the word “Command” means a built-in command of RadiaCode; Script ‘XXX’. means the added custom command). The two columns to the right show the two key combinations for calling this command, if any. Both combinations are equal to each other.

Dialog item
Add Delete Edit
Edit script file

Description
Opens “Edit command” dialog box to add a new command to the list and set its parameters.
Deletes the highlighted custom command from the list. Built-in commands cannot be deleted.
Opens the “Edit command” dialog box to adjust command parameters. For built-in commands, you can only reassign key combinations ( Command description and Script name fields will not be available).
Opens in the”Script text” window the source text file of the selected command

Creating a new command To create a new command, you have to make a script file for it. In fact, a script, not a command, will be added to the editor. This means that a custom command is capable of much more complex and multistep action than a normal editor command. Moreover, you can tailor this action to your specific situation or a specific work task. Your scripts can take advantage of the functionality of the scripting language itself, its rich set of built-in functions and variables, text editing functions, and existing scripts. The script source text file is an ASCII file. To execute the script, the editor compiles the script source file. Note that before you can use the script you have just edited, you shall first make sure to save the source file on the disk in order to recompile it with RadiaCode’a. Script source files for new commands shall be stored only in the KEYCMD folder located in the root folder RadiaCode. Program package RadiaCode contains several files with example scripts. For more information about scripting, see the chapter “Script files and automation of the emulator”.
2.2.4.3.3 “Edit command” dialog box
This “Edit command” dialog box is designed to work with the parameters of a new or existing command.

Dialog item
Command description
Script name

Description
You can enter a command description here (not for built-in commands). The text of this field is displayed in the command list.
Name of the script file that executes this command

Graphical interface 50

Set key combination #1 Set key combination #2
Delete key combination #1
Delete key combination #2

Opens a specialized dialog box that senses the key combination you press in it and assigns/unassigns that combination to a given command. The buttons correspond to the first and second key combinations.
Deletes key combination #1.
Deletes key combination #2.

Script source files for commands shall only be stored in the KEYCMD subdirectory of the system directoryRadiaCode. The file name should be specified without path or extension.
Notes
1. You cannot specify key combinations reserved in Windows (e.g, Alt+- or Alt+Tab).
2. It is not recommended to specify combinations already occupied in the editor and programRadiaCode, because in this case you will have fewer ways to use these commands. For example, the combinations that open the application menu, e.g, Alt+F, Shift+F1, Ctrl+F7, or keyboard shortcuts from the local menu of the editor window.
3. You can use more than one control key in combination. For example, it is possible to use not only Ctrl+F, but also Ctrl+Shift+F or Ctrl+Alt+Shift+F.
4. For some built-in commands, key combinations cannot be reassigned (e.g. cursor movement keys).

2.2.5 “Database” menu

Com m and
Choose database…
Copy database to…

Action
Select database file to work. By default, the shared shared database.
Copy the currently open database to another location on the computer. This is usually a removable medium, such as a flash module. This command allows copying the database without knowing the location of its file on your computer. Only the destination folder or device name is requested.

2.2.5.1 “Choose database” dialog box

Dialog item
Use a shared database
Use the specified database file
History

Description
Use the shared database file to record and display the data in the log window.
In the field below one can specify which database file to use to record the data and display it in the log window.
List of previously used database files.

51 Graphical interface

2.2.6 “Tools” menu
Command Action Calculator Opens the “Calculator” dialog box.

2.2.6.1 “Calculator” dialog box
This dialog serves to calculate expressions and convert values from one number system to another. The result can be copied to the clipboard.

Dialog item Description

Expression Input field for an expression or number.

Copy as

Specifies the format in which the result will be copied to the clipboard.

Character values

Specifies that the result should be interpreted and displayed as a character value (valid only for decimal numbers).

Display

Enables the display of leading zeros (in high digits) in binary and hexadecimal

nonsignificant numbers.

zeros

Copy

Copies the calculation result to the clipboard in the format specified by the “Copy to” switch box.

Clr

Clears the “Expression” field.

Removes one character (number) to the left of the input point (Backspace).

Inserts “0x”.

Shifts the expression result to the right by the specified number of digits.

Shifts the result to the left by the specified number of digits.

Mod

Calculates the remainder of a division by a given number.

While you are typing an expression in the “Expression” box, RadiaCode tries to calculate the result and immediately displays it in different formats in the “Result” panel. Also, a switch box and two checkboxes in this panel control the result format.
Examples of expressions: 0x1234 -126 (2 + 2 * 2) – 33h (float)(33000 / 4)

Graphical interface 52

2.2.7 2.2.8

“Scripts” menu
This menu is intended for starting process scripts to start device calibration. It is beyond the scope of this document to describe the script language and how to manipulate it.
“Window” menu
The commands on this menu control the arrangement of windows in the application. Also, at the bottom of the menu there is a list of currently open windows – this is the standard way to switch between them. When you select a window name in this list, it is activated on your computer screen. This method is useful for navigating to the window behind the others.

Com m and Tile
Tile horizontally
Cascade Arrange icons Close all

Description
Resizes and positions the window without overlapping each other. In this case, the window sizes are about the same.
Places all windows horizontally, without overlapping each other. In this case, the window sizes are about the same.
Arranges the windows with a ledge.
Lines up icons of collapsed windows.
Closes all windows.

2.2.9 “Help” menu
The commands in this menu work with the on-line help system.

Com m and

Description

Contents

Opens the “Contents” tab of the help file.

Opens the “Index” tab of the help file.

Check for updates…

Check if a new version of RadiaCode is available for downloading. This function works if the computer is connected to the Internet. Opens the “Check for updates” dialog box, where you can configure the automatic updates check and actually check for a new version.

Send e-mail message to ScanElectronics…

Starts the mail client installed in the system and prepares the letter to ScanElectronics.

Generate error report…

A dialog box is displayed where you can send a message to the developers. The message will automatically include trace files. Optionally, you can add your own attachments to the message.

Visit ScanElectronics website

Launches the web-browser and navigates to the “Scan-Electronics” page.

About RadiaCode Opens the “Information”.

53 Graphical interface

2.2.9.1 About RadiaCode This dialog box shows:

Nam e

Description

RadiaCode: version Version RadiaCode.

Software build version

Executable file version RadiaCode.

Device

Device name.

Device bootloader Device resident software version. version

Device firmware version

Device replaceable software version. The replaceable software provides the basic functionality of the device and can be updated from version to version.

Device serial num ber

Device serial number string.

Hardware identifier Unique hardware identifier of the device. of the device

2.2.9.2 “Update checking” dialog box
Here, one can set up the check for automatic updates of RadiaCode and actually check if there is a new version. This function works if the computer is connected to the Internet.

Dialog item
Enable automatic checking for new versions of RadiaCode
Checks for new versions:
Check now

Description
Automatically checks for a new version of RadiaCode at startup. One can specify the frequency of checks below. If there are no new versions and no Internet connection, no message is displayed, when checking for updates. However, Windows may display a message that RadiaCode tries to establish an Internet connection.
Select how often you want to check for updates.
Immediately checks for updates.

Chapter
III

55 Appendices

Appendices

3.1 Database RadiaCode information
RadiaCodeThe database file RadiaCode has a default name RadiaCode.sq3. At the first start of the RadiaCode program on the computer, an empty database file is copied to the folder:
Under Windows XP:
C:Documents and SettingsMy DocumentsRadiaCode
Under Windows 7, 8, 10 and later versions of Windows:
C:UsersDocumentsRadiaCode
This database file is used by the default program and is called the “shared database”. The shared database is not deleted when uninstalling a package RadiaCode and is not updated when new versions are installed. Thus, all versions of RadiaCode use the same database and require no adjustments, when installing new versions.
Note that a shared database is different for each user of the same computer.
Using the menu command of the home window RadiaCode “Tools” -> “Select database” one can select for work both the shared database, and the database file with an arbitrary name and location, which was, for example, transferred from another computer.

3.1.1

Database backups
RadiaCode creates general database backups in a Backup Subfolder of the folder where the shared database file is located (see above). Backups can be used to restore a database that has been corrupted by some failure. Restoration should be done manually by copying the appropriate backup file to a shared database file. In this case, the program RadiaCode shall not be running.

One can configure the number of days over which the database backups are created in the “RadiaCode settings” dialog box.
3.2 Special function registers of RadiaCode-10X

Special function registers (SFR) are intended primarily for use in script files that are executed in the RadiaCode. The scripts are used for process purposes and allow automating some setup, calibration and pre-sale preparation of devices. However, some of the SFRs may be useful for the users of RadiaCode-10X.

SFRs can be accessed through the “Variables”. Listed below are the case names whose values can be viewed and modified in this window.

Group of registers, which gives access to parameters of spectrum calibration by energy

Spectrum calibration is performed to convert the number of the spectrum channel to the value of the emission energy in keV using a polynomial of the 2nd degree of the form:

E = a0 + a1X + a2X2, where x – channel number;

Appendices 56

a0, a1, a2 – calibration factors.

Register name Access Description RC_VSFR_CHN read/wri Contains the current value of the coefficient a0. _TO_keV_A0 te
Contains the current value of the coefficient a1.

RC_VSFR_CHN read/wri calibration constants in the RC_VSFR_CHN_TO_keV_A0,

_TO_keV_A1 te

RC_VSFR_CHN_TO_keV_A1 and RC_VSFR_CHN_TO_keV_A2

registers. If there are no factory values, these registers will be set to 0,

1, 0, respectively.

RC_VSFR_CHN read/wri Contains the current value of the coefficient a2. _TO_keV_A2 te

Windows PC User Manual

Index

About RadiaCode 53

“Multi-file search results” panel 35
.csv, save log 15
“Calculator” dialog box 51 “Colors” tab (“Environment” dialog box) 44 “Condensed text mode”
options 40 “Configure” menu 41 “Confirm replacement” dialog box 37 “Database” menu 50 “Device” tab (RadiaCode settings). 42 “Edit” menu 34 “Editor” toolbar 41 “Environment” dialog box 44 “Event log” window 4 “File” menu 33 “Fonts” tab (“Environment” dialog box) 44 “Help” menu 52 “Key mappings” tab (“Environment” dialog box) “Message console” window 29 “Misc” tab (“Environment” dialog box) 46 “Multi-file search results” dialog box 38 “Replace text” dialog box 36 “Restore” 39 “Set/Restore global tab”
dialog boxes 39 “Set”
tab 39 “Settings of RadiaCode” dialog box 42 “Text search” dialog box 35 “Toolbar” tab (“Environment” dialog box) 46 “Tools” menu 51 “Update checking” dialog box 53 “Variables” window 30, 31 “View” menu 41 “Window” menu 52

Calculator, dialog box 51 Clipboard history/Repository 40
dialog box 40 Colors, “Environment” dialog box tab 44 Comment, log 6 Condensed mode setup
dialog box 40 Condensed text mode 39 Configuration files 34 Configure, menu 41 Counter 38
Database selection dialog box 55 Database window display settings 7 Database, information 55 Database, menu 50 Deleting log entries 13 Device status indicator 4 Display options 31
45
Edit command 49 Editor key assignment 49 Editor options 47 Editor, menu 34 Environment, dialog box 44 Event log 4 Expert mode 4
File use wildcards 35 File, menu 33 Fonts, “Environment” dialog tab 44

Global bookmarks 39 Graphical interface 4

Index

Help, menu 52 Hot keys 49

Text replacement 37 Toolbar, “Environment” dialog box tab 46 Tools, menu 51

Key mappings, “Environment” dialog box tab 45 Update checking, dialog box 53 Updates of RadiaCode 52

Languages 4 Log entries filter 10 Log filter 10

Variables 30 Version RadiaCode 53 View, menu 41

Message console 29 Misc, “Environment” dialog box tab 46

Window, menu 52

New versions of RadiaCode 52 New versions of RadiaCode, check 53

RadiaCode windows 4 Regular expressions 38 Restore global
tab 39

Saving records in an HTML file 14 Search 35, 38 Search in database 8 Search selected text 36 Search through source files 36 Search/Replacement prompt 37 Select database, Dialog box 55 Set global
tab 39 Set/Restore tab
“Confirm replacement” 39 Settings of RadiaCode, dialog box 42 Shared database 55 Spectrum, display settings 19
© 2024 Radiacode Ltd.

References

Radiacode 102 & 103: Radiation Detector, Gamma Spectrometer and Scintillation Counter

Read User Manual Online (PDF format)

Loading......

Download This Manual (PDF format)

Download this manual >>

RadiaCode 10X Series Nuclear Radiation Detector and Spectrometer

Product Information

Product Usage Instructions

FAQs

Introduction

Graphical interface

Appendices

References

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Related Manuals