Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Port the symmetry programs from Fortran to C++ (drop the Fortran toolchain)

Ouverte
  • Quelque chose ne va pas ?
#366 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
35/100
Type d'issue
Refactorisation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
cmake, cpp, fortran
Domaine
backend, build-system

Piste de recherche

Start by reading the 17 files under src/apps/symmetry and identify the program entry points and callers described in the issue. Translate the routines into C++ under src/tdat, preserving algorithms, tolerances and output conventions, then compare results against the Fortran programs using the listed molecule, MO diagram and space group cases. Done means outputs agree within tolerance, callers use the library, and the Fortran sources and toolchain references are removed.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

src/apps/symmetry is the only Fortran left in ECCE: 17 files, about 7,100 lines (autosym from NWChem, the symmetry-operation and molecule generators symops, genmol, genmollat, gensym, dosymops, cleansym, the space-group tables spgen.f90 and spnames.f90). They build separate programs that the Builder, the calculation editor, the MO diagram and the reaction tools call through temporary files.

Why port

  • No Fortran compiler in any build. macOS links libgfortran and libquadmath statically, and the Windows client needs a Fortran-capable MinGW toolchain; this is the last awkward toolchain dependency for the native clients.
  • In-process calls instead of a program start and temporary files per call (the MO diagram calls symmetry often).
  • One language to debug; the symmetry traps found in the MO work (#132) sit in this code.

Method

  1. Translate function by function into C++ under src/tdat (no wx), no redesign: same algorithms, tolerances and output conventions.
  2. Differential test against the existing Fortran programs, kept as the reference during the port: every test and teaching molecule, the MO diagram goldens, and all 230 space groups in several settings. Point group, operations and symmetrized coordinates must agree within tolerance.
  3. Switch callers to the library; delete the Fortran and the Fortran toolchain (CMake, packaging, CI images) only after the outputs agree.

Outside libraries (spglib, libmsym) are not used: their tolerance behaviour differs from autosym's, which the MO diagram and the Builder's symmetrize depend on.

When: after the 9.3 queue, or earlier if a Windows or macOS client build is blocked by gfortran.

Langage dominant
C
Étoiles
10
Forks
8
Merge moyen
21 min
PR mergées (30 j)
1

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de FriendsofECCE/ECCE

Toutes les issues de FriendsofECCE/ECCE

Issues similaires

Plus d'issues C

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.