template: sohpc-template.tex

\documentclass[a4paper, twoside]{article}
\usepackage[margin=12mm, bottom=0.75in, verbose]{geometry}
\usepackage{graphicx}
\usepackage{here, multicol, fancyhdr}
\usepackage{charter, courier}
\usepackage[OT1,T1]{fontenc} %use TeX encoding then Type 1.
\usepackage[protrusion=true, expansion=true]{microtype} % Better typography
\usepackage[english]{babel} % English language/hyphenation
\usepackage{amsmath,amsfonts,amsthm} % Math packages
\usepackage{lettrine} % dropped capital letter
\usepackage{booktabs} % Horizontal rules in tables
\usepackage[small, labelfont=bf, up, textfont=up]{caption}
\usepackage[rgb]{xcolor} % Should be CMYK if supported by the system
\definecolor{prace-orange}{rgb}{1.0,0.42, 0.1} % 255, 107, 25
% Colours by PRACE graphics guidelines
%\definecolor{prace-darkblue}{rgb}{0.1, 0.19, 0.48} % 25, 49, 123
%\definecolor{prace-lightblue}{rgb}{0.52, 0.81, 0.94} %132, 206, 239
% Colours by SoHPC logo pipette measurements
\definecolor{prace-darkblue}{rgb}{0.08, 0.31, 0.58} % #155195 = 21,81,149
\definecolor{prace-lightblue}{rgb}{0.32, 0.73, 0.93} % #51bbed = 81,187,237
\newcommand{\highlight}[1]{\textcolor{prace-orange}{#1}}
\definecolor{link}{rgb}{0.1, 0.19, 0.48}  
\usepackage{sectsty} % Enables custom section titles
\allsectionsfont{\large\color{prace-orange}\usefont{OT1}{phv}{m}{n}}
\usepackage[superscript,biblabel]{cite}
\usepackage{calc,float,wrapfig}\restylefloat{figure}
\usepackage{lipsum} % Used for inserting dummy 'Lorem ipsum'

\usepackage[colorlinks=true, linkcolor=link, anchorcolor=link,citecolor=link,
filecolor=link, menucolor=link,urlcolor=prace-darkblue]{hyperref}

%To automatically convert Inkscape SVG into PDF or EPS use:
% pdflatex -synctex=1  --enable-write1 sohpc-template.tex
\newcommand{\includegraphicsvg}[2][]{%
  \ifnum\pdfstrcmp{\pdffilemoddate{./#2.svg}}%
  {\pdffilemoddate{../gen/#2.pdf}}>0%
  {\immediate\write18{inkscape -z -D --file=./#2.svg %
      --export-pdf=#2.pdf --export-eps=#2.eps %
      --export-area-drawing}}\fi%
  \includegraphics[#1]{#2}%
}

% http://tex.stackexchange.com/questions/59166/span-column-in-a-multicols-environment
\newcounter{tempcolnum}
\makeatletter
\newcommand{\multicolinterrupt}[1]{% Stuff to span rows
\setcounter{tempcolnum}{\col@number}
\end{multicols}
#1%
\begin{multicols}{\value{tempcolnum}}
}
\makeatother

\hyphenation{SoHPC AntiSpam} % do not hyphenate

\usepackage{titling}

\pretitle{\vspace{-30pt} \begin{flushleft}
    \usefont{OT1}{phv}{m}{n}\selectfont\large}

\title{Long Title Describing Short Title can Consist of
    up to 3 lines} % Your article title

\posttitle{\par\end{flushleft}\vskip 0.5ex}

\renewcommand{\maketitlehookb}{\par\noindent\flushleft%
\fontsize{45}{50}\usefont{OT1}{phv}{m}{n}\selectfont%
\highlight{Short Title} for SoHPC} 

\preauthor{\vskip 0.9ex \begin{flushleft}\large
    \usefont{OT1}{phv}{b}{sl} \color{prace-orange}}

\author{Leon Kos} % Name and surname

\postauthor{\par\end{flushleft}}

\predate{}\date{}\postdate{\vspace{-50pt}}
\pagestyle{empty}
% Do not enable page numbering below as it will be inserted by the publication
%\pagestyle{fancy}\fancyhf{}\renewcommand{\headrulewidth}{0pt}\renewcommand{\footrulewidth}{0pt}\fancyfoot[C]{\colorbox{orange}{\raisebox{0mm}[4mm][7mm]{\textcolor{white}{\usefont{OT1}{phv}{m}{n}\selectfont~\thepage~}}}}

\begin{document}
\noindent
\begin{minipage}{0.44\linewidth}
  \maketitle
  \thispagestyle{empty}
  \fontsize{14pt}{20pt}\usefont{OT1}{phv}{m}{n}\selectfont
  \raggedright
  Describe motivation of the project and main results in an abstract like  manner. The size of this description should not be large. Several lines  will do the job of attracting readers. It can state some highlights of the project. 
\end{minipage}\hfill
\begin{minipage}{0.5\textwidth}
  \includegraphics[width=\linewidth]{sohpc-logo}
  %\includegraphicsvg[width=\linewidth]{sohpc-logo}
\end{minipage}
\vskip 30pt
\frenchspacing

\begin{multicols}{3}

\lettrine[lines=4,nindent=0em]{\highlight{T}}{}his template is used for
PRACE Summer of HPC project newsletter report in popular science format that should be 2-3 pages long with graphics. The target audience is an educated adult, without scientific education in the field of the project. The report should contain a title, abstract, references and acknowledgements. 
% http://ctan.ijs.si/tex-archive/macros/latex/contrib/wrapfig/multiple-span.txt
\vspace{13\baselineskip} % we enforce space here for figure in right column
The report should cover an introduction, methods, results and conclusions but does not have to contain these as section headings. Tone should be more informal than a journal article. Your enthusiasm should show. You can use your blog posts as a basis for this report. 

Graphics should be your own. Short title should be just few words. Highlight word or two to give some separation within the short title. Long name preceding short title is not necessarily the title of your project as facts about the projects, mentors and the author(s) are given at the end. Usually in magazines no two articles are the same in terms of formatting. You are free to do figure positioning and column spans. Bear in mind that with multiple columns spanning in \LaTeX is non-trivial.
\begin{wrapfigure}[13]{l}[\columnwidth+\columnsep]{1.3\columnwidth}
  \color{yellow}\rule{\linewidth}{3cm}\color{black}
  %\includegraphics[width=\linewidth]{fig1}
  \caption{Use \href{http://www.ctan.org/pkg/wrapfig}{WrapFig} only if you are wrapping a text around the figure that flows on more that one column. See \href{http://ctan.ijs.si/tex-archive/macros/latex/contrib/wrapfig/multiple-span.txt}{instructions} on how to find breaking point on each column. Note that captions are not preferred.}
  \label{fig:myfig1}
\end{wrapfigure}
\noindent Example nearby shows how can wrapfig be used for spanning into two columns. Don't be afraid of large screenshots. To get an idea on the style take a look into PRACE digest, newsletter and other popular scientific texts available on Internet. Google for \highlight{writing popular scientific}. For example: \url{http://awelu.srv.lu.se/genres-and-text-types/writing-in-academic-genres/popular-science-writing/}

\section*{Paper format}
We use A4 paper size with 10pt Charter or Georgia font. Text at the end and captions should be 9pt. Short title Helvetica (Arial) medium or light 45pt with 50pt spacing. Long title and Abstract 12pt. Margins should be 12mm everywhere except ob the bottom where 0.75 inch is reserved for page number. Other important dimensions: 
\begin{description}
  \item[column separation]  \the\columnsep
  \item[column width] \the\columnwidth
  \item[textwidth] \the\textwidth
\end{description}
For compiling \LaTeX it is recommended (if having troubles) to use latest \TeX live distribution. Use pdf\LaTeX instead of classical \LaTeX as it outputs PDF directly, wraps URLs correctly and can include PNG files directly. Do not use JPEG for screenshots! JPEG is for photos only. For sketching use \href{http://www.inkscape.org}{Inkscape}. 

\section*{General guidelines}
\newcommand{\itempar}[1]{\noindent\highlight{\textsf #1}\par\noindent}
\begin{itemize}
  \setlength{\itemsep}{0pt plus 3pt}\setlength{\topsep}{0pt plus 4pt}
  \setlength{\partopsep}{0pt}\setlength{\parsep}{0pt}\setlength{\parskip}{0pt}
\item All articles should be in English.
\item Articles should be a maximum of 3 pages.
\item All articles should contain at least 2 images.
\end{itemize}

\itempar{Who Am I writing for?}This article should be in the style of a popular science article. This means that is should be relatively simple to understand and entertaining. 

\noindent The audience are not specialists in the field in questions, but rather interested laypeople. Adapt your content to the level of general knowledge of an educated adult who is not a computer scientist or scientist in your field Let your enthusiasm for your project show! Explain terms well. 

\noindent Use vivid language. Use illustrations, graphics and examples.

\itempar{Formatting}%
Final formatting will consist of a three column article 2-3 pages long. Please follow the formatting in the templates. Please provide links to hi-res version of any images submitted.

\itempar{Title}%
This should succinctly describe the content of the article. Be descriptive!
%

The title should be at the top of your first page and centred.
Do not use a title page.
%Headings with an asterisk(*) must be included

\itempar{Content}%
The following is the suggested content of the article. You do not have to include section heading to match, but should match the general flow and content.

\itempar{Author}
Author's names and institutional affiliation at the end.

\itempar{Abstract -- What did I do - in brief}  An abstract is a one-paragraph summary of the entire article. It should describe the question/problem or research topic addressed in the project and the methods used to answer or explore this area. It should highlight the important parts of the article. This is easiest to write once you have completed the rest of the article. Include a sentence summarising the introduction, methods, results and discussion section. The abstract should not contain citations. Equations should be avoided if possible. And not numbered if not referenced in text. 

\itempar{Introduction -- What is the project?}%
The introduction should describe the question/problem/research area addressed by the project and set the context for your work. It should explain why your project is an interesting or important. It should introduce the techniques and approach you used to complete the project.

\itempar{Methods -- How did I complete the project?}%
Briefly describe what was actually done. This should include more detail on techniques and approaches, with enough detail that an interested person could attempt to reproduce your work (You do not have to include every detail, but use citations to give the required background). 

\itempar{Results -- What did I find out?}%
Focus on what worked! Outline the outcomes and results of your project

\itempar{Discussion \& Conclusion}
(What does that mean?) Explain your conclusions and your interpretation of your results. How did it compare to what was to be expected or previous work? What implications does this have for other work?

\itempar{References} (what work did I reference?)

\itempar{Acknowledgements} (who helped me?) PRACE acknowledgement will be given together at the colophon. Site acknowledgement if required. Other acknowledgement if requested.
\multicolinterrupt{\textcolor{prace-darkblue}{\lipsum[16]}}

\subsection*{Project form update}
%Strange why the following macro needs to be repeated due to multicolinterrupt
\newcommand{\itempar}[1]{\noindent\highlight{\textsf #1}\par\noindent}

Week 3 plans are given separately and contain the following items:

\itempar{Workplan} Please append and up-to-date workplan (Week 3 reports) outlining what you did week by week. Introduction can be used for final report too.

\itempar{Appendices} (Extra information)
Optional --- anything else you want to include, but not publish

\itempar{Appendices} (Compulsory)


\itempar{Award statement}%
Please amend a section to ``Week 3 plans'' at end of the programme stating why you think you should win
\begin{enumerate}
  \item The HPC Ambassador Award.
  \item The Best Visualisation Award.
\end{enumerate}
Information given as an update will be used to aid reviewers in evaluation of the projects and will not be publicly available.

\subsection*{Tables and Figures}

All tables and figures should be captioned. All tables and figures should be put into context in the text. Give your main figure instead of SoHPC logo figure nearby the title. Tables and figures should sequentially numbered. Make sure that there isn't a page break in the middle. Sometimes it is easier to add more text to get good balancing between columns.

\noindent\begin{minipage}[H]{2\columnwidth+\columnsep}
 %\vspace{-15pt}
  \begin{figure}[H]
  \centering
  \color{yellow}\rule{\linewidth}{3.8cm}\color{black}
  %\includegraphics{}
  \caption{Captions for figures should be used only if necessary and referenced in text.}
\label{fig:my_label}
\end{figure}
\end{minipage}


\itempar{Acronyms, technical terms}%
Symbols, abbreviations and acronyms should be defined the first time they are used and then used consistently from there on. Note that too technical slang is not desired here.


\begin{table}[H]
 \caption{Random table}
 \centering
 \begin{tabular}{llr}
 \toprule
 \multicolumn{2}{c}{Name} \\
 \cmidrule(r){1-2}
 First name & Last Name & Grade \\
 \midrule
 John & Doe & $7.5$ \\
 Richard & Miles & $2$ \\
 \bottomrule
 \end{tabular}
\end{table}

\vspace*{5cm}

\begin{figure*}[t]
  \color{yellow}\rule{2\columnwidth+\columnsep}{10cm}%
  %\includegraphics[width=2\columnwidth+\columnsep]{fig4}
  \hspace{\columnsep}
  \begin{minipage}[b]{1.0\columnwidth}
    \color{yellow}\rule{\linewidth}{4.6cm}\\[\columnsep]
    \color{prace-lightblue}\rule{\linewidth}{5cm}
    % \includegraphics[width=\linewidth]{fig5}
    % \includegraphics[width=\linewidth]{fig6}
  \end{minipage}
  \color{black}
  \vspace{-3ex}
  \caption*{Large figures should be placed at top and can be combination of
    several sub-figures. With or without caption. Do not number figures if
    they are not referenced in text. Several sentences can be used to
    describe the figures.}
  \label{fig:large}
\end{figure*}
\noindent Answers to the questions of general interest will be published at the page \url{http://trac.lecad.fs.uni-lj.si/sohpc/wiki/template} where also all template files are available for download.

\section*{Videos and final presentations}
We recommend that videos are prepared in \href{https://support.google.com/youtube/answer/1722171}{720p HD resolution} (19:6). Screen casts can be recorded by \href{http://atomisystems.com/activepresenter/free-edition/}{Active Presenter --  free edition}. It is advisable that you prepare a text that you will be recording along with the presentation. For quick check of how recording goes try the following:
\begin{enumerate}
 \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}
 \item Enter Full Motion Recording (FMR).
 \item Select Custom resolution (1280x720) and portion of screen you will be capturing.
\item Disable Floating Toolbar (bottom left).
\item Unmute microphone on the desktop.
\end{enumerate}
Once a capture has finished, one can:
\begin{itemize}
  \item Edit the capture (Cut, delete, copy, part of the captured video)
  \item Insert text, shapes, spotlights, higlight boxes, images
  \item Other elements possible.
  \item Each added feature appears in the timeline and you can edit for how long it will appear, where it will appear and how it will appear/disappear through transitions
  \item Position of these can also be altered to give a sense of ``animation''.
  \item Export it into MP4 or AVI format.
\end{itemize}
There are many other ways to record a screen and edit such as \href{http://geekthis.net/blog/98/virtualbox-video-capture}{VirtualBox screen recording} and \href{https://youtu.be/WDh1CrL2344}{Windows Movie Maker}. For video encoding one can use \href{http://www.erightsoft.com/SUPER.html}{Super~\copyright} or similar software. Please visit examples of \href{https://www.youtube.com/playlist?list=PLhpKvYInDmFXMg1WcPTaMQVt-gUTx7HPV}{SoHPC 2013 videos} on Youtube.


\section*{Section 1}
Section names should not be to technical. No numbering should be used. Sections can be even questions for the text that follows. Section names can state the fact explained in continuation.

\begin{figure}[H]
  \color{yellow}\rule{\linewidth}{4cm}\color{black}
  % \includegraphics[width=\linewidth]{vortex}
  \caption{Quickly explain the content of the figure if you reference it in
    the text.}
  \label{fig:vortex}
\end{figure}


%\subsection*{Subsection 1}
\begin{align}
 A = 
 \begin{bmatrix}
 A_{11} & A_{21} \\
 A_{21} & A_{22}
 \end{bmatrix}
 \end{align}
Please balance the size of figures and text in such way that you will have the complete page filled. It should not be half way ended. Use citations as superscript\cite{Figueredo:2009dg} if absolutely necessary.

\newcommand{\sohpcinfo}[1]{\par\vspace{1ex}\footnotesize
  \textcolor{prace-lightblue}{PRACE SoHPC}%
  \textcolor{prace-darkblue}{#1}\\[0.5ex]\scriptsize
}

\renewcommand\refname{\usefont{OT1}{phv}{m}{n}\selectfont\small{References}}
\begin{thebibliography}{9}
\vspace*{-1ex}  % adjust this
\scriptsize
\bibitem[1]{Figueredo:2009dg}
Figueredo, A.~J. and Wolf, P. S.~A. (2009).
\newblock Assortative pairing and life history strategy - a cross-cultural
  study.
\newblock {\em Human Nature}, 20:317--330.
\end{thebibliography}

\vfill
\noindent\begin{minipage}[b]{0.7\linewidth}
\begin{flushleft}
  \usefont{OT1}{phv}{m}{n}\selectfont
  \sohpcinfo{Project Title}
  \href{http://summerofhpc.prace-ri.eu} Official title of the project
  \sohpcinfo{Site}
  Institution, Country
  \sohpcinfo{Authors}
  \href{mailto:name@example.com}{\theauthor},
  [association,] country
  \sohpcinfo{Mentor}
  \href{mailto:summerofhpc@ichec.ie}{Emma Hogan}, ICHEC, Ireland
\end{flushleft}
\end{minipage}\hfill%
\begin{minipage}[b]{0.3\linewidth}
  \color{prace-darkblue}\rule{\linewidth}{2.5cm}\par
  \tiny\theauthor
\end{minipage}%
\vspace{-1.5ex}% any of information below is optional
\begin{flushleft}
  \sohpcinfo{Contact}
  Name, Surname, Institution\\
  Phone: +12 324 4445 5556\\
  E-mail: \href{mailto:leon.kos@lecad.si}{leon.kos@lecad.fs.uni-lj.si}
  \sohpcinfo{Software applied}
  Virtuoso
  \sohpcinfo{More Information}
  \href{http://www.virtouso.org}{www.virtouso.org}
  \sohpcinfo{Acknowledgement}
  Write any requested acknowledgements or thanks here. Mentors should be
  asked for them too.
\sohpcinfo{Project ID} 15xx
\end{flushleft}
\end{multicols}
\end{document} 

%%Local Variables:
%%% mode: latex
%%% TeX-parse-self: t
%%% TeX-auto-save: t
%%% TeX-source-specials-mode: t
%%% TeX-PDF-mode: t
%%% LaTeX-command: "pdflatex -synctex=1  --enable-write1"
%%% TeX-master: t
%%% ispell-local-dictionary: "british"
%%% End: