<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\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=SDR.LabIntro}
\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_sdr.png}
\vspace{0.25in}
\labdate{Fall 2017}
\vspace{0.23in}
\labauth{Michael Benjamin, mikerb@mit.edu}
\labauth{Henrik Schmidt, henrik@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}

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

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

\vspace{0.1in}
\begin{packed_itemize}
\item {\em MOOS-IvP Documentation}: \urlx{http://oceanai.mit.edu/ivpman}
\end{packed_itemize}
\vspace{0.1in}

\noindent
This lab is also online in wiki format at the above link. The wiki
pages are generated from the same content (LaTeX) that generated the
PDF or hard-copy version of the the labs. This is done as a matter of
convenience and for later labs where there may be videos embedded in
the labs.

%================================================================
\section{Getting Started with the Command Line}
\label{sec_command_line}

Most of the exercises in this lab are given from the perspective of
the command-line user. If you're not familiar with the command-line,
this is a powerful mode of interfacing with your computer that, for
many, {\em far} surpasses the efficiency afforded through a pure
point-and-click GUI experience. For Mac users the command line comes
by way of the Terminal application. For GNU/Linux users, you are very
likely already accustomed to opening a console or shell window.

\pskip

The below couple sections help absolutely new users get started a bit. 
Just enough so we can reach the goals of our lab. Much more information
can be found on the web, and there are a few help pages related to the 
command line on the workshop help page:

\vspace{0.1in}
\noindent
\urlx{http://oceanai.mit.edu/ivpman/help}
\vspace{0.1in}

\noindent
Finally let's not overlook help already on your system. For any given
GNU/Linux command, \cmd{foobar}, try one of the below to get further
information.

\vspace{0.1in}
\begin{consoleverb}
 $ man foobar
 $ foobar --help
\end{consoleverb}
\vspace{0.1in}

\input{./help_cmd_basics}
\input{./help_cmd_mkdir}
\input{./help_cmd_movecopy}
\input{./help_cmd_shell_env}
\input{./help_cmd_shellpath}
\input{./help_cmd_aliases}

%=======================================================================
\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}

</pre></body></html>