Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Risks and open questions

Open questions for Vincent

IDQuestionOptionsRecommendation
Q1Decided 2026-11-10: (a). Audience, licence, hosting of the code(a) personal and private until submission, open-source at submission; (b) open from the start; (c) stays private(a): referees increasingly expect public code at submission, while an early public repo invites scooping of an unpublished idea. Licence at release: MIT or BSD-3 (common in astro codes).
Q2Decided 2026-11-10: (a). When to contact Dullemond(a) after M7 with the bias result and corrected estimator; (b) now, with this plan; (c) after M9 with a near-complete paper(a): a concrete, checkable result (the bias explains the thesis’ slow evolution) is a strong opener, shows the work is serious, and lets him shape scope (porosity model, comparison with RPMC) before the expensive phases.
Q3Decided 2026-11-10: filling factor φ. Second property for M9filling factor φ (Okuzumi), volume V, ice fractionFilling factor or volume: it is what the thesis and Dullemond’s notes motivate, and Schöll et al. (2026) in his group just argued it is too expensive as an independent dimension.
Q4JournalA&A vs J. Comput. Phys. vs ApJSDecide with Dullemond; A&A default.
Q5Decided 2026-11-10: public research tool at coag.mader.xyz, English only. Web app scoperesearch tool for us and the group vs public teaching toolResearch tool first (personal audience, no i18n or legal pages); a public version only if it turns into a teaching asset.
Q6Decided 2026-11-10: bridge for oracles and figures. Python in the looponly oracles and figures (ADR 0013) vs a full Python API for group membersBridge for oracles and figures now; a polished Python API only if co-authors ask.

Risks

IDRiskLikelihoodImpactMitigation
X1Sampling does not beat full summation even when unbiased and variance reduced (H5 false)mediumhighA clean negative result with a cost model is still publishable as part of a methods paper; the bias analysis, Radau/W-method Jacobian study, and 2D cost surface stand on their own. Decide go/no-go for M9 at the end of M8.
X2Linear solve dominates cost for p = 2 regardless of samplinghighhighPlanned from the start: E13 (sparse, approximate, matrix-free Jacobians).
X3MC noise destabilizes implicit steps at steady statemediummediumHybrid estimator, batch averaging, implicit sampled form, step-size control decoupled from noise (E11, E12).
X4Porosity physics recipes are contested and outside our expertisemediummediumUse one published recipe verbatim (Okuzumi 2012) and keep it swappable; the paper is about numerics, not about the best porosity model.
X5Overlap with other groups (TT methods, Gurrutxaga et al. 2026, RPMC improvements)mediummediumTrack arXiv (astro-ph.EP, math.NA) monthly; position clearly (grid-based, implicit, unbiased). Early contact with Dullemond. The public website makes the work visible early; Vincent accepts this as low risk (Q22).
X6Scope creep (global disk, transport, GPU)highmediumNon-goals in the vision; each extension needs an explicit milestone.
X7Own Radau implementation has subtle bugsmediumhighscipy parity tests on identical problems, order tests, step statistics comparison (M6).
X8Parity with thesis code is hard where the thesis code has bugshighlowParity tests reproduce the thesis behavior behind toggles (e.g. gas_velocity_viscosity = "molecular", estimator = "thesis"); fixes are separate toggles.
X9Time (part-time project)highmediumMilestones produce standalone value (reproduction, web tool, bias note); paper can be split (method paper first, porosity application second).
X10Machine load (16 GB shared Mac)mediumlowheavy lock for studies; CI sizes small; offload large sweeps to a server only with explicit OK.
X11Native f128 stays nightly-only longer than expectedhighlowDouble-double is the stable extended type; f128 is an optional nightly feature (ADR 0016).

Decisions log

Accepted decisions move from here into ADRs. Rejected options stay in the ADR’s “Alternatives” section.

DateDecision
2026-11-10Q1: private GitHub repository until submission, open-source (MIT or BSD-3, chosen at release) with the paper. Project audience: personal until then.
2026-11-10Q2: first contact with Dullemond after M7, leading with the bias finding and a corrected run.
2026-11-10Q1 (grill): local model only for the paper, architecture ready for non-local models (ADR 0015).
2026-11-10Q2: corrected thesis model as primary setup, DustPy-like setup as robustness check, exact thesis model only in R.
2026-11-10Q3: bouncing included; headline runs with and without it.
2026-11-10Q4: second property is the filling factor φ (log grid; mass and volume conserved per collision).
2026-11-10Q5: η on snapshots plus work-precision diagrams (transient and steady state), cost as counts and wall-clock.
2026-11-10Q6: comparisons from literature plus RPMC via Dullemond; no own competitor implementations.
2026-11-10Q7: thesis behavior kept permanently behind toggles with parity fixtures.
2026-11-10Q8: repo/ is the git root; related/ is read-only reference, never edited; what we need is rebuilt in the repo, mostly from scratch in Rust.
2026-11-10Q9 and Q27: web design runs in parallel with M1 and M2; deploy pipeline in M1 (docs page); views ship with their milestones.
2026-11-10Q10: DustPy run as an external oracle at one radius.
2026-11-10Q11: Dominik and Dullemond (2024) bouncing recipe verbatim, validated against one of their figures.
2026-11-10Q12: minimal, swappable porosity physics; richer physics possible later.
2026-11-10Q13: accuracy targets 1 %, 10 %, 0.1 %.
2026-11-10Q14: integrators: explicit Euler, DOPRI 5(4), backward Euler (Newton), linearized implicit Euler, one Rosenbrock-W, own Radau IIA 5.
2026-11-10Q15: p = 1 studies on the Mac; p = 2 compute estimated after M8, paid time only with OK.
2026-11-10Q16 and Q21: switchable precision: f64, double-double, nightly f128 (ADR 0016).
2026-11-10Q17 and Q22: web app public at https://coag.mader.xyz on mk11 from the first view, not staged (DNS set up).
2026-11-10Q18: go/no-go gate for M9 with fixed criteria (roadmap, M8).
2026-11-10Q19: cells × particle grid state, LocalConditions interface, cell position as config key.
2026-11-10Q20: no wholesale copying of related/; third-party material is not committed.
2026-11-10Q23: shared Impressum and privacy pages for the mader.xyz family.
2026-11-10Q24: static hosting on mk11 via the shared Caddy, deployed by GitHub Actions.
2026-11-10Q25: English-only UI (documented exception).
2026-11-10Q26: two-step contact: short note after M4b, full pitch after M7.