# Thinly wetted surface

This repository contains data, information, and functional Python code associated with the publication "Identification of weakly- to strongly-turbulent three-wave processes in a micro-scale system."

Please cite as: 
Orosco, Jeremy; Connacher, William; Friend, James (2023). Data from: Identification of weakly- to strongly-turbulent three-wave processes in a micro-scale system. UC San Diego Library Digital Collections. https://doi.org/10.6075/J0WW7HVJ

The contents of this repository are outlined below.


## Supplementary information (supplemental_information.pdf)

This is the supplemental information file to be included with the above noted publication. It contains information on the following topics:

* device fabrication
* experimental setup
* measurement technique (digital holographic micrscopy)
* derivation of the classification parameters from kinetic wave turbulence theory
* formulation and implementation of the wavelet-based bicoherence analysis

## Capillary wave analysis tools (capillary\_wave_analysis.py)

A set of tools (written in Python) for programmatically implementing the analysis demonstrated in the associated publication.

Requirements:

* Python >= 3.8
* scipy = 1.7.1
* numpy = 1.21.5
* pywavelets = 1.2.0

Tools provided:

* wavelet-based bispectrum
* wavelet-based bicoherence
* nonlinear resonance broadening
* dimensionless wave turbulence classification parameters

## Data

Data is grouped according to experiment (one experiment per value of power input, in mW). The experiment groups contain files named according to experiment ID: \<date>\<letter>_\<initials>, where date is the date (MMDDYYYY) the experiment was performed, letter indicates the ordering of the experiments on that date, and initials correspond to the experimenter.

Each experiment group contains the following files:

* .zip zipped archive containing:
 * .md parameter file: list of experimental parameters
 * .txt file: an auxiliary timesstamps file
 * .csv file: contains a time series of the center pixel surface height for the entire experiment
 * .hdf5 file: a 0.05s sample of the surface data 
* .hdf5 data file: all surface data for the experiment

Each hdf5 data file contains surface height (i.e., capillary wave) data sampled at 115.2kHz.

The data is stored in hdf5 ([hierarchical data format](https://www.hdfgroup.org/solutions/hdf5/)). Tools for accessing data stored in this format are available in most major programming languages. The HDF Group also provides a [free java-based utility](https://www.hdfgroup.org/downloads/hdfview/) for inspecting these files. Each file is structured as follows:

```
root
│
└───main
│   |   00000
│   |   00001
|   |   ...
│   
└───meta
    |   frames
    |   t
    │   x
    │   y
```

The meta group contains metadata: the x dimension vector, the y dimension vector, the time vector, and a vector of frame numbers.

The main group contains surface data for each frame in the sequence.