Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

GROMACS: Force Field Tool — per-part force-field assignment, compatibility checks, downloadable catalogue

Offen
  • Stimmt etwas nicht?
#242 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
25/100
Issue-Typ
Feature
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
c
Bereich
backend, databases, desktop, tooling

Rechercherichtung

Start with the GROMACS implementation in #106 and the MINFF work in #241, then review the Basis Set Tool as the precedent for downloads and per-site libraries. The issue calls for a wx-free component, command-line entry point, tests, and a dialog; the design questions and compatibility rules define substantial design work. Done means catalogue entries and assignments generate validated topologies, compatibility checks and checksum-verified downloads are tested.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Part of the GROMACS implementation (#106): this is the Prepare step, i.e. #106 option 2, generalised.

Goal

A Force Field Tool, analogous to the Basis Set Tool, which lets the user:

  • assign force fields to different parts of a system (e.g. a mineral slab, water, ions, an organic adsorbate);
  • check that the chosen combination is consistent;
  • generate the GROMACS topology from it.

Force fields are downloaded on demand from their sources, not bundled with ECCE.

Assignment per part, not per element

Basis sets are chosen per element because atoms are independent there. Force-field atom types and charges depend on bonding and environment, so the unit of assignment is a part of the system:

  • a molecule type, residue or fragment, using the Builder's existing fragments/residues (as used for NWChem MD segments);
  • or an explicit selection.

Example assignments:

Part Force field
Mineral slab MINFF (#241)
Water OPC3
Na⁺/Cl⁻ ion set matching the water model
Organic adsorbate GAFF2 or OpenFF

Compatibility checks

A GROMACS topology has a single [ defaults ] section, so every part must share these settings:

  • non-bonded function type;
  • combining rule;
  • gen-pairs;
  • fudgeLJ and fudgeQQ (1-4 scaling).

Parts must also be consistent in:

  • the water model their parameters were fitted with;
  • ion parameters matching that water model.

Known incompatibilities include different 1-4 scaling between AMBER- and CHARMM-family force fields, and a different combining rule for OPLS-AA. The tool:

  • shows these properties for every catalogue entry;
  • refuses combinations with conflicting [ defaults ];
  • warns about water-model and ion mismatches;
  • checks that each part's net charge is an integer and reports the total charge.

Catalogue and downloads

ECCE ships a small catalogue file, not the force fields themselves. Each entry records:

  • name, version, and source URL pinned to a release or commit;
  • checksum;
  • licence, shown before download;
  • its [ defaults ] properties, water model and scope (biomolecules, organics, minerals, ions, water);
  • how types and charges are assigned:
    • pdb2gmx, for force fields with residue databases;
    • atomipy, for MINFF and CLAYFF;
    • OpenFF tooling, for small organics;
    • or none, for ready-made .itp files such as water and ions.

Force fields are downloaded on first use into a per-user cache. A site can configure a shared read-only copy, for offline teaching labs. The Basis Set Tool's per-site library is the precedent.

Downloading per user also means ECCE does not redistribute force-field files, so their licences stay with the user.

Output

The assignment is stored with the calculation/study, as the basis set is. ECCE then writes:

  • topol.top, with one [ defaults ] section, the #include of each force field and the molecule .itp files;
  • the .gro file with the box.

The MD tasks of #106 (EM, NVT/NPT, MD) then run on these files.

First catalogue (proposal)

  1. GROMACS's built-in force fields (share/gromacs/top/*.ff), via pdb2gmx.
  2. CHARMM36, GROMACS port.
  3. MINFF and CLAYFF via atomipy (#241).
  4. Water models: SPC/E, TIP3P, TIP4P/2005, OPC3, OPC.
  5. Ion sets matching those water models.

Later candidates:

  • Open Force Field (OpenFF) for small organics;
  • charges from QM calculations in ECCE (RESP/ESP, #179).

Design rules

  • Typing, charge assignment, compatibility checks and topology writing live in a wx-free component with a command-line entry point and tests. The dialog only gathers choices and shows results.
  • Tests:
    • every compatibility rule has a positive and a negative case;
    • each first-catalogue entry produces a topology that passes gmx grompp and a short EM;
    • downloads are checksum-verified.
  • Platforms: Linux and macOS (Homebrew gromacs); Windows later.

Questions for GROMACS users

  • Which force fields, water models and ion sets should the first catalogue contain?
  • Which mixing conventions are used in practice, e.g. CLAYFF with organics, and which water model with MINFF?
  • Is per-fragment assignment enough, or is per-atom override needed for special cases, e.g. reactive edge sites?
  • Is a site-wide shared cache needed for teaching?

Related: #106 (GROMACS activation and MD workflow), #241 (MINFF), #179 (force-field charges for new ions and solvents).

Vorherrschende Sprache
C
Sterne
10
Forks
8
Ø Merge
21 Min.
Gemergte PRs (30 T.)
1

Entwicklungsumgebung

Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus FriendsofECCE/ECCE

Alle Issues in FriendsofECCE/ECCE

Ähnliche Issues

Weitere Issues zu C

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.