(DEPRECATED) Import Raman measurements from Renishaw ASCII-files

These data input functions are deprecated and they will be removed in the next release of hyperspec package. Now functions in package hySpc.read.txt (link) should be used as the alternatives.

read.txt.Renishaw(
  file = stop("file is required"),
  data = "xyspc",
  nlines = 0,
  nspc = NULL
)

read.zip.Renishaw(
  file = stop("filename is required"),
  txt.file = sub("[.]zip", ".txt", basename(file)),
  ...
)

Arguments

file	file name or connection
data	type of file, one of "spc", "xyspc", "zspc", "depth", "ts", see details.
nlines	number of lines to read in each chunk, if 0 or less read whole file at once. nlines must cover at least one complete spectrum,i.e. nlines must be at least the number of data points per spectrum. Reasonable values start at 1e6.
nspc	number of spectra in the file
txt.file	name of the .txt file in the .zip archive. Defaults to zip file's name with suffix .txt instead of .zip
...	Arguments for read.txt.Renishaw

Value

the hyperSpec object

Details

Import Raman measurements from Renishaw (possibly compressed) .txt file.

The file may be of any file type that can be read by base::gzfile() (i.e. text, or zipped by gzip, bzip2, xz or lzma). .zip zipped files need to be read using read.zip.Renishaw.

Renishaw .wxd files are converted to .txt ASCII files by their batch converter. They come in a "long" format with columns (y x | time | z)? wavelength intensity. The first columns depend on the data type.

The corresponding possibilities for the data argument are:

data	columns
"spc"	wl int	single spectrum
"zspc", "depth"	z wl int	depth profile
"ts"	t wl int	time series
"xyspc"	y x wl int	2d map

This function allows reading very large ASCII files, but it does not work on files with missing values (NAs are allowed).

If the file is so large that it sould be read in chunks and nspc is not given, read.txt.Renishaw() tries to guess it by using count_lines().

See also

read.txt.long(), read.txt.wide(), base::scan()

Author

C. Beleites