Skip to content

Docs: TOML-first usage, input reference, automatic figure, choosing nu and Nn - #65

Open
rogeriojorge wants to merge 7 commits into
feature/toml-examplesfrom
docs/toml-first-usage
Open

rogeriojorge wants to merge 7 commits into
feature/toml-examplesfrom
docs/toml-first-usage

Conversation

@rogeriojorge

Copy link
Copy Markdown
Member

Stacked on #64.

  • README: Usage and Input File Format are rewritten around the one-file workflow, spectrax input.toml or a three-line Python script. The input reference is a complete commented species TOML, checked to parse, with units stated once. It replaces the old table of internal keys (dn1, nx, ...) that only the default case used.
  • Automatic figure: the README lists each panel and what it is for.
  • Choosing nu and Nn: a short guide on how to read the Hermite-spectrum panel. It also states that, for ion waves with hot electrons, the sink also supplies electron Landau damping, and that nu of order 1 ω_pe with 128 or more Hermite modes reproduces exact kinetic growth rates. This was measured for the three-population ion-acoustic benchmark.
  • docs/getting_started.rst: rewritten as install, run a case, Python API and examples.

Documentation only. No code changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant