This readme file was generated on [2026-03-30] by [Alisdair Soppitt]

*Note:
[text within square brackets should be changed to specific information about your dataset.]
*help text within asterisks should be deleted before finalizing your document**

# GENERAL INFORMATION

* OpenLB Experiments in Clogging a Porous Medium Varying Particle Size: 
## Author/Principal Investigator Information
Name: Alisdair Soppitt
ORCID:
Institution: University of Liverpool
Address: 
Email: 

## Author/Associate or Co-investigator Information
Name: Haopeng Wang
ORCID:
Institution: University of Liverpool
Address: 
Email: Haopeng.Wang@liverpool.ac.uk


* Date of data collection: 2026-03-16 to 2026-03-26
* Geographic location of data collection: Remotley using Computaional Resoarces located at the University of Liverpool
* Information about funding sources that supported the collection of the data: Producded as part of a Postdoc Pathway position funded by the Engineering and Physical Sciences Research Council (EPSRC)


# SHARING/ACCESS INFORMATION



* This dataset was produced using the OpenLB Lattice Boltzmann library

* Uses microCT data provided by the authours of "Bo Li, Yunpeng Zhang, Dingbang Wei, Tengfei Yao, Yongping Hu, and Hui Dou. Evolution of clogging of porous asphalt concrete in the seepage process through integration of computer tomography, computational fluid dynamics, and discrete element method. Computer-Aided Civil and Infrastructure Engineering, 40(12):1652–1674, 2025. doi:https://doi.org/10.1111/mice.13419."


# DATA & FILE OVERVIEW

## File List: *list all files (or folders, as appropriate for dataset organization) contained in the dataset, with a brief description*

* Relationship between files, if important: 
* Additional related data collected that was not included in the current data package: 
A control simulation without particles was performed. The velocity fields were ommited due to space concerns, the volumetric flux data from this is retained in the "small\_20\_03\_no\_particle/tmp/vtkData/Q" folder.
* This is the only version of this dataset


# METHODOLOGICAL INFORMATION

## Description of methods used for collection/generation of data: 
The data was produced using the OpenLB lattice boltzmann simulation library, described in the papaer: "Adrian Kummerländer, Tim Bingert, Simon Bock, Fedor Bukreev, Daniel Castroviejo, Luiz Eduardo Czelusniak, Davide Dapelo, Christoph Gaul, Marcio Dorn, Leonardo
Dorneles, Johannes Grafen, Michael Grinschewski, Shota Ito, Julius Jeßberger, Florian Kaiser, Danial Khaza-
eipoul, Timm Krüger, Arsh Kumbhat, Halim Kusumaatmaja, Andreas Nettekoven, Alice Raeli, Tikhon Riazant-
sev, Michael Rennick, Gagan Prakash, František Prinz, Liam Sauterleute, Maximilian Schecher, Andreas Schnei-
der, Yuji Shimojima, Stephan Simonis, Philipp Spelten, Alexandre Tacques, and Mathias J. Krause. Openlb
release 1.9: Open source lattice boltzmann code, December 2025. URL https://doi.org/10.5281/zenodo.17899765"
The code used can be found at: https://github.com/Asoppitt/PorousAsphaltParticles.git

## Methods for processing the data: 
The folders named "Q" in each of the experiment folders contains the volumetric flux at the lower boundary. The is derived from the velocity fields. The procedure to do this was as follows:
1. Extract the velocities at the lower boundary using ParaView
2. Use the provided "Q.jl" script to integrate the z-velocity over the outflow plane
3. Divide this integral by the total cross-sectonal area of the sample

## Instrument- or software-specific information needed to interpret the data: 
The velocity data is in the VTK format. It is recomended to use ParaView to read this data. Paraview can be obtained from www.paraview.org. The dataset has been confirmed to be readable using ParaView version 5.11.2.

The script "Q.jl" in the "Q" folder is provieded for reproducibility of analysis and is not needed to view the data. To run this script Julia is required, the script was written using julia 1.12.5

*include any additional methodological information needed to interpret and/or use the data, as appropriate*
* Standards and calibration information, if appropriate: All data is given in SI (meter-kilogram-second) units.
* People involved with sample collection, processing, analysis and/or submission: Alisdair Soppitt


# DATA-SPECIFIC INFORMATION FOR: porousAsphaltPaticles.pvd
This information is relevent for the file "tmp/vtkdata/porousAsphaltPaticles.pvd" in either "small\_20\_03\_lowMed\_2", or "small\_20\_03\_medHigh". This file, when read using ParaView, gives the structure for the vtk files in the "data" folder, this summary therefore applies to the whole data structure.

* Number of variables: 3
* Variable List: 
    * physVelocity - a vector valued variable that describes the velocity of the fluid at the target location in m/s
    * physPressure - A scalar giving the pressure in the fluid at the given location, in pa
    * ExtPorosityField - A scalar that has value 0 within particles and 1 outside of particles