Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Fragments: one definition (atoms, charge, multiplicity) for paramagnetic systems, MO guesses, counterpoise, MO diagrams and QM/MM

オープン
  • 何か問題がありますか？
#252 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
12/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
領域
desktop

調査の方向性

This is a design proposal, not a starter task: the payload names no source files, tests or entry points. Read the linked issues #132, #172, #178, #201 and #242 to see how fragments are defined today, then the Builder's atom list and selection code in the repository. Done means a fragment definition in the Builder (selection, charge, multiplicity, storage) that works for one paramagnetic example, such as a Cu(II) dimer, with generated high-spin and broken-symmetry inputs checked by running the code. Agree the design with the maintainers before writing code.

索引モデルが issue の本文から書いたものです。

説明

Many calculation types need parts of a molecule defined as fragments, each with its own properties. Today each feature that needs them defines its own: the MO diagram (#132, #172), fragment-orbital analysis (#201), counterpoise (#178), MD force-field parts (#242). This issue proposes one fragment definition, kept with the structure and used by all of them.

Defining fragments (Builder)

  • Select atoms in the viewer (picking, box, by molecule (connected component), by residue or by element) or in the Builder's atom list (rows, with shift/ctrl for ranges), and assign them to a numbered or named fragment. The atom list gets a Fragment column, editable there too. Show fragments by colour.
  • Per fragment: charge and spin multiplicity, plus a name.
    • Check consistency: the sum of fragment charges equals the total charge; electron count and multiplicity parity per fragment.
    • The total multiplicity follows from the fragments' spins and how they couple: ferromagnetic (high spin) or antiferromagnetic (broken symmetry). The user chooses.
  • Fragments are stored with the structure and survive saving, duplicating a calculation and editing atoms (new atoms get no fragment).

Uses

  1. Paramagnetic and broken-symmetry systems (first target). Unrestricted DFT on systems with several metal centres or radicals: a fragment guess with per-fragment charge and multiplicity, then high-spin and broken-symmetry solutions (e.g. exchange coupling J).
    • Gaussian: atom tags (Fragment=n), Guess=Fragment=N with per-fragment charge/multiplicity pairs on the charge line.
    • ORCA: atom fragment tags, ! BrokenSym M,N or %scf FlipSpin, or a fragment-based guess.
    • NWChem: fragment guess (vectors fragment) from separate fragment calculations.
    • ECCE-QM: a fragment-superposition guess with spin flips, as a later step.
  2. Initial guess from fragment MOs (with #75, basis projection): converge each fragment, combine.
  3. Counterpoise / BSSE (#178): fragments define the ghost-atom calculations (Gaussian Counterpoise=N; ORCA and NWChem via generated ghost-atom jobs).
  4. MO diagrams and fragment-orbital analysis (#132, #172, #201): fragments from this definition instead of a separate one.
  5. QM/MM and ONIOM layers: fragments marked as QM or MM region (Gaussian ONIOM, ORCA QM/MM, NWChem QM/MM); with #242 for force-field assignment of MM parts.
  6. Energy decomposition where a code supports it (e.g. ORCA LED/EDA, NWChem fragment-based methods).

First step

The fragment definition in the Builder (selection, charge, multiplicity, storage), and its use for paramagnetic systems with one code (Gaussian or ORCA): a two-centre example (e.g. a Cu(II) dimer) set up entirely in the GUI, high-spin and broken-symmetry inputs generated and checked by running the code.

主要言語
C
スター
10
フォーク
8
平均マージ
21分
マージ済み PR（30日）
1

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

FriendsofECCE/ECCE のほかの issue

FriendsofECCE/ECCE の issue をすべて見る

似ている issue

C の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。