(IAD) Web Service - Earth and Planetary Remote Sensing Laboratory
Contents
1. lt orcid_id gt O000 0002 8924 3894 lt orcid_id gt lt creators_detail gt lt creatorsblock gt lt publisher gt Southeast Fisheries Science Center National Marine Fisheries Service NOAA lt publisher gt lt publication_date gt 06 14 2012 lt publication_date gt lt site_url gt http www sefsc noaa gov species turtles lt site_url gt lt product_type_specific gt Survey Data lt product_type_specific gt lt product_nos gt SFSC232012 lt product_nos gt lt description gt This survey reports the results of the 2012 effort to log existing tag numbers of endangered sea turtles and to also assign new IDs to untagged sea turtles This survey is conducted annual along Florida s Atlantic Coast between Jacksonville and the southernmost boundary of Dade County lt description gt lt keywords gt Protected Species lt keywords gt lt related_resource gt Working the Sea Turtle Survey Jesse D Johnson and Arnold Imagined Resource Watch Volume 34 Issue 10 2013 lt related_resource gt lt contributor_organizations gt Florida Atlantic University lt contributor_organizations gt lt sponsor_org gt National Oceanic and Atmospheric Administration NOAA lt sponsor_org gt lt contract_nos gt lt contract_nos gt lt other_identifying_nos gt lt other_identifying_nos gt lt file_extension gt txt lt file_extension gt lt availability gt lt availability gt lt contact_name gt Sheila Jones lt contact_name gt lt contact_org2. CXIDB dataset Coherent X ray Imaging Data Bank Y 4 ata Sponsors Contact Us Home Mission CXI File Format Browse Dat CXIDB ID 5 Citation Details Title High resolution x ray diffraction microscopy of specifically labeled yeast cells Description Authors Johanna Neison et al This is the second of five Journal PNAS exposures of the same sample at Year 2010 different tilts This one is at 15 DOI doi 10 1073 pnas 0910874107 degrees tilt Experimental Conditions Check CXI IDs 4 to 8 for the complete set Method Single Particle X ray Diffraction Imaging Sample Gold labeled frozen dried Saccharomyces cerevisiae yeast cells Wavelength 1 653 nm Deposition Summary Johanna Nelson Depositor Contact jinelson slac stanford edu Deposition date 2011 07 22 Last modified 2011 07 22 2014 CXIDB All rights reserved Designed by Filipe Maia based on Zenlike Page 12 of 13 ZECART Home People Site Index Search arm gov B iT OF SS gt CUMATE RESEARCH FACIUTY r NERGY gea news ESAS ARM gov gt gt Data gt gt Instrument Datastreams gt gt aoscpc Documentation Data Quality Plots Office of Science Datastream AOSCPC AOS condensation particle counter Active Dates 2011 03 09 2013 07 14 Citation Measurement Categories Aerosols y What is this Originating Instrument Aerosol Observing System AOS m GENERATE
3. gt NOAA SFSC lt contact_org gt lt contact_email gt jones sfsc noaa gov lt contact_email gt lt contact_phone gt 893 987 5436 lt contact_phone gt lt record gt lt records gt Sample of a new XML record to be POSTED Record names three creators Pls Only one has an ORCID the other two do not However if any creator Pl in a record has an ORCID the ORCID related fields lt creatorsblock gt etc must be used in that record lt xml version 1 0 encoding UTF 8 gt lt records gt lt record gt lt title gt Repetitive Flu like Episodes Data Comparisons from Ten Western States lt title gt lt creatorsblock gt lt creators_detail gt lt first_name gt Amy lt first_name lt middle_name gt J lt middle_name lt last_name gt Askins lt last_name gt lt affiliation gt CDC lt affiliation gt lt private_email gt askinsa cdc gov lt private_email gt lt orcid_id gt lt orcid_id gt lt creators_detail gt lt creators_detail gt Page 10 of 13 lt first_name gt Horace lt first_name lt middle_name gt lt middle_name lt last_name gt Bart lt last_name gt lt affiliation gt Los Angeles Health Department lt affiliation gt lt private_email gt lt private_email gt lt orcid_id gt O000 0001 8123 0763 lt orcid_id gt lt creators_detail gt lt creators_detail gt lt first_name gt Marcus lt first_name lt middle_name gt D lt middle_name lt last_name gt Welby lt last_name gt lt affi
4. of these smaller sets of multiple files On the other extreme a dataset may also be as simple as a spreadsheet Datasets are not always numeric in nature A computer model and sets of canned input could be a dataset while each of the simulations or output files could be assigned their own DOls A collection of photographs or a graphic of a workflow can be registered as a dataset Interactive resources or audiovisual items may be assigned DOls Data studies can be registered also these may include a variety of materials associated together as a package Subject expertise and knowledge of how your audiences normally look for your data will help you determine the appropriate content and boundaries of the datasets that you intend to register OSTI can provide advice and share examples of best practices but granularity decisions are ultimately the responsibility of the people who know the data best i e the creators the analysts or the data center experts at your submitting organization IAD s Digital Object Identifier DOI Each time a new submitting entity becomes an IAD data client OSTI requests from DataCite a numeric prefix which will belong only to that one specific entity A data client may be an entire agency or a center or office within the agency an observatory or other facility or even one specific project DataCite and IAD ensure that no two data clients will ever have the same DOI prefix A DOI con
5. CITATION Measurements Only measurements considered scientifically relevant are shown below by default C Show all measurements BUILD AN ORDER LS CY vorbe Aerosol concentration parts cc concentration time Comments Particle concentration We would love to hear from you Send us a note below or call us at 1 888 ARM DATA Locations North Slope Alaska NSA Southern Great Plains SGP amp ARM Mobile Facility PGH ARM Mobile Facility PVC Email Address Comments Page 13 of 13
6. Interagency Data Web Service Manual Version 2 0 May 2014 Interagency Data IAD Web Service 1 About the IAD 1 1 General Requirements 1 2 Understanding Key Components 1 3 Getting Started 2 Using the IAD 2 1 Authentication 2 2 POST Submit Update and GET Retrieve 2 3 Response and Notifications from IAD 3 IAD s Metadata Fields 3 1 Required Metadata 3 2 Optional Metadata 4 Appendices 4 1 Sample XML records 4 2 Sample Landing Pages 1 0 About the IAD OSTI s Interagency Data IAD Web Service allows U S federal agencies to obtain persistent identifiers known as Digital Object Identifiers DOIs for datasets and ensures that the DOls are properly registered with DataCite The Office of Scientific and Technical Information OSTI became a member and an allocating agency for DataCite in 2011 OSTI can assign DOIs to the Department of Energy through its Data ID Service and to other U S agencies through a similar web service the IAD IAD provides an easy to use mechanism to submit edit or retrieve registration records Users can manipulate records by performing HTTP operations on the web service URL and providing XML metadata to create update records POST or to retrieve records for review GET Submitting agencies agree to ensure data persistence which includes storing and managing their registered datasets such that access and usability are provided indefinitely The URL as
7. ace Gas Fluxes lt keywords gt lt related_resource gt lt related_resource gt lt contributor_organizations gt lt contributor_organizations gt lt sponsor_org gt National Aeronautics and Space Administration NASA U S Centro de Previsao de Tempo e Estudos Climaticos Brazil Instituto Nacional De Pesquisas Espaciais Brazil Instituto Nactional de Pesquisas da Amazonia Brazil lt sponsor_org gt lt contract_nos gt lt contract_nos gt lt other_identifying_nos gt lt other_identifying_nos gt lt file_extension gt dat lt file_extension gt lt availability gt ORNL DAAC lt availability gt lt contact_name gt J Smith lt contact_name gt lt contact_org gt ORNL DAAC lt contact_org gt lt contact_email gt smith daac ornl gov lt contact_email gt lt contact_phone gt 865 497 3155 lt contact_phone gt lt record gt lt records gt Sample of a new XML record to be POSTED Record names one creator PI who happens to have an ORCID ID and uses the ORCID related fields lt xml version 1 0 encoding UTF 8 gt lt records gt lt record gt lt title gt 2010 Survey Endangered Sea Turtles Florida Atlantic Coast lt title gt lt creatorsblock gt lt creators_ detail gt lt first_name gt Jesse lt first_name lt middle_name gt D lt middle_name lt last_name gt Johnson lt last_name gt Page 9 of 13 lt affiliation gt NOAA lt affiliation gt lt private_email gt lt private_email gt
8. aken such as May 01 2002 December 31 2002 geographic information such as a specific state region country latitude and longitude etc information such as temperature ranges etc The abstract length should be no more than 5 000 characters Note The ampersand amp character is not XML compliant All ampersands should be sent as amp amp Keywords Subject Terms or Topics etc lt keywords gt Terms that could be important for subject indexing or particularly helpful for search and retrieval Keywords Page 7 of 13 may be terms or phrases Separate multiples with a semi colon and a slash Related Resource lt related_resource gt Brief citation information title author identifier for key publication s or report s that the dataset being registered directly supports A DOI for the related resource can also go here though it will not be processed as a live link Contributor Organizations lt contributor_organizations gt The names of any organizations that have significantly contributed to the gathering formatting analysis etc of the dataset These are organizations that would not otherwise be credited because they will not be listed in the Publisher field or in the Sponsoring Organization field Names of Collaborations should also be given here Sponsoring Organizations lt sponsor_org gt The name s of the organization s that funded the work w
9. ata Web Service is provided when the TEST activities have been completed Page 3 of 13 2 0 Using the IAD 2 1 Authentication Each POST or GET request requires authentication through an approved web service account The IAD Web Service supports HTTP Basic authentication over Secure Socket Layer SSL With this method the client server connects to the IAD server using HTTPS URLs https www osti gov iadtest dataapi for testing The POST and GET verb commands will pass along the standard Authentication HTTP header base64 encoding 2 2 POST Submit Update and GET Retrieve If authentication is successful the input body of the request is read as an XML document parsed and submitted appropriately The HTML status code for successful connection and an XML response which includes certain metadata fields are returned at the end of processing each request The POST request is used to submit metadata for a new record that will receive a new DOI It is also used to edit or update an existing record that has previously been submitted When requesting an existing record in order to update it the OSTI ID must be included in the XML record The updated record will then overwrite the specified record Note The DOI previously obtained for this dataset must also be included in the XML record being resubmitted for edit update If it is not included the system will attempt to re register and obtain a new DOI This situation requires significan
10. e of the following e Information on how a full formal citation of the data should appear e Access information including a notice of temporary restriction if necessary e Links to software or toolkits needed to open download or analyze the data e Alisting of the individual data files that may be included in the registered dataset with links to them e Update and version information e Contact information DataCite notes two cases when a landing page is mandatory rather than recommended A landing page is mandatory for any data that cannot be viewed using standard desktop software A landing page is also mandatory when the data has restricted access Because DOls are not deleted from the DataCite Registry a landing page can also serve as a tombstone page when a dataset must become unavailable The tombstone page should tell a user who has followed the original DOI to that point what has happened to the data why and provide a contact for further questions 1 3 Getting Started Access to the IAD requires the submitter to have an active approved account To request your account send email to AD osti gov Once an account is established the account holder then submits records to a test environment and does a coordinated review of the results with OSTI before POSTing the first live file in production mode The test URL for the web service is https www osti gov iadtest dataapi The URL for production use of the Interagency D
11. hich produced the dataset or information products Separate multiple organizations with a semi colon and a space Contract or Grant Number s lt contract_nos gt The contract number or grant award number under which the work that produced the dataset or information product was funded If the dataset is the result of a joint effort between two or more funding entities additional contract numbers may be entered When more than one is entered the first one given is considered the primary funding contract Separate multiples with a semi colon and a slash Other Identifying lt other_identifying_nos gt Any other identifying number s Numbers Dataset File lt file_extension gt The file extension of the dataset Knowing the Extension type of file posted will be important to users as they decide whether they can easily open the dataset Some common file extensions are txt csv ps etc Availability lt availability gt The name of any office or organization that can offer additional help in obtaining or utilizing the dataset 4 0 Appendices Appendix 4 1 Sample XML records Sample of a new XML record to be POSTED Record uses the single field character string entry for the lt creators gt field because none of the creators show accompanying ORCIDs lt xml version 1 0 encoding UTF 8 gt lt records gt lt record gt Page 8 of 13 lt title gt LBA Regional Global His
12. irst_name gt lt middle_name gt lt middle_name gt lt last_name gt lt last_name gt lt affiliation gt lt affiliation gt lt private_email gt lt private_email gt lt orcid_id gt lt orcid_id gt lt creators_detail gt lt creatorsblock gt Use the lt creatorsblock gt tags if you ARE including ORCID number with any of the creators Pls authors in the submitted record When the submitted record has the lt creatorsblock gt tags ALL creator Pl author names MUST be broken out into this block format even if only one of the names has an accompanying ORCID Originating Research Org or Submitting Org lt publisher gt The entity that originated holds issues or produces the dataset information product Page 6 of 13 Publication Date lt publication_date gt The date when the dataset or information product was published or issued Required format is mm dd yyyy example 04 17 2011 URL of landing page dataset lt site_url gt The unique URL where the dataset s landing page is posted for access The landing page must contain the direct link to the dataset itself Contact Name and Position lt contact_name gt The name and position of the main point of contact for the dataset being registered Contact Organization lt contact_org gt The organization of the main point of contact for the dataset being registered Contact Email lt contact_e
13. liation gt University of Oregon lt affiliation gt lt private_email gt lt private_email gt lt orcid_id gt lt orcid_id gt lt creators_detail gt lt creatorsblock gt lt publisher gt Centers for Disease Control and Prevention CDC lt publisher gt lt publication_date gt 07 14 2010 lt publication_date gt lt site_url gt http www cdc gov ncbddd flu western lt site_url gt lt product_type_specific gt Data Studies lt product_type_specific gt lt product_nos gt lt product_nos gt lt description gt lt description gt lt keywords gt Virus Flu Anomalies lt keywords gt lt related_resource gt lt related_resource gt lt contributor_organizations gt Lawrence Livermore National Laboratory LLNL lt contributor_organizations gt lt sponsor_org gt Centers for Disease Control and Prevention CDC National Institutes of Health NIH lt sponsor_org gt lt contract_nos gt CDC NIH 40376 2010 lt contract_nos gt lt other_identifying_nos gt lt other_identifying_nos gt lt file_extension gt xls lt file_extension gt lt availability gt lt availability gt lt contact_name gt Shane Harmon lt contact_name gt lt contact_org gt CDC lt contact_org gt lt contact_email gt harmons cdc gov lt contact_email gt lt contact_phone gt 204 874 2189 lt contact_phone gt lt record gt lt records gt Page 11 of 13 Appendix 4 2 Landing Page Examples from CXIDB and ARM C b D B r A typical landing page for a
14. lly make it into the processing system Page 4 of 13 POST SUCCESSFUL SAMPLE RESPONSE FROM IAD SERVER lt xml version 1 0 encoding UTF 8 gt lt records gt lt record gt lt osti_id gt 1035366 lt osti_id gt lt product_nos gt none lt product_nos gt lt title gt ARM Climate Modeling Best Estimate Lamont OK ARMBE CLDRAD SGPC1 lt title gt lt contract_nos gt AC05 000R22725 lt contract_nos gt lt doi gt http dx doi org 10 5439 1035366 lt doi gt lt status gt SUCCESS lt status gt lt status_message gt lt status_message gt lt record gt lt records gt POST FAILURE SAMPLE RESPONSE FROM IAD SERVER lt xml version 1 0 encoding UTF 8 gt lt records gt lt record gt lt osti_id gt 0 lt osti_id gt lt product_nos gt none lt product_nos gt lt title gt ARM Climate Modeling Best Estimate Lamont OK ARMBE CLDRAD SGPC1 lt title gt lt contract_nos gt AC05 000R22725 lt contract_nos gt lt doi gt lt doi gt lt status gt FAILURE lt status gt lt status_message gt Data too long maximum number of characters for dataset type is 2 lt status_message gt lt record gt lt records gt IAD also sends an automated email to those at the submitting site that wish to be on the distribution list The email reports the same information as the server response message but can reach a wider audience if necessary It is the submitting organization s responsibility to
15. mail gt The email address of the main point of contact for the dataset being registered Contact Phone lt contact_phone gt The phone number of the main point of contact for the dataset being registered Only required when a POST is intended to update or modify a previously submitted record OR when a GET command is intended to retrieve a previously submitted record for review 3 2 Optional Metadata Fields Field XML Tag Definitions Comments Business Rules Specific Product Type lt product_type_specific gt IAD automatically defaults to Dataset for the overall generic or high level product type However submitters are encouraged to use the lt product_type_specific gt tag to indicate the main or most important part of the dataset s actual content This is a free text field Example 1 Numeric Data Example 2 Computer model and sample input files Example 3 Photograph Collection Dataset Product Number s lt product_nos gt A unique identifying number that has been assigned to the dataset by originating hosting or submitting organization Multiple IDs may be in this field Separate the multiples with a semi colon and a space Description Abstract lt description gt A clear concise summary of the content of the dataset as well as specialized parameters that describe the data Specialized parameters may include a date range during which information was t
16. reatorsblock gt which includes several tags for each creator name 3 1 Required Mandatory Tags and Values Field XML Tag Definitions Comments Business Rules OSTI ID lt osti_id gt The OSTI ID is required in all requests intended to edit or update records When POSTing new records to OSTI no lt osti_id gt tag is needed in the XML The IAD automatically assigns an OSTI ID to each record successfully submitted you will receive it in the XML response returned automatically to your site DOI if one has already been assigned lt doi gt A previously assigned DOI is required in all POST requests intended to edit or update records When POSTing new records to OSTI no lt osti_id gt tag or lt doi gt tag is needed in the XML The IAD assigns both to each record successfully submitted you will receive it in the XML response returned to your site Principle Investigator s Authors Dataset Title lt title gt Full title of the dataset Include version numbers and specific date ranges when applicable Creator s lt creators gt You may use this field if you are NOT submitting ORCID IDs with any of the creator PI or author names in the record Format for names is last name first name middle initial Multiple creator names separated with a semi colon and a space are allowed Creator s Principle Investigator s lt creatorsblock gt lt creators_detail gt lt first_name gt lt f
17. review the returned messages correct any errors and resubmit the failed records 3 0 IAD s Metadata Fields The following two tables list the required and optional metadata fields their XML tags and the related business rules governing submission to the Interagency Data IAD Web Service Records without required fields will fail to load into IAD and will not receive DOls Only a few metadata and or administrative fields are required The other fields available for use are optional though several such as the Abstract Description are highly encouraged Third party indexing services often integrate with the DataCite Registry where the IAD sends your metadata to reflect the DOIs and associated Page 5 of 13 information in their own products The more metadata these services can pick up from DataCite the more retrievable your datasets will be The OSTI ID and the previously assigned DOI is a required field for all POST requests where the intent is to edit or update records The GET request must also include the OSTI ID though including the DOI is not necessary for GET and will allow retrieval of a record previously submitted by your site Please note that there are two ways to submit Creator Pl Author names These two methods cannot be combined in one record Arecord must use either the single tag lt creators gt and combine all names into one character string OR if any of the names have an accompanying ORCID a record must use the lt c
18. sists of the number 10 followed by a period followed by the data client s prefix a forward slash and a numeric suffix The suffix assigned by IAD is the OSTI ID a unique identifier that every record processing through any of OSTI s systems including IAD must receive Page 2 of 13 What makes the DOI not only a unique identifier but a persistent identifier is the commitment behind it Data clients commit to update the URLs for their DOls whenever a posted landing page and its associated dataset must be moved to a new online address The DOI will never change but the URL which is invisibly bonded to a DOI in the DataCite Registry can change Changing the URL in DataCite s Registry is accomplished via IAD through a simple POST operation to update the affected record DataCite recommends that DOls in a citation or database be displayed as live links i e with http dx doi org preceding the beginning of the actual DOI numbers or characters This is nota requirement but it is a best practice Example http dx doi org 10 5439 1021460 The Landing Page A landing page or introductory page is recommended by DataCite for all registered data and actually required in two cases See next paragraph The DOI points to the landing page which in turn links out to the dataset itself The landing page which must always be publicly accessible provides context for the dataset The landing page may contain one or mor
19. sociated with each DOI should point to an HTML landing page that provides additional needed information such as a list of contents if multiple data files are included in the registered dataset Note that datasets are not uploaded or stored at OSTI Page 1 of 13 1 1 General Requirements These general requirements have been established for data registration The submitter must e Provide at minimum the required metadata to enable basic bibliographic citation e Have authority though not necessarily ownership to make public the assets for which they wish to assign the DOls e Guarantee the persistence of registered data o By ensuring that data will be stored and managed such that access and usability are provided indefinitely o By maintaining and updating as necessary all URLs associated with the DOI e Establish and maintain appropriate landing pages for registered DOIs 1 2 Understanding Key Components Defining Datasets Content and Granularity Determining how DOls should be applied to your data i e at what level of granularity is an important step in planning data registration Some datasets are similar to collections in that they include multiple data files The DOI can be assigned at the collection level with the included data files listed individually on the dataset s landing page Another option is to break the collection down in some logical way by topic by geographic location by time period etc and assign a DOI to each
20. t effort to correct Metadata can be retrieved for any record previously submitted by your organization by using a GET request and supplying the osti_id argument on the command line Authentication is required and is handled in the same fashion as a Create Modify command The requested OSTI ID returns that specific XML record 2 3 Response and Notifications from IAD The IAD server makes an immediate response when the client side server sends a POST or a GET request The primary goal of the response is two fold let the client server know if it connected successfully and provide a status message about the record that was POSTed or retrieved The status says SUCCESS if the record correctly transmitted and the metadata loaded into the processing system The status says FAILURE if the record was unable to load into the processing system for any reason The FAILURE response includes a status message indicating the error or problem that kept the record from loading Errors leading to a FAILURE response occur when a required metadata field is missing when a site URL cannot be validated as correct by the automated validation process when a value is too long for the field it must load into etc An example of each response type appears below Note that the successful record returns its newly assigned OSTI ID and its newly assigned DOI The response for the failed record has neither since OSTI IDs and DOls cannot be given to records that never actua
21. torical Climatology Network V 1 1832 1990 lt title gt lt creators gt Vose R S Schmoyer R L Steurer P M Peterson T C Hein R Karl T R Eischeid J K lt creators gt lt creators emails gt lt creators_emails gt lt publisher gt ORNL Distributed Active Archive Center DAAC for Biogeochemical Dynamics National Aeronautics and Space Administration lt publisher gt lt publication_date gt 12 31 2002 lt publication_date gt lt site_url gt http daac ornl gov cgi bin dsviewer pl ds_id 702 lt site_url gt lt product_type_specific gt Numeric Data lt product_type_specific gt lt product_nos gt lt product_nos gt lt description gt This dataset consists of a subset of the Global Historical Climatology Network GHCN Version 1 database for the study area of the Large Scale Biosphere Atmosphere Experiment in Amazonia LBA in South America i e longitude 85 to 30 degrees W latitude 25 degrees S to 10 degrees N There are three files available one each for precipitation temperature and pressure data Within this subset the oldest data date from 1832 and the most recent from 1990 All data taken at Latitude 10 00N To 25 00S Longitude 30 00W to 85 00W More information about LBA and links to other LBA project sites can be found at http www daac ornl gov LBA misc_amazon html lt description gt lt keywords gt Rainforest FIFE BOREAS Remote Sensing Techniques Selective Logging Carbon Storage Nutrient Dynamics Tr
Download Pdf Manuals
Related Search