Dockerfile.examples

# SPDX-FileCopyrightText: Copyright (c) 2025 The torch-harmonics Authors. All rights reserved.
# SPDX-License-Identifier: BSD-3-Clause
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice, this
# list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# 3. Neither the name of the copyright holder nor the names of its
# contributors may be used to endorse or promote products derived from
# this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#

# build after cloning in directoy torch_harmonics via
# docker build . -t torch_harmonics

FROM nvcr.io/nvidia/pytorch:26.04-py3

# we need this for tests
RUN pip install parameterized

# we install this for the examples
RUN pip install wandb

# cartopy
RUN pip install cartopy

# h5py
RUN pip install h5py

# natten
# Pinned to an immutable commit rather than tracking the default branch: an
# unpinned clone resolves to whatever upstream HEAD happens to be at build time,
# so two builds of the same Dockerfile can ship different code, and a compromise
# of the upstream repository would land in the image unreviewed. A commit SHA is
# used instead of the tag alone because a tag can be moved; git verifies the
# object hash on checkout, so the SHA fixes the tree exactly.
#
# This SHA is v0.21.7, which is what HEAD resolved to when the pin was added, so
# it does not change what this image builds today. Bump both values together.
ARG NATTEN_VERSION=v0.21.7
ARG NATTEN_COMMIT=39375ea1d2f3b1bb284315fa5f79f6ecbebb6382
RUN cd /opt && git clone https://github.com/SHI-Labs/NATTEN natten  && \
    cd natten && \
    git checkout ${NATTEN_COMMIT} && \
    make CUDA_ARCH="8.0;8.6;8.7;9.0a;10.0a" \
        WORKERS=4

# install torch harmonics
COPY . /workspace/torch_harmonics

# The custom CUDA extension does not suppport architerctures < 7.0
ENV TORCH_HARMONICS_BUILD_CUDA_EXTENSION=1
ENV TORCH_HARMONICS_ENABLE_OPENMP=1
ENV TORCH_CUDA_ARCH_LIST="8.0 8.6 8.7 9.0a 10.0a+PTX"
RUN cd /workspace/torch_harmonics && NVCC_THREADS=4 MAX_JOBS=8 pip install --no-deps --no-build-isolation .