{"id":14980716,"url":"https://github.com/maurovm/thesis_template","last_synced_at":"2025-10-29T03:30:54.230Z","repository":{"id":209674562,"uuid":"126823487","full_name":"maurovm/thesis_template","owner":"maurovm","description":"LaTeX class for an undergraduate 4th year project (4YP) report or a DPhil / PhD doctoral thesis for a student of the Department of Engineering Science at the University of Oxford","archived":false,"fork":false,"pushed_at":"2023-11-28T15:21:07.000Z","size":14616,"stargazers_count":13,"open_issues_count":0,"forks_count":15,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-09-29T04:41:48.259Z","etag":null,"topics":["4yp","book","class","dissertation","doctoral","doctoral-theses","dphil","engineering","latex","latex-class","latex-template","oxford","pdf","phd","project","report","template","tex","thesis","university"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maurovm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-26T12:12:00.000Z","updated_at":"2024-07-01T14:40:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"4d788034-dce2-48ac-aa7b-de5240ef2fcf","html_url":"https://github.com/maurovm/thesis_template","commit_stats":{"total_commits":74,"total_committers":2,"mean_commits":37.0,"dds":"0.027027027027026973","last_synced_commit":"6d2ef250014f38698f1e0ac833e384434e271751"},"previous_names":["maurovm/thesis_template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maurovm%2Fthesis_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maurovm%2Fthesis_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maurovm%2Fthesis_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maurovm%2Fthesis_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maurovm","download_url":"https://codeload.github.com/maurovm/thesis_template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219858509,"owners_count":16556043,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["4yp","book","class","dissertation","doctoral","doctoral-theses","dphil","engineering","latex","latex-class","latex-template","oxford","pdf","phd","project","report","template","tex","thesis","university"],"created_at":"2024-09-24T14:02:18.293Z","updated_at":"2025-10-29T03:30:52.958Z","avatar_url":"https://github.com/maurovm.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DPhil / PhD doctoral thesis LaTeX class\n\n\nThis repository contains a LaTeX class (OxEngThesis) to write formal academic documents for a student of the [Department of Engineering Science](https://www.eng.ox.ac.uk) at the [University of Oxford](https://www.ox.ac.uk). For example, my undergraduate students have used this class to write 4\u003csup\u003eth\u003c/sup\u003e-year project (4YP) reports. My doctoral students have typically used this class to write their 1\u003csup\u003est\u003c/sup\u003e-year Transfer of Status report, 2\u003csup\u003end\u003c/sup\u003e-year Confirmation of Status report and their final DPhil thesis. The typical 4YP report contains around 50 pages, whereas a doctoral thesis is a much larger document.\n\nAlthough I originally created this class for a student at Oxford, I also included in this repository some examples for a PhD thesis for the Massachusetts Institute of Technology and (cough, cough) the University of Cambridge. It should be easy for you to adjust this class to suit the requirements of your academic institution.\n\nLaTex itself is very portable. However, I developed this class under Linux and macOS environments using the latest LaTeX distributions. I have not tested compiling a LaTeX document in Microsoft Windows, but some of my students reported that it works. If you find any problems for Windows, please report any issues to me. Event better, I encourage you to contribute your fixes.\n\n\u0026nbsp;\n\n\u003e \"OxEngThesis\" is free software: you can redistribute it or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 only. Check the file [COPYING](COPYING) for more information on the license and copyright.\n\n\u0026nbsp;\n\nAs a research student, a proportion of your time will be devoted to writing science in a formal academic style. There are many resources that will help you to write your thesis, such as [Writing your thesis](https://www.mpls.ox.ac.uk/training/resources-for-researcher-and-career-development/completing-your-dphil/writing-up-your-thesis), [Completing your doctorate](https://www.vitae.ac.uk/doing-research/doing-a-doctorate/completing-your-doctorate), [Essay and dissertation writing skills](https://www.ox.ac.uk/students/academic/guidance/skills/essay) and also other [resources for new students](https://cameralab.eng.ox.ac.uk/resources_new_students.html). Steven Pinker's talk on [Linguistics, Style and Writing in the 21st Century](https://youtu.be/OV5J6BfToSw) will provide you with sound advice on writing (hopefully you will put the passive voice to rest after watching the video). \n\nMy students have found very helpful to use the LaTeX typesetting system to write reports, theses, journal papers or other academic documents. You can write your LaTeX documents from scratch, however, it is often easier to start with an already written class template. This way you can focus on (as your supervisor expects) writing about your exciting research contributions, rather than spending time formatting your document or applying other cosmetic changes that just waste everybody's time and distract the reader. \n\nThe OxEngThesis class is based on the [memoir](https://ctan.org/pkg/memoir) package, with the addition of several other packages and extra features useful to format a typical academic document. The main class file is [oxengthesis.cls](oxengthesis.cls). One sample source file is provided: [sample_dphil_thesis.tex](sample_dphil_thesis.tex) to get you started writing your thesis. You can check the [sample_dphil_thesis-sample_output.pdf](sample_dphil_thesis-sample_output.pdf) file to view an example of the output PDF document for a doctoral thesis.\n\nThis tutorial summarises some of the features available in the OxEngThesis class. Take a look at the [oxengthesis.cls](oxengthesis.cls) file and the [sample_dphil_thesis.tex](sample_dphil_thesis.tex) source file for a more complete overview. Additionally, this tutorial is replicated as \"Chapter 0: The OxEngThesis LaTeX class\" in the [sample_dphil_thesis-sample_output.pdf](sample_dphil_thesis-sample_output.pdf), so you can view examples of the LaTeX syntax to write your document.\n\n\u0026nbsp;\n\n\n## Requirements\n\n\nThere are several options for writing in LaTeX, including online versions such as Overleaf. I don't recommend online editors, as you will be writing long documents with several figures, tables and other elements. In my experience, having LaTeX installed locally in your computer is a better option.\n\nYou will need a modern LaTeX compiler installed in your system, at minimum version 2017. Most modern operating systems use [TexLive](https://www.tug.org/texlive/) as the preferred LaTeX typesetting system. If you are using Linux, TexLive is already pre-installed or is readily available from your distribution's software repository, for example: [LaTeX in Fedora](https://docs.fedoraproject.org/en-US/neurofedora/latex/) and [LaTeX in Ubuntu](https://help.ubuntu.com/community/LaTeX). For macOS, you can download and install the latest [MacTeX](https://tug.org/mactex) distribution. For Microsoft Windows, follow the installation instructions described in [TexLive on Windows](https://tug.org/texlive/windows.html).\n\nInstall the Carlito font (if it's not already installed in your system). Follow the instructions for your particular operating system in the [fonts](fonts) directory, for example for [Linux](fonts/INSTALL_FONTS_LINUX.md) or [macOS](fonts/INSTALL_FONTS_macOS.md). If you are using Microsoft Windows, also install the Latin Modern Math font.\n\n\n## LaTeX editors\n\n\nThere are several editors available that will make your life easier when writing LaTeX documents and, ultimately, generating the final PDF file (a.k.a compiling the LaTeX source files). For macOS, [Texifier](https://www.texifier.com) works really well. Good editors for Linux are [Kile](https://apps.kde.org/en-gb/kile) and [TeXMaker](https://www.xm1math.net/texmaker). If you know what software is good for Microsoft Windows, let me know so I can add it to my recommendation list.\n\nThe LaTeX files in this repository require the [LuaLaTeX](https://en.wikipedia.org/wiki/LuaTeX) engine. You editor should allow you to configure LuaLaTeX as the typesetting engine for your document and automatically take care of the compilation process to generate the final PDF document.\n\n\u0026nbsp;\n\n\n# Writing your thesis\n\n\nThis tutorial is replicated as \"Chapter 0: The OxEngThesis LaTeX class\" in the [sample_dphil_thesis-sample_output.pdf](sample_dphil_thesis-sample_output.pdf), so you can review examples on how to write your LaTeX document.\n\n\n## Preparing your document\n\n\nAfter you installed your preferred LaTeX editor, make a copy of the [sample_dphil_thesis.tex](sample_dphil_thesis.tex) sample file provided in this repository. Throughout this tutorial, I will call this new file your \"*main LaTeX source file*\". The minimum content you need is:\n\n\n```latex\n\\documentclass{oxengthesis}\n\n\\title       {The title of your thesis}\n\\author      {Your name}\n\\college     {The name of your college}\n\\supervisor  {The name(s) of your supervisor(s)}\n\\date        {The academic term of submission}\n```\n\n\nFrom your \"*main LaTeX source file*\", remove the line that includes the OxEngThesis class documentation. It is a line similar to:\n\n\n```latex\n\\include{oxengthesis_class_documentation}\n```\n\n\n\u0026nbsp;\n\n\u003e**NOTE**: The line above includes the LaTeX version of this README file. It shows how you can use the features provided by the OxEngThesis class in your document. It is numbered as \"Chapter 0\" in the sample PDF file [sample_dphil_thesis-sample_output.pdf](sample_dphil_thesis-sample_output.pdf) so not to change the flow of the rest of the document.\n\n\u0026nbsp;\n\n\nThe *frontmatter* of the thesis will be automatically created depending on the type of document you are writing, either a doctoral thesis or a project report. If you want more control, you can review how the '\\makefrontmatterpages' command is defined in the [oxengthesis.cls](oxengthesis.cls) class file. If you want all the sections in the *frontmatter* to appear, you will need to create the following files:\n\n- **[abstract.tex](abstract.tex)** : If you want the \"Abstract\" page\n- **[dedication.tex](dedication.tex)** : If you want the \"Dedication\" page\n- **[declaration.tex](declaration.tex)** : If you want the \"Declaration\" page\n- **[acknowledgements.tex](acknowledgements.tex)** : If you want the \"Acknowledgements\" page\n- **[publications.tex](publications.tex)** : If you want the \"List of publications\" page\n- **[glossary.tex](glossary.tex)** : If you want the \"List of abbreviations\" page\n\nIf any of the files above are missing, that particular page won't be created in the *frontmatter*. This is useful if you are just preparing a draft version of your thesis for your supervisor to correct. \n\nSimilarly for the *backmatter* part of your thesis, add all the BibTeX citations to a file named [references.bib](references.bib) if you want the \"Bibliography\" section to be created at the end of your document. \n\n\n## Writing a \"Transfer of Status\" or \"Confirmation of Status\" report\n\n\nThere are two [Key milestones](https://www.ox.ac.uk/students/academic/guidance/graduate/research/status/DPhil) for which DPhil students are expected to submit substantial piece of written research work, or reports. They are the \"[Transfer of Status](https://www.mpls.ox.ac.uk/graduate-school/information-and-resources-for-supervisors/transfer-of-status)\" at the end of your first year, and the \"[Confirmation of Status](https://www.mpls.ox.ac.uk/graduate-school/information-and-resources-for-supervisors/confirmation-of-status)\" at the end of your second year. \n\nFor these milestones, you will often be required to submit a report with all the details of your research contributions. This document is often around 50-60 pages in length and does not need all the sections that a doctoral thesis has (i.e. declaration, dedication or list of publications). \n\nYou can write a *Transfer of Status* report by simply providing the \"*report*\" option when you load the OxEngThesis class, and defining the \"*degree*\" variable as shown in the following code snippet:\n\n\n```latex\n\\documentclass[report]{oxengthesis}\n\n\\title       {The title of your report}\n\\author      {Your name}\n\\degree      {{\\huge Transfer of Status Report}}\n\\college     {The name of your college}\n\\supervisor  {The name(s) of your supervisor(s)}\n\\date        {The academic term of submission}\n```\n\n\nYou can write a *Confirmation of Status* report by simply providing the \"*report*\" option when you load the OxEngThesis class, and defining the \"*degree*\" variable as shown in the following code snippet:\n\n\n```latex\n\\documentclass[report]{oxengthesis}\n\n\\title       {The title of your report}\n\\author      {Your name}\n\\degree      {{\\huge Confirmation of Status Report}}\n\\college     {The name of your college}\n\\supervisor  {The name(s) of your supervisor(s)}\n\\date        {The academic term of submission}\n```\n\n\nNote that the \"*report*\" package option is just a shortcut to not include the dedication, declaration and publications pages and format the title page accordingly.\n\n\n## Writing a 4\u003csup\u003eth\u003c/sup\u003e-Year Project (4YP) report\n\n\nIf you are an undergraduate student at the University of Oxford reading [Engineering Science](https://eng.ox.ac.uk/study/undergraduate/your-degree), you will carry out a self-led project during your fourth year. It usually involves original research or significant design and construction work, undertaken in close consultation with an academic supervisor. At the end of your project (usually by the beginning of Trinity term), you will need to submit a report with all the details of your research contributions. This document is often around 50 pages in length and does not need all the sections that a doctoral thesis has (i.e. declaration, dedication or list of publications). \n\nYou can write a 4YP report by simply providing the \"*report*\" option when you load the OxEngThesis class, and defining the \"*degree*\" variable as shown in the following code snippet:\n\n\n```latex\n\\documentclass[report]{oxengthesis}\n\n\\title       {The title of your report}\n\\author      {Your name}\n\\degree      { {\\huge 4$^{th}$-Year Project Report} }\n\\college     {The name of your college}\n\\supervisor  {The name(s) of your supervisor(s)}\n\\date        {The academic term of submission}\n```\n\n\n## Creating the PDF output\n\n\nThe source files in this repository require the [LuaLaTeX](https://en.wikipedia.org/wiki/LuaTeX) engine. You editor should allow you to configure LuaLaTeX as the typesetting engine for your document and automatically take care of the compilation process to generate the final PDF document from your \"*main LaTeX source file*\".\n\nIf you want to compile your \"*main LaTeX source file*\" from the command line, you can use the script [compile_document.sh](compile_document.sh) provided in this repository. This script only works in a Linux or macOS system. For example, to compile the sample thesis provided, you will execute the following command in the terminal:\n\n\n```shell\n$ ./compile_document.sh  sample_dphil_thesis.tex\n```\n\n\nIf you want to delete all the temp or auxiliary files LaTeX created during the compilation process, you can run:\n\n\n```shell\n$ ./remove_latex_aux_files.sh\n```\n\n\nIf you are compiling the document manually, you would need to run the [latexmk](https://ctan.org/pkg/latexmk) build command (already part of your LaTeX distribution) in the following order:\n\n\n```shell\n$ latexmk -pdflatex=lualatex -pdf  sample_dphil_thesis.tex\n$ makeglossaries sample_dphil_thesis.tex\n$ latexmk -pdflatex=lualatex -pdf  sample_dphil_thesis.tex\n```\n\n\n## Customising the title page\n\n\nAlthough I originally wrote this LaTeX template for a student at the University of Oxford, it should be easy for you to customise it to suit the requirements of your academic institution. The [default title page](titlepage-oxford.tex) is simple and customisable. The class template defines some variables you can use. At minimum, you need to provide the following definitions in the preamble of your \"*main LaTeX source file*\":\n\n- **\\title{}**:      The main title of the thesis/report\n- **\\author{}**:     The author of the thesis/report\n\nYou can define the following optional variables:\n\n- **\\supervisor{}**: The name of your thesis supervisor. The default value is: \"*SUPERVISOR NAME*\"\n- **\\college{}**: Your college affiliation, if you are an Oxford student. The default value is: \"\" (an *empty string*)\n- **\\degreeprefix{}**: Text printed before the degree name. The default value is: \"*A thesis submitted for the degree of*\"\n- **\\degree{}**: The name of the degree. The default value is: \"*Doctor of Philosophy*\"\n- **\\department{}**: Your university department. The default value is: \"*Department of Engineering Science*\"\n- **\\university{}**:   The name of your university. The default value is: \"*University of Oxford*\"\n- **\\universitylogo{}**: File name of the university's logo, without the file extension. The default value is: \"*oxford-logo*\" (which will load the image file [oxford-logo.png](figures/oxford-logo.png))\n- **\\date{}**: The date of publication of the thesis, such as \"*Hilary Term, 2048*\". If you leave it blank, it will print the current date (useful when sending a draft to your supervisor)\n\n\nThe title pages for a DPhil/PhD thesis and for a 4YP report can be created with very similar code. They both use the default title page \"[titlepage-oxford.tex](titlepage-oxford.tex)\". The only difference is the use of the ``\\verb|report|'' package option. For example, the title page for the DPhil thesis can be created with the following code:\n\n\n```latex\n\\documentclass{oxengthesis}\n\n\\title{The long-term effects of climate change on farming in Middle Earth}\n\\author    {Samwise Gamgee}\n\\college   {Jesus College}\n\\supervisor{Professor J.R.R. Tolkien}\n\\date      {Hilary Term, 2048}\n```\n\n\nThe title page for the 4YP report can be created with the following code:\n\n\n```latex\n\\documentclass[report]{oxengthesis}\n\n\\title{The long-term effects of climate change on farming in Middle Earth}\n\\author    {Samwise Gamgee}\n\\degree    { {\\huge 4$^{th}$-Year Project Report} }\n\\college   {Jesus College}\n\\supervisor{Professor J.R.R. Tolkien}\n\\date      {Hilary Term, 2048}\n```\n\nThe code above produces the following outputs:\n\n\u0026nbsp;\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/dphil-title_page.png\" alt=\"Title page\" width=\"250\" border=1 /\u003e\u003c/kbd\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/4yp-title_page.png\" alt=\"TOC page 1\" width=\"250\" border=1 /\u003e\u003c/kbd\u003e\n\u003c/p\u003e\n\n\u0026nbsp;\n\n\n## Create your own title page\n\n\nIf you don't provide a custom title page, the [oxengthesis.cls](oxengthesis.cls) class template will load the default title file [titlepage-oxford.tex](titlepage-oxford.tex) shown above. If the layout of the default title page does not fulfil your or your university's requirements, you can create your own title page. To do so, you will need to follow the 3 steps described below. As an example, we will create a custom title page for a PhD thesis for a student at the Massachusetts Institute of Technology:\n\n1. Create a new LaTeX source file and add your own definitions, such as the example file [titlepage-mit.tex](titlepage-mit.tex)\n\n2. Define the \"**\\titlepage{}**\" variable in the preamble of your \"*main LaTeX source file*\". For example, after the \"\\author{}\" variable as in:\n\n\n```latex\n\\title    {Protein expression of the X-factor mutator gene in Homo Sapiens}\n\\author   {Charles F. Xavier}\n\\titlepage{titlepage-mit.tex}\n```\n\n\n3. Recompile your \"*main LaTeX source file*\". An example of the output is:\n\n\u0026nbsp;\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/mit_phd-title_page.png\" alt=\"Title page\" width=\"350\" border=1 /\u003e\u003c/kbd\u003e\n\u003c/p\u003e\n\n\u0026nbsp;\n\nThe following text in the preamble of your \"*main LaTeX source file*\" will use the \"[titlepage-cambridge.tex](titlepage-cambridge.tex)\" file to create a title page for a student at the University of Cambridge:\n\n\n```latex\n\n\\title      {Protein expression of the X-factor mutator gene in Homo Sapiens}\n\\author     {Charles F. Xavier}\n\\college    {Pembroke College}\n\\degreeprefix {A thesis submitted for the degree of}\n\\degree     {Doctor of Philosophy}\n\\supervisor {Professor Albus Dumbledore}\n\\department {Department of Engineering}\n\\university {University of Cambridge}\n\\universitylogo{cambridge-logo}\n\\date       {June 2048}\n\\titlepage  {titlepage-cambridge.tex}\n```\n\n\nThe sample output is shown below:\n\n\u0026nbsp;\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/cambridge_phd-title_page.png\" alt=\"Title page\" width=\"350\" border=1 /\u003e\u003c/kbd\u003e\n\u003c/p\u003e\n\n\u0026nbsp;\n\nThe [oxengthesis.cls](oxengthesis.cls) class makes available new LaTeX commands that you can use in your new custom title document. These new commands are based on the variables defined in the preamble of your \"*main LaTeX source file*\":\n\n- The **\\title{}** variable in the preamble will map to the command **\\TitleName**\n- The **\\author{}** variable in the preamble will map to the command **\\AuthorName**\n- The **\\supervisor{}** variable in the preamble will map to the command **\\SupervisorName**\n- The **\\college{}** variable in the preamble will map to the command **\\CollegeName**\n- The **\\degreeprefix{}** variable in the preamble will map to the command **\\DegreePrefix**\n- The **\\degree{}** variable in the preamble will map to the command **\\DegreeName**\n- The **\\department{}** variable in the preamble will map to the command **\\DepartmentName**\n- The **\\university{}** variable in the preamble will map to the command **\\UniversityName**\n- The **\\universitylogo{}** variable in the preamble will map to the command **\\UniversityLogo**\n- The **\\date{}** variable in the preamble will map to the command **\\DegreeDate**\n\nCheck the files [titlepage-oxford.tex](titlepage-oxford.tex), [titlepage-mit.tex](titlepage-mit.tex) and [titlepage-cambridge.tex](titlepage-cambridge.tex) for examples on how to use the available commands in your new title page.\n\n\u0026nbsp;\n\n\n# Package options\n\n\n## Default package options\n\n\nBy default, the class is formatted to produce a doctoral thesis for the University of Oxford. If you don't provide any package options, such as:\n\n\n```latex\n\\documentclass{oxengthesis}\n```\n\n\nthe output document will be created with the following options\n\n\n```latex\n\\documentclass[10pt,a4paper,openany,onecolumn,twoside,final,font=Carlito,mathfont=\"Latin Modern Math\",headingcolour={0,0,0},leftmargin=4cm,rightmargin=2cm,topmargin=2cm,bottommargin=2.5cm]{oxengthesis}\n```\n\n\nwhich will produce a thesis using a 10-point Carlito font on A4 paper size. Page margins will be formatted as required by Oxford. Chapters will start on either recto or verso pages (openany). Note that the options \"[onecolumn,twoside,final]\" cannot be changed. \n\n\nThe OxEngThesis class template is based on the [memoir](https://ctan.org/pkg/memoir) LaTeX package. As such, you can pass most of the memoir's option and, therefore, customise your document even further.\n\n\n## Page size and margins\n\n\nBy default, the page size and margins are set to comply with the requirements of the University of Oxford. Other institutions have different requirements. For example, the requirements for a thesis at the Massachusetts Institute of Technology are ([taken from MIT libraries](https://libraries.mit.edu/distinctive-collections/thesis-specs)):\n\n\n```\n... For the main body of the text, including appendices and front matter, font size should be at least 11-point ...\n\n... Top, bottom, and both side margins must be at least an inch wide (1″) to allow for binding and trimming....\n```\n\n\nTherefore, you would configure the class with the following options (Note that the left margin is larger):\n\n\n```latex\n\\documentclass[11pt, letterpaper,leftmargin=1.5in,rightmargin=1in,topmargin=1in,bottommargin=1in]{oxengthesis}\n```\n\n\n## Fonts\n\n\nBy default, the main font is 10-point \"[Carlito](https://ctan.org/tex-archive/fonts/carlito?lang=en)\" and the font for equations and formulas is \"[Latin Modern Math](https://ctan.org/tex-archive/fonts/lm-math?lang=en)\". You can change to, for example, 11pt Arial as the main font and \"tex-gyre-math-termes\" as the font for equations with the following package options:\n\n\n```latex\n\\documentclass[11pt,font=Arial,mathfont=\"TeX Gyre Termes Math\"]{oxengthesis}\n```\n\n\n## Mini-table of contents for each chapter\n\n\nIf you have a recent version of LaTeX installed (TeXLive version 2022 works) in your system and would like to have a short table of contents at the beginning of each chapter, you can simply add the \"*chaptertoc*\" option to your document:\n\n\n```latex\n\\documentclass[chaptertoc]{oxengthesis}\n```\n\n\nBelow is a sample output for one chapter:\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/dphil-chap_minitoc.png\" alt=\"Mini-table of contents for each chapter\" width=\"350\" border=1 /\u003e\u003c/kbd\u003e\n\u003c/p\u003e\n\n\nI use the [minitoc](https://ctan.org/pkg/memoir) LaTeX package to create the table of contents for each chapter. Previous versions of the minitoc class where incompatible with the [memoir](https://ctan.org/pkg/memoir) class. I tested TexLive 2022 and MacTeX 2022, they both work fine.\n\n\n## Abstract page for the Examination Schools\n\n\nWhen submitting your final thesis to the \"Examination Schools\" (located on High Street) at the University of Oxford to schedule your viva examination, you are typically required to submit two printed copies of your thesis (soft-bound). Additionally, you are required to provide two separate one-page printed copies of your abstract. The stand-alone abstract page should contain your name, college affiliation and is NOT meant to be part of the binding of your thesis. To create this single stand-alone page of your abstract, add the \"*frontabstract*\" option to your document, as in:\n\n\n```latex\n\\documentclass[frontabstract]{oxengthesis}\n```\n\n\nThe page will be created before the main title page. Below is a sample output:\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/dphil-front_abstract_page.png\" alt=\"Abstract page for the Examination Schools\" width=\"350\" border=1 /\u003e\u003c/kbd\u003e\n\u003c/p\u003e\n\n\n## Review editing mode\n\n\nYour thesis supervisor may request you to print your document with double line spacing so he/she can correct your draft (the red pen!). You can simply add the \"*review*\" option to your document:\n\n\n```latex\n\\documentclass[review]{oxengthesis}\n```\n\n\n## Different colour for section headings\n\n\nThe default font colour for section and subsection headings is black. You can change the colour (to blue for example) by adding the \"*headingcolour*\" class option:\n\n\n```latex\n\\documentclass[headingcolour={0.25,0.45,0.76}]{oxengthesis}\n```\n\n\nNote that the colour of subsubsection headings will be black regardless of the setting above.\n\n\n## Chapter heading styles\n\n\nThe default style for chapter headings is simple and gives you enough space to write your content. You can take advantage of different chapter styles defined in the [memoir](https://ctan.org/pkg/memoir) package by passing the \"*chapterstyle*\" option. For example, the following settings:\n\n\n```latex\n\\documentclass[chapterstyle=southall]{oxengthesis}\n```\n\nwill use the \"*southall*\" chapter style. An example of the output is shown below:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/chapterstyle-southall.png\" alt=\"southall chapter style\"\n    width=\"350\" border=1 /\u003e\n\u003c/p\u003e\n\n\u0026nbsp;\n\n\n# Additional features\n\n\nThis section describes some of the additional features available in the OxEngThesis class. Refer to the official documentation of the [memoir](https://ctan.org/pkg/memoir) LaTeX package to customise your document even further.\n\n\n## Figures\n\n\nI use the [graphicx](https://ctan.org/pkg/graphicx) LaTeX package to include figures. You can put all figures in a \"figures/\" folder and you can simply include the image file directly without the file extension, as in:\n\n\n```latex\n\\begin{figure}\n    \\centering\n    \\includegraphics[width=0.9\\linewidth]{dummy_image}\n    \\caption\n    {\n        Sample image.\n        \\label{fig:sample_image}\n    }\n\\end{figure}\n```\n\n\nthe code above will insert the image file \"./figures/dummy_image.png\".\n\nYou can create a figure with sub plots with:\n\n\n```latex\n\\begin{figure}[\n    \\centering\n    \\subbottom[\\label{fig:subfig_example:fig1}]{\n        \\includegraphics[width=0.3\\linewidth]{dummy_image}\n    }\n    \\subbottom[\\label{fig:subfig_example:fig2}]{\n        \\includegraphics[width=0.3\\linewidth]{dummy_image}\n    }\n    \\subbottom[\\label{fig:subfig_example:fig3}]{\n        \\includegraphics[width=0.3\\linewidth]{dummy_image}\n    }\n    \\caption[The PointGrey Grasshopper2 video camera]\n    {\n        Caption of the figure, showing:\n        \\subcaptionref{fig:subfig_example:fig1} description 1,\n        \\subcaptionref{fig:subfig_example:fig2} description 2 and\n        \\subcaptionref{fig:subfig_example:fig3} description 3.\n        \\label{fig:subfig_example}\n    }\n\\end{figure}\n```\n\n\nwhich will automatically produce the following output:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/subplot_example.png\" alt=\"Subplot example\" width=\"500\"/\u003e\n\u003c/p\u003e\n\nNote that you can directly refer to the subplot as in:\n\n\n```latex\n\\Cref{fig:subfig_example:fig1} shows the camera ...\n ```\n\n\n which will automatically produce the text:\n \n\n ```\n Figure 3.2(a) shows the camera ...\n ```\n\n\n ## Tables\n\n\n You can have tables with shaded headers with:\n\n\n ```latex\n\\begin{table}\n    \\centering\n    \\caption{General features and specification for ...}\n    \\singleTableRowHeight\n    \\begin{tabular}{ll}\n\n        \\tableHeaderStart\n        \\tableHCell{Item} \u0026 \\tableHCell{Description} \\\\\n        \\tableHeaderEnd\n\n        Imaging Sensor        \u0026 Sony ICX625 2/3\" progressive scan CCD \\\\\n        Image size (pixels)   \u0026 2448 (H) x 2048 (V)                   \\\\\n        Pixel Size            \u0026 3.45 \\si{\\micro\\metre} x 3.45 \\si{\\micro\\metre} \\\\\n        A/D Converter         \u0026 AD9977 14-bit, dual-channel           \\\\\n        Max frame rate        \u0026 15 FPS                                \\\\\n        Video Data Output     \u0026 8, 12, 16 and 24-bit digital data     \\\\\n        Gain \\\u0026 Exposure                  \u0026 Automatic/Manual/One-Push \\\\\n        Lens Mount            \u0026 C-mount                               \\\\\n        Interface             \u0026 Gigabit Ethernet                      \\\\\n        Physical dimensions   \u0026 44 (W) mm x 29 (H) mm x 58 (L) mm     \\\\\n        \\hline \n\n    \\end{tabular}\n    \\label{table:camera_specs}\n\\end{table}\n ```\n\n\nwhich will produce the following output:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/table_example_with_shaded_header.png\" alt=\"Table with shaded header\" width=\"500\"/\u003e\n\u003c/p\u003e\n\nor you can have more complex tables as in:\n\n\n```latex\n\\begin{table}[htb]\n  \\centering\n  \\caption{Summary of population demographics in the training and test sets}\n  {\n    \\small\n    \\begin{tabular}{p{2cm} c c c c c c c c c c}\n      \\toprule\n\n      Set \u0026\n      \\multirowcell{2}{Number of\\\\subjects} \u0026\n      \\multirowcell{2}{Total time\\\\(hours)}$^1$ \u0026\n      \\multicolumn{2}{c}{Gender} \u0026      \n      \\multicolumn{6}{c}{Ethnicity$^2$}  \\\\\n\n      \\cmidrule{4-11}\n        \n      \u0026  \u0026  \u0026 Male \u0026 Female \u0026 W \u0026 B \u0026 A \u0026 WB \u0026 WA \u0026 O  \\\\\n      \\midrule\n      Training  \u0026 15 \u0026 216.6 \u0026 8  \u0026 7  \u0026 10 \u0026 1   \u0026 1 \u0026 1 \u0026 1 \u0026 1 \\\\        \n      Test      \u0026 15 \u0026 210.0 \u0026 10 \u0026 5  \u0026 10 \u0026 $-$ \u0026 1 \u0026 1 \u0026 2 \u0026 1 \\\\        \n      \\midrule        \n      Total\t\u0026 30 \u0026 426.6 \u0026 18 \u0026 12 \u0026 20 \u0026 1   \u0026 2 \u0026 2 \u0026 3 \u0026 2 \\\\\n        \n      \\bottomrule\n        \n      \\multicolumn{11}{l}\n      {\n        \\footnotesize $^1$ Period during which both reference and estimated data were being recorded simultaneously.        \n      } \\\\        \n      \\multicolumn{11}{l}\n      {        \n        \\footnotesize $^2$ W = White, B = Black, A = Asian, WB = Mixed White \\\u0026 Black, WA = Mixed White \\\u0026 Asian and O = Other.        \n      } \\\\\n        \n      \\end{tabular}      \n  } \n  \\label{table:patient_demographics}\n\\end{table}\n```\n\n\nwhich will produce the following output:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/table_example_complex.png\" alt=\"Complex table\" width=\"500\"/\u003e\n\u003c/p\u003e\n\n\n## Cross-referencing labels\n\n\nThe [cleveref](https://ctan.org/pkg/cleveref) package is used to improve cross references to chapters, sections, figures and other common LaTeX labels. For example, the following text:\n\n\n```latex\n\\Cref{chapter:literature_review} discusses .... is presented in \n\\cref{chapter:dataset} with a detailed ...\n\n\nThe summary of the demographics for the entire set is described in\n\\cref{table:patient_demographics} ...\n\n\n\\Cref{fig:subfig_example} shows the video camera used in the study.\n\\Cref{fig:subfig_example:fig1} shows the camera, as opposed to \n\\cref{fig:subfig_example:fig2}, which shows the lens ...\n```\n\n\nwill produce the following output:\n\n\n```\nChapter 2 discusses .... is presented in chapter 3 with a detailed ...\n\n\nThe summary of the demographics for the entire set is described in table 3.2 ...\n\n\nFigure 3.2 shows the video camera used in the study. Figure 3.2(a)\nshows the camera, as opposed to figure 3.2(b), which shows\nthe lens ...\n```\n\n\n## Glossary, acronyms and abbreviations\n\n\nI use the [glossaries-extra](https://ctan.org/pkg/glossaries-extra) packages to define acronyms and automatically add the \"Glossary\" page in the *frontmatter*. Simply create a file with the name [glossary.tex](glossary.tex) and add all your definitions to it. For example:\n\n\n```latex\n\\newabbreviation[longplural={heart rates},description={Heart rate}]{hr}{HR}{heart rate}\n\\newabbreviation[description={Respiratory rate}]{rr}{RR}{respiratory rate}\n\\newabbreviation[sort=SpO2, description={Peripheral oxygen saturation, as measured by a pulse oximeter}]{spo2}{\\ensuremath{SpO_2}}{peripheral oxygen saturation}\n```\n\n\nNote that the first time you use an acronym, its full definition will be provided. For the rest of the instances, only the abbreviation will be used. The following paragraphs show how to define and use acronyms.\n\n\n```latex\nThe standard vital signs include temperature, \\ab{hr}, \\ab{rr}, \\ab{bp} and,\nwhen appropriate, \\ab{spo2}. The routine measurement and interpretation of \nthese vital signs is a core component of the physiological assessment of most \npatients \\cite{prior1977physical,goldberg2005practical} as they can provide \ncritical information about the underlying state of their health. \n\nWe included all study types looking at monitoring of \\ab{hr}, \\ab{bp}, \\ab{rr}\n or \\ab{spo2} using image analysis with comparison to a reference device. We \n did not restrict based on clinical setting and included all age groups. Only \n non-contact methods using cameras were included. All unpublished studies \n found were included wherever possible to minimise publication bias.\n```\n\n\nwhich will automatically create the following output:\n\n\n```\nThe standard vital signs include temperature, heart rate (HR), \nrespiratory rate (RR), blood pressure (BP) and, when appropriate, \nperipheral oxygen saturation (SpO2). The routine measurement and \ninterpretation of these vital signs is a core component of the \nphysiological assessment of most patients [1,2] as they can provide \ncritical information about the underlying state of their health. \n\nWe included all study types looking at monitoring of HR, BP, RR or \nSpO2 using image analysis with comparison to a reference device. \nWe did not restrict based on clinical setting and included all age \ngroups. Only non-contact methods using cameras were included. All \nunpublished studies found were included wherever possible to \nminimise publication bias.\n```\n\n\nNote that the first time you use an acronym, its full definition will be\nprovided. For the rest of the instances, only the acronym will be used. The\n\"List of abbreviations\" page will be automatically created in the frontmatter:\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\u003cimg src=\"./figures/dphil-glossary.png\" alt=\"Glossary page\" width=\"350\" border=1 /\u003e\u003c/kbd\u003e\n\u003c/p\u003e\n\n\n\n## Bibliography styles\n\n\nThe default style for the references is \"*ieeetr*\". For example, the\nfollowing LaTeX source:\n\n\n```latex\n...Finding reliable correspondences in two images of a scene taken from arbitrary viewpoints viewed with possibly different cameras and in different illumination conditions is a difficult and critical step towards fully automatic reconstruction of 3D scenes \\cite{hartley2003multiple}...\n```\n\n\nwill produce the following output in the content pages:\n\n\n```\n...Finding reliable correspondences in two images of a scene taken from arbitrary viewpoints viewed with possibly different cameras and in different illumination conditions is a difficult and critical step towards fully automatic reconstruction of 3D scenes [8]...\n```\n\n\nand the bibliography section will read:\n\n\n```\nBibliography\n...\n[8] R. Hartley and A. Zisserman, Multiple view geometry in computer vision.\n    Cambridge university press, 2003.\n...\n```\n\n\nYou can specify a custom bibliography style as an argument to the\n\"*listofreferences*\" command in your \"*main LaTeX source file*\". For example,\nthe following command:\n\n\n```latex\n\\listofreferences[apalike]\n```\n\n\nwill use the [apalike](https://www.bibtex.com/s/bibliography-style-base-apalike/)\nBibTeX style and produce the following output in the content pages:\n\n\n```\n...Finding reliable correspondences in two images of a scene taken from arbitrary viewpoints viewed with possibly different cameras and in different illumination conditions is a difficult and critical step towards fully automatic reconstruction of 3D scenes [Hartley and Zisserman, 2003]...\n```\n\n\nand the bibliography section will read:\n\n\n```\nBibliography\n...\n[Hartley and Zisserman, 2003] Hartley, R. and Zisserman, A. (2003). Multiple\n    view geometry in computer vision. Cambridge university press.\n...\n```\n\n\nTake a look at the available styles at [The quick BibTeX guide](https://www.bibtex.com/styles/) online.\n\n\n\n## Mark text as TODO\n\n\nYou can wrap text in \"todo\" tags, so they appear in red colour in the PDF\ndocument. For example: \n\n\n```latex\n    \\todo{Add a citation to reference the latest research}\n```\n\n\n## Formatting source code\n\n\nOften, we want to show pseudo code, source code or other verbatim content in\nour document. For this, I use the\n[listings](https://ctan.org/pkg/listings) package. The extra cutom\nstyles are defined in the class file to show \n\nC/C++ source code:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/listing_style-c.png\" alt=\"C/C++ source code\"\n    width=\"400\" border=1 /\u003e\n\u003c/p\u003e\n\nBASH scripts or commands:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/listing_style-bash.png\" alt=\"BASH code\"\n    width=\"400\" border=1 /\u003e\n\u003c/p\u003e\n\nor other verbatim content:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./figures/listing_style-verbatim.png\" alt=\"Verbatim content\"\n    width=\"400\" border=1 /\u003e\n\u003c/p\u003e\n\n\n\u0026nbsp;\n\n\n# Troubleshooting common errors\n\n\n## Text beyond page limits\n\n\nWhen compiling a LaTeX document, you could get a warning similar to:\n\n\n```\nOverfull \\hbox (22.49216pt too wide) in paragraph at lines 4--5\n```\n\n\nThis often occurs when a line of your document could not fit within the designated horizontal space for text in the current page layout. The LaTeX compiler tries its best to fit text within the page limits, but sometimes it just cannot do it appropriately. This typically results in some text hanging out past the page margin due to long words, acronyms or long equations.\n\nSometimes, it is difficult to know where these errors occur in your document. You can add the \"*debuglayout*\" option to your document:\n\n\n```latex\n\\documentclass[debuglayout]{oxengthesis}\n```\n\n\nA black box will be shown next to the affected lines. Below is a sample output:\n\n\u003cp align=\"center\"\u003e\n    \u003ckbd\u003e\n    \u003cimg src=\"./figures/overfull_hbox_warning.png\" alt=\"Overfull paragraph errors\"\n    width=\"350\" border=1 /\u003e\n    \u003c/kbd\u003e\n\u003c/p\u003e\n\n\nThe [oxengthesis.cls](oxengthesis.cls) class file already takes advantage of other packages (such as [microtype](https://ctan.org/pkg/microtype)) to deal with common issues such as character protrusion, font expansion and inter-word spacing. I recommend you slightly rephrase your guilty sentences instead of changing the class template. This is usually the first approach many of my students take.\n\n\u0026nbsp;\n\n\n# Suggestions and feedback\n\n\nTake a look at the [oxengthesis.cls](oxengthesis.cls) file and the sample [sample_dphil_thesis.tex](sample_dphil_thesis.tex) / [sample_4yp_report.tex](sample_4yp_report.tex) documents for a more complete overview of what you can do with the provided LaTeX class template. Additionally, review the documentation of the [memoir](https://ctan.org/pkg/memoir) LaTeX package. It is quite customisable and provides many extra features not described here.\n\nIf you have any suggestions to improve the class template, don't hesitate to contact me.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaurovm%2Fthesis_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaurovm%2Fthesis_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaurovm%2Fthesis_template/lists"}