# HCP collection
This is a data project to facilitate collecting documents and data on Habitat Conservation Plans authorized under section 10(a)(1)(b) of the U.S. Endangered Species Act.
## Getting started
### 1. Find the folder corresponding to your HCP in _Google Drive: HCP_collection_
Either use the Filter to try to find some part of the HCP name:
![Use the Filter][1]
<br>
or use the [Excel workbook](https://osf.io/r45np/) that links HCP names (as given in ECOS) to folder names here in OSF:
![Use the worksheet][2]
### 2. Upload HCP files to the new folder
- Either drag-and-drop or choose the `Upload` button from the Files section.
- As noted in the FOIA request, all data and documents about the HCPs is ideal, but time or resource constraints may require prioritization. In that case, the order of interest in different document types is:
1. The HCP itself, the biological opinion, and the ITP(s) associated with the plan;
2. Any spatial or non-spatial data files;
3. ...
- Please [contact us](mailto:esa@defenders.org) if you have files that are too large to be uploaded or if you run into other issues.
## More info
We have created one folder for all of the 1,256 HCPs we could find information through the HCP portal and from species' pages on ECOS.
- Folders are named with the planID used in ECOS, followed by '-', then up to the first 25 characters of the name of the HCP.
- We removed or replaced certain characters in the file names, e.g., '&' were removed and '#' were replaced with 'no'.
- The Excel workbook also includes the URL for the HCP's page on ECOS; you can visit that page for info that might help finding the folder here on OSF.
- If the folder simply doesn't exist, please:
- create a new folder named `9999-<short_name>`, where the `<short_name>` is a very brief descriptive name for the HCP;
- Upload HCP files as noted above; and
- Please add a short note in the folder that gives the full name of the HCP and your contact information.
## Questions / Issues
If you have any questions about how to add files, or if you run into any problems, please [email us](mailto:esa@defenders.org).
[1]: https://mfr.osf.io/export?url=https://osf.io/9wnyb/?action=download%26direct%26mode=render&initialWidth=774&childId=mfrIframe&format=1200x1200.jpeg
[2]: https://mfr.osf.io/export?url=https://osf.io/dp7t2/?action=download%26direct%26mode=render&initialWidth=774&childId=mfrIframe&format=1200x1200.jpeg
