Accompanying Code for Wave Run-up Analysis

This dataset contains beach elevation data and derived products used for wave run-up analysis. The dataset includes ground control point and camera calibration information, rectification grids, extracted shoreline time series, and run-up elevation results. MATLAB scripts required to process the video data and reproduce the analysis workflow are also provided.

Subjects:

Civil engineering and built environment

Coastal and Waterway Engineering

Cite this dataset as:
Thompson, L., 2026. Accompanying Code for Wave Run-up Analysis. Bath: University of Bath Research Data Archive. Available from: https://doi.org/10.15125/BATH-01724.

Export

Data

C7.zip
application/zip (2GB)
Creative Commons: Attribution 4.0

Processing package for coastal run C7, containing the survey data, generated rectification grid, and processed outputs from the CIRN run-up analysis workflow, including shoreline and run-up results.

C7a.zip
application/zip (2GB)
Creative Commons: Attribution 4.0

Processing package for coastal run C7a, containing the survey data, generated rectification grid, and processed outputs from the CIRN run-up analysis workflow, including shoreline and run-up results.

C3.zip
application/zip (2GB)
Creative Commons: Attribution 4.0

Processing package for coastal run C3, containing the survey data, generated rectification grid, and processed outputs from the CIRN run-up analysis workflow, including shoreline and run-up results.

C3a.zip
application/zip (2GB)
Creative Commons: Attribution 4.0

Processing package for coastal run C3a, containing the survey data, generated rectification grid, and processed outputs from the CIRN run-up analysis workflow, including shoreline and run-up results.

C11.zip
application/zip (2GB)
Creative Commons: Attribution 4.0

Processing package for coastal run C11, containing the survey data, generated rectification grid, and processed outputs from the CIRN run-up analysis workflow, including shoreline and run-up results.

C11a (2).zip
application/zip (2GB)
Creative Commons: Attribution 4.0

Processing package for coastal run C11a, containing the survey data, generated rectification grid, and processed outputs from the CIRN run-up analysis workflow, including shoreline and run-up results.

Code

ScriptsAndFxns.zip
application/zip (57kB)
Creative Commons: Attribution 4.0

MATLAB code and supporting functions for processing coastal video imagery to derive wave run-up. The workflow includes ground control point selection and camera calibration, image rectification, pixel instrument generation, variance-based shoreline detection and quality control, conversion of shoreline position to elevation using a rectification grid, synchronisation and comparison with LiDAR measurements, run-up peak detection, Still Mean Water Level estimation, and calculation of run-up statis

Master_Code.m
text/plain (5kB)
Creative Commons: Attribution 4.0

Master MATLAB script for processing coastal video run-up data. The script manages the CIRN processing workflow, including ground control point selection, camera calibration, grid generation, image processing, pixel instrument extraction, and shoreline/run-up analysis.

Creators

Laura Thompson
University of Bath

Contributors

Samuel Rose
Data Collector
University of Bath

0009-0006-2071-4547

Chris Blenkinsopp
Supervisor
University of Bath; University of New South Wales

0000-0001-5784-2805

University of Bath
Rights Holder

Documentation

Data collection method:

The dataset was generated from coastal video observations collected at a fixed monitoring location. Video imagery was used to identify and track the shoreline/run-up position through time. Ground Control Points (GCPs) with known real-world coordinates were manually identified in the imagery and used, together with camera calibration information, to establish the image-to-world coordinate transformation. A rectified spatial grid was generated to transform image coordinates into real-world coordinates. LIDAR and bed elevation data associated with the study run were also included where available for comparison and analysis.

Data processing and preparation activities:

Data were processed using MATLAB-based scripts adapted from the CIRN Quantitative Coastal Imaging Toolbox. The original workflow was modified and extended for this study to support automated processing of the video imagery, camera calibration, image rectification, shoreline extraction and run-up analysis. Additional custom MATLAB code was developed to identify and filter run-up peaks and calculate run-up metrics.

Technical details and requirements:

Data processing was carried out in MATLAB. The processing workflow was based on the CIRN Quantitative Coastal Imaging Toolbox and includes modified and additional MATLAB scripts developed for this study. The supplied code includes a master processing script and supporting functions required for camera calibration, ground control point selection, grid generation, image rectification, instrument data processing, shoreline extraction and run-up analysis. Users wishing to reproduce or modify the analysis will require MATLAB Version 2019b or older, and the relevant toolboxes, which include MATLAB Statistics and Machine Learning Toolbox and Image Processing Toolbox.

Additional information:

The dataset is organised by individual experimental run. Each run archive does not contain the source video, but does contain associated spatial calibration and grid data, processed outputs, and run-up analysis results. MATLAB processing scripts are provided separately and include a master script and supporting functions for camera calibration, ground control point selection, grid generation, image rectification, instrument processing, shoreline extraction and run-up analysis. The workflow was adapted from the CIRN Quantitative Coastal Imaging Toolbox and extended with custom code developed for this study. File and folder names identify the relevant experimental run and processing stage. Processed results are provided in MATLAB and CSV formats where applicable.

Methodology link:

https://github.com/Coastal-Imaging-Research-Network/CIRN-Quantitative-Coastal-Imaging-Toolbox/blob/master/X_UserManual/UserManual.pdf