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

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

オープン
#366 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
リファクタリング
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
cmake, cpp, fortran

調査の方向性

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.

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

説明

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.

主要言語
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 を短くまとめたダイジェスト。