diff --git a/retrospective.tex b/retrospective.tex new file mode 100644 index 0000000..a93bcca --- /dev/null +++ b/retrospective.tex @@ -0,0 +1,217 @@ +\documentclass[10pt, draftclsnofoot,onecolumn, compsoc]{IEEEtran} + +\def\changemargin#1#2{\list{}{\rightmargin#2\leftmargin#1}\item[]} +\let\endchangemargin=\endlist + +\usepackage{textcomp} +\usepackage{todonotes} +\usepackage{caption} +\usepackage{pgfgantt} +\usepackage{setspace} +\linespread{1} + +\def \CapstoneTeamName{Automated Fenceless Grazing} +\def \CapstoneTeamNumber{CS3} +\def \GroupMemberOne{Ryan Alder} +\def \GroupMemberTwo{Danila Fedorin} +\def \GroupMemberThree{Matthew Sessions} +\def \CapstoneProjectName{Automated Fenceless Grazing} +\def \CapstoneSponsorCompany{Oregon State University} +\def \CapstoneSponsorPerson{Bechir Hamdaoui} +\def \DocType{Retrospective} + +\newcommand{\NameSigPair}[1]{\par +\makebox[2.75in][r]{#1} \hfil \makebox[3.25in]{\makebox[2.25in]{\hrulefill} \hfill \makebox[.75in]{\hrulefill}} +\par\vspace{-12pt} \textit{\tiny\noindent +\makebox[2.75in]{} \hfil \makebox[3.25in]{\makebox[2.25in][r]{Signature} \hfill \makebox[.75in][r]{Date}}}} + +\begin{document} + +\begin{titlepage} + \pagenumbering{gobble} + \begin{singlespace} + % 4. If you have a logo, use this includegraphics command to put it on the coversheet. + %\includegraphics[height=4cm]{CompanyLogo} + \par\vspace{.2in} + \centering + \scshape{ + \huge CS Capstone \DocType \par + {\large\today}\par + \vspace{.5in} + \textbf{\Huge\CapstoneProjectName}\par + \vfill + {\large Prepared for}\par + \Huge \CapstoneSponsorCompany\par + \vspace{5pt} + {\large Prepared by }\par + Group\CapstoneTeamNumber\par + % 5. comment out the line below this one if you do not wish to name your team + \CapstoneTeamName\par + \vspace{25pt} + } + \begin{abstract} + The Fenceless Grazing Collar system aims to reduce the amount of work + needed by farmers to keep herds of grazing animals. The project + will be implemented using the LoRa wireless communication protocol to allow + for long-range interaction between animal-worn collars and a gateway device. + The gateway device will also provide an HTTP-based JSON API to apply configuration + changes to collars through an application built for Android mobile devices. + The MariaDB SQL database management system will be used to store the data + received from the collar for viewing and analysis. + \end{abstract} + \end{singlespace} +\end{titlepage} + +\pagebreak +\tableofcontents + +\pagebreak + +\section{Introduction} +% TODO briefly recap the project purposes and goals +This document describes the current state, problems, and future +plans of the Fenceless Grazing Collars project. The FGC system's +purpose is to reduce the amount of manual labor required for herding +large numbers of livestock. The system does so by placing GPS-equipped +collars onto individual animals, and producing a negative stimulus +(either auditory or electrical) to discourage the animals from leaving +user-configured grazing areas. The goal of the project is to +provide a reliable, cost-effective, and accessible replacement +for manual farmer labor. + +\section{Current Project State} +% TODO describe where you are currently on the project +At present, the initial design of the project is complete. The project's structure +lends itself very well to division among the three group members, and all +team members' responsibilities have been explicitly defined and agreed upon. +The team members all successfully researched the components of the project that +they are responsible for, and their research has been incorporated into a thorough +design document. + +Both the technical reviews produced by the individual team members and the +design document have been validated by the client, and there is consensus +between the team and the client regarding future plans. + +With the initial design complete, the project is ready to move into the +implementation stage, with the exception of funding: once the department +provides the team with funding required to purchase the hardware components +specified in the design document, work can begin on implementing an initial +prototype. + +\section{Problems} +One of the few problems we had this term was difficulty scheduling meetings in which all +team members could meet with our client. As a result our interaction with our client was +minimal at times, and resulted in only a few meetings over the course of the term. While +this did not prove to be a significant blocker for our work, it did result in some necessary +clarification recently with our client in regards to our vision on how we planned to move forward. +We plan on fixing this problem by scheduling a biweekly meeting with our client at the beginning +of next term. The best way to ensure that our team can keep our client up to date is to have a +definite meeting time, and the best way to schedule this meeting would be as soon as all class +schedules have been finalized. + +Another problem we encountered was lack of funding. While this was not an issue at the +beginning of the term, it is looking to be a serious blocker in the near future as our next step +the moment we get back from winter break is to purchase hardware. Ideally, this hardware would be +purchased prior to even returning to school to allow our team to start work on the physical +aspect of our project immediately. Our client has approved our hardware proposal, which was the +last step before purchasing. Our team has discussed this funding with our TA, who in turn has +brought it up to Professors Winters and Fairbanks. In an effort to ensure funding will be secured +as soon as possible, we will continue to follow up with our TA and the professors if necessary. + +Our last small problem we came across was in regards to formatting for our different submissions. +One of our documents was incorrectly formatted as a result of our misunderstanding of the +requirements. Also, towards the beginning of the term we named our files incorrectly, resulting +in the loss of points. In order to ensure that all style guidelines are met in the future, we +will communicate with our TA, other students, and our professors as needed. Prior to asking +others, we will peruse the online documents provided to us on Canvas to ensure that we are +not asking questions that have already been answered. + +\section{Weekly Progress} +% TODO The document should include a detailed, week-by-week summary of activities, +% problems, solutions, and the like (consider using your blogs to inform this report). +% The report should not include more than a summary of any bigger documents you produced +This section contains the summary of each week of the Fall term during which the +project was active. + +\subsection{Week 3} +This was the first week during which we tracked progress. It consisted largely +of drafting, submitting, and merging +the requirements document and problem statements. This went smoothly; each team member +felt confident in their understanding of the project's requirements and the +problem it is solving, likely because our group was offered the project in +the summer before the class had started. The only foreseeable problems at +this point is the difficulty in scheduling a semi-regular meeting with the +client: each group member, and the client themselves, are exceptionally +busy during this academic term, and on most week, no single time works +for every person. This problem is not significant at this point, however, +because the team has enough information to work for the time being. + +\emph{Note: At this point, some members of the team received lower scores + than expected for certain submissions. Since the content of the various + submissions was agreed upon by each team member, the variance in + the received scores was unexpected and was listed as a "problem". However, + this did not impact the project itself, since one of the submissions + received full points.} + + +\subsection{Week 4} +This week consisted largely of revisions to the requirements document and +independent research. Team roles have been decided as early as this week: +each team member has a particular "strong suit", and will be playing +to their strengths in implementing this project. Since team roles have +been assigned, and since the team already has a vague understanding +of what components the project will consist of, members are eager to purchase +hardware and begin tinkering. However, a meeting has not yet been established +with the client at this point, and the matter of funding has not yet been +decided. It is not clear at this point who will be financing the hardware +required for the project. + +\subsection{Week 5} +During this week, the source of funding was somewhat elucidated by a team +member's individual meeting with the client. The team was informed +that \$300 has been set aside for each Senior Capstone team to help with funding. +The team's TA was asked about this, but was not aware of the details, and +offered to contact Dr. Winters. + +While there is not yet an exact date for a meeting with the client, one +is soon to be established. Each group member and the client provided the +times during which they are available, revealing that there were no +time slots during which each individual was available to meet. As such, +one of the group members will likely skip this meeting, and the rest +of the group members will fill them in. + +In preparation for the client meeting, team members have been doing further +research into their components of the project. This coincides well with the +first drafts of the technical review, which require exactly the type of +research that the team will present to the client in the meeting. + +\subsection{Week 6} +The highlight of this week was the first meeting with the client. This meeting +was scheduled last-minute, but went very well. The team's plan and the client's +expectations were not significantly different. + +\section{Retrospective} +% TODO add retrospective +% positives column: anything good that happened +% deltas column: changes that need to be implemented +% actions column: specific actions that will be implemented in order to create the necessary changes +\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}|p{0.3\linewidth}|p{0.3\linewidth}|p{0.3\linewidth}|@{}} + \hline + + Positives & Deltas & Actions \\ + \hline + \begin{itemize} + \item one + \end{itemize} + & + \begin{itemize} + \item two + \end{itemize} + & + \begin{itemize} + \item three + \end{itemize} \\ + +\end{tabular*} + +\end{document}