# Manage Project Data

ESS-DIVE project management features allow principal investigators (PIs) to access and edit information about their project, assign other project data managers, create teams of project members, and share permissions to datasets and data portals with teams.

**Project management is not set up by default for any project.** Principal Investigators (PIs) must set up project management on ESS-DIVE, using the [recommended workflow](#summary-workflow-for-pis-to-set-up-project-management) below. &#x20;

## Discover Project Management Features

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td></td><td><strong>Project List</strong></td><td>Check that your project is on this list, your project name is correct, and the PI list is up-to-date</td><td><a href="#project-list">#project-list</a></td><td><a href="https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2Fo6157zsh1akDzxcaD3Se%2FProject_List.png?alt=media&#x26;token=10d4bdac-cce1-4157-b0e3-0cde68dbd5c3">Project_List.png</a></td></tr><tr><td></td><td><strong>Project Data Managers</strong></td><td>Gain access to additional information about your project and access the Project Teams feature</td><td><a href="manage-project-data/project-data-managers">project-data-managers</a></td><td><a href="https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2Fob6gUMUsEWfLBYyNZCLQ%2FData_Manage_Page.png?alt=media&#x26;token=28712d9e-b766-4901-87d7-0a1e9f34f6b0">Data_Manage_Page.png</a></td></tr><tr><td></td><td><strong>Project Teams</strong></td><td>Create a team of project members on ESS-DIVE and  share datasets or data portals with your team</td><td><a href="manage-project-data/project-teams">project-teams</a></td><td><a href="https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2FpZg2IW9YjVPuPstDsU98%2Fteam_multiple_datasets.png?alt=media&#x26;token=a0c6fd4e-b780-4016-be90-3d8be5da7c31">team_multiple_datasets.png</a></td></tr><tr><td></td><td><strong>Project Data Portals</strong></td><td>Create a collection of all project datasets on ESS-DIVE</td><td><a href="why-use-data-portals">why-use-data-portals</a></td><td><a href="https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgU7GrufgIOpY1Ufd5R%2F-Mj1dnqzGlOoV5bJJSgt%2F-Mj1enr7nBO4hjuyKbkT%2Fpublic-portals-list.png?alt=media&#x26;token=9417f874-9159-408a-af03-9182efd81b85">public-portals-list.png</a></td></tr><tr><td></td><td><strong>Share with Teams</strong></td><td>Grant your project teams permission to edit datasets and data portals</td><td><a href="project-teams#share-project-data-with-teams">#share-project-data-with-teams</a></td><td><a href="https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2FUo9Mmxtx3ES2lq4cSoSw%2Fsearching_for_team_whole_window.png?alt=media&#x26;token=108caf39-80b4-4ef5-8309-c1bddf69b23d">searching_for_team_whole_window.png</a></td></tr></tbody></table>

{% hint style="info" %}
**These features are still in development and will be continually updated until Fall 2023.** \
\
[Subscribe to ESS-DIVE's newsletter](https://lbl.us2.list-manage.com/subscribe?u=4a9433904c29fa74aa1127282\&id=b6d9f8dc07) to receive announcements about our latest updates.
{% endhint %}

## Summary workflow for PIs to set up project management

Here we provide a summary of how to get setup with project data management on ESS-DIVE, with links to additional information contained in this page.

1. Make sure your project is in ESS-DIVE's [**project list**](#project-list)**.**
2. Become (or check whether you already are) a [**project data manager**](https://docs.ess-dive.lbl.gov/manage-data/manage-project-data/project-data-managers)**.**
   * If you are a PI for multiple projects, you'll need to become a data manager for each
3. [**Assign additional data managers**](https://docs.ess-dive.lbl.gov/manage-data/project-data-managers#how-to-add-project-data-managers) to your project (if applicable).
   * Visit [**your project page**](https://docs.ess-dive.lbl.gov/manage-data/project-information#project-information-page) to make sure the list of data managers is correct
4. Create a [**team**](https://docs.ess-dive.lbl.gov/manage-data/project-teams#how-to-create-teams) for your project data managers (if applicable).
   * Name it carefully using our [**recommended rules**](https://docs.ess-dive.lbl.gov/manage-data/project-teams#rules-for-naming-teams) (e.g. "\<project-name>-data-managers")
   * Add all project managers to this team&#x20;
   * Make all project data managers owners of this team&#x20;
5. Tell your data contributors to [**share**](https://docs.ess-dive.lbl.gov/manage-data/project-teams#share-project-data-with-teams) any new datasets that they create with one or more specific team(s) that you want to have access to project datasets now and in the future.
6. Consider creating a [**data portal**](https://docs.ess-dive.lbl.gov/manage-data/why-use-data-portals) for your project data. While not a requirement, it will allow you to view all of your project datasets in one place.

## [Project List](https://data.ess-dive.lbl.gov/projects)

ESS-DIVE provides a searchable list of projects that are approved to store and publish data on ESS-DIVE, including all projects funded by the Department of Energy's (DOE) [Environmental System Sciences (ESS) program](https://ess.science.energy.gov/program/).&#x20;

Find your project by searching for the official project title, project short name, or principal investigator (PI) name (Figure 1). An explanation of the project information is listed in Table 1 below.&#x20;

Your project will only appear on this page if it is approved to create and publish datasets on ESS-DIVE. **If you do not see your project, please email ESS-DIVE Support at** [**ess-dive-support@lbl.gov**](mailto:ess-dive-support@lbl.gov)**.**

<figure><img src="https://3166205607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgU7GrufgIOpY1Ufd5R%2Fuploads%2FNfB9KJN8QdeJaRuhcxNt%2Fproject-list-logged-in-v2.png?alt=media&#x26;token=dab3cbc3-5ab4-47dd-9ad9-a51f55ffbefa" alt=""><figcaption><p>Figure 1: A preview of ESS-DIVE's project information page after login with an ORCID.</p></figcaption></figure>

{% hint style="info" %}
PI information is not visible without sign-in. [Login to ESS-DIVE](https://docs.ess-dive.lbl.gov/contributing-data/new-contributor-registration#1.-login-to-ess-dive-using-orcid) using your ORCID to view PI information.
{% endhint %}

<table data-header-hidden><thead><tr><th width="273"></th><th></th></tr></thead><tbody><tr><td><strong>Project Title</strong></td><td>Default title submitted to the ESS program at the time funding was awarded. This title is used in dataset citations.<br><br>PIs can update their project title by contacting ESS-DIVE Support at <a href="mailto:ess-dive-support@lbl.gov">ess-dive-support@lbl.gov</a>. Changes to the project title will be reflected in dataset citations. We do not recommend changing the project title, unless required, as this will impact the ability to search and filter by project name and dataset citations.</td></tr><tr><td><strong>ESS-DIVE Project Identifier</strong></td><td>Unique identifier assigned to all projects, which will never change. You will need this identifier when <a href="../programmatic-tools/ess-dive-dataset-api">submitting datasets using the API</a>.</td></tr><tr><td><strong>Principal Investigator (PI)</strong></td><td><p>Default lead principal investigator(s) associated with the project submitted to the ESS program at the time funding was awarded.</p><p></p><p><strong>PI information does not automatically update.</strong> If your PI has changed, update project PI information by contacting ESS-DIVE Support at <a href="mailto:ess-dive-support@lbl.gov">ess-dive-support@lbl.gov</a>. ESS-DIVE will not retroactively update PI info in published datasets.</p></td></tr></tbody></table>

*Table 1. List of all project information fields that are available via ESS-DIVE's project information page.*

## Frequently Asked Questions

<details>

<summary>Why can't I see any project management features?</summary>

For now, project management features are only available to *project data managers*. Only PIs, co-PIs, and project members who received approval from their PI can become project data managers.

To become a data manager, you must first register as an ESS-DIVE *data contributor*. If you are a PI, but can't see the project management features you either are not a data contributor yet or only recently became a data contributor and have yet to inform the ESS-DIVE Team that you are ready to become a project data manager.&#x20;

Make sure you complete all steps outlined in [How do I become a project data manager?](https://docs.ess-dive.lbl.gov/manage-data/project-data-managers#how-to-become-a-project-data-manager)

\
If you are a **member of an ESS-DIVE project** but you are **not** a project data manager, then the *My Projects* page and all it's features will not be accessible to you.&#x20;

</details>

<details>

<summary>What are the different kinds of roles available on ESS-DIVE?</summary>

* **ESS-DIVE user:** Someone who logged into ESS-DIVE using their ORCID.&#x20;
* **Data Contributor**: An ESS-DIVE user who was approved by ESS-DIVE to upload data; they can create, edit, and publish datasets.
* **Project Data Manager**: A data contributor approved by a project PI to create and manage teams for that project.
* **Teams**: A group of ESS-DIVE users who share access permissions to datasets and data portals.
* **Team Owner:** A "starred" team member who has permission to add or remove individuals from teams. They can assign new team owners or remove existing ones. By default the project data manager who created the team is a team owner.

</details>
