Project, Studies, and Collections - Revision history

Mmaciejewski: /* Adding Datasets and Samples to Projects, Studies, or Collections */

2025-06-20T14:17:48Z

Adding Datasets and Samples to Projects, Studies, or Collections

← Older revision		Revision as of 14:17, 20 June 2025
Line 103:		Line 103:

	== Adding Datasets and Samples to Projects, Studies, or Collections ==		== Adding Datasets and Samples to Projects, Studies, or Collections ==

			* Datasets may be associated with Projects and Samples at the time of sample collection if the Project and/or Study are selected from the NDTS GUI Experimental Details window.
			* Datasets and Samples may be placed in Projects, Studies, or Collections from the NAN Portals Data Browsers by selecting Datasets or Samples and dragging them to the appropriate location in the Hierarchal View

	== Funding Sources ==		== Funding Sources ==
	Funding sources may be added by PIs (or PI Delegates) and linked directly to Projects. When a dataset is linked to a Project, and that Project is associated with one or more funding sources, those funding relationships are inherited. This structure assists with downstream reporting, including generation of reports for funding agencies and internal accounting by NMR facilities.		Funding sources may be added by PIs (or PI Delegates) and linked directly to Projects. When a dataset is linked to a Project, and that Project is associated with one or more funding sources, those funding relationships are inherited. This structure assists with downstream reporting, including generation of reports for funding agencies and internal accounting by NMR facilities.

Mmaciejewski: /* Collections */

2025-06-20T13:32:47Z

Collections

← Older revision		Revision as of 13:32, 20 June 2025
Line 74:		Line 74:
	** Datasets and samples may also be added directly to the Study in the "''default collection''" for that Study		** Datasets and samples may also be added directly to the Study in the "''default collection''" for that Study

	=== Creating Studies ===		=== Creating / Editing Studies ===
	A Study may be created inside a Project by right mouse clicking on the Project from Hierarchal View of the Data Browser and selecting "Create Study". This brings up a dialog box that is very similar to the one used for Projects with identical fields except for Start / End dates and Funding.		A Study may be created inside a Project by right mouse clicking on the Project from Hierarchal View of the Data Browser and selecting "Create Study". This brings up a dialog box that is very similar to the one used for Projects with identical fields except for Start / End dates and Funding.

Line 84:		Line 84:

	* '''Within a Study''': Collections allow a further level of organization underneath Studies and can be created by any user with access to the parent Project.		* '''Within a Study''': Collections allow a further level of organization underneath Studies and can be created by any user with access to the parent Project.
	* '''~~Independent Use~~''': Allow individuals to organize datasets privately, even if those datasets are part of shared projects		* '''Personal Collection''': Allow individuals to organize datasets privately, even if those datasets are part of shared projects

			=== Creating / Editing Collections ===

			==== Within a Study ====

			* Right mouse click the Study from the Data Browsers Hierarchal View and select "Create Dataset Collection"
			* Fill out the form in the dialog box in much the same way as Studies discussed above.

			==== Personal Collection ====

			* Right mouse click "My Collections" from the Data Browsers Hierarchal View and select "Create Dataset Collection"
			* Fill out the form in the dialog box in much the same way as Studies discussed above.

			==== From a Multi-sample creation ====

			* If you utilize the multi-sample creation tool a personal collection will automatically be created and placed in your My Collections

	== Adding Datasets and Samples to Projects, Studies, or Collections ==		== Adding Datasets and Samples to Projects, Studies, or Collections ==

Mmaciejewski: /* Creating / Editing Projects */

2025-06-20T13:16:36Z

Creating / Editing Projects

← Older revision		Revision as of 13:16, 20 June 2025
Line 63:		Line 63:
	\|A funding source for the Project may be selected from a drop down list of pre-defined funding sources. If the funding source is not available a new one can be created using the "Create New Funding Source" button or from Lab Administration --> Project and Funding --> Funding.		\|A funding source for the Project may be selected from a drop down list of pre-defined funding sources. If the funding source is not available a new one can be created using the "Create New Funding Source" button or from Lab Administration --> Project and Funding --> Funding.
	\|}		\|}

			=== Default collection ===
			Each Project may have datasets or samples placed directly inside the Project, rather than a Study or Collection. Those datasets and samples are placed in the Projects "Default collection" which sits at the same level as Studies

	== Studies ==		== Studies ==
	Studies are mid-level containers that exist within Projects. They can be created by any user with access to the parent Project.		Studies are mid-level containers that exist within Projects. They can be created by any user with access to the parent Project.
Line 69:		Line 73:
	* Studies can contain Collections		* Studies can contain Collections
	** Datasets and samples may also be added directly to the Study in the "''default collection''" for that Study		** Datasets and samples may also be added directly to the Study in the "''default collection''" for that Study

			=== Creating Studies ===
			A Study may be created inside a Project by right mouse clicking on the Project from Hierarchal View of the Data Browser and selecting "Create Study". This brings up a dialog box that is very similar to the one used for Projects with identical fields except for Start / End dates and Funding.

			=== Default collection ===
			Each Study may have datasets or samples placed directly inside the Study, rather than a Collection within the Study. Those datasets and samples are placed in the Studies "Default collection" which sits at the same level as Collections.

	== Collections ==		== Collections ==

Mmaciejewski: /* Creating / Editing Projects */

2025-06-20T13:09:03Z

Creating / Editing Projects

← Older revision		Revision as of 13:09, 20 June 2025
Line 61:		Line 61:
	\|Funding		\|Funding
	\|no		\|no
			\|A funding source for the Project may be selected from a drop down list of pre-defined funding sources. If the funding source is not available a new one can be created using the "Create New Funding Source" button or from Lab Administration --> Project and Funding --> Funding.
	\|}		\|}
	== Studies ==		== Studies ==

Mmaciejewski: /* Creating / Editing Projects */

2025-06-20T13:05:22Z

Creating / Editing Projects

← Older revision		Revision as of 13:05, 20 June 2025
Line 62:		Line 62:
	\|no		\|no
	\|}		\|}


	== Studies ==		== Studies ==
	Studies are mid-level containers that exist within Projects. They can be created by any user with access to the parent Project.		Studies are mid-level containers that exist within Projects. They can be created by any user with access to the parent Project.

Mmaciejewski: /* Studies */

2025-06-20T13:04:19Z

Studies

← Older revision		Revision as of 13:04, 20 June 2025
Line 61:		Line 61:
	\|Funding		\|Funding
	\|no		\|no
	\|Select the Project funding source from a pull-down of pre-defined funding sources. A new funding source can be defined with the "Create New Funding Source" button or from Lab Administration --> Project and Funding --> Funding
	\|}		\|}

	*

	== Studies ==		== Studies ==

Mmaciejewski at 13:03, 20 June 2025

2025-06-20T13:03:21Z

@@ Line 5: / Line 5: @@
 == Projects ==
-[[File:Navigation-pane.png|thumb|Navigation Pane]]
+[[File:Hierarchal-view.png|thumb|Navigation Pane - Hierarchal View]]
 Projects are the top-level organizational unit and are created by a Principal Investigator (PI) or a PI Delegate. Projects features include:
@@ Line 17: / Line 17: @@
 Projects are ideal for grouping data related to a particular grant, research theme, or initiative. Associating datasets and sample with projects allows for clear attribution of funding and enables both investigators and facilities to generate accurate usage and funding reports.
 == Studies ==

Mmaciejewski: /* Collections */

2025-06-20T12:36:29Z

Collections

← Older revision		Revision as of 12:36, 20 June 2025
Line 28:		Line 28:
	Collections are containers that serve two purposes:		Collections are containers that serve two purposes:

	* '''Within a Study''': Collections allow a further level of organization underneath Studies		* '''Within a Study''': Collections allow a further level of organization underneath Studies and can be created by any user with access to the parent Project.
	* '''Independent Use''': Allow individuals to organize datasets privately, even if those datasets are part of shared projects		* '''Independent Use''': Allow individuals to organize datasets privately, even if those datasets are part of shared projects

Mmaciejewski at 20:23, 10 June 2025

2025-06-10T20:23:39Z

← Older revision		Revision as of 20:23, 10 June 2025
Line 1:		Line 1:
			{{LabAdmin}}

	== Overview ==		== Overview ==

Mmaciejewski at 16:46, 29 May 2025

2025-05-29T16:46:39Z

← Older revision		Revision as of 16:46, 29 May 2025
Line 1:		Line 1:

	== Overview ==		== Overview ==
	NAN provides a structured, hierarchical approach to organizing NMR data in the Data Browser which is accessible from the [[Datasets#Navigation Pane\|Navigation Pane]].		NAN provides a structured, hierarchical approach to organizing NMR data (datasets and samples) in the Data Browser which is accessible from the [[Datasets#Navigation Pane\|Navigation Pane]]. This allows datasets and samples to be organized in a hierarchal manner similar to how users organize data on a file system.

	== Projects ==		== Projects ==
Line 8:		Line 8:

	* The ability to link to one or more funding sources (e.g., NIH, NSF)		* The ability to link to one or more funding sources (e.g., NIH, NSF)
	* Serving as containers for ~~datasets, studies~~, and ~~collections~~		* Serving as containers for Studies, and Collections
	** Datasets added ~~at the~~ Project ~~level appear~~ in the "''default collection''" for that Project		** Datasets and samples may also be added directly to a Project in the "''default collection''" for that Project
	*The ability to grant all lab-group users access to the Project or to apply fine-grain access control to the Project data		*The ability to grant all lab-group users access to the Project or to apply fine-grain access control to the Project data

	* Allowing the Project and Study to be selected at the time of data collection through the NDTS GUI		* Allowing the Project and Study to be selected at the time of data collection through the NDTS GUI
			** Data can be later organized into Projects, Studies, and Collections through the Data Browser

	Projects are ideal for grouping data related to a particular grant, research theme, or initiative. Associating datasets with projects allows for clear attribution of funding and enables both investigators and facilities to generate accurate usage and funding reports.		Projects are ideal for grouping data related to a particular grant, research theme, or initiative. Associating datasets and sample with projects allows for clear attribution of funding and enables both investigators and facilities to generate accurate usage and funding reports.

	== Studies ==		== Studies ==
Line 20:		Line 21:

	* Each Study belongs to a single Project		* Each Study belongs to a single Project
	* Studies can contain ~~datasets and~~ Collections		* Studies can contain Collections
	** Datasets added at the Study ~~level appear~~ in the "''default collection''" for that Study		** Datasets and samples may also be added directly to the Study in the "''default collection''" for that Study

	== Collections ==		== Collections ==
	Collections are ~~flexible~~ containers that serve two purposes:		Collections are containers that serve two purposes:

	* Within a Study: Collections ~~group datasets that share~~ a ~~specific context, such as replicates or multi-condition experiments.~~		* '''Within a Study''': Collections allow a further level of organization underneath Studies
	* Independent Use: Any user can create personal collections accessible from '''~~My Collections~~'''~~. These allow~~ individuals to organize datasets privately, even if those datasets are part of shared projects.		* '''Independent Use''': Allow individuals to organize datasets privately, even if those datasets are part of shared projects

	~~Key points about collections:~~		== Adding Datasets and Samples to Projects, Studies, or Collections ==

	* Collections can be nested inside studies or used independently.
	* Collections can only contain datasets the user already has permission to view.
	* Datasets ~~added~~ to ~~personal collections retain the PI-defined permission model—they do not become private~~ or ~~public by virtue of the collection.~~

	== Funding Sources ==		== Funding Sources ==
	Funding sources may be added by PIs and linked directly to Projects. ~~Each funding source includes fields such as:~~		Funding sources may be added by PIs (or PI Delegates) and linked directly to Projects. When a dataset is linked to a Project, and that Project is associated with one or more funding sources, those funding relationships are inherited. This structure assists with downstream reporting, including generation of reports for funding agencies and internal accounting by NMR facilities.

	* Agency and Institute (e.g., NIH/NIGMS)
	* Grant number
	* PI and Co-PI names
	* Abstract, start and end dates, and optional URL

	When a dataset is linked to a Project, and that Project is associated with one or more funding sources, those funding relationships are inherited. This structure ~~supports~~ downstream reporting, including generation of reports for funding agencies and internal accounting by facilities.

	~~== Summary ==~~
	~~Together, Projects, Studies, Collections, and Funding Sources provide a scalable and intuitive structure for organizing NMR data in NAN:~~

	* Projects group datasets at the lab/grant level.
	* Studies subdivide projects into experimental or thematic areas.
	* Collections bundle related datasets, either collaboratively or privately.
	* Funding sources tie datasets to their financial support, improving accountability and reporting.

	~~This structure parallels a traditional file system, making it intuitive for users while supporting robust metadata tracking and analysis across the NAN platform~~.