JUICE exports data into R via the bin folder of R installation (usually at c:/Program files/R/R-x.x.x/bin), and these data could be automatically loaded by appended R script. Files, which should be exported from JUICE, could be either manually selected in JUICE-R wizard, or could be selected automatically according to JUICE-R tags in R script header. The script, which is uploaded into R from JUICE, has two parts:
The complete R script, which JUICE automatically appends to the script file (i.e. this part should not be in the script, because it will be automatically appended) and which is intended for import of the data from JUICE to R, has the following structure:
setwd("C:/Program Files/R/R-x.xx.x/bin/") JUICE.table <- read.table ('table.txt', sep = '\t', check.names = F, head = T, row.names = 1) JUICE.short.head <- read.table('ShortHead.txt', sep='\t', head = T) JUICE.species.data <- read.table ('SpeciesData.txt', sep='\t', head = T) JUICE.head <- read.table ('TableHead.txt', sep='\t', head = T)
The files which JUICE exports in current session depends on which data are being exported. The command setwd sets the R working directory, into which the JUICE files are exported and from which R can read them.
|Original file name 1)||Name of variable in R||Content||Original file format 2)||Format of variable in R 3)|
|table.txt||JUICE.table||sample x species matrix||samples in rows, species in columns; first row - species names4)), first column - releve numbers||samples in rows, species in columns, releve numbers as rownames, species names as names|
|ShortHead.txt||JUICE.short.head||short header data||samples in rows, three columns with names Releve_Number, Group_Number, Short_Head||samples in rows, short header data in columns (Releve_Number, Group_Number and Short_Head)|
|SpeciesData.txt||JUICE.species.data||data associated to species||species in rows, ten columns with names SpecName_Layer, Species_Name, Layer, Species_Data and species Ellenberg indicator values: Ellenberg_Light, Ellenberg_Temperature, Ellenberg_Continentality, Ellenberg_Moisture, Ellenberg_Soil_Reaction and Ellenberg_Nutrients||species in rows, species attributes in columns (SpecName_Layer, Species_name, Layer, Species_Data, Ellenberg_Light, Ellenberg_Temperature, Ellenberg_Continentality, Ellenberg_Moisture, Ellenberg_Soil_Reaction and Ellenberg_Nutrients)|
|TableHead.txt||JUICE.head||(long) header data||samples in rows, first two columns are Table number and Releve number, other columns and their names depends on the original JUICE file||samples in rows, header data as columns (first two are Table.number and Releve.number)|
The script written by the user and stored in the file with *.r extension. It consists of following parts:
Contains important information about the script. Follow this format (# at the beginning is important - R will ignore this line):
# Name: short name of the script # Author: Firstname Lastname (firstname.lastname@example.org) # Description: brief description what is it doing # Version: version number (starts with 1.0, after minor revision it becomes 1.1, after major 2.0) # Date: when was the script posted
The function of these tags is to set up particular switches for export of JUICE data into R. JUICE reads these tags while loading the script.
|Tag name||Tag function - what JUICE should do|
|JUICE.table||export sample x species matrix into table.txt file; R will read it as JUICE.table|
|JUICE.short.head||export short head into ShortHead.txt; R will read it as JUICE.short.head|
|JUICE.species.data||export species attributes into SpeciesData.txt; R will read it as JUICE.species.data|
|JUICE.head||export (long) header data into TableHead.txt; R will read it as JUICE.head|
|Rgui.exe||the script will run in interactive mode in R GUI|
|R.exe||the script will run in batch mode in R.exe|
|no.transf||sample x species data will not be transformed (the transformation setting will be ignored)|
The line with tags MUST begin with a string # JUICE-R5) (this is the sign for JUICE that JUICE-R tags follows) and should be located within the first 10 lines of the R script. Tags must be separated by space, and their order does not matter. Example, which will export sample x species data, header data and run the script in interactive mode (Rgui.exe6)).
JUICE-R tags can also contain link to website with detail instructions about how to use the script. This link must be the last tag in the sequence, and should start with http://.
Example of JUICE-R tags:
# JUICE-R JUICE.table JUICE.head Rgui.exe http://www.davidzeleny.net/juice-r/doku.php?id=scripts:generalists-specialists
This part is up to the R script creator. If possible, try to make it convenient for potential users. See tips for writing the R script for JUICE-R.