Skip to main content

Protein structure visualization agent for Lobster AI - 3D structural biology and PyMOL integration

Project description

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

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

lobster_structural_viz-1.1.406.tar.gz (41.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lobster_structural_viz-1.1.406-py3-none-any.whl (48.0 kB view details)

Uploaded Python 3

File details

Details for the file lobster_structural_viz-1.1.406.tar.gz.

File metadata

  • Download URL: lobster_structural_viz-1.1.406.tar.gz
  • Upload date:
  • Size: 41.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for lobster_structural_viz-1.1.406.tar.gz
Algorithm Hash digest
SHA256 1d8312552cfc9c96293d4cdfe7586213d7e898f4d9afce7ba6f994518b58e3b7
MD5 1ee5a5e7cf82f853f30e30e7ecf48a84
BLAKE2b-256 d5c1a7e3b9c0d400699249a95309ab94c5b23b6f4295cb32c2f255ff51e1ec23

See more details on using hashes here.

Provenance

The following attestation bundles were made for lobster_structural_viz-1.1.406.tar.gz:

Publisher: publish-packages.yml on the-omics-os/lobster

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lobster_structural_viz-1.1.406-py3-none-any.whl.

File metadata

File hashes

Hashes for lobster_structural_viz-1.1.406-py3-none-any.whl
Algorithm Hash digest
SHA256 e9f9931f0be27e0049a4c5f9a5d3e206e86351862762c37d41b21ec4886c29c2
MD5 ee9241fe6927cdcead601073ea1867c7
BLAKE2b-256 859a6940ad9f85c8d1814724254aeb8ab948144dd5be451aa88e4135f881143d

See more details on using hashes here.

Provenance

The following attestation bundles were made for lobster_structural_viz-1.1.406-py3-none-any.whl:

Publisher: publish-packages.yml on the-omics-os/lobster

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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