mater-data-providing 0.1.0

Gives functions to help build a mater providing data script.

MATER data providing

Metabolic Analysis for Transdisciplinary Ecological Research

[TOC]

📋 Requirements

• Python 3.12 or higher

We recommend using one virtual environment per Python project to manage dependencies and maintain isolation. You can use a package manager like uv to help you with library dependencies and virtual environments.

📦 Install the mater-data-providing Package

Install the mater package via uv:

uv add mater-data-providing

Install the mater package via pip:

pip install mater-data-providing

⚙️ API

metadata_definition

import mater-data-providing as mdp
mdp.metadata_definition("source_link", "my_source", "my_project")

Returns

{"link": "source_link", "source": "my_source", "project": "my_project"}

provider_definition

import mater-data-providing as mdp
mdp.provider_definition("Jon", "Do", "[e-mail]")

Returns

{"first_name": "Jon", "last_name": "Do", "email_address": "[e-mail]"}

to_json

import mater_data_providing as mdp
import pandas as pd

# 1. Build a DataFrame
df = pd.DataFrame([
    {"location": "france", "object": "car", "value": 15, "unit": "year", "time": 2015, "scenario": "historical", "variable": "lifetime_mean_value"},
    {"location": "france", "object": "car", "value": 17, "unit": "year", "time": 2020, "scenario": "historical", "variable": "lifetime_mean_value"},
])

# 2. Write out as "input_data/sample.json"
#    (creates data/input_data/sample.json)
mdp.to_json(
    df,
    folder="input_data",
    name="sample",       # filename will be sample.json
    mode="w"             # write (overwrite) – this is the default
)

Creates data/input_data/sample.json:

[
  {
    "location": "france",
    "object": "car",
    "value": 15,
    "unit": "year",
    "time": 2015,
    "scenario": "historical",
    "variable": "lifetime_mean_value"
  },
  {
    "location": "france",
    "object": "car",
    "value": 17,
    "unit": "year",
    "time": 2020,
    "scenario": "historical",
    "variable": "lifetime_mean_value"
  }
]

replace_equivalence

data\dimension\dimension.json:

[
  {
    "value": "car",
    "equivalence": {
      "short": "PLDV",
      "long": "personal_vehicle"
    }
  },
  {
    "value": "france",
    "equivalence": {
      "ISO3": "FRA"
    }
  }
]

Python scrip at the root of the project:

import mater_data_providing as mdp
import pandas as pd

# 1. Build a DataFrame
df = pd.DataFrame([
    {"location": "FRA", "object": "personal_vehicle", "value": 15, "unit": "year", "time": 2015, "scenario": "historical", "variable": "lifetime_mean_value"},
    {"location": "france", "object": "PLDV", "value": 17, "unit": "year", "time": 2020, "scenario": "historical", "variable": "lifetime_mean_value"},
])

df_uniform = mdp.replace_equivalence(df)
print(df_uniform)

  location object  value  unit  time    scenario             variable
0   france    car     15  year  2015  historical  lifetime_mean_value
1   france    car     17  year  2020  historical  lifetime_mean_value