Skip to main content

A library for advanced scientific calculations and visualization

Project description

sage_lib

Overview

sage_lib is a versatile library designed for advanced scientific computations and visualization. It enables users to process atomic structures, perform thermodynamic analyses, generate band structures, and handle various tasks commonly required in quantum mechanical and molecular dynamics studies. The primary focus of this library is to simplify complex workflows, enabling researchers to conduct simulations, generate graphical representations, and export data in multiple formats with ease.

Features

Atomic Position Export: Converts atomic position files from one format to another, making data compatible with different simulation tools or visualization software.

Plot Generation: Generates plots based on simulation data, such as band structures or molecular arrangements. This includes support for visualizing results from popular tools like VASP.

Thermodynamic Analysis: Provides methods to calculate thermodynamic properties based on ab initio data. This includes phase diagrams, ensemble analysis, and more.

Blender Integration for Rendering: Uses Blender to render atomic structures and molecular arrangements. Supports customization like resolution, camera angles, and the addition of fog effects.

Dynamic Molecular Analysis: Analyzes molecular dynamics data, tracking species counts, evaluating force fields, and computing properties such as diffusion coefficients and bond distances.

Configuration Generation and Editing: Reads atomic structures and configurations, applies specified editing operations, and exports new structures. This includes operations like creating supercells, rattling atomic positions, and applying compressions.

Solvent Environment Generation: Creates a solvent environment around a given molecular or atomic structure, supporting various solvents and configurations to simulate realistic environments.

Dimer Search and Analysis: Facilitates dimer search to analyze interactions between specific pairs of atoms, which is useful for studying catalytic activity and other atomic-scale interactions.

Surface Disassembly: Generates configurations that allow the disassembly of surfaces, which is particularly useful for understanding surface stability and catalysis.

Customizable File Management: Provides functionalities for handling, reading, and exporting files in different formats including VASP, XYZ, and others.

Installation

To install sage_lib, use the following command:

pip install sage_lib

Ensure that you have Python 3.7 or higher.

Usage

sage_lib can be used from the command line or programmatically.

Command Line Usage

The library includes a console command sage which can be used to execute various subcommands:

sage export --path ./data --source VASP --output_path ./converted --output_source PDB

This command will convert atomic position files from VASP format to PDB format, saving the output in the ./converted directory.

Another example for generating a plot:

sage plot --path ./data --plot bands --fermi 5.0 --output_path ./plots

This command generates a band structure plot using the data found in the specified directory.

Programmatic Usage

Below is a Python example that demonstrates how to use sage_lib programmatically:

from sage_lib.partition import Partition

Initialize a Partition object

PT = Partition(path='./data')

Read files from a specified location

PT.read_files(file_location='./data', source='VASP', verbose=True)

Export files in a different format

PT.export_files(file_location='./output', source='PDB', verbose=True)

This example initializes a Partition object, reads files from a directory, and exports them to a different format.

Dependencies

sage_lib requires the following packages:

numpy: for numerical operations

matplotlib: for plotting and visualization

scipy: for scientific computations

imageio: for managing image files

Optional dependencies include:

pytest: for testing

flake8: for code linting

sphinx: for generating documentation

License

sage_lib is licensed under the MIT License. For more details, refer to the LICENSE file.

Contributing

Contributions are welcome! Please feel free to open an issue or a pull request on the GitHub repository to contribute to the project.

Contact

For questions, please contact the author via email: lombardi@fhi-berlin.mpg.de

For bug reports or feature requests, visit the issues page.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

sage_lib-0.1.5.27.tar.gz (306.3 kB view details)

Uploaded Source

Built Distribution

sage_lib-0.1.5.27-py3-none-any.whl (421.5 kB view details)

Uploaded Python 3

File details

Details for the file sage_lib-0.1.5.27.tar.gz.

File metadata

  • Download URL: sage_lib-0.1.5.27.tar.gz
  • Upload date:
  • Size: 306.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for sage_lib-0.1.5.27.tar.gz
Algorithm Hash digest
SHA256 d3625465c2c07a263cbd1bf6d1022754aff528737bd9b9d0ef03bc9e0a324d5d
MD5 6828737b824239dccb6f054baf2c79be
BLAKE2b-256 f7992fdc2e5939940c443d37debc3841995f0f5070be13ff746a2e3b501e0e29

See more details on using hashes here.

File details

Details for the file sage_lib-0.1.5.27-py3-none-any.whl.

File metadata

  • Download URL: sage_lib-0.1.5.27-py3-none-any.whl
  • Upload date:
  • Size: 421.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for sage_lib-0.1.5.27-py3-none-any.whl
Algorithm Hash digest
SHA256 92631b38c7c7180da419ba5e7da92beb65f69b33647d2c1b2ac6c5c80f30ff9e
MD5 06f3f62430303474e406db57d55c0e35
BLAKE2b-256 5641240176ba7d976ebd9b200d37ad04e28bffcca7062fd3accddcb89ce4ec66

See more details on using hashes here.

Supported by

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