Typesetting and References

Paper Layout

Your paper should be divided into logical sections. We recommend using different markdown files as “chapters” of your paper, and then sub-sections inside each file using markdown titles. We require three sections in the index.md file:

  • Abstract
  • Acknowledgements
  • Competing Interests

We also requite that you include both and introduction and conclusion section. You may organize the remainder of the paper however you wish. All code and data required to reproduce the results be provided inline or as external download links to public repositories. Writing style and article content should generally follow the guidelines of the Microscopy and Microanalysis journal. Note that you can specify acronyms in the myst.yml configuration file. For example try hovering over this text: M&M.

Equations

Equations can be typeset using LaTeX notation. To write an inline equation, place it inside a pair of $ symbols, and create equation blocks using pairs of $$ symbols. For example, the general Schrödinger equation is given by itψ(t)=H^ψ(t)i \hbar \frac{\partial}{\partial t} \psi(t) = \hat{H} \psi(t), while the time-independent Schrödinger equation for fast electrons along the zz axis in the small angle scattering limit is given by

ψ(r)t=iλ4πxy2ψ(r)+iσV(r)ψ(r),\frac{\partial \psi(\vec{r}) }{\partial t} = \frac{i \lambda}{4 \pi} \nabla^2_{xy} \psi(\vec{r}) + i \sigma V(\vec{r}) \psi(\vec{r}),

where ii is the imaginary constant, \hbar is the Reduced Planck constant, H^\hat{H} is a Hamiltonian operator, ψ is a wavefunction defined over time tt or 3D space r=(x,y,z)r=(x,y,z), λ is the reduced electron wavelength, σ is the electron-sample interaction constant, and V(r)V(\vec{r}) is the sample’s electrostatic potential Kirkland, 2020.

Equations can be linked using the markdown syntax, for example the above equation has the label eq_schrodinger_electrons, which can be referenced using Equation [](#eq_schrodinger_electrons) which is rendered as Equation (1.1). We suggest using highly descriptive labels for equations and other content.

For other ways to embed mathematical statements, see Math and Equations.

Tables

Tables can be written with markdown syntax:

```{list-table} This is a table.
:header-rows: 1
:name: table_example
* - name
  - value 1
  - value 2
* - a
  - 1
  - 2
* - b
  - 3
  - 4
```

which will generate this Table:

Table 1.1:This is a table.

namevalue 1value 2
a12
b34

More information on markdown tables is given here Tables.

Links, References and Citations

You can link to any figure, equation, code block, section of your paper, or external link. This can performed by using markdown links, or by assigning a label to any portion of your paper and then linking to it. Some examples

Citations can be implemented using either a BibTeX .bib file, or as DOI links. For example, this BibTeX entry:

@article{ophus2019four,
  title={Four-dimensional scanning transmission electron microscopy (4D-STEM):
    From scanning nanodiffraction to ptychography and beyond},
  author={Ophus, Colin},
  journal={Microscopy and Microanalysis},
  volume={25},
  number={3},
  pages={563--582},
  year={2019},
  publisher={Cambridge University Press},
  doi={https://doi.org/10.1017/S1431927619000497},
}

can be cited using the commands

@ophus2019four
[@ophus2019four]
[See @ophus2019four, pg. 4]

which are in turn rendered as:

Writing this citation as a DOI link [@doi:10.1017/S1431927619000497] produces: Ophus, 2019

Each citation will be added to the bibliography at the bottom of each markdown file. Note that we require you to include a DOI link for all journal articles, textbooks, and conference proceedings. The DOIs will be checked when you submit your Computational Article.

For more information on markdown links, see Cross-references. For more information on citations, see Citations and Bibliography especially Markdown Citations.

Code Blocks

Code can be directly embedded into your article using .ipynb files. You can also print code blocks using markup syntax ```language. For example, this block:

```python
import numpy as np

def add_two_numbers(a, b):
  return a + b
```

will be rendered as:

import numpy as np

def add_two_numbers(a, b):
  return a + b

For common languages such as python, syntax highlighting will be automatically applied.

For more information on typesetting code blocks, see Code and Code-blocks.

References
  1. Kirkland, E. J. (2020). Advanced computing in electron microscopy. Springer. https://doi.org/10.1007/978-3-030-33260-0
  2. Wilkinson, M. D., Dumontier, M., Aalbersberg, Ij. J., Appleton, G., Axton, M., Baak, A., Blomberg, N., Boiten, J.-W., da Silva Santos, L. B., Bourne, P. E., & others. (2016). The FAIR Guiding Principles for scientific data management and stewardship. Scientific Data, 3(1), 1–9. https://doi.org/10.1038/sdata.2016.18
  3. Ophus, C. (2019). Four-dimensional scanning transmission electron microscopy (4D-STEM): From scanning nanodiffraction to ptychography and beyond. Microscopy and Microanalysis, 25(3), 563–582. https://doi.org/10.1017/S1431927619000497