-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Added intro and instructions for the readme file.
- Loading branch information
Showing
1 changed file
with
34 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. |