https://doi.org/10.5061/dryad.3tx95x6nh

Corresponding Author: Jarrod Petersen, Brown University, jarrod_petersen@brown.edu
Principal Investigator: Thomas Roberts, Brown University, thomas_roberts@brown.edu

Overview & General Information

Data Types
The raw data included starts with six different individual identifiers 001-006 (n=6) and can be broken down into three different types of files:

1. [XXX_MotorData_AllTrials.csv]
2. [XXX_TrackedData_FVXX.csv]
3. [XXX_TrackedData_RampX.csv]

For each of these file types, "X" represents a character that will vary based on the individual and trial (as listed below) while the base name of each file type is listed above and detailed here:

Type 1 data are raw data obtained from a PowerLab data acquisition system that receives a digital signal from an Aurora Scientific 10N muscle servomotor. The motor converts an analog signal into digital force and length output waves.

Type 2 and 3 data are both user-generated data from tracking two-dimensional points from a high-speed video recording in XMALab. Multiple variables along the muscle were tracked for each data type including "fiber_x_top" and "muscle_y_bottom." Type 2 data have fewer variables and are from video tracked from isotonic contractions where the servomotor holds a constant preset force value and the muscle then shortens or lengthens rather than producing force exceeding this value. Type 3 data are for dynamic shortening ramp contractions where the motor shortens (thus, allowing the muscle to shorten) based on predefined ramp signals that correspond with time.

Trial Nomenclature
Following the base names, the file names (and variable names in Type 1 data) have specific nomenclature that represents which trial they are a part of. There are two main types of trials:

1. "FVXX"
2. "RAMPX"

For both of these trial types, "X" represents a number that references the parameters in that trial. These trial names are also present in the variables names for Type 1 data.

"FVXX" trials correspond to "Force-Velocity" contractions, or isotonic contractions as mentioned above. The number following the "FV" corresponds to the percent of the maximum force value that the servomotor regulates. For example, "FV10" corresponds to a trail of a "Force-Velocity" contraction, or the isotonic contraction, that is ~10% of the maximum force value. These numbers range from 10-80, however, there is a variable in Type 1 data (as detailed below) that uses 100, or 100% of the maximum force value, resulting in an isometric contraction where there is no shortening.

"RampX" trials correspond dynamic shortening ramp contractions where the number, ranging from 1-4, corresponds to a specific shortening velocity of the muscle servomotor, and therefore, the muscle:

• '1' = 60mm/s
• '2' = 90mm/s
• '3' = 120mm/s
• '4' = 160mm/s

For example, Ramp4 corresponds to the fourth "Ramp" contraction, or the fastest of the four dynamic shortening ramps at 160mm/s.

NULL Data
For "XXX_TrackedData_XXXX" files of FV20 and Ramp1-4 trials, there are "null" data in cells prior to and following the relevant contraction period for most muscle, mtu, and bone coordinate variables. The start of each trial and the end of each trial are not relevant to the experiment, and are often periods where data is being acquired but equipment voltages are not changing. This means that many values may appear to be similar or even the same during this waiting period. Null values acted to speed up the consuming process of marker tracking during data analysis, so data was not collected for these variables. Other variables may have all of these values present reflecting a different subjective decision during analysis, likely where time was not a constraint.

Data-specific Information for Type 1 [XXX_MotorData_AllTrials.csv]

Number of variables: 22
Number of rows: 1003
Sampling rate: 1000 Hz
Units: "Fmotor_XXX" variables are all in Newtons, "Lmotor_XXX" variables are all in millimeters
Note - Data acquisition measured the first datapoint (row 1) at time 0

Variable List:

• "Fmotor_XXX" - Force detected from the motor where "XXX" corresponds to the name of each trial (ex. Fmotor_FV10 corresponds to the "Force-Velocity" contraction, or the isotonic contraction, that is ~10% of the maximum force value).
• "Lmotor_XXX" - Length detected from the motor where "XXX" corresponds to the name of each trial (ex. Lmotor_Ramp1 corresponds to the first "Ramp" contraction, or the slowest of the four dynamic shortening ramps at 60mm/s).
• "Fmotor_FV100" & "Lmotor_FV100" - These force and length signals are also detected from the motor, but are distinct in that their naming convention (FV100) does not appear in other files. This is because they are isometric contractions where, rather than force being held constant, length is held constant and these trials are used to determine maximum muscle force. Since length is held constant, the muscle-tendon unit cannot shorten and no videos were analyzed in Type 2 or 3 data files. There is one "Fmotor_FV100" and one "Lmotor_FV100" variable per individual.

Data-specific Information for Type 2 [XXX_TrackedData_FVXX.csv]

Number of variables: 10
Number of rows: 501
Sampling rate: 500 fps (frames per second)
Units: Millimeters
Note - Data acquisition measured the first datapoint (row 1) at time 0

Variable List:

• "fiber_x_top" - The x-coordinate of a two-dimensional point located at a marker at the top of the muscle fascicle for an individual (mm)
• "fiber_y_top" - The y-coordinate of a two-dimensional point located at a marker at the top of the muscle fascicle for an individual (mm)
• "fiber_x_bottom" - The x-coordinate of a two-dimensional point located at a marker at the bottom of the muscle fascicle for an individual (mm)
• "fiber_y_bottom" - The y-coordinate of a two-dimensional point located at a marker at the bottom of the muscle fascicle for an individual (mm)
• "muscle_x_top" - The x-coordinate of a two-dimensional point located at a marker at the top of the muscle belly for an individual (mm)
• "muscle_y_top" - The y-coordinate of a two-dimensional point located at a marker at the top of the muscle belly for an individual (mm)
• "muscle_x_bottom" - The x-coordinate of a two-dimensional point located at a marker at the bottom of the muscle belly for an individual (mm)
• "muscle_y_bottom" - The y-coordinate of a two-dimensional point located at a marker at the bottom of the muscle belly for an individual (mm)
• "Corrected_Lf" - The length of the muscle fascicle throughout the trial calculated from the x and y coordinates of the muscle fascicle variables and corrected with a factor obtained from measuring the length of the real muscle fascicle vs. the length between muscle fascicle markers (mm)
• "Corrected_Lm" - The length of the muscle belly throughout the trial calculated from the x and y coordinates of the muscle belly variables and corrected with a factor obtained from measuring the length of the real muscle belly vs. the length between muscle belly markers (mm)

Data-specific Information for Type 3 [XXX_TrackedData_RampX.csv]

Number of variables: 16
Number of rows: 501
Sampling rate: 500 fps (frames per second)
Units: Millimeters
Note - Data acquisition measured the first datapoint (row 1) at time 0
Note - Blank values are present where there was negligible movement, thus, no need for marker tracking

Variable List:

• "fiber_x_top" - The x-coordinate of a two-dimensional point located at a marker at the top of the muscle fascicle for an individual (mm)
• "fiber_y_top" - The y-coordinate of a two-dimensional point located at a marker at the top of the muscle fascicle for an individual (mm)
• "fiber_x_bottom" - The x-coordinate of a two-dimensional point located at a marker at the bottom of the muscle fascicle for an individual (mm)
• "fiber_y_bottom" - The y-coordinate of a two-dimensional point located at a marker at the bottom of the muscle fascicle for an individual (mm)
• "muscle_x_top" - The x-coordinate of a two-dimensional point located at a marker at the top of the muscle belly for an individual (mm)
• "muscle_y_top" - The y-coordinate of a two-dimensional point located at a marker at the top of the muscle belly for an individual (mm)
• "muscle_x_bottom" - The x-coordinate of a two-dimensional point located at a marker at the bottom of the muscle belly for an individual (mm)
• "muscle_y_bottom" - The y-coordinate of a two-dimensional point located at a marker at the bottom of the muscle belly for an individual (mm)
• "mtu_x_top" - The x-coordinate of a two-dimensional point located at a marker at the top of the muscle-tendon-unit for an individual (mm)
• "mtu_y_top" - The y-coordinate of a two-dimensional point located at a marker at the top of the muscle-tendon-unit for an individual (mm)
• "mtu_x_bottom" - The x-coordinate of a two-dimensional point located at a marker at the bottom of the muscle-tendon-unit for an individual (mm)
• "mtu_y_bottom" - The y-coordinate of a two-dimensional point located at a marker at the bottom of the muscle-tendon-unit for an individual (mm)
• "Corrected_Lf" - The length of the muscle fascicle throughout the trial calculated from the x and y coordinates of the muscle fascicle variables and corrected with a factor obtained from measuring the length of the real muscle fascicle vs. the length between muscle fascicle markers (mm)
• "Corrected_Lm" - The length of the muscle belly throughout the trial calculated from the x and y coordinates of the muscle belly variables and corrected with a factor obtained from measuring the length of the real muscle belly vs. the length between muscle belly markers (mm)
• "Corrected_Lmtu" - The length of the muscle-tendon-unit throughout the trial calculated from the x and y coordinates of the muscle-tendon-unit variables and corrected with a factor obtained from measuring the length of the real muscle-tendon-unit vs. the length between muscle-tendon-unit markers (mm)
• "Corrected_Lbone" - The y-coordinate of the marker on the distal bone for an individual. This variable is not corrected with a scaling value like the other variables that start with "corrected..." are, it simply represents the point distance of the bone in millimeters (mm)