Functions for reading, and in some cases writing, foreign files
containing spectral data from spectrometers and their associated software,
output from daylight simulation models in common use, and some spectral
data repositories. As well as functions for exchange of spectral data with
other R packages. Part of the 'r4photobiology' suite,
Aphalo P. J. (2015)
Package 'photobiologyInOut' provides functions for importing spectral data from diverse sources including instrument-specific files, as well as spectral data output by solar-radiation simulation models. It also includes functions for exchanging spectral data with other R packages. Package 'photobiologyInOut' complements other packages in the 'r4photobiology suite' by allowing reading and writing "foreign" spectral data as well as reading data saved from data loggers.
Developing a package like this is a never-ending task as I have only a limited sample of output files for testing and formats are quite variable. The functions may not work with different software or firmware versions used for acquiring spectral data from instruments. Even the format of files can depend on the current locale and operating system.
Please, see the r4photobiology web site for details on the suite.
The functions in this package work with the example files I have access to for testing, but they may not work with your own files as file formats vary.
PLEASE, BE VERY CAREFUL WHEN USING THIS PACKAGE. DO CHECK THAT UNITS USED IN THE IMPORTED FILE ARE THOSE EXPECTED BY THESE FUNCTIONS AND THAT THE VALUES ARE AS EXPECTED!
If they do not work with your files, they hopefully will be useful as examples for developing your own functions. If you develop new functions or improve the existing ones, please, do contribute them back to this project.
Add support for StellarNet spectrometers and Bentham spectrometers. Add a generic reader of files into a collection of spectra. Add alternative reader of TUV output files into a collection of spectra. Add test cases for new functions for exchange of foreign data (currently tested through examples in vignette).
Add function read_FReD_csv() (read files flower reflectance database). Add function read_ASTER_txt() (read files ASTER materials reflectance database). Revise function read_licor_prn() to accept transmittance and reflectance spectra in addition to energy and photon irradiance spectra. Improve handling of 'label' by using only the base name of files and appending user supplied label text. Change location of external data used in vignettes.
Fix CITATION file. Add function read_uvspec_disort(), rename read_libradtran_vesa() to read_uvspec_disort_vesa().
Edit read_licor_prn() to work around a bug in readr::read_table() that results in missread data (wrong numbers). Add read_csi_dat() to read data saved from modern Campbell Scientific loggers.
Make compatible with upcoming version of package 'lubridate' (pull request by vspinu NA). Add function read_avaspec_xls() which can import spectral data from Excel files exported from Avantes software. Fix code to avoid partial matches of function parameter names (tz -> tzone).
Fix LaTeX error in vignette.
Replace a couple of NA returned by read fucntions with empty spectral objects. Improve handling of strict.range to avoid spurious warnings.
Add functions mspct2matrix() and matrix2mspct for conversion of collections of spectra into R matrices and vice-versa.
Fix bug introduced when attempting to make the package pass CRAN checks without triggering a note.
Fix for compatibility with 'dplyr' (> 0.4.3). Add functions to exchange data with package 'colorSpec': colorSpec2spct(), colorSpec2chroma_spct(), colorSpec2mspct(), spct2colorSpec(), chroma_spct2colorSpec(), and mspct2colorSpec(). Add or revise functions to exchange data with package 'hyperSpec': spct2hyperSpec(), mspct2hyperSpec(), hyperSpec2spct() and hyperSpec2mspct(). Add import function for raw counts from Ocean Optics instruments accessed through server running on a Raspberry Pi board: read_oo_pidata().
Add 'readr::locale' support to all functions that could make use of it. Add 'label' parameter to all file import functions. Add function read_oo_ssdata() for reading SpectraSuite files containing raw counts. Add function read_libradtran_vesa() for reading libRadtran output file with multiple solar spectrum simulations (as preprocessed by Vesa's script). Add metadata as consistently as possible to the objects returned by all the file import functions. Update dependencies. Edit the user Guide. WARNING: from version 0.4.4 the time zone (tz) is by default "UTC" for decoding dates and times in files imported. In most cases you will need to pass the tz (or the locale) where the file was created as an argument to the functions!
Update for compatibility with 'lubridate' (>= 1.5.6) Add function read_oo_jazdata() to read Jaz files containing raw counts. Add preliminary versions of functions to exchange data with package 'hyperSpec': mspct2hyperSpec() and hyperSpec2mspct(). Add preliminary version of function to import data from package 'pavo': rspec2mspct().
Fix bug in read_fmi_cum(). Update dependencies.
Update vignette. Fix docs.
This is a major update, not backwards compatible, as names and formal parameters of all functions have changed. Trimming is no longer supported (should be done as a separate operation).
The functions for Ocean Optics files now read the number of pixels from the file header, and hopefully will better adjust to different instruments and settings.
Functions for reading multiple spectra now return collections of spectra. (Functions that saved the spectral objects constructed from the data read from text files on disk back to disk as R data files have been removed.)
New functions for reading daily spectral exposure data from files returned by models from FMI have been added.
New function for reading .csv file from Avantes' AvaSpec spectrometers added.
Add "use.hinges" argument to functions, and default to not adding hinges when trimming input.
Remove dependency on data.table.
Corrected some bugs in read_licor_files()
Added function to read spectral irradiance files generated by the Jaz spectrometer from Ocean Optics.
Functions names shortened.
Expanded the User Guide.
Edited read_licor_prn_files() drastically. The new version is functionally equivalent but formal arguments have changed. In addition it is now implemented by calling read_licor_prn_file().
New functions read_licor_prn_file(), read_macam_dta_file(), read_ooss_txt_file() and read_tuv_file() returning source.spct objects.
Function read_xlsx() removed as there are other packages available for Excel file import.
Added function read.xlsx() for reading data from Excel workbook files saved as .xlsx (zipped XML format).
Added parameter unit.out and cleaned code.
First version containing only one function for importing data measured with a LI-COR LI-1800 spectroradiometer from .PRN text files produced by the PC1800 MS-DOS program from LI-COR.