<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}
%===================================================================
\setcounter{tocdepth}{2}
%===================================================================

\begin{document}
\wikidoc{file=Lab.2S01Setup}
\wikidoc{auth=mikerb@mit.edu}
\helplevelsubsec

%===================================================================
% Build the Cover Page in an environment style easy for wiki parsing
\begin{labcover}
\labtitle{Lab 1 - Overview and Machine Setup}
\vspace{0.2in}
\labcourse{2.S01 Introduction to Autonomous Underwater Vehicles}
\vspace{0.5in}
\labpng{0.95}{figures/lab_one_topics.png}
%\labpng{0.75}{figures/sim_cluster.png}
\vspace{0.25in}
\labdate{March 31st, 2025}
\vspace{0.23in}
\labauth{Michael Benjamin, mikerb@mit.edu}
\labauth{Supun Randeni, supun@mit.edu}
\labauth{Mike Sacarny, msacarny@mit.edu}
\labauth{Department of Mechanical Engineering}
\labauth{MIT, Cambridge MA 02139}
\labtoc{scriptsize}
\labtocdepth{2}
\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 lab laptop for the
  course on Day 1
\item Overview of the Course Web Pages and Support
\item Get Started with the Command Line
\item Get Started with a Text Editor
\item Download, Build and Run the Course Autonomy Software
\end{packed_itemize}
\end{labinfo}

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

There are two main web pages for this course, the main course page on
the MIT server, and the Piazza Page. We recommend putting these pages
in your browser's bookmarks or Favorites tab as soon as possible. We
will be referring to them a lot:

\vspace{0.1in}
\begin{packed_itemize}
\item {\em Course wiki}: \urlx{https://oceanai.mit.edu/2.S01}
\item {\em Piazza}: \urlx{https://piazza.com/mit/spring2025/2s01}
\end{packed_itemize}
\vspace{0.1in}

\noindent
Lectures and labs are posted and linked from the course page:

\begin{packed_itemize}
\item {\em Lectures}: \urlx{http://oceanai.mit.edu/2.S01/lectures}
\item {\em Labs}: \urlx{http://oceanai.mit.edu/2.S01/labs}
\item {\em Labs}: \urlx{http://oceanai.mit.edu/2.S01/schedule}
\end{packed_itemize}
\vspace{0.1in}

\noindent
This lab and other course labs are 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 labs. This is
done as a matter of convenience and for later labs where there may be
videos embedded in the labs, and for those who prefer hard copies.

%======================================================================
\subsection{Machine Requirements for MIT 2.S01}

In 2.S01 you will use the 2.S01 provided Linux laptop. Udated after
our first class: since we have enough Linux laptops to loan to the
whole class, we will simplify our lap setup instructions based on the
assumption that everyone is using the same provided Linux laptop. If for
some reason you switch to a Mac and have questions, let us know.

\vspace{0.1in}
\noindent
{\bf NOTE:} On the 2.S01 laptops, there is already a user account. You
do {\em not} need to create another user account. If you would like to
anyway, a couple simple further steps will need to taken to ensure
access keys (ssh keys) are in place. See Supun, or post to Piazza.


%================================================================
\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 discussed above. For GNU/Linux
users, you are very likely already accustomed to opening a console
or shell window. 

\vspace{0.1in}
\noindent
The below couple sections help the very-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 course help page:

\vspace{0.1in}
\noindent
\urlx{http://oceanai.mit.edu/2.S01/cmd}
\vspace{0.1in}

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

\vspace{0.1in}
\begin{consoleverb}
 $ man wget
 $ wget --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}

%=======================================================================
\newpage
\section{Getting, Building and Running the Course Autonomy Sim 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 your machine.
\item You have properly configured your shell path to include the locations
of the software executables used in this class.
\end{packed_itemize}

\vspace{0.1in}
\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>