# adi-notebook
## About adi-notebook
Introducing adi_runner: A Comprehensive Python Package for Seamless Integration with PCM and ADI Systems.
adi_runner is a versatile Python package designed to offer an intuitive API that simplifies interactions with PCM (Processing Configuration Manager) and ADI (ARM Data Integrator) technologies. This powerful tool empowers users to navigate ARM (Advanced RISC Machine) data, implement the VAPs (Value-added products) algorithm, and develop comprehensive VAPs workflows with ease.
Whether you're operating directly from the command line, embedding adi_runner within scripts, or leveraging it in an interactive development environment like Jupyter Notebook, this package is engineered to enhance your productivity and streamline your projects. adi_runner is especially beneficial for scientists and developers alike:
For Scientists: Integrate the results from PCM configurations and ADI algorithms seamlessly into your familiar research environments. adi_runner makes it easier to incorporate advanced computational techniques into your experimental analysis, fostering innovation and discovery.
For Developers: Transition scientific code into production-ready VAPs ADI pipelines effortlessly. adi_runner bridges the gap between research and real-world application, allowing for the smooth transfer of valuable insights into operational systems.
With adi_runner, both scientists and developers can unlock the full potential of their data and algorithms, paving the way for groundbreaking advancements in their respective fields. Welcome to a world of enhanced efficiency, precision, and versatility in PCM and ADI interactions.
## Install
Requires-python >=3.8. Using pip.
```shell
pip install adi-notebook
```
> **_NOTE:_** The package is still in active development, when required, please include the version number for reproducibility.
## Explore the package
The adi-notebook package provides intuitive APIs to run adi workflow in Jupyter Notebook environment interactively. In order to run the notebook and explore the features we recommend you explore in a conda environment. Follow the steps to create a reproducible conda environment.
> **_NOTE:_** If you have mamba installed, replace the "conda" command with "mamba" to increase the speed.
1. Clone this repo
```shell
git clone https://code.arm.gov/kefeimo/adi-notebook.git
```
1. (Navigate to the repo path) Create a conda environment from file, with
```shell
conda env create -f environment.yml
```
or
```shell
conda env create -f environment.yml --solver=libmamba
```
> **_Note:_** mamba solver is much faster than conda, and it is preferable. For jade, use `--solver=libmamba` sub-command to enable mamba solver.
1. (After the environment is properly installed, which might take a while) activate the environment with the following command.
```shell
conda activate adi_notebook
```
1. Verify the installation by running the command line utility "pcm-overview".
The "pcm-overview" utility takes a valid process name as argument and review its retrieval rule dataset(s), coordinate(s), variable(s) and output datastream(s). You can find its usage with "-h" (or "--help") command option.
```shell
(adi_notebook) [kefeimo@dev-proc2 adi-notebook]$ pcm-overview -h
usage: pcm-overview [-h] process_name
Overview Processing Configuration Manager (PCM). EXAMPLE: pcm-overview <process_name>
positional arguments:
process_name <process_name>
options:
-h, --help show this help message and exit
```
Here is an example using the "adi_demo_0" process.
```shell
(adi_notebook) [kefeimo@dev-proc2 adi-notebook]$ pcm-overview adi_demo_0
╒══════════════════════╤═════════════════════╤═════════════════╤═══════════════════════╕
│ retrieval_rule_set │ coordinate_system │ variable │ output_datastream │
╞══════════════════════╪═════════════════════╪═════════════════╪═══════════════════════╡
│ met_b1 │ half_min_grid │ alt │ ['adiregulargrid.c1'] │
│ met_b1 │ half_min_grid │ lat │ ['adiregulargrid.c1'] │
│ met_b1 │ half_min_grid │ lon │ ['adiregulargrid.c1'] │
│ met_b1 │ half_min_grid │ met_temperature │ ['adiregulargrid.c1'] │
╘══════════════════════╧═════════════════════╧═════════════════╧═══════════════════════╛
```
1. (Optional) Start a Jupyter Notebook server and explore the library in notebooks.
```
jupyter notebook
```
After running the command, open a browser with the url and navigate to the path that stores the notebook. For people new to adi-notebook, we recommend you start with the notebook [Introducing_AdiRunner_1_quick-start.ipynb](examples/Introducing_AdiRunner_1_quick-start.ipynb).
Raw data
{
"_id": null,
"home_page": "https://code.arm.gov/kefeimo/adi-notebook",
"name": "adi-notebook",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Kefei Mo",
"author_email": "kefei.mo@pnnl.gov",
"download_url": null,
"platform": null,
"description": "# adi-notebook\n\n## About adi-notebook\n\nIntroducing adi_runner: A Comprehensive Python Package for Seamless Integration with PCM and ADI Systems.\n\nadi_runner is a versatile Python package designed to offer an intuitive API that simplifies interactions with PCM (Processing Configuration Manager) and ADI (ARM Data Integrator) technologies. This powerful tool empowers users to navigate ARM (Advanced RISC Machine) data, implement the VAPs (Value-added products) algorithm, and develop comprehensive VAPs workflows with ease.\n\nWhether you're operating directly from the command line, embedding adi_runner within scripts, or leveraging it in an interactive development environment like Jupyter Notebook, this package is engineered to enhance your productivity and streamline your projects. adi_runner is especially beneficial for scientists and developers alike:\n\nFor Scientists: Integrate the results from PCM configurations and ADI algorithms seamlessly into your familiar research environments. adi_runner makes it easier to incorporate advanced computational techniques into your experimental analysis, fostering innovation and discovery.\n\nFor Developers: Transition scientific code into production-ready VAPs ADI pipelines effortlessly. adi_runner bridges the gap between research and real-world application, allowing for the smooth transfer of valuable insights into operational systems.\n\nWith adi_runner, both scientists and developers can unlock the full potential of their data and algorithms, paving the way for groundbreaking advancements in their respective fields. Welcome to a world of enhanced efficiency, precision, and versatility in PCM and ADI interactions.\n\n## Install\n\nRequires-python >=3.8. Using pip.\n\n```shell\npip install adi-notebook\n```\n\n> **_NOTE:_** The package is still in active development, when required, please include the version number for reproducibility.\n\n## Explore the package\n\nThe adi-notebook package provides intuitive APIs to run adi workflow in Jupyter Notebook environment interactively. In order to run the notebook and explore the features we recommend you explore in a conda environment. Follow the steps to create a reproducible conda environment.\n> **_NOTE:_** If you have mamba installed, replace the \"conda\" command with \"mamba\" to increase the speed.\n\n1. Clone this repo\n\n ```shell\n git clone https://code.arm.gov/kefeimo/adi-notebook.git\n ```\n\n1. (Navigate to the repo path) Create a conda environment from file, with\n\n ```shell\n conda env create -f environment.yml\n ```\n\n or \n \n ```shell\n conda env create -f environment.yml --solver=libmamba\n ```\n\n > **_Note:_** mamba solver is much faster than conda, and it is preferable. For jade, use `--solver=libmamba` sub-command to enable mamba solver.\n\n1. (After the environment is properly installed, which might take a while) activate the environment with the following command.\n ```shell\n conda activate adi_notebook\n ```\n\n1. Verify the installation by running the command line utility \"pcm-overview\".\n \n The \"pcm-overview\" utility takes a valid process name as argument and review its retrieval rule dataset(s), coordinate(s), variable(s) and output datastream(s). You can find its usage with \"-h\" (or \"--help\") command option.\n ```shell\n (adi_notebook) [kefeimo@dev-proc2 adi-notebook]$ pcm-overview -h\n usage: pcm-overview [-h] process_name\n\n Overview Processing Configuration Manager (PCM). EXAMPLE: pcm-overview <process_name>\n\n positional arguments:\n process_name <process_name>\n\n options:\n -h, --help show this help message and exit\n ```\n Here is an example using the \"adi_demo_0\" process.\n ```shell\n (adi_notebook) [kefeimo@dev-proc2 adi-notebook]$ pcm-overview adi_demo_0\n \u2552\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2564\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2555\n \u2502 retrieval_rule_set \u2502 coordinate_system \u2502 variable \u2502 output_datastream \u2502\n \u255e\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2561\n \u2502 met_b1 \u2502 half_min_grid \u2502 alt \u2502 ['adiregulargrid.c1'] \u2502\n \u2502 met_b1 \u2502 half_min_grid \u2502 lat \u2502 ['adiregulargrid.c1'] \u2502\n \u2502 met_b1 \u2502 half_min_grid \u2502 lon \u2502 ['adiregulargrid.c1'] \u2502\n \u2502 met_b1 \u2502 half_min_grid \u2502 met_temperature \u2502 ['adiregulargrid.c1'] \u2502\n \u2558\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2567\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255b\n ```\n\n\n1. (Optional) Start a Jupyter Notebook server and explore the library in notebooks.\n ```\n jupyter notebook\n ```\n After running the command, open a browser with the url and navigate to the path that stores the notebook. For people new to adi-notebook, we recommend you start with the notebook [Introducing_AdiRunner_1_quick-start.ipynb](examples/Introducing_AdiRunner_1_quick-start.ipynb).\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "adi-notebook, use ADI-backboned method in a notebook.",
"version": "0.3.3",
"project_urls": {
"Homepage": "https://code.arm.gov/kefeimo/adi-notebook"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "79f2d2cc30c970bb512b6949d925c89b52c82fd6700df22648427021afad5869",
"md5": "9a0e0c1656e1ac90eca892d517da55d0",
"sha256": "435959a8571f8bc87d7ae87e16d941629aaf831c731511df47857179d5eae56b"
},
"downloads": -1,
"filename": "adi_notebook-0.3.3-py3-none-manylinux1_x86_64.whl",
"has_sig": false,
"md5_digest": "9a0e0c1656e1ac90eca892d517da55d0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 21115,
"upload_time": "2024-05-30T22:33:22",
"upload_time_iso_8601": "2024-05-30T22:33:22.750873Z",
"url": "https://files.pythonhosted.org/packages/79/f2/d2cc30c970bb512b6949d925c89b52c82fd6700df22648427021afad5869/adi_notebook-0.3.3-py3-none-manylinux1_x86_64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-30 22:33:22",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "adi-notebook"
}
JSON