\documentclass[onecolumn,letterpaper,11pt]{article}

%===================================================================
% Include common packages, environments, counters etc
%===================================================================
\input{common_latex/common_latex_packages}
\input{common_latex/common_latex_lab_format}
\input{common_latex/common_latex_definitions}
%===================================================================
\begin{document}
\wikidoc{file=MCA.Lab01Intro}
\wikidoc{auth=mikerb@mit.edu}

%===================================================================
% Build the Cover Page in an environment style easy for wiki parsing
\begin{labcover}
\labtitle{Lab 1 - Getting Started}
\vspace{0.2in}
%\labcourse{Accelerated Marine Autonomy and Communications}
\vspace{0.15in}
\labpng{0.7}{figs_common/header.png}
\vspace{0.25in}
\labdate{November 17-21 2025}
\vspace{0.23in}
\labauth{Michael Benjamin, mikerb@mit.edu}
\labauth{Department of Mechanical Engineering}
\labauth{MIT, Cambridge MA 02139}
\labtocdepth{2}
\labtoc{small}
\end{labcover}

%===================================================================
% Add a blank page so first body page is on the right when doubleside
\blankpage

%===================================================================
% Begin the body of the text
%===================================================================
\section{Overview and Objectives}
%===================================================================

\begin{labinfo}
%\labinfoheader{Topics:}
\begin{packed_itemize}[2]
\item Goal - Make sure everyone has a suitable machine for the workshop
\item Goal - All students able to build and run the workshop software
\item Overview of the Course Web Pages and Support
\item Getting Started with the Command Line
\item Downloading, Building, Running the Course software
\end{packed_itemize}
\end{labinfo}

%=======================================================================
\subsection{Linking the Course Web Pages}

We recommend putting these pages in your browser's bookmarks:

\vspace{0.1in}
\begin{packed_itemize}
\item {\em This Minicourse}: \urlx{https://oceanai.mit.edu/minicourse-pisa}
\item {\em MOOS-IvP Documentation}: \urlx{https://oceanai.mit.edu/ivpman}
\end{packed_itemize}
\vspace{0.1in}

\noindent
\pvar{Blue Labs:} There are eight core labs in this course, found on
the main course page in the section labeled \pvar{Blue Labs}. This is
the first of those labs.

\vspace{0.1in}
\noindent
\mvar{Green Labs:} There is also a set of optional \mvar{Green Labs},
providing background skills assumed for the Blue Labs. At the
beginning of certain core labs, a set of background green labs will be
suggest for reading at the outset of the lab if warranted by the
readers background.

%=======================================================================
\subsection{Pre-requisite Skills}

The labs in this course require some core skills in a three different areas:

\begin{packed_itemize}
\item The command-line interface (CLI)
\item Proficiency with a basic text editor
\item At least a beginners level capability of C++
\end{packed_itemize}

\noindent
For Mac users, if you haven't developed code on a Mac previously,
there are a few additional steps you may need to take, described
below, to set things up. If you are a Linux user, development tools
are likely baked into a typical Linux install, e.g., Ubuntu, for all
but the most minimal install options.

\vspace{0.1in}
\noindent
For this lab, some basic CLI and text editor experience is needed. For
the three core skills areas mentioned above, we could spend many days
or weeks on each topic. However the basic skills are all that is
needed here. In any event, an effective way to enrich each of these
skills is to iteratively improve and expand as you go along, once you
have established the baseline for task at hand. Allow yourself time to
explore and expand on each topic in the margins of your time.

\vspace{0.1in}
\noindent
If you are new to the command-line, please read through the following:

\vspace{0.1in}
\noindent
\mvar{Green Lab:} \urlg{MCP.GrnCommandLine # Command Line Basics} 

\vspace{0.1in}
\noindent
If you are not familiar with a text editor, or unsure what we mean by a
text editor, please read through the following: 

\vspace{0.1in}
\noindent
\mvar{Green Lab:} \urlg{MCP.GrnTextEditors # Introduction to Text Editors} 

\vspace{0.1in}
\noindent
If you are using a Mac, you need to ensure that you have XCode installed,
as well as a package manager to install some software packages needed for
the course. Please read through the following: 

\vspace{0.1in}
\noindent
\mvar{Green Lab:} \urlg{MCP.GrnXCode # Getting XCode for Development on MacOS Machines} 

\noindent
\mvar{Green Lab:} \urlg{MCP.GrnTextEditors # Getting a Package Manager on MacOS Machines} 


%=======================================================================
\section{Getting, Building and Running the Workshop Software}
\label{sec_course_software}

The objective is to build and run the "Hello World" version of the 
marine autonomy software, the Alpha mission. This will confirm for us 
that:

\begin{packed_itemize}
\item You have everything you need in terms of software installed on you machine.
\item You have properly configured your shell path to include the locations
of the software executables used in this class.
\end{packed_itemize}

\noindent
Follow the steps here until you are able to successfully run the 
Alpha example mission.

\input{./help_mip_download}
\input{./help_mip_firstrun}

\end{document}
