Finding data#

Searching the site#

To find datasets in CKAN, type any combination of search words (e.g. “health”, “transport”, etc) in the search box on any page. CKAN displays the first page of results for your search. You can:

  • View more pages of results

  • Repeat the search, altering some terms

  • Restrict the search to datasets with particular tags, data formats, etc using the filters in the left-hand column

If there are a large number of results, the filters can be very helpful, since you can combine filters, selectively adding and removing them, and modify and repeat the search with existing filters still in place.

../_images/search_the_site.png

Searching within a project#

If you want to look for data owned by a particular project, you can search within that project from its home page in CKAN.

  1. Select the “Projects” link at the top of any page.

  2. Select the project you are interested in. CKAN will display your project’s home page.

  3. Type your search query in the main search box on the page.

CKAN will return search results as normal, but restricted to datasets from the project.

If the project is of interest, you can opt to be notified of changes to it (such as new datasets and modifications to datasets) by using the “Follow” button on the project page. See the section Managing your news feed below. You must have a user account and be logged in to use this feature.

Exploring datasets#

When you have found a dataset you are interested and selected it, CKAN will display the dataset page. This includes

  • The name, description, and other information about the dataset

  • Links to and brief descriptions of each of the resources

../_images/exploring_datasets.png

The resource descriptions link to a dedicated page for each resource. This resource page includes information about the resource, and enables it to be downloaded. Many types of resource can also be previewed directly on the resource page. .CSV and .XLS spreadsheets are previewed in a grid view, with map and graph views also available if the data is suitable. The resource page will also preview resources if they are common image types, PDF, or HTML.

The dataset page also has two other tabs:

  • Activity stream – see the history of recent changes to the dataset

  • Topics – see any topic associated with this dataset.

If the dataset is of interest, you can opt to be notified of changes to it by using the “Follow” button on the dataset page. See the section Managing your news feed below. You must have a user account and be logged in to use this feature.

Extended feature — Citing a Dataset#

You can get the citation for the dataset using the Cite as widget in the bottom left corner of the dataset page:

../_images/citation.png

We provide the following major citation styles:

  • American Psychological Association 6th edition (APA)

  • Modern Language Association 8th edition (MLA)

  • Chicago Manual of Style 17th edition (note)

  • Chicago Manual of Style 17th edition (author-date)

  • IEEE

  • Council of Science Editors, Citation-Sequence (numeric) (CSE C-S)

  • American Medical Association (AMA)

  • American Chemical Society (ACS)

  • American Institute of Physics (AIP)

  • American Society of Civil Engineers (ASCE)

You can also find the other citation styles using the search box on the top of the dropdown.

To get the complete list of citation styles, please visit the CSL Style Repository. To search the styles in the style repository by file name, press “t” and start typing.

Note

If the dataset is assigned an ARK Persistent Identifier, the ARK URL will be used as the URL in the citation; if not, the dataset URL will be used instead.

Extended feature — Data preview and visualization#

CKAN’s data preview allows you learn the data without the need to download the entire file first:

  1. Go to the dataset’s page. You can find it by entering the title in the search box on any page.

  2. Select the “Preview” button inside the “Explore” button beside a resource in the “Data and Resources” section:

    ../_images/data_preview_1.png

  3. Then you can preview the resource:

    ../_images/data_preview_2.png

The data preview function will check the Format field to specify a proper resource view. Please refer to step 5 of Adding a new dataset. depositar can preview the following formats:

  • Text: txt, html, xml, json, and geojson

  • Image: png, jpg, jpeg, and gif

  • Video: MP4, WebM, and Ogg

  • Audio: MP3, WAV, and Ogg

  • Table: csv and xls(x)

  • Spatial data: WMTS, WMS, and Shapefile (Please specify the shapefile as “shp” in the Format field when filling out resource information, otherwise it can not be visualized.)

  • Others: PDF and web page

../_images/data_preview_3.png

One resource can have multiple views of the same data (for example a grid and some graphs for tabular data).

You can add a new resource view through the following steps:

  1. Go to the resource’s page.

  2. Select the “Manage” button (You must have the right to edit the resource).

    ../_images/new_preview_1.png

  3. Select the “Views” tab in the next page. From here you can create new views, update or delete existing ones and reorder them. Available view plugins are:

    • Data Explorer: It allows querying, filtering, graphing and mapping data.

    • Grid: Displays a filterable, sortable, table view of structured data.

    • Map: Shows data stored on the DataStore in an interactive map. It supports plotting markers from a pair of latitude / longitude fields or from a field containing a GeoJSON representation of the geometries.

    • Image: If the resource format is a common image format like PNG, JPEG or GIF, it adds an <img> tag pointing to the resource URL.

    • Web page: Adds an <iframe> tag to embed the resource URL.

    ../_images/new_preview_2.png

  4. Select the “Add” button to save the new view. You can also take a sneak peek at the view by clicking the “Preview” button.