mcgt-core 0.2.12

No project description provided

Modèle de Courbure Gravitationnelle Temporelle (MCGT)

Résumé

MCGT est un corpus de 10 chapitres (conceptuel + détails) accompagné d’un ensemble de scripts, données, figures et manifestes pour assurer la reproductibilité complète (génération des données, tracés, contrôles de cohérence). Ce README dresse l’index des ressources, précise les points d’entrée (runbook, Makefile, configs) et documente les conventions.

Sommaire

1. Arborescence du projet
2. Contenu des chapitres (LaTeX)
3. Configurations & package Python
4. Données (zz-data/)
5. Scripts (zz-scripts/)
6. Figures (zz-figures/)
7. Manifests & repro (zz-manifests/, README-REPRO.md, RUNBOOK.md)
8. Conventions & styles (conventions.md)
9. Environnements & dépendances (requirements.txt, environment.yml)
10. Commandes utiles (Makefile) & contrôle de cohérence
11. Licence / Contact
12. Historique / Notes

---

1) Arborescence du projet

Racine :

• main.tex — Document LaTeX principal (compile les 10 chapitres).

• references.bib — Bibliographie BibTeX.

• README.md — Présent fichier d’accueil.

• README-REPRO.md — Guide de reproductibilité pas-à-pas.

• RUNBOOK.md — Procédures opératoires (exécution standard / QA).

• Makefile — Cibles de génération (données, figures, PDF, QA).

• setup.py — (si packaging local du module mcgt).

• requirements.txt — Dépendances Python (pip).

• environment.yml — Environnement Conda (optionnel).

• conventions.md — Convention de nommage / unités / style (référence).

• LICENSE — Licence du projet.

• .pre-commit-config.yaml — Hooks de qualité (format/linters).

  Chapitres (dossiers LaTeX) :

• 01-introduction-applications/

• 02-validation-chronologique/

• 03-stabilite-fR/

• 04-invariants-adimensionnels/

• 05-nucleosynthese-primordiale/

• 06-rayonnement-cmb/

• 07-perturbations-scalaires/

• 08-couplage-sombre/

• 09-phase-ondes-gravitationnelles/

• 10-monte-carlo-global-8d/

  Code source (package) :

• mcgt/ — Module Python (API interne).

  • scalar_perturbations.py
  • phase.py
  • init.py
  • backends/ref_phase.py
  • CHANGELOG.md
  • pyproject.toml

  Configurations :

• zz-configuration/

  • mcgt-global-config.ini — Configuration globale (référence).
  • mcgt-global-config.ini.template
  • camb_exact_plateau.ini
  • gw_phase.ini
  • scalar_perturbations.ini
  • GWTC-3-confident-events.json
  • pdot_plateau_vs_z.dat
  • meta_template.json — (référence croisée avec zz-manifests/)
  • README.md

  Données :

• zz-data/chapter{01..10}/ — Données structurées par chapitre (CSV/DAT/JSON).

  Figures :

• zz-figures/chapter{01..10}/ — Figures générées (PNG).

  Scripts & outils :

• zz-scripts/chapter{01..10}/ — Scripts de génération & tracé.

• zz-scripts/chapter03/utils/ — Utilitaires (ex. conversion jalons).

• zz-scripts/chapter07/tests/ — Tests dédiés chapitre 7.

• zz-scripts/chapter07/utils/ — Utilitaires (k-grid, toy_model).

• zz-scripts/chapter08/utils/ — Utilitaires (extractions BAO/SN).

• zz-scripts/manifest_tools/ — Outils manifeste.

  • populate_manifest.py, verify_manifest.py

  Manifests & diagnostics :

• zz-manifests/

  • manifest_master.json

  • manifest_publication.json (et éventuellement .bak)

  • manifest_report.json

  • manifest_report.md

  • figure_manifest.csv

  • add_to_manifest.py

  • migration_map.json

  • meta_template.json

  • README_manifest.md

  • diag_consistency.py

  • chapters/

    • chapter_manifest_01.json
    • chapter_manifest_02.json
    • chapter_manifest_03.json
    • chapter_manifest_04.json
    • chapter_manifest_05.json
    • chapter_manifest_06.json
    • chapter_manifest_07.json
    • chapter_manifest_08.json
    • chapter_manifest_09.json
    • chapter_manifest_10.json

  • reports/

  Schémas :

• zz-schemas/

  • 02_optimal_parameters.schema.json
  • 02_spec_spectrum.schema.json
  • 03_meta_stability_fR.schema.json
  • 05_nucleosynthesis_parameters.schema.json
  • 06_cmb_params.schema.json
  • 07_meta_perturbations.schema.json
  • 07_params_perturbations.schema.json
  • 09_best_params.schema.json
  • 09_phases_imrphenom.meta.schema.json
  • comparison_milestones_table_schema.json
  • jalons_comparaison_table_schema.json
  • mc_best_schema.json
  • mc_config_schema.json
  • mc_results_table_schema.json
  • meta_schema.json
  • metrics_phase_schema.json
  • README.md
  • README_SCHEMAS.md
  • results_schema_examples.json
  • validate_csv_schema.py
  • validate_csv_table.py
  • validate_json.py
  • validation_globals.json

  Checklists :

• zz-checklists/

  • CHAPTER01_CHECKLIST.txt
  • CHAPTER02_CHECKLIST.txt
  • CHAPTER03_CHECKLIST.txt
  • CHAPTER04_CHECKLIST.txt
  • CHAPTER05_CHECKLIST.txt
  • CHAPTER06_CHECKLIST.txt
  • CHAPTER07_CHECKLIST.txt
  • CHAPTER08_CHECKLIST.txt
  • CHAPTER09_CHECKLIST.txt
  • CHAPTER10_CHECKLIST.txt

  Tests :

• zz-tests/

  • pytest.ini
  • test_manifest.py
  • test_schemas.py

  Workflows CI :

• zz-workflows/

  • ci.yml
  • release.yml
  • README.md

---

2) Contenu des chapitres (LaTeX)

Chaque dossier de chapitre contient :

• _conceptuel.tex
• _details.tex (ou _calibration_conceptuel.tex pour le chap. 1)
• CHAPTERXX_GUIDE.txt (notes, exigences, jalons spécifiques)

Liste :

• Chapitre 1 – Introduction conceptuelle (01-introduction-applications/)

  • 01_introduction_conceptuel.tex
  • 01_applications_calibration_conceptuel.tex
  • CHAPTER01_GUIDE.txt

• Chapitre 2 – Validation chronologique (02-validation-chronologique/)

  • 02_validation_chronologique_conceptuel.tex
  • 02_validation_chronologique_details.tex
  • CHAPTER02_GUIDE.txt

• Chapitre 3 – Stabilité f(R) (03-stabilite-fR/)

  • 03_stabilite_fR_conceptuel.tex
  • 03_stabilite_fR_details.tex
  • CHAPTER03_GUIDE.txt

• Chapitre 4 – Invariants adimensionnels (04-invariants-adimensionnels/)

  • 04_invariants_adimensionnels_conceptuel.tex
  • 04_invariants_adimensionnels_details.tex
  • CHAPTER04_GUIDE.txt

• Chapitre 5 – Nucléosynthèse primordiale (05-nucleosynthese-primordiale/)

  • 05_nucleosynthese_primordiale_conceptuel.tex
  • 05_nucleosynthese_primordiale_details.tex
  • CHAPTER05_GUIDE.txt

• Chapitre 6 – Rayonnement CMB (06-rayonnement-cmb/)

  • 06_cmb_conceptuel.tex
  • 06_cmb_details.tex
  • CHAPTER06_GUIDE.txt

• Chapitre 7 – Perturbations scalaires (07-perturbations-scalaires/)

  • 07_perturbations_scalaires_conceptuel.tex
  • 07_perturbations_scalaires_details.tex
  • CHAPTER07_GUIDE.txt

• Chapitre 8 – Couplage sombre (08-couplage-sombre/)

  • 08_couplage_sombre_conceptuel.tex
  • 08_couplage_sombre_details.tex
  • CHAPTER08_GUIDE.txt

• Chapitre 9 – Phase ondes gravitationnelles (09-phase-ondes-gravitationnelles/)

  • 09_phase_ondes_grav_conceptuel.tex
  • 09_phase_ondes_grav_details.tex
  • CHAPTER09_GUIDE.txt

• Chapitre 10 – Monte Carlo global 8D (10-monte-carlo-global-8d/)

  • 10_monte_carlo_global_conceptuel.tex
  • 10_monte_carlo_global_details.tex
  • CHAPTER10_GUIDE.txt

---

3) Configurations & package Python

• zz-configuration/mcgt-global-config.ini : paramètres transverses (chemins de données/figures, tolérances, seeds, options graphiques, etc.).
• zz-configuration/*.ini spécifiques (ex. camb_exact_plateau.ini, scalar_perturbations.ini, gw_phase.ini).
• zz-configuration/GWTC-3-confident-events.json ; zz-configuration/pdot_plateau_vs_z.dat ; zz-configuration/meta_template.json ; zz-configuration/mcgt-global-config.ini.template ; zz-configuration/README.md.
• mcgt/ : API Python interne (ex. calculs de phase, solveurs de perturbations, backends de référence). mcgt/backends/ref_phase.py fournit la phase de ref.
• mcgt/CHANGELOG.md ; mcgt/pyproject.toml.

---

4) Données (zz-data/)

Organisation par chapitre, exemples (liste non exhaustive) :

• zz-data/chapter01/

  • 01_optimized_data.csv
  • 01_optimized_data_and_derivatives.csv
  • 01_optimized_grid_data.dat
  • 01_P_vs_T.dat
  • 01_initial_grid_data.dat
  • 01_P_derivative_initial.csv
  • 01_P_derivative_optimized.csv
  • 01_relative_error_timeline.csv
  • 01_timeline_milestones.csv
  • 01_dimensionless_invariants.csv

• zz-data/chapter02/

  • 02_optimal_parameters.json, 02_primordial_spectrum_spec.json
  • 02_P_vs_T_grid_data.dat, 02_P_derivative_data.dat
  • 02_As_ns_vs_alpha.csv, 02_P_R_sampling.csv
  • 02_FG_series.csv
  • 02_timeline_milestones.csv, 02_relative_error_timeline.csv, 02_milestones_meta.csv

• zz-data/chapter03/

  • 03_fR_stability_meta.json
  • 03_fR_stability_data.csv, 03_fR_stability_domain.csv, 03_fR_stability_boundary.csv
  • 03_ricci_fR_vs_T.csv, 03_ricci_fR_vs_z.csv, 03_ricci_fR_milestones.csv

• zz-data/chapter04/

  • 04_dimensionless_invariants.csv
  • 04_P_vs_T.dat

• zz-data/chapter05/

  • 05_bbn_params.json, 05_bbn_grid.csv
  • 05_bbn_data.csv, 05_bbn_invariants.csv
  • 05_chi2_bbn_vs_T.csv, 05_dchi2_vs_T.csv
  • 05_bbn_milestones.csv

• zz-data/chapter06/

  • 06_params_cmb.json
  • 06_alpha_evolution.csv
  • 06_cls_spectrum.dat, 06_cls_spectrum_lcdm.dat
  • 06_cmb_full_results.csv, 06_cmb_chi2_scan2D.csv
  • 06_delta_cls.csv, 06_delta_cls_relative.csv
  • 06_delta_rs_scan.csv, 06_delta_rs_scan2D.csv, 06_delta_rs_scan_full.csv
  • 06_delta_Tm_scan.csv, 06_hubble_mcgt.dat
  • 01_P_vs_T.dat

• zz-data/chapter07/

  • 07_perturbations_params.json, 07_perturbations_meta.json
  • 07_cs2_matrix.csv, 07_delta_phi_matrix.csv
  • 07_dcs2_vs_k.csv, 07_ddelta_phi_vs_k.csv
  • 07_perturbations_domain.csv, 07_perturbations_boundary.csv
  • 07_scalar_invariants.csv, 07_phase_run.csv
  • 07_perturbations_main_data.csv, 07_scalar_perturbations_results.csv

• zz-data/chapter08/

  • 08_coupling_params.json, 08_chi2_scan2D.csv, 08_chi2_total_vs_q0.csv
  • 08_bao_data.csv, 08_pantheon_data.csv
  • 08_dv_theory_z.csv, 08_dv_theory_q0star.csv
  • 08_mu_theory_z.csv, 08_mu_theory_q0star.csv
  • 08_coupling_milestones.csv, 08_chi2_derivative.csv

• zz-data/chapter09/

  • 09_best_params.json
  • 09_metrics_phase.json, 09_comparison_milestones.csv (+ .meta.json, .flagged.csv)
  • 09_phases_imrphenom.csv (+ .meta.json)
  • 09_phases_mcgt.csv, 09_phases_mcgt_prepoly.csv
  • 09_phase_diff.csv, gwtc3_confident_parameters.json

• zz-data/chapter10/

  • 10_mc_config.json
  • 10_mc_results.csv (+ variantes .circ.csv, .agg.csv, .circ.with_fpeak.csv)
  • 10_mc_samples.csv, 10_mc_milestones_eval.csv
  • 10_mc_best.json, 10_mc_best_bootstrap.json

---

5) Scripts (zz-scripts/)

Chaque chapitre dispose de générateurs de données generate_data_chapterXX.py et de traceurs plot_fig*.py. Exemples :

• zz-scripts/chapter01/

  • generate_data_chapter01.py, plot_fig01_early_plateau.py, plot_fig02_logistic_calibration.py, plot_fig03_relative_error_timeline.py, plot_fig04_P_vs_T_evolution.py, plot_fig05_I1_vs_T.py, plot_fig06_P_derivative_comparison.py, requirements.txt

• zz-scripts/chapter02/

  • extract_sympy_FG.ipynb
  • generate_data_chapter02.py, primordial_spectrum.py, plot_fig00_spectrum.py, plot_fig01_P_vs_T_evolution.py, plot_fig02_calibration.py, plot_fig03_relative_errors.py, plot_fig04_pipeline_diagram.py, plot_fig05_FG_series.py, plot_fig06_alpha_fit.py, requirements.txt

• zz-scripts/chapter03/

  • generate_data_chapter03.py, plot_fig01_fR_stability_domain.py, plot_fig02_fR_fRR_vs_f.py, plot_fig03_ms2_R0_vs_f.py, plot_fig04_fR_fRR_vs_f.py, plot_fig05_interpolated_milestones.py, plot_fig06_grid_quality.py, plot_fig07_ricci_fR_vs_z.py, plot_fig08_ricci_fR_vs_T.py, requirements.txt
  • utils/03_ricci_fR_milestones_enhanced.csv, utils/convert_milestones.py

• zz-scripts/chapter04/

  • generate_data_chapter04.py, plot_fig01_invariants_schematic.py, plot_fig02_invariants_histogram.py, plot_fig03_invariants_vs_T.py, plot_fig04_relative_deviations.py, requirements.txt

• zz-scripts/chapter05/

  • generate_data_chapter05.py, plot_fig01_bbn_reaction_network.py, plot_fig02_dh_model_vs_obs.py, plot_fig03_yp_model_vs_obs.py, plot_fig04_chi2_vs_T.py, requirements.txt

• zz-scripts/chapter06/

  • generate_data_chapter06.py, generate_pdot_plateau_vs_z.py, plot_fig01_cmb_dataflow_diagram.py, plot_fig02_cls_lcdm_vs_mcgt.py, plot_fig03_delta_cls_relative.py, plot_fig04_delta_rs_vs_params.py, plot_fig05_delta_chi2_heatmap.py, run_camb_chapter06.bat, requirements.txt

• zz-scripts/chapter07/

  • generate_data_chapter07.py, launch_scalar_perturbations_solver.py, launch_solver_chapter07.sh, plot_fig01_cs2_heatmap.py, plot_fig02_delta_phi_heatmap.py, plot_fig06_comparison.py, plot_fig03_invariant_I1.py, plot_fig04_dcs2_vs_k.py, plot_fig05_ddelta_phi_vs_k.py, plot_fig07_invariant_I2.py, requirements.txt
  • tests/test_chapter07.py
  • utils/test_kgrid.py, utils/toy_model.py

• zz-scripts/chapter08/

  • generate_coupling_milestones.py, generate_data_chapter08.py, plot_fig01_chi2_total_vs_q0.py, plot_fig02_dv_vs_z.py, plot_fig03_mu_vs_z.py, plot_fig04_chi2_heatmap.py, plot_fig05_residuals.py, plot_fig06_normalized_residuals_distribution.py, plot_fig07_chi2_profile.py, requirements.txt
  • utils/cosmo.py, utils/coupling_example_model.py, utils/extract_bao_data.py, utils/extract_pantheon_plus_data.py, utils/generate_coupling_milestones.py, utils/verify_z_grid.py

• zz-scripts/chapter09/

  • apply_poly_unwrap_rebranch.py, check_p95_methods.py, extract_phenom_phase.py, fetch_gwtc3_confident.py, flag_jalons.py, generate_data_chapter09.py, generate_mcgt_raw_phase.py, opt_poly_rebranch.py
  • plot_fig01_phase_overlay.py, plot_fig02_residual_phase.py, plot_fig03_hist_absdphi_20_300.py, plot_fig04_absdphi_milestones_vs_f.py, plot_fig05_scatter_phi_at_fpeak.py, requirements.txt

• zz-scripts/chapter10/

  • add_phi_at_fpeak.py, bootstrap_topk_p95.py, check_metrics_consistency.py, diag_phi_fpeak.py, eval_primary_metrics_20_300.py, generate_data_chapter10.py, inspect_topk_residuals.py, qc_wrapped_vs_unwrapped.py, recompute_p95_circular.py, regen_fig05_using_circp95.py
  • plot_fig01_iso_p95_maps.py, plot_fig02_scatter_phi_at_fpeak.py, plot_fig03_convergence_p95_vs_n.py, plot_fig03b_bootstrap_coverage_vs_n.py, plot_fig04_scatter_p95_recalc_vs_orig.py, plot_fig05_hist_cdf_metrics.py, plot_fig06_residual_map.py, plot_fig07_synthesis.py
  • update_manifest_with_hashes.py, requirements.txt

• zz-scripts/manifest_tools/

  • populate_manifest.py, verify_manifest.py

---

6) Figures (zz-figures/)

Par chapitre : fig_*.png (noms explicites, FR).

• chap.01 :

  • fig_01_early_plateau.png, fig_02_logistic_calibration.png, fig_03_relative_error_timeline.png, fig_04_P_vs_T_evolution.png, fig_05_I1_vs_T.png, fig_06_P_derivative_comparison.png

• chap.02 :

  • fig_00_spectrum.png, fig_01_P_vs_T_evolution.png, fig_02_calibration.png, fig_03_relative_errors.png, fig_04_pipeline_diagram.png, fig_05_FG_series.png, fig_06_fit_alpha.png

• chap.03 :

  • fig_01_fR_stability_domain.png, fig_02_fR_fRR_vs_R.png, fig_03_ms2_R0_vs_R.png, fig_04_fR_fRR_vs_R.png, fig_05_interpolated_milestones.png, fig_06_grid_quality.png, fig_07_ricci_fR_vs_z.png, fig_08_ricci_fR_vs_T.png

• chap.04 :

  • fig_01_invariants_schematic.png, fig_02_invariants_histogram.png, fig_03_invariants_vs_T.png, fig_04_relative_deviations.png

• chap.05 :

  • fig_01_bbn_reaction_network.png, fig_02_dh_model_vs_obs.png, fig_03_yp_model_vs_obs.png, fig_04_chi2_vs_T.png

• chap.06 :

  • fig_01_cmb_dataflow_diagram.png, fig_02_cls_lcdm_vs_mcgt.png, fig_03_delta_cls_relative.png, fig_04_delta_rs_vs_params.png, fig_05_delta_chi2_heatmap.png

• chap.07 :

  • fig_00_loglog_sampling_test.png, fig_01_cs2_heatmap_k_a.png, fig_02_delta_phi_heatmap_k_a.png, fig_03_invariant_I1.png, fig_04_dcs2_dk_vs_k.png, fig_05_ddelta_phi_dk_vs_k.png, fig_06_comparison.png, fig_07_invariant_I2.png

• chap.08 :

  • fig_01_chi2_total_vs_q0.png, fig_02_dv_vs_z.png, fig_03_mu_vs_z.png, fig_04_chi2_heatmap.png, fig_05_residuals.png, fig_06_pulls.png, fig_07_chi2_profile.png

• chap.09 :

  • fig_01_phase_overlay.png, fig_02_residual_phase.png, fig_03_hist_absdphi_20_300.png, fig_04_absdphi_milestones_vs_f.png, fig_05_scatter_phi_at_fpeak.png, p95_methods/ (fig03_raw_bins30.png, fig03_raw_bins50.png, fig03_raw_bins80.png, fig03_rebranch_k_bins30.png, fig03_rebranch_k_bins50.png, fig03_rebranch_k_bins80.png, fig03_unwrap_bins30.png, fig03_unwrap_bins50.png, fig03_unwrap_bins80.png), p95_check_control.png

• chap.10 :

  • fig_01_iso_p95_maps.png, fig_02_scatter_phi_at_fpeak.png, fig_03b_coverage_bootstrap_vs_n_hires.png, fig_03_convergence_p95_vs_n.png, fig_04_scatter_p95_recalc_vs_orig.png, fig_05_hist_cdf_metrics.png, fig_06_heatmap_absdp95_m1m2.png, fig_07_summary_comparison.png

---

7) Manifests & repro

• zz-manifests/manifest_master.json — inventaire complet (source maître).
• zz-manifests/manifest_publication.json — sous-ensemble pour remise publique.
• zz-manifests/manifest_report.json — rapport généré par diag_consistency.py.
• zz-manifests/manifest_report.md — rapport lisible.
• zz-manifests/figure_manifest.csv — index des figures.
• zz-manifests/add_to_manifest.py ; zz-manifests/migration_map.json.
• zz-manifests/meta_template.json — gabarit de métadonnées (source maître).
• zz-manifests/README_manifest.md — documentation manifeste.
• zz-manifests/diag_consistency.py — diagnostic (présence/format/empreintes).
• zz-manifests/chapters/chapter_manifest_{01..10}.json — manifests par chapitre.
• zz-manifests/reports/ — exports/rapports additionnels.
• README-REPRO.md — procédure reproductible détaillée.
• RUNBOOK.md — séquences d’exécution standard (pipeline).

Note : un meta_template.json existe aussi sous zz-configuration/ (référence croisée). La version maître est celle de zz-manifests/.

---

8) Conventions & styles

• conventions.md : normes de nommage (FR), unités (SI), précision numérique, format CSV/DAT/JSON, styles de figures, seuils de QA, sémantique des colonnes, règles pour jalons et classes (primaire/ordre2), etc.
• Cohérence inter-chapitres : les paramètres transverses (p. ex. alpha, q0star, fenêtres de fréquences, ell_min/max, etc.) doivent être harmonisés via mcgt-global-config.ini et les JSON de paramètres par chapitre.

---

9) Environnements & dépendances

• Python ≥ 3.10 recommandé. Installation (pip) : pip install -r requirements.txt Environnement Conda : conda env create -f environment.yml conda activate mcgt Chap. 9/10 : références d’onde (IMRPhenom) indiquées dans les métadonnées ; LALSuite peut être requis côté référence si régénération complète (voir RUNBOOK.md).

• Fichiers requirements par chapitre :

  • zz-scripts/chapter01/requirements.txt
  • zz-scripts/chapter02/requirements.txt
  • zz-scripts/chapter03/requirements.txt
  • zz-scripts/chapter04/requirements.txt
  • zz-scripts/chapter05/requirements.txt
  • zz-scripts/chapter06/requirements.txt
  • zz-scripts/chapter07/requirements.txt
  • zz-scripts/chapter08/requirements.txt
  • zz-scripts/chapter09/requirements.txt
  • zz-scripts/chapter10/requirements.txt

---

10) Commandes utiles & QA

Aide : make help

Générer données d’un chapitre (ex. chap. 4) : make data-chapter N=4

Générer figures d’un chapitre : make figures-chapter N=4

Pipeline complet (données + figures) : make all

Contrôle de cohérence manifest : python zz-manifests/diag_consistency.py --manifest zz-manifests/manifest_master.json --report zz-manifests/manifest_report.json

Pour des validations supplémentaires :

• JSON : python zz-schemas/validate_json.py <schema.json> <fichier.json>
• CSV (tables) : python zz-schemas/validate_csv_table.py <table_schema.json> <fichier.csv>
• Schéma CSV (structure) : python zz-schemas/validate_csv_schema.py <schema.json>
• Globals de validation : zz-schemas/validation_globals.json

---

11) Licence / Contact

• Licence : à préciser (interne / publique) — voir fichier LICENSE.
• Contact scientifique : responsable MCGT.
• Contact technique : mainteneur des scripts / CI.