\chapter{Introduction}
\label{cha:introduction}

The template was prepared as part of my course \textit{\LaTeX\ for Scientists} taught in the AGH Doctoral School. If you are unfamiliar with \LaTeX\ and you don't want to attend the classes, you can learn \LaTeX\ from materials available on the Internet, such as these books: \cite{Datta:LaTeX:2017}, \cite{Oetiker:LaTeX:2018}, \cite{Krishnan:LaTeX:2003}. All these books can be easily found on the Internet and are legally available. I recommend my book~\cite{Szpyrka:LaTeX:2026} to Polish-speaking students.

\begin{figure}[!htb]
\centering
\includegraphics[scale=0.33]{okladka}
\caption{\LaTeX\ praktyczny przewodnik}
\label{fig:latex:okladka}
\end{figure}

%------------------------------------------------------------

\section{Class options}
\label{sec:class:options}


The \textit{aghphd} provides 4 basic options:
\begin{description}
\item[en] -- Sets the language of the thesis to English -- remember to set the \textit{english} option for the \textit{babel} package.

\item[pl] -- Sets the language of the thesis to Polish -- remember to set the \textit{polish} option for the \textit{babel} package.

\item[auxsup] -- Includes information about the auxiliary (assistant) supervisor on the title page.

\item[secsup] -- Includes information about the second (main) supervisor on the title page.

\end{description}

%------------------------------------------------------------

\section{Basic information about thesis}
\label{sec:basic:information}


The main file \textit{phdthesis.tex} contains a sequence of commands that are used to define basic information about the thesis.

\begin{description}
\item \verb!\fieldofscience{}! -- sets the field of science, the available options are:
\begin{itemize}
	\item Engineering and technology
	\item Natural sciences
	\item Social sciences
	\item Humanities
\end{itemize}

\item \verb!\discipline{}! -- sets the scientific discipline, the available options are:
\begin{itemize}
	\item Automation, electronic, electrical engineering and space technologies
	\item Information and communication technology
	\item Biomedical engineering
	\item Chemical engineering
	\item Civil engineering, geodesy and transport
	\item Materials engineering
	\item Mechanical engineering
	\item Environmental engineering, mining and energy
	\item Computer and information sciences,
	\item Mathematics,
	\item Chemical sciences,
	\item Physical sciences,
	\item Earth and related environmental sciences,
	\item Economy and finances
	\item Management and quality science,
	\item Sociology,
	\item Cultural and religious studies.
\end{itemize}

\item \verb!\title{}! -- sets the title of the thesis.

\item \verb!\shorttitle{}! -- sets the short title of the thesis -- If the full title fits in the footer on one line use the full title of the thesis here. Otherwise, define an abbreviated version of the title.

\item \verb!\author{}! -- sets the PhD candidate first name and family name.

\item \verb!\shortauthor{}! -- sets the PhD candidate first name initial and family name -- This version is used in the footer.

\item \verb!\supervisor{}! -- sets the first supervisor name with degrees.

\item \verb!\secondsupervisor{}! -- sets the second (main) supervisor or the auxiliary supervisor name with degrees.

\item \verb!\faculty{}! -- sets the faculty name, the available options are:
\begin{itemize}
	\item Academic Centre for Materials and Nanotechnology
	\item Faculty of Applied Mathematics
	\item Faculty of Civil Engineering and Resource Management
	\item Faculty of Computer Science, Electronics, and Telecommunications
	\item Faculty of Drilling, Oil, and Gas
	\item Faculty of Electrical Engineering, Automatics, Computer Science, and Biomedical Engineering
	\item Faculty of Energy and Fuels
	\item Faculty of Foundry Engineering
	\item Faculty of Geo-Data Science, Geodesy, and Environmental Engineering
	\item Faculty of Geology, Geophysics, and Environmental Protection
	\item Faculty of Humanities
	\item Faculty of Management
	\item Faculty of Materials Science and Ceramics
	\item Faculty of Mechanical Engineering and Robotics
	\item Faculty of Metals Engineering and Industrial Computer Science
	\item Faculty of Non-Ferrous Metals
	\item Faculty of Physics and Applied Computer Science
\end{itemize}

\item \verb!\date{}! -- sets the year of the thesis preparation.

\item \verb!\acknowledgements{}! -- sets the acknowledgements that are typeset on a separate page..

\end{description}


%------------------------------------------------------------

\section{Supervisors}
\label{sec:supervisors}

If the dissertation was prepared under the supervision of only one supervisor, then you do not use any of the options \textit{auxsup} or \textit{secsup}. In this case, the information about the supervisor is typeset as follows:

\medskip
\begin{tabular}{rl}
Supervisor: & Prof. Marcin Szpyrka, PhD, DSc
\end{tabular}

\bigskip

If the dissertation was prepared under the supervision of two main supervisors, then you should add the \textit{secsup} class option. In this case, the information about the supervisors is typeset as follows:

\medskip
\begin{tabular}{rl}
	Supervisor: & Prof. Marcin Szpyrka, PhD, DSc\\
	& Prof. Adam Iksiński, PhD, DSc
\end{tabular}

\bigskip

If the dissertation was prepared under the supervision of a main supervisor and an auxiliary supervisor, then you should add the \textit{auxsup} class option. In this case, the information about the supervisors is typeset as follows:

\medskip
\begin{tabular}{rl}
	First supervisor: & Prof. Marcin Szpyrka, PhD, DSc\\
	Assisting supervisor:& Prof. Adam Iksiński, PhD, DSc
\end{tabular}



%------------------------------------------------------------

\section{Chapters and appendices}
\label{sec:chapters:appendices}

I recommend preparing each chapter and appendix in a separate \textit{tex} file. In this template, examples of such files have names beginning with \textit{chapter}. Add each of your chapters using the \verb!\include{}! command. Chapter should be included after the \textit{add your chapter here} comment.

If you want to add attachments, uncomment the \verb!\appendix! command. Appendices are added in the same way as chapters, but the \verb!\include{}! commands must be placed after the \verb!\appendix! command.


%------------------------------------------------------------

\section{Bugs}
\label{sec:bugs}


I prepared this class trying to do my best. There will probably be some errors in it anyway. If you notice something, just send me an email to \texttt{mszpyrka@agh.edu.pl}





