This readme file describes the contents of a data archive intended to accompany a doctoral dissertation.

Dissertation Title: Plant-Pollinator Interactions in an Ecological and Evolutionary Context: The Promising Role of 3D-Printing Technology and Mathematical Modeling

Author: Eric Octavio Campos

Degree: Doctor of Philosophy

Institution: University of Washington (Seattle, WA, United States of America)

Department: Department of Biology

Date of creation of this readme file: June 7, 2017 (06-07-2017)
Date of degree conferral: September 27, 2017 (09-27-2017)

Contact Information:
For questions regarding this data archive, you may email the author at:
eocampos37@gmail.com (most stable)
or
eocampos@uw.edu

For custom scripts or software used in the processing or analysis of the data, see the dissertation's Supplemental Software Accessibility sections at the end of each chapter for links to GitHub repositories.
------------------------------------------------------------------------------------

ORGANIZATIONAL STRUCTURE

The data archive is divided into five directories, one directory for each experiment in which data was collected.  Each main experiment directory is named with a common pattern:

data_experiment_x

where x represents the number of the experiment (1-5).  For example: data_experiment_1

Each experiment directory contains sub-directories that each contains a data set originating from a particular data acquisition source.  Within the directory for “experiment 1”, the sub-directories are named as follows, alphabetically:

flower_exploitation_counts_experiment_1
ir_sensor_data_experiment_1
moth_flight_tracking_xy_coordinate_data_experiment_1
video_annotations_experiment_1

Please take a moment to verify that this is the case.  Every other experiment directory contains the same sub-directories with names corresponding to the experiment number.  I will continue to use “experiment 1” as the model of this description.  The reader should understand that the same organizational structure should be present in the directory tree of every other experiment number.
------------------------------------------------------------------------------------

FIRST SUB-DIRECTORY

Sub-directory flower_ exploitation_counts_experiment_1 contains one Microsoft Excel file, named flower_exploitation_counts_experiment_1.xlsx

This Excel file contains a table of the number of artificial flowers that were emptied (exploited) by a hawkmoth during each foraging trial.  The table is organized according to the nectary diameter and corolla curvature of each flower type present in the experiment.  For example,

D 2.5 / C -4

Corresponds to a flower with nectary diameter of 2.5 mm and corolla curvature of value -4.
------------------------------------------------------------------------------------

SECOND SUB-DIRECTORY

Sub-directory ir_sensor_data_experiment_1 contains:

raw_ir_sensor_data_experiment_1 (sub-directory)
tabulated_proboscis_insertion_data_all_experiments.xlsx
tabulated_proboscis_insertion_duration_data_all_experiments.xlsx

The sub-directory contains original raw data files from the infrared sensors attached to each artificial flower (see dissertation, Materials and Methods, Chapters 3 and 4 for relevant details).  These data files are in csv file format.  Each file corresponds to one foraging trial.  There should be 25 files in total.  File names indicated the date and unique moth identity associated with each foraging trial.  See GitHub repository links in the dissertation for information about how to process these data files.

The two Microsoft Excel files listed above each contain tabulated processed forms of the raw data files.  These can be used to quickly construct bar graphs of the data.
------------------------------------------------------------------------------------

THIRD SUB-DIRECTORY

Sub-directory moth_flight_tracking_xy_coordinate_data_experiment_1 contains:

undistorted_moth_xy_coordinate_data (sub-directory)
undistorted_video_frames_for_flower_location (sub-directory)

The “xy coordinate” sub-directory contains csv files of x,y coordinates from a custom automated moth flight-tracking program that I employed for my dissertation research (see Chapter 4, Materials and Methods).  For Experiment 1, there are nine such files, but other experiments could have a variable number of these data files, depending on how many foraging trial videos could be successfully tracked by the auto-tracking program.

The “video frames for flower location” sub-directory contains a set of image files in png format.  These files are intended for use in finding the x,y coordinate locations of the 36 artificial flowers in my flight arena for each trial in that was successfully tracked by the auto-tracking program.  This is for calculating the distance of the moth from the flower that it is visiting at any time during the foraging trial.  There should be an equal number of image files and x,y coordiante data files in each respective experiment’s sub-directories.
------------------------------------------------------------------------------------

FOURTH SUB-DIRECTORY

Sub-directory video_annotations_experiment_1 contains:

video_annotations_experiment_1.xlsx

This sub-directory contains only one file, a Microsoft Excel file.  

The Excel file contains 25 tabs, with each tab containing video annotation data for an individual foraging trial.  The data takes for form of a table where each row represents an individual visit to an artificial flower by the pollinator (hawkmoth).  For each flower visit, I record the frame at which the visit begins and the frame at which it end.  Frame rate is also provided to allow the calculation of visit durations.  Also recorded is a code numeral representing the flower morph that was visited.  The key for the numeral code is also provided.
====================================================================================

NOTE ABOUT AN EXCEPTION

There is one exception to the directory tree pattern described above.  The directory containing data for “experiment 5”:

data_experiment_5

does not contain an xy-coordinate data sub-directory.  Automated moth position tracking data is not available for “experiment 5”.  This is explained in the dissertation (Chapter 4).
------------------------------------------------------------------------------------

This concludes the explanatory contents of this readme file.

