From fe9b950de5cbf10b0cf548ef6d11ba7ef6697656 Mon Sep 17 00:00:00 2001 From: Ye Liu Date: Wed, 19 Dec 2018 12:01:20 +0000 Subject: [PATCH] Added intro and instructions for the readme file. --- README.md | 36 ++++++++++++++++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1c03750..f8ac095 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,34 @@ -# ecsades-r -Environmental contours for safe design of ships and other marine structures using R +# ECSADES +Environmental contours for safe design of ships and other marine structures using R. + +## Introduction +This package contains functions to fit joint probability distributions to bivariate wave data (wave height and wave period), estimate environmental contours based on the fitted distribution or directly on a given sample data, output the coordinates of the vertices of the contours, and generate a plot of the contours. + +The choices for the joint probability distributions include the Heffernan-Tawn model and the Weibull-log-normal distribution. The choices for the environmental contours are the direct sampling contours (Huseby et al. 2015), IFORM contours (Winterstein et al. 1993), generalised joint exceedance contours (Jonathan et al. 2014), and isodensity contours. + +The statistical models and contour estimation methods included in this package are discussed in detail in the project paper Ross et al. (2018). + +## Getting Started +The user will need the ```devtools``` package to install directly from a github repository. +``` +install.packages("devtools") +``` +The following command will install the latest versioin of the package on user's computer. +``` +devtools::install_github(repo="ECSADES/ecsades-r", branch='master', subdir='ecsades', dependencies = TRUE) +``` +An example of applying the functions in the package can be found in the package help file. +``` +?ecsades::ecsades +``` +There is a sample data provided in the package, which is used in all examples in the help files. +``` +data(noaa_ww3, package = "ecsades") +``` +Alternatively, the user could use function ```fread()``` from the ```data.table``` package to read in their own wave data. + +## Author +* [Ye Liu](y.liu@hrwallingford.com) + +## Acknowledgments +This work was part-funded by the European Union ERA-NET project entitled "Environmental Contours for SAfe DEsign of Ships and other marine structures (ECSADES)". The author thanks Erik Vanem and Arne Husbey for their help on parts of the code, and the project team for useful discussions.