Skip to main content

This package aims to provide machine learning (ML) functions for performing comprehensive soil and groundwater data analysis, and for supporting the establishment of effective long-term monitoring.

Project description

PyLEnM

PyPI version Documentation Status

This package aims to provide machine learning (ML) functions for performing comprehensive soil and groundwater data analysis, and for supporting the establishment of effective long-term monitoring. The package includes unsupervised ML for identifying the spatiotemporal patterns of contaminant concentrations (e.g., PCA, clustering), and supervised ML for evaluating the ability of estimating contaminant concentrations based on in situ measurable parameters, as well as the effectiveness of well configuration to capture contaminant concentration distributions. Currently, the main focus is to analyze historical groundwater datasets and to extract key information such as plume behaviors and controlling (or proxy) variables for contaminant concentrations (Schmidt et al., 2018). This is setting a ground for integrating new technologies such as in situ sensors, geophysics and remote sensing data.

This development is a part of the Advanced Long-Term Monitoring Systems (ALTEMIS) project. In this project, we propose to establish the new paradigm of long-term monitoring based on state-of-art technologies – in situ groundwater sensors, geophysics, drone/satellite-based remote sensing, reactive transport modeling, and AI – that will improve effectiveness and robustness, while reducing the overall cost. In particular, we focus on (1) spatially integrative technologies for monitoring system vulnerabilities – surface cap systems and groundwater/surface water interfaces, and (2) in situ monitoring technologies for monitoring master variables that control or are associated with contaminant plume mobility and direction. This system transforms the monitoring paradigm from reactive monitoring – respond after plume anomalies are detected – to proactive monitoring – detect the changes associated with the plume mobility before concentration anomalies occur.

The latest package can be downloaded from: https://pypi.org/project/pylenm/

More information on the project can be found here: https://altemis.lbl.gov/ai-for-soil-and-groundwater-contamination/

Installation

[Optional] Create a virtual environment within which the package is installed.

It is recommended to install the package and work in a virtual environment.
Read more here to learn how to install conda.

conda create --name pylenm_env python=3.8
conda activate pylenm_env

Working with Anaconda, you might need to install jupyter for Anaconda to identify this env as a jupyter environemnt.

pip install jupyter

Installing the pylenm package

[Option 1] Install directly from the PyPI package repository.

Install directly using pip as mentioned on the PyPI page.

pip install pylenm

[Option 2] Install from the source code

  1. Clone the repository
    git clone https://github.com/ALTEMIS-DOE/pylenm.git
    cd pylenm
    
  1. Install the package
    pip install .
    

Journal Publication:

PyLEnM: A Machine Learning Framework for Long-Term Groundwater Contamination Monitoring Strategies

Aurelien O. Meray, Savannah Sturla, Masudur R. Siddiquee, Rebecca Serata, Sebastian Uhlemann, Hansell Gonzalez-Raymat, Miles Denham, Himanshu Upadhyay, Leonel E. Lagos, Carol Eddy-Dilek, and Haruko M. Wainwright Environmental Science & Technology 2022 56 (9), 5973-5983 DOI: 10.1021/acs.est.1c07440

Demonstration notebooks

These notebooks use the refactored version of the pylenm package - pylenm2. This refactored version reorganizes the functions into a more semantically separated modules.

To use this version, import pylenm2 instead of pylenm after installation. The function hirarchy is shown in pylenm2 README.

1 - Basics
2 - Unsupervised learning
3 – Water Table Estimation & Well Optimization
4 – Tritium Spatial Estimation
5 – Proxy Estimation (SC~Tritium)
6 - LOWESS Outlier removal
7 - Miscellaneous

Sample data used for these notebooks is stored in the data directory.

Demonstration notebooks (Deprecated):

1 – Basics
2 - Unsupervised learning
3 – Water Table Estimation & Well Optimization
4 – Tritium Spatial Estimation
5 – Proxy Estimation (SC~Tritium)

Demonstration data:

The data used in the demonstration notebooks above can be downloaded here.

Contributors:

Aurelien Meray
Haruko Wainwright
Himanshu Upadhyay
Masudur Siddiquee
Savannah Sturla
Nivedita Patel
Kay Whiteaker
Haokai Zhao

Maintainers

Haokai Zhao
Satyarth Praveen
Zexuan Xu
Aurelien Meray
Haruko Wainwright

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pylenm-2.7.3.tar.gz (75.7 kB view details)

Uploaded Source

Built Distribution

pylenm-2.7.3-py3-none-any.whl (385.8 kB view details)

Uploaded Python 3

File details

Details for the file pylenm-2.7.3.tar.gz.

File metadata

  • Download URL: pylenm-2.7.3.tar.gz
  • Upload date:
  • Size: 75.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for pylenm-2.7.3.tar.gz
Algorithm Hash digest
SHA256 99ebd5ab5a4e54cfd3d445202eb2547dbea7a47bd3c234ca2243770715b47cd5
MD5 fd20c088c2e7d608f140c6a6ae4b912e
BLAKE2b-256 36bb79fbe71eca7cb5092317e43d6283aaa2480a4e017d4f8a57445d923460e6

See more details on using hashes here.

File details

Details for the file pylenm-2.7.3-py3-none-any.whl.

File metadata

  • Download URL: pylenm-2.7.3-py3-none-any.whl
  • Upload date:
  • Size: 385.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for pylenm-2.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4548f7b873a7c035ac4e22ff8e635bc3439e86deb5cc47a43aaf51e43d3d920d
MD5 06f5f0b6a9be830189021c271326128c
BLAKE2b-256 a18b627d1ad613b989b5d1fce838796b191f4d89d479b72126016b9769153a30

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page