Technical Issues - Saving Multiple Spectra

While it is typical to save a single calculated or measured spectrum in a unique file, this becomes unwieldy when there are many associated spectra. MEASURE examples: 1. Life tests on solar mirrors, 2. Uniformity on large optics, 3. Multiple samples from a coating run, 3. Unusual spectral requirements. DESIGN examples: 1. Random error analysis, 2. Angular variations.

Excel is universally utilized and is the file format of choice to replace specialized formats. The Collector simplifies matters by saving multi-spectra Excel files without requiring Excel (critical when security is a concern). If Collector format is not suitable, BASIC XL functions allow maximum flexibility. If Excel is not installed, the recommended free Microsoft Excel Viewer lets one view and verify file content.


Excel Viewer accessible from all FilmStar programs.

This page refers to FilmStar BASIC (#2, #6, #7) code and Excel VBA code (#8). BASIC files MultCalcXL.basMultCalcXLC.bas, are found in C:\Winfilm\Basic32. Template MultCalc0.xls is in c:\Winfilm\Workbook while MultCalcXL.xlsm (Excel 2007/2010 macro-enabled workbook) is found in C:\Winfilm\Excel 2007. Users who cannot get these to work should contact FTG Software for assistance.


1. DESIGN/MEASURE Spectra Collector

Recommended for most purposes, BASIC not always required.
Compatible with goniometer-based spectra from UMA/ARTA/TAMS

The Collector (Spectra..Collector) in DESIGN and MEASURE provides means to create and save multiple spectra in Excel XLS/XLSX format (Excel not required).

The Collector, a modification of the Cary UMA Collector for PerkinElmer and other instruments, offers great advantages in cases (e.g. OMT Solutions ARTA/TAMS) where optics are analyzed over a range, typically angle but also temperature and time (kinetics).

A standard Column Header format enables the Collector to average over sample and detector angles and P/S polarization:

RP -45 -90: %R Ppol -45 -90
TP 45 0: %T Spol 45 0

Reflectance detector angle = 2* detector angle; transmittance detector angle = 0.


MEASURE Collector Scan Dialog

When measuring a single optic over a temperature range, or multiple optics of the same type, ignore the Formatter and type appropriate Column Headers. If there are many measurements, BASIC's Collect command provides further options including full or partial automation, as in the following ARTA/TAMS control code. It is assumed here that we've already performed P and S reference scans.

SetInit  ' Initialize ARTA/TAMS accessory
SetDetector 0           ' Transmittance 
Const sht$ = "Highpass"	' Assign sheet name
For ang = 0 To 60 Step 5
    ' Load P-pol reference data
    DataType = 3: FileOpen "RefP.dat": DataType = 1
    SetSample ang       ' Contact FTG for ARTA/TAMS code 
    SetPolarizer "P": Scan
    ' Clear Collector when run the first time
    Collect sht$, "TP " & cStr(ang),(ang = 0)
    ' Load S-pol reference data
    DataType = 3: FileOpen "RefS.dat": DataType = 1
    SetPolarizer "S": Scan
    Collect sht$, "TS " & cStr(ang)
    If ang > 0 Then    
        SetSample -ang: Scan
        Collect sht$, "TS " & cStr(-ang)
        SetPolarizer "P": Scan
        Collect sht$, "TP " & cStr(-ang)
    End If
Next ang

Currently using ARTA or TAMS with PerkinElmer UV Winlab? Consider the advantages in directly creating XLS files; compare with Winlab's arcane and tortuous file structure. Contact FTG for an online presentation via Glance Networks. The above code is easily modified for Pike autosamplers and similar accessories.

MEASURE Collector files can be opened and analyzed in the DESIGN Collector. In addition, the DESIGN Collector can be populated with computed values.

The blue color indicates calculated data. In MEASURE black indicates normalized measured spectra and green (in UMA version) indicates raw data. Row (1,2,3...) and column header (A,B,C...) visibility is adjusted in File.. Configuration.. <Grid Style>.

Spectra are saved in Excel XLS or XLSX format. There is virtually no restriction on the number of data points and number of worksheet windows.

The Spectra Collector automatically plots multiple FSPlot curves as shown below. With the FSPlot Module open, select one or more columns in the Collector followed by Spectra.. Plot Column <F4>. In the results shown below we applied Spectra.. Average P and S to the Collector data shown above.

Sub Collect is also available in DESIGN as in the following example. Of course, it is possible to vary other design parameters, not just angle and polarization.

Option Explicit ' not really needed here, but always a good idea
Sub Main
    Dim ang As Single
    For ang = 0 To 85 Step 5
        Angle = ang: Pol = "P": Calculate
        Collect "Test", "TP " & CStr(ang), (ang = 0)
        Pol = "S": Calculate
        Collect "Test", "TS " & CStr(ang)
    Next ang
End Sub

Further information relating to multiple scans can be found here. Suggestion: After running the above, try Spectra.. Average P and S in the Collector. Have no idea how to get this BASIC program to work? Contact FTG for an online introduction.
 


2. General Method using BASIC XL Functions

Flexible output for nonstandard spectra.

An example of a nonstandard spectrum is one resulting from angular dispersion where sample and detector angles are varied as a function of wavelength. This requires BASIC XL functions as discussed in a MEASURE BASIC macro on a separate page. Another example is given here.
 


3. DESIGN Contour mode

Fixed output, easy to use; utilizes Excel or Workbook

Another DESIGN method is to select Contour mode in Setup.. Parameters. Evaluate and copy spectra to the clipboard (Spectra.. Copy Data <Ctrl+C>) and paste into Excel or the FilmStar Workbook (Excel 5.0/95 only, so not recommended). Be sure to select Contour Data.. Matrix in Spectra.. Format Options. This method only applies when each column corresponds to a different angle of incidence.


4. FSPlot data storage

Unwieldy, use Collector or BASIC XL functions

The next method uses FSPlot, works with MEASURE as well as DESIGN, and does not require BASIC. Using the Plot button, add spectra to FSPlot then click Data.. Save As to save the spectra in Excel-compatible CSV format. Alternatively, click Data.. Copy <Shift+F11> and paste into Excel. For users with occasional requirements, this simple technique should be sufficient. Data can be viewed in the Formulator.

The FSPlot method can be automated as follows:

 MultCalcCSV.bas for FilmStar DESIGN
' Copyright 2011 FTG Software Associates
' ****************************************************
' Save multiple spectra in Excel-compatible CSV format

Option Explicit
Option Base 1
DefInt i-n
DefSng A-H, O-Z

Const path$ = "C:\Winfilm\Workbook\"

Sub Main
    Dim ang
    PlotClose
    PlotActivate
    For ang = 0 To 60 Step 15    ' adjust as required
        Angle = ang
        Pol = "P": Calculate
        PlotNext
        Pol = "S": Calculate
        PlotNext
    Next ang
    PlotDataSave path$ & "MultCalc1.csv"
    'PlotDataCopy  ' even simpler, paste into Excel
    Busy False     ' remove hourglass
End Sub

Select 0-100% scale or risk losing data. FSPlot only saves data within Graph Axes range. Click here for further discussion of this topic. Click here for a built-in method (MEASURE only) and here for a BASIC method (DESIGN and MEASURE) for labeling multiple plots.


5. FilmStar Workbook used manually

Easy to make a mistake; column headers not well labled.
Obsolete Excel 5.0/95 format, use Collector or BASIC XL functions.

The next method relies on the ability of the FilmStar Workbook to add multiple spectra as it is activated. In the following DataType = 11 (1+2+8) indicates formatting (0-100%), looping, and one data column (%T instead of %R and %T) in DESIGN. While this can be automated with FilmStar BASIC or with a Workbook macro, we think Method #6 (below) is a better use of BASIC skills.


DataType B1, DataMarker A3


6. FilmStar Workbook with BASIC (MultCalcXL.bas)

Obsolete Excel 5.0/95 format, use BASIC XL functions

CSV is not internationally invariant. Files saved in European format (comma decimal point) are unreadable elsewhere. In addition, CSV does not support formatting.

FilmStar can directly create single-sheet Excel files. In BASIC program MultCalcXL.bas a pre-formatted worksheet MultCalc0.xls provides a template. This template can be created in DESIGN or in Excel 5.0/95 format (supported by all newer Excel releases).


FilmStar Workbook (Excel 5.0/95) template with text and numeric formatting
No special defined names (DataType, DataMarker) are utilized.


After running FilmStar BASIC MultCalcXL.bas

The filled-in Workbook is saved with a new file name. Marking the template as read-only is recommended to prevent unwanted modification.

If 256 columns are sufficient and Excel features like charts, VBA macros, multiple worksheets etc. are not required, this is an excellent and highly reliable method for generating Excel files without MS Excel. Note that a template is not limited to formatting but can include worksheet functions.

MultCalcXL.bas code comment: Function Cell$ converts column numbers to addresses (35-> AI). This is required because the Workbook cannot directly utilize column numbers. The FilmStar Workbook is limited to 256 columns as are Excel versions prior to 2007.


7. DESIGN export to Excel (MultCalcXLC.bas)

Highly flexible, useful for exporting spectra to Excel workbooks
containing formulas,  graphs, VBA code, etc.
If only saving data, use BASIC XL functions (Excel not required)


After running FilmStar BASIC MultCalcXLC.bas using template MultCalc0.xls

Use this instead of Method #5 (above) when more than 256 columns are required (Excel 2007 or newer), if XLSX format is required, or if the Excel workbook includes multiple sheets, charts, etc.

MultCalcXLC.bas code comments: Why Macro "CALCULATE;" instead of BASIC Calculate? It appears that Calculate is misinterpreted as an Excel keyword. There is no problem when CalcPlot is utilized. Excel can be run in the background (not visible) by changing xlApp.Visible = True to False and adding xlApp.Quit before End Sub in Sub Main in order to prevent multiple hidden copies of Excel.


8. Excel import from DESIGN using VBA (MultCalcXL.xlsm)

Useful for importing spectra into Excel Workbooks
containing formulas,  graphs, VBA code, etc.
Otherwise use BASIC XL functions (Excel not required)

Excel aficionados might prefer to work in Excel and have Excel retrieve spectra from DESIGN or MEASURE. Users who do not have Excel 2007/2010 should download the Microsoft Office Compatibility Pack.

Once spectra are transferred from DESIGN to Excel, the related Excel VBA macros are no longer required and may be deleted. Excel 2007 and 2010 deal with this issue via two file structures: XLSX (no VBA) and XLSM. By starting with XLSM and saving in XLSX we delete spurious macro code.


Excel 2007/2010 macro-enabled workbook

MultCalcXL.xlsm VBA code comments: Pause .2 is a puzzle! Without a delay, perhaps a message box, the program does not run correctly (ID Module error). This remains an anomaly. Note the line shapes(1).cut for deleting the Calculate button.


VBA macros deleted when saved as MultCalc2.xlsx

Advanced users: what if the final Excel model requires macros? There could be two code modules, say Module1 (imports spectra from FilmStar) and Module2 (subsequent analysis). Module1 can be selectively deleted by adding the following code as the last step. This procedure is also useful when Excel 2007 or newer is not available.

Sub Main()
    ...
    ...
    Dim vbCom As Object
    Set vbCom = Application.VBE.ActiveVBProject.VBComponents
    vbCom.Remove VBComponent:= vbCom.Item("Module1")
End Sub

Depending on Excel version, it may be necessary to adjust VBA security settings as shown here for Excel 2010 (Developer.. Macro Security.. Trust Center). Menu sequence and terminology will vary in different Office versions. If trust is not enabled, the error message upon running the above code is 'Programmatic access to Visual Basic Project is not trusted' or similar.


Enabling a VBA module to delete itself in Excel 2010

Should DESIGN and MEASURE BASIC run Excel (#5), or should Excel VBA run DESIGN and MEASURE (#6)? While each approach has merits, there are advantages in FilmStar BASIC control. Excel is a programming language and Workbooks can easily (unless precautions are taken) be wrecked. On the other hand, complex and user-friendly data entry dialogs are easier to create in Excel VBA. Advanced FilmStar BASIC users can 'borrow' dialogs from Excel. Click here for an explanation.


9. Transferring Excel spectra to FSPlot

Users may find that Excel charts are fairly complex, especially if there are a variety of wavelength ranges. A simple alternative is to copy data to the clipboard and transfer to the FSPlot Module.

Spectra are plotted in FSPlot via Data.. Paste. This function has been upgraded in DESIGN 2.61.2244 and MEASURE 2.51.1323 to convert column headers to line legends. (Headers are automatically detected by the presence of non-numeric values in leftmost columns.) These versions also support the opposite via Data.. Copy which optionally converts legends to headers. Multiple header rows are supported as shown below.

Data and headers were copied from MultCalc2.xlsx; the second 0 deg column was deleted and data limited to the 0-30 deg range. FSPlot's Bitmap/Gradient mode was used to set the border color to light green.


10. Learn by doing

The only way to master FilmStar BASIC or VBA is to develop code and/or modify existing code. Excel VBA books, online tutorials, and short courses are widely available. Here are some exercises:

  • Very simple, just to get started. Add the degree symbol '' to angles. Looks more professional!

  • We don't need two header rows. Change to one row.

  • We don't need P and S polarization for normal incidence; modify BASIC and/or VBA code so that angle = 0 only utilizes one column.

  • Add dialog boxes to set angle range and interval. Be sure to check for invalid entries.

  • Automatically increment the file name each time a worksheet is saved. How to keep track of the last file name? Hint: Make use of BASIC Sub WriteIniString and Function IniString.

Don't forget to first back up any files that you will modify.

Back to Technical Issues