license:cc-by-4.0 region:us
This dataset consists of analyte data for various analytes that are regularly tested for in cannabis. The dataset consists of sub-datasets for each type of test, as well as a sub-dataset that includes all analytes.
@inproceedings{cannlytics2023cannabis_analytes,
  author    = {Skeate, Keegan and O'Sullivan-Sutherland, Candace},
  title     = {Cannabis Analytes},
  booktitle = {Cannabis Data Science},
  month     = {October},
  year      = {2023},
  address   = {United States of America},
  publisher = {Cannlytics}
}
---
pretty_name: cannabis_analytes
license:
  - cc-by-4.0
---

# Cannabis Analytes

This dataset consists of analyte data for various analytes that are regularly tested for in cannabis. The dataset consists of sub-datasets for each type of test, as well as a sub-dataset that includes all analytes.

## Dataset Structure

The dataset is partitioned into 18 subsets for each state and the aggregate.

| State | Code | Status |
|  [All](https://huggingface.co/datasets/cannlytics/cannabis_licenses/tree/main/data/analytes.json) |  `all` | ✅ |
|  [Cannabinoids](https://huggingface.co/datasets/cannlytics/cannabis_licenses/tree/main/data/cannabinoids.json) |  `cannabinoids` | ✅ |
|  [Terpenes](https://huggingface.co/datasets/cannlytics/cannabis_licenses/tree/main/data/terpenes.json) |  `terpenes` | ✅ |
|  Pesticides |  `pesticides` | ⏳ Coming soon |
|  Microbes |  `microbes` | ⏳ Coming soon |
|  Heavy metals |  `heavy_metals` | ⏳ Coming soon |
|  Residual solvents |  `residual_solvents` | ⏳ Coming soon |
|  Other |  `other` | ⏳ Coming soon |

## Using the Dataset

You can load all the analytes, or the analytes for a specific test. For example:

```py
from datasets import load_dataset

# Get all of the analytes
dataset = load_dataset('cannlytics/cannabis_licenses', 'all')
analytes = dataset['data']

# Get the cannabinoids.
dataset = load_dataset('cannlytics/cannabis_licenses', 'cannabinoids')
terpenes = dataset['data']

# Get the terpenes.
dataset = load_dataset('cannlytics/cannabis_licenses', 'terpenes')
terpenes = dataset['data']
```

## Data Fields

Below is a non-exhaustive list of fields, used to standardize the various data that are encountered, that you may expect to find for each observation.

## Data Fields

Below is a non-exhaustive list of fields used to standardize the various data that are encountered. You may expect to find the following for each observation:

| Field                        | Example                                      | Description                                                                                          |
|------------------------------|----------------------------------------------|------------------------------------------------------------------------------------------------------|
| `key`                        | `"thca"`                                     | A unique ID for each analyte.                                                                        |
| `description`                | `"Δ-9-Tetrahydrocannabinol is a cannabinoid..."` | A brief description or summary about the analyte.                                                    |
| `name`                       | `"THC"`                                      | Common name of the analyte.                                                                          |
| `scientific_name`            | `"\u0394-9-Tetrahydrocannabinol"`            | The scientific name or IUPAC name of the analyte.                                                    |
| `type`                       | `"cannabinoid"`                              | The type or classification of the analyte (e.g., terpene, cannabinoid).                              |
| `wikipedia_url`              | `"https://en.wikipedia.org/wiki/Tetrahydrocannabinol"` | The Wikipedia URL where more detailed information can be found about the analyte.                    |
| `degrades_to`                | `["cannabinol"]`                             | A list of chemicals or substances the analyte degrades to.                                           |
| `precursors`                 | `["thca"]`                                   | A list of precursor chemicals or substances related to the analyte.                                  |
| `subtype`                    | `"psychoactive"`                             | A sub-classification or additional details about the type of the analyte.                            |
| `cas_number`                 | `"1972-08-3"`                                | The Chemical Abstracts Service (CAS) registry number, which is a unique identifier for chemical substances.|
| `chemical_formula`           | `"C21H30O2"`                                 | The chemical formula of the analyte.                                                                 |
| `molar_mass`                 | `"314.5 g/mol"`                              | The molar mass of the analyte.                                                                       |
| `density`                    | `"1.0±0.1 g/cm3"`                            | The density of the analyte.                                                                          |
| `boiling_point`              | `"383.5±42.0 °C"`                            | The boiling point of the analyte.                                                                    |
| `image_url`                  | `"https://example.com/image.jpg"`            | URL of an image representing the analyte.                                                            |
| `chemical_formula_image_url` | `"https://example.com/formula_image.jpg"`    | URL of an image representing the chemical formula of the analyte.                                    |

## Data Splits

The data is split into subsets by analysis. You can retrieve all analytes by requesting the `all` subset.

```py
from datasets import load_dataset

# Get all cannabis licenses.
dataset = load_dataset('cannlytics/cannabis_licenses', 'all')
data = dataset['data']
```

## Curation Rationale

This dataset provides a standard set of analyte data for [cannabis tests](https://huggingface.co/datasets/cannlytics/cannabis_tests).

## Data Collection and Normalization

The `get_cannabis_analytes.py` routine is used to normalize values collected from Wikipedia.

## Known Limitations

The datasets are not complete and may include inaccurate information.

## Dataset Curators

Curated by [🔥Cannlytics](https://cannlytics.com)<br>
<contact@cannlytics.com>

## License

```
Copyright (c) 2023 Cannlytics

The files associated with this dataset are licensed under a 
Creative Commons Attribution 4.0 International license.

You can share, copy and modify this dataset so long as you give
appropriate credit, provide a link to the CC BY license, and
indicate if changes were made, but you may not do so in a way
that suggests the rights holder has endorsed you or your use of
the dataset. Note that further permission may be required for
any content within the dataset that is identified as belonging
to a third party.
```

## Contributions

Thanks to [🔥Cannlytics](https://cannlytics.com), [@candy-o](https://github.com/candy-o), [@keeganskeate](https://github.com/keeganskeate), and the entire [Cannabis Data Science Team](https://meetup.com/cannabis-data-science/members) for their contributions.
