View source for AI and Machine Learning

<languages />
[[Category:AI and Machine Learning]]
<translate>
<!--T:1-->
To get the most out of our clusters for machine learning applications, special care must be taken. A cluster is a complicated beast that is very different from your local machine that you use for prototyping. Notably, a cluster uses a distributed filesystem, linking many storage devices seamlessly. Accessing a file on <code>/project</code> may <i>feel the same</i> as accessing one from the current node, but under the hood, these two IO operations have very different performance implications. In short, you need to [[#Managing_your_datasets|choose wisely where to put your data]].

<!--T:2-->
The sections below list links relevant to AI practitioners, and good practices to be observed on our clusters.

== Tutorials == <!--T:25-->

<!--T:42-->
A self-paced course on this topic is available from SHARCNET: [https://training.sharcnet.ca/courses/enrol/index.php?id=180 Introduction to Machine Learning].

<!--T:26-->
If you are ready to port your program for using on one of our clusters, please take [[Tutoriel_Apprentissage_machine/en|our tutorial]].

<!--T:36-->
A user-made tutorial showing all the steps necessary for setting up your local and Alliance environments for deep learning in Python is available [https://prashp.gitlab.io/post/compute-canada-tut/ here].

== Python == <!--T:3-->

<!--T:4-->
Python is very popular in the field of machine learning. If you (plan to) use it on our clusters, please refer to [[Python|our documentation about Python]] to get important information about Python versions, virtual environments on login or on compute nodes, <code>multiprocessing</code>, Anaconda, Jupyter, etc.

=== Avoid Anaconda === <!--T:21-->

<!--T:22-->
We ask our users to avoid using Anaconda, and use virtualenv instead. Reasons are explained on the [[Anaconda/en|Anaconda]] page.

<!--T:24-->
<b>Switching to virtualenv is easy in most cases. Just install all the same packages, except CUDA, CuDNN and other low-level libraries, which are already installed on our clusters.</b>

== Useful information about software packages == <!--T:5-->

<!--T:6-->
Please refer to the page of your machine learning package of choice for useful information about how to install, common pitfalls, etc.:

<!--T:7-->
* [[TensorFlow]]
* [[PyTorch]]
* [[Keras]]
* [[Torch]]
* [[SpaCy]]
* [[XGBoost]]
* [[Large_Scale_Machine_Learning_(Big_Data)#Scikit-Learn|Scikit-Learn]]
* [[Large_Scale_Machine_Learning_(Big_Data)#Snap_ML|SnapML]]

== Managing your datasets == <!--T:8-->

=== Storage and file management === <!--T:9-->

<!--T:10-->
Our clusters have a wide range of storage options to cover the needs of our very diverse users. These storage solutions range from high-speed temporary local storage to different kinds of long-term storage, so you can choose the storage medium that best corresponds to your needs and usage patterns. Please refer to our documentation on [[Storage and file management]].

===Choosing the right storage type for your dataset=== <!--T:34-->

<!--T:35-->
* If your dataset is around 10 GB or less, it can probably fit in the memory, depending on how much memory your job has. You should not read data from disk during your machine learning tasks.
* If your dataset is around 100 GB or less, it can fit in the local storage of the compute node; please transfer it there at the beginning of the job. This storage is orders of magnitude faster and more reliable than shared storage (home, project, scratch). A temporary directory is available for each job at $SLURM_TMPDIR. An example is given in [[Tutoriel_Apprentissage_machine/en|our tutorial]]. A caveat of local node storage is that a job from another user might be using it fully, leaving you no space (we are currently studying this problem). However, you might also get lucky and have a whole terabyte at your disposal.
* If your dataset is larger, you may have to leave it in the shared storage. You can leave your datasets permanently in your project space. Scratch space can be faster, but it is not for permanent storage. Also, all shared storage (home, project, scratch) is for storing and reading at low frequencies (e.g. 1 large chunk every 10 seconds, rather than 10 small chunks every second).

=== Datasets containing lots of small files (e.g. image datasets) === <!--T:11-->

<!--T:12-->
In machine learning, it is common to have to manage very large collections of files, meaning hundreds of thousands or more. The individual files may be fairly small, e.g. less than a few hundred kilobytes. In these cases, problems arise:

<!--T:13-->
* filesystem [[Storage and file management#Filesystem_quotas_and_policies|quotas]] on our clusters limit the number of filesystem objects;
* your software could be significantly slowed down from streaming lots of small files from <code>/project</code> (or <code>/scratch</code>) to a compute node.

<!--T:14-->
On a distributed filesystem, data should be stored in large single-file archives. On this subject, please refer to 
[[Handling large collections of files]].

== Long running computations == <!--T:15-->

<!--T:16-->
If your computations are long, you should use checkpointing. For example, if your training time is 3 days, you should split it in 3 chunks of 24 hours. This will prevent you from losing all the work in case of an outage, and give you an edge in terms of priority (more nodes are available for short jobs). Most machine learning libraries natively support checkpointing; the typical case is covered in our [[Tutoriel_Apprentissage_machine/en#Checkpointing_a_long-running_job|tutorial]]. If your program does not natively support this, we provide a [[Points de contrôle/en|general checkpointing solution]].

<!--T:37-->
For more examples, please see 

<!--T:38-->
[[PyTorch#Creating_model_checkpoints|Checkpointing with PyTorch]]

<!--T:39-->
[[TensorFlow#Creating_model_checkpoints|Checkpointing with TensorFlow]]

== Running many similar jobs == <!--T:17-->

<!--T:18-->
If you are in one of these situations:

<!--T:19-->
* Hyperparameter search
* Training many variants of the same method
* Running many optimization processes of similar duration

<!--T:20-->
... you should consider grouping many jobs into one. [[META: A package for job farming|META]], [[GLOST]], and [[GNU Parallel]] are available to help you with this.

== Experiment tracking and hyperparameter optimization == <!--T:27-->

<!--T:28-->
[[Weights & Biases (wandb)]] and [[Comet.ml]] can help you get the most out of your compute allocation, by

<!--T:29-->
* allowing easier tracking and analysis of training runs;
* providing Bayesian hyperparameter search.

<!--T:30-->
Note that Comet and Wandb are not currently available on Graham.

== Large-scale machine learning (big data) == <!--T:40-->

<!--T:41-->
Modern deep learning packages like Pytorch and TensorFlow include utilities to handle large-scale training natively and tutorials on how to do it abound. Scaling classic machine learning (i.e., not deep learning) methods, however, is not as widely discussed and can often be a frustrating problem to solve. [[Large_Scale_Machine_Learning_(Big_Data)|This guide]] contains ideas and practical options, along with tutorials, to tackle training classic ML models on very large datasets.

== Troubleshooting == <!--T:31-->

=== Determinism with RNN using CUDA === <!--T:32-->

<!--T:33-->
RNN and multi-head attention API calls may exhibit non-deterministic behaviour when the cuDNN library is built with CUDA Toolkit 10.2 or higher. The user can eliminate the non-deterministic behaviour of cuDNN RNN and multi-head attention APIs by setting a single buffer size in the CUBLAS_WORKSPACE_CONFIG environmental variable, for example, :16:8 or :4096:2, which instructs cuBLAS to allocate eight buffers of 16 KB each in GPU memory or two buffers of 4 MB each. 

</translate>