cosmol-viewer 0.1.5.dev7__cp37-abi3-manylinux_2_17_i686.manylinux2014_i686.whl → 0.1.7__cp37-abi3-manylinux_2_17_i686.manylinux2014_i686.whl

cosmol_viewer/__init__.pyi

@@ -5,7 +5,7 @@ def parse_sdf(
     keep_h: bool = True,
     multimodel: bool = True,
     onemol: bool = False
-) -> MoleculeData:
+) -> "MoleculeData":
     """
     Parse an SDF string into molecule data.
 
@@ -28,7 +28,7 @@ def parse_sdf(
 
 def parse_mmcif(
     mmcif: str
-) -> ProteinData:
+) -> "ProteinData":
     """
     Parse an MMCIF string into protein data.
 
@@ -374,13 +374,13 @@ class Protein:
     ```
     """
 
-    def __init__(self, molecule_data: "MoleculeData") -> None: ...
+    def __init__(self, mmcif_data: "ProteinData") -> None: ...
     def get_center(self) -> List[float]: ...
-    def centered(self) -> "Molecules": ...
-    def color(self, color: List[float]) -> "Molecules": ...
-    def color_rgba(self, color: List[float]) -> "Molecules": ...
-    def opacity(self, opacity: float) -> "Molecules": ...
-    def reset_color(self) -> "Molecules": ...
+    def centered(self) -> "Protein": ...
+    def color(self, color: List[float]) -> "Protein": ...
+    def color_rgba(self, color: List[float]) -> "Protein": ...
+    def opacity(self, opacity: float) -> "Protein": ...
+    def reset_color(self) -> "Protein": ...
 
 class ProteinData:
     """

{cosmol_viewer-0.1.5.dev7.dist-info → cosmol_viewer-0.1.7.dist-info}/METADATA

@@ -1,41 +1,43 @@
 Metadata-Version: 2.4
 Name: cosmol-viewer
-Version: 0.1.5.dev7
+Version: 0.1.7
 Summary: Molecular visualization tools
 Author-email: 95028 <wjt@cosmol.org>
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Repository, https://github.com/COSMol-repl/COSMol-viewer
 
 # COSMol-viewer
+A high-performance molecular viewer for Python and Rust, powered by a unified Rust core.
+It supports both in-notebook visualization and native desktop rendering, with smooth playback for scientific animations.
 
 <div align="center">
   <a href="https://crates.io/crates/cosmol_viewer">
-    <img src="https://img.shields.io/crates/v/cosmol_viewer.svg" alt="crates.io Latest Release"/>
+    <img src="https://img.shields.io/crates/v/cosmol_viewer.svg" alt="crates.io Latest Release" />
   </a>
   <a href="https://pypi.org/project/cosmol_viewer/">
-    <img src="https://img.shields.io/pypi/v/cosmol_viewer.svg" alt="PyPi Latest Release"/>
+    <img src="https://img.shields.io/pypi/v/cosmol_viewer.svg" alt="PyPi Latest Release" />
   </a>
   <a href="https://cosmol-repl.github.io/COSMol-viewer">
-    <img src="https://img.shields.io/badge/docs-latest-blue.svg" alt="Documentation Status"/>
+    <img src="https://img.shields.io/badge/docs-latest-blue.svg" alt="Documentation Status" />
   </a>
 </div>
 
-A high-performance molecular viewer for `Python` and `Rust`, backed by `Rust`.
-Supports both static rendering and smooth animation playback — including inside Jupyter notebooks.
+COSMol-viewer is a compact, cross-platform renderer for molecular and geometric scenes.
+Unlike purely notebook-bound solutions such as py3Dmol, COSMol-viewer runs everywhere:
 
+- Native desktop window (Python or Rust) via `egui`
+- Jupyter / IPython notebook via WASM backend
+- Rust applications
 
-A compact, high-performance renderer for molecular and scientific shapes with two usage patterns:
-
-- **Static rendering + update** — push individual scene updates from your application or simulation.
-- **Play (recommended for demonstrations & smooth playback)** — precompute frames and hand the sequence to the viewer to play back with optional interpolation (`smooth`).
+All implementations share the same Rust rendering engine, ensuring consistent performance and visual output.
 
 ---
 
 ## Quick concepts
 
-- **Scene**: container for shapes (molecules, spheres, lines, etc.).
+- **Scene**: container for shapes (molecules, proteins, spheres, etc.).
 - **Viewer.render(scene, ...)**: create a static viewer bound to a canvas (native or notebook). Good for static visualization.
-- **viewer.update(scene)**: push incremental changes (real-time / streaming use-cases).
+- **viewer.update(scene)**: push incremental changes after `Viewer.render()` (real-time / streaming use-cases).
 - **Viewer.play(frames, interval, loops, width, height, smooth)**: *recommended* for precomputed animations and demonstrations. The viewer takes care of playback timing and looping.
 
 **Why prefer `play` for demos?**
@@ -48,27 +50,23 @@ A compact, high-performance renderer for molecular and scientific shapes with tw
 
 ---
 
-## Installation
+# Usage
 
-```sh
-pip install cosmol-viewer
-```
+## python
+See examples in [Google Colab](https://colab.research.google.com/drive/1Sw72QWjQh_sbbY43jGyBOfF1AQCycmIx?usp=sharing).
 
----
+Install with `pip install cosmol-viewer`
 
-## Quick Start
-See examples in [Google Colab](https://colab.research.google.com/drive/1Sw72QWjQh_sbbY43jGyBOfF1AQCycmIx?usp=sharing).
 ### 1. Static molecular rendering
 
 ```python
 from cosmol_viewer import Scene, Viewer, parse_sdf, Molecules
+    
+mol_data  = parse_sdf(open("molecule.sdf", "r", encoding="utf-8").read())
 
-with open("molecule.sdf", "r") as f:
-    sdf = f.read()
-    mol = Molecules(parse_sdf(sdf)).centered()
+mol = Molecules(mol_data).centered()
 
 scene = Scene()
-scene.scale(0.1)
 scene.add_shape(mol, "mol")
 
 viewer = Viewer.render(scene, width=600, height=400)
@@ -81,9 +79,6 @@ _ = input()  # Keep the viewer open until you decide to close
 
 ```python
 from cosmol_viewer import Scene, Viewer, parse_sdf, Molecules
-import time
-
-interval = 0.033   # ~30 FPS
 
 frames = []
 
@@ -93,15 +88,24 @@ for i in range(1, 10):
         mol = Molecules(parse_sdf(sdf)).centered()
 
     scene = Scene()
-    scene.scale(0.1)
     scene.add_shape(mol, "mol")
-
     frames.append(scene)
 
-Viewer.play(frames, interval=interval, loops=1, width=600, height=400, smooth=True)
+Viewer.play(frames, interval=0.033, loops=-1, width=800, height=500, smooth=True) # loops=-1 for infinite repeat
+```
+
+more examples can be found in the [examples](https://github.com/COSMol-repl/COSMol-viewer/tree/main/cosmol_viewer/examples) folder:
+```bash
+cd cosmol_viewer
+python .\examples\render_protein.py
 ```
 
-## Documentation
+# Documentation
+
+Please check out our documentation at [here](https://cosmol-repl.github.io/COSMol-viewer/).
+
+---
 
-For API reference and advanced usage, please see the [latest documentation](https://cosmol-repl.github.io/COSMol-viewer).
+# Contact
 
+For any questions, issues, or suggestions, please contact [wjt@cosmol.org](mailto:wjt@cosmol.org) or open an issue in the repository. We will review and address them as promptly as possible.

cosmol_viewer-0.1.7.dist-info/RECORD

@@ -0,0 +1,7 @@
+cosmol_viewer-0.1.7.dist-info/METADATA,sha256=vcEi0GjgyKTUmhvB-LJxpoqdUE6JzQKf8W1zte1ESVs,3984
+cosmol_viewer-0.1.7.dist-info/WHEEL,sha256=oB91FzNpC-hO8c8ewOPvbQZBthpYN_59_Trh5rKisIg,139
+cosmol_viewer/__init__.py,sha256=K33zoYpHqUVvpFdMVxmCtw4uKj9ZXrGuQD4D4DuUmjk,135
+cosmol_viewer/__init__.pyi,sha256=dHeDzQd2wiBI2j6byAn6bxnVRxXNGVRBDYLaHPYVr4c,10210
+cosmol_viewer/cosmol_viewer.abi3.so,sha256=mqNEkOROmnWhd4kx8xQ040MG8XjawSgRvuY2z_6ifII,14092820
+cosmol_viewer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cosmol_viewer-0.1.7.dist-info/RECORD,,

cosmol_viewer-0.1.5.dev7.dist-info/RECORD

@@ -1,7 +0,0 @@
-cosmol_viewer-0.1.5.dev7.dist-info/METADATA,sha256=qaTJlkdyqV0wercZDDVmYbUY1x_UXNX8UuhBC8uCBAk,3579
-cosmol_viewer-0.1.5.dev7.dist-info/WHEEL,sha256=oB91FzNpC-hO8c8ewOPvbQZBthpYN_59_Trh5rKisIg,139
-cosmol_viewer/__init__.py,sha256=K33zoYpHqUVvpFdMVxmCtw4uKj9ZXrGuQD4D4DuUmjk,135
-cosmol_viewer/__init__.pyi,sha256=fNOQlMLuOiY6IJxHG8hmdJxeaSbaz4Vn45f3oi17Gyg,10220
-cosmol_viewer/cosmol_viewer.abi3.so,sha256=v5k_up9PYWf9jccaRx54yW8qwVIxrG_ISXYUeSzNOf0,29500808
-cosmol_viewer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cosmol_viewer-0.1.5.dev7.dist-info/RECORD,,