MoleditPy 4.11.0__tar.gz → 4.11.2__tar.gz

{moleditpy-4.11.0 → moleditpy-4.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MoleditPy
-Version: 4.11.0
+Version: 4.11.2
 Summary: A cross-platform, simple, and intuitive molecular structure editor built in Python. It allows 2D molecular drawing and 3D structure visualization. It supports exporting structure files for input to DFT calculation software.
 Author-email: HiroYokoyama <titech.yoko.hiro@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -696,8 +696,8 @@ License-File: LICENSE
 Requires-Dist: numpy
 Requires-Dist: pyqt6<6.10; python_version == "3.9"
 Requires-Dist: pyqt6<6.12; python_version != "3.9"
-Requires-Dist: pyvista<0.49
-Requires-Dist: pyvistaqt<0.13
+Requires-Dist: pyvista<0.50
+Requires-Dist: pyvistaqt<0.14
 Requires-Dist: rdkit<2026.4
 Requires-Dist: openbabel-wheel<3.2
 Dynamic: license-file
@@ -705,148 +705,45 @@ Dynamic: license-file
 # MoleditPy — A Python Molecular Editor
 
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17268532.svg)](https://doi.org/10.5281/zenodo.17268532)
-![MoleditPy](https://img.shields.io/badge/MoleditPy-v4-3577F7)
-[![Powered by RDKit](https://img.shields.io/badge/Powered%20by-RDKit-3838ff.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQBAMAAADt3eJSAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAFVBMVEXc3NwUFP8UPP9kZP+MjP+0tP////9ZXZotAAAAAXRSTlMAQObYZgAAAAFiS0dEBmFmuH0AAAAHdElNRQfmAwsPGi+MyC9RAAAAQElEQVQI12NgQABGQUEBMENISUkRLKBsbGwEEhIyBgJFsICLC0iIUdnExcUZwnANQWfApKCK4doRBsKtQFgKAQC5Ww1JEHSEkAAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAyMi0wMy0xMVQxNToyNjo0NyswMDowMDzr2J4AAAAldEVYdGRhdGU6bW9kaWZ5ADIwMjItMDMtMTFUMTU6MjY6NDcrMDA6MDBNtmAiAAAAAElFTkSuQmCC)](https://www.rdkit.org/)
 [![PyPI version](https://badge.fury.io/py/MoleditPy.svg)](https://badge.fury.io/py/MoleditPy)
 [![Python Versions](https://img.shields.io/badge/python-3.9--3.14-blue.svg)](https://pypi.org/project/MoleditPy/)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![Build Status](https://github.com/HiroYokoyama/python_molecular_editor/actions/workflows/tests.yml/badge.svg)](https://github.com/HiroYokoyama/python_molecular_editor/actions)
 [![codecov](https://codecov.io/gh/HiroYokoyama/python_molecular_editor/graph/badge.svg)](https://codecov.io/gh/HiroYokoyama/python_molecular_editor)
-[![GUI Status](https://img.shields.io/badge/GUI-Manually_Verified-blue)](https://github.com/HiroYokoyama/python_molecular_editor/blob/main/tests/MANUAL_CHECKLIST.md)
-[![Pylint Score](https://img.shields.io/badge/pylint->9%2F10-brightgreen)](https://github.com/HiroYokoyama/python_molecular_editor/blob/main/tests/pylint-score.txt)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/moleditpy?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/moleditpy)
-[![PyPI Downloads](https://static.pepy.tech/personalized-badge/moleditpy?period=monthly&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=monthly+downloads)](https://pepy.tech/projects/moleditpy)
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/HiroYokoyama/python_molecular_editor)
 [![](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/HiroYokoyama)
 
-[🇯🇵 日本語 (Japanese)](#japanese)
+**MoleditPy** is a programmable, cross-platform molecular editor built with PyQt6, RDKit, and PyVista. It takes you from a 2D sketch to an editable 3D structure and out to input files for DFT calculations, and it can be extended with plain Python plugins.
 
-**MoleditPy** is a **programmable** and cross-platform molecular editor built in Python. It streamlines the workflow from 2D drawing to 3D visualization, making it an **ideal tool for rapidly preparing input files for DFT calculations**. Designed as an **open platform**, it also allows users to freely extend its capabilities, writing custom Python scripts to manipulate molecular data, automate tasks, or integrate new cheminformatics algorithms seamlessly.
-
-**Author**: HiroYokoyama
-**License**: GPL-v3
-**Repository**: [https://github.com/HiroYokoyama/python\_molecular\_editor](https://github.com/HiroYokoyama/python_molecular_editor)
-
------
-<p align="center">
-  <img src="https://hiroyokoyama.github.io/python_molecular_editor/img/icon.png" width="500" alt="MoleditPy Icon">
-</p>
+**[Website](https://hiroyokoyama.github.io/python_molecular_editor/)** · **[User manual](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual)** ([日本語](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual-JP)) · **[Plugins](https://hiroyokoyama.github.io/moleditpy-plugins/)** · **[Wiki](https://github.com/HiroYokoyama/python_molecular_editor/wiki)**
 
 ![MoleditPy screenshot](https://hiroyokoyama.github.io/python_molecular_editor/img/screenshot.png)
 
+## Features
 
-## Overview
-
-This application combines a modern GUI built with **PyQt6**, powerful cheminformatics capabilities from **RDKit**, and high-performance 3D rendering by **PyVista** to provide an easy-to-use tool for drawing and visually inspecting molecular structures.
-
-## Key Features
-
-　Please refer to the [user manual](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual) for details.
-
-### 1\. 2D Drawing and Editing
-
-  * **Intuitive Operations:** Easily add, edit, and delete atoms and bonds with simple mouse controls. Left-click and drag to create, and right-click to delete.
-  * **Advanced Templates:** Place templates for benzene or 3- to 9-membered rings with a live preview. Features intelligent logic to automatically adjust the double-bond configuration when fusing a benzene ring to an existing structure.
-  * **Alkyl Chain Tool:** Drag to draw a zigzag chain of any length — the bond length stays fixed, the chain axis snaps to 15° steps, and the number of carbons that will be added (`n`) is previewed next to the cursor.
-  * **Charges & Radicals:** Quickly set formal charges (`+`/`-`) and radicals (`.`) on any atom using keyboard shortcuts or the toolbar.
-  * **Full Element Support:** Select any element from a built-in periodic table dialog.
-  * **Clipboard Operations:** Full support for `Cut` (Ctrl+X), `Copy` (Ctrl+C), and `Paste` (Ctrl+V) for molecular fragments.
-
-### 2\. 3D Visualization and Advanced Editing
-
-  * **2D-to-3D Conversion:** Generate a 3D conformation from your 2D drawing using RDKit's powerful algorithms. Includes a robust fallback to Open Babel if the primary method fails.
-  * **Interactive 3D Editing:** Perform **comprehensive geometric editing**, including dragging atoms directly in the 3D view to intuitively create specific conformations.
-  * **Precise Geometric Control:** A **powerful suite of tools** for precise geometric control:
-      * **Translation:** Move the entire molecule or selected atoms to specific coordinates.
-      * **Alignment:** Align the molecule by placing two selected atoms along the X, Y, or Z axis.
-      * **Planarization:** Force a selection of atoms to lie on a specified plane (XY, XZ, or YZ) or project them onto their **best-fit plane**.
-      * **Mirror:** Create a mirror image of the molecule across a selected plane (XY, XZ, or YZ).
-      * **Set Bond Length, Angle, & Dihedral Angle:** Set precise numerical values for distances, angles, and torsional angles.
-      * **Constrained Optimization:** Perform force field optimization (MMFF/UFF) while applying fixed constraints to specific distances, angles, or dihedral angles.
-  * **3D Measurement Tools:** The "Select" mode allows you to click on atoms in the 3D view to instantly measure and display:
-      * **Distance** (between 2 atoms)
-      * **Angle** (between 3 atoms)
-      * **Dihedral Angle** (between 4 atoms)
-  * **Structure Optimization:** Perform 3D structure optimization using MMFF94 or UFF force fields.
-  * **Multiple Display Styles:** Visualize molecules as "Ball & Stick," "CPK (Space-filling)," "Wireframe," or "Stick" models.
-
-### 3\. Analysis and Export
-
-  * **Molecular Properties Analysis:** A dedicated window displays key molecular properties calculated by RDKit, such as molecular formula, weight, SMILES, LogP, and TPSA.
-  * **Stereochemistry Display:** Automatically identifies and displays R/S labels for chiral centers in the 3D view after conversion.
-  * **File I/O:**
-      * Save and load entire sessions, including 2D/3D data and constraints, with the native `.pmeprj` project file.
-      * Import structures from **MOL/SDF/XYZ** files or **SMILES/InChI** strings.
-      * Export 3D structures to **MOL** or **XYZ** formats, which are compatible with most DFT calculation software.
-      * Export 2D views as high-resolution PNG or SVG images, and 3D views as PNG images.
-      * Export the 3D model as **STL** or **OBJ/MTL** files for 3D printing and rendering.
-      * **Security note on `.pmeraw`:** the legacy `.pmeraw` project format uses Python pickle, which can execute arbitrary code when loaded. Only open `.pmeraw` files that you created yourself; prefer the JSON-based `.pmeprj` format for sharing.
-
-### 4. Programmable & Extensible
-
-  * **Python Plugin System:** Drop your Python scripts into the plugin folder, and they instantly become part of the application menu.
-  * **Downloadable Plugins:** Explore and download specialized plugins from the [Plugin Explorer](https://hiroyokoyama.github.io/moleditpy-plugins/explorer/).
-  * **Full API Access:** Plugins have direct access to the `MainWindow`, `RDKit` molecule objects, and the Qt graphics items of the 2D scene, allowing for limitless customization.
-  * **Rapid Prototyping:** Ideal for researchers who need to test new algorithms or workflow automations on the fly.
-
-## Installation and Execution
-
-For detailed instructions, please refer to the project [Wiki](https://github.com/HiroYokoyama/python_molecular_editor/wiki). A [Docker version](https://github.com/HiroYokoyama/python_molecular_editor_docker) is also available. A [Windows installer](https://hiroyokoyama.github.io/python_molecular_editor/windows-installer/windows_installer) and a [macOS app bundle](https://hiroyokoyama.github.io/python_molecular_editor/macos-installer/macos_installer) are also distributed.
-
-#### Requirements
-
-`PyQt6`, `RDKit`, `NumPy`, `PyVista`, `pyvistaqt`, `openbabel`
-
-#### Installation
-
-1.  **Install the Package**
-    This will automatically install the correct `moleditpy` (for Win/Mac) or `moleditpy-linux` (for Linux) as a dependency.
+- **2D drawing** — atoms, bonds, ring templates, alkyl chains, charges, radicals, stereo bonds, and the full periodic table.
+- **3D editing** — 2D-to-3D conversion, dragging atoms in the 3D view, exact bond lengths, angles, and dihedrals, and MMFF94/UFF optimization with constraints.
+- **Analysis and export** — molecular properties, R/S labels, MOL/SDF/XYZ/SMILES/InChI import and export, PNG/SVG images, and STL/OBJ for 3D printing.
+- **Plugins** — drop a Python file into the plugin folder to add menu actions and tools. Browse the official collection in the [Plugin Explorer](https://hiroyokoyama.github.io/moleditpy-plugins/explorer/).
 
-    ```bash
-    pip install moleditpy-installer
-    ```
+See the [user manual](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual) for every feature and keyboard shortcut.
 
-2.  **Create the Shortcut**
-    After installation, run this command to create the shortcut in your application menu (e.g., Start Menu or Applications folder).
+## Installation
 
-    ```bash
-    python -m moleditpy_installer
-    ```
+```bash
+pip install moleditpy-installer
+python -m moleditpy_installer
+```
 
-#### Running the Application
+The first command installs the right package for your platform (`moleditpy`, or `moleditpy-linux` on Linux); the second creates an application shortcut. Start the app from the shortcut or with:
 
 ```bash
 moleditpy
 ```
 
-**(Note: The first launch may take some time while libraries like RDKit are initialized.)**
-
-## Keyboard Shortcuts
-
-| Key | Action | Notes |
-| :--- | :--- | :--- |
-| `1`/`2`/`3` | Change bond order | Single/Double/Triple bond |
-| `W`/`D` | Change to stereochemical bond | Wedge / Dash bond |
-| `Delete`/`Backspace` | Delete item(s) | Deletes selected or hovered items |
-| `.` | Toggle radical | Cycles through 0, 1, and 2 radicals |
-| `+`/`-` | Increase/Decrease charge | Changes formal charge |
-| `C`, `N`, `O`, etc. | Change atom symbol | Applies to atom under cursor |
-| `4` | Place benzene ring | One-shot placement on atom/bond |
-| `Space` | Toggle select mode / Select all | |
-| `Ctrl+J` | Perform 2D optimization (Clean Up) | |
-| `Ctrl+K` | Perform 2D-to-3D conversion | |
-| `Ctrl+L` | Perform 3D structure optimization | |
-
-## Technical Details
+The first launch can take a while as RDKit and the other libraries initialize. A [Windows installer](https://hiroyokoyama.github.io/python_molecular_editor/windows-installer/windows_installer), a [macOS app bundle](https://hiroyokoyama.github.io/python_molecular_editor/macos-installer/macos_installer), and a [Docker image](https://github.com/HiroYokoyama/python_molecular_editor_docker) are also available.
 
-  * **GUI and 2D Drawing (PyQt6):** The editor is built on a `QGraphicsScene`, where custom `AtomItem` and `BondItem` objects are interactively manipulated. The Undo/Redo feature is implemented by serializing the application state.
-  * **Chemical Calculations (RDKit / Open Babel):** RDKit is used to generate molecule objects from 2D data, perform 3D coordinate generation, and calculate properties. Open Babel serves as a fallback for 3D conversion. All heavy computations are run on a separate `QThread` to keep the GUI responsive.
-  * **3D Visualization (PyVista / pyvistaqt):** 3D rendering is achieved by generating PyVista meshes (spheres and cylinders) from RDKit conformer coordinates. A custom `vtkInteractorStyle` enables direct drag-and-drop editing of atoms in the 3D view.
-  * **Modular Architecture:** The codebase is organized into dedicated packages for `core` logic, `ui` components, and `utils`. The `MainWindow` acts as a composition hub that delegates all work to specialized manager objects (state, I/O, 3D view, dialogs), ensuring long-term maintainability and easier verification.
-
-## License & Disclaimer
-
-This project is licensed under the GNU General Public License v3.0 (GPLv3) - see the [LICENSE](https://github.com/HiroYokoyama/python_molecular_editor/blob/main/LICENSE) file for details. As open-source software, it is provided 'as is' without warranty of any kind, and the author assumes no responsibility or liability for the results. Although outputs have been carefully verified, users are strongly encouraged to independently check and validate them for critical applications (such as publications). If you encounter any bugs, please open an issue.
+> **Security note:** the legacy `.pmeraw` project format uses Python pickle, which can execute arbitrary code when loaded. Only open `.pmeraw` files you created yourself, and use the JSON-based `.pmeprj` format for sharing.
 
 ## Citation
 
@@ -856,140 +753,8 @@ If you use this software in your work, please cite it as follows:
 Yokoyama, H. (2026). MoleditPy — A Python-based molecular editing software. Zenodo. https://doi.org/10.5281/zenodo.17268532
 ```
 
-Additionally, please cite the plugins you used.
-
------
-
-<div id="japanese"></div>
-
-# MoleditPy — A Python Molecular Editor
-
-**MoleditPy**は、Pythonで構築された**機能拡張が自由自在な**分子エディタープラットフォームです。2D描画から3Dへの変換により、**DFT計算用インプットの迅速な作成に最適なツール**であると同時に、**Pythonスクリプトを用いて必要な機能をユーザー自身が手軽に追加・開発できる**柔軟な環境を提供します。
-
-**作者**: HiroYokoyama
-**ライセンス**: GPL-v3
-**リポジトリ**: [https://github.com/HiroYokoyama/python\_molecular\_editor](https://github.com/HiroYokoyama/python_molecular_editor)
-
------
-
-## 概要
-
-このアプリケーションは、**PyQt6**によるモダンなGUI、**RDKit**による強力な化学計算、**PyVista**による高性能な3Dレンダリングを組み合わせ、分子構造の描画と視覚的な確認を容易にするツールです。
-
-## 主な機能
+Please also cite the plugins you used; see [Citation in the plugin collection](https://github.com/HiroYokoyama/moleditpy-plugins#citation).
 
-詳細は、[ユーザーマニュアル](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual-JP)を参照してください。
-
-### 1\. 2D描画と編集
-
-  * **直感的な操作:** シンプルなマウス操作で原子や結合を簡単に追加、編集、削除できます。左クリック＆ドラッグで作成し、右クリックで削除します。
-  * **高度なテンプレート機能:** ベンゼン環や3〜9員環のテンプレートをライブプレビューしながら配置できます。既存の構造にベンゼン環を縮環させる際には、二重結合の配置を自動的に調整するインテリジェントなロジックを備えています。
-  * **電荷とラジカル:** キーボードショートカット (`+`/`-`/`.`) やツールバーを使って、任意の原子に形式電荷やラジカルを素早く設定できます。
-  * **全元素対応:** 内蔵の周期表ダイアログから任意の元素を選択できます。
-  * **クリップボード操作:** 分子フラグメントの`カット` (Ctrl+X)、`コピー` (Ctrl+C)、`ペースト` (Ctrl+V) に完全対応しています。
-
-### 2\. 3D可視化と高度な編集
-
-  * **2D-3D変換:** 描画した2D構造から、RDKitの強力なアルゴリズムを用いて3D構造を生成します。主要な手法が失敗した場合は、Open Babelによるフォールバック機能を備えています。
-  * **インタラクティブ3D編集:** 3Dビュー内の原子を直接ドラッグ操作でき、分子の形状を**本格的に編集**できます。これにより、理論計算で検討したい特定の配座を直感的に作成できます。
-  * **精密な幾何学制御:** **精密な幾何学制御のための強力なツール群**を提供します。
-      * **平行移動:** 分子全体または選択原子群を特定の座標へ移動します。
-      * **整列:** 選択した2原子をX, Y, Z軸に沿って配置します。
-      * **平面化:** 選択した3つ以上の原子を特定の平面（XY, XZ, YZ）上に配置したり、**最適フィット平面に投影**したりできます。
-      * **鏡像作成:** 選択した平面 (XY, XZ, YZ) に対して分子の鏡像を作成します。
-      * **結合長・角度・二面角:** 原子を選択し、目標値を入力することで、距離、角度、ねじれ角を正確に設定します。
-      * **制約付き最適化:** 特定の距離、角度、二面角を固定したまま、力場計算 (MMFF/UFF) による構造最適化を実行します。
-  * **3D測定ツール:** 「Select」モードで3Dビュー内の原子をクリックするだけで、以下の値を即座に測定・表示します。
-      * **距離** (2原子間)
-      * **角度** (3原子間)
-      * **二面角** (4原子間)
-  * **構造最適化:** MMFF94またはUFF力場を用いて3D構造の最適化を実行できます。
-  * **多彩な表示スタイル:** 分子を「ボール＆スティック」、「CPK (空間充填)」、「ワイヤーフレーム」、「スティック」モデルで表示できます。
-
-### 3\. 解析とエクスポート
-
-  * **分子特性解析:** 専用ウィンドウに、分子式、分子量、SMILES、LogP、TPSAなど、RDKitによって計算された主要な分子特性を一覧表示します。
-  * **立体化学表示:** 3D変換後、キラル中心を自動的に認識し、R/Sラベルを3Dビューに表示します。
-  * **ファイル入出力:**
-      * 2D/3Dデータや制約情報を含むセッション全体を、独自のプロジェクトファイル (`.pmeprj`) として保存・読み込みできます。
-      * **MOL/SDF/XYZ**ファイルや**SMILES/InChI**文字列から構造をインポートできます。
-      * 3D構造を**MOL**または**XYZ**形式でエクスポートでき、これらは多くのDFT計算ソフトウェアと互換性があります。
-      * 2Dビューを高解像度のPNG・SVG画像として、3DビューをPNG画像としてエクスポートできます。
-      * 3Dモデルを**STL**または**OBJ/MTL**ファイルとしてエクスポートでき、3Dプリントやレンダリングに利用できます。
-      * **`.pmeraw` に関するセキュリティ上の注意:** 旧形式の `.pmeraw` プロジェクトは Python の pickle を使用しており、読み込み時に任意のコードが実行される可能性があります。自分で作成した `.pmeraw` ファイルのみを開き、共有には JSON ベースの `.pmeprj` 形式を使用してください。
-
-### 4. プログラマブルで拡張可能
-
-  * **Pythonプラグインシステム:** Pythonスクリプトをプラグインフォルダに入れるだけで、即座にアプリケーションメニューの一部として機能します。
-  * **プラグインのダウンロード:** [Plugin Explorer](https://hiroyokoyama.github.io/moleditpy-plugins/explorer/) から特化したプラグインを探索・ダウンロードできます。
-  * **フルAPIアクセス:** プラグインは `MainWindow`、`RDKit` 分子オブジェクト、2D シーンの Qt グラフィックスアイテムに直接アクセスでき、無限のカスタマイズが可能です。
-  * **迅速なプロトタイピング:** 新しいアルゴリズムやワークフローの自動化をその場でテストしたい研究者に最適です。
-
-## インストールと実行
-
-詳細な手順については、プロジェクトの[Wiki](https://github.com/HiroYokoyama/python_molecular_editor/wiki)を参照してください。[Docker版](https://github.com/HiroYokoyama/python_molecular_editor_docker)も利用可能です。[Windows向けインストーラー](https://hiroyokoyama.github.io/python_molecular_editor/windows-installer/windows_installer-jp)や[macOSアプリバンドル](https://hiroyokoyama.github.io/python_molecular_editor/macos-installer/macos_installer-jp)も使用できます。
-
-#### 必要ライブラリ
-
-`PyQt6`, `RDKit`, `NumPy`, `PyVista`, `pyvistaqt`, `openbabel`
-
-#### インストール
-
-1.  **パッケージのインストール**
-    このコマンドを実行すると、お使いのOS（Windows/macOSまたはLinux）に適した `moleditpy` 本体が自動的にインストールされます。
-
-    ```bash
-    pip install moleditpy-installer
-    ```
-
-2.  **ショートカットの作成**
-    インストール後、このコマンドを実行すると、アプリケーションメニュー（スタートメニューやアプリケーションフォルダなど）にショートカットが作成されます。
-
-    ```bash
-    python -m moleditpy_installer
-    ```
-
-#### アプリケーションの起動
-
-```bash
-moleditpy
-```
-
-**（注：初回起動時は、RDKitなどのライブラリの初期化のため、起動に時間がかかる場合があります。）**
-
-## キーボードショートカット
-
-| キー | 操作 | 補足 |
-| :--- | :--- | :--- |
-| `1`/`2`/`3` | 結合次数を変更 | 単結合/二重結合/三重結合 |
-| `W`/`D` | 立体化学結合に変更 | Wedge / Dash 結合 |
-| `Delete` / `Backspace` | アイテムの削除 | 選択またはカーソル下のアイテムを削除 |
-| `.` | ラジカルをトグル | 0, 1, 2ラジカルを循環 |
-| `+`/`-` | 電荷を増減 | 形式電荷の変更 |
-| `C`, `N`, `O` など | 原子記号を変更 | カーソル下の原子に適用 |
-| `4` | ベンゼン環の配置 | カーソル下の原子/結合にワンショットで配置 |
-| `Space` | 選択モード切替 / 全選択 | |
-| `Ctrl+J` | 2D最適化を実行 | |
-| `Ctrl+K` | 3D変換を実行 | |
-| `Ctrl+L` | 3D最適化を実行 | |
-
-## 技術的な仕組み
-
-  * **GUIと2D描画 (PyQt6):** `QGraphicsScene`上にカスタムの`AtomItem`（原子）と`BondItem`（結合）を配置し、対話的に操作します。Undo/Redo機能は、アプリケーションの状態をシリアライズしてスタックに保存することで実現しています。
-  * **化学計算 (RDKit / Open Babel):** 2DデータからRDKit分子オブジェクトを生成し、3D座標生成や分子特性計算を実行します。RDKitでの3D座標生成が失敗した際は、Open Babelにフォールバックします。重い計算処理は別スレッド (`QThread`) で実行し、GUIの応答性を維持しています。
-  * **3D可視化 (PyVista / pyvistaqt):** RDKitのコンフォーマ座標からPyVistaのメッシュ（球や円柱）を生成して描画します。カスタムの`vtkInteractorStyle`を実装し、3Dビュー内での原子の直接的なドラッグ＆ドロップ編集を可能にしています。
-  * **モジュラーアーキテクチャ:** コードベースは `core` ロジック、`ui` コンポーネント、`utils` の専用パッケージに整理されています。`MainWindow` は、状態管理・ファイル入出力・3D ビュー・ダイアログなどを専門のマネージャーオブジェクトに委譲するコンポジションハブとして機能し、長期的な保守性と検証の容易さを確保しています。
-
-## ライセンス & 免責事項
-
-このプロジェクトは GNU General Public License v3.0 (GPLv3) のもとでライセンスされています。詳細は [LICENSE](https://github.com/HiroYokoyama/python_molecular_editor/blob/main/LICENSE) ファイルを参照してください。オープンソースソフトウェアとして、本ソフトウェアは「現状のまま」提供され、いかなる明示または黙示の保証も行いません。また、本ソフトウェアを使用した結果について、作者は一切の責任や義務を負いません。出力結果は慎重に検証されていますが、学術論文の作成など重要な用途においては、ユーザーご自身で結果を独立して確認および検証することを強くお勧めします。バグに遭遇した場合は、Issueを作成してください。
-
-## 引用
-
-本ソフトウェアを研究で使用される場合は、以下の通り引用を明記してください。
-
-```
-Yokoyama, H. (2026). MoleditPy — A Python-based molecular editing software. Zenodo. https://doi.org/10.5281/zenodo.17268532
-```
+## License & Disclaimer
 
-また、使用したプラグインの引用もお願いいたします。
+This project is licensed under the GNU General Public License v3.0 (GPLv3) - see the [LICENSE](https://github.com/HiroYokoyama/python_molecular_editor/blob/main/LICENSE) file for details. As open-source software, it is provided 'as is' without warranty of any kind, and the author assumes no responsibility or liability for the results. Although outputs have been carefully verified, users are strongly encouraged to independently check and validate them for critical applications (such as publications). If you encounter any bugs, please open an issue.

moleditpy-4.11.2/README.md

@@ -0,0 +1,56 @@
+# MoleditPy — A Python Molecular Editor
+
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17268532.svg)](https://doi.org/10.5281/zenodo.17268532)
+[![PyPI version](https://badge.fury.io/py/MoleditPy.svg)](https://badge.fury.io/py/MoleditPy)
+[![Python Versions](https://img.shields.io/badge/python-3.9--3.14-blue.svg)](https://pypi.org/project/MoleditPy/)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Build Status](https://github.com/HiroYokoyama/python_molecular_editor/actions/workflows/tests.yml/badge.svg)](https://github.com/HiroYokoyama/python_molecular_editor/actions)
+[![codecov](https://codecov.io/gh/HiroYokoyama/python_molecular_editor/graph/badge.svg)](https://codecov.io/gh/HiroYokoyama/python_molecular_editor)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/moleditpy?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/moleditpy)
+[![](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/HiroYokoyama)
+
+**MoleditPy** is a programmable, cross-platform molecular editor built with PyQt6, RDKit, and PyVista. It takes you from a 2D sketch to an editable 3D structure and out to input files for DFT calculations, and it can be extended with plain Python plugins.
+
+**[Website](https://hiroyokoyama.github.io/python_molecular_editor/)** · **[User manual](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual)** ([日本語](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual-JP)) · **[Plugins](https://hiroyokoyama.github.io/moleditpy-plugins/)** · **[Wiki](https://github.com/HiroYokoyama/python_molecular_editor/wiki)**
+
+![MoleditPy screenshot](https://hiroyokoyama.github.io/python_molecular_editor/img/screenshot.png)
+
+## Features
+
+- **2D drawing** — atoms, bonds, ring templates, alkyl chains, charges, radicals, stereo bonds, and the full periodic table.
+- **3D editing** — 2D-to-3D conversion, dragging atoms in the 3D view, exact bond lengths, angles, and dihedrals, and MMFF94/UFF optimization with constraints.
+- **Analysis and export** — molecular properties, R/S labels, MOL/SDF/XYZ/SMILES/InChI import and export, PNG/SVG images, and STL/OBJ for 3D printing.
+- **Plugins** — drop a Python file into the plugin folder to add menu actions and tools. Browse the official collection in the [Plugin Explorer](https://hiroyokoyama.github.io/moleditpy-plugins/explorer/).
+
+See the [user manual](https://hiroyokoyama.github.io/python_molecular_editor/manual/manual) for every feature and keyboard shortcut.
+
+## Installation
+
+```bash
+pip install moleditpy-installer
+python -m moleditpy_installer
+```
+
+The first command installs the right package for your platform (`moleditpy`, or `moleditpy-linux` on Linux); the second creates an application shortcut. Start the app from the shortcut or with:
+
+```bash
+moleditpy
+```
+
+The first launch can take a while as RDKit and the other libraries initialize. A [Windows installer](https://hiroyokoyama.github.io/python_molecular_editor/windows-installer/windows_installer), a [macOS app bundle](https://hiroyokoyama.github.io/python_molecular_editor/macos-installer/macos_installer), and a [Docker image](https://github.com/HiroYokoyama/python_molecular_editor_docker) are also available.
+
+> **Security note:** the legacy `.pmeraw` project format uses Python pickle, which can execute arbitrary code when loaded. Only open `.pmeraw` files you created yourself, and use the JSON-based `.pmeprj` format for sharing.
+
+## Citation
+
+If you use this software in your work, please cite it as follows:
+
+```
+Yokoyama, H. (2026). MoleditPy — A Python-based molecular editing software. Zenodo. https://doi.org/10.5281/zenodo.17268532
+```
+
+Please also cite the plugins you used; see [Citation in the plugin collection](https://github.com/HiroYokoyama/moleditpy-plugins#citation).
+
+## License & Disclaimer
+
+This project is licensed under the GNU General Public License v3.0 (GPLv3) - see the [LICENSE](https://github.com/HiroYokoyama/python_molecular_editor/blob/main/LICENSE) file for details. As open-source software, it is provided 'as is' without warranty of any kind, and the author assumes no responsibility or liability for the results. Although outputs have been carefully verified, users are strongly encouraged to independently check and validate them for critical applications (such as publications). If you encounter any bugs, please open an issue.

{moleditpy-4.11.0 → moleditpy-4.11.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "MoleditPy"
 
-version = "4.11.0"
+version = "4.11.2"
 
 license = {file = "LICENSE"}
 
@@ -36,8 +36,8 @@ dependencies = [
   "numpy",
   "pyqt6 < 6.10; python_version == '3.9'",
   "pyqt6 < 6.12; python_version != '3.9'",
-  "pyvista < 0.49",
-  "pyvistaqt < 0.13",
+  "pyvista < 0.50",
+  "pyvistaqt < 0.14",
   "rdkit < 2026.4",
   "openbabel-wheel < 3.2"
 ]