sound_raster: ASCII raster from sound file
In soundecology: Soundscape Ecology

Description Usage Arguments Value Note References Examples

View source: R/sound_raster.R

This function creates a raster file in ASCII format from the spectrogram of a soundfile. This file can be opened in ArcGIS or any other GIS software. For more details see the tutorial of Villanueva-Rivera et al. 2011.

1	sound_raster(wavfile = NA, wav_directory = NA, max_freq = 10000, no_cores = 1)

`wavfile`	a single sound file in wav format.
`max_freq`	maximum frequency to draw the spectrogram, in Hertz.
`wav_directory`	a directory that contains wav files. To specify the working directory, use `wav_directory="."`
`no_cores`	number of cores to use when working in a directory. Can be `max` to use all cores, `-1` to use all but one core, or any positive integer. Default is 1. Uses the `parallel` package.

The function will save a file for each channel, in the same directory where the files are at, with the extension .asc.

To get a raster file for a single file, use the argument wavfile. For many files, use the argument wav_directory. Do not use both at the same time or the function will return an error.

This function was released with the version 1.3 of the tutorial of the primer paper, available at:

http://ltm.agriculture.purdue.edu/soundscapes/primer/

and at the website of the package:

http://ljvillanueva.github.io/soundecology/

Villanueva-Rivera, L. J., B. C. Pijanowski, J. Doucette, and B. Pekin. 2011. A primer of acoustic analysis for landscape ecologists. Landscape Ecology 26: 1233-1246. doi: 10.1007/s10980-011-9636-9.

## Not run: 
sound_raster(wavfile = "file1.wav")

sound_raster(wav_directory = "/home/user/wavdirectory")

sound_raster(wav_directory = "/home/user/wavdirectory", no_cores = 4)
	
## End(Not run)