Skip to content

Commit

Permalink
Wrap up
Browse files Browse the repository at this point in the history
  • Loading branch information
ineshbose committed Apr 8, 2022
1 parent e51951a commit a076185
Show file tree
Hide file tree
Showing 7 changed files with 121 additions and 28 deletions.
2 changes: 1 addition & 1 deletion .gitattributes
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
*.example linguist-detectable=false
dissertation/l4proj.tex linguist-vendored
*.tex linguist-vendored
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Portion Mate is an application that helps keep track of your food intake. This p
- [Getting Started](https://github.com/ineshbose/portion-mate/blob/develop/src/manual.md)
- [App Documentation](https://portion-mate.readthedocs.io/)
- [Repository Wiki](https://github.com/ineshbose/portion-mate/wiki/)
- [Dissertation (WIP)](#)
- [Dissertation](https://ineshbose.github.io/portion-mate/dissertation.pdf)

<table>
<tbody>
Expand All @@ -48,7 +48,7 @@ Portion Mate is an application that helps keep track of your food intake. This p
<td><b>Dependency managers</b></td>
<td>
<a href="https://github.com/yarnpkg/yarn" target="_blank"><img alt="Yarn" src="https://img.shields.io/badge/Yarn-2C8EBB?style=for-the-badge&logo=yarn&logoColor=white"></a>
<a href="https://github.com/python-poetry/poetry" target="_blank"><img alt="Poetry" src="https://img.shields.io/badge/Poetry-1f293c?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAABHNJREFUWMOtlt1rHFUYxn/ve85ks7vZZCvolZUY0QuvAqLUFi9KsRZRpDdCTUGKV176H7R/QLXxRgRFi6hUexEQvCtZQamorVuLad2UZkvbzTZJm6VWmmabOV7M7O7M7GQ/xAOHOWfPzHmf93nejxUiY88nC25p1zPUfAHnwA+nc+D7nb0f7l1i7yff89PPDz0pLZsaBfDTH2u88FuFx9kKLncOCJ/hMhiu83BEDyIj8o1LO08BgMBceY1d5SvsFD9yQfTSFDBRQ2nfEDsv9QSACqfPrfBieZGd6nckiBlOMEOShe097ssAAniWb35fY/fFKzxhIlq3JUnQ3waXAJq2hnIPABJOIONx6twq+y4vsScbuTzGSIrheHCkMXKhPwMSLnIZPvu5ztN/Vtmdk26P0mKiy+skSNcnBtpAwhsLWT4/W+OpS9fYlY2kZ9IIPejvMFBlZqo6AAN0pBBgPMcXZ28wVbnO87mkHOH9PunSxLNkrncQxlhwHQAqMD7GV2dvMrl4k33jmjC2zYTk/mT/LGg/JU6LUZjI8+0vNQqXb/DGDpMSlEntY/FRYmaq3IeBMAuIyhCRwirkR5k7X6e5cJMDSRB+LyDu2AB1wHWob5MQkQKBjAejHt9fuEXzUo29EyZuyHcpMeJKzEyVBitEpBhvRXErM7IZyHicWVilWVlm97hJNK5k+vHeYJUwmglEmIgia52PemAMP1Zu01ys81LR4glpwXiMw93a92HAJQy6uEytqpnLgAq/Lq3TqNR5rmCwrcgPWCgzM3V08F7QxUKP39pMBCAuXr/LncVbPJtTTACigePgcM2oKwVTOluy0RmBEQ8EKvV7NK6uMpmRBo69HI5XvbRhtz2RNFkkzkTraTS4amuL69duUzhzvjq2sVm9N3Q73jYlXLckyVetQe5vkq1UcVtu2k5MzBcPfV38DwAizV5ajkuC+oQOvsPUb5P/awnP87BjecTqtBidf+Tt08UhALjupdCdAdGfNjbJXK2Rv7aMl89h8jnEGsQYxJppUZ1/9J254pBp2DKWSEcXAdd8iHdjhbGFq2Tv3sOOF9ARD7UG9TzUM6i1qDXTYnX+sXe/Kw4XhABOurXfbOKtrpNZuYMRQUcziGcRVUQEUQWVMJmCXiLCpINJEn/HUgC4uHF1QZ9/2MSu38U2/sb+cx9jTMwwRlBVRALjaAgkwFBGOHLrw1fLfRmQtfWGOIo83ELvb6BbPvpgE7PxAB3xkJERNJcNNdbA69Y0Le8V0VYXlRK4g/UTBxoD1QHvwuW96o3Mi2eL4lnU2MDLQiEw2J4GUYmDCNeB9wIix5bf33+0Xxp2ZXfulY+nxei8GC2KMQmDJgEi9DwCBJWqiBypHX+5NEAdSi8vY699GoIwxZjnahAbGFJjwEgUSENEZmsDeN0XAEDh4Mk2E5r0PM5CQ4zMgpxY/mB/gyFHrwLLxJtfTouGctjA6wiAsqjOojJXnz0wtOGBAADseOtUiwnEaEmM/iBG51Y+er3K/zD+BYzRWKPnTc4MAAAAAElFTkSuQmCC&logoColor=white"></a>
<a href="https://github.com/python-poetry/poetry" target="_blank"><img alt="Poetry" src="https://img.shields.io/badge/Poetry-60A5FA?style=for-the-badge&logo=poetry&logoColor=white"></a>
</td>
</tr>
<tr>
Expand Down
53 changes: 52 additions & 1 deletion dissertation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,58 @@
<h5 align="center">Dissertation</h5>

<p align="center">
<!-- BADGES / SHIELDS -->
<a href="https://github.com/ineshbose/portion-mate/actions/workflows/build-dissertation.yml" target="_blank"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/workflow/status/ineshbose/portion-mate/Compile%20Dissertation?logo=github-actions&logoColor=white&style=flat-square"></a>
<a href="https://www.latex-project.org/" target="_blank"><img alt="LaTeX" src="https://img.shields.io/badge/language-LaTeX-008080?logo=latex&logoColor=white&style=flat-square"></a>
<a href="https://overleaf.com/" target="_blank"><img alt="Overleaf" src="https://img.shields.io/badge/editor-Overleaf-47A141?logo=overleaf&logoColor=white&style=flat-square"></a>
<a href="https://zotero.org/" target="_blank"><img alt="Zotero" src="https://img.shields.io/badge/referencing-Zotero-CC2936?logo=zotero&logoColor=white&style=flat-square"></a>
</p>
</p>
</div>

## _Abstract_

> The Eatwell Guide is a recommendation given by Public Health England on having a balanced diet. Following and maintaining a diet may be difficult for people, and logging can help them keep track of their plan. However, the task of logging itself can also require a lot of commitment which can cause people inconvenience and make them give it up.
>
> This project aims to develop an application that solves these problems of maintaining a diet plan; this was achieved through months of research and development into users, food and logging, in order to create a fully-integrated and convenient system that does not add a burden onto users, but rather motivates them to adhere to their plan. Considering the time-frame, this project also leaves development open-ended with scope for future work that can be passed over to or taken over by developers who can make use of the open-source side projects created and best practices followed by the system without great difficulty.
>
> To confirm the usability of the application, evaluation was carried out through a survey where participants could share their thoughts with the help of System Usability Scale that also in-turn helps in analysing the results to a score that deemed the system as acceptable.
## About This Document

This document follows the [provided template (`/dissertation @ 89738d2`)](https://github.com/ineshbose/portion-mate/tree/89738d2aa8959f847b1b542e6dc466de8165126b/dissertation) that can be found on [Overleaf](https://www.overleaf.com/latex/templates/university-of-glasgow-level-4-computing-science-project-template/spqpnkvzjdbw) and [GitHub](https://github.com/johnhw/l4template). It provides a class module file [`l4proj.cls`](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls) with attribution to the authors and modifiers.

```tex
\ProvidesClass{l4proj}[%
2009/01/09 Colin Perkins <[email protected]>.%
2009/09/16 Modified by Tim Storer <[email protected]> to support non pdf modes.%
2011/02/15 Modified by Gregg Hamilton <[email protected]> for use in final year projects.%
2012/10/18 Modified by Patrick Prosser, use geometry to control margins, simplified.%
2018/09/14 Modified by John Williamson, improve typographic appearance%
]
```

However, this class has been extended with features such as supporting syntax highlighting for [JavaScript](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls#L603), [TypeScript](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls#L661), [YAML](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls#L648), and [TOML](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls#L669) using [`listings`](https://ctan.org/pkg/listings) (not [`minted`](https://ctan.org/pkg/minted)), and autogenerating labels for [headings](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls#L511) and [figures](https://github.com/ineshbose/portion-mate/blob/develop/dissertation/l4proj.cls#L274).

Majority of writing and working with [LaTeX](https://www.latex-project.org/) was with [Overleaf](https://overleaf.com/), and required a separate repository since branching and symlinks are not supported as of yet (changes are still synchronised here). The chapters have been divided into separate files (using [`subfiles`](https://ctan.org/pkg/subfiles)) in [`chapters/`](https://github.com/ineshbose/portion-mate/tree/develop/dissertation/chapters), and compilation is through [**`pdflatex`**](https://www.tug.org/applications/pdftex/) that requires `--shell-escape` and [`inkscape`](https://inkscape.org/) enabled for [`svg`](https://ctan.org/pkg/svg) support. Referencing was managed using [Zotero](https://zotero.org/) and their [API](https://api.zotero.org/), split into separate files. These are added using [`biblatex`](https://ctan.org/pkg/biblatex) with the default `numeric` style.

```tex
%=============================================================================
% CHAPTER NAME
% description about chapter
% ## Guidance
% - Some guidance about the chapter if provided or necessary.
% - This would help in writing and fill criterias.
%=============================================================================
\documentclass[../main.tex]{subfiles}
% \graphicspath{{\subfix{../images/}}}
\begin{document}
% contents ..
\end{document}
```
44 changes: 22 additions & 22 deletions dissertation/l4proj.cls
Original file line number Diff line number Diff line change
Expand Up @@ -125,17 +125,17 @@
\pgfmathsetmacro{\deltaA}{\v/100*360}
\pgfmathsetmacro{\nextA}{\curA + \deltaA}
\pgfmathsetmacro{\midA}{(\curA+\nextA)/2}

\path[slice,\s] \c
-- +(\curA:\r)
arc (\curA:\nextA:\r)
-- cycle;
\pgfmathsetmacro{\d}{max((\deltaA * -(.5/50) + 1) , .5)}

\begin{pgfonlayer}{foreground}
\path \c -- node[pos=\d,pie values,values of \s]{$\v\%$} +(\midA:\r);
\end{pgfonlayer}

\global\let\curA\nextA
}
\end{scope}
Expand Down Expand Up @@ -305,44 +305,44 @@
\renewcommand\maketitle{
\begin{titlepage}%
\definecolor{UniBlue}{HTML}{00355F}

\let\footnotesize\small
\let\footnoterule\relax
\let\footnote \thanks

% the logo, full page width
\vspace{1in}
\includegraphics[width=\linewidth]{images/CompSci_colour.pdf}
\vskip 0.5em
\color{UniBlue}
{\large \sffamily Honours Individual Project Dissertation}\\

% title and author

\vspace{1cm}
\Large
\vskip 5em%

\begin{center}

\color{UniBlue}
\noindent
{\Huge \scshape \@title \par}%





\end{center}
\vfill
{\Large
\textbf{\@author}\\
\@date}



\end{titlepage}%

\setcounter{footnote}{0}%
\global\let\thanks\relax
\global\let\maketitle\relax
Expand All @@ -351,7 +351,7 @@
\global\let\@date\@empty
\global\let\@consentname\@empty
\global\let\@consentdate\@empty

\global\let\@title\@empty
\global\let\title\relax
\global\let\author\relax
Expand Down Expand Up @@ -400,12 +400,12 @@
\newpage
% \let\cleardoublepage\relax
\chapter*{Educational Use Consent}

I hereby grant my permission for this project to be stored, distributed and shown to other
University of Glasgow students and staff for educational purposes.
\textbf{Please note that you are under no obligation to sign
this declaration, but doing so would help future students.}

\begin{tabular}{@{}llll}
& & & \\
& & & \\
Expand All @@ -418,7 +418,7 @@
\chapter*{Educational Use Consent}
Consent for educational reuse withheld. Do not distribute.
\fi

}

% split into files
Expand Down
10 changes: 9 additions & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,17 @@
<h5 align="center">Documentation</h5>

<p align="center">
<!-- BADGES / SHIELDS -->
<a href="https://ineshbose.github.io/portion-mate/dissertation.pdf" target="_blank"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/workflow/status/ineshbose/portion-mate/Compile%20Dissertation?style=flat-square&label=dissertation"></a>
<a href="https://github.com/ineshbose/portion-mate/wiki" target="_blank"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/workflow/status/ineshbose/portion-mate/Deploy%20Wiki?style=flat-square&label=wiki"></a>
<a href="https://portion-mate.readthedocs.io/" target="_blank"><img alt="Read the Docs" src="https://img.shields.io/readthedocs/portion-mate?style=flat-square&label=docs"></a>
</p>
</p>
</div>

<div align="center">
<p align="center">
This project has been heavily documented to allow you to learn more about the background, development and usage of the application. Each document acts as a guide to a specific area/aspect of the project, and you can find all information and links on the <a href="https://github.com/ineshbose/portion-mate" target="_blank">repository</a>.
</p>
</div>

##
6 changes: 5 additions & 1 deletion docs/log_parser.py
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,13 @@
if line in ["\n"]:
continue

if line.lower().startswith("## week"):
if line.startswith("## ") and (
line[3:].lower().startswith("week") or len(raw_week_logs) > 0
):
raw_week_logs.append(week_block)
week_block = []
if (not line[3:].lower().startswith("week")) and len(raw_week_logs) > 0:
break

week_block.append(line[:-1] if line.endswith("\n") else line)

Expand Down
30 changes: 30 additions & 0 deletions timelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -584,3 +584,33 @@ Time taken off to unwind and relax for Christmas and New Year.

* *1 hour* Issue [#73](https://github.com/ineshbose/portion-mate/issues/73)
* *4 hours* Issue [#133](https://github.com/ineshbose/portion-mate/issues/133)

## Week 27

### 28 March 2022

* *6 hours* Dissertation writing

### 29 March 2022

* *8 hours* Dissertation writing

### 30 March 2022

* *8 hours* Dissertation writing

### 31 March 2022

* *10 hours* Dissertation writing
* *4 hours* Presentation planning

### 01 April 2022

* *5 hours* Dissertation polishing and review
* *2 hours* Presentation recording
* *1 hour* Preparing submission in format, uploading and submitting
* *0.5 hours* Celebration :)

## Total hours: 411

For more information, see the [Git History](https://github.com/ineshbose/portion-mate/wiki/GitLogs) or this timelog in a [table format](https://github.com/ineshbose/portion-mate/wiki/LogTable).

0 comments on commit a076185

Please sign in to comment.