ShoreShop / ShoreModel_Benchmark

This repository is set to benchmark the shoreline models contributed to the ShoreShop2.0
14 stars 9 forks source link

ShoreShop 2.0: Advancements in Shoreline Change Prediction Models

This repository is a testbed for shoreline modelling algorithms. It contains all benchmark datasets, input files, codes, and results.

Background and Objectives

Background

Shoreline change prediction has witnessed the evolution of both hybrid and data-driven models, offering valuable insights into how coastlines respond to varying wave conditions across different timescales. Building on the success of the ShoreShop 1.0 (Blind testing of shoreline evolution models) in 2018, which tested 19 shoreline models in predicting shoreline positions over a four-year period, ShoreShop 2.0 aims to further explore and showcase the evolution of predictive methods.

Objectives

Join us at ShoreShop 2.0 to learn about the latest advancements, share insights, and foster collaborative efforts in shoreline change prediction.

Notebooks

The following notebooks are available in this repo:

Task description

Beach_X

A real-world Beach_X serves as the target site for this workshop. To ensure a blind test, all geographical information regarding this beach has been intentionally removed. \ What we do know is that Beach_X is an east-facing embayed sandy beach with a mean grain size D50 ≈ 0.3 mm.\ 9 shore-normal transects are established from North to South with a 100-meter longshore distance to measure shoreline position. The coordinates for the landward and seaward ends of transects are provided in transects_coords.csv. These coordinates are in a local coordinate system, deliberately shifted (not distorted or rotated), and are expressed in easting (x) and northing (y) with a unit of meters. They do not reveal the actual geographical location of Beach_X.

Tasks

Given 20 years shoreline position data in the 1999-2018 period, along with the shoreline position in 1951-05-01 as well as wave and sea level data spanning from 1940 to 2100, participants are tasked with:

Evaluation

$$ RMSE{norm} = \frac{RMSE{pred}}{STD{targ}}, STD{norm} = \frac{STD{pred}}{STD{targ}}$$

$$ \mathcal{Li} = \sqrt{(0-RMSE{norm})^2+(1-Corr)^2+(1-STD_{norm})^2} $$

$$ \mathcal{Lavg} = \frac{1}{n} \sum{i=1}^n \mathcal{L_i} $$

Modeling rules

Input data

The following files are provided for shoreline predictions.

The following constants are also provided.

Shoreline

The shoreline data (shorelines_obs.csv) utilized in the ShoreShop 2.0 workshop is derived from public satellite images captured by Landsat 5, 7, 8, and 9 satellites. This data has been processed using CoastSat, a public toolbox specifically designed for coastline analysis. \ The satellite-derived shoreline (SDS) data for model calibration/training starts from 1999 and ends at 2018 with 347 time steps. \ The shoreline position (m) is defined as the distance from the landward end of a transect to the intersection of the shoreline and the transect. \ All the shorelines have been corrected to reflect the instantaneous position at Mean Sea Level.\ The satellite-derived shoreline position data exhibits a high level of accuracy and closely aligns with the ground truth data for Beach_X with RMSE (shown in the figure below) less than 7 (m) for transects 1~8 and 15 (m) for transect 9 which is close to the headland, ensuring reliable model calibration and training.

For short-term shoreline prediction, The shorelines_target_short.csv contains the target dates from 2019 to 2023. All shoreline position values are intentionally withheld for all participants. During the evaluation phase, participants' predictions will be compared against the withheld shoreline position data from the SDS dataset.

For medium-term shoreline prediction, shorelines_target_medium.csv provides shoreline data for the date 1st May 1951, serving as the context data for the medium-term prediction task. Additional target dates are included for medium-term prediction. Participants' predictions will be evaluated against photogrammetry (pre-1989) and SDS (1989-1998) data available for the respective target dates.

Hindcast wave data

The hindcast wave data used in this workshop was obtained by downscaling offshore directional wave spectra to nearshore areas. The offshore wave data is from the ERA5 Wave Hindcast. The BinWaves approach was applied to transform the offshore wave data to nearshore. The significant wave height (Hs), peak wave period (Tp) and mean wave direction (Dir) were extracted along each shore-normal transect at 10 (m) depth contour with a daily interval from 1940 to 2023. Wave roses for the three target transects are shown below to demonstrate the minimal longshore variation of wave conditions.

Forecast wave data

The forecast wave data were made using a nested WAVEWATCH III wave model with surface wind data from the Australian Community Climate and Earth System Simulator (ACCESS) as inputs. Wave projections have been performed for medium range carbon (RCP4.5) and high range (RCP8.5) carbon emission scenarios throughout 2006-2100. The offshore wave forecast was transformed to nearshore following the same approach applied to hindcast wave data. For each transect, to ensure the consistency between the hindcast and forecast data, the forecast wave climates were calibrated to have the same seasonality and joint distribution of Hs, Tp and Dir over the period of 2006~2023 with the multivariate bias correction algorithm (MBCn). Calibration results with hindcast data as reference for Transect1 under RCP4.5 scenario are shown below.

Tide data

tide.csv contains the daily average of tidal height from FES2014 model. Tidal components M2, S2, K1 and O1 were used for reconstruction. Tidal height is the same for all transects.

Sea level data

sealevel_obs.csv contains the annual sea level data from gauge measurement (1950-2018). sealevel_proj.csv contains the sea level projection under the RCP 4.5 and 8.5 scenarios (2019-2100). The projection data is from NASA's SEA LEVEL PROJECTION TOOL, which is based on the regional sea level projections provided in the IPCC 6th Assessment Report (AR6). Sea level is the same for all transects.

Bathymetry and slope data

Similar to the vast majority of beaches worldwide, Beach_X does not have nearshore bathymetry data available. Instead, slope.csv contains the beach-face slope for each transect derived from SDS with the CoastSat.slope tool. Therefore, participants are challenged to adapt their models accordingly to address the model applicability under data poor scenarios with only freely accessible datasets.

Outputs and Deliverables

Participants should provide short-term, medium-term and long-term model predictions for all transects as shorelines_prediction_short.csv, shorelines_prediction_medium.csv, and shorelines_prediction_long.csv.\ Both the short-term and medium-term model predictions should have daily interval. For models that do not generate daily outputs, please interpolate the results to daily.\ All prediction submissions should be placed in the designated submission folder. The submission folder will have shoreline predictions from various participants. An illustrative example of submission is provided in the submissions/ShoreFor folder for reference.

Model classification

Participants should copy and check the boxes below in the model description to assist in classifying the submitted model. An example of a model description can be found here.

Model mechanics

How to submit

To submit your results, please:

  1. fork this repository;
    • Begin by forking the original workshop repository to your GitHub account.
  2. Create a Submission Folder:
    • Inside the submission folder, create a subfolder named "ModelName_AuthorInitials". Replace ModelName with the name of your model and AuthorInitials with your initials.
  3. Place Your Prediction Files:
    • Copy your completed prediction files (shorelines_prediction_short.csv, shorelines_prediction_medium.csv and/or shorelines_prediction_long.csv) into the subfolder created in Step 2.
  4. Provide Your Model Description (an example is here):
    • Include a README.md file providing a clear description of the model you used.
    • Copy and complete the model classification checkboxes to the README.md.
  5. Include Your Code (Optional):
    • Create another subfolder within the algorithm folder named ModelName_AuthorInitials.
    • Copy your commented code into this subfolder.
    • Include a README.md file providing clear instructions on how to run your code to reproduce the prediction outputs.
  6. Submit Your Results:
    • Create a Pull request to the original workshop repository to submit your prediction results and optional code.

If you need any help with this submission, please post on the GitHub Issues page.

Deadline

The deadline for the submission is the end of the year (01/10/2024).

Questions and Comments

Please put any questions on the GitHub Issues page so that everybody can read/comment.

Acknowledgements

We extend our gratitude to Dr. Killian Vos, Dr. Laura Cagigal and Dr. Raimundo Ibaceta for generously sharing the CoastSat, BinWaves and ShoreFor codes, as well as to Aditya Deshmukh for supplying the forecast wave data.