Photon Systems Instruments
User Guide for PSI models including: SpectraPen Mini Software
Page | 9 6. Select Irradiance tab to view the irradiance data stored either as umol/m2/s/nm or per µWatts/cm2/nm.To change the units in which the spectra is displayed click on the unit icon as shown in (Fig. 8).
Page | 9 6. Select Irradiance tab to view the irradiance data stored either as umol/m2/s/nm or per µWatts/cm2/nm.To change the units in which the spectra is displayed click on the unit icon as shown in (Fig. 8). 7. To view the light meter data for the spectral scans acquired click on the unit icon as depicted by red arrow in Fig. 8.
File Info : application/pdf, 15 Pages, 2.08MB
DocumentDocumentManual Version: 2022/01 © PSI (Photon Systems Instruments), spol. s r.o. www.psi.cz This document and its parts can be copied or provided to a third party only with the express permission of PSI. The contents of this manual have been verified to correspond to the specifications of the device. However, deviations cannot be ruled out. Therefore, a complete correspondence between the manual and the real device cannot be guaranteed. The information in this manual is regularly checked, and corrections may be made in subsequent versions. The visualizations shown in this manual are only illustrative. This manual is an integral part of the purchase and delivery of equipment and its accessories and both Parties must abide by it. Page | 2 TABLE OF CONTENT 1 2 3 4 5 6 6.1 6.1.1 Software installation ........................................................................................................................................ 4 Data transfer.................................................................................................................................................... 4 Software menu ................................................................................................................................................ 6 Data visualization............................................................................................................................................. 7 Troubleshooting and Customer Support ......................................................................................................... 12 Appendix ....................................................................................................................................................... 12 Programming custom index in SpectraPen .............................................................................................................12 Function description ...............................................................................................................................................13 Page | 3 1 SOFTWARE INSTALLATION 1. Download the SpectraPen software from PSI website https://handheld.psi.cz/products/spectrapenmini/#download to your computer and launches the SpectraPen program. 2. To activate all software features register the SpectraPen software as follows (Fig. 1). · Select: Help > Register · Enter serial registration number, which is available in download section on PSI website · Select: OK Fig. 1 Software registration. It is not possible to download data from the SpectraPen device without software registration. 2 DATA TRANSFER For data transfer from mobile application to your computer select Share and choose your preferred option (Fig. 2). Fig. 2 Data export and sharing via available communication channels. It is not possible to download data from the SpectraPen device without software registration. Page | 4 Open your data in .spec format using the SpectraPen software (Fig. 3). Fig. 3 Opening data in SpectraPen software. Page | 5 3 SOFTWARE MENU MENU: File Load Save Export Export to JSON Close Close All Exit Loads previously saved data files. Saves data to hard disc. Exports data in .txt format. Exports data in JavaScript Object Notation. Closes the current experiment. Closes all open experiments. Exits the program. MENU: Device NOT ACTIVE FOR SP mini Connect Detects and connects the device. Update Firmware Used for firmware updates. Attach GPS File Used to download data from the GPS module of the old versions of the SpectraPen or PolyPen. Memory Erase Erases data from the memory of connected device. Online Control Online control of the device. MENU: Setup Update Software Settings MENU: Help Registration About Used for software updates. On/off Auto memory erase after download. Selection of separator for the csv file after its export and following opening in Excel (TAB, SEMICOLON, COMMA, SPACE). Used for the SpectraPen software registration. Offers basic information about the program. Page | 6 4 DATA VISUALIZATION 1. Visualization modes: Scope mode window is always displayed as the default. To view irradiance data go to Irradiance tab (Fig. 4). Scope mode represents non-calibrated spectrum. Fig. 4 Scope spectra. 2. All data that are downloaded are displayed in the Scope window after download from the SpectraPen. The user can select the set of measurements to be displayed by marking and unmarking the data from the selection list (Fig. 4). 3. Right click on list of measured data enables edit data name, delete selected measurement or show and hide all measured data in the graph Select all measure and Clear all measure (Fig. 5). Fig. 5 Options for list of data. Page | 7 4. In the graph marker feature is available, which enables display of the numeric values for wavelength and light irradiance for the selected wavelength of the scan (Fig. 6). Use the mouse to select the given point. In top right corner of the graph (red rectangle) is displayed exact value for the selected point on the x-axis and y-axis. Fig. 6 Marker feature. 5. To zoom in on the data displayed in the graph select an area of the displayed graph (Fig. 7). To reverse these steps and return to original display use minus icon in the corners of the zoom area marked with red rectangles in Fig. 7. Fig. 7 Zoom function. Page | 8 6. Select Irradiance tab to view the irradiance data stored either as umol/m2/s/nm or per µWatts/cm2/nm. To change the units in which the spectra is displayed click on the unit icon as shown in (Fig. 8). 7. To view the light meter data for the spectral scans acquired click on the unit icon as depicted by red arrow in Fig. 8. Irradiance and illuminance light meter numerical values for each scan are displayed as LUX, PAR or IRRADIANCE values (Fig. 9). Fig. 8 Irradiance shown in different units. Page | 9 Fig. 9 Numerical values of measured light intensities. 8. To Save the experiment select File>Save. All data stored in the device memory will be saved irrespective of the data selection in the SpectraPen software. The file will be stored as .spec. Spec files stores all Scope and Light meter data. 9. Select File>Export to export the data in .txt format. Export function allows the user to specify the type of data. The options are: Spectrum (Fig. 10) all raw scope data for entire range of measured wavelengths are exported including data for the dark scan. Spectrum scope scope data normalized to dark spectrum scan are exported for all acquired scans or set of selected measurements. Fig. 10 Export options. Spectrum Irradiance irradiance data for all measurements are exported. The user can choose to export the numeric values either in µE/m2/s/nm, µW/cm2/nm or both (Fig. 11). Fig. 11 Export of Irradiance spectrum. Computed Data computed numeric values for Scope and Irradiance are exported for all measurements. The user can choose if only Scope numeric values or Irradiance numeric values are exported. For irradiance values, numeric data for Photon flux density and PAR in µmol/m2/s units, irradiance in µW/cm2 units and illuminance in LUX units are exported (Fig. 12). Page | 10 Export interpolation if this option is marked the spectrum is exported with step of 1 nm. Fig. 12 Export of computed values. Page | 11 5 TROUBLESHOOTING AND CUSTOMER SUPPORT In case of problems with the SpectraPen SW visit FAQ on our websites (http://psi.cz/support/faq) or contact customer support by email to support@psi.cz , or contact your local distributor. 6 APPENDIX 6.1 PROGRAMMING CUSTOM INDEX IN SPECTRAPEN The SpectraPen software enables programming custom indexes, which can be used for wide range of calculation based on the measured spectrum. 1. Go to the main SpectraPen folder in your PC (Usually in Program Files). 2. Open the file Config > Formulas.txt. 3. Write your index into this .txt file and save it (Fig. 13). Index example: Scope:PSIindex:PSI test index:Scope[600nm]/ Scope[500nm] Scope the index is placed in the bookmark Scope in data in the software PSIindex name of the index in the SpectraPen software and in exported data PSI test index full name of the index (not showed) Scope[600nm]/ Scope[500nm] equation for calculation; calculated from 500 and 600 nm of Scope spectra Fig. 13 New index in the Formulas file. 4. Restart the SpectraPen Software. 5. The new index appears in the selected bookmark in the data (Fig. 14). 6. For export of this index choose the option "Computed values" and selected spectrum in the export table. Page | 12 Fig. 14 New index. 6.1.1 FUNCTION DESCRIPTION Different mathematical functions can be used in SpectraPen software syntax to create new custom formulas. min, max - min(value1, value2) value1 - number, variable, function value2 number, variable, function - only one value can be function! min(array) array array of numbers example1: max(Scope) example2: min(Irradiance) example3: min(Scope[760nm], max(Scope[450], Scope[680])) example4: max(Irradiance[550nm], (5+4)*4) __________________________________________________________________________ ln the natural (base e) logarithm of specified number ln(value) value number, variable, function example1: ln(5) example2: ln(Irradiance[760nm]) Page | 13 example3: ln(max(Irradiance [550nm], Irradiance[480nm])) example4: ln((5+4)*4) __________________________________________________________________________ log the logarithm of specified number in a specified base. logB(value) B base - number value number, variable, function example1: log2(5) example2: log5(Scope[760nm]) example3: log10(max(Scope[550nm], Scope[480nm])) example4: log10((5+4)*4) __________________________________________________________________________ sqrt the square root of a specified number sqrt(value) value number, variable, function example1: sqrt(5) example2: sqrt(Scope[760nm]) example3: sqrt(max(Scope[550nm], Scope[480nm])) example4: sqrt(((5+4)*4) + 6) ____________________________________________________________________________ ^ - specified number raised to the specified power value^power value number, variable, function power number, variable, function example1: Irradiance[760nm]^ Irradiance[550nm] example2: min(Irradiance[760nm], Irradiance[550nm])^max(Irradiance[435nm], Irradiance[430nm]) example3: Transmitance[760nm]^0.5 ___________________________________________________________________________ integral - express the area under the curve of a graph of the function in the interval integral(function_values, from, to) function_values input values for integral compute from,to limit values Page | 14 example1: integral(IrradianceL, 360nm, 700nm) example2: integral(IrradianceE, 360nm, 700nm) * IrradianceE[450] Page | 15