ECNet: machine learning models for fuel property prediction
ECNet is an open-source Python package for predicting fuel properties from molecular structure using quantitative structure–property relationship (QSPR) descriptors and multilayer perceptron models built with PyTorch.
The current v4 API centers on ECNet, bundled property loaders
(ecnet.datasets.load_*), hyperparameter-tuning helpers, training callbacks,
and analytical blend-property equations. Descriptor backends include
PaDEL-Descriptor (default) and
alvaDesc (optional; requires a valid
license).
Installation
Requires Python 3.11 or newer. Java is needed for the default PaDEL backend.
pip install ecnet
From a clone of this repository:
pip install -e .
pip install -e ".[dev]" # pytest, ruff, pre-commit, pip-audit
pip install -e ".[docs]" # Sphinx + Furo
Documentation and examples
- User guide and API reference: ecnet.readthedocs.io
- Example notebooks:
examples/ - Stability policy: Sphinx API stability page (source:
docs/source/stability.rst) - Bundled dataset cards: Sphinx Bundled property datasets page (
docs/source/data.rst)
Historical JOSS architecture note
The 2017 Journal of Open Source Software article
(doi:10.21105/joss.00401) and the
accompanying paper/paper.md describe a prior generation of ECNet based on
a project / build / node ensemble workflow. That architecture is not the
current public API. For v4 usage, follow the Sphinx documentation and the
imports documented under ecnet, ecnet.datasets, ecnet.tasks,
ecnet.blends, and ecnet.callbacks. The JOSS paper remains an appropriate
citation for the software’s publication history.
Citation
If you use ECNet in scholarly work, please cite:
Kessler, T., & Mack, J. H. (2017). ECNet: Large scale machine learning projects for fuel property prediction. Journal of Open Source Software, 2(17), 401. https://doi.org/10.21105/joss.00401
@article{Kessler2017,
doi = {10.21105/joss.00401},
url = {https://doi.org/10.21105/joss.00401},
year = {2017},
publisher = {The Open Journal},
volume = {2},
number = {17},
pages = {401},
author = {Kessler, Travis and Mack, John Hunter},
title = {ECNet: Large scale machine learning projects for fuel property prediction},
journal = {Journal of Open Source Software}
}
Contributing and support
See CONTRIBUTING.md for local development setup, hooks, and
checks. Report bugs and feature requests via GitHub issues (include OS, Python
version, and relevant error output).
Contact: Travis Kessler (travis.j.kessler@gmail.com) and John Hunter Mack (Hunter_Mack@uml.edu).
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ecnet-4.1.5.tar.gz.
File metadata
- Download URL: ecnet-4.1.5.tar.gz
- Upload date:
- Size: 36.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8b034d4c1c5c06e8f6ce011a675bfd61ce190d24caf6c26e6802bcb460a80c4b
|
|
| MD5 |
c4f99ffaea3ed2aaa18beb9420ff2868
|
|
| BLAKE2b-256 |
d85b124a7eed061e764868588e8feaaf9ca8db0d39c01b5226ebb9b03145d415
|
Provenance
The following attestation bundles were made for ecnet-4.1.5.tar.gz:
Publisher:
release.yml on ecrl/ecnet
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ecnet-4.1.5.tar.gz -
Subject digest:
8b034d4c1c5c06e8f6ce011a675bfd61ce190d24caf6c26e6802bcb460a80c4b - Sigstore transparency entry: 2220132728
- Sigstore integration time:
-
Permalink:
ecrl/ecnet@90714da3e40e31f55fd9f36ac09003125acaba03 -
Branch / Tag:
refs/tags/4.1.5 - Owner: https://github.com/ecrl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@90714da3e40e31f55fd9f36ac09003125acaba03 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ecnet-4.1.5-py3-none-any.whl.
File metadata
- Download URL: ecnet-4.1.5-py3-none-any.whl
- Upload date:
- Size: 36.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
474819a38a32732e85e84fd791a531398184ce6adf3b53280631a70c640cfca3
|
|
| MD5 |
562a45ffb05e3b4931e4a6c85b71e9b1
|
|
| BLAKE2b-256 |
b487a4e69aac0783f271d6ece15160998fbd78a629bc8e1a689d3318954b7b83
|
Provenance
The following attestation bundles were made for ecnet-4.1.5-py3-none-any.whl:
Publisher:
release.yml on ecrl/ecnet
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ecnet-4.1.5-py3-none-any.whl -
Subject digest:
474819a38a32732e85e84fd791a531398184ce6adf3b53280631a70c640cfca3 - Sigstore transparency entry: 2220133220
- Sigstore integration time:
-
Permalink:
ecrl/ecnet@90714da3e40e31f55fd9f36ac09003125acaba03 -
Branch / Tag:
refs/tags/4.1.5 - Owner: https://github.com/ecrl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@90714da3e40e31f55fd9f36ac09003125acaba03 -
Trigger Event:
release
-
Statement type:
