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 ,
while the time-independent Schrödinger equation for fast electrons along the axis in the small angle scattering limit is given by
where is the imaginary constant, is the Reduced Planck constant, is a Hamiltonian operator, ψ is a wavefunction defined over time or 3D space , λ is the reduced electron wavelength, σ is the electron-sample interaction constant, and 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.
name | value 1 | value 2 |
---|---|---|
a | 1 | 2 |
b | 3 | 4 |
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
- Article Template for Elemental Microscopy
- Typesetting and References
- Paper Layout
- Equation (1.1)
- Figure 1.2
- Figure 2.2
- Table 1.1
- https://
www .go -fair .org /fair -principles / - Wilkinson et al., 2016
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.
- Kirkland, E. J. (2020). Advanced computing in electron microscopy. Springer. https://doi.org/10.1007/978-3-030-33260-0
- 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
- 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