Skip to main content

LigninGraphs is an open-source software package in Python to generate feasible lignin structures.

Lignin is an aromatic biopolymer found in ubiquitous sources of woody biomass such as wood and bark. Designing and optimizing lignin valorization processes requires a fundamental understanding of lignin structures. We introduce a graph-based multiscale modeling framework for lignin structure generation and visualization. The framework employs accelerated rejection-free polymerization and hierarchical Metropolis Monte Carlo optimization algorithms. It can be used to generate feasible lignin strutcures to match experimental or literature data.

docs/source/logos/ligning_logo.png

Documentation

See our documentation page for examples, equations used, and docstrings.

Developers

Dependencies

  • Python >= 3.7

  • RDKit >= 2021.09.1: Used for constructing feasible chemical structures

  • Networkx >= 1.4: Used for computational graph operations

  • Pysmiles >= 1.0.1: Used for reading and writing smiles strings from/to graphs

  • Matplotlib: Used for generating plots

  • Numpy: Used for vector and matrix operations

  • Scipy: Used for curve fitting

  • Pandas: Used to import data from Excel or CSV files

  • openpyxl: Used by Pandas to import Excel files

  • pytest: Used for unit tests

Getting Started

  1. Install using pip (see documentation for full instructions):

    pip install ligning
  2. Run the unit tests.

  3. Read the documentation for tutorials and examples.

License

This project is licensed under the MIT License - see the LICENSE.md. file for details.

Contributing

If you have a suggestion or find a bug, please post to our Issues page on GitHub.

Questions

If you are having issues, please post to our Issues page on GitHub.

Funding

This material is based upon work supported by the Department of Energy’s Office of Energy Efficient and Renewable Energy’s Advanced Manufacturing Office under Award Number DE-EE0007888-9.5.

Acknowledgements

  • Siyi Huang (Logo design)

Publications

Metadata

Release files for ligning 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ligning 0.1.1
File Size Uploaded
ligning-0.1.1.tar.gz 31.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ligning 0.1.1
File Interpreter ABI Platform
ligning-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 63.3 kB

Release files / ligning-0.1.1.tar.gz

Download URL ligning-0.1.1.tar.gz
Size 31.3 kB
Tags Source
SHA-256 checksum
How to use checksums
28fce11b008c755e88b4c27b53bc4276215868c9ad3a11e8ce052d6cba77adbf
BLAKE2b-256 checksum
How to use checksums
70f00d5101affd663d48af604e70861256c0fd5edb5d072908bcaf5c549e2a60
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.7.6

Release files / ligning-0.1.1-py3-none-any.whl

Download URL ligning-0.1.1-py3-none-any.whl
Size 32.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
43558a3e60c5da587eedb25e74ad4fe22ebd8b8822b40782a34aac8d36910c10
BLAKE2b-256 checksum
How to use checksums
430e94c641574e2bfcccf733f1568c538198838b4dcc576bb3ad61b7f667d695
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.7.6

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page