Merge pull request #48 from carlos-encs/master

Juyterlabs venv - added to the manual

doc/scheduler-scripting.tex

@@ -759,6 +759,61 @@ \subsubsection{Jupyter Labs in Conda and Pytorch}
 \end{enumerate}
 \end{itemize}
 
+% ------------------------------------------------------------------------------
+\subsubsection{Jupyter Labs + Pytorch in Python venv}
+\label{sect:jupiterlabs-venv}
+
+This is an example of Jupyter Labs running in a Python Virtual environment (venv), with Pytorch
+
+\begin{itemize}
+\item
+Environment preparation: for the FIRST time:
+\begin{enumerate}
+\item
+Go to your speed-scratch directory: \texttt{cd /speed-scratch/\$USER}
+\item
+Open an Interactive session: \texttt{salloc --mem=50G --gpus=1 --constraint=el9}
+\item
+Create Python venv and install jupyterlab+pytorch
+\scriptsize
+\begin{verbatim}
+module load python/3.11.5/default
+setenv TMPDIR /speed-scratch/$USER/tmp
+setenv TMP /speed-scratch/$USER/tmp
+setenv PIP_CACHE_DIR /speed-scratch/$USER/tmp/cache
+python -m venv /speed-scratch/$USER/tmp/jupyter-venv
+source /speed-scratch/$USER/tmp/jupyter-venv/bin/activate.csh
+pip install jupyterlab
+pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
+exit
+\end{verbatim}
+\normalsize
+\end{enumerate}
+\item
+Running Jupyter Labs, from \textbf{speed-submit}:
+\begin{enumerate}
+\item
+Open an Interactive session: \texttt{salloc --mem=50G --gpus=1 --constraint=el9} 
+\scriptsize
+\begin{verbatim}
+cd /speed-scratch/$USER
+module load python/3.11.5/default
+setenv PIP_CACHE_DIR /speed-scratch/$USER/tmp/cache
+source /speed-scratch/$USER/tmp/jupyter-venv/bin/activate.csh
+jupyter lab --no-browser --notebook-dir=$PWD --ip="0.0.0.0" --port=8888 --port-retries=50
+\end{verbatim}
+\normalsize
+\item
+Verify which port the system has assigned to Jupyter: 
+\texttt{http://localhost:XXXX/lab?token=}
+\item
+SSH Tunnel creation: similar to Jupyter in Singularity, see \xs{sect:jupyter}
+\item
+Open a browser and type: \texttt {localhost:XXXX} (port assigned)
+\end{enumerate}
+\end{itemize}
+
+
 % ------------------------------------------------------------------------------
 \subsubsection{VScode}
 \label{sect:vscode}