USGS - science for a changing world

ScienceBase

Upload and Download Files

Upload Files to ScienceBase

Almost any file type may be uploaded to ScienceBase. Multiple files may be uploaded to a single item, and these files may be uploaded individually or bundled together in a zipped file. The current file size limit for uploads and downloads in ScienceBase is 10 GB. 

To upload a file and enter descriptive information, the user must be logged in and have edit permission to the ScienceBase item. ScienceBase offers one edit form with multiple tabs for entering descriptive information and uploading files. Creating a new item will direct the user to a blank edit form. To create a new item, click the “Add Item” link in the black title bar or the “Add” drop-down menu in the upper right corner of the folder view.

  • The Add Item link in the top banner:

 Screenshot of the ScienceBase title bar, the Add Item option is circled

  • The Add dropdown menu in the upper right corner of the page:

Screenshot highlighting the Add drop-down menu

Users can access the edit form of an existing item by clicking on the “Manage” dropdown menu and selecting “Edit.”

Screenshot of the Manage dropdown menu, which includes an Edit option

Once in the edit form, the user selects the “Files” tab and clicks “Add files…” After a file has been uploaded, the user can enter a title into the text box on the right side of the uploaded file. The title will appear below the file name on the item view. While it is useful to provide this title for a file, it is also recommended that users provide descriptive and meaningful file names prior to uploading their files. This practice is helpful to downstream users who will be downloading the files. 

 

Uploading FGDC-compliant XML metadata files

All USGS datasets should have associated metadata that adhere to FGDC endorsed standards – either Content Standard for Digital Geospatial Metadata (CSDGM) or the ISO metadata standard. Metadata files can be uploaded and stored as resources in ScienceBase items.

Please note: the ScienceBase edit form does not contain all the fields that are required by FGDC endorsed metadata standards. Filling out the edit form is not an alternative to uploading FGDC compliant metadata.

For more information about metadata standards and creation tools, visit the USGS Data Management website.

ScienceBase has the capability to recognize and parse FGDC endorsed Content Standard for Digital Geospatial Metadata (CSDGM) and ISO metadata files that are in XML format. This means that information from these files can be used to populate ScienceBase fields. If a CSDGM or ISO XML file is uploaded, ScienceBase will recognize the format and automatically bring up the following menu:

Screenshot of the window that opens when an xml metadata record has been uploaded. It provides options to auto-populate edit form fields

Select "Yes" to automatically populate many of the fields in the ScienceBase edit form. If you have already entered content in the edit form, it will be overwritten. Select "No" if you would like to upload the metadata file without populating any of the fields.

ScienceBase will apply a stylesheet to CSDGM and ISO metadata records so that they can be viewed in a human-readable format.

Pop-out image of the metadata record with stylesheet applied when "View" is selected for the "Original Metadata"

Uploading Large Files

ScienceBase can now support uploading and downloading of files up to 10 GB. The new upload functionality can be accessed by logging in and scrolling down to the “Item Actions” section of the ScienceBase item view. This section contains the "Large File Uploader," which allows users to upload files from local systems, Google Drive, and Dropbox accounts. The ScienceBase team is currently working to incorporate this tool more seamlessly into the interface; however, the new functionality is already in place and available for use.

Item Actions section of the item view with the Large File Uploader subsection outlined in red

Select the location from which you would like to upload the file.

Local System:

Select “Add files…” and then navigate to the file(s) of your choice. After selecting the file(s), click “Start upload.” You will see a progress bar for each file as it is uploaded. Once the upload is complete, click “Next” at the bottom of the screen to return to your ScienceBase item. 

Screenshot of the upload tool when uploading from your local system

Google Drive:

If you are not already logged into Google, select “Authorize” to provide your Google Drive credentials. Then select “Choose from Google Drive,” select the file(s) you would like to upload, and click “Upload.”

 Screenshot of the upload tool when uploading from Google Drive

You will see a progress bar within your ScienceBase item.

Screenshot of a large file upload from Google Drive in progress

After you refresh your browser, you will see the attachments on your item.

Dropbox:

Select “Choose from Dropbox” and log into your Dropbox account. Then select the file(s) you would like to upload and then click “Upload.” You will see a progress bar within your ScienceBase item. After you refresh your browser, you will see the attachments on your item.

Screenshot of the large file upload tool when uploading from Dropbox

Uploading Spatial Data

Certain geospatial file formats (see list below) are recognized by ScienceBase and can be displayed in preview maps and used to generate web services. 

Uploaded spatial zip files must be unzipped for ScienceBase to recognize the format. Spatial files uploaded in zipped format will not display in preview maps or generate web services; however, they will remain available for download. 

File formats that can be processed by ScienceBase to enable interactive online viewing include the following:

  • Shapefiles (.shp) -- shapefiles can be displayed without symbology in the preview map. Keyhole Markup Language, Web Map Services, and Web Feature Services are created.
  • GeoTIFFs (.tif) -- GeoTIFFs can be viewed without symbology in the preview map. Keyhole Markup Language, Web Map Services, and Web Coverage Services are created.
  • ESRI Service Definition files (.sd) -- Service Definition files allow ScienceBase to display shapefile and GeoTIFF symbology in the preview map. Keyhole Markup Language, Web Map Services, and ArcGIS Mapping Services are created.

When one of these file formats is uploaded, ScienceBase will recognize the format and bring up a popup window, asking if extensions should be created. Select “Create Extensions” to display the file in the preview map and generate web services for the data. 

For more information on creating geospatial services, please see the ScienceBase Geospatial Services page.

The current file size limit for file uploads and downloads in ScienceBase is 10GB; however, there are additional limits if files are used to create web services. Files must be uploaded through the edit form (not the Large File Uploader tool) in order to create web services. 

  • Shapefiles -- ScienceBase can process shapefiles up to 500MB.
  • GeoTIFFs -- ScienceBase can process GeoTIFFs with overviews (internal or external) up to 1GB. A GeoTIFF without an overview must be less than 250MB. 
  • ESRI Service Definition files -- Single file uploads should not exceed 1-2GB. ScienceBase can process uploaded .sd files if the unzipped content does not exceed 4GB. 

Downloading Files

To download files from ScienceBase to a local system, visit the item view of the record of interest. If an item has files attached to it, they will be listed in the Attached Files section which appears toward the bottom of a record just below Contacts. Files may be downloaded to a local system individually or together as one zipped file. Click on the filename to download individual files or click the “download all” link, which is available above the list.

Screenshot of the Attached Files section of an item view with call-outs describing how to download individual files by clicking the filename and download all attached files by clicking the "download all" link.

If a ScienceBase item has child items with attachments, all of the nested attachments can be downloaded together as one zipped file. To do this, you must be logged into ScienceBase. Select the dropdown menu next to the “Child Items” label and click “Download Nested Attached Files.”

Screenshot of the dropdown menu next to Child Items with "Download Nested Attached Files" option circled.

A window will pop up describing the size and number of files that will be downloaded. Select “Download” to proceed.

Screenshot of the pop up window that appears when trying to download nested attached files. 

Downloading Large Files

For downloads of files exceeding 1GB, ScienceBase employs a temporary Amazon S3 download location, from which a user can acquire the file. There is an option to select “Notify by email when download is available.” Follow the link in your email and select “Download File” to initiate the download.

Screenshot of large file downloader with a file transfer in progress:

Screenshot of the large file downloader with a file transfer in progress

Screenshot of the large file downloader with file transfer complete and ready for download

 

 

 

 

Accessibility FOIA Privacy Policies and Notices

USA.gov logo U.S. Department of the Interior | U.S. Geological Survey
URL: http://www.sciencebase.gov/about/content/upload-and-download-files
Page Contact Information: Ask USGS
Page Last Modified:
Site Team