This README.txt file was generated on 2022-05-13 by Emiliano Espinoza


GENERAL INFORMATION


1. Title of File: SeekingShellfish_Data&Metadata

2. Author/Co-Investigator Information
	Name: Emiliano Espinoza, Halley McVeigh, Caitie Reza, Mariano Viz, Thomas Wheeler
	Institution: UCSB Bren School
	Address: Bren Hall, 2400 University of California, Santa Barbara, CA 93117
	Email: emilianoespinoza@ucsb.edu, hmcveigh@bren.ucsb.edu, caitlinreza@bren.ucsb.edu, mviz@bren.ucsb.edu, tbwheeler@bren.ucsb.edu

3. Date of data collection (approximate date range): <2021-10-01 - 2022-04-01>



SHARING/ACCESS INFORMATION

1. Links/relationships to ancillary data sets: http://farmscale.org/



DATA & FILE OVERVIEW

1. File List: 

raw_data (contains two files:
	basic_voi_plots (this folder contains made up data used to build the theoretical explanatory graphs found in section 3 and 4 of research paper); 
	voi_fx (data outputs derived from utilizing farmscale.org 'RUN THE FARM MODEL')),
software (R files containing the code used to create distribution plots from the raw data displayed throughout research paper), 
supplemental_information (contains all the image files of plots created using R code).



DATA-SPECIFIC INFORMATION FOR: [voi_fx]

chlorophyll_180_DAYS.CSV

1. Number of variables: 2
 
2. Number of cases/rows: 6 columns and 33 rows

3. Variable List: 
[density]: this variable is the stocking density of shellfish(individuals) per meters cubed; the unit for this variable is (ind. m-3)
[profits_Chl_2, profits_Chl_7,profits_Chl_10, profits_Chl_15, profits_Chl_20]: these variables convey the profits associated with the different levels of chlorophyll 
content, i.e. (ug L-1/micrograms per liter), within the water that the shellfish are in, relative to stocking density; the unit for these variable are in dollars. 
*For example, profits_Chl_2 represents the associated profits, relative to the stocking density chosen, for chlorophyll levels of 2 ug L-1, while profits_Chl_ 7
represnts the associated profits, relative to the stocking density chosen, for chlorophyll levels of 7 ug L-1.*
(units: density(ind. m-3), profits_Chl_X(dollars))

4. Missing data codes: NA, no output was collected


current_speed_180_DAYS.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 21 rows

3. Variable List: 
[density]: this variable is the stocking density of shellfish(individuals) per meters cubed; the unit for this variable is (ind. m-3)
[profits_CS_0.05, profits_CS_0.07,profits_CS_0.1, profits_CS_0.12, profits_CS_0.14]:  these variables convey the profits associated with the different levels of current speed, 
i.e. (m s-1/meter per second), that the shellfish are in, relative to stocking density; the unit for these variables are in dollars. 
*For example, profits_CS_0.05 represents the associated profits, relative to the stocking density chosen, for current speed levels of 0.05 m s-1, while profits_CS_0.07
represnts the associated profits, relative to the stocking density chosen, for current speed levels of 0.07 m s-1.*
(units: density(ind. m-3), profits_CS_X(dollars))

4. Missing data codes: NA, no output was collected


POM_180_DAYS.CSV

1. Number of variables: 2 
 
2. Number of cases/rows: 6 columns and 21 rows

3. Variable List: 
[density]: this variable is the stocking density of shellfish(individuals) per meters cubed; the unit for this variable is (ind. m-3)
[profits_POM_2, profits_POM_5,profits_POM_7, profits_POM_10, profits_POM_12]: these variables convey the profits associated with the different levels of particulate organic matter, 
i.e. (mg L-1/milligrams per liter), within the water that the shellfish are in, relative to stocking density; the unit for these variables are in dollars. 
*For example, profits_POM_2 represents the associated profits, relative to the stocking density chosen, for particulate organic matter levels of 2 mg L-1, while profits_POM_5
represnts the associated profits, relative to the stocking density chosen, for particulate organic matter levels of 5 mg L-1.*
(units: density(ind. m-3), profits_POM_X(dollars))

4. Missing data codes: NA, no output was collected


temperature_180_DAYS.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 29 rows

3. Variable List: 
[density]: this variable is the stocking density of shellfish(individuals) per meters cubed; the unit for this variable is (ind. m-3)
[profits_Temp_4, profits_Temp_8,profits_Temp_12, profits_Temp_16, profits_Temp_20]: these variables convey the profits associated with the different levels of water temperature, 
i.e. (°C/degrees celsius), that the shellfish are in, relative to stocking density; the unit for these variables are in dollars. 
*For example, profits_Temp_4 represents the associated profits, relative to the stocking density chosen, for water temperature levels of 4°C, while profits_Temp_8 represnts the 
associated profits, relative to the stocking density chosen, for water temperature levels of 8°C*
(units: density(ind. m-3), profits_Temp_X(dollars))

4. Missing data codes: NA, no output was collected



DATA-SPECIFIC INFORMATION FOR: [basic_voi_plots] *again, this data is completely made up for the explicit purpose of building theoretical explanatory graphs* 

1_1.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


1_2.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


1_3.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


2_1.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


2_2.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


2_3.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


3_1.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


3_2.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


3_3.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 131 rows

3. Variable List: 
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_1, prof_2, prof_3, prof_4, prof_5]: these variables represent different levels of a made up environmental parameter, the unit for these variables are in dollars.
(units: prof_X(dollars)) 

4. Missing data codes: NA, no output was collected


voi_plots.CSV

1. Number of variables: 2 

2. Number of cases/rows: 6 columns and 42 rows

3. Variable List:
[management]: this variable represents management secenarios of choosing a certain stocking density of shellfish(individuals) per meters cubed; there is no unit for this variable.
[prof_e_lo, prof_e_hi, prof_e_ave]: these variables represent three different levels of a made up environmental parameter (low, average, hi), the unit for these variables are in dollars.
(units: prof_e_X(dollars))

4. Missing data codes: NA, no output was collected



METHODOLOGICAL INFORMATION

1. Description of methods used for collection/generation of data: 

Datasets within voi_fx file were collected from the Farm Aquaculture Resource Management (FARM) model. This model is used to assess the “productivity,environmental 
effects and profitability of shellfish aquaculture” by calculating anticipated shellfish growth under the following modifiable parameters:
environmental conditions, stocking density, farm size and the number of sections, species, and grow-out period. The FARM model was chosen for 
its widespread use in the aquaculture industry, comprehensive consideration of management decisions, and flexible data extraction interface.
link: farmscale.org
The dataset was collected using the following process:
A. Each of the four environmental variables was assigned five possible levels, which we refer to as “scenarios”. The range of scenarios was selected to prioritize 
methodological clarity over exact accurate representation of conditions in B.C., but represent a reasonable range of values for these variables.
B. The model was run for each of the five environmental variable scenarios while adjusting stocking density in increments of 50 ind/m^3 ranging from 50-999 ind/m^3. 
After each iteration of the model, we extracted Total harvest (TPP).
Note: When running the model for a single environmental variable across five scenarios, all other environmental variables were held constant at baseline values. 
There was also a set of fixed variables that were kept constant under each iteration of the model running.

Datasets within basic_voi_plots were completely made up numbers for the explicit purpose of building the theoretical explanatory graphs found in section 3 and 4 of our research paper.

2. Methods for processing the data:

After raw data extraction, we converted Total harvestable biomass (tons) to expected profits assuming an average $8.50CAD/lb conversion for mussels. These profits are 
then representative of the profits associated with different levels of the different environmental parameters found in the voi_fx data sets. We then used these datasets
to generate the distribution plots in R found in the supplemental_information folder, with R code to create these plots found in software file.

3. Instrument- or software-specific information needed to interpret the data: 

Any spreadsheet system (i.e. excel) or statistical computing software (i.e. R)












