Go to the Bulk Uploader (https://data.pointblue.org/science/projectmanager/bulk_uploader), select your project (you will only see projects that you have access to).
...
Choose the Add Observations tab.
If this is your first time using this tool to upload data of a particular type and protocol
Select “Get a blank Template to fill out” and “Point Count”, then select a Protocol and Site Condition Protocol. Note, the Protocols must already exist in the Project before they will show up in the list. If you need a new protocol added, please submit a request to support@pointbluehelp.zendesk.com.
Select a layout style for your observation data: Standard, By Distance Bins, or By Time Bins. See XXX for graphics that demonstrate the different format choices using the same dataset. All three format options result in the same data presentation in Biologists.
Standard is formatted as one record per unique combination of species, detection cue, distance bin, time bin, breeding status, and singing indicator.
Distance Bins is formatted as one record per unique combination of species, detection cue, time bin, breeding status, and singing indicator. Counts for each distance bin in the protocol are entered as separate fields in the same record.
Time Bins is formatted as one record per unique combination of species, detection cue, distance bin, breeding status, and singing indicator. Counts for each time bin in the protocol are entered as separate fields in the same record.
NOTE: Site condition protocol data are formatted and entered the same regardless of what layout style is selected for the observations.
Download CSV and YAML files. These files are custom-generated based on the Protocol and Site Condition Protocol you selected above.
Populate a CSV file with your observation data in one of the three accepted formats. The top row of headers in the template defines what should be in each column. The second row of headers is required for the YAML to process the file. If you wish to change the name of a header, you will need to change the corresponding line in the YAML file. However, in most cases, the YAML file should not need to be modified.
TODO: Create documentation for YAML modification.
Note 1: All entries must match the field definitions defined by the protocol. See Protocol Search for valid codes to use for the protocol-specific fields. For example, for the following protocol definition (VCP25_150), the distance bin values you must enter in your csv file are L25, L50, L75, G00, B00, B20, B50, or FLO.
Note 2: The field No Animals Observed will override ALL observations if set to “y” or “x”. The observation data will not be loaded, but site condition data will load.
Upload your data by
Selecting “Bulk upload datafile.”
Selecting your populated CSV file to upload.
Selecting the YAML file that corresponds to your CSV file.
Selecting “Process” to upload the data.
Results will be displayed. Review these carefully to make sure both site conditions and observations loaded. You can also go into Biologists to confirm the data uploaded and is correct.
If there is a problem with your data preventing it from loading, you will see an error message detailing the issue and what line it first occurs on.
Note: If your observation count shows 0 in Biologists or in the Results screen of Bulk Uploader, but the site conditions loaded, it may be easiest to verify that the No Animals Observed field is set correctly; this field will override all other observational data and cause nothing to load. If you expected the observations to load, delete the sampling event with the partial dataset from Biologists, correct the No Animals Observed field, and then upload files for again. It can also be helpful to test just the observation protocol . This will force an informative error message identifying which field value is not being accepted by Bulk Uploader. If a partial upload succeeds, any error messages will be suppressed.data without site conditions.
Data format examples:
Standard format example
...