Skip to content

Commit 42d2bd9

Browse files
committed
docs: updated documentation
1 parent 8cd1fab commit 42d2bd9

File tree

633 files changed

+9224
-2150
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

633 files changed

+9224
-2150
lines changed

docs/source/cli.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# PyMCNP CLI
2+
3+
PyMCNP provides tools for formatting MCNP files, visualizing MCNP geometries, and running
4+
MCNP simulations using the ``pymcnp`` CLI.
5+
6+
## Manual Pages
7+
8+
The manual page for ``pymcnp``:
9+
10+
```{eval-rst}
11+
.. literalinclude:: ../../src/pymcnp/main.py
12+
:language: python
13+
:start-after: """
14+
:end-before: """
15+
```
16+
17+
### Check
18+
19+
The manual page for ``pymcnp check``:
20+
21+
```{eval-rst}
22+
.. literalinclude:: ../../src/pymcnp/cli/check.py
23+
:language: python
24+
:start-after: """
25+
:end-before: """
26+
```
27+
28+
### Convert
29+
30+
The manual page for ``pymcnp convert``:
31+
32+
```{eval-rst}
33+
.. literalinclude:: ../../src/pymcnp/cli/convert.py
34+
:language: python
35+
:start-after: """
36+
:end-before: """
37+
```
38+
39+
### Plot
40+
41+
The manual page for ``pymcnp plot``:
42+
43+
```{eval-rst}
44+
.. literalinclude:: ../../src/pymcnp/cli/plot.py
45+
:language: python
46+
:start-after: """
47+
:end-before: """
48+
```
49+
50+
### Run
51+
52+
The manual page for ``pymcnp run``:
53+
54+
```{eval-rst}
55+
.. literalinclude:: ../../src/pymcnp/cli/run.py
56+
:language: python
57+
:start-after: """
58+
:end-before: """
59+
```
60+
61+
### Visualize
62+
63+
The manual page for ``pymcnp visualize``:
64+
65+
```{eval-rst}
66+
.. literalinclude:: ../../src/pymcnp/cli/visualize.py
67+
:language: python
68+
:start-after: """
69+
:end-before: """
70+
```

docs/source/cli.rst

Lines changed: 0 additions & 77 deletions
This file was deleted.

docs/source/conf.py

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,4 @@
2020
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
2121

2222
extensions = ['sphinx.ext.napoleon', 'myst_parser']
23-
24-
templates_path = ['_templates']
25-
exclude_patterns = []
2623
autodoc_member_order = 'bysource'
27-
28-
# -- Options for HTML output -------------------------------------------------
29-
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
30-
31-
html_theme = 'sphinx_rtd_theme'
32-
html_static_path = []

docs/source/examples.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
# Examples
22

3-
For examples using the command line, see the [Comand Line Interface](cli.rst).
4-
53
## Loading a file
64

75
import pymcnp
@@ -19,11 +17,10 @@ use the universal `modify` function.
1917
filename = "/path/to/data/input.i'
2018
data = pymcnp.read_input(filename)
2119

22-
pymcnp.modify(x.data.card_s['nps'], npp=100_000)
20+
pymcnp.modify(x.data._cards['nps'], npp=100_000)
2321

2422
data.to_mcnp_file('/path/to/data/new_file_name.i')
2523

26-
2724
However, dor common operations, we have specific helper functions, so
2825
the above can also be done using:
2926

@@ -127,10 +124,8 @@ the data of a specific one and easily plot it.
127124
Creates the following image:
128125
![F1F8 Tally plot](./images/Example-F1F8-tally.png)
129126

130-
131127
### Energy and time
132128

133-
134129
file = "data/output_files/png_e.o"
135130
out = pymcnp.outp.ReadOutput(file)
136131

docs/source/functions.rst

Lines changed: 0 additions & 8 deletions
This file was deleted.

docs/source/index.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# PyMCNP Documentation
2+
3+
PyMCNP is a Python package and CLI for interfacing
4+
with [MCNP](https://mcnp.lanl.gov). PyMCNP parsers MCNP files,
5+
visualizes simulation geometries, and runs MCNP simulations in parallel.
6+
7+
## Table of Contents
8+
9+
```{eval-rst}
10+
.. toctree::
11+
:maxdepth: 1
12+
13+
cli
14+
pymcnp
15+
installation
16+
examples
17+
contributing
18+
```
19+
20+
## Components
21+
22+
PyMCNP has two main components:
23+
24+
* [pymcnp CLI](cli)
25+
26+
* [pymcnp Library](pymcnp)
27+
28+
## Guides
29+
30+
PyMCNP has guides:
31+
32+
* [Installation](installation)
33+
34+
* [Examples](examples)
35+
36+
* [Contributing](contributing)

docs/source/index.rst

Lines changed: 0 additions & 29 deletions
This file was deleted.

docs/source/pymcnp-cli.rst

Lines changed: 0 additions & 10 deletions
This file was deleted.

docs/source/pymcnp-inp.rst

Lines changed: 0 additions & 66 deletions
This file was deleted.

docs/source/pymcnp-ptrac.rst

Lines changed: 0 additions & 35 deletions
This file was deleted.

0 commit comments

Comments
 (0)