Setting up a SESAR User Account

Whether you are a single researcher or the PI of a research team, the steps for creating a SESAR User Account are the same:

  1. Create a GeoPass Account
  2. Login to MySESAR.
  3. Select a User Code for your account.

 

If you are a member of a research team, you can create your own User Code or wait for your PI to grant your account access to use the lab’s user code using your Geopass email. Access to the lab’s user code can be found in the “My Account” tab of MySESAR. 


Selecting a SESAR User Code (IGSN namespace)

User Codes are a tool that researchers can use to aid in documentation and curation of their samples. MySESAR supports multiple User Codes for each user.  User Codes begin with IE and are followed by 3 letters and/or numbers of your choosing (IEXXX0001). Users Codes are not case sensitive. Common User Codes are initials or abbreviations of a large project.

When you create a MySESAR User Code it is important to keep in mind what samples will be registered with that User Code. For example, Unique User Codes can be used to represent

  • Personal vs lab group sample
  • Different projects or grants
  • Different field sessions 

Managing Shared Samples

There may be instances where someone other than yourself needs to register a sample with one of your User Codes, (ex. student). To allow others to register samples with one of your User Codes you need to grant permissions for the user. Permissions can range from ‘Read’ only to ‘Create, Read, Edit, or Delete’ samples. To add permissions:

  1. Access the “View/Edit User Code Permissions” tab of the “My Account” page in MySESAR.
  2. Select the user code you want to grant permissions for.
  3. Input the GeoPass ID for the individual you want to grant permissions to
  4. Choose your level of permission.
  5. Select Activation and Deactivation date for permission (Do not select a deactivation date if you want permissions to be permanent).

Metadata Submission and IGSN Registration Workflow

A sample should be registered in SESAR as early as possible after collection so its IGSN can be put on its label. You can also pre-register samples in SESAR before going out into the field.  This allows you to print labels in advance of sample collection.  See section below on ‘Registering samples with IGSN before collection’ for more information.

 

If you are registering legacy collections or existing collections, it is best to create a registration plan that divides the collection into groups that share common traits. These traits could be sample type, project, field session or year. Any samples that have produced sub-samples should be registered first so that SESAR can capture the parent/child relationship of the samples. See the below section for more information regarding parent/child relationships.

Authorization to register a sample

In order to register a sample with SESAR, you should be the “owner” of that sample. For example,  you are the collector of the sample or the principal investigator for the field program that collected the sample and stored the sample. For the “Site” object type this means that you were the principal investigator for a project located at that field site.

In some cases, you may not be the original collector of a sample or collection of samples but you have been transferred permanent ownership. If the sample is registered in SESAR the previous owner should transfer you ownership of the sample via the “Transfer ownership” tab in MySESAR. If the sample was not registered in SESAR, you should register the sample in SESAR. In both cases, you should update the “Original Archive” and “Original Archive Contact” to be the previous owner and update “Current Archive and “Current Archive Contact” to be yourself.

If there are samples you want to register with SESAR, but you are not the owner of the sample you should contact the owner of the sample and request that they register their samples with SESAR.

 

Registering IGSNs before samples are collected

It is possible to pre-register samples and obtain IGSNs before collecting samples in the field. This allows for samples to have corresponding IGSNs immediately upon collection. To preregister samples

  1. Follow the tutorial to Complete a Batch Registration Template, when it is time to upload your batch registration template to SESAR you must input ‘Object Type’ and ‘Sample Name’ but can leave all other fields blank.
  2. Print labels that contain the IGSNs to label samples as they are collected.
  3. After collection, update the samples metadata, including ‘Sample Name’ and location information via the Batch Update Method.

If you register more IGSNs than samples you collect in the field, you should save these IGSNs for your next field session.

Registering Samples After Collection

After you have collected samples in the field you can register your samples’ metadata in SESAR using one of our registration methods. We recommend that you register your samples with IGSNs before processing and analyzing the samples and as close to the time of collection as possible.

Updating Sample Metadata

It is possible you will want to add or update sample metadata after registering them in SESAR (ex. Adding a publication DOI or updating classification). To update or add new metadata use the Batch Update Method.

You have the ability to add up to 5 related URLs to a sample’s metadata profile. You can add urls through the sample edit feature on the “My Samples” page of MySESAR. You can also add URLs through the Batch Update Method. To add URLs via the Batch Update Method you can only add one URL per batch update, but can add urls until the sample has 5 related URLs.

Deactivating Samples

If you want to remove a sample from SESAR

  1. Click the “Request deletion of this sample” button on the bottom of the sample’s metadata profile page.
  2. Fill out the form and give a reason for deactivating the sample.

SESAR deactivates samples instead of deleting them because it is possible the IGSN was referenced somewhere in the past. The metadata profile page for the sample will still resolve, but there will be no sample metadata present and there will be text stating that the IGSN has been deactivated.

Registering Samples with Web Services 

SESAR provides REST web services that allow fast registration of large numbers of samples. Access to SESAR’s REST web services is limited to ensure quality of sample metadata. If you are interested in using web services please see our technical documentation (SESAR GitHub) and ensure that you have a GeoPass Account.

If you or your institution did not have access to SESAR’s REST web services prior to SESAR v7.5 (May 2021) you must apply for access to SESAR’s REST web services. When you request access to SESAR’s REST web services, a curator will work with you to ensure that the samples you will register have quality mapping of metadata. The form to request access for SESAR’s REST web services can be found in our technical documentation (SESAR GitHub).

Hierarchical Sample Relationships

Many objects that are sampled from the Earth yield subsamples. For example, sediment cores may be sampled at regular intervals creating hundreds of individual samples from one core. This relation among samples is considered a parent-child relationship in the world of data management: sub-samples are children of a parent sample. Subsamples can be sampled themselves, leading to complex hierarchies.

SESAR has been designed to record the relationship between samples and sub-samples. Subsamples have their own entry in the SESAR registry and have independent IGSNs. The parent-child relationship is established by recording the IGSN of the parent in the child metadata profile. A parent sample must be registered with an IGSN before it can be listed as the parent of any child samples.

By adding a ‘Parent IGSN’ to a sample, the metadata profile page of the newly registered sample will show that it is a sub-sample of the sample that was listed in the ‘Parent IGSN’ field. The metadata profile page will also show all other samples (siblings) that share the sample parent sample. The metadata profile page of the sample whose IGSN was listed in the ‘Parent IGSN’ of the newly registered sample will also show that the newly registered sample is a sub-sample (child) of it.

Embargoing Samples

SESAR follows the National Science Foundations guidelines of allowing sample metadata to be embargoed for up to 2 years from the date of registration. 1 month before your embargo period ends, you will receive an email from SESAR notifying you that the embargo on your sample metadata will soon end.

If you embargo your sample metadata, we recommend that you use a release date that matches the publication date of a related manuscript.

 

Making your samples Discoverable and Shareable

The best way to make your samples discoverable within the SESAR Catalog is providing as much sample metadata as possible. Important fields to include are location, sample type, classification, and archive.

Samples can also be made more discoverable to the broader research community by listing sample IGSNs in your manuscripts. Publishers can link IGSNs to their sample metadata profile pages so readers can see all sample metadata. (AGU, GSA, Wiley, Elsevier, Copernicus)


Transferring Ownership of Samples

If you are receiving or donating samples to another scientist or institution (ie. repository or collection) SESAR provides a way to transfer ownership of the associated SESAR records. 

For samples that have already been registered, 

  1. The current owner should use the “Transfer Ownership” tab of MySESAR to transfer ownership of the specific samples 
  2. The new owner should update the sample’s metadata profile to contain the new owner as the “Current Archive” and “Current Archive Contact” and list the previous owner as the “Original Archive” and “Original Archive Contact”.

 

For samples that have not been registered with IGSNs

  1. The new owner should register the samples using their User Code. 
  2. The new owner should update the sample’s metadata profile to contain the new owner as the “Current Archive” and “Current Archive Contact” and list the previous owner as the “Original Archive” and “Original Archive Contact”

Crediting SESAR

Registering your samples with SESAR contributes to the National Science Foundations mission of open access to data and allows your samples to be discovered beyond your personal or institutional catalog.  The National Science Foundation allows for researchers to budget expenses for the preparation of research data for distribution. (NSF Proposal and Award Policies and Procedures Guide Chapter II.C.2.g.(vi).b)

Below is sample language on registering and managing samples with SESAR which can be incorporate into your grant proposals :

“Samples will be registered in SESAR with International GeoSampling Numbers to ensure the preservation of sample metadata and to promote open access of data. Registering the samples in SESAR also provides an easy way to share sample metadata with my collaborators and contributes to a culture of sample sharing, which can help me discover new, relevant samples and promote new collaborations.”


Incorporating SESAR into your Grant Proposals

Please, acknowledge SESAR as the metadata repository for your samples in your FAIR and accessible data statement or the acknowledgements of your publication. An example statement which credits SESAR is as follows:

“To ensure the accessibility and discoverability of the samples used in this research, and to align with the National Science Foundation’s guidelines of effective data practices, all samples used in this study have been registered with IGSN Global Sample Numbers  through the System for Earth Sample Registration (SESAR). SESAR is maintained by the GeoInformatics Research Group of the Lamont-Doherty Earth Observatory. https://www.geosamples.org/ Accessed DAY MONTH YEAR”


External Resources for Sample Management

EarthChem Library

The EarthChem Library is an open access repository for geochemical datasets. The EarthChem Library provides services for data preservation and access, including archiving and registration of data with Digital Object Identifiers (DOIs). IGSNs of samples used to produce a dataset are linked on the EarthChem Library metadata profile page of the dataset and link to the samples SESAR metadata profile.

ezDMP

ezDMP is an online service that helps you create Data Management Plans that can be incorporated into your National Science Foundation Grant Applications


Labelling Samples

The IGSN can be used as a label for samples that allows for unambiguous naming and persistent access to information about the sample. MySESAR provides label printing services that contain the sample name, IGSN, QR code linking to the sample metadata profile page and customizable additional metadata fields. Information on how to print labels can be found here. Preregistering IGSNs and printing labels before field work is an effective way to ensure unambiguous tracking and metadata assignment from the moment the samples are collected.


Citing IGSNs in Publications

SESAR asks its users to include IGSNs in their manuscripts. This allows publishers to link the IGSN sample metadata profile pages to the manuscript. Tagging IGSNs in manuscripts aligns with the National Science Foundations commitment to FAIR data as well as publishers such as AGU, GSA, Wiley, Elsevier, Copernicus.

Use the following syntax to tag an IGSN

IGSN: <SSH000SUA>

In the published manuscript the IGSN may look like :

IGSN: SSH000SUA

Below is an example of a published manuscript with IGSNs

Dere, A. L., T. S. White, R. H. April, B. Reynolds, T. E. Miller, E. P. Knapp, L. D. McKay, and S. L. Brantley (2013), Climate dependence of feldspar weathering in shale soils along a latitudinal gradient, Geochimica et Cosmochimica Acta, 122, 101-126, http://dx.doi.org/10.1016/j.gca.2013.08.001.