Title: | Temporal Trend Analysis Graphical Interface |
---|---|
Description: | This interface was created to develop a standard procedure to analyse temporal trend in the framework of the OSPAR convention. The analysis process run through 4 successive steps : 1) manipulate your data, 2) select the parameters you want to analyse, 3) build your regulated time series, 4) perform diagnosis and analysis and 5) read the results. Statistical analysis call other package function such as Kendall tests or cusum() function. |
Authors: | David DEVREKER [aut, cre], Alain LEFEBVRE [aut] |
Maintainer: | David DEVREKER <[email protected]> |
License: | GPL (>= 2) |
Version: | 1.5.10 |
Built: | 2025-02-19 05:00:06 UTC |
Source: | https://github.com/cran/TTAinterfaceTrendAnalysis |
A friendly interface to perform Temporal Trend Analyses (MannKendall tests). Just follow the successive step from the data frmatting to the results sorting.
Package: | TTAinterface |
Type: | Package |
Version: | 1.5.10 |
Date: | 2024-01-23 |
License: | GPL (>=2) |
David Devreker, Alain Lefebvre
Maintainer: <[email protected]>
Devreker, D. and Lefebvre, A. (2014), TTAinterfaceTrendAnalysis: An R GUI for routine temporal trend analysis and diagnostics. Journal of Oceanography, Research and Data, 1(7), 1-18.
Display logo, version and developpers name and email of the package.
about()
about()
Display logo, version and developpers name of the package.
The function create an environment where the data, arguments and objects that are used between the differents function of the package will be stock for better exchange processes.
Envir()
Envir()
Objects passed through the environment 'Envir' are called in the other function as Envir$objects
Simply modify your datase through the interface
fixdata()
fixdata()
The edited database that is automaticaly read by the interface to replace former values
fixdata() call the function fix() that act on the rawdata base. The fix() function itself call the function edit() from the package <utils>
This is the core function of the interface. It receive arguments from the interface (see the function <TTAinterface>) and build regularized time series , perform diagnostics and analyses.
FULLoption(param, depth=NULL, sal = NULL, site=NULL, rawdata="NO", select="NO", resume.reg="NO", test.normality="NO", plotB = "NO", selectBox="ByYears", log.trans="NO", plotZ="NO", datashow="NO", help.timestep = "NO", auto.timestep = "NO", time.step = NULL, help.aggreg = "NO", auto.aggreg = "NO", aggreg = NULL, mix = "YES", outliers.re = "NO", na.replace="NO", start = NULL, end = NULL, months = c(1:12), norm = "NO", npsu = 30, test.on.remaider = "NO", autocorr = "NO", spectrum="NO", anomaly="NO", a.barplot="NO", zsmooth="NO", local.trend = "NO", test= "MK", OnOK4=NULL)
FULLoption(param, depth=NULL, sal = NULL, site=NULL, rawdata="NO", select="NO", resume.reg="NO", test.normality="NO", plotB = "NO", selectBox="ByYears", log.trans="NO", plotZ="NO", datashow="NO", help.timestep = "NO", auto.timestep = "NO", time.step = NULL, help.aggreg = "NO", auto.aggreg = "NO", aggreg = NULL, mix = "YES", outliers.re = "NO", na.replace="NO", start = NULL, end = NULL, months = c(1:12), norm = "NO", npsu = 30, test.on.remaider = "NO", autocorr = "NO", spectrum="NO", anomaly="NO", a.barplot="NO", zsmooth="NO", local.trend = "NO", test= "MK", OnOK4=NULL)
param |
The name of the parameter you want to analyse it must be the name of the column where are your data. Have to be enter like this : "yourparam". |
depth |
If existing, the depth interval where your data will be analyse. If values are different from depth max and depth min, missing value are exclude Depth column must be name as 'DEPTH'. Enter the value like this : c(a,b). For analysis at one specific depth you can enter c(a,a). |
sal |
Same thing as for the depth Salinity column must be name as 'S'. |
site |
Labels of sampling site as they appears in the database Enter the value like this c("S1", "S2"). |
rawdata |
Peform desciptive statistics on raw database, can be "YES" or "NO" (the default). |
select |
Peform desciptive statistics on selected parameter and site, can be "YES" or "NO" (the default). |
resume.reg |
Peform desciptive statistics on regularized time series, can be "YES" or "NO" (the default). |
test.normality |
Perform a Shapiro-Wilk normality test on selected parameter, can be "YES" or "NO" (the default). |
plotB |
Display a boxplot of rawdata with outliers identified as cirle, can be "YES" or "NO" (the default). |
selectBox |
Options for plotB: allow to choose between boxplot by years or by months. |
log.trans |
This option transform your data in log(x+1) prior to perform analysis. |
plotZ |
Display a plot of the regularized time series, can be "YES" or "NO" (the default). |
datashow |
Show a table of the regularized data, can be "YES" or "NO" (the default). |
help.timestep |
Display an advice for time step selection, base on the mean time that separate two successive measurments. Can be "YES" or "NO" (the default). |
auto.timestep |
Autoexecute the advice without diplay it. |
time.step |
Choice of the time step for data aggregation during the build of the time series, can be "Fortnight", "Semi-fortnight", "Mensual", "Annual" or "Mono-mensual" for an aggregation of the data of a month of all years (e.g. all January data). |
help.aggreg |
Display an advice for method of aggregation selection, base on Wilcoxon p.value between rawdata and the different method. Can be "YES" or "NO" (the default). |
auto.aggreg |
Autoexecute the advice without diplay it. |
aggreg |
Choice of the method of aggregation during the build of the time series, can be "Mean", "Median", "Max" for maximal value selection or "Quantile" for selection of the quantile 90 |
mix |
Allow to mix the data of all sampling site during analysis. Permanently set to "YES" and removed from the GUI since version 1.5. |
outliers.re |
Remove the outliers from the rawdata, the outliers list is save in a .csv file. (for outliers visual identification see boxplot section). |
na.replace |
Replace missing values with median of the corresponding cycle (week, month...) for lags longer than 3 days and linear regression for shorter missed period. Can be "YES" or "NO" (the default). |
start |
Define the first year of data analysis (by default the first of the database). |
end |
Define the last year of data analysis (by default the last of the database). |
months |
Define the months of data analysis (by default the twelve months). |
norm |
Compute normalised values of nutrients at the salinity npsu for each years, can be "YES" or "NO" (the default). |
npsu |
Compute normalised values of nutrients at the salinity npsu for each years, 30 by default. |
test.on.remaider |
Extract the reminders from the data series using the stl package functions to perform statistical analysis. |
autocorr |
Display the autocorrelation diagramme of the regularized time series using the acf function with arguments : lag.max = ((nrow(TimeSerie))/2), na.action = na.pass. Can be "YES" or "NO" (the default) |
spectrum |
Display the Fourrier spectrum of the regularized time series using a Smoothed Periodogram (spec.pgram). Can be "YES" or "NO" (the default). |
anomaly |
Display a color box (function filled.contour) plot by year each time.step (months or weeks) minus the mean of the time.step of all years. Red colors show positive anomalies and blue colors negative anomalies. Can be "YES" or "NO" (the default). |
a.barplot |
Display an anomaly barplot as a function of the time.step. Red colors show positive anomalies and blue colors negative anomalies. Can be "YES" or "NO" (the default). |
zsmooth |
Display a detrended plot of the time series using the stl function with arguments s.window="periodic", na.action=na.fail. Can be "YES" or "NO" (the default). |
local.trend |
Display the interactive cusum plot of the time series (local.trend of the pastecs package) that allow to manually identify the period of change in the tendency using the function identify and perform a Kendall familly test on each idenfified period (see test section). Can be "YES" or "NO" (the default). |
test |
Perform a test to evaluate the presence and the magnitude of a temporal trend on the time series. Can be "MK" for Seasonal Mann-Kendall test (the default), "SMK" for the same test with detail for each time step, "LOESS" that fit a polynomial surface determined by one or more numerical predictors, using local fitting; a MK is perform on this fitting. |
OnOK4 |
button to call temporal analysis functions |
Results are return as .png figures or .txt files Results are also directly readable directly in the right part of the interface.
Savepath can be choose using the option 'Select directory' (see the function <selectdirectory> more more informations)
Name of saved filed follow the nomenclature : Original.file.name_analysis.name_parameter.txt/.png
or for multiple period analysis (see cusum for more details) : Original.file.name_analysis.name_parameter_starting.year_ending.years.txt.
analysis.names are :
_Boxplot_ for boxplot figure (.png). _Outliers_ for the save of removed outliers (.txt). _TimeSeries_ for the plot of the regularized time series (.png). _Regularised_data_ for the table of regularized time series (.txt). _Autocor_ for the autocorelation diagram (.png). _Spectrum_ for the Fourier spectrum plot (.png) . _ColorPlot_ for the anomaly color.plot (.png). _Anomaly BarPlot_ for the anomaly barplot (.png) _Detrended_ for detrended plot (.png). _Local_Global Trend_ for result of Seasonal Mann Kendall apply to local trend (.txt). _Local_Seasonal Trend_ same as above with detail for each time step (.txt). _Global Trend_ for result of Seasonal Mann Kendall (.txt). _Seasonal Trend_ same as above with detail for each time step (.txt). _LOESSplot_ for loess plot (.png). _NormalNutri_ for analysis of normalized values of nutrients (.png).
See values output of corresponding functions.
David Devreker
boxplot
impute
shapiro.test
summary
acf
spectrum
filled.contour
stl
local.trend
mannKen
seasonTrend
seaKen
loess
Allow to chose the directory where results (.txt and .png files) will be saved.
selectdirectory()
selectdirectory()
It select the main save directory; the package will create appropiate sub-folder as function of selected parameters, statsitics, methods etc. Then you will be able to perform successive analyses wihtout overwriting the previous results.
Variation in temperature, salinity and chlorophyll-a concentration (microg/l) monthly measured between 1995 and 2010 at three different stations distributed onshore to offshore (North See) near the city of Dunkerque (north of France) for the SRN monitoring program (Ifremer). This database contain many missing values.
A data.frame (TXT) containing 1561 measurments of temperature, salinity and chlorophyll-a concentration
The Ifremer QUADRIGE_2 meta-database
A friendly user graphic interface to perform temporal trend analysis. The interface offer multiple options to select parameters and build time series that the user can follow step by step. Some options are selected by default to let the hurry user to do really quick analysis. Some diagnosic tools are also present.
TTAinterface()
TTAinterface()
Results are saved in .txt files or .png figures in the desire directory (see selectdirectory). See 'FULLoption' values fore more details.
David Devreker
FULLoption
fixdata
selectdirectory