Tutorials
This page contains a few tutorials for using PyLiPD.
An Introduction to the PyLiPD Package Provides an overview of the package and the tutorials
Dataset Representation in PyLiPD
We recommend reading these tutorials if you want to get a deeper understanding of how the datasets are represented. These tutorials are mandatory reading for anyone creating custom queries or needing to create/edit a LiPD file.
Understanding how datasets are represented in PyLiPD This tutorial provides an overview of the ontology and the SPARQL language
Standard, Standards, and More Standards This tutorial provides an overview of the vocabulary used for the values of certain terms such as archive and proxy.
Getting Started
Reading LiPD formatted datasets with PyLiPD This tutorial provides examples on how to load local files, files in a directory, from a URL, and from the GraphDB.
Basic Manipulation of pylipd.LiPD objects This tutorial shows how to extract information (data and associated metadata) from LiPD files and how to add and remove datasets from an existing object.
Basic Functionalities
Working with ensembles in PyLiPD This tutorial describes how PyLiPD deals with age ensembles often used for uncertainty quantification in paleoclimate studies.
Retrieving textual information from LiPD files This tutorial demonstrates the use of pre-defined APIs to get specific information from a LiPD file.
Filtering through queries This tutorial demonstrates the use of existing APIs to filter records by location, type of archive, type of variables.
Advanced Querying using SPARQL
Although PyLiPD comes with many querying APIs, we recognize that we cannot cover every use case. These tutorials teach you how to use the SPARQL language to query the datasets directly. One of the advantages of using a graph representation is that rich metadata information can be stored and accessed. That level of query specificity comes at a price: learning the SPARQL language.
Custom queries on LiPD objects This tutorial provides examples of custom queries of LiPD object using the SPARQL language.
Directly querying the LiPDGraph This tutorial demonstrates the use of the SPAQRL endpoint on LiPDGraph to directly retrieve relevant information.
As you may have guessed, many of our existing PyLiPD functionalities are wrappers around custom SPARQL queries, which are stored in this Python file. Feel free to use them as inspiration!
Editing LiPD files
The Dataset class This tutorial describes how PyLiPD relates to the LinkedEarth ontology and how it can be leveraged to create/edit LiPD files.
Editing LiPD Files This tutorial walks through the process of editing an existing LiPD file.
Creating LiPD files from a tabular template This tutorial shows an example on how to create a LiPD file from existing data in tabular format.