The NVIDIA container image of TensorFlow, release 23.02, is available onNGC.

Contents of the TensorFlow container

This container image includes the complete source of the NVIDIA version of TensorFlow in/opt/tensorflow. It is prebuilt and installed as a system Python module.

To achieve optimum TensorFlow performance for image-based training, the container includes a sample script that demonstrates the efficient training of convolutional neural networks (CNNs). The sample script might need to be modified to fit your application.

The container also includes the following:

• Ubuntu 20.04
  Note:

  The23.02-tf1-py3 and23.02-tf2-py3 container images containPython 3.8.

• NVIDIA CUDA® 12.0.1
• NVIDIA cuBLAS from CUDA 12.0.1
• cuTENSOR 1.6.2.3
• NVIDIA cuDNN 8.7.0
• NVIDIA NCCL 2.16.5
• NVIDIA DALI® 1.22.0
• NVIDIA RAPIDS™ 22.12.0
• Horovod0.26.1
• OpenMPI 4.1.4+
• OpenUCX 1.14.0
• SHARP 3.0.2
• GDRCopy 2.3
• NVIDIA HPC-X 2.13
• TensorBoard
  • 23.02-tf1-py3 includes version1.15.5
  • 23.02-tf2-py3 includes version2.11.0
• rdma-core 36.0
• NVIDIA TensorRT™ 8.5.3
• TensorFlow-TensorRT (TF-TRT)
• Nsight Compute 2022.4.1.6
• Nsight Systems 2022.5.1.93
• JupyterLab 2.3.2 includingJupyter-TensorBoard
• XLA-Lite (TensorFlow2 only)

Driver Requirements

Release 23.02 is based onCUDA 12.0.1, which requiresNVIDIA Driver release 525 or later. However, if you are running on a data center GPU (for example, T4 or any other data center GPU), you can use NVIDIA driver release 450.51 (or later R450), 470.57 (or later R470), 510.47 (or later R510), 515.65 (or later R515), or 525.85 (or later R525). The CUDA driver's compatibility package only supports particular drivers. Thus, users should upgrade from all R418, R440, R460, and R520 drivers, which are not forward-compatible with CUDA 12.0. For a complete list of supported drivers, see theCUDA Application Compatibility topic. For more information, seeCUDA Compatibility and Upgrades.

GPU Requirements

Release 23.02 supports CUDA compute capability 6.0 and later. This corresponds to GPUs in the NVIDIA Pascal, NVIDIA Volta™, NVIDIA Turing™, NVIDIA Ampere architecture, and NVIDIA Hopper™ architecture families. For a list of GPUs to which this compute capability corresponds, seeCUDA GPUs. For additional support details, seeDeep Learning Frameworks Support Matrix.

Key Features and Enhancements

This TensorFlow release includes the following key features and enhancements.

• TensorFlow container images version 23.02 are based on TensorFlow1.15.5 and2.11.0.

Announcements

• Starting with the 22.05 release, the TensorFlow 1 and 2 containers are available for the Arm SBSA platform.

  For example, pulling the Docker imagenvcr.io/nvidia/tensorflow:22.05-tf2-py3 Docker image on an Arm SBSA machine will automatically fetch the Arm-specific image.

• Support for Slurm PMI2 has been removed from the 22.01 release.

  PMIX is supported by the container, but is not supported by default in Slurm. Users who depend on Slurm integration might need to configure Slurm for PMIX in the base OS as appropriate to their OS distribution (for Ubuntu 20.04, the required package isslurm-wlm-basic-plugins).

NVIDIA TensorFlow Container Versions

The following table shows what versions of Ubuntu, CUDA, TensorFlow, and TensorRT are supported in each of the NVIDIA containers for TensorFlow. For older container versions, refer to theFrameworks Support Matrix.

Tensor Core Examples

Thetensor core examples provided in GitHub focus on achieving the best performance and convergence by using the latestdeep learning example networks andmodel scripts for training.

Each example model trains with mixed precision Tensor Cores on NVIDIA Volta, therefore you can get results much faster than training without Tensor Cores. This model is tested against each NGC monthly container release to ensure consistent accuracy and performance over time.

• U-Net Medical model: This model is a convolutional neural network for 2D image segmentation.

  This repository contains a U-Net implementation as described in theU-Net: Convolutional Networks for Biomedical Image Segmentation paper, without any alteration.

  This model script is available onGitHub andNGC.

• SSD320 v1.2 model: This model is based on theSSD: Single Shot MultiBox Detector paper, which describes an SSD asa method for detecting objects in images using a single deep neural network.

  Our implementation is based on the existingmodel from the TensorFlow models repository.

  This model script is available onGitHub andNGC.

• Neural Collaborative Filtering (NCF) model: This model is a neural network that provides collaborative filtering based on implicit feedback, specifically, it provides product recommendations based on user and item interactions.

  The training data for this model should contain a sequence of user ID, item ID pairs indicating that the specified user has interacted with, for example, was given a rating to or clicked on, the specified item.

  This model script is available onGitHub andNGC.

• BERT model: Bidirectional Encoder Representations from Transformers (BERT) is a new method of pre-training language representations which obtains state-of-the-art results on a wide array of Natural Language Processing (NLP) tasks.

  This model is based onBERT: Pre-training of Deep Bidirectional Transformers for Language Understanding paper. BERT is an optimized version ofGoogle's official implementation, which leverages mixed-precision arithmetic and Tensor Cores on V100 GPUs for faster training times and maintains target accuracy.

  This model script is available onGitHub andNGC.

• U-Net Industrial Defect Segmentation model: This model is adapted from the original version of theU-Net model, which is a convolutional auto-encoder for 2D image segmentation.

  U-Net was first introduced by Olaf Ronneberger, Philip Fischer, and Thomas Brox in theU-Net: Convolutional Networks for Biomedical Image Segmentation paper. This work proposes a modified version of U-Net, called TinyUNet, which performs efficiently and with high accuracy on the industrial anomaly datasetDAGM2007.

  This model script is available onGitHub andNGC.

• GNMT v2 model: This model is similar to the one discussed in theGoogle's Neural Machine Translation System: Bridging the Gap between Human and Machine Translation paper.

  The most important difference between the two models is in the attention mechanism. In our model, the output from the first LSTM layer of the decoder goes into the attention module, then the reweighted context is concatenated with inputs to all subsequent LSTM layers in the decoder at the current timestep.

  This model script is available onGitHub andNGC.

• ResNet-50 v1.5 model: This model is a modified version of the original ResNet-50 v1 model.

  The difference between v1 and v1.5 is in the bottleneck blocks that require downsampling. For example, v1 hasstride = 2 in the first 1x1 convolution, andv1.5 has stride = 2 in the 3x3 convolution. The following features were implemented in this model:

  • Data-parallel multi-GPU training with Horovod
  • Tensor Cores (mixed precision) training
  • Static loss scaling for Tensor Cores (mixed precision) training

  This model script is available onGitHub andNGC.

Known Issues

• The default set of Keras optimizers are not currently compatible with Horovod, see github issues[1],[2]. Using the old optimizers (available now under tf.keras.optimizers.legacy) resolves the errors.
• Some DLRM models may regress by 10-40%. We are currently investigating.
• A known performance regression of up to 50% affects some efficientnet models. The regression is inherited from upstream tensorflow and is still under investigation. It will be fixed in a subsequent release.
• The TF-TRT native segment fallback has a known issue that causes a crash.

  This issue occurs when you use TF-TRT to convert a model with a subgraph that is then converted to TensorRT, but the conversion fails to build. Instead of falling back to native TensorFlow, TF-TRT will crash.

  To prevent the conversion of an OP that causes a native segment fallback, useexport TF_TRT_OP_DENYLIST="ProblematicOp".

• A knownissue affectsaarch64 libgomp, which might sometimes causecannot allocate memory in static TLS block errors.

  The workaround is to run the following command:

  Copy

  Copied!

  export LD_PRELOAD=/usr/lib/aarch64-linux-gnu/libgomp.so.1

• IO-dominated CNN models, such as AlexNet and ResNet50 see a ~10% performance reduction on some platforms. The regression is under investigation and will be fixed in a future release.
• In some configurations, the UNet3D model on A100 fails to initialize CUDNN due to an OOM. This can be fixed by increasing the GPU memory carveout with the environment variableTF_DEVICE_MIN_SYS_MEMORY_IN_MB=2000.
• There is a known performance regression in XLA that can cause performance regressions of up to 55% when training certain models such as EfficientNet with XLA enabled. The root cause is under investigation and will be fixed in a future release.
• On H100 NVLink systems using 2 GPUs for training, certain communication patterns can trigger a corner-case bug that manifests either as a hang or as an "illegal instruction" exception. A workaround for this case is to set the environment variableNCCL_PROTO=^LL128. This issue will be addressed in an upcoming release.
• Within the TF1 container on T4 GPUs, the MaskRCNN model may fail with either the low accuracy or illegal memory access. The root cause is under investigation and will be fixed in a future release.