Skip to main content

lobster-structural-viz

Protein structure visualization and analysis with PyMOL and ChimeraX integration.

Installation

pip install lobster-structural-viz

Agents

Agent Description
protein_structure_visualization_expert Structural biology specialist. PDB fetching, 3D visualization, structural analysis, and omics data integration.

Services

Service Purpose
ProteinStructureFetchService Download structures from RCSB PDB with metadata extraction
PyMOLVisualizationService Generate 3D visualizations using PyMOL
ChimeraXVisualizationService Alternative visualizations with UCSF ChimeraX (ALPHA)
StructureAnalysisService Secondary structure, geometry, and RMSD calculations

Features

Structure Fetching

  • Download from RCSB PDB database with automatic caching
  • Comprehensive metadata extraction (organism, method, resolution)
  • Support for PDB, mmCIF, and biological assembly formats
  • Batch download for structure comparison workflows

3D Visualization (PyMOL)

  • Interactive mode for GUI-based exploration
  • Batch mode for automated PNG image generation
  • Multiple representation styles: cartoon, surface, sticks, spheres, ribbon
  • Color schemes: chain, secondary_structure, bfactor, element, custom
  • Residue highlighting for disease mutations, binding sites, active sites
  • Ray-traced high-quality rendering for publication figures

Structural Analysis

  • Secondary structure distribution analysis (DSSP)
  • Geometric properties: radius of gyration, chain length, surface area
  • Residue contact maps and distance matrices
  • B-factor analysis for flexibility assessment

Structure Comparison

  • RMSD calculation with optional structural alignment
  • Biological interpretation of similarity scores
  • Chain-specific comparisons for multi-chain complexes
  • Sequence identity and structural coverage metrics

Data Integration

  • Link gene expression levels to PDB structures
  • Filter differentially expressed genes by structure availability
  • Cross-reference proteomics data with structural annotations
  • Annotate structures with functional data from omics analysis

Requirements

  • Python 3.12+
  • lobster-ai >= 1.0.0
  • PyMOL (optional, for visualization execution)

PyMOL Installation

For visualization execution, install PyMOL:

# macOS/Linux via Homebrew
brew install brewsci/bio/pymol

# Or download from https://pymol.org/

If PyMOL is not installed, the agent generates command scripts that can be executed manually.

Documentation

Full documentation: docs.omics-os.com/docs/agents/structural-viz

License

AGPL-3.0-or-later

Metadata

Release files for lobster-structural-viz 1.2.0

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

Source distribution (sdist)

Source distribution for lobster-structural-viz 1.2.0
File Size Uploaded Provenance Actions
lobster_structural_viz-1.2.0.tar.gz 44.4 kB With provenance Details for lobster_structural_viz-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lobster-structural-viz 1.2.0
File Interpreter ABI Platform Actions
lobster_structural_viz-1.2.0-py3-none-any.whl Python 3 none any Details for lobster_structural_viz-1.2.0-py3-none-any.whl

Total release size: 94.2 kB

Release files / lobster_structural_viz-1.2.0.tar.gz

Download URL lobster_structural_viz-1.2.0.tar.gz
Size 44.4 kB
Tags Source
SHA-256 checksum
How to use checksums
3d8ad9dc3a1c62a6accb29ed69d5ce08dcfd8679497383ae86f1bd247371cdd3
BLAKE2b-256 checksum
How to use checksums
bcb7abd6ddcf8d997330942ef69864e60c5d497ee95243b772d63a13ec840b02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Release files / lobster_structural_viz-1.2.0-py3-none-any.whl

Download URL lobster_structural_viz-1.2.0-py3-none-any.whl
Size 49.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
689074983981c12855b441d8a4d6e978f455ae8ff0244c65327418f467eff9ac
BLAKE2b-256 checksum
How to use checksums
8f7b72b3a8530601997873fd1e62f115cbd919007a2a7c1914d5a5ca7be7e13d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Security for lobster-structural-viz 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for lobster_structural_viz-1.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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