-
Notifications
You must be signed in to change notification settings - Fork 1
/
assignment_tmpl_eng.tex
202 lines (167 loc) · 9.73 KB
/
assignment_tmpl_eng.tex
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
%
% Assignment @ DIPT
%
\documentclass[12pt,a4paper]{article}
%
% Set a flag to include or exclude the blue comment boxes.
\usepackage{etoolbox}
\newtoggle{todos}
\toggletrue{todos}
%\togglefalse{todos}
%
\include{preamble} % Contains commands that we pushed to a separate file.
% Please identify COURSE CODE and COURSE NAME.
\newcommand{\theCourse}{PA1234: Course name}
% Please identify ASSIGNMENT NAME.
\newcommand{\theAssignment}{Assignment name, number and/or title}
% *** Do not touch the following lines. BEGIN. ***
\title{\theAssignment\\\vspace{1mm}\footnotesize{Template version \templateVersion}}
\author{\textsc{\theCourse}}
\date{\today}
%
\begin{document}
%
\maketitle
%
\vspace*{-12mm}
% *** END. Do not touch the lines above. ***
% *** BELOW YOU INSERT BASIC INFORMATION ABOUT THE ASSIGNMENT ***
\begin{longtable}{|l|p{12.15cm}|}
\hline
Group name/ID & Group name or ID, in case this is a group exercise \\
\hline
Title & Title of the answer/ solution \\
\hline
Supervisor(s) & Supervisor name(s), if applicable \\
\hline
\end{longtable}
% *** BELOW YOU INSERT DETAILS ABOUT WHO DID WHAT ***
\vspace*{-7mm}
\begin{small}
\begin{longtable}{|l|l|p{10.9cm}|}
\hline
\multirow{4}{*}{Student 1}
& Name & Full name as given in Ladok \\ \cline{2-3}
& E-Mail & ...@student.bth.se \\ \cline{2-3}
& Program & Program you are registered in \\ \cline{2-3}
& Contribution & Contribution of student 1 to this assignment (if there are several students) \\
\hline
\multirow{4}{*}{Student 2}
& Name & \\ \cline{2-3}
& E-Mail & \\ \cline{2-3}
& Program & \\ \cline{2-3}
& Contribution & \\
\hline
\end{longtable}
\end{small}
\todo[inline]{Please add/delete table rows, if necessary. You can leave the rows for group name/ID and/or supervisors empty or delete them, if there are no groups or specific supervisors for the assignment. Don't forget to delete the blue comment-boxes before submission by uncommenting the row \texttt{\textbackslash togglefalse\{todos\}} at the top of the \LaTeX\ source code.}
\todo[inline]{If you use some other text processing software (e.g., Word), please make sure to follow the formatting used in this document as closely as possible.}
% *** BELOW YOU MAINTAIN THE DOCUMENT HISTORY ***
\begin{small}
\begin{longtable}{|l|p{13.3cm}|}
\hline
\multicolumn{2}{|l|}{\textbf{Submission/change history (latest entry on top)}} \\
\textbf{Date} & \textbf{Changes made} \\
\hline
2019-04-01 & Complemented due to FX. Changes made: ... \\
\hline
2019-03-22 & Initial submission. \\
\hline
\end{longtable}
\end{small}
\todo[inline]{In the table above, you should briefly describe the revision history of your submission.}
\setcounter{table}{0} % The tables on the front page shouldn't be counted
% When you need a table of contents, you can uncomment the following line(s)
% \setcounter{tocdepth}{2} % Sets the level of sections/subsections for the table of contents
% \tableofcontents
\newpage
% *** THE ACTUAL ASSIGNMENT CONTENT STARTS HERE ***
\section{Introduction to the template}
\label{sec:intro}
This document describes in generic terms how a typical assignment submission should look like with respect to formatting and contents.
There are many types and purposes of assignments.
This document can therefore only cover general rules and guidelines.
Please make sure to carefully read the assignment description for your particular assignment, since it might describe additional or more specific requirements.
\section{Sections and subsections}
\label{sec:main}
All assignment submissions should have a Section \textit{Introduction} where you describe the overall purpose of the assignment, introduce key concepts or terms and give a very brief overview over your approach or solution. The remainder of your submission should be structured into sections and subsections that are appropriate for the current assignment. The structure should provide a good high-level overview over your submission, so that it is easy to navigate through the contents and find specific parts. A single \textit{Main}-section will be insufficient, except for very short assignments.
Which sections and/or subsections are required or suitable will differ from assignment to assignment. Examples of sections or subsections for assignments are Prerequisites, Assumptions, Related work, Results, Analysis, Design, Implementation, Limitations, Evaluation, Discussion, Summary, and Conclusions.
The formatting of sections and subsections is exemplified below. Please note that regular paragraphs in sections, subsections, and sub-subsections are not indented. Paragraphs start at the left margin of the page and are aligned left and right, i.e. as in the paragraphs in this document. There is no space between paragraphs. However, the first line of a paragraph is indented, except for the first paragraph in each section, subsection, and sub-subsection.
\subsection{Example subsection header}
\subsubsection{Example sub-subsection header}
Normally, you should not use subsections on levels deeper than three. If you need more structure below level three or if you want to structure your text without numbered headers, you can for example use lists or named paragraphs. You can have bullet-lists, numbered lists, etc. Some examples are shown below. After the example lists, you can also see an example of a named paragraph.
\begin{itemize}
\item A list item.
\item Another list item.
\begin{enumerate}
\item Lists can be nested. The text for a single list item may span several lines and should be indented as shown in this example.
\begin{enumerate}
\item You should not nest them too deeply, though.
\item There are more types of lists, but the ones here should do for a start.
\end{enumerate}
\item You can also change the numbering scheme, but the standard settings shown here should do for a start.
\end{enumerate}
\end{itemize}
\paragraph{Named paragraph.}
Note that named paragraphs are not numbered.
\section{Tables, figures and references}
\label{sec:tab}
In your assignments, you can use tables, figures and references. The entries in the reference list should be sorted alphabetically. Examples of tables and figures are shown below. Their numbering is automatic. Please note that table captions are on top of the tables, whereas figure captions are below the figures.
Please do also note that figures and tables are placed automatically and do not always end up where intended.
\begin{table}[bth]
\centering
\caption{An example of a table.}
\label{tab:ex}
%\begin{small}
\begin{tabular}{|l|r|p{6cm}|}
\hline
\textbf{Items} & \textbf{Number} & \textbf{Comment} \\
\hline
Books & 25 & We categorized everything longer than 50 pages as a book. \\
\hline
Reports & 8 & Blablabla... \\
\hline
Etc. & & \\
\hline
\end{tabular}
%\end{small}
\end{table}
Creating tables and figures can be difficult, since \LaTeX\ is no ``what you see is what you get'' environment. For simple tables, you can use generators, like the one on \url{https://www.tablesgenerator.com} for help. For figures, it is easiest to provide them in separate files and import them using \LaTeX's \texttt{\textbackslash includegraphics} command. The included files can have various formats, like, for example, JPG or PDF.
Using command \texttt{\textbackslash ref}, you can insert cross-references to other places in your document, for example sections (e.g., Section \ref{sec:intro}), tables (e.g., Table \ref{tab:ex}), figures (e.g., Figure \ref{fig:bth}), listings (e.g., Listing \ref{lst:add})), equations (e.g., Equation \ref{eq:fx}), etc. Note that you can only reference places that have a corresponding \texttt{\textbackslash ref} command in the \LaTeX\ code. This command you need to place there manually. For references to literature (citations), there is a special command (\texttt{\textbackslash cite}). You can find examples for that in the next section.
\begin{figure}[bth]
\centering
\includegraphics[width=0.6\columnwidth]{example-graph}
\caption{An example graph.}
\label{fig:uml}
\end{figure}
\begin{figure}[bth]
\centering
\includegraphics[width=0.6\columnwidth]{example-fig}
\caption{An example figure.}
\label{fig:bth}
\end{figure}
\section{Source code and equations}
\label{sec:code}
Source code can be printed nicely using the \texttt{lstlisting}-environment, as in the example below. There are many parameters for the listings and code can also be loaded from a file. Please check the documentation of package \texttt{listings} for details.
\noindent
\begin{minipage}{\textwidth}
\begin{lstlisting}[frame=single,language=Python,basicstyle=\small,caption={Example of a code-listing.},label={lst:hello}]
# Python3 example for printing a constant string
print("Hello World!"!)
\end{lstlisting}
\end{minipage}
\lstinputlisting[frame=single,language=Python,basicstyle=\small,caption={Another example of a code-listing.},label={lst:add}]{exampleCode.py}
Equations can be typeset and numbered using the \texttt{equation}-environment, as in equation \ref{eq:fx} below.
\begin{equation}
\label{eq:fx}
f(x) = (\frac{1}{\sqrt{x}})^2
\end{equation}
\section{More information}
\label{sec:more}
For more details on report writing, please refer to \textit{Rapportskrivning för ingenjörer} \cite{nilsson2018rapport} (Swedish only), which can be downloaded from the library's Writing Guide (Skrivguiden)\footnote{\url{http://skrivguiden.se/resurser/bth-resurser/} (Swedish) or \url{http://writingguide.se/resources/bth-resources/} (English)}. There are also of resources for learning \LaTeX\ on \url{https://www.overleaf.com/learn}. There are also numerous free guides for learning \LaTeX\ on the Internet, e.g., \cite{oetiker2011not}.
% All references are stored in a separate bib-file: ass-refs.bib
%\clearpage
\small
\bibliographystyle{plain}
\bibliography{ass-refs}
\end{document}