Spectra Difference Generator
Thu, 02/04/2021 - 04:48 am
This project is provides functionality for comparing two (1D) data waves. The main purpose was to calculate the difference between two data sets, but currently summing, multiplication and division are supported as well. Two waves are selected, where one serves as the reference to compare against and one is edited. The latter can be shifted, offset and scaled manually with respect to the reference to find their optimal overlap or extract certain spectral features from their difference etc.
The underlying original data of both the edited wave and reference wave is never modified in any way. The comparison is handled separately, and modifications (default wave ending "_mod") as well as the calculation result are saved always as new output waves. The default wave ending for the calculation result is "_dif" for the difference, "_sum" for the sum, "_mul" for multiplication and "_div" for division. All settings are saved in the wave notes of the output and will be reloaded automatically with the next start. The program is fully folder aware.
I tried my best to test everything thoroughly, but you should verify the correct behavior yourself to be sure. Bug reports and suggestions for new features are always welcome.
To start, select one or two (1D) waves in the Data Browser and then go to 'Spectra Tools' -> 'Difference between Spectra ...' in the top menu. Or use the command line:
The second wave selected in the Data Browser (or the wave provided by the 'refwave' parameter) comes preselected as reference when starting the GUI. A quick overview of all controls can be found below:
- The wave to modify and the reference wave are selected from the current folder. The current folder can be changed in the Data Browser during operation to use waves from a different folder.
- Both the edited wave and reference wave can be smoothed (Gaussian broadened). The smoothing is saved in the output for the edited wave. The smoothing of the reference wave is only for display and to calculate the result, but is of course not actually applied to the original reference data. However, the smoothing setting is saved with the output and will be reapplied upon reloading.
- Chose the mode of operation in the drop-down menu: A-B difference (- key), A+B sum (+ key), A*B multiplication (* key) or A/B division (/ key).
- The result can be inverted (flipped in Y direction) with the Invert checkbox. The state of all checkboxes is saved with the output and will be reapplied upon reloading.
- The edited wave is moved with the relevant controls of X/Y horizontal and vertical movement using the cursor buttons (cursor keys on the keyboard).
- Scaling is done with the stretch (page up key) and shrink (page down key) controls.
- The delta step of each modification can be set using the nearby variable controls.
- Discard & Quit will just close the GUI without saving anything.
- Save & Quit will save the current state as output waves (edited wave name + "_mod" and "_dif" etc.) and then closes the GUI. Optionally, the result is display in a new graph afterwards. At the same time all other graphs with the same data set displayed are updated as well to reflect the new modification settings.
Additional keyboard shortcuts:
- Hold Command (Mac) / Ctrl (Win) for changes in steps of 0.5 times the current delta value.
- Hold Shift for changes in steps of 10 times the current delta value.
- Hold both Shift + Command / Ctrl for changes in steps of 0.1 times the current delta value.
- r key to ‘Reset All'
- i key to toggle ‘Invert’ mode
- p key to toggle ‘Pin Background’
- Hold Command (Mac)/ Ctrl (Win) while pressing ‘Reset All’ and the reference wave will be set to none.
- Hold Command (Mac)/ Ctrl (Win) while pressing ‘Save & Quit’ to override quitting the GUI. This can be used to compare many waves in quick succession.
- Hold Option (Mac) / Alt (Win) while pressing ‘Save & Quit’ to force 'Use Ref. Name' for saving.
How the result is saved
The result is saved next to the input wave (the data to edit) as 'wavename + "_mod"' for the modified data and 'wavename + "_dif"' (or "_sum", "_mul", "_div" depending on the mode) for the (inverted) result. All modification settings are saved inside the wave note of both of these output waves. Here is an example where 'first spectrum' was edited and 'second spectrum' was the reference:
Loading the GUI with the same initial data again ('first spectrum' in this case) will reload the last session from the '_mod' or '_dif' wave (if '_mod' does not exist). Note that loading a '_dif' or '_mod' wave directly will just start a new session with this data (this makes it possible to create differences of differences etc.).The wave to edit and the reference wave can be in different folders. If neither a 'dif' (or 'sum', 'mul', 'div') or 'mod' wave with the same name is found in the folder of the input wave, then the default settings are loaded. It is thus recommended to move the result and modified waves together with the original wave to a new folder, to always be able to reload the settings. What will be reloaded if you have mixed result waves from summing, multiplying etc.? The reloading hierarchy is 'mod' > 'dif' > 'sum' > 'mul' > 'div', and thus deleting the 'mod' and 'dif' waves will load the settings from the 'sum' wave if present.
What is the purpose of the 'Use Ref. Name' setting?
Imagine the following scenario: A 'baseline' data and then several spectra have been measured in succession like this:
Now you want to remove the baseline wave from all the spectra, but the spectra should not be modified (for example, to preserve their relative shift or intensity). This is achieved by modifying (shifting, scaling etc.) the baseline for each spectrum individually and then saving the calculation result next to each spectrum. Load the baseline as wave to edit and one spectrum as reference and do the modification (since the roles of edited wave and reference are reversed here, this usually means 'Invert' needs to be activated). Then check 'Use Ref. Name' to save the result next to each spectrum. This will give:
What if you reload spectrum1 but have conflicting settings in waves spectrum1_mod and spectrum1_dif? In this case spectrum1_mod is loaded according to the hierarchy 'mod' > 'dif' > 'sum' > 'mul' > 'div'.
Settings inside the procedure header
The procedure header contains several settings as static constants, which can be edited to your liking:
- The name endings ("_dif", "_mod" etc.) for saving the result waves can be modified here, should there be a conflict with other names in your experiment (in fact, Igor's own Differentiate function will also use 'dif' as name ending).
- The string keys for saving the settings into the result wave's note are editable as well, but altering these keys might make saved results incompatible for reloading later (if these keys are changed again).
- The GUI shows additional data derived from the calculation result, which is however normally not saved. Set kSaveAux to 1 to save this auxiliary data as well. The kAuxMode constant selects the type of data displayed (and saved). Currently two types of data exists: A smoothed version of the result (value = 0) and the integral of the result (value = 1).
Current Project Release
|Release File:||Difference Generator_v4.3.zip|
|Version Date:||Thu, 02/04/2021 - 10:15 pm|
|Version Patch Level:||3|
|OS Compatibility:||Windows Mac-Intel|
Added multiplication and division modes.
Igor Pro 8
Igor XOP Toolkit
Igor NIDAQ Tools MX