source: issm/oecreview/Archive/12321-12677/ISSM-12632-12633.diff@ 12679

Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Android.tex
===================================================================
--- /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Android.tex      (revision 0)
+++ /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Android.tex      (revision 12633)
@@ -0,0 +1,138 @@
+%Preamble {{{
+%Packages
+\documentclass[9pt,notes=hide]{beamer}
+
+\definecolor{links}{HTML}{2A1B81}
+\hypersetup{colorlinks,linkcolor=,urlcolor=links}
+
+\usetheme[jpl,headstyle=institute,fnolabel=,sidebar=.15\paperwidth,footstyle=low,footsep={ $\cdot$ },TPomitframeno,conference=This is a test]{Pasadena}         
+\useinnertheme{MLHacks}         % ISSM bonuses (ghostframes for example)
+\usepackage[T1]{fontenc}        % T1 encoding is better for foreign langages
+\usepackage{aeguill,aecompl}    % Virtual fonts
+\usepackage{amsmath,amssymb}    % Mathematical symbols (useful for equations)
+\usepackage{xcolor}             % We can define new colors
+\usepackage{graphicx}           % Include pictures
+\usepackage{times}              % Use Times Font instead of default
+\graphicspath{                  % directories where the pictures are located
+{Images/Results/}
+}
+
+\setbeamercovered{transparent}  %invisible, transparent, dynamic, highly dynamic
+
+%%Automatically insert outline slide at the begining of each new section (very nice!)
+%\AtBeginSection[]{
+%\begin{frame}<beamer>
+%      \frametitle{Outline}             % title of the slide
+%      \tableofcontents[currentsection]
+%      \ghostframe                      %do not count slide
+%\end{frame}
+%}
+%}}}
+%Presentation properties{{{1
+%between brackets    []: shown on headers and footers of every slide (short)
+%between parenthesis (): shown on title page only (long)
+\title[ISSM on Android]{Ice Sheet System Model on the Android Platform}
+\author[G.Perez]{Gilberto \textsc{Perez}\inst{1}}
+\institute[JPL]{
+\inst{1}California State Polytechnic University, Pomona\\
+}
+\conference[conference shouldnt be required]{Not sure why this is needed...}
+\date[\today]{June 2010 \hspace{3em}\copyright Copyright 2011. All rights reserved}
+\logo{\includegraphics[width=8em]{ISSMlogo}}
+%}}}
+
+\begin{document}
+
+%Title slide {{{
+\begin{frame}[plain] %No headers or footers
+       \titlepage
+\end{frame}%}}}
+%Outline {{{
+\begin{frame}
+       \frametitle{Outline}
+       \tableofcontents
+\end{frame}%}}}
+
+\section[Motivation]{Why Port ISSM to Android?}
+\begin{frame}%{{{
+       \frametitle{intro}
+    The ISSM Android project is an attempt at outreach by the scientific community by producing a readily distributable application that the layman can use to hold tangible evidence of climate change. 
+\end{frame}%}}}
+\subsection{Why Android Specifically?}
+\begin{frame}%{{{
+       \frametitle{Why Android?}
+    The reasons Android was selected as our target platform are as follows:
+       \begin{itemize}
+               \item<2-2> Android is a GNU/Linux based open source platform
+               \item<3-3> ISSM was developed with portability to Unix-like operating systems
+        \item<4-4> Android holds the largest market share in the smart phone market. 
+       \end{itemize}
+\end{frame}%}}}
+\section[SDK]{About the Android SDK}
+\begin{frame}
+    \frametitle{Android SDK}
+    The Android Software Development Kit(SDK) is a set of tools for developing applications for the Android platform. While a the Java Software Development Kit is still required, one need never make calls to Java SDK programs as the tools provided by the Android SDK and the Apache Ant build tools.
+    \\[12pt]
+    For more information on the Android SDK and the Apache Ant Project see the following links:
+    \begin{itemize}
+        \item \href{http://ant.apache.org/}{Apache Ant Project}
+        \item \href{http://ant.apache.org/}{Android SDK}
+    \end{itemize}
+    \includegraphics[width=4em]{android-hub}
+\end{frame}
+\subsection{Why the use SDK?}
+\begin{frame}
+    \frametitle{Why use the Android SDK?}
+    Although developing for Android is typically done in the Java programming language, one cannot simply use Java SDK to produce an Android app for the following reasons:
+       \begin{itemize}
+               \item<2-3> Android apps do not run on an implementation of the Java Virtual Machine. Instead, they run the Dalvik Virtual Machine.
+            \begin{itemize}
+                \item<3-> Different byte code and API
+            \end{itemize}
+               \item<4-7> Applications are distributed as APK files which are zipped, signed and aligned packages that include
+               \begin{itemize}
+                       \item<5-5> Application binaries
+                       \item<6-6> Resources like images, text, etc.
+                \item<7-7> AndroidManifest.xml
+               \end{itemize}
+       \end{itemize}
+    \includegraphics[width=\linewidth]{build-simplified}
+\end{frame}
+\subsection[Tools]{Important Tools}
+\begin{frame}
+    \frametitle{Important Tools}
+    There are many useful tools provided in the Android SDK, those we are using are:
+    \begin{itemize}
+        \item<2-> \href{http://developer.android.com/tools/help/android.html}{android}: is arguably the most useful tool. It allows you to:
+            \begin{itemize}
+                \item Create, delete and view Android Virtual Devices (AVDs)
+                \item Create and update Android projects
+                \item Update Android SDK with new platforms, add-ons and documentation
+            \end{itemize}
+        \item<3-> \href{http://developer.android.com/tools/help/emulator.html}{emulator}: is a generic Android device emulator which can emulate any existing device specification.
+        \item<4-> \href{ttp://developer.android.com/tools/help/adb.html}{adb}: The Android Debug Bridge allows you to communicate with an emulated device by piping shell commands, granting a terminal, and pushing/pulling files from the file system.
+    \end{itemize}
+\end{frame}
+\section[NDK]{Android Native Development Kit}
+\begin{frame}
+\frametitle{Native Development Kit}
+    Since ISSM is written in C/C++, we must be able to compile it for an Android device running on an ARM processor. Furthermore, we must be able to run ISSM from the context of an Android application. \href{http://developer.android.com/tools/sdk/ndk/index.html}{The Android Native Development Kit (NDK)} provides tools to this end.
+\end{frame}
+\subsection[Standalone Toolchain]{Android Native CPU ABI Management}
+\begin{frame}
+    Although the NDK provides tools, as well as useful examples, to compile and package native libraries along with a typical Android application, it is best used for our purposes to provide a full compliment of compilers, linkers, archivers, etc.
+    \begin{itemize}
+        \item make-stand-toolchain.sh: will create wrappers around the GNU GCC that are tailored to a specific Android API and Application Binary Interface(ABI)
+        \begin{itemize}
+            \item \href{http://www.sco.com/developers/devspecs/gabi41.pdf}{ELF System V Application Binary Interface}
+        \end{itemize}
+    \end{itemize}
+\end{frame}
+
+\section{Compiling ISSM}
+\subsection{External Packages}
+\subsection{Configuration}
+
+\section{Java Native Interface}
+
+\end{document}
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/ISSMlogo.pdf
===================================================================
Cannot display: file marked as a binary type.
svn:mime-type = application/octet-stream
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/ISSMlogo.pdf
===================================================================
--- /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/ISSMlogo.pdf     (revision 12632)
+++ /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/ISSMlogo.pdf     (revision 12633)

Property changes on: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/ISSMlogo.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/build-simplified.png
===================================================================
Cannot display: file marked as a binary type.
svn:mime-type = application/octet-stream
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/build-simplified.png
===================================================================
--- /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/build-simplified.png     (revision 12632)
+++ /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/build-simplified.png     (revision 12633)

Property changes on: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/build-simplified.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/android-hub.jpg
===================================================================
Cannot display: file marked as a binary type.
svn:mime-type = application/octet-stream
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/android-hub.jpg
===================================================================
--- /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/android-hub.jpg  (revision 12632)
+++ /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/android-hub.jpg  (revision 12633)

Property changes on: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/android-hub.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
Index: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Makefile
===================================================================
--- /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Makefile (revision 0)
+++ /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Makefile (revision 12633)
@@ -0,0 +1,27 @@
+#Makefile for beamer
+
+#if nothing specified, make pdf
+all: one
+
+#document name (no extension)
+TARGET=Android
+export TEXINPUTS=~/issm-jpl/issm/publications/Templates/beamer/Theme/Pasadena//:
+
+#compile only once and open
+one: 
+
+       pdflatex -halt-on-error $(TARGET).tex
+       open $(TARGET).pdf
+
+#compile three times and open
+complete: 
+
+       #compile three times fpr the structure
+       #first two times draftmode to go faster (no image inclusion -> faster)
+       pdflatex -halt-on-error -draftmode $(TARGET).tex
+       pdflatex -halt-on-error -draftmode $(TARGET).tex
+       pdflatex -halt-on-error $(TARGET).tex
+       open $(TARGET).pdf
+
+clean: 
+       rm -f ${TARGET}.{dvi,ps,pdf,toc,log,aux,out,nav,snm}

Property changes on: /u/astrid-r1b/morlighe/issmuci/trunk-jpl/../trunk-jpl/externalpackages/android/doc/Makefile
___________________________________________________________________
Added: svn:executable
## -0,0 +1 ##
+*