在 Ubuntu 22.04 上安装 Docker 是一个相对简单的过程。以下是步骤：

### 1. 更新系统包

首先，确保系统包信息是最新的：

```bash
sudo apt update
sudo apt upgrade -y
```



### 2. 安装依赖包

在安装 Docker 之前，需要一些依赖包：

```bash
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
```

### 3. 添加 Docker 的官方 GPG 密钥

为了确保下载软件包的安全性，我们需要添加 Docker 的官方 GPG 密钥：

```bash
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
```

### 4. 添加 Docker 的 APT 源

将 Docker 的 APT 源添加到你的系统中：

```bash
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

### 5. 更新包索引

添加 Docker 的软件源之后，需要更新 APT 包索引：

```bash
sudo apt update
```

### 6. 安装 Docker 引擎

现在可以安装 Docker 引擎了：

```bash
sudo apt install -y docker-ce docker-ce-cli containerd.io
```

### 7. 启动并启用 Docker

安装完成后，启动 Docker 并设置开机自启：

```bash
sudo systemctl start docker
sudo systemctl enable docker
```

### 8. 验证安装

运行以下命令查看 Docker 的版本，并确保 Docker 报告了其版本信息：

```bash
docker --version
```

还可以运行一个简单的测试容器，确保 Docker 工作正常：

```bash
sudo docker run hello-world
```

### 9. （可选）将当前用户加入 `docker` 组

为了不在每次运行 Docker 命令时都使用 `sudo`，可以将当前用户加入 `docker` 组：

```bash
sudo usermod -aG docker $USER
```

然后，重新登录或重新启动系统以使更改生效。

现在，你已经在 Ubuntu 22.04 上成功安装了 Docker！

Ubuntu22 安装Docker

本文作为这篇文章的总结：

https://mp.weixin.qq.com/s/-rXYgsu_1IEpjGvSQArPJQ



### 深入解析FlashAttention的核心原理与优化策略

#### **FlashAttention的核心价值**
- **问题背景**：Transformer的Attention模块存在计算效率瓶颈，传统优化方法（如稀疏近似）虽减少计算量（FLOPs），但未解决关键I/O瓶颈。
- **三大优势**：
  1. **I/O感知的高效计算**：通过优化内存访问模式（减少HBM访问次数）而非仅减少FLOPs提速。
  2. **内存高效**：分块计算（Tiling）避免存储中间矩阵（如QK^T），显著降低内存占用。
  3. **精确计算**：结果与原始Attention完全一致，避免近似算法的误差。

---

#### **数学原理：从Softmax到FlashAttention**

1. **安全Softmax**：通过减去最大值防止数值溢出，但需三次遍历数据。

    Softmax的原始公式：
    $$
    s_i=\frac{e^{x_i}}{\sum_{j=1}^N e^{x_j}}
    $$
    安全Softmax：
    $$
    S_i=\frac{\frac{e^{x_i}}{e^{m_N}}}{\sum_{j=1}^K\left(\frac{e^{x_j}}{e^{m_N}}\right)}=\frac{e^{x_i-m_N}}{\sum_{j=1}^K\left(e^{x_j-m_N}\right)}
    $$
2. **Online Softmax**（Nvidia提出）：
   - **递归思想**：逐元素计算局部最大值和归一化因子，将三次遍历降为两次。
3. **FlashAttention的突破**：
   - **融合计算**：将Softmax与Value矩阵乘法结合，通过分块迭代公式实现单次遍历。
   - **避免中间存储**：直接计算Attention结果，无需保存QK^T和Softmax矩阵。

---

#### **硬件视角：为什么需要FlashAttention？**
- **GPU/NPU内存瓶颈**：
  - **HBM**：容量大（40GB）但带宽低（1.5TB/s）。
  - **SRAM**：带宽高（19TB/s）但容量小（20MB）。
- **计算膨胀系数β**：矩阵乘法（β=O(d)）易受计算带宽限制，Softmax（β≈3）受内存带宽限制。
- **分块策略**：将大矩阵拆分为小块，在SRAM中完成计算，减少HBM交互次数。

---

#### **算法演进：FA-1到FA-3的核心优化**
1. **FA-1**（基础版本）：
   - **外循环分块**：按Q的行分块，内循环加载K/V块，逐块计算Softmax并累加结果。
   - **避免中间矩阵**：融合Softmax与矩阵乘，仅保存最终Attention结果。
2. **FA-2**：
   - **循环结构调整**：将Q作为外循环，K/V为内循环，减少数据重复加载。
   - **计算式优化**：调整Softmax迭代公式，减少除法操作（式4-12），最后统一归一化。
3. **FA-3**（硬件级优化）：
   - **异步计算**：利用H100的Tensor Core异步执行GEMM与Softmax。
   - **低精度加速**：支持FP8计算，提升吞吐量。

---

#### **面试常见问题**
1. **FlashAttention为何比传统Attention快？**
   - 关键在减少HBM访问次数，通过分块计算和融合Softmax与矩阵乘，避免存储中间矩阵。

2. **如何保证计算精确性？**
   - 采用安全Softmax的数学变形，通过局部归一化因子递归计算，结果与原始算法一致。

3. **FA-2相比FA-1改进点？**
   - 外循环调整为Q分块，减少数据加载；优化Softmax迭代公式，减少非矩阵运算。

4. **分块大小如何选择？**
   - 受SRAM容量限制，需确保每个块的计算在SRAM内完成，典型配置为块大小≤128x128。


![image.png](/static/img/a63f18baaa685381e6a9e5e1f5516edf.image.webp)

---

#### **总结**
FlashAttention通过**分块计算**与**迭代式Softmax**的巧妙结合，在保证计算精度的同时，大幅降低内存访问开销，成为大模型训练的关键优化。其设计思想揭示了AI计算中“内存效率优先于计算量”的核心原则，为后续硬件感知算法提供了范本。

FlashAttention 透彻理解

https://www.modelscope.cn/models/iic/cv_ddcolor_image-colorization/summary#ddcolor-%E5%9B%BE%E5%83%8F%E4%B8%8A%E8%89%B2%E6%A8%A1%E5%9E%8B



## 下载模型


```
pip install modelscope


modelscope download --model 'iic/cv_ddcolor_image-colorization' --local_dir './DDColormodel'

```

## 推理
pytroch环境：

```
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia -y

pip install addict modelscope datasets sympy==1.13.1 simplejson sortedcontainers timm
```
推理：
```python
import cv2
from modelscope.outputs import OutputKeys
from modelscope.pipelines import pipeline
from modelscope.utils.constant import Tasks

img_colorization = pipeline(Tasks.image_colorization, 
                       model='./DDColormodel')
img_path = 'https://modelscope.oss-cn-beijing.aliyuncs.com/test/images/audrey_hepburn.jpg'
result = img_colorization(img_path)
cv2.imwrite('result.png', result[OutputKeys.OUTPUT_IMG])
```

原图：

![audrey_hepburn.jpg](/static/img/c6024d7a0f0ab002e4133224881120af.audrey_hepburn.webp)


![result.png](/static/img/fda6112455c6e6e6ccc94914c2f612d8.result.webp)

## docker环境

```
docker run --gpus all --shm-size=32g -it --net host -v ./:/ddcolor kevinchina/deeplearning:2.5.1-cuda12.1-cudnn9-devel-pix2pix bash

pip install addict modelscope datasets sympy==1.13.1 simplejson sortedcontainers timm opencv-python

apt-get update
apt-get install -y libgl1-mesa-glx libjpeg-dev libpng-dev libtiff-dev libopencv-dev

docker commit 731cbf160933 kevinchina/deeplearning:2.5.1-cuda12.1-cudnn9-devel-ddcolor

docker push kevinchina/deeplearning:2.5.1-cuda12.1-cudnn9-devel-ddcolor
```

DDColor 效果实战

![image.png](/static/img/1b321dd10474f3d3e9bff1081cc767f5.image.webp)

随着深度学习的兴起，自动上色引起了很多关注，目标是在复杂的图像语义（如形状、纹理和上下文）中生成合适的颜色。一些早期方法尝试使用卷积神经网络（CNN）预测每个像素的颜色分布。不幸的是，这些基于CNN的方法由于缺乏对图像语义的全面理解，通常会产生不正确或不饱和的上色结果（图1中的CIC、InstColor和DeOldify）。为了更好地理解语义信息，一些方法借助生成对抗网络（GANs），利用它们丰富的表示作为上色的生成先验。然而，由于GAN先验的表示空间有限，它们无法处理具有复杂结构和语义的图像，导致不合适的上色结果或不愉快的伪影（图1中的Wu等和BigColor）。



随着自然语言处理（NLP）的巨大成功，Transformer已经扩展到许多计算机视觉任务。最近，一些工作将Transformer的非局部注意力机制引入图像上色。尽管取得了令人满意的结果，这些方法要么训练了几个独立的子网，导致累积误差（图1中的ColTran），要么在单尺度图像特征图上执行颜色注意操作，在处理复杂图像上下文时会导致明显的颜色晕染（图1中的CT2和ColorFormer）。此外，这些方法通常依赖于手工制作的数据集级别的经验分布先验，如[45]中的颜色掩码和[47]中的语义-颜色映射，这些都是繁琐且难以推广的。

在本文中，我们提出了一种新颖的上色方法，即DDColor，旨在实现语义合理且视觉生动的上色。我们的方法利用了一个编码器-解码器结构，其中编码器提取图像特征，双解码器恢复空间分辨率。与先前方法采用额外网络或手工计算的先验来优化颜色概率不同，我们的方法使用基于查询的Transformer作为颜色解码器，以端到端的方式学习语义感知的颜色查询。通过使用多尺度图像特征进行颜色查询学习，我们的方法显着减轻了颜色晕染，并显着改善了复杂上下文和小物体的着色（见图1）。此外，我们提出了一种新的色彩度损失，以提高生成结果的颜色丰富度。

我们的主要贡献总结如下：

- 我们提出了一种带有双解码器的端到端网络，用于自动图像上色，确保了生动且语义一致的结果。
- 我们的方法包括一种新颖的颜色解码器，从视觉特征中学习颜色查询而无需依赖手工制作的先验。此外，我们的像素解码器提供多尺度语义表示来指导颜色查询的优化，有效减少了颜色晕染效应。
- 综合实验表明，我们的方法在与基线相比实现了最先进的性能，并表现出良好的泛化能力。


![image.png](/static/img/f3379daf7f584a6f6a95ece7762f96db.image.webp)

## 3. 方法

### 3.1 概述

给定一个灰度输入图像 $x_L \in \mathbb{R}^{H \times W \times 1}$，我们的上色网络预测缺失的两个颜色通道 $\hat{y}_{AB} \in \mathbb{R}^{H \times W \times 2}$，其中 $L, AB$ 通道分别表示在 CIELAB 色彩空间中的明度和色度。网络采用编码器-解码器框架，如图2（a）所示。

我们利用一个backbone network作为编码器，从灰度图像中提取高级语义信息。backbone network旨在提取图像语义嵌入，这是上色视频化的关键。在本研究中，我们选择ConvNeXt [29]，这是用于图像分类的最前沿模型。以 $x_L$ 作为输入，backbone network 输出4个分辨率为 $\frac{H}{4} \times \frac{W}{4}$、$\frac{H}{8} \times \frac{W}{8}$、$\frac{H}{16} \times \frac{W}{16}$ 和 $\frac{H}{32} \times \frac{W}{32}$ 的中间特征图。前三个特征图通过快捷连接传递到pixel decoder，而最后的特征图作为pixel decoder的输入。至于backbone network的结构，有几种选择，比如 ResNet[17]、Swin-Transformer[28] 等，只要网络能够生成分层表示。

我们的框架的解码器部分由像素解码器和色彩解码器组成。像素解码器使用一系列堆叠的上采样层来恢复图像特征的空间分辨率。每个上采样层与编码器的相应阶段有快捷连接。色彩解码器利用多尺度图像特征逐渐优化基于语义的颜色查询。最后，由两个解码器生成的图像和颜色特征融合生成彩色输出。

在接下来的部分中，我们将详细描述这些模块以及用于上色视频化的损失函数。

### 3.2 双重解码器

#### 3.2.1 像素解码器

像素解码器由四个阶段组成，逐步扩大图像分辨率。每个阶段包括一个上采样层和一个快捷层。具体来说，不同于以前的方法使用反卷积 [34] 或插值 [30]，我们采用 PixelShuffle [37] 作为上采样层。该层将形状为 $(h_p, w_p, \frac{c_p}{2})$ 的低分辨率特征图重新排列为形状为 $(h, w, c)$ 的高分辨率特征图。快捷层使用卷积通过快捷连接整合来自编码器相应阶段的特征。

我们的方法通过逐步上采样过程捕获了完整的图像特征金字塔，这超出了某些基于transformer方法的能力 [24, 45]。这些多尺度特征进一步用作色彩解码器的输入，以指导颜色查询的优化。像素解码器的最终输出是图像嵌入 $E_i \in \mathbb{R}^{C \times H \times W}$，其空间分辨率与输入图像相同。

#### 3.2.2 色彩解码器

许多现有的上色视频化方法依赖于额外的先验来实现生动的结果。例如，一些方法 [46, 13] 利用来自预训练的GAN的生成先验，而其他方法使用经验分布统计 [45] 或训练集的预构建语义-颜色对 [47]。然而，这些方法需要大量的预构建工作，并且在各种场景中可能具有有限的适用性。为了减少对手动设计先验的依赖，我们提出了一种新颖的基于查询的色彩解码器。

**色彩解码器块**。色彩解码器由一堆块组成，每个块接收视觉特征和颜色查询作为输入。色彩解码器块（CDB）基于修改过的transformer解码器设计，如图2（b）所示。

为了基于视觉语义信息学习一组自适应颜色查询，我们创建可学习的色彩嵌入记忆，以存储颜色表示序列：
$$
Z_0 = [Z^1_0, Z^2_0, \dots, Z^K_0] \in \mathbb{R}^{K \times C}
$$
这些颜色嵌入在训练阶段初始化为零，并在第一个CDB中用作颜色查询。我们首先通过cross-attention层建立语义表示与颜色嵌入之间的关联：
$$
Z^{\prime}_l = \text{softmax}(Q_l K^T_l)V_l + Z_{l-1},
$$
其中 $l$ 是层索引，$Z_l \in \mathbb{R}^{K \times C}$ 是第 $l$ 层的 $K$ 维颜色嵌入。$Q_l = f_Q(Z_{l-1}) \in \mathbb{R}^{K \times C}$，$K_l, V_l \in \mathbb{R}^{H_l \times W_l \times C}$ 是图像特征，它们经过 $f_K(\cdot)$ 和 $f_V(\cdot)$ 变换，分别表示。$H_l$ 和 $W_l$ 是图像特征的空间分辨率，$f_Q$, $f_K$, 和 $f_V$ 是线性变换。

通过上述cross-attention操作，颜色嵌入表示由图像特征丰富。然后，我们利用标准transformer层来变换颜色嵌入，如下：
$$
Z^{\prime\prime}_l = \text{MSA}(\text{LN}(Z^{\prime}_l)) + Z^{\prime}_l,
$$
$$
Z^{\prime\prime\prime}_l = \text{MLP}(\text{LN}(Z^{\prime\prime}_l)) + Z^{\prime\prime}_l,
$$
$$
Z_l = \text{LN}(Z^{\prime\prime\prime}_l),
$$
其中 $\text{MSA}(\cdot)$ 表示multi-head self-attention [42]，$\text{MLP}(\cdot)$ 表示前馈网络，$\text{LN}(\cdot)$ 是层归一化 [3]。值得注意的是，在所提出的CDB中，cross-attention在self-attention之前进行。这是因为在应用第一个self-attention层之前，颜色查询是零初始值且语义上独立。

**扩展到多尺度**。以前基于transformer的上色视频化方法通常在单一尺度图像特征图上执行颜色关注，未能充分捕捉低级语义线索，在处理复杂背景时可能导致颜色渗出。相反，多尺度特征已在许多计算机视觉任务中广泛探索，如物体检测 [26] 和实例分割 [16]。这些特征也可以提升上色的性能（详见Sec 4.3中的对比实验）。

为了平衡计算复杂度和表示能力，我们选择了三种不同尺度的图像特征。具体来说，我们使用pixel decoder生成的中间视觉特征，在色彩解码器中使用1/16、1/8和1/4的下采样率。我们将每组的3个CDB分组，在每组中，多尺度特征按顺序输入到CDB中。我们以轮转方式重复此组M次。总共，色彩解码器由3M个CDB组成。我们可以将色彩解码器公式化如下：
$$
E_c = \text{ColorDecoder}(Z_0, F_1, F_2, F_3),
$$
其中 $F_1, F_2$ 和 $F_3$ 是三种不同尺度的视觉特征。

在色彩解码器中使用多尺度特征可以建模颜色查询与视觉嵌入之间的关系，使得颜色嵌入$E_c \in \mathbb{R}^{K \times C}$对语义信息更敏感，进一步实现更准确的语义边界识别和减少颜色渗出。

### 3.3 融合模块

融合模块是一个轻量级模块，通过结合像素解码器和色彩解码器的输出生成彩色结果。如图2所示，融合模块的输入为每像素图像嵌入 $E_i \in \mathbb{R}^{C \times H \times W}$，其中 $C$ 是嵌入维度，以及来自色彩解码器的语义感知颜色嵌入 $E_c \in \mathbb{R}^{K \times C}$，其中 $K$ 是颜色查询的数量。

融合模块将这两个嵌入聚合形成增强的特征 $\hat{F} \in \mathbb{R}^{K \times H \times W}$，使用一个简单的点积。然后应用一个 $1 \times 1$ 卷积层生成最终输出 $\hat{y}_{AB} \in \mathbb{R}^{2 \times H \times W}$，其表示AB颜色通道：
$$
\hat{F} = E_c \cdot E_i,
$$
$$
\hat{y}_{AB} = \text{Conv}(\hat{F}).
$$
最后，通过将输出 $\hat{y}_{AB}$ 与灰度输入 $x_L$ 拼接，获得上色结果 $\hat{y}$。

### 3.4 目标

在训练阶段，采用以下四种损失：

**像素损失**。像素损失 $L_{\text{pix}}$ 是上色图像 $\hat{y}$ 和真实图像 $y$ 之间的L1距离，提供像素级监督并鼓励生成类似于真实图像的输出。

**感知损失**。为了确保生成的图像 $\hat{y}$ 在语义上合理，我们使用感知损失 $L_{\text{per}}$ 来最小化它与真实图像 $y$ 之间的语义差异。这是通过使用预训练的 VGG16 [38] 从两个图像中提取特征来实现的。

**对抗损失**。添加一个 PatchGAN [23] 判别器来区分预测结果和真实图像，促使生成器生成无法区分的图像。令 $L_{\text{adv}}$ 表示对抗损失。

**色彩丰富度损失**。我们引入了一种新的色彩丰富度损失 $L_{\text{col}}$ ，其灵感来源于色彩丰富度分数 [15]。该损失鼓励模型生成更加丰富和视觉愉悦的图像。公式如下：
$$
L_{\text{col}} = 1 - [\sigma_{\text{rgyb}} (\hat{y}) + 0.3 \cdot \mu_{\text{rgyb}} (\hat{y})]/100,
$$
其中 $\sigma_{\text{rgyb}} (\cdot)$ 和 $\mu_{\text{rgyb}} (\cdot)$ 分别表示颜色平面中像素云的标准差和均值，如 [15] 中所述。

生成器的全目标公式如下：
$$
L_{\theta} = \lambda_{\text{pix}} L_{\text{pix}} + \lambda_{\text{per}} L_{\text{per}} + \lambda_{\text{adv}} L_{\text{adv}} + \lambda_{\text{col}} L_{\text{col}},
$$
其中 $\lambda_{\text{pix}}, \lambda_{\text{per}}, \lambda_{\text{adv}}$ 和 $\lambda_{\text{col}}$ 是不同项的平衡权重。

DDColor 通用场景黑白图片上色 论文点

前两次的训练都不满意，用mmgen库做通用和线稿的，效果看起来都不好，我怀疑是不是mmgen不行。

我重新找了一个仓库来做这个事情。



## 仓库

```
git@github.com:junyanz/pytorch-CycleGAN-and-pix2pix.git
```

## 环境

```
docker run --gpus all --shm-size=32g -it --net host \
-v ./pytorch-CycleGAN-and-pix2pix/:/pytorch-CycleGAN-and-pix2pix/ \
-v ./anime-sketch-colorization-pair/data:/data \
pytorch/pytorch:2.5.1-cuda12.1-cudnn9-devel bash

pip install -r requirements.txt
```
已经保存为这个镜像：

```
kevinchina/deeplearning:2.5.1-cuda12.1-cudnn9-devel-pix2pix
```

可以直接使用此环境：
```
docker run --gpus all --shm-size=32g -it --net host \
-v ./pytorch-CycleGAN-and-pix2pix/:/pytorch-CycleGAN-and-pix2pix/ \
-v ./anime-sketch-colorization-pair/data:/data \
kevinchina/deeplearning:2.5.1-cuda12.1-cudnn9-devel-pix2pix bash
```

## 训练

先启动一个visdom服务器：

```
python -m visdom.server -p 8097
```

要么这么开始训练：

```
python train.py --dataroot /data/ --name anime --gpu_ids 0,1,2,3 --model pix2pix --direction BtoA --batch_size 192 --lr_policy cosine --num_threads 32 --init_type xavier --norm instance --netG unet_256 
```

或者用visdom服务器训练：
```
-display_server http://remote_ip --display_port 8097
```

浏览器访问8097的服务就可以看到训练效果：

![image.png](/static/img/b2c0b87baed3e8d6830533fff36432c2.image.webp)

200轮的训练，看起来还是没那么优秀：


![image.png](/static/img/eecec56cf99c304d7d8785d7b802d02b.image.webp)

## 上色模型

仔细阅读一些相关信息，才发现之前黑白图转色彩图可以这么训练，输入单通道黑白图，输出为LAB空间图的AB通道。

这么开始训练：

```
docker run --gpus all --shm-size=32g -it --net host \
-v ./pytorch-CycleGAN-and-pix2pix/:/pytorch-CycleGAN-and-pix2pix/ \
-v ./unpaired_self_datasets/:/data \
kevinchina/deeplearning:2.5.1-cuda12.1-cudnn9-devel-pix2pix bash

nohup python -m visdom.server -p 8097 &

pip install -U scikit-image

python train.py --dataroot /data/ --name tongyong_l2ab --gpu_ids 0,1,2,3 --model colorization --direction AtoB --batch_size 192 --lr_policy cosine --num_threads 32 --init_type xavier --norm instance --netG unet_256 --dataset_mode colorization --input_nc 1 --output_nc 2 --phase trainA

```

还是不错的：


![image.png](/static/img/e0ee6e095bbb41f82f83f6180527b291.image.webp)

pix2pix pytorch 线稿上色，模型训练实战，Docker【3】

我是一个专注技术分享的博主,尤其爱搞深度学习和单片机电子。你现在看到的是我的个人博客网站。