> For the complete documentation index, see [llms.txt](https://docs.pacificdata.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pacificdata.org/ml/user-guide.md).

# User Guide

Entry point for documented census and survey datasets, and access to microdata

For an introduction on how to use the Microdata Library see this video :

{% embed url="<https://youtu.be/p-ZAqoVyrKE>" %}

## Access the Microdata Library

### Directly via Microdata Library URL

The Microdata Library is accessible using the following URL:

<https://microdata.pacificdata.org/>

### From the Data Catalogue

The application is also accessible in several ways from the [Data Catalogue](https://pacificdata.org/):

A link is available from the "Tools" menu:

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MK8FB6rGLByTXw1NCI-%2F-MK8FSMyBSXjJ4F4Yq-e%2FMicrodata%20Library%20PDH%20menu.png?alt=media\&token=03adff3d-2f8a-42de-bc86-7a7243bba4f8)

PDH Data Catalogue entries have a link to visualize the data at its source (Microdata Library):

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MK8FB6rGLByTXw1NCI-%2F-MK8FWjPwhBNoctdNdII%2FLink%20to%20microdata%20library%20from%20PDH.png?alt=media\&token=c7684968-1dfa-4726-975a-60f8095a01cc)

## Find studies using the Microdata Library Central Catalog

The Microdata Library Central Data Catalog allows users to search for published studies (censuses and surveys).

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MK8FB6rGLByTXw1NCI-%2F-MK8Hb7Pc_svQCZPE6Zx%2FMicrodata%20Library%20Central%20Data%20Catalog.png?alt=media\&token=ee146d05-8f18-4a32-825d-bea4dcb831cb)

&#x20;A keyword search returns datasets containing the given keyword(s) in titles and descriptions. The variable description can also be used to search in more detail.

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MK8FB6rGLByTXw1NCI-%2F-MK8ITlOKAPxq9hJfcG_%2FMicrodata%20Library%20Central%20Data%20Catalog2.png?alt=media\&token=ce689e28-cfcc-438b-900b-f7107c31035e)

### From the Pacific Data Hub Data Calalogue

The Microdata Library is registered in the Data Catalogue and can also be found using its various different functionnalities. For more information see [dedicated section on the use of the Data Catalogue](https://app.gitbook.com/@pacific-community-spc/s/pacific-data-hub/~/drafts/-MJz0A5FvX84FSq5yBMJ/catalogue).

## Explore a study

**Study Description** - details all components of a study (census or survey) from identification to metadata production.

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MKHGPzUys3IBvnU4tRg%2F-MKHJBHGwwuJIlNkO0BK%2FMicrodata%20Library%20explore%20study.png?alt=media\&token=ae46a131-2a78-4a5c-824e-b7485f72b884)

**Documentation** - provides access to questionnaires, reports, technical documents etc.

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MKHGPzUys3IBvnU4tRg%2F-MKHJFFcVKUnHVwCdayv%2FMicrodata%20Library%20explore%20study%20-%20documentation.png?alt=media\&token=522aa87c-0ff9-4f74-9630-680f3e0ce6e5)

**Data Description** - provides a full listing of all datasets and variables created as part of the study.

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MKHGPzUys3IBvnU4tRg%2F-MKHJIbAo8DLvryaPobH%2FMicrodata%20Library%20explore%20study%20-%20data%20description.png?alt=media\&token=16a7a080-171a-4d59-8d2a-8b12710cc394)

Clicking on a data file provides a listing of all variables. Clicking on a variable then displays a profile of that variables' responses.&#x20;

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MKHGPzUys3IBvnU4tRg%2F-MKHKZYTMkQXkpVBAbQT%2FMicrodata%20Library%20explore%20study%20-%20data%20description%20-%20variable.png?alt=media\&token=6adb4961-00ac-4745-bfa7-eba94ff18fad)

## Access microdata

To access microdata (where available), create an account and then follow the data request instructions

![](https://3496061366-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDSpD50SdXxsYnU7P9D%2F-MKHGPzUys3IBvnU4tRg%2F-MKHJOo7QxpcS0vlP9Jr%2FMicrodata%20Library%20explore%20study%20-%20get%20microdata.png?alt=media\&token=5b49c746-4fdd-4e4e-91bf-30b798f96884)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pacificdata.org/ml/user-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
