This DATSETNAMEreadme.txt file was generated on [20251125] by [Satyam Srivastava]


-------------------
GENERAL INFORMATION
-------------------


1. Title of Dataset: Supporting Movie Files


2. Author Information:


    Principal Investigator Contact Information:
        
        Name: Taylor J Woehl
        Institution: University of Maryland College Park 
        Address:Dept of Chemical and Biomolecular Engineering
		University of Maryland
		4418 Stadium Drive
		College Park, MD  20742
        Email: tjwoehl@umd.edu


    Associate or Co-investigator Contact Information:
        
        Name: Satyam Srivastava
        Institution:University of Maryland College Park 
        Address:Dept of Chemical and Biomolecular Engineering
		University of Maryland
		4418 Stadium Drive
		College Park, MD  20742
        Email: ssrivas@umd.edu



3. Date of data collection (single date, range, approximate date): <2024/01/01 - 2025/06/30>


4. Geographic location of data collection (where was data collected?):  Dept of Chemical and Biomolecular Engineering
									University of Maryland
									4418 Stadium Drive
									College Park, MD  20742



5. Information about funding sources that supported the collection of the data: National Science Foundation under grant NSF-CBET-2025249.



---------------------
DATA & FILE OVERVIEW
---------------------


1. File List:


    A. Filename:Segmentation_and_event_detection.m
        Short description:A MATLAB program that analyzes grayscale optical microscopy videos to identify and track particle aggregates in order to detect events in which a single aggregate splits into two or two aggregates merge to form 	a larger one. The program saves binarized frames but does not provide full aggregate trajectories.

    B. Filename:TrackingVelocity.m
        Short description:A MATLAB program that takes a .mat file containing binarized frames—created by Segmentation_and_event_detection.m—from a grayscale optical microscopy video and tracks the detected objects.

    C. Filename:Segmentation_HighMag.m
        Short description: Short description:A MATLAB program that analyzes grayscale optical microscopy videos to identify aggregates containing two particle sizes and to detect large particles in each frame. The program outputs two 	processed movie versions: one showing all aggregates and another showing only the large particles.

    D. Filename:TrackingVelocityHighMag.m
        Short description:A MATLAB program that loads two binarized video files generated by Segmentation_HighMag.m, one containing particle aggregates and the other containing large particles. The program tracks both aggregates and 	large particles across frames and assigns each large particle to its associated aggregate.


 

2. Relationship between files: MATLAB codes used for the manuscript "Electric field driven dynamic assembly of active colloidal aggregates"



--------------------------
METHODOLOGICAL INFORMATION
--------------------------


1. Description of methods used for collection/generation of data: 
Programs were written in MATLAB.