11 Session 11: Arctic Data Center Data Portals

11.1 Creating a data portal

A new feature on the Arctic Data Center. Researchers can now easily view project information and datasets all in one place.

11.1.1 What is a Portal?

A portal is a collection of Arctic Data Center data packages on a unique webpage.

Typically, a research project’s website won’t be maintained beyond the life of the project and all the information on the website that provides context for the data collection is lost. Arctic Data Center portals can provide a means to preserve information regarding the projects’ objectives, scopes, and organization and couple this with the data files so it’s clear how to use and interpret the data for years to come.

Portals also leverage Arctic Data Center’s metric features, which create statistics describing the project’s data packages. Information such as total size of data, proportion of data file types, and data collection periods are immediately available from the portal webpage.

11.1.2 Portal Uses

Portals allow users to bundle supplementary information about their group, data, or project along with the data packages. Data contributors can organize their project specific data packages into a unique portal and customize the portal’s theme and structure according to the needs of that project.

Researchers can also use portals to compare their public data packages and highlight and share them with other teams, as well as the broader Arctic research audience.

To see an example of what portals could look like, please view the Toolik Field Station’s portal.

11.1.3 Portal Main Components

Portals have five components: an about page, a settings page, a data page, a metrics page, and customizable free-form pages.

11.1.3.1 About Page

This page is the first page users will see after initially creating a new portal, and it is highly recommended that users use this feature to create a description for their portal. Add a picture of your logo, a title and description of your portal, and freeform text using the markdown editor.

11.1.3.2 Settings Tab

On the settings tab, users can give the portal a title and assign it a unique url; also referred to as a portal identifier. Users can add a general description of the portal, upload an icon photo for their data, and upload icon photos from any partner organizations that have contributed to the data. These partner icons will appear in the footer banner on every page in a portal, likewise your portal icon will appear in the header banner.

Every Arctic Data Center portal URL will follow this format:

https://arcticdata.io/catalog/portals/portal_identifier

11.1.3.3 Data Page

The data page is the most important component of the Arctic Data Center portal system. This is where users will display the data packages of their choice. It looks and performs just like the main Arctic Data Center catalog.

11.1.3.4 Metrics Page

Unlike the first two pages, the metrics page cannot be edited or customized. It is a default feature that provides the following information about the data packages within a portal:

The total number of publicly-available metadata records
The volume (in bytes) of all publicly-available metadata records and data files
The most recent date the datasets were last updated (metadata and data are treated separately)
The file types of all publicly-available data
The years in which data was collected, regardless of upload date

Please contact Arctic Data Center’s support team at support@arcticdata.io about any questions or concerns about the metrics page.

11.1.3.5 Freeform Pages

Freeform pages are an optional function provided by Arctic Data Center portals. Here, users can add as much supplementary information as needed using markdown.

11.1.3.5.1 Example Freeform Pages

Below are two examples of ways users can take advantage of portal freeform pages to tie unique content together with their data packages. Users can add as many tabs as needed.

The examples shown on this page are from the Toolik Field Station’s portal; visit this portal to explore its contents further.

11.1.4 Creating Portals

A step-by-step guide on how to navigate the Arctic Data Center and create a new portal.

For video tutorials on how to create your first portal, please visit the Arctic Data Center’s website.

11.1.4.1 Getting Started with Portals

If you are on the Arctic Data Center’s primary website, select the button on the top right titled ‘Create Portal’, this will take you to sign in with your ORCID id if you are not already signed in. Sign in with your ORCID, which will then take you directly to the page where you can start customizing your portal.

You can also get to the page to create a new portal by clicking on your name in the upper right hand corner when you are signed in to the Arctic Data Center with your ORCID. A dropdown will appear, and you would select ‘My Portals’.

On your profile settings page, select ‘My Portals’. After the page loads select the green button ‘+ New Portal’ to add a new portal, you’ll automatically be directed to a fresh edit session.

11.1.4.2 Portal About and Settings Page

In a new edit session, the first thing you’ll see is the about page where you’ll be able to add details about your project page.

On the settings tab, you’ll set the basic elements of your portal:

Portal title
Unique portal identifier
- This identifier will be used to create the portal URL. If the name is available, a label will indicate it’s available and if the name is taken already, it will note that the name is already taken. This feature ensures the portals are unique.
Portal description
Partner organization logos

Adding collaborators to help you create your portal is as straightforward as copying and pasting in their ORCID into the box below the permissions section. You can choose whether the collaborator can view, edit, or is an owner of the portal. You can have multiples of each role.

11.1.5 Adding Data to Portals

Please see this tutorial video for a walkthrough on using portal search filters:Adding Datasets by Search Query

Navigate to the ‘Data’ tab. Here you will see a list of all the datasets in the Arctic Data Center. In order to populate a portal with the data packages applicable to your needs, narrow the search results using the filters on the left side of the page. When you’ve selected the data you want, hit the green save button in the bottom right.

The portal search feature has the following filters available:

Search: A general search feature that will return data packages with the entered term in the package metadata
Creator: We recommend searching by last names for more accurate results.
Publish Year: Use either the sliding scale or enter start and end years manually
Year of Data Coverage: Searches for data packages with temporal coverages within the selected date range. As with the Publish Year search, use either the sliding scale or enter manually
Identifier: Searches for all or part of the DOI (digital object identifier) associated with the dataset
Taxon: Searches for any taxonomic rank specified by the submitter
Location: This filter will search within the data packages’ geographic description field, meaning that you can search by both name or type of location (eg. United States or forest)

If you need assistance assembling portal data using a complex query, please contact the Arctic Data Center Support Team.

11.1.5.1 Data Package Metrics

As stated in Portal Main Components, the metrics page is a default function provided by the Arctic Data Center. This page cannot be edited and cannot be viewed while editing. Users do have the option to delete the page if they’d like. To delete the page, select the arrow next to the word ‘Metrics’ in the tab and choose ‘Delete’ from the dropdown list.

To see metric summaries, navigate to your portal in view mode. See Saving and Editing Portals for more information on how to view portals.

Please contact the Arctic Data Center Support Team about any questions or concerns about the metrics page.

11.1.6 Creating Unique Freeform Pages

To watch a tutorial on creating a new freeform page see this video:Creating a Freeform Text Page

To add a freeform page to a portal, select the ‘+’ tab next to the data and metric tabs and then choose the freeform option that appears on screen. A freeform page will then populate.

Easily customize your banner with a unique image, title, and page description. To change the name of the tab, click on the arrow in the ‘Untitled’ tab and select ‘Rename’ from the dropdown list.

Below the banner, there is a markdown text box with some examples on how to use the markdown formatting directives to customize the text display. There is also a formatting header at the top to assist if you’re unfamiliar with markdown. As you write, toggle through the Edit and Preview modes in the markdown text box to make sure your information is displaying as intended. Portals are flexible and can accommodate as many additional freeform pages as needed.

The markdown header structure helps to generate the table of contents for the page.

Please see these additional resources for help with markdown:

Markdown reference
Ten minute tutorial
For a longer example where you can also preview the results, checkout the Showdown Live Editor

11.1.7 Saving and Editing Portals

Be sure to save your portal when you complete a page to ensure your progress is retained.

Whenever a portal is saved, a dialogue box will pop up at the top of the page prompting users to view their private portal in view mode. You can choose to ignore this and continue editing.

To delete a page from your portal, select the arrow in the tab and choose ‘Delete’ from the dropdown.

Users can view and edit their portal from their ‘My Portals’ tab.

First, click the arrow your name in the top-right corner to drop down your menu options. Then, select ‘My Portals’ from the dropdown underneath your name. See the section on Getting Started with Portals for more details.

ADC-viewportal

Click on the portal title to view it or select the edit button to make changes.

11.1.8 How to Publish Portals

New portals are automatically set to private and only visible to the portal creator. The portal will remain private until the owner decides to make it public.

To make your portal public, go into the settings of your portal. Under the description, you’ll see a new section called ‘Sharing Options’. You can toggle between your portal being private and your portal being public there.

11.1.10 Tutorial Videos

For video tutorials on how to create your first portal, please visit the Arctic Data Center video tutorial page.

11.1.11 Acknowledgements

Much of this documentation was composed by ESS-DIVE, which can be found here.