Code for: Experimental Investigations of the Flow-Following Capabilities and Hydrodynamic Characteristics of Lagrangian Sensor Particles With Respect to Their Centre of Mass (doi:10.18419/darus-3314)

View:

Part 1: Document Description
Part 2: Study Description
Part 5: Other Study-Related Materials
Entire Codebook

Code for: Experimental Investigations of the Flow-Following Capabilities and Hydrodynamic Characteristics of Lagrangian Sensor Particles With Respect to Their Centre of Mass

doi:10.18419/darus-3314

DaRUS

2023-03-13

1

Hofmann, Sebastian; Rautenbach, Ryan, 2023, "Code for: Experimental Investigations of the Flow-Following Capabilities and Hydrodynamic Characteristics of Lagrangian Sensor Particles With Respect to Their Centre of Mass", https://doi.org/10.18419/darus-3314, DaRUS, V1

Code for: Experimental Investigations of the Flow-Following Capabilities and Hydrodynamic Characteristics of Lagrangian Sensor Particles With Respect to Their Centre of Mass

Code for Lagrangian Particle Tracking within the framework of a Master thesis

doi:10.18419/darus-3314

Hofmann, Sebastian (TU Hamburg (TUHH))

Rautenbach, Ryan (TU Hamburg (TUHH))

427899833

DaRUS

Hofmann, Sebastian

Hoffmann, Marko

Schlüter, Michael

Hofmann, Sebastian

2023-03-07

https://doi.org/10.18419/darus-3314

Engineering, Image Processing

<b>Data for 2D Lagrangian Particle tracking and evaluation for their hydrodynamic characteristics</b> </br> </br> ## Abstract</br> This dataset entails PYTHON code for fluid mechanic evaluation of Lagrangian Particles with the "Consensus-Based tracking with Selective Rejection of Tracklets" (CSRT) algorithm in the "OpenCV" library, written by Ryan Rautenbach in the framework of his Master thesis.</br> </br> ## Workflow for Lagrangian Particle tracking and evaluatio via OpenCV</br> In the following a brief introduction and guide based on the folders in the repository is laid out. More code specific instructions can be found in the respective codes.</br> </br> working_env_RMR.yml --> Contains the entire environment including software versions (here used with Spyder IDE and Conda) with which the datasets were evaluated.</br> </br> 01 --> The tracking always begins with the same 01_milti[...] folder in which the python code with OpenCV algorithm is located. For tracking the tracking to work certain directories are required in which the raw images are to be stored (separate from anything else) as well as a directory in which the results are to be save (not the same directory as the raw data).</br> </br> After tracking is completed for all respective experiments and the results directories are adequately labelled and stored any of the other code files can be used for respective analyses. The order of folders beyond the first 01 directory has no relevance to the order of evaluation however can ease the understanding of evaluated data if followed.</br> </br> 02 --> Evaluation of amount of circulations and respective circulation time in experimental vat. (code can be extended to calculate the circulation time based on the various plains that are artificially set)</br> </br> 03 --> Code for the calculation of the amount of contacts with the vat floor. Code requires certain visual evaluations based on the LP trajectories, as the plain/barrier for the contact evaluation has to be manually set.</br> </br> 04 --> Contains two codes that can be applied to results data to combine individual results into larger more processable arrays within python.</br> </br> 05 --> Contains the code to plot the trajectory of single experiments of Lagrangian particles based on their positional results and velocity at respective position, highlighting the trajectory over the experiment.</br> </br> 06 --> Condes to create 1D histograms based on the probability density distribution and velocity distributions in cumulative experiments.</br> </br> 07 --> Codes for plotting the 2D probability density distribution (2D Histograms) of Lagrangian Particles based on the cumulative experiments. Code provides values for the 2D grid, plotting is conducted in Origin Lab or similar graphing tools, graphing can also be conducted in python whereby the seaborn (matplotlib) library is suggested.</br> </br> 08 --> Contain the code for the dimensionless evaluation of the results based on the respective Stokes number approaches and weighted averages. 2D histograms are also vital to this evaluation, whereby the plotting is again conducted in Origin Lab as values are only calculated in code.</br> </br> 09 --> Directory does not contain any python codes but instead contains the respective Origin Lab files for the graphing, plotting and evaluation of results calculated via python is given. Respective tables, histograms and heat maps are hereby given to be used as templates if necessary.

Sebastian Hofmann, M.Sc. DFG Priority Programme SPP 2170 "InterZell" Room O 1.013 Institute of Multiphase Flows (IMS/V-5) Hamburg University of Technology Eißendorfer Straße 38 21073 Hamburg Germany Phone: +49 40 428 78 - 3106 Mail: sebastian.hofmann@tuhh.de

Rautenbach, R., 2023. Experimental Investigations of the Flow-Following Capabilities and Hydrodynamic Characteristics of Lagrangian Sensor Particles With Respect to Their Centre of Mass (Master thesis). Hamburg University of Technology, Institute of Multiphase Flows.

Rautenbach, R., 2023. Experimental Investigations of the Flow-Following Capabilities and Hydrodynamic Characteristics of Lagrangian Sensor Particles With Respect to Their Centre of Mass (Master thesis). Hamburg University of Technology, Institute of Multiphase Flows.

Label:

working_env_RMR.yml

Text:

This .yml file configures and reproduces the entire environment via e.g. conda.

application/octet-stream

Label:

multitracker_RMR_w_recognition_CSRT_tracker.py

Text:

The first step in the experimental evaluation is the tracking via "opencv". It is important to note that the tracking requires images that are in one directory/folder and sorted in the necessary order through which the algorithm is to run through. Prior to the tracking the images should be cropped to a necessary size, in the case of the tracking for this thesis the images were captured via a Basler high-speed camera in which the necessary mask/crop of the image was automatically introduced. To run the analysis the captures are analysed and must have the same undisturbed imaging.

text/x-python

Label:

total_circ.py

Text:

This code is used to determine the circulation times and amount of circulations based on the positional results.

text/x-python

Label:

Floor_Hit_counter.py

Text:

This code is used to determine the amount contacts between the Lagrangian Particle (LP) and the floor of the vat.

text/x-python

Label:

combined _results_hit_counts.py

Text:

This code combines all the individual floor hit results for the respective experiments.

text/x-python

Label:

general_code_for_combination_of_results.py

Text:

This code combines all the individual floor hit results for the respective experiments.

text/x-python

Label:

velocity_plotter.py

Text:

This code is fairly simple and just creates a scatter plot for an individual experiment based on the trajectory data, which is saved into individual numpy files. It is important to only access one experiment at a time in this code as a combination of all results would not yield a reflective result as too many data points are available then.

text/x-python

Label:

velocity_plotter_40mm.py

Text:

This code is fairly simple and just creates a scatter plot for an individual experiment based on the trajectory data which is saved into individual numpy files. It is important to only access one experiment at a time in this code as a combination of all results would not yield a reflective result as too many data points are available then.

text/x-python

Label:

historgam_maker_position.py

Text:

Very simple bit of code that creates histograms based on all the individual experiments for the positional data. It calculates the histograms for each axis individually, the path to where the numpy files are saved and the directory for where the results are to be saved are defined below.

text/x-python

Label:

historgam_maker_velocity.py

Text:

Very simple bit of code that creates histograms based on all the individual experiments for the positional data. It calculates the histograms for each axis individually, the path to where the numpy files are saved and the directory for where the results are to be saved are defined below.

text/x-python

Label:

heat_map_std_calc.py

Text:

This code calculates the heat maps standard deviation and recalculates it to reflect the uncertainty in a 10x10 grid based on the numpy positional data that are saved into one specific directory which is to be defined. It can also be used to actually graph and calculate the normal heat maps, however, this only requires the full np positional vectors which was done in "Origin lab".

text/x-python

Label:

CFD_vel_map.py

Text:

Here, the respective folders are searched for the results pertaining to the CFD and experimental results. Make sure to have the results from the trajectory data stored in their seperate folders. Eventually, all different Stokes numbers will be calculated.

text/x-python

Label:

calculations_40mm.opju

Text:

This file contains the origin lab files pertaining to the calculations and graphing of the 25mm and 40mm LP results. Generally, the python codes will yield "numpy" files, which are read through the respective editor, the results are then imported/inserted into the respective graphing program (in this case: "Origin lab") in order to graph the results, such as the histograms or heat maps.

application/octet-stream

Label:

calculations_HZDR_RMR_Master.opju

Text:

This file contains the origin lab files pertaining to the calculations and graphing of the 25mm and 40mm LP results. Generally, the python codes will yield "numpy" files, which are read through the respective editor, the results are then imported/inserted into the respective graphing program (in this case: "Origin lab") in order to graph the results, such as the histograms or heat maps.

application/octet-stream