PTA Proceedings Format and Style Guidelines
Author
A. Rozanska, R. Smolec, L. Wyrzykowski
License
Creative Commons CC BY 4.0
Abstract
Template for Polish Astronomical Society (PTA) proceedings
Template for Polish Astronomical Society (PTA) proceedings
\documentclass{ptapap}
\usepackage{amsmath}
\usepackage{amssymb}
\author{Agata R\.o\'za\'nska}[CAMK,PAS]
\author{Radek Smolec}[CAMK,UU]
\affil[CAMK]{Nicolaus Copernicus Astronomical Center, Polish Academy of Sciences, Bartycka 18, 00--716 Warsaw, Poland}
\affil[UU]{Unseen University}
\affil[PAS]{Polish Astronomical Society, Bartycka 18, 00--716 Warsaw, Poland}
\title{A Short Introduction to PTA Proceedings Format and Style Guidelines}
\begin{document}
\maketitle
\begin{abstract}
This document serves both as a documentation and as a template for writing
articles. It also contains a short style guide and a list of do's and don'ts
for authors and editors. Feel free to use this template while writing your
contributions to Polish Astronomical Society conference proceedings.
The articles containing only abstract will be not be accepted.
\end{abstract}
\section{Introduction}
The articles for PTA Proceedings should be submitted as a
\LaTeX{} file using the class \texttt{ptapap}. This class is
based on the basic class \texttt{article} and inherits all its
properties.
\subsection{Submission procedure}
{\bf The only submission address is:}
\begin{verbatim}
ptapap@camk.edu.pl
\end{verbatim}
When submitting to PTA proceedings, please {\bf rename
your files using your last name}, e.g., in case your name is Nicolaus Copernicus,
these files should be called \texttt{copernicus.tex} and \texttt{copernicus.bib}.
In case of several
papers uploaded, please also use the numbering in the file name, e.g., \texttt{copernicus2.tex} and \texttt{copernicus2.bib}
Please, send us only the source files, i.e.: \texttt{.tex}, \texttt{.bib} and all figures, all
together compressed into one file named the same as \texttt{.tex} file.
Typically \texttt{tar} and \texttt{gzip} compressions are most welcome, using the command:
\begin{verbatim}
tar cvzf surname.tar.gz surname.tex surname.bib fig1.jpg fig2.jpg ...
\end{verbatim}
{\bf Compressed directories will not be accepted.}
\subsection{The need of simplicity}
Your manuscripts are meant to be printed as a part of a bounded
book, with possible releases in the form of e-book for reading
on portable devices. Both outputs have very little in
common; producing an e-book requires different parsing. {\bf We ask
the authors to use only options supported by our style.}
If you need a feature which is not supported,
drop us an email\footnote{\texttt{ptapap@camk.edu.pl}},
and we will try to make it happen.
\section{Using the class}
Use this file (\texttt{pta4authors.tex}) as a base of your own
manuscript.
Every manuscript needs at least one author, a title
and \verb+\maketitle+ command as the first typesetting command
after the \verb+\begin{document}+. The quite minimal example:
\begin{verbatim}
\documentclass{ptapap}
\author{First Last}[CAMK]
\author{Second Author}[CAMK, PTA]
\affil[CAMK]{Nicolaus Copernicus...}
\affil[PTA]{Polish Astronomical Society...}
\begin{document}
\maketitle
\begin{abstract}
put your abstract text here...
\end{abstract}
\section{Introduction}
your text here
\end{document}
\end{verbatim}
The class itself loads most common \LaTeX{} packages including
\texttt{graphicx} and bibliography.
\begin{figure}
\includegraphics[width=\textwidth]{fig1}
\caption{The graphics is usually full width.
Ah, splendid times doing science stuff in the early Renaissance...}
\label{fig:1}
\end{figure}
\section{Using equations}
The \LaTeX{} is specially devoted to edit state of art mathematical equations.
Please, use only simple equations in the main body of the paper, using \verb+$eq$+. More complicated equations should be separated from the main text and properly labeled. For example, single Eq.~\ref{eq1}
may be typeset using:
\begin{verbatim}
\begin{equation}
\frac{1}{\nu} \frac{\partial(\nu < \upsilon_{\rm z}^{2}>)}{\partial z} =
- \frac{\partial \Phi}{\partial z},
\label{eq1}
\end{equation}
\end{verbatim}
which generates:
\begin{equation}
\frac{1}{\nu} \frac{\partial(\nu < \upsilon_{\rm z}^{2}>)}{\partial z} =
- \frac{\partial \Phi}{\partial z},
\label{eq1}
\end{equation}
nevertheless, a more complex equation may be written as arrays in the following way:
\begin{align}
\alpha_{\rm B} \Omega P_{\rm tot}
&= \frac{dF_{\rm mag}}{dz} + \mathcal{H}_{\rm rec} + \mathcal{H}_{\rm mag} \nonumber \\
&= \frac{d}{dz} \left( 2 P_{\rm mag} v_{\rm B} \right) + \left(2 \xi \Omega P_{\rm mag} - v_{\rm B} \frac{dP_{\rm mag}}{dz} \right).
\label{eq:magnet}
\end{align}
The arrays are placed inside \verb+\begin{align}+ and \verb+\end{align}+ environment.
The first line of the Eq.~\ref{eq:magnet} is not numbered by typing \verb+\nonumber+
on the end of line.
Some mathematical formulas require to use additional \LaTeX{} packages, which can be
added to this manuscript as follows:
\begin{verbatim}
\documentclass{ptapap}
\usepackage{amsmath}
\end{verbatim}
on the top of this manuscript.
\section{Using graphics}
Unless it is necessary otherwise, all graphics should be placed in
figures floats, i.e. separated from the main text. For instance,
the Fig.~\ref{fig:1} was typeset using:
\begin{verbatim}
\begin{figure}
\includegraphics[width=\textwidth]{fig1}
\caption{The graphics is usually full width.
Ah, splendid times doing science stuff in the early Renaissance...}
\label{fig:1}
\end{figure}
\end{verbatim}
and then you can reference its number in text using
\verb+\ref{fig:1}+. The \verb+\label+ statement must be placed
after the \verb+\caption+ statement. Otherwise you can get wrong
reference numbers. This is a bug/feature in \LaTeX{} and we cannot do much
about it except placing this warning.
\begin{figure}
\centering
\begin{minipage}{0.48\textwidth}
\includegraphics[width=\textwidth]{face-1.pdf}
\caption{Dapper young Nicolaus we all know and adore.}
\label{fig:face1}
\end{minipage}
\quad
\begin{minipage}{0.48\textwidth}
\includegraphics[width=\textwidth]{face-2.pdf}
\caption{Time makes a fool of us all, eh?}
\label{fig:face2}
\end{minipage}
\end{figure}
It is up to you whether you use EPS graphics and use the dvi version of your
\LaTeX{}, or use \texttt{pdflatex}. Unfortunately dvi/dvips version of \LaTeX{}
cannot deal with pdf (only eps files), while \texttt{pdflatex} deals with pdf,
png and jpg files, while it fails at pure eps files. If you need to include
such files we recommend using \texttt{pdflatex} instead of plain
\texttt{latex}. The rule of thumb is: keep conversion of graphic files to
necessary minimum, stick to vector graphics if possible for best print results.
Sometimes it is necessary to put two or more figures side-by-side. It is strongly
recommended to divide one figure into two or more panels.
If you don't know how to deal with complicated graphics do
not hesitate to leave it more or less correct.
Here is an example of possible solution of placing two pictures with
separate caption side by side using minipages (less recommended option, which may
be changed by the editor, when necessary).
\begin{verbatim}
\begin{figure}
\centering
\begin{minipage}{0.48\textwidth}
\includegraphics[width=\textwidth]{face-1.pdf}
\caption{Dapper young Nicolaus we all know and adore.}
\label{fig:face1}
\end{minipage}
\quad
\begin{minipage}{0.48\textwidth}
\includegraphics[width=\textwidth]{face-2.pdf}
\caption{Time makes a fool of us all, eh?}
\label{fig:face2}
\end{minipage}
\end{figure}
\end{verbatim}
\section{Using tables}
An example of table is presented in Tab.~\ref{tab:fejki}. It was typeset using:
\begin{verbatim}
\begin{table}[h]
\caption{Table caption here}
\begin{tabular}{|l|ccr|}
your four rows should be placed here
\end{tabular}
\end{table}
\end{verbatim}
This particular table is designed for four columns and four rows. Border lines were defined arbitrarily. The align of the text in columns is defined
by letters in \verb+\begin{tabular}{|l|ccr|}+, where \texttt{l} means left, \texttt{c} -- center,
and \texttt{r} -- right.
\begin{table}[h]
\caption{Fake spectra parameters for A, B, and C model atmospheres. Different combinations
of vertical and horizontal lines are used.}
\label{tab:fejki}
\begin{center}
\begin{tabular}{|l|ccr|}
\hline
%\multicolumn{5}{|c|}{fe0l219} \\ \hline
% & fe0l219& fe0l220 & fe0l221 \\ \hline
name & A & B & C \\ \hline \hline
& & & \\
$T_{\rm eff}$ [K] & $2.19 \times 10^7$ & $2.20 \times 10^7$ & $2.21 \times 10^7$ \\
& & & \\
$\log g$ [cgs] & 14.25 & 14.30 & 14.35 \\
& & & \\
$F$ [erg~cm$^{-2}$~s$^{-1}$] & 3.62 $\times 10^{-10}$ & 4.47 $\times 10^{-10}$ & 3.46 $\times 10^{-10}$ \\ \hline
\end{tabular}
\end{center}
\end{table}
\section{BiBTeX and bibliographic style}
For simplicity, the PAS Proceedings use the {\aap} and {\apj} style for
citations. Abbreviations of journal names are taken from
\texttt{aas\_macros.sty}\footnote{Originally at \texttt{http://doc.adsabs.harvard.edu/abs\_doc/aas\_macros.sty}, but also propagated with this \texttt{ptapap} class.}.
Please, do not put the literature references directly at the end of the document like that:
\begin{verbatim}
WRONG:
\begin{thebibliography}{}
\bibitem[Copernicus(1543)]{1543droc.book.....C}
Copernicus, N.\ 1543, Norimbergae, Apud J.~Petreium, 1543;
[Bruxelles, Culture et Civilisation, 1966],
\end{thebibliography}
\end{verbatim}
The correct was is to use the \texttt{bibtex} (natbib) with the \texttt{bibtex} bibliography
file \texttt{yourname.bib}:
\begin{verbatim} \bibliography{yourname} \end{verbatim}
In the original version of this document, we use the
\texttt{pta4authors.bib}.
\texttt{BiBTeX} is nice, because one can easily copy the from the NASA ADS\footnote{Note in the new ADS the \texttt{BiBTeX} entry for an article can be found under Export Citation link on the left},
place it into a file (e.g., \texttt{yourname.bib}) and reuse it many times in different journals and bibliography styles.
For example, let your file \texttt{yourname.bib} contain the following entry,
\begin{verbatim}
@BOOK{1543droc.book.....C,
author = {{Copernicus}, N.},
title = "{D revolutionibus orbium coelestium}",
keywords = {SOLAR SYSTEM, ASTRONOMY: EARLY WORKS TO 1800},
booktitle = {Norimbergae, Apud J.~Petreium, 1543;
[Bruxelles, Culture et Civilisation, 1966]},
year = 1543,
adsurl = {http://adsabs.harvard.edu/abs/1543droc.book.....C},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
\end{verbatim}
In the above example, one can cite Nicolaus Copernicus' original edition as \citet{1543droc.book.....C}
with \texttt{\textbackslash citet}, as well as other references with
\texttt{\textbackslash citep}, if need be \citep{1985mwpn.book.....K}. If the
citation has to appears in brackets, please use \texttt{\textbackslash citealt}
instead of \texttt{\textbackslash citet} (like here,
\citealt{1985mwpn.book.....K}). Please, follow the Internet
links\footnote{\texttt{http://merkel.zoneo.net/Latex/natbib.php}} to get
detailed instructions.
Only for references where the number of authors is less or equal three, the whole list of authors will appear in the list of references in case of
any style of citation, for instance: \citep{shaposhnikov-mxbm}. For the number of authors higher than three, only the first name will appear in the list of references,
for instance \citep{lee2011}
{\bf Please, send us .bib file together with your .tex file. The only .bbl will be not accepted}.
\section{Style guidelines}
Here are some simple style rules we would like to keep (no particular order at this point):
\begin{itemize}
\item for quotation marks, use single quotation mark: ' and twice the single quotation mark: ''. If you use single quotations marks, then use double quotation marks for a quote within a quote (and vice versa),
\item do not use colors in Table/Figure captions,
\item use Figure, Equation, Table at the beginning of the sentence, but Fig., Figs. (in case of many), Eq., Eqs., Tab., Tabs, in the middle of the sentence,
\item write Fig.~1, Eq.~2, not Fig.~(1), Eq.~(2),
\item keep numbering of sections (\texttt{\textbackslash section}, not \texttt{\textbackslash section*}),
\item keep paragraphs intended,
\item use either British (colour, modelled, optimise) or American (color, modeled, optimize) spelling consistently throughout the article,
\item use footnotes for Internet websites\footnote{Take a look at this cool site: \texttt{https://www.pta.edu.pl/proc} .},
\item write the units with the Roman font (in math mode it requires \texttt{\textbackslash text\{\}} or \texttt{\textbackslash mathrm\{\}} of \texttt{amsmath}),
\item mathematical symbols should be written in {\it Italic}, while their superscripts or subscripts
should be in Roman font, as in case of magnetic flux: $F_{\rm mag}$,
\item names of functions should be in Roman as: $\log g$ by typing \verb+$\log g$+,
\item use vector graphics for best printing results, but try to make the files as small in size as possible,
\item if any of the above rules are unclear, please drop us an email\footnote{\texttt{ptapap@camk.edu.pl}}.
\end{itemize}
\section{Input and output encoding}
The class enforces UTF-8 encoding.
We strongly suggest authors keeping UTF-8 in their manuscripts.
We assume that UTF-8 is {\it de facto} standard of
encoding in the second decade of XXI century.
If you absolutely can not use UTF-8, you can type \verb+\usepackage[...]{inputenc}+ but keep in mind we will have to re-encode your text.
\acknowledgements{We thank Krzysztof Leszczy{\'n}ski and Micha{\l } Bejger
for creating and developing this \texttt{ptapap} class.
This work was partially supported by the Polish Astronomical Society and the Nicolaus
Copernicus Astronomical Center, Warsaw, Poland.}
\bibliographystyle{ptapap}
\bibliography{pta4authors}
\end{document}