A spectrogram is a visual representation of the energy spectrum of photon (gamma and X-ray) radiation varying with time.
The Spectrogram tab displays a plot of either the spectrogram currently being recorded or the spectrogram loaded from the Spectrogram Library. There is no separate tab for viewing spectrograms, as there is for viewing spectra.
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 tab. The count rate in each individual channel (Z scale, similar to the Y scale in the Spectrum and View tabs) 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 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.
A long tap on the chart displays the marker lines and a "magnifying glass" that enlarges the section of the chart at the intersection of the marker lines:
Under the magnifying glass the information about the spectrum channel that is in the center of the magnifying glass is displayed: its corresponding time or count number, count rate (number of pulses in this channel divided by spectrum accumulation time) and, in square brackets, total count rate for the spectrum (sum of pulses in all channels divided by accumulation time).
| | |
| ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | **Start/stop** recording of the spectrogram. Once stopped, recording can be resumed. When you exit the application, the spectrogram recording also stops. Every minute the recorded spectrogram is automatically saved in the library.<br>Loading a spectrogram from the library does not stop the recording of the spectrogram, it continues in the background. |
|  | Opens the settings related to the spectrogram plot. In the settings you can choose:<br><br>**Capture Interval:** 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 device is not synchronized exactly with the timer of the smartphone, the intervals of accumulation of spectra received from the device can have a scatter of ±1 second.<br><br>**Maximum number of samples:** 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.<br><br>**The minimum and maximum values of the scale:** the count rate limits for the engine at the bottom of the tab, 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).<br><br>**Auto brightness: do not go beyond the boundary:** The minimum and maximum values of the scale can be automatically corrected by the application if the calculated values exceed the limits the calculated minimum and maximum values are out of the limits specified in the settings. Setting these options blocks the values of the engine from exceeding the specified limits.<br><br>**Scale:** 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, as well as by double-tapping the plot.<br><br>**Merge channels by:** To speed up rendering of large spectrograms, you can combine spectrogram channels by 2 or 4. When merging, the number of pulses in the adjacent 2 or 4 channels is summed. As a result, the displayed spectrogram has 512 or 256 channels, respectively.<br><br>**Y-axis units:** you can select the calendar time (counted from the spectrogram recording start), spectrogram accumulation time (hours:minutes:seconds), count number (counts are numbered from zero), or disable the display to save screen space.<br><br>**X-axis units** - channel number or photon energy.<br><br>**Palette:** 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, the same ones used when rendering [[Map and tracks\|tracks]].<br><br>**New data: I**f new counts are added to the end of the chart, they will appear at the bottom of the chart. The oldest values will be at the top of the chart. Otherwise - new counts are added to the beginning of the chart.<br><br>**Resume recording:** If automatic resumption of spectrogram recording is enabled, the action selected in the list will be performed when the application is launched and the device is connected. This option is triggered only if the spectrogram was recorded during the previous exit from the application.<br><br>**Automatically colorize the spectrogram when recording:** When capturing the next count, automatically select the positions of the scale sliders at the bottom of the graph and, accordingly, color the spectrogram. This happens only if the minimum or maximum value of the count rate in the captured sample exceeds the boundaries of the minimum or maximum value of the count rate for the entire spectrogram.<br><br>**Display isotope information:** draw vertical lines that correspond to the energy of this or that isotope at the point of the plot selected by tapping. The header of the application window will display text information about the isotope.<br><br>**Draw the grid:** if the size of the squares is more than 3 pixels, then draw a black line grid for better perception of the plot.<br><br>**Draw a graph of the count rate:** Display the count rate graph on top of the spectrogram. Since the time axis of the spectrogram is the Y-axis, the graph is rotated by 90° relative to the usual view.<br><br>**Do not shift the initial boundary of the spectrum histogram range in the automatic end boundary shift mode:** Selects the dynamic or fixed interval of the displayed spectrum when the [[Spectrogram#Spectrum histogram\|spectrum histogram panel is enabled]].<br><br>**When recording a spectrogram, automatically save it in the library:** The recorded spectrogram will be stored in the database every minute. After stopping the recording, the saved spectrogram will be visible in the [[Spectrogram#Spectrogram Library]]. |
| **Lin.** | Select the linear scale of conversion of dose rate values to brightness/color. |
| **Log.** | Select the logarithmic scale of conversion of dose rate values to brightness/color. |
|  | Enlarge the graph (zoom in). The plot can be scrolled both horizontally and vertically. Long press of this button increases the zoom to the maximum. You can also use gestures to zoom. |
|  | Zoom out. Long press of this button decreases the scale to one. |
|  | Open [[Spectrogram]] |
|  | Open the dropdown menu. Actions are available in the menu:<br><br>**Share spectrogram:** Export the spectrogram data to a text file with the extension .rcspg and "share" this file, i.e. save it in smartphone memory, send it by mail or via messenger. The .rcspg files can be imported through the spectrogram library.<br>**Save spectrogram to library:** Save the spectrogram in the database (spectrogram library). It is not necessary to stop recording to save the spectrogram.<br>**Isotope info:** Show detailed information about the isotope that corresponds to the tapping point on the plot.<br>**Close spectrogram:** Close the spectrogram, if it was selected from the library, and display a plot of the currently recorded spectrogram.<br>**Spectrum histogram:** Open or close the panel where the histogram of the spectrum corresponding to the selected interval in the spectrogram is displayed.<br>**Load the spectrum to view:** Open the spectrum, which is displayed in the spectrum histogram panel, in the [[EN/Android APP/Spectrum#Spectrum settings]]<br>**Save spectrum to library:** Save the spectrum, which is displayed in the spectrum histogram panel, in the [[Spectrogram#Spectrogram Library]] dialog box. |
# Spectrogram Library
A list of saved spectrograms is displayed. For each spectrogram its name is displayed, which was set when saving, accumulation time, interval(s) of samples, date of recording start, serial number of the device and number of samples.
It is possible to create folders for more convenient organization of the library. You can manage folders through the options menu, which is accessed by tapping the three-dot icon in the top right corner of the screen. The options menu also contains:
**· Search:** An input line appears where you can enter part of the spectrogram name. Only spectrogram names containing the entered substring will remain on the screen. The search is performed within the displayed folder, i.e. this function essentially works as a filter. To find a spectrogram located in a folder, you need to switch the display to "Simple list without folders" mode through the same options menu before searching.
**Import spectrogram:** The system .rcspg file picker opens. You can import a file that was previously exported by an application into the library RadiaCode on your smartphone or computer.
Tapping a line opens a dropdown menu:
- **Open the spectrogram:** Load a spectrogram to view. If a spectrogram is currently being recorded, it continues in the background. To return to the graph of the recorded spectrogram, tap the button on the "Spectrogram" tab and select "Close Spectrogram".
- **Share spectrogram:** Export the spectrogram data to a text file with the extension .rcspg and "share" this file, i.e. save it in smartphone memory, send it by mail or via messenger.
- **Rename spectrogram:** Set a new name for the spectrogram.
- **Edit comment:** Set or edit a comment for the spectrogram. A comment is an arbitrary text that is displayed for the spectrogram in the library in blue.
- **Delete spectrogram:** Delete spectrogram data from the library.
- **Move to folder:** [[Folders in the libraries|Move]] spectrogram to another folder.
- **Select:** Switch to spectrogram marking mode. A check mark appears at the bottom left of the graph:
![[EN/Android APP/Images/_spg_mark.png]]
----
Select by tapping all spectrograms, with which the group operation will be performed, and tap the symbol with three vertical dots in the upper right corner of the screen:
![[EN/Android APP/Images/_spg_more.png|300]]
A dropdown menu will appear:
- **Select all:** Mark all spectrograms in the library.
- **Invert selection:** Make unmarked spectrograms marked and marked ones unmarked.
- **Delete selected:** Delete marked spectrograms after confirmation.
- **Export selected:** "Share" all the selected spectrograms. For the marked spectrograms, files are generatedand, compressed and exported as a zip archive. If folders are selected, all spectrograms from the selected folders, including nested ones, are also exported. It is also possible to export all the spectrograms contained in the folder without marking it - the "Export folder" command is available in the menu that appears when you long-tap the folder.
- **Move to folder:** [[Folders in the libraries|Move]] the selected spectra and/or folders to another folder.
- **“Cancel”:** Unselect all spectrograms and exit the mode. The same is done with the “Back” button on the smartphone.
# Spectrum histogram
The menu command "Spectrum Histogram" in the tab "Spectrogram" opens the panel in which the spectrum corresponding to the interval selected in the spectrogram is displayed:
The interval is selected by dragging the triangles (markers). The scale of the spectrum (linear or logarithmic) corresponds to the scale selected for the spectrogram.
If the marker position is outside the spectrogram area displayed on the screen, the background of the marker will be semi-transparent.
A long touch of the marker sets its position to the corresponding extreme value. If, for example, you perform a long tap on both markers, the spectrum will be displayed for the entire spectrogram.
If during the recording of the spectrogram the corresponding marker is set to the extreme value, which corresponds to the most recent data, then when new data comes from the device, the marker will automatically move to the new extreme position, i.e. as if it "sticks" to the boundary. The behavior of the second marker in such a situation depends on the setting "Do not shift the initial boundary of the spectrum histogram range in the automatic end boundary shift mode". If this setting is enabled (default), the second marker stays where it was and the spectrum interval increases as new data is received from the device. If this setting is off, the second marker is moved so that the interval between the markers remains constant and the spectrum is displayed over the selected fixed interval.