diff --git a/.gitattributes b/.gitattributes index a6344aac8c09253b3b630fb776ae94478aa0275b..a616d52a71c82446cd05a19e93e4a0f8d0e33f9b 100644 --- a/.gitattributes +++ b/.gitattributes @@ -33,3 +33,9 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text *.zip filter=lfs diff=lfs merge=lfs -text *.zst filter=lfs diff=lfs merge=lfs -text *tfevents* filter=lfs diff=lfs merge=lfs -text +*.png filter=lfs diff=lfs merge=lfs -text +*.jpg filter=lfs diff=lfs merge=lfs -text +*.mp4 filter=lfs diff=lfs merge=lfs -text +*.gif filter=lfs diff=lfs merge=lfs -text +*.webp filter=lfs diff=lfs merge=lfs -text +*.params filter=lfs diff=lfs merge=lfs -text diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000000000000000000000000000000000000..cf6ae8f6dd52bd7907d7b96d551312a3192ff835 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +*/__pycache__/* +*/__pycache__/ +.ipynb_checkpoints +__pycache__ +.venv/ \ No newline at end of file diff --git a/AdaptiveWingLoss/.gitignore b/AdaptiveWingLoss/.gitignore new file mode 100644 index 0000000000000000000000000000000000000000..47bddecbbbf35bbbe62c199e32eaa2c92dad1cc7 --- /dev/null +++ b/AdaptiveWingLoss/.gitignore @@ -0,0 +1,8 @@ +# Python generated files +*.pyc + +# Project related files +ckpt/*.pth +dataset/* +!dataset/!.py +experiments/* \ No newline at end of file diff --git a/AdaptiveWingLoss/core/__init__.py b/AdaptiveWingLoss/core/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/AdaptiveWingLoss/core/coord_conv.py b/AdaptiveWingLoss/core/coord_conv.py new file mode 100644 index 0000000000000000000000000000000000000000..a56c826450ac75d30b824de5d0daa79c5094d74a --- /dev/null +++ b/AdaptiveWingLoss/core/coord_conv.py @@ -0,0 +1,153 @@ +import torch +import torch.nn as nn + + +class AddCoordsTh(nn.Module): + def __init__(self, x_dim=64, y_dim=64, with_r=False, with_boundary=False): + super(AddCoordsTh, self).__init__() + self.x_dim = x_dim + self.y_dim = y_dim + self.with_r = with_r + self.with_boundary = with_boundary + + def forward(self, input_tensor, heatmap=None): + """ + input_tensor: (batch, c, x_dim, y_dim) + """ + batch_size_tensor = input_tensor.shape[0] + + xx_ones = torch.ones([1, self.y_dim], dtype=torch.int32).cuda() + xx_ones = xx_ones.unsqueeze(-1) + + xx_range = torch.arange(self.x_dim, dtype=torch.int32).unsqueeze(0).cuda() + xx_range = xx_range.unsqueeze(1) + + xx_channel = torch.matmul(xx_ones.float(), xx_range.float()) + xx_channel = xx_channel.unsqueeze(-1) + + + yy_ones = torch.ones([1, self.x_dim], dtype=torch.int32).cuda() + yy_ones = yy_ones.unsqueeze(1) + + yy_range = torch.arange(self.y_dim, dtype=torch.int32).unsqueeze(0).cuda() + yy_range = yy_range.unsqueeze(-1) + + yy_channel = torch.matmul(yy_range.float(), yy_ones.float()) + yy_channel = yy_channel.unsqueeze(-1) + + xx_channel = xx_channel.permute(0, 3, 2, 1) + yy_channel = yy_channel.permute(0, 3, 2, 1) + + xx_channel = xx_channel / (self.x_dim - 1) + yy_channel = yy_channel / (self.y_dim - 1) + + xx_channel = xx_channel * 2 - 1 + yy_channel = yy_channel * 2 - 1 + + xx_channel = xx_channel.repeat(batch_size_tensor, 1, 1, 1) + yy_channel = yy_channel.repeat(batch_size_tensor, 1, 1, 1) + + if self.with_boundary and type(heatmap) != type(None): + boundary_channel = torch.clamp(heatmap[:, -1:, :, :], + 0.0, 1.0) + + zero_tensor = torch.zeros_like(xx_channel) + xx_boundary_channel = torch.where(boundary_channel>0.05, + xx_channel, zero_tensor) + yy_boundary_channel = torch.where(boundary_channel>0.05, + yy_channel, zero_tensor) + if self.with_boundary and type(heatmap) != type(None): + xx_boundary_channel = xx_boundary_channel.cuda() + yy_boundary_channel = yy_boundary_channel.cuda() + ret = torch.cat([input_tensor, xx_channel, yy_channel], dim=1) + + + if self.with_r: + rr = torch.sqrt(torch.pow(xx_channel, 2) + torch.pow(yy_channel, 2)) + rr = rr / torch.max(rr) + ret = torch.cat([ret, rr], dim=1) + + if self.with_boundary and type(heatmap) != type(None): + ret = torch.cat([ret, xx_boundary_channel, + yy_boundary_channel], dim=1) + return ret + + +class CoordConvTh(nn.Module): + """CoordConv layer as in the paper.""" + def __init__(self, x_dim, y_dim, with_r, with_boundary, + in_channels, first_one=False, *args, **kwargs): + super(CoordConvTh, self).__init__() + self.addcoords = AddCoordsTh(x_dim=x_dim, y_dim=y_dim, with_r=with_r, + with_boundary=with_boundary) + in_channels += 2 + if with_r: + in_channels += 1 + if with_boundary and not first_one: + in_channels += 2 + self.conv = nn.Conv2d(in_channels=in_channels, *args, **kwargs) + + def forward(self, input_tensor, heatmap=None): + ret = self.addcoords(input_tensor, heatmap) + last_channel = ret[:, -2:, :, :] + ret = self.conv(ret) + return ret, last_channel + + +''' +An alternative implementation for PyTorch with auto-infering the x-y dimensions. +''' +class AddCoords(nn.Module): + + def __init__(self, with_r=False): + super().__init__() + self.with_r = with_r + + def forward(self, input_tensor): + """ + Args: + input_tensor: shape(batch, channel, x_dim, y_dim) + """ + batch_size, _, x_dim, y_dim = input_tensor.size() + + xx_channel = torch.arange(x_dim).repeat(1, y_dim, 1) + yy_channel = torch.arange(y_dim).repeat(1, x_dim, 1).transpose(1, 2) + + xx_channel = xx_channel / (x_dim - 1) + yy_channel = yy_channel / (y_dim - 1) + + xx_channel = xx_channel * 2 - 1 + yy_channel = yy_channel * 2 - 1 + + xx_channel = xx_channel.repeat(batch_size, 1, 1, 1).transpose(2, 3) + yy_channel = yy_channel.repeat(batch_size, 1, 1, 1).transpose(2, 3) + + if input_tensor.is_cuda: + xx_channel = xx_channel.cuda() + yy_channel = yy_channel.cuda() + + ret = torch.cat([ + input_tensor, + xx_channel.type_as(input_tensor), + yy_channel.type_as(input_tensor)], dim=1) + + if self.with_r: + rr = torch.sqrt(torch.pow(xx_channel - 0.5, 2) + torch.pow(yy_channel - 0.5, 2)) + if input_tensor.is_cuda: + rr = rr.cuda() + ret = torch.cat([ret, rr], dim=1) + + return ret + + +class CoordConv(nn.Module): + + def __init__(self, in_channels, out_channels, with_r=False, **kwargs): + super().__init__() + self.addcoords = AddCoords(with_r=with_r) + self.conv = nn.Conv2d(in_channels + 2, out_channels, **kwargs) + + def forward(self, x): + ret = self.addcoords(x) + ret = self.conv(ret) + return ret diff --git a/AdaptiveWingLoss/core/dataloader.py b/AdaptiveWingLoss/core/dataloader.py new file mode 100644 index 0000000000000000000000000000000000000000..d50deda51bca3f3349bb84f676ea2a0447884a67 --- /dev/null +++ b/AdaptiveWingLoss/core/dataloader.py @@ -0,0 +1,368 @@ +import sys +import os +import random +import glob +import torch +from skimage import io +from skimage import transform as ski_transform +from skimage.color import rgb2gray +import scipy.io as sio +from scipy import interpolate +import numpy as np +import matplotlib.pyplot as plt +from torch.utils.data import Dataset, DataLoader +from torchvision import transforms, utils +from torchvision.transforms import Lambda, Compose +from torchvision.transforms.functional import adjust_brightness, adjust_contrast, adjust_saturation, adjust_hue +from utils.utils import cv_crop, cv_rotate, draw_gaussian, transform, power_transform, shuffle_lr, fig2data, generate_weight_map +from PIL import Image +import cv2 +import copy +import math +from imgaug import augmenters as iaa + + +class AddBoundary(object): + def __init__(self, num_landmarks=68): + self.num_landmarks = num_landmarks + + def __call__(self, sample): + landmarks_64 = np.floor(sample['landmarks'] / 4.0) + if self.num_landmarks == 68: + boundaries = {} + boundaries['cheek'] = landmarks_64[0:17] + boundaries['left_eyebrow'] = landmarks_64[17:22] + boundaries['right_eyebrow'] = landmarks_64[22:27] + boundaries['uper_left_eyelid'] = landmarks_64[36:40] + boundaries['lower_left_eyelid'] = np.array([landmarks_64[i] for i in [36, 41, 40, 39]]) + boundaries['upper_right_eyelid'] = landmarks_64[42:46] + boundaries['lower_right_eyelid'] = np.array([landmarks_64[i] for i in [42, 47, 46, 45]]) + boundaries['noise'] = landmarks_64[27:31] + boundaries['noise_bot'] = landmarks_64[31:36] + boundaries['upper_outer_lip'] = landmarks_64[48:55] + boundaries['upper_inner_lip'] = np.array([landmarks_64[i] for i in [60, 61, 62, 63, 64]]) + boundaries['lower_outer_lip'] = np.array([landmarks_64[i] for i in [48, 59, 58, 57, 56, 55, 54]]) + boundaries['lower_inner_lip'] = np.array([landmarks_64[i] for i in [60, 67, 66, 65, 64]]) + elif self.num_landmarks == 98: + boundaries = {} + boundaries['cheek'] = landmarks_64[0:33] + boundaries['left_eyebrow'] = landmarks_64[33:38] + boundaries['right_eyebrow'] = landmarks_64[42:47] + boundaries['uper_left_eyelid'] = landmarks_64[60:65] + boundaries['lower_left_eyelid'] = np.array([landmarks_64[i] for i in [60, 67, 66, 65, 64]]) + boundaries['upper_right_eyelid'] = landmarks_64[68:73] + boundaries['lower_right_eyelid'] = np.array([landmarks_64[i] for i in [68, 75, 74, 73, 72]]) + boundaries['noise'] = landmarks_64[51:55] + boundaries['noise_bot'] = landmarks_64[55:60] + boundaries['upper_outer_lip'] = landmarks_64[76:83] + boundaries['upper_inner_lip'] = np.array([landmarks_64[i] for i in [88, 89, 90, 91, 92]]) + boundaries['lower_outer_lip'] = np.array([landmarks_64[i] for i in [76, 87, 86, 85, 84, 83, 82]]) + boundaries['lower_inner_lip'] = np.array([landmarks_64[i] for i in [88, 95, 94, 93, 92]]) + elif self.num_landmarks == 19: + boundaries = {} + boundaries['left_eyebrow'] = landmarks_64[0:3] + boundaries['right_eyebrow'] = landmarks_64[3:5] + boundaries['left_eye'] = landmarks_64[6:9] + boundaries['right_eye'] = landmarks_64[9:12] + boundaries['noise'] = landmarks_64[12:15] + + elif self.num_landmarks == 29: + boundaries = {} + boundaries['upper_left_eyebrow'] = np.stack([ + landmarks_64[0], + landmarks_64[4], + landmarks_64[2] + ], axis=0) + boundaries['lower_left_eyebrow'] = np.stack([ + landmarks_64[0], + landmarks_64[5], + landmarks_64[2] + ], axis=0) + boundaries['upper_right_eyebrow'] = np.stack([ + landmarks_64[1], + landmarks_64[6], + landmarks_64[3] + ], axis=0) + boundaries['lower_right_eyebrow'] = np.stack([ + landmarks_64[1], + landmarks_64[7], + landmarks_64[3] + ], axis=0) + boundaries['upper_left_eye'] = np.stack([ + landmarks_64[8], + landmarks_64[12], + landmarks_64[10] + ], axis=0) + boundaries['lower_left_eye'] = np.stack([ + landmarks_64[8], + landmarks_64[13], + landmarks_64[10] + ], axis=0) + boundaries['upper_right_eye'] = np.stack([ + landmarks_64[9], + landmarks_64[14], + landmarks_64[11] + ], axis=0) + boundaries['lower_right_eye'] = np.stack([ + landmarks_64[9], + landmarks_64[15], + landmarks_64[11] + ], axis=0) + boundaries['noise'] = np.stack([ + landmarks_64[18], + landmarks_64[21], + landmarks_64[19] + ], axis=0) + boundaries['outer_upper_lip'] = np.stack([ + landmarks_64[22], + landmarks_64[24], + landmarks_64[23] + ], axis=0) + boundaries['inner_upper_lip'] = np.stack([ + landmarks_64[22], + landmarks_64[25], + landmarks_64[23] + ], axis=0) + boundaries['outer_lower_lip'] = np.stack([ + landmarks_64[22], + landmarks_64[26], + landmarks_64[23] + ], axis=0) + boundaries['inner_lower_lip'] = np.stack([ + landmarks_64[22], + landmarks_64[27], + landmarks_64[23] + ], axis=0) + functions = {} + + for key, points in boundaries.items(): + temp = points[0] + new_points = points[0:1, :] + for point in points[1:]: + if point[0] == temp[0] and point[1] == temp[1]: + continue + else: + new_points = np.concatenate((new_points, np.expand_dims(point, 0)), axis=0) + temp = point + points = new_points + if points.shape[0] == 1: + points = np.concatenate((points, points+0.001), axis=0) + k = min(4, points.shape[0]) + functions[key] = interpolate.splprep([points[:, 0], points[:, 1]], k=k-1,s=0) + + boundary_map = np.zeros((64, 64)) + + fig = plt.figure(figsize=[64/96.0, 64/96.0], dpi=96) + + ax = fig.add_axes([0, 0, 1, 1]) + + ax.axis('off') + + ax.imshow(boundary_map, interpolation='nearest', cmap='gray') + #ax.scatter(landmarks[:, 0], landmarks[:, 1], s=1, marker=',', c='w') + + for key in functions.keys(): + xnew = np.arange(0, 1, 0.01) + out = interpolate.splev(xnew, functions[key][0], der=0) + plt.plot(out[0], out[1], ',', linewidth=1, color='w') + + img = fig2data(fig) + + plt.close() + + sigma = 1 + temp = 255-img[:,:,1] + temp = cv2.distanceTransform(temp, cv2.DIST_L2, cv2.DIST_MASK_PRECISE) + temp = temp.astype(np.float32) + temp = np.where(temp < 3*sigma, np.exp(-(temp*temp)/(2*sigma*sigma)), 0 ) + + fig = plt.figure(figsize=[64/96.0, 64/96.0], dpi=96) + + ax = fig.add_axes([0, 0, 1, 1]) + + ax.axis('off') + ax.imshow(temp, cmap='gray') + plt.close() + + boundary_map = fig2data(fig) + + sample['boundary'] = boundary_map[:, :, 0] + + return sample + +class AddWeightMap(object): + def __call__(self, sample): + heatmap= sample['heatmap'] + boundary = sample['boundary'] + heatmap = np.concatenate((heatmap, np.expand_dims(boundary, axis=0)), 0) + weight_map = np.zeros_like(heatmap) + for i in range(heatmap.shape[0]): + weight_map[i] = generate_weight_map(weight_map[i], + heatmap[i]) + sample['weight_map'] = weight_map + return sample + +class ToTensor(object): + """Convert ndarrays in sample to Tensors.""" + + def __call__(self, sample): + image, heatmap, landmarks, boundary, weight_map= sample['image'], sample['heatmap'], sample['landmarks'], sample['boundary'], sample['weight_map'] + + # swap color axis because + # numpy image: H x W x C + # torch image: C X H X W + if len(image.shape) == 2: + image = np.expand_dims(image, axis=2) + image_small = np.expand_dims(image_small, axis=2) + image = image.transpose((2, 0, 1)) + boundary = np.expand_dims(boundary, axis=2) + boundary = boundary.transpose((2, 0, 1)) + return {'image': torch.from_numpy(image).float().div(255.0), + 'heatmap': torch.from_numpy(heatmap).float(), + 'landmarks': torch.from_numpy(landmarks).float(), + 'boundary': torch.from_numpy(boundary).float().div(255.0), + 'weight_map': torch.from_numpy(weight_map).float()} + +class FaceLandmarksDataset(Dataset): + """Face Landmarks dataset.""" + + def __init__(self, img_dir, landmarks_dir, num_landmarks=68, gray_scale=False, + detect_face=False, enhance=False, center_shift=0, + transform=None,): + """ + Args: + landmark_dir (string): Path to the mat file with landmarks saved. + img_dir (string): Directory with all the images. + transform (callable, optional): Optional transform to be applied + on a sample. + """ + self.img_dir = img_dir + self.landmarks_dir = landmarks_dir + self.num_lanmdkars = num_landmarks + self.transform = transform + self.img_names = glob.glob(self.img_dir+'*.jpg') + \ + glob.glob(self.img_dir+'*.png') + self.gray_scale = gray_scale + self.detect_face = detect_face + self.enhance = enhance + self.center_shift = center_shift + if self.detect_face: + self.face_detector = MTCNN(thresh=[0.5, 0.6, 0.7]) + def __len__(self): + return len(self.img_names) + + def __getitem__(self, idx): + img_name = self.img_names[idx] + pil_image = Image.open(img_name) + if pil_image.mode != "RGB": + # if input is grayscale image, convert it to 3 channel image + if self.enhance: + pil_image = power_transform(pil_image, 0.5) + temp_image = Image.new('RGB', pil_image.size) + temp_image.paste(pil_image) + pil_image = temp_image + image = np.array(pil_image) + if self.gray_scale: + image = rgb2gray(image) + image = np.expand_dims(image, axis=2) + image = np.concatenate((image, image, image), axis=2) + image = image * 255.0 + image = image.astype(np.uint8) + if not self.detect_face: + center = [450//2, 450//2+0] + if self.center_shift != 0: + center[0] += int(np.random.uniform(-self.center_shift, + self.center_shift)) + center[1] += int(np.random.uniform(-self.center_shift, + self.center_shift)) + scale = 1.8 + else: + detected_faces = self.face_detector.detect_image(image) + if len(detected_faces) > 0: + box = detected_faces[0] + left, top, right, bottom, _ = box + center = [right - (right - left) / 2.0, + bottom - (bottom - top) / 2.0] + center[1] = center[1] - (bottom - top) * 0.12 + scale = (right - left + bottom - top) / 195.0 + else: + center = [450//2, 450//2+0] + scale = 1.8 + if self.center_shift != 0: + shift = self.center * self.center_shift / 450 + center[0] += int(np.random.uniform(-shift, shift)) + center[1] += int(np.random.uniform(-shift, shift)) + base_name = os.path.basename(img_name) + landmarks_base_name = base_name[:-4] + '_pts.mat' + landmarks_name = os.path.join(self.landmarks_dir, landmarks_base_name) + if os.path.isfile(landmarks_name): + mat_data = sio.loadmat(landmarks_name) + landmarks = mat_data['pts_2d'] + elif os.path.isfile(landmarks_name[:-8] + '.pts.npy'): + landmarks = np.load(landmarks_name[:-8] + '.pts.npy') + else: + landmarks = [] + heatmap = [] + + if landmarks != []: + new_image, new_landmarks = cv_crop(image, landmarks, center, + scale, 256, self.center_shift) + tries = 0 + while self.center_shift != 0 and tries < 5 and (np.max(new_landmarks) > 240 or np.min(new_landmarks) < 15): + center = [450//2, 450//2+0] + scale += 0.05 + center[0] += int(np.random.uniform(-self.center_shift, + self.center_shift)) + center[1] += int(np.random.uniform(-self.center_shift, + self.center_shift)) + + new_image, new_landmarks = cv_crop(image, landmarks, + center, scale, 256, + self.center_shift) + tries += 1 + if np.max(new_landmarks) > 250 or np.min(new_landmarks) < 5: + center = [450//2, 450//2+0] + scale = 2.25 + new_image, new_landmarks = cv_crop(image, landmarks, + center, scale, 256, + 100) + assert (np.min(new_landmarks) > 0 and np.max(new_landmarks) < 256), \ + "Landmarks out of boundary!" + image = new_image + landmarks = new_landmarks + heatmap = np.zeros((self.num_lanmdkars, 64, 64)) + for i in range(self.num_lanmdkars): + if landmarks[i][0] > 0: + heatmap[i] = draw_gaussian(heatmap[i], landmarks[i]/4.0+1, 1) + sample = {'image': image, 'heatmap': heatmap, 'landmarks': landmarks} + if self.transform: + sample = self.transform(sample) + + return sample + +def get_dataset(val_img_dir, val_landmarks_dir, batch_size, + num_landmarks=68, rotation=0, scale=0, + center_shift=0, random_flip=False, + brightness=0, contrast=0, saturation=0, + blur=False, noise=False, jpeg_effect=False, + random_occlusion=False, gray_scale=False, + detect_face=False, enhance=False): + val_transforms = transforms.Compose([AddBoundary(num_landmarks), + AddWeightMap(), + ToTensor()]) + + val_dataset = FaceLandmarksDataset(val_img_dir, val_landmarks_dir, + num_landmarks=num_landmarks, + gray_scale=gray_scale, + detect_face=detect_face, + enhance=enhance, + transform=val_transforms) + + val_dataloader = torch.utils.data.DataLoader(val_dataset, + batch_size=batch_size, + shuffle=False, + num_workers=6) + data_loaders = {'val': val_dataloader} + dataset_sizes = {} + dataset_sizes['val'] = len(val_dataset) + return data_loaders, dataset_sizes diff --git a/AdaptiveWingLoss/core/evaler.py b/AdaptiveWingLoss/core/evaler.py new file mode 100644 index 0000000000000000000000000000000000000000..b782461c9ec53b45bfd3de7ff8ea801cc79d276d --- /dev/null +++ b/AdaptiveWingLoss/core/evaler.py @@ -0,0 +1,116 @@ +import matplotlib +matplotlib.use('Agg') +import math +import torch +import copy +import time +from torch.autograd import Variable +import shutil +from skimage import io +import numpy as np +from utils.utils import fan_NME, show_landmarks, get_preds_fromhm +from PIL import Image, ImageDraw +import os +import sys +import cv2 +import matplotlib.pyplot as plt + + +device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu") + +def eval_model(model, dataloaders, dataset_sizes, + writer, use_gpu=True, epoches=5, dataset='val', + save_path='./', num_landmarks=68): + global_nme = 0 + model.eval() + for epoch in range(epoches): + running_loss = 0 + step = 0 + total_nme = 0 + total_count = 0 + fail_count = 0 + nmes = [] + # running_corrects = 0 + + # Iterate over data. + with torch.no_grad(): + for data in dataloaders[dataset]: + total_runtime = 0 + run_count = 0 + step_start = time.time() + step += 1 + # get the inputs + inputs = data['image'].type(torch.FloatTensor) + labels_heatmap = data['heatmap'].type(torch.FloatTensor) + labels_boundary = data['boundary'].type(torch.FloatTensor) + landmarks = data['landmarks'].type(torch.FloatTensor) + loss_weight_map = data['weight_map'].type(torch.FloatTensor) + # wrap them in Variable + if use_gpu: + inputs = inputs.to(device) + labels_heatmap = labels_heatmap.to(device) + labels_boundary = labels_boundary.to(device) + loss_weight_map = loss_weight_map.to(device) + else: + inputs, labels_heatmap = Variable(inputs), Variable(labels_heatmap) + labels_boundary = Variable(labels_boundary) + labels = torch.cat((labels_heatmap, labels_boundary), 1) + single_start = time.time() + outputs, boundary_channels = model(inputs) + single_end = time.time() + total_runtime += time.time() - single_start + run_count += 1 + step_end = time.time() + for i in range(inputs.shape[0]): + img = inputs[i] + img = img.cpu().numpy() + img = img.transpose((1, 2, 0))*255.0 + img = img.astype(np.uint8) + img = Image.fromarray(img) + # pred_heatmap = outputs[-1][i].detach().cpu()[:-1, :, :] + pred_heatmap = outputs[-1][:, :-1, :, :][i].detach().cpu() + pred_landmarks, _ = get_preds_fromhm(pred_heatmap.unsqueeze(0)) + pred_landmarks = pred_landmarks.squeeze().numpy() + + gt_landmarks = data['landmarks'][i].numpy() + if num_landmarks == 68: + left_eye = np.average(gt_landmarks[36:42], axis=0) + right_eye = np.average(gt_landmarks[42:48], axis=0) + norm_factor = np.linalg.norm(left_eye - right_eye) + # norm_factor = np.linalg.norm(gt_landmarks[36]- gt_landmarks[45]) + + elif num_landmarks == 98: + norm_factor = np.linalg.norm(gt_landmarks[60]- gt_landmarks[72]) + elif num_landmarks == 19: + left, top = gt_landmarks[-2, :] + right, bottom = gt_landmarks[-1, :] + norm_factor = math.sqrt(abs(right - left)*abs(top-bottom)) + gt_landmarks = gt_landmarks[:-2, :] + elif num_landmarks == 29: + # norm_factor = np.linalg.norm(gt_landmarks[8]- gt_landmarks[9]) + norm_factor = np.linalg.norm(gt_landmarks[16]- gt_landmarks[17]) + single_nme = (np.sum(np.linalg.norm(pred_landmarks*4 - gt_landmarks, axis=1)) / pred_landmarks.shape[0]) / norm_factor + + nmes.append(single_nme) + total_count += 1 + if single_nme > 0.1: + fail_count += 1 + if step % 10 == 0: + print('Step {} Time: {:.6f} Input Mean: {:.6f} Output Mean: {:.6f}'.format( + step, step_end - step_start, + torch.mean(labels), + torch.mean(outputs[0]))) + # gt_landmarks = landmarks.numpy() + # pred_heatmap = outputs[-1].to('cpu').numpy() + gt_landmarks = landmarks + batch_nme = fan_NME(outputs[-1][:, :-1, :, :].detach().cpu(), gt_landmarks, num_landmarks) + # batch_nme = 0 + total_nme += batch_nme + epoch_nme = total_nme / dataset_sizes['val'] + global_nme += epoch_nme + nme_save_path = os.path.join(save_path, 'nme_log.npy') + np.save(nme_save_path, np.array(nmes)) + print('NME: {:.6f} Failure Rate: {:.6f} Total Count: {:.6f} Fail Count: {:.6f}'.format(epoch_nme, fail_count/total_count, total_count, fail_count)) + print('Evaluation done! Average NME: {:.6f}'.format(global_nme/epoches)) + print('Everage runtime for a single batch: {:.6f}'.format(total_runtime/run_count)) + return model diff --git a/AdaptiveWingLoss/core/models.py b/AdaptiveWingLoss/core/models.py new file mode 100644 index 0000000000000000000000000000000000000000..0344ee36ebf38b7f77c1ebc08549166b40321656 --- /dev/null +++ b/AdaptiveWingLoss/core/models.py @@ -0,0 +1,228 @@ +import torch +import torch.nn as nn +import torch.nn.functional as F +import math +from AdaptiveWingLoss.core.coord_conv import CoordConvTh + + +def conv3x3(in_planes, out_planes, strd=1, padding=1, + bias=False,dilation=1): + "3x3 convolution with padding" + return nn.Conv2d(in_planes, out_planes, kernel_size=3, + stride=strd, padding=padding, bias=bias, + dilation=dilation) + +class BasicBlock(nn.Module): + expansion = 1 + + def __init__(self, inplanes, planes, stride=1, downsample=None): + super(BasicBlock, self).__init__() + self.conv1 = conv3x3(inplanes, planes, stride) + # self.bn1 = nn.BatchNorm2d(planes) + self.relu = nn.ReLU(inplace=True) + self.conv2 = conv3x3(planes, planes) + # self.bn2 = nn.BatchNorm2d(planes) + self.downsample = downsample + self.stride = stride + + def forward(self, x): + residual = x + + out = self.conv1(x) + # out = self.bn1(out) + out = self.relu(out) + + out = self.conv2(out) + # out = self.bn2(out) + + if self.downsample is not None: + residual = self.downsample(x) + + out += residual + out = self.relu(out) + + return out + +class ConvBlock(nn.Module): + def __init__(self, in_planes, out_planes): + super(ConvBlock, self).__init__() + self.bn1 = nn.BatchNorm2d(in_planes) + self.conv1 = conv3x3(in_planes, int(out_planes / 2)) + self.bn2 = nn.BatchNorm2d(int(out_planes / 2)) + self.conv2 = conv3x3(int(out_planes / 2), int(out_planes / 4), + padding=1, dilation=1) + self.bn3 = nn.BatchNorm2d(int(out_planes / 4)) + self.conv3 = conv3x3(int(out_planes / 4), int(out_planes / 4), + padding=1, dilation=1) + + if in_planes != out_planes: + self.downsample = nn.Sequential( + nn.BatchNorm2d(in_planes), + nn.ReLU(True), + nn.Conv2d(in_planes, out_planes, + kernel_size=1, stride=1, bias=False), + ) + else: + self.downsample = None + + def forward(self, x): + residual = x + + out1 = self.bn1(x) + out1 = F.relu(out1, True) + out1 = self.conv1(out1) + + out2 = self.bn2(out1) + out2 = F.relu(out2, True) + out2 = self.conv2(out2) + + out3 = self.bn3(out2) + out3 = F.relu(out3, True) + out3 = self.conv3(out3) + + out3 = torch.cat((out1, out2, out3), 1) + + if self.downsample is not None: + residual = self.downsample(residual) + + out3 += residual + + return out3 + +class HourGlass(nn.Module): + def __init__(self, num_modules, depth, num_features, first_one=False): + super(HourGlass, self).__init__() + self.num_modules = num_modules + self.depth = depth + self.features = num_features + self.coordconv = CoordConvTh(x_dim=64, y_dim=64, + with_r=True, with_boundary=True, + in_channels=256, first_one=first_one, + out_channels=256, + kernel_size=1, + stride=1, padding=0) + self._generate_network(self.depth) + + def _generate_network(self, level): + self.add_module('b1_' + str(level), ConvBlock(256, 256)) + + self.add_module('b2_' + str(level), ConvBlock(256, 256)) + + if level > 1: + self._generate_network(level - 1) + else: + self.add_module('b2_plus_' + str(level), ConvBlock(256, 256)) + + self.add_module('b3_' + str(level), ConvBlock(256, 256)) + + def _forward(self, level, inp): + # Upper branch + up1 = inp + up1 = self._modules['b1_' + str(level)](up1) + + # Lower branch + low1 = F.avg_pool2d(inp, 2, stride=2) + low1 = self._modules['b2_' + str(level)](low1) + + if level > 1: + low2 = self._forward(level - 1, low1) + else: + low2 = low1 + low2 = self._modules['b2_plus_' + str(level)](low2) + + low3 = low2 + low3 = self._modules['b3_' + str(level)](low3) + + up2 = F.upsample(low3, scale_factor=2, mode='nearest') + + return up1 + up2 + + def forward(self, x, heatmap): + x, last_channel = self.coordconv(x, heatmap) + return self._forward(self.depth, x), last_channel + +class FAN(nn.Module): + + def __init__(self, num_modules=1, end_relu=False, gray_scale=False, + num_landmarks=68): + super(FAN, self).__init__() + self.num_modules = num_modules + self.gray_scale = gray_scale + self.end_relu = end_relu + self.num_landmarks = num_landmarks + + # Base part + if self.gray_scale: + self.conv1 = CoordConvTh(x_dim=256, y_dim=256, + with_r=True, with_boundary=False, + in_channels=3, out_channels=64, + kernel_size=7, + stride=2, padding=3) + else: + self.conv1 = CoordConvTh(x_dim=256, y_dim=256, + with_r=True, with_boundary=False, + in_channels=3, out_channels=64, + kernel_size=7, + stride=2, padding=3) + self.bn1 = nn.BatchNorm2d(64) + self.conv2 = ConvBlock(64, 128) + self.conv3 = ConvBlock(128, 128) + self.conv4 = ConvBlock(128, 256) + + # Stacking part + for hg_module in range(self.num_modules): + if hg_module == 0: + first_one = True + else: + first_one = False + self.add_module('m' + str(hg_module), HourGlass(1, 4, 256, + first_one)) + self.add_module('top_m_' + str(hg_module), ConvBlock(256, 256)) + self.add_module('conv_last' + str(hg_module), + nn.Conv2d(256, 256, kernel_size=1, stride=1, padding=0)) + self.add_module('bn_end' + str(hg_module), nn.BatchNorm2d(256)) + self.add_module('l' + str(hg_module), nn.Conv2d(256, + num_landmarks+1, kernel_size=1, stride=1, padding=0)) + + if hg_module < self.num_modules - 1: + self.add_module( + 'bl' + str(hg_module), nn.Conv2d(256, 256, kernel_size=1, stride=1, padding=0)) + self.add_module('al' + str(hg_module), nn.Conv2d(num_landmarks+1, + 256, kernel_size=1, stride=1, padding=0)) + + def forward(self, x): + x, _ = self.conv1(x) + x = F.relu(self.bn1(x), True) + # x = F.relu(self.bn1(self.conv1(x)), True) + x = F.avg_pool2d(self.conv2(x), 2, stride=2) + x = self.conv3(x) + x = self.conv4(x) + + previous = x + + outputs = [] + boundary_channels = [] + tmp_out = None + for i in range(self.num_modules): + hg, boundary_channel = self._modules['m' + str(i)](previous, + tmp_out) + + ll = hg + ll = self._modules['top_m_' + str(i)](ll) + + ll = F.relu(self._modules['bn_end' + str(i)] + (self._modules['conv_last' + str(i)](ll)), True) + + # Predict heatmaps + tmp_out = self._modules['l' + str(i)](ll) + if self.end_relu: + tmp_out = F.relu(tmp_out) # HACK: Added relu + outputs.append(tmp_out) + boundary_channels.append(boundary_channel) + + if i < self.num_modules - 1: + ll = self._modules['bl' + str(i)](ll) + tmp_out_ = self._modules['al' + str(i)](tmp_out) + previous = previous + ll + tmp_out_ + + return outputs, boundary_channels diff --git a/AdaptiveWingLoss/utils/__init__.py b/AdaptiveWingLoss/utils/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/AdaptiveWingLoss/utils/utils.py b/AdaptiveWingLoss/utils/utils.py new file mode 100644 index 0000000000000000000000000000000000000000..bb5a32b87b2aa48b6def1ab43cf8cf409744f6c0 --- /dev/null +++ b/AdaptiveWingLoss/utils/utils.py @@ -0,0 +1,355 @@ +from __future__ import print_function, division +import os +import sys +import math +import torch +import cv2 +from PIL import Image +from skimage import io +from skimage import transform as ski_transform +from scipy import ndimage +import numpy as np +import matplotlib +import matplotlib.pyplot as plt +from torch.utils.data import Dataset, DataLoader +from torchvision import transforms, utils + +def _gaussian( + size=3, sigma=0.25, amplitude=1, normalize=False, width=None, + height=None, sigma_horz=None, sigma_vert=None, mean_horz=0.5, + mean_vert=0.5): + # handle some defaults + if width is None: + width = size + if height is None: + height = size + if sigma_horz is None: + sigma_horz = sigma + if sigma_vert is None: + sigma_vert = sigma + center_x = mean_horz * width + 0.5 + center_y = mean_vert * height + 0.5 + gauss = np.empty((height, width), dtype=np.float32) + # generate kernel + for i in range(height): + for j in range(width): + gauss[i][j] = amplitude * math.exp(-(math.pow((j + 1 - center_x) / ( + sigma_horz * width), 2) / 2.0 + math.pow((i + 1 - center_y) / (sigma_vert * height), 2) / 2.0)) + if normalize: + gauss = gauss / np.sum(gauss) + return gauss + +def draw_gaussian(image, point, sigma): + # Check if the gaussian is inside + ul = [np.floor(np.floor(point[0]) - 3 * sigma), + np.floor(np.floor(point[1]) - 3 * sigma)] + br = [np.floor(np.floor(point[0]) + 3 * sigma), + np.floor(np.floor(point[1]) + 3 * sigma)] + if (ul[0] > image.shape[1] or ul[1] > + image.shape[0] or br[0] < 1 or br[1] < 1): + return image + size = 6 * sigma + 1 + g = _gaussian(size) + g_x = [int(max(1, -ul[0])), int(min(br[0], image.shape[1])) - + int(max(1, ul[0])) + int(max(1, -ul[0]))] + g_y = [int(max(1, -ul[1])), int(min(br[1], image.shape[0])) - + int(max(1, ul[1])) + int(max(1, -ul[1]))] + img_x = [int(max(1, ul[0])), int(min(br[0], image.shape[1]))] + img_y = [int(max(1, ul[1])), int(min(br[1], image.shape[0]))] + assert (g_x[0] > 0 and g_y[1] > 0) + correct = False + while not correct: + try: + image[img_y[0] - 1:img_y[1], img_x[0] - 1:img_x[1] + ] = image[img_y[0] - 1:img_y[1], img_x[0] - 1:img_x[1]] + g[g_y[0] - 1:g_y[1], g_x[0] - 1:g_x[1]] + correct = True + except: + print('img_x: {}, img_y: {}, g_x:{}, g_y:{}, point:{}, g_shape:{}, ul:{}, br:{}'.format(img_x, img_y, g_x, g_y, point, g.shape, ul, br)) + ul = [np.floor(np.floor(point[0]) - 3 * sigma), + np.floor(np.floor(point[1]) - 3 * sigma)] + br = [np.floor(np.floor(point[0]) + 3 * sigma), + np.floor(np.floor(point[1]) + 3 * sigma)] + g_x = [int(max(1, -ul[0])), int(min(br[0], image.shape[1])) - + int(max(1, ul[0])) + int(max(1, -ul[0]))] + g_y = [int(max(1, -ul[1])), int(min(br[1], image.shape[0])) - + int(max(1, ul[1])) + int(max(1, -ul[1]))] + img_x = [int(max(1, ul[0])), int(min(br[0], image.shape[1]))] + img_y = [int(max(1, ul[1])), int(min(br[1], image.shape[0]))] + pass + image[image > 1] = 1 + return image + +def transform(point, center, scale, resolution, rotation=0, invert=False): + _pt = np.ones(3) + _pt[0] = point[0] + _pt[1] = point[1] + + h = 200.0 * scale + t = np.eye(3) + t[0, 0] = resolution / h + t[1, 1] = resolution / h + t[0, 2] = resolution * (-center[0] / h + 0.5) + t[1, 2] = resolution * (-center[1] / h + 0.5) + + if rotation != 0: + rotation = -rotation + r = np.eye(3) + ang = rotation * math.pi / 180.0 + s = math.sin(ang) + c = math.cos(ang) + r[0][0] = c + r[0][1] = -s + r[1][0] = s + r[1][1] = c + + t_ = np.eye(3) + t_[0][2] = -resolution / 2.0 + t_[1][2] = -resolution / 2.0 + t_inv = torch.eye(3) + t_inv[0][2] = resolution / 2.0 + t_inv[1][2] = resolution / 2.0 + t = reduce(np.matmul, [t_inv, r, t_, t]) + + if invert: + t = np.linalg.inv(t) + new_point = (np.matmul(t, _pt))[0:2] + + return new_point.astype(int) + +def cv_crop(image, landmarks, center, scale, resolution=256, center_shift=0): + new_image = cv2.copyMakeBorder(image, center_shift, + center_shift, + center_shift, + center_shift, + cv2.BORDER_CONSTANT, value=[0,0,0]) + new_landmarks = landmarks.copy() + if center_shift != 0: + center[0] += center_shift + center[1] += center_shift + new_landmarks = new_landmarks + center_shift + length = 200 * scale + top = int(center[1] - length // 2) + bottom = int(center[1] + length // 2) + left = int(center[0] - length // 2) + right = int(center[0] + length // 2) + y_pad = abs(min(top, new_image.shape[0] - bottom, 0)) + x_pad = abs(min(left, new_image.shape[1] - right, 0)) + top, bottom, left, right = top + y_pad, bottom + y_pad, left + x_pad, right + x_pad + new_image = cv2.copyMakeBorder(new_image, y_pad, + y_pad, + x_pad, + x_pad, + cv2.BORDER_CONSTANT, value=[0,0,0]) + new_image = new_image[top:bottom, left:right] + new_image = cv2.resize(new_image, dsize=(int(resolution), int(resolution)), + interpolation=cv2.INTER_LINEAR) + new_landmarks[:, 0] = (new_landmarks[:, 0] + x_pad - left) * resolution / length + new_landmarks[:, 1] = (new_landmarks[:, 1] + y_pad - top) * resolution / length + return new_image, new_landmarks + +def cv_rotate(image, landmarks, heatmap, rot, scale, resolution=256): + img_mat = cv2.getRotationMatrix2D((resolution//2, resolution//2), rot, scale) + ones = np.ones(shape=(landmarks.shape[0], 1)) + stacked_landmarks = np.hstack([landmarks, ones]) + new_landmarks = img_mat.dot(stacked_landmarks.T).T + if np.max(new_landmarks) > 255 or np.min(new_landmarks) < 0: + return image, landmarks, heatmap + else: + new_image = cv2.warpAffine(image, img_mat, (resolution, resolution)) + if heatmap is not None: + new_heatmap = np.zeros((heatmap.shape[0], 64, 64)) + for i in range(heatmap.shape[0]): + if new_landmarks[i][0] > 0: + new_heatmap[i] = draw_gaussian(new_heatmap[i], + new_landmarks[i]/4.0+1, 1) + return new_image, new_landmarks, new_heatmap + +def show_landmarks(image, heatmap, gt_landmarks, gt_heatmap): + """Show image with pred_landmarks""" + pred_landmarks = [] + pred_landmarks, _ = get_preds_fromhm(torch.from_numpy(heatmap).unsqueeze(0)) + pred_landmarks = pred_landmarks.squeeze()*4 + + # pred_landmarks2 = get_preds_fromhm2(heatmap) + heatmap = np.max(gt_heatmap, axis=0) + heatmap = heatmap / np.max(heatmap) + # image = ski_transform.resize(image, (64, 64))*255 + image = image.astype(np.uint8) + heatmap = np.max(gt_heatmap, axis=0) + heatmap = ski_transform.resize(heatmap, (image.shape[0], image.shape[1])) + heatmap *= 255 + heatmap = heatmap.astype(np.uint8) + heatmap = cv2.applyColorMap(heatmap, cv2.COLORMAP_JET) + plt.imshow(image) + plt.scatter(gt_landmarks[:, 0], gt_landmarks[:, 1], s=0.5, marker='.', c='g') + plt.scatter(pred_landmarks[:, 0], pred_landmarks[:, 1], s=0.5, marker='.', c='r') + plt.pause(0.001) # pause a bit so that plots are updated + +def fan_NME(pred_heatmaps, gt_landmarks, num_landmarks=68): + ''' + Calculate total NME for a batch of data + + Args: + pred_heatmaps: torch tensor of size [batch, points, height, width] + gt_landmarks: torch tesnsor of size [batch, points, x, y] + + Returns: + nme: sum of nme for this batch + ''' + nme = 0 + pred_landmarks, _ = get_preds_fromhm(pred_heatmaps) + pred_landmarks = pred_landmarks.numpy() + gt_landmarks = gt_landmarks.numpy() + for i in range(pred_landmarks.shape[0]): + pred_landmark = pred_landmarks[i] * 4.0 + gt_landmark = gt_landmarks[i] + + if num_landmarks == 68: + left_eye = np.average(gt_landmark[36:42], axis=0) + right_eye = np.average(gt_landmark[42:48], axis=0) + norm_factor = np.linalg.norm(left_eye - right_eye) + # norm_factor = np.linalg.norm(gt_landmark[36]- gt_landmark[45]) + elif num_landmarks == 98: + norm_factor = np.linalg.norm(gt_landmark[60]- gt_landmark[72]) + elif num_landmarks == 19: + left, top = gt_landmark[-2, :] + right, bottom = gt_landmark[-1, :] + norm_factor = math.sqrt(abs(right - left)*abs(top-bottom)) + gt_landmark = gt_landmark[:-2, :] + elif num_landmarks == 29: + # norm_factor = np.linalg.norm(gt_landmark[8]- gt_landmark[9]) + norm_factor = np.linalg.norm(gt_landmark[16]- gt_landmark[17]) + nme += (np.sum(np.linalg.norm(pred_landmark - gt_landmark, axis=1)) / pred_landmark.shape[0]) / norm_factor + return nme + +def fan_NME_hm(pred_heatmaps, gt_heatmaps, num_landmarks=68): + ''' + Calculate total NME for a batch of data + + Args: + pred_heatmaps: torch tensor of size [batch, points, height, width] + gt_landmarks: torch tesnsor of size [batch, points, x, y] + + Returns: + nme: sum of nme for this batch + ''' + nme = 0 + pred_landmarks, _ = get_index_fromhm(pred_heatmaps) + pred_landmarks = pred_landmarks.numpy() + gt_landmarks = gt_landmarks.numpy() + for i in range(pred_landmarks.shape[0]): + pred_landmark = pred_landmarks[i] * 4.0 + gt_landmark = gt_landmarks[i] + if num_landmarks == 68: + left_eye = np.average(gt_landmark[36:42], axis=0) + right_eye = np.average(gt_landmark[42:48], axis=0) + norm_factor = np.linalg.norm(left_eye - right_eye) + else: + norm_factor = np.linalg.norm(gt_landmark[60]- gt_landmark[72]) + nme += (np.sum(np.linalg.norm(pred_landmark - gt_landmark, axis=1)) / pred_landmark.shape[0]) / norm_factor + return nme + +def power_transform(img, power): + img = np.array(img) + img_new = np.power((img/255.0), power) * 255.0 + img_new = img_new.astype(np.uint8) + img_new = Image.fromarray(img_new) + return img_new + +def get_preds_fromhm(hm, center=None, scale=None, rot=None): + max, idx = torch.max( + hm.view(hm.size(0), hm.size(1), hm.size(2) * hm.size(3)), 2) + idx += 1 + preds = idx.view(idx.size(0), idx.size(1), 1).repeat(1, 1, 2).float() + preds[..., 0].apply_(lambda x: (x - 1) % hm.size(3) + 1) + preds[..., 1].add_(-1).div_(hm.size(2)).floor_().add_(1) + + + for i in range(preds.size(0)): + for j in range(preds.size(1)): + hm_ = hm[i, j, :] + pX, pY = int(preds[i, j, 0]) - 1, int(preds[i, j, 1]) - 1 + if pX > 0 and pX < 63 and pY > 0 and pY < 63: + diff = torch.FloatTensor( + [hm_[pY, pX + 1] - hm_[pY, pX - 1], + hm_[pY + 1, pX] - hm_[pY - 1, pX]]) + preds[i, j].add_(diff.sign_().mul_(.25)) + + preds.add_(-0.5) + + preds_orig = torch.zeros(preds.size()) + if center is not None and scale is not None: + for i in range(hm.size(0)): + for j in range(hm.size(1)): + preds_orig[i, j] = transform( + preds[i, j], center, scale, hm.size(2), rot, True) + + return preds, preds_orig + +def get_index_fromhm(hm): + max, idx = torch.max( + hm.view(hm.size(0), hm.size(1), hm.size(2) * hm.size(3)), 2) + preds = idx.view(idx.size(0), idx.size(1), 1).repeat(1, 1, 2).float() + preds[..., 0].remainder_(hm.size(3)) + preds[..., 1].div_(hm.size(2)).floor_() + + for i in range(preds.size(0)): + for j in range(preds.size(1)): + hm_ = hm[i, j, :] + pX, pY = int(preds[i, j, 0]), int(preds[i, j, 1]) + if pX > 0 and pX < 63 and pY > 0 and pY < 63: + diff = torch.FloatTensor( + [hm_[pY, pX + 1] - hm_[pY, pX - 1], + hm_[pY + 1, pX] - hm_[pY - 1, pX]]) + preds[i, j].add_(diff.sign_().mul_(.25)) + + return preds + +def shuffle_lr(parts, num_landmarks=68, pairs=None): + if num_landmarks == 68: + if pairs is None: + pairs = [[0, 16], [1, 15], [2, 14], [3, 13], [4, 12], [5, 11], [6, 10], + [7, 9], [17, 26], [18, 25], [19, 24], [20, 23], [21, 22], [36, 45], + [37, 44], [38, 43], [39, 42], [41, 46], [40, 47], [31, 35], [32, 34], + [50, 52], [49, 53], [48, 54], [61, 63], [60, 64], [67, 65], [59, 55], [58, 56]] + elif num_landmarks == 98: + if pairs is None: + pairs = [[0, 32], [1,31], [2, 30], [3, 29], [4, 28], [5, 27], [6, 26], [7, 25], [8, 24], [9, 23], [10, 22], [11, 21], [12, 20], [13, 19], [14, 18], [15, 17], [33, 46], [34, 45], [35, 44], [36, 43], [37, 42], [38, 50], [39, 49], [40, 48], [41, 47], [60, 72], [61, 71], [62, 70], [63, 69], [64, 68], [65, 75], [66, 74], [67, 73], [96, 97], [55, 59], [56, 58], [76, 82], [77, 81], [78, 80], [88, 92], [89, 91], [95, 93], [87, 83], [86, 84]] + elif num_landmarks == 19: + if pairs is None: + pairs = [[0, 5], [1, 4], [2, 3], [6, 11], [7, 10], [8, 9], [12, 14], [15, 17]] + elif num_landmarks == 29: + if pairs is None: + pairs = [[0, 1], [4, 6], [5, 7], [2, 3], [8, 9], [12, 14], [16, 17], [13, 15], [10, 11], [18, 19], [22, 23]] + for matched_p in pairs: + idx1, idx2 = matched_p[0], matched_p[1] + tmp = np.copy(parts[idx1]) + np.copyto(parts[idx1], parts[idx2]) + np.copyto(parts[idx2], tmp) + return parts + + +def generate_weight_map(weight_map,heatmap): + + k_size = 3 + dilate = ndimage.grey_dilation(heatmap ,size=(k_size,k_size)) + weight_map[np.where(dilate>0.2)] = 1 + return weight_map + +def fig2data(fig): + """ + @brief Convert a Matplotlib figure to a 4D numpy array with RGBA channels and return it + @param fig a matplotlib figure + @return a numpy 3D array of RGBA values + """ + # draw the renderer + fig.canvas.draw ( ) + + # Get the RGB buffer from the figure + w,h = fig.canvas.get_width_height() + buf = np.fromstring (fig.canvas.tostring_rgb(), dtype=np.uint8) + buf.shape = (w, h, 3) + + # canvas.tostring_argb give pixmap in ARGB mode. Roll the ALPHA channel to have it in RGBA mode + buf = np.roll (buf, 3, axis=2) + return buf diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64 --- /dev/null +++ b/LICENSE @@ -0,0 +1,201 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/SberSwapInference.ipynb b/SberSwapInference.ipynb new file mode 100644 index 0000000000000000000000000000000000000000..804f94ee152842bc1fb0f40582b81348d80439ec --- /dev/null +++ b/SberSwapInference.ipynb @@ -0,0 +1,393 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": 1, + "id": "published-metro", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/conda/envs/faceshift_env/lib/python3.8/site-packages/kornia/augmentation/augmentation.py:1830: DeprecationWarning: GaussianBlur is no longer maintained and will be removed from the future versions. Please use RandomGaussianBlur instead.\n", + " warnings.warn(\n" + ] + } + ], + "source": [ + "import cv2\n", + "import torch\n", + "import time\n", + "import os\n", + "\n", + "from utils.inference.image_processing import crop_face, get_final_image, show_images\n", + "from utils.inference.video_processing import read_video, get_target, get_final_video, add_audio_from_another_video, face_enhancement\n", + "from utils.inference.core import model_inference\n", + "\n", + "from network.AEI_Net import AEI_Net\n", + "from coordinate_reg.image_infer import Handler\n", + "from insightface_func.face_detect_crop_multi import Face_detect_crop\n", + "from arcface_model.iresnet import iresnet100\n", + "from models.pix2pix_model import Pix2PixModel\n", + "from models.config_sr import TestOptions" + ] + }, + { + "cell_type": "markdown", + "id": "contemporary-factor", + "metadata": {}, + "source": [ + "### Load Models" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "signed-mustang", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "input mean and std: 127.5 127.5\n", + "find model: ./insightface_func/models/antelope/glintr100.onnx recognition\n", + "find model: ./insightface_func/models/antelope/scrfd_10g_bnkps.onnx detection\n", + "set det-size: (640, 640)\n", + "loading ./coordinate_reg/model/2d106det 0\n", + "input mean and std: 127.5 127.5\n", + "find model: ./insightface_func/models/antelope/glintr100.onnx recognition\n", + "find model: ./insightface_func/models/antelope/scrfd_10g_bnkps.onnx detection\n", + "set det-size: (640, 640)\n" + ] + } + ], + "source": [ + "app = Face_detect_crop(name='antelope', root='./insightface_func/models')\n", + "app.prepare(ctx_id= 0, det_thresh=0.6, det_size=(640,640))\n", + "\n", + "# main model for generation\n", + "G = AEI_Net(backbone='unet', num_blocks=2, c_id=512)\n", + "G.eval()\n", + "G.load_state_dict(torch.load('weights/G_unet_2blocks.pth', map_location=torch.device('cpu')))\n", + "G = G.cuda()\n", + "G = G.half()\n", + "\n", + "# arcface model to get face embedding\n", + "netArc = iresnet100(fp16=False)\n", + "netArc.load_state_dict(torch.load('arcface_model/backbone.pth'))\n", + "netArc=netArc.cuda()\n", + "netArc.eval()\n", + "\n", + "# model to get face landmarks\n", + "handler = Handler('./coordinate_reg/model/2d106det', 0, ctx_id=0, det_size=640)\n", + "\n", + "# model to make superres of face, set use_sr=True if you want to use super resolution or use_sr=False if you don't\n", + "use_sr = False\n", + "if use_sr:\n", + " os.environ['CUDA_VISIBLE_DEVICES'] = '0'\n", + " torch.backends.cudnn.benchmark = True\n", + " opt = TestOptions()\n", + " #opt.which_epoch ='10_7'\n", + " model = Pix2PixModel(opt)\n", + " model.netG.train()" + ] + }, + { + "cell_type": "markdown", + "id": "occasional-hanging", + "metadata": {}, + "source": [ + "### Set here path to source image and video for faceswap" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "id": "floating-perspective", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + } + ], + "source": [ + "image_to_image = True" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "id": "wound-attendance", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + } + ], + "source": [ + "\"\"\"\n", + "choose not really long videos, coz it can take a lot of time othervise \n", + "choose source image as a photo -- preferable a selfie of a person\n", + "\"\"\"\n", + "if image_to_image:\n", + " path_to_target = 'examples/images/beckham.jpg'\n", + "else:\n", + " path_to_video = 'examples/videos/random_gif.gif'\n", + "source_full = cv2.imread('examples/images/elon_musk.jpg')\n", + "OUT_VIDEO_NAME = \"examples/results/result.mp4\"\n", + "crop_size = 224 # don't change this\n", + "BS = 60" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "id": "fourth-devices", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + }, + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Everything is ok!\n" + ] + } + ], + "source": [ + "# check, if we can detect face on the source image\n", + "\n", + "try: \n", + " source = crop_face(source_full, app, crop_size)[0]\n", + " source = [source[:, :, ::-1]]\n", + " print(\"Everything is ok!\")\n", + "except TypeError:\n", + " print(\"Bad source images\")" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "id": "abandoned-intermediate", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + } + ], + "source": [ + "# read video and find target image in the video that contains at least 1 face\n", + "\n", + "if image_to_image:\n", + " target_full = cv2.imread(path_to_target)\n", + " full_frames = [target_full]\n", + "else:\n", + " full_frames, fps = read_video(path_to_video)\n", + "target = get_target(full_frames, app, crop_size)" + ] + }, + { + "cell_type": "markdown", + "id": "mexican-start", + "metadata": {}, + "source": [ + "### Model Inference" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "id": "moderate-geneva", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + } + ], + "source": [ + "START_TIME = time.time()" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "id": "placed-savannah", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n", + "100%|██████████| 1/1 [00:00<00:00, 85.92it/s]\n", + "1it [00:00, 4056.39it/s]\n", + "100%|██████████| 1/1 [00:00<00:00, 20.14it/s]\n", + "100%|██████████| 1/1 [00:00<00:00, 20068.44it/s]\n" + ] + } + ], + "source": [ + "final_frames_list, crop_frames_list, full_frames, tfm_array_list = model_inference(full_frames,\n", + " source,\n", + " target,\n", + " netArc,\n", + " G,\n", + " app,\n", + " set_target = False,\n", + " crop_size=crop_size,\n", + " BS=BS)" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "id": "clean-button", + "metadata": { + "scrolled": true + }, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + } + ], + "source": [ + "if use_sr:\n", + " final_frames_list = face_enhancement(final_frames_list, model)" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "id": "electoral-validation", + "metadata": {}, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + }, + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAABGoAAAINCAYAAABmlpneAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8QVMy6AAAACXBIWXMAAAsTAAALEwEAmpwYAAEAAElEQVR4nOz9d7wtWXbXCX7Xjjju2mfTVWWVkEolAWrkHSDhUeOhaQE9MEi0aAanHpxoQE0PQtCAsAIB04BA0D0f4UEINNByhSQYIQejQg6ZUmVWumeuv/e4iL36j20jTtz7TGZlVtXbv8zz7jkRO7aPWL8Va+21RVUpKCgoKCgoKCgoKCgoKCgoKHjrYd7qChQUFBQUFBQUFBQUFBQUFBQUOJQXNQUFBQUFBQUFBQUFBQUFBQUfIigvagoKCgoKCgoKCgoKCgoKCgo+RFBe1BQUFBQUFBQUFBQUFBQUFBR8iKC8qCkoKCgoKCgoKCgoKCgoKCj4EEF5UVNQUFBQUFBQUFBQUFBQUFDwIYLyoqagoKCgoKAAEdGH+PzcD4F6/jYR+dUPmVZF5Hd/kKtUUFBQ8GEPEflCEfleETkVkUMR+Y8i8hfe6nq9WRCRfywi73lAmq8Rke95k6pU8ISjfqsrUFBQUFBQUPAhgc/Ovs+AbwH+BPCvsuM/+KbWaBi/DfjPwD9/i+tRUFBQ8BEBEfnDwJcDXwH8IWAKfCrwm4Df9xZWraDgiUV5UVNQUFBQUFCAqn5n+C4iO/7rj+fHHxUiUgGVqq5eb/0KCgoKCj5o+N3A/6aqfyQ79vUi8mVvVYUKCp50lKVPBQUFBQUFBQ+EiPxmEfkOETnwbvHfKiKf1kvzNSLyPSLyq0XkB4AF8Jn+3O8WkRdF5FxE/rmI/IL+cioRMSLyh0Tkx0RkKSL/RUS+IDv/HpyV9wuy5Vhf+AhteI93b/8tIvI+ETkTkf9dRCYi8hki8l3+2HtE5B29a/+0iLzXn/+AiPx/ROSZXpqJiPx1ETkSkfsi8mdF5PeIiPbS3RCRvyEir4nIQkT+vYh85sO2o6CgoOANxjXg1f5BVY3PLhH5tyLyN7Lfn+efwX8hO/ZrRWQlIlv+96PKjR/2z8TvEJGf1kunIvL7ROQrfX5HIvJXRGTcS/cOEfn7Ps2FiPwbEfm4XprnReQbRGQuIj8pIr/1cTrNLxdTEfkULzcuROQ/+d/bIvJ3RORYRH5CRP673rW/TES+UUTuiMiJiHyniPzigTI+X0R+1Nf1W0Xkk4dkn4j8VhH5AS873y8if/Bx2lTwoYPiUVNQUFBQUFDwMPgo4O8BPw6Mgf8O+HYR+emq+hO9dF8B/HEc8X+fiPwa4K8Afw34OuBnA189UMZfAb7AX/t9wC8C/raI3FfVfwn8TuCfAD+Bc9PH1+dR8FnALeCLgXcAfxGY414ofQVwDvxl4G8A/3V23VPA/wq8DNwGfj/wLSLyCapqfZqvAL4Q+CPADwG/BfgNeeEiMgG+CacYfQlwB/gdwDeJyMeq6oayVFBQUPBBxvcBXywiLwD/UlXvD6T5duDXZr8/F/cy/nN6x75PVS/874/i4eTGO4G/APxR3PP4y4B/45+Jiyzd7we+E/iNwE8H/qSvw5eAewkOfAdwH/jtwAVuKdc3ici7VXUuIoKTQ7eAL/LXfxlwA/jRB3fVIP4u8FXAnwH+NPCPge/y7f5vgf8e+Hsi8u2q+gF/zU8Bvh74c4AFfgnw/xWRz1XVf+fb82nA3/f5fTHwU4F/0C9cRL4EJ5++AngPzqDx5SJyoapf9ZhtKniroarlUz7lUz7lUz7lUz7xA+wACnzhJecNztjzw8D/kh3/Gn/dJ/XSfzfwr3rH/ppP+3P973fhyOoX9NL9PeC7s9/fA3zNQ7ZDgd+d/X4PcATsZ8f+oU/3udmx3+mPbV2SbwW8Lb8OuIlTML4kSyfAD+AN0/7YFwEr4GOzYzWO0P/Zt3rsy6d8yufJ+wA/A/cCXP1z+AdwL8z3sjSf58/f9r+/DfdyogF2/LHvu+w59hBy42dmx97p8/3t2TH115rs2JfiXsbc8L+/HPeS5kaW5jpwDPwu//uX+rw+c6C89zygn74G+J7s9xf6vL4gOxby/9vZsX1gDfyOB/TNv+ld949wMdkkO/YHyeQzsAecAf+vXp7BWFK91fOrfB7vU5Y+FRQUFBQUFDwQIvJTReSfichrQIsjnR8HvLuX9CVV/U/ZdTXwycC/6KXr//4FOAXhn4lIHT7ANwOfJC7ezRuB71HV4+z3j+FenHxH7xjAc+GAiPwSv0TpGEfog1U0tP+/wgXgjO1Sx5a/vlf+LwS+F+dpFNoI8G+BT6OgoKDgTYaqfj/OW+NX4l6iC8675XskxSz797hn/8/2noGfAfwt3IuRzxaRPeATcZ43wCPJjTuq+u+z+rwf95z8jF66r9PkwQjwT3HB7z/B//6FwDcCJ9nz9dTnFZ6vnwG8pqr/YaC8x8U3Z9+D/PiWLP9j4C7uBT8AIvJ2Efm7IvISTqasgV9Mt28+Hfh6L0sC+rLzs4Ft4B/1ZOe3AE8Db38d7Sp4C1GWPhUUFBQUFBRcCRHZBf5P4DXcDiDvx7mL/y3cy4kcr/V+38J5oNztHe//DumOGcazpJcjrwdHvd8r4LRH/kPw4ymAiHw6jhz/M5xb+x2cRfM7Se0P8Woepp2fhSPlfTzqMq6CgoKCNwSqusS9WP56ABH5Itwz/ouAr1TVUxH5T7ilTvdwHoTfj3sx8zk4vVLwL70fUW7cGajSHdxz/6p04XdIF56vv34gv/Ay5ZkrytsdOP4wOMq+rwaOheNBphicTNkF/hfcy51znBfMU9k1z/BwMgWcF9QQnsf1fcGHGcqLmoKCgoKCgoIH4bNxVrlfpKo/HA6KyP5AWu39voezpN7uHe//PsBZFX8WzrOmjyFi/Wbh1+DI8a8Plk0ReWcvTYgtcxvXFrLfOQ5wy7d+x0A5y9df1YKCgoLXD1X9ahH5CuDjs8Phpcx94N+pqhWRbwd+NTACflBVw/PvUeTGU5cc67986KcLv1/xfw9wL0C+nE2c+r+vXlHefOD4BwPvwnma/hJV/dfhoIjMeule5eFkJ8AvZ9NQAvAjr6OeBW8hytKngoKCgoKCggchkMf4IkFEfiYuUOSVUNUG+I/Ar+qd+pW939+C86jZV9XvGfgEK2W0Sr6JmAHrnvv5b+yleS/OWhzb6YNW/opeum/GkfQXBtr43g9C3QsKCgquhIhsvLgQkdu42Cq58v9tuBcMv9R/D8c+E7d89duztI8iN57y50K6dwCfggvIm+NXeW+UgP8G93LlP/vf34wLMvwDA8/X8MLiu4GnJdtpLyvvzcJQ37wTZ6jI8d3Ar/CyJKAvO/9/uD547hLZeUrBhyWKR01BQUFBQUHBg/CduGCFf9NbWN8O/DHgpYe8/k8B/0REvgpn7fxZwC/z5yyAqv6IiPy/gb/vy/ge3AuZnw68W1XD9qk/DHyeiHwezqr7Ph3eoeSNxDcCv0dE/hJuWcDPBH5TnkBV74vI3wS+TETWpF2f9uh6Gf093G4k7xGRP4cL4HkTFzfhVVX9ix/kthQUFBT08V4R+TrcUqU7uOC6fwAXqPfvZum+A/dC/WfidmAC+P/jlnJ+OvCXsrSPIjfuAf+HiPzPpF2f7uCC9+bYxcVi+Zs42fBHgb+aefH8Bdyz+VtE5K/4sp4Gfg7wHar6tcA3+Dr/IxH5n3AvS0J5bxZ+GLeU98+LyB/FtevL2OybPwP8B5xc/Du4OEL/gz8XZOeRiPwx4Cv9y55vwzljvBv4ear6az7IbSn4IKF41BQUFBQUFBRcCVV9Dfh83Hr5rwN+D+5lw49dcVl+/T8F/kece/w/xxH6P+BPn2RJfxfOZf0348j01+Be6HxbluZP4F6C/EO8tfFR2/OoUNVvAP4n3Na0/wJH+n/5QNI/iKvzHwO+FmeJ/mqyNqrbavbn4V7+fBlOMfpK4GPZtB4XFBQUvBn44zhPl7+MeyZ9OW7Z0Weo6vtCIlW9i3vJcIEPvuvje4VAwN+RpX0UufF+nEz4Y7jtqE+Bz9Pu1twAfx63zOlrcbFdvhr4I1mZ93Axan4Y+Iu+LV+B8wz6fp9GcV4pPwj8bZ/uq3CeKW8KfDyg/wa33Pcf4/r7T+GCyufpvge3pfmn4mTnryUtm83lylcAvw23xffX4frnN9L1cCr4MIN0vXgLCgoKCgoKCj748JbTL8Vto/pmxQV40yEi3wSMVPXnvNV1KSgoKPhQg4h8DfAJqnrlrnciosAXq+pXvSkV+xCFiPwm4H8HPjp/iVbwkYey9KmgoKCgoKDggwof6+APA9+Ks8R+Ds5D5as/kl7SiMjPw8Vq+D5cYM1fj4vb8PlvZb0KCgoKCj48ISJ/HeeBeYiLo/M/A/+qvKT5yEd5UVNQUFBQUFDwwcYKt3PIb8a5oL+CW+7zR9/KSn0QcIZb3vWHcfF1fhT4QlX9x29lpQoKCgoKPmxxE/hr/u994B/gltkWfISjLH0qKCgoKCgoKCgoKCgoKCgo+BBBCSZcUFBQUFBQUFBQUFBQUFBQ8CGC8qKmoKCgoKCgoKCgoKCgoKCg4EMEJUZNQUFBQcFj46d94qeriACg/oMRRAQBjF9dG9LkEBQjLq2qompBQMSlVwxgQEEIH5cvftluWLyrgAqoKoigqC9fXC7GoEAr/hprMerK6dct5LVRXxHfRsUKiJhYb/XnjQhGJda3D3UNx4Z8VF1dxSC+30wjGAEjoZ8sgrqyAEW69dasH03lylBLZQxWrWu/CKBY68oyxiAiWGtjPgbBqKMFsS8BMcY3pgVJy6XD+ZAXugYsRqASV08rNZYKRaitGz+Mnw/i5kBog+sHQXzn5X8lXCsGjKG1fgoYgyAY1gjW1ScbV4OgAq1akNRvxvixsxajQuVror5MFcnmQJXPDPcRm+asMX6sBVVDnK2uExG1G/MoIIz/0Pm0Mj38Tv0NYG3rj2kaq/5cVo2f/jER4+Zw7H9o4zyziAEsqFYYKz5Ni8HSaovGfgHVcA/j85ZOvaxNfaDAunJjIoARA1ZBnfVQVbHtGhE/Lj5vREIyd4+rRWlxM80/KxAMFsUSzoYeNOrnBlXn/snrlvdR6Oe87xq1tKKIfyYR+ta6uWSz+obPD3z/dw89Cp4oFDlR5ESRE0VOFDnx6HKivKgpKCgoKHhsSKAemeAXz5r6JHSD7Gog24k4u9/qyJeKJ7bQ4yib9fDEWiJxCgfo1MJnGxWEUKdcyEqe6UZ7fb0VjNFIOsK5y4h3fr34ytpAOOI1gqgnoK6msR+61ZFuvUMnDtR3s59Md6wkGz8FpM0Sk5gLw4PQJXwmjp87aVJ7ETT34ZUsR8kP+hOiaeyJXBbRQH7UkXEh6/c05mF8fW95wp8RX0+6xBhEM7KbNSe1WLMT6hUxid/zC0Xy9KHyG93W64eH0+Pzvs7nXf/cg67rFL5RnaC8CmotKKh1Y2GM0xz7CsNQeUEx2DzmihWFypdvnDZKpyf9eFn/W8NkCHkEpVyyO0hDC5wiJJmCZzIlPhDjqDj26pdeCGi3z7yCnT9SRINKFlR+UFHy/wqKnChyosiJ/MIiJ4qceFg5UV7UFBQUFBQ8NiT/NwoniaRHekJ4mCiII20dy5CkfIb4n6SSlcyyKZmQ9ZJSNBBMbz2NZTIogCMJvAIVzrKoOCItEkS/DIrcvN3Okqqx7zSyzIyIZ3VDtNPPOQHPEcnsA5SVnFh08hFQelYjwRPpLuGDZLHrkHivUojrdE/lnOUxESiNZatk9cYRnMDDA6XR0DjrOki1BQxGLHgbp4SUntz5Cnll0FnjbK/dqY2BOGVtzr4mEp5OCsYpCRpt9wS65/rXxvl2JTnmQcPVvTbllQju5QQ7zeur6uAT+rvOk29NfW+yNHhlaqjSycKrg99zj4pKbVTQNI5f6g8R470JnFeB874I7QlzZuOh4MtMuRmT+iRaN8XVKczfvG5BMauqCmtt9CTI75Nc4Q5doWJQUboeDQ+8FZ8YFDlR5ESRE0VO5PUocuLh5ER5UVNQUFBQ8NhIFikv4AdJWbJOdC2q4XyXTDphF1NECqLevKjhuow45mTEegFoYp7dMrVH+C8lJ1ndcxhxrrbBImyNerIVKIyjsX0X5FB+VABiGulymth+zYxDEvUC1bxFGRkxeTtD/2eEtNfWnFRIIDPadjP3GdjQ3p6vf7zet8wROI1tlbxd3tLWZ/IaEpKyDzpXyFtEkEo688mds1G5ypWy3BIe9blQXs/9O7qxM4wwFnmbVRXU9GZoj1ALvbPduaR+IPttylKzOTU1+9tToIbyh8HzfYLc1W1dq+Jo+t+pvl4hs/1rQr0kzqf+fR+Ifbx/NBzL6ihgEQzeYd1XzmRlqQSXdn8sDHDQ6PzzwSBYNDm8i3oFruvK3n9eBeJdVVWsv3FsHvUNd8MrcdmIFQDbsZI2bUNBkRNFThQ5UeREkROPIyfKi5qCgoKCgsdG5UloYFu5MO8L9dyVVFURU4EGoVjhXNkTqYjrjLM8OkQ7I00S1mN78i2Vc1fVNhEzcGTUeBKR5x7qFPJudFM4x7QkcqeqVNka5dxtN0fMI2uQkWQl7bQzrmXPrWE+j4x8R2KT82JP6MUEQmFcn5IIUSBIOelI1tIOhcziOfSpZI+0aGh0uF59eTiiJL7nRJzbvu9HKxoJeFCY4hiFHCV868Kltz6f7Lh3VVbryZ/xNu2svn0imq9R3ywp7/Q+ic3Hyv3dVOi6ikM/FkC/P0O6VFdP+MRk3x053OiTEFNhIP+87e6vyzvFMrBxHokkZcnlGUipV4SNG8dU38025GXm97+q+pgCGfnOLhMEg6EN86gST3wlfHVWT99Wa1tfhvHT398TCK0qWTQIl3emEPfrHAh3XPLQq7cRgayPo7JnBLFObSDzNqiqQrOhyIkiJ4qcKHKiyInHkRNFghQUFBQUPDaS8MpILilmQF8cB3IULazq2KOIzfLIKI0mq1mwTPqCiaQn8r/o2Aw4MVj5A0HQB2KqWbqAnPRI7/wQsQhlRhfx1AGXXgOK1fwXiMkDEkrnz5D5LliYYrtJAQ6j227MI3WgIxMDVRooIfDpaJEWV4DYbpu6bQzExkZrlUi3saIutKCx4oIQal73ZGvGOotrJc4q3eKsZy4fxXjrVyDgqtI34m72Wrw8KXki4m1bRIuykuaAr7Q/alwZwbTaUUny+ZjNQBWQLlHuEO3LFLX4W7N5mX/Py03k/qq8+scdlzShU1Kbxf/2LRSv4LhAq2HRQ7gr3QWJqIb+7Za5YbXVrqoWClbAxLLdP84ILr5bQx3D3ArjmLUtKs/JxTxVhM5LguF+kY1Pfo8HY6zTS51F1IigRrAtPqSrr3zZWxUocqLIiSInQv5FThQ58ShyoryoKSgoKCh4bARhGH8pfg3upvDvW0sTkUmrzCUjFLkQT3xDOsJ5uEIZPTDi5LF1QtJIvj48YdPVeKgFWXoGK+eFu0ZCM1jBrI4qdFzRhxvVPSvZlw0ikWsOCiF4nTxE3u58YgyRROAq6gJYXpFH0ABUYjNzEhcCPFbWkeqgYbnxEIxfZiCkXVgqBSNK6wNCOrLjiJXxbTUkS+fjIFrg458+sc4JXVACs77SqAKljouBMokKYChrg4zmU2ngfN7n3f5/wFzpjVWueASybIxxVkERP2czBUQkjmVS+MQr2Plc8KMsgrXZ5Ouhc4918kxXBIXEpOHIeL5gNFee3QlnyfXPDx8DID0BXJuitTT+cznyeopI6iPASorOEad7Vsc2zAR/7115vzxBKHKiU7kiJ4qcKHIidgIb5cfvRU6UFzUFBQUFBa8DYhMpEUUlCOggInNCFwiKolapPEmx6UykNcFqlly13cmwI4RmRDooAYE4RcGtzu3Z+PRkwvdBVLRyLCRuj9oRpJqi9EfyoJ4Jhpwls5Z4yiD0rHmSk71g7fFEqMNfEtGJwRbJuZH67SrdwdwSlgLmxcpn+SWS4nUOOqYd1cDGvLF0k4BHwiguP2/4zkhJsn4Gt3I1GT1TZ/GSoNKIJ1+GaBnLw1Zm9kuCA3FYGx9gxZfnFUHZGBsTu7Uzh7Lezi16MVyi5P2baVE5+fZzP1mzc/LsQ2hK8BbP4lXk2QXlL5vbwVqYliT4vrF52WlM4l/xrv1hrMOcUa/ExHmcU9owd03qMp+3W0bglGeVfq+50CM2bIlLmIM9hSN7QqhvZ0ib6o1XroIKF4Yws+bGciXoD917XIRKhxSd7j2Rbz2M741wT2xapknl53XwCUxlvNXexrEqoMiJeKjIiSInoMiJIiceVk6UFzUFBQUFBa8DjSPdYkAEU9WoeqHWE3SRwAXh6ommNYp1bNkTJqFWoVWLBhd09eTemEjucmOUwVlRAqWN6+VVvMu4O2Z77sw58t/Gb9EhAo0XwkbEb9GpiTCpq7dmQj58D0QnWGnFODIYdpUQTyDFG6rCNpRttoOAa0RFIASIQUMgTk+TKr9zhHM3ToQk1DnQVe1YOoOlrPs7bsuqzi3dZLso9JH3oVVFK7cGXBGsJEVCgBol/GjFOwJrPoaKMZka5gmeDdZ0SUE/RZzlqrVgxfjdWky4DItF1FlUQ3auFwS3D4ubPBYL0oIKRiWSu7xdzurtj+HGMOe7KoqVLGigJ9VhrrSqqHFKhbP++fCBxm+7G3RSvD3Wz2vj87BA0LkcoYuhEklXdsck/hXv6u83LxWT7gEwGGkx2rrjuLqiJt6fGhUDm/W/oOruwZBfP9ZBVCTJiXjWp+qpt2q0fIY2xceDMRhV6kBigzITmx3KzfP2iq5UMS8j4nblQGk9Oa/QLBvt9FluTXbnUwwCIO0MhDiLbPYccDUNTv+afQqKnChyAoqcCONd5ESREw8rJ8qLmoKCgoKCx0cQVuEDjkRIn35vQiEGCAyu4Fad+EpbLUpMG4uMfyWaR6LLauRwqeyrguZ1mxKlKUGAqz+eWzhVxFvjUo3EEzUCOQ/KhAiI7Qj5cJ3x2056k0y0CPZdmIctLuqrmq909sTb1y3Wf8MVfVjxeIgu2kDsW03rxUWIW9LmitJm7YnW3mFIakT/TEaWUupAwgLN3cgtjSfZdBXBiOGxEfvZZWqSroER2XS392RRJPW5ZvmEv/aK8di0Pg6kGejZzv2keaBVb+GV5JwvcfeKMNdysi0b8zSvlzGS2vaAidX1Qhi61/NJIg9xL4f7WLK2dYpIz5Dw7LnkGXGZkt5fAhOvlzAPXUkP89x5IlDkBEVOFDlR5ESRE48qJ8qLmoKCgoKC14HA+ATE4CLqR/PIlSTc+kvV7YcYhVhL5CiONIlze8/zctYk4lHJ2YyvFVcI1o1W9MlEDEBHzDcnjeqtS87A6y1tkT14C47xNQ47hWgge66s8Fe7G4vEOlxOrrTzNxKKoANll0lGXhKZHy7jCi73UPAqR9ztJDvx0DkAQSujw0izFB3yRGpHJFtZtEfNrukQu6ipSKz34yrVuWu34G2Z1lkByZS1bt19/YzXv+iOat7sjuo0QAAvQ1JHuteGUvIyQzvccgTXl3VPiX04JU5j37pbcnP9vUj3+pAmJ/qXt+hyUryRf+jYh4QLmKmXKqJ90j3obaFesZKua39BkRNFTqSyipwocqLIiYeTE+VFTUFBQUHB48OYSL4R44V6sCxewbxybhUtlJ4kIjiHeJeb1SRkpUdkNSMpCpf8ztaDi/9cIRkVb+nBuflaXPA5RLwJVyPj9VQDifm7612yQAlDusyCiOL9cX0/pj64Wrvr2XwkWChDruJL90c1NDmRogehSzR8rhsEK1mIAhFxMSO6LsKX1dz91ri2PJWb9VaaIITYBCLdoH0xRWqoV7wkLfQX34ac4JnQf66RuV112OqnsTTn5u5mWLKg+/JtRnklKT9DSEpDl5xDmsfR5f2SOdFXqjbO+3pEa3YcE3/PhparIMbfuz3eOmSV7Re5YbWWTUt2XqvcVVxE4njma/01PA+UTr0vsxIPKZhBC7tUld3IK90j/bneL2tjfqsmpVpxz4zXFb70IwhFThQ5UeQERU4UOfGocqK8qCkoKCgoeHx4Yuqi6EvcctDztg2X5Y5A8+RbALGOjIkIVRBuIbidzawSgUiEMnx+1n8PYlJTgZGNZ3wucLKIDbLgy+pQMxEfN8/4bLN6ZnmJcW1QdcEwxUh0Xw8fa72lShIBUE8YDJcI/Vjl1MrQvO65QEQCGRRQV+erCGEfXcIVyGs6l5MXt9beb4waiHSPgAYyGPPz1UuEx3+XLvkOBDyUtUF+1Pe/ISpZwYoaFJvgbi6A1Tw2Rbe9Q4TLEalAGF29wvx2ShWRf4Oz6oe4AZdR47D8IClwntpryIM0TxmYCwNkd2MOq8a5ahU/F4PaCPg5GWJhVGJi8ErYjCnQLd9X8JL65S0fIuH5PMrbEElzPCf0iXX/OiASePFzJ/11dQn97XbgGK7b5QpDv+2yUS54S6sqVi1GiHEjCihyosiJIifC9yInMhQ58SA5UV7UFBQUFBS8LgyL3h7z9siFqaq6QJGRcuaUy7m851YbI46qWNpIOB2J7dYjbIeYF9+vYxDIQ4iHc+HsibgIiHWhBvO84w4WZEJdFVUb1/4HchrT+XoQ3OM9owsEadBCFRnjhqoRr4/MI++YDssdbncqKxB3d3EgHH2OtWGpyorPLu/EbRguOkscv3vFLvRSyNgTye6ASlze4LijJ5CS5kiILBD1PiIte0BfRF1ss8a+r8IunwKRdLf5hL4CoV4uiKREMoyEYUvE9LK18ZdZDkPxnSH3moMAomGe+VPWKxTq+0ZCix6MXDFS1Q2CPZQ+h/HLPsK1PT0ia83mtZe524u4NgZdzvH57qj3+66v2DwI+fXO4ttEgu+s+5epYE8eipwocgKKnChyosiJR5ET5UVNQUFBQcFjIxdnKUyg+9XhU/SIZGaFMWErVZuxo4w/RsOOpusU/Bas0iHAuUt73PdAcbswkBEFZxIarFusoyfDgrcmaXBth2x5e0cRUPwuJf5k7s7uC0pu30FoC1i/ewYiyb45SKgE9bsr9GpLpgJsXDV8/DIEEh76q0tQNiyV/atD3zxscVfWU5JSEnS60L9Ze4NV1lnW2WiqeuLpdBNN+Qpor6KbhLZLogRv1Q7j24/mmBH/fhcMUGi3cwdpd5twbbSWXtXXvXuqn7cOpI3LEHCaRSDcihs7o2GpiF9HP1hxGSzbkVDbmSP5coDQCznh7te929z+XOvnOdwH+SVO2VZ/TJJWkl17lTX2yiUDWZpo/S/YQJETRU5sXF3kRJETRU48EOVFTUFBQUHBYyNYOUNoQFVPfL1lsPJczq0z99/VuW0HF27rLVuedeKTOVEbLIxAqza6Jvcq4dMGt15QI7TWbWUq4kiFBCLnL+js0BEy8r/Uu9Ebz0CqnPypI0tB1hpx/7TeJCUKVahnZj1C1e2Q4NukeGIv4vvDN8ezsLCtZegMyUx2wf3fkaPEOCV1hieXkcqRNBvtEKZYv2iVy/pWfTMIl3aJVvgOQSHCb8PrxjzGExCnOgSlKIy5SNUlRqFnfFWt30jWxjOJfMfpIkITs/BkljqbRQqRdPtRE7+Egqpj5R6Csxq67V2NFT8u0ObzDXEBH/04inX3Qdh+NfWpRsudi9VAJN2NEa+AeWthUGKz0e3WVMCa7Lwns5KX1GbKqMvXBTlVWu0pINa1xYSspXX3rfoxBZyPgGZj6xIbr5g6cq2O8BpFrcF683Ei5Tb0wgbJHSLuqpskO5+jG2Rc0lzJ+zrd3v3r/Sj3FJROnmySdBGhqqpIvq21fvxib2eeDU82ipwocqLIiSInipx4dDlRXtQUFBQUFDw2JPuvSxYCcRMnhOIWiMll1UiIU6DZRTmJDN8T8czPB+IigVc6dh/ZTnAvFpVIdvwBbLiox+UhFWWQSJAiI/T5BAuo22nEk6Vwsd+NIuNc6U9uJQVaaz1By9ucRzxQYoDL0NZAZkIdskYIydLq0gcVKSgHPugeyVU6d+u2vWtVs31UOhYjP3IatQNPPhIpDhbt0OZOAMlIwMLwpt/k3Z0pOvFkJO9OSRFRVr5NFWBCi+O2oo70ReKeza18rsWWbVjh0niJOqXO+nGJMS/89NfAQz0Nq/LMM6If6+DnsJVAjENGbh6lpRmBfOdEVPywhn7P+h9QWj/Wad6EjVJSbINwL/l+UfVeBY5Eg/UDBCImZRBbH5Qr42+UFmMEpI3zwNXVYIxTtmxGtkN/m+Au0R0JUgyNq9HXycOo50TfvQBIimb/2jAPBz0UNhSALkEPx6x/MKmPLSKm2sjrSUSRE0VOFDlR5ESRE48uJ8qLmoKCgoKCNwy56HLiOBHnaMERnHlRckZCZk3skkJIAlAiB8ndml0+Vg2qFrGCGvFbtfbr5NdFZ+RgsA3ZqURUUy7Bi1mztJEiSSDtvXwHhXYi38O1uTqfSIBjzdJfwa3pzutymStwPOb/TaQk9XKOq9x8HxYdd+ComPVcmCOZTD/dRh2e6LgMGO69MGeSYhaI3sO4KYe62M7YiLMo4sir8Qw5zJkURSMpgvFInFhZ2b2fefoH8067OYele14H8u8njX8j+c9TGNJ8SPOiowtcWk/Xf0YENcb368MR6k4ukqz5D4q/MHQub40OHH/QPXFVnn0YQP12q8HJoWATRU4UOfGwKHJi82eevsgJn8tHqJwoL2oKCgoKCt5wBGLU0rUMqiphR8wkkNNFEv5Gbp4kfc5fxNuHxJejIs71Vt0ZqwwGilSN9p3uuVwI+/PheN8y4moUyB8gxlt9rXeTJsuBzlrsIStcJKKByD0kuR0kHd6yGKmOpoB9qhoDVqbyuwj9EixojkR4a62ks6makn1SfR6HoPddijdjAGT2L0k9nFt3g+U6uDDH4JCXtDed3KxLmLf5OclIVRjn5O7dOxaut9nF/nwan1T2UI89mA5m23rmSmP4/YBhiPMta4OjyD7ORjC1+jEO7t95WzqKdCdnR+Bz8h69GR4RGyQ7H8v+/Zlb5GVzS9ehvIdwGdm/TBkIz67OsfKm5koUOVHkxKOiyImBPhmucYYiJz5c5UR5UVNQUFBQ8LpgrXUWuZzYeVLcJ65R0GcCVSG6O5v4MTTq7KyJrNOxlAZBrtEc5NdAe4JTG+24sivezd10ic0GyQ7198eqquuW2lEo8PURHz9Ag22plz5D7r4bv0cCpJGwh2v7FtbLEPqVLmfsXOv655K6qRsHZ8XO1AxJdTWYOG7GdOvluu1qq1O0Omdk2xcd/+2Tb1UfsyFrqVWLVMmtv2MNlsQbTSBMgz3my+/Vs68IhO/B8lWJiTvG9HcqMWJQa2Pk06hMkLYGTi0lGyin5BhPeg2CMWl3jyFXa5HMPZykwCWSW0XubCJR1siNxbvEK6DWJiUlZEYaVxBsCOIasjBhpjtXd42qjyfvBBf7XA1SjAlEfrO/+/MnjH8nzoVE9Td2RFAMgnu8ZPnlJPxBZLs/L/vYsOR7GGNcGZoWmEQFrAAocqLIiSInXK2KnChy4uHlRHlRU1BQUFDw2BgiK/G4JxIJmUVGUtyByAkk7GyQrHX52mFrrSMBeH4jiqqPbeCtU7kTu+QfJ5GHmelAe/rHcoEcSXdK4AWvpz+BqQ3kmRPrqEtIz8DykIR7KE+bEWZJCbrV7XVCJBU56dD4TyRmSkaYe0R6o22RpIfIkbn7+Wa7RIgku0+CIinMTH/RSuv7zmi0m6O4pRQxUOcVfRYaK5likpcreBorzhJvBD/P1O3CQtIHjbjgoFZBfNDQuGlpqvqlYx2SuSH0W8n25l63f8J9lpPvkEtGOHuW0KCghbICCc+tw2pDXAFiWTF3o1llE4lPcRxc7urjXKT6u3gGSed5ODI8dMx2L3DV8OPtpsuQV8Lmvdw/dtn5q74PWXD7isOTjiInKHJiqG1FThQ5UeTElXKivKgpKCgoKHhsDAmszvn8Ry6MM3YcBH9yB88IXna5MQa3c0XgvIoaJUXPdxkrubt7qqe7yAbO0ePQfcF6eZtiBfKmeQtJ2GXjQUT/yqzJyNAD0LfyPvpWp1m5xrgtRAUf9DBTOkJ/Zxa0BzWyU/+BLr1M2Rkk9b4O0hlPzx81kT/vvBz/Tdvj6hUkbFMhyb/HYKFZM6w4Z3KluyuH8fXh8uzjsVwBC5MyfI2X9K34fcQtVDbLcXdByGZzPifC7MvNlCSrSiWSmH1UhFOFO030SokjvuBc2cMNHiub/X20iRq2aWWj5Kyr4/NiczyHSP1l2FQOH76uLoamf3GgUoIJexQ5kdWXIic6+RU5MZR9PFbkxMPjI1FOlBc1BQUFBQWPjVwwDiG5Gmv8Haw7rZfvJhyL5g5AnRuzSZei1rptUHEEIQTdy8V6+BgJ9MML+0CqM9mfW/uGLH+uwi7nvgut+yMxH3wbHo1WhDwvE/jeTTxEpLwic/HEX0Q7a/FjSZqOdYg1Lh6BU24SkeplntVHPKeSgbyGFJfNPhnu4359+1Yuz1g7ZbjdRlyadNSRRxOVoUDK4vzICO1Vqla4VlQx2c61mud1RUM2xiA/5gckkuRL5s7QvXWl8kAYE8ny9Nb7ASJpcIqEu87fC4LXZExvLuQkVoIuHM+5+6in4GT3f1SLsvkU78ke3G3n6ty1mG4S8HhNNOt288/v66teGDwUOc+Vj/BPul3dcynzJihwKHKiyImUV5ETVzWryAl/oMgJoLyoKSgoKCh4HXAu5mZw20QxYCW5eAtgKoOI23UjWJhCYL8gWGvwafIgAZacjTuOUKe4AurKa8Vi8UHcPBGxAnjCLuK25uzUU1LQt2jx9G676neMcHVUXy+lokfaM4NVh2NkCPnXdR0TW5TKr5W2kYyYaJyKrttIFP65Q68Rk1lmfamJaSf668u2kgJWCtnuFuE/xW+76TIK8RQCqWnFBcLUrIzYPlHv8w1ChbZha1S/FlwyAucHTvzYKmaDvMV6emLn4iYogtu+U1QRjOuRSIzVKyOuF00cEFemG0t/Xn015IrYBD59Y6zLxri4B6opAOXYjNBaUSxrv7xCLIg11JF2qlMevSKoKmAVFTfzDeK6zsfxAKG1Xgn1xLDvHt1RUrLjwQVfNcQ7qOK2sEHBdbeEYMV4Jc9SVeLnnHbuF68ppLoDokLtv1vvfZDSGSSswxdQ493b8Rq3H0e3pW82n0UA40NftLH/BcFKUnqwbprl806tjzuQLU0wJhBvxZiqc4/HeRjThuvymydu3EweUSRYxMPZqEBVFVXrN+RVpwbbB5DwJwVFThQ5EdtX5ESRE0VOPLScKC9qCgoKCgoeG+rZWd/KEHlj2MrRJq4WiB4kIZh4Zp9skrGLVIaKIGrIbVZqNcpJx0kTobBZdkPo1t8L3Y6Qz+roy7rcVVY7ZT3IStNx8x+k7r30WRpn2cqvCda9/Ahx+00jxvdP13oU6hGIdW71HeDaXNadotmyBMnTORITqprG1ylwoczLt0XNa5MiTITSAhlCJCpleaUFHIkLF/b6OV8asDGXM3IfyHD4G7QzxToiKN6t2ysArhO87bozj1MFJcwplc5csKTYHf159jAu2oE6Jh3MKSLhCusOxnOiqU3B8pwbWPNlDI60+37LygzjH491hy1llvd/Z8II3YklWJzyoRjvPRE101gvNYGAS1IypF94aE+3zzbGu1N+1hlJnaU7hulbfl47d+qTjSInipzIUeREkRNFTrhvD5IT5UVNQUFBQcHrQG5N6EMSCSYQJi/Gsv0r1Z9U6wPvBaG/sWdhlxFHkh0OabCS+aOZJL1y/fZAvbv8Lbk2gzgX50uJom/1JUUN1eEqF+WNtD1+YoWNsvLtZk1GuMIA5BbIByFPE9ffa1oGkFe92hguifUVFIOJJMzTod7n8RF2eXFTxs2tYOV2rOuKiwfO50S3r6jkfacQI0UqA/Ms9HdoZa+cvnt2PjbBmt0n2/kSjI2mXNHMPuSKPIW0tGFoJwzFzT1I3depjQ5Zny97TgylCkqZr6sf124Y2HSB9Zw8BNZ09Rq4N/OxG7JiJi07XOGfVxIHT/uj9tCK/ZOMIicGW13kRJETUOTERu2KnAgoL2oKCgoKCh4bEkiOZNbP7HxwNcULd7clooDfvtNZLgJ7CmufxfO0TNApJLfSTCr3LCYEa5sqam0k5A9uR8+KKb3NUxXvQh2oFB3rWjczOkJ5cx19FykP2bh2CLpBZLL8o7Lg0nXKMy7zy4hJXpehdgWFJ+pGPd4ayW8YP6SjngnJ3TheK4J35ndNzy13HaLUrYtmbQRnlYw0XnwnqndwF+KOL0Pd60jZJsG+rJ9yt2h8HYLHwAaRxyksm8rkJh3NZhbultHoadAfj1i/zLe7U6+YYfeaDkwYzWzb0OzaTEfeuN7S26kktDX2yWX3XBilgfOxAySbQ/jnhndHty3Y7H5xDXfBTb0mINXlSxT67Ri2yId+Mb5Cxn0k/O42J1f2+7mVXZ8cipwociKeL3KiyInYJ0VOwNVyoryoKSgoKCh4fAQrkI2MKp1zXCytuVac8AyC37i1uYFESSDO3o82bG/p/yeJZHe+z2kCoVcv9PJ1yJvVHiYI0SplTOTD3gTWI2hXdEkgfT2C3rc4GV9G16W9W8c+4QuW55wwkl1eZcSpk+0A6bjMAtcnv9FqlzhnzDycC1vieo95RMwmCRIX1FGtYkwWv0BSn13a7gfoUIGOqYRBi6oCztrYxkTRkp71TVh5MQRr7aXWtWDNzH97/ui+a09J9P9kMznljVBVPu5AaztKwJDlNsRZSAS4rzT0FaiuMmpbty2oest/Z8cMfw8GAhyOxb4wrm1WNWtrtyyii342hjnJRhBxxN+VLfG4i1XQDeLqeiibhNl8McZkilCaS0NzfdBCmnWZqCCmRmlRbWNb3BPIKT0h2G3oE3BKoJV0vG3bh1L+nwgUObGZd5ETRU4UOVHkxAPkRHlRU1BQUFDw2MjJB5qRObr2EJMJIgmWH3/eiNB6sq2qiCotxhO+INjDuvhkeVAFYzNy44m+9gnWZXUfEI6BQKnYSMAD3clbHY4+rBU21blLcAMBTLkPk4OUhwtQGf5Tbx0KpDyPtycQgyAGheBh69wvVzW3z3qGGcxEgZ/k1/m/RsRbwwURG8mKW2Ye2uotXHLFMoGc0GaFBIXEBCVNnHtzpyKd7NLM6NHTDZJ/VT/lyo+qUtUVFmi17RJyknN4v+QQ2HIg90SGw7hmSOckWoCBFKQzQPttTPMvlNNvZ7SSI5fMxG4fSGbl78TnsPmXRMDD+WCJFKOoptgTjuS6BRDqg3HGuRzqZPDKnG8T6XeYA/16XkbAN8Y4BLEUF4C0j6gGR6UHKjFRWXB1vjyOxZOKIieKnChyosiJIiceXU6UFzUFBQUFBa8DfSGV/3ZWBCNBfBLdkKObuzEYMXFHj7CIXCPXkkhSM6dlz8l7BEL7ROfRIJlUdevWg7glkfEo9GXQondV3rlF8mHRJw5hJwFxlSAzRKX12Z7pdIh/bEO37EHLX+8T0lhP9sVIMJR5YpzWoQcjWswrMrJQN3XkJmQQx9R0ysrbfZmiJDFP8PpS3HL2QeQxWtX14cajT1K7mTlrqvVzRtEYn8HNmUTCMxWGAQfpDausuWQWh7x73XtlvTfKIY1v3xI7RGQ7xFWJimCoQ1R8pD/24sc9Gxk/9hr/SlSyRAyttU7BCEp5vDUVFeN27JFuncJMqqQ7yx/rhUmY6/mczMrJWhYDgwa1vOz0NIQiJ4qcKHKiyIkiJx5VTpQXNQUFBQUFjw3R5JqcxFDiBMYfi4RJkxhL8jkQuuSia0TcbgGB+UYC40meOuFnTKBhyWISarAhch9CBkdLKbZDuPPzSs4+U1mB/AdynCMI8aHtaYPBMXfx7p7OXJc7pCZdHw6rhgwlXSOBnDq6lOkrw+0fQHRNzslNYN+ByPnzYb1/VFxCQWJx21G6Exp6LiT0jcjd9wXxJFSyjurU2NUv7wvPbOO8jP0a7JKZgpGlC9d3+yP8kw5o77zU4rYfFqUylVve4dtnQvOiuhDKD81JCzXC+UBEVWNtszHISWcis+ne2FQO2DgXCLcb00Si/dwPmskVN0yaqnm7fD00v/vC2Kf7OHSM2NBW09Ek1I+z+tgiQdn1NXfPB1z8A40D7dqSRwwZtACLDM77rqLr56kn/nH6xn/CPAzjwUZ/aby2vLSBIieKnChyosiJIiceR06UFzUFBQUFBY+NStx6W+eeqzRqqTxpMiJYCcEgPTmTJHSt4NzPxeVjrBPOgbQHThasqBryVaFCqEVofZmNd+cNcj4FdHTYJONXuOwqaeeJcCgQ7qpyhFI1uvBq3FrWbfvoAhami4PwN8Z0FBGFuENGIC4IxKI1EAxvffONsyGxTx8JNS5DBR/fgUiQITjoNnkneIWgz0C7vSUSiJrfHcQTCyMh4KeAVISWBHIXclJPWoy1vu88ace4+qmnU+rqHZYkVMZg1ClbNvS1b5KqC1IY4lqo+J1gfLnGpPFNW8kmJS93w8b3G7GniN8rU9Gi3kqcEaysi6w2iPHzzfo+Cc00gljJSFqYS+7aytSR9DriaZHY10GbCPXftMxHgpgRyHwkrdjYljSyLuhiaxvX31rT+pggQLT4Vr7T8/LiLjaxUq7sMI9DLAK0TUph3qm44BStWnc7KVRUjlCrYtX654K6+0D9mIqrixhDBaDuiWB93ur0H2of8yLUL4+nkHsqXE6MFRGLxKC3fi6rxVQSebcLYGvjBG+tYkzlFcxw/eXk+0lDkRNFThQ5UeREkROPLifKi5qCgoKCgseG9QI23w40kOZceG9YcDyRs4HMGuP5jSMZBk80rig7usO6DCOpDtbNPunOCbkjctnvnrBMFrx0TlWjK7AxxhEza1GRTmwFenkP/c4tjpFUxlr78iSdzN1yN3olN5l2G5H/SeVKStDtg43UMc8hC2rfYreZRDt1M7EQ6aoo4lzAQ/phtUk3jnTgr4v6Rn4Kv1uFXxcO6t3uL+m3fhPwpK2Tp5DYWG9uDWUXKhfmkq/zUIM6fd3Lu1s13ZjDaY6Ef7Nre6RdjHgrZebJQFIKoxI8dP+yec9AiDXRvQEDMQ9zwZWlXQU3TfuURvDzoqu0dDonV3SDQkpyhe+T78t+ZzXJ8sz7L6TfaHLKT69I8ISjyIkiJ4qcKHIioMiJh5cT5UVNQUFBQcFjIxLwcEDE78LhhbrN3IdzAezJh2gmKH0mCrQMh8/rlI3GWHQi9AjSG4eNdeeqyYNVZIOcXLZWHgKR2HD4dRZkBsg1A4rEQP6PgrS+/cH59AyEG/XYJICbJAcCofORKURJW+oGJSqbMyG/3t+rIBCt8IOUKiOfr7f/RHILqySXfYb7NJDtUMeoWEoi93ne4a8MNSZPr7053+vvnPAP5ILNxy9YkIP27Al6cgN/tBcQIThprAtZXb1lNdQ/vwfinNCkeMRWBQ4e/4k3Yf4ASlbnh8Rm7IXuOcj7VjeujYqsgm7MgfLiBoqcKHKiyIkiJwZyL3JiMH2O8qKmoKCgoOCxYYMU7ZGJQKuCS2l/zX0UbEEQBwEfspNER3Mh7S7ykfu93NWMED0utXoQae4rEW6b2bDdY6zWpVatPL8838B3EofwxELTNaFfL7fuxBIetrkbRKNfz0CkO0a7DuHu9g0I+RBv9qdBnBN6VluN7u5um1aJCooCxitYFWk+AR1LeCxHgn0sswQHRk4W8PMRyHccy+yP5ueEqKHEIjMimP/e4IxD5fUUGpEQ56KbboMU9saIWM8ueRaRbiwNFR9U00bLqAAmuD64iwbL3iivR2JD97haeGVa/fOCMIZuVCyJxMaFEN6iHed/Gt1MUU1zMemTm8tJhurd78dhJSMd35g2mfdE7wqQEP6zLH8KKHKiyIkiJ4qcKHIiXvHQcqK8qCkoKCgoeGxEUul4CAbjLJiarQ2HSMJFxO184LffNMYgwd0Y3PpncdZW2iROpVceOOId1qR3SIgrsEOcB+vdO94hxj1CEeMGRNJje+vhXcDKnOAMld2pP4mQEINtJhp+WT6X55kL+6sVgU1LqXchlkRg850lhqzd1vbJ2BV1U8Wq8aw5WZrTggRBvDJjPWFz1lN8LILcBd6nz/vFdsk8moY3ELjU3G5gxqv7KPVNOP4g1Vt8ZyRC6eri7gm/jn6gvDDnrLXxuxHj+ah2jqeCUl+4bs7mj3grrtOmkmJl/Xc1hNYYAbIAnumjnfp1ysjmQrhnYr0zBS1XsMXfM36jVVq1tC5l3PXH1af7XBFCkNNQvxAJVH2cjV7bRDoDHJ43/bZAN3Br3r+u2/rk3NUkd7EPikFQHOk9AwqKnChyIs+3yIlQXpETRU7kfTSE8qKmoKCgoOCx4YIihq1AHQFtSYQpkIY8WBtkwjv8zuwfKQ2gyRW4AwmBI5Ol0XM7L7CThbFfJmwYnzZwFeHtMP6unL/8mv7lGfXMM3CBML2l6UGVfMPwepXJnKxebsVtxSRKFxa4o6h0d2EIuQTVa8PKeUkR6pU+sq1+L0vn8guE+uE6OpDvREsf6ioQp5C6OdwlykjXtp7fI0MWupz0huy76fsXkJtvO9fWhHuyJViTFROnt/Qa2rl/HsJTJJ8Rkv2NASW9MqKhb3pzPsZAUNeGcD9nakFWUl4CPMoIvV4IfeKd6lI8ahyKnChyosiJK68qcoLUZ0VOJJQXNQUFBQUFj42w24IARhUxzoKhA4KwTxCicJWUKrdHiJfIaV3+JoL3reM20hHJpkdW+sKwb1fs59+3nHbqHQjKJfW6Eh0il4iYy1uj0tHh5pp9iQdfH3GWjBA+KK8hy2LXinp1WW4+VNk4O8uVSrdfs9mCN7I5r3GTK0SdhG6emETYHk65klhGLPzS9GTj84jj7S/QYE8zXglRv0MI3b4dVPw0/e5aSru16VsAkaDY9tvj1VMV1NulrR8Pd9i50ldXNeuqAQ9WxA2tOVS3ez/FILMDJDxe01cErA6M2SOPzuuDJqUsjHEW2fXNrcuHOIqcKHKiyImrCqPIic4590+RE+VFTUFBQUHB60Dl5bYCrYB4q5AE4WScHSG63Qbrh6Q1xeCsrW5XDIiS1ZOBiGDhyshoIupEeWe87aJvmc3dlFW6LsbGb50agtuFOvavjZaa4M4tvl7BdTj+1EigDVm5Pq2IYFEqb2XRrF+yHkh9lclyVZuRsEDuQtvDumfXITkpy12002cT7hpAjCdj6slGfoVmObmYAiJxiLL25jnb2E2mV3ysUcxDosUbvxVrIpQalTYLMZ3r61S9xJv9mcwN2XFXt/I+ajuhP335Fr9Li6pTLsXVw/p8YoDSjGg6guwdur12qX5MBKesImDdPqPEFvl5USHZdsSubM372isPGufc5tjldYmNMoJV79HgFZtgnbaB4XoyaU1WxkDeXffu1F9uu1FQsQQu2kkaSCq4PsrmgbUWsSl4ZD49tHcvtyjWhL6OtXApBfzIuKdAtqwlr7c71lME0i3sf+edK4lwa9hi2F+koW/UXeOXCqg+ONDtk4IiJyhyosiJbGyKnChy4uHkRHlRU1BQUFDw2DDWkQkbSIUnpEYEt2w6EMokikwuMsV/E7puyF6AS5YmuMxLlo9NRRIIZyDlyoCLL15YxmIUNY50mCD8bc+imxGPaBmBrsSWsP5ZUIl2sdR6T6LbAWKeW2LFE7+cKhuSJVLVxuNiHBm0OVHyfRhJdESXNG2S70SMQgXFGBDB+jKNSqx7N09AW5CMmAxQD1HrlA/EK0kkbcr3vTEV4glZbkLMd/swBGKj+aVp7KPCEU+kOkXSGrQtZxOM7Qa/PWs+z4gKiPH1DeTbrzrPCJ4nhZFwAp6QG7WOdBtFjWKxGDEoBrEKFoxJLt6uu2MEBp+piSECHDElLhcZcmm3imO5XsGMJLjVrG88YfT02BF/cYpe+J2Po59bIuLq0iPgiWYbuuqDpj4x/ph4DwvSfJXsQ5493g1eXf+pteHhkOlQgfh2lYW+14OLNyD+furHFugrjlnMgyxdrigGZUDjA8v1Rx7z4ElGkRNFTrivRU4UOVHkxKPIifKipqCgoKDgsdEakksqRGtSIEvBWhACDkbBCE6e5cJ9k7N14MgA0TLhZF2yRqT8XaLcMhoQyW4MDCfeuui+i+CDzmXlhnZkVsxA+oLVk8xqk2zDjuOpJmKT+PqQBTM0Mqe2gma1UQSCpca7z3YDKEqHPQyuR78KXqkQvEJkXDnWWl9Kd1eWvgU4EZjN5Qt5FWM/+GPWj0tVVQOWrUvQYWjdAgJxdFb0MDm7dRjOrItE7jdThuUYYkzs8/5YimecOUG0EK3pSYUg1jm052E8MnJr/lBsDwTnrRDmKCRF09+rieEGR/agjLRXlJkpBRraINnfAQUsaZFZ/2yqhg+Coqj197EOjeVD5uPrsXkf5scly98rR3T7Oc8nKZWCiMVctS7gCUKRE0VOhHKKnChyosgJHlpOlBc1BQUFBQWPjdZ4URxkrmfJTqYH9287SDbz7VKhaxHJLaLBzdyI+24kEJpgQ9Ik9iUFrIyCPSPiySrpbTkS3JZ9WlLMgsvhthhVegoEyVrqC3MEyBOt0Ccxta+XtTbuKNCqxUpXAYjKjQJqUkcFomwSkRO6BCEvK1ht+s3bcLcPHaGpjzDGl5+T6qTs4Pm3MVlevT6L5cbx6BKZ3Gr8QPL9AESraZiLHXKY/yY7djlC0/Orw99OTgNKn5E039SzThHBBOJGUEqidtZRoq5oZSyzr/BEct/X7TQRcLyi7MozmdoYNrodKDES/rBDRr/vgmK42Q85Xs/oumUOOPeMh6btWdnZ/MqfS8PLAXqaW6hDdu/mxzSFrgVRzKNX7yMSRU4UOVHkRJETnVKKnOBh5ER5UVNQUFBQ8NgIMjAQT8GtnUadq7XBu9wGGuTZivsTLAri3FMz4qEk1/dgUQE2tjUNK+19sg3JvkGGjIlrx2MQSZJrq/jF0K4JXSGdkFlQMvITyw9kqEeMNiipPx7Id7LMdK2o2rkmbf/qSFYI7hfKSe68uRUt/U1byG6sLcfHftDkYqytBZNZTvtkJGd5mtyq+2UHN+No4dZsPuTZ9ax9wV3bWpus25KUhTD3+lB1AUuTlTo4wmscp0h8e9fndXfj6NsGuTG4M/f69Zd8bnkrsxgXiyNY+IxUnX4LnWFEMsXOufaL73vr4xUYYzpdP6jASNi2VWL/k92HllxV8xuhekugqnO3l6BADihULmaB9XUVwLi4A2I6HdNR8B4K3hI6eErdkpHsXunUqkek+2WLVyYjcc7uzajEZ9eFa2LVs/nS75fc0uqO242tiZ9UFDlR5ESRE5v1L3Jisz+LnOiivKgpKCgoKHhsWOOIsltLLtEZVgFUMVUgGXZDADurpxN56oVcLk7d8mQJ+z7gf7rrSETZi37w9ehbOvuEStAYhE/Uk46eYST+1ORqHfOL1emSzOyieDy2OLTDKw15nTouseLPeYulIawBl+R4H0mGJbnYRnVmg5R0yLyycT5vmABxTX4gnsF6irniWukO3iUISsBlrvadpQN9IpWTKVWndDxMobHuaf7FuXhZe/I6+XQhuCJ4Yk3g5sPtiUpZDMMY2TJoCIzajTsRzkumJSQSKa4NgVjHnFOb8jpUuHLAhRoIdQpeDVYsMcyqSJzTQougVFUiqnl8A19Zp6z69Sza2cUiqSYdBSyr25VUPGjpvb6MZV9yscs+K2OA8Id5ZPvHfMaZftU7t4kHWfSvuvZJQ5ETRU6E9hU5UeREkRMPdy2UFzUFBQUFBa8DgRhWgXyrC7bYupNJAPv0RkwKhKeatspUiQQ05ey/KY4wuyzdx0tKg4RNEXxdZEPo94mcqLPmdvLKiHdfCD9WvyTDV6f9wSM8J92B3IR6VkoMFGn8RYnM+baKt76Juu8uyAFu7fgmgR0iiP1jkv31tXsYfpquzfp6iIxeef0AecrHzyDRwpUUgsvrEgmb0okzkbfOFSQ8sJGBEGaX5jmFsTRZ/bp18bEVCJPCz1SFYGkMyzY225IKTdbXTBG6ggAaBKNh9xHvwYDiN5wACdEmc+UyhON0O7T0CXjWcSAWiyHtepHVdaML+7ERMmVmqN1VBcFCnucRyn6dCPpCXo+hem9emBIFS348Fc3o4fkzrAQ8iShy4pJ+KXKie77IiSInipzooLyoKSgoKCh4bIR1/oLb7cEJNCeArLdo5a7JSGa5A8STcFX1MQV6JDH7HglzJCJupb0hWIJ047poeczRs8RI75ohDLl/x4uEjqt9N12Wb+QpXbdusjYFC2lIGmxOQczHKAbiyBIobkdR6ytRbfShRMtb4njecTkjNX4scmIUmheItYaAlTnJSmU59+nQKX6sgwt2VMQ2ybNL0VWcun2YXLwdGTfELS0GEGhQdKNHBsa2R8TzM7694RMCkQZlMVhMJRvPyyB4pRPrQy4GAu7/Fb/mP+gB/Spl90QwEHcViDypxGvctHDqmOffzuoumRIYdzMxaVxUMd7Z3dq2t9xis/uC3hSr1VMMLrN8uzFKdDp4B4TvJj9OIvDxXhV6luuHQ1Cww0XDyvblc0NJz7S8Td3+kUu+P7kocoIiJ0Jdi5wYLKXIiSInhlBe1BQUFBQUPDZqtYhfo+zItXjhaDB++9Hk4u3XRftrnZjzwR89A9ngH0EYB6EXhL0R2rDpqhEqCevSA7VRsK0TuNpmFlNHdqpAzRyjd+TTX6++HiqAzUSoZxs5B5LsE8v3TE09Q8n3vwiUQ8N5wMb4Ae5jpY2Kg1uzTnTjdhbjLCikOKpS+VJsZm1OlmeNpasYrPghkXyNu48jQeuq4beldMEDc3VA/MCFmATirdwGawVjFMwaoXF5iYBWoJ6ce7dsF+KhQhFUKpzq4JiiSAjcqWBd2qC81cZgWxv7x3grqqpi1Y2ZFefq7dbOG9zUSDtT5DTQ+LgKYYl4IMKKdbEzRBCb5koYE3DBFlVx8QRwczsSx0DWcZbKsGeMqHoCbF2ZPm8VoSXL31dIsskTxzO7SYY2i1CVOLMa9fPM+vr7fFxelSe96rbERbxyWIMo1rsThPSOwPstaS1UUtOoxWJ9TAWnCLotl8UrX6nu+Xcj6T4y4q257mZFUdpwn0fNkbQLiggY4/L3920I4BmUwlDnYCV2veH6dWScX4clLQcxOA+K3gSJCo/4aI9GNyNOdNom7pnmnlEkbecJR5ETRU4UOVHkRJET/vsjyInyoqagoKCg4LHhKJkGypsQyG72M3p8enhORbCIXOZy7QiSF9qaVtrH+AHZdYHIO17d3yLU/4VAv1NZIY3/z8Y9NbN8jaSG2KxtGSUOJJ2OLO82Otr4guLRbXUsIroBB9YVGEsy0fl/TSzCkFtxuq1zSoVmjZU8USSRed0ltIcwRgalddbDQO7juvNwnWdogZhIsMMF5ST0T2hLut6RqaxeGpY9tGjbololpUd9AEQE1KZcxAfCVB+g0do0dhDdpOu6diTNW3PFE0dQdw0K3vU8juMgn/J9rr5JhOUI3XEyocng41CENmdu0Vl6xxfV9Z9jnknZxe/K0a9QIKS+DPXjJ/F0Iq2BcAfSC2E+Gj//Qrn9uaB+VxDxw+nnl2hUZI0Y2g11eqPbInp6RXpWRAXA/yU9RMJSAOlclxTQYH31P1LGmaIUprubT768XjWTO7/79JeKdJrkFR7rLfm2b2F+QlHkRJETRU4UOQFFTsTsH1JOlBc1BQUFBQWPjdz1F0LU+0TY9Coh3Je6A3kPfQd3nZguAe+7lV613v3yM/FqR0yC3PbcK5CeN8JQPlg/8fQtCx4IgTwncvegPANZ2lgHr6GM7l9XSKQi2SfPPCfWwf3YumO9azwNQ8WgWgMVatxWoxr8/+M6APuAVsGorjAVqArrpnH5i7PQioizYInLC3AWRtuiWE84a8gIVmfeeKUkuMDbSLaSQhentZBRwNeJkGlnngcy7hUAE75LDJNgNCPU/TwlkMBAMC+/wfLbzyl7HSq7+d1fEBSvYFwNbZCMrAflMg+k2Ceuly1h2KhnnNNegfJ5hnYG2Kz80ENx/HIiHkgyKR5EpncOlv0w9czTB9KeB5d9klHkxOOjyIkiJ4qceHLlRHlRU1BQUFDw2OiS5J5Az8TjZUI4x8aa8x653lirn1k5gMyNmGFp2innCmHqrbLWW2IsoNY6t3lJbvBDdR4uq0sihrbrjO0KH8/yWu1aZvK8ripTFeeuHYmVdgYoWKDp5CX46IFAiDMgPYurotpi1VJVviWhslHpUUTFO5EbCFuehnOxgYoj3zh3YpHLR0Utk9GY0XjCcrlmvlhhLyFN4KyhgsV0dvzQaIEGaNqw1CFZKoNlKxqoL6tO7+8mHoKiC76/c4t+FtBSLNYvMQgWwqCABd1lUxHMaLVuzpVNJTUc71lTQwYxqY1jG85b0Q3vh1CDDpXvzeHoAdD7vpFJrz7xHgpVCww8tMHVDpNb7rP7LqiGSiDvqVed5wU8SBHM6zN4Do3Pqoch7E8KipwocqLIiSEUOZGXWeTEJsqLmoKCgoKC14VowbDaIS6OhGfC8JJrN3cKyK7PhG/+OwSv65B0Lqc9IV2+O8Bl7UAdgTQE12MQMT7oniOxLW49srW2U4erEK02vg79NqkqapNLsFsTHnhGILDDrv+bbU3fncu2UmW7WkQC57d0DXXDdGlBXFbg87S2deReKtQqKtYTfZd/ZSrEKE1jMTYFP2xt64iONnSJn6dNkoJbxrXxhG15HVbrNYowmUwxxrBYrlC1WJuIDz5Og/NidwzdlevLEue2HkkSTtkykm8rqrG9cf5dMrOGZrcje/2lFpukPRDaPAdVm41d0m0qMUhlCNZVi24UvOlNoL3xC/ep7c45dW79xpiYZ7rvAAku5cHN39UpTLtgWTYIxriGDimeeb6pipsKZlA38nZp3hZXpc6YKul+km6XxuursGtOuE498TZAm54f/bqHZ0a/rnnf5n2eP2vKy5qEIieKnChyotf/RU506lTkxCbKi5qCgoKCgsdGEj5X0d8BcgCOrNEVzH2BfZmFBZJFRlKCzPqXaQK9/JLg7McmSATceJIT81OilQpVv8NDd9vFiAFCnNe5L5L7CojzEJe4TN+R74wg0O3py6zPqc3EKypTddJpZm4U7fQm2iGH3iqW7S8iAnUtjCc1o5FJBN8qTVPRNmuadYO0DZUnuVIps8mYyXTKatVwtlgipsaquFgBWUcJAp5ctwrNumXdLGhby9bWjMm4RhvLfLFAEda27W2nm6y+btx89SVzUe/1oxJIVofB4YJZgvTm1QYie+7nSyT0gSymPt5UCgNhd4ElU34KMZ5Av/45wVefyVBNh6yTqUmp7WL8mCtIZLUpNgYD94/rd/W76wzjwcpquI99e3LiG+5DyVUX8e7pPm9N/RefTuqVCKtxPELDRQQNSobE0jf667L77MqWPIRi/iSgyIkiJ4qc6GQS69/Nt8iJPN3VeDLkRHlRU1BQUFDwQUNO/jagwwIqWE+H88uIeZ9E0M3vMhFpjNkQsv1KhxgD4klX9AofKOsqS+XjwFllDdYH3fO0L51ns7yBJmTEITnR5xayYaQNXsnIqDNIhR0+AKp4zlqlaRqs23aDcT3i2s42lQBt47b+FOX84ozpdMr+/j6KcHB8hsoUqjGnZ/MrxkSwKm4HB4HVag3Wsr+zzd61XVarCfeOD2lwVmuDwbnx+z1bVEBb3yluWYIRiTt/YH0/Reum6/PYrb059Ubq3tI362UWUCGMhrf0emapSNwchVYv77VeRfvKmXbSSfyb0kCaN52cCApAIrm5lVI37sXHIa+XwfWLXKK6ZPp3qKl/nth4MCgYaXlKX0HfzLNb//IC5o1FkROPjiInNlpT5ESREykvPjLkRHlRU1BQUFDw2IiiqrcIuh8cMroma/oTXYqNoaqq6Do6ZCUNv7tUZdMqGC1Sl9Q3prOakYdeWZoIhpfP3QxFCPpBZw11vLZrXdkg6ECiTRqD2wU3W0HIrVyOTKdr3UajQvBLd9lrrwT3N1iv1K/xdzAE72XbtiGluy7bejJFSfBUR4lbUwoKamkb6/NocWv9haYyNBfCuDLMxjW3bt7k1q0bWFpAuXPnDvePj5gvG7SaMtveZbVqWC+bvINivUScG7oVF9hPxNC0luPjY2jX7O3t8LZnn+Lw9ITjszMa2+I2JFVUQ+wD514c1IvWWlTEETh1VB3JyGwgo9JVtDQqjamSmo2mT9Ax04WZltzjM0KbkdyQOpsaTpkIZafhy7SAq8lsdAcnj8EQrve78GRu2KFeSfnIqxba628MDW7/+GUBfk56pTsnwCHvoI9fRXLDsoIQmbXTX77JMVBk5y723Z+NTT9PtRaNMUSEsBOJkO2pkin30bKd5XUlSd84/PqUjY8UFDlR5ESRE0VOFDnx6HKivKgpKCgoKHh8SJ0JQpBKIi0BnHXNErcp7bj3ZsIxCOkOTCZYQ44+jQVPxsg+meAl3/bSVzUnUsaAVI4MWAvi16r7wtq29URbokAOViAVRY0jzRiTRLdatxafRDqGYh1UUjvLl7ZYb91zFrzKuXUHEo5iJIRa9D3szzuC7giyYCOhsp4MCQZt07p6y5rJZAxa0bZK27aoKlVVx95NtieDUnviYRHxbbAtlViQBtQiqtRVhaihbZTKCKPa9UUtrj8uzi94ZbmmWa156rlbTCYjnnnmBtu7Y+4dHnN4suD86C61mSKV0NgWDfzVKkJFhUG0RdWCVLRUWCO02nJwseR8teL2jT1u7u1iVwvOlwsaWprWYKmxZoKaipEBsS3StIxEaKiwYrBqGQneKu1mj+tV13cu0oQCFUjlrLaCn4GWvk3fzeekx8UJmXGxSJ/DzRCRchNxag3qYw2E49YrQHT13qiHRa0xEchgaY33mVf6unWW7j3iNK5YY1ONOgqbqMGo9cqYL1zUDb6VqEu4uR5a7Ym/gIuz0I0vAkTvgKDquZxTZa1Aq4KKdQRaFDBud5Gg6Pg8w1bNweJsTIX1eqUBjBVs21IZE4co3LGa5dF7MnXq27FAG0HVurkK8e8TjyInipwocqKDIieKnHgYOVFe1BQUFBQUfHAgbkcHEwhVFMBB9msvebJERDIeLazdtErYFaL38dmKJBE+VK/AXNSzBAk2l2gqcumCe3qfSyXSSmxZTrKGlIrUPoOIuvX23hIYeVOg3qH5SCRBIfuUj69/ZF6uryXwQ29la9WCGMRUbG3NAFgtl8wXc29x8mQhlm69AuMIuLVrRFpGRqgFKmOpa2F7NmMyHlEZFwNgPB6zbtY0tmE6nTAeVczPz7HrhuXFCa9+4Bwxymw2YlRXXNuaYFQ4Ol3StEtqMdRiWVvrtxg1jCqD2BZwJFmNo8MgqAiNKjTKK3fuMxnXrNs1xtTUvgesBRHL/u4O1/d2WZ2fcnp8hFWABjCOK0qFEqx9jpQZI1SdPs6GWIlb8ZJZ0/Jx9qdA6MzE/PvlDum5Ktk9GG+JOD+ywiTOmjgHU10277dL3bP7xXrLZNAs3P3nyaVf76GdbXtTC0JZ0Vqq4uZkv70ZEZfesW7VxG+r21W4032drumTe8h0Cl/HPBBpfDlA0KCGcdlyllBDNtSygktR5ESRE0VOFDlBkRNDKC9qCgoKCgreMOSCzgox0KJ6khk/4tKajLAO5XFpORldDf/1U1xdT1Css+CKeGtIIhiONYm35iaSIsHiFF2MnYWx686a0zE24igYdeveja93IFLqybgrpHVHo/U3U0gyEhYrFVutjnYLziJk3Laeqi3n8yXL9TlVZZjNZty8vc9qteb8/IL1uvE7WrQYz+NElUosYlrqkXB9d5ud2RShhXZFJZZxbZlNDIuLJev1gulkQjUas2pWrC4W7G/N2JntMKorWm2xtuXGjT12d3ZYNS33j8+5dW3N/GLNcr52pFoM89WKtm0xxlmPl6sVq7al1RY8EXckyVk0rSrt0tK2luVyjhjD/rXrjKqRs1Y3F+xtXefmsx/F6eEhr7z2Kgcnp85yVo1pw/yrKibjCbZtsG3jFJA4sLkLdbAsZ0d0aNalwUpXDmOYbL4+BOLcIbc9DwXV7ny9Kq/03UYPBRTUSkbAcQc7kQGyXWsG8o6u95lCcPkaf/fcsEFx9RkaIASulLjcQ6/IJxYeLcrhvs/v+at6p7OkRRWsfxapXwJCdXm5TzCKnIAiJ4qcSChyIrSkyIkuyouagoKCgoI3BBuWQU8EvTN7ErySC7XMIiHxqg0Lz5DLuwvsl1lWgpnDG48usxJ17SJQiXoC7tmEt+j0pW6eZxLNnoBn9Y9Wtczy26mHZFn7XUGi1Q1F/d4ERtw6e7WSlUdGuD0B1EQ43DUuD0yI5+DyqioDqth2zfnZmvnFKTtbO+xtb7NeWebzC1TWCJYRMBvX7O1uM53WGAMjI4zEAg1iLJORMDLQrE4Y2QalYVoZ6lpYzee0ywtO5qcctWu2Z1O2dnY4Ojzg9GDKtb09bty+TdUsmR8fYKipmjWTrR229vc4PptzcHQItmUyHrEz2+ZiueJ0vmBlW9S6pQSqAqYCMVhtGU2mWGu5OD9jcXrKtaefYjoZ0TQL7r/yIuvjA/Z2d3jbUzfYmhjO53OOl2usOud0ERiPR9TVhIuzU7RZ41Q1Z0vPx13j+KcJEizfaEoBRDf9y21vD48OUU8TbxBXrZfv30957AFfUqe8nLCrWhe/orcDTPKxt1ErcdfYmG5I0ciVhCHrZl9BN4THhvgyghpL7HVVjdsi9+//Tg3Eb5/sv/fr1U9/WewB5zofYpC4b8OW1CcbRU5kjcvTFjlR5ESREzFdkRMO5UVNQUFBQcFjI67PNaYr0D0ZMcZZNeISYcmsf4Hk5hYJb35RuhbG3JJSVRWoJ819y0+Wvl/HTVKPq5874Mu3oG6NciBNHTbujSCmEk82Qp4aBbj06p1DRJyfNY40OHd2R+KDRU7FEsP6+SLEkw3BBTZULCKGuqqo6xoRF0+AtgFVv5TAUT6DItpiWktVCaN6zKgWoGV+fJ+6mrA13eH6jX0wCyosY5TdrRmTUc3x6THnZxeMt7fY3dtlNpuyXl7QrJccH97l4P4hy8USBaZbW6ytsFw1rJqG1WJBbZTn3/42pKpo1mvunZxydnzMnTt3+aiP/hho17z4gffz8suv0mKY7V6nGs2ixWo2nTCdzhhPZ0yMUlUgdU1dj2lWLlClVMJ0tsW1vX0MyuHBfe68+jI/+sOvsrOzxdufe4b9nV0qUbBrRpXhmVv7tHaH1w5PObpouFi1NM2S+QXcvH4dM5tycbaiaVsQH5jTx5wIYxYUtkC8s6X6LqCmDO84MYRNa550594jou+yPkQcE/ENaVy5gViH5Q59F+5A1t317pqwNCOZLzXtzGqJ5YT7X8RsEOtQn7AV8SCBVUUw1MagClZb1Abd2yu0bN7z+fWhmjGNpBcEam33OXKJF8eGlRSIgUbF+sdbeVEDRU4UOVHkRJET7poiJ3gkOVFe1BQUFBQUvKGQTJgF4m0ULzidoAzySvsCUlIeMa/MQhMFYLRsdsvN//aP5wjxJyOFFggkWqONq1dWVn9HvEIjcgtmTjIGoIEoBKOSxmIq9cupDahNeSfy7a1AggtqJ4atrRlbW1uoWtq2wdgWFBqFVdvQNmvsakHVNmyNa7Z2dpjORtSmZTIx2PU22kJVjZlNJ2ztbHFtZ5taLdK2iDHszmqOzia0qxVH9+9yRMticcF6taKqKkw1Yb6a0zRLzuZL5suWVaPMlw3GKLdu7DHb2WO9WnNwdIp4q+T5xSlnP/BDXLt+nes3r/PawT3mF2vODw5ZNYcEbWdUCVvTKbdu3WLn2i71yKDtmp2tEXvXr9G2yqJZsG5aJlXLzRvX2ZkKuzPh+PiAs5NjXnnpBRbXbrC7vcPObMr21pSmWbI1GTGq97jVGk7ma+6dLLiYr1nOL5hNRjQjF8+gtdYpVtb68U0WucE5GA9kPwbmRP9Il3DmxHjz2od5BTDkcRCOtz7g4+B14AIechkRHlpbHxSSlEewlkblOlr2N4ns4yIp4f5zCWGOZaUqOiVb0x0fPCbyq65SgTasz1Hd8oqLuezKgiInipwociIcyH4UOUGREwnlRU1BQUFBwQcFgiPeuaU0cE4TyGZIGC+S9NGugOsT7KEgkENE5VIyjEbLUNqRQDCiWKv4AAFEkewtPUYMKm1mFdrM9zKRHch3yDVYAwEfjwHU4IJVarCihsgEyXDm3HUbTk9POTs7xXoX44k4Yq4CVpRRBTtbI3bqMTf39qhqw9b2mNlM2N6quL6/y9Z4ynppmUxnXMzPsOsVp/fvc3D3HgeHx9w7PuVsufbj2WLbhkYdOZdqjJERo9k1tmulaRvqmXA2b5g3p0glrLXmhVfuYARmu/tc293n/t27NE3Dyy98gB/7yffzX33yz+D5j/lofvTHXkCbEZVW1NWISW3Ymo6Yjmvq2jCulPGkYrFcsDy5x/lyzs7WDjd2J6xbQdsLTg7WGCPs7kzY330akWeYXyxZLtcoysuvvsqN/W12tiaMqzET07CaL7i2tcN0eoNX7h5zfn4OzZi9nR3q8YjTiznWuu0+kyVOEwsOSlVOyDQoWZeTsCHLZW/GXHp1nDmX8NcH0drO8hPxywOGS9jMWwXB790bAj4GBVQDEe/fB35RQC/by+/Pq7BZL0eu7VXdnZQAkm6knrx3aqoD4/kAJKuqBbHxeVJwNYqcGOiTIieKnMhnSpETT6ycKC9qCgoKCgoeG5dZYvDWBzEm8tEgj6KVAi8KleSengnCQEgdEZYoc1UyMu8qQbDABPOMxK+SERVNv53pxgeWoyMsFRO91UUlRfuP7FlwIR4NeNfeWKJ4UrahOHSJSPJ99ts9qoAYVx9rOgQhpFXvMu1XNTvrsWh05VerrLWlrpTKKDvTEbuzmtkIbu5uMRvVqF2zs2XZ2h6xNatZnx/x6msXrJYtp6fnvP+lD7C8uGBxfsHiYknTKNRTxtMZo/EIU9Xs7u9xdHTIwdEx82XD2cWKthW2tkbUo4pqtM14usvO/g3Gdc1sOsKqUo9rWhXuH56xf+0pxpOarb0dzhdn3Ll7l+eefwc3rp/y4+97meWypapG1MYAlsmoZmdryvb5lO2dGZNxDaOaw8U97tx9lfF0wu7uHk/dvM21vW2stpxdrGjaNdPJlP3ZNZbrltWq4ejwiJPTUy7OT6jEUhll/8Z1mvWC87NTRiJUNKxWFtnZ5vr+HoJydjFn3a7BjHAO7U7ZwYadT4hk1IobT40z3c+FbO7Hvz0LZgd9hp2R1zzGQVDo8nX34Z6Lc8lf2y+ToAhqctS3OCUwTeOMoMZ7SNh02I93ddA+sva6Gd1fejKkZHPJ+byMXPtRDS72xCCpm0jPiI4OELwRwoNB070Xnx75hRvkP16c2hieJQ/P3z+iUeREkRNFThQ50a1wkRMPIyfKi5qCgoKCgsdGf01ygKpi1QUnRLyjp4inm0QJlzhzl4A7OejX74okMt8rKwhKtx7fE2yfQVZalIQS6iyGJMQtGMG2AAaRCjFrfx2gnl6LQfz2I2rrDlkwEikYzkqS94d0/5pQrokkRUM5RjC9wHvq6xf7xwotFjWCGNC2icsGagPvfPtzzEYwliX72yN2ZjXzi1PWq3NmI8OsrjGtsjhd8sqrr3Hn1QPWK8vR8QmHp4cYU7FetdhWqeox2sJWPaEaGQ5PDji5OAW1TCYTZtt7bO8od+4fsWzWHJ2dcT4/YN2AmJqt8ZiRMdSVsLW/TW0MFYbZeExVWabbNZiWi/mco6MzRvWEtz97G1ONOD2bc3x6TtPCyWLF4ek55jXLpDZs78yYbc+Y7WwxGtes5hWr5SnNxZrDu/eoK8XUwvbeNsa2NKszRvWY6faUUXWNo6Mjzi8umIxqrG147eAn2N7Zx1JzeHgG1ZitnWvM52eIjpmIUm2NOV8umTdrRMYoFSIjaFuc2mZR68ZFMaipQRSj7YY3u2Tz2HbIcA+yeV/FU1I5ZcwGxijYSMjjzEY1xeno3AvZvaveCqziApbaVqkyxTKfjWpt+t7Ly9Ff7cx/FYMGJTIQ8IyEB5f5oWUsm3ABKr2K4BQgT8BDsBCV1lFgSfl3yzH+Xkrnw3NBra+7eJXGK9hujMJzLSkdqQxLiK2garxC8IBdRJ4gFDnhUOREkRNFTkCREw8vJ8qLmoKCgoKC140hC0eIZi+Z8NfIFQwiXhCLRAEoEK2gHWuhpngBjpQ760YI8BYtG7mb7kNXPvurQaj6+AkSAv91rS+u2Dw4HNGaIkhamt1xEx747suSEFQvusVKik2Q2W0UQY1zq3aaR0slMK4qru1ss7s9ptYL2sWK28/dZn9rRNssWQGrxrJoGs5PX+Po+JCL+YKziwuWy5b1GqqqYjyeMZ3OsK2laSxt22Kt0toVk2qL/f19zk5OsK1FVairitHuBBmNULtmtV6zWFmOTs5oGlgulzRNy854xrpZc7FcM63H2Kahrg2tKNVIaHWEbWBtG6yF5cWS1WrNbDZlZ3eXpm05PTnh/PSU+XLJ/P4Sc3yC1BUWpa5G7G1tc2N/j+3JiHFtUFp29rbZ29tlNp5iqgWYitlsi/39PZrlBQf3XqOqa+rJhNPTU9pWGdcj5stzamY8+/RTaCucnJ4iKjx7/SnuHZ5wfL502+aKhQqvbBIZmQSbo587l1nMwr1xmSI7lD4huNdfkhZxdfL3iYnkNyi42ZVh3mX3Yj5jN+rVS3dVPTtX+jLQIfJ+SVkPhITb6NK6XFbWQFYddSPPY9hqW/AoKHKCIieKnChyYqCeRU4Mo7yoeUIgIl8IfDHwbqABfhL4VlX9fW9htd4QiMhHAe8DfoWq/su3uDoFBU8kcgKRhLeJQjHu+kEiHGG3DMG5tBsSkSakTkYgF6BPAlHPAlF66RsI0JCQzK0wmy7mAhIsK2ELR18zzfJUJQWCBOlYsRKxyNMkgd4tL1/n7ch8SB+ud9dp3FJEcIEQFBVngTbWImqZTUY8d+sWtA3H91/ixv6Un/LOt1Oz4vz4lMOD+7z4woscHR8zqmta23Dj1i1aNZwvGs7OF4ipaS8WYFtn/QOsbVEsu3vbVFVFVQuT0TZGBG0ty+WKxXoNrbPE1aMag2KMMh5fR8WwalpW6yXBBj6dTJjUY2zTIiIsl5Z20bJYLVk2DePxxAe9hLquXX1XS1Tg+o19ZtMxq9WaxXxJa1tH+JdLzi9OuSeH3N/ZYnc2ZToZcX1/l8aqs1ztV8y2xqhVVs2aUSXcvHGNiobDo2PUwu72jiOqldvG9e79u7zw42c89fTzXNvbobGWxXrJztaY9bplsbYgLbYSbGud7U7ceBnEuYTjnb5790GYi/lvYwzW2o00OXKF9oFknTiV0n3kp6qqt6L6eybXQRFxcSX8rjOhHnlQyZDuqnrm58Qfy4Ov5m3J2/NgkivZp1/+8LUPreBAZyeR/OOU/UuL2LD0lpc6myhyosiJIieKnMjrmZ8rcmIT5UXNEwAR+cPAlwNfAfwhYAp8KvCbgA/7FzUFBQVvHeQSISwiKVyApmNR1HtiaiQQzUC0Jcp1E0iqWrf+PxLbZCEKhMcRc3OZbBy2kIQgBu5HLFfVOtdyl6m3KoV6+fQmfBc6WYuzQInfFjUIbtWUvntNRtjFbZXaBtIDVAhUWUeKYkyLUWVUK9d3d6hRTu+9jGjLzb2a29emHN55kcO7d5iOx6xXDdq2XL92nd29XRaLJXfuH/DSy6+wVmXv2nVmsylStT7IZM1sa4IxhqoSzs9PWCxbnn3ubdy8dZvVcoW2ytHRMYfHx9w7OuT49JTt6ZTpeMLO9hbTrW1aVebLJVa2sRYMBrHQLFdoZWjWa1QM4/GEajRmdXrMcrUEYH9vj3FdY1UZjUas25a6rtDpGAXq0YjRaMxivqJpWtQoy+WC9XKBNYa3Pf9OtmYTXnv5FX70R3+C3Wt73Lh1i1u3b/HsM0/TrNfY1QU7u7vMtnc5PDlnsZgzm06oTcX29oz93bfx8ksv8+pLL3D9xlNMt2YYgXa5ZH9rQr1Ys26VtcDKWixCJQLWuVobBRsCE1w1D8NM6Ll2X6ZIJgU3I3xp+nWJcUy5af8TSWmtpnySVTHlAM6SHhSEqyyPm8tbbKqJmFTHjHxb7yaf52utZRPi9Vy35WqHGKPZp9tnod6uPBPz7pdvxNBHx9KKXDqG5cXM5ShyosiJIieKnOi3o/u7yIkhSBEsH/kQkZeAf66qv6t3XPRNmgAiMlXVxQcp74+ieNQUFLwl+Pm/6Jdf+QxRAbVp7bMgHW9vFReEUa2lEpMCMgKVBIuFxVQQCGgQ4KqZsPRr860Q3XZNTvw3hGbl/7YgLSnYnSPLlfGWSQ1rmwNRbnHWykCKpffBKQxGvWB3Qj2tRTaekMQecvEDNBAET1K8ZdYEbmEt0+mUre0Zk1mFtA3GNuxMxizOTtB2zXJxznp1hF1fcGN/j2du3/JlG5YrZ8k7OT/jJ9//AmdnCxqrbO/uMZnNwLhxkMays7NDXVcgyvb2jKoWptMp0+mMi4slRwdH1KZmsVyBEVqxHB4fsTyfg3Xbv66aFa1CNarZ2t1jZ3ePUTViVNU08wXL+dxZ7MSwXLcsmxXz1YL5YoFtWqqqRhXOzy9YLJas2wZTV8y2Zjzz3HOgwvHxKVuTGZPJDKWlqg2j8Yjr+/vYtmE5vwCrvPDC+zk6OWG9bpltzXjXuz6Gtz/3DDUt40rY3dulUTg/P0NQdra3wLZY66y5r90542Kx5vbTt5lub9G0lmo0BRlzcHzKAqGxoOrGe2RccEuxisVi4yAO3B+ZCA7E1vgYG9bawbkbf0e9TbrUU7r5SVD4HLsGVdQqagSMm5duN1nBIlifpuoR2ZBftOZm9eqv7++kd7M8zHbXBmtjlwzRkFDORpuzfFNZydIa7qE+gpU3eEmE31VVxfMiQmUqFz/iEmVIZbiufcto3k//9j3fdLnW9YSgyIkiJ4qcKHKiyIlHlxPFo+bJwDXg1f7B/ksaEbkF/HnglwMz4LuAP6Cq35OlUeCLVfWrsmN/DPjdqnrL//5C4O8An4nz4vlM4H8FvlxEfgbwJ4HPwc2/HwS+VFW/0V97A/jTwK8C9oHvA36vqv6HR2mwiPwk8I+Be8D/E9gC/hbwB4BfAvxZ4B3ANwO/RVUP/XXbwJ8BfhHwPPAa8A3AH1bVkyz/68BfB34FcAx8JXAb+G9V9aOydO/wffCLcZ5M3w78j6r6I4/SnoKCD1dItHAGS2my8DhDpCfgYjCmS8CRbgA8xSKijmxD9BXWLL34PEUV2sutOYR6eIuNQ24hItIajdYR7RCpTliB7GnabUK4xlEPYwRrA6HPL3au4HU1YmsyZTyqmYxH1AKr5RxRy97eDju7W4i0rOcX2EXDjZ0xzWiLs7Njnr19i/2955mNK/Z3d2hXKxaLJfPlinUr3D884mJ+zo2bN7h1e4SpnGt20B2WqyVUhnW7Zntni8l0zHK5oLXCen3OxcWSyWTGdDZjUk+AC1osk5GhHleMnxlhrDIZVQiW6WxGNRrTAvcPj1kslmBX7G2PmFybMR6NsQiHx6ccn50yXjSMpQZGiNScz5eMKoOZzTBGGY2dxfTea6/x9NNPc+vaHqcnJ6xtw9Z0SrNqWK5XHGPZ2d1htr1Fs1rx/DueZ3rnHq/dvc/x8Tk/+IP/haODE25c36PCsr13ws7+DpPRCNu2rNuWcVUhCqvliv29XUTOufPay9x+6jbbO/ssFnOUJbvTMXa5coEVMai4gKgtQmW68+LNRCDi6u+56A+g6Vznvhi4RTYtnhnJvEwpyNJ2FIX4R9/APumT8qDEblo7+8jd1nMlRweUjo7LfXB2KHhDUeREkRNFTrz5KHLianwoyInyoubJwPcBXywiLwD/UlXvX5LunwPvwr3MuAd8CfCtIvLJqvpjj1Hu1wJ/Dfgy4EhEPh74d8CPAL8duA98Gu6FCCIyAb4J92LpS4A7wO8AvklEPlZVN142PQC/Afey6bfglnr9CZxz4ecCfxT3MuqrgD/l6wPuhU4FfClw19ftS4F/BHxelvfXAD8b9xLoVeD34uL/xMWZ/qXTd/h2/nbgArf07JtE5N2qOn/E9hQUfHhB0pckoL2lRNIWkcFd24hEK5E74sm7iCfdBsT66xSkcn8CQVdNbu6Z23jukhprlE5mFdV4be4j3KMaaUvWQUmc2hfa6IgBoAPB6iTtEiAi1HXF3s4OdWUYV4bKKLNawTYYu2B5tqRCmY5qJlsTJtIAK559+hrXb+w7y2rb0jYNh0dH3D84RExNNZ5CZdi7vsdysebg/jGr1RmqQts0LJdzFMUKjCdjFosLFos56/Wara0dlssFTduwvbXDdDxje7bDumkwtTBmzNPPPcX+zh6zesxIHAk/OT5muW44Xyx5+sYNpDJszyZc29tmUldMJxNOzy9QDI2v8+nZOfPlmrOLJYfHJygVSEW7XrFYLDhfXHCxXHJxccbezg7bkxrbNCzPz1DATEa064rz81O2ZjNmWzO2t7YYmTFbW3ucnl/wymt3eP+LL7NaNezv77LinIPTQ7ZnW0xGI05ODLPxiFvXb7C9tcPxyQWzyZiLuXJ0eMB0MkVUOD055dqNW2xNRtj5irWA1DVN6wSNxvnFB1XBv4zPqlcug+UTcMZ/b4AM885ZUzeXg+RV7lsCc1Ifzm+mc6kSEXc5qrjvr69LUg0S9+9aNePRoIRoJ1nHCtqt4xuH/HlWcAmKnChyosiJNMeLnKDIiYTyoubJwO/CvYT5GkBF5IeAfwL8ueAlIiL/NfCzgJ+rqv/WH/sWXNDhLwH+H49R7l9W1a8MP0Tka3HeJ5+TvaT4xiz9bwI+Afjpqvqj/ppvwr3Y+f2+Ho+CBfD5qtoC/1pEfhUuoPLHqur7fP6fCHwB/kWNqt7FvRwKda5xy6q+Q0TeoaoviMgnAL8S+HWq+o98um8GXgTOsvJ/L7ANfJKqHvh0/w7Xp/898FcfsT0FBR960DZaHAXI/kHxcR3FRMuMEXFbseJczgOZNqKoWNwKbpeHIDj55S2sUuGCKypiBDGVN7x0iUFfqOcCNlk8bKyzu7py5UgFKNYx+Si4BXx5FWHbRwlWVg0BL0PwShc/wPWLd50XTz7ou9w6om78ViWrdcsrdw+oDIyMMqmEa7tbzMY1q+Wci7Zhb3+X6daUkc6ZVC3X9/e4desmLZaL81NOz05Yr+Dg8ILZ9i2OTk955aUXmG3PsKKslmuaFqwVzs8vsLZBKsEaYba7xf7ONicHB7TrJbPpjHoyZuvaNWozRhtluVxz5+AMRGhoGV0saasR7dqwXiyYjitm0zEgnJ1esL29x3rdspxfUIlwv2kxapnNpty7d5/5fM5sZ5fZ9jY7+9fZq2p2zi/Y2dlmvW5ZLVc0zRh2d1hay8n5BWfnc7AtWo8ZVRXNuuHw+Ijj00O4EKZb26yXe1yYBbs7e9STKVs7MJ7usLO9z/37dzk5PsJIy7ZOaGk4OjhlXE+YjsdUAufncz7qnW/j1tPXeOnll7mYn6FzaK3l2v4NdndmXJwfU41HzEZjdKU0gKFCFVqxiGq0/ge3acRkkzTN2Nxo77YQ3gybGm8sgtXT5W/VB2CMhswhQunOm1iQoGqTx4CSb1Ts8/DKY4yP4esTI0yGtIH4hk84XiHWK5lOxcMIzs1fCRsre2eCrjv8ZR4Oobz8HoLkvm8Qn1fwcwCjJlk6K1eiZkqAhPpoUPDxerjSeb5IGB3t9m1se5dwD7nrP5EocqLIiSInipwocoJHlRPlRc0TAFX9fhH5qbjlN58H/HycR8lvEJFPUdUz4DOAO+Eljb/uXET+Jc5z5HHwr3q/fz7wf1zhSfILge8F3udfkAT8W5znzaPiPf4lTcCPATfCS5rs2G0RGavqCkBE/u+4IMsfi3vREvBu4IWsLl8fTqjq3L9U+qxee74ROMnac+rb+DjtKSj4kEOg2o4gJyKhBPnkBHYylAaBZB3h6FhTnBBL1k7jCUFkJd7KI5HU5xbLrrjWvpTecF0VCYTcXZ1kpaS/vjFBtCeTi28XjlA54e+LVOPaF5NtkqiMuvg6hKB1BsXQqoXG0jYttm0w2jIe1+zv73H9xg1Yn7E1HXNtu2Zna4y1DYvl0pEGEc7mc07OFxycrjm7OOP47IK7Rwcs1ysqRty6dpuDe6+xXq+RWrg4u2Brf4emVU5OTkBha7aFqccslg0v3X2Z48Mz5ucL2kZZtxYxhnXTYGmZTCrGlaE2ytbWhMo48jWuxuxs7zOZTBmPYTSqqYywXq+oqwoRt4vGvpnw0v1D7ty5i1pLXVW06waA2XTKqK6ZL5dgalQqVJXxeMTu9j6juuL48Jjbk5tsrbY5n59zenrB8mzO9mSH5fmS2e6Mre0dUMNkNGJvbwvbrjk/P+b47JDlesWocuVczFvadsliNUdqeP7tb+f2U7cRY7h37z7r1ZKT40M++l03MVXF0ckxo3qCVCOOz1uvxOGVRaE2FcGS72dmPik35kY30VB4x5RIyXhwJJzpfkjWyLTlaofY5reJJGXT3VdE8q2B4AePBAnbuF5Ss8wjwPi9X60qzunU3zNIXsFMscgJrwwe055ikVzto7oeOsRfk34aMYlUh+v67ejVKR0LygIbbRft6CSDHhpPKoqcKHKiyIkiJzZqVuTEA+VEeVHzhEBVl7gXC18PICJfhIvZ8kW4+CrP4pYa9fEacOMxi32t9/sm8MoV6W/hXnSsB879+GOUf9T7vbrkmABjYCUivwb4e7j4M38EOMD1zT/DxZgBeAY41c3gyHd7v0N7fv1A3b75YRtRUPDhCpFglfHCGC+kvCR0VqOcuCcCP4TcXVYTw7+Mfkel4NLYA6E8BKs2CkxHGrI8RTcFdD+vmJ/f/jXuRHL1dbGIrI7iw+qFEHnL1oJt2drZ4dq1PWamZXt3xt60YlpbmqZh3bYcHJ3ywgdexLbCydmCF198jYPDI6QytDSs1nMmkylP33qGu3fvUIky3Z5htWV/9yb1ZMzaQqU12zt7iFTcPzrlJ19+jVfvHzGfr6lwERmqukaMI9DVaISaGjVgjWHVVtBa14fG8PLde4zHE1TXrJYLVC3TyYS93V2MgXsHx2wdnbBGOT05ZX5x4QIkKkynU8ajC6qRYd22NFaRasR6vWZ+dsrbn3uGT/mkn8Enf+InMl/O+ckX3sede3c53T7j9OiM9WLByfycs3lFVU+4eeMWk/GMs/ML6lHFjVu32drd4cWXX+Tk7IK6njGdzFCxnFyc8r4XXqJplHc+/w5uXL/FYr7k7Pyctlny2ssv8uxzz7K7NUXNiFm1w3J9xmLdYKlQjLsHqoq6qrBqXeDAB0yJNxL5zO+T2e5t8Wi1CvM9rPnv5pPu0+ABoEFpjetBLlMquvfCo77ocMtI6Hyiam/8I2NgR5LLyuk/Oxz57tU9FDSAsvTpwShygiInipwocoIiJ4ZQXtQ8oVDVrxaRrwA+3h96BXhqIOnTuJcVAUvcS40c1y8rpvf7Pu6lx2U4AL6HbOlRr9w3A58P/AdV/Z3hgIj8nF6aV4Fd2dzJ6nYv3QHwL3Bbo/dx+kZUtqDgQxXR+CI5GWYjCCQ90i05Ie1bIiTFJhDwe0X6X9Es6dMqkUxfFXvACezgPp8IeIImw2iskOanowIgKon0e7PTkFzWvGlBEQmERYS48apAq36nEwyrpmF+dsytyZTxZMpyPuf+6RHr9ZpF0/DSK3d47d4hx8dnHJ+cs27c1q/QYCphtr3Ds089w2qxZHt7xnq+ZHs2Zf/6HlVtwFSs18J63XJycsb7fvL9vPjqARdNi60q6skMI8pq1aJSgwUVZWSFWmoYjalGNVK7Be7j0RhTVYzNGFDsWqmm26yWK47OFpwt1lRG2JptIecLrBGmkynTnX1s09Ks15wvVpycL1k1DVoZRuMpVhvGo4p6tsurdw/5V//6m3j+2ef4OZ/7OXzSz/hEzs5PWa1WvPTCS9y7c5/Ts3NO5xe0rbJezVmvVyyXSw6P59R1zc3bN3n72z+Kl19+hZOzM+aLFZPpCFNPmS9XvP/9L7OcN7zznc+zt3eNUV0DluPjA1TXPPPM24CG7S3DzWtbvHLv2HOyKs4PU5k0D/2cjaT0ci76hiJ4IyTjoIJY+m7Yg/N8A1enccQ7EPTW3+pK2C51uIIPKDKU2MugHxfBBezs8eKgQ/sHkWTXQto5ZWgsus+PzArbqWyf9g/XtaCLIieKnChyosiJIicub1B5UfMEQESeUtU7vWO3cbsqBa+X/wB8mYh8rqp+m0+zBfwynDdJwAeAn5rlY4Bf8JBV+Wbg14nIlw54o4Tzvxh4oV/fNxEzNl8K/cbe77AL1q8E/iGAiMxwO0XlL2C+Gfh1wA9csdyroODDGoEQDwmasA7fiFvT3Nl9UhS3BrtLwFU3jSh9a0UMbJexe7UarTIhJsCGcB1Abi2BnHyrJ+SCiHWFYP3vTUFtSKKZNsUmSBbUhJbeDgJZHURcXo26KAwiztp2bW+bazszZnXLpIJmccHZ6QnHp8esm4bDkzNeeOkVXn71PutWGdVjdnb3qWqD1ZZ6XHH7qVu0q4bZrGZa14x2dplOJ9SjGlNVnJyec3h0wUsvv8ardw44PV/RmhHVZIoitN7QVU1GoAZrlfFkRFULy3XDcj3Htg2gjqRaS1UbKuNMVKEbxqMR1GPMeIwIXKwaJtUUU9VYMWBqqnGNVDWYint373F2voJqzGxnTGstqg11JextTxGteeHle3ztP/ynfNzHfQwf/3HvYjwa8fw738HHftzHc3R4wr2DA15++WUuLi4YjcfsX9vh6PCYs7NTPvDCC1TjMXt7e+zt7fPqK6+xOJmzvb1FVY1Zrta88IFXUAxve9uzjMYTmmbFeDTm8OCQuppgRhP2Vdie7TKtLCttaaxz+V6vGxQdvEdyF/Q+rlp77xLQufZqrwDI3bBV05IOwLub42J6qNC2dvA+1Ox7VB7J8+wqsWHpiLOmuvms4XZC43Xg4x7I1ffrZruSgh22OXUUWJLWD9g2LJXBbafr+y08v8LuHqjrg8sQ9adIwsW3L1mf82HOt459klHkhO8HipwocqLIiSInHl5OlBc1TwbeKyJfB/yfuOVN78Tt7HQB/F0AVf03IvLvgX8gIn8I5/3yB3AvLv5sltc/A36XiPxH4CeA3wrsPWQ9vgz4buDbROTP+zI+Gbivqn8bt+TotwPvEZE/5/O/iYuf86qq/sXHbP+j4BuBvyoiX4p7efVL6b2IUtX/LCJfD/x1EdnFedj8Plx/5nfbX8AFSP4WEfkrwEs4D6WfA3yHqn7tB7sxBQVvBnJLQsc1WxIpNZk8DAJMMwEZhFhOUsyGBSeVB4Bqspzm5YYML7mubwmVeFE6pmp9gMt0DBFn7fGlhHa4nVUFk9iJUy42ynL5GA3kJSgpxO0xBWd9FNc8jBFqoGbN7mSLZ25eY2JW3Lt3l9VqTWMNL792wEuvvMLZ+ZzZbIv96RZ7e3tUVcV6vaaqnCLULBvatuX6/j6VKmenp7Sq6MJw594BL71yh5OTOaumodXaBX6UCqlqTOXiLmzNZlycz1ku17TrlsVygQv8p84CrI5QVmZNZRRjYFQb6rpiVI8xpqJRaNeWdbtkMh5hrcUul0xEEauslysAJuMR09mMp59+mput4eVX7vPKy3dYNS0WoTbCdDKiNgara9CWH3//a7z3B36Ez/6sT0cETs/O2Zptc/v2U3zSp3wqJ8eHvPbay5yenPD0rX2ee/om94+OOTo54ezokHo05u3PPc26tRwcHrBeW8b1mOVqxQ/92E9wcHLCrRvXGdWGSmowE1557S5b29tMt2ZMt6Zc351w/3gOqlitsBbW626wwQdhyFNgIFXmkTDslp3ulfhPnIfde0adcolueGzH/Dfq1rVHhntYMq+FtHWxU7hFDU7FbDv1yfN+FPIdr9/wcHClO56f1TGaSx8u35B3LKNT4/C8yr4//BA/cShyosiJIieKnChy4tHkRHlR82TgjwO/CvjLuHgzrwL/Hvj12g2s+6uBPw/8JVw8lu8Cfr52t+b+MtwSqT+Bi+/yVcAP4HaWuhKq+iMi8rOBP42LjwPwg7hYMKjqQkR+nq/vl+Featzx9fgXj9jmx8X/Bnw0btvtKe7Fzf8N+M5eui/ExbH5y7idnv4q7sXSp4cEqnpPRD4L+JPAX8RtO/4Kbsvu7/8gtqGg4C3FBgmPzDIn2F5Ih/ME4WuiBUc8E8iFa1/o9o+9jlrH+qa6uL8mrFkOx3HUQ3wzRBz5DuH81AgqNlGTAaEcrkUCoYkmrMgPjIHagDQrTGPZHe9h7IrDsxOox9y7c5+ffPFFjo9PGY/GPPPMDbZ2dlAR2rZhOV/QrldUMkZUoVEm4zFnJ6ccHt5nNp0xX1teu3vAa/ePuVgsXfGjCU0r0TXYSou1DWotq/WSi7Mllbd4GRTEOjoVYkyIQdVi/FiCYm2D1RHatqDqYhcINI0LBLletbTtitlsRiUGYwy2rWhZA8rO1ph3f8zbuH16nRdfucPJ+Zx103K2WOCUOUFbSy3K6v13OJ//Oz710z6F0/MLXnjlLj/8X36CG9f3uH1rn1s3r/P2Z5/i+OCYyWTM1mzK00/d4uDwkNW64ez8AmMq3vXRH829e/e4e3hMVY9Qq7z/A69ycnrOjevXuba3B4xZq6X1w1Yby429GYuLJRdLSyuGRsG2rds6OGqlOTH+ICHx4CsTBStqZ1mIvFEVc/NDcORUnc8ESttNNeQi8ZgQ3Wx24MbhUZSX++jPj0S6k+u+K8N6Ip5iL5QYNZehyIkiJ4qcKHIiVqLIiUvqecW6qIKCgoeDuF2d/jMuvs0XvNX1KSh4s/CLfvEvUxGJbqj5B5JlNBDXaJlEQSr/SVaWQAhcehMJStft2+dgW4wxiLdK2rgjRkizaaXsIjAP9XUIW6WCWy9tUIKLrcGIEHZqsNFqIpgQc0Cd1dQaxZpgOfEW1lgXv6OCOoIdLaXeHVdEwSgWt7XsWJStyvLOp/d5em9K265YrBpefuVV7t536+qnkxlqLWKEVdNwcnLMarXCCMymW+zu7KJWGI1HnM/PODo+8q6/hrP5ksPTBWa0RTUaMZ+fs1q3rC2sWli1DeumoW0d2TCAtoB1VCqMr6tv6HLjCLpaKqNMxobxuKKup1SmwghUxjAeGaqqcvZwbWlonMVZBCMuj+3ZDFMZJiNDPaqxZsR81XLv6IyDo2NOTs5ZNy2tqVELlbbUKNNxxY2be7zrXR/DwcEB9167y/7ujBvXtrl1fY93f/Q7efb2UzTLBfcOT7BVxWK54P7BAW1rOTo55c7dQyazbcbbu5yfz7k4P2M5nyMo1/b2uHnjBrPZhNV6yXRsuH3jGjs7M55++jnOF8rR6YqLNaxaoVWLqSqnWCjRqqxDZsk+8mkr2THJDzBsic2zt0QlWNUiBkKARxssiJ4wtq31u3X4jUc1t4m6wkN8j866//BbPfGUBmj8DV6hdoS1Fa2s3KwJ9bGWylReTw9kPdQ1PB82OyScC+7srhW9PlVobdu5F+MSA03u7PF6I90ysnZ5uu3+s4m8W//ssv6Wz/N7z7d+4xujWXwYo8iJIieKnChyItahyImHlhPFo6ag4DEgIp8PPAe8F7f063/Abef9m9/KehUUvPlwQqaqkkUgWkcHD7jvIuLWIOdEtmc5NWFrVY8uyQ/mEMdmVZ1lTwTUWG+gMd7SKRtEoWsdke5fFcRUKNA6v3JHvtVirHPjjRYWEaicpc6q21qyEkfKA2HpEgIB4wiHAWoBUUtLg9Se8AuMBSYjYX93xrM39hizYm1dcMMf/4kXuX9wSGuV+bLh5PwYEObLBfPVGrXKuBamtUFUuDi/YN3Cum05Pj1lsVqzblpWjcVSsb13AxXDyfEpFxdzGqusFVYWmtbSto4wK0qjPpaEeIIkBitOrar8CVM566Chomka2nPL4twyHiv1eMTWbMZoNMaqpVbL1njEZDZjblfMl2tWa4VWGIkg8xXb0wm2Ekw1RlC2Jobnbu1wa3+Lo6Mzjo5POVlcsFy3QI2osGxalvOGV194ieff8XZe+sAd3vfiPV5+7Yinbp5xdLTgHc/e5/lnbjGdTTldXKDrOe9+53MsF0uOdnfZ3dnnx37yA5yfL7hx7Tq7N29zcnzC6fkJ5/ML1veWXL++5wbZjlktlhycX7C8WPP0238KW1tjmvmadtG6PjMwmU6YL5e0bbAUZkFP/YwJ94OzvPWItY99EQigkUTjgiKa0mrOWjvcXQlbplb+XhN/zMcOcDZwdz8Gsq/qyGfuIi7BMh6sjl4BthbV1i8LqT2hFpQGpKESwdnZrTu+QVElaCldFUN9SFcjsR7WRm3EW1yDap21Pdudx2eL+iUrmrXFlRvShuNKGAkJUUbUqZ2ufYJaryjE56BN9SmgyIkiJ4qcoMiJIiceWU6UFzUFBY+Hc+C3AO/CPcHeC/wKVf2ut7RWBQVvMvqu5le6h0qiGe43UdhJvDZZRPO/g66nPZJvMCC2J1A1cpD+9VHgDkC99TOIU8nqmfOhSGrUlyrdsH9Da6kVZTSu2d/eYWc2dZbDqqKlZblaMZ6MGBmY1ML21PDUtW3G0nD31Q/wgRdf4OD+Affu3UeBRpV1o1iEprWIMexf32daG9bLC86XC9pWOZ+vuFisWLUty1WDRdja3mFUjVg3yv2De1xcrEAtVqBRWHteU9eVI37q15pHa5BrTSuJQBmAyjhXX7VUVYWoczdfrdas1g2r5YrxuGZrOoJJxWxUURlhZ7rFeKSs1i3WCsuLOaPabbG6WM5REWazCevFkrqu2Z/NGFNzbXuXhV3wyp37HB/PnYJXVa7M5ZKDe/f41E/5RH7wh/4Ld+/d5+VX73F8dMidO69xcPg2PvbdH8Pe9X0Olwte+sAHmE7GPP+2d/Ds20ZMZ1vcuXuXi/M5YiueefomT+kNDo7uc3p2xOHhAePxDLHK8fEZtA3Hx6ds7Vzj+lNPuzFRkKriYr5kvYK6HjHb2gYRzi8uaJrGWd6DAqnOGhcsobkCt3EfiI3zsW8hTDS5O+nz49kd5wvPabrERGme51llafKyNVwjVFJh/Zzp1Eiz+9LXK8s5KdexdpIlvhyd+y23foZD+ScoFyQLardX8n7OMsjOd4Yiemdcpug/uShyIqQvcgKKnChyIl1a5MTVz8Pyoqag4DGgqt8AfMNbXY+Cgg8FPBT5hkQUMoHurKbZtSKJGOfCrZPep/FSVAlrusWLxc0dEvoWiyvrqmBUk/XPHzTqBHaf1ORC3sVM2DzfjZnQ0lhluV4jRrCtxRhh2axYNyvGxq1hH0vLcmLYlpvM7ZKXXng/L73wfk7OloyqipPzcxaLNWqE0XjGjevX2d3bcRbN1ZLFQjm9mNO0wtl8wWLV0iBgRlRVzenFkrZdsF63LBcrRJw1LydnIs693Ln/+tgQ4BSNMJ7eCoZ1rtBq14hRxnVNJVBPKmoZoaq0rcWqsm4a5vMWI2Mmy4rKGKZ2wriqEQP1eMRYYHFx4WxTAidHJ4jucnZ2ymQyod6tGVUGURiZEdvvfJbz8zX37x1zdnbOar5gfG2Xg4MDZru7fNzHfTSTac3BwSHz9YpXD09YNC13Ts74aT/13XzMO97GcmeHk8P7vPbySzz17Nv4xI//GO48fY079+5xcbHg/sEx+/vXeOrWdWbTmtOzUxqrrFrL0dkZEzFMRjUvvvA+6nHN/vYetBeY2lCbKSfnc2zbUo1G1KMJIurjVChiTGZd9xPxEpf3NJ+8UtRTJhVcDAxN1tPErb2V1F5uxQvz+TJc6SjS5aCxbM0mll6xGdJwub5ntEeMO9dly118YY8XW8BXMmk2QxrLRrnFe+ZqFDlR5ESRE0VOpAspcuIhUF7UFBQUFBQ8NvqxBjrHIcrNFHsg2H4kk2PS+RYJfX4mJ/nir1aJqYLsMyKEnTRCucBg/XL0BbXxUSA140B5fTp2He3aVUJLc6GcB8esKnd8vlyxXDfevdmiWMa1YIwibcOoViZVjWlXvPryB7h/9y5t23B0dEQ9GrG3t89zb9tnuVqzWreMx2MO7t9luVy43UFMTWtq5qs150vnwt6KoR5VLJcN61VD07gtKKfTGav1ylmZXRdjvIt+s147a58IVlM/ROLh+702PjikESoDRqGuhboybsQtGFODVM6kalsWyzUG62IRVDXjakRV11jbsj0dMzLC2dkZQoUxQrtuGdc1F2dnzE8vGI+nbG/tMB4JrVVu7G5zY3efu3fv89qdu8xmWyyWCw4P7vGOd34U49GI/Wv7HB0dsW5a7p2tuGjuc3DyvZydnfEJH/tTeOa5Ge1qwcXpEeOR4freDCPXOD4+ZTIyHB6d0FrlmdtPMZvOuH9yhjE162aNiKWuK44ODvjAC+/j7W9/B+NqRF3DbDpla3uLe4cnrJZzZltbjCc1Tbv0yl6NtX5dOxbEb0WazdngCh+8CoIL98ak9LCXkFkVv8NOMFwyyC0vRTJGDhNiJXgPdHMMRDzcG3FNf+d+zG25iakHz4erCHj+veshEfpq894Md+wQWc9fDLj2Xl1mSFve2XRR5ESRE0VOFDmxWUKREw9CeVFTUFBQUPDYyMl3+G5tCNZoMB2m6gIA5r+zP91843/dsoDoViqJChLXcIsTtNa2iApV5dZWB0Hfj64f6tsVpFBXFaqwVotV67YdBbdjhXaVDlVNG8RaX4eMhPehqpjKYKqKqhphTIPQUlfKdGyYVQ17sym7k4rarjg5vMtqccF4PGG5WnPj5j43b9/mxs2nOD49R8/mHJ7c5869I0bjitFkhKnHnM/XnFysOTmd07QWMC4GQbPCtm7h9Xg8YTwa0TQtxtSO/GlLa1tnSPMfgyPZkgbAkUT1x/05I25FeaUC1rJuLTqqmUxGjEcjVIV1Y6lHI4xRmuWCVWOZL5dMxxP2p1OMMVycnzOqaxfTQpTzsznWQqOW9XpNXddMRhOOj05pVmumu2PatmVnu2Z7awu5dRNUGVU1e7t73D+8x/PPWyojiCrj8RSMslitOTxbMl8s+K7vey9t0/DJP/3jGE+3WK0bFvNzJlszRpWwuzVhOhmxt7vDwcExq8WcG/vXkKrm+PgEgbgjitqG06NjTrYPuHbjBtiKdu1iPexuTzk+n7M4O2ZcCwttsFoxrkcsVw3id4LxrBARH0zTmHhv5eTxKtqczz6buXj3UzlFKvNSyMbZlZfuF0dmN3NJyqa/K41xaa2zjhN3vgg7vXRJeKyNJ7DBZd7dz+ot+QabWVmHrJTht4hgjN8ZxiZSb6LSaJxXhUi0GofrQlyDEE8hKRKbBD0n7irixyw9GwqKnAh5FzlR5ESRE0VOPIqcuPJFzfd+73c/koR5fQIpfzMG8e032jmXGgWXuXqpKutmGTt+6C1+v875W7+2tTEytKrSrBsuzs85OT7mP7/3vfzEj/8X3v++H+fg/l12d3bZ3d3nuefeznq9YrFccO/evfDoBeD8/Ixmvca2DaC0TcNqtQQUYyrqegRA27Y0bYuG8t3jjap2N15lKu/Rpe4mNG4y1qNRvEFHoxExErZCay1Ns2a9XrGzs8Nq3bJaN4yqmulk6td1rjg7O2O9XjOa1M5VsK6AisVyznq1YrG4oGksTas0LYhUjEYV0+mI/f0993AQ8RG5XZ+fz+ecXyxYLteobRlVLtBaA6yWS1Qtk3HtortXI0aTiXuAG4lCcr12faVtS9u27iYWeOr2LW7euMa1a7tYq7Rty2KxBN8363XDar12a1bnc1artbs+f8vsbxRrXQTuyXTk0tjWbQznI/uPRxNaPx6mrrjx1LMYYzg+PMDg+nx7tsVydcF8Puf09Ayscw2tatOb2eIfpBVVVXeIi7WWpmnd3PAPubZtUdtSj8ds7ewxne2wXq+Yn59jm5Wb41XFfH5BVY2oqxFVNWK5vGC1XkD2cFN1OxKIJ0F1XTGeTNje3WNre4/5/Jx79+7QrF3kdTEV08mUtm1o2wZ07aL4q3tIWywqgqlnbG3vMhqNECxjH7xrvV4jdY3alna9Apyw39reivecGFiczWnbBmtbVqs14+kWk9kW127cpFmv3Pw8P2U8GjEajdiaznjHO5/nmWef413v/jh2dnZRlNVqDQq2dZP/5lM3qesRgnBydMzF/ILlcknTrBiPx0xmM27eus1stkVd15jKUNd1fF5c9dwI+PRP++yrEzwBGLJEpmPJahiP5+niv5fIjp7LbX69+9fgbEl+20NCeZ68DwhmoENkBtui3lFYYhQDFGd1EiRuL5q3wyCpGRobPwAXTNIR3DVt45+NNGyPa557+jrP3d6lalcsTg7YGm1zZFe8dHbB4dEZb3vHT2F7b5sXP/AS73v/C0ym29w9OMJSceP2U4jA0fEx9+/c53zZgIxotQLj1uLTWFAX6HFU11R1hfXbqTbrFqSiVQ2O0t4i6tpXiyPDVgQrzgXbAKKKqGK1cc1uXTHiL15pS7NuqXe2qMcTVJwFtm0s9aimMrC2cHB6Sj0ZcevGda7f2GPdNITAh02jLFcNpq7ZGu3QNg1GhOfe9ixnZ+ecXMyZzxecX6x56qZQ12PGo5rRqGLv2tO8cvcO9+4e8M63Pc8P/OAPMR1PWawuGI9nnF+cMV+2WDvnP773RwD4rE/9REazNccnR+xiuLa7z93FXfZ3tlmvW0am5t79Y0SVp29fB9twenJOVY/xjyBOzi/YOj5md3+f1s6xUrG2sHf9FiJwdjGnHo8ZG2HdKJVAJeJ3ieiS3iFFkWy+x3k3cDbA9K18MKz9xszyewe0I0+GrYrWOhlsRJzDgjpSGu6k6NxwhcXR5R/a373A7X7S54OXu60/6Bl+FTaXogyT8N5Fb0jZH2kocqLIiSInipwI9Sxy4uHlxFvqUdN5sSObX+P57Fw8pr0TGcLbsfBCI7wpv7oubEys+AYM/0Kkrtnf3+P6tescX7vByfERrXVrKKUyjKsJGKeIL320brWWtm1Q9W8KbesU5iAq/ADZ1qYXRK4RvmIW27buzbqEl07GPeyspdE2bvNlKkPTpBcRghNWIhJfBtV1jTE1ouotFs6iYCr5v9j7zydLjizLE/wpM7NHnAZBgCWrzKysmqmeGZlZ+mVl//eV3ZaZ6p4u0pOVlQQJIBDM+aNGlOyHq2r23COABKpJjXS6Qhzh/oiZmpnqvVePnnsuJpV7FhA8I/cxX3sMHqOECpdIkCIhBrwfKMjEMHiMllxVrRTWGKKN+EGuIZFyyb2cE5nRSCVJq6icR6pSRBsL1qCUqKTHlCB4SNC1LZvNhsViRkoIioomxQFilGdmNDYJ8KRQeO/x+ZoV0kcf/CQUFVPOcc30S+I4worSeYyBrt1hbUVTzxj6gegDXdtinKVpGhLQ7lqUkgoHEhjIfyoHC3L74uikldKk/CDH8c+B2UmIWniMlO2Lw92Jcexmo/mQRigE4IPAJI9ppVUGOTr6vpcxW9DuGInByz3RmmGY0GKjNUkk/FFEUgykaDBGgosUZSyr4FGIyFzfx8mopgQaUkh5bkRC/k7wA77v6bqW4IMIqPmAcpVUSdDF6EaC93R9J8+l63G2GsHM4COKgFKKfhikqkAIUvrQSK6zcw5j8n2ICe/9OPetteNcum8r/lMA6f8228Od0tFxFTt0+NnyS3bM458fdOiMjno8x8PzFl+gDmZOmgLwDx3/Q8/w3rlzsBHL7/mn9KfE34oH/wqOPNKIEzy4+vxqPk5KkUDEpISmY1kf82ThsKFle3uFDh1tF3n51Zd0vefzn/ycejHn9btv2LYdVb3g4uYOW89x2uJ95O5uxXbfM0RLUoZ9J3R0qUYCFgFpY5LxHmMgpEjvvfQ3JRKTvkAJfwxaqOkakoakFWipXOKUwihFCB6jNSZphj7gfaQPEe/Fr603W5omYF3Ndr/HR/EpJ0dz5vM5fd9yfXeLMfDJR8+QhY9suCSlGVLEp8RsPiMMPbWr2G12nJ6f47c7Wn/LZreHeMlHzz5iVjfc3NxwcnrGfLaUAPyzH3F+esbbiytiPzBET+VqhkEqk2z7wP/+D//E2dkZv/jZ56jdntvbDUY7ZvWc9WqFsZbj5ZIY4PLqGj1EPn3xjDco1utWbKkPbPd7lNZUdcPJ6amMd23x3Y6T+YJ5Zdj3Hc4AQVOhJbEhgrKamMJoyUtccW9gHaR0PBhheTym98ffwQbXw+2x+03xYDp+a9B9f6FA3miZjlzOow7mxbe1cQ2bAPRBHw79B6hxNfGfHwz58M7r/fe/raXx/98BLPyZtkc/kf999BOPfuLRTzz6ie/pJ/6TgJr/OguW7x4i39YKEh5jHNkZH7pphzf6EKjRWufxLUa8LOpOjk84Ozvn7vaWV69eEmOi63tCjFgrrBalNN57+r4npQhRFqIpyYI2xgymaCW5fzD2NYQJCS3rWWHIhMxaMSO6GaOUXQshEaKwJQYT0VqMrVYakxkCWgs90xqDdgY/+OxMMlCjFMbozDrJNEWTKWFG2B9aB1ICkyDEiTYa/CDAkzH4MBCCwBFaW6zRJGtIQUOS4xoFUatxE0SRUCmiUhiddUqCGmsrKu9h8HKPlNAR+65ju1X07WmmzWVoJWbQIAkYY4wBVwkIMwYHEY3CCMQAFOBM3I5Q+0Bl5oiCLN6V8CHStS2pgqaeEfqQQYKWZbWgriqMMUQv96oAhillETAQpLcANSPoIP0S1kuevtlPcwBujJ8hoXTunxLQbCzQl+I9wEfucHakJShSoIxC5fN33QTUlPtPghgDVhuMNvS5H0qlEQgsxiZFYSspK4yuWPoaZP4ZY5ASfGmczgJMRWIMMvajgJLBewbd0fctMSSCD7JzgLCtlIaYIj54hqFDdTJuu77P1RzUOKdCCJCEwTUMAyFGXGZ/aaUzZVbmbIiBFNI4N+X1aTx+H4rin2NTuepFCbYLCPq+X3zgfRWUXZ5EvPe5cVyVY6qD9/L9z0NZZq7iYKf0wfnGk8Y8C/R951qOddC18ukCdMvu6OHn1ZiLr9IUkZedHSlFekD/ThN4qlIaS7oqpTFEtAo0BhoNm9srrne3OJV4en7KP/793/PHr17yq7/+H7GzJX/8+itu13ckHO/e3dDMj7G2Zt92rFYb2n4AbVFK07dbNFkPQMn5rBPAv/MeHwODjxl8V6Bz2U0FShmxHGVjQQmLTqXCWpvK4mprcNbSKIczDosi+AjKsOs8+0GCfEcghMTR8QxbVaxWd7R9x2bXoa1hsZhBClxcXFBbw7OnT+i6geVizqbr6dY9lXcoW6FRhBg5Wh5xfXXJJz/5GdEnbvrAth345s1bTk9PqCpHVVU0swVtu+NuveZHn33G1eU1Bk0fEn3yRGAI4KJi13n+7h9+jXOO85MjnK75+uUrzk6OcdqNrL3T0xPWmw03NzfMZktevHjB8qjj5cuXdF1gu9lCSjhXkVA0s4bjkzPC0DM/P+Pk7AWb7Y6X37xmmyJ13eBjT+eHPOblPCqP7xjyCFdprC4zBuFlLXowCZSS8TbNAhnlH7Rgqgzgw4XowaxI9xfBYsqnQPN9Wvr9Q8vGkHy26ClMGwzT/CuBuho/X1a9auzfPabCB+zxt9H2S5wwmqDRBh1eqxrX9AeXLq/nezAe/QBwGI+R+zhasUd/ATz6iUc/8egnHv3Eo58Yj/ED/MT/6TVqxgHF/Qf6Aet+8A1hn6S8oAwh3Ft0ffBbmaECjDl+IIs9Yw2ucsxSw5NnTyRvMwW+efmSm5srbm9u+O0//xpjLSjYbXdyUK0gIrTIfPwY8yJalfQeARfCuLgdXc84MMtldV0vzk0LAKONGHEBauT4afDEFDKbRQN7Qa61Zj5f0DQWa4XamFIipIEYvfxkgMYPHmMMxhqaWUWMkU4nSX9RIU/+fC9DZOh6VExoJ2i6954hBLTusdYynzlqpyX9yHtSDALCKAUanDWYnANIlLSbpBTRSz+sNaRZjbMK71VmzCT8vuPq3RXHx0fUdU3wA33nGfxA23Yoa6b7HAXR15VDq4RRGoNGD8PIZNJaHYBpQtccKbC5TyZqfNeTvDBbtLMQFb7v2W83VHXFbDYjLo8yQyQJUJfTh2IBUPLti8HLc8CXgShPPxRCKfn5ZSMXAorMhiqTI00BhAJSnD4Tx2AlGw+kNKXWoLWkYGlj2G43dF0ns6dYwcxYcbXBOkvYxnHmRS2pd2VGCcgT0SpR1xUKGPrIMPQYY7FmToRxR6auarknPtL1A8EPOcVqIKkIOjL0nWB7Sa7F5DnZ9R2bzRprhcH07NlzrHE4DEPXYl1F1TRjCtzQS+pUzPMpxkEYXdRYJ85ZG0MIgWEYRoCn0Ec/RNV+bFPT2VtN4aYA3RGxn2Ogqu7fPwmshZKekiapIMChKvyzRCikszLGZYDnIFhnWwFJRYFblUInSEmhlKWAl0onCSYPov/i9sv4UmSadX7HKCN574BOJWjPoH8SWwcBVAlgExGNUpaIXL/k4QOEvGuV8iS1+ewBqyMzp6gU6BRQUTG0A+t2z2bb8dXra06ff4pXmt/+5te8vbgmKUtMGm0WdB1cX9+MwcQQI7u2Y+g9TW0hKdpuwLka33uGGPAp4hUMWoOzxCCg/3iJKt+hmDcaAK8CShkqa0dGJ0G+E4wIXqo+YVWP1aCMIqREUIZoFSEkVNCEfmC/3fH8o+ds12tQmp2P7G9WvDCG8+Mjgk+8e3vNvJ6zmM9IWvHJR8/ouo626/AejuanpKGDvuPZ6Sn96pZf/ORzvtCKN++u2Aw97dUli6YBBW7WcL2+5Xa74vT4iLOjY9o2crvf41WENIC1mPmCGAbevrvlN//0B/67v/4ly6MGO5/x+u0Fz07PePb0CXfbDcEEPv7sY+xbx6s3bxkiGOt4+uyc/ayiNproA9vNnlV9hwHirMVozWq1xjVznn/0nLcXl5i+p6oc7RBQGtnIQRNyvBB8yHNFjeOo2HzUxKWUZWaZLDBZacaYYgx69fS5RNEMmQLSmHP/ZdMgj4c8/iUIVwc2Mh1sTOTe5Ok2Bd/Cfn0vJs39SJlRLIvBsjGRfZiejiHXMr2nKSxYud6Q4hg0U2wFKf+bF835viYKqwPI8zyVxXdmY8cSVOcd4ElbpdifKXTXOQgvvlQXwdo/8/boJx79xKOfePQTj37ih/uJHwzU/KfvDpRVIPmCJ+RN3k1ZLfwQkSsoejHYMELkh8dj/Fj+iLrHrEkpvZcGdciiOTzOIctGZWDEJdDGUNc1y+WS58+f44eevuu4ub7C5N158m59IhHCgBrZEgdouVIjE6Q8qXJ2IZ7IRIopjjo7KUZSEiaND/latFD+lBInkyIYbSjj3bm62FP6YSCmSNd3hCEIO0GpfH8yUJQnR0wJEww2OyeNwWhL0ghgQ7k/KosvCWvHZfZN8IEYJU0pxSQpJloTgiMM/fg80KIAr1UWclLTfZC0r0SMCqsVtq7AWYL3eUwkwJOSJ2Gp60qYSySMHiaUMzOPhLXhhZKpNGibDUoagQ6tDUprgh9kAiqN0vJMFQlnHeSdoegHjNZYrbFNTfS9PBsfaeqGIbOqYpIFvzEGQsjHKmBcAXrHp39veKv8Rwk8kojEYIxhCGEMeawR4E4rldPf0j1gs4zvMXUoybVa46hsRcxgVQGRyjQX/Z+I0gFJz4pEhMFVdsZIknOMigweKpe1lKL8FPU8awQw1KoYscAw9ISckiTjUAK6GAWUKlr2xhqqqsI6m8eVjNuu61Bo6mZG08y5u70VXaZ8vBA83g9Y50RnKKdWZWsielFaYzKT6NAzHAI1h2yawjp6bNIK1btUdxwd0gFIOAbP8gnKhJPPTM6sjPoiDocubvV7+J0D/zxqFCRVJlEO5OVDKinCwWfzqwc7pvfLtj6k8kpXs61SxY0plMkOPsack69GE6/K5EJEFFUMWAvzxtHYSEXiZDnH6URvNIPWvHz5Dcdn50Q0v/ndF+zaDls3+AjzZsl+3/Pu3SWLxZKkEpfX1+w7D9pwdHxE2/bsdnuUNQSt0HVF3/WioWAMJgdylbOkECU9sIjlhaxRkPuuFTijqCsJdnzwY+BilBaaPKCiPNOUEl3f0YWIT6JFoNHEEPGrgWrWcHp+Tnv1jhilDO3LNzdoZfno7An0LS9fveWnP/6MxdEcjOHHn77g629ec3PxlpMf/5TeB4w2HB0dc3F1ybt3b/jLv/wlgd/y9atXJGW43W652Wx49uwZv/ndbzGvX3O6XPLpZ5+xagNps2MIg4y54Nnu9hzNGwKe1+/ecXp+whN/xpOzM3brPZfXt4Di/Nk5l3fXzJzlr375Fxwt5/z+iy8IrgI0s1mD4YzgAwHP3eqG+cyx3miOjML4ipdff0XbrqmdYoPHmkRlJkFOqx19FHte/OxhtHTfl5SQ8+D9xMHnuWfHvi/mfE9mQ0kwTh7/P6Q91C2Y4sD7YPi3d+TwYAeL+R/Ujen678V43+tmTAuasjv6HhsbeXb3r/OxwaOfePQTj37i0U/86fboJ95v3wuo+b7O5mGu1p9qB/bo/jES793s8s+hErwYvW/v22E+bDn2d93s0v2HNxUY0zdAwJqqrjk9O+H29prVyrFe32ZhVwEMkjFAkkWiygtXxlX5hOKVB5k7UNbsBfXMFyCASgF0UsqAhEInDYaRNYJOGYABpUTJHCDFSD940dPJ1ypaMgqthelQGD0pypm9j7gQx5tvtCHphDWHlDg1an5Ya7HOYUIkmMAwkI2GsJSM0dgoCH080EIBBBXWmkwkHcGLlEvQOe2E6WQtwRi8H4gxkJLHhx7j5fzGGmxyOCcMoXh4z1OS9JwIQQutbhSKS4KiCmCkSDkFTWlBS8szMoLy5OAhopKIJ2tr6WMQtDkk6tqQ8rWm7OSKDs00/DKAp+4jx4K+HgQABTACUpw0iFJBb5XCGBFlVlqTUj8aKHUAuuRD5bGUZCdISzpdKshxDkKSBnJ6W4gRHUX4OqQ06s9onXeqYhLRt5iIQUA0ASfLNcq9l/mhx3QrEU8WkCaEIt7N9G9MwtrJgJBzDussQx9HNlrwAW0sVd0wWyy4ubkhhZLyVJD2SFVV+CB6N0PX5evMJQz7gWj0CFqWPsSDsa/0ZHAPdWweGyMQVwLRWHZJxlhhCrgne53G75DSGFeUgK7Uxii7DN/PBxVCfT6uEmq57GbKizoH3xK0qNFhlu/pbGcl6Hz/+U5OP+VdpHycwjDUkFIQjS2AvBOMUjmkFzFFkwJ1bVjOHfNaYdXAk+NzGqu5ePOK0O8xSvH8xcdc3Ky4vr5j7xNDMjTzhmUzY7/vub67Y7vvqGZzCXYHz2w+Z7k4oveeXbcmWo3Smi5G0dQaAtZZnLNYnZjPZlilUCEyeM+Qd00hMW6kFbBZ500trXDBCThvpVToMIigYwS8D8TkZacIhdMKYiRlynzUilfvLvjZz3/Goj/C1ZY3b6+IWvH12ytIhvPlnPmi5ndffM1PfvwJIJsLP/70BX/44itWt9c8ffqMi4t3VLOG5fGSt5cX/P4Pv+Uvfv4zbtYrtvs9WMvl3Yr/4d/8lNOzYy6v73h7ccV//6u/ZnF0SXVtGXrpbwTaYeC0OsZqQ+s9f/jqa+Ynx3zz+opPP/6MV1/8ka9evkJZzXzekEKPSZ5f/cWP0Wngy29egRLdh2Y+z77F0/Ut7bDHeUciYEzCh8D15Vs+/eQTfD8Qhx0Ej9Piu2OKBJ3GVONC8z5c0MbDOGEcqcV3HqaDTGN4jIm+w4QdTlf13hv5l38BEDHpk9xPO/8h9vQ+jXzq57+kHz/8e4w+4hDIL38/YjPf0h79xKOfePQTj37ie7ZHPzG1f6XUpw+gMAd/ysVN2jLTt77je992JqXu0axCCCNDRd5nvGkxqnHxWECZkgYhqUtSWajre3yMNIsZRycn7NuWtt3Rdz1hCOx9y0iWSQFsJedL02IUyMwhMeAxCaPlUGFeoajqWq42JXzWHhH/JrmdQYu+S2VqrC00zYjS5HQilfsO680uG1FNVTnJOU1RKjzlPukMiSekak8Y/Hi/rXXM5w3WCbOh7GwIUJDZEuWZJej7ShgTwQMhGyKoZw6jG4iSMjPkcyilsMqOT1cr8jMTXZi6rnFNg2saun1L37Xsth3tfsDYNc2s5uj4hKapaZqG/WYnx/eDpFdphUZALhIMQ8BHAa5GHSMEGRbRZX1gqEom4ZR3qJVCxUTCk4jM6jqzbzRt35KSGFmVjKRXpYQxehSFRhUtpcDgQwYVyFTY6TwCQEn5waHvQOkxLUvGt1QOM0b0i7p2L+NvjIyCiI4pLWBcCMISM/Lc2/1+TKkSEbhcprKk6iGAm1QUK2lB2QEUfZwkxy9zZvIJk3HSSo3gkABAAZ+rPRWdGhnrCpJUQTPKgtIkIlUzo64cIQzUdUPlGsCwWCyZzWZoo9lvNxhrsc5iayeCSAoRk9vu2Mc9bRae1soQfSSELs+RRO89KoHTFmUn9l0cGXFRAMn889goA2Ec0yq/ppD4U32gROlkf9PkDsr733myCUz8cIB84CemSBzIu0/5hyT6YDEDoodVDrRS95QQDoP/e+ByCX1SIcsnKKmtSK5/Qk1AbIqgBNx1Gs6WC+Yzg4p7npwsOV7OuHjzmvXdHUZHNvseOztive9YtwOXVzcsj46Ibc9637Lb9fiYWBwvSVqxbTvQGhLc3a3Y9R1uNkNZw+3dihST2BJgCIFht0dp8F2HjgkLucSpHTXLrDVoLSLqSoExCms1s9mc2lVyr5NU5/M+0A1yrYMX219VbtxR3bctbQQGz9BL4sDX37zir/76l9zdXVFVju22J6bEN28usJ98zNHynHrmubndsJgZ6sqSQuCjZ0+5uV2h9HO0cby9uOLzH33E0dGCN++uWK9v+MUv/4J///f/SIiRbvAYo2lmDW63Y73b0Q89zayCJP5JKYkThhjoo4C7Qz+waVsur294dvaEm7st588/5vrdG/7wxZd8+vkLnj09pWt3GAN/9atfsNlteP32Em0atKnFV5KYLY7zAEyE5PFDLxVSNOzWtzRO0w8erQLz2tHM5+zaPX2JP1JEYUa/W1pI6d4GVlnTlugipSlgfW/zqozbPI4fBpD6YNMsHX4vlc0H9d6xD2bj2M/DDa/ytwDjTBtU0rEPBvWHx37Ifv6QwSgvHe5oHgbth/fh4a7nh9q9gP/ge4fXNvXxEan5YHv0E49+4tFPPPqJRz/x7R36lvadK40/hU4/7MD3ax8AW96zowJaFDFXGQNlwEy73GPO2Lf0uTzLw88U0GVa5Ba16KkkdPlMAXb2+10WqY103Z7tds3NzRVXV1dstzu8D1Ju2VoSopEyofEJoxPWKLSx43FiSiQ/CKNB54X8qK4r+SJKaYytGYYhG7iSiiFln5U2wvjQAsiUUs0JT8k76fs9pVBQVcp4a0XtKkIYZMGd8h1WWgANM5Vwlv5pYWw4m1kUh+lkMZcbjCTNPaBGdh4EeIg+5Pxexcj20IqmaXAuTODVAVAlczyB0YTU0XtP3O+pYoXWmqaZYbN4bUqJtm0JIeKqisXiCOukYlRKUUpeR0kRilncOYZIYVYoVE5jkmpAh2PSaDMaKh9ET0jGV6HCAjnNxpCwzmFtTYxe0rQIaB1H0Kn0V2txcqWKkZBAUlbTn5q1cr0qAlFS3LQqwtVqrEgmKU2y/6PGvgsTJ6q8+5GfqzZK9GBIo0C1KYGKNgIyas0wDLm/MWvaTGBcTAkVQakoO1pJRMy8F+AtpEnnRcSu5bhKa/zQj6XQY2Zz3auwqRTeDyRlMMpR17VoyVjN4D1t26GNw9gqAzkwDAN3t7fM5jOWywV934lGTdYU2m42bLdbBu8xzlI1NSGVyl6SEibVrBJDGNBqYlWVimp933F1dYm1Uk3ssYmTVnnXsATbMDkpNT5YsTNlvMtnxrh7DATE0R846nwsQfDJIuwfCL4P/5+BzrI/Of03fVYwac3hGoAkNgt12Mf3z1XmmXxFdmCLugFkEFfl0qUJYTkmhY6BRW05O1oyqwyh37JsFOenS26uLrm9vWG2mNNUFcnu+ePrC95erbm6XbE4OmaxXBC85/b2BjB89NELVust7y4uabue+aLGaYd1Bq8VGMN6u8saEIrQe4zSNHWNq50E1EphQIJwrXFVg3U22yvRPCvBVkwCKG82W7ZJBBCt1vl+KIypMHXNcjnHVhWg2Lc7Ygi4qqa9uRWKdxSGXdt27NZbnj95yquvX0MMgMH7xKs3FyznM/7q5z/nn3/9D9T1KbvVFq32uEr0pb7++iWnT57yh69ecvrkiOPjE7re8/bVN/zir/6an3z+GV9/84bNekVlLMeLJZcXl/ihZ7fbcX5yTOMsu66jpKKiFEZput4za0S0crfbcacdq5B48fQ5ppqzvnjHxeUNs1nD0WLG7WqFsob/5X/+n/j//H//V16/uUJXkbOzM5zRrLcrjNPM7ZzNZgPJoDEcHy3YrrdEZTF2RlNZAoa6cuzbfQaRIySdn8PhMBwR8XFcjnOPKf4pKeCHsc8YW98b3pOA6sNAf5xXB/6pbIJ933YYyN6PzbJuH7Kg4CBg/lCwW35/n8b//vke/v5+wPwwbpwW7Q/b4Xc/dO0pZQHMMl9i/NBh/izbo5949BOPfuLRT3yf9ugn7rf/bFWfPtSR0tHv/K5K95/x+MwFDXtw1PdAtO96+IdvHTqFQ+SsvCY/OjuEUoFJNDR2u90oBrve3LG6u+Xu9obb2zt22y1D11GQCRnYiQNZndIBjDYMqCyelkgEBCAxI/pXJgaQWRwKH8CHcu2SoqO0whSQRhsKf1SpAtanMZdU/JYs5ouwsDNS80iqcMdxAW+0xpoJjS2LV0HMxQAk0gjSiGbJBM4IglZ2Bhir9UjZv6y1M9qM+zsoJMlnLWk4cTSGKVetEgqg9h5nBDRyzo0Lfh+S5NWGSOVqqlx62TmLH3qSKo5RQRABrMNnX/RbDpk0QNYdIqPVU/+Kn1bl2mMUEeQYBCDJqVSohDJTqlIMcu8gA1sJKaWVDe04BvLUEKaMGkWCi3kYgZqDH0jogzEnlyHhQYgHwIPOxiF5UhbQG+dDPoPSeazlOVPujRieg9Li44STsRey1k3KFZ3KMy+CZCV9KIQM0sQHeZr5gDF6iAGNiAZb51BKKo4Ng2cYvABfyDm997RtS11XWGvpupau7em7HtXM2O/37Ha7UYhbG8MwDGNAp3VOV/NeRIXbmK9BWDQ+l2G/vLrCuUegpjRNknzk7NGLnSqybUlNwOH4oXutWDwZm2rcsUnjHFDqwwHBt7Z0j2k/wvxj2Hwgfveh9mGvNTVNQo8h/qiqKELYYlWJ6NGGgwhALmvDTz97QVPPePP6G0K34Wx5ynp1x9XVFUprZosjbu9u+er1O169u+F6vceHxNnZGYZEnyIvnn9ESpp3765pu4HKOp4+eQIa5vWcza6li4H1fo8fAlYZnLYczecsFnMikX3XsWtbuhBkRyxELApjZcc1pYCPwr6bzWpmyxm1mxFChFGwPI06Cl3Xslvf0g6BgKaaLSBrjzVNzdHRMdo51hsRv+x6j0qBr//4FT/7/P/K8/Nz9ru3QEQpSz94vvz6G54/PePFJ59zcfmWlCLWROK2ZXl0xN36jvOPPsY2NV9+9Q3/w3//13z84mN+/etfs1+v+PmPf0S72/Pyq9eEtuX85JTf+cBus8N3A4vlgufn59yst2IbU8JZQ1M1GJ2YNZZ2v2W7WrNwNRrLVy9f8eknH2ObBVe3K6pZQ+sjTW1Jd2s+WSz4m7/5G3b9f+DqekPf9Zw+OwENt+s7mizaSdywqJds1nvQipAG5kuHsY6qntH7gX7o/vRYL1kTaYp5is8tYci3xUnjogOgVDksga98gIN/KNN8rGzzHdPx/aD2w6+N/T0Mzjnw1Q/ee+/7H+iDLCzej/U+9P3/HJpjh4uFeFC5E747Rv1zao9+4tFPPPqJRz/x3rEf/YR07zv8xL8ydz992B6rgteUFIoC2HwbHvb9mlJgrZG8yBjxwzCK2FZVlQEQSYHqupa2FfbM6m7Ffr9nv9vy1ZdfcHN9ze31Ne/evmO33dK1LaQw6q5YoxlCzDmsCrSaGDdt1uaIMWcDFaAGisuQ4ktKFr77XFY4hMyEOEBK82QxxhJiIqRA30mqT4pRKIyZHWO0pm4slbXYnPJiAoSgCcGPE0CEzSQFJ8RAn3qUUrjBjuyKcr+MsTlNpmQ/igCYVPORMsuFkeNcNTJ1QlGAD5MatzGiEu+sFRHerjtQwVbMmlk+diD0nqhyCpueJuasnufKVYn9dkuoKqqqYrFYoFH4QapOKRRaxXFcqQyiGTOlOyk9gUiSWpRFor0fq0SlAxTUWIsCYojsuy3KSE5uZZ1QDrM+i9GRgCcgQEZJFzNKgoGo4pRLirBWbNbIGXzAZBAnxURVVzKL7rGDJL1qLIOthFWTMmx+IN4uIJtKqFiAGhl3ccprwhibIW15yRhNSoaUSupVBgXjFGjEImqWfK4UpsZnDIphCKLIPwwiVhwnoe0SvEGUcaI9lWo4PT+jmc3wgyclxeAHYvBYq3NKYst2u8XHQD2fcfbsCV9/+RXr1Yp23/LjH/+Y7W7DanXHs+cfgQIfPNvNOpefN1R1Rbfr6LqO9XrN1eU7NusVt7c3OO2QMpSG7X6HNgrr7guT/7k22SnlPWctuffj/6Zdj9GKp4Mfxs9MY4B7znMCedN7buN9Fyfj3yTGKEFG1cFKgSk4HwOJ0fd8S6h/cJ0mpSn4Ro+9SkrlGiIlTFfE5KmM4sWzM86O57x5e8Nms+VkWWGN4vr6mn3bMpsv2LQdf/jjS95d39F6jY+gtMEaw+rmkl/8/OdgHP/2//e33N5tmc0XPDk7o6prYopcXd1wdXPL3ntCDn7nVYP24Pcdb1drfAy5aklm9SUNIRFUQg2eSBr1pFLwtH3P5e0KrQxVVXNyfMTTJycQe+Ig1QiNnXG8WDD4wOXtlpu7FUMGb5WCyhqqymFdxdFyybGy9N2efr/md7/5Lb/4yedcvrukHwLGGWJU7HYt//Sb3/H//n/9P3lzecUQBjZZxHG12RATXF1f8+lnn/Gb//iPXN/c8fmnn3C8XPLyyz/ys59XPD094ertBe/evGFeN1hl2G1abq5vMFrx5HRJ/Y1i34utPTs5Zbfd4Yyi7xKVVTRVhc62dLPZ4iOcPf2IL7/8La/eXuKV4eR4ibGey6trfIj89Kc/Zdf+lvVmjTWR4/MTToyh61qGzrMLLebM0Q8R19Ts25bF8hQUuMris9+Ydn2+ZTyqA6OeN74OQoSx8t+HA8H7i1qx6Xl+iEN475OlxPH3icXu74ZyLyC+t2nzoH/ftsH3oaYe9DO/eO+c3xaA39ttHRcJ8PCefN9+lON92zn/nNujn3j0E49+4tFPfKg9+onvbt8J1DxEp/4luwTpAw+/LPAEZb5/Aw4RtfcYO7KqJvF+2dw/xeCRBeVkyGUxrvEhZAMjwEARtd3tttzdXPPu7Ruurq5Yr1fc3a14+/Y13X5Pvxddmq7vGMIg4EcZCBmgUUoWwPagvLK0QoUSQbKQKwEJdS0Jq09BUlI1KiXJY7WmMBqUnC+XNvTDtBhWSqOS5PSFEFAo+Z6CGAZa3wNg9QEooQQ8SiHhGUatkxjTmNeoK4111ciG6Loeo3MZbyPVrgTEAasNrjL0uT+F+VIejbU6p2FJukrfC6vBGI11Fj0U8Gga0FZpktEkrQlR2CojeykzVJKPI8tIynsHBgaMMlJ1SmkGVBb0LUCM5MVOaV5yj13lDhANsM4JQDUyeMpEkw+UJ5tyWpKPkhJmtNBHdQZ/Ukp4pfCDwscwAlnaGJTShBgIwaOzQ/cpYvIANs4x+ABao52hrp0wv7ywUnRGt521YypdOgBZVElLK5cVUq7EEA9fRhkRJda5ylPKJexU1jzSKEIMIgiY557RDm002gBJQMIYolBXM96qrUVri0IqU4nwmXQuRRlvKht36XvAVArrhFETgzBppIJXEDug4erqAtDs9rJ7goKLiwtWt7fEEGmqir7v2O937HZboh+4vb5ms16xWa/GC48psVvvhL56d8d+u0EpRT2rMZWTz4RAUh4fpMLVY2Ms8yi1vMSuTUmB5aeEqUWosXy3jC2yedRZG0DelzkjYyLlYCMdRBhl/ChVdm/ieEpVogXyCZI5WA9MhPSUII6Df/IfSsm1xZhA6bwnmhDRyUTUxU89CJCSHN2QUCmQtOSXf/T0CU/Pz1nd3rHbbXhyfsyyhu36jq7dAYm273n56i03d2u0slgN86rh/Olz9m1g28E/f/mKt5dXtP3Apz/6Edvtnq73vHknAaqPoKuK05NjIor1Zsv17S1qCLgM2morTyymhE5gNJjMQFQqkaLY0spZ6lmNthofPEOIeB9Y71bcrW6orWXeVJwdLzg+OsIZ6LqOpp5xdjRwcbPibrtnSIn9MLDrB2CP0jvQmsY5nLG8e3fF+fkZn336nC+/fsvgPWiHtY71Zserb97w8ccf8+vf/BpNYr0V/bGqbrh4945f/PIvUVhev77g808/4eOPP+Zv//Z/5+LiCuNmLOdLvn75kl/86q+wrqHrtlzc3jFfNCwby/OzJa+ud1R1w8//6lf8/d/9PUSPTZGTRUOKMGtmKO0wuz3Xd9d8+skLmvmS27sbjLsleY/yC+ZNw/HJCdp2/OIvf87f/Yd/YLPdoyvL2fkZMUV2uz27bYuyhuXymEYn7la3PH36RGwrCpTDaCuleFUElVAEijLGtGbMGx5J3Xu1ULPHdJMHAWZKJXY/iKMyA1KOVM6Zz5Lky1N8qg6nS56nh+fPYymVBe+0tJ0EInM/ysqXItifxjhqTGvJc3b0taTxtRKEf3CJ8YGYUHxMXibrshAoFiqNMaZ89j6tXpUAO19n8bFlYYKCw1Krj4waaY9+4tFPPPqJRz/x6Cd+uJ/4QYya7zrQn0xxeu/76j66nt4X8TkEa+R5pLyAZfzih89bHsbh4yrnmfpbcsdEyDTh40DsReD06vIdN9fXvHv3jsvLC1Z3d9ze3nJ7cz0yM7quz9WHIlFrYioGOQ9s1Aj8lHxbyamNlAmSkLSNBNP3x84ylkwWMOEAzMoeJyHK6cUJlZzcMmAPrnxMuUkJ0CnrmpgJtcw6JmlkVGSHqURHp6qqqax2EkBCSnfLjU1JdIUkjURhrR3vs81VsFCZ3VO5ESApzBSlBImORtK0RtQxyrkoArlBHRgJSChhdMQ40eBUYZ5Egve4DLQYY4jETJstpNSiT5KBGpWBMCWpXjEK86WkGhmt80TL4yxFKVedx3G0FuX9mP5kjR6fgTEGVSavFyaO1rKborXBBE+fhA4ssYMedZSUzkFDrjJlcs5vVEoYOSo7fl3EoYvuUZ5r5ftlzmXjNxqT8swziKmVllzjbOZKKlcshilXB6MAQRl0jVHue8xVAYoB1iqn1KXJOUh/Ss52Yejk+xhEF0dYPUgqU9dlcMpnkK/n5vqalBRdP+CMYrPe4H1gtVpLLrVz3FzfsFmv2e/3dF1LuJNAbbtdE0Mghkjvh5FRs91u6PYtxsp4KXYjxsjgO5lL8b5t+bNtMnEnYUWlDuLuMTKebOKBZVJJjyVLySPtnlfPr98D4tXkiFWSnUk5jdg3NR4HDontpdrY2IpveehC8lgOKTFS0LQmRU9KAa0SSiVC8VFxPEM+gMEklR25gI9Hizmnx0e0u5bNasPzJyfMZ45ufU3Xd8xrR1XVvL665urmhqpuQFnoAjGKztKu7bi4uaO/vASteXp2xnq7Ybvest3uiWiWR0ts7di1HXerNf3g830q1UcCCo1RUDuLNSII6ZyDBD4GuWVBQMkQerq9RxlF1VScnS6oqob1Zsd6vSUOnt12R2j3DEcLTs6PWCwWpDpRqY7FrGG177jabNl2LSkluj5k0W5FGwMDAafg7dsLPnrxlLeXN/Q7qeonu7WaP3zxBf/L/+V/kuIoSdH2QxaD7yAlri6uePHRx7x5/Yo3b9/x0bMnuLri1Tdv+PTzn1DVM66uLviF1jSzObebLeu2JSoI7Z4nJyes2oiqavZ9x3q3pXaW4Af2Gjabjn3nef78CW/evcWHniF4fvqLn/Pv/re/5erimmG3h2Hg/OQYdQLPnj2lHQY+/vg5r16+Zr6cs16tqZyAvl3fcbdZo4ym71v2+w277YrF8phut8HVC3lOVU2I4P2AiuGe/cxWfApsppk1LVIPhrYummU5+Dwct+IPst6YYmKMFqN87/jjJDr4ub94Pfx7CnAPvpY/qKauHhztgW1Nh8ec+j3qlTzcmTz4+rfHplPcIY5cA4aS+PKtNPooLFQKIDDaprGA9ME5Hn3E2B79RDlDPsCjn3j0E49+4tFP/Gk/8YPFhH8I7ejwphxSfWBKgwBZYBfdk4ffK3+HUirXHCJx33b+/FCyaCxkkS6lDhAyDiq3yOc3mxXrzR0vv/6aP/7h96xXazabDddXl6zXa1Z3dwxdR8gVarwfxuvp+14WmHnxpo3OauhyDpU1VtBaflRCGVloex+m6zxgQAAYsv0vkyllDRp5AMSU6AZPiJIaVTmDUaCtGdOeQNKMimNSinw/PVpHATGUlN6OwY+AkDEGrS3GWKqqoWpEiNdZg9UCFGil6VoxrCkEGcRGdFeaqrqn96KNzceVfmqlsVoAqBDimLZkjWE2a+i7Pl90/n6eqepAnEkDKlffKSWZx88CSalR3Fb0dxxJxbHClsnCuWV8FKDHaCkFLqlawnwxGXSJOV2pbmpIcl7vPUXUNmR9o5AFlytr8X7AB8+sno/iv6obsM5mAKiMBT/OE6UUtXMZSZagQOdqWypXJUuARaOtHqs0OWNH4bt0OEe0ziW35c+QAxvBnKagxmidf5P0tVTuiTEUkergh0MbCkrmcBiGUU9oEsiW7yojQtQk0XyJMRBCRqlHALVUjkpZa6iichW7nQgB952kArZdj9J7zNUtd3d3eZxpwjBklpeAQkWXab26YxgGUHBzsyAkEQofup79bkffdXRtKyl6uWpUC+x2e27vViikkoExGldZUmKySX/mzRR7pUrIKd5SNO2SzN88hyOMwbnKf0/01uJYD5qacnpHuq2ajKHYlrJzIYCjgMtqjP+/rX2X/1IoTD5AoeGXnSKD2Av/4BtTsJ+ISuc7EbFK4Yylb1va/RqTBmoTaVdXDO2G2llcVfHk/Am/f/kaYyusbVitd2zalhAV7fqW9WZN6DvOT49pmorV3S3dvseYmuPjI5Iy7LuOm5sbYvBEpXDOoo3NzyhROcO8bnDZLxmt0SiquiKFyL7t8AhRPwVP8AKGhhDoul7E2m2HcxUvnj4VwLTd0ziNSoG79Zrtbsfz8+ecP1uy33foyjI7mrHvO7p9y2q9Zb1t8VE0rARAFlr/0ZHj+KihD4FuiGgtmlRXN9cMwXNycsq7t+9IQB8icWgBxVffvOav/vKXvH71mlev3nB2esyLFy/49T/9jpPzjVTtMJEhdCyWDeZa0w0DyjhWuw5jHLUxzOZzXr18Kam7WcerD5G2H7hbbfns84a6bjBGUoFPTp/w+eef88Xvfs+GFuI1i8WcppkxXyyYW8Mvf/oTbi+uuLu+Rp2d4o6WPD19RrsNdLsB3wSC9hgF++2K48UCZRTzegLKrVHEMIWe5f/pcPilwzEtQfO995nit+9Pux4Ns/jpeHD2g5ju/i5pabLTOgXvJUg/MPjvzaH8XqnZnDeFJnGTxKSocHhNf+o6HpxpvO4JhB/7/F3tYB2S5OQUZi/pfYHZh8zwP+f26CfKiR79xKOfePQTU3v0E3/KT/wX06h5mPJUmBXAWDGIDECklMbytw8/OzFr5MaEkN4Tez0cTCPj415fIjHmpW5iZJEYo/F+oOtarq+v+P3vfsu7d2/5+usvuXp7Qdd29H3PdrtmGAZ8PzD0A4lISdmKsVAyVWaj5EE9DsyYQRtDSgpFEX2KpFQ+N/W1gEmFlZJ0HJFMYdzIdRiUKK0XWlYerEM/kPRENVPajBPGGTsC/zEFTNaEMcaMTBqVtUekIpGlruqxNLQGqspxvFyMqUukRNc2OYVGkYKwHWIQlFtrPbFcSuoNouWSMtXOWYvRiWQjMTNymspi9aQBUgCwBCOYATJ+RFtGnn1hDRWN6gJEGDRGaVxhsOSFug8hg17pHlBTmDMma83oLMJcW4sPHq0V86aGJIysrk/YsQKRpmt7ur6j7TvRmbEWV1mMcWgdiRnsquoKYwzee5TSGayKFNquylWIgKwNVONDoB8GhhCw2qAqucfRBwGrvEc5h002py5Nhjhm7aKY0pgtLfc35nkIMfgRNQ8hUxy1wVkNyQggd+AETLZGKSVEVkr0mWKKY1yiTAEIB/pOSpcXYxqipOgZY8ZS8SlIlSitFMF7Xr9+g/cDJMb0s65tuYu3aAPOOWZNgw8BGw3gcJVjGDr2fc/15YUc31nevnktqVV5zIco2lLGGmxVwDmPUYnaGpzWVLWUmEwp0Q9SUn7wA48NVApinLQa/Sbjjqa+twuCKnzC4pcPgf9UvnZw8OnvqURr8ROgiTnPP5c7LVH3vWDkX9YkZS9h8ryzpmFod8Shg5BQBkkzTWPYP15p1GUpIky0FD3tbs1cBSoL25t3VBYWTUXftWx3O756c8Ht3QbjGvZD4Ha7lWp99Yzdes18XvGzn35K6Dtev3rFzNUsj5d8/OmPuLi+48tv3rJtW0zyzCuNqRv2vcc6gzEKrSX/X6vI0O3odmGcAyJGrkEpglJYbfB9T0l77LwHo6iriqEd0Kalrzq0UTijUDqxWa2JrsJVmq9fv+JkseTk5IQn5yfcrlcYZZjrmrkznCxm3K62bPZd3oiQFdntzTXzoyVuHQgBjFb0fsCqxDevXvHpZ5/x5u270Z+0bY+1FavtjourG47Pjrm4uuXtuytOT86om5qLiwvOzk+xlaIbdiwWNVVl8GGgD5F9H3E2cDRrWCwW3L1+M47ZkKCLgZASN3d3uKrmpz/7C16+/Iqqqri6uuRHP/4JL796Rdt3KDXw8ps3HC2WnJ2cUBuDruB//Ju/4d/+23/L5u6O2lWcnz+jPfW8evWOzWqHc4qj5Yxuv6PvdjTzOSp1GBVQPuFUAufwOuK92G3NtOi8F8+WDSkoy+Hx/cOg+/vMD6UOvqMVKsXRDpaF75QC/PB4OVhWZcYfBNVF3+Ded9KD3zMLl/Dg9Qg5Dff7LyQOr0kAgZQtkcSWhRz/sB/5lXtBGuN1jN9I031KuZTzv6Rv/y23Rz/x6Cce/cSjn3j0Ez/cT/xXFROeHvwErkjF4TiCN2WRrA8W9eW7h2XDpNrQdGNijKNOyuG5SivGvtxHpUT0dLtdc3d3y5d//CNffflHLi9FTGp1fYcfBtFj6VtJjwqRFGVhX0CGcvAR+1MHAEFeDMrLiqIkL9ctiPtDEE2pAlQd3oecfxuQgac0aFkwS7pRGkHGlBIha31IScE0Hs8amx1U3lE42HFIMTswGEt+C6OmgGJp+t54NSqDB27sq6SlGIKXvpVUosLYkGclbIvpERVam1QTUnmnw9kHwzNfn86gGKRc/crk/MFENBmoKxoylIkhpbettTiTSwoaqSAVU9ndYRL31QZjJ/0Ya6Rsd20MPoiWUZXZWDEoUghSlUgblDKQx0oInspVmUglWixKS1pVVGRRZpMF9RRR61xNqOSXyk0qOj/GWLp+EIV+kxm35PQxI9dqjKFAXKUUfMyIc1RS7YpSmWkcs1rA0lwuu4CMhwZEzlVMepoYTg93udI0sJUiV1XKmekxZMCljEH9wClM4JqzFSqPqd1uBxQmHrk6k4gRG6PGXOngI9HoTMcdGPqevpV0Jhmn0O52edcrz4FcBasAkkrL+HKVE/2jGLPY+NRHESF/DMAByWXX5GAzO9XspEYNAnXg1sp7mgwMT2+8b7eLwS7JcfedtFIqlznMGdkHjlA2Lw4D/GlH9tt2L8bzJ9n3jElAYt/3NIs5R6enDO2e7X5LSH4E1QUwLyuFNB7AoFHRkwZ5rZ5Zzo8W+D4Qhpb1+o7tvuNmveWbt1d0UdFHz7btiUrRLJYCysbAJ598zOr2hna34fz0iKfnz3n27AVfvXzLy5cv6YfAfDHjqLak4Nm1HdYo/NATfMJoUMGIxoCCqq6E0g5YIwxHZTS9Dxil8UNN17YMMaCtIWph+OkIQwh0vVQ77FRCLxpOTk+52XW8u7xh2HuuqjuePdlxdnrMfDln1jh26w3OaE6Pl8xqx9XdhtVmj3EGYyJd32F6y3LREKP4XWfE/r19+4af/+JnzOcN+32Xq/HJoi+mxMXVJc+envPu3SWXlzd89Pw589mcXduxXt9hNPT9nrPzE2bfOPa7jvVmQ1TC9LNa0bd7hrbFqgxeKxhixNQ1m/2eu82GFx895x//4z/yi5//nH7VMgwDR6dnfPXlH4nJ0XV7jo/e8vTJGYtZTb9vefbkCb/8xc/53e9/T7vbMywGnj15xuW7W7a7DdbBYlbTdR273RpjBUZ3rsYS8AqS1vigJHZQkgQeUzgoQawyg5F7OmwfGutlnB/GVPfG//i7jNuYAkQ9rpzVOL/LfJvm77hzmuerxAV5zt2Lz76jZKvi3gZF4mADTul7c/u+zfjw9X7wBFktZbpPTMG4vn8/PsguP/hdK2E3pxjfu4ePJbqlPfqJRz/x6Cce/cSjn/jhfuJfpeqTPBBZyMeYRpDmEKiJMd5j1ZSfvu/loWsNOcWkGNRSOrhokUxteighRFnYJYUfOl69/oaXX3/Ff/jbf8/d3Q273U60LNY7YYbEQCSfIxYt+EMalBqRyXGHoCyMY5RFfF70xpzPOV6reIuDhytVebQ6KBFtICVZ4BMKeySnF3mPiBnJd1KCEMCHOFaI0iSsUTirqWvHxAKSwRdDkMW8l7ShwoDRxmCtE1HeJHojWlm898QQaVsx2pV1VJWwcqyxqANmS9d2+flNTirmZ+5DyCrjacx/1Zl1ISLMcUxfEaaLMIPSwXgBDiaKAAlxmuOjcYkZ3DHa4IyV3M8k73dDLylKSfrmMoOmrusMYihc5airCmcMViGVjADrZPpE5SHmFDIrqWLR94BF65rlfCEAR4psNp2APlaTnKKunYBoityPhDGz3D8BtKyzVFXFbL6g6zpS3NGqlrpuxGkq2O12cp+MMEAKOwgYq5wJe0TOoeNUXUorQzR5LnlhCJVAR2d2li4SQTGQYsig1mRwi+FXypRZMX6/gF8qyXjz3o+VHow291DlGCMhCQC3mM1QxhJSymW365wCmAjBI5luPVXl5KFHSd0r8zAFKQXZ952AXEFYVV1sc1l7jamqkVXmKievK2HbxdpJfwePcwLcWWuZ+Rrvw5iy+OfekrZij9O036DSocpADgqQYF2RCiLN5MYmYI97rxw6tGIrJ4emCliIzuxMxvM+DD6KLbnX9+9w1ilJfxPgQ2C1WjFUlsWs4smTc9bdnvVqm0vQW2RHJ4pNBlKIGA2N1dg4ELue+dkZRkc27Y71Zs3t7ZrWB/Z9wFQNNiRurm7RVUOIAy9fvebs/AnHp2d8/c1rbIr8+LPPsVpRz+b80z/9jjcXN9R1xdH5kmq+IPR7bq+vMXUFSeGymL3TCmek+pw1VirI5UjJWCui90bT1CW0UtjzM4yr6MLA9fqO/XbHrm3ZdwMRcK7CWcPdpqV1nsXRMUcnZ7x785bNass3b65YrbccHy9IKfHk9JT5rGK1uuPkeMHJ2SnfvLng6vYO4xzWSkW5qrIs5xB6Pz6M0O8h9pyfHvH1Zk1KCp0XOz5G7jZbzs/P0Frx7vKGqmqYNTO6YYAUMcayvr3j6bMXzKuK0PYMfStpyx5C9IRWbJ/ValpQKhh8ZN/2vHr9lp/+9KdZ66pDa03fd5ycHjO/WrDfbbEa/vD1N3z2+acorfAhcnNzw+eff0bXt7x5d8HJ2RnLuuFHP/mEX//un4kk9n1HU1nWmy2zxRJbgkLfk4ImJkOKwggm+05njFSQzAsRiZ0ke76A6D8ETr4fPE5BtASnIccNB3NpEhw5+G6Z1yXIVSMwP1mCnJ6Sjz2dNk3f1QeBa3k5My+E8RkO+vz9rrIE2mWEl/htOkk+9nfpj6l7exEcXvWHzvdw0/HPtT36iUc/8egnHv3Eo5/48Pm+y0/865XnVuq9BVrf93mRZO4hd6k8vBgZ+p4UwghkeB9kkZWFl0hkEVL9AWMb8b4jhJa+a/nqD3/kf/t3/ytvXr3m9vqW3W5D3/d0bZtLbccDdkE6GDwHQyz/kuQE8nuZEBlE8F1PUH7ULkkx5oEb8+J6QgyVKgCAgqToczqLlPou+azCzTFGo1V5hDLhHHlxDBiVMFod3KsMPOVrU/n+1lWFq6qc7pQr/miNs5Luo/JiWwAVPbpVl8vozWa1gA+ZgeMHL6k8cXpORd1aUo6KyI4AOEPwApQQ0RSgTYyxyqPdZUaL0VJ/3g9yX5TRme0ik7BMjFAAqVRopSpr4hicMflziVmUUoU+p+KVktp13WSgRu5nU9cC1GihwIlGkZQfjy5gtGU2a0CLQn5fOawxLJpGQILMLDqeHTGU1DAn6TnGCpV0v98zDD3DMMg80Ia6agQ8MCIgvN/vscZwvFyKXk4BP6wjFh2kAoAoYZp4K+CaD0HKLYaICj4LBiuUkuP4IAJxahjugYkqp30dotxNLWlfKSaGnBRb5kPMmlMlJcpqw2I2k5LcXsaGsyaDlALIxZT1mbxHaYNWootEgjB4qWxGwg+Kdr/HGOmTpM0pYZWlQPQTACxpW6JFVVe1AMSkXJEtV/eyjrquRFg7a0YV21TZiqgjCmFsqTwnrRXQpnpPXfDPswVlZfeCzLZLco91yimYB2VPRzuqisM6DJDfP/b0Wna7D/yiGh19RCE7OSrl3VPeD7jfP/63v18qfJSFQwJ23R4/tDRNjakrzk+fsN+37HZ7yexUEoQX7XMVPA7LzDl+9tmP0Kljs7pmvduz6wNeGZJxuJlC+x1WJY6PTtjsWq4ubmiOj/Ao9tuWo+Nz+s2Gb15f8vTJKVc379hs93z62ScoV3F5e8v11QX7/Y561hCikvz+vpdgTkPQ4pdcVWG1Fh0pP6CUzqmxCaMC1lhICm0s2lqCUlLERMkuaR8iSSm6XQ8kGmdp6kRUe87PG/7yl7/k6vKab16+4na1B2U4Wi755s0li/mcs9OFVMGoKj7++DnaWa5ublCmwukKpZIAzlqhYkJpcCqyW91yejTnGwLaWBGl16J35YNnu29xdSPaUrd3LJdzovfYeoYm4XcdNiYqJQsjnRLEwH7oaWY1m/VO4ouEeFmRk6PrB9pu4Ob2lovLC2JUXFxc8Pyjp9xeX3N0NKeeVbKDHiN+u+eLl69QWnO0mNNudyin+dHPfsyQPG23oZnVnJzNaeYVVze32Q80pM2WsyeRualBGRYzh/GwaiUeKTuYItKvRZDeGEJMdINUiZxC1+/eNSxpwN86PyiL5hLzx3Gul4izBMDvLXhzAC5Z66XCZEljn2jxsrd1f6Es/c5bCaOdVQc/kULaP2zff5f0cPF/7wh/8tvjWuAefpDGeCpx/yiPjBppj37i0U88+olHP/HoJ364n/jBQM2fMmjf8ygjElseXAFiYpoWWMCkaxNE2DR4L7mSGUzo+17Q2hGoSYcQH0ppUhJGQQie3W7L0AmV8A+//y2vvv6G66urnB7R4r0neDGiEyOjgDVw6AEOb3IZoGUAjOytJMilViKIlbIS8GF6kwzcONLAQhT9mhgV/SCitCSwTqPyIlglAVuKOJHKQIa1BmvECarox2dWWEqF3VPYM0WDpYAspgArWgswkXVmjDWih5L/01pSk5q6Yt7Uo5irVqKHbUCUx3PJc6P0qA1UqG0ZU6AfBkK+FpESEpFiYySfV6OobM6fVQLUBG3kviglRkir/KxlAvgMYKSUxvlbGEDO2JwOFIX1lIG4UqHLaENd13K/VKKZNcyqCmcEFPAZaPHGjwasrmqqusLHSNf3WGNw1omYdAaSpEKWoWsFsHDNjKoWFk7KqLHRKv8Io6lpZgLkAT4mZnWDNZbow8hKS5naKc83M2YKMBaD6PeYgA4a5RVax1xecQIsYpQ0NUl/ikQlOcgpxhG4E/BIY3UWTQ4hM5HiGFCNBrCMcSsgqnOOzW4/MeAywycGOT7ldcjXLulpPnhCEIATArEgz8mijCEoRd+1+NxHSXnLFZmUgCpW2dFelGsu+kPlPhz2mXyOIvIslyTXFWNEm+8y4H9+LQAkNVYz00mN1d/GPYxMSY8IJZdspmO5t2pigJXbKn/e38VQpfIboCiAb6lLNomlk5+zSlMA8aGd0sNWdg0P/bME3tPOk6sqUvTsuxZ6T1XV1HWNdYZhaGXH0YBKER0jy9kR88qxuXrH5cVrjhc12iiSMmAculI4NMN+QBuHVYrd9oaLi0sWizlHp2dELZpLd3cbNjcrXjw7483bK5q64Ze/+hXfvHrN7c0Fby4vSFoRSPTtXgBGzJimJ3GN7BjGGPEpZRC4CN3LPbJaymUSE323R4UKrAWlmM3nEqjue25Xe7psg7adp+0CbdvhfaByNU+ePGO5POH3v/s9N3dbfNR88skLXr9+RcTz5MkTXr95zZDg+fNnDCFxdXND13qWsxodQaWEM4rKOYyD9eqa5fJUROitpJnGpAjRMoSB9XZLpTWDD2w2G05Pj4SOnXKFlwjdbofTiqZyhKFj1tTcrvdZ7RRms5rdriekwjsFrS1Ka/rB8/rNG5RWXF/f8OTJGbvdjpPzM05OT1htd2y3Ugnk61dvePHiI5ZLjasrrm9uODs/5rPPP+Hd5QXtsKMPPR9/9oKbzYo+etkw8IFuCKQkOnEgCwYzJJyz+Ci+2WnQKdGXDayUgz2JaHNs8IGd0geBy3fRtmXYT0Kt5PlQoszvjgf16OflUIZJK0GB8mM88H6efiThcwcMatyk0kjVjYNFfZ7bZfe4sDUS49p/vJbvF6D/6VYq3JZd5NHOcf/2wp+6R38+7dFPPPqJRz/x6Cfeb49+Ar77Hv1XYdQcdmC6AYKiiUmeaD9D3s0XBE2NXRy8p+97+r4fU4NMZhiklGiaZjyXQnRvDBap0R6J0dN1e1Z3t9xcXXDx7i3/8A9/z5tXb9jv9lnTIpevjkJLLEyfWEpayxUcXhljUfSDn3GtWuC0lI14zstRZUF+wByKURbJIQb6EIhRhJOHIYz5bNoa8VgRUhIwq0wvYy3GCavDGUUKHt+XktyFClrQI1Gqr5yjqirqrL9RjG+5v86J2LA1AgCNC92kcHkB3jQV8/mcfBGQRAclaC35m/nRS+WoakxzCsHnKkWJvheGi9JS+rlUZIJcqUlbamdytWxh5CSHgGApIThFETnTI6PG+0Bh08QUqZxjPpvjrCPGxBA8eD8aIWutgA8x0tSVoM7A2ekxTVXjMtDUte0IGCYS2kjpcpRi37b4fsAZS103LBZLtJ40gay27N0e33vmR0dUTYN2RsodxkSrDd7me+UEqLHW4kNgv9+jjo7w3jMMnv1uOwIts9mUPjh4n8tiR2IQND0ki4kRNegxTYmcn6qNgImD1yOIFkLApCQpcUodsKzEiPrBM+TdiZQmQBWmNCiQkoF1XeOcE6bVINcZEc0nqch1kFGupCKWs05StpLQiQc/ELykBorOkFAlY/Tsd/04vs0BfbBy1Qg0HoI0pRJbKR8/Vpsj6/voImxsKXm1ZVyEILTO78pf/3NrtYpjpThSSV8lVxyTZ6uVuN/s6oVtmIHqYjDL3RyfYJJA9pC2DpMPKeUhy3dSOmBf5v+inoDDsT5qKl+bhBHLJoG8WgL1w/2m7BfywiIhc3ZodwwpMZvNeHZ2ypOzI+a1Y313ie92pDDwxz/8hn6zwtkXnJ0v2Kz3tH2gbz19u2e72xGUBmW4Xm355t1bZk3FL3/1SxbH5/zm91/QrjfsN1t++uMfk3rJTX/+8XNuVyveXN3ShUjUjn7oZIGjJDvWWQnSnHXU1koKaZ4jEphrjs9O8IMI09eVxXcb+q4n+kQ/RCpT0XUeWzek6KmriiWa06NjLi6uWO92DCHhSWyGRHt5C2g+fv4UozS/+sUv+PU//Ybtdserd285Pj/hdn1DtPDJj37EF198yW7XM6sqFlVN2/bc9S1N41AJtInoRsbMzgfc4DHKEHpPM1tyu9uiawvDwBBlURR1Yj907HY7KmPRJKqqoh86fOipGkPbBbq2o5k7QNMPg/hUFagq6H0cNw6MTqgUIQTWN3dU1rJZrdivNyQfSF3PyfyI69mG9WqPB1arPe224zpeS+DcD6xu10QiJ8tTEprtdse8avjo+VNuLi9p2z1VVdENLZEBk6SKRlPXLLUh7AZ82xM84mt9ZMjPVGW2KyTsGCzDQfAyLlBLRBYONjLeb4pwWH6nvHoQT6T0vpbgOGdSkmA5nz+O/ZgC+qKDdvjdcVMMd/9YKkHyObiWBWMJuccgOImdKQKZ8tq4Jjl43R94ncMbkHUUvsu0p7IpIT862700/qcPrkE2kB7bo5949BOPfuLRT+T3Hv3ED/IT/2qpT+VmO+uk6ktUzGdzUkzs2z3XV9csl0uapmE2mxEGL6V0NxuU1jRNRdNUY0k4gMXREfNmRlPX7HZ7WWQS8GFgs9myXt/x5tUrLt++5eLdOy7eXtC1/UGeWdHMCbms94S8qYyyFQQORjAdmPRQpnfKr1ocUR7D1hl0MqLDkUEFSfvy+CApOFFWvuJwMkAju/gIeBAlN7KuhCIWIqjoiUNiUAGvBBQKPhDDBBxVTlgwzmhcZi0csgq0Bms0tatw1tHUlaRXZaCmlOM21rCYSeUnV9lR5yaFgM0sBKUghYgPkRgCQy5xLVoxCqPsyGSZzRpxDJl9A+T+S8qOlLjWo7BvjAjDx4iWzOAHQhTArxyzAGjFUIQUaZoZp6dnhJjofc++69BE6lwCOqaI98JgWiwWtNst0XueHh2zPD2lqiui92zu1iQfqJzFpyC6JbM5t3d3qJQYZjPOzp+wODrm+PiUfbulqoS5tF+taZsZQ++Zz2ZU8xnaWnbdPgMgC0m1ms2xzuFchR96hl4cVIiRruvZ7fYczWfy/KwRMbMhi+cO/WgAgpfqRD5Khau2lfmigLpp5Plqxe1qRdpHDCKSnKyFBN4MAtIYETPuYsQnPwKqSkk+8yE4o7JSuzGW45MT6tmMfvD0Q5+BnUSMkpPrC6Mm2wTnHCgl5eZTIhUm3ZDTsvJnvfcZ7EujgS8stQLMeO3RXo9AU1VJilN1UDY+eE/IgaBNNrOULNZKWlrZDYgxZGaYZb9vSR+gU/65NiOxNCXsVePuS7oX9x4Gy5EC4t73/mVno7w66jVnJ1rmOCD28yCYOBwHgqHfB9PUe/+fXh93W/K/sos7+YXpOznxNPc9IYzAwXva/Zabi7eo6NFq4HhZ8/b1Ky7evuWTj5/RHB1zt93z9uKKzWrDbrdlNpuNAKL3iVev3zJ4eHH2hNl8znw+46MnT1hd3/GTzz+m3+/46Ok5n378hC++es037+4YQmLfdrRdh1KJqhLdK2cMzmix40pB8BhjhTGa/VJMsNu1WGdp5gv6doetao7nSwyGvpddu3YjFPGYBmaNwyoDNTx7+oR603C9uqMdAj4II/TduyvS0PPJxx/RtXuenJ1wcX3D3e2aGD3zWc1mveXkqOPjj17w1ZcvaZrA2fERr/cXDCGhBkVdaaKKhBQxumLf9hzNEsfLI7abPdF7jFJElPzrPYqKqnb4YWCz3zH4AdUlFsslbd/SDQMxKZI2DL1H91JxT0VwRmOSRfTWAz4ljNOE6EmIMOZqs0YbzcXlLa/fvsMazfXVDc38iLOzMy4ub9hsN5i5Y73dslnfUlnDfD7j5uaGqnGA4vPPfoxWhrfXV/zo00/ZrVaEXMnPALHvUI2iquaYpkHPHEPaEgKi/xYSSpXNnmnsymAuozaR1MPdUnVgutL4+fdTxdO4Q1maLD7LLuyfsoAK1CFlPc8jnUTM/gPz/34w/iFAPB9vVFhT0/VNaD9j2cdyhjSdqtioe/3k3gEe9Op+S/c/On5hSo+/t+Z5bLk9+olHP/HoJx79xPvt0U/8qfZfHag5RMPK71ppsbRWiYhrSnRtS7vf47PAk++HLOKa2O02DINUGgphwPuBYejZdy3LxZzFYpFTLICkSCnQty191wmipkzWdlGCkislwktKgQqEfnhvfJZ/0/ggZfFHnG56yTvjACErehaQU5rUQRWeMdUrjSKv5SGWqmRKM+rMQBoHRnFGWiGlj1OEkPB9zIK+SRbBFH0ZjTWTsKvNGh/ynhkX7M4amkqAmjrrpxgtZY1FD0SAmllVSVqJ1bLrkRLgxtQpheT/FhZC3w8jcljKleuSqmVlcS4Ai7BsYohEb7NobMisHoexUllJgBpDXTc5PUYYGoMXIEsrAXW0UiitCClRNw0nJ8f0g6fthMZZV5aqqqmqGq3UmGozmzXM6gpi4vTsnNnRQhg3fY/FkFLEWTvmghpjsZsNlXMsF3NOzs9ZLI+YL5bM+iprqihUjDhXEXzMNE0HGkJyaC1CatZZqno26gV1+5yShojqUjmpSmXsGGx0Q4/JlagWzLJBgHa/F8HkIABU7WpS7rOrHDFG2r4bx6/oG+lxjOsMjki6Ua4KldOUSqlGZSSkOqQllmpgNo/9vs+izZlFlQ5SC0mTojrFmSgZIyFIepRMKj0S2ELILJgUJcd7ZP3kCl3W4KyMY2ediOJpc49ZU3bpRvObIiEolAoELyLCKSW6vqcfhhE0HIWsv8tK/xm20Z4f5DNL6qH6oKMeg+33gmwO7Nz7N3l8LQfKD98b00nLlkY+nvoeTvGQ9i7jOnctyfjIq4uDsT4J9vmuJxHRyVM5uL7eobTl85/8BWcnxwxJcXV1w2bX0Q49ffSczGb4pPFD4ps3b2jbwMnZOX/zb/4NXT9wfXXNF3/4A0ezGsLAfrNiO6/YdJHr9Z7NvmW964kpZgHIJMLfuY/BB9rQUlcVGvElASPpo32fwdY2+5c72bmKPbO6YTGbc372hB9/9IL1dsu7q2suLi9ZrVaQd40XywXLkxOeupqrm1uCSkTvIQzc3a0hJU5Pj4HIR8/PeXNxxeZui1PQ1I7ri0t+/KOfcH5ywtt3FxyfH7NY1Kw3LX7oqWyF1Q6NobYzTNIkn1jOlmgcu7ZjUWm2bceyqoWh5z2zumFQ4GPAVBURCEkxRNj3npAUKAs2SUlZZGGotQFnSSESlFD7K+do2z2RRFKSMquMpu0HbtYrFk3D5fUVP/7Zzzk+PaGqHbtdYgiBXd9hUmDf7jCVoZk3aA2r1YqLy7c8ffqM1ve0Xc/52Rk3V9c4Y9AhoX3Ehuzn0SKubhuUWrOKCt8N4mVV0Wb7wABX6oB+fRDLjMHon5oQ8AFS/DSpppCTe1EuIGWUyzyZAlRFIqnIlFb6oeCfcXdzOt5B7Iik0EQ1zety9ikOf9jzb7/aMSW7nPw7Q/DvaEkWB/d3fR81ag7bo5949BOPfuLRT0ynfvQTf8pP/BcDar4t3+pDg0Rrk/NWlWhyaMNuK0hyGyMpSpWYGAWEWK9Xgiz3Pcpqeu9pc4Wh5XLB0dExzUyUzEmymGx3W/p9i1aGytVUdYOxDnSXF3giiIUeSAOjgQVGxk0BaopGixoHd5pYAQXYyYtVa/WYQjF4T0gpiwqX6kVFkybvMhRRLECrhDJZ30UJNUzKCecy0gpMBplCTnfpA2hriRG8jzhnMdbQ1A6N5FKaESxRGCPgjKSCGCpnaJwwD5zL+jXWZOCmGgESZ3Q+d2b8aINWhqJkrxH2jlRpSrRtRz94pJyyYTZrqKqK+bzBOksiyWI4awT5IbNpgoA1WhlcVVNVDa6uc/81LgMPIUxgXIxRnnNTy3U5JxWd6prF8oiuazFG0q+Oj5a4qs7HrogZ9HFVplNqzfHxMTbvPgzGsJgtMzAggFQMgX7oRbS2rnF1xfNnT6lnM6q6JsUFUErXReK8sH5kVAlgEWhmDcZaqqYWQAqp/CSVu0RKehgGrLHYhaQUhRgYhoGw9jhToZWiyvcnpcTd3S1VV+WUnZR3rXI6mEq0Xce23eV5qESoLHAQxJS0IU3XtYQsbo1SWJWNv5mYYXLvJb2oqmsxsiEyhGGs+hUy8DIZ5AeBzzh3LMF3k8jW2KcJqBkFucfULJfHrgA0VVXhMmNKGz1q9xwCQ0ofGuBE8Ipe9XL0GEcR5JCFkKuqRsrBPyI1cP/ZHb6WCs+U8v6Bcz749/CbZfNk+ndyZPeOy31ne3j+KUDnu3zuB6/j4A/i4R7RYccUoDQ6TaT3QiUmBZrKMZ/X7HYbmtmCqqowdcNmt6b3MD86YbNdY6uKdvAoW3F9ccHdasPJ6Rln50/Y7qRSxB//8AeGds/nL57y9tU3PDk/4cUnH/Plq3e8ubhhCAFnDCEkbOUk6NECcBITrqqY1TXGGrbrDdttyxChpPWCyiC9IUWpMDf4xL7dcn274eJ6xat3l2ilOT5Z8tlnn7Hb7Xn35i3b9Za72zWbbcuT58/46NlzVle3tLuI0g6tEpv1hvm8ASJWWz598RGvXr1it96jU82iaVjf3PLJR8+5ub5mtbpjuVwSU0XfixZY3ymc0lAJ427oBhSK2lWic2AMvh/QWjOQwHsWyyW7FHLFN0sIkc2uZd8OWDeQtKOaGegH2rbHaiR9AvGtXZQ0DaeEfbrrunHnUdls7xT0PmBj4Orujp9agzKWp8+fslrdEFKkHzw6CTtwtVlzfPoJVWXYbrfc3FxRVRUnR0u2m7fMmwX7ak/0id1mRzo+ZXbsqJqG7TCwurxkwJK82FiUwcd0fwLda2W3hzEIn15//9cPzonDg5cNpvJT5oUqJYcf7mhGUPHeTql8SgLzIhwph77fkbKLOgbuKd2vivHQBpTYWZVfRYFgtC/psHe5F/d2ZSfbkvLx7wXl39ryPb63s6fGZ/KYHju1Rz/x6Cce/cSjn3j0E+VE399P/OtVfbrXhH1ijOSAGmM4Pj5BK9jvd1xdvhOAwVoZjNsVdze3rG7ueP7iGbP5nLqZc3d7w7uXA9EHjk5Psl6FpDf0fSfMDOdYrdfs92sqq6m0YsiVwZQGQmLIVYXKOIul1jxlUQc6Ifl9WqONIKvlM8bYcfHZBwWDiFTFEBmGQO8j/RDH6jOobMiVMGTswUBLiF6GVpoQPNbksmMpkStqU2tNiGnMI3TZqDpjOV7MqJylsobgB0k9UmCsVHES0VstzBLn5Mdaed9ZqQhl7fi6NQbnpESfzgK51lmp1IMWhkN2yCY7glJqvfLirqyzzGYzKXtdiwgWpBFMGvqB/a4VQCxXkwLRfKmqhmomi26UGqe0PKjEfrNl6HqGwdPMBdSZzWf4wWOspWnmdLnc9rxpOD5ZYqsa4yrqWTMK9M6W87IBgoqRMAwoYPnknLJbQlJYZRj6nru7W45OTiHJ9S3mM4yVakH1vBHt8ZioXSXATBbILawSHxdUswZTCWso9H0GqiKzupYx3HWcPXmCymlrXd8J86xtsbUdhX6rqpIKad6Tosec1bkvmhQjfddze3vD7d0d7W7P0HlOjo9lvA2B2/WdABNRhMrkNojDtpki6+I0QocQxkDE5PSiwgDb77cSzERyKlvIz0u+MQpY64mFU9czXFVl8FPOXtf1vR210RlCTs0SZpZxDutcTl0S3SAfA77by7jFYpLkIhfnciBliFaaGCObzUZYSEHS4ebzBpUBqL4fBJjU5j/d9P030A4D8IfOMiXyc7zPYCq7pyJBIN+9z1RSoz3lPed8EGA/eP0ewM7kYEcFpTTlFqfsuQsLTFLc4pjS96HVQdmRUgBlg0GBQvSTFk3Djz55zuCF5j6ESG1rdp1nGAKL+YLjRc3LP/6OZjbDuprVasdqveXZs+c09YwYI6+//pq7u1suL654/uwJmsBf//Vf4b3nN//8z1xvW6raQQtd37NcLnFWMYSB3XYPSQsY7iq6bmB/s6LremErpnxPjBZRdKVQakAbQ9cPYrPzde2HHavdTkDrt5q6bvjoo49FAHK+ZLvdsN3vub665ONPP+bsZMn10NF3XrQljGKzWXN2dkq73XB6/pSPnj3j9uaW0Ac6NbDbbjk+WnJ6uuRmfYf3A3XtZIcpiO5Uu+9xxua0zIq222dfJJTryiCaalrRDx3OaI6WC25uron5Ore7LcZY9m3HbD4Xv2oCg+9oFg21s4TBY5SwTNGaAMznM/ZdS+0cXdcya15gtCZhGUJkvd2x2bXc3q5wdcXZybFoeaXA3XqNVUIM77zmeL3l7PSIj1684Ivff8HN1TWff/4jFk2DTj0vPv6Em6tr2q7j7u6Wj549YT6foUMkbPbsNjt2u57Ba2zVoAP0of/g/EgxU8/L6FfkHe4PfPbbAsWHc29a8eY5FqfAOB0ep+wQPtwlLE41jXP1Q+cuO6Wljx9a4Jc4SM4lv+ukiMQH6TL5PNltq3wdZS4Xe3W4sD9sxR6M/RwDdih6J+UcItKpJ8+i1COjJrdHP/HoJx79xKOfePQTP9xP/J8CqDm8gEJDrOuaEBYorRiGnna3ZfA9fd8R/UDwA/vdltWqyiV/A8PQ07cdfdvhh14GhlJ0XZs1NQJKGzEamy1h6Ec0bRh6fIj0vlSZmR4qZBEilUS6XiVUVJNzUWoCDlWi1G0vK0qVzOhkUlJjtbBpsSk5oALuHCL2UyUiAWomJk1MCcUBClmcjCLrzxgqY6mdFeXzVMosi0aMNvlfJceUPFVDU0lVJGGrGAFnrBkrKxkjVZZcXozrbMh1rjqlsLnyjqS3aCNMJeukjJ9SGlu5sdKUcXpctCulcMbiXECbChIi6uocWlucq3GuxtZy7pLilbJaOxGS91hrWCojwIcx6FyxShtJ30paAKCqrlgs57iqwjhhCxUh68ViTikvFwcvOa1JxLpCrppVEDatFc5ZlsslxlhcXdFU1QjRKi1pYEmBm8+yExSwZjRAWuNmjWjwkOhJpBDRuex4CIGuq+j6Tq45M5PqWlhD3medoCxKDAlrDedPnkrpdSNT3Q8D+/2e3X5LXdcYbVguj0THZhjoVMd8NhPh7qEfGV8hg23WSol2H6GUr9cpjalsaAHrQkgiLi1PlpC1ZDSyw6BGI8UI6pmcBqe0aN4MfUvXd3jfU6qiHVgNCXpy2l3KKXbDMORqUgK4WTuVjY8xErKdiDHn7OZgZES2YxrT9SaKthqrYimlWSxn0/U+tvd2KQ93HmDayTmExcq+iUoxC0GKrlUcd3eEPpzCtFvz0BFrpccMZPhAEJHGk1J2R6ZnzuGbH7wmfW8H5MGhH7wl7EY4Pzvh7OSY69s7EhofIyHCdrNhXimO5o63L7+isoaz0zPq2YL/8Hf/kcXRCUZDv19zdnZG2wXOjhZ88vycxXxBXTckpfh3/+HvaAfPyekpq9sVTsOzF8/wMdJ2LSEE5rOGMETa3Z71sM6l6sWfGaPRqtgVCYSsNSgl74Ug1QZj8HjIATAYo1Ah0W129P4rThZLnpye4awiJk87DFy8fc3nL17gFw13acBnU+RDZL/bs5jNePX6NR9//DE+BNarNcMwsG8Vl9eXLJdLLm5u0DZiVMJZAzpSWYMyGldZuqFlNqvpY492Nc3M0nU91kDlJL//9nYg+J66qbF5p7OqLV0n7NkUwPeDMPaGjhQHjG7QRjF0QdKNrcxtZyXNtSyyfD9gteHk+JimskQf6YaB4CN3t3cYo6nrirlztK1nvVpncD5RV4ab2w3OORazhsX8iPVqy/puxcliyfXVN5w9/Yi+D6zvrulj4PLmChrH/PiE0+MZGE1ICRcsPhr2YbgXHB7u/slP/jsxzrsycFUex9/VDtNApvlV5nBeiD4sq1ziJgXT0pcpVhmD8Gluf9sC4Ft3Ug/+VUwbXR8OoR9+80MB/8FiIHHPN31XWo0wK9Oor6KUIqTwJ6/rz7E9+olHP/HoJx79xKOf+OF+4r84UHPYgYeIuryILLTSVGEJkIo3sxlKK7quo91v6dteFlneQwyEMLDbbGXXO0j+4DD0dF1Lt9+NrIvdbov3g4jrpsR+t6Pt2qx/kyBFMQRdjw8hCwpPg0mVpwwHoqkpL96K1k7e/VcZrImldHZCaycaK1ofDP7pocrAlXOkRFZGy0NJ5zQrxAAUoKWI5wrIMyH9WkFlDXVmw1SZgaNSqTSlRz2aIuxbQJrKWmrnJBUqM20elu4uPyNQo7UYrKwLYtBZLybgQ8xixQK2WJPBGevyPS2UtTjek7qe4WLCViVNStJYjLE4W2FthbJFNFblFDIvoECE0DS4GKWMdV3LhAiBZCUdyjgHyVBVDhTM5jU2l3dPiDAYCmaNgCYohe8HEbVKUuI7BOkbCcIwoLWg9HXTYF1F3TS4DPp4X7SV5HptVQlVNkHKItgohXEVtpH+dl1LGgawgco5MEbYYJWDrWLoB4bej5WJtNZ4Hxk6Sf0KwyDCt9ZwfHaOdfKZECJd16KtZr1q8INHI6UUr6+v2e13xOCZz5psWOKYphQjGYhTJJ1QIRFigAgqs+AKGj1kbRetjVQpQEqLqxwAabRo31AQ8VxlyUi1p4Qaq1wNXTdqUz2wLFlAUIxuTInkh9xnnatJQZLyYChlCSHvcinp24fo0t770RDLuJO5EIN8xlrNYrHIAtzfafr+rNpDuz5R2tX0w5TWWW6epgQHeU9HyoKMdHJ9AKYdnuM+ZZ775/yBfS7tveAlvT/qpg+Td16EOkuSHb1507Dbbbi7u6PtB3xI3K3WpKHHNTWx22Njx1/8+Me42ZK//fd/h7MWoqeuLL/4y1+gUKw2Lf/06//ITz//a1arFdu+58tvXtMNgaPjI/A9J4uaeTPHe8lt73uPsYZu35F8gCT2PWZBvnJdNldvk2u1eVMkZIZfyJpP+RqNIiiFjwmjFM7Ixsn1zQ3J95yfn/H0yRmv371jGDq262uenJ+y7/ekITIMEe8jm80OjWK+bHhz8ZZFs0AZAwr2fU81VByfnFDZWnSvAGNAHKrYXldZqsbRx56Ax9ZzlvM54bbHVQptFcZpEXccBpq6lqqHPjBfLHBGozAMQ0AnqVySomPoFcaITsEQB6xzBCIR2ZTY9y21dbIpEROh7yFE+Unit4zSECN935MGEX6Pvif6QBsGtBZR+Nu7DYpEu5hJ5QltuXjzll/84hfM53PevHvHyekZne/AGYJObPdrhuSp50tmtZbd6FXHdrMXu5reH8djWmeZX1PYIs99iqW/dYwfztMyL6YKeQcT4WASKomqD/46iHMkMh9/lCqz/sNz9176yuHv+bT3rnpc5H/HBX3PpvLC4JBBUfr/kAY/LjoenHR8Bgd9e2yPfuLRTzz6iUc/8egnDq/1+/iJf11GTUHx8qJNjIDPKRZSslkby2JxRBh6SLC+u6Pddyg0T548Ybvbsbq94eriHbP5POuGCDABIrhauQaVNCoOxBSx1mG97Jj7IeB9gARO57SiGEYk/fABFCHU0lJiXNiFUIwcOVUnL0CtwUcBXKw2lKehVHY2+Ti6TBYUPghLJKVEldOJGAegMHBspokKwKNoqjqDLop5XWONyecT4EgMby5rrg1VZYUiaAyLxZy6ErZJVVkqZwW8sRZjLVqbEXAp3zdGmDbOGqo6iw4bLSWVvSJGwyKnnzjnqOtqFMdVxmRGkLBxhixWJmWxs66JUhjjZFGvDImE0Q6jLUWESSnQSlTeS+mz2awhhMjQD8KUyYyawkwhA0nl/ldzKR3t3FTiDaUwVTX+Xs2mMupihGSCxRAZ2hZTVTRHy+l8+TqD9/hhyACaMI5MZfExZPHoDLZpja0q1AGjR0dhyBirQJs8J6zkOze5LLjWiOK5YnW3IVcF5OjomNm8oVk0PHn2jL7rGYZB2ClDw2I+Z1ZVbO5WdPtWShM6Q0o1yij0dkdhqXTdkAFJnYW+ZbwOXuZpzBWk9l0v15uBLjUynnIKYYw55U5xqNKeUhrHWRljnfdSJarr8H6Y0qUO5qNSE8qfEEaaVlmkOAPxkUjve3rfCxAXxWGKZlTxA2ksPS87RlNpbqUgBE/XdRhTZf2rBUPfsek7uq79TzaB/y20b9spJQexEghMr5V/phmpski0VA+A4rpl3I37MjkQL0wmpSRVtoC+HJ6bvOua88nLHkphSB50JQPqU3/ErsCY9ncY5OfPhfw9rbKviYH50YKj42Mu373idr2hH4QWrhM8OT/io9MF2m9Q/TG2avg/fvPP9F3LYt5w/uQJ52cnvH33mu1mix/gr371q1GM+9Xr16zWG45PTkgxcLKcY7Rmv2tH0JiU6Fvxk2KrDX3v0SqBlnurtMI5lVNhxccMbUdIwvKTSmxyI4xWpMxuUyqz3GJEtP8T6/WGlCLPnz/lyfkJN9fXbNZbnpydcrxcsNrsIUUq63BGsdvtWDQneB/ZdS1VU6FSykLzUtVtsWhou54UVRaFB20UdeXoh5bnHz9hv9+z3gRQgaqxVLUlxoq2GwhtwKcgtjQ/7xQCtbXMZwL03602DN7TOMfR0VO6fo82Wuywc8wWcxFx73uG4EnJ0zQ1cRBgvd3t4TQJSI6CEHHasVlvqJymbzuxiymhosQIi6M5292O7XbPrHI0rqLOQDDJs9ttWS7mXN2uub6+4smTM1abO6xTYBKnlSUlT90s8UTs3ufNFqaAU5WNm2njA+6vInV5rXwvwbTTme5/XCELi3KKshs7vU0peTp+ReeFa1Lcq4w3fub9IFvOLEC+HOtBUF9sQ34ppilZtcxHrbh/3IfnUg/+vvdGum/DmALw0seHG45jMB4P7rUaf7t3lx5ZNdIe/cSjn3j0E49+Ah79xA/1E//FgJoP55MdGsEMOmQEPSVJETHajEa8AB7RVcznS7kpMeGso9u3tO0eYqLXmi6PRKMNrrLUrskpM4Zmlhd9w0AIA8qA5MwJ5SvlRWlMkZQiSifRy0njmLsH0BTUmYzil/QXeZMDJyPH90MghSQ/4+uBJCo14lRSGueDD2EUYxLKoLzhvVQ/kmo7Cp/1TRRS7cdZyywDLVpltgtSAUmqOxXRVUXtpKpT7RzzphLgxlpc1rMxB0CNMQbnXE57kQFmDFhNZt0YMWBKQRqkj04qMhlnJ+aHyc9W61x2TWG1JZlIVBFMoqpqlBbHZ12FVqJ943N5b6laZccJ430GXRBgJ2ZmVmHhaK3R1k79Uzo/Y2EX2brCOIs1VgCGIkJk1Pjw9SioK5Msxozw5vSjsmNjnJ2MHkqYVNaiDthHiQQhoLMwdpkD2hiUMaSoSXWNDoEUg4gmO0dCgCGTU3gionejtYEkc2U2rxmGgVlTUTU1VSO6O9panPfYwTG0nYwVpTAk9s4ghwi0XYfb70khiPaQMRjVishaFAX76gu+5QABAABJREFUGFMuEd5JSXlE4NoZI0M/qinbNEGIIaenTSyWpNR90FNNP94H+q6n63oR3/blc5J6pYGR5YYiCEyT05OkShVJyty3+3acq33bjfZH5+pQUpXNjjYoHjCDYoyS0qc1VS0VpJRKInDedrmKVklx/PNuY4W6PLcn6y520WIYHZJKUmZdIQB0TDIeshcVfTWFQead5PJO4JzMl3wohCUIZN34dK9yiEGjkkEIryEHBPnDaJLKLC+yA8/5pxqh2sds3pOGWOxempx+Qp6/TgJCHi0X9DFytd3TJQGHrfKcLSs+eXbMotFcXnTMz8+5uVpxe3NDZS2/+u/+Gm0tv/ntb2nblpTgxz/6CfP5glev3/HVy3cMPnF0fMbZ2RnHixn7zS03qw3bdmC97+i9lLHXeYEiFcuGvAlQ2GdBmGAWAqK/lIIENBiDVzAoGLQE3DoHR5oCKEOKOcTIc9B3PZdvLjh7csbJ8oj1asXN7VqAfJ1QDmAAZbC1od3vmc1q9rs99XyG7CVoQurYbK5oKsVu1+PMDFcv2G02VEbTLGf40LFfb3n+/DmhEwBXJ01tK3CQYotPEHXCG8VgQNeiJ2Ctpp7VgMJYCCmhnaJuGsBQVw0pBYKCxlksDcH3+MFTaamS2HsRp+y6PW27o6kqYohYbVDKklB0vmMYtjijqSuNCgGnDc4EDJF+v2NfWea1wyhYr+9YLhoubi45Pj5nVmneXVxyulyQgma/S2i14ejkBKUtISR8SDhTcTQ3bLf9WPEQJaNZjaO6BJVTZbuyUB1TkxGx+pKrH9JIVM+hzX19AGVE50w+rdFJE0iIVH1ZUOfSyimSsnGQMqlqCvwpdjyCEhsukbsSeng61C5IOQtZkUKOrbKn1UicVCyMxHBp2gTL/1EWBpkZW+5P8SOjDmFe1E8L9cNAXI82qASHJZ4rn5O7d38j4rFJe/QTj37i0U88+olHP/HD/cR/dqDmT51wBGvyRRyiUFppko5i8QCdWTXGWWbzhTBhjEWjaZsdu+0GjaSKuG5PN3Sin2IszWyGccIGsS6Kjkc/EHzHMHT0fTfSJ8WeFFpSRrdNBsHiA4BJMVaJktcglWPcQ9MYkTOfRUkPWTdKlTMW5yIoYUyJENPBfcoGMpXUsJRBLZ21TjKarIV+V1fVKDhc8mdtqT5VQB6tqStHU9c0taNpnLBocnUnO6YrCcBiTBYVdjllqWigZJ0boycHqVIuL+0cdVOPCLTWmU1TnHRmCRltiEqLlo1WVFWFUiL05Co7AjUMUlrcGI01TgAVQCkvwAuZKVGeiXXiSLPQrMr9kD7IMzRGoysnZbzN1Ldy/sLAMKq8n8flCMsmrDN5DCCpdhn0Ewcl39HOjgyTEDzK68yWMYxocn4uSQN1hQpS9UprhW1EFLeIVcUk42BWN5ixrLxi1jd4H6hri60cxhmpVmUMMTiss3SA1wqnNd73kuKUd1JcK4LEwcexclJKChc8MaXMDisMtJj1XIKwUTIIR1TjuIwpl+COk3Em/1tAGrnnU3DlvafvRIsq5OMUQ6ZVsd3ZqEu2GzGXVVAlDzTPoxT68djpYE5pLaBeAfLK8UsqYwFqxPDrzB6TMbtv92w3+wlwfGxyLxgN24Fjyo4y20FGG3v4XT3uTJaAV6EmGu6DXdh7LZXA++B4aRpn42vTx8uBso+J43djHqAaseelD0XOWudzRTUdLasToJSkRFpbcXFxTdsOkLLtVYqToyW1c+zWK0jw8uUrvvjiG86ePuf/9n//f3Bzd8uXX3/Dar3jdrWiqWesdh1fvnzD7e0d2+2OZ8+e8unHnzKfz/FDjx86Qlxzu97Sh8TgRfTaWYUzjALuxtwvgat1oV4PBA9GS2pl6wf6FOT+J5U3AxirRoyy3lrKuhpkT9s6Czqx3W04Ojmi7Tv2Xcf5+QLT7om5Il8KkcoYEam3mmANfd8xn9VUzmIt4CNNVbNoPD4qZlWDt33e5IgcLRZs1muePnnCydERV1dX4uurmhQTdVNzt9mNKbYqaZyr6Pshp1VWUiHPe+qqxmnDYragdjWL2Rzfd3jd4YxFxcS8mYmQJrLwkM0PsXPbrYikK6MJ/YC1sikkWgvCMmxMjR8C1tq8iJRKjG3fs2075osFXT+gjcI6x2azHheV282a4+MTvPcMg6Rvz4+OaeZzFrqi6/fs9gNKxQxXxxwXqoPgI6dbfM+W8mRReXQ/nEfvNQUc7FoeBtfjCo0SSOfgdiwrMoXrqgTniYMJPVHKR6tf1vBlfiqEQnrPuzzs4GHnyD483Xv/MG4raTjq8O/82TL1H8a4h/Prw/Hvn7yTfxbt0U88+olHP/HoJx79xA/3E//lNWoKqvSBzqQkC7MCKkiKiMCx5UKMMei6RjczUkocn59xcv5E2DH9wGa9YrtZc3d3y7u3r9ltt2zvdmzXe1wlKS3aaCmxnRKkQPQDcejF8GcQAcq/spg+fNiFZqVUZg48AGbkweiJmZNpljqnJw0hEIMIqc4aK2wOZcgyGpTBFmMUBFcOR6Fvxgz0kFkyOiuNl2FXO0NTWZrKUjmDOXBULmtsVAWoyalLR/MZs1lNU1fMakl1MsZQuWpMBdFG46oKax1VJQBOObJGFsYoCNGjkjy/xXw2sW9KqpOWajkKTZlnOoMtlbOk6FFaUc9mNPUMUKMDkfW7wtZmvB8uM0mUUgw24IdetGUAYkQrjZ3Nxusgiwer8f6V0l2gch8ZAYMMOEVhfogdUaXsALq43TwGYgyjAC0pV/KyVo6rCvijRptotEW5bGQ0pBgEoQ9xZJPZLPpcKonZ2spuUkq4JqdopQM2WIKTJyejNtCYGqYVyhq0dhBh6DQqegaV6KLn+OSYuqmFNWUt8/mC0+PA2dkZu13LZrujstcMfpB0Ma3ovacbPIP3+CAstBArUB68x8csQJciMYgDT3rSkSlVtUhKgNfKoa3cZx8C6+1ONG5CpNKWpHVm4EyaMDGbETkmxJBkpy2Kbo4xwiCLlMemhTWUEqOaF8KeC8Ef7MBZkigd53EHMUS879huNjk9yjGfN2Oa1mMrQdoUhBf3ei9+Hn2hGuN0SLlCnC4+V6DrbG9TCaZVmZcP6KFF8uvA8as4nW4KuPM/9zqj8h7R/c/EvGgA2QGFNAXfTJ8BhcGiYkQpg9KGzbZjt9tCNFiliGFgPp9JZbh2oOsG3r294ne//QPRNARd8e///j/y9uKCq5tb5osFfVDoqLi4XQOKbU5L1CngDGxXN/iQePX2gjfvrmmHQEhiq6rKYYzKgt0T+FmA5QKORi87oc45YlL0ITKkhM8xk1NJUkrHBUbKz7jYS1lYWBirIPa+Y9dqlkcL2n1LCH4C3Q/Kuza1pKna+Qw/9FgFrq6xWuYaiBbWMAxolZjVNX3b4nuPO55RLRfst1uOlkfcXF4RQ2DW1KQo90HYpRUWQwoJjZadTC0lW2OIGGVo6lq01sZ04RmpqhnanqZyKCebF9u9iDJ2Q8jV9JKk8WoRg+z7AaVhsZhlkX8Bga2zLBbHrPq7cfNAaWHr+SiVJZPSVM2CEIesz7BFG8Ns1tB1Ld4v2O/3KGMYvGe/32bR+7mwY1VEa0gGVCpL24eQuDr4+/02po9me1om4veDFtS0yIb3F9c5/D9kQB5Sv2XCq7F7IhiveW+hneOjabLnXHkmRva9a3pwF0r8Nh5tjOmmv+VzB5sHB3/f0xF4bP/i9ugnHv3Eo5949BOPfuKHt+8Eah527F/a0sEtkSMWg6rvWckJaZoeigIoTAhAJcV8uRwfSLNcctR1nLZ7nnz0EZvVivXdHZvVihi8UJyApGRhJkhvZkdkcKFUsyEXD0oZKUYrFJphCKJmLkmXYz+LQ5hyP6XHMQZRmk+JIZaSxGK8QhSDjhZB1ZiSpDrlz+hxfOZ7RMoAQMQ4g8mpHTEkXBYoXs5qFnWVy2drTAYItJKcTZvFgl0WEjZGM2sqZrk60byppAKU1iOjRio5iWiwtYYqgx5jWpouaVQZMMpjparrbKyzEFm+15JalB2fEierlYBHwWbwyhhMQZUzm0Qrg1ZmGgsIs6acz1qDVhVRuJl5QS8AkLYl1UrYWSJ8bEYQDD09U9HO0eN5JkpbGl21Zqr8U6IIBVlOLJPktAAkgrZldla+Z6BIOh835WBDA0mP6VUoAfgck6ZKGfsS31hKjiiHhiVKjm6MmpSyxpKghXIVKk2ltY0wqvzg6YeBumk47o4ZhoG+69hs1tSzjno+wzhH13UMfY/3A23XY01PyELPXdcT01pAIi3ltUt6VLEbhSVWQJqYEDAvl4NPKuFDKQcec+l3Ebcu9iOEABlRT6jxeWrUQd6pADJSOlsoqCkJ3dIZMwoOhjBkUthUdUsEiyMpmvEZd11m5Ogsom1yhbM8SeMI+vx5twJcFseWyAAdIINWBuvkxNL0rxrNwuSkU/EVQlH/tpYSRFN8Shqp9TpNAXjJP5+CcEbvXLQFVOmrgkNbVpL4ilhkmUfyu8ZkarxS0pdd2+G9CG87o6nqiqPlAu8HzKyh7z1ffvmSH/3oZ6z6yPMXn/HFH//Ib//wJRHFSVQMXhFbTzUE7q6vhHmnDb/42U8AqN2Mf/w/fsO7i1uGENHGkpDxSQrE4Ecwsvi2KZCQIEdjsFVFSJquHWRnT4Mz4s9cASqJ6CSVPIwWJpqyApxqElZB9IPY0wR91zKfzzEG+qFjNpuNOhFaG7wfcNkuNrMKbzVD3xG6gKlEiN4qTW0tw9BjiBwtGm7aPSqCUYqz81PafQ8p4Ywj+Ugy0FSOzkuar9OyACqaA1Er2n3L+dkZ0QROj48x1qBTJPmBWWWJw0DTNOiUqI3GWY1VAaJDGUvbe5QxtPuWmbPMGkfXGWIYqJxhOa/wsUdFjdFSTU92zyVtWCvGXesEDENgu2tl5z2IKH6KgcWsYTar2e46ttsN3gf8xnO8WXJ6dkoKAyl2dPst3b5DKZuZqJaYIPggFfZUCTwPptuH5hAHQXiZrkzfPQw8DwPU/FGmmXb/qIVlWmI9Dr5R5gxJk1TkQBFBFuNjoJ0FKdPh99UY2Atl/n4fEoeL9Pf7/uH+Puz+Yfj+8PsH9/Xgvftp/e+//9ge/cSjn3j0E49+4v5RH/3Eh7/7sH0vRs2HHsL3aRNA8+0jYcrbGl+Y/kkPPwdKSZnlAvRoZ6n9nLk/Ynl0xPZ4zdHxHbeXl/RdxzCIkGoInhA8/RDzwytWtYA1JqPegiKLKLEYWGNyRl8u8xflRmQUMFO2DnmVo4FPY9WcwnAYc2nLoEulek7KAGCmiJXFfZKlKSplRovcmJRk8Vk7y7yuJF/SGlnkFk0aa2iqSgyB0Zk1I5TCuhKRqir/SEqUGo2G1hqTxYKLUHABakoFKJ1ZBQW0UkrldBn52xgDqqQ+6TFVJCJ17MdjZVZLOaYq/ylROzfalsEHGeApg0Sy18R4pxDHHMJR1Dc7d3OQ+iR0oIN7XECXg3GulRrzmCewZfzo+P2oteQ9ijLWuLAXG5Km75Q5Xc6hip9UGU9RI0NJSYdJAr2jSmCQyPo9+YUDMKkYTp30eA/kY2rKqdZSRtwaTXQO7zzOO1zl8MOMoR9E90mBrSqpmqUNXdvRdx1d22Jti7WWOIIlhrZr6YdBBKKTwhOmcvNlPpR5Up5r1j4aU7mCsFtEdFjGsYCjogckwVABBY3oDpUxU4xwUliXWVTKZEaU5LSO+jgpgQ+jDYhJQKCUBGCNOuT5me1LEdGuqgwOT5pWjy23lMfmwTgtaaXiL7KWlhJwuuxcTIJyHHgKMfqSaqxycFs0jvR7vxfNouIrpp2YKcAu7TAQSHkCCmB88Lk8YGNKY2B5bxznzyiSiADmeRYUWXQRlLagEh89f4pRgZm1oBW/+8MXnD19xpPnH/OP//bfsdp7rq9vmC+OcVXNdrujrhrOnpyTjAiIN03Fz//ix5yeHnF7e8vLl6+4ur4hpiKKLT5CK/CDR5XxbtQojj2Wm9cJrQzWOMlh9yLOqHNQLHMpYkcvFHOVv8knScZ6InkvIu1GdKGquqKe11TOCaU+JRSeWWMZBqlU4k1CMUCERVND07DbQN/vUTFSVY7KWoz+/7P3Z02yI0mWJvixLABU1czu9SWismpq6Z7ph6aep57//x96iIZoqJqmuzqrco3w5S62qAIQEZ4HFhFA7S7unpmRVVmhiDA3u6pYBIAIM8uRw4ch54UxCvd3R/LlTHQBL4rmxDQMkM2HaE4Mo1XuG1R4Or/w4UPCa+F4OlrlveWFaRrMFmgielvFnsbI6OGb+yNFC95B9MoYYQhwiCOnKaLiuSwr53k27bUAgcIUHAyOIIHoEtE7lAHcwDrPaF6IHg5jIIwRSmJeZqQUNKfODs0Ky2xilPLyBCL4IJXJCPfTCR9Goh+sjOw48HAHHz4mXl4uUFOGqfasTyib84KrhaX9WCjNl+3377Tz660d0yZV1Rx+ag6qvS+66YZY6unO57axpq/FGHfDEOn2wL5vBRRs7DadgYJufhWq9tunAXS/53L9DPZ/t4U3Qa/aeq0loJ8c96VnXG5+YttufuLmJ25+4uYnmjm4+Yn+3S/5iT+xmLD9vL6RPsmUDczZgJGWTmDpJA0IuXpA/c23FCOjyw3jSBwG3n73Hf/+//E/kdaVdVn4+ccfOL888/L8xF//9f/FeVl5Pl9Yc+4ounNWerdhAN4HSjZx0+N4BAyZuyzLVa9rKUtNhX57Cdv3rrJPPFZWu6BI3gAjLWol6ADVQtYqRuYaOGXATuVVoGp6NPfHicMwcDcNjEPoTKHgDGAZh8hQgRoruS0m/hs9p8PEUFOUgvM1r1JsvzqJHsZYVeENfAj7yXFjNFSPasBOqM+uAj3SdGlcTT8x5kyuOV9O7J5i1QqJPu7YQPW3D5a6YzduYFrvWbZJZTtJ2EAeSw9jQ1Zq6pJ410EWqvOkgmit31VL0cWPnXdtsaeu4hjggIilmYVazUv1lQFpdkH7qSG0ngLkrkfkw5ZWttnNyj6C6jwqUNVBL2OJFaWz/ETp7ab1L6yPqRfER0sRyhnxYkLKQySlRE6ZcRqJw8T5cmG6XDie7iz1LmVenp55eXnh5Xzm/vmZ94+PPD49My+z6buI5R2v60pKiZRS15hBbWSLN92cYZooRVnWlcv5bNXeKrPMewuQ5vVCT0XDRP+cCM5LZ7d4H4mxiTULx9Ox9jNHWi2lrJTCeknMF2ubEO0dqlUHWzf5YwMkxVUB7IgHfF3lsXKOaatQFW6pT9CGUB13VKfefKK0HGKQilaK7AbJKwfe6KTt6y2Yvg68RaSR1q4CgU7NbdtnAgRogXWp3kb7f7tdqUG1qOAUXC0Xa9/VgFQN1NPKnlS1fWxF7w13b+/5+POPOIG//su/YcmF3333O/4///F/5/3HD1zWxO9//6/4X//X/xd/9Vd/xc8/vUeA4Dw/ffyAc/D9d2/5i99/z7pc+PDhA3/7hz9aeqxzIK6CjAZkRqfGYhTTRTP9LPOXcQhVDN6xzKvZhPpOgrOqDcFZkFMqlT+4tqJljMFmmLyzlcQpBsYQ8F443R0ZpsiaV6L3rEsipdkE3jGBxDjYvmlJlLQwDhNvH+55/JiBzHGMHA8H1rLig7V/CIV/+29+zx///gfuTgdidEQ38u3b3/HzH3+GSjEfR88P7z8wRGHwcH+cePPmnueXJ4JXxikwDp68mk58cAPBF6bB8eY0cllNSPTh/sA0wt0hEkNgnE68e/eIK4lI4G4MgOIlM/pCdoXjaSRKrYQnZn+LHykpI4PnEAUtK4fo8FJF6zUjmm3xxVlqhJL7RIm6GHO5rISzZ12t6slhsklncIExDrw4Wy1c11InPb72Zuut+wnp64DTRBstbbRNoGU/XnQbf79ms/PvFyea1sB+RLcYBlplS8tDqSKRPU/FXe2/GYJ6PLKj4W9jtoWWnx3QV+f6gmH4FVsHEF4t7mzf/8PP/d/zdvMTNz9x8xM3P3HzE+37X3/urwI1r0/0a/Kv9kjRNVgBduNVpKef69U1dn9t17PJvtCe/x4osQerqhRx1VBo10mJw2DpHYcDcYj8//6P/y9PT088Pj4xz5bCAYY0qprmSHCJNWWcQAwe8VI1bqyBDQxYc7KJc6Vh7QVLpaa4hMbkuHp2ukPxpadSbBhWReF1l05TAQMnhoA/3B25O46MwTPGWg1JDLAYY7Sy2dEzRavkFKM3ml5wRres4sFNOLgJ9cZaAck+2ypwNeZL21fqhNa5pjHj+vsXBGk5hfVVeddSRoQi0kWNt/LZnhAD3rvaRzCaX+3sxohQA1x6vxQ66FIfoCB9Mk9L1XKyadE0p9L6VxeU3vqjYkZ6u/fKgFIqBW/XU5t9E1tW2VZ+Su2zNSyp4tFoqRorGwZs19FuLKSCCM26NHVxqzAgnSEjFYjaByrbmDIwadOIcbUcuD1DL5aW5kqhuEojVEEDHCZqX/AcxoGUMuuarB+NVlGqOKtlIM5zWUz1PqVtPDSwbq3l650quKZb5LlcjOm2rIvlHLdUKWd56LmybGoMh6BoZYsFEQPsaqqYVN0hH6wPNW0o9U0kD4Zh5HhnKyI5JUpn2K3ktFbR49yrpbWUPi2FlFaQJgjt+vlLvgXksBvzAGIE1fZknDMnvK2SmPPshuGzQfjmLo3FuAFpe/ooanXzVDeRR5Xrc+3PrewDDMWrItLk8KSzJVuTsrMx79SCCUrVSqi2TUn9XiwYaHUQHJfLhXfv35HLyvw883d/+IHHlxfi0zMP33zL/3x84O//8Afmy5n/9//2v3F3d8+bh3t+/ulnXs5nUp55+3DH//Dv/y3BO3764Qf+01/+F+Y1EWIkL4mimeCs4l8pGe9Np2wt2kXTSzFfOFRG2MvLCyUVfIhkLcQgBCdMwUNOJlhfx4xQH2ytBuKkAvZDYIqR0zAyBF8nMgXSyuCtWtoqDh0CJStBHENlZRasPK2TiHeB4zjhpZDWmYf7e2N3hpG7+5Hn8wv3p4nT9MB6vnB/PDAdB7QExmHkMB2AxGEc8BGmQySrEoLwzds7huhBB6PYLy/E+Bbv7f0Og1VBHLxyOgRyWXi+vDANjuMh4Fg5HSZECsfJoymQk93/WgohRtb5BaLj7v5AvpwhZ8I4gggxjrz7+T13x5EYPMuyVu2Fgy3WqN1zJJo4fo03p6OVl11TIufCsix8+OiYfnjHMQaOw4TozHqxfubEk2p6dw9add/j7fd+pbD5NdkxCbQG3+33P3RrE2jZgrX2zSf72jjONMaw7lJJbbHWXR/bBUqujcbnmqs1Ou+T8x6E1/P8honFl7b9yqld5+YPvrbd/MTNT9z8xM1P9HNz8xO/dvtNjJrfcoE9YNOO3VC72hH6zl88yw7basDNds52jY6cN75k72yNbjfhnbAuF+Z5Zp4XlqVOzmoKjqXwUI1WIeUMDhyuC0w3IKU/i13JbnSnVN/m8FLTdGqHv6JDyW6gyDZQ9qhfhaAqjiCmtSJWYecwTRzGSAwOL1XkVprYbtWkCd7+jr6W3zZNm+DrTy137aWBMPZ5T3OiXbdqdLSfsJWytgntpl0jOwOgKrv3Rn8OjTFjzJAtTcmHNsm2SbJrfYbNKWs7T3060oAWFSiZxpTp7anXkJqGRaW72fkq2rFZDJo6uRN6u9u/qUBYf+W1ItjVeO5/y/beartF2PpI2/cVYNkowO0z62e1MtTV+CtcG9r9mNpR73r/owNUCFWxn5rbLThf1eCLIoMxzLw3Eei0ZtaY6FRJgWk+G5AG3F/ueH5+ZlmWDvhRx1Hwfqvc1CmJyroYSLKsawek7KVLxaGqN6gpYU3suulJNdAwxNj7TxeJrkDgMMTaD6xPNdaeMWNW0rry/PLCuhjLK+dNy6ildbkdONOAxcYsE3dj1IBV3XJ9qUVqP9M+ZuE6SN+s+q7/S5d12vaRav+wfqod7LcgXlS2FR64WiW1EVH5mgJVDGozuWhvj6qtuuR2fdlfZ7P7fWIgdmbtS0JCW0l0dTyVolwuF9Jy5sc//C0/vX+HAv/x//hPhDhyGCJ/9zd/h0gAPOk7WNeF+XzmdHdgkMzDaeLueODd+/f8/Q8/8u7DM4RYUxuDCWE70zhwokQHQSC/nAlS6c3BRMjndYVc8Gq5/UVBgidVBpu4KpYvAXGBAp1FFoNnDIHorc9LTbm9O0xViN4WOJCC+KEyKw3IvFxmfAiEYGMxFwtCox8oqRCC45s3D3z4+IFvvnnDMl84HCeyTqzzzJvTPWMc+O6bB4RM8FaiVyURBntHp+PAdBzJzrPM7ziMI8dprNpmE4fjkcsy4zzcPZjIZGPhTmMkBiEXOL88M42Bh+PEMj+zLmdCVO5OE/P5BQFiCEzikBiY08BQPMdDJLmCarLAPgSm8cD8+MTheCCnTDwOpkPnTLtB1XN3GGsMYgLoIY7EGECxai3Onv0wRHJa+fDuA+vv/xXeZ85nW2QKQzD6PI4igha5ik+1jcMGasvWr00cv62MtwG0BZPC5nJeU7fbSXr1HNmCd6H9rrNX2iLO1i7zqYqpWJR6HfP7pdppKbt4qXnRSpNvY1nbooQITcPAoqFPY8Wrv2ULnF+H8NJYrGJ6aj3uz+1z2T2HqoHYn81O7F5hXwb6z327+Ymbn7j5iZufuPmJ3+4n/qRVn7pAVWUHdBFUmoGtd0b77HprWMa275f2tJ1DKx8NpGxlftd1Nd2UYsbk8fHjlqrhpb47m9TnVka7GNrbEH7FVvhTBQJyTQUBrMM2wGbf8/fGub2wUjbnU615KdpVzPtzE6NFWs5n6foojsIYI4dx6MbPC2jOtr/3jDEaiyYYODNNA0MMxqCp1XC8CNEFy+d0DaCxdBL7qVoyJTPUEt3DMPQJbNelaSCIC3VAbeLQqtfPYd8J+0RXBBc8IQ523hjtbdfB5I09aM/MoPsOwDWGjMg2WS55268LUDtnjJ0QzPixG249QtgBgtVYuav+ZpamutltMLv67jqCV9surg/UHoxUgyBoB5eMzteemRniDdqVaiOaHorWPuAqZpO2Akaudpp6rUoN6wZCvAcveAlbX3NS87Yd4rKZQSd4CtkpMQyMGliSlZVP2daQGv5zOhwJ3jNOViVsWWZUC/OyICKsKTGvC8NoTialxJxsDOVSWC8ruY6dvAM5JQlFFI8w+Mg4TQzjyP3DA+MwWN90m4DwhlQbWyilYuDlEDid7iydzjlyKYTgO8AzzwuXy4X44T0vLy+s62IV6GRjeg21X7oGbIZAjAPDONrPMHLbMHBtr8fUgVQAtRLyu+1qaPVAuwa7LVdX6o5lA/i3PGm3BcplHxS/3pQixrRUUZr1dTU4aLTeIpCrszXL06jcXK8atWto7a3i6vSgAdQFioHDDsdyeeGv/8v/xU8//j3eOz4+vfCHH37m4e23fFhmLs8XcAMPb78nFc9lzoQY0LIyOOVuGshpZVlW5jkxTCNzrrht2YKjOESr7qBKXpcuXr5oQUVZUjaRxQyDeFzRDsrH6BgPVQC+FDRnAg4fA7gjUJCSmYJnCgHEUcRVQXLPOHhEE1KSMTSHCfFWbXFZFo7TRFHleDpWEXjzbWXNLPOClsRwmDifTU9smiJv7u9xPvDy4YmA4zBO/P533/Hu4w9M48Dp7i3Pl0RxiW/fPjCdJo7HETfd83d/+wO/+/57xhC4u3/gklZOH99zPj+Ty8rpeMdhHHl+fOYwjXz7zTc8PX2kZOX54yOHYCzUu+kNznkUTy6O093BbFVSgh8oAochUnxgnAIvee4C/UMw4ca3Dyemo9HqHYllzagm4mAp2r//7i0//PEH1GUOh6NVM5SAZsGTGbyDo5Al48g2yVVlnAYeZOAiZ+bnxXQKckHxFLEVfwcbNb6OJ3Mn+ynq5rN158M6I7r2ddhipI0trUihVntsY347r1fqmFObmLWAtDZEAafmg3KdBKiI+QIB53QL5qWxLexc1Luy/9lgsJVfm0y3gN/Chk+tQltracG3Xt1jizmNn2GloPuHV/ZAam3oHv/RYh3Z2ifsvv8z325+4uYnbn7i5id25735iV/nJ/7BjJrPIWd7ytT1TfmrF9d+t5zUTn26tszbTUF/adonddc3ZWWsS59IS2WFuKrZ8nQ58/j4gcfHj6yLVYOxFXNrR1pX1lwodSLZHqZzjrTa/jiQZA7AObWy22UD73q7FHtzjWHWGAXXD7MzDRqDwDkzTmjV4hDwO52acRi5vztwmkaOo8eLIfMuWkWn6APTODAN0So1Rft3cK6WfLZnEZxpw0jT9hkGQnCVQWFVlkxQmfpdqIJjhrbmnLqIq/cCO+ZM/59ILaO9lRTv5bpbP+npVKFWXNoxYWq/AaqzacCPaYZITaERH7oDp3i0goKNftnYNL0qgFRHWXuQldBu72TX31obagMs17G9323ANRaX1nxd7d1Yej/vzrl9126lAXgt7emqezQAqHQwqf1XsbS4RgE0jd42+Ftf3JlDbaGHbEapVMAItQoFUiuiDQGKAaxeFfG5lqjOrENE1wRrYgkDmhJZDEyM0SqJ3d8ZgHNZZlLJRs0shVzsPFpMPEwc+Pr84t6WUHpJ+RijVToLMC9nlvVc09o2do2BKjvmlpoy/rpkzryw1JQ75wOqg12hCoy54Li7v7PVhnVlXVdrYwXLfGhaP7UqVc4si7GAhnVlHFduG8Zk2m2/nCL7+e+tm2/2rqUENqajQB8njlfB8WfOqld/y3YOtnHUnGy7pqNR2NnIdnp97k+9zzYBEMGA8SD84e9/5OO7n/jmzR3Pz0+QF6IXxhB4enoiF0XEUvhSstRC0RW0EH3g27ff8Me//yPzZebx8ZnoLKffOcdhmsgU1DvSuvDyvBoA7wOK0dVzsWprDhOSj04IGBgfxogfjDrXqOvBeaJzOFcIQ7SgqCREM4cYOQ62CpqrvwoxWODvBtDRVh/jSClqKbbDgSFEnh+fuB9HpmmkaGKdZ2IcyTHw8vKCaObhMBJR7k53vDmdcMFzf3ckDp4QPdPhgUt6ZpoOxHHk7XjH/cMbvvv+e0KMOBcYQ+RyfuZ/+Pf/gfvTHeM0Mq0rb+4OSJmRXHg4nhAVQsF8ogiaEtGZ9kLwwnEcmSZbTZ5nA8+/efPA08cnlpR4c3eyANIpwzGCgzJfiFNkjIEhRl6ez3z/3RuyCiUHNCvBCeJNA2I6HLk7TjyOER8D4ziaPwwBVeXsDRT3As5XCv/hwNPzI+Fw4P7t96QQyPLE+v6MlSyt1HZpkWL7uR4Zn8RxSl2EuI7jXu/7pa3Gsc3DsIV0++tKD/LbWorNr5vPlG537aRfsiFS71M/HfC/YhNpPnBzxN0PX93rVVCw+1N2E3Dq/bREGPNDrn7fbucG09h28xM3P3HzEzc/cfMTv91P/MkYNa9fYnvAr1Oi6h51v21/O0n9bne3hpZdgz7tej0Vqu7XVtvXdeHl/MLT00fmy6Wqrm8ZsKomCGw/u5fSJr/1PLba7uu5t7QrbT3qk9n2du+vTXirOFP6uY2Q1RkjUl9n7aneWUnlqf54oZfi9l4YvKVEDcGbonq01CdTRzfRW1fP470xPqzEtuno9LQm7/HORH8b7a+JITeGVFGb5Lt6zjaAnDhDTisjxdfqUQaaSEfwN3qdlWFugsNbn9lPvHc4XnvPO7ZMU+62al1+86YViOr94jOjtfWB3tXa7z1I84khqXDMq7G6N2Ds+rnlI+/otNpuyH62c5UN6GvPQQ1zvboQ+8/216TbWn21f+uHrY9KvfdmORuui1DfewOflICJ5YGBdnnNlJQZfCA6z1JLr49xYBpHjodkoE5Vq996fku1aqLCdXVJ6FW82rhqfU6xSlC5FHRZezqa6+lHJui79V+P8/b+FCzHtxjQ5XM2UeHV+mQTWQZMHykYoJad7Vdy3tpU7N24CurllEhu319v2x5gvbLL/5hz1TO0wLk5dtHt57efeztXpq2E2BeCBd8eekDxGZO+880tuLEfVwPYECEtZ54//Mx/+Ld/wfEw8B//93c4CvcnW33MCnhPHCcKCVxAinI5n5nuD/zbf/MXePH89OM7Xp5eEBW8CpP3TNPE4TAhIeDHkcfzmQ8fn3h6euYlzQim16TV9o5D5BACg5jgpQzGZMSJLTQkC/hHZ/Tuwsw8PzFUTbPjNPFwumOMEdXCmo15djqdmI4Hcs7M86VrN4kI4zig2aqlxPsTmhZccoyT4/v7byk58/L0wiHecVlXght4e3fk7nSHaEEKPNwdGaYJH4VlXfCVzj8NE8MwcYgjDsfx+MA4Bp5fznzz5p63b+743fe/4/zyzLqeOY0mvHU3TawvLwQXcaUwxoCuifvjkZ/ff+Dh/sQUrPKhaU4op8NIweFUmB8fmY4TD4cRxLHMT3z35p6X5Yx8c48XIS8z4+AY3IQLA+8fn5gGwWnkeLTAfZ5XYhCWlye+fbiv76EgwTMdJ4Y4oFpY5sTHx0fUO9PVqrZsXReQzDQ5YlBbRMl5y5jtzuDzAfg/ld16nQ7eLq3UcsfbFbffLU4QqSvzFRivsVYLzLdCrNdt/sfqwPQg/5Xx6P66xQT9Eb2O3dpnW2Ai4kBNtFXENDzsXHapfNMy69vNT9z8xM1P3PzEzU/8Nj/xm4CaL7247eNtAvm54z5F4Crg0ierFTDZfddpRmX/71cgCTZRbqCBpWqspJxYU+J8fuKnn3/gp5/+yMvLi5WbK2ZpG9OlaAOKBBFLc1Ckig3bTfoGEoi1ucytrWwpcZ+5/+ZEqGhhKdqrP7Xn58QE1VyF501vxr6zqk2B+8PEaRwZQ8ApVTTYUpqCt1Sp6D2HaTDh1xAYhkiT5xURQnC1zDf1bzuuTXSDC8QxGgOm5us2QMZ7Uwp3qrjg+sS1AVhePCid8eBbNZ72/u0J2L99rQblK3unaqnsNy2bYrbIBvRwBdLsDhO7dvOyhomIMW/q962H9v5X2UCuAXOv+ql1zU2bBRqbpYFw9bAK1vTOVI2fqpKxyl92XdNF6iAgGxtH6s00QrDW+xBXU/CaoDXQl3F2YM5mpMoO3JIrLaUG0giKRQHbj52yhzp1hUp6dz4eD3gcQTznj89c5pkogePhyOl0oqji8LycZ5ysDN4YT0kyAvhopbhzZaE1vSUT427ApQElWQuX88JaU6+01IpMfqvIZOlyrqc0DXGwVCknBAfqapW1VMjrTMnP1j+dBRbO79hUsgFUgqX9pQruaMkGOgXHMFgFspIzy+XCbdu210H4LznLDcS+Pkf7TqFqh7eViRok08mKfd8vna+fF/rqRR9nryLsBgy3/ZvUge227deHYB0qWgNxw4wN1Ht8fMfDaeJ//Pf/jnfvf8QBQ4ysJfH89MxlWXE+cDhNFM2s6xly4nQY+f677/gP//4/8J//8i9xfqAwczxOnM8XDtPEcRpRlDBGkih5XSk5E0MEL8yXmZJSHReCK0rJyQJ2J5yXC5oMoHTikKxkMkkSZVHwK0N03B0Cp8PIm/t7pnGqlO6FaQiM42TppJpZ16WuLk7ktHb2pPeeu+lAwPH07j1pnbmfDtydRs7PL2QP0+nE0/MLz5dCFHA5V58BD6eB4XAgDBNrVpxYVbgpBqZh5M3pRPSBw+HI3d2Jp6dnfvf9d3zzzRvGwePdgbxeeHOc+P7+DlETtS85I6VwGAa0aiuIJr7/5g2HIRIQjsNILpk4DJwvC94H7k9HDtOB+9OJx8dHpgCSZwYpHB7u0VIoo8cJhDCxpMI8OwbnGaOlSpaiBAEfPNMUGYfRNMByRkLgdHdCfGAYAhQYh8DzZUa843w+W5xSF59EPE4zOVfGb83BtwWTHtB8ujK6GzevF9Ha961c6NdWTRUQL7uxsVtBdG0EtTbYn9IKL6hWmbVqL6QrFFhcVOPBFsjudds+XUTZ2mix4udjzn7PVN0R+fJ96X516LMwgpHx+1JPW1Sqz72Tb4tyUzK73m5+gpufuPmJm5+4+Ylf7Sf+pBo1X9s25kjLKbPGe+/w7FNIbCtS+uo2dQLpve9MmJRTR9YRRcSxzjPPjx95fPrAu59+5N1PP7NcFhOyDbUiT32ZJpCbtwkbBvhkLWYQqHPwWu4350xH0+t/9owQ1yo1uaY2b/TCViZP62FSO56XVrXJzhC8MzHgIDWdaeThdOBumhhCIIgjukDAEXCMPmz5pJVJE6OxbwTQUnqaiAE6oU54jTIYarnhaRrxMSLiKDmRkj13ez6b8G97boJVEGrCwoh0XQ/vd12voxk1La0CNIZQ0X9ada/XmF9HVwUz/DuR5v2m2yGbFoydwLCR5oWbsWhQb71ogy2cqxWi2llrjpsZqiae/KpT71gqWhpfQ6ECEYiQNSNa2+4ENJvFKNlS4EQgBANMdlxaqZ1Fm8aMNqynMsgKFTRsFoj24F41cW9sSn8WPT9clbxTVccJLgYkBEIEHyJxGJACp/s7zpcLj+czY4h8ePrITx/e8zS/oFJIZbUekjLKSi7ZViAEfKwlzTEwxSi4lnrYXvwQIt4ZqJmSUXRTVpImo+o6h0+eRZTgHSkuNjaTVXIyEXGrXjaMDi0ZzQb8rOsKq3YGUWPQlZyrVlU2h6q2P1DF+YyRlnOjMd42+cw43K+Y/pbvXjtDC4p3AYTaKkrlYFU/IT1g+NKmNIASGhzpkB7QyG6c9HGrXNkihU6Ga27fhrvUAVooxWzmfHnm//7v/h2/+933/OEPf4sCcRhYnxfmNbGsiXGaQITLfGYaB8vfHyajLj+98PO7j1zmldPDG97//I4393ccxoFSEnNKkBPP88zLyzNOhCBWbvU4DVVYG0pa0ZxJWbjkhBPImi0z12W8E0pK4DzDMBkbczoyDcL9aeR0iGiaWbUwDVY5MUSrkpjWRIiB03DcAnQrl0eoYP/xMFLmlYeHE3kJhOA4HSbuD0fe+3c4F8yOeWGIHieKFyWnmWlwxGiVF++PBwKZp4+PlPML58vC3TQQh8j98YRznsMwcRgnfvfd93Xilnl6/zPf3p8Yh5F1NTHCUgyofnj7wN3dkcfH9ziBt/cnohOit0WZGAeOpyPjEEEc6zJzf3diCJ5pDHwXHyisPNzfsa5QUsJPkTFaCu7TywXuj5SsHMYDy7qyrolwGPAhMo6RdZ0Jaquz8Tjx/fffQIiAkuaVt/dHxAnzmrhcZpYlsa6FD+8ewUfy2lblCiKmeVBKq5Bx1aG/uu0D1s8F7J8EqZ0lQO37urtOHSB1KVWklUqmrx5uM93rRgrVR181WvcmoDJ7Nx/XvutrL7uJ+OcnEH3kfv7ea9DfdAfsTqXfZot92gKj/TZ9BPpz6VbkttXt5idufuLmJ25+4uYnfruf+K8G1MCnN36d+kJ7E/SVfaoRLAqOPsGSCq7kNVm+pKqJl84XLucX3v/0M+9++pkP7z+YiHCd5OeuaVPLCfumOu1qnXpjmmgta5dzTcWoosP7e+jtls0hNeB906LZs4XavtfnsD83QdMYHeMwcJgGphgNgPHe9D2kMV2MmRC8w1fGjPfGGvCupd2Y/kxjz5juzA6sqVox3m3lh1sb2T1jV9NMrBNWRybX76GlHLXnc/2zVdRBrGVdV4ZaArm+aHk1Rjeqa/OALT2q7Vj/s/+9/2G3W/v9Ck1uAKmqIpUmpZVVYb8V8VQQqD7b9krZBu9V0EAT4t2AnK0zV4ZOZcuoGCik/b4qItPHBNsqVP8emlidYWEVGOqmY9u6CRLZDGErdd2b3R442/MGVAQfbfxNxwPqDPHPwOl4JOXE0/mZwzhwGYztlVPBFRPELiJ4NoCtqKUnrdlKDJY6Rpo+k6XFgVdPCPRyhbmo9UF7GB1UMaDXyrgbpufQEI0556gCy2a4u4az2PiUan9KPU+pgHDrEAbOmlbPHqy7bddjvP37S04QNgf5uef3SbDewfSdILca9VwVcF++1p7x9iqOt33VxOxsX6wv9K6/UemdtuM3O9OhdtWtZHvJKIWimcPhwJu3b3l+OfNyuSDO8XKeKXhUlKyCC4G1JGxhQblcXgjfvCFr5v/8y//Eu8eP/O5f/Wv+5m/+DlWtgujCOE6sZ3h8fubj8zPOBYYQyFKIhwlxkDXVCm4j0ziS1sSymri+a5MYMebmMEZGL4wRhug4Hg4MQTmNA8ch4p0wTSecH3GuAAnvPadhYBybwKRWhlrExUgJjsPdkRgj6bLgspKXBT9WNhzCd999x/k8m4i8t9XXEAJruhBcwHkhRo9zwiCOu2FEDjPLyyPffvMd4c2Jnz8+kpcLy+p4fP9IdANDHInR8/L0SFlM9FJT4uHhDeA4ny/EEBHvSJpRB/cPd3zz5p71cuHhdCKvJo4eRPDTwNNlZjoMjGOEonz//Rsu65kiK8e7O85PxrALYs9wni8choFxGFjXhEPwBBwFEccwmVaDJmWaRmIc8acDx8NA8ZGH+xMXOTP6bzjc3fHDT+9IKfFyXjicwMeIdwMlXxjHgeIKay6mm6fabSDIJ2Pil8bmfgz/0lY+M666O4S+4rhVS6yhq8IVrbxrAci1X/7kir/C5u5nzfuPXwX7/dKfmXDsGbal39Qucmg1artVurqQVfEoe998225+4uYnbn7i5if6Obj5iV/rJ/6JgJrPG9ivHvFZBOvVpjU1pLQXY4i2GZGtZK5zjlIKyzyzLAtrWlnmmZenJ56fHvnbv/5r/u5v/paffvwB2T3YNa9I1WQZp7G3JSVLefDO4aLgi2dZTXB4XmbSalWf+oPf5rUGROz4lqXYxLJP/hoiKPTiYPLq+YlYmkcMnmmIHKeR0zRyGAJDMIaAqNKwghgbK8ZU1kOwVKmmT6OqqJh4WQNiYjDF9caoiQ2kEWuVpQw5nPoqxmospHZ8Sxdq7CMqeuia3ky9p/6OEBMAFocLQ73T0lkOEMCHDhJJBzVk91ykAwrXn9u/m17N9sUG8ti7pUrh7/qfNk2j3b5ShajUAA9rYzKGRbHqQk690fnaOSowog10af2hGZw2sDEwptmIKtC+GS0FzXnrUzXIqFiNnS8rmpPpqNhDt47gvTFEcGgFPhQ6+GX32C5YaXdFK/jU0rvkWrHctf+YvXHZ4XNgPEzWLu+Y08o0jczLyOADh2FkHkaeQ2TxKxTBFbej9hlrZ821RHcdb82K+cpmCn6rEOaD8exKKSzLioijFMvr3ASLy67SnCLFoaFQgo3VUjNihyGYULAzI2kg0e5dqNmBpp1j12pATaKUJoJ9I7XDtS3/bGB9NSTlEyf/tSCgjaJ+Gr32Nl/zM70tLQAvuxIY1LHYguvdcaUG3ntxyOvge/d5PU8IwfpPToQIZQj89NPPHI6RcTrgwsC8PJMVMkIqJma/poSgLOvC3d2Jt2/f8OMPP3A+v3D38IbzPDOvK4cx8vTyTLg/cn46c15WSlFOJ1sl1Fxwg0dKYU4XHLaKGaPlyadsYp5BBoYSLPiO4KNDSBwGz8PdkdPhjtN04u4QOY6Ow1CFFAmEOBHHwDgK0zBAKQTvOY4TZV0qi9CxqBKOI/E4sawrpzd3BBXKmnCTre5F8UzDxNPzC2vODIcLa0ocpgkfjkCipJVxOhHDES8DD6eRnyWR1sz9YeT7b74xu5ATP7/7wOV8QUTIq60UxhB5++YtkhIfP37g7nTk6eVipU3rC1yWBR88D28eAOWbN29xKJoWY8GmlfEwcjgYJX0MESfCYYzIXMBHxnFgkMjFWSUWIVfGaiSjDCGyzjNhiHXVVcCZ/TpOk1W3G0fCwSqGhMHx9s0DTwrLZWUphfu7kz3beeV8WcCtjETyWsX9vcfHCZ8K82JtENWrfv3JuNiNwS+Nn9fb63HQY9JiE9XSFw5A1PwosFv82UbPVVXVds3qDDcFwU/b0xYP9lpxFhuIxYxFrvz569XefuyXNrHztAWh5jut5Vpjht2CyZVFkK04QI81f3ki8+ew3fzEzU/c/MTNT9z8hJ39t/iJf3JGza9B17527NePb9WQbFV7WS2NaWPPnHl6euTx40cu88w6X1guL1yWhfM8c5ktX69pT1AH6TCaUnbOmZQS65p2Lw3WdWZdlloVxtrnnDM1dugv0563vYxStKY7mUDxlkPX77ZPvAUzjk2XxsoAW3ntwzRwHCOHIRBFkAo0+GBVdmLwxBgYY9hKCFeB1eAEtFiebi2xbUCLATltEuyk/lSmTEttUjE2kfNSj/Ud8fRCTxtRaewao+a5WpGnqr/aN4qVM3T2nYEjlr8HGHtFjXIoRqfAqdtABcFGuMH89sxFETwNJIKNAbR/zAAUM0hl74Crg//8YDSApg96G3H2vhv4VllXzaBpY3bkbOcVYxC9RqxVKujhGhCwa6i0/+xcfO074hwq3tgh3tl1iiIlQ7Drl5wpvTx4+48xqtoptd5L65D7QMhV8KGNxV4OHDOKPgQDghSCg+hgTAt36R4VeLm88Pj4xLquvFxMZT64lVksxUnruFjm2RhqVZNqZ9c7qKnOqkUpBXLBe9NdGoehVnHCynGfAynnrklVNJPSgpbMOE6IG/E+1LSnzLLMHXAMPmyAlu6NvO+pZFaO3tq3rgYSOZ9vQE3dRPZrAfbM2jBUoLhtfNnntU+2Prc/uvZLV1Pxmo6XrzZEdqCh7kDFT1dI65is40eAUHWdVNUEIlX7UGsB906LHJc3B6/1hlQqA6sR63VBmaEo4zChUVBmK305wOnNkfN/ufCyFOL4wN//9PdclsQxjhyHAwuZ83whp5X/2198y9Pjez5+/IkQR4K3Vb3DODCOA06UVYTizG6n9YKj4ChMhwnF8fz8gpbC4XBkGC0Avlxm1rQgFNCMOK2psTAO8Obhgbdv7vnu7TfcHe44jQemMeAlU9KFtK5EH20seYePjhgj4iqTE6GsVjaV4Bh8QELEEYjTSPAQvaOUFaJDcyTNhRXh7bffk1LicHkxENw7ir0dQvAcjkecC1wuMyUJh2lABzgdjLb/3Zt7/OGAc+A0o2KM8Lu7ifPzE99995bl+YV1XTg93BMPI48fH5mKo6yrMVO94+40IVqIY0Bz5nT/wPPTR/KyIkPk/ngkKxymCaHgUFyY0JLwzlOcIkMgZ6wsaxxRFYtDdMVPjX0qaIGsQnaOoo5xjIQYERHSujAeThxPd4xu4McffgJ5pJQF52AcI0NIRJ+sgIALrJcLRRUfrNxvxFPU9MCA7n/246THWlf+Uvvigf35Bc/YF1Eq67SdQpTdUDfheN+KL7RU0bZDcyrbJFsc4AuUZPahNP+o3Ue2qiVtTEtXIXF1vANOW3XWfmvmAduizG5Q7+2HYhUQq90p7FOYqWVkPxdTb8+vH91O7QS9iQkDNz9x8xM3P3HzE9z8xD/AT/yTAjW/BaT5rfteofFOyCmzrAvLZWaeL7y8vDBfDKy5nM+It/w0m5OWCsK0lfv68pzv6T+qapPcpi6N9lX0dV1JKZFS+oT+1PpwM+QdF9AmGqxbh62AmjSDL9JA0/7be8dQ2TAxeCvjFjyD91a2rVVqqiwaA2liLX/nemqTa71EN8plK5PtK1iyT1dqjgkMrWxivcamqZV42qpDvd9GN7XOX4EYe2H2znRzxA2QqsN/mxBXod+e8tQfLgbENFSjVkVSSq2O1ZTj95PrjXnS3oHdz/ZOLSezXaveTzU2bVWlNrE774Z6igu4ek5VKjtn9wL53E8/fBuzrX91B6/QJU8+k6pU+2sVsak/JqisjaVVDZSlA1WjaHe766P7RtDoPUippmNfio7roAaq83CgwRGGYGlIWggxEusqwGEaORwmLvPENI5c5sWYKN40aYqYgnvrd955FIe6pkFVTZgqKWfLIab2xR2w5HvlAIeIgayWQpVq/1HWtIKYI4oxImL9PogBqVpAgsPXNKiSMx19l63vuspY0gq6OuerBpXjtjXAc9t2/h6gs8kMrK3dsI25V/29naGG6NYba6DdRpSK1EBZr8A1+Ixf0Ta+7bo9DZWtLRvQW68s1DEq25BpZmi7KZqsHWTyunJOJtAu3vLWv/v+W4qu/PTuPbnAu/fPPD1diIPj7Zs7gndc5oWSM8dpMs2C8xktJtx9OEy8f/eBaRg4Ho+M00AuicvlyQDKYIGjc2Ydn88LWYtpM/nIulo5+aKKl1ptTWDwMI6ON/cHvnt7x7dv77k/HjlNR4IPeC2QFly0oE4QvBTGwTGNE+K8TUTsgZNKQbCqcH7wEDypVv8bpolhCuR14bIs5qdaVUI34vDEGInB94BQvCPlhIoyTpNR5b1AUYbguZwv+OA5nY7MaeHu7oiPjpRWPj49c7m8cDpN5JwoJRNC4HQ64pzjeJgQzVyen3GVgSrA6XBAtTBNE2SriJjWGdFEDN76StUlELFFkKhQcsCLI4sSPeTs8OIt3lgTJTlULZV6jEaHTyVbZRKJ9TmBi3aPSZVSslW2GwaO93e8cZk1C/PyyIf3PyEucbo7cJgCx+NEXBPzkslrJmtGxQTfrO9+Pc7ShlDXX1epxHo9jm0ofuKd2sC5Wp28+gK6/92OazHALgBnG2v1YpufZjteKTU8qP6NTW/QgnS7Gdld+3XMvF8tbYtMbafXEw/Ztb/Uq21SJa/urxu/XZzoPnkof5bbzU/c/MTNT9z8xM1P/HY/8U8K1PxSuhP8eoCmsQ22lKFmuO3F5Zx5eXripx9/5PnpicfHj6zzYgwDhIfv3qK19HNpQM1q+jJIrVJUV+i9c3Wl3SaVDWgoJZPSSkoLa0qknHdEhNo15Bp9UW3pTsa6aOW+2YEWTjrZpIMhIiaOGpyV4R6GyBgDUwyMwcCaEGxyagyXQIyBIUYOU+ydrJXgNkS29K5toqo2MfZ+A2psf9P16J1ITbPDVYFhA2psot3zjNu91Hvvndhe2kYfda8qOpnqLXgz0L4BNA2psp2M2lYBEANrnKWuqKWpGLOqsnbYATbVMbd22L9K/VP7PbfWamNTSHtS2sGRa9aJr/diIlyUXIGaxvppJkRoQsetW9gJtn5vejTFtHxbmpTbgUdtq8dfCxNvQUhPA6tVo5xsqYLtXFay3FLfpD3bZigq0LgFKcYioj+PHdiFmNizM6ZQHFzHsOIwEGNkGAYO08Td3Yk1rTy9vPB8vpBywSdvV651LsU5Y7lgWHepQsI5585AS9nYYD6AKx51bTwpMdSx4x3TNPb952WpGlKJlBdyubAsK8MYmaYj4zBxmCJzBZCa8DUoK1pL5G2gnat6Tq7UNuZC9LFFbty2r2/Clt/fnpijOU6+6OT7uKwq7l982q8966vtij4Pu5212612ntenuQ4XmmOvKas9SLcPVTxFHaqtBKYwhoHH80zOsCzK+/ePeBcZolXmyyWBJsbomcYRL4E5KYhnGA+UbPpLh0MkeI+WwnK5kNKCD4HT4cBhGik5c7nMkJXoBxO7LoWUbXRFV8XpyXiBOATePJz4V7/7lt9/94a7GC2lFgEtuCCUvLCuFuQfxmh07sE00gQh6S49wGHUusHho2c8HlAX0OBw1ccmCs4dcHFgGCaiDIQwMr/YKnOr/BaHgTgE88dpZRwH80FcQAo5JUY52Ep6EE4Pd7gg6CWzzBe8E5Z5sX7nAxmjrB9ORw7TYMzRogzicdUWBm/BvIgJmK/rimjheDripHA4RPwwgkhNJS5QilWBFEALwzDAEA3sLVoFKZVhdOAjvniGGCjJ0qZjDIgfuazZFl2GgItDLT5QCMGhRHyM3J/ekFLAuYmX8xMfPrwjDAMxHPnum+95XFbm+RFxnugiKo5UxUptAeJrgLL2zr+Lxbfh9Sqmu0o30VdB7ev4r098v6Jj0HP4PzUE2wpvHWO6tyD7ycVnjAi7tr2yEb+Ylv8P/K5/Ly100P5z276+3fzEzU/c/MTNT9z8xOe3/6piwm17LVh01WARfAx9MqyaWeeFy8sLH99/4Mc//JGnx488ffgIwOF44nh3hzjhw8/v+OGPf+Cv/vN/4fHDY9UXEUIc8D4QfOipHjkl8rr2VIx5XUhpZZ5n1pxM/Tx6ylrMMKqxZVrJ6L5aIJVJk3VfFbkCNMZMEQHRYjoZ9RhxSvDCNASOh4lp8ByGwN00mthUBWq0AjFDcAzeyhAD1RjU1CnvuuPy3oSCo/fN53QxYWPZSG+byFb2uuEmHYiC2vbNaTURYRMG3nVNpWromDEpovggHRyw5+E60CCV0VO0icAakNFElkTq+QuWjmQHQbtuB0M+36+sP5XP7vTZPExtQrLsMJ8MUif2ld1jCU71ebR3Lc5Kj1cRZ9q97E/mBLS+D7c58W3lZfcgW7ta0JJza5B94sz5m+GsQBKZ0sC0yiozY3gNAl1tV9UQZGuR0oV6O3OogkRh8CCR4+FITglEWDSzCAynI346EMeJ5+dnHh+f+fj8wmVdSEs2w1upitF5CJYPvKRMTqmWxTaAzSqPLUAg+IKrqW9NcNh7QZxndIGHhwca22pdbPwuy4V1nZlfLqR5xcnJeoMTzpcz0zQQQuBwOLAsay0L3261stB86H1lHA5X/ebPfXv9HD73XPaMum1NxP6l1z3T0kq7TpPb+mpfitkZ1l8xB+orsjvb1f+qp2ytaYG28CoueGXL7RZLDwqKiq2woRRN3A2BtGaen854N/D89DPLnBingegcTgpFE4M3kW1KZhxHZj+wXFZEPB8enzic7himERAeHz8iohwOkWmcOE0HyIXHp2fSmhn8wOAcS05ktOd7e4SDd4xOGQfH228f+P53b/n2zR3HwTMgRPEVjDTLFgdfBe3hcJiYxsnsfFarIIEB+YhYMDjEutAAhVyBWI8zfJvj4UBJI+o8MYx4FwjOU7wH13QglBAi3nliiDhvYHAMEXd05LKipVia45ooDu4e7silMMbAt9+85XyZcd6zXM6M0ROOE8vLmWmMVk0yGxX8cHdnbSqZ+XxhiGNNOQ6EENG8Eqsug7hi6ZbOk/JabaVVmiviSKWgUivniTFzPR7nBhMtd4kxTFCUIo7TyZGLTZJCBYoV8zFOAsELaO599nA4UUpgHI9c5mf+/oe/4uX5Az/88Lf8m+mO797esy4rSSKFwJKKsVmb6NYXAtQ+fDrz9PN77gPoK5+6d/n6GV1C2RZDPheES4/294PsywO6TyS0TSxkF+BeH7fdR5sg7zywfv0e+33u/71r3S9a/b7Cy1eD7z+37eYnbn7i5idufuLmJ67vG37ZT/zJgZrP3hh88kKvUpt2++w+7YbUPhdijNzd3dmgXBJPT088Pj/xfDnzhx/+lnc//8T7dz/x8cN7lnlGW0lfbylPQxwQZ6kRuray24k1Z+ZlIaVELqaObRWUtZbn1j6vvXoh9S2VPQOCppxuKGvHFWrZGXFYKlMvxx2I3lm6UwhMw2CiwLWMXivB3Zgzvgr1ugbARN8BFTCKZahsmlYlqqWO9BLiDfHdz+NFrn9e/Y+rv3eHmiWxgdGAmTa/d6ZRI25rn3R6EcacsRdfn40NuCIGsCGCSOjiuaaNU9/Aa0SXeu1Oz9tYNyKftPrqHe6Bl35aqf9RDDjyroNb/Zr15QrShY1bRautN9hffaKvrVfXa+yBJ6XTaNv9q7bnsxktAcim0qUikBI4hzrpyLe2YGZvrKS+K16huf1zjI2j2sGLDiaJ9VvvHSEGQowVeBQTsh4HjqcD02FkTQvhYlW+KG0MletUw8pC2mvl+BAqm8jakHOh1DLkzpmOUgiujuPKNguOECIxDHAULpcL8zxyvjxDBQ+9D90xlFKY54V1TQwx2jlcS63aOoCVNTR2mKUe2irGbdvYj/B1h9PAbAt8re+WqyRh609AFSasY0oxhh29a9Y+85lA/xWA5ipgqvW/V8CsXou71xvAxqe7oqI6lR50NLF0FVvhKwKo6XxpyQRXOI4Dy/nMy9Mz65p5ej5XarnjdDwQvGNZEk4Kx8OBEE1g3fnIMB0Jw8CHP/6R3333e2KIvDw/kdeVw3FgnCIxWC7/+cnAR8Eh3sDbGD1Bah9PVs1i8nAXPQ93E99++4Y390fupoHRO5wWvBpVN4hHAxwOIz5KFau3oLgUA4pzziiYXtThQBgHs8W1XGlKJvA4DIHj8ci6JKQ4oo9dLyJ6XwU1LRc/eBPzL6V0xukYB1JJBO/tvTjP8XRiWRYunPHek9YFUAJw8MJwGBkOI3/44x8A5TiOpGVhyYUYbOFiGkaOx5NVGlkTy+VcaeQDWpTD4UBKAdWIk4z3NYir8YMLAyWtZk4LBB8gBISWHmx9pWhmHC3GUHWIB62acCmZvws+VlFSscUbUZxm8rqQ1eKU4CIxFO7uHrjMz5zn97zMZy6XZ85PH/GHe96+ueOPPz9zXlcygmpGawW919UkrgLl7nL33mm3327ftk8ppY6jOrYac/XV2LdFj+u47loXJHc/o32/LX9/O8923Kb1V31fi11etfF60tAm/e3e9KsTd0FwKOXqw11sUifpn5t0dH21XTt+qST0n8t28xPc/MTNT9z8xM1P/GY/8c/OqPkcMPNL+9o/+oeATeSmw4G333yD956cCx8eH3l5euZ8fuHnH//A89Mj55dnQ93r/LRptLTJpKK1kku2VKcK0lyWuevZqAolF3LK5FSwuj9XqIbN4dU6Syk2kW5whpc2+Wv3IRvshml1RL9VYopOGLxnilb1KXiPFwGKiQTXf7uWNqVW8s57xxCjlSiu30fvetpTK7Pn2rEdiGmPWLZ2C1fpUXtNm/2qQ8v3a8dbmpF2AIK2XxUxFm+lAxsw5FzVPWnnqs9FVTr1tZS8ATxUtkqdmHeYQ6WO9c+MrJZ2ZiZy61BXXbDeRy8Tt3smV4Pc9TQiE7LTnVFog263uoP03Os9YmPO25xPKw3d8+HYGQ+ubFgHGKhskwb2WF+1ZyDZBHhFna3C1D4nojSBLZQqyswO+OktpjF4jNm0laoW2adhCeJNJynEgA9mTqxiWTCV+8G+c1XYWuv5tKYFNsCmATVFNvBwCKH2hVrZKWcUcywxpJrCBzGOZuhq6e0QPNNhJIaRcRy5XEZC9JayhuK9aQ2Vql10uVwoZaXkYhRaH8zpU7WmVE2oGfp1xAlx+G+CkPjf1PaJQ6IFy/RAgwbisjnG3d599aP7WRFaLnEDWZteFuXVMN6f7fXKDPSBXbsje3sh4vo46JpVSGXdVvBYpWsWZOoEoa3CuIyWhdPkmCKIZp6fn/jw+JF5XRHgMI1883CHkClrZpwGxsEqQjw/faSgHO/uePf+A4pjWVfSan3+dDwwDN4qQgBpToiKBbaqxqYcHBJj76sxeFxamTy8PY189/ae092RKUYCJgo/jiOurvQKtmgwxIAEs4laYEmJnLWmIgrjOJrWQAyoQNIEBHIBHwbGaQARUiq2+udGnDgu85kQleXygvPGxjQxvoITR3Q2sfGVFSpZmOcX4hCR4sjZqjFO04R3jnWe0ZRJ5xdYZ7wAq/Kvv/+GDx/f8/L4jrysHA4TJV1wBNYlsQYBHQg+cDodiIPpbKEmmJ5SwrlIHEac056aSbGJmQnrK4ivtjvWoK8g2bTsuk6cuKpHpqRs1Vu8M00CFbPZNvkBVwqSEqRk70ICiBKDiXB+880bPj6/Rd8ry7zw8vLE/ThBKQxD4GVda7qq1vbJV4PNFgC3OKCn4u4D7y8cKi2W+cy40xo3bWHbFkT38cXmS3qA3KpoVD+/rYL2M9EH/u7czWf2dZm6h6r1WdqEfneWT++ntcH2avFH25q4fGv/17b9/e4Bittm281P3PzEzU/c/MTNT/w6P/EvaqbRJq1xjIbKVq2VnAuPj8/M88LHDx/58OE9zx+fKKUQ/EjwWsVDC6UkQgiM48TpdOL5+YmcEuu6WqngWoI756rvInb+bKCeoeS6GfOWOmTbhho2kLFP0bWmQrWXK4L3QgjCEB2naWIcogmCTQOnaeA0Dkzj0LuBOKPcxVBFkJ0xGIoqQQy8spQm2a7vnIE4zm8AT0050VplqRTqs5SqSWPHhFArKvXJs+ud3TURYLSmKNULNiS0Vn/CecRbaovU8tHNqRrg4uvzMuS1gTwoFKp4s4K4iBO/pUtBeyG0cdGGxr6/NNjhGk6VqxHYjc3u/YBcH9OQpfbTDJa2oV4QaVWAdiyVBli9bldRVKu4taiBa026rjI3LAgp9fwNwdpVlpIKPZkKtYEyAK6KaBfdTIiT6lC3vnqVDeab1k6zYBXMKbo9l/3zEbXS9l4YnedOzHGt60wqVn2p7dvU4QcfIGrNHBXmZWFeIa2rASEKWUsPtIjZNKSC5246WV/CBNByXllT4fHxEbzp44QYQE2fZr6cySEBQhwid/EN67qS00rOyZg3fuDt8Qgq5JT4+OEDOa1oWXGjPVuELgimObEsCy9Pz/jKIrptn25XzrsG29rMA1yNhjaitk13P3TwVupRn7Izv+4It9VNscogbbVHta++bifUCmbWlZC9z2/DqLV3FxPYV5aSGKPy5u2Boy+k5cLj03seP74nZ6OzGws8s84J7yOHcSI4ByXjqyD8khaWxajZOVNF4z0xwjR4XLBV1rQaOBtDNGbZYKtxa7GgbxhMfDHNiYe7kd99/4ZvH+6I3j73TvAefAgEP+AqrX1wQi4rJaUayDsLrL1ppwUnjMNgjyXb5EDF/nZu4HA4EafRPlMhyECQES+O1c02+dFk/gTFB09F662iRgiIt3Ki4gqaVtY1U5bGTlRSWilifk+cI6LEMaIo83rBS+AQhHAcYQxWznUQcl4IfkLzzKIrbjowjMHeCxnxobIEBwu4xZh9ohlKqpUAqfYqUZxNUFxxvd0qHieOLAs5r1twW7uMq1UNfbHfpruQkFxp8ilRloWsgB/QkvFBKDkxTSNv37zh+fmFeV55/+4dx7t75vPK8/NKLhHFIaI4Gzi87uavR9tv2V6zbHU3Tn9Lmo/Fcm25a1v9tPHXPs3XLrkuskjtV7+69Z8BBX65fbKbhLfTfBq2f56qf72y+2sWJf8ct5ufuPmJm5+4+Ymvnoebn4B/BqDmc2lPv7Tfl25oM8AGGnjvKwtlYBpG7u8fKNmqAgUcqq2KizJfLqzLwrIoQxyIcbCV+nVlWRbWtJJytlSnKsLbJrstPaPNVUVqGcBwXZ7X6EzVebQ5c0UQhH3nrelOwZDsIWyVnobgGaKvAsJh439ITXsKmxhwr8gkNvhjCMYWcB0L6QPF1VLa0lWMe6MRcfgQ+uSzVYkS5yv7RfCuaXRsZbw7FKLXqvyNPeN9sMl1ZcK0G2nlt/vvHQAilN6+LmzbeDCVAWGrLW5zjNUjbt1Gd+fcVZii0fDay60Gqn53BUgI/Y6u+m07pq2oVHBjuwYVPKr9tR3Tv6T3Sc1qTr/u00rGixcDpURQXMVKGmBTQQy5RnFxrt8xVftIAdmXhu+iSfV43ZAaM4j1fio40+6lPa797xYkiTjEO+IwkLUwnY6Mz0/My2wrQEOsjBtHjKECloUhxAqwGXsmFytlL3ljpK2radW45Eg5E4aRGAdOd6dOc81rwuFMFyrlDpw5sb5jBCKtpdLN2SuWv7ymTErFKKloBwG38M+eQysZqFoqcwlKLiRWbtu1Q/vEwr9acWkuu/fEuvJ5nQpbx+3uqD52itZSrHK1ErOdj3481EJpu2u1zbXIZLdq26cDbXWm2e22avvqro0JxzaWHExT5P40MUnip6f3rPPCsqzknJmmiZRm5otHixBCQGnU8JHl4yPzshLCgLHGIt5XO+gdd6c7KAvLvLDWVdIhBo7TyOkw4bzycnmClBmn0YDTdOF0N3J3b6VUY/AEcYxxwAdB3CYaL+IhmU3IySpDFBTxgWk6EoepmuZCSsmEEoMjxhEfHAU4TEeOxzuSmvihPZaAZrMVh2lEJVcfAcu6dn21ko05VzQT1CNOkVIITkhpxYlnTZklLby8vHCYBmPxlcJxGnl6fEfKCSdQ1hXKwmFwDGG0srTeUUqpgvpiizFacM4mXq2cKlrwTnAumKDlGFnXGc1Sg1uw1U/pPTp407lCM6smS9lUbTrvW0EEVxd6tDFDwVUw3zvpHdbVFRSRwryeCcMIUqBk7k933N3dsSzPqCo5LZZ2EAo67zr8p6Nx+7R28cY4sKHwmRjsC0FnO9G2wqlXv68WP/bfX7Vju3Znampd4d1fu49p+91iwM/f2XZ9V/2wc+6KVn51ut0MZeexPwmc9wH1L23db9Zdi5av7f5ns938xM1P3PzEzU/sf9/8xK/zE18Faj55mP/I/X7N1uhQX/tc6rVMKNe0ZqbDgbdv3xJ8YBpGpjiiTfQ1rTx+/MjLyzNQGIbRJo2lkNLKmhZSNj2a/CqlJLf0jLLlmzXAw7lKk6pta9Vqtm2bvHegROrf3hG9pSZF76smjSHi/e9g1ZjqvNzSnmplKKmAh3OWChVCqCCO2ypK1QFyhW7KVke+vS3Lpwz4OOCHoZbnFqj5t64Kqto7rjozewSRNrEXqNTEBvS4JkBbJ+UI1fDsQBPZJsiboK4ZQrNQe1qpFT6rLTddm6ZutTtLb55aaljFJvY96qo/KVyxR7T2sc2QyNXgbDnRHYR5ZbD6pa6c9y7YaMfu2qQloyK4IiZIjPR29KWmFiRc0W/3Y88Ah55uVUXL0MZ82j+cXVvr/Wh9h/1edoZK971GG1UQo3jGQFQbh+M0MS4z4zAwjSPjNDDUUotWES0QgoGoIhYMpVopTcTU7nMu5GTV2kQg5UQExHvC4Dkd7xEV0myrEdDG5wbOlJzr9bSOFd8Nc8mZZU3kdCYOg2nSyLaClrOlN9Htzl6QTIyddwvAbdvl6O+Da7DRHGqOXX9+u27f+1Dt1yXb8zV2mq0OWb3WWlrRC1LTBVFFq7FrgteC1JLuQkbJFUuXeq1t5bVdfaO6WhqigcIFanWLbZg67yvQqDi1fPdcLChTCmgiugFXBrwvzPO5p/iF4DhMAUpG8KjLSDDh8SKOp5cL82zB9ThEcp4ZB4+WFR8ih2EiOmFNBV0SBwnEQ+B4OHA8jKCFdZkZvAWNfoiclzPDFPjm7QOn6Jh8YBSHc5EQPHESQjTA36vHqQWamQWV3JmY4zQRx4mUCyUpTgEyMTpiFJxPZIXD4UgIQkpz1Q/zZC04WfExIizokuy+8ayq4AcQCM50vxRBi1Vsk8pqpdiK6JJXVJTohfuj3bNIgSgUhKFEfFJCCFwuF0Q8IUQrpeo8cypE5xlECMBaCqSMGw7Wt0qh5BlNSy17OuE8XNYFyStSEh5LnS7J+l3WynrMimqilIW8nm3SVDKuWBA+hNEqRxZlyUrWZAshWtBivnKp1fp8NObsqJ41JYboKLrgEHJNcT0dTpynhVSUy3Jmuj/hntfq3z2qUChmC9tEEhtKFK3tUgiuxzXaBnAbD21RhM0XXuf2Yyfv89XOZ7A4qQfYOx+4D3zF02Yo2tiz9erWFhNhVXU1JmvfWQqrsU6p9mIzQD2Qp04wqq/SVz+9PbKL4+oV+ulexaJ9QUb2/uA69lUaC6N6TL2lPgE3P3HzEzc/cfMTNz+xa/2v9RP/zaU+fQL2yPZ5E5t1rq7Gh0IIkRAHxunAw5s3XM5n5vOZnEvVmSj857/6z/zd3/4N79/9bAZNPKUoTy9ncio9BWRJiZSsqlAInjWVyrYp9bpVH6YyWkxkuIkLmzBquX5fdpzsfqq8ineVqhisxPYwBIYhMA6BKUaGWBk1Yto2zotVfvImIOz99hOC7yLC/aXLDsSpbW6ivY2q1cSEfaXxNTCpgSsqVGZHJ3ICtVPuGBwmmlYHoAuVwmoAimml0FdEGsC0TfipVqH+u4rENR2TmhBLrtfYGwg7i+ud/arP9PQm+9x1UMVoch2w0GZo6vdfQELtCtL/hoabtMn8q8Z1o9T69DWQgtRjdmCQAX9ajXJC2Y7r5/CtwlYl3e2bW9tftFj5c6ky+UW2e2vP29eOWA1yfyTUd7c3yLo/fwXPoDKeFHxEvJVzvL9/w7okgg/kVFjX1VYQCmhRvLsAsCbLwbUfwZVMLsowDKw5k1JmPs+knClayGtiTU/M5xfOTx+5f3jD8XjizcNbprsHnA/46Fkui2k21edJdQY5J6vslhIprWjKuGJrbsvLi+nVFGPYgeKcMIxDBUBDB2FLBSJv27Z9WqoR9iDgXrR/T4Pd25TmQTfXJx0s37ZOoKWF7H2/fhrpY5Lajp1vvmqr7K9fT2uOVWpL9m19vWk1WzUAEaua0Rx+Wq1KxHy+4BS+/eYN43iEkolDZMmzaTd50xdYlqWyEM3eOvHEMDDG0fzBMJBSpqSCc47DdOTu7sgQA5BJa2Y8jBz9RMrKkjKHaeT+zZHjYWRyGFgaogV4YyQMgo9CEIfXSF4wHSiXkeBtlTBGxumAiCfns+kzeUfwAZFCLhlHFf5GuFzOeLfix1ir+AlFFPWKSk2ndUKuSm/Be0pO5HUGXK28uJh5kmofagBGsbKxuSSkGPhcUkYd5LySstmdVmElxgHBdAKG6YBPitNCVCWvK1IKThTNlq+vWq/pBKSgWUhSceuyVHvncQyUnJGahoqYXplKIeXCkrKdV60XadUsM50B87FatQicCOrEgmVVXGWuzvNsNPaiFOyZOx/JmpjGA8dDwrn3aEqktFA0M40Dz8u6i0F68HQ9K26jyLr5K8F6PgkqX+fkv14Fvfrs1eefbtUva1tFFppgrLTPgb22wDbG27hsE4T9dfdpA6aVt2/I1Uppm0jINUtj18LP3vcX7+j1Cuq1ybptdbv5CW5+4uYnbn7i+vRf2G5+Yr/9s1R9+i37fTVXS7Y/LEfNJukhRsaD0e2OpyOlZBShpMSyzHzz+BG0cDodePfTH0lrJqVEjJEQAstqqRWpVnTyTirCbYPCqii5WgZOt35NFRstZUtb4dqwa8XdGtInlU0TgmfsgIwh18F7grNS2tE7gjd1e++21CUnUitFtcpPVvmmKeWXUkwYTOq+9dlaxSVXgYGWvtQcFpgIcOnVdprz62lOztHYBVryJi5MBUtk947a6Ki4AOJMp2Y/cLtX1M1ZSv2ydloJcesbWg+qfws1D9VrH3SU0gcVFfBobdG+mqPwCnhq78n89c5ht/tVy0FlzyxCwLWBrH3lZn/GLQSpiHN71j3FacckqpHKbt3mqv9cgSXtmeyutX/09cXWqlsO2qNv1cjqoV1or55Xa/+0PGDt/btvYsbS7rnUNji2xoEPjnEaSenI3emOl+cn1nnmeJg4Ho6UoqxppWTTksm50j+rcLfzkSEEwlDbWOnATRC8ZFjnzPn5jOaCqDIuC76KGYsYkCkuVAHqyiRLFtR4FwChFBMLd1jetKitrIlY1baUEqqF5G21pQklqyprXjtl9bZtHLhtk6u/mk3/nF3XVx+pqxGBKCpqwpICXjd7a0GDbPaE6/HQAwc1Vf7WjqvgW7d9tzi6fWg27Zecp+6q5oGt5gVved9pWbicZ5bzzNuHB8aHby0wni/Mea0BGczryrquiMBhOjCvqzHLcHg/GF3cmT1P62L6asPA4TAiXljyglCIQ+AwjTamSmIaIoe7kfuHA1N0hFIIztcxvvkCEFJR1rSwXozG7n3AeY+EAZwnF3uOngABXLAUQgMsi+XIF0GTQi2LKt6ovD5EW92rbEFbEPAEVwNTzZS8VrDcIWWBtFAkk0rGiRBcIOcKuJZcKfBKrseBlXslRIYQSSlxmI54bww+q/ImjD4aWzSvtlIpgiMjuuC0rsSjeIxxl0tGU6IgNG2wog51deFGaqzixAB0ewxVnNDcj4iniLHvck3lDd60DEpRpNAnfkKhpNVWRAVUVubVpiqBocYCniFEclHuTw84d+ZwOrAsM+Mw4dzaiyA0P+tat25udmf3X4+//fj58uTz0/0/R/f+un0UoLF0d26oFyMQxDXNtra/+ZuWVrzzeNucuwfqn04avtSe13ZpH578YzeRX3oOfz7bzU/c/MTNT9z8xM1PfO7cX38Ovwqo+aXUpt+S8vS5xnzOeH722NfH0XQnAgNWnrqBIeIcl/MZ9+K5u38gxMDpdOTl6SOqF9PJGEZjmoCh0HlDK0tjdAg9lcd5V1Mxtg73CU1Trl+etIbLdn+uGqIQfP9ppbZ9RcuNLWOgTisX3FOuuiF7XZGpXqz+La9aYs+rgTWyHSM7aKCCOpa3V7hynBWM0AbEAK1kcf9+7+W0AQbS2TytD7gKaxZ2grdq/2lggjRQZGdMGmnOnncDR8xhd6BEASk74KSCeq0Jcq3vcpVSx3a/RQ0m0WJpMP1/O4Og0oxAtbhXZ97eQEs7Q6CIrcAY9rUDpho63DtNs6PaIoSrfrYZoC0fc7M/9dk3EM0BDdzaLtL/1O2S23NWezednFQFju1RF9QZtXffLueEMASGceRwPDLGgSEMDDEwjpFlNXBUpPUlpRMJa//y3sZDTrG/my2PVypYs9jz1kIq5uh9DIzjCCGa8Bq26iTe4YoiweOq0HIDYaVWiWjlP4vxoUmlVYMz8HbsQtqWl72Bs7fNf4VhdEVnrds1/XODJLcddg52b8K6eWkg5AZEt/Nep2RKNw2bS2azHb09tR163YavhQ+KbBXBpBACnKaJ++PE8TDxfPnIu58/8PHxiRCOlLRymRejNacVHwSylWRMJTMMAxI8qWTWlFB1TOORGCPL5YKWxBDg/u6O4/FgIvopUdT8U6jaS1A4HSaG0cqzHgbPOHiCwuQCUxxwIeCCx3kD/UuyvuyDt0qIgRqKmjikpNInPt45lBXFxOudeJbVAvfogpVw9Z7gbfXP1TGas7VOiiMSajWLaqOL+VTvIEhCJZHTSloXK2vrPOtayGppkEvOODX2nQk52nsPPiISAKveFoLr4zynRKyBeM6W2qhkBhdNyNEHUCEvC3Ea8UAqC1JL64bgKLkG1V0rjL6IoaLg6jPxwUQsi6Vni3d4LJ2zpFT11hTN9myKB4IJ/ad1ZU4FPx5MM08LWoQkmRDrJMWZnsL93T0pZw7DQF6Ukla8V1LJeyex84O7z/Y+f//tLlBtiwu/Fmh4HeRen4seaVdrT6PDX8d8NaGkO639b9mdd39dC9TbZLrFOldJx21Sob8MsG8+/vq4X7tZ0N3uqXB1e3/G281P3PzEzU/c/MTNT7Rjfr2f+G8u9em3bg3gGGKEw6EaNENB07rinefb777ncDiwLhf+8j/9n4gshBA53T3w/v3PrOvK5TwbgOA9MUYen1+sxJtviLBtIYRu6FMqVy90b+Rl949eRlsqA8YJUYQgVrrbVyDGeyvTPQymVXMN4FjqT/COEAJT1dVoIE2MlQWDdtSwaKkGcwfCyAbYOCed4dMYOmghrytFrCqV+A0Y0WIVeVxNNxLnEB8Q8VCKaaygm/6MrwwU52jT8fZ89swkLU1AWECzHeucGVMtoLW8elU/38isQFFDVBt41FDU3ullO3f/acDS1yfaUlk4mvuZgFa1yEAm1y+rpvaOboAG1Yg18KcCNeKliyPTxKdROjtFqc60P6wKgm2g0N5AFN0MRotZWlAjgDpzpghdXLiftxotrcCDsX12VD+lPzPxzvCvomhOmwKfowI62vt7GDzH+yNhnBDvyTnhnYlnj8PA4XhE/IIsK/NsY6+grOuCU62q+oE4bOyxVlWrZGVZF5Y11cpRCyFG/BC5P92RQySFSB4PhDjgNVSmnIlmh8PAcBwp2Zy8VYNKrMtKWB0pZdbFxMXtNW3GV3UP4NyAGtjGSdt0h/p9Qhu/OhBM+6kfydax9bMApchWqlLFgv+2Erv/3cDg9rcgHRw2UHBzqqXGAn3c7OIWAx8r8+3a63dwU7CKZm/u75hGRwyOx5dnfnz3nlyUcQjEceD9h48UzIecTgfSupDySl5X4uFoNGlMqNqE7TKqnrQu5CXx8PtvON0diMHXoevxEhgGj0PratnA/fEO7x3T5AlBcZoJVXDehwACJa0GelZ6eohW7c97z0q21brUGIpVaK+mBWu2SUeh2hat5VhFKCUTBo8T7aVJXfXFCqjY+CoIWgUdfUvJVYdrVSicIoP5lrRmimbE2Up01kJZM1AsFTh6y+50AS1UX6hGJnRNnNwqedDFxeuLFkHqREDERNFNu25hLZlhEnyMaGUBOrGV3xjHqjVn91TqOCheiMGBuqp312y34sVWh0uyCUcMwSrzeWFeZoL3ROdYsukWZEx3Yl1sBVWzCf1TCjF67k9HluXCGCNJ4JxN/6I6Gftd7f3V6ujrwbqfEO9XFq92++UA9IvBd5sY13HbWMiu+eb9+Ke5ua2xW5pJG6FS01oF1VzXagqoaZCVsk0y9tt+ov76fl5T3pv/+zUrrZ9ulV6/Wyi6bTc/cfMTNz9x8xM3P7G70q/2E/+sQM0/lgIqr/9lFvnqO3GOIKHPyRHleH+qSLTwr/71v+bDh3ecX16YL6lXmAFDXn1TNm+T6365jYWitQOl3Fg4bZfWFqmsHnsRxnqB6ITopAsCB29pTiYGXPVqhljLaJtYmduh/80BNR0Z7zegxgaZtcE1/RilVoHyGxagm8NsYI2rE1jvfUXOEwJ4tzEaSi6QCyJVzBibOIu3c5vGh01snWtluGvijhZQVymBmIZIp1RibJsmltvApgpgqBZLacoNAMKEdndYjDawQ7e8xPY+2jPplXvYUNa9GFTFR+o1m8GqKW9OLfXrSvR4AzEaMLYJDJtA7q577nsoe9qdtOpEV2XktlSg/tnOYdj+V+Zx96chxHZ8qR/VsdLee9mDMC3IUTPW1fl35ySw3Y1DvRhHUg0ALFrTh9SumatwsYiVej8+HEn6FkgcTk98/PiEuPc8ny8Uu6SV8s4GEqWc7d1LsuePaSgNd0Mff76COI3JtcwXcs4sLwvP5ck0n+JASRkfIz5EnA9oCCi1JGIplSYrbcTW/kfH8tpzKmpU5O3Zl9qfbgE4QLmyzLr11bp9JQS3592FsndGqp6r44TIBorWA1uVsi/5Fa1jmbIFXPtRBq/foPR4H660L6/3auOlnjOIEMWRlwUdIyWvvPvwgUsu3L99QypGV87LBfGR+7t7pmHgaZ7xBQMlgbImDmFgWRdKgaKprhCuHEfPOHl8AMiQYYqBcYiIWDpqETiMkcNkFQ2DF6ZotjI4Y5vlZPpX4gD1BGyhQNQWELwo0XkUJVea91CrtS1Z8eIQ9ZQlMetMHCyEWCotf/QCeSWvBR8HikIu2Fj0BhYv60Ksz818ScvTt/dlZU9HihaWNYP3OHtCiNMeyKWcGeNoVPngERcq2w2shK6tHIvYamopJlrunCNMI6CkUmzS4CJZLWfd7t1Wh9e04oB1fsGJMA6Cd5HgZdMaE0XLSl4TWpJVB1ELorfVQEWq3kAL9sU7ilrZWkFJy2yM2uAt3RML/kMUSi6saWYYR7wzsNh5ePNwhziHHwNnndEPT0DV8KuDZedtrvp995N8KcDcNNA+t2K4+bHPjI+670aPr2P1aseNTWuT2fZtta26tfzq763V9c+y+6xOPD4zqfhSGz+9J14bhuvvdufdp+vsAYDr7eYn4OYnbn7i5idufuLV+ODmJ3Z7fnqyun0VqPm1KU2fozLtG/mn3q5pjGATy5ZGIozT2Pf7/V/8BamsrGnl6fFiE/GaYtNKX2/UyI27cZUSsxMPttu7fk4dLKlYhAlebWya4GrqU0Wmfa3aFEMgeN+ZLpYmtRtAUkGfDtbYvlxN/DftGAOIDHTaBmNlu7SJeM1DdfV3Y+W0u+4rC7UssbSGVBDDlMNrVaHulOhATUUD7PuitGRLpZ1Hqh6U9vZQKYP1YdtPBXjaW+6vvCHRHYXav4ttkKru2tKuv2uv/Vtal7k63qooVYHlbe8KMsvOcGwHN1LdJ9snzdubxe1csqsy1S4pV4HN9fPeGztDQAxMUKiRhGwGuL5ibeeFDbKq/aQzoDqD6dU7q1WSepBT33+rqtAuE4fI4TCR7+8oKpQCL5eFYRxZs4mqWTWm1N9JzrYKgnjTTHKeEAM+tLEyMAwjTc1dxLEsM2W5dDHwJuDnS8GXTBxGc5ZacOq6sHDJmbKaBk5KycDXsjHlOlBTQUiQ3pf+GUzbv4jtOn/5lS2sY+7LnqSNUa3dX7ePaUPU/udETChb6RoFn6Ot7s/drNmn3/z66dPnfJhi/aLdX8mZvCpeBtZ14f3jR4qrNtJBXlfSPPP9797aCtc8U9ZEEIfzgdFHXuYXgnMUHJeyUEpiLRa8+SCEIBRdceoYfGRwjlDtT1FlCJ7TNDEOI0JhiIUh2DPw4u2OVfEoDocThxdvE6Cc7T5QhiF0HS0QnBTWnK0dzkM2inhaVwKg3rDbNJ/x0eOoqY1gJWfXjBfHMI5ozmjKplcASFscwGyNKoijUv8zOI8L0cQh80LWjKupjc7bqnnKxdIq8mqsT1GcF5RaDQ4buwWplUTMf4FQSiKTuy9wiok/Vj+ZUqKkzOCMzdqDQ+sBxqzTwrrONPZnWhdKY+i5geCDVd4rbQGiamiUQkZZk2ks5JzJ68ogB1QKOMiqeArB2/2nVJuOTTBiFHwwKv8wZ6Yxki5SK9+1dN9r7Q+txr+ntH6x49f/NJ/2SQD6KwdQ378lubbtNdit9BTmqwH6Oviun+0Mz+bfqfFNuT7zbsVz/+/P3Ve/7/3VXh239w+/HCffHAXc/MTNT9z8xM1P/PJ28xOfbv/iU58+t6kqKRtbxjlPjAMfPrxnvlz4X/6X/ydPHz/w0w8/cbm8MB0mjukOfvihgyIl5wpCWGcV8R0LyVWIOOdcX0Z7+LseI1alyVVF8gbURO962e0hBryPBB8JYWAaJ6bBqj95J/3aQMNF8OL6T8s3dd7AlRADTjYdFueE4BtIg02gybgYiDF2UESuFOSrYHGMBhKFaA6vGCXUND48zlURsca8aIO0pRTVh2WMoPpOqvG3tijFVaPgW+m1trOhyH3QNyEt6Dmb9a3Y30Vp2jANRJIOUNlmuIU9y04W6Z3lcz1oN9jbQNVSwQy3fSZ0vWIaRY+9mdgNzFf2o7/bSpdtui8A5PoMVIC861nS27tHwtu5VHUTv6sBjRn+etFXZdWv7ngH2mkuHahhcGxV46yilEKtPmXHGVhjDB6tz7rkTEoLUlaEgjhHHCOH48T9wx3H9yeKCrkIl9nSjHzONT9Z6wpLVTAS8HimaTTGWRjIydrnY+Thd9+S15X5fGa5zObYilKWlQEDPcu6mvJ97SNWBcpSnJZ5Ia2JNS018LD7KqWW987J3lhLD1M6C+22QamsLNn1RcG656ey3Ttn1vZrbnk/5NTO4upv62cVJEQrEWyr9LAfz20UOgWvznLgpZW73xynYtmU7cBOc27/rjbmi4sQtd1FCyqOw+FYKdHnqmvleHp+4ptvv+Px4wvDOPLNt2+Z54V5PrMuC3GIxBhqeqvZzGkYSGkleluJC0Pk7s2Jw3Eihrry6aP1a63ApMA4RKYxMnhLDyQrLjicC3jnySnVe7Z8aJXKusvGoAzBW3WMWqHCi0OLklcrBwuQnUMFXPAMbgIgrasFtqqkZCumUgoqK6pShSedCSUmC3KLitG5haoJ0GwILPNKKtlsRogozirBqU0cxhiQWEHh+saWy4IrxtRUMfshzoLxxk4spSASUFwv7+u9YCm2Ss7LVi5VqCC1FReIVc9O8YjzFKmikSVZ6kEDd0tmXc22aCmksvbqeDmbyGUuNl5UdwsGGDsRlKwZ1BNU0FrgYBhsUqM5sywXfLTAflXzStF77k4Hfv+9p/z4yMulkHKy2IV9n60/Dpt46XWcexVUy27yuluA2L7fxsbrSWpfRLj6vNmGbQGq5egL23pNc3havxepqdFVPLZV/0BaZci2CCF1UlHq6JVXV752969XS7ex/UtBdYslpC8WtPjDQkLZ3T8oXzvXn8928xM3P3HzEzc/sd9ufuLX+YlfZNT82pyz/b6/lkXzaxk7v3T8/np7xMzHwCC2qj+OE6rKZVk53t3z/e9+Bwg//vwj5/WCVKHgVmJb2/mllk1Wy0/7mj5F06FxFWixab3Ustw2YfQ1/9OYNBA8DEEYvBAdBDGn1dKeDPARA2i6yLClSnXWjbP8WxUTkXK1d2dVUzm3B0N/3KJb6khL/fAOvEdp4sSNmbNN1F1VlW9gSO3yQL3nYOWFXAV+VCHnAmLVfFr+4dWgLBui2Q2C1PPWL5rai0lBqQEC7Jxu6+hKF5Fr324ZRa2vCGi+Mny9Xe5a7K73q6ah069VDY8TwHIfVauwrp3Q7r9fdhvY9NWVOlZw1+Og3lhjNl0NpbIxjXpA0p+TDXgV06PRek6nspXR7qW1pZOW+r03gMv76tSr+VKMEuwUcAac1ed6Xba9sU8yuxdnomoqhAqcmbHLPNzfVwHg0bRgqkMqy4xqstzbrJScIAlLmrlc5lrNYGSIA94HQki4YJRbcZ5hmuz9FGWZF+Y5kbLC0VIMnVigYCW8leAEBo9ziqojaTOuwdpEgtzefTO4NaXsplED1L7QMNoC3U1r52V98VhHuRrIhj3WfqXWf9sQLiLgpYKiFoxBc9T1DG28CbYqVXRLk3RbAFJUyY76jrdt54P7dT9zx+YXqi0oYKVIh6FPHjyC10Lwnulw4g8/vOPu7QNLWXl8fk9ZrMIeIrjgUVHGcYCUGYZIXlccyjBG7h+OfPPmgWEIBKlpnNGRtOCxdFoHTONgefdkRArBOdAG1tuqoGpGvQVgQS0YDCESvDHWihayw2w4ZhJLLjiB4D0qGYaAZ6Aswny5sKwrLnimY8R5z7wsHchswv5LTsx5ZRgmnATU+Q72FxzLfGFdX4hV2NH8iKuaBdL1s8TXAFpz90HBeZBCTgtEE+/MWpBitHlHY30WSl7Nzkkwn56atkRCSkJzxqUagNkKi1V9dBEVb33QWbqBpgXyXKd1kXlZyalWpysC4jtoDSb+udalTmMRmn6brwLmPnhyFUcPqrhs/fdSlEWUaYiAklQpWRnHI2t+YZlnxuHAw2lC4pHLnEHPvJQVo8sbzXvvjwS7D82bDdNXQ1Xbfjs300OIbci+WqWUq3+3Uj+y+2lnUvXbviK0BZs+BHuKqX3d/ZJQP28/bueLFCVV3ZEWCG+U81J98N7Tt1huDwx8YeD3bR/GXIU0V6bOYgr5XMmUP8Pt5idufuLmJ25+wsbPzU/s9vpFP/FVoOZPnbb0mmb0a7Zft691mlbRicYWEEcuyununm+/W8m58HR+6mV9jcVXaN3AMAl7eaUUA3FegTR9/i70ikyuVwhiA2xEqnCv7+lOTWTYOxMVdiL4ati380o9ton/1spPO1Hd9ixtslon3e0LZysYeFe/q6BCS3PajySp+i1Orp6ziKBSwacO0tTvm8DWq+dMnRDbUKvnq9o5n+1Vcj1EX79LU6ytw+aVxxTdf1TPoVTNmOurdQOh2gc3vGrXZwfT7oOGQ3wGBe7/ataqWy29GtnSqwU0ZAY2it7+wF1EsNtfdu+rEXubsWx/N9S23bN2kIhu8z55NlI7YLWLWor9uwiWK/r6wUh/Fs1gtr9LqerzDQSqLLBhGDidCjhHUeH5eTLl+mzU2ZwLYIBPV+PPxmZzzrPEhWkYTWw4BuI0VgDRHBuAOkXnxc5bMi44NAwGcEpLX7SbFKFWYavq/9i/RbdxUEqq7KmmBeW6eOCf+yaAK22c2+oSu/7/RRYXcLXKSeu313Zg04srva83e7VDYj/ZmpBkT7aswbKC2bjtTJsz7Qf/wk2rYirjDo9DcqKkmWm45/xxZl1mEHjz9g3BB5Z15XA88vj4xDwvuGK58sM4MYwTyzzjxTFOAw0ILikxhCOncWIKEU0JrcLzojWfPwYTW/SOMUYL/H2tCthtHb0ah/VvexY4RcUxhmifSV2UePW+zCTUACZlY9wp1p6cid4WH9K84AjmyzDm53yZ8dHE7xWg6h64Yu/tsiRSrhXcKIh4fAg477oIvWk8KkOMeOewMVsDtvbenEAwsUacs8URsXKxTi2YLPWN73PF2/21SaOqrfxbPyyUAk5tYmKxokewin3ruqLrSvBC0kJOqwlr1gmDc64LIm4Tu2obayBpoLHZExOArDbJHLWx+Zyt5GopOG8r2Catp4zjyKLZNLQmzzSMxtYNnhAKy/KFahKf+Uxe+YqvOMI+Rr6eUvJrt8/5/msa/ufaqq+Oq269Lxx+9jKb+9smEzW++3X09F/YdouV/xxp//+StpufuPmJm5+4+Ymbn+A3+4nfzN3/HIvln3P70nWvgQWjzBkYYpOvnBIpJWKM/P4v/g1v3n5LjCM/vvsZHyIhRNJi6VIFzACIUaRKUkoupHWt+hmfdrZ2rQZ+NETPuY1p48X0NrzzBB+7oWzsGOcsZcq3Kje1E7qalgQN2NlQes1KVqUJrzpfPU6lWxl41HRoqChv6arughllrxigUwXVCoWSSlXNbmQT20kq8KCaKwpsx7oGxjSkqYFMUhk7bWKrateBDkJVpMuO34MF9bKOXdqO8okSePuuMYFsgFXS6auB1dkqFXAzcMoqV+3zM0V3yUyylSHXqzFgjfTirj15LYW9w2Z2qzjN8V/fw4bOWZ6wqKKlt+AKc7J2eoQdu6g+st43+v1zZXgaCqNFaIWmqr23dy3G0CrVWbR3Kw60Ukb7c6tGTYtWANMEzNJqgIvzwYR8FWII3J1OjNPEuw+PhKcXEGG+PNjbUmFea86x2GqPUMGfDEtOvV0fqGr9wfPNt98yjpZzrWHYdJe8Z1lm0moU4nEcGYaBcRxNVK/UMoi1a06HgUZ5ttWRUO+zMJ9fjHFX+8he5PvPfQuVcmdA81bxTHf/+9Im9OGw+3Ab+7nandZvlRpQN/D4C+dtp8yODsg1MHgXMvyGu3zdRME7CzajcxyHwGkMHEfPHz78hJbE/d0dD999z8/vnwk1Te5yueCcx0tExBP8QM5Gq/bOMY4TP//4I2ghLStRHIMLkCwvfRwHQq0a530gimNNM95FBhGcKk5qWqJWvac6CbI+61jXBXGF4gR1vguAe9/e3RaEedm0y0pNKXRVxy2n1IXhpRRyXlk1MU0jUpSAcHx4w5pWSlHWZUbIFPEk8dhSXaHkRAxWlYPgapU6sPxxWzE1AUuz0aWlHTdttBZM15VX772tiFb2n0Vltvpqab4eY56a1pxVncs9yJXaxzRb3xXvoVY0FC344iklk5aELivFwSJWyjWX3OYS5GK2w1YlTXTfteA5l0pmVVBj3ZZiVRoR3/2WaXSZtkUSxasDB3EcyMVWDg/HIz9++EAMA+PpxBAcZV3JpXSf9Vv6NfXaV1HqF7bmWzf/u5s4/+Is9te353OTJt1XMNw3VK995Rca3v1tYyX3yUf5xwXi+0vfAJttu/mJm5+4+Ymbn9gfDzc/YZf5up/471Zkoa1255xZlgVFCTFwPB3RUggh8Obbb7i/u+PucMfD3QPzaiyblDIpJ6sMkzLLvNZJmtI5Wg1EcVsVpv2jbzIrJiJsFZ6GaHmmIXhCEKMShtCZNNE7xugJlQXTQBoRwWHMm6b5sgeMRAWJ1SiqgStODDFvVZ2cbxo0UlO5Su/UUo21wcKWrtRABSOOGqAgXjoQ1Xq5GSXpzq1C1LZ/hyaN1iet0zd/CH2kCBtQY6hBM4NUAMp1ZNRR009qJo/sQJJuDH7D+OnP4ApKbX93btT+gN0At89bUlIzDF13R7b9VKVW3HK7Y+3HDGVFy8qmhyO7JskuUtHqVNrT6xWd7NstYGk5sRWAaKlrpShKgWJ9zMSBK3DVzl8yOa12XifEcdraLS1lq/UNb+l6xRx58VZSvr9f7yniyJpZV2PLDGPg/uHE5bKw5sSyJoZh6JRWAyZdR7GbrvSaUs3TNW2756cz82XBe880HYjDwDCOxBBoB83LQi5nLvOF4RJouKPWFQ3nHTEaoJSzsi4L4pY+tsW5ntrW3tUt/Lat8QcdgpQtZU5UKF1pf9uucvn3Y65+Yr+ac7SVssbm0v5dsxFt90/TdIsYDb7IZk+3Nlxftn+j279fp7deBwBK8IHBO4IWDtFxmiIlLThR/uIvfk98euHx5cK8XHh4uOfl5ULOhWEckeLxfiAX7QsARYyevaZEiAPzPBPE4VXQJTGGgKcG0losnVAL0XumGAnOEatmWdNUUFVSKpVJVu2mtkUDG19rTpQi+FDZb8UWHprWW/NzYLTivC5khcH5agtLTRvOII40r4SoJCeklFjW1YJLL6guBBcwDQCp48/sS0s5aM/die9pvb4mMJgdqyvmqjWHXatJ2gnjF0fRZDay1OocTs331VRQEWdaVblRv6stV8U5C36pDFrXrqsmwFjW1aogVjq9Ab/m41qRgZLs2OC9aRG0cbHr31ptUNJi9rjqzJWSSasiLuPGCS3Z6PJ486MK4zjw8emZYYqghXW+4OJMSavpbWl9PzWp354d14sgn+nfe6az7oejUv19d+GfBN5d10N1P4/+NAit8YXIp999bTHu+jthy/1vHf7aV4tYigNUv0ztJ1qu9rm6tnx6P5+7zy+29QbMfHa7+Ymbn7j5iZufaP3t5id+vZ/4zUDN1cvZXei/rVWDT1N3LA/SdcRaUWPNYJ3Le09QBbIxCZLlXOZsFWGaunk/bQc59gie1jmzDeVGLGlATQwNpDER4FAns64yaGw/t5vGb5NvEdhqwhtQY/mL2/1eoYpuQ/96f5St3comXbRNPBvAUEGFCn6obE62AwG7PEG79z3YId3A7EZgrfq0Bz+qsdOtXYa8bA6y3nF/5u1mWlWkZgTs2G2C39r9S/1k/y7bM9+YMkID5NrWQQyuB24zSZuobhvgDYi5Pkf//BNESSryX6/N7v3pDh7QzViwO3c7irYy1N7//mE042g3YwZG67238+ziG+sX9YnUd9WBuLZf+0wsbagEG2s+BHyyPOOtP269yQnEwTOOkWkcGGI0IXAtlOz78zenKCb+JrLto7bakZIxeVRNiE1VGaOxa3yIuJRRqjNOeVOy1x1oRdpAKwWtubut/9t4c9Xo6+4d/3lvTnz3yK1vb6LWGwC437pTM2STZte2cdf6cH03ao7T+q6BuUWr4pK8HkP1Gu1sO5H1vgK0C7Rf/2Xtuz7XayetCkvKpHnhGIS77x84HQ9cnt/ZKlbVahInnI4nfvr573h5PjNUfQLnjP2oYv0VFB8CL+cX8EI8jDy+f7FVvAqg+2qnS84WsHrHuq5E3/LjDdCWqmNGFUdM69zbva4rtirr68opFqQ5WPJqCwIStudUVya9893euOApKZFKIq2L+a7oCVV03wLIUkuD+v42c854TATRWJNWYtQ5UCd1zLf3JeRlJZEIPraFRkoxDQG0+VmrLOK8pVGWZKVZXU9RNhFPE2ak282cU//eeUBdlfAy4DpGK1NL87Xe2UKNAjlXlqGrkwbBSqxaP/I+oLngg2ddV9Ja77emAyNNV87sSqYt+njWkk0QQTwpFzRlQhVuR+tEEuVyeeZ+GBjHgWVdGWLkkhbyeuEwBoJzpOJo0gIG1rdhpXXitHmifd/e9/fWP9rsQSsTtr3TJoa/jQvtE6hekOEz/rL7911Au48pP+9jr8eiq33SfpojqjGa7jRN2v1S4762+v/qnl/HsK+vvbXVnsX+8/3E40vt/XPfbn7i5idufuLmJ25+4rf7iX8Uo+Y1avQPOfYfc9zngKLtJTpUjXUSY+x6Na6m5uSSWdaFZVlYlwXLewSpdLpUy6Yt67ql9+wMFtRUH9kh6rJ1TAN+DXyJwTMMgXEcGKKV4A51Ihta+WHnCd6ZsFcpGyzS05jMuKKgWUmlVIVvb7RDaalWG4smhFAn2zXfUetk02/sn/YE+6S8Aici1cCpbm2pA7EJSwliZavbe2naNOK6M94DEb2iTkuPglq6sJ5NfH+2UrOEmziwCYRt6Ue9OVUBzg4zx2zjo4ILr7pZ7zNag4N2sivZqF2/lj0FVncPrBmg7T60qbqX1M/jWlpXPW0PUOgP3AxDydt19w3uxm9rQ2PIlN7nuTJmNepAqMJjSaHUVQLVLbpoRrnsgBtqP6+G1dWVBu37t8bYQ5f+fLZnZrRR+yyVTEGJdawFHxiCcsaqS+U1EYLjcBgo5cDTyzO5JANIWp502QKwgMAQWeeZlBJzWiyQUSWtNqbjPLOMM+7NG7wLjMNQi4OZWNt+C953AbolLxwOJ4YxAJ7L86P12ZpX38Am53ytBnV9rj/XrTl2hU2Q8Vead7O3FoxY39yx1aqttfM1sHPTJhDZ9eXPnXvXjD4h0Pq3vhpWnzm2fMVHqQprBl/g7uENd/dG3X4+n1lS5sPHj2RxlJJ5fn7mw4cPjMOBYRgJtf+olNqPVsZxxHlYl4SPHj8OuCHy7sN7vn1zTxwHLvPM4TCSUmKcIoXCmldiGMFLt0WIUbfboNZaWr60SU9RNCuNP7euK8MYMPq2aTPlnE1TyvtuM733ZFFSybhQU0WzkDRXINUZcw4oOde8f93Pdyhs1Vc8Rt8u2MqiFEXzioivK5rmr70DUqn7GRBetNSgPpFTsudXRRlzXsk1TVIdFAcqgq/CjKUU1rp6OwwGBpu7qCu3wVFEWNIKBbwIuq6UXEBdlc9Sss0CrKpgxpbmcQQfSGk1X8o2cbF3Uarem7PzVQDYOW9AclotQJe2Om0VVVrV3JxWBE8RTy6ZIUaTD0sLzllxgrvjkXGInNeqf5C1xwcKu9VPuRo/n1/N/HRgfJKCsv+6j9PPuK5PR9GVz3kddH8tmN1WLzeft/9sW2zZ7q3Zka/ZjH6ur7b8Ovhuv3vb7IJX39+2m5+4+Ymbn7j5ie2cNz/Br/YT/92mPqHaNVOcuFq1xvI1c0mUnHl5euL56Ynn52deXl6Y15WUC+tq6U5N3MkH30+7f+A2gdXeB3zVgQlNJFgMwfYhVHGrniCD4Ig1HWoaBg7HgSEYspgqW6bRCF1FUX0IiBoY0YWSG3pt9aUAy7V17X6d7+1zUveqQqhSnVspBbJYrmYVthKpKTF2EVutKJsatuZd6lf04LRiHWUHFNQVk4a624MDNYEzoLKJvOV3VlDDVka0CmY1ceLakgqGGbihoBkJleVA6cynPTraLttOkkvZAoX2qW6gS4ceGuz/egyV3cCudEHUBNSowBYdibV33XPh+iDVHViz9VkLZkx/Ba1Ic673JO2C7YCazoajYNc2XC9Q1Bgnrt58y6xih+h2hLgUSi0D3u+rHSd1pavtX3NzqVWSSrH+mrJROrWCHjmXuhqREYEhDixxZlkW5ssLy3yhpAQKabF8XR8CDw/3vV/mlJCVzZixGbrpeKSUQlxXwwWLBQ+5JHIuvLxcAGUYR4Y42soEgqpVTlCxFbc4TUixMbDMs62+iTAdBg6H78g5sS4LSksn9MRhMM2qnLhtO4du8fN1IP6Z7YoeKtJBR9288bazg8bP1jaeZXfRX3DxogrI1p4WfNvHfdXnk3tCNk3tzzhsE/mLhGjB48/v3nF/sGpr4+Fo/RN4mZ/4+PEjqsrp7sQQJ0SVdb2QdbXSqbkQx0BaFnywMSfBc/dwx8d37zhfzkwxoJoIxVetMQsQ15xw4UBBa6lSQXLGeY9WTaUG0GpdkW46abZa2XSlVsCZECOVSl5TEEMIoFiaroO0zohiQWZjeQoUJ+SWalkULwKuCtzX881LIoRADBHnI7kFYaWYjkGpfludLRioUiSBCllKfWe2eltyqnapWLW5IpCrSHjOm/ZZpbZaMGz+0XyXTTSUjBQQF2xi0VZta4lYA8GNqi7qTVdAoVT5hFSUdcmsy2qLI8akt5SOrJQiCDXVGKkU+0xKGcERBl/TPbUuKkUUT1mVXEze0ok3fQLN5FXx0bEsC5lEUkuvSDmTlpWH+zd8+803PM3vWda9L7PfpQLu0p7Nbuy9Dhj11RC7Yni+Hmu7IPrXbBsTVz7z+devcbXH1WR6P+1+ffAWO+z3uIrp6iSpaZF9vt3XbWzHSY1t9oftV47/3Lebn7j5iZufuPmJm5/47X7inwWo+dyNfOkhf+mmv0Zt+tq5DJxwNCJWBxdqTqOxamZSWo1+lgoplV6r3tW31qfGVUNFxAR3W6pMn9M3lFN2qVHWmi5qZJ1/Y794Z/o03snVZLQ7DLZzt0Hcn2P/3TyL0OrWW3pUK7W9Ax7aNeqZSmVN9ApRDfVrHVu1TsxrUk0Fh4x5IR2EkKqvQp0EG7y7tbQ/iWqg7V73o7saCbX7uQIL2j1eATBy3QcaKFS/3ZK76pATUH2VbNT6lW4gmv3fntV2Br12+vU50cC6pizfn99eiPh139UNd+kP2a7dn+9+uUjaIbtnpVqv0Y5ztV/tTVHrlP1F7g6/Phel7IpONSOm9d3ajVmKVEvv2h6b5ozWlYkOyhUDT9pPezZ1XWwT881qoKRXvBr7LUbTbuoMttb0+hqbALUZPhNWK9VRkU2BvygmSsxKyRBi6GO5VBBQxRg4XjyiEGLEBwtMSs4GsOLRGMwRVoclIoivonW3DVd2Q6N1t8oKdHUlFGHL/ZXa89s4Fwvg1LXvamoZFpxTdYqcFqN1K0BGym5c6fVoNzth4+Fz1F07Q2E3yvqY66uqXTzcYjsRdtJTlsNeRPjp/XuWUXg4/Z5xmIhh5O3DA0suPL6spJS5u7vncDzhnOf8/EzOShwCKSecCq5YUJ8qu+0AhGHk2Tl++vCRu9MJ7zxrUo6HgZIKy7ziMSq2KqRcLGce02Tq5t7bim2pQaMXJdXSlM5vK4VSK3A478jF7OFSMnnNxBgBYV5mcim4EKooo0cIfSJRFKIPiLfV0rRmo30HK/8qUsXyUbSs1crYe/XeI76g2ajpFHCYBlrRQvZAbS9atQnE7EtZVrJYsO+dR3y01VRpNtUkJwuQBdRZRRRNqQb93lyXE8R7UipWIMA7S5XMxcTlSyGtZhscQiqgpa6WqpJSRkW7CL+SEafV91jHMu0Fs905ZVJabbEhWBpoKclsuTrIQgr1TGm1fo9DnWN5foEw8rIshCEY8TBnBoXff/89KUf+9o8/sazJqPrOVzvZPE0NHqED91crfld+qA32VwE71zFYi6+sxZufs+QD+r7m+xslvWyDjhbnOEthbRO0eqKuISKQMH8iUv0SYKmqQlswaqzY1oY24m2RbRdv0dimAK4XmNwc12avzD3KJiapNtmyXfsToVmw22bbzU/c/MTNT/zp/URKK6LJ7OsX/ES5+Yl/UX7iTwLU/FPTPX/pfK+/N8Pjdn1nNzkXY5kY6mu5m5dlrilQiZxNlXub5Lbpdn1hbRLeAQStxl/rJLIyYIQu6tuoY1pMqNe7qsbuDJzxKEPweAG01NQRqalVSoP5G/DUHUMfNNTzbx2l5X7aZJMdYFPFenG9o1hftU5sBtJXdkljDYGvBkShD1Lxpj0iflPCRrNdwwHirh1c+10n/PUmXu1Rt8L2/J1sg1l2A9gJ4KvDbeDBjrpWB2rfVOpcX5pVgA7i1RSX9l4ruFWfEP0v3T5oA/YKoGh9BNevv93hZtCkASG7+7fS0lUz5er5tPdqrbfn1w6TanA8IgYuajGn1ZhIwvb86IftDKmCSq7PegP2mvFqwE0DaKTWsuzGsRS0VgSgAXxaxdJK6VpPWozmGrxDqJ+njA8DQYym6f1MiJE4DDvWVwV8Gri4A9C8c0zjSFE1keIlV/1gQbMyp4VZFsZpIIZoqU5aqkBxYVkWYgjEGDkdDpV5A8s8d8DVe09RS8cq5VPhvD/3rZG1Sh1T1mUreG0usv5uKwZtYGnvMs3Kmilr48woye2czflt40i7ZtGVD+grKdoMTg3AtrFfh2q16lS7QBU8bw61ftp8a2u61gVcaltQTnd3fPf9t0S3sl6e+ObNGz48nfuE4Xg8VhuZq9aAPZOSjKFm+emOZVkNVHTCYTzBd9/y/t073tzf8fb+Hl8gJ2W+XEjrwv3xaH4lKask8znFdcAxhlCrnxVSthz4XNa6WBHBgcPjanU3zYVEwvsAzhFwlGgBqogJYjosgGkrjhRja3pXS+6KVf5IS6JIIU6D2Q4njMNgOgZkKxvrva2opox41ytzaFECroqJJ1QK4oNN0hCc+AoQGzCrJVOCYwijrVZqRtQmHgIEMTBXmz8pUJKtzHpxBB/JCCKV9t76ror5MWn+RhFXcGJBdy3ZgXOBYagputX/q5owJuJI1f8LDlG7nouBRCJjiyV5XfGhlplVEG3CnhY3lLziNONcgDWRVYljxKkjp8JaMkVX5PxCWgMPxyMv9zM/ffxIrhMwG28tBvjlbb+OojXOKC24rPbxSzn7bTGmjaE+tmnt2AfvVStAa2zSmJxtHLdBeNVsba6xXkWrDdL+tYh0+9SHryp79cu9q9Xuw9sEooldtrNYuwTMNunWKGPS7trVjviNFVX+e91ufuLmJ25+4k/vJ3Jaqp9QVFeyGhNLipg8QEkmg3F+IS3mJ57vZ376+MEWT8tmB1v/+6Xt5if+tH7iX0Tq05ZT9ts2ebXiLXUQLcuF5+cn/vDHP/Dh8QPn85lUcqfjSZ/EN8OPDVgtpNTocGwTyQ6g2LFeTE/G8iZNdyYETwyRcQgM0fRqDsPIFD1TtH2cKFp1ZNoL9NWw+ZrCZSCOq0yc/W+3PaPqnKTr1TQWUWMomADrHmhwmFCYHU/v7O283of9PB8f60Ta1TzROontg7rU/3Sg6uq0W3v9rsRc30n7cY0FJO46uNSq8t+P6VeuwEJj+tTGaPei2nNxewmt5q5LZamI4vwr2lw796vN0qCdGe7i6KOZfXtbG3XrUGB00LZ/zYm1bdM+sXaXayMnLYLYl+ZukQr0pRPVKnpmyHop6xUu9hrltia21LWqPeSqQSwGPGobHEoNrYzKKpWyqhWcoQrfmTGz8GtdF86XmafnM5clMy8r87JwXhNFHFYVy/p4jJHD4VjHJKxpNi0pEXKIHO/ucN5TMszrheA9d/dHpjSwLIllWa2KE0ZhnZeZkguzSK9iIE4I4kjLynJZeHp85ng6MgyRcRzIKW14Yb2bDoB634XJ/9w3dcJuoQDqipVi9NmMCbO1fRpVfE/0bCPlqiqZiC3DivQKBlfXZXPiDVV9TXftiYLSwo7dUKzHt2u3qnSiux3lk8v2M8cQQFdiFL77/g33D0fK8sjjh2eGIVLKE957jocDBN+FCQVLwRWkV80QoefExyH24GGaJh4Rnh6fOE2T5ZSfz5Sy4Kue2poTPtvzdgJjHNBU8L7qnYlYXv+y2gpeBbp1tQoRErwBnWVlcAFXICcr2Rl8wKlVcnNiovzZQVoTS0oEF+pEytib6mHVlZISSiYExzh4cvNJAooJ9OeUSLmmB/vAMhdCXZH1vlaHkUIqC9RKHBb8OEvpdS1QBoKnON+f57oavdz7lg5cqmuQ6p8t2Nbs8IKBHwh463/B2+pvTT7e+qjDVonFdO5MuNxsaVE7p3O2YtlSQLXaTa0x3LyurFn7gka71pqpq4MtNaCuFBZHkeZbjUWQSmZZM6uemYuSyKyaGY4nYvB8eLowz1W7IXjykj/bkb9EZe9bBfS3QcKXBsRv3tqp24m7W1O1yfrra+3dJRCKxehtF5VtkH/ubq5o6O6LA5ttMlCj+y5AaQ0qonTGL+xWaX/b/f+5bTc/cfMTNz/xz+En7AS/5CeCd1zmM5eZbUGypaS9AkiaXd77iSs85OYn/qR+4r/aTONrwMuXUpp+Mah4dYzIp/uKCMuy8P9n71+7JEmSK0HsiqiquXtkZlV1owHM7OwuyV3uOTyH3/j/fwh5DneGO88F0KhHVmaEm6mqCD9cUTVzj8isrOoGBo0M646KDHd7qqnK44rIlcfHJ3z8+IRtrWi973NMdj94uK8W9Yxszz3SmLgYUqRhxjonRhBpdSlY1VOmU1fK/kMiYUXOiqVkpDkhBjgRgMbgkzmCQspFNYAanRMvsl/C2R2ZORPwcARBq0S7bD7fETH10QFntNxWnRkzw2OdJSnj99BwQKQ4xmbOkilEFhIiw2aeiz9c8L7PYB8gQsyDuEeR42fjmKOwwPh03isfceSveHCoMGKgrvtLn2c9/Mtvkd6biXU7q+a9jTnDDKXDbY0Z5eP7/aPj936YeePom1VwmCPmDTKyXAKUPO7rER6SeJb5HH77ODcnjzkyxTBzNYGDYTPufTyzJkFyXt8GfbzsJYaDgDeXE8rSsZwaLpdOkC8ltI+PqK2jjcybUAhlWXCqZ7gDW22T9Le1huv1ipQLSjlBU4YBuK4VpShO5wXLsoSA35Hw3o3tFzvHOIkgFXaDG+TA5KQJAX8ouSMpNJ+ZoKS8kgnHZgMPjUnFNHQJrDBIrw9y+X6Gv7SNjC+NiEZ35gDeL8ORKnuMqXxScUtEcw0z4jZ2lDjhMMIx9O7hHHK8eWcqrXW2hb9cMrb6AUuKFFsQDF+vTzidCtLpAdvasLZOwLMbHJTTvTNiuK4rZptO61jXK+q24ttvvwEE2LYNP1tHyQKRDpGMHiWbZoYOR7cE6zb5CcQBNEORhC4JYiHb/dDtotMpMDPY0jk+Tn3XowTRtGE5nQB3tHUjP1MzmDKTLqcEeIdngSQasAkZ3tmmdeiMFob6GFNyHuSIbgKtOjNLlUaSWYMkh4uh9RWUfQkpF0zuspSQNEdbVz8Ym5EuPTalUW/Cc6ekQNLQ4QpG6GTq0CkP1Xeq+XAue6MT0VrldDBh2r87Wt12wv3IYrUoax4d55yXA1TRekPWhOVU0D2h9hFNTxFzoRzWSAHv5nB1bK1FhFxQW0WHIeUF57Lg3UXx+PQzrtdHtPZlXFr3dteNET7XgGDP7nx5e+m7TwXb5keyB8hmxuxca7t2xL77oM2gejrc4zSef8Wz7vOFRrdMPsGbo6hPxGAHv2TKiU84J3/uDPO/1O1VT7zqiVc98c+gJ8D26r9ZT7wox4acPMiz8Ale9cQ/vZ74VUDNp0708sDePuCvuamX9jme59dk2OzgDjAc3Ot1xYcPH/H0uKLWHo4bJuGqyN5izQH0zkVtgWjrcJ4tslbEoTLABLD1diZQMtpyM4smYykFS8ls1Z2iI1TJe2pYPOYomRqObpoZJYJRv5lSEIZh4hIAHJpIPJxz3pXiYfzMDGiNOR8iNyCQmUGCqEtSwszsBP+eaWxCCMF9rBIBZmlVOPaHblhIGYDOxDAJ4i4ciIIH8/sR+IHfzel4j3tpoB8W8Z3GvJsDTJXsLNOJ8qZZJ+mOmZUyNfbxNLILoHHe+fUBHAo0ekdZx06j3Ev2c46/46w2uhxhCG/BSy0reQ4qUR4rNzQ0IkHw5uM+fY7TXgZ1MD4i4gI/vk9eR9guaSpkzHKkg1AWZUkwov4YDnWNloopiLALzuc3GATEEMVy2rCsG2qrcCNp72DhFxHkXHA6n+EiWNeNCi9Iiz8+fkQpTF/NpaDWho+PT/jm2wecTwtOywnbSuI7gBlv123FViuVoAGuAk0ZZeGsrLUyelMrAaGUAXDtl5wn6OoRGXolieRm0V2PM0e4jKJ2XWWyEnGeDkBaQPkZBw7Z6WEg7onmnNhpmMsHJ3KAtyNuMbOfPBLpRSBRCoqDaJjt5GOdujsz9owZaoqx/0Gpx93QruX6c+tQAXIWnBZFYk442rbh8eMH1HXF44cP+J//p/8Jj1vHjz/+jK2uaNcNioxTXkj0F+Tx27ZxPkcpnrUO6x1/9fvf4frxY5T3NfI6JWOWZikAGC0VSehmaK1CU4GJwMTCIQDOucB8kH7Tcmm1YmtPeHh4CNJElv3WrUaXwYTTsjD6uF2hmqa8ySmz1r0ULGVh5FCBtNAYF6MuQm9B/Aj41K18G8tywlhjogUpMWghTqYA1yCwD8JHDSutdXJTIcp06czo5GUr5QwRwCJ7MpeM7iEyh/0QafZIAhdFCk4AP0QVh1FmGP9mtqKoQHNCAaPGHYLWDCrOcgBJ6G1DygUuhzJJZ8bmmFTmHZoVHT2WDFPlHYBZxdYcKmdGkHuHIKG3ig62tHUw03Z7+oicE7w3iHU8XE6A/Yhat52rbqyXg0L9lI015vvRyZ36Yth25nNtvGTv/ZINONf35EAbOo//TsO5FgSx5VEz4SAhwmmOqNEMXI13tt8Q3x1Gic3ze537ybDjb+3M4fT5QSbMbIs7k/RzTsrXuL3qiVc98aon/nn0BH6DnhjEuPQJ7/TE9Fuey7ShJw6ODY951RN/Nj3xrzJ3/+iYSziSwBh/x/v3P+On9++DsJS1feyUxNdqUeYB0E/WmLjqI0VslGekAGiINDO7hQ5qKYVosQhyUqQkyFlQogV3UsFSEk45Y0mZkzARDOHGt5ySkgdGx6QylmFZhyrgrvsiiUkkg/BUcKOgqHeGEBuDFYvwMLt7EC2N9MAR7RDfyZUlyJZJxHXkvwnEkQWhQAeVW0qRlsoL9UFAnIDkB+Dl5kUeHmv8jNGJRTJBkXjBcthv8JDAOpHUAwjhQLQGP4AnMjJ/9sX87GZennAxcP32iEBOJAQc38F9vGfsO+7ttu3zBNHGPcTK9zCgpylyAKmGQBrPsQuhPUNoCq1xnXHktFKGaPN4B1FrG8CNFL4/Bwh+gYBfOZ0hrUHVoKnALSHnBSkV1tuKoLUNW72iu2LxhJwJaGZVLDmROC3GJJeMi0qkpArWlWCLQtDbhh9+/Ec8PDwg54KHhzd4elzRqqGdDA9vLlDNECSU5YRTtGhsraO1ht47np6us4xxOS04nU58lc0ikYgZaOtWAWzHIXvdYht8U0Nha8gTGsEaigwHQ9bnnBTgUN+8K8UxT/cJeViPjhkZIUBJ4JixR37PjDkPXqNha/vOPwDsxjluL3Fc6YPAcnwxIUp39GZYFsUf/up3uFxOyBloTw0CwbKc4G74X/6X/xvOb7/D//c//Ce4G+vtR8ajJqawlzJ10+QSg6C7T4P8cr5g21ZcTqfAk4WRSxF0N2SJ+vXe0SBIanREjDJJBbMsQHMhgeO2oW0NgwPKVFBbY5q7BoGkgO1OYaitMhVf2O1DisIjGDHeWxJFNAgMLgLATUcVLHIqEE1wN9QRwXNH74CEvG7ekSQ6FyrYYrSzTaskZsDRmcsHYnGmpjPYsIOoOTgYIEFYOseBet7EGOkXAZTp7iMDU0J2mjN663CYRxtUd2QJR7E7egtjNMj89ylFg37YEN17lHRwbWiMBbMFAUmJTpYzVtetQqxALB/IQBlx9sSy0+YC0YT1uiJpxvr0iPO7B1zOLN8c9pCFUzzsoWfrWJ7zCNxvk7dsX6QvGtovBdOO0ch5mns1e7iXY5zj6AhMzaRcI91lljEzPuLPDOxxtEDgM6rx/Jrj/ADJSLkux00KAHJ0HPkM9HC6l0bvFdDn9qonXvXEq57459IT8qv1hJlH+RP9tJf1xCcE9t32qif+vHrizwbUfErJfy5i81uv8yXbMTPAfQAvFJr/+Me/x3/+T/8H/uN//A/48P4n1G1DVG4CYIbMkP0CDw4Wtn9WGVwvdPI1Fv2Q5FzHuwtNbpkgFQZ/ZxUsUfJEAYHbyRLvmsfpoYPUcJ0jbc8CZtA9K4bt8qLExykA9hKVyHAIQGVMyDGmFpagHhTahAjcyMGSHJBBRBy3GmMt7pHe5QEkjG5TGgg7jxgphyMeMl7pXguJG6BhKGNHjMvYB8f1GwDCnB8BFBlb9GlEaGQob9kXC8f1MK9E5nze38vhLnxX3PN+Dyj6BHxCaAxR4HPn5/N4tN27/W68d+Zw+bBw4vmOhgIkDIsQGATo9DB+FnBigFnO8Rrn82nE+zRCKGyBvfbW5/8ijACHo9UW6yOQ7ShfgrC1vbkjNc67nDJO5YyP+gj4hlp3Yt6UMsQrRvTKjMR23ZjyuyxLjLkzy81pONStcS1kliOZBRBjHSkX5EzQVFUgJU/eBusdtbIM0BHnyaPMSRjtc8zSQ4DveJRn+asBDoAiwWQoomEEjwzDm1n6bHPgBqTVKTm5su81hg9lFwufIKaHkUy2/jS+A5AdMOfMtbjg5IcL+QJgGmnjIiHR9i4lxxv24VAoLpcT3jy8ieel/ljKCb39zA5mpwv++P0/otaNkVhnyvpyOk0ix2++ecfU6DCOUkpovaG1ijeX84x0jWgbu14Er4MZUtbomhLdKpzEsiMrN0+DVSAu6MJaeGKfivP5hLSUkPnxTgOEhTpq3wCw1aeAvBAmlBlb3VAbS33nmIaha4ndiYYegAPWgFQEAKOpve8yWySCHZqgYhABujkaBJLKwP3ZjgMOkcrjIjBRDiWM7lHeqiWIJp3ZgFFDzozRKGfMAhOFQRiRl/1nBHuAkLhmMHX4dB7iucwi0jr0NCPXKSV4c6gJ1GUGflz3+269wbwF59pwFshFIwnovaK1BO+hI8NQ32rFU7ui6QJYx/p0xXk5wXvH5VTw+99/h29++Bnr+8dPr79pt3yZnTYzHg6Bgc+dW47rC7uduOvW8TPmgeDosR/t8/lvAUwkeOoEzWmjiYO1Lwc9+9s2PSr2w+cWAAPLmkfcSfxwywf58rrdbq964lVPvOqJfx49YQc9sYae6F+qJ/z5WrzVE18A6L/qiT+rnvgsUPMlEZb7/X/L9/8UYM4xq+YoyFur+P77P+K//pf/hP/4f/x7/PzTT2jbGmmMo/TFDvPUYzEQh1fdQQpGAsLRdxw+359nkPmOrAgmlzBzoBSSWLFlnc99qMRkgkBjUQeCsT/TAAeQpoDekVcPNm3ByOJQzROJB3x2eZr1U3E+D6Te3JEHADCQhvF+ZJ+kI1tnlG5xkQzuHIFIdIaKcVFhBwsqrX2cn736IQTlOKKHZTkFih/Pwj3Gs7hFxsehU9dR2QZow/sfiv+F+TTGB8dxELAsiJ+N9MmdvftwrkDnX0qj20HFXRjONTEyfCBgV6fx/g88MmNTgCg/UzT3dF4ZX8Z5h/SIZzoIyoEKy7gf2TNnZOyP/Th3g9UGM8JuJsz2coDKV2MNBAl2TgXLckZOJGXr1idIk9KAkijgqEwbW0AKUJYCkUGgVuHBNVPr6PTkGCVJ7iu2uqGUBctywsPDJYBKRZIE9QTPGUnZ+a21htoq4OzsmEuO8eL7ICEg37H1aC3+CtRwG7JPdmUEYEY6LAy7sSpGNwAHW7LPA/xgFA9N+wmFNg4TQaSwjwvu1neofCbURw3nXL83S33sOcoC4xoz7IpdIR+M91NZ8PbhAdenJzw9Ki7pBIGgd7oVf/X73+M//7d/AKAhG8iLNCOh0V1jOZ1wXa+U+0F02CpBzPSWWY3besVpKXDvSMqSVnIqdZjSJhWwo2AHIDNSKnuJa6x9F4fmhLwUSFbkksktFkahO4CkqFbRVoKtZSGRYWuG61rRa8NSWJp4PrEEsQfJdjkVeFLUVvH48TG4nvi8LoBXg0Q3kQFuqyo0ZaScAXTIIOBPGZIKJJ+Yfa5MXRdxdGuRnbeh1kqZz/YuKEF2D2E7WojMToZ8h7rLqXAcj/afHvYXIb/VlNMH2TlmD0swl9kdcav1ALIrUky4PMdZMUzQ4XDQ4RGU04mcXesWsv9oEO5ztpmh9o6fPvyEBKCuV7w1OnPX6xOSCn7/++/wfm1Y1y3smFhT2B2L+23qnpdMsen9cr0919nYF+fN7cpBZzhGjf+teS2353h24oOPLA4Lh3se6sMG+RIL+GU70+P5aEPaYdztcJTPW5djbvvhlDdm+6ue4PaqJ171xEFP5FPh8f+EegLisDs9AXfga9ATsdiaGWrr+OlKPdH+THqC15Cbjk/z6kc9ceP1HJbSq574Yj3xr670aRgZKQ1yVS6YwQHTe3CU9I76tJLQyToFSI/9x8u0sUAAj24LA6gRsOMaMAjAA4kO3SFCktVcFLkklEj9O5WC81LIo5ELUqLYT85FJiJ7Fo6ObJqDUgOm8zgyaQagsZcfcU8/TGpOqKF7OD0GeRtTF2NhthZ1njE1coZEC76ZX2IOS6H0hjyK+lby9jADYbCeQyRIsjSY8kcmB4WoOGtcZS7eeJZIqRwrbP5PmN0ECInQ4hk9yrHgx1RWrgxzY+tATUgSLbn3C8YYDbk6wKd9BCU+BzwIwMYYkiRNHLuAn/sOuXNv0Hq8i5fT/saBN+9zAEJz0IcwYnzEMUrQBPCRSmrzWkAIeh3roB3Q6sO14+cGO5JhGAGAQh3s1tUaHaNQiL02XB8fcd2uQV7HOSCpQNOC8+UCzQWeFjxsV0jKLEk6PeL9zx9gDlwuZyAysPq4/1qxbmwVWZaCtynhw4ePrD92kCDNGry2Wa7XmuF6/QiRJ4gyGrQsC3IpWE7n4HdSQIHlvOCEBQJm3Lk7oEC5nObMY5YOSeFGV4YbArqveGshE3XoVABAQg/DuzuB5xSiVZ1ldDux4zCAQ66FgeAAehJ2Mgjj3O1WcQ6Cdw0eg8G3ZGGzaNSww2VmJjZn+rYLo06AAxapqo4JkLtERBB8ODdHB/W7GPDm3RssBVg/vIe/VeQ3JzzWhhpGQHvaYL3j/eMH1F7ReoWb43JasNUNSIJyLnAFNu8o5zPJtZ1dPURIPCgqnN/O+SpuWJQt7d1ILgsYEgyeaOx67YALOmjsujDKmFMi4aI7tAisA1344rImjpEb4B2agNY7D7wCWwN0SXjz7g2ysJT1VJaphzQrLKJ+gozz5YQ3bx5QtEDMmbkmlENlKTdOSEoJpsBqlTX0QRyusncdhKYZhGl9QylnXC4XqGp0YitorcKsopQU+pop+AaHKaBITLSsHdfrE4AGiKFuFUmpj3Jkp2KSqlN/dCcBfwI72CUn/0RKgkULltMCEYG1IEQPrjeoownbx5oYxA1qCdYppwhgn7l4VABRSAOKnEGCycyM7dzRrQHemNKuCc0Ma2cb3iTAkwk+rhv8w0/Q5YzTWZCywa8dIgtmSxGEQ5hG6bc910c3qon6W1UxOlsIBHbsUBi6WpMyO/ewVkfE2W/sEJmR62nnDh8HoN8xDd1ofDqcY6O+T+HOCzo8OEvYKpffz+DXITo7sj2p/kMX263xPRTf/u9xL3SuR3ap4RDkCJ6MYYfIWFfl5VKzr2171RNfj56QqSdo8y8HPSFZ4b3BD3ri4c0DFi2AOdtpv6AncNAT26/UE+fQE/1OT+SS6APd6QlBAgzolUTPzHz5Uj1hEHeC5/8cekLPEH+uJ8QbmnW4JDTrWJtjXXc98eG6wT78hPRr9QSGWzaAz32d8Tu9yUqifH/VE3+KnvhioOZz2TJfWo70qe0lh/W3XuN+PzqYgzAMWJYFJS9QSahbhQDs0JQL4I0DKIF2Swj0IdxvMjuOzneUbiidvxygTE7s/DQJgVMQkqbRbpu1mio7aDLAmnG/x/S6ARwQxAljKQCd4aTzJ0XUMVLyXKYT7mawgZhHMYx72p9FECh2dJoCl4eOiRshj8lH043jw+LWHWjgi51AzcwCGc8XKZBT4GBouljcgU753fs8Ail8/rt3PxYxDucKcIc3rthV/7jNAcjxPmK5BSg0zhNzaUAbjlDswERmfazqI4gy7/pwPbn5mwj98bhxrcNDDwBoHHeLMc3nENlrhcd195IsR/d935sLeJhBqgQyx3y8H8oeGTiDgygQI02K5JHa6oC3yIZZN0ZhMp2O5gYkoCw0QkQI5rAddsfj0xNGW/lSchB4k6SYqaoESEQFakSzVSK9t+9ZTWNdWDiI1+uK1jpyrmidacV0OoJfSjDbeQMeIK0elESMRRKoJSqSV5wGQKzRwxQfozXKIMdngOwRhvGZDKk2ToZdVrlHtHIo1Fvj2w//mIb/QYEPJT57c8Y6J29V1KJ/4nnG0npuiLAk77yc8fbdG9Snn/G2LLicH5BSZgcMM7x58wZXXdFaw3q9wqyjm+Ht23doayVAAcXpchojg5ILTqVge1pRt4rLmaV+T4+PMCf5YznTcD0vZ2xtRRUnx5IAGobrWjekKDXNytp3U9bmQwDpglxYithsZB2y1h1CzgZznx0Hcyk4pQXSBRap9K2TJ6r6xmMyTaFeVxgS1NkatJTCWu/oGLKcSHiowb8wdYPINI7WbQPcUVJiJwp3eDak5cRAKASXywMUQKsbeVi60dkQlmButSHnHAauQKLEWKIcVLPi7buF2Z1W4RdH7+woJwAdCQhEmHnaWkM1QwbHRwXorQG+t4qVmNwpC05acH16QkoZWTJqG1LZJgnpLvNHmndHjpa7SSVsZWYdNjdAGoERcbDUFOhmkwAdofMlZfz080e4ruj5FIbo3qlkGpZHjoSDIn3J1orlA9lXBcdH7/XU2D94HsZXwxbwW4lw3H+XHHcnO9yDHL4N7YZ9Fe/39eLCPjzfeJ553ighGPkcQ48M23Q2SYgjZqQ3CP2P8ukY8Hnd9u1VT3yNeqJBIWh3eqLVFflOT+ATekJT2jkmh+/yhXriHHqi1w3WWnQl3fVE/Yye8NATb0JP+It6IvgZBaEnrtQTItAAYHr/M+sJdOT0XE+YdzQzANQTLj7nN/VERdsqkIPKICX89P4jkH6lnoj3MNbl0Xnk2xney3BmjpL7VvK/6okv0xO/CNTcK/DjSb8EPPlTyqd+i6J7GfQZAwguiJyRlKSlI5qXU2arM0cANT2O251nngnzzY3vRHAAY9IdGLNnx6Tgh9l5biJhTQaAwCk1GiKpYN8vJvvxfvbfByACe6eoG4peP47nmLqB9k2YUHbSrXET4cQjkE8fNZF+/IppkqP0aTj57rtqHTw2A3QQZbYMs5B47wTVqE1midI+6lSKTiGGw3uYuwjoVI/FMKyAOXb7wEnMlZs5dhAo+5XjXz4UBPfxw2Kc0+NGDvj+2SxOvN/x9vbn4ccJN07jIVjCeplCMh58ItEHYMYPEPAAOObjjPcRL3GKxR0pws10OVg4g6AZ8DlFRBLbdGvim3TAu0dbQgGSATkzYuM0FkZWS8oZZVlw7h0pj7bzBDytEAxqNQcvUzD/z0GIOeYEbXq3mP9jXlmUKbVQsJ0lfZlE33tKrcBtgaSDsRa1xBj2QYyP5jwV9Ov267ch926WBHDDrzc+H7BqrOBgZtqX1P12Hw3xEJg6yjSCCmqXqZRnIyNwGDc3TqcDiCw+cSBrxjfv3qE3x4efP2J5l9EMqAEmXi4XeO348af3EBW8e/sOT/Un5FRQcsHP7z/A3ZFUUdKCtnW0lcCHJMF23chLoIrrdUXfVrw5n5CV5aun85lZJL0hp4zWO8FKEVSwjWpKQAbntYUuG1mhxcCWlYgOf6p7dzewTDEvGflcoElmPX/bOjoYcTyljPNyQm0NDkdGAQQopUBV0IxcUTnnGWHMKQWg2sDETZYdTp2tAi2CJRe4cX9XBhdyylEqAN5TJXeVAii5wNSw1gBwo+PC6NyoqlAw6wYBsFo3vlPlvEh5QSoZiwAlZ5bLGpOmzQylbsymqxX1ekVzlkr2uiH3BiwnKBR121C3yg4oMDSr2GqHaGbkPeTTyLIkF1eDi4FRR4YHqRI57j1IJCGMNHej4d060PsGW6/o2xVaChyGy9u3sM3w99+/Rz4nCBLMmDm0lwBHxHK6mn++bQaIDgv8C0zF33idT9l8z/cFDvabjJDMIUo7bYQvsDvDmbixj+O3HyTbl9zb6/by9qon/vXqieWfRE/w35/TE0kN22f0hIBZN8yUoZ4QUfRggk15gYaeyDkDQUgsoG16oyfWKxoaiZfrhmwdKKEnakXdNpyWE1z8Tk8wc0UPVQx0qzqCXQiTyiAB0gkeHfWEwWFGXdHMb/WEZ5gbzm/ewKrjH374GfmcoJLh3ukPDn7Ll/TEAaQZv7kWfp0uedUTX64n/iJKnz4FEP0aIGc45df1ChHBshSIKJayTLQlOwWEu6BJEIYGMStiQg38QgIGSWkHYUhYqjsZ6bjfEZlHEAyBUbrR5s9xKLFR7jdqLFOSIKrmZNkVxz4WIgmYwAZJtui804FmdsHObQMgsgl4DqL2cYdJAU38ieuat+GXQz2hi6A3mzQpQ3HtxcUhzDXO68DO+8PIiKQgaB0/U1FGlPWIfkyMwOc97V8d0FuRsHMptDGBIg1g6IXUsmgd5wCsde43SphCme/jHfMAHHMfYMF8lx5O/XHBfWqODsk0/4P7UprDVzefjudl/eoAtcLwGBjWzaUGT4/Nc+wD6CxlC0GhEVWwHvdD5jLyv8RoS0roW4OUBKSEHJxIMEBKwul0IvhyBvTpim3b8Pj4AR+ePsBEgVxwerigPJzxVhX69AQVhRvwzbtvIeC7qpUt5FUFp1NE5jdgq6NzU0ezdlPbeeSO0UhNHYrfLJwiM6yCuS4ATt11XZEjAy5nRSn7WnPQydOUWGOc/JV74Fdv94o8wM8dc2PKc4BjO1/SXCHPjv7kZWIHE0awhpwYShsgaR/CYTbIJEn0ACbT7OoQnzlzrM7nCy7nB/zxj39Ee1rx7pxYBisJKWd8cz7jw88f8PHpCpGElIG6smvHVhtT/CU0iEcrVSMvgUJQUkYqzHK8XleccsL5fCHJvRlyyXhan1gOWKLVaue9ZiEI7qqoZrBtI3cLgJwQPA2CHl3PkrADoQA7B5UweDDkj0Sq9XIqgCoMIJ+AOXprNCiDyLIsS6wxZ+krSFKvHgMJrht2XGRXQyDAlMRy15wSgwLu0KTw5BOYlQhy8KDglTAapSllmFNvj86GKRfKamPKPnVVpF2bwTv3ATKgmVl7jS1dXQTeHaQuKFhKgRSHlRPa+YztfML6xHa4KWReJDUjFQZrSIhu0+hFxFPcDRY/cEZXsyokZDWczmaDwWQH2h3sYNG6s6tHa7BWYXWDk/iA47tc0P0RP7//iN59NhDYf7hQaN/c66z49sa+etHdvUlbH+sLPpK+98N+2VK7Pf9LNuu9DXj8ewSFpj3wgh3Nchm/6fBzf+7xe5J0yoHUcvwMoTAFw+Eajj0VH/dj+Lp92faqJ/4S9QSEmfW/pCcggrwUjPbfn9MT6VfqieEHSAScKYw+pScw+STv9QRAPSEpmrN0R84FjgwJPWF3eoJkzrue6OWEftQTNvREwgiSMzBJkKvF2LAShs6mOwPp7oZ+0BMKIzXAC3oCzq693Y16ojEjtIeesIQ5vnl5QPMnfHj/iN4d8qKe2FfkDZAxvnsm42LvuYyHnrjz4UfAf/hRN3t8avs69cSvBmp+S3Tgt0YUfjEd9+6zz6FSjFx1rOuVvCIKpCyR+scMid51GlADgRh+uAwtcP92ZW/JPRxdBZAkMmJmVIAGEVt4jzrYeI8DfwgBk5JMoGYQXQH7PgOEGT83QEIIOQ/4z3pnBBGgUEzhnJbIFjgsKP6pAZQMJRjnFwIC7oK2dfhWISCwkpdC9NksnkkPAxbPpVOLUaCHcUhhKrdDq/GcU15E/ykVHNstUgBE620oEqL9XwxMLKn9OcFzEW+hoNJEHh1BLDpwsJjueiDRjXON5+FS133hHubE8Z0M5HUY8ANrGq9soNX3mWTD4D3g6byb+c7GuPF/5hZ12aP55C0a7qGoRjkbJFpeO0G1yW8T82i2NvQ9I5gg1ZwUM/KEWEMCjmcqCyAsRyhLiVI6dih4vF7x4eef8I9//EdoZjbN6XzB2c4AHE/XDa07IIptq2i9o/VRnkSFnRNbepsbfJRiyegc5UGed8u5MICamWkVwzgIwVk+JTDjNRwZInU/fhDKSUPOo2QQr9sXbGNW7ZGZ/YtRxswIFt+PzZdzyMgbv0XDoPQXtTplFSZBpRvXMxV0dMaTRHk4SMZCNo9164MWqtlQ53SSDcil4M3lDT68/4C6VeS84N13v4eWC5oLUl6wbk/44ccfAWE6+IefH2nkuWJdr9CUyReVM7YWnc26A97xcE6As9beesPWNrw5v+Vzw3A6nbGuFdZ7dP3oJFFUltVyDIcM1khNj2WqzHqjftgNjsETM8IJrTbkloC0dwDUyD4h1sDBsm50GiKLTlNCrxUQchxICp2Y0k6mBzCaWCvO5xNKofzN0ZEQIPjgcW8jOmLudHBKIU+ERv13ZMullPnCDXAxmI1uHgxaUM97pKFHg4Agr0y6EEAWRcoH6wkOj04kKnEtOCQXJDek3nB+844BmmWBKh2bbds4Xp0dB0/nC5o5WtvgdiKRZ+t4elqRxeHW4sapz5IKDALNtEySAx3BE+GAe4oSh+A4gARA3XE6LTBzrLVi3Ro+fHhCG1x7wpjICNjsmbi7ofjpINi98zzWzd1nvmcKHReuyjHqejhlrOmx4+4g72nlt6e/NYrHMSPrgVUA5J0YQZubaw4j/MVnG/fAezqC/sfnpOMUOicx4LWD9rtRPnTSK1jzZdurnvjL1xPyxXqi3egJhJ7QF/TE6XwikbFIZGFTT/TWp00dBjzftyo0Dz0hz/REd2YKufjUE6IJAo1W4YZ20BO0fxWqC3WGJOgLegKhJyaPSy5QN6R80BODS6g11K1SLj7TExXuNvXE9WmFqMP7UU/Qj9PQExr8TL0Leqcdy1ypjtYrA7FRRpusY1kKzBzXRj3x88cresyJYKM46Ak80xPDZ3pZT9xWcgz/8X63KcMPX73qiZe3X+z69Fu3P9exn0PH7j+/dY5vj+cLYz23qJChvGSip4Jo/8YEyuckobeTaaJgEq6yRrkR9owXghjHH9YTqgh/B0fNwCQmWCEHkCaAmmPa2XDyd4Pq+fhx76mBuK6dwgoeZF5mJHyS/bxz7A6oVEwl3p1wMlkz+LpCoZBcIDlDIjVwRD3keK7xcxBs893dDCxuxnl+5gewZQIVNoEMOSwcCu2p8nmlA1Dj8BkRuH3woXUDGPEhFOKBbtbxcU7GbY9/YD/NeK9xo2HA2n7QHINbW+LljJy4LzlYLUcQapQ4DVAnJsog7hLIoXvWYe64374rYAJfGu90zqUhXBxRqxkCcXQAiFtVVXhKUGd66GDqP68rtq3BesfH9z9DMjvEiNLxEFWU04JTZ4bO6XTCum3khwDmWkqJYEoylhHaUF7i87kGOebIqhkt681H/lo8bnDcjBr30SLS4ejGjLAhO2wuKb+dt6/bZzZ5PsFf2J59LYelefcbn/n7Zh35nPlREhlp3bKX+s1fB9lzw2MQxjxT2RO8Gx4/PmJbN7gJLm/fQNOCH376gKW8hZrh/U8/4enpimaGbkxLXvKCH99/wLVWRhBTQnWDGNCtY20Vb05n1N7mOty2ilPJSCmTLFeAJo3dztyhJcERKdiScF0rcoAeAmF3M7ANbYp53KqhS8VlWQBljX4zHlNy4TGD3TPWOW/H4Y1GWBqlu04nZrBHCMj3BnVoXljvnwmUwOJc6lhO0Z5UAYdFCjq7OLkxNX8Q6fcgitREYIVdNQUlDSLHzpamqui1MwghHuShlEsa5JfqzigyfCRS8m/XeP97ViGcwIfGPt07aRWd67+7QPMJbb0SzImsUAczA6s1XjMXEpxvFb1T4buwtGk5FeSHwnKpdSWJaKelrFFKCgOsNWxbZcQzLwASegda52duCW5M288ps/zMNd7hyP3FfI8yJ/inZdjL9ttdZvP9OXwPEB3Xogzje4BDuNXbL53fY0GO29gBc5vfT5tPbs/xJdutrNivsz/KbkTf/Hvc53giB8T9Jthmr7rhN2yveuJr0xOilGf3eoJZ9o5ypydk6gkGn10YUKSe8Bs9QdEXzyh4pidEBUkw9QQ8gpPCZhn5oCcAYUmSp2gWZZ/VE0BwjprBXKDphNaHnqC/yfIyoPYeYEshF89WgzD+Vk+kVNCGnrCK4UYM8AvOioCtNvQ29ISybXkf/I0K70zpzIMCpEbFQ+gJjSD6i3riMO9v/MXDMhjf36/TkeE63dIpSW/X1NGvedUT+/YXUfp03D4F1vzS5lG/J6q4nB/wzbtv8e033zJ1zQ1P1xXrFqSEFohDOGhAEHvDB5cuBKyB3IEZTE6aNDgygl8mR9u6pSQsS8ZSCs6lIOdCE+qAxqmSXFUTUw0BBPEuhYJER5z9uSJFUEbXJIceFlRKCR51oCkinACJEDUHuj5RzZGJEZk8fPIAShJBn97R6wq/rnBJ0A5goVAIj38vZ1IliBNZKx73JwDEWcfLapyom9cDODIc/wAGbhbyBBUG2HIoYRGSLLp68Az5PP8QDz5PM8rD9rEcFzJgx25uJtL9P8Y9ACLpIHTs5rgdyNjn1HxWkdnBgNtx/A/X0MOzT+BE5jvb18VBwIpCSoZ4ggRyPzNpDuMpegSqsL9HYK9L7o6ZyaMKb+yg1q2iBQlea9ucByXTEOjqQALefvst8vmM85s3UCT8+P49/vj99/j3//6/4Pzmgoc3F5zPF5yM4vlh21jb7ECtDRVtjkjShJIcVhgV6b2jtxblTbsQJ2Az/h3FX9bmoysAj1K3lGKtloJyOgPYiTpTKlPYW5Aav4iSvm6/ajsu7WNq++EXgINR/Im/P7VRvo4FzgvQvmTE5KgqxxqVuPq9GlWhwcrOFAaRjG7AP/zxe7w5C/7w+zdYSomTOD4+PcGcBrJjw3XdIlpZYDBUa1gKW2x2OHQp6O5Rn896//xwJhjZaRDCDUtienJOBZoVuSzwznasKdK9h9MgzuidwWGt8bjiqE5ZsNUND6czXISRQ1Wc0gmaBB4d7SBAayzHGY0JRlCiR0mk6/7SrBskWXRXMmhEcTUl5BQ67RBUGT/mjuaG03Ki9BRh+rcAHU4VE4Y5s2xYlw/B5K/as0RIJN5aZ7ZOom4mZ5ax+59msDdHomjFXpY8tZ8xO8+idFcwgF5ybC0L9V40JUFthtodSegc9RZcC0aOBmY2EojuI9u1O1Qysg6tkcgv4A7RDEkOpERenS5AIl9XN0X3hGYS5cp0LuGGJReclwU/P9YgkB/2z9HsfW4oDqN2vpNfKO88Joc/U40vHrBff2aNfkKO3sR2nn0X0VHZA3RfLI7vglPUycOFnNLo5lrz3zcGQxwb343WC3aHBPwpQcvXjdurnvjXpSck9IT+Bj3hzqYYy1IOesKjvbuH2atIQgPvuZ7ArZ5wR+sdGQSPqCfaQU+k0BN6pyf2OflcT8TMED5PWSgdggYIrftzPWGd3fwOesKN9+ZGUEk1I2M8J/WE2dATgKQUGToCpBLnUHRTNJPIImVw091Q8oJTWaBSGYh0D1DsBT1xWEtHPQFIlPDeLQTZf8nxj4Og9qMfd/zXq5642f6kjJqXeGN+y/a5Y1/67ks/4xf8NYaplII3b97gu+++w9/87d8C7qjbBsdPeP/xEeY92u/yOCbCxQQ2MqeLMjsmh9Go8T93oqDjuIQ9OyanhKWU6AalKDk6M7nDXFjjrwpJOjNdRNl2Dx4dMToO5MJ6WCy6Zw6AekYPOCTFStx4AEijRIikqHTAVRmds05BrRILWzTM0yBeFYHlDInJZgGTKjBLuohkTQQkAJpIo0s6TTsR3HDUHFCT4LoJwR58LHAE0bHScO+8J4v7GqS/UIGYYKbhCTAJm0dWhfskkZvkyQdrU3wIgZvVhGPkcOx7nIezfbiP9NL9nINExg+K5zg/7yY1b9zj28HxhRB8N4eMNP/ICgMzaFQ0IsYOoCNBoMI20xz/yAgLwI7EaPOUBHoUGF1GBomeZp3v0zaHdTokddtmHbJopkGBKItLinIqOAvwh7/9A9588xa/e7ri+x9+ws+PH/Hhpw/46cefMdScZiCXjFwywcveoGZIKWMpGs8G9B4M/O5Mo0V0iMK0HzC05wTEYp6qCHJwQeW8d2c7LQ9o7QpXAj1bizIoESQZEepXAxzAzpUdS+/GcIZPxegiEaE6AKbzd9T1gunD47z8yo8JU/EOj+oTNMJuzocbQ8rnVY/HyTypT+f87p3OmyeB6yjrdGW06vFpxXrdcCoP0JwolpQ1+BCglAWyGbatwh1YTgsMQMoZfWXatfW+g/tOTjBoRi4JS5zHjanQ4qz3l8ROaLlkAoe9Y1mWSH+uLP1rHSKKUy6REeYwkLCQ+LhCM9u8yhiLEUWOktturMNPqoAdSl0OepXZoiOjFIAxQ9W6QUqCZger6B1mTLkuI0hwMNxyzjPlesqLCFoAJEY0ODtdDM4WG3OFn8mw2mz2bANECFZYA0sDKKNFM1pH6B0HggRUImrbW+d5ZDDLOdwJdGvI5pyXAIkrBA7bGrkLMnnrkPg8KWWIAK3GXFYAYvQJU4pMndBFotH9BYBmAIolnyBwNFOWaTE1B+LC9xfcDWYdZhXn5QHfvrvgw9OGfm10OCWeAdQfQzfdp4ffTv/jaj6u2vhb9slws9aOxngIYcZs/Yb0dY847uc+Bk5krs/n9uYIZlhEsadevrPE5f7fPnc/nI9f+PzCMDsmzAfZdchcLwfZ52P+Dzklvy2o+K91e9UTX6uekE/qCXbzNGhJwBfqCbbgvtUT+ZmeMGao2FFPjICoYWRKY7TGDol0oydk6IkAwwP4AfrUE9YZJKS+Cb4aRAb2CBxAkNMSOoWdhvvQEym6HybOu5TYYrvVmHfqLHsCIvsTcGNmkUh06nK+I4Gi5DNYuqXoEg1lgm+oRjRhEEdbrzidH/Dt2zM+PG74uLYdDPuUnhgjdaMnwqcaUepnZvFBT9ztcwyOD58UMryYVz0xti8Cau5Pcl9q9Fu2P6eT87kHnQuSf0BVsZxOuFwu+O6771C3DU+qkJ9/xlQCNosj+GbsWFYi8+MbBxxjUsXkCPBkJwWOHx2OYdrr8YZMk8O4qExuD9bPSdDH7F0bxrPvqGEshH01zcU1WglqOOaCgzD140QLJFcAVwWcgtgPNymq0JLjHEG+GzVc4z52RDbO7TsvzQ0oM7hRROBxX/vCt8Mz6jybjIUuMp9rghk3L3/AbHNwY9HbHCPH3Vy8mZdysE1fmF+3lkbcWYzBBJgDhR3v5XamYBw1F//xvRzvKe5Bbm0IXuFAgsczMG1zgmCDu0YUEslZam0+uyR2DvBDZtc+L8d8H1k3A6wDPDG7RtUh0oAAHFk7DGjm6Js7uvc4J0Gh5bQAqkiFrSrNDVuteHp8mpLRgsF6rCON9ZDUIJnX7kFM6u5hIO1ZY633/TXJYZx9TFcJHqi91GL+T9IuC8IAslE/rQOD/PPJsL/k7UZl3w+JY48uCEai4s3BLjQOAeoUC4MKYcz54A7wSKE9rA+LdW8SPwE0ji5z7iM+hWmwiCPKYOg2Dv1g44bnM+1yQkVJIinAFoCgiQDCunHNNJ62uqJZx+P1EeeHMyAF9YePaN1xOp3hEPS2oWiG9I7+tAJrwyIJyTq7k3kF0hkW3SDWzXApGapAToLWOpa0wM1Qtw0ww/m8wNGx9UqDD0BtQEkJOZ9gYXyRk0vRO79L0lFUkAUomWW5ogJTi0nOMVBXWLXIeqkwERQHrFeKGFOmfSt5ZDSVAPEN8IaGBkGGWoa4oNbRVTH0s3RI98BYYr5Yh9UGjyAEwQ7HJE8P8knpAconQa0rvHcoUqSyZ9TWYACWcGBOeUFKCQaFaEcHgV4Y5RQiK2Xwvwjo5AxDT5QSFga0yu5Q6pRVyR3nPIiEe5RJGVwsSjcTOijbBlFmD+RGUmKb7ZC1JSU8rRV96yjlxHlsDjdBSQK1Dm8bzCqg7GQHd1hvKGL47psHfP/TI94/1TC2D7wKIqFffTo8owvfkRDx3iC/dZ1vV/8kT7Tj9/GdsbPMQcPjVmMfI57jGn1e4qjdbu9Npo03ASe/bamcDs+UQp+N0lgOxcG5MGPJgYCCR2I/BzycnoDJhmCIh/Gbc45xfOWo2bdXPfGV6IlGRsZuFSaKAsCssQuTBwCeMjsoBTDBYC9lsSLDLAMuaJXu+q4nWEJ1oyf6rZ7Q0BMEM+xWTwRJb21rtALXCdpvnTZxEXoJi1JP0LE26olIg2je4z4sugMqgITeRvc+j/Kq0BMD9A+Zm9yRovvw4DIhN+peNUH856AnzAncBBccM36YBHDdKnpjhgzAzCWzCD7C4a3CvMLFJ5F+7xUFhm/eXfD9T4/4+foLeiL0jxwoM46y+JixwsxOn4v+RtLffzbWcIAswaI5f7/qiT+BTPglcORLIwh/bpDmS649omgpZSzLgoc3b/DXf/M3+OGHH7DVSlZsa3DvBE4jihZVHwACj4h35c6aURFM4SbCLJtTzlgKS53OJ0b/cxIK0JyRc2H0EIBP429k0QCcjBoZCZgRAg0irVuQhpkFEwkVotSugpwyah8ZEjLRxaSJDjtiEdixpTfgMFikB7KEiR0xhsOrkqDLKQApQS4FEimLPCQWrcfg2bjWuJOBivMZcUC0Z7TFAukPNB+Rsq1zHQqQIltk1iPaDjL4ABYCVNRdiOzM5vuCn+AjBsgUS/4I1Bym7ZgD868DcrsDO/vk2eemjtk4r8+TyQThJojjmPwvN2l1x+MOv90HN02aRHqKRMdqjJEwlT4JCEAKmMU1xnTe3z5Eg8BZU5rjjIgaSVam5QfRc60r0zedQImB66T1CiBay3bH09NK5nw3fPPtWyyXBd/87hv85//yd/jxx/f4+OEjrttKRQFHzgm5KdxTKDXQCAKj3+P5U1lmWcGHjx9nGdRx/FQkSLU1WPexd5AwoDXDtq64Xp8AZ5vEBAli446OvkePXrd9Wbwg1m8A4fHZULQAJIyAwf4/optD5pEy4F5hy/0CBBBRF7mxD+bf/H5eNb78tL4Ysm7+7Xu9OoC5Jt0dLaJa21ZRxJCXhY6EdWzN8NP7n6IrUpzZHdtaAVeYAdvW8fBwQdKC6/VKh7171LMn1G54OLN8xxDGvzvEjOBGUlhrMChKYfSxpIzMwj7WvEf3QBN2+WOXthGrmgKEQKv3GHOW/nXtyJpnWS86Dd9Syg7qhxypjaBEAtPNJQksgPxWDYrOFP0Yj2FsdQuySWFJ0VEW++iO6E4FkJluL4eOjL1V1L6h1Q1wYMmJUdaSoMiUWV6BxvJMBx0RjezSutUoU3BmusJZuuCC7g21bpAEqDqsRzbiGD1hC1SzDo3s2R4ccOY9Okl6gE1pGmZjXokDHQbpNAy704CT0MEWJMYpJ3bCS4pUCnJO5GsI8EpTgUjGuhq2vuJxA7Zm0zY4rsNPRR1fsqGOhvFnbTd/fvyXBvWef78v4sF5wF1uHYTpZHuMgQozkz5zD/f3c2P4T2P/MD4AM4uDv+S+nObFbNjX7dn2qif+teoJZlNb70hSdj3hDoWjlIVrVGR2Upp6QghkI9H3caX9JbCoUug4GuLmOn0eZsyMlyjRSjsGXWnjGRgQ0HGfraNJZUa5O0pa6IsNPQEDjLqgtQ1AYoAz/I+6NRqxMKQU4zKbVHjoCUFSdhgl0XXIE0EEJTskU88Z0yZZruSYfmSKLMsbPaGOLnLQE9EVbMwx86knWiXVRQk9QYLjkG8pQ0A9UW3FtSlqGxUUn9ETYz3Nuf+y5Jte3kt1h/F+blbklOt+8AU5noF9HPb9OvXErwJqPiVIX/rsJYX9S+d76bgvvZfPXXs/OWYKXMoZ7777DluruK5X+CiXiMgSI2KANS5+BRHkAdRwLghGBEBVUJaCpWScTics0Z4zQLQ5aXO0ldOUwtk9LAr483s/oJUpOD+GVvEQmOZs2QcRiNGQFKGDrJGCKQJoOUGShGPuYJQAs+OGKlsPz/UYoIcoJrGhxEIfKO8AaybaOMuY+EQzE0NkP6cPJUnUcfD/zFGIMRjlgOQXGx25HMQV+CXZ2GU+z6Di9/F+5ouPRR8o/ABjpvoxv+mwhQPwN9js+ccOBonKzfuayCsQHYb6DsRJKBgdS85vf99YMTuKDTPyD8SuO3fNLvxZ8Gt8n2bMkAnwCBjRJQ0hNsq/JFLunYpnEgcjyqv4nuzwTCR1E8AojEL8ASJIRVGkoNkJPbJqzEDQr3e0taL1BpZkJeSS0bxjvVZ8/PiBKaTm+O7dWwiAnBTrP6y4Pq3kp2nbBF1UU0RoGUVeliWcPvIw5JRwOjEVuNWG1ht6i44toQRzSXsWTUS7c4CYKsJWht0C/EPMdb4EEsXtGV+v2+e3T4Hou/11AEh9/1wAdBEuabs1mz/v9s2zD67D3aAWzsn79HbgBZ11uF7sMOXYAIe5JbQOvP9wxXdvE3IujJblhPfff4/1+oSUFhjYfaNbh2qGdUMN8r+kJTo1KEpZsG4NOSVszXDKCtccRmxniWPU8BNEZOQ3K0l2oQADt3zG1iv1gIIRvzAsuwiWkkI8CnlWYHBp7L6RaEznklHygqIlUtsVJRecT2fUy5mAe2aHlL42ZM3IKc9MumHO9G6oVqccG7LR0YEKqGaMjiv3Ubqx/pob8pohSbDkhRHOxs4iUA/uB4pEcsQBsA54h8Lg0rFtV2hLTCVPCVIyeqdxzuygwUEgk0PGrCOJhDyrJD8Hv0fMUToiSl6H4ERAVmicY4Auo0wZwA6gA4APgmTKoySKJWVgiXIKZXeYre56tZtFNxZAtWBZ3sH8hB++/4gPTx2Pa70xjMfY7gbsrlP+KQJox2s+2+dg+P+S3SdhN7xwkrDvI9Dh7N53NNa/5LnunROf9gKmrUAlM5o7vIIzf+7tVU/8C9UTKljynZ6Q0BMQIDkghlSW0BPMFIH1XU+0CkRb7aOeSJpZ6hSgj4vCuqN52/VE3cLlMaB66IlhJzt220zmvzs6UimQJCi5QE2AjtAThhItwcXlVk/AgsGlY9tWtKahJ8i3aX0A+sesLBz0BDtcGQzWG/WE6K2ecAFU0ZwttQXY9USUS1mA+aNb7st6gvtkUE/IoszOhLPUrdEvTQHYmfXI2snIyxt0W/DDD4/4eDU8bodOi/hCPRFr8tkKkQGa3AIZd4tonmvfS2Iu3p1rLKlPn23f/V+pnvjF0qfPRUPuP7+P0vzS/r/2nPfbp6738jluP1NVnM9nnM9nLKeFiykQudFCexw16Evo1O1Vr1NpBImwjHRAjBbJMYlFZqRwlHAMYGMCGX1v8XcPOMk4ZhznAu/9VhMNv3zHSODR8QmyC6MxL2fNpgCi6XB+nbQuDA14kKntKKKoQHMm8CDHZXa493lrXBjxJY3b8ex82ONoRiQVNP5D4VE4vTAPfFwvrjYBsRv8f46lD9Ts5po+dpj73oJno1Jyv99nKPPdOV6csRPMksNxzx39MW68xkhFGtk2x+fBzd8SH7pT+dxLzts14Yf7mK/5gEbv9zzHJeYdJ0w8542gOszVRCJP9Kh3DsK7ba1wAKaCZqONdkfdNrTeSIQHRVKglIxSMraNbRy7+WyDd6tAfJYupZxgG/mVBNH6ER7URDV4LLj2c8oBfMY6CBCHaxNw61MAw50AJygDRvr1q6nO7TlgJXMe/VLGI0VWmF2HktPRGpHA3h678TDSPzX6U37s1nZcfxyzK0+fAO7zc80rHpb3NMgdQDjq5DQqWKvhw9OK7775Fuz8w+jax48fAREaqloAiVr9lHB9qmiVBrWZo1qHQJFzQd0qEIS4pZzYFUQF3Q2XvLDzmTiyCLtUJP7IyA4bm45noeHde8OxPHC+gYgEETMn6WzRjOWUsZwXmCvMATVDUWWUThwmLD9EJZ+CR6cJeIcKUDJbmboWdPOI3gqWpYCkhRztlKh7euM61yjDGXdpTo60RSVKqwIsNmMGXxjZCD1uMKBt8Mb5o+Iw39Brg3XHopy327ZBTIMnDtHOFruedbaBhTjq2mBekbPCesMgowSEwYsol6zbxqBP2E6Dm2HMz/v55jHXCf4gspRifjmzcFttc853s+huEgTMrfL+kZDKA1K+sIx0AzyixDPb9Gggf8Jmesmu+pQdOIMZh+e6P9cvyYCXt0/ZgXt20FzPN/p66NjnkdGX7vH+/m+vM0DDXQ8PgTAlyFD9h59hknz5s34d26ue+MvRE9YbICnKFTFt19Ei2Z2yRxQomrCcTsGrQ1mq1m/1hAq71rkxQ15S8MF0qAi5yHKCK9DdkMHg5LKQN2c4NSl8oN5pP6ruFQVzjomhSEYqmT4NotTHWgBnQfYIMOOmVXhkfEMM3St6476qvH7dDOiJ5XWdQVidmdgCi/ImEaBuHe4NKQls8t2ErkgZGm2ha2tTT7BrMIOQc67JmESYPtuo8mBzwwHgsE13Son3Ha/UnHpUIrugW8dWOxwJms7QdMFWP2KtQ09su/+BXU5+MqsE89aer9vpgrwgZ+/OBWCChcN1mX7rYf+XV/LXoSd+dUbN5076p2TI/Jpz/ppjjmnGAJCSTXDkfLng4e1bPHx8RCrRucgjLcrHSwR5LHAknYrrgAYYs2QIXHRzlmzA4aCzmVNhF4ayICeSXnF9y3QO58S8WxjmwTceAilFGzsm9I2W4tjJhN0mqdZwTCUyJCapUu8z4ji4dAbJIsdvZKWwLSCGv+4AVJh1oJnGtDANHaH4JqIoMUISWgGDW0BmdywRjRZ78eyuQCPh1ewUFdPajYj7uMfpRQ/Wqbj2Dhrsi2PMA6aZD6Uc150Ph4h2JkwFbX1Hk9PovAVMQISDHHjGzcViDiXsqPIO0hxm6gQ9DgeHYRAkaGRSAMThojfGzj5nxmycozONGhsGSUgFi2fyUHp8VJ3GSNzCnOa3t3xAqwXM4jFDb4ZWGQHiHEmQDD5DJUjTasO6rqitYYuSKKL8vNi2VlyvV9RO9ny44Zt3b2jgPCZc1xW19iiXiuMD7LHhWJbMTJ7esQY/Tc7Mnonbjft3lFIYfRegt8p1I4i1w/pujuGRlyfm7kGJvW7AvQq9N76/SGeM9GGRiRO7GTxJ8Avs8ziW4LPoy42BLACgM7NhKkWMH7/h0vhFPSWYYAaFDAAYWBoDfLxuaP4WZTmjbwtUFbVuzKr0DndBToJrZJblct5lkiBIYBtEuS5L0gAGaez23pj2LDRk1QTn84ICgXqbYLqKYylLOPl8xuHQA0BWlpzmnJlBIkpd5zqjeSmn0FsCmKHVCs0LtGRYbby+d0QtEKx3Lq7WIYrIptuQRUhOb4qusWqitel1bSGLCNaUUsg/lTJGK1YR6m6S99J5UCS4NXRPyHlhpmfvdASMOs2sM3IJmx3uOgzuFd47xDW4YJQgkhuSDIJKQECSSIVCfAC34ax1iw53bWahDqB7ODMqgq2xs1wuJWQP5e6xPn3Mq+EyTlslHDyIole+99F2tnVyQlhk9KXMMiszIOUTIBlrNVRzRldVoS4Rhd+N0ZdKne7XwLAp7js/fcp4PX53f75nNfiy6+r744edOflyYuFOnyXGeZRoHw354QgodkfU7DlINX4frz/vw3dDWsLmcx/PjANh6AEI4GKNm9gdgJeAua93e9UTfyl6ImmGJFJFjDJ3rgHqCRVEh8zo0GSO1lroiRR6ok89wZbZBjEDmjBrp3cSHYsAnvhsiZQTIj30xMoSong/JZfJVbg74B7Z7SR2detQ8eAsigD5lBl7hz4zUkQYenB/DRCnTT3RG9ugD70y9QGOeoL6U0A9Ie7TFmZWlE+SfDj2gLswyHFrn1Ouz3LZmKhjPg7AirQOfb5PawaTqJYQRe9cI4ObKZfgcWwdogWOjK0ZmgfDS2JDHAs6BF778yWxx7X5HBvYQdixzpihtR+D8dw+EhqGD+c7SDMGe/hkX6me+Itrz/1bNxGJ9tSD6yXjfHmD09MjNCdcr2ukssXA2f4yafLx71Mp09gaAAdwHGiWTyRV8tUsGZdzweW04HwqKEuOUiNlbWaAJWzFKfM+h5E0EGQA8TmjoQRa+FwaJSzuHiiwTgBm1m2qoHUL1DayZ+KHT3gYK49SJdWofx0TC5O8zVFpfELmve5jDRqIOQMaaY1ugDJzScLAHeU4GBM9pTt8dGShHNEBmYavmVFQHcCtqYThmOVDY/H78Sy31xkfMDVQ9lIyzBNiFxaHv+VwjuMFwnAXpFlWRNH+bGbiVoRgAiws5am7cB8lZIHOj+rXWP3k8QmFzvsMqTVLmYZw2a/HORaEZlEKFwMBeIc3livNdzQeXuN6wSyfoEBX1kwPwWMWZQd8D+aG1hu2dcPTumGrFdtGfqjhtCkAyQUpCXoXLKXDzobvvnuLn94Dj09XPP78hK0R/U+a0aIUwYNPBs4snmaNXaA0Yfga496sdzRlC/EJlMInyIlQdCKKpAUpUxn0bqhtw27KvW4v4Y/chmL+NKA1Z2IsAx3/Buvk+W8ZZ5vyeFe009qOezms9ck0OdbY+KFB5hPO/MS9ja9CBB3J/Y/GvjmwdcPHxxXvPzyigCUq5/MZpXyEqmBJBWslIFiWEiCEw8GIYrcGaxtOJxq+16dK8DFlLFlhnfrduqG2isu7t1iWBVorTimhJMVSMlwdJRfABNYamlUkURqviC6CCbt8lzS7p8EVKRfWx/fOiGcRZClMpRaFJxo01RvcC/MNQ4YUzbAEbPaEXrfgKsuwpvCUyWE1SwmjW9twjuAoYUwyc65PI7HWyhRuBdQ7pCcYMqzSKLZWgd55rdpRrUJLhkcJMIxp6N0b0MmbICLQLEhQtr3tK8QA9xYOE7s9wQXWBOISJdELiYGTYnbZM0O3XXZOPSwK7x3NfYK7E/ifxuUwOjFBqZHWL53yu7lBywIIs0wVBJfJt3ei0+LAcrrgdHnAz08dj+sV1R0SnF5jbXxu+y3A89Fw/bXHy2FtH+/hxYwKOSzGuO7NodPw53+GxPjUuV+6zvws7Kv9tMNGOkTuD/bG0fB/5nC8bnN71RN/IXpCQk+MAOqdnhBPLNlK5Fbp7pCi0IOeQKINW6PdtMV5kiiyZngC6vXKUiId2VAp/Feh7DrqiYOtTW6uKOU52Om1NSQlF2hKCol22UnYzc96ZTaWJFjrqNah+eAjmQVpfAN81xODlJ4dnhrkQGuw6wkF6XTod5XErKjhQ4lolAID3nfeSu8safVu0VWLMn/OzUnKGfI1ghEY/Gwmc3J1MWgu5NQJPWG9IqXEOaAJEEMpJ5TTGWs3PG0rqgPqaSIcn5vr99vLMl/u1vrwjX1/js/pigHSYKyjIWt9Hve16YlfBGruX8SvV8Z/2v6/NoPnl/bRlJHzgmU5wd1xPj9gOZ2BEMYj2tQtmK7DcZ+iPFLUBvo27tHckUEW6azs2EC+mgWn4K7Js/TphfuWYbDtE3ES/AYQMv8NCqMB7Ezn8og2jq5RYxxxMKoAzHS8wzUPqMlECKe0lGMK5K7WZJ5LJvo7wYSZyWSH+0r7uR0DeoyZvC9EGwtsjMvh/czjIqNDlNeSg8M9X9iz9gJzje5/RWbNsWBqzrtxvePxEsvOZc6MPfXN52FzSOdVwwCf38h85tkB7Lj7AHcmygAQmt/n3hgTD+E2waTjlQOckRibmRLshxcZ15J4D47dAGekYghX38eYL/8gc2V/yoPAPM7lQcJbUprXbLWhtY7aKiPGovDI8hlG15jnw8GptcHd0YSprkfz7MbYirlyj1pbKOU+3tOQnHG/JWeCiz5KIeN+NLKr3G7G+KveDkvseUTd4a43Ow/HfO43fofdMZd4zK9xCZ/n3Gf5/Y3w2BFdERzrpONuZvTlJYPk/oy35n382zHXgAujKO4EKbfa8O7dGW/evsXpw89B5pdRG0tUzuczoIK6NTgMrVdkTeh9g0rHUk5QBbw3nMoJlyUjge2el5xQvaMsBWUhoHISRUbHUgSnUsgBAwTRrkK1AG47D5gjatajpXMYonyeiKp1A4L0l+1CI4MjxTtCpFxbR06FuqZFy9FC0sOcBWws3dGCIJddBHuIEkHvbc6R1irMFqgykprzCYNzqveG3oHqjbpTMhw5CI4BMQYCxEkd2bwhRbWtW4dYpPP7CKuRh87NsW0VdaTamWE0E5hAlfP9JhRY6zCv5GTQoA4LEX7kojAzZGUkFwCzb0aW673h5+xWV6MrCMyRU0JrDEYspWBrjVkzcGgqyJqgjcTFD28ecDqfsa6NnBepoNlGjgTYnoHw0rV/YftS2+0+C/iLjgG4Al+QHZ+6R1WZgPuYhwzyD/0rU4bPaPTh3ANMeulej99TdAjkrsXiuMYtce3+37mfhyXxG4Cvf9Xbq574F68n3BAdew56QnY9EQsOEpk14tFYIYLL5j7fB9t8U64mLUiiJMKt0QE0AamwJEuEOqoDJGTFIEFHgOAEzXpvMFsgEl32ygI76onmAKJFuWaYJ1YAAOy45AYB2443b1BJUXnQCcCYY3T4cgApABbrG21TB+CdgQRhYLePUhdXqGe2PPcO5NATrpFRQx+BU8KnD0mgh+Da8A1HcPQ4v7o5WlRDwMFmMRGUzDmRTsAZGFdNSKJQ6UiJ1SOlnKBrZ6JCSmi1BU2Hox8IkeU++/EXtmdy7hNi7yXZ++wqB5DGbz4++OBfoZ74J8mo+dyFP4+C/fZz/dLDHklYz6cz+kODpoTeO969fY+yZAqaAFJMEVI2nHePLAcIJAAXYNh3HiS3gkUpKE9Lwfl8wts3D7icT9GFIiGHszlS0jzQ0EH6O0CS4djO1sQpTV4YTjDcADnDuR4gCYESAiOIBWhuEA+j/ABuzEkm4bvrLjyYtkP+HcWezUGeg0PZVHComI/SMglQgRkVooXlUpoA8cnzoU40mpo3nGhQWIYph1GWtZee+bCO4a3CU6EyTfdzJ6z1A9Ax2jZOtT6AoEBvAqe4AWpGR6A4Yu47tXHsN8GAOUH5n2koBwhAvGMAO8OA1wCKDtFJVSgS0AlIUTOwzbYiWgsqArzjuAHOFNPxhIIpgDGF0rQguI8KsY4BzEWqLvz2WMi4QxB7SwEgxvc+yNVizMbcVE1IhaS/HDTFspwxWqv/l+2/4vHpCR8/PuK6rYzSq2JZ3qK2jtY6ttrCcWRWXGsNrTW4G5bTwvkKYJSLGaj0PF5oSikydzg/zQytRaeWAA81OmwlVSxLQRNmbdnsPMDxSZldZF4jptz2JHTEnA9AL+bUzNiIveUIpAEYxNSQwZECqIWBM9Jlp3Kk8WdhTBLn9ZszijLSwfczolf7lOey3Es9byKw2Ne+jHTm+J/GweOoHvuP8tQQSViWEx4ub3BZLnh7eYufTxtavYLRtgKoYGsVW+2Asp1r7x2aBKflBDSmpZ9O5xk0WBaW0QqiTChCt8vDCb5d434FBQlpkOJzaKeuSKKQpFGD3yFIkFyQRSl7E6KjkiFJGLie0XtknwQResoFpZwgQfwIY7lT3WoYhwA0obtHanWUsDrQXYMEEQASHBGlHB02ZUNOGTlFmY8LVDJa62gdUHUkNVhf4ToycjyMu+DEEgeag91KjNxXtrdMNU0kq2xtdihxALVXtOs6QRwDqHMj49DQ2Wq7OXpryKVAk6NFS9YcBPvMvOu3a2QEIEYpVuikoVusd3iPbB4AzdnhJElCToe07G5IKc/y4SUXnE4ndu1IEqTroQl2erVnIM2XyK77NPOXtmNZ+U1a+AvPfmPk8ojpyA5XmfuN7HCZ4RPy2mmUp82FD8FeNs7U0cEb1HeHWyTe3/jkk75E3ACgYodn4RGiUTYySWbjx8H5Fz/z2zEOhzH6mrdXPfEvW0/AAU+hJ1RhXklUjgTJC4ooQZzkkCKAGxQDCMmwLux4lNkhNueMspwADD3haN3QauM1ALgkguvGd+oW7kCMKd2TDPfOMiHvcDCjOeneOYnNnzKaVfRukVnTAesEfgQhY/iuHYCJIzULf4D2q1mfRr4J+YAQWeKUNY5WK9pWkZLuznoO/xEO7z5/943doTQBzUbWN+1IN2aYq/aYuztQY536ashLnpvgPbxP/6i7w51VFVkH2EKgIumoyFAUTczQSmnOq9Gd7Ng5a/oLx2X6kq6INYaxDg46gnJ+Hg0A03cb57/RFYfjxrkJoEikziH+Hn7Ufgtfi574akqfxmbeIxXsxLTDZcHHnz9M7pdBKKhJkdzR0dl6k+OM2juWnIMPo9EATgkls8tTzuw4c1oKlpyRRWd0LcUi2fM2YhOqJSLTbEctSWfbZKOUJ+YhwEjVPJYuDWR2EAMDgHdeRwOMGCziEkzgIZH2HxnnDF4Z29PUAUCUQjnnEuzwLCtRYL+XZEjQcJwDfIIjnc7QXMBIaodORb3zv5g723yHwe02luBIPeVvmxaoBAmkwUWgM6p5uOkpLHZkcx972+9RaNSP8+6o6hAgB3DHbde2N29ygFOG0f+cNaQj08aBA7cDolb2pTZ2A5ATjdIpYEaBEIbFADooY0OiIVB/CSDJbtFpDV4gcpCFwBKBZGV6KABYh6jFPNEpKL3V6DIGSAkw0Lk/aoX0TvI4X+CI1NNa0d3QBmlaUiynBbUattaw1YqlFFwu5wBdTvjw+ISn64qf3/8D6tZQW8fTuhKwaTUeTegg9o4nX6Ea3dSCKFUF6E5lhwBhdkAu6pOjg0HOCH6MhNpIJGcph9FmbIHbAZEETRklJ7CO+NYZ+2o3v1sD83NMA4cKeqygAZz6/MxldMhjZE2ckbaoOaUc8znDMVpCp+NnOCo9CYL249qiMc8I2q0xMkzwHsa2OJXj8TsDoO5QMi/GknOoO7wann7+iMdvTrDfv4NAcT4/oJQPeHN5i+vVkRvYvcMN69MWDd0SerfgEUvwzhRuAARCD9Eth+B8uSAJ20+nrJAk0FOhQdqd2RZh1A7AOaUCaKKxEmO8g8SjG5wD0mHC7kajrMc6+baSK5KD8tYdVgnAU0YrScFrJUQsEURIbBV7k1cp+zokOWbouNbQasUg61/XNe4vMToKhSOFQatQaxCvcDib0MFB0MfDgEsQGzxYfWbIIjEtvDu5vzI4z6wb0+lrp1yGsIMTDK4NeRj6KrEv4LUjdYLGLsFjpYMzgnrC3KKLHCKgghH/QQ59aGgoOWHrFVvdwp1IGE0NLucLbLsyKyk430qANVtteLhc4JJQlgUfnp5gnnBeHqbTMlCwXwMsf0m51Evfzbk69eenAR6zXS8esxP3FHfZPw+9tesyuv0eMoaOMcMXDo33sWc92lxDCHlye1+36e7ACFv7fkHOTRnG//5DhxPzxR4zl190cr7W7VVP/Il6otN+/6fUE0gRNA49YRYPMEAyhwtBa4LFiS6pAWoC9ciI8KAt29oEDgSKXjvWbUPqAohDE3nJZpZ92HUjo8QhSIl2tQi7cZI/sEMyUOsGtvuiAy5O7hpzsHOhdTiCa/KgJ3bAWG9sQhsyI3yCQfCeIOyo21jm2msHWmLn1AhgIlF3Sjhd1n2WaEkjebB5n5UQnNfMgLFuGNlbIge5546Sg1rZHQpBc/IBcZx0nm/JC7xVVu07Oc1y8POYGU5lweVyRlkKnp6uMD1jKWf0mAfUE88zPm+2MVhHkOZ2NR9WyzhkQiv7jgd5LPNdPL+UiOzVFYfrYczIr0RPfBFQ80upRr8mxfO/ZzqoI9psZtZ2d2tQAMtpQUp5ps+pCnKiA+uQOYYCTONCReAB0qSk06hiiUa0/iU1NxDG5yjhgcihrpXI5CxjCoE0fhPt9Jv3OOdAdNXZy5EkCHJjAnTWZiKFww0Jxz1AkPFegXBkI3rg8elw9odSGnLUg4w4SCglB2+OClIqzLwZoEUsTgmS3olyjmsdwQKMexKm4E+jfgeVjkpWQGdgHO93YzEejkJ/riIqgIPMmDDMHONRm4oJEYVIwWE1xjeHhT3PRiCGa5jPuyPMcbWJgMUCpmVwOIfPuTIfBPfrL8ZD9r98POM4akgH2Y+hw+HjSyDSXz3GzScIhQkEwsHOKiFkZuqfs5OM9RatwVm7bEHiduRwssHjoOMdDedHJwDYOrPLVDSi0h41x4kK2ncCb8tMMTVHdH+JMRj3Px0FCQ6bEaEARrnezjOFOTcNjmp1F6Lh+GncJ9/f6Hj2uskN1+hB6Y45rwTFbmbvS0M3xOU80+18tjv9c7N+ZTfAx6r8Jcd0ZHnMNXwwCLjZYU+dQMcI86Qgwia5oqOtDW3raA0kp0+CfFrw9rtv8I/vPzCia4a2EQwsOWOtG1qryKUgF7ZldWuotuHcC1QLVIGcBCUBpyI4nQpyYuZmUkEJAw3uGCS8cujMtv82uDNLhtmQDCSw0NDQm6MJkMoZo6ZewHausI5eGfmrtZKM18lNk1NhGZIK6sqU+rKwZMonYQPnxRJtuxlNdCQIsiRUMAKZMnVeXbcgfVQs5UxZ4gazBjOFmKEHEMJOizRzzahLe0xKcpl18gN0ygTN5ELIouiQ+Z2qBM7eh3eFXjknenQ/GRxYScNZ7NzfpTNqHPM8Rec7N0ePjFTynqUAjmj8m5Hg0dogVh6ZTwWtOtjCnNHap6cVqSgkkQy9LAUfr1eYGR4uD8il4Kf37/G4CTZLvDf4i0vtl7bnpSn4RfDl/rhPnedT+95+idn18X6vowFuIpMslo6zADAIDKKjpI0O2e6E+M2ZXtzYR/ewi8zMj93dv7nd+YmGTTdkl9vn5dDXsr3qiT9VT7R/Fj3BrPgE0Ywc/CxDT4gbrBmaClI5TYDI3WcpVl8pb6+V/IO0L1O04ybh8boSPC6njFLC/xljLQJJJeQnYJ10EiqJpSyd2YNwloYNwC4F8M3smM6sHOsRXGRGusFjjnn4WCnmjMV+PjMSoZQXSYIPMppXUAZynDTma28d3gU+6SjSFB+tN7gBtVXUXsNHizmpkVnTeuguVl5QbtBmpdpqDJxjcElGRpGwgQ1t88g2rxWiBQAB/Zxz6JyGZVkgmvD+wwdUbDCw3bvvy2f6pPtNxt93IA2/krnPsJ/9E3J7rL3jcc+W9/21x33d3ODxy69DT/zqrk+/dt9/yvKA4/180b05gZqSF6hkbNsTVJy1nLnArKG1yqh5+Mhj7AKjiAVBBDjnPEmDj+25VYlgS9od8cA7poNP/znyRIIrYI/6ywR1LBxml130wwHYqHHkYh/tOkedrxuBGpajRAZHYCRuHb2xnvW40IbzPRbK/t24KOAwsrkfyFlHmiafPWNkv2Bw5wQosUdyMcGoeIAQ1D5BFrcYw3CK4+IhDOJ9KK/tY5QHDrLPCp5fARkvUrGv+bm4KfT52DYBEmI6HpPgCPZgPy7m1cxtEdnBjTh+Jw/D5Bsa97+XSvlBQMl+rmmNjHRA41d6/27GO9sHYcgPP7xjfj4AmgBOBnA2kLghUMepxvsxltFJEF46CFz2uqH3CncKlKQkHS2FoM1Qwr2HAkzkexFhuaAIIrKSovNMCm6MmAOqOImitYbeJTLiynw/rTV0pxJtbcNA4kt0NRAIar8tVRogTSllfm5mSEIHrBmzgETZIYfkeQmS01TWetS4X/Emd0p9TMm5FEfruDmv9/1vZvxxCcSHhpHeeqs2h/8/gVnZr+fHE3/B9pKxzlTY+MxH0rRiuL7HWMvItACAp+uG2h3L6YyUE84PF/z99/8n53EoFEXMe014ukZgoCQspwW9k6S9FEFKQOuVpr84VAylCM6nxEhu4v2oKPKywFujwdlDVxyyFjhfUxh3mSnqiVxRp1OCIDoZRRaLSwLQUXuHryukDjJww3Wt7MTkvMZSTni4XLh+cp5j2juNSxWWLEGYcQl38lJtBH6SEDjKOSNnRl+tG40pc3Tf4CnB0eBolNDmsHjeGwPcg+gX5FxoneWR5kBrlJ2pZ0CA6uREyMpMVzNH68OxsCk/U87wyAi02I9BjXSTmm1RMup2cBZD5pdU4PBpkLfm6MbswLptMKscg7SEbMqUzxA0a7hczliDl0sEkX0rkS1ruLy5IC8L0A21N9RmcBA8+9KlcC8fj6nsR06+L90+B9q8tO9ttDT+44Ot7GgPcwXO4Mfo2IM09bAIOS2GPmPQ69DBS54b0Ye7ufuNqX8xbDfYC8fFt04Acpgc98DB17q96onfpicgCY/XRrC3KMqp/EY9IV+sJ3ToCSHoXHLCackQsOsm8wapJzz0hG2RHWId20FPcPwVJS04nU4ErFIQB9eO1nssU+oKiEAygQ7rBpgcMvlTcHHRTjPrwJC3tQaXILNoBOSdsd5mVoaH3HB3eCIBMnzcNyG/1sPHiOoHc8JvKew9A7s6CRzWqXdGx6UWreO99cimAVuJu2OrG7a6AqMELwAzQMKmZHmSdepOD9LirZJY3/sGgSFnnfxnSZVAAxzNGkpwmrkzS1dVopzK4W4opzOgDFDU1ph9o3vZ1s2iOvzi/H55sQxdQbfU933v5P2LtCcvn/HFa4xAwdeoJ76y0icKoXLJbCvcV6gWnE5nfPPtO6bYgW+5N8coM9dDZkXWNLNdSsmRPC5YcsaSMhZlqllCCiZtpkqbGMkYzTHZ1G9vjYLJjEZh1ImmmZ2Toh12CItq6JXouGaFI8Mj7TpQCBqswarYjS2Nc8rIJU/HeCz4kQ3kZjDpM9MgJbZzHXW/MGF5Ul6gQuTXemedMBSaCbyENQmPUhSMWk8AktLOjWNgyz7oNHoRSoCcODE2Me1lok3cTzRRwPghfXrO94MVMGHZcf5BypwxOhdZqzBjZghy4TNNFPlQUoQAPwRE5An7Y58ltwtuRC+YfpkO4Evc37P1Oe4PmNGaYb8Eo7iIRAZMCKCbZxv/GuDNDvwAo+xn8AnF9wNzGMpDhnD3OZ+g0cnLGJn2bkA3WLQwHAz1IacIqJxOGFD64+OVoEqtbA8c8yqrstxCFDkJcmYUQVWwrg21U5mrCpbCSH3ShK1WPD494rpu0E4uG08xbzXFOmYEovc+u7UxzZdz/3w+M9rQO1qrs4TPBRA3pKQ4nRa8e/ctM21qxXZ9+icFoP+it4OC5hy1qbjG3B1z1ME5PPHAMKqHsT3Sny0U8Vx+R+Me4SRbmMYvBAhe4s24vefDfjfntYPhrZHSDhg6RJ3ktkCQyna0XvHx+oguwDffvMPPP17wXz78HWprWE4nnBoJb60CWRUmNKJdQQMNFjaHoSwLWm9YLCOVhZmfOeHhlFFSlPZ43JkgSg4d1jy6KdGABzDLXLm+MpIMQyWyJBGZH61HaS1lWa1sjarKaFStG7bW44F3KbVuHddtgwj53zQcA1hDymw3mzTmQmebV2uGWhkwUCnIqcA9kfoqseV1kui01jola6YxU2sLAzxqR52cL713Aq/dUH2DGcuxCN4klNOF88CcxMDmQFJUi0wZFQK0zZA0UbaLQENvQYRGdxjQKVrjDhLHHDnWrVI+JiVXAzozbnpn2v/gqUmZdkito/2sMLO3O3JwGmgSEoIuBd999y0+PF6hOcNAkHk4UW/fPODy5i16Bj7WD1jbiuF4fW7qH9fLPZfM/WfHdXX8brTvvgd3njm1B0N7AD8vZdwcde4wuMd8u/mR4TtI2AjYK4APelXGf0Xgzmj4PQHkzXVv7mH/JbKXl+zO7a18GTkVvOIhg/h1u91e9cSX6QkRdHHqCfEILNHe+7SeUDycEkpyKF3BAHE+rScE93oiIZG9JuAmAGCpa+9saw1h19dWN2bZC+DWsW3UEzaMymGrS0W6XoERRBvcmt5ntyaNTBWkmAeuQGTul7yg5AXLKSN3ICWC4golaNN7EL1zbGofBMG7I86OgkEm3x0NzJzu0XUUws6HFnrCW5RDCTlrOFcFrTvYJp2AvYiwayB4/7UzY7R1h0HQ3bFuK7a6DlaJAGd0VnOIdJyM/lqrI/NJsJQCEWatww1ahe9WOpaF6yFlQcr09x4uZ1zXBiS+uZRT2PlAWRbkZYHIGZt3ePMpSwe57UvbzXqRAUMc1sydnnjhBDeE+3PfEOJz3fm+Pu/X4/2a/Zr0xGeBms9lxbxcU/bLn/33dHAYqQpHWZkR01qFquJyuUyiUt6jQoWkVEC44DJKhADAo4KDJU8p6c4xc8yaGNoEiBcxKhH3mrXptx/R3kjrJnrMlEHW8AYnjY7SrLi7o5F0f/1YD6LkvgmJyOPDvx7gk9lB/QkwukcRghiAUQ6+GQIcEsATy8RGacnMMRmDH1k9/HSfBgN4ccAPz4AdKJDBBRPCc7ZuG6ce558AjsWCEZ5z7jW0d5w9wB1m8viBVHc3OvcSLo6JHZQ8s1DGe/AxSw51iPsN+hjo+XzDirjNnDoKwWfzd34u8xmA45o6ZOAcRzEMiRsjes6hMXYx/+a7SmTqs8HDEs833uN4lxLzI4g/DQEERcrpSN/0MBII1BAM67a34c2ZPE+lJJhnuDlOOaNubL3bW90fXQW50AkqfUGLbBkRQ84ZS1mwLOfoplJRa7sB3UR0dmE5dp4Z247IcyxEFC3awdfIHrJBXvi6sUXm2GTM7Vi/CpgMPpQDmDrWd6yX0dZUjga4zKnJLpQ4GODxA3gQ5votBUJsv1rfHIRWuJ9hcNLQSEoCOfMKSeQfKQAyOtQ7TsmQ1aCtQVuDtIZFBT0nZBV4ymi6oSSFiUa3hkaiWqNhrinIbbcGLIKcFijCeFYgC1BKgjebumc4NhIE5FzW1HF7+3nKKdFEUaQs9yFpr6N31r9L32B+RTV2YuvW0WqkXiuz3bpxVMjNZkiNnAVPtYb+IyfD+bSgZP5tbrDEe7LuqLWjbg05CbbqkM2RFoI94jTaKe8BTcGD0yt67ZBOcMmM753lxgWiBa1Xct70Rg4DOC4PC5AU1jpaa6jXFSqC0+UMVUEX8p11JGyRLZSU5UnNKHP6KJ9EcPUEC2d1mWn67oLaeV9mK2b56tMWpJecVSTpZOerZpVlYubIeQnumsq50TvQNqTzCefzCU/rBggjqZfLBZfLE04rnZ/ruuHx6mju1E2HWXzcfk3p0rHc6UvX0pdmU9+f+/a46YJjSGPHWPc+7RHIjA8MxrkI3Ax9P6/G88nuyI/be3k8Dta7h86cAZGDwf3SM0Zqh4QDeW/of63bq574dXqi6hq8e6RiuNUT+hk9kXc9kRO8h54YgVwMG2jXE2nqicO8ToMY3iBp1xOtg7QKfYX7FdXYlap12kcWnTtF8yRVz6MMXlrYkCuDnU57fsnk5IIbujV4EpRcuIYM8C4ouSGnDbkIyqI4nxYGxSOQIAYUIfF78wZvfSZEuO0+gWiCg/v1Fh2jjHw/ZcmAsE15aw19o92Zc4GkyJ5xR3dmaSNae5MGggHFtZFXcXKbKgMQ121FrevOX9P71MsC+o/5Wqc8GtyiNcpi3dlpCu5QbSgpozTH+VRQTKC9QXIiMFPbBDxKYXCelASOtTY0aWgQJgTI8D1v4McbH+Pedxo+BA7zZX7+bC0N/2IsmTjXzb+OC+v59lJA4WvSE38xGTXPUp7uBu34/UuGgoQzPaN9cORSJifN5XJBDq6VuXhCQO4vigYbbl4ephBk9ksQKOpeOjOyQHZ3cKAnQ4nsEx3xHBYABbNqMjNbEGVAQsN1INKqO4mqB0HXBG4COKFhzvsbQA1Z8Acfyygxsl27xWcagIQi2MXLAskZImnydAzIyNwJhk+wIt7JIDgeIEsAA+NYieUjA6wZiKoZ3BvGYr+pRRugSLyQodIncqmDKGxocg/gSsagUwAK0VMEKAX3+cwE6NipavI8jPeujKAgnB8c5sRNpCbe9fzBwDhGBlQYHpMX5jB/DyDMvpD3f9/gQTd2kExzZzgHwpZecQ1gptHIMI7iEVTYyUBJmjtemGCPKCCPTCJhhNcafKT++miXGF2TrMPcwhhg3XVtUQ/sI5VfkDOjw2YJbobTUnB9umIDyxxGFpaEM5s8oZSFdcrd0MDUz8vlDd68eYutVTw9PaHb4wRqGEHKk7Om1jrHbbZI93AAY5wdglrZAYP8FR0AAQAASURBVKFu2+G58LoBsLsKsOM8nOTn7nOGTfkMTFm7/xfzu7mPcNm7jAril1Xas5TYw+dHBf/lGzMV4Wk+VPcK94qlCP7wu7f4d3/9t/j2csLiHdIrxDseWsP1H/6I+tMHaO2QzuxHD4PWrBNoFIGukXEZ3dw6HFlpnKpmiBaosNS2pIwkzEArqvBgsdSh8MMITbpnOQygxkJumhm6NqSyQBRo1tBbw7ZWpsI7UOtH1N7RVfC0VWzReY2doBQ5M7XaO2veSyaRd8qKvFD3JRFkURgqckth4Dd0NZwvF1gnMWNOBdUcQJQTdof0zpCjGePBvaP2BkuGag3ejNmZJuRqEMVyyigiuFbea2tblEp2LEsGNGNtHdt1hdUGa3QgTDeU8wkGYN0aoEqHy1mllZ2dWhglrQFuk5etNsfWNmx1Qzd2i4IDrTu8I7gDOJNKlHBalFBBmNb/+PSEdX2ibJQMsyuWskCTIBfF5bKgbxtcEy5v3+HNmwc8rQ1aEjSThD1/SOyop4q1baiRaaRx37c64jkQ89LnX7odj/8lMOel7Jn773fDdmq449UAyK5Kp/EE+Oz8tUuT6LFzOP5zaew3T3X4iRMOlOAuonwPMvEqHv+L5revOA2AVz3xa/REbZVtl0t6pidMFB3983oCBz0RA3SjJ5JCPU2bc/g+Y0S6GUQbNBdoUjTvsNbC1uIgt9bQrKOL4CnAidrI28IqgM5MfrNJExFOESRxzSIahmRlBv3Ukeo4nc60Yw3kQBMGA3JR5CJ4qCfkpMihE8UduStcIyvHCN4oJMruWTbPzlvk0RldQt1Z4gVNATw1WO/onc0kmjsSSLPAbCGJQCOY6dJZBrXWlY0vjGCOKwMytRvWuqK2FQIEkB+T1SV4URO7AyfKLRVBzgm9pckDyewYhfeGlBpyVmxtwds3F2j4MqksKCWj9uBzzJkdwCLAagC23tE9MXgvBMgILIyFIdMfvfXV9mAwxeJn1spEOXZQ5ubjTx0W56UL+aongL8QoOZLI0AvgTkvGg70RlHKCdYNpSwohYZmygmCtE/Mu0sPB5QRsISU82y7nROBnRLpyCUnCpoBHPCM+034rafHGnvZNVMYw0h5AiEaNazNFankAGL00CYzJukg8r2pUwSgJMaq2wpPipwV0PMEkIiRDIJeBDDEBS5KgjFmJgn9exVIKqw/9oEiYp/n3vjIukyQANGClMJAoFFedf+SvLf5s48joKUQcBqO9fG9BsZ0u1Rxtw7t8Br6xKVIRZOBlOGI58bI7RG4kuR4nxMH9GUaGvs3PsczgKeB8PlBTMR70RFJmlbJAJ6O10EougH/7QJox56OGT8EHR37uyErA885uorROKISncZRPAvT+CwsII95oHBla1q4wVSRcp5dVlIuFOB1Q+8bU0Th7JR2WnCqJ7x//x7XdcV1vaIP8s54n70bSehgOF/OkJSxdcfTemUUAmMYCaiVkhkB6YqHt2/w5uEtHt58g+3772m4RJc2C2WkKUdGjJEEOYR90hTkowbrjlQKS+s80n3dI4Mh7fPodWPK+WE7/ikTIz0otZ39GnOGf0Yv3n81Fb5jxxrHvgPwnkCm38jfLzfCBewmET/OFptZDW8fFvyv/5d/h//13/0bfHM+4emH73H98XtIrfDe0K4fsa1P2N5/BLYG1A50zr2UEnIpSIlrZMkFtW3T2OhmWPLCtqa26wSBIqeCEjKb3CMKdCMXWczLUZNNsNQjg5QZLXDqr61XJFegd2x1xXbdsD5VuAmsNfRtRU+CzYGfrxtaOANwlhup0NAVN5xPjdHb6OZWTjTkckooqWBJFg5FkOZmR/U0OWgeLgsjm52EurZ1VOt8plpREvlhTssCZAJZ6E4i/dbB1qSKrRm2baM8cqb1r9crRAXL6YR1q2gSxjtYVtRbg4lgs45uirVZyK4oi3VAzKNjjKG5IRdFh8H6hnWruNaNRr3VIBrWUOvKMqlOnolLUdRaUbcNAKLLJLCuG67rhrV+hOoCuKL3nwh6FcHDw4Lz5cR7ShnnhzdILYIxUf708OYBZWHG0JD5hkOb4Ps5f9A/L877fcd9TX1i9+fr6n61Hv+WZ/dyY17f2W67Ot2dhN1luH+uPauVm04balfKw4A+CI67+/A4085NEPIqHJaZooz9aznq4sM9ftaJ+Qq3Vz3xhXrCnR1kS/6MnnB2n31RT2SUrMjpE3piNvaI0nA3SPCEjU6mBKYbUtGZSVzXiutTJS9LN/RW4UmwueDjukbmYQZM4FYBiZIiM5RSdh8mpyhjDZvKGWgmUBPNKdRRrmFfueBUFgZHQR8oZcfD+YSiiqyCcyEQtJRM2XowyeHgGAnB8dbY84dl7hJdF5ml3TvlfDgo6GbYtgo1h5qjW2RMiqCbM3Nma2hrQ28E89da0QFUA6oZ1tZRA/DpVqfMkPDTSMEgOJUMXwo23+DGzKOlFCxLiTlq2DpborN0akNS8HpmuFwWuAsWCFJeqKeTIHmC5oy8LGii6IxzsDOWhJ8yZfPuwByW3fNFhYNLMZbB4TxjfU25Gmvr3k996byI93aUn0c98DXqiV/V9elP3efX7Pdrjn0pm+bzx4QLHwS4OSe8ffsWp9MZKeVgX6b3pqrsFhHbzHLwPRNlZM+ospVczsqay8NkH3XZFJAUSDfZEg6Mll4a5MICRhPNOtwzct6zApQU74DbbCO4I50833DQLQSCRobJwY/n5AnHn12UmDUjgxBZR5vVEKaTv+RwrdFm0w8TNgTdXJBjSB03oMCxMIktN6KV6PhQDqBTnERE5ndcE7tQGCl51judlLE4Yge3DkDj+TQypPYFJUGc63Ogoj0cEY8paGYmz5wY8Xfc2k2jpfheBXeo6f4iZpKhgELDoo/JJKy9fXE35u8Yy7hfgj+RDhoZURCCDDZBIB8DRuDFQnkMFv+YF0PAQChQJLiL9hURnykFlyDSPcd8N7CFJnbOpWVZosyQ59/WGuOtN88D4RpNWXE5n7BuK6oZauv7bHBwfcAnnwxEcL1e8bQ+RclUlF2MrlNiMSYp5gPm+I99xnOOrJuSyxSqJA4HLL8a4sC9Krub96YQWeYqH+rLIWx5Dp8Geo/1h7m3wGGcx/GyJ+ipAohH7CPKY8bVR1R2nm9YFNN0n9ccGQcSKcBhwoahoeS+hcPFYej47tt3+N/+53+L/9f/4/+OvD7iP//v/x98+OPfIbU1OLWiY08A1KeSkL1jgcNywZLZdaGyJQ+WU8a2KRZV9NpYunfKSKmjnAo0dbg2SF7QzCCyRBlstAxVmeDDIO42JxjvrcN8yBaJbFKS7bo5aqtYrxvaRuP78cMT1m2DKyOGa+34uG7sjeCC2gxlKRAh+HIqGWurcGtQOC5+RuoJLgozwekEFAVT753lAJYVpVUSNIrijz//gFIUy5Jh3tGs4efrRp3SGhZNvFY1lkguGdYr3HuUDymKOOzakGGorVFGdMd1XfH24UzSYQEkJVh3GtbNsF436qIVaK6AFjxer0ilACDZYq3UI0mpUzoeYaJYe7TPbeQZ2J6u8O445RMupwtqI4hzrSt6b3h7uQTXnaP3CqyAakJdmfVj3fHh4xPWlZ2fmlWcLgmnJ8Xvv/kG69UgyOx8YkC5XNAlwXNBuXyLf/M3/yM+boI/okbzCnIwCHCIOh7s7qGnxrr0sS4EOz+aw1H3dT0t991c3YkqO+43Gbwjod+Yvh9rO+S7+1EPSejZsYZ1XncAkLQewiyXKEUA5/u9wh1acreymEU87KOhZ3aOu308RuDkIFL25wIHlXEqCd4TYctmAToFGwAGLibx/1e+veqJX9YTxVnyXXL5tJ6ITlBHPZHu9QR2PaGgj+KhJ3Rk982ORRZ6gm+JQA7LndxIVLxuFXWtqK3j6cMVtTVIckAT1tbxtNboocNufQSiaSWmpOh1I4eMG1IhmX1zR63OTCAP4pbIcjEBNPfhhsHtEaUoTkv4KAp8eLqiqGJJgstScMoF56WglIJlyVE65PO1akgOHe89JYgntG445SWu0wEj6XurDa11rFtFNoc0gzmJeNfa0Z3lu4/XFdfrihYZT7U1bM1QzfBUG/lqnEETaxXeDadywnk50VeBo2lHbw1wR4kyMHdDbRt9QY3OwhC0ali3QSlg6AIgeEy9b4jaBzjC51OnjJQFl8s7dCR27hJByQTyhHW7nPWHlJej+zzsbcewl0dFgMPRcNAuY3Xsaz3cl5HBtZ8ROGawiNA2CVEf55e5TukTDHDl69ETv5qj5k8BWr5sE3zqEn/qfdw4w0PIC2vm37x5i9NyQs4Z28q69gGOBeQR5i7/O4EGkTkJVYVob1LMLL9p3IxnAGYZje9TfsxDCF+qigTC3CfPx+iQM+6Ni5ltoAcIrLJPxEHe5ABcx9TCnJhjsSGAk9FunEBNGE46HOxBursrxzkWxygIKGjF93EahuCoFZZwyomGHpZHADXzk+G8H97DrGs+vn8Z9wQMECOGeRqjXNwN5mwxTYAtzblAhRuGqjIyPZ7V48XxzHfmht//sc+rITD22Xa4x2k8jzm5zy4e5RN0GobsHJP4HsMInj93WTEQaAjp/d440caw85kTROx2TOf4D0McE7wQHfzq+34SvBRD2Q6JLi43PE2qJDcbJNkiitY6etxeKfnm2oO5/nwqyClhBdBqm2vTnSUVLGtkKZS74+n6hPX6hJHVZN7RBwjTEzQPvqddJszbFGbXaHTlmm3CY40YxvO+GuDA7tY934YgevZJrKcwxX2kgMbfIthbnMa+R3B8OnnYLYe4j2kezKyB+3vb9csnsy+nbUf5qT7O2ZDQ8e/+8Ht8uxT8p3//H/Hhj3+H3Feot+gelJCWBSmdgJzQAVy3CjxuqI9P2BodipyYEbj0BUtZkCShOwFIFUXW6LZRmOrNDn2YwKsKS0wVcpDtvE+Ncw95bfOxBN2BtlV8rKyXFzjq1tCq4bptTOcWx7pt2KI8sbujdkfKCxwELnvaieRz6Lzt4xXmHbmckPIJ1TuSAH3bkAD0tqGroxTysIzMHz4jjZVtcFi1Ro6bQgO85IxTWXA5L7AgCnYL8CYRsFk0yIa74fG6Yl2f8PbhDGYCNZgDW23oW4t0dsH64RE5FUATtt6w1QpJzCit3bHWGkZ7jZJHh0UKeQfYNrd3rI+PKFqQ46csBVuv2DrH9GltgHe8fXPGsjANvRnwWDu2p2s4mwXVDNu2AmJo6Ni6IOuKb98VfPz4hNPlDMmFs9P61OD/5q/+Crq8w2qKn//Tf+OcCxti6Imxlo7rcI/xTU2JvYp/LsBn6+gY7JnL5milInSUjADSMHr3q08ut+Oph76JHXYRO+5vn8uHg0Kn7gbz8RnjQqFGZcqRcc/z/m+HaH+KCS6N5wgHPWwa8XFsdDMMZ2Bcb5Qhfu3bq574vJ542ipcVtSPv6AnjPxWQ0/kNMqBXtYTeqMnYhwdpELIAMDzuc3Zy8Qea3h8eiTPlxvBmmvD01rD4QF6JXjjYdOaOTP9gbCb+B5aa7FMhUC5kZSeraEJ4PStAdaZUQMDokshxx0oRbBu7HYnEQgvqjglxXUpuJSC9bTgcj7DzaFKSoVhWasqHetB8+DM3jb36FA6SIKN2Y+1MQvUBU9rRVIDkLB2jkXr0QVxa7iuzKTZ1oraG7o5msskEm69w53lS1kSPLE8dllK1OmxdbsGuFZyRsksddaUeR/dAiikbG69QzPHkGW4jpwErTk0k/B5cEF2IxB0KQuWN2/hjw0/rRXmDZCCQQ1y9JmOa/Fo7+/+CLmI9s+Oi9hv1/P0h4bvEvsIomvavs7n+h8yergtcvCQvjI98S+w9Gl3VT+5x5/RQUqasSxnfPvt7/D2m2/x0/ufsa4baiO5FLMQBl0YgYySM5ZckIS0jSrsRrMsGacl0tNTtO2egAdfCkuXMOps7p4LAZAkHLNIvAPeOlBYzzaQ/D2LCBONmziNx6SWOF9iK1GLbI3B8D54OEZXqZRz8NXE/Y6MmhCYcTGYTlk97j6eJjI44psJurjP9S2JmS5jIqvvqvLmrcsgPx4TPhRxpJhCbqCU44FU4AdhAGH7cuvbRPA5TgNu2kGafTHfj28AJ0egaAJuY5H5no0jz55oF1JjMd/YCAfhJgKm1PaDQYEZoRyGxlwtcZ4B2BC5Hpw3adopfmR2P5xggC+jMxLGM4+25TGG0N0wMqOSQ1JIAtTBLlCVfBMD3DNzrOuGtbLrU6vMcskl43Q5IW8V6+MTrutKDuMAfpbTCd2vQO+AON69PVMR1Yp1pYPUesO2bdCUcDpfkHLBum54evrIbgSR7WUzyqbY+ooa5MRmFs7xaPt9ItAqKcaDUZVtJbFfzhnXOJZd4l63z20vlZ7e8FoMIrVjWw/uFf+/lXX/1E7PngJvNGwPYOHDueDf/uF3+B9+/y3++J//A/7+v/3/4P0JvW/oW8NqgKQTLlqQ0oJzKfju7dswlL7HT+9X+NZwWs5AXkhemzpSdJ4boDkzJ6jgk5IXZnCBkbfL2RVjlifeGhMaPw6gu0G1oNVK3pkgfFy3J1yfnqLtNJCEnS6aOboCsixQMZA50lEK6/fFDDmlAFV4bHVHvzLDJKlD1ysgDZArVDPq9Qq0ilPJ+ObbN3iqK9b1A1QTs0+zwp2ZIJs56nVFTuRYEXuEOnBeFrx9eMDlfOZ9gTw2pRRkZXbKlhTdDVuteHp6hEYrWXODeEYz8sesraFVjsV13QBUaMpoDtRKQGfdGtbasQX3wuPTNXipWJ6WCjP3JDIDa2+QU8G2VWxPj0g5I5WMZg0uTKFfr49Ya8ebhwtOpwXbdUOtDbUjSqLoCPQhq7ujrg05r9C8IJ+uuFw3pNKxnM9Yzg/49u0FyRWyXfHNu9/hf/ybP+CP79/j77//MdbMrmCelYJPm7eHrgF2g5MlEC8F675027M8743aLziWJ5h/PwvS3foBt5sz42HqrhAsM37gVGX8950D8sKdPB+3kckW+n202709ivaMfw6geN3G9qon3qD1jt6/x08//To9AWc32vxLeoKjGdwsBJZGEI16guS/lI2O1thO+np9QqvkplGk8EAASAIKu+NJj8yBCOyKG5KyxFyEPIbuiJbVfDfWgGb0SZjpuMEaS2lL4b2sK1tu56wEPlrwjEZgcEkJPSlqbVjThstW0YPMfclsCCPw0KP0v1x0ypDuHRpcnTPIKQpIhqODdGiCrXbyMAoJ3rdKvXBdG3VFa9hqw7pu6B5Z5WC5alHauUkTVByn04IsBQn0JVPW6PjokfnEVutJSAxM7jhmd7fWYU5aBkkM5mhi8LAZx7N2g/bo7Noq4IIlKRYVtMePeDi/xXcPJzRxXJvBQZ63z7jcDMKOhSeCnbZj95H41+cE80sLabhKw5MbPtNY4EdAZoA1h/s6Xhz/evXEZ4Ga36Kcf+v26Rrnl/a5/fevIwEbL57XYRT+hDdv3uF8PiNndrQYmTL3d0OSrOjwNEqdEjtyZE03JU/DAZQBKMjRK9/r+CDRmk5HTSmFiaoihVDxiLSlQnIvAkgIC+g2um/zvIgyjRDscninPu4iDOIhpNwJIglLoOKEBIhEIm2SwA05awbggclj4gP80OBdMYej70SMOoAWf7bQdsCH6awT8LCRTeP77btDUsIg+YUqs4jcSXmjfM/mQHKftbwStfy3syVW5RhSO2SYCCZAJXIknvKJLvnt6rsFaiISxFs/SBqRwwGHf47ThoJ9KZNspODuxrBiAknw6LjETBCWtlEIcsr4TTcn91Doz9Dn4OnRAMgGmW8cN0FB1VmSqRBoB1R9gntmJAPerlt0YdqwbgRDu3VyPGWFbMDHDx/3YRDF9bpiq5VdZwAsS8a7Nw9kzY9Wi24GyQUplz363SrJ4cCWnOYeGWbktdgBqiCy04TTsuByubATTm108JCAxOi1icONpZLkuPnnk4//WrajrKa8GUL2qMJith7D9XHs52T8+H7//fI+n7uv+TdI8SaJGWelCP7w+3f4f/5v/1ek+oj/+r//v7G+/0d437B+/ID18YpaHSmf8fbbFZd3b1BO5Eb69uGC9e0Dfvoxo9UGFbZ0dqN8phEbXAKeoMLonorTkFMJ/jMJQ1ywOwoHB3zompA9HlGa7fqEbhQq61axbVe0XlEDlJUwAjscpkLgpbO9qYG1/BZAZikZ/eq4bhXXdYWBNfvXjd0qzktCqw21O4AEh6BvG0oSLDlh64ZlWdC7Y9uuuFzOKEXRbUNzYDND3TZ4axCwjXkSwVM1fLw2LOkjqVi8IyfF+Xyi3k0J5Xxml6RIKT6fziilsPtbX1GRsG4NHz48olWj7oDi8fGK1h/hYIeN2h1b7fGMBG66A+u2oXdDLgXaGqO2iSVbUgyGiu3a8fRxxbKc4FjRe0XOBeeLwEyRG9A/XnHaGnmvDOim8HSKduV0AEQNqRRy4oHp9tetIWW25LZuWKKjy+YdP/z9f0XWgt+9+QZ/8/tv8NOHn3FtG0EfewGkiU0ihOoBzLgd97kvVnm+1m7Pdf83eO6Dwz0M4V/eboMc9/beLx99sN+myROG8nQKfH4qx5CT0G4b62uaTL7Lp2HYu9/EmseOGBnTOxfK6/Zrtq9OT+T05XpChp5IEVTyII0X5ARkvdMTNuZh/C0zF577DD2xrhGUlgAiVgbCeo+OT0FQDgT4zHO3TuhGg5h28JNZbWHjsQSffg05DHMSbFs9lJRJyLYE9ehSlQkLmRFoUQAw6iQfAbhm6NEtyzJXsvsTam04lczMVGUgPSdDLmHHupPwPqfg8xm8PT4EAJo5qhm6B1izNdROHbDVhq12rJVAzejyNDhPBOxalcqCXBacTiekrCglsXzYFWKCnDJEogpBgh7BlwCYyKlG0mHAncHDbvwZdiy7AtPHI2DjOEewn1nkSq4163h8/yOWcsLDH/4Nvnk4oX+8kl5jLKt7P8aBkWYzpCbH6bi+dCAmtwJ3HH485djvIN53PYEJ3Oy+zOFEXIDP/MWvQU/8k2fUfMpA+NJjx/YsrfYTCPwxivOp/eIbAARHSik4nx8YTc+Z9fMYLmkYGTG5RlmSxO8k0VZN02zRPXz0HSmUMKLHdWXewvAZB+HvXqdGRzmlPF9ka43gSRrtt4fjjcNxA+0OhE6jSGl41fORCNGM5xr3Oo2q8dQBFJhZSJG9C5QM9BwgmCNxM4fnGqvPA/yaNydREqOHRf5sqg5vWiAaK+EG7txRTJ/YJMfgltbG530BKQAXnW9iXnXCwmNfzHvzkXKog3DtMK8EO6HVvOVwliAgQoQApnTfZwzPLp04dgOQOiz+l7ZZ8jSyfY6CxW0qMx91eMfNnTw47nANLpxjKdDhGZiqN7LK9uPH2NnYN3YYYOaYHxqGlEU2zVYrWmNJQbc+AR9xxzUi1+6A5hRKsKFubFcLgBGJsiIFyTTXIslWSUTcYb0xPdYVgz9hEAj74d0WzZEll1BywWkhaR27wgyHV9G8RSRqlAHabD35un16e8mZu4l6ztp4uYmscLtVwOO7EZEb7UTvjefjNV76fp79zri3KKVhSSZ5nRwgGbYUvH1zRvaK//rv/yOefvgjHn/8I3768Uf88I//iKfHFc0E5hmXN+/w3V/9Hn/4N3+Nb755h1wyHkrGm/MJzQUfrpVzXBOWrHh4uDBzoyaUUhg5NUdZQrdkQSkJ59MCmEElYymZ2WvGunYJYF0SOQZ6PHOtFeta4cBMwa7WsLWKGkBBTkEeGd0tWhDHe3S4y6UAvWN9esLaSXipOcMNeAwSyRYirq5PbH/dgdocomw3uwlQMzNYkjI4knPB+vMTEisByA2TCgwdUGXXJiMfTveGp76yLSwcS8pYsqJ8fMLlXGiId2b/5AT8/tu3+Pbdww4qq+CUF/TGuXPdVkAYbIAm1K3j49Mj1m2DIWGrhhbPcF0rXEnCaEZuBfeK1gyqLaKe5CwwZFxtxY/f/wTvhlISltJxXTs7uMCiXTmdGQdLNq/rBlFBOZH/KmfF+bwAwqylFiTqrXW8efcGzRgFzaXgzeUEqxXf/91/xfmvHaesgPVpBD6T6TcL8nY93HCiHe2fF2yqo731UuDsZduL57wFb3ArE8bn/oJjPP8+RDBvdC5v2c32NP4R3NhPMonlaf5IWEMaPATMRt2vO64FuLNDh8huE45zDHGVNAHemR8ldw7H6/bi9jXrib/62z/8aj2Rc0HSMvVEVkV5QU+UkoBmsBocIsISIAlfpQcVQG0Na7SiNhB8qb0xsNbZwUiDs685ux15NB0xIsGz3bf1RgJ6B06loHXH1pnFT3srI4tjycvMWGGpFo/trZLQvpHXDB5B2wCTp0PtXNvNHWySIRCwA2itFVvOOBUSK/duOC2sFkhuSFCkpDifyWszuLZS5mW67VxuPTLHuzm2rWOrWwBZhtosAHdhJZAI71njHaXMNtq5YDktSFmQlwVJMkmZrTPGHM8lYAerpGzHLeJQZ/kxlICaRDkbYMiasJQFZYluUA44yClXSmHHRiNhdFZB7Rsef/4Jp2++RVnOEOe9+1xTR7n8gq4ImTzRlYPf5QM0Pcp03zP/xzlv4A8fYMZYk8DwLMSPemLcAG7W9teiJ34VUHMrHO+d6uP2L1k13d5bzgXLcsLl8oCHhwcsy8J0vaQHgFEiiybtE8CIgIqyBVrJXJA5kF9m16R9zGIyWLTOFCdSqiIsG9EUxLaK3nukyR04YdyDHEwgkdIoKUPMYN1IFCbMdpmzQkdGxCDMAQbnS8oLEeycA1DYF6AGSMQt7sEd6GOCj8ibxWSPSeuD18cBk2D5HwhGpGJORu24v8NbGTg/gZcDwihRU2oUXhPhcINbKOHBjYJhPMbU9iCZG20A80KwK7JDdkQt/h7I5sj+CaBiB5Sw/56gE0hMNj7U4/hxzAfh8Xieca1BnjzF1xifw0y9MT44knDzyLZSRAIfZCC3NsZjsOYHqBWv30XQO/mPDEweUhQqgOCNgTCLC6oDidnvKcZ+tos0u3leUYHmhLRknC/nSba9bSxXsmZMVd3Y2rY2w7qu7CxQK54eV6xbI1NCgDNbbVjff4SI4O3bB1weLtHuW/H0pMjlhFIW1lE3dmJBkB4PiIlClMANs3gSzqcT3jy8QQ7H081YHz1GOgwzRj2AZh2n8wW9N6D+S5Zz/323T0U0j9HMfQt+o30v3Bvfx+M/t43SvaGkj3rqc8fe35eIICHR4FXFaVnw7uGCDz/9iJ/+7r/h6aef8OPf/xF/93/+PT5+fIxadEFrwIcPj/jHH3/EP/z4I/6Hf/s3+Ou//iucyoI//O536PoBa/uA7XGFFMNpuQBZYI8dgcFTvFkA6UIQn+SIuoOjZowIpjSNlmEYtVbhFlHW1uCoaG5spdrZ9alZn9kWlNeOLbqvpVQmCLmUhfolOn3UNYh+KzNPFBIcCDRYOVYXnLTARJiV0zqsExhajZ3WgMpWqYlkh+4V7uy+sZQS5Hs9yr7iTQYoBXNyE+SE8ymh2waF46FW/P533+Hd2zPeXRacSmS+JnJAaFJcLifU2rBtdEBaa3Q6VOGa0Jwkm80EW3e0LoBkmEdmoAvgijVkmaZEXd6Bp7pRf3uC5wU5kXfAI9Lq5hxHDQM9Rbvz5YxcznA3JBW0eiIItSTyQ4BcFSoaY5xZkmmC0/mMdr3C64YPH96jLWeQUsuDIP5lJ3hfZ8E3RgNg13lTt/Vna+jewX1pnd5vtLNvFegM7Nyd+5PnuJEDB6DIgRG06aN0FxLcB9xmKYzEfUQw5ug6UCcLdkLK/faog8f1hn6eFv4crnlFPzzzL8isr3n72vXEH3/8EX//ww+/qCeWez2RPqEnQnaOOT30RAo9wQzKCPzWBndnmWZQPXR3dI+W1BbBqbDtRpOI5nxu1RzZ+9RD6eCEo+8Z6SwZL5CcoSmAmigvh2YgFUDId1a3K7brE67XgvVpRd0avNt8R+6gzPY+A+YmAIz+gXVFS4Le86ERS4EqAmhXCArOp4zzqTBAV4Ztr1BXqAFwRz8V1G0LfpiObg3dWgBY1KVsIMuMnBTVQ+Y2qx3MenR7YlZSd8HaNqh2BjTdmUEUJMYqAslCviHhfLc0eB8VFqVsJrxGim7DJbHzcNJDB2BNcPEIwAhMSHtQ64ptfWI3YY8KiDFnZFR/HFfEqLsIuXijJwYC0Xc5OsEZoiE+/8u/n4NAt+ttgi83eurw6yvUE19EJvzCN3e/D1eNz4+Hfk4Y/7rrfnp76ZjPCdxjgY0IjTgBfWx2LeZL6DFFzYKYSgxmyjpBp6E6SqCOv2d5VKTUUahygRHVxg4SQPbJGzaTdUNHRcpBIHXIUvCIEMgAVBSR2TKEMwIh1kl6KsPI18hO0RRRAIIn0rmcktJoPWYC8f4GYMNsA4FD0sg82sfbA5QBJLhqRsFNAAWOaH8aZqKmiRxDEUI50jSNkdBxfvO9nCcotIm0y5jne6lUSoXlP2NMMEAcxZGQC3LIluFD4KanXyjBWdszpNiYWnrMuxqrFYe/5grer4dYvG43ApIP5PP5RQDXtD8XRnSIY60zU2YXoDsuKxhcNcLBi1EYxNSJunSMUDy3u0fLvrttCp0InQ8gyH1yygASrbb5DOSiVmhOyEvB+XKKeuSOdb2iAvDu2NYN27Zhq6ynRWQ7ffz4yA4BqsGfwSyhH356H85kKMqI9NRtjSh3wvnygOt1Q+/kmEHMJ7jhtJTIygmyNp3JYmh12yMDtgM2fHUc05QiUlLK/Si9br9p2xUyweJj/fO9Uv/09lszN4FdfxwzChVppp0P4PynH37Ax/fvcf35A37+43tsjxuNxJhf7jS4nlbF+o8/MiukNfztv/23OJ/OyOmKt+++Re/fw8RRFoF1Rcps6woEkCEZJPke65uZGAlCwKA25OWEsixotQaYyGfojR2R8rIwNT4noDEyWK2j9kYJE+AysQ8a5aoCjUwTLQxM9N5JGrk+0bAQjU54dALMDAnGZMPuMAFao1FaraPXBjijeoPQ1wYRiwDnc2ZE0DvECOzMVPQ0enUAIjYjVOqOZh1b7eit47QkXE7f4PffnPHtuzc4LSxl1JyxnB8AUWb0dcP5dMbbd2/x+FTx8WnFh4+PWB+v5OcxRi9dSHYOZRvabb3ier3i8bqiWUdzYww38T3lcoKkjJSZ7aSJ/BFLUhRNyHmBiOG0LDgtCVkEsA6J0umhI0+ngvywoDdy1iznBQBQlozTsiBndtUq5weYKLpkNAh+/PAzWhP0xw/w8oCSCrIKAxmfDJwNQU89PYCbaXzTWsaxJ/KxZOS3rDEfzJCyr7npQB7POYI5X3biZ049KXf2421cl9+C+jEi4Th8hdvj9tsZx4z5bwcbDBPn+v+z9+9dkhvJtSf6M38AiIjMrCqyWy3pzJk7c+f7f6i7Zs2aI6m7SVY+IgC4u90/zBxAZFWxyZZ05x6R4EpmZQQCgYe7mfm2bdt+h2T+M7f/Wn5Cq7LchPkvP/1NP5G+8BP1Cz+hqCehRqJaom1dTdw95UxZi8dnNmBNHN1KLEOKxJysQ97aKM1+ENOXAbPzWqv5DrHFexSIybvUOsOgteL3wjsVedmWeDK6JyO6XzNWApRqibq1FkqzeG9eF2segVopVLIqBikdvGioGOOHZj/SjPMQPAYdcl+lCDHCaUw8nqwzVPSuos2BJyQYAL8tOiDoG7UW5pu1Dl9XYxq1JohEYsyIBGpppsG4LKy12OOOEUkZub6iRFSFtTYkWNnumCJjgEHsXiYJlCTIyUCkFNmuw62zNx1QJ/ev1BIJHstGCV7Kb6xYSdZxq6gxj5aykkKilIWoSoqJ1vpabZshB1Civ+RAmT01WxXroWyh+wlHIgyX6Ou+Pj9/bmJtX90xjXcgBj6+f5t+4t9R+vS1m/POkPZX3xm396//R2+/zhD7ojLsqGIQccEs2Zgq6se18ocdTNgNkpEPrDHaAZ3cFuiHr9sGMPTSjU3zWm06aGuo2Po6WnTKsavPkW4VXCsGuK8x798vOz1ZPECSLppLHzgOEshu1Pr7+3X0wdp2sga2SD9Sz3bgBkMVt7hvf3+7DXefwAe1ATQGKoR9Mupem7qNdt21UrajS2cQiQEp3sat35MOPh2wFrunW3sUB2nkGMDK8TT3vzfAp39O7/+9XZ24retVvv10jgc97O9otXSACKy2eAO5zFj2b/HResgQHc7Tz8XGb2fwhO2mHVlfdw+PPpf07noMY9Lt1kgHasSMsjR1eZsdYDQtqMwwFMqSTfjOz61W02aotTooZddfq+k+EEyPaV1N16HUyjDYGFzLDmK1Vre27Gk60ZoFF8XFfzsolVIg50RKiV7G1ku7arUykRgTW6b5cC8tk+Qi4fI7UHO/7TbpzgbLu7d1FzHcX+6Dz0FH99b3lbtfs+u7U+200/ttsza4tz8c5cvjdaA5iDPJ+uxtjaDKerui1RbuZS0EteDIWCdGkZYkJsoeE7fbzJ///GcTzn78QAxinYjaA7eysKIsy+xmyZgWdV1QX7wHv5chWJlLqHVfeLvd6jT8EKL5DPFWnz2jmZLR1RcLfrummYK3DQ1WThVtrq6rZUElBOZ5JiJoiBbU1UYM2a2NZ1xLtcyn4l0mhLe1sDRYlpVaigeaytKUUpovbOyZ/PTaSDlwGRPnYfAxUFGtxOr+D4DqJj1tZq2Uwpjg48dPfPr0xIcPj3x4OHMaMyknmgTyNBGTlQOspaAqPFXlelv58fmVtayUz6/MS+FtXl1wGNYVXt9mPn9+YZ2vOxs2CsWvZVUTKC7F/aCYbTkNiTEqH84T52niNCjTNFCblRmkmMnRyi4jQsiREJRxSIxDYr5ZUmLImVKK2y4rt0wpI4MBQyBcb1der2/UFgllpUrx7o/ypfYq78f/cYErX/mb47S2X/3lo+94P4+2HXUL8t2so1+fen5sOfiwb8eLus1lPYYWHpPtC8HtKkOnpNvnPC23xWA977t9l7/TQweL0zxuO57W3Wnq3ffy7pi/b3373U9YE4buJ+Lf9BPL3/ATnfVufiKZmKwDIMcYPjpYolixUPcTgpBTMpB6XU3TzOeIqjFtelI4DbbuaY1t7YMnCoIEmkTXy4km3eC2qNbKuizWGtpB87kqlchaC8s8U0sxQAixZPW6GjjULJmbcuI0mu0UB4VaLZaIFUGroKk307CGD7WZFllMgek0cjqPjFPe9N8kRWMLeZwqzUuttNFqoqyJ+RZAqwssW6crCEiMNLVW3iYOv7qfUAhQamG+XnmZC6+3het1ZS4mHTwMmcuYOafIwzjweJo4TyPnKXObM2MOnCcrx+/VHEKDLpCPleKqdyWVQ5xuNs9ZOcH8Vm2mQ2frSbN90bUut890u4fbW93f2dCTOx9xmD1300R3e3/X+OV+Rn7hJ3ypJ8f3D7Nz+77fmJ/4/8OuT/+/3Xr2vAuaxtjFe3fgobmNUtVdU0bE60KtA1TvUtEto7Zq4zrGTQ3eAuuD+K6NARC2jGivlVQ6WyD6yLW0f2cudAaIZfh30VaV6sfeAZx94IpTD6PTI3Hj3XVnfDjKzogyR2lGR/o+ZiE2cEZ7R6htk7vv3GoVvaxHAK3V/Vs/ZnDn0dyAsIEEveWiTRxnAfWpI2zod6/R3JymdOPCvePtkeIWccp2rRswse34tQnUZ7hA2MuO+oNVB3o2psy7YNbGgHJPXdGD9I0Jg0m3LH03X1xZE7Gw2U4fpZsxQrsWix/cRZ47DROBkIYDdmX330orgn/e9rdgSQ/nuNdy93Iz6W0UQ9g6hlkZn7CWgjQbh3kcDEwpK0NKzD7Xaq0bW8oyFQ0JcH448Xa9Md8WbsvMuqwupAZa37Z7eblMVkIAXMvCeDpxeXzg04fv+etf/8xf/lJAiz9mN9CqpvGhlXWZaTHYgrau+zNxUNCG/D4/qjZiHBl+Z9R8ZVOO88Z7GQBu7lS9Jtt2aaIou9aPCtt8VPf0XRz9OF638Ukfj/t7nSHgCTf2CbSz5vpn+hyJMThrUvou23shBZ4uJz6dJl7/srCUhbXOXMsbRVekCaFWpDlLJQ2M55HhfCKJUY3/5X/8X3zXKg+PT9aOdc3EnPnhekU0EhWkYjoDUtG6oDViLtpA0Lf5SqKRk7nttTaSsGVxh3H01q0GWi7LiogxOhaJKNHacRbXtJEITqEWsfFvbEkoS6G6iHeIgRxHagaS3aPbUlgLXJfK680AjnUphGLdn24Kt2bihmggNqOvX6vd9xyEpGYnmsI8N+Z55SULDxdhzEoOjdSU1tmcLmofAmgy+vIQG5c8cT6fCUOCnInjmenhwjAkJItlNlMkhImwzOi6QDU2jrJStfB8vfHDy5WlKtfVAJzPn6+si2k9hHBCqeTQqGXGK3G5LsoKIGpiwK3CrRLDTJLGv/74QhTh6fHMw/nE42nk6TRwHhPfPTzw8enB5gTNSsBCpSVhOA9IVaQZ8GalXgnRxhB7+XJEa6G+XfnrX/7K+PiRoTZmXWhtpUmhhWg6GjY5emhgc7PtwTTb7z2JsG/74rWvnHvsoD637tbYImhfv6p3g1EQ7Vl/nJHl88uTTFsZbZ/H71zvXfLPF5soVjLgBmM/7N4d0603+JK2uVjpdgA1tpmKJ+yA0ALV7cyWK3JVaXNtEQ2euHN/IjTvYNlAuv99p2f3++bbb9dP0MSZFt/2Exf3E2XNhJyZ365Iiza+KgxJSO/8hHq8+TZfyahr+ln5aXS2j4hsAusWz1nzBdMSi8SgqCTTCSu2ElG8XbcvWno3J9NvMVYOrRFTdMB5X1OU0lhKZSmNuVSuy8J8nVluN27ryrUot6rMpbIuK5RqIE82BuGUEtnnl9JYq5XKT8PIkO07lGCM0NaQFmjVSlGFYDGamFDxNE6M00hIiRYCGhK9jiwEL/vqa7Yc0dVXJG2h1IV5XXibV26r6YWpQC2riS6vDVHvnhsMdK9a0Gqi9M/XmZd55bpWrnNlXhXhRhYYo3AZI4+nkY8PJ57OJ85D4jImHs8jHx4eOJ0mIDhrycqwJAg5mgBzBwz6utQqQ4TYvEKkGUC4rpV8ChCtu6AV+usGpHTiwBEh6aCFaWz2teE+d/eVXgcy2PfpS7Vv+AmCVzvoXp0h7PIXzY8h7FUiv0U/8XcDNdJv/hc3SN/tJ3f//rXlTv9emuLf/rwNzJSzBRDNi2R0r4vseH1n24gL/26K4Sns4mKHy+hOYleG9p+OtknH1VygrJdfOZBipS1mXO/ujgNJXYA4xGiGNxgNM4i31I5py1qa3ogH/XRmTr/vewAX4w4MGeuGzX911oSB6z6hd2mXjilsk1trcb0bD8yEfeCrboGhtSMHWiU6otlRdVGc1dRRSGe5dOaPHIwDwdX3gy9WXFC3qaHcYICQ++j38k266ZLYX18dkwfgZS9Zko7y2OeOxqkDWxu4wwEoYgt0OxBlMYdpq6j2Mdy/bz/UtrOPKTZgRgmuO9CdbCcssj1DC3wkdFDG7n0Tu8+6laz1a+6gkV8nDbTc37st2rH5EYkEAkwW3AgNras5jFZ5fHzY7t31Zm0ZW0hcpol5rcRiJQ1RIG739v3YsTFs888Mq1FTV+bblTjZeedolFbL0ltIWFbLPFsL8kZrQq1ekgFIrXeAlLZmRj5aN5nz+ezO8/ftW5s545+zv9L3up8bR5/hh5A+9O7j+w2H3b7TA+ctuNhmjd4FEnDvH/a5dgw0bEylnDmfL6BWViQu6kcVQotQG0kyNTQ0Rk5PFx6//47xNNLWheX6xm2e+fz5Mx9PF1KC0zQRFeamrM0u5DRNjDEQms1cC4IVmmmprGqlMkPOxLSXRXWQ3VrNm08Yp4Egwtv1tglBDsNAaaYz01pn4gfryuEBRKnVtdMCTSxQqtXap67NAvbr9crzyysvbzPXpXAr1ajnCFIKRRu3BrdqIsM0JWIA89I7WKSABkGLUdolZlSV29qoz1fOU+Q8RVow6rfZMPPNQRuNQA5KjoGYEtN44nJ54HQ+M51PXB4euFwujOcJDbBqY54LRaBFsfKqoRDzxI8vN/7th2d+eFm4rYWfXt94frvRmpDSiLXMDqaLQICYCDFYW/C2QrX2tk1twdkwUxiS6Sc0VeaihHnl9eWVHyI8nSbeHm/clsLj5czlcmJKo9m25pnOYGNxmiamwUotVZXb9cr0mKyrXU9ySKARkThQi7CuODV/B2n2OfKlb/tq+OXzR44vdN/WA/hjF4z7qcmRObwfb597/Vy+Nh+3hNDhnN9/9muB7dfeOVqTrh9wl/71OKizvva4z+6LJfP2z+/Cm9vJHQ61Mzb6Z/49MexvYfvt+onzN/3Eh+4nxomoylyb+wnzHUMMBO1rh2oxcjOGYVHrzmqtn30Rr/uYrc2TekGsA1EILPNKq7YwHXKmtsqyrrTqAEazBJVJF5gMgaizHV0TsZW+ThATI15nrvPM221lKZW1wdoa87zw8vrCdV65lsatwlKsCURoummuXE4VLickJyKyrYVKFa5zYa1Cdl03rTjL29ibWdVKuRAkJVIeGIZx+8njSE4DKWVSHohDprmO27qupo8WA5JMaqIgvC2F1+vKUqGJUNu6teIOIVoTADzJLw1rXAIhN9I0MMZMiYWF1bo6dTscoUWYa+VWKmOtMFdqWajVkpNPTcl58KWGmggwxkrvrPWUIkM2vxDojHTrhNuHuUpEYkbiQNOubyfbf31+dUKC4mE97eBL7mfmPn/6/+/9xMEh7PMPPUzR+3Xz7nd0Wzv3uYd8qRH1W/ATvxqo+Vqpxv7e3V+/4PNfbv+PODUHRTqytrW3hrv19dFXBBHr8hTfgzT312eOQO4cQx+gRzTwPZ29lyzZQ3eGggMu/ThbXaGyTTIRB3p6C22fNL1OznHA7Sx7BeGGZnrgRz+Hberpdj5srAl3WvRrs8m8PUPVrVwHdTZG797UJ/Nx33bImHRH3Ol2m0Pt3ynbgOuHCB1gOpz39v4+I3j/mHrZ1+6c/V8deNk+sH/+Xnlnt0u2w91f23O927a2WH7MLjSl7Ewb2a+5j4vjx7dIpOvQ+Ckby6ZbWt1iml0PZ7+P9qGdfaPb87snE9u+EcJe9rbPC3v2HCiOIoIGIecEKLUMlGF18LJxupzpGtSv1xvU6oh/oVQlUPesQHdE3rJYagXtc8ROoami1a6jlMI8z6QQ0dasxEkatXr3Mu0lYNYVCsUy1xvDSTB1KvG23rqNf5v38V607fftm1v3011Z/4s3/8ZnUcvGH81GNwdgycmjx7jPgP6NL2APut/7HTM3lt2rtfH88sbnKVJUSMOJ8+mRMZx4W19p1UplCcLlcuIPf/qOh08fCEkoc+KWI3meeFsqnz+/8BAGco6ICtOYua2F1oQhDwTP1qC6Z5r8byGAsyCiCF0jimDnX+tq2gLVhHkVSDG5Zs7COt/MVsRoNdci1KpWPqiNFk3XICbx7oUZCZG1KLUqc2n8+Ycf+fGnZ27zQpOAEqmSrX31ulKWytqUpUF1tkyrShQYohBThKqkZHor67pYzT5q3dRiYG0Lrzdr3TrkRAqeCXNWalChbm2lIzEMpDSQc2IcM+fTidPpzDieSGmkIsRWifLqgopgbW4zb4vyf/3rT/zl85Uf31ae324sVdF4AoHSAqU1lmUhp8DldEZkQFFiVVJTVhqtgmXHzMaqWDenmARaYxwmLpcz89sr1+sbt9szL28zz7eF7x7O/OHjI9/xkYenyZl+SgqBaRhJYyJHUO/Q0poLf3qXKyTy9Ol7ND+w1sjL60opAfHwTqTxNUDkl2nNbDP4MDn4uo/7yif7741tvL3uxz0Ew1s2lx6X7EH5V7VxfkWsuANDwhZ2vbsnQlelg4NrOSx0/Zo9Vvia3dj29xLn3zGaX7b9dvxEO/iJ73n49PRtPyHmJ1AYx8ywmvB5ydnifEefuv5iCOL3T8xPaJ93rico3sWIRqmN0tbtJm0djspKWY1VLMF8R1NjLy7V/E30ZF0KnhR1nQ8VsQ6AtXG9Xrler9wWKyWtCBWhqNj13Spvc2VRmBtb96fkjSgkWblSiAayiBpzpwUQIkWhLpU1KEl6Qq1aQi3CKIHcQAlISFub7JwGcs72MwzkPBDTSEyD9cyoBeVKqyst572EuSif3xZebisV07TRLWFoSQfct8Qxcj5fiDlyXVbq65U1LUhRCjPXWzUNnRgYUuQyZS5jZIqRh9PEaRrQMrOUBd6qy3EKl5My5GRdAV1rI0W7ZzlFT+CEjc0OFu+upVrJL8Lp8sB4eqRpZl6V1tIBpunrIJtQ2sc831gP9zngb8hhjbW94Tbz52aZgat9ZcqdP/DF7T6n+W36ib9TTBjuzZ7fNF94/lqw5ddo1XxL7+bv3V/dmIdePuQLybihHuI18r2cpOsBBFLsP10gy4fNO/heFaNDCSjNJoBY0K0R8IEXxJTQbSAeOj7FYAEusKyLgy4gw+AOyXUzRAjRhLtCMEYNrbqh9lbiXSSxl+bcDbNDWVX/wRzaxj7pmiO93kgdTXexyL1LuJpvSGkbKa1VqOIdRUyLJBwGciuLPzNbJNjpqQvh4t2MzBjsJVgHgCVEIB6AiV4eVPsLm6DZ1mqbHrh3kGi3COrIyQErOT5V++zGvDoYtPfG6usHsHvdwQGPJDaAyu+7StuMY8BAxD30NT2Y2EEWZFPo34xbD4ZFnHHlx6WzxBwt8ZPT7SR0u/aujYQIooFApbpRsmtr/jhlA/EQq9sMMe30Q7BOY3lAYmQYTkzDREyJn8aJH3/6zPXlhpZKLSsRrMxDzMHLYKVtpSw4JQoVpdRCLY11MaG7dVlZ1oX57UqMiXEagMbtVr0jyv5waq3GKPBn09kJql0DyAHI0Lu7mdbFsizeuu/37d62difpWQW3KnC/5NNt7z7mvjyeiBzKEeWLpKt2G7BlXL6yoPzi/NiO/fXzP16HcezWWpmXQiUiMTGeT3z6/nv++n/+mecfXmkVijZkjDw9PfCHP37i8nSGAOtcuY0nllUZ5pUWMuu6kiQgMZGCeAYxcPO7FIdMK2U7xxQTOWZoxYQbwerSFQNWYWtlTRBbOMRoYBCgS+E0ZBrK+vpKc9HchjfnCIFxGBmHhLaVRjUwJAhVK+s88+PnN/71hx/5/HqlVkUl+71RD/qVtVRKU9cYDJSqIIEmpi2j7jtaLSiWaIgxM9+uBqiqCeumNFLbwtvNNGUGZ8xJ2syYBcSqtEGIOTNNJy4PF2PRTKMlUCTQqoBkchwIQyOhLCiqhZAqf/nxhf/x5594flt5uS7Mq0IcQBLzcmNZbkizMgJFWNYVkUbKCcv4QRLc3nkIJ4EUhDElzkMENeZPWVbWdaXURiuVtd4oEkginKeBh2VF9MSYB8Y8MOXBNIPqwu12Q0Q5P5wt81tW2rqAWsb7+3/4J2ZG/vK88nxdqRoRsXbgNpb3cf4+kL3LTn51uwdrbL66T/GXv0qI0PuF991RBHrLZd3OiU2T6WgQvhp8H42I3O1+9zm7Pvnq9e76Pft7QZ0Rewcn9RXCIfPb/QXOFvbj6Hafu49uiLwvDf9tbr/7CdMEkzG4n/j4TT9RNz8hd34ixZ5SVcKQodbtPibvPEsrzqowP6He3lqlM2683APrVBWTN9MohSElqkKpV0+qGaOyVltMWqc+QbB1RWcWNDW9m2WtXOfZu29aI4dSlQIQonfWgyoBcrIYa2nUVmgikCLDNDINiTFEptOJy+VEKyvXt6uxevCYFKyjUq20Zm29VRsp9Y5UYuuVmEgpk4fMMPTf3kwiJmLKSMgEAlESGYVW0FqI15lG4O228Px64zavaDBdoeANXNRLclUqOWceHi98+u4T42nk5TZT//xXCq+E0liWSg5Qg5Ji4DJmPlzOfPd45jIOXMaBROP2VlnKYgBZWbktK8PYGDpBIERSjkzTxGkayTm5jfdkQTBb1FxOYC0FlcDDh4+cnr5jbpHbqhS8rbfPsG35hs+XzcYe1nvyrsJj+4QvOuRwlG57PTF9zD3fTfLuJw7+Yreqh9d+o37id40atUk/DCPasJbDVb0MSQwIcN1Vo5UbiyYl7xjj2h4dCTTg+lgD59+DUQ7FVssO6Cg+5IgxOJ6yM26IstUfqsdGMe71s7UUWmgW9PtqvonaIBITDlMEicYEyOPExvxpeqinTFtHqRDjLjTcOyyJwwTi4I6XZNnWaOWK93mlihJSJoREbQa8HKWY0IbWAqJ+nwxsaK1S59Umc0jWqWQzFOoo5U7lEIczjw5+3+x1c58OeqWO/jtA01uXe2Z6n+Bhv3bBj9+RZbaWgGYUhW2udTCkWxr1wfVN5y8uruOuLgibcLLt5GNkH0DNs+QbUNW7c6i4gFlwAy39EO7Q7CDtiJa3RmvVa14V0rDfE8/cKtb2fdMnihGTI2OjU25b69nksF1XR9NjEkYGE64DBBPVw7PPDWUcBx6fLgxD5q8/fean5xf+5c9/4fV64zbfKItRPem3GQUXrOutEpdSDNhRA1fCEBjHkSEPvL49b/TUVstmSK19Yx9jshGdWmvOSGN7ngZIVkK0406n0xfP9re4qXoHMiywOzKd9obSB5q53AfgbEH2l4vFXsDXvHWl7+SZDT04PKDP08Px+rE7S/H4PV/7zs1po1vHuaZQFOvsM05Erpw/PPL0/Uf+8tcfWF5viMDpPPL995/47uMjaTKAuiQ4nRNIZm3C3JSXtyvX+QVBSUGY0sCyXA2sT4GQk83NbR4LtRSSNKY8kdRaV7emLLVam00H3+d5tfK8KOQ0MOSRmFbiWolDNj80Vt5uC7e1krEkRU6Rh/OJh4fvWdeZl5c3Xp9vXG83/uVf/8y//fCZuarZfbFObat3AIkpMw3ZsnfVwc5ggo6lWslgEmPU5CisBUQrta1bK3HLxC4EKUxDJoZg+HxRaivkFAhVCdEC1SYGUChKjELK0TUYACqlzKwxoVXN/6klRoKCNOvkFER4fX5mvi6sSzGNBA2U1XQbSlmRZuWXUhtNC7dWiElM10obUhqDWreOIQdqbG5DlHNUHgZrgco6UxZFaiEJNNcZqrXx/HZlGhPjeSRnazs+hESN1vVkWa8EgfNpIudk97WsDONkJQZViRpI05n5p8+s6hXvano+PZTs5XF927XtDvX+X2zH12zy7s0Vxf1UD7LvfZ0egtm+eN5KvnXHeTaw55Ct/CKLeUi4fcEG0j6f8a6IupVab6Xdh1MTcQYc3Y/qnvw6LEje2wQTTLXrOZbG9H2Cxwtaymar3t/z3/L2u584+omP3/QTSxPmqjy/vX3pJ+ar3aloMXJ1P9EXkrVWIsowZmMXNYvh1lpNS9Lj3WVd0WBd6GIcyMmAh9CUkM025VB4k4UyF0KAZIEfKZjArarpypS1sMzWQe82m4ZMaSYYvHgDiJAy4ykznE5ITCytIaUQCVRdtuYppzFzPk2ccmQMgceHC58+PFHLDKq8vL1RaiGGSJSAJWYbpSjLYvqGuQXG0XXYYvRuUfYTov10+YoQBUm+oNBoos8p02pGot3fshpItMwL1dmfKQqWQ61mF5q5xilPfHh84NN3HzldLoxvb9yWlXVZkVuhjJl2mZhzIOfMZRr59HThHz5+4NPjA+cho3Xh7Tny8hIpXezZS/uLNu8mbPqoKZkmUGuWJMkhEEI2hpf7ieqJEZWApIGQJ8qsrLoDpLJNvwPw4KBL8PVlZ+n28XaPgNzBKXQ/sdngA7izaV4e1kmbjzrs02PvDdiga+T89vzELwJq7k/+/bvyldd+yXu/fvs1zJtfe9wY47vj71GEbAPIF/vyruX1/gm2h+rbe9qTOpijXn9+Xyf7fn8fPNgiW3yA7Zo3bOezAQWyYwSAtVn1NuExufhp1xI5TrA7Fo0Pylq9W3K06XzAHY7t0/r5vw/pjpNltwQWQHKYGJ0ytnV0cqPQ1/pKd6obrLHfnSO6ezi/fR69MyZyZA7Z3207bui30JgpYvdFpU9gP7fdvN2PbxH2dM4ebBwePh382c+v30jZDaCIi6fJZji1lznI/oBbNRE36QZ0u9IeRPT7cI8+b8+m1e2cesnbPnZ1AzxoVsZ0LKNT7e87wNHbvDv9Vg8PRTAhsBgjvRSw1sFasdfGuq7b43l6etg6DFxvC0spPg1XiqqTqw7Xq3ZsE822Fw04DQdQtQvcCS0EasHO9fhc6GOg3+M+bvsY7+NQSSkxjgOn6XeNGjja5YPt28a6vtMM0A1I/CWbybeIC7I1to569K/Z57d0oLS/rw5OfgUsfe8Uv1YGUtWAiNYqb9eZz8+vfEyZ5dp4vEz84X/5A89vz/zL//WvaFM+fveJj58+MI6JlE0PTKaBNFyIw5kqgbdlof3bv7GWV5Z1IcrAaRx4fr2SQgQJniE0MFXEGGJFApdpJImV3cUgtFbQ2ihaHGC3IPTt9sq6zJyGiXGYyMmEJoNGwgdre11KYy7KbSmmRVAK1JX1dkMkMqWJH66f+bf/8a98/vxidzgIy+3GMhcIwpjMp8QYGaaJ05BY6sj1NtNqIwfAAZsYlBS89TZK0IquzVlz9qCbLwTm20wMgSEno9OXQgxW9mgT0QWQs4HAMQck6mY7Qa2z2yAgyZiWEqwNKV6+iNKWmeX6RlJlCEJohWWxbk+I2HkKDMk0Y1I0zYeUjAUwjPmgJWf0+qLFsptAEiECp2FkSMkWLqWyrIW3+cbL9WrPOQivy8rL9UaKUOvCeRp5cBHJaZyYhsgwpO05xBRAnMUZM1WF5+dXXm4zRXUT7t9LbH2WHBaev2x7P1fvndpxoft+C+Kafj026MzY46Hcj2zrhM3n//rt58pT+rn2xfkxKrDf91niY4B9PK6qeGnyl2fY/erxcz1m/H373U/c+4mPjN6ZDuTOTxQCb8tM+7e2+YnAwDRknl/MT6gESm0u6Ot+Yi0UMXZeCtaNFhHU/URV3ZKwIQau841aVupQGPNozBNRhEi4ROqpcjpXznPh9brwdpspywJlsYRwCEQCt6Xw8vLKPBfWVpnXwrys1GJM9pQSp9PIw4dHzo9P1NY4XSaeX95YamOMmVu8oTSmaeDhMjIE4Zwynz4+8MfvPlLWxZnMM8s8oxTUwRqrbsiUsOwNLtQAuxSD+8udgU0H1xykicnix6ZWEqxr3NZ4TRtlnWnrwhACMkQr+W3GMkpByAFSsjLmp4cTHx4ufLhcOD0+MI4jqjDExNvbjbeHmdvHJ2ot5JQ5TSNPlzPfPz3wx48fOA8DdV14e3vi5fmZl+sbr283T7I2Si1kjGGFeqlajIQUyTGaoHPqlRBW6bDpfabM2pQfX165lkiVtDW5Ad7Zv33rYMLPuw15Bw50WKUfTDew9fAJB2Nsv62GpOm9l9kWtOqfk9+cn/iVjJrDIu4Xvf7+/ffbvv/fih3eG8f/GNBmv0ExxE2pvJML+2LVwAAfTNEnMbIpP7NlAOTupn+t7KrWanS8O+TP3+wLxtbQg/5FU0Va87IlL11qah1GJNo59asJ4t2iLLuQBquzTDlblw9VW3hTLIhzNoaKI8wIqtXEZdcZScmuJebtaekBxKIDRngZj1PxVRWqomJGIoR74yca6W0V+3/dyEJDg1HIUZDW8yUegPZSFemMh+D3qW1Bn6dcLThsfeL456KZhU0IcceQNvDGNIscTHJwBsUzFtHbWBymrfjEPIwbxM/XTu74iHfAxXc3O7eDDb1dtEi05+PGKkQLMmqtlGVG8K4aMd91+FI5BiTvg2m/olYs8AiRLYAJYdOgMYfnsLgKxjyysUG19rmqallrvybxcdF/Iy6uSSNtHQEi6sFUlMCyVuuk1CrnxzMahGEaDBCZBj4/v/Lj5xduq1E4l2Wm9tvaGjkmNFuNuEin5yb2LlRWeqAh0CSw9LF2Z3/s+RpRrLuJ3V10XyEC0zhwPp14eLjw+2ZbH2vdwdmmm338wjH+LZdxeLtTT1trpM5y6u/7MTeW2uHg2v/ZbfidI9Wv/n3cWqtISKgqy1L4tz//hcv3k5UdjYHHPz7wT+s/W029Br77w3c8Pl5MxDFGRBKSRmIXLIyBIo1hCISghACl1k1LIA+ZJmIsE7UUnQkEW6CXo4Eshn8ESMlwCAmstbCus82dcUBr4e3tlevrFULaArVhHCw7GiLTNPAk0UtxVl6eP/P5hx/4618+8+OPz/z00zNv15kYEtoK87yQQ+L7f/iOjx8/8vD4wDCMVi6sdh5pSPz402fKUlhmE/ZWrZS2UGtBYjThyrWyLpW1FZampN4FsCm1GAi9LishWyZU1UETCUQRkijjEDlNI8NpIA6RlNKWXWxaUC2EWJHog8y7IEaBIA0tM5ch8w+fPtDkhet8RZoyxC4MqaRQrMNKGIghkfx8WqtcTiPTaeDD0yOPj5/45//+v7BWL4l0EXuplSElpCkvr2+8vF2ZS+XlduNf/vwXfvr8TBNYUNZmi6lxnHh4euDTp0+czyfQgtTi1GllGkdyHpjXgkjiw8fveWuR13/7idu6UtUWJOK+1+CifWz3ufAt0OZ9cGpWUN7t4z6BPX75akTmdlVb90P7kY6lWPsc/mXb1/a0srq2Aexf3/ToEbdj3eVY3sXXu+3yGOf9ufT72AGGdwuI37XM9u236Cce/vDAPy3/ZOUyHPxEdrFfSUh0PzFYuWORRh6se5AIXupqieGU3U94cwYk0aqJ0+aYTb/EfUoIAU0JibbgXquVI2mAYcy0WplvM+ttteBHAuIixDHAmCMpZcZx5HQbWOaF2/WNdTFG5jKvXK9XE6ivJghc1pUUhIeHC6ezl6Q+PHB5fOT88EDMA7dl5afnV+al8Pp25fX1jdoKMQdO02BloznzD3/4xIeHB5ZloZaF2/WFsty2DlFNIiknpsuJy3lgXa7UsjDGyJiS/eRE9Li5s9JtLWFLB8GAKwhWGl8sYS1BjK0Z4PE80r77yKoWr16vM60ql8uJ83lgmjKn88Tl8ZHHjx95eLgwnU6Mw0gU4TKOrMuKqrVkByWnyDgMDDFyipHzkImqlOXGfEp8fDzxdrvxw0/PPL+8Mq+LlYhpI+eRx4cL4zQwTieS6xaBAzOhoaarQa2VIIHT6YLGgZelMDcIOSJiyXizUGEDWzrzcZsPd5PtaF/lbpq+j5vv5pje/fXlHFZf27nXUvCE9WGS33/Z39z+q/iJXwnUfAug+Xu3959X9i4CO5L960CZX2jZfV8VExatrQAWPNtafQddevvTu3ITPy9BrC2ba798S1h4N/h4Fs0fjJpCfDwwZd5PkCNy2GqjeRcjaRCCknRHPanipJhG7GUtVtPlrAi/xVEcHFBXDRevWGkmVtisQ05zcS6j5cc71FQcRZUYnc62wUWWRVOB6uU63gZPnf2wo6R4d5OyPzO7SQZ09OekhhBblllpWKtCFbVM60HTZ7vn0sES7HoqG8VSJB6epWUn3zvxDtr0Z234i09wbyFtwtN2D3aPf7xDXoIl+9+7cZMNzNFm3a+6RbOvVdeVwcQ/dT+fIKY0r6068NXcuMbtFDZD09FoAXHcWoNapll1B7q8u1Etqx3PjyAudqUtoLV5e7zqAJKJZu4gJdA7bAF4JzPxzEoLjRDtXqcQiVgLbw1KE+soE1MiZ8vCPD0+bHTp57cby7qSQmAt7mCCd7Opjds48fz2SgyRnBPLslKW1cCsGE2/w59zxwQ76H0PlhrVsra2iQeLA4VFK5WGhg6a/b4pe/2tuqO24Svb3z04wm3j+0Va//d76iq+r3ag0wPq/sXSxNsPd62p/YEqoJvvU++WoJvGSQd1LciX7TO76Q4EDRbwKAb8pQREyrqSx8z3339EiiISOT89kE+jAQZYxrPWG20pcJupItyWhdvbG7UWQhDKujAXIaXAIEJRZXG9mf0c1cR93TdF12yJMdoSPARCFSsTAmiBNJxgCtxeF+a5cJtn5nV2/TK7nOF0MsHdYSQPmXE6EV5viCSzIyHSRFiWG+fTwP/rf/tf+fThe4ZsTLKUM+fLmeAta/MwMKYBkWAgC4F1LaQc+PGnH/nXf/sX1tZ4e3vj9eWN221hKYHbWqhqzButChkT/vZSJwlKDMqYonV5isI4RB4uE58+fuDT4yNDskVHXQqaE6qCNjFmnThrMgQ0JiRl18pKfPfpA//rf1shBUJS5hWW1cpQRQuiKyk0UhzJ0UQoYzKm3uk8cTmfNhZgmZ+3VsA5JWPANGuXKqqgmZQNgPten3h6OPHnv/zIX54/s5aZ6/WVa4bSHok5oaK83d6QaiVYwzQQ4pnaFJ1X8nCCkJGHzLIoRXo7dJCt/5RgPbcOPsXnw0Y4F7b5eQxb3Du/0/xwHyTsrB2fRJ28I+zBrPhc7q1OxYMZxdxOB7/7Pv3M7Lx+nv2zn1c/b4sZfr6DUPf43Qro9trG4FC81eoOGoiAhr3zTfcHx3WJ85u8FGbXS9DftcyA36KfMF2qPCa++/4jFJAQuTw9MGx+QtxPzLS1bn7iuizMb6/mJ6L5iaVATEKWaH7iVujlKHisH3qjD7FuekEgxrzPy4h1qUOpzcpnZIisS2VZCvN8ZSnLLkgrQhyMbTNkIYaBAMyyEChohZtYGWjTwvk88KeHT5xPF3JMhBgZxoGnDx94eHzk9PDAdDoTYqI2ZamNslaut5naCrUVVKvpfqKcx4EUhOUmSH0iaOGUA8vtRlutQcSQMw8fHpmmkdvtldfnz8SgnMfMacyMQyInK4s1JowJ9KIB1d5TsK/NrKNTB/VTHpjOJ77//iNPj0LRwOt15vX1Ck349PGJDx8uDJMBRnk6cTo/Mp7PxDwyqJ3f08NlA7G6vmcQ60iaEII2glYTMa4LQRrjGEn5REqRlAI/fn5mLivaCiEEpskE6uOQfCh74tSHdq2VshbrIhgiQxypebJETTUwKvT4/mD075dBevf6cYmj/r7NDa+A6MZ9Wz8d5uIB2OjH6jN/I4D2ltjo/h1HC6L8Jv3ELwJqvoWT/HL85JfsuJm+L985PIS/Bdrc73s4g8Mfdw9VTR9lnmdKKa5N0UEM2QR6N9aHrVg31O/uKg+LVQtAlCOdqaNpe3s7//wWqCihNTSGu3P0tbtN9GIAyjwvxDwYfW6cTItWsTZ9MZCadWCKyWjYFSB1sdT95iidUaG0Wmjr7cDM2I210h3ArpGzX3fYJqjCjoIeaHXbhRL2cd9xJK3OcOjn1Utp+ml6NqNZplKx+2oDvjlrwoCODXsRwAWO7RoPmTy6VWj08rUNHPO9+vf38xbZP7eDaRhbRzDmSQvbpNxOoU/WDvhslqvfjz65w4Ymw0bA2XYz0eGuqaPbPSDoxoDpH9meR7/W7fXdAqsEQkh0MWTTuJG7blK9HlP9vO9K2Xy33mVAPAPRP7d/bb+PetgHYkpoqbRkbWfHNlk2eTp5dyYl55XkdbgpRlIUat1BzA6oWmmTCUm/3m5b6/ggxpwpa/HOOYd72ocA3XCytYG3YMcN8Aae9s/ZJ1JKTL+35wbY6ofxsXC4WWyBcR+Jh8D7vXN973DVQVCqCwgiGy22Z1+SB99Vu3oSWwDeUFq0oFurnWjQzvg7GiZzpyaIjgliIwQy0gJRLQPz+e2VuQyc0kBdZ86XTJqgPFy4lUo6DeRxZIgBFVjrwrIurFVpCGuD21y4vr4wX98gRpqKiUUOQlkaqVlRZfW52GuaY7ROTK0VSoWgJpIoMWzlj+OQreW1hX6EMDKNgqqVHF6v1nHo5fbGbb7y+tdXlmIdp5pGlEgrJpS9loW1rUiC7z994L/905/4x3/8I2M6M18r12VGBJIzM2OAHCKxLtS1UufZAt6m0BLMV0aUoAWyEM+J8xBYa+Ltbba24LV4JyOhVdcfC4EQBZXGkMW6nwyZy3niH7574h//4RMfH8+Epkir1LUgGtAi1FnJXThehDQM1KhondGYSXnkw8cL/10CZJjOmeui3jXJ9bvajGghRWvvOo4j59N5A6mmcSTmBKkzfkwI+jQOTONELUZxF5Q0CGkx2xdC5sPjme8+PPF//8v/zY+ffzSB4LLwl7/8G8ty5XwamaaB85B4fLiQhwfTTajm11xKgirKzVu71haQaoyhtiU69oVtz7pu09Od7BYNyCEQFUW1GsP4MLdFxJ4tupNIj7GWmk6e+UEDx1XUOqPQC1fxhM1Oid8CVXnnq74WhKsnMHrMITaLozMim+686K+FjIFoNklLv7jNJzT/6nZwwhub1+9L0L6842DXxBYuHnvsfvR3oAZ+m36ilJnTufuJM7faiKeBtPkJZa3W/GAtbfMT17lwfXlhuV5pMZgwboy7n6g2/su2eHY/EQzIblqp1eapROsS1BnrOUeSmM0HA1/GMaDNdDJu8415vnFbbszrwvwyU1ujNihGpqYVpa7V2M11JSR4upz4+PGR7z585DSeURWP4wZnnoyMU2IajaUDwUTtVSkPJ5oqy7oAlZSEKEoKJtxaT4mHU+a7x4mXTw/cbjfm28JyXZAQefrwgfPjmXl+44e/jqzrjcfLifNpNEaN+Lqktr0jlhibCRJoYjMCwdjXSCTmgel85uMnoAVKhen1ymUaECKPDxceHiZStoV3GiPjEBhSQKKQCAwx0oaB1irLOlus3RR1PaEUBK2WfDc2aEUpZs+CcJoytV0A5bYspGSacmDM+jZXmnSJAUxIWSypr1Wto2xTqidDJSYC0RL9WqH3EnFNyd1e9hlpY7+va7aYvq8hxWxceDe3Vbq2TKdf9Di6r4Vs/m1WQLjzE3csOGUDV3+LfuLvEBP+8mr6F+zBgPzs/l896mG3X1dD/cXZ/M3vPupwWEu6wtvri4mWlkIMYXuolj2zgdJ6P2EPUA6Eiy/OvXeIevem4RN+LKFtC8pOcW84LfuYHXAQp5aVWivruvL58zPT6cQ0TXhvD1pTylIIOZGHgaZquiAx0jwoIkbXCvFFNUDIFryWmeXtheHyYEroWxeqsDtDHMTopTlg7BS6kny/B+psCntVW0NiMnBqW8c7+EK7F6NFzKA60KP9SXZKuap1Q9KAYi37QjSx2y3bh24MEVBiSPSUtJ1dI7iYrT3DLsjsxqD1YBLonZe2SapbILE9115K49/fS8Du9hMBfTdg3NAYEOPizXedpHrXJ6GnwrtejTFwBAm9ZEzujomake7du8wYdEMhhJRBrca51XX7bM+4Q7/3bnh70KQdDLLvCyHYsxZ/2u1wfxzIAkxR1O9jiEbJTakaeyZMhJRY14IxnALX2YAaE44DG4my20u1sRiwtr+9rKoXu6cUqc00cHJO27VsRhPdBMl6CWLzsjprM18tA+g14OEAQA3jwOPTE79vfJGYkK/8a3vlncH8NWUPXyvX6EGqOdMvz+FbSRMDV9+95h/82kcUWGqlxMj08SP1pxlCZTqNlPOE3kxfZCMdSgNpaFtZbjO3uXC7rby93YzqfXsjjgOXD9+Rh0wpC62sSBjJOVOLutirLbJDiMQYENz+1ULVhhaMJUizjHEMm08K0ghigcYwDFxOA6pPrK1ynd+43d54u914e5v58ccXfvrpJ97erpTbQlDhT3/4yIdPn3h6eiCnwBhhzELQREpmN4YhMEyTdRmJEamBkgqnMRnTploGc54TQ/5Ayol5nnm7XT2DO/M8vHG73VjXaF5ErW14j1tiso4n0xQ5n0ceHi58/PDIn/7wkU+PE+csJPdHzUUs12UFImls3jElUFmJaoBSTYkhBh7PE9N0soVIbbxeC1OuJsqsDWkZtJBiZhwnTqcz59PJxlyr1OVKkokcE0O2kjfNmZSiaez0tqlBGIbAqQ4QxUuoI99998T33114fv7M9frG29sL0DjlwNNp5OnDg4lrnk5M55EYdlBldc2bq0RebpXbPL9bAHd/9rXJtA/s3R7ubylf/9gX8+Vv7NDD/M40fr/Ahl82999vX/vMMf7sS4Hjd93rr337Cvr138EIsvuNr9LxOdoTtfnvcZD8jcztb2X7rfmJ8cNX/MQ8H/yEz7LNT9w2P/F68BNhGDg/fTI/sbqfkMFKoKolZnc/4ax+DMylKVWbl5U22uYnZG/yoc2YA0GIeeA0JOrlxNJWA22WmWVZmZfC29vM9TazziutNIIqj5eJYXpiGhNDDowJphw2uYOcBy8PSuQcyVFJQb3xRXRGNiDB118w5oDWxeLSVqhr4DIE1jHwOEbmeWG+rVyvN7QJl4cLj08P1DoxZphvb0xD5uE8uM9q3gHrAObZ4sd+gnV8QoJ1HQ0RCdYt6jSOyEVBg5XzLjO6dlmGQl0Xi8NtkUIKmSqR0Co9lo0iiCqDdqF33Vo8B0wY3+LwZr97S/Vgz/RyHhnGZGtQf85DjgZkxbAnxYX7ZiK+li1rZY2Vlu2yoze82TAXnw3306sDDvsc+fqY7ytX7vfnWxZ2f/O4jw2BL8t/VO8+8qv8xX8VP/F3atT8Z+3/73dov14sz5DH2UGa1sxoaejZf6EVhyAUUjRDeNSQ2SMb3ZAbPSz+7LwOO6tRscO+u1HdmxkTySZeqCH6xFVqtU4b1jJ04eX1imJ6IlGF2qxdKyEQa+I635Dnz1wfrlYH6T/RGQoxRsq6UFslDQtRV4JWpJjIowquT2Ndp6iVuvRBbsgsdAE4dxLO1tkW9L1D1ReT5TC8m1LrunWY6qAOdNBG6WVJ4se6A42qCUuqmHjjluLb9G78G1N0ppCBSraXdeHatWjYvqNqJbRu0o1GL2LPxbAldbS6t8DoJtfP/0Clba3QqZVmCOyoZry9Y0svR1OgCdKcVeWLMBUhkCz2DgItbBRB2281418bMe6QxAa0iGyOWx1sVPa2fNQONAGkeyOrCjTrLqOBoNZeUaJ1WJIYkewr1FK9lEtdx8af/9F5+OJBBBNBm0akJkIqrOvFS6saacj2kzMxZ4aheEthpcy2ACwV5qWQh8DgbRfXdWFdi4n9lmKlhmqlYimpiRcXx8MCbLC/38umrgMi9gyKs+xiH+d4qWPM/L59I8j9hulX7Z0//h3ft2Vy+jM0m2pt1L+MoOXdHxve5kH4BiTqveM9nDUqyrUU/scPP/Dxn/9ATZmlrpxiIudAXBq0FdHBUo5BEanQVtbbG28/vfL6cuXl+Y3r9cbL9YbGwJgnLqczdcg8P19pGC271uo6WXZepr2iNKz0NWhFiQYkdtZg7Zlgm9etCTGYNpnWGV27La1MURgvJ05j5nGa+O7xgesfC/N1ZkiZYToxni9Ml7NTqG/M1zfmeUXLirTGKWVEKplqJUkpEFJAc6aUQkqm29BaYMgfWNeVgDIPgSnDuhSW88ApR96ukds8s9ZGadYNqTVjt12mgaenBy7nzOUy8fHTB77/7iMPp4EsjUyFaoKZrTbqWimxIKVYVzcssM2SWMuCWosp07mJcDmf4B//QGuVv/71M8+vC3W0DKg2EzLOyTRwRAKiK1GClSIhqBZktpbbVSDmRExnoiilVUpRJCVj3AwJpSJSCFEZh8THx+9p9RPaKrfbldeXZ0pZGMeBh/OJPIzGCKwViYGyzsRsGdG1Np6XwvPbYqLQzcruRLW7o182p+6H+/bCfybE8PNMiV8P3tyXydzbmC+OfQiQv5j17/6U/vnt/d07Crv9C/TkdF8B2W8rh/t9+635iQ///D3tm34iQxXzExSoy52feN78xIymwJAnzqcTJxcUrlK31tn9PvWForqfMDZwtfVMTy6KxZQW23T/Uj0mDRazObM7C8iQGJNQx0wpjfU8cbsVlmX1rHIgJCsJVS2UdUaotHojMJi+TRaGoCStJF0JGytaCWLlrCkn127JGLdTKctKcQZ9DRCxpO7cVqQVojTGbLo6pynxcBoQyURWbrdITsJpHEwo3r1i8E6t2kxXzXuW2GrDAQ/VSBGL8VJITMOArnVbkZyGRLnNzNeFW1moc0QChBTIw0i9rSzTzeLWlEkpE2OyBGMz39Oqd0+NgSrCsqysy0ItK62uKMbgSH5vpiFxSSdPRPZEv2ylbipWsqVqZW3iFxYcrGmI6TrqAajY7BS75vwRpODLf37TTxwWDPcAzVcQmft3vkgMfHVebevofX39rb3/1vY/o5/41Yyab5YQ3e/17m/9xnvf+vzhMf8d2ZbtKPq3j7PV0Tn7ZOv+JL3YaW+b1cEHM26OlolsJIp3R94+07Vp9u/zmkjZ8R066i3WYq+GSqnVRBarBa7zbWZZFuZl4Xq70WrjLb7xHH/aMpo5Z06nE6bDoZTaGIaBcTTads7J9AjGkbKuRrereD1+I4dA0kb0lXRVvHCz7m3c1JkefRC68noTfKHgF9sX6Tgbwxcw0IWT/PXOfNkU9t2QbAwOK0HZipeOPtZX2xva64yYVsoGQkh/dn1iNWOp9FrRXo6kHASmNnBhn3i9/GvHmDo6v591f57q9PTWKnVdNjBoG1cCLZguQiCa0PPBGHS/2mu6Ddvwe+GMlY7Mq1G0jrfO9xcvr/NjKOwOe78+XOOHrd5ZdwO8ie4q0ukCPubNqR2Os222v3L4Pn9WuoFpwT7Su0FhNMQhJwdcsnVZiZZxCcEc1qBKbbC6kn1ppueRfJ7lnCjFRIfPYmBLCA6u+YItpWQLQdWNybY5jeNlbD6rPwM715wzebAyl983NrHvzUkJNp/26Xq3tdZ2MJfdOX5NqPF9Bv7Opvv/LEva9vH2fs77pFSPvrXPb2d7bUcMoZ+6fZ//38JWywBeS6OmiXR+4vb5Myd1cLYWpEWimnCf9wFBRNG6UpeZ5fWF5fWNcl2ot4VZleXtlT/80z8iOfPT8xtz2cfZdp3BOj8l9Xaiamy2Vg3cNrkxaz0dfG6rCpSyi7IHo5ubmK4iOSKiTC2yZgPkUxxN3yklQh4IKSPJGDDX1xfeovLcXimLaZjRKmVV6nwlxeytT+PmD+pqvnNZl028T1CkriQqKhWl8njKnIYHbnM2zYKmlGpj4enxwvefnvj4cOF0SpwvE+fLiYeHE0kULat1IVndt7a2ZU2D015LKwT3cagxWFELulOA0xAY/vCBYRz4y9OP/PTTK9frzOt1ppSVlI2zWtZCrStlaRAiRat1g0qJGDM0W/BoUV6fP7PMdr9zztDMvscoSLSgLEghp8aUM2nMxDghH86snx55fX1mvt2QthLjZF2+6kqZC8QBlYE4CITI2/xmwB/mM8UDY3FWp3S/dfBvm886MG60/89dQg/gt3H4jg0q74LvPn+/Jsh6/7mvM2vu3/Mz/wo74mufef/6/aLjGIfplkzqjAbd79K2Yuls543V3v2YejJpuzaLSpzrxtat8XDO/54Y9r/S9rufULSt5idaI8RgWhZf8RPr6xvlut75ie/+9A9oMHHc29pPpTObbZ6UsrIStrxhUHz9ohvpIvizCH5jtDVfkApI8O6DJpcQkyVqmwZPeI3wIPSw0DptGVN9WWZub42yLsaG0WrM9xZpa6BoRetKSgstDyauHCOUREsG1KQYCQKlFdbbK2W2UqFaFpZl4fp24/XlhduyWGUCgdG74l1O2QCKMjJERaSRkxgbW9S78IldalMHa3TL1fX0JbCBNDUa0JLSjFZlzJGnhxNB4UVeeX154/oys5aFEMW0fMaRaTp5qezEMEwMg8lUGGCj7qeUdVFKrczLSimLJ9wrIkrOAcnB9OuGtDUp2GJnG+x2f3xONPFrUyVuXYkFQqI6hwrEy798rPtrO8PkCIxYPHEEWY9+wpaJfecOSMi+X5+A7fj5zvR3v9Tt6mFNTf+t/Vzu7cBvzU/8aqBmf4D9Mr8EYY736p7O835/Pbz+/8y268qIT8i80a+6YWt6uOGwDSq/z4cbLHfH7Qvuvik74UP8sTd/owdYqrAqG6ATY6Q1KKVxvd4oZTWg5m3mypXWKmVdOJ/PjOPANE0uNBuoVXl5M2R3mibGcWAcMuOYaY+PXsPYqMtKc1R9GgaGDtSA1/oq1LI/2GYdf/rldmZBEK/bw12g7po9XWQxtGAlO476NNyRNDuX45q/1xdrrSBdqHkHgswoOKvHnau936hlcYPQnXBHPhpaTYxLondDcVxCD5PLhoADav3b/LmIFz02bZtxE1UXV7R9ay3WOm9dKMuMqchHkLhpoIQoRBIhNtJmMu37WgewqrFzxFAwZ6nYtVR0e4ZgWZLYy6NEdui2j9nWDiVdRsk09CYYRdKNT+sLKhv8DmZUwpB9bNMH/gEQsnG8de6SPiB6GV+DYq9pDBATiHqr2YiBZMFAxGFgHQZyTMQDWJNyMsMmkeKsq9UZVc0N6jgk5llMbBibBzElK4UQu+6UEqUWaqvU1WzU7lTEh1LbgLwehCFWstAd8Did+H2zoA8PUMGnm+hW+ozeB89fC7K/tqDr730hHAl7tlUMMG30wPkw32GrR98+by/Rs1A2V+xAx3iiO2V124xa9nJdGy/Xwnf5RNHAbVkJ1Qv3S4FmmWBVy8AlsRam0tS64BWbg0ECKUBKgfNpQppyeTizfp4J0jxDqZ75hLUUokIaIjWYALtlY4XmGUNtjRTZOkohSozWXSLGyDiOhJSoQNOClVpGwjky5ImcR78PSh4nWkgsayWgDPGB0xg5TRMP1wuvb29c367Mt4W31zeWZUWwuvx+/2rPzgo2f4NJ89VWTYdK7ebnGDmfzjw+XggxsjalaONyPvPdxw98OI2ccuTyeOJ0mUzEOzTqutBUaNVAJ+1Ba61bcqW2hq4rQSEGJUpEJAMRRYgx0OrK6WEkj088nEduf1x5frnydrtxvc28XN8oa2W+3liXRsU06rSu1gq7JWpsVG0ET/Yg0GoxjTittBaMyRoSUx6JEVRXA9laMXBOrBtXGjNT/kAtFwvim9uoVglqWhTzuhBKRUOmElmLzzZzZHtAfgi53k8vke77DgvnfXf6rNhc8nF1+pX4bw9w5atz/Diffynz+W8lBr/2fnBf9n7v/fNKCJ5sOsQHZuPDliAS5EDQ3RfzW4k03WrY6wE1LRH/fvEoL/zenhv47fmJ12vhUz5RNO5+ojTzE2ol233p9zU/QfcT0bpWnqcRrY3TeWJ5nu29tPsJ1HQsV62kHKgtmJ/w4RrEOeqti9MrBGvGEbyFtbW6Nu2ailLdj+Gi7EFMy8WAd0w0WSJVYUmRQZTbzVqFKyBi4ExZoK0BuQVSGsijlW7VIMytbQvdISVSDGhdWW5Xyu1GLQvrsjDPM/O8Mq8LRGPyxDQwjonLeWTMkbZWpiGRwkBrBQnNyeoB637n8XHTjYHZWqO2inlRUCIxDZAqNS7EmIkxU9uCJBinwRN+pg9X1pnlujC/LhTvsJRSYsgD0zBZrDiMnM5nTucLIabNjJbaWEoxNqRaY5AQYMiZFEdbs415kwAQTCYhuA0NImhKrLWxNiuXUtqeRNXmScqIYgnLFmycSgcjDsln+pToMXyfuxz8RB/1qhaPb3v0OXH4W7q91B3c0L6X28jjNO/rNPrc65Pv/jveb//V/cTf2fXpeMOEb9/AL27B4TP6M/v9+7ZfVf4khoJO04mHhyfO54vd+BB8Lap3x9Oq20MI4u28++KOQ0nON77fxIoDKlaH3wvxgwi1VEop1HUl58Goz5cTYOyYtSymEL85FyFK4nQZGXKyTO5a+B//9m/WrSZEpyYmXt9Mc8bYNQOPr1fPBKatjV+MEUmCXBfGFjg/TmiwwVdbJQYXW0XBuzRZ0BV2cMGzlgAxZVRDR7uoWlCvg22duRSziQD30i8f5daNJ9rCphhQ07oOjU+gfUmAzeVSrLNUNyfVjhexrIEZOQcTNjaJo6HaW7oaWGP1qu+Hyu7090yL7ODdupihVGWeZ9ZlZplvJgSaMikev89qh9c6g4+l5ucYY2adb7SyUperGwdQNw7dmUqwLERM0c7Xx3Pt7CcHUOyaDAwTZ6IQXchRrR5W0mDmQhu1zLRSoFS3r2Yww1q2sW1A4l6a0ap3ifJ26H1TsffqsthtCwFaoKPpIYJU3borjaezidU14TT8xJQzN2eBIRBjJUWjzN7STGuNtSq1mrMbh+yaEJHbbWEcR6Zx5O31hvXEsa5mzenPvfMI4O0YfVyi7jPszejlVxIT4/nMeDozDr+LCYNn7Q6+vqlunQfg4KR+wfatgPv4/vH3XUZWnFh2CKjF1vSbw+zPtHl7+OOpbcF396nb+Suh2XUtt5UyV8bLhVUSy7wwrIo0QUujlXYAKUFUXJDO2InGpBRI1h77j//wRy6PJ8ptYZom5KcZ1DKZ3bW21jxAdhYYWLlhEP8JVjKreAvpgZQjMVl70Wma6AdTVfI4EuOJGAzgtTLMvcxVIlZiUy3IP5/PBDlRy5mHx4XbuvL6+sbr8yvX1xsv4yvXtxltaiXEdTUwqikpZ0BJ0UTDRSuSJlIcbK5Fs1spW2luHiIyDBRtjMNgZU9T5pwiaRiIU4agLOXKrKsxVSpoM3Bc2wGs0Z0xZ+BzJAaBOCCSiCEbiLsuTFRyDuSnE0+PFz58eKCo8Lqs/Pj8zPX1RrktpqUzL9Rlpa6rlUvXRqFStZHUFwVi937MiWHMhGwdqHqwPcTMMEzkIZLiIQxrDW3WBTKNI6lWG1fNfKe2ynx9Yw2QLgIhEYcRk3L07n8bnft9nNXnSbdvVgrQ9+yL0f6pu3KPb2zvA+Avqelf7rsnb74tnvjv3uTe7nxxPtITY9pdOXj8tidc7sGnu497WezWWNO8qlebBW/u0EPw/8Tr/J9o+635iXVujOfuJ2bzE3r0E76Q+xk/ISkynQa+/4c/cH48sVxnpmnkp8+zATlD7F/uySor7WoupizevcjkGZ09oyASCSFZuWqElIyNTBO0mWZKDMYqEenNU4AmruMn3rlWkBjJITHmzOAdCW+32wYSdcaOaeg4YFfqdv21FNa1UGthFiuJqsvCMs+s82wdr+Ybt9l8Yx4S0/jAeL4wnE88PT1xOU/kHClNyDGARmowMMCIldHWGSrUCrWoaeykap1TmzGb+izWkNFQIAzENBLTbG3YRZGAdXjKtn4aThPTywMvr6+8vt5MomJeuV1fedFXB9us+cTp8ZE8DCbou4mr+/yIweVyMjEO5DwxpJGcEsnv687kwI20r0P7fcXWkgIU75KrajpGosnC89p8X9dT8fF2v6x31ryhp5st28GaPgncX8jhhf0g9/+Sr/2xwzpKX1rt4E+30X3e/odv/5P4ib9DTLgbwC+zJvf7/BxQ8vMgyn8EVfSXgTX7YGlORQzByiwk9JImeyAbRetw+vLFcfbt+ND6uTQXJe2UzlrMQNRSjTlTG7UW1nkhpsLNF7fqAfa6ruZw1LKkzYsOa2tcb7PpaKS4AznuGBFjouA07HEYeLvevBTKdD1StCByXlfOa2GaVjQEcnJKu4SNlmjNfeo2qZC6I6y60+ZQ0y+xjjzi9fxidEPvyNQFWrdFsQvlNhox7R2ZOjtGPfCmNfOsB2fdaiW0TdPfSgNUrX2tNtcidsFef+adCtKdfXNGSJMKslcS2j1sd+NeFWhWYtW8/Eib0dqvb6+UslBKYZCM1tUEwjYRXtPmidGALkEoq2Va8jDw9vLCcrux3l6p6+Jil9Zt6HS+8Pj0xHDKSIwOttn1ayvIZvUcjBEfQ/2cUWMAHNpL9/K87dE5k8a5ZTYPmrfp7g+sj/weFG0Tw6k8qu4EC9qKv+7XK2Gvi3XAL0gg5UjOAzmv5JTI0RTuc0rWiUWUEKx9Y4qBFAKlWea+lOatDE3Ic1lmKwn0rJrNuy7YbL+Czw/H7Bx49GvqYFIwR5uSzZXL5YHz+czp9DujZtsOpnEfZ/21fX59zba/X05+y25/GXxDh3a7Ce5g+TYHmjvJpttzVu1B7e6kN3BXthG5/V8UCNZOXpow5hOX8yOvIVtbVXWgvSplqUStaPQFRG8NoMZg09DLkAL/+N//G//43/6ZOGZGBAlvnrUUbutCigY4GkgpxGhgTa3N9F8QF583fZiIGGMkBAvMTIGbpc7EkBnHgZRGJI+u11DRtjojTzxrF1hroanZmiiBplDWlWVejL4ukIfMw+MTD5cnPnxYbWGyFpZ5ptayPdk+p4bRsoNCI8REislLpbIDyeLMH6UALQZyjoxReBwSpxSRlKhBqLrawioIGiMSA62ZEKU2Y/IU961N1dpjx0iIA4oSwkDKE9Op8fL2QmOh1EIeEimI6c+MJ1rIpGUlTiPlQ4NqugmtFG5vN+brlXVeuM0zr+vNhB+NYmhZ3BBISTbBx3GYOE1nTuNEToGcAsNgLL3WqrF/SiWGiFZnJKmXc9YGzcoHWis0TBgzBOtMYgzWPRA8TMn7uSbd++hm778WbR0D569t/f1vlTW5+fxK4Polm+aXldN/eR3H7cvP/VwM2YN/S0xY7BG2BTsep+z77ccT2RnWu8OUd/c80F/Vjn79vtn2G/ITU54OfuK2+YlWlbpUqlZa0K/4iYiGCEFJOfCn//bP/Omf/4kwZoamiLxaRCZia4JhdP29nsyyhgqteTMR8SW2WDI2KqaP6CtGCTZESysInlTEzqHPByt19aSyB0ulVSrVWIBBUAmssZfxyyYkX6VBBhm82bE2yrJSiyV1l7KyrMWSg/QuvDdLdC4zdfVugCjjOHB5eOTxwxPj5cL0cOH8+MAwDhYbRnFQIrjGpM3r0NdAWBzYnPEeWnYpAbbnqb0zLQkJmZhGQhwIyeLPbueTJ+7SOJJPZ4bzhelyY34zML8sK2VeWOeFeVlZSuX57UocLEGQcvJkubG+h8GYRjklJk8w5jRsZIAgPbHoaxWFVmwtuXXSOyTOpbp9o21rQMPpdPMVuN/YJthxPHd4Tvts3RlgfTK+X+l/y2d8Ad/4enqfwrJ/vTjT8w7Q+W37ib8DqPlbF/efhHz9iu3bD/HrIcy2QEf2LGVftOH0SbUWq9ug1T5k5W6s/5Jz6+c3L4upca/FjKufxzIvyLKaHkaMWxDWWrUaR7GWxBVTCC+1sCwLQYRhzKi48GRtrK3S1ARYO1Az5IHXlyunkwXP58vF0eGIXK/WTWJdIMBpmjbmTYsWyJvR0C+AmhDUS2vcELRK1AwRQnAhXMzJNW0E7ZSyHazpDsGyivmAHGj3nNvfX2ZVMLEuD5bVy4QErO252P2NKdqhOthDL3lqe3mQz0abX+KgDZ4S6s89oK2gviDAwaJSCte3V8vwooQUTOxSPThwtlZZ5k2cWlRY5sWc2JD5/OOPzG9vzK/PLPOVulbWUhnHiQ+fvmMcR4bLo3eDScZwcmV7cWBMu5jkAaHWfi9bQULq0bRPj25YfJemSOwYupdZHYOp/kD7nNqic+h8Ya3FfrRTcHuGxwXwDjo/QXr5oXV7ysfW3CkRwkqtXV/IlOtzjMyePS+lepc267Ryvb55e2/LXhQHQmMXufZIMfRuYbT99P09caZZSslYbtPE5fLAw+WBy+XyC2f9f+1Nw641hezOaPezBtwdSyIMk9Xea41w8GdHf9Xn9X5EG1dbVg/PEGKBclQPMdTCjZ4BUZwmrNCMZnbottgBW8DFeFGxQE+s7hu1Cm8jhFVaFEIeKFoZgq3MDcR229O709UGFQKWnRxCJubI8PHC//v/+N+5nM/UkBhCYswTKV3JFUpZiUFY20ppgUqkefYxaiVEywy2aucZg7VklcHGsYGsidaElAfyMJLH0RkubWMC2oIgkox3iKoSXJdAtbAuC9frzG1ZqE0JIRNCYkyTd/awzk7rWljXnpns9tHuac55m0NF9/kXwx7kBGBImUhg1cpwnohjJEUxHZpWrPRHhFILrVREIlEUFRdeTEJjZS3CqCPrWslNCDEj4kLogEgmhpEiKzlZK1ejvzdEjDae0kDOI+PpkceLslzfqLVQ1kIIkVKbiSEvhfk2c72+sKyraQU4yBRjl6q3gC55AJ5zss6OVJoGslhHr4DSooF5TayMt7ZKldUXZplSK5KUxopKIeVIWW60tbrMRKKKh9iqW2yimwcQ0O0Juef71ia73oDPnT65+0zcV8/2yn07Y6Xni79KPT++1n/3WEoNhvwylDsuDXbff/wO+7tui2gwUM+eb78PEbSXUneWq2XzTUItHBg/bjtwf3X8Htntk/rCtycydLvzvzNq4LfnJ6p0P5Ep2hiC9saju5/wmPbeT0SGmImD+Yn//f/433g4n1lDZAyBIU3EeCVGJZq5orifaGpsfROrNRZGq77gjuLrY7NR1m2qocGEhUW8zFxMZ8wSi35LvWtbX+AbXmHs7bLOHuOB1kZOidM0ESWwLAu1WLOWdV2tlBcDq1ptlFJZ1tXYmz5XayvW6MTF4INAzl52+3Dh06ePPDw9Ml0unB4fGM+Tze9lgSBIFOvoGuI2WHaWoYJWWi2WQNS6DSaVaB2xfD/zE97BKXStRDbNRJIiMZOGE+PpwjiemPIrt+FKmY1Vai3MF5Z5ZSmrJ0Fc9D5UQgxECcQkTNPAdL5wms5MJ1t3WdxdWJs6kWBfbNq69bD2FPOjSDCLExqNgmKAPsXj9tDBgX3bi2707pVd4/IrVkz2fxz1y3bGmdxp28hxbh5En8wm3+uTHud29xN3gNBvzE/8h7Tn/o/b9hv2n3Psr/xb+4BvFG9/jbAt1rvWjHR6mcj95zugI71c6lAmdQBldvQquMBioRYDEkKQTTtko0eLUaVf327b8VOMmK4AlFaZ54Xix+gZxOfrzHQeHdHDkNy1GGLdGilnxmHk0+OTXfNiBuXycEEmq5P/6cc/8/yTcHt74cOHD4zjaFohIW4BtymZ9+B7JZSyMQ/ELp5O6TKjp14L2ammwe+jCe5uTBc1FoaWwhrMsItHmx1lFaCtK1oraci+QnLF9kPr8N6OT4NsWi/2etuOh5pWQvPW3xtQk9ImlyzBhXbVWDDVGVG4qK+IEFKitMYyz7y9vHJ9ffP34PXzZ9bZ6mxrEIbJmEwUuwatliWvzWpUVRsvP/7Aer1R5oUYAzklhmFivc28Pn8mDonp4UIOAtGU7yVEpCmtrqRo47EeNIY3emMHvQ4juWrZNXFcUX5jo7jN01a+GPt3f4T98OLq+ltsI8G6iKWM5LyXXrnUUbTohRaDibIF/LeVBozjwDwv1FKpDdIwoCJMZeVlNhG22tSkb0QZp4z+ZCy0EISHy8hPnxeWuTnYqc6QsgxOr2rravoCxqLJmWEcydOJy8MDHz58x3d/+CN/+Ic/8ac//ekbtuY3trnZPqzjDmUTd+E4tpjbHajALqzvu8lGU+9H1K84Wdv9uACNIgZIb9/V64kFDWpdEfqJ9vPowLv0oNQ/qx5kiNAC1gZ1LQTgrz/+wD/94YE4DLSYQKuVIqWwCSSq2Ni2gB/LmklgyJnx4cT3//1P/OEP3xNSJoTMaYAxDcaUmVfbP4TjXUNUnLXYAccMEm3hIWIaB6LEGBjHgWEcadpIeXA2Ti+9de0bp4LHlAiG5vs8V9ZlpiwztRVyHLh89z3D6UIMabMHzZ9LaSZ8X0olhbBFWabFZaB0awamrnWxLG+rWP18sQ6HquQASSLnceL0eCFkodFYbso6V8oybwudlBNSDdCvweruQxKs+aEvBGPYfGOMkSE55dh1qtbVdGNQZZ0XrAZA0QwhNAYxGzjExMMQqLVwmxcT1qxKPYFR6QuUj9TaWGpjaQX1lrtjCkzjiRhGBLM1tS7UdaEUayHedROCgMRo7Mw+sgUCiyVemlP2aSC22KieAOg792xq/999S9U9dtkZAofp8pVp/bW4acdX7mObbQ571pENnL8PlPvOX2NN7LJqnZZ/OPv3/uZgS77InLJT1vvuPfjWDXHqEbOVR+h2TbId837xDziguQUiIluXys3eeGB+jH1+3/jN+Ykffvzx4CdswUeMBPcTEru2lnzDT0x8/7/8iT98/z2SEyLW/Wfw2FtZt8SpJS11u6ddsLa1SggmL9DBleBzQcQY+CklL/tOh86tvlgV6JQb0bCx2hFjxmuxeJgYiWlkGkyXpdXKMi+8Xa+8vr5ZKVSdPdYGmpXglLUwr8bg7Kt6A9UaQYRxGjmdBk7TwOV04ny58PDwwOly5vzwwPnxkTREj98LtQpSIUZB1WQStKk9tl1Ikdrcdrbe9EOtHEiM2a3igExMHO2E5SKDxZBJCAmGQRiGRpTEIJFrSixjccFifN3QWNeVUov5S1/vSAqEGJjGgcfHR87nB8ZhICbXskRNu6ZZ3Oueddde6s08RA52ZreFvaEJmhzo9Hu8rVN1k0noM2kf2/fH+sV+Qr6yu3CPvviLtrarm3B3t/m7i/ndT8C/oz333y5Pcqv8q7f9c9+ix35t+xaL5vi5/d/vBvQG1tjCXsJey9mfughGeXMNC4uDvvzOnfpr7/VyJwXv4GOdmEoxAcEQncHjNsQW0XkT9tql1gQJabuGFExkWKRQijFyxAGJshqTozYTkgpu+KvXvpugYzPhqwC32xWlkudE9Dr44Ehha41pHDlNk2l/pERNiZpHcjJx2ZSTySv6BAvq2TyU1lagEYMzJ4MQpJmz8vusbjy1Fo7Ian9PGo7uW/AdUqZTzlrtRksgJNRZOiJ7BqADMHYP7TWtjVqad/FyTNMdspWlGbBVtVFLsb9rYV1nOqukFitTAwgpsbbG9Xbj5fOLZTiDgSVBrGvLuqwUNUZPjIKo0UZ7Odw831hLMeX+242gcM6ZlKzT0DiOxjoJgXK78fb82e53jKQ8WtYjRuq6ElrbKK10Y9Tn1dbt6jCEnfZrGa/+2+97N0gKvTRIdf/wXU62j/9mWQNLH5lsnoS4L2QRf1bOqPEOLRLYOpiZ4DG26MWDmBhYV7YyPD1NhM+v3pKysixmHGMQhjSgWKtjE9IeWJfCvCzmnJw9d/QoloT2crkYNibN6XTm4fLI09OTicN5F7XfN9vuLKG8+/u439FmboG7Hkbnl/78aFOPQPiWHTza+LvvevfdPZPrgbgTDt59+xYv3i0o7HORYYgMw2TlO+NESdnGy7DShbI1BgjZwMZqejMhRUiBNA5cPjzx4dNHcs4010lKyez3MGTiPFObZ+20EUMkqBBViBq8k0fPjLktR0k5ulCxZUSFsIsQuj3s5amClaK2YMFS8N+iwTKTtTKNE8M0ISGjcUBDwnilze04qAQyQsKC/OzgUi/p7batevZUg1qb1SgMaSSEybPLDREL9k+XEzEHSi2wFqQ02rJSqwH3xOBltCZRI67/Qole3gi1GDMzBEFrpUlBJNrYCUocImGRjUla1kaL5u9SaEgt1oWl7do2KQZOp8nLFIK1jlXQmkli9nepjbla+Wldb1aKCrSykFLkch4QGRxkWallZS2V4kL6MWUbf8XZiwLRM+KqtpjQ1iCyCQGb8GSitLLn5H42XLqbJT+34/3+Xz3m+xf7gutvxIcHRsW7T2/r4KO469cPId/8O7jHe//5zX4ckmkIBIlearad3v57M0hHyMv8xmaTDmDBu11/3w7bb8lP5GH80k+0AtESUhoDItnyjFk3PyE5khAuH554+viRYchUsWx9zraAzzkRbgHtyLUaGycg7it6mRHbWkXVwPXoALZpmZifiMGZNJsM4w5sgck/7GUcugFBolZamlMm5YGQR29M0VxH0eL4Wq18qdTizUP8vgYYR9OPCZ4YjMli3BQTp2ngdJqYxoHBkw/DODJOZ04PF/I4Wpxb1w3Ms6S5HPKRxnjvTKCmQJVDXF8RTxxE191pypZ42QegAy8NtAkhRXIOkAJBTCMuYHHqMhuTqN8/cGBLG1aMZD8qliSOQQygiVatkLZEpT3b1qyhQPG23jEmkpgT6HIM0gc7FiOg1twA14BMMVHwMdPto+7z6AjV3M+Qb6/l7y3j+/16bP01f6DduH71uPshvjFn+9+/ET/xs0DNl/VdsD3ObyBd+3798/ruor71cL7t2H+tZs23z2s33EfEfSMCq9OPhB0I287bHmlww9hxlR6YfG2MWO29LXa33+qBdankbEbAzkfpkvSmh2GBevHyGaundfBBDADIR4ckQDNd8+JdL0ozeriEQIoBaWyIeW2FtWKZP23Uumw19Z0dtK4FFNZpMmrjNBFzotbs7fnUwIjo7QBbsMwsJjgsvuhv6vRKQJpQRUk1QwjWvs8NmNYVNhDBACNVQZugWq3qyKBuB2HMIag2gj83XPncQJnOhGmubROcMteBiHawUh188/ebATSlFObblXW+mU7DcgMvoVqWmev1iiqEmFhq4e164/nzC1GidwAx9L2ulbIWVgejRIyyZ8bZ9BWu1yvravTIiDDlTBhNpyJFU5HP0YWo18Lt+mZlDeNkKvVuFJqDJBKqZYnvJ8dhfIKrDW+O3Lz5Eax5B3odQQ0/iHYQrb/mwJiVSuHBS9hLnno2AEwceQND7XfswtYdqPHgK8Rg7SLFyiZiSDCO1umKQq3KuraNCZRT3tt3ezlUzpm3lzfTw+jn04MP2bNjfQ6EaLXf03TmfLZszjAY8yGmv7Ny9L/YpoffO6O1u6QvbfFddkN3oM/s2O4f9JBhOX52ZyzKwdZ/aYMtZPFx7sO8j7euG7l38pC74b2dky86bTxERJKV0sSEpAFStvFIscVzzl7PLrQWaYp12psyp9PEmpQ8Dn7+DcHAAwvI1MuCbL6AMQSD9nDafizYVFoppBy8Q5TRm2srPgeUlhRR07OxoNxq1fsve82ovsFXTQIMMXEaB9KQTUMmDoQ0QswEqQSp25wmBNayMi83S3S01YEgyMkymhXdviu1xOjd40BZl4W1NqZpJAyJvPmYlTLP1HVBarWueDnRgmdDV89YAkQT4kQVVrPZ67pu3QSDCEOKaC1Oa8ZBbNNwmMaJ23WmLSZK3oIgMdGWGzEOIBGCdYTM3oULovtZhRTIobHWisTElAZqq2iz7xS10o1arAx0LQui6iLzkZASlEopK6UZU0qSNfIUIDZbUDWxlqs006FIcSClgWk0oea5d9n6WyDJL9z2+XSYrz+zyQbQ2IT7pToC3/ryrinx9Wzot4Pv499HdvPxte5zuvmXgIlSd1/mLC+R3Rb0AGGPUDyt5F/dGbjvz+4/QnPxv8L2W/YTkgf3E9X8REqElCEKqQWa6uYnpmmkJHYQwuNsVImerE2x68dYuNuqg+8qBLfjndVca92SXP3eNVVjnvTwp6md1xbHWaK6czqbsmsUenwXQyCFwXUS4/Y7BNNSSw5up2g6a2/XK/OyOJtSXQTX9FliTFvHvJRMlzBJMN2wlKwEPSXyODJME8PpxDCOhBRptewseTF2aRUBrVvsb3qUPmyqF0ItgTgvpHEltErEy3HFnuf24wpHgkBT2tIozVhTcbCEXhwCOUaPMxPX243lZj5IO6u9A0gBizujVQHYc2zOePK5oMa0V7WkY/REjqxhA7tqFGtiIBYjGJMq7CWl1daUIqZdF4mW5Olz0Efw38bVf96Ov/cT/E17pxuA0+ft320hfyN+4j91pbEDO+9P6z3y9CUSBb/Wwf3aR22j0wxFZBwHo4B3unk3IjER6aUuHejYtUuka4wcvv69WF4vlVFVlrJQSqNooc7Vu1QYMBCCEENgHEZzPjGQY6b6ormqos60EYSUkyPH3vYPNgYNjsD3a1Xdu1QJ8Pb6ul3DaRoZkgmCtVY28dZxHChl5W0YmG8XHn2RmoeBcfLAshj1urdQNgdnc7V/l1ChGBAkEiwoXb3blFr9cFOntsfgRkfQ0qgIVSIyJKQZ+CO1EYYByXEDC9yDYK3D3WJ7hyEthUp1oM20ffDPaRfc6hPUF0jruhj9f555/fFHrq8vzMuN2/xGUaMxPj9/Zi3FEe7M8+fPzPPCPC+M5wej3nv3Dml2TQKs60ItK7UsDMNArZX/8//8//BwOjGNA5fzA09PTwSJXOeZogHJE3GYyC7bUxVUo3UKu12pG43WQKBluUFZGc9nNsjR1f/tutsWmBzta6dEqpcVmDE6Tq/dqreDwJyjjYgYpbUVL6PylM6RMdZrNAVzNI6RbsdKKTJOozsn+85Wm8/HXRAuhEAeE+fLRAWW15nltpjjjIlxzIRionev11dCFC6Xib9+/myZabFgopcPSjwIiXsHqBgjKWceHx/4+PEDnz594nQ6EWO0rga/b1snog7sBQdlG2pjqOGtEL90pI0+78Tmro+vLag/dIbpn7t3rgd9sa3s4+BHOvjYf/ox+Er44cfbgPtoQKEvl1E15sPLyxuvbzPnPCFxsKA5gkS1zkQhMz2cCYuJCoZgnSjGISHB9kkpUqrp0ChCbWVjV+Zs7eQNAI7WOQ3TWOqdHUoxsXVVWNdC0MbswbHUZj7Fum97h5HqC5bKmDK0iqj5DwnCkAfwbiQxRhM7TImQs5VnxcFAf1FrU+rsFK3V2l9j4FAM1vq1lsZaFi9XtGPmnDmdT6zr6t3VcD0H69SXUibkYCLsy0JdV6Q1IlAlULXQurBkM9AiADUGihrXRySwris6er2+NqRV2rpSUG+hnZGgxJRNODOYNkErdo+o0USDW0NjZZxOtAqleHmzWmkU3mXKdG+8Zl1scZRECDlZtlWdVp8j67IQqAZid9AIa0sbQ2CZreTMSj6tc2NpgZVKXwiCCX6ez49onkDe7H720FBwzQC5Yx3IwYZvUyR8ORN2ZkIDwq+Iw+6W4l9Msvdx0d2/YfMx3R70ZMHRdmzvd5/2rTPRd+yHY/C9lRTuJSNbR5dtvz2c3i6/a771Bf3xumT3cVp3O9e/7/ftN+gnXo9+Iruo+S/wE2MmRCUPxqaubSUEA3q0VWccm07luljXOUnR7yUUbwLRsFgsRLtPtVqcWzDGhjpi1gEdraZd1jGwAJvOVcBiQ4vfvGzKQRVxHybBQCJTSLGa95QCJ2eCT2OmabXrdPmErgdUqrXojjEyDmaTa62WsI4GZqc8EPNAmkbiNG5sE2u1XRFn+GzrgGJAvbjfVIEmpkNm8eZKG1az+9Vj2aawJY8doAtua1SgWimSarOS2xiJwZq7iGuxhbDb3bKaZmWp1XXGbP0WUvDrihvD3kNdhM5I9/IoAZHe6TUSivm4WtYtAapqiXi0QdANoGsKOY9UGQg1bIDDlphE3qMFdOOmd0buK9a2j4df6yc2ZMirKX6ln+hf81vyE38DqHmPPt3btl++yTce4lfN4LvvvEe8vr1fP9671zpSdoeD79dhScHIMIyI16EhFiyLI2amOI6XsTiFPMjGeuktUruWzLfOufXJ74vX3uqu1uasgF4iZSU30sygSdiGwnbs0iri2FwXXUWhNWFZVquDLMXqGxUXW21UCmXDMQx9LWulFbtGbQZopBB4OE/UpVCGhboUlnlhHEZOpxMPT0rJRh0s62JaHkNmyKPdkxjIw7DRMUuthoqHgETvWNIa1LrrwvQBrNYeUJsSYiJmM1DGOmqQAhp6OY89W1XLHneAoVUTnzQ0vRhQ0mt4N0W3zshhA9Ja7yC0rpTF2gPO843r7crt+sbn5594fn1lXhfKuiDB2TC3G8/Pr2YcGzw2F6mNgfr8vMGoVoLmekEp8vrTj5R5ZgqBk8ApBJ7GkYQtHJ7nlVwUlcjpcmE6PaLaaKtlZ8uyMAeY55mN56WmwxI64+MQlIszlggmdGnXvrdGF59ztl8f62ETQEbu4VXdjII7TdWd1SRYG8KepelAWAfIXJ+n1bod0ZyHEoKV1EVvGVxLsakZAnnM0HYjexpH1rXxep2pVTcmVArJ2hQTrQNUsPsxDlYG2Ko52OBC3r1FfYjGEhudZptz4jSNXC5nnp6eyMMAIsY4+31jo6R7iVrbXjnsc8hYfPlpe92yl7L9vQXs7M7s7pOeybj7jsOKbzvGVzMtx28/egYvD0KoW7vO/l3CshR+/PEzP/zwwMN3Bl5oa0zjRGVFRDidTzw8fkBfAi/6o3XyAcZsIinDYAFddOCxikATcs6UdWUavYxmvRGGRFUoKKun3HQLxBQJFZHAEEzsjhCs1TYRIRAlWkavesCHlQKJM1BUleSdl0SsO1PEFxRJQCq1zFBN3F1ZUF2QMFCWxryakG8eLfBCTQz/+nalFCtnGofTVkIYxANpEmupxDSQ88BaVtIwbp2PWiloMRvempWDlrpSinWpEg2oVHB/3Kp6dotN3K/VCrVZNxHFgHu3/U0FCQMxDEQZCbKytsU6OxUvwUQRgnUnSYLUlRQGW5QVywyL39fqooQSho3C36p1Mmni5WiIZ4YzIRirFtVNK00cfLJyYX/WtWzrhObZw5gzGhMarPzqerttJdYHIjc9978F49rnyRF3P/5xP1f3QPfntn7gPjf7gtkz0IdjvM9Wfi2g3M91tx9fMrt/QRDqY33782A/9vxVo2uEiGDdYkQ37aX9a9/foLtfd/dB93/+uvP9DWy/JT8xLys//fjMDz/8ZH4CK8v/ZX7iUAbrDTxiCjSxks9xyLRaNj+xlhtIpqpSFEpwkEXszA176CCVw0sinkjdeJoOeGCiw3DXeac5w6YvKFO0jpwxmR5bbc2Sj63SVgGxp9sarHOl1krOiWk6MYy2XmkK61JcW9C0z/oaoTo7EAmEmBjGM8PpZLFaSputpxnI0kqh1NVElKuiRaEoOCCOgkQHdVBfUzXqWkzvshQHABtGLQogitUGxM2fWhlVQ4vaffa1X3ZNmZAiacicgnWFKsvKMs/My+J+qZmF1GrHE7YEfehSCQRfE9W79WvraySJEBprPXQxRV3MWmgE11kSFAeEiCYZ1sGZbc50jpgfZkMWdoThgFu+mxRf9xNfBze/7Sd45ye29YS/vx3vcB6/NT/xq4Cau5P/uU99Y6ev30jHrH5JXfO3v/Hd393Y7+8cbo8PmsPDCeKCi15ugQksiiNpCls7PAPxjK0Sewa+gzMHkGYLSPp3bn/72Rzmg+BG02lwRwfUSzCQQ2nONoFsEPeg367JgsRaK2uMDgqYIaWp19U30+Dw69DaKP59ttCu1CDkYNnAVpu1Cy2VdVwtuB+GXbl9XcjDgLYBaUpIidDMiJuQQTRTr2Y6ksTtGjcGDNBFFbfp3NRskgfYIk4BTX4/Dk7dgBpDd1uttHXeAJjWGqKN0HzaC045jHvw4Pu1Yk6lLKu1B5xvzPON2/WN19dXPn9+5qfnz9YVq9l9XNaVz8/PvF1vgFhXlNvNs+HidE97VnWavBROaTpYd6hl5cM4MuWBKWembEK5VdWcWDPBzrUYLb/DsrWsLDO0aq1xO7obgzBOE8M4+Rj2uxtdxM7L1TR48OSlTj4YbYy7iLAcnFFfLGxzTN4TlmVb/G1jPqZNq8e6bHVAx0G16oJ3GIjTZ6agnmmIJu6mTj4VYRgG1tkz3ig5m+MXsXlaWmWtlTgEUsyEmHh9u3kwZm2A2+x02OR1wD4HjSIciTmSh8GzWolhHJimifP5zDDk/Xp+3+6cjmJAs+wedbOPrYtwv/twBwl9vbrZug4cfm2ze38fWG/x99EuvOsw0jeHFXqYsB3nWO9siwq2c8HB43WtzPNKDBdSyMTWmIbM0kzvKooBJFESoVmQPARBc0acCm5lL8G79wVopjGzloW1WjlTbZ5By4mVQgTroCfO0ghdBlD2ZIHP91YbdTWNmHjIkgEGdLi4pInQY2M8ZnKydqVFC1QriTLgupIkEYIxZUIYqMUCVEsSFG7zK2/X2csuI5fLhSFPqBprptd2D8OEIuSYXVQzMQ2TdesQC9BjTKzrwryurHVhLouJHReggrhP06CmM1aUdamWpCiF2+3KMp6Z0xWRyOn8iDaIg7VcNe2tSKuBWjBwV1fzXzUQ1dihiicNyoJiXT+sSYVlaUWMLl/qSlOBaEKWaKJ3L0QwkXSJqNjChg6Gq1pHQl+YRISQMqUs1NV07JoH4WurFLVAP+RMAd5uM68vr8zz7IKcsk2Ebaa9W6TKu/eOc+O9zsfPx2TvQ3Jlb/Nxvxj+2if9C4+f/hXbfbz4c4vrX7KJZ/Yx12rPSOVwen0O+T3x2Ov4rT1usYXwr7qY38T2m/ITVVnWsvuJmInamIb0C/yEgb0pJlIUUgrEHKkakGrxTqmFUiDHRG3WtVKDsKIkPG4TkzTdz7vHcr5OUdnKpkzInG1Mbz8O9vSyJyu7SmRvLiImhuKL/UorMx0uNtBcaMVsTgTQRlkdUJFg6xI/w9asnHf2WHQYBgiRkEfiaIzymJNPP0sKtGpJy7KulHXd2JaW3bDfWkzI3oRfBInVJnkM1NVKbNM40+pE1MnXeMGu7XCftLJLOThYQ5StjE3VuutqgDQkYoq0IZGHyLAOJrBcFtZSbLx32Yjj2jD0piABbZ7UbMbwCQ5+BbwFfIZaVxfqN7DQOl01E7xH0EPTgB2L7COivQNAPMbep8Y+R+72Y/MzfQ3/82yag5+QfqBtAt3vs/mmuxln40vs379FP/E/ncjC1xBz237d49s/ZvoA0+nM6XxmGidiiAzjiDZvlU1HoO2uBjewKRsF0UAaDqBg/0P3zBE4K0RAKt38xxgYvYRpYy/ABs6Aq7HHcDfktAZa6ZQsXLvD3k3pZDTTZi2pTcyrstzmTZCqM1ZQQwari/DmGLydqTgavtJKc0DGVMuNTZRZh4WcrUSq1kKrKzTrLJVyNjpf8DaqMdDmG7EkF0UOTrlsjucLkjJNC9uc9BbjtTQk24JFkrFUqBbc4oK1GhyF9uuuy+oaN2B1NhWiuktpGEqxZ15bqS74a7T769sLy3xjmW98/ulH/vLnv/Dy/MLz87PhSa0yX6/89YfPpoeAEnL2rMFELdYyvazWKcTKroCybs/ypx9+cD2IiT/+8R8Zx9HqcYdMoDGEyNPjE3kaiYPVM9+WhRgMXHh7/om1Gijx+vkn1nmm1cp5mvj0hz/w+OEDTx8+bUBgmkbLwLuQncbSTaAbyE5jdEeVNmW5beD1+WdBVTwYa7e5qvT2TyGKdSuI0UsAjDnVWkOXQisrbV2M8RTixnjBHVOMkXEcmaaJFCKLl2Kdz2c+r58NPKzNAh4XNw05WVanVEpcGcPA6TQS40d/titjipS5eBeVZvO4z53s4sHnM6fTybqkjQOn88T54czl4cL58mDCzuEXWtnfwNadT3dS+lUg77DXwW9btqhtdlI7wu76ST242EBHhS0yjq7T5Qyru8XhjmizIeAehezLSQ9MtoB2X+ge0pJ+Kj7uY0BVqM2yV12cO3vb5tu8kG43oJFTZMyZ0rx7Q3UwMkTLlqZMaEotM9F1lV5eX5BSaFrIj5NlkBUXlLTf0lssS9iAlKKKRCFK2jrZ2XNwAFwBNeZHa4G2zqytMYwnE6QNCVUo2kwbrTUoFVplCIlWC2WxLF+eJk7TZMFuK6yr6cakYKBIHkZCSKxLJecJo24r4zRwnW+o4uy1ZP4hJZprz1A9k+jJC+rh+Ru9aAte+zMNRForGyuuLiu365WURjREQhoZxzMxmu7OWlaa1/D3bh47P7NZlrwVgg5ItcAyxugtZtm6n0QJIJawqaUZk3MNpGh2NISe2exZWtP1UcTLT33sq7oehDUzIARaMXZgDXb9jUZpJjBUqzUlMGq+C/9XNaFIt8M9CFSctcO+INjmpd6Hqe/jqzt9kGNQfReY9qP2Q+6h6OZc3m+yzbb9fPTLkPkYWOvx+//G1pkA33iXPaNr53f85v1WmRG4W7hsNbzvt8NrcvgryNd3/41uvxk/4cC5lbW6n/B4/mf9hJr90YOfCDERg4E5tc6+Zsg8v7z4Itx0yJon9lq0MqyKbA0g+vm21mjevjnEPvJ1ixH3eeM3sHm5WmsEieSYrfTKk61mu2w9Y8k1YzdaIiESUmZIwlqr2a91hWqJ8WGyNcKymKC6diGPECz5lk2TJk8TaRgsARxN0F6LJVWbiwFv4N72g2kt+n7qz86ztRCsZFWrlcVWbweetCIhe4fFvVX8zuDal3iqugsSZ/uG2to2tCRaXCoB05EDhlq4LbNJVHjp2K43JBibJ0Lo49VlM5puSVIJzoOSQCCyqm6Al0kXNCoOGvn6RxxUa6VtZVk9OdubEtybaocS5O7PfT4K937C/9/9RJ8r25t9Xn3DTxyFuY+b9CTTAaCRb+53PO5+Vj+3/c/iJ36lmPAv8ziyPdB+kX2l97V+5/IzN+vr3/etMqqvnt9x3y8e4E5oHIeB8+WB0/lMTsnLZtSZKtGvoE9YY6b0UiZgqy9TdeFEcWC3mqBrz9ZLMYCmqdWRBl90Jy8vMQHTsDFsQugsnr1dq6C2WNjETE1cLATrItVvm6oFd9airVEWa+dt6uvWiUOrB+V01JbN4KmFl14GYw6k1cqyzLy9vZJWEzGUbbCayc+tkRXLlqoBXUNnLGmjrDeCJndC/gyaAUbdyEo3OpjwWQ6WlQ0xeXtnL5tal8P5WeZRg//0maDmaBogrVgdblCjlre6ATV1MXR9nm+8vnz2sqeZH3/4kdvNMpbjNFHW1RB1Ah8/fUCbWra4f51YNgWEEBOnU3RnYqJnUawby/jwxHQ6MZ0mTk+PjMPoeg3w8HBmHEzlXqKBdhICy7ziYT63tzeWdWFZrH1rCIkUs5UQ1Mp8u3JN2Qx6TIyu3SKtUVclRDy7ErZ5sjkjETg0wUP9frnB3gxzEA9OjLGl7mtcWGNjnFn3xN6vWK2e2FlenReghzkq6hoxyUC/PGbKolsAFkOiBd30ZYIIY0600qixEsLq4xpyykynC/PtxnybUaxshJs5OKnGLoquS9M7bIFRUqdp4unxkafHJx4enzidz6bVlIev2KHf3mai5duqcBPG7Ywju9970LPrX+DMBmwBy65p1VoFqo+JgGhENSFOCw6exbCyPfsWA357TbfQeo2xjzd1e92kD08byA1BNFL1EGSIOkXZ87W+OM85kFOg0nitSh0G5vmGomQXEF+Lcltn8qCMD5nbPKIBxgqyQsgjIQ7UGkhEophIZArGhiurabucHqYtm2u+JqAVVrezQwhWkk4gif2bkEGEJhUN2YQGxeZircXEEsfGWhfqKkzThfNoTMh1NaCjtEJdVqyE0kQcK7BoJUvicTwz5ATSuM1v1o46RS5P31vmOCQrQWzKMJ2RmAFj1RVZyNPgvi56qWhxccpEaQbcGHPEWaIKSey6b221RQV2fGO4mPWIUdASGMS6ppTbzC3d0DRwTpEw2XMQLbDOtOVKLYt5Do1EHdC2oq1R1pk0jIQUGMaRsi52H6MlDNBGVHUByEAazlBML6LWYn4RpTahakBrpFWgyQbIEIW1FYp6hpdCC1bSSh/Da3XWVUUG89d1hnOYyERurTHPq+kXhezdgwWhGRtW2Rg8wcXj7uOk9zEemN3vA6/dQzFfjWnNV5gJMG0Ky3j/7UD57ih74GjH23Te90XDHtzfb1+WzHwtnD/GjjubdotPN3aHL3owMK53KUaNtUvYtQZSMFaANEV8sarC1iVHgy1cf99+W37CBHEDVbufyCy3G0q78xPzOpPe+YmhClIgDLufiESCqDWWCNYcpJWVW52ZLqPHbeoJWgNiyjZvxBg7IgSJdJFA08xQ8Fh4K4vZwAYHQMCYPzG66Py20j+wPYxZoq2Z/peDOiEka4W+LpTWTAcwmz5NSgOqStJoPS/EUrYhWjelmCJ5mhinyZPH/vz8HFpVA8dd3JhtHO3/9WTFZke8FXcQ85uhNS+PtY5USXctpNB2eZod1LO12LYias2666r5IaWzvw0AsaYXVqovEhgkkFZraS70MejjR7FxqyYkD85+aqatY6Cm2z+xvlG9XKp50t3mi69Na3WtMjYQrzZL5ti1GOgY1J9pN4WuH+kT7u7XZlIPfqLPnQ7N3PsJtWNv9zCwSTQc/MQXHulujb/b8t1+/Lb8xM8CNe9rtX4efTreBN5d/M85qvfgyXFE7P/+OWrVMct/PI/DHvfHOLzdF6UpGRNiHCdDpz2rtwE0/j0GDNoAe4/c3aGtx+Nrt20+MfxZH9FaEevCselk+L+lB6u4pgz+WZSQPKtK2FTBDe3erIvT9MxAFReuraWaXk2t/vfaR5g7TtN2qVodNHHj5OhmrZVlnY1y16z18SbshP+IkHKkt/CzKW3Gtn+f9PGFI8bVSpT8al0bRbb54SeyTWQN3j4v7N2w+j4q70ad6ibeaACNO+xmqHwthbourMuNZX5jvr6xLCvzbeZ6nU04VkzAudWKBEPCg2sD1VKoWruMGq3sEzulSJWVWvCsebIORMPIeD4xesYgDSMpGrXz/PDIMBi41VpxB1wp8wq++FoX02JprZHzQAzGXErZpnVZC7e3V8vep4ykSEqDs7UaFN1Ec0OMfVCykfWE7ZkfbmSfNLvxEkHVnf4+HexZ9eel6hlkF2zbALm+32HCHNgCfR6E6MubHhwghy9ia1teQ+8aFVjqumW3zuezBRnNxJxznlnX1fSZmp1Id79sc92ChmEcuTw8cL5c7kCalDK/b3xhe60E0QOHwz5wP556QPzuYP1dDzzN3oofd0s8iO4O2o68Mwj6QX2cdtut7Wt+qB9w9zdHq95DPwEvjbX58Xq98XqbGWJgqYVKZEpWTlSLbiyx0/lMK4VbvrGuSlgaSCKKWDawFEJKBuILjJPptbzdFk4PJ2txT0bEOgQqzTQPxZIAAdPxCtEYguo18Kq9LXblVqu36bYrWdZKiDBNk3VGW2ZqW9AmLvJrLJ0cIkNMNDHNtGmcyGIgzNt8tQwdynQ+k04XCMl8XWt2XimakKEzVlIyvR3xc48hk6N3SFJcr009CxkdtDYfGIhoK9tYa+D6CNa1Stx+pZzMR689i2qLP6ObGwtQgth1x8Qqwe6ngygxJQuMiyLZmEtabeGhpueL5GBioNgztBLdhK62Q4rRxqUv+ky/3ReAdaXWglIt+Db1zW0RaZpq/cwtgKulomK+KyDkmIxBVHvAa/65HeZCz2BuC4Ev5uC3t2MWtbtU9pfe7fvu3Q1s+fp3fO275SvnZougnz3Nu2N+cW3vYtWjjep/7zsef2whqL542gJ5OWR9v3H7jh6p2467MrPf+PZb8hPBbW33E2MILK1QGe78RG2F/M5PlFWZV3U/AVoKrRZCSJuWyTAO1LZyuy2cLqMDEnEbwf2eqeAsGggSHaz1y3atIHsEzZJXKs6wODD9PNGM2vlSPWbEYjojAFqr6JbES7rMRiHWrvqUT7Rg4vS9E6ma6SOPiRAy3jnCYq9g1QbR42TE21s3taTfasL3ne3fXEC/PxjtC+EgqHYF3f4IewzbX+nMegNdYref4uXwLtiLBNQUZBDERIURLCssdGHmVoyTGVJAXMfUjmeJ0hwSqff5dr1Kl8L3cdY2wEUw4KuDKdoCXeKgaQdHOovM55I2tFmsK17aVsWeb1MlqI9U6UzSHm/LZu62UX6wme9M6hd+4jgn7v/qemV3R7qbS+/fQb44kbs9f2t+4m+UPr0HUX7tdlzk2cXcJU24Gwfv3hN/TVE9Hucb3/RFpujntvdIDaQ08Pj4xOPDg4m8Xq8IMKRdaFFEtqykGTi/JsQFgXdEtbc47tclYOK4Yp0chpwRcGT3YOgdnY5eA2orSANrgsQuMG/nlhPJ2wf3RXHwFnFd7+ZYo9tqs7KnWmmrZf9aMzpi8LIsRVnXmVoP4lyHrIcEo+Oty0oN1UQgUzLAp1VSNnr22kUQHXjRqkwefMrqMo1BXe2/uZBZp4sHiEIcPPMag8u1KbRKW1Y3KgFSMsPvhjSIYqVlnoVRzJD6sw4BvIGGiW+58HArK/P1mbfXF97eXnl7eWaeV5bZNA+6wn2thZYz1vIclsVavtYGa23kYeByOVMV6wB1W5jGRA1CC5FpypymiWkcrdRpGKxNI5ByZJpGHh4eOT08oii311euL8/WhWpd/RpMkBIgDxOnlKxLVL/M1rZF4I9vbyYwmkzzYTqdjVUTDHDrtMw8DOZUUjKxNpzpEi177AW6XiqwY8xm760Nr81ScxaibBoMFgQp6m0F++JFRL0uOjj6vC0zEMQ7gun2HGutxqDxkqe2zUs2kFKb1XBPOvH2vLCWSqmVh4ezOdemXG9v5JzIQ+K2rt4lwY6zrCtIIM8D5/OFYRi4XC58//0/8P33f+TDhw/kYSQlE/r7fbPtaHu/9e/+9/HHNtm82lFtQBVnVXhoJKAefYg0WhAri+yfEbPLzQH2rj0QsIDl79l2z2PfMc8LUgsilaeHzB+mQAuBKiApEIEUlFIW1iUzDhM8CjGNLHMhzIVSLHNb55kSg7cwFUSUNERiDui1cXt7IybhdBpN28Tvj0ql6P+XvT97kiRJ0jyxH8uhambuHhEZeVRVV/d09wywgxe84wl/Pl4AEIgWtAss7U53b1915BUR7m5mqnIwHphFzdwjIo8+ZgYVqUme4W6HniLMLB9//HGxYEysbNZGcPeOnEJDTcAdNXZK76QUUEmekTWBy+bd38ra7P62SBTLnMZoAXUgeItUoXWlaCWIMueJnDIN4bw2QkrssgHXMQJipUI6BMFbdVHJbHm1ZkAE3XxKq931X9QJJyaCKBjg3+ro6GeLjNqb1/QnszHJSoBCGvcqECZr+4oLZSrBtGRCJsYdIuctmUJzMK41IBB7QlpAopDEs8UaCJ65t4x1JEQrRQrByhuCGoNyG8m2sqD3Rqur+VXpSBTUO4wYK9EWg+ZvdbNvvZuAJQEigRAyc5qo3Z5x9+wd/SoA1Ws+89CM+OGE18fG/9N58GOfly2o2xit/07bk0X/s2Td85D1p8eGto0uN9elOfZ4Pnwn9OrVMPAzXw/+gtRctk/FT5zXBbr5iZe3mc93wTrXPfMTrRbqqkzv+YlGbRc/EaIQdmLxvyh5ipYIPXWW85mcAzf7eTsb9XvQsPhafO1g4rjjXP137V5trtZVNjqTn+iDOGxXqB6L9d7M1jG6yYpXALheDqatlVIipQnJmUaii8fqGOMjheBxlJeGcpm/lrwI5h828MnAmVov65dRwqqNrYuUrZvwkpKrMmG3hZ2L5EOjk4fZHN34QgI1IWEkIhK93Ktu5WQGCpqPGucYNNC7RbDaoItupXFRzPeEENj0gTAQaXTqvQAtja4NpG3x7WDHBDVhaXrd/DcDaMHL3dSYMlEMFOzeVQsZJXh+j+Tyz5Z8ddzhfRiFy/vwQV8y5sGPmbzn+mfvA7FcwJp/5fan4Cd+4krjXwvYPN0+FCts9+0JwnUBOn7K/fthsObqxj0Bh7ZRysuXr3j56hX7/Z7T49EMwzgn1a37UwyRyVt5g69Fu6PTQf21KyfUx8wx0MIebrDATS3ozGnadDJabfa0kxBjtkWrL3athEpI0fQMUvRuGiltpVNTzl4+ZW1ft+vubuyGTojrELTeCSlbHSPKej7ZQqMsrOvqC2TrvNG7GUdBwQ38spwZnZbm2UqS6I1FLOuZYqS1wrpYtiK4FkkPEanOANIBZOElNGawRJUtDRut3amlH93txnSFhHktvgYggTODZHhfNT2aQUlTgbpaO9R1XTid7jmfT5RlsbIdLDt6d3tjrWG9NZuBAZFpOpjD751amnXfUKMz5hSYwsRhSqbeL5EkgXk/M+925Gl2wMTYLNNux5QTMQjr8kipJspZzmeW5eRiaZU8ZQNSureO9/bRilHn1OtquwQagdPp7NkYAWdTpZwJQay9XxBqnmi7bu3pUyUf9raICGqOxtH/wJVBUQdQUGJgszai7hDUGVJiQqlGazWmmIoaAOiU1eAZfGzd6W0UdXtf+1WrbzrVKcPdy6bMQF4c8pRMFPXN/QPrWrh/fKTVQozCNGfL0uTMVCsprngVto3zUg0gVZgmA2tevnzFZ599zouXL9nvDy7E/XPa1v5pb9cO8Pnvzz/34b/Hgs5t9GbvR3BlzIqhaSDSUbHxuMUVV8fcHPFV4DFqzHGI0Z74xbE8f5JyFZDgwZ1LlVBq4927hd+nzuGrVxwkUjr0EEhirU9bgdXtSJ523OSZfC6EaTXB2+XMuhRKUNIueU2+kHPg9nbP/fHEsp7J68S6NpIYg1JRa/2soL0ZaNsbtQ/QXykdtHnmrBnTrFJRFSQG5rind2E5V+Y5e2BojJOuDSERczZ7160sCxV6NdM6HXZk1wSrXa31bNoR0ww0VJvNaYwBFLxksrdGShOoEIKxEA30NUZeEOu01mullsUCYfEFg1bXfwwbINICFuRL3BiPVb3ldYqIJEaXO20NqmUqC7YICGmy8lxfaNTeEZK1LcfKHKz9tmzjIUqAqqx1QdznGpRlrMbuQvSAjV1VGEzR3tBu2kMKdk+966CMjKxnle1tS0bEGCguyJlDpLXAlGcagfNi46lv9viyqBIPtW3OXAfFT+fhR+2Yx0UjchL78pN48rIv83vvhVk/wUZ+OGa7UNjH+z/W5npcx/Vc/7HPjuu5jjFHomATZ356tttutyvf1hx2r4M+fQK/ADW2fVJ+oguldu7vH/n9H5X9Vy85SPiAn1CWZUX1qZ+I7ieK+wmCspsSOUdSFqYpbn6ilJVaZ2q1UtUWrDQ0elfTRieqdbrrplwDYmG1AQvebGM0SBBriBGC+YDmTHQDbxws8S57EqKzVkzDRsSSqggk71plidREiBMxOqNGTc8r+fzq/VKKZjIPcdPV0oZJODhlUNR5+25b0VF24pUJuGyCBNcmcismVoo2mEJNO0Hs367NS1nHGgK6lzIh3nXWZQJEjXUz5AGMdTkYMGrNAogGkxWlhwYRugYCzQEoGTnPbQ0q3Y7fPTHae7Xx60n44TNMTiAZM7MNEWEhSNpsvZXpKcnLtFrvqIZtrCtigJnH8MNOjQqG5yVCMv6/YTzXi+htNWZzbHz36Sy5zKEr6Ut8fj3Z/0fs5YcTDZ+Gn/gRjZonf11O4COvXW7icOsXNszHFzVXZQ8/AAT9EAjzkwMPrm7y9Uf8dHeHPfvDjbWVHi3irh+lsxmGrszHznhj4Oj1w9INEd3KnXxgjr9HpDOQY+2d7WkCcKnftdpHUw23xXpyTY/k2X4TsmqaGJQ40Xh9k6wWvjc6YjWg0aiT62I1+WU9b1001sXAjForpayXe66dWq2dqKrTwZy6F0NgUqvVN1DZEPLmYElQW8BvSLqdpoED0gnabGUgOFjg4yxaRy6CMYi2ZzTeF0z93BHZ4QQGy0mQDVGvZaXU1RTjN9aQZZC7g2+SxFTUuznC5MH9NE/GMFKllkrKaSsni2nca7HuQa6Un+fJGBnZRC2Dl2+lnD2/0emtbArzYIYnJdN+SJ4hNhqsdfsKYqBL9zaFKrYAMC2i5omFsBng7q2py7qAsHVp6V1JqqTW6dLMMVW/910vi57rge+C0NdzazxHGx72LAfwNmpHn4Aw4uNxtO7mcp5D8HogRIPm3NoQy+byvoNko5TLAMLG+WxaQyLRMjzR/00W+Jh0Tr+cuNqiN6fEPM9XujSzZefHHP7A3P8Ut+fBb2vtqWaX/76x8p4E6CP4Bvtli6jBgyHVATD3Z2WdZj+Ei8MVsUBG1fSqxrHMypmzVMXL3a6p+B+w5VvAMUo6O1GiCTEKPJ4Kj+dGDpFTVdZmrLgQOrswU0s1coiLzcokTEHIU+RMZVlPPNy/Ie0nws0N+zlzs595eXfg6+++38TIl6WiMdJrI1LZ52BLEhFrcdoaQWCekqk19IZ0oXpwG5J1RcNtTfU20No759PCPGWS9S6lVRcb12YCyD1Si0mCpWTix0igOuMl5QSSgUBvBsr0BgTrYpXytNlVA3xs3gasfWlrY94NHYoOVAJsrbij24bkwpldFUmRHJOPH+v0Nvy4iiVTogRaqewmIapAq8Q8oRIILl4s0VrfBl/NqXZSnAgpbGO5a/XkBERN9KbkPKG++AnRunRYm1VjI/WrJEF3irsAU47QvLWnj8WtW1dXqtoiqWsjBGvL3lWtfMzvYZdECIm1dQP0ipV4dtgiyREsB3kWmOqFHQvvB7XXsdM207aAkieTZCzs1O0usAHubOfyfFJ9eHsehF/HhFt89IHvPA/Ot9eeffy9968ucpQcbNlWtyjPjzkW8zrsl98Tk/wQz2J7RzYGG/THFw6fyvZJ+QnXGlSBx9P6w36iGoiuYl1nZRJyEOIUESrLeuTh/kzcZcLhhv2UuNlNvLw78O33b1jWSqudsnbSFFlQujSC+4kYbOHeuulShhy59M8yFibqBe+jBH5rZjLsoJU4RZ/zzWPCLjiwoWgb3WtdEiBEugy5h8BgtMi4MV3oYsncGBysd+kHQSwu9bFxHeNZ2+oGVEvCdl9vRLnEj+IaQ8EAmsHA6t3mb3e7irIx0EW7Lbeun6eD5ZYFMdbrE5sTLMnYSvG40eUngvlIerfGLW3o5dhtjZ7sw/Vl7NLUpR9Mb41g5aw+e/zzDg50K3mOCqphhMf+SfGOvjbuu1qVQ3dAxyNp+4IMAGKAMM+BD73MLwbgZRexmfmraTnmznAWA3zrV0DHmO9Pd3A1q+Tyz3NmyqfqJ36EUfP8i5cTHw/zY+9veNP1/f/gd9573B/dLnSp91H4H9+UD31lBBmqyu3tLXcvXrDb7VwbpHsd4GWwpBQ3vQy85bLpaAzh3w8NlM7QmgkS6GIlOMEfviGk4b3Fn2qn1WJBNgFtai1MEaJY86MUlBRhngIpZ2vJLMnLYwS4qIZD8DrVaGVFvSHazInFyfnqUNYTraysy0JvSi2F8+mR48MDy7JwOj6ylsWArFEGVSs1rvTWyMVKaVQV3U30numxeR2xkFs1RfyuqFYI8QLiKATM+PYQkGSBLN1YOtI6cT5s2I5I2oAh9QwKgglgFutc1auXSrnBFA00bay9UM6nDVyREMnTjhgnWq6E88mEeumEuGOUvo2xGNPk9CgTI7u5Ka4CbwFIysmFcPdbqYyMsRIjed6bdkwI1FZZlxO9FiKRlGeEQJ+VWisSI9M0g7aNEbUJeGlnOd2znM6sy0KpzYP2wDxP3N7esdvv2e/3hGTA3fl85Hw+07UT44KKiWZKEFqtBhppR9s2k4lzNuMThsl2YKWPEjN3btsiwd7vnsXovqCwLHP1toINpHtgoE759LHf6ibqDVZr230c23q0U3ozSq/rc4QopCm7jkzmvC48Pj7w7v6eW9f9mebJFoHdKLTnZTHhYTUG0AgWpjlze3fLl199xeFwS3omHvwLo8a2D9ni64zMc6d3AVRtZI0Sie0j177ZA5fg1Pagw0Zai9PGtfPnCgz0fTh7Lnhcv2Hn167tI65kLFIvgYNRtm1CJLoKD6fGlGHundPc2E1WkihqJT6SJjpCRQg5sZsSQidH4byeefv9O46P99zudvS6MAV4cXMgReFhXXk8nkl5oaSE9MKUIIXZdWnilu1UArUZwihglO5uIG3vDvB7CakB5bhQrFp3odZI0fRPYgoOJFgwO0/G2hz08u7+hxC8w5QLFWcD+kMwYMpn6iYoLh7UjySHBUoGsIRoXbFqWUCVEDtS3T84oy8Gy5o3FE1xA+NFAxkIvXnA3MlTIqiBJtKUvhbqejb2Ycz0WiitoGp6PZIgpAtV3cSbG6KFqispWUC9lrOJvqsFuTEEppwsEO/NRd2DMTcBkYhE1w7qQ8MmuU0cde4+lj3VuGkxYEmMtVd6CNSu1hVLrDuM5GkrD259pRNNZNTt8dMEENuc+6nAgV7NjSdr5CvwZyx2NwdwdZwnkTm8Zyc+lHy7XhDz9Osf3D6ewPMw/yPHf/r6hm8xtFFsiWoLSR0fQOjBF3L+uWcrExOPDMEy403fA7c+5e2T9RMIjz/kJ9LFT+i1n9BGDnBeTrx9c09+vOdmnul1ZYrCi5s9OQUej8XK7JeKqNCkoxnr4OqxdffuTR2LiZtYz4c+wAE11oq43e5PxMD9vjuzZTCXEfMRDWusIdESx3bPrTOii+NsgIs2K/kUxNmI/jzl6me70UOvy8CUgRF0LfS2umZZoWuhtcJg2Sjdtb4MUBqKhlaN4Kzu3i7PT/F23n3T1FR/firWIZUotuaImC0P0RMl3XTHtJHUhN+tYiC5jxTo4z7bIr43S1QMm/IMmfAxH4giBE9MjMGofn9MEiI6UGPATfNHph6HG8CvdPHFYpftfRwgMIzEzmX4aPASMoYlvNyojf2y2UAf+u4sLtP3qe0d+7sc+dn8ufrrmhwhDuJsoMp2fz4tP/FvILLwMeDlp23/tmudsbMfBnEugM+FCSAizPOOeTebYKwPFxtgY7iKL+TitujekFCJTwb6k/O56qqzIdmqo4LnyXnZuZlxoSvBk4ZhEE/o3uXCMv7GtDD3FDGVcUnjHAOoKe0H1wkQF8Cdpv1m2IJEYt7ZIj4FWyz3Ti2V2qGWlfPjA48P95yPjzy+/Z77N9+xrgtlLdRmbBQrj6rGVFhMdLeUmSlP7HY7F230rOvcrHRHEk1cKT7ClvXY1LEtGA9eJuTWk611q1luc9RDsNEnRkgR7daKvG+turFuUWotBKMb3BgCoSdarC7eqGTJhGzGLTr7ZWR0/YHZZJMhOib0ZosFkUDKE3nekea9ZV2Ddw/z52waEHa9Hbh98dJL3KCVugGFMXndr0JdFgcvuuvrNLRal5aIZZ1DEuI0M+12fPbFV+z21sksBii1UMtq99ED/3M9UdfG/vYGCS+QnAjd9GqCWvldjGlbUNgWfF6opSm2MR6tS9VAlT0D0rfUgD2r5qVybehMgDF4wDIkzRZoQ83fsJ1GWSutWyvFQYU14X57xvvDjv1uYjfvubvZU2rhdDrzx2++BYm8fGGdyvI82TDKiXQ8UpaFsq4DPaXS+c1v/4I//4v/wJdf/spaqvdOq9XLLX7QxHxS2wACfmx7GnjbNgBsvX5/fH6U04FTm4MHBMGDxU7/iKjAcJpPPII8XXz+2Dbcqmx/OdIgihIpFR5PlZdpoquwFmUtjSn6NXow1dXKalKKTDkS6EQa82EiPUaW9cy8nggd5hjZ5UROJsS4roXHhxN9t4O+whyAPYpQO+SQCNG0Y0SVOEXP4JnQcIpxC1p7A62CRLVsm5q9ba77lMVKaKsakE4Qo7WHYHosXYFRUuSyis2CnBStm8NFl+0qG+4PMMRIRKi1uz2259s2HTXr4IIHvyKNmDyT19Q7IyZ7Lsnr9MUA46A2P6eYQNsmuCs9WIvxWomi1GKaNCFZ+9eaAhI60y6hIZv2QVCqVkK37Fclo2oMVYC6ntHWrStUCGit1GbXmr3znMLGNrGyJK4WmuJaN7Zw6XUE48pQwTefYIF2E6hdWWtBu2mlKYE4TcRpJiVj0raGlx3Y4miM4uvF8ADNPra9X3Zy9fuYD1uQfNnvvzSO+9eA3cOPXjMwLm/a/z4WdF9/8BJ3jZX8+O2ykLk0g7gsUEyXAl9AyoVd4B08LEyRDyYIP8Xt0/UTyuOp8uJn+ImcIoGGuJ+Ij8H8xHIiqLBLkV3O5k88uXY6LSZwLlZOPjRoWndwPDhIg0kodJcYQH2xCSCNhsVnOcZNvNgq4G0hPthKfSxUZTBPxHzPeBYSttLSIZYenCBvJmow/GzCydZ1xe5dV0ugXiaQ85V6pfeV3gqtrvRWHbTpG2pgXVY99vexFLxiQNTAcVtHOajXQVpHnOGpavOXaILAMUV6Clb+66CWqnUya82ymTknlIkgk49UO0YYmFfvbkPV1BmuwclxjZ6wdCjM7mW3VeMm+CBWdhZJdi6DkTPEoYUL0KRsrKCxVrHbpGPyXEa+Pp178nxeDED+mf3f3vJP6mUyXM0l3ebI1Uc/vl1Qne18rsHQn7P9KfiJH23PfcmWjNeuP/GhPevV964vfAwA/9TVV0WuH/pPexLPka6n5/f8vevhdnWjnw4bEyQNwUV8xzkN6OBCCdu+Msb6s9twfS2DMqawZdHGF0IYXW3i1SDYMDdG+Go28ArJRLfgLKbkGcxREjMsoU1tM6SmZ2LtrUepTXJQQDYaekgZzb4IVWt9V7tau9FpJk4T027n9PZKPJ0I4YSeoXZTpu99tChthixbxLm1FkfVO5CY7oGkwSR6glixoc3DYMTxTIxGTrNg1RB8f5biRm4DUC4tz5vrEwxqLAPQuc7iuME0ITq1eyXWWcT0ZMI2BsZICldsoORAjKoBF9Za2sAaidGF1sIlwxwGZdEC+RgvY2AAEYotcFSVVhq0jnarLe3N6bshMLnWiwlLQ97tmfZ7DrcvmObJjt2N3inNgMbo3c2qmqOvpbhOS/EaXEVy2miwQ2XeHLFutaZb2OTnLibCxLbikIBIv1qoeMbYF3+dvo3b4OKi1xNYB1VfDEQZ2jiIbkJc4xFaR63ENCV282QLXuDxeOR4PDJPk+9KNj2nPk1ex+6q+D4e7+7uePnyFbd3L7zjT7jM039bhPn/zze5TrBcvabbe/bIZPubLRQZPza2NvBbhmXql6h5jCGuxtZ18O7GUsCFqHHtj6cevotlWIPvd7M9I0jZzPe133C9Jf8GYtnJtSktJHpOHMuZfenMaTKhxxCsnI/ReU82ge2QArv9jtvbOx5PK+u5ENJMTpEowjRNzNPEeWms6+pgsrLWzlIqookcBaIwCoY6VoqjtVnXiRCJeACpZjuIoC4bFcQC96VUdmkHItTWqLEREeYpE11Mv7dGjnkDVYPbsd6tNClPmdZxRonZl76Ng+YinZ02brN68O+B6NZhRJSqzTTBtKLaUBekD8GYPkEEQtziRqP6mBFIMSJqGgF29TZWaiucy8KcM9YoUKE3YhCmHNEaQSaaWrbZ2l2DNSavCBMgpJQJmICkdqi1gZfDxejl0qqmy9MDo1zZQH7Z7L0bQsve+oJCvI22hGCCxq7NtQXj1fQl9rsdXZTj8cTbt29Za72aO80XtXiQ7NGE+7mNXSXPbCxjTo4JYK8MCdZnUeD2l/oc2ua/pxw/FM39UPn6c/DnA594cgbXkbw8macfiVV13IvrHLHt83K2Y4Hpz+VK3H78uy2gZHz6YluC27mL+TA/8eEuQp/i9un4iW1h7bHE8rP9hB0nRPcTN3c8nheWcyFk8xM5GmN6zpna1GK42pCEJ06bl9aDBiv/6RZyGXDcFJOdl+081dBetIvFiiltcW1vVhpkvkbpAVL0tYOXTJlA85iTwZ+N2WFLTnoCQC/3ZlQtjHVi9zLW3l22YLOXpiXTW6W1Ql1Xalm2xhmulutC85U6yo48Ng1SXXuM7Qcfb+KDT/GOS2N8iJFRWrS1humj4SK+jbUUSlsxAMllHlSQ5JoxMpLLIyTWzZ8y1hLuu8TbAdtx3R56eRkKwRlMNgyt+9RIHrONXPOnoibRoGLlbqU0NGQvbbvYyeuhu3VtvV6Ly/XMs4vYZonARna4mjcD+9leuVpfqTz1CarX+5LLvPLpqFwAvbH9kB/5U/UTP6E999OLenqbn27XWTR5fvXvffby3pi0dswfOiO2QTmO9/FNnhzncozrh3V1XFx0yvvSbwtJ8ADdJtPoxjAW688v7XrNPwafwrbYHBopUVzrxBHr8Z3hSC70r46JWdl+uxuePM3WktmZJilPVkYjro3SmwvbGj09pWSskGjgRUy+WPfylBQTIUUkZyuBErFMbLPn029fMB8OnE9HZgdrjg8PHO/fmSDyutBap5aFCoRV3PnZPQrg2cNGiokYMmAATBQHQYJlTQYtclDoQwhOc1dD0quY3o4mYpwZSuYSg+sANXOuIUAwZkhr1epFveRl1BGOjhpdretIrVa+pJhGAA6uiD+rGK0DCZgWShTXy1GsZjQl8jzb+YiVmuU5b6UKEhMh5Y0h1PtgjVgGQLFzibtp05bp3Z2wLpCTLwCg1otBmOcdrVhnkThN5N2eNM/W8jslQCmrt6iNgTTNZC8JExWq2niptcNamImEMMNhZgRT27n6vIqbFb/8K+4oVRUZpRhqY7A2K8lqfSyscKelEJTo2SUJav9K2MSrg0CKgZoCrZsY6ahxbu0iNLebM7s5M+fIYb9jni0bdToeeffuHUGE/eHAEKpOIbCbZ5IDgbUWe64hcHt7x4uXL3n58qWDdZEYEuLstB+yhZ/SNkRTN/uFTb2xIMfZDiMrsgHgw19w/R0vE1GMBTiiFLAAXLYlIubNoweeZp/DyGJ5INZRCzrFGQpgzDBfxMqVrWUEb76N7gjXzlgFWvBxjvKwLvzxQclpDwKHtXE7W8cyGcBsM7FZ675g2UBR2O1ueHkn9P5AL345AmnO3B5uefPmxLo8MM839N6ZpkzrhaVUmysCWTPNxzEhUJsFAkEUTSa4W0WhFlI3oKj6tQexTGJKEZJlWkWEHoU8mTCh9oYMajUwxUgQW1DUZiWaSESxzm+q1qUipGy2SztJI0KjlZWmo9VrMJp5F0ITpBsrCNxXRltUNLWuhFo7VYtpSFwlALq2LUkQMAHKQDCx9RAgBmOl5gApG0swQFBLKqRgejYpJCsHCJfOWVTzGb0sqCQkZHoT8wchErxcuCGgzbryYeM7iVgJmfPRO6Ou3WKMUirVy6M0CjKyyv1iVXo1oKbWhvROUkWks9tnTkEpp0I9rfTS3EZalnuDV7qzgb0k+1pTxuat6RiYho773iAIzRe76s/26QJ1LChHGe+1HTQ9gstnJTy1kU+YVh+0JZfM59Pv9Pdet1PqW/nV5brGm4yg6nL+Ouj5sv19uQJ7BgGMnevBi2mn4aLSlxgtheAaS754Gb4qXGzH80Tnp7x9cn5CLgvux7L+LD+hvVFbQTA/8eIFdH2gV5AIBCHPmdv9LW/iidNpYb+z+R6j6W/V1gwi8cWiqsVVILTGpodCMC5jQAnNAWO8Q5XPpZGiGLGgBoxpkjMpJ5cykK1xyrANY321CQS7ZsEAlMXq1g2cCPbMRzxni/hhe8wWtmZAzdDKLGVx/9DA2Z0KWzzbVbyXRYBmjJ4ogajOfvBus8MujjmPDkNszG4jJLnovELvjVIry2rnINrRWpFuvkyadegKUSCkDYQxH9mpvfk6x0uDt7GlHgcY3N4Z3U1BogcI9M2kiQcNI2Ep/qyCwDQl4mJ+rtWOJoUwbOgFiBj3WAYwswEhykBWgpdB6zieDD8xKhjs9W1NvNlgZYBPm112cLV7SfNYN2xbCFx2dO0rLnP8U/MTP7E990/bPo5y/ay9/AuOf/0gr7cPI2gf29ZloSyLIWW+9kR1q7fvvVNbpbZI63kbNtq91bHELXB5UnPrExzcwDFYIrIRR+w0+1Z25HAFDaV7/az4AjIFC3aNVt2JBGpZjP7XVtKULeAKgXm/J+eZnIxJEDxjtzFcPLDT0Kw1X8ANtYNYs7X+bmJGZ5pn5v2OvNtxvL/n4c0bJP+B44O1tn5spuZeWkNPZ1rrrMtC3e3Z7XZM07S1D7eMaSXuZRPwDRtQZYi1doEWkImNlZLzbBT4EBntUUOEpqatYlRAE9gcRi/GuIF8Q+Spq9K8jKj35vozlsVgTCwBxECtkCI5pW3CiggpDGDMqf05k+eZmOaN1ZMmF2r2muEB0kjwVnk6tFc8MEnRnH5rtOVEL6sJR+dITgcHRoRaytZavLVG9GcVct6YPtoL56N15RodoSREJCfifofkTJoNeEt5YnImTkqZkCZbAPozMb2FIaarDCEy0zYKl5hosMZEhm8y7Te7Otdp8r8diBvMsNY6pZoTbArWTtLEQttVXXkdzlWEc1k4l4XSGpO3zhaxTPl+zhz2M7UU1vOR72thOd9uJVUiNqbTPBOCUJZ16+rUsIDPNG9mu28ObP6iT3PZPuwYL2Eyz0Dt64WfXn328mWfX+phx3D8Hrj1zXlf9iNcnN71jkZ3TFXPZHisE2AL6qzTwjatAJxC7+c9DjOCBHUgOVp76+NaeDhH9jthqY1zKeQpoG1FMe0w1UDTQu3GrIgxkHeBA0JR4d3xZKWjPqYP+72TE4ZGVaDWShQPVjVRm7KUFSFQRT2v3NFaCGJzgRCtzasHS+NR9d5IEr1UMhlu4tppcWjMqImkBxfitPKp5iWlnfOyMinkaaY1cfH15lo4bWPgCUoUq6tv1cp6A2qArLrQuCnseWazUZsFwK0WlrJSTitNzUcZRb6h6kJ83TpNaewkicQobvvNRoUUmKZoIExdkKDWraQZ62jOO7Q2Si0IHTpIV0pplFgxKL5AAolu93o3oUqnKAUZi0jzq1YGW7dxo+bJfVwaIqPq74/AVy6lAyObrEBXA7FaV/KcyYcDPd2SPeOtevbdyha4X8dCFhRe2IDvx2nXcdK/bvtxCvnHt3Fuz8/xQ6UwcFVa9hNLai7HGe7pOkj+0AdxQPZigjyKu14z+Emy3d/rN34IlPrUtk/KTyiM4F6iJal+jp8o3eKeFCN5F7khUDVwfzxRWzPNnRg5HPZm63T4he56i8akUE8G1qZbeb4ODa5mXUxDtrL25iUxrr+LqFJ7B2nmJ0Jwxoy18LaOrmkTQx/6NuO5jW5FvXcI3TRbvMsdqmZLDY0wcLebXo72TnUmoQi+JrgCUdzml3U1+YWyugRAd/82nm/YSk6DKBqFEDE/41o6ffzXja2j2qyZhwMWeGdcwYTiqxj4bkL/zRKoS0Vbpa8NGkgTmCGFblprqSEp2Rgd4JUMUMWqAGzgDEaPEro4C8rWQQPcsLHo5Utj3bCNyRFs44SDRMhCSBCq6aOp4iVS45iXuaD0rZvpmI9X6MTVL8/X6HoF+7Bd24iY3rPMqlfyRx+w21dG4On3L37gU/MTP1uj5mM341+7fTx4+Fl7+YHv2Y352GmLL3yLL3o3Y7yhbBdn4pbm4lzUBKLUF94hiE2+0bXHDsBld5fA7PqBXWhw3ZgxV4BC74ok8Y42jgx2F2H1/dsICVuZxqCp91pZezdaow+UsuRNxDgGiJ5tTLU568ZKsoLMG7vBFvMJlT27riDWKeh0OjqS2QzswgCkUiooTo+/1Mav62rBvlqLspaK67U8XdyP56ZbPzdjyDD0XkLwAN+uKahp0kg3nQOuxqoBV/ZDd8TedRKsw5Y+GdshpgvK6c8pIA5w+d9iwpDij3uo3Q8x2jAYU8kRdWcN2Y8zt/yehFH2JPY5erUW1TVCixCVOIAK75QlIrQqtG18+/UFa1lujU6MItpb8+NGj+OFlGc0djRZaYF1RDLdI6OyYkLMF2hqezDdyxGevCpcvXJZ2AIX8Swsm9Ut3WTZh6vMi7ZO959tp2IOpnvXgt4Ho80iitK661wIOWVydjFt79CVowFfI3OxrsuGeg9jH4ApJ2NiiZBEjFpbVxBckypsV/Re+cAnvD33CddOdNi7rVzw6jMXK3q5j3L1rwXh3rHBP2aYoV5KZYZQ4cU1ejCOLbjxEh8HGwNmGgiu53F10GeSYW63ubLdl5VAH9emVv50rJ1VJs698bgU8iykYC3vI5EemtGPJSIxWwlPhDRP5F2B04lSV4pX9R0OO272O97lE2tZmXeznW0QSmsOSk5I9AxwV1rA9LdQYsyoWkcz0WEjA82zb713iF7mG5J15wgK0fyIdWayFUuI0WzC6CAxmHgC2iraI10upTddoa7dMtJqN3wKYwVlxrKDUbSD+Q0Llgu9F2pZWM6PLMtCWSvLaaWu1WxeSMboacbEk+3JKZo7Mkdisva04uWrMSUkCUI1n4a1kg0pI03Q2EhxtU5RY3wQOZ9Wjmsl3d0SQ/XAGkS6Ae/drBnd9XLwEl8PRId/CWMdqRe2sQTdMsgibCyUERz2bvqWXQIaoDWhIEzzHqYdYdojS7HMvw9iv+qrESxXAfwlYH26fSj4vn79X7b9S23jh773JOl19bnnn33+9w8FvtdB/vvHlG18b4v7p3t+9rsy7nUI79P0f/ETtn1SfkLsXFyaBfh5fiIQkWTloyEIeQdzqTwsZ0sWOyBxOOy4Oex4PK5ul/ceMgmtN5oGckxYtyKXX8ATgWrsEiWOvhQej4qLMpv2n4jbtRhtjIuQkokHI8akGZ1JUSunRa7KnZxFY62/ffHqawRtxmAcibMtwhq+1hft6iCKqumYCQ3thbIulggulVIarTZizKRpsmR2M8a16bUJmkAmvbAPRbFmFrYO6LXQ62LHDNF1LAMSExqzxc+IyTl4E5aqhfNSaVS0qbN0GnNupNwIZIMN9RL/D6BCZTCY1BMIhlpZR8HxOgieHPQSve13MX0gDeOe2ujWmKgEWlB6CKi4Ps4AvIYWmoqz/238Pl3jXs82nyj4gJbr967/vf6aIB+zwcMWfPjdZ8d7fqxPz0/8qxg1z5Gmf7lDejoormlAP3STP569uf597Of560//DgKlVtZ1pazrtogDLrTHq8Hlz2Yrg+rdjY3TOMbh5OpnHG8s8qPrcmwLzysQCN/LcDbN0UAroUlbuU7Qjri4lAQrrYnJOkEgpnVSmi3U21oYglumWWPMmjRZ29UYI3k+GtgQjQmS54MFtMkYRCEKKc7sgoElqrAcHxGnsS3nM4O+WOqysZDidg+UnDMarP1ebFDzbF22tCEhb04TX4jj9bUiAQ3W9o/kta5017EV0w1oBn4Mw4/qJoy5lVc1F6wcQrUDpPFF+tCR6V4eA5dq24Bs2ck4FjDOCrFnG0bFFSEFJI2MwzZQN2e3ieciW2kUHiw0KqIQc4SeIFi5TyvWfht/dkNbRZx2qOKIOyDaqeVMXe05hDzZ+BJzsilZWVNvpl8Ro2kZxZDwImnaUgxwStZBxd2AAz/ir8klDfVkXunF3gvWFUBMSnWAX9cZBtQ7p9RGr15iNdI7BC9Na86m8XsZIrV1mndbmXJiytkASAdqpmgLMNMcCqylbBkiERuHQYRpzkQPFWKMrOcj6/mMat9YNpuTg+2Z/7K9v10c5sfriXUsaLnY1SeuwDvfqN9ycRruEIxk1Ag/C6S3V9xzbhk8GP04bN8+dPX6u1fjtXOhrgNXc3zoHRgYUUU4a6DEmXiTOK1HprVyM0HoriCjFz0liQltldKqt+xUupq+QPPs8H6eePnyjjf3j7x7XE1024XYT+ez6cfkCQnWOc2aVnRvy5kJ2bqNlNqtBXUIdITWlOBsNGPCWfcqm4/WylWdOWMlfpfnYswMQaXTUfchgvZK02o2JzR6EXrIXtppgeui3ukwTZfgG710X2uFVhZaOVPqynI68fDwQKvqwWQgxQkRA0ZQE/FttQLemjVePXSxOZumTJiszLZr2xilhh8pKWRC7oSyEuOZKc9IrYTaoXYeHk62aJoNuI4ImgSaUlEvrcoIkx3ZRSyr62g5Pk+IFiu0Wq+u3zLgiF2XgdQ22E09wkF4CSbATOTm5WvIM+emvD2dOJdyWeRuY/OKts1lUn1oHqoH7MM3XxZS//LtOuN5Oc7Tv68/80OZ0Y/FeON7H8uSfuhanwIEMC70+bkNwGzEgEOdRLYQweZK77aIUr3Eg5dzu5Tt/rJ9fPtT9hNj4dtds7CGp37i6H7i8MxP4OsNCQntjdLbxjhEDARQtVTTfp54+eKOd/cnlmLsj9bNji+lMmUrxyeY9oqxyNXAk2Asb0WozRgvEnzhP5YhiieDg8eckZSDdZfztYT2joRopU0EmpdOjcYYMdmaRbHyWo8gkY4nYcWTpc1L3zDf4w7TksD10gW0FlrxTrNrYVkWajXpAu0QUyCGTAqT7b8Vu2e4oPBYK3m7bVtiiK/FvGFEGOXtA6TK9JSJcSLmidxNrweFvjaWhzNrXS1h3xpaGzpXpj6TdDZhaJkQSRvSp2o8y+EnJKglbLmsN4depg1oW19cBPtdE3Mw20Vd1zIhaaLWyKqNtTVqV2sMgKDXJukD6+IPzcLhT2T4CAdrnnxWtpef7Guc/tNtrG4d6Lj+/NVeh129rKGvz+nT8RP/Bl2f/i22K6v3X217/2HWdaWtxiDI02QBU7/wAi7YwWBYeD2aGyRrwWbZ+RCGAfJMVndadLjsx4AA2RxPFIGYWIoZJqjezcFqTbu3EEaM/RCiAz2tseoJisDxyJtvmyHM64o2CNHaq87enjnGQAidmIQYIarQH08myrUuaF8ROjGolTnNM/PtDflwh+QZmfZompCg5H1mf7un94XeVuqLF35ukWWtlFopxc67amdtlS7CnWccpjyz1gWpQqwZmZ2yFxJ5t9uAqbybCTEjMTuQZIv8SNwWTWM2S4jEPLtxxifUhcUiMgAVz6wM9L67NfDoOoiAZ0SDP2+8rMqYKyDeKSXNM2EIhxkqYQaxWjvCwW7aMgUDNNrsRHcDLi6e5U4sZ2Ka3IGssJzdUNuCKsRAJkPKtG6011JWyrrQ64oVNQcHwLKTccSFjeUJMGjnJebYo3cMOBcaFWjM8y2i6jWWBZo6mm+lT0/0CMaqlMv+BzvMWi0Gj4bMLFunrU7tBi72WjcwKCXTWEJNJb32bqAWls2Z8oEUJoJ25jwxp4kQLJOTU2KedyznhXmeyfOMxMR6PtNqI+dELZWmSr65AS0GatbCm2++5vtXr3j3/bfkNJEdUHzPY3zi23MHOMpmxMexJf+ux8ZlVIwKX+CJyN+TYMUD8NGhQsfuFK+J58qj2746BtzhmmK2GJUnnnJogw2w/WnQMoKjS2S+AfdYMKHa6AIF4VjhvsDn+UCMkUVP5N7R2omxerYQtClaoTdlXYtpCaxnWllZTyuNRJh2pCDsd1YmOlrVW7AfYANmLOyVbuVItStzzqRkoGQXvLwHZrHsbO2NUJQgiUiiVyi9M83x6qYauFK1kkJyJkYxXQccSO6VFiuZiag291tvSGjeXUOByUSEu5+/dydRF9VXLzdVF4lspVDOZ9blzMO7B47HIyFkYp7Jecc874gS0S70AoXCqhYIxTTRgyLO8uzBxH1DysZKITCF7CWzLpIc1DPKgpQViRMxma/uujDnmft3j9y/e0Qmod/MyKxoVqZpRsVq9OluTwkGNHdj5KrrxPVeIeim2dDdTtuw0o2K3nsf5CBEEipQtZttVEFiZtrf0iXTCJyWlbUUDxBlYxEIQ/hDwGn9Hy17GvNiC8CfzOSPzvMfS8o9B2mug+oLi+J9oOY5YPNjpVRjUfxjWdEPvMrwS9fZzKf7uXBJbZ0yFir2iudLti4q9tX39/kLoG/bp+gnTK/P/YRe/MTrdCCEyFlPpG6gcIwNuhoYXO1aelcrce+VWlZaXSnnlUYmTDMphq1pwrKaPY0h0uMohIU2EsDaCRpovROSsynFNFyGLMAlngbpBlJEGQr08iyxZueHKFGV0cV2lEGBvS9e+jTmj4nD940JLyrOcGFLVm8aRF6y39sQlVdaL6zryrqslLVYUk9HqU9iv79hN+9JcUZUWFKhLCshCvMuEyYhJdeQCfEiE4Br7DT/wa9FIiEoIbocQJqx07fky+HQOR9PVoq1eBcqB2t6a0y9E7URtJHSznVFxe/5GLejjMnWL1sdnroV8rHNltDHx2q8xNreUl0JBLF2751IcxH7URXQsbh90xAdgIsOkVxn/FyDLmOduqkwP5nZz379KX5i2MnL582G2gnZGm0wfLq/9un6iX8ToOaHnPZPqs+V9yGa5zVoP4+tM4KUZzfzg7t4WoY0NDNSita9qLZtwmz7fBJ4cIWqjWOzGXTrkHR5fRwn+EAcHWaG/oYOpod/NkRjBoToi2pf6NbqQIwby1aKZWc7xDQZwJEywdQS0Th0QQZTQSFFJM/k/a2XAnXqstDKQi8r5/OR45sT8Ej85g3zYU+ed+SbG/LNARXxMpWCoMRo3T9ynci1knJm1b4trktthFAppVBqJdVm9baeBejqaHow5Duk7OVXF12QUa41Sn9sIrgjxb4rMXg7vbw5+U3kK5ghFJ8s5hDMUY1uTQNsYxsTdtyL+rgxqGiKtNX1gwIahxaEQG9mDHu0kixh+3uIaIlmBnJnWaCrrHswsTt1MRdLgGQ0ta1rVVf1z6mzh6ytdV1OxqJp1RhQeUKi1ciOEqvNcHERKhOB1hu1rkh3XSYHuUKMRhbzpI8JA3pnEr/vIwCSJ3PkyvH25l1MBrrtQONVemoz3OJzyPVuxrhQYC3VO7PpVqsbQmAKVjM9mDJBjPWUc2Y5r4iXBcYpW/vzZnMt+MwupdjCOEZaKyznMw/397z9/ntevPr8SVc1Wxj9BNv2qW/PbK5e/TvG13UA7gpIW2aiD1762NnzmEAv+9wCDt+6RxpDCz4wAnh1gGN8TS8LW7k+R/+cH9TKgQYwP8QshS6Jx9L45+/egjb+8qvPiL2h5wcOOSFayAOodeHsXtUYFOtKW1d6KZTTidIzs2Qki+lSeTDbmpWktt5JMVJrY22dm5xcLyCgtVF731q0WsAMSqfoABAiUSNzmow91ixALFSEEZSL6cG0Tpysk5Fg3f9aaOTJ2SPd6vnFS5zWdQEtTNMEUpBYDTipzeZYigQRzuczrVUHLpSyri4S2VhOC/fv3nH/7gFVJU8TcZ7Y7e/YTRnpakBNtKxo1YZoQLLZJ9WwDa6uYrebRIgTIe+QtIM4oZLQaK2vwzyT2oGwrPRz8YplYd7NpJy4f3hAc6f3AzSYc6PVTponsyU0ui7klD0JEl00unuHkmr21XW4ulrZ1uh2oiilFNq6GAg+UvgSqWploIEIYbJS1wa1GtDXXKz4EiCPnw/9/aHNRSKezE7hic7N9Zz7mSD1NR39Y+zonxI8fxBk+hnb+7Hk5Vw+zDTSS2B3ZY/MGgyb5d/bQk3dXnuaNf159+yT3D4JPxGf+okvPyNqg2s/EUc8p9AM0O/VhNjrstBXA7Nrr0ySkGjdQoOX9XftqJiNSTE6qG4+IwRxBqS9NjLG47o63uhBTDslEUghkSQi3RLLbQBbDgaPpGGPxtQJTp8QjxHtBo2gdpTdePlSl+1Rqaqz8g1wUDVmS/e220O7BReXX5aF5bzSqhJDsqYeMZOnmf1ux27aMeUJCZm8Vs7nM6De2MNAmhi6M7aHxqL/dKyESY1NtQF0CMRESBOhK0Etdtwd4Ob2lvNy5nRa6Wu1+L82WrH23bk3Ulc0CzJhCfMR+w5jobqVIRk4c8VIt4FlGmbOgB+lT5t5scUOYD6iOzvXTn1oQ4bNVcg2Yq99wNPJoj6/PrBC530/cQWWPPn803X4Ez/z5JhjnDx/7+InPuRH4E/fT/xoe+7/KttQiwauD/mxh/ITdzr2+N5+P7QZKBK3n5ySlWC0sYB30GWUKfXNejtIo9sz1auJZws7oztvgI6fz1j8D0PV3ID2q0xTitFLUsI2iHprLMuZci7UWlnXynI82bmiHO5esbu942Z3S8hWV6oBDygbodtZBJkhJeL+lhATIKTVRLrK+cy5fcfjwx8p5xP1fGSaAtMuc3ix5/DqBSFPhDRRlxO9FUKAlBMpJ/I0kafJWuS5EGKtnSDNRDNLpaZKbXW7p0NQNwQT25QYTUuAcLVgN7qYSNxQ6Q106NXvq0CO9JYdCOj0Zp1AjF0yiK3mrEY2U3ExS7HiIZHRRls2kUiGyLEqvZtjjK3StRnF0w2hdffykqiYthEpKRFyIaQJzbMxhKK1AB9KdZY9jeMbWJv1YECJf7b3xuioFHSwthpaV9py2jpAIdnbsWf6YHVtxt32H8KmU+4ibQuDyhc86xBj8vIqH9vBBEWtlK4hGjfQUocS+jBMrojfm4FM2puDbb6w2qq+A1strs+fcQz154EE1lLJySafdWFrpBDI2dliVwi1sXHyJaPgYM2Ye0ZztWe2Lgvz3R0hBmqFdVl5fHjg+++/41d/vpDzRI/W+hD5r2gf/7vfnjpimxvDPv7wQvEpS8V29cRFi9Vdb29+aB+MYI+La1Rv4zwCap/yTiamK7gu7NZyVAbBzcetkaWvaO3qzLrg7WDpdIKVwEi0DlBvH7jZ79m/2nM6PUKthCmS5+iOWyF0X2yIiTX2xhQj+2miHTv1vEDIDjyMGna2gD+mRO2d83khhc7NfiblTO0LYDapNittShtbo6KYqK9WaBS0ChBZ1hMxKy9e7EhhAg1PxIQlB8IAF7qSklHyqzYTcS/q9N1K6IXSKiHvPIma0GbAbHdWTcDKLCUIpRbonXU5sS6F4/2J08PJM5pGYZ/ynhAmBCGIZadDEhIJKVaOqMFA8NE5pgchaHD7kpA4E/MeiWZzNZgwP9qIkoi9k8+FmM/UsvqiJnB7d8v98ZHH49HGWRfCzS2trSRVMpBytnihN7vPvbntajZ+hjaYilH0XShTu82V5ipjIQSPNyzQGyyCEVDv5gNdhbIUHs8rj49HXygNqPk5SPNj2/NgWp+9dh1Us82rJ3v4ERv4Q+9/iF3zQ9//1wLjz4GhH04w4nGAJ4Qu63N/KtdQwjgAvt64YlX84iOutk/NT4z50+kaaECT8MRP7F7uOZ4e0VoJM+R5dC69+ImAlSbRKjkIc8rUs/uJfdqaZlyGmm7Jvt6VtVZCUNJkTHcTzbU4rfXBx7NSpGYCZsTuDMuOJ9cwFmU1my4kf4a+JO9edhP82Jjf2uZ39yIfuQJjxmN3UMKEuYYWzYgrLzFjcwbmel5YTovr0SSLTWMmRFtzTDmTUiLnTMo7UjZJiqZtE8oPQf2nb2L5ona9vQGiqFQnOA5mj68JYibGDr0iKHnK7G8OTI8zp/ORWoxBSx//XMaSkWiU1NOWaDaQUHCHb4ncem1r/N/RDMXXScNPPAc/VIXalN5M5aE5eINfZ5Cx3pYn/5f3mDKX7elq+gn8wEWd5cpWX73Ks3fe26tcIKPnnx7DYxtHHzm/P3U/8d9J6dN/y+1yAydHY/e7PTklSiwYcOAdlpp6hyB7BMGtflevMeRyw4cDErG2wqgBCFuvJVV6Lah4G9HePENpNfciFkjmmJhSJEULnpfzwmM7cjo+Us7FS6qsrCntvePQzQ01CG+Pbzi9e2Mt7NbVJoRTF1OeyHliyjvuPnvNtL9hmvfc3t4xzwfyfuar139Jb3/Jel54+PY7vvnHv+H+zVv++Z/+SE6NPGemw8xutzfGRohot/NHLBva/D6cTye0F1rtDkCZCO+0S0xrIqbAruxdL8azELUQkiDZhI6thEhdnDd4FiFd2DBqQS1imgYhZwhiHUhaYrR+VEYtarPWfmbJzGB7ZmKg94AJ1blIJ83EeVspLCfr1GJUdt3EGkeLwuh1u3naG+gUE/PhQPa22dN8IE2TBfqHA/P+YG3W5xkvtNpA5uHcejH5SJFAnLI5vNaoZ4h+/N3dS+JiC462LNR37+gxkW9vCdm6UWkb+/H2vGqlVK0Vzsf7bYGxv7m1QKXb8xDvWqVaTdRa1IGkUcYXn82ukVHtXuusVjLlbaCM9ZIsgXSVQdiCeEzQrra+1U4va7UsShJygu/v37GbZ17t94RswFapnTxl0rq6aGej1kIpAaIgvRM69FIgJToW+EhrTPPE/nCgtc75fObtmzcs5xO7ecfE/JMM+Ke1vb+YE4+97O+nnx0goYheukXCEyr7CIq6iFO3vTR0BOhjnLgIoHhwrB5BD9c/nKWidEcSt9JB35l6NKD+voCLwluQrXolfyJ4lyLoLt4a6IRmYrPntfK7794yccedJlo7kbSyt7jW8lYlgC5oLc6kS+x2B1RmCGdOa6W3SE6zd7GI7vw7Uw4EGuvayVPkvAq3tzfG1m5KjCbcPoTsnbppgopBKb2ipVBjI8iydcNrpVNWq3nPk3UIFGSr2VcM4Kzryv27MylnZEqstWDRfDUbgCANRBqhF1SaMXaCsUNbrV5GKvTSKevCspw5Hh9ZTwvn+5PbuGylnyEjEi16LnIVaHagklIYSUQXLxYrW3WQNoRRkml08BiNpamixGhjp6t1cOoxQIob00WCMO92fPbF57y9f8N5KcSwkNPM/hCtHXdw1pKaHxCsO4iVDbCN9S7mn4wZ4GLKMdjga+5rxOR3arMSUG2KNBOzrFq5fXFHTJljhe/fPnI6FrpuB7Gy1A3aucxMkYs9fZpx1Ktg0u6R5QGvFs3X62e9vDT+/CFb+EOlUs8zn+Pv6yD5+Ws/Fow//+xzEOh9TQP/O9hCEu/2OW6HvTv8mmyWZGSRx6tDlDSAJeX1cm8lXGLBX7ZPy08Mu9QRJ701QrexeF7bEz/R24mslb2TO3pPUDv0FWoBVZTINO856ITKylobrQZyzB6qjtKJbmK/NGpVagqUKuxm64LUu+mFGfP7Mg8s1rKkWW1QRjytAxiw+LKudpTgidTBPLASJbvo1i0eDilh5ageP4uzbrxkdHT5o3syr1syuTdriz2SfLV6uVMxJk1ZjVWdJpNEIEQTmnedHFHXkxTTrMlzMgaPCl1NLFlE3RfZ+kybMWDAus12GfpCCuKVDmKJZGLCWPENEWHaTxxuDzweHyjr2fQUaaCrsZq0MznQ1OpKynlr+hJCMM1NFZqkrePssOsDABzaNPZInKvlshrWMcvdSIgeTwtldM/ya0TwNeh1MeFT/3Cx7xeQ6Mr6bePs4isuY34MpPHr0Hcdc2fMtusPb1Zdnr3/gfD6U/UT/yqg5nIPnjvrD2FpPw/l+imLoJ/2mR9+fzyU3jtTnkh5coFH+25IAWlWEtIHoqnOfGF0/9hkhAC2+vNRBjPYGFaPyYhwHI3rF1V5P+aYKqpKq8XaBHfhtJrey6CJgwW/IQldGktVzrVQHu5pzUpYTsej6cS0QhkiVBitPueZad7x+bEwz3umnNnlxGGe2O13vHr9msPNC4IEpn3kxevXTHPmmBPnx7ccT4X7h7dM0wMpT6RpghioXi5mnXeSLR6itQks2lhXM7o5JcpaTCOkVANNtsW6XBgbdEa7cRPLHPeHq0Fo97mjWy1tiGCMmyujIDBqXutaqOfFS4nwblqWkbUMw5iCSq/VWsUejyynM2VdWY4n1lKs6gj7rrg6fpwSMSoxdNLKJmScl5WcJ29//WAskGSldrvdnmnesbu7ZXdzQ5wmZDJdIfcaXmqkm0CxjnEVDZhKIk6td+E1L9XBgS+Jg1HEppkQXKBMA4jGIZWzMQe0FZSGajKNohBciPQqwlILVoYq/ZP5LlxKtLxu2hgyA4wZ43LMgSunEYzhFq9KtcxR6dYdKhKZQmKXDYxragLJMZoAsowMjoukUhtTCMxTpvlaydpVdhOp89K5w82eaZ7orXJ6fGQ3H9jtbrdz+2WzbYButo1gcTjA933C5qB0ZPMuH7Gh5EwCUUYfCNn2gaemLITeFP0wuvb21xY/6GXMcHUgjGas1wfnyRe3Ux5ZTcDFum2+dw94TLepEcUC1HfHM79TZX79ghQax+WBXXI2S8gQG1EXeiusy4o2JeWZQ8Q6axxPnFWYcyanCQmmobRLiRChlIXeI1OdKa1zWgpNIInbwOoaAA7uM+Y21mmvKli2shMd7Egx0RqU0hFpxGRtulOye1qqMfRqNRFHSUKWhG53oqGt0DTRBeJaTJcg2CJqLP6HXWproa2FrsppObOsC3UtBnakTKtKF+tIpWrZ5C6X0kMDkApRTEdBEZv3XqdvTNRIytaJL2Wb07UUQitI6JRqkEnvVsqENFIK5BSwpKiNkZevXrPWoZ9TeJRHVE0XaK2VpZzZ7WyRECWDn2dvFaRTewWM1UjVjTGraqL72vSSMVant7sIs7RO7Z1pv2d3e0eJmXXtPJzO1O6Co6OcmTH4ryJleM9ePbFdch0cul6Pfcj3I5epK89miV6u5b39Xm0fev1DgfXzQPU6gP4xnZcfCtSfH/8pMLAFZFcZ5XHN+p4ru/i8y30K1zbGF2Vm25595xPfPm0/YWxtaZ0YDFS6Py387luYX98RQ+NxeWCXIYpCyGjM5idqoayWlE1p4nCAkCKPp4UF63SZUkLF7Id1xoPWCk0jqSViENbS6KIkP2n1eJIwwG/dxnxHqXSCM7cN7zdQrLUOpRNVIAarHGJ0zPJnrCA9kKMBIdZ+uyHSrdMRssWKoqblpq2YDewuEt+r6Za5VMK6LqylUGsjYInKkCeQyJBCkHFwHz9WCmbJSOlCKbZ2qo6/hKgEaSjF2emmLSm1+Lqs2+6dsaWto73aCLpaq6Wcubm95fHhgXI+07d1WkVqobSV0lZqNa21WXdonhidX9W1aQTTX9QxP0QMOBwxto/73tWqnzr0bs/SqtkMSGwq6LgvwROx+HwY5WnX5YKq9tnLbH06d+XKx4wk8gemw9W0Gafv4JiDG1f37Pl8Mnt6DeI83cTvw4dYnX/qfuLfhVHzr6Ee/Zgo0E/Zftr3LscZFMzslLkhaCViJTiDQaOONo/Pj7rZQVDe/IN338BevXQLeXJ9l1Gw6ZBcL1DHhGyV4rWbj/cnimvRTDmTp+y178raVmrrnNfK4/FEKZVSVpbSWVtjaZVTueibiDbyNDPv9pR0y26u5BCJfeGQhP0uc7z/ni9/9St2+wMpzRzubsiTlTbV2lge3vFw/4BIJefMNM/k/UQX8SqeS3erGEd3nk5ZzfGUtFLXQiuVVpvXpF6osMLV6Hdtmq1sxw3SmGAishE2NHR3/GrgydV3kEv5WC2Fuix2PwDBGCpIsA5ULsiirbGezqznhft3bzg/nimraZiU2lECkmZEMiFl4mTtnUMzamVcF+/UJMTTiZQyKSaURE6BGIRIZb/bMe923L56xe2rF0yHG/KLV+TDjds+J1HqGEeXsWRtwC27EVuh1bjpGw3j0FqBGi4lfjLarpvejCK+uBv3059Bq0bTRy2TEKPTNAMQkVr9xo+65wHcXI1zESufsBn0pLyvD7GwMXfHwkIuZWchXIz09SKntUqUyJQSc04uUmqAzKgTvzhuo9DSGnOIpJiRnFh7o7RKW6sxpKqVce0Pe3a7HYLpaqzr4mVWI4v0ywbXNu1qRWfv2Dx8714NltWTJabvQk1Ly4Pzi56RQ3wjtpCrfY19yJVzvTqjj29X714FFsrQivLlgchlOHuAKYjF/oRtN5ZpVZoGTlW4XzvTbuZcj7w7LexiJ8WKyArSOZ2OHM9npv2eFALRO9lVlHVZkNqZ95nwaAuFkDJKZ3Etk1oKdYqczgukSJoztakBDqJUteA+ByFno4LHGGlGebkABhKJ0846UHRF10JsnZwssMs5oaLUVglJTMOJhrQVaYrQoK70tlpXJwlEEjkl6KaP1tRKpESVXgrnx5N1VANKq5zXlVIbcdoR00R5ONJqZVkXphyZotCd9RKC0Kta8qR7q21h01kLKThTzzS5QgQJndZNQFycVt+cDWQsVkFrI/Rq4vEx0FZLaucQefnyFW/bt87CXDkfTWg/pkSvyrIU5jkSAtTSaVpprViyQBSqINo2YV/tWAe72rxTlHcAc5051bjZu7U1pl1md/eC06nz/eMb3j4+svZuYJb+8Dj/aQzADwXP/3W3H2Lg/JTv/rxS+asV9uaqLj714yT798/vx+LdX3yFbZ+cnwBndjx9TZ3N0TRwrnC/dvLsfuJ4ZpeUHCsSVkQ6y+nE+byQd7PLIEQDwFHqWohRmeaMnJZNt1CBWoo3Iem0GFjWgsZgDUq63amAotWz+mLi6iHFrTFGV7PdiHjJuEspYB0EB/gWQ/M48nruKLRCl5GUNqAmeLwKwbVph8B6MbFkL5NvpZgMQ7FuSqVVlnWldWXe3RDmHV0irYNoJ0d/MBHIQk+AdAYfBFVaqazngtDpEVpUSo6EVImpEVujxuyVBw5OBZdHaFa2OtZ3QS0BrRgmGGLkcDhQz2fOx6N1aO3NEoVVWJdicXCMxGLNMcRj3KiBmKyDrw4wxe97x/ELTzh27V5qLKgG/9eImV28rXsNLLUZo0bC1nUIZ3aO0XhtubbSoh+cDB/yE8/s348u/69Azie280OzcdiJD/uwT8VP/DuVPv0UoOb5w/hvsT0dGDFP5GlmmmfriNQCKollXRiq6CJC67CUUVd+YXKIl5700Qou2EI5jjbAm1CwXjFnnj7IkT1IMZlBpvPw8MjptHD/7shuNzFPmTwlCMpSF75/eMe7x4W1NEpTQsrMuwM3n3/JpMK704mHh3tWzqzLQilnyvFImBoHdvyn//B/5tWrz5nzxPndNywPb3h4fMff/L//hs//y9/yYpd5/eKO11/+hnl/w83dDRJ+ze7xlrw/cD6dOB8fefftPSGYYFeesgkYN6MzAk71tnu+rgspCHU5eA2qO+WmmKJ6IOUdIU9InkwEVkzgjA5hnpCUjTHSipVc1eLOQvx5RTR2QrTOIb0DtXkpjQXqbV2sw1A38WMZz6qXjUXzcP/I/ZsHjqeF0/FEb5ZZSPPE7vYled4x3dxt4s0pRx6PR6NqnhfOy8pgCrW+uOBtQrtlWVOOzDlaaU3M7L+5R85vmbLw8vM7vvir/8j+5WfsX3xOmCZzPKoXNLc78h8wh5qilTO1ZIuqwRADQ+wxhopcAQ4jcWq/XMR4DR+xBQbFgatarNRNwkVwvqzm7GNGHDCyY9q5aa9oMZE18S42vQdCMGaYtWM0pE28BGGppsHUmtX8DjV9AXu9Fk7nE3nakaaJw80tZjqtTGo4fCuXYBNdllbZTxO308R+nng4nXlYFpZlgQ6lNu7f3fPrv/gL7l684Dd//ufkmGm1cj4euX2RR6T2ywY87Q4zRL4N0ECuxaIvsfglADdi7fY+F3HH8Mw5G2CuG6AXPHhR1au2okPv6Me30eVjO3PXFBgKVhdBRKMZGzvLru2i1+R8SL3Mm47wuHZ+/+aR2z97zbR/xcPDH2lS2aVGFNMqKEtljhP7aY+GSBPoMTFPmdRWYuzs9omUhUowQcoeUSJB1EsVjaEWc0ai6aqta4WEiRFjZaBalR6xrkmMts9qgWYMnItrNTnuJGrlhiIuYtys9WuM0UCIbmKQASzr2rqJI6eh91W8BMrOu6G0pkjDso1rpa6N2iqndbXsbZoIuz0SJ9pxpdbCUgq7stKilSwagN+pVBPPbAb8hBChBRdgdo5P79b2tleowrkZEKvNOnBoqwSsy5yI0f7bWllXS3qsXSkdApH94RZ65/HdWxNNpm0C8XmebCHZCz25zcSZnGIAcVQo64p1JzHWqYkEj25PQ7tBGRk6++k0EXqMxN2BiPLd/T9xLAVipDclbMyC98f9z9WU+ddsP5Zk+ymB6kjU/JxOSc+BqOdlVe8fByByrcnQtoYP46fzcwz8NRX/Y+/9sn06fmJk0i3VZWNqK4cY3ZYQHlbl928eufnNZ+TdS+4fvqbVxj4bQ7NLoKzV4sJpTw+mdaMSmaaJ1CsxKbtdIiWBYMzuroIS2RKTandEQkQl2DU1Q7NGG2wjRKvpfZFQhKJWdTq6BFWFtHUsdWaH2/1NQ0VHqQsmVm9HJkhHZNQPeJzW1YSKqzEkB2Oz1WZ+olRasaYjpVXT1AnJ5AGmmVaV6uB6AlS6lbFjTJ3gIEYtjXVZOZ8W1nMh0FkjxKDWzjtnYq7EvJLCaEjh6ztP9lmVgv2IWFXCNM+oBD+/7nHoDdo65/ZoYFY33yjB5BbKWhCJtKaEaGx6iUBziSTXt3TOi9+74M/JRHR6s5LiTkTUfHrv0LyLVY+R03Fhac0TSNdwx+X/11CL+LOTnzgvnm7PYZ/r7fnr+oGXPwTY+J4FLow7/ST9xE8SE/74xTx9/V/OpPnwQ36KfP007PunHe7qWH7Oqlabf3N7y5dffsmbb/9g9ZIrT1pqgxv/EC8G0BG23obYUyclU1lPKZCjodC9C6VbFyS7tuEshlCSWiA6kgtq2dPj8WRq4n75inJaFlrrlNZ4PK8sHSTNHF7ecHP3gt3uhsPhBW8eHjlLIJVK6t6Kr3dKOLLUSj+d+P7dAy+/+A03r7/k819/xXJ64Pj2exYCPaycRXlXhPLHr5mn79kfZlLcEVEOh4PViSbTFHi8f0upZ+R8JuZklDwHr6yNnlICZO9cUkqhrJU220KgX7VmHvfVyCjuHEJgEwQKMNTKTcwpoVgtrF48Pd3b6oWmSKwGdLhz2I6BZR6kmpBZqwvLeWFZVt68eeB8NsolkpgmY6uk2Sil2ivr6YFTrZRWWevK8XHhtKxbC9XmYmR5npmmnbWHbUpOlnne7TKH3Y7dNHG33xFbI1U4f33Pcflb9jd/4O7VKw6ffUbe78m7G8I0G9B7PThR02hImaQmtCt+bBPQDRsoI9dzzpH9kRkaSL8t3MxMBNiyC9qt7S9g7Rc9EFHVbXqJWDmRtkovZz/iJdtibXqxcg+LqraAatQqr2V1cHHoRZkLa6VQarEW25N9vpbVghXl6dxUA9YGiNrFlPibl0717uCgtyvU1ijLSlutJfHt7R2Hmxtyzlv73RiEravBL5tvl0DZ0Qs8EvT3R4b0UuJwqW/3ZyWXmuGuSrgWsB57cQPZxRJEiAft/ToIdGnqDzrEca6ytaGkXwA9Gy8jFLdjmYC3BU3RQxmrqDTqcrcTM3akQhE49cjbBdJuD/GGsryltMrOW4POh1vmPBM8+O7etjTGxBQjKVZuDzvmKdKLGhskBIRAjDYXc87M087ozt3a3McuSFNSTkhQy+DFBETWpdKT6bYEMX9Qqo1ngrDWypyyXX+1zkzLOspDleW80OlMMdND2lp8mv+yJVPMiYjX3HeltEIXIUi02v21cj6v1rVDu3VxmzOH2xeQD9TWKa1Ta2eKSimNmhrk6Aw6ExXXoBYk1wa1kjTSuhB7ppfGuTWmpqRcEQnMUzJQRmFdV1uoeEeUjrIsC60pS+2spbM2WDtoaYQQefHyM+idb75+5Hx/Ip0X8mlhf3NDzIGcG7udkCcXYZdApxtY1XVrg9uquv3x0dqtOCLGYH6pVEqtNA007abTkyYezpU/fv/AaTU/dJ3d/eiMHOzEf49N5MmxfyxT+TxQ/tDnP5aBHEyk68/9FBDq+bGu/7Yf+zvGdLFBjGSajeEBmn1on9cMz0uijc3m/WvY5X+626fhJ4bE91aqj+tpdYs49cpPvFuFOO+ReKCs7yitsc+BFGDa3zJ7mUzz6w9ia4wpRnIQbvYTcw6sbcQ4ptUSnRkSYyQla67R1GLfoALBgRcZ3S8DOIhgOJjFZINdnrIv47uPc58vrTWq3yNF6cHXSQLKpXmEBfO6gXLqQI+x6i/d/4y5WClrZS3WdKRqJ6ZEPtww7Q9eIluoXUki3v4YqnS0Wlkt7nOWk4E0y2mlFitdSsn0hUISUi6kXI15mtJWah987ImPkVIraymomn1Pc0Xcf6hrlE3zjrpbWZcj69quwHQD57outCbkqZNysvVoY1N31HaR0rChLqbJGNg6Y2lTY3/T7R5LoKuVmJkPs66Q3UHQDWy4AjyuR/xWyfFslv486zUWyE+BTWSwyq5s4gBLPvD9bd77+djcHHNoDKNPy0/8IFDzb+Vk3t+PXBlB+LnD4fn2Y4HIj1N/7fHHFJl3O16+fMnhsKeUwlqXTRdlDONRjqGMANUGZveylPG0BtsmOhXbNDUMiW7tAvCIT8hxG8QR/9YtMD4vhXUtG6Wxq+kSrKuJpi61QZ5J856bl6949foLdvsD83zDUZVUVtIxk6oJz2qqhBTpa+O8LHz33Tf8+s/+AqJw+/lr4mlHixG5fUnMQhKI0jjdf8NaHlmXd9zsXxFjZooJyZMJZtXG8eGBUmyRm2rBaR52n66YM9aSuzt6bj/aOlob3eng6EXWUBjlMA7YCNc3zB1A8JJ7rwoWC5LFUWaJEUa9ZreSpnE+gFOwEfyuAAEAAElEQVTQ7djL+cTxeOZ0Wnh8OG8ZCdNtyKYNFMUX7p26rLw9nzmXlfO6cv9wMqbG8WxdrrzN4M3Lz9kfAtMcoTVyVFKspGVlfzqzmzLrumdOmRwiS2ksx2/Y7TLnd295tTyyf/GSw8vXTDcvt+zMk/kQrLwJTYQWsRTMFX6u6rXJl1pT8dYBm8EO4QLU+D0UdfRYh5E3cb6uw2A5AnQ937uPuVohpg3M0av9JCsC3i6j9wvFtFZr595crNXWk8LaPOuyBQz22egA6vbjonYjqNDW0dCdxmqZmtF1bKtw7kaRbUtBujLPO3b7PSGmDfxRlPDDZucT23zBDlfmXN6z7O9n3T/kqq+3UcZoMcbITg7k3ALoQTnXTRvA/9r2ZzZ1+8OdZHAn6xlAGfbYLiS4UPYWhAe/oqsWl9fnPcaQzaHAUju/+/Yt693Mb15+QY+Jt4/fUUW4mWZSnqghIk0tgG7O6mgGtkySuJ1n9jlxXs4ETEdtrQspWdt562yRUe2UZgFFiDM9KGs3kbooamWRMbAcF8ramHcTISd6a6Rs4C29UXp3ANnbuTYhdAueTOS9EXJCCNSlWhci7V5ilEwEt3uploPhvRt8vvZGPVfKeeXx6OzO1ghT4ubmjt3hhi6JdloRbyuqKvQmtCYkHUwmAWcGld5YVgNdtax0Oqks1rY2Rea5MOVMCLCfspVESaCuBQFaMXHjhpo4Z4PTuXFeK2uzzGyPlZwjd/s9L9PnLOXE13/8PQ/3C3kqrLVzuN2jPRBDQ6nEJNRe6FqJ0TSA3OS5//MERu9o6QRRJELFRCAbQlWhAhIzN7evOK2Vf/r9NxzPherxQ2BQ5X8YrPmh7V9cYu5z6dre/px9XwM1H4vRroPbjwXnPxSYf4jqfh1kjyu5gO6+OPJru1ypMuKYH7oeGCGgfvC8f9k+HT8hY51zPT59/ouOmDawNOV3371lvZn41cvPzU8cv6dK4HY/E/NMk0C3GiSPOY3NElWYYuJmntilSK2FwEQOgdZwVr/pdZkGozqgYZ1Tu6gBIFsIbUyn6tpZUQOSguth2bpEOxTVTTzV1jl1A66GzogE0zFUZ32qgEZ7e7CeGLFWqfRqDMtSG831OIeeZe0NSZE8T+wOexO89/ZbvVn3xYb6zqG2AqHRurAslYeHE6fjmbaavEIUSCkQkyfTcyPnxpwSbcqkFL2UVre1qiLU3uz8WqeUhnAk5GQAzxSZkhBSIO8m0nlC1pXWVlvfiAF11ujRGJ+5N5pWYjcWfIrJtWoE3AcKgRSVJs64UWO71uYSAsESsQ1givQurKVTqzXAQQ1K7CJsAI1ezSF5XtvxdJ5dWcntxevPfsDqP/nMcz8x1nWX6f9Uf+r5DgcTDrDSbD49P/En3/XpgzdMYSz/h5K5rf1NLX1/+4Ivf/1bJEws59/RYkKb0qQbAp2iZeFG0OjbWKjqQNRFjDGRk4l1ebu9KkLpJpB1AQpMNMrYBMriYovnoyHAhuBi4NGqHM8ry9pAIvNuz8tXrzncveD29efcvLwjT5mcE/vHiXlKxCxMfUYw1XXpt3ROnNaF/+X/9X9D1nsevvtr/sN//Cvevn3g4f4d3/7xn/hP/5f/K//hz/+Cv/yzr/j93/0vfP0Pf8Pf/8//D959/Xfspx13N3fIq8+YcyS8uEUEHu7f8fDwwPH0eCn9CsFokD5JRyvyWhulmmBYXa3cSFtFqwEbDAS5Y2JfBKufdQBIRNAw0GL1SX8Bvi6ZGQ8ERwevUmnnhX5eGZOxdtPJaaXw5tu3nM8rtTRyyITJulT1stJbZa2ddSksVViacqyds2TS/o7dl5/z0P6Bbx+/5tt339HXhdYKqp3b3Wu++uIr5s9/S6YTpdHryh++/j2nf/5npJ54uc/8+vUXvLi74+Xrl8jdC2qHx6/f8d0fvuZws+flZ5/xxV/+NfPtHXl/QKZpAwkDDMFxWxj0AfU6WCbiVHtDnyVGa284AK0QNvE4BGMjxUyrizlzD7ZEjVmjTR0Ec5HhYiCbt1u6zDex51G29ot+vmHn4FtAuprDXlZzqs1EvEurgAceIvTaoDfTppkzIQTWUqwDgwcCvTRqMSV/E/rzHzVQrpbCGUwcD0yAtFmpWK+N8niknc6Iwu5wi4TgXb50YxP9ssEIvu3fJ+756t+PfNOd3RgOJm51EWXsA9BzAHBkY9wdPgFM1MfTlfvdMjBju86YdM+ABrmwqXxQDu/w5BLMvJsonAj0cNl78OsXsQBWu9JEeVgVvV/I08yL6QXxNnKqC7WsLL0y0Und6PKlV0rv1NbQ1okN9mniZjezlMZuPzOnTDmNgMdE7kspps0C7NKEqnWR0FgpLCRRVi2WyQ1Q10JYDcDpvRJI1i0tGAhqZYumYVNa3YJ4AdfXmggarHsbxsoZMqFNDSBXAqEby7Q2pbTGWipt7ZSlUFo3Wn2I7G9uObx4SZom2mIaUkmESkRboBVYQ0NSR2r3jhamsHA6FY6nlda6zXXtcF4gKDEIc07ssmWdy82eFCMpJWfSdW+HbQLLjchalMfjyulcaL2TciCkxKkUVuD2xS1f8mtO6yN/+P23nB+PdKeetx1AYlKIXUAqXRqxBWLsbl9t0dc909+wjlw23gyYKQg9BErplG5layKJ06lwPlc/txE4/7cFAZ4HyD/ElhndM3/uvsfvz7frY/6spKKAJXOeczC2PX/sSz/9ED/3nD6J7dPyE+O4XRwwUt2YBYL7CQdtHxZQXUnzzF1+QbyJHNtCLZW9VmYC2f1E7Y2qxgqmdVIT9jFzmCZq7exyYk6RUzHwaiSrWmu20JVADgnUunZ2qaAVESXQzMOpum00tkAQkyOIAbqOJLV5w6BCqNVjOTHQfoBWfSQwDERpo7zqKqndS6MXAz/W1RgrvXZKrSz+twpMeSbvdqQpm8i9a9O0Uk1zp1jXQhUDNdbaOS6Vh8cz7x5PlKVishJCdtH4KUdyTkylMaVGzc3sfozG9HGGhshIkkNpneNp4e2bd5S1sNvPfPbZS169uiOmZOMyR+bDjtoKtVfWYuVPUZtXVAzAvhJaIFSxluIpEUImBgdsVEAs2RGu0M3mPmvMBeuqZWV+I8FhzM3uoMylCE+2kXs13n9gBsqzXz6ApXz4889es9P3uSBi6wc2XG87kVFW91O3T8FP/Gyg5uc6n49/3lfSP3BhT9Gt8drHP/NTz+X5d1SNirwsheo055cvX9NrZz0v/HH5PVbuFAgxXIKRUVfOhdolwtZZZ9TCBqxloKToQAmGJLfmHZ06F7UnEwFrrdEU0pTpISCt0dGtDXRv5rRCFHbzxC4l5mQGepcjOUVSEg5zZjdNTDHD1AmaSCSy3BBT5KZUy4Tef803f19YH7+lOF1vAl7e7vns5Q13dwfqn/2aII1yvOf7v/kbSlm5f/eWfU5ITAQJ7HYzqreEaN2Deqt0tbaEG6LaR9cOW2S0ak6n10ovle6ix3L10Af9cDj7UVaLPDcbHZtcDvL07t2j1EurGq2s9LrSa7FjqYMBZWFdVtZl5XReATENGe9Y1VqjLAtrV6pATRFuXjBPe/a7G3YvXpF2B+J8w7tl4Xg+k+7fWBZhtc4pbx+OHNbKIUQ+//VvyQHqeuLt45HHb/7AcmysFXI6sayNh8cHzq8fuLs98NmLF6CZc+vUb76jtcbNq1fcfPaK/WefE1JGQhqWmg029/EavGzMsiyZMOionh2ysXkVzagiu/my33apAxx6LzrAmREJyei80s2rxUhIMKrMR6la9zrfEEwvxzINzdhHDtq1Wm2/wUpLLh3WjK2mozWtXlhaoxRAYJt340eAKIGbecdhykzJMhfTPLHzsda1UbqNoHJ+5Px4z/Jwb4LPebSFH+Hhf9tF0n8vm14B33CJY8XH1g+5DIGRBLswZocv9313z1yOGFm2g8hmI7aa+O2cLGi/ZuG+54s8UBwfGldwlTNhkONHpwqbJ8HXGl5BrhfbFNQAda+AQhEe1srff/0dr29mfvXyht2053j8llIruVZSVWK34FW9I0jAuqTNOXPY7Xn3cKKtKw3TL7vQh4MJtJ8XooiVLcXk4uWAVJoaoy8G69CRUqTXYhRxbYTQCOKC3SGNmi6v/7Z5NfxW6OJ6Ao1ENjMhkeY6VnG2BUDvgrZOLZ3T6cxSijMoG+fzmfPZhC/vXt5xuLuFKFYyLCC9k0I0dopaaRaKFbWKslYDypsG1tZZSvWg2qxMaQVEyRGmAHOITEGo60oIQp4mRBwgCdYPtzRlaYXTUjkeV0rriMAuZKZuHRokRSRF5sOeX//Zb+lkfv+7r7l/fKSUlf1SqK2zqzvynAgJ4mRixrV7a+A+jmk2rWqnqhKvNAlUBSVQtdMU5mlGu/KP//hPPD4eadXKzKKzIK+7Rj4f5wa66ZPJ8YTgLu/Pi+vwaATXcv2Fq3k2JveIj64zkz/EsPkpceTHMqMfeu8CDH34mFsW0+e7iM3ty15GGbrNWpUP7+OHMp/uisyHCjzVZPll+5T8BA7EmJ+wExWGxhkEtYTpSCGqmJ/4h6+/57PDxFcvD+zyjsfz95RSmRvkpsRRO+V+QjQg2plSZjfNPJ7O9LrSomzs4kvy0ljkQZQQk7EDREGs21un07QRVDa70WrBRG9tlRPo1ulJvI+42Lk3Z21H18gh+mTQhqhpbdq9VjoNgs89T8xptdivrNWbiii1VNayUnsn72am/Y40T8R0iRmDmF7h+XjmqGOMKEutvDsufPf2kTf3Z47nFcU6fe53M/tdZr/L7DQx905ZIzVbKX5XkFAsYaIuGRATSKR15Xhe+Pab7/jDH/5Ir5Uvv3jN7d2NxdXBtGQ0moblvt96osK67zbppJQ8MWndmaQZc7VPnVY7KXZi6qZl6UlpK9kb4fwooZKtzXPvatmi1lm10Fsct99G65gMcjXOr/yCbAyzy0SQCwTpy6ztEx+eoE/eubLP+Hf9OMbQdz8x1oRP4B9xY3o1F7fPfODQn4Cf+Hdj1PywI76+6R9/AD+2/RRRoPcDA3ny+th6b1s3ot4a+8MNtRROxyPffP21BSLiok7+oEZWcyvL8c1YCW6YsfeDiHeusW4O3XUBtMuG2Q3nMwbuYDYkv0uGmppDiyGQkxBTYpcSU0pMMTDFQA6BFIQUAvsps8uZKWVUKqKJJhM92ECaciXGiPSF5fENb3oBDeQ08+L1l9wedtwcZvKcuHlxR1u/4PSbv+D87RuWd29YjveEx0fSNBPzRIomcqbAbiks64laDdS6xiVVjV3T1Onf/dJuWfsQXfYnNpz5GNd2k65+tr1e/eDvdSvZ2Y5hpVW9NesApKYZ1HqnLoWyrKxLQVVI7hAisDZzJn3QOEMizHvSi5fkwwt2Lz7jxevPidOMSuJwc8u8O5CnyRg/Yt87rYXj6ZHj6QENAikg3VrariqsXVg10cJElcT5XHn37h1oY7ebIc+EppSyIN9+S3XQSWIk7w+keY9IZOuTIDJsno3hmLzrk+tL4NZ8BONyuXeKO3RX+h/72sa/I+NPqX9sc8Pa/xnTRmK0EqihaeFUWjumWa7edctym4ZDczbQttdtHkdfRI4YqjtIowOlF+s2NsXELk+cnYabQuAwT+ynTAqB3jo5JTqwlsqSrP6giuL9iunr4t3LzGkGCR81wp/m5uBbd7u1hbHXNv75JlffZEQgVsrmc70NtqGPvSDB57Nl8gRb+G76AZ75bNpdF2uUp8k2fsEdttfcby7bs4G4/gmMlqRjjA9TYxlJkdHZzhenAuK0XBONH98xEcHSOt+/Wynric8/u+Pli9doWzk/nKwV6HomqpKTBfurnlmbQsjs5h0xZo7LSlUhzztK7ZQmhNNKFkFag95pAjWeCSnSpsDNPtFD4LguoCtUr5kPAZIhSrUVKIEWhJSUGFanaauVMXkALJg4fIydIBmugd1uop5SzZutp4XuJUm9V1oxse56rByXBY2J29eveP2rz5kOEyKNecrUpSMJ5v1EQ1jOC2tTYheyBlqH86qclsZSYVVlbZXSlSCWnAhRaG1BtDGFyERglyce1yMpwW62TlIiJgpuopuJ83rmuDZKDFSEcj5ZC/CuTGlmP5vAv0w7bu4+489+s6OtkX/8h39iXc6U0ihr5bAr3NzdMN1MZiMVk+aMauBe6kAYpEZ6ntAgRFVLVqyN2quXjHXCHEmHiULjtC5b21UdyQutH52Zz2fee1ZL+7MXn31i2N4rEz88rAiE/pRJ01rb/n6Pnn51PsJFu4Or3+Xqc0/FZZ/uSzGfenn/6YGu1hXb9y9Bv1jiYQTbWyhxXb4VtvfMThhDa4vPZMRpo+x3nKMF75dW44PR+8v2KfkJ9OInFNMuMV0t9xPiqatRrtUVCcY8fHO/UsqJ1y9veXn7it4Kx+OZUAosKwllcj9RdHE/EZjmmRAya2kgjTxNW3egWhpZxOYrlb4qKrZOCVFJMTjI3Qg0T6b68+iyPQElkWMgBO+259TiIWrLKH3tzdnNcQN5FKyphKvmCkqrVvppiT8TABZPqK6LdXuKU2Z3c2B3s2faZaY5k0KkFivpbdp4+3DPuqwmDt/huBTevDvx9fcPfP/uzLk2JESmeebu5sBnL29pEqiiLKWwj4naM60L57XTtaCYkH5OBg4hyroWvvnue/7whz+yriuH/Z55f2CeZuuYJdbVCRJJJyCwa8p5aZzXI6iJ4KeejW0kpmnUiyVNchQkBYJYh9c+Ok75XAkSkG5JjTYSpcH0z4IoRI8/fF5Zid/1eL5abz/DVZ7DLE9mo8+vyxc/7ieGb+jbx4wNNKQrUFvrjZLG56H0NWgqcrEBZmcvPNJPyU/8d1v69LEatH+fTamtcD4feXy458333/P551+Q80TKmf/97/6WZbESkQ0q2BaFl3MaGSUwoakYhCSRKKOOUywgC6b0PU8TQRpQTBtAbcLllJFsaHVbV0x0VWgKEi2jerc3IxBiZDfNHLIBMvucmCQQCcQmvNgdON+s3N8deXu+J007tM2sx0cImVgbt4eZNCUkRZRADhO3Ny/4q7/6P/DF61ccDhkNjbzfcffFF8RpJiB890//yB//7m958+13zPPMfr8n3d2SgiC7mZevX/Pw+MDpdGQ5PjiotT3QbaGvvnBHvZTm6scAloaMQR7seTEG+CYeZVHvqIH0h+SreKdxOlW0OYtnBAwO7VMWK3VShLuXL4kB0EZ5fLRSrKaEOLHb74k3B+Yvv+TwxVdMN7dMN3fM+x2tKeezGfDD/sB+f0PXRJoSeVo5vSu8+d3fcXr3LbK+Yb+boXfefPNPoJXdzQ2vvvgVv/nrv+Z2znB8w5vf/T3n+6958/U3/PbPfsPN4cBht+Pd8cTD4x/59g9/4FenB1588SU3n70m72/9stQFLc0wCOr6Osnqlb1kQulWyrAxYVynPzgo6WPTarHxe93s480MUIjW6alVdaaZgzTqYb04Dbard80azJ5kz0JHu2BnomHinqVYfS88FetKKRG6BRe9m8OvpcIUt85dN/uZOZrORy0mVJdC4PMXL9hNiQDcP56Yosm41ZQoaSJSKdJ5Mc/cTYmDKKHbvYz+2V+EhJ9uOp4zFxq5PnHu15979to1gIuPAf/dshkj0NgO8f4C0rcRloQts8F7gcD4cpCLu3+qN+QBu14WpSb+6PZEzBYN0H7zVdfBjgzNpi1MoqOc18bb+zMx7fns7iWHm9ec37zh3fIH1lpZWgGpFGkmZDsF0rxjdzhYF6JaTVAxZ2Nl1kYrlRyDgc8B0ylQA0VFGlMSqBVpFemdQLAxLwGC1ferWgmgSGdhpZ0rKdg8iyEy5R3aYVlWlE6KE/MkzNMO3FZL6KxLZTme6UWhQaudtSysbeV0OlKWQiNw9+KWL776knm/R0Jncr0d7Y1pnlmrEFal6cL5vHjgpzw+Lnzz/T1//OYdv//me+6PK+dqbNPDfs+vf/UFf/nXf8aLFzuCVmp1e6YViSBrp3Zlr0KQZtoGat2u1mLtrmur/G9/81+oxyOf3d4w/9lvePWXX1g2uVub2mm3I0jmV7/tnMvK7373T7x7eODh/sRuPnF7PnO73jDdzMyTJVNSjra+69BptOYC0CFs5XLdAerTUlgUFxiNnNfVhlWQq1Ur2yD9uVooW+j7XnbxaRA+aOnP8lzbHLxmKb+Xzfyh49qXrt6QrbzFw9irtz6y749lLPFp+iyb+iRpN1YU+v7xnu3Jvqd6AaE8GxwC3hr3Y3HpsB6/bGP7lPyEqCWjzEuEy+AO8uRKbCx7edDmJzrvHhZi2vHq9o7D4RXru7c8LN+wtsbSCiKNKp21d1oIxDwx7Xb0ZTUGpSZSzHbQbnFZdCRDggmzBwmm76VWCitNKbSthMa69vm97xCagnYXS7dzTzEgkwNkwYTTmyeVhUiKmRizPSXXOmMk1qpuwsTNm1J07azrSmkrkjP721v2tzfs5j273Y7dPDvw08nZ/GGplbfv3vmx4eFYePuw8vZh4d2pcFpNOywcK49nA/Y1gDJTotJCp1SlWKhJbQsinSknpsmq+FuH4/HIt9+94byu5Gli3s/sdhM5RWKEFIeuY0RkQkJkbp3psBLOZ9ZlZVkLQiSrmMhwN/mG2EByIEq30i9tNrrVyu8Q8x/WGapvsTTB9Sa9I5RKspHkIImqbObuiXn/CLPkiZG+xiOu5sQVlIIPXxsjA6Xx9zd+2fVS69mx5L1T0CensFFQxpzj0/MTPxmo+bEasJ+6fTiYuIyeH4o1PhaI/LTjj/1fIWDDMPZOrcXYCb05K2THQM2NgWBUskE/C25suxqiH6MpYIiwMQJGC9WN9aHDTgtTTma+g7UG7WvxdnmG2AuXco5AIAk07cRotYwvb+6Y5x1RrI5x3h3IeWYnZgAigZQS826CmJjmPf/bP/wdx/OZVYvpA0iAGNCQCXkmTxMpzXz28jVffP4V/6f/4T/z6sUdc84EieRsTiciyH/8T7x49Rmfvf6Cv/t//t8px0eOb95xN2fSvCNPmekwM+32HE8nvuuNspzRVp9OjH4BUwaLZoAt6uVQGusFvFET4VXP5OEUQhtBg+IpFyAHjNHhwECKkZwnasqUkEwAWgw5ne9u2IWIiGUGyrJQlsZyKrRmxvdwd8N8dyDf3LB//Rn57oYw74g5MqVATxDjxBe/+oxzeeC43rOej7TlTJsWcjpjmnBnjt/8A+dkgFsrK/M8sd8f+LM//y1/8dd/yYvDnrAe+XqeeXjzHffffc0ff/c1t7d7Pnv1kpvd3trJnlZ+/7f/yPnxzIvjkZe/+oqUZwNkRJim5Ea603tBtdIKyMiYRED6BZTpzY1OR9vq7Sl1u9djykbXlVlrdUKgZ6BE8Py6PSssq96HNo3PZWMjRC7GV2jdytCaR07XLBubs06x9xLEgFqXmWzZbhN7TuQYefHihlYa63nh8eGeUhtBhNubG4JaO8i1FAMEUWopJDXA9RAin+123KaErIsFXlip1i/bD29b8A1m935AdfkJsLq9yObUlWvfo5fvuDG9zrQK1v0j+NvXMnDw1E+MzMzl61dByyhp4jLWwQKKoAMAFeJ43f832jWP10Ta1b6NudFVWBfln3//hsfjym8/f02a9+S7W6QVltOR87JSNKAxIZJpUgkxc3Nzy+PDPUGFu92BUhZ6M4q2iFBaYdJMyoneO8u6knNk6Q2txUtsXNchJEKzTGaKgeqi37V1klc/rd3m4S67gKXh3CZM7K28O5WuhabFAAhV1lKop4ZqYF0Kj6cjpRWWuhIj3L6847NffU7eW6YyxYkpJXOmKqS4Y86RmgNv2yPfv3lgKSvntfKHb77nH//5D3z93SPn2ineQhsB3j7wz998w9/94Z/4z//Hv+Ivf/MrDslsfHFKe2+dta6c1k7OO0IMdi+S0kJiWVf+5//P/5dv/vh7vnh5xxefveAvfvsrXt7saecFyZEQfYGWlBev7/gP6a/oIvzD3/8Dp8cHpvPCUlbWWjksB3b7ibqbmeZk2u9RLLZQ2XTuunZaq2bnxMQ7qwqHPJPyzOPpxFqbPacfoUo/iZOufv9QXP5DgSzq8bmOgJlLwPp8yv67JdFs+2Dc+TNAkB/TMfjR73IVxHtGdTA4t/Px95+f1y/syw9vf/J+Qob4q71prBoxjZbhJ1QRz/hf+wlVYV2V3/3xLY/Hld+8/oycd8SbA6FXyvlkdlahS6ZrpBKQmNjtA+W8EBQO80xvFe2V3oOV5KqVmKbJSmhrs6YbzeNw1PybdgNjTL9TCCrUbowNmhKDdaqTbjo7ETW2kH9GBUSMUQrGXletG2DTmiU/zXGqtbiujfO6sLYzMgV2N3v2Nwfm3YF5t2c3z+Q8oSpMKIebyIu7lf3ue75p3/F4PFNa5/HUeDw3alcrr4+YTe2d4/lMfKsgjdpvud3PtGCd/s7FFnitV6AypcZUFJHqAsKFkDL7mwMA85S5vd1ze7NnP0/ECCrW5SqmQImB1BrzfmI+7Fhb5VxWeod5gqQZibLZlYIlS5pWJDTwLlxb6+GtZKwj2PMczysoprMpnebNS2xQDgfJU3/wEdDho7NQtv9doT6XMS88BUR/sp94AsRs37wc8smRngJE7+/qT9NP/CSg5qc74ctt/Tm1yPDDAI29L+8Z0I9tH/rcUwrVFeKnbDeze6ehnLLXkRvKG1w1fesgI5d9DFbNwA/VBcJ0GCxXaA9DmKu71kEIpKBoiPTYiVIhCNKxkii91OyOkqsogRQic8rs9zv2+wMpJKhKniZyzuxiIonRMaMEUsrEfSbHme+/f0MODzyejtR1pXlDuN1uz+Fww25nWitfffVrvvzyK7768gszPmIOJThTomtnt9vB3R0sK4f9DY/Lwnpe0NqQWUkxkW4OxDwRU+bx3Ru0Vav1F3nyMyb9Rinzf0cJ1FYKtTFktmJNu+sil7+Hiu54zs+OFYKQ8kTKVqplUX4goOTDbGVrEljuTzQpiAYgGSUzBKY8sd/tmPY79vNMnDLiGj0pJaO7JuXly5fcP9zz9u1LHkRpIdCCKe/X2gz8aMVou64PMU877l684Msvv+Dzzz/n7rBD1gPt/h1RO+X+nvPjW4J2phiYs+nRdFUe7x+JKSGi5hRubknznphmY4KJWJtsV+0XR77t1vl8GPd2GEkJbsy7G5fwdB6NuRUuNc3qZVSoPxc1DSAD2pyFpn0D1XzGbvu0U9CtkxTbXNLrR+7HH5mwSzcuEzu1+XqzP8DUWWPiZr/neF6MuSUXgT31AEFdPyMJBLG2lzc5swuBoMro/PBz7donuW3DSTfn/txRXf3xJEoeQMhQg+naL/Ncr5wgHoKI/6YGQOiVI//AutTeeTKI9Nm/HtSMRekVGDN0sgaTJujT7gUbQxBMlFFMuNuOF0G9daYqGhPf3S/M6ZFZCm++f0PQQi0LvXdKF25e7AjTDOey6ZAIQpLALiXqcrLSzGgsEImJopBCNIFvCSbaTocmtNbIweZwVoguTilqfq67Fkys4qVBxsVrobH0xUSEYyIkE9gtrVjZFN0pvJ1lWREiS6ms58rj8czxfOJcF0IO/Oq3X/Dlr79i3u8IKRKTCSdC9K6GC6qVofoWY6Yj/PHb7/nmzT3fvnvkzePCscOKQEqIZ7FCCvQY+Pb7B/7H/+l/ZT2t/Of/+JfsQuS8FtZmGeVzUR7PC9MsTLvIvBdyzKx15X/8n/5nfvdP/8jrF3d8/tln/OrLz5mysJ7OCIkUXX9IBHXRzJefveA//Me/hhj52//ytxwfj5zfVo5L4fbxxOHuwOHuwH4/E5MF99O889KI4HPFyz27Uh2AImZimmnAw/HMWr10lAsYuC0OfyAe2t7TD4M1H9/0Mv5Ftqzo9TZo5x8OkJ9+/D3tnOHvf+T8r7/zQ/t6+t77+3tuu6///lBW9YlegepFDPk6drn6zvjeExf1C0jz8e0T8BOj9fd7fgILVYMvzD/kJ1aFHjNvHgpzPjFTePfmDaKVXle0m6Ds7rBDUqSHleZXJGLd7XKIrGW12DfafZIYadj6QL3duN17Y/5YTOoM6GivB3FWh7Lp0bSoZMzPxK4m5o5BUuo3Q0RRqUQdAg8W12nvnoRr9GolIGtZWctC6RVSYHc4GJPm5sB+f2Ce9+Q0E6MlIojKPEde3N3x+vXnvH33wLJUzusCIszzhGQIWQlLMS2z3olBaNp4OJ5QMSbp7W4mSUfWPpYNgHJeC2k1zbQQA/M0sb/ZUetKUOWLVy/47MULDvuJZAJrINZBWAIQhNISeT8zr3uWtfC4HjmtC1WVWTs5TVYuJYEi0EonNGftBuu+aLqn/TJfdGjh2ZpG1NiZvXVadNHm8RCUq2vCS2avsBG5fl8GtsnVL5ehf72E3kAbffLy9bS1ISNct9z+yGTbXh9zU7bXL3Y4/AR7+qfoJ34SUPOvYdH8pADC9nj9znvv/+sXRnJ1w8cxBPDWZq059Tuw39/QugWdy+nMNE20qUBXVqNWMDriDICh9WGi7BhddUNgc4hotFKoUUMbnAOtwTo85BC8M5SdbfcWcKKuUxMVVSuX2u1m9oe9lRqFRBYLeKdp4mY/e1tlO8cpWPvszw6Z6a8i3775ju/efM83TvFWgRcvX/Pqsy+4vXvBixef8ds//y2vP/uML754hWB0eSkrfT3TTkfWd29opcJpIfXGi9sXxNI4dUGXRtjDlCK3L19Qm7I/Lxzv30ArrP6cY7LFdIrRg0d3xA7Q9Godf2jdUPqrVtoX94sHn+P3fsn8BRO+RALNRaBjEGIU9ocbaEqvStF3IErIkdtXL2mtsS4Lpzf34K1u9zevWB6PKHY/5zQxp8zsZWwSI5Jn0nRAYoIY+dWXSi2d8/FMawtrSrR5Ryz7rdOISqZ0K3eLBF69es0XX3zJf/yrv+Y3v/qSXY7U4wPxqy84BCUvZ/7+/h3ndye+P53ZRWHe7Ui7mcc3C2+/fcP6+EBOyu0XX7J/8Ypwm0lp9kWQWN1vN0GzmKMZPhf+VTGROsRKmdI0WQDQzQENh4EIrV8ovjG57lLv6LpYVCQCMToI2i7t14cKNsMg2wIPZ9ag3sbeO0ddA3bi5YMdm2/GvoGkpo10cziw3+9sZquVQiSFNs28fvGSUr7jYTnxcDwRmrVhzyFZxzEvObhLmX1K3E0Tn+WJQ5oIkggpeenjlUX5JQh/tl3ZbXkyS7ft2lFdvnG9i4vjC67RdXGYGGDutmLLSihs+kXeOns4eZH3j/nsdK9Pzh2rfvAaNhFpvcQs4ufVZXQgseA9SDA68BZ/uFy3QBtlrBJMTDBFjuuJx7ffm55Ls05ocT6wn2fuXtzwzbfCw/3RAPLaqesCvTPtMiLCWgqg7A57zueVUlZu725YakW0k8TmuqRETJGlKbpaWZSqaaMkF8ruEmgYECzSWdZCoNITpGlCNRogj3oHOOV8Lggmdn8+HTk+nHl8PHM8nlhaYXez48tf/4ovf/MVN3e3pJDJaSKnjAk3JGrrLEvhfF7QZqL6KUVuX7xkendP+f4dp2WlaKdFkGRtwrU3UpqQGOhqGdTSlL//5z9ye7jjz7/6krUqaxMry/VFQ5VGkUKPlUWV//3v/3f+6Xe/3zpf0Tun85HSbmgtWvcpUSTZM9Nh+0Pg5auX/A/7/8zh9ob/8r/+b/zhd3/g9HbhvBZua+dhqdzc7Li93VEbrBVjxMZoXUq0OagGBaheH9808O7NAw9r5/FUUbeRYyBuC8OPBacfnmXb1r2NzvN9XE2JLcAfGcPrbWhUjPdH4Np7/+h5fei1DwXgPwdTep/2/tPizuvfLxpndtG9e0ZDn53zs++OY2/gE3ZfLvoDv2xPt0/JTwwRejuPi5+4+uzH/IQKrUKYgicAE4/rwuPb70xrsSshTLyUxC7sOdwceHf/lvPjmV3OaO/UsqK9kydPPLcGAnmaKNVaYucpe4JNTHdmzFvxBg0MXR4uJVEYeCPdksviYsB2rXFrpiKxE9XibwPIOsGfQa1W4tOKrZNMOLgiKViDh5sbbm4HSLMj5RkJ2Rf+CtqJYs1UXr9+xbIsiATS23vOa6U0Ye1wLp3pvHA8LRRvUDHObymV++MCKswp2X2QMaZMMyfEyjxP3Ex79jd79ruJKJ3DNPHy7obbw0xM4bIwD57MCUJIkHJm2k3s1h3n88p5XVnOC3U9U1tjnpV53kOHVsXlHGzcxaimlammceYjeIQZqApRTG+ytU6XRvO1qQ3Ny1pVuJQbvrddvXEB8y8WeLDTBivsva9vfkLew2IEu9/bYeyFba2HXCdtuSA9P3H9/yn4iZ9Y+jRMmvLTb8mP7PEHFzkfHU7/5lvw4BSEUgu1N9KUbb3qBmWedtSpmAYGVwYdcwg5JRc3xUFIYdAZW+uspRCbTZMpZ2+H7NocrbmIe7ApKIqQSVmQDNNsugS1VsK6kLMF2uDsmyhMOW/lHlEVad3AHY3MsRFzJ2a4/fMv+e1XLziff83x+JfUXlFgOtyyv7lj3h24vb3jsJ/JuaOP31rpUW30UiinR+pyZj09cn48UdfCel7Z7Xek6StuP39N7cUYPPuZnA0IS7Gyy7BOAdGIAtk1CUaHEutoNUQRbbxp6xsYcOEtyROtoItH7NAKIxOLi8Fqb07fdi0VYH93R5737G/vOH43IXRCCswvXvDw9p7yuKDMTPsD/z/2/rzJkizJ7sR+ejez99w9lszK6gLQ6OkGG7NQSH7/b0ERCjnDGQzAoQgHjZmursoId3/vmd1F+Yfea2bu4ZGZVWgsg0hL8Qz3t9h6r6reo0ePTmfH6Zy5iKPlbN21nCficLkg64p3AT8VXKu9tZzj3cMd5fsfaEvl+vzE8/Mzt+VGbhGC1fK6mAyBFeH+dOaf/9Vf8xe//R3/8q//hrskuLqyUME7wjyTvv+OkyilWGZgmgx4cl54+O4jrCu0yvK8Mj/0VudlpbWI9wmXIqkvQGhKOJ3NaGRbZIkz6qxzDhcjIdl3am20Whi6NAi4EAxAqQaOtWrlFVpNtM3qsA+lTlgXMBE1kTl6cN5NSm3WtaXWrv5fMuvaf0oBTKTLOctAtw6sKlCKga0xWLczY+WY9o4PkeQDP3z/Pdclk3NDaiU6TwiJD6fILS+UWqi58H1n0UQPHx/uubs/E+fJRERfIe2/brb9OUzHnf75tqU/Ztv319gCahs3sjn1jXrbX+7f+MJdvU4OyMGvbdk+FcBKUFTk0EEJ0xKBXRyvn//o5iHD/vdw3Or7+wJXu8S3WrDuVAkOzqeZlCLPjIpNh7bG8+Mjp4cT33//kefn3/Dpx08sy0rywUDjFLf7ZIEhVup3vRFD6N0mGmjheV24P53xONZcDFRpDdXQGTdKo+G8Mp+MhbfmjJYFD0wx0SMRcK5fj+nbiFiwcbuuPD4/cX2+UNbC4+Mzt3Xl/W/e89t/+jv+yV/+U96/e8dpSlY61hcFOE9VIfd5n0tGSyXnG9fbDRXl/v07flgLt9xo7hlK641kxbTHWkOCddEAY5KKi/xvv/8jU5y5u7ujUbmuXadHIGilamYpn/j0+Jl/+3f/KyEGesUal+uV/+33v6eVlb/+q3+G6kzQhm8eaYpPEefAYwmW03nir/7FX3L/4Z7/+V/9a/7Nv/pf+P2Pf+TT85WH9+9663Ihl0qaKopnig7xtpCsqpSmrLXRnEewEqjbsrJke0/xHafR7Rm8rtN/OeAPC9gxh/6E2Er3sOaw2N337f6Eff1piTfZFiN/yv63/cp+nT9nn462Zvt3XOXI6PZ/N0r7q+8f9y+v3v8VsLHt2/QTurEKBHC6X8vP+4nehESV4ITzPJFi4Emh1NYFfwvPj49M58T79x9Yliv/9vnCmguT8zRtuAFg93vpRHpHvmKsGu3Crz25nELCi+ud/Lp/aSZ6e9Suidh9bmr7cihePN6pxeh9TVT7sR1ui/cGS7pV6+q3rpmsxTQ4oydNM+f5zN3JmP4+JJNpAFq15B9akWbaiedT4jc/fIcLjruHO54vC0uu3ErltlYut8Tjo+Nyu5F7R90Bjq2l8nhZyKlZ4hV7QE4URyMGzzwLMQV8dKTJ8+7unvtp4pQSIYrFuwJWym8i1bYOdMQYOM2zJYbXal19tbAsK7faqKuBcjGCj9LLiu1GWUf1QmiCa8aG7S7O9Mp6e/SxMm/ay/xEDIyUuk2cbfXeB+ARwETGP9sqi34bftmK3+2fe/GvOZyXfuLnjPpx7r3pJ+Tl79+An/gFQM1bTJSfd7Jv2eGfprn2/f7MHf9TKbLH/b8dG+wsl3F9JhjamQBdcGt0ejFEfncgO0PGuoAc9ro9u1HGNJDKcR5te910ZwyqEZxEvPM48SjCklfyuiIoPoRe4jIyAr1t+OhG1duKSmtIbZAzA68MvZNymgL38cHanQJhPjHfPZDmM/P5TBjZglLQ3KBWpFTTp3GBGGZqqGiFEGF+v4tXlbIiQXDByq/QAjXjnOnr+G5sg7dWds7tCP4xcwfSrc7LkihUt5tod8t3EKZiPcvtRqvTDeQBtu+KQEwRHyJxSkjpVHsHfprx/mZ6PClhgmB2Um2eaMGTUsT73ky1VlypuJJxebUOSa1anbAKDylS37/j8fvf8jQ/cb1eyRnr9uSsfEDUnMOHd+/5y7/4HT98/xvenU5EXdFqwnItJfz9PRFlOp/6gqZS8zNQek2sNyJLKWz0eBllGgCWaZbYAZZcOuvKBoU1MrCsjRNvY8x76/jURZe1bjVTW8aZrm2hvZWhdEE5y3jt91+Giqb2Y47XtlE8rIqBc9a+vfWW292gSfc/DEdvQVIttrKK0UqfRseoVisSrCTwNJ+Y08QUAil4TnEi+cgUEnENBhJOyjsvJAHvlOk0k+YJH+PhXH8FaV5vR7v+xTpR4Jj9fEFJ1720Yvv8cZ+qX9zx13T40XZ1y2r2gGM472Ppxpub7DblC76A6+fu+rs9DnfsVd/HH9d3JwPEEfMjG5i8OXUTpYwiJG8/UwgGhvTA1bmKlgVpGa2Zh7szd+cz18uKOkehsbHcREwkXKDmYsBxSOQ1U7VaFlEhV0XWigRLDOSqBK+UkqnLjeDgdDqbDsGyErwSQyA6E7CPva2oiROaLgGtsd4ynz9dePx85en5M9fL81bm+P0P3/OXf/OXfP8X3/Hw/h1zOPUOhR5RE17PWqjqWNaV6+3KbbniamNZLiBKVaOzewd3pwjhgbk01mpd3Fwp1JxRbyBHqYKIJ8SESuDz89U6EgbfW5sb+7U1eHp+4vHyxOPzJ7xX3r+7JyC8O584zdHuowqfPl9oVZlbItRKmpO13S4FxTqglJpxTnn//QP/t4f/K+8/fMf/6//xP/Dv/u3veb5lcm2UWrk7R+7bmeAiDo9X6+DStC9axjU4EBd4eHfi8fd/NBfGYS59xRZ9bazrz4dXr3cEDA2PHtB3bb5jS+PjnP05BvWLQPcXxHI/dW7HAPsfg9341rnJdixe2LGfOTmOVutX5qVt35af0IOf2KHRzU/ABuqbSODBT2yn0DY/ER0kN/xEREsjt2qC6GWFZjo0p9PENE+UpaJOKDScKH7L6ttaQYtpXzofDPjASs4H62KUNDYRY+8ApShaW++AGU0QXRXvFC/NhBR868lKi7+1agfGvcn/lmGHLHa0xFyliSW9JQghRqbpxGk+c5pOJjIv1myiae2drKrF2s0SEc4p0xz58P6BOUWut4XLunJdrAT1cotMAT5/bjxfb1xLJbdCq1CUje0dQzCWv/XkQrzrQI218z5NgfMcOc+RU0rWAUtgaMgo2gnj0pM5jhASJIeex6CrFF2tdLgopVXaeuO6FkKYSVMy4XkBUWtu0qrpoI5qCUaVgOfA4PHkMXjEwB5rCDL0HcckGUhNnwgbetbnh9LXVr9sOzItf8pP2AfGGvf42pgQY6r1+zg+P+bsLzyfVyf3X4Sf+IUaNa93/PaCxY6zmdA33n/7RESO+/3a9vX3vo6EHX/f9/+lkxiAgbd/faDklZIz67IYoNJXiNrR7tqpBU78pmcjm5LADtR457Yf6wplmTJDqgU2fZK0ARQ+JmJIPSvoud2stamtgbtoqjeAw41zwBnCXhrOCxSlUclPF5q/dSPoNrz07v4B/GB2OO5Oiek84WKgFbOmDqMr4j2SJqbwAZqguXK7PrMuN26L0fe6KA5Io+aVWlaul8+0vFCWC6IF5yFEc1Ohl3tFb+KvwXurAx3Cvx10asXaZ1O1px0alC6UpQ3tbWJ7ixHQLmIrHb9pyugIJSheHETfdYgCgUIr2cpofCTExJwmeLin5GJU0aKc7k8AhBQJPth9Lw2/Zrw4vFyNYeNtDHnniQ7efbjj3d/+Lc+XK5frjUqkSs/JaEUUog989/13fP/dd9yfTpzFrrFWc2Dh/h69u0N/8z2IlQblnHn8+79jXZ5Y12dKyeAF0YSLEecj3kVSmoyCqlabqyEaCILpyUgv+/JdoNd5j+ANpBF3AMgaLa/bHBPxkCt0wWfo9aNp6tfWoJY+Hw61ms5ENC1g6eK84mlOcb10TdXU7I3Js2s1aZ/C3rt+SsZAMzqrcHd3Yg7J5ktdyMsK84k4z8ynmdM8cZ4nHu5mHuY75jATXCCvK6iSfCCVFacV7yvTwx3hfDbmE13M7R/J2P+XtO0OsP/o0QcMp3vQo6AHArpby7e2dvj8+GU898PReQn09f9vL+xB/PapQ1Cuun9njNFRP/xFINGDcFO1gi032gPsbSEsI5zfr8v2a+K9NvZ1s3W1ZoIX5nlCq1JWY7y0snJ9fka8ZTPfvXsALtYFzbuugWbZzOAc2pS8Fu4f7sE5LtcL4oRaGlOKtFa5lcwkCeeFopU1N6QVlmXhHBPahGVdSEGYUmRKnuh7VyI3WqxaEFtyZV0rjz9e+OMfnnl+upHXC4+Pn5lS5J/983/Gv/jbv+H7v/ieeI54H5AmtNxMN18EcZ6WTUDcQPRkZa+lEmIgLxeaNqbkubrKFB3z/ZlbhSUXEyEuhbZm1pq5rYWlKBVHrZllXXi+edofKnM0kL2VYqWYWlnWK6UVQoC708z5dMd5PlkrWy2mCyOWDEnTBCI8Pl3wtxun04mGUZ+dN+8f50hpDecif/vf/C13dw/8D//9v+Lf/Ov/hX/4h98jVFq5x+GIod8TFyz4VutgV9ZMbkJ0ibKuxHczcUrk52ejxovfJ4VwAL7HGP9yofp6jv3SoPcAL/ZjvYyhvuzY8eX3D1/fbOj22sGW6lbCvH/ja8m91wHxTwXhr5mQG/X8FXPj+Pkd1JLt1r2IbL/y3ZdnaN84lod9y9s35ydUN2b+0U8cJ4UBOy/9xOhlZUmB3lxEjD3jg2OeJ2pRSr7iRdFaWG5Xnh89TeF8PnPTBWjdZrcuxWBMYiObV6b5hLi9bFYbhNBLpEpBnLN213QNz65j5sXTnKOg1CrEgDHvnDA6rIpa3rRhpZVOvMXmTTqzptCqdbQVBz568AY+pDRxnk/McbJYWzzqTCvHOvjZzwYAiCKixADuzroRpsmRFk9aCvHmSdHhtUFvalGupoNYmpW9q/NIc7S8UpwBCSE4Upw5nxLv7k68vz/x7uHE3ZyYgsM7i+GtaxOA6cm4znqsoyQGK9mPMXB3PqE0cl3JJXN5vtkocJiY8nqhtMJJTz0hDIVK841WxUrIvCV5kYZ4xQs4p4g3CYUyYoxNV3GDPfYx3P8vWydXeTEuefHpl799bXvLTxyH/fbCq73t83EAHS/Bnc1vdBBzu5ZvyE/8e7Tndrxy48fT+w+4vQZffmp7HaC8BQb1h1MbIXp88JsGhmIMFrq4b21dzAkDWTYjK4AITruGhaq1TOvbAFaEvgjtzIN0Oh3Oaq9tjCkxzTMxJRAxESnJnErCx5kQIvN0IjlPEN8X2KG3xxNcipsAMr1dXauVdl07IydSbiBecb7hXIVcjGUR7/Ah2vU4RwtdrR3F9/PRqoSgcEq4emesC+eQ4PExsFyfWZ4fuV6fjN2QV2pt1nUpWLtALx24QjZBTOdtoFoXrkL0BS2Flq0j1tayu7NEVIBiTsZKn0A1d/qfMTrMkBsgoK5SHThvhs05xSeP6l7eNU0e/8M75oczy9PCel2slXnP6oz76pw3MUyXEDXQwnTErIuX9taFURy/+3hH++7BxITjybIDrXF7fiJ402k4zQlpFVdvQCBOJ8I02T3v2knOeUrO5PWKuz5RHu5Jc6DmE8/Pn8jXG23JtCWTL8+sc6C9v8P7OyQmu28CIQam82zlSs2yJLUWI7y0DqGUzqZxsnffyreNMdPUdIS0iw8byi8m7tkKVPozs/FuNdXFMt0hGgTYgx0VB9XKudZ16SVwFdVRblV7N5RecjjEixVKLeAqXuDd6Qy1ca2F223h/p/8BWm0/I2pt5RsfPfxAx/O7zmFE7WYmJ+IZa70+RlpFe/hfPeOcL4nzHNvf/Irhf2tzZQ1HCaEaBBGU2Ma0J9TbdZxi87O8j371IwvfNjXEfjocMeIhocD7UGzoiZvgoGJrgeb9C4Vun2KHiz2dtr9WLZmHJoFZs+duC6aqDYeRI3uvQUYsgcL2k/mEJxXFEZXj97FRLRTf9XuhYqAlw74q2mdBI9PARaHTzaHWlOulxshzWgHInHK5brS1CNSqXnhFAPJRy7XKyFOrFU7SGEAjiDUdSXOgVIWHmQ2/RnnQQtOPe585hRnWlMClRgSc4qmq+Yc4gK5P+W6LORaWZbMp08XPn1+4npZuTzfcFq4fzjzX/31X/E3f/vXTOcJHwOigfVqnTSW2nDBE9PU/ZGNi+frynW5WWZQK1lhXTPaGu/OCdF71nxDQiA0x5QiDqE5LOmwmHYWvtFEWHPh6fqJZb2QxBPx5FqoWkhTJEWPa40peM5z5D46HuaEE3i4v+N6feLzH/8BL4XvzjPPj450SpTauNwWLrcV8Q7FQKWUIidS1wHLTO8nvv/hO/7b/8vfMp+E//l//Dd8+sOPJCJRIjF4QoAQ74huIqglL0QLTz9+4v13AScV5wqnKZB8oDTf268KSKXJS5FGN3QzXsblBuKMefaLUZo9qN+C2GaA/JhH7Ss7e5M6/vID++e24Lv/X8ax/VcD8J/aXlz/4bXXAbhdor543XU2gJXO7syPoSkw7od+Zd8vlkG9w+ivpU+2fZt+op/PCz/RS5vsYIcOUMNPdKDJ7WWRTUGdLdR9DEhwBm6o6fQt15WYCs45E9EVJedqpak0tGWiD0RvmnziI0UVraYrNpiilIIkT9NMlATBI2IdMUFsnYG3RHWpxiJqQhOljnVIGzoc7TC3LJksdE2emlEKMXp8cGjvOupD4DSfOM9nYo9Zh8pPJ5KY2HGrKG5rUb03grG+tLU6VNLG7nYCWjI5J9Y1kkuxGL0aQIJWajMhZWnW6ep8njnfJb777oEP7+54OCXO0TN5SA5ErUNwR+NoNMLWht3i6NqGiLJ03Uc4ywnkIwL8KJ+5LYWGkIKnNmPF3m43UpoI3qNUK4n2gAQbA2OEtobQ8J3K64TeDt7Gna1VuzxBj1GGbMfWkeyFrdQN+B/NOnj1kRfg/Garv+4nxizcPnTcXtn1L7zJ0U8Myyvfnp/4SaDmpzQZNgHXA5r1p2xf3tCfvsF/fhL7BS7H6yezBTBiok8hRlt0ChvNbDyk/UEZqrkJJClbckCgo6qyUQ6dN6YIrU8k5/Ah4rrWwBDJHYBFTIHQfwRrr1xLIMVoQIzYMUyQNxjVvbdidiK40ao4eKgdBMKcigvBOkFNyRg6XvAxbNdj1+4YVD7xg8rXaFo7OcVKWkSw7/lgTAzvcDEg2YzXTlNsG0TmehbVHRzteAZj4owJPzIW2zTXHaAcYk42VztjpjVDuHU8CX0x0bfrG8DO0L8Zv2PZi+ADtZcVOGfPz85LrEtJDB2wCbguYinOdwQbA7Zq3emJaiyQGCJxnqymGWXyjuAT3gdicGgxZocPwcABsFaupWw9JMV1Gql4Yox4aTQPtZ7wOKpbcdX0afL1xnp5JiD4WtEufGnnTgdadgFsAC09mHJtRAu9jGF0OegGc9jNMadG+0DVrRSqo2SomsZNq9na00ranQHb14zpUyutA3LHlt57+Zv53jR10LBn0gU4TRP5dkM6MBRT3MC/KRlT6jRN3J3P3N/dM4cTNRect0DPt66TVA2oCXEiBGMojaDrzzZD/wVv6o4aAp0+PbKQ/Q2BPUtyMMGm5aWHv/cEgNI77NgbFiAo+4B5tb2g2PLSx2yx01fjhQPrqx/PwBjZ/MN2IV+44Jc7/Clv6LqTF+Fg94xp6b3v4APULKYhUyt5uZHmE+d5RjFzsGYT8w3BMc3JGDWXSkyJz89PxozsWdRWV8IUeyBgQuEj2J2mQADEBbwEw1qjnWvrpYWIbF0Pc2ejXC5Xnp5u/Pjpket15fHpmWXJ/MUP3/PX/9U/55/+s98xzROPj595/PxIU2FOE9H17lMpcToZtXxdM+I8j58fuS4rDsf1ct3EiKsIcZrR1jvjvf/I7//wifPdTFlL11pTSBHnhFspXNeyPYvburI0h2uQ60qaAlEC0PAe7s6J+7uZh/uzBcu18fjpR1QrzgvLsrCUSiwFXT0qQq3aUavKmhfOd8I/fP7M5z/+kRSjtYKtFXWRu/uZ/+b//F9zOp35f/7f/3uenp9wQfATxHMktorThosJ7zw+Z7I2LsvKXAvLZeHx8cYQ+6yAtQaufZ7s82HP8P3EdvzAnxi6yeEH3g6MfzZYFnl1jq+LuPTNKfaLzm879gsH9dXPvZVhfR0x/vRxDt9T/dIsyCil/3X7pvwEA7TRwzW/XLB+uSjd/3UjkfnKTzhncf00DT+xbuKmNWfcNDGlCcO6LEFqNt8RomlprmvDhWDlpN6kAwZI5qPbVu9Ous6OSF9L2EKfKtYls1nZUkYJHoL3uNCQ0s+7X7mVW1mSzJhOJigco0M8VC20VkkuMsXIaZ6ZpoT3Q4C2GRjUFwCjsUjDmkzU2qh1NHQxjULnPZMLIFaqK63RUqScJmOkCvjbyq3UruOGJd+LgWcpeR7enfj++/d89/GBd+eZ8+SZohC9mPyONpp2hpAoqtbifBOHFkHU1pAyYmdn9zWGyLv7e2jw+HTleTGGDc4j3littVp33RDt/lUEL7aW8NF3NvrGQ7N7QevsHukdh+vWKp2Nq7WbV0EPrLJX43DULXF4X/sEOq4Z3ponr187zIvx24vvfQUP2LAUfasU69vxEz/LqPnPTzjzLdDo55dPX/vIpjPjHGmaSd14iXd7tcNoLdyplN53VsBBYLS11ktVh2aNGbjgHaEv5JtafWcI0To+xLAtTrWZVkkIgThFM6rB1LxTjLSUyGkll4q2jLaCCwkfRlvi1FutqgE1wROiMResxZvHx9hBI2+tqVHEKXGK1mY6+F6+dIBHxMpLto4+XfujdSFXq+P0PVg0dLqWTCkrteRuKMbNxo7XdVL6jdvBmQ4ZmO6OR4I9hz5lt2O0bpgYlG6rATgs7LuT7KCC6nByDvWuL/zt0HXoq7RRW4st9NcCteBouAH8OIdLiTDPBqbEhGIAlwvesj9qVNRWmnULkkRZGq5VvFb8PBy6Y373Hiddb0gUjREBfErE+WTg000gr7ScWW9LB2wE1JF8oInSgjGpWsrUNbM8faaVxvp84fKHP5KW1dg5U8T72IWAEy0XMxAh4Xza9GYMpPE74tyNlPjYnY3bA6EeC0mPKFqp1HXtpQw9qFFoJVPySkh9Ih7qmMHsTGvNRH2rlX2N8aP9ibcO1jgn3N/dsaYCTxeuTzcQ5Xyauaw3RDtFN4TeVUG4P595d39PXRfu7x64v3/HKRlQ430vo1tXc/a1IgIxTbg44ULiV4jm69sIRY9ZBUth2eAQlc23v+1s2+GvoYhhey3SO170TKhhr51Rd8jkDNhP+i73bMv4nGwuWfaDbaDwAFCOemKNhowMWb++F4HFAC9fbS9e0ZfHHKWErUGVTidvbsumphRIIdBqImebRzWvpPt7JCZua0a1GRuw77PWjJNAmiNVK3QbSzPbpb1DWy1QciVna/cdU6A1QWIgdp2cVgoS+pPooLETE6OsHXRfc2bNxQCQZeXx6QlE+G//u/+af/F/+hfc3Z0o+caPn3+0+d2znk+3BW0mFj73sqFpmrnerrSGdXtSEzu+XReCizzcv2etlbVValViSJynE+9ONlen6KkayGtlThOpBOS2kGujqgksL0uhauNWC9oz4K0D8/MUub+fmKa4+Se/raUc3s34IDwvKy4m1q6N1bQRK1ZOtiwoyvVyoZXM+/f3lNZ4fn7mw/c/gHfMdxN/+1//Det15V//T/8f1popCBXHqpbxnv2E9xH1HvWegvK8rKRwR65CqdrbEI9Oef1fDhRs2X8/ZvB+3d7eXicj36K9fy2r+nrTA+JwnO+/PgLbviU/Afsa900pZP1yTbIdc6BURz+hVhaJmnj5FE3nq5VIKdnio5KJ5xMuROvo2oV2vVhMW1sx/cFoeoHW2KHHx61H83ooc9K2xdFWftR7dKrSisVqrVacWFlO9aaLOZKi1jPDyoHGGseJJYddcDRR1pIRUabkOZ9n7s9n5pT6eXUW/RaG9hGkJp7fejOWkZi1HhljnRYIwVGrkpy1+2aOiM54L0xzZL4sPN9Wltr6WsBAHyfC+TTzm9984OOHe86nSIpCikLwI+ZtvYRrxADGMs9d0mIrY1ErR1Ks5bo20KpQTP/tfJqpTWkC6/OFWiraPLU1ci7GPJ1OSBBbj3qxtUY0vbjWtHcIs+NWFarqHltoRbGOXjYc3XYvx7pKwMpOt/XUPlxf4CDb64c3f3YbX3rjw68mwJfAzlv7+k+z/af2E/8epU//OW9/2qLKOauLrKVwu175/OlHpinhcEar2xaU1iJYvLOF+ijX8UIttY87A0uCmA5LCAmPx6nQnPQFvnU8atjDUT0wLmI0sdtoTItaGk4cwQemaUb1Ri2F9fKZQEWmEzF4fDA9HBHXgZ5IjFZW4zrjxcWIj7ZvEY+15Ks4UaOgrhcz5p15ITjqWmi1UPJKLdfOjFiheZpam1l3uscF6+B0vTyyXD5zu3ym5sUW2nIYmJ0N0jpYK0gXPa7omjElSxvgISUkRTRFJEUkBHDeSqG6oZEQoQ3Wh3YgozsdoZcgWMA+OrNQKy0XVKEsC2Vdqetq+i2lUnOmlkdqXqjrSs3F2o06h4tCw9s9mjyO0FkqAR/jpnTvc8GFgE+JMKXuaYR4d9czLSaaJr2OFN/ZRn1MtlY3wIc2VOStZMs7JbhGSxMunPDJ0VrdBK+X64Wy3mi9C1N+LtRbJZxmwiz41G++D7iYCKc7ojfgrrXSBTjclrWy+7oHRU3V0vreghNpBkSqKi2vxtSBTZhYpeEl0Cj2DJqiYjpIiuJG9wRtLNeV56cbj09XbuuKC960IS4LrS+0UgiczmdqVeb5xOPtgiK0VlhyYbmt3C43Hn//R3744Qc+fPzI+XSPc8Jvf/M9H+7vmeOJ6CMaCx41oMYHGzqtgghxOuHSBD78DO7+bW8jYH31KkME0vWodIjO7UmawYrTw7524E6xEqImRuC2oHHXLNi+1wM1E3QfDrDLAfYA1Gr/X4Mougfg2M+YZxbEK9ZO1IDUTZ1m2K7DRX+ZcelZE315PMsINjQYWAsOUftxahkz5wV1nuAtMyrOMUdj2T0+3/DOxCenmHDNb1m2+XxiyYU7fyZn042SXn61rJkUDbC+3Fa7Ed7BCqoFdeavWqv4Yp3kpvlESJaFLVanZfNMlVIbpTaeLxfSlPjbf/kv+au/+udoEJ6XC8tyIfas43JbkAZ5sdarqorklefnC8+XC8/PF1RhzQUnkcvThZoLKU3EYEKSZW3WyhtBS+E8JW7XZ07ziRIcN2eaO0WtO1zwERcjS9fRqa1RnbF6TueJGCBF4TwnPry7tw5azQTvBRNhjNGzFghTIp5mitgzqqVxvV6twyjKbbnSdCbFtIFMpVUen595+PCBEBLrcuNufuBv/+Xf8PnHH3l8vuCCmNaQOAvUa6FJYKmV27JSJSBpJd5HfFAaNxtGmz8djNI9srZxyOuR/hPbHoq/yZzeAm394vNjSP/k3r8aqH79fTvKbhW2EtnjwWQPkt8EpA6L/bEw2a/zS4D1xT7eyJ6+OO/XC4z+9077P4bg4wx+3b4lPzHYQgY8fW0uyg7KHF4ax9z9hIFZ0lUjHQaC4AR1gRQ7k1uE5C1Be70ZQILS2zsbCI1TQgq0BslZR0/tyK4K1jzFeVv7jEYeYnF+bQYWtaaUWowx2BNyBhZ08WBxeNhaj+dSyUs2JnQMOBy1mU0WadydInfnE3fnE6fOpGmtUQSMKV92ALqz0UVNq7FV7c9H+rl19r4haDgUjzIFjz9PhCBMp8R5PXF3t/J0yyy5sZbKuq7UpoQQuL878d3H99yfJ6KH6JXgrcvq5ttlgFIWPzYxQWatveJK+3Ps466W2seM28ZUjIF5nnExUlE+PT5T6i7f0LTikydEb2WtnUCwldIZxtmT4VYJUTu4t+l4doBrsG/of2tnzLzmN+5z5dVY3V7UNz7zFT/xBV3nK7vvBvuAEf2iJMO34id+Eqj5P0o25mvOXkfL1J9E52y0b2261eoxT1NCsAWzMOiOvT2aGq0ZDDl24oyOfDC8Q13d9RpJxJyC92Erx9CqnanTjPImDu+CgTs+4FwAl/HBE9VAAB8CpRTKcoVWqPlGWYIJxXorgVL19kPraL9R2PfGNaOUpDOFugK7ZTiMcSMd9KnZUOu8Wnck7XQ6Wuk1j452u4DzqDiujz+y3p5Zl0vXJektssW0aIaz7ksU/OhWtceeNr/bcJ70GtD+EHtHIDeC0XYwRGwYjaHx8urh90XP0FUZKGZrSi2VsmbT08mZ5fpMuRlIU6u1oQahXJ7QLqxrdPUJ5wOI4rXX4ToP0eFjJEwTLvbXxeHS3I1DFwajl2N59vvQeiahtq31rPYMsIiJr0n0pNM9YYr4KYK2jSob1zvK7WYg1O2KlgKiXYjaWnX7kJDocZ11ss0GZxo0gyHTkQsDvdrernE4GguDxr0cmd7dvLVRpywGZol0am2r++PWxlGsbrDX1myfcc4RQ2BZMqU2fHAWfHihlIbvAnmtt3nUXmYxpRMpTMQYOd/f0dS6tczOG3iKGJgEOFUT3uv3XESNiui6OHVHyd90at/4NjpKMIJdZAu+DZwwrQHZdL16wCCDQ/flwm2UPVZGhbr2kQbaA2HpAbdTttpsOw3l+KSk2xmrydZ93+P3/vOiRngEDcIW3Nh5jYC8f+jVee9f74uAHsiO17aW9NAzsxYhe+fxTqjZgG1xgRQ9KVqJ4zxPLK1R1sI8nSl1wVGJXdQQ56i5WEttoJS83x8xFqH3kSkF1tI2nZX7uzNtCsRTJFfT13K9tHcEx63HhMOWKkoulc+fn4hp5p//1V/xu3/6OyqVZSnkvBC9IyTP9fGJy+UZqtkfacbUu1yvLKtR0K/XG9bWVJiTME2ReDohIqy1cfl8MZ2p4JlCwHuxjm3+Huc9t0XxLaBV8XXoFjTWklnWFbTivHJ/PjH1gDc5iE54uLsjJSsDTnGCnInBMaeEivJ8fSKdZooqt8szmguuNRMlbg2JHumAkHOOtVQqyul05nR2/P0//Mj5/sw8R3xz3N+d+Ou/+Sv+3//j/2SLpuiJMeCCJ5fMLa/kXCitExsxYK3hGXoNPfpkW12x18zvC4PjovbrwMgvAXX2MvcRyticHQuQP2d7DWyO8bVlIp1Ae0kH/zLO24PvL2jp2l74fvt7fIvNfrzOfL7OmI7M+Ph7LARfb4OVrdsz2D/V2lvf+Pa2b8tP9PW0jD2/2rbzZ78PHdixr7idkeMscJfm8M4TnAmyw4jpgnUfcsbIXFuj5EoME9oyUHuzFLvrre3rl1oLDmhNDmwjE76tzdqAtx6/9Soqi9f6Pd7kIejXv12UPYnSlHWxOHqeU/9so9VGCML5PPNwf+J8mklTtM5GGPunNA7HsHvgnO/3C4QBrDtcMyZTrWVLMqO1tzYHdRYv+uBIqpxq47RWTrfMdclcl5VSIyJCmqzpxLu7E3dTZAqOFJwdy9sDN2ARQrDEfW1WBlW77/FN92ROs/vRsHHe1HqjlNpwPjGfJ0JrpsmWG63eQA0w8sHKzlKKCKPLozErPVa5Id0Oa1+PWS708Iw41ir04Lw34ngJrrD5ji/im8OYfRtw/dJPIAdQ6xf4ic1tHT76wrb3/b2w29+In/hHYdT8ktKj19tbN+0f+1ivB9tL4Olg6EW64K8tJFspXZDJGAZGd+wdiRhitx2a2WpJx0ToRlp28GcsekUcPhgQoh0x73w9RHvJlPMbUCPiIFQiAe8dkzhK7/hzfVTqulDzwgqgzVg0aaJGQ9NbgdLRfi+Ka9YhQ5vpubQ+WFAT/NVSzKG5oVfjrftOqZR17cF775pd+2z1zpgfCqUql89/MPZNXbcWydqqgTQ9lhyGw/f7vhkSHQYFAydKharbPTXWRdcswQxzq5VNXKrPdO0aMQOoUbRLqJjejNbajYI5IFUopbFeHsnrQl4X1suVlo3a2Qow6ljziltu1GlCSiaczrg0EWjGsJKeSfDBWFEpgSjio2kQdG0VsYHEaO0+OjSqau823qDW3uGq2DhBQRp48Ckyv3sgnmbCPBmgQW8JWQv5dqXcbqxPT5R1QavpLcR0wqeIT9bhS7rYqIk0263fW3p3o65dZyZbLfELJFnYQb+hxu/GnNNe+mZjxfvUgTLdDaQ4a0NeG7UUY+N04C2XujnoFCO1PlOKXYfVLztiDIRg6vi1FG5LQcRxf77j3cMH5tPZxJrv73DBMZ9mZM20pUA1MMaL9LLB0DMi1nXHst1Ck0OG71ec5ovNbSip/TNc/wBN3UDk0F5OerTJjr37x5ebp+GGk9Sdlm7/0xfCdhsFlUM2tQMjr49g9mcPUV4vZkVAtyhoWKXRCW/74Mt9vvp7s/2qNr7Gjek049GxqWYrJXRi9e8A4r3RweeJFA1EeXq8sS4ruVmbZ6cVF+2MVO3smgpKtc5NPjLFiTUX5vnE+TwBjbreuFxvxJQQF3sZr3WR8N4xTTPBWyCJau8IZ0BB1cblcjVGCY6//Mt/xg+//a2VGK0XFMdpmknJsS4X1ryY33AWUOecrctfZxNebleerxdEjLVGazzc3TPFRGsNr46iZx6fL0ixbKV3thhLdxO3XCiiNG/6OrqaXoGxQQ1M91KpbWWKJ4I0WBem6Y5TjLx7947bbWGaE+ob8xSZnBA8XG8rMVh2d1lv3C436m1hTonTaaZSKbWylswcAolERViuK+ITId3x+x8/8cdPz7y7i/zw8XtOHyfOp0gMYkmWvIKcrPV5g+u6oArBR+b5TPCJXE0cWeUYMwlC2ETrx3js0+Lfa9uP8VIXYB/e+4LsTwGu3wp4v/aZ1pot3L3FSrXWP6N70gimv1xYHBfHx2MfExTbeRzeex2ob0c62o9X9+RXl2Hbt+YnXo45+fK3DtJsC7f+3ta2u/sJbWrgbRBjiYhJKggNnGNKgXmKeBGWXLhcVvKSezmMlY77AOqFXolqoAuNnFeCCyQXoELwgdi1bKpW0zITW5t4J5hIpRKC79ortn4w9gbbRKtDH6VCWQuxyxgo1rhhnhN3d2fu7mbmKRhbxRk7Rank0mzhKvISqOl6kaYBKgTnUW/xc9FqzSVQoEtKULAcgKNVLOnthKZCmpQpFZ4uV04poBTrOjVNpBA5x8Q5BuboSTF2BmXXrRQImKyFitC8s2YcOoap9vWf2e2ilVxLT8K2bb1kvjUCjWm64+G+IeqptSL09WLvahW8IzgD61wHFBHTKwXXiwHFEq1q7bnH58Z6aQthNxOvYyDug/O1nX85fF+OaRkQ0eHVbWkwmDwDQt139XUX9TLIfg3SHF//lvzEf6GlT19uX2MHbbWmznW9F48PRv0OIZCm2QQUu25FiMEU6BF8jH2Rq/QG2YgT6/4wJVIwgUjtx3F9YWoHxupCmyK14eOgVQ7VbunAQmTyEcXatra6duciJrDVGq3cKGvGeU8MiXx5JgRP7MLBm/BtB4tkBN7WBgdnVqMLc9W99Km3akaNreDSUFF3rH1B3fkU5JJZ15Xr7cJWJGOrB0Q8wQcDvrpnFpyxaTp44mMgngw8cCJIU/L1ZiBaDFbu1BR1ZQPFbFaZ8ddtsnWGEHRApgMfMUA/lvXxE1Qq/nTCi5Uw3R6fWZ4z+fnay7aGWJkt6unXy+0Zh3D9h98TzifCPDPf3VPOD/g0E6YT0/sPqG+03PAp0dpKXQuU0llWdq5VTWVeDqivtkYrq5X65GwlCiji7TNhnglTYn74AMHaGvoO/JjAmQlTxtMdaTpRy2rMJq1blojaUM2WYRHLFAyAsZZ1j5dGK2y1sqah5+N8XxRqoy43tmzu0FzqiL452E7lEkCtu5b40VVKWVtlud1YLhcDRrtWk2JCniaIZ87fSjosI2NJ5MbdPDGlRCvKcl04TxO/+d1H/uV/999uQVCKCe8gRU9+fOqZokoQz+Rj16USivfWkaBlNAZa8Kh/HXT9uh23Q4M74MsAXOglnqh1FesSR2YjbA5/bfO9FfQeAsOIOLQ7yv24vbvD+GuPn+2c+hjdQJMhSNmd7XCwTuRALz5kXNWyWdJtz08yFaDbi/39YwzUsKBiWVfqZCWCDkG8J0QHLjFFTwqB4ITPj884CZxPZ/7d3/8DqqWzPh2lGLvRtMIc1+sTqpVSYUoT57uzfVaU2/XG5XKjNiUirKXSNKHO4YL5LucdPgilWitWRGhVWUvhcr1yvRnQ89vf/gXvP3xkWRfWcmE+WzfCWgvLstKqARm39YpzgXUplFw5nU7clpXbslq2cJrQJuR1wXu4XJ5Y5EII1uq61UIIxp5b1xvNWbe3OJ+4FeVWK9X5zizKWwb8fDojVNa1ofXG5MHVyjRFTiFwP5+QRk+cYDYleGrL1Fx5enyiOse7uzPT6YRrSgGmYHZLnGktiGs8d19VSqVVJTfhxx+feLoUnBbceqPdCtF5puB5/+6MSxE0m1h0TKZX1mC5LsQQuTtbR0V1Qsl1b9PRyyD2mVY3QPAXb1/mrL4YxzZm/z1Rn1fb1wLYl+9bXCOYhtzr8/q5fe9/7/9+ka2Uw7JadbuTm38cvvhV1nPc5+PeXn9m7HvYlF/FhG379vyE288FtnH15daFe4/H7N/Q4SeWTE2hM2OE2OUXcJEpeqauSfbpekXwTNPMj58+A5XYm5JYHGXs/aaNkheL0wzBMNmFYLFOrZVaR9LNzs076SBBMyiqmX3QNkAqofRFa20DtYCQEiEEWz8Fz9155u7OBINTsmR2a4WlVtMI1F6apmLJAoE0TcSUaLVSq3VbUgVatYYmYGyZOaGt9e6oK6q1DxAB7/EhEntyOFYlhkpKkaaF1jIiEGM08MrbT+xrKdPK6TG42xM2lpx0Vp4UhCKZAASx7GvBGmOsZaWsGWlq7NeiOG1IUBqelE7c3wEVcikGjnlHiq6H+dYZKoSIiLfcLfZMKsYQMzFh6TPBEv+9IRTIKJX9cvx9aeZle32DSA54zovx/gv9hHzl9y8Pve/7Vz9h2y8AanbD8bVsyH7wn7z9/97b6xqzn38o+2ePN/OIeNmObEE6zTPTNOGdZ7ktlFIJMVpnpd6WudbaRX+jGa2eNRXtnZgODBuld+5ovYNQLzNxzm/o884mwSjbzZgFtki2FtAbbcuD90oMyhRnvLqOKO5IntLp80WtHbUvW9tv590G1HgfjMbnTP/Gjdc7ELPdow4zumD0bAscHcF1tX60K50r4g0sGoiy1mydrKy9lJWRqVod6MBaOiAlnX3kNrTS7s9oJ6etoVJQdVt5jg5naT0CrYVhL5nSfl+2YVAHg8MeuBOHeiOyhGliwjM/fEQLtNwoa2/7LdKZRAaqtc76qE0pZHIrhOVmWjbLik8TYT7RWibMJ8LpRLq7Ax9Q58j1+mKE+nG9zUTMbKw2GtYW3TJLuhlJFxI+ResK1c9LBmuls13oTtw5ZzW6de/40oc7bCUZuzGRnokw7SILTFqpB9BtzP+Dse9CzaNm3MZOQ1WMaVUH/djKq6xzWCNIv6cKZV2s5KzkDvL0+94XULU2cq0bcJbXrnvhTHg0JaPM5mxCq3NKfHz3wDTPhBhBelv4ZrpEtc93UfDit/ntoodaOoMKqjOR7M3R/bq9uXl1vcWojZ8u/WzUWjGM0zyc7IHwFii/zMZ84ZfFqNAoZmOGblKfy36YCtgeUg8tXzrJw0HUsXXz64a4+7hxXnZOzton9PF78CU94Gmbgx9ncFjkHq/rwBS0o1lZLK3QSqcxB88qRl12PhCjmA6BmBi7c8LkIlMtOCqlFUQMVFmuo2xVyZcbt+uNGP3WujSdJlqrlLJyvd04TbP5JRopwHwKaMuUtXKtxr6Z5xmnQpwmtDXW60otDQpogdM8c//uRNHFAutcWT6t/N3z7zmfT5xOiZIzIZ2IWVmzlSHdnc7M08TlckVrYz6dQQ24ms93qArXyzMpJLTBZbnZvFQluAjJ0chAI7eCuIiJN3pELfOs2ogxMs0nWs20cmXyHl8KU5p4uLtjnhJZG2vpLWL7PLeh5sh1JUwBBIqufDx9JF9veG3MMVBHhlS8MVFL5o8/LpRcKKXxh09X0jTjY+T6dMEtlmX//d//nhBtUXR3f898PqG1sV5vpPM7XJx4vq6oC1SF2DPbOSutWTmCeBAOfr+PrS1O28beGNuyB5b6cq2oB0UOSxJuIXL/8JeL4+OS96e2t+KzYwx2+CTWNaUvy4efcSM4tkneWt2vt5ubfuavzn27ckZZrsVGbAkIv90pfYOosfs5BrjQz23M++2eM+Sct4vumidtO///ELHw/xG3b81PDPTnxXw5AqFYICV9UEpvQT6ubYvpW6UVK4f3/qWfCEPgtt9H74UkgYqayG+rIMHKc9bSL6NSlpW1rERvor6tKS56VE3EttViTSYUcm2WuPYWZ4tWY29709xEjUleS6GtdXseKq13J7XuRCFF4pSsSYpxjqilmYC9GBNclpXgjXGJwrosgDFn8NaR17RDK7lUKxmuntJL7H3wtGJlStUboCTO2NwVW8OlYOCFk4p3gWmaEDEwxUqEPd4ForPmHiaV4Lp0Qwfl+rhqg82P+ejoo7UnV0vel2IxqdZKrYWcV2qulLWxZhP+D5Mnps6SkUAMaTMZMZrgsN17tdI3H8zvqBX8KaBaqU1MRFg6If+QtGYw51+MzeOckjGCdwBmh2jg4Cf2sd7nwr+nn3BHX3AA8t/yE/qN+omfAWrkxb9HpPfliR4/p/v5buf00w/qi6P+iZ//6W1frY/SDF4EJ24clHmemeYZ7zy32421dJp2sJZ4vgZcsXrPGHs9ZddPGUirc70sowMMY3GpOEw7sE/4BjLEqMbgbG0rARlbDIFNwNJBCH1gJTMydk3mzYZOiGqvQy2NKrUPTqP9DaAmhrgLI08OSUe9knF/mgnti4B4XAzW+cgQo24gDBhx2vAtE2IcZfPUpeKlgz/OUWUACmpU+JFl3jIUHSDq91S8256PDk2TrYjXNBRkdA8yMknHE/ovY5p0oGcAP9Kft3d2DUhA3MT5XaOVRs2V9XIZciv2HTeeT9dpqabTQ82U1RvIsK6WPZhmWlkIpzNxOYMWXEyI99TFgAjFSoxaDL11e+sgVb+nfoAVwcTK+mPwKeKnmTCfYANQGtpL2lDFuWlrw+2cbOVKI1CQ/p3d2OnegrsVWlWka/xoB05U23bf9MAK2+aQ9PuOgPPbM2m19Hlh99o0iwohpO25GFCTTci51k3ozwBNq/tdc970nEpt3G4LzntyqaTRdjJnHMI8Jd6/eyDGQDydrNtZMae2izJbBzAvfW4HE9vWEvdGFKOTxM84mm9+G901oAfe/Xfpw5M9/2+f2/3Gsa6f/v3992Gfbczu9fvSnSC9pMa21jN40oPokdE4lukhZkPM4duxXLdFY2EwAmx3CD5eAnUjODtkVXB7sMAIefbzhUOSYQD04noZn5jWiXegwRYqzUr4anFoMMCkFSUvV6Kz869tZc3WjcmJsFwu1OVGEAtmLYiGx+dnnFNiEKZ5hua4PT1yvpuYkmO9PeOjI0zJrlkwdk5rVDWbF7y3WnD1aGnMc0RdIU6Ry3Xhj398ZFlWy1Y6Z6ydUjidJq6XKylGPnz4juADeV25XG7EEPDiEbH2sRICt2UFRpdEJcZo7LuAiVCWG0plOp8orZKXglMlOsfT5wtluXE3mw1WhaU25hRJ7o7z6cTpfE/q5WTrcqVoZRIr381rZVHldJqQEEwzQQpI7QtAs3G1VaqaGDpVuXx+7nYWqgaWdeXp6Ufu78+c72daXbGlDZ25FDjf3THPM+dpQiTydF2pt5XbYp1DarPytfv37/DxxOfrFW2h29GOJIvaverPbBviclweDvYNW8DqRgAL1F5SYj54zMttxXz4eXPif+X1t7djRvFljNe5EOMatmB6aCXsfgroJRfDbBy+d1xI6HbJ2+JqHAlMk2wEz+P9vY/lvngf3VBGHAGd8ez2+SxdX20klIZdGhp7X8sKf3Pbr36C48y00zoyLS3w2PaPdHZO66CIQ5pJJ7QW7Nhqyc/WLDUQUzLJg7zgRcE3mmZytTnkgbyYDuOYQyK2Xriti4nZOyvJccBaCt6ZWD1aEKxESfu9tXIlv8lIiphcggn7FlxwOG+xt/Pj/pkwsbEPs+nKiFBrJnjP+RwIOHIpLNmSva0H+CKW+F3WQs6F4BQNJrzrnCWj7Zkb6OI8Pf407U7vg5WyaevPbQyQBsRNssLsSug+uCBedqCGXgLtpLe+1m5ze1WEOIzRWlmLdRzMtZLXQilCKcJaYFmVqoWkq7HLMSZQ6zopzplW0JxMr87uK/tar4+wpgV1PaGPbE1eqmrv3NXHkg14G29Odrv2wlfsdtT1MWs2dPcTyG6Xh53+D+0nbJ6ygy98W37iFzFqvv77S2f789//j7HtTI/XQJ21iYPRntmMg4Elznum+czd3Xse3v2G/+X/+69orXA6nXBiujEiQm2VGBLTNDOQVSe2mDQtErWFXrOe9mDgTAyRKU27M3BiGiFekNLr7WqlrhmCiW4572mlWUs25zinSHWOGqwjRTNp8O26GWyd0hfetdJK3oI3lww0MXaNAS8uDEaB27VpfOgLeqHmxQAKsRpQakNc67RI1zVHVlsIpISPsd/fynW1DiVBPEq18tbeYtB1seVhkKQvivEBCSaQG+aEi1baVG+rnZf3XZTL4dShSfrCwhHU04KVptVaD/an9gmraC1duNkmbvBGg/UiyMd3hCkyPbyz670+Udcr6+1qArxOkGhaM7VYVkJEwAkFaHlBSsZdLzw/fiakSJon5ncfDFxJyZgdJphD8Ba0i/fbM7GxeAChMDxIHEhwSADx3RhtCz7BBUwIV2vvWgQD2fME+/xmVQxoksGSUUW9ATXNdUdcK62UgxNj6zYiHfSkVKSLC5tRNw0L52zhindosRrSESgJVietqGWim1LXLtg84pMupgxGaTQaa7a2kDRu68KyzMSoeBFSCLhWefz8mXcPd/zmu4/85vvv8KIEp4TgLNtUHK10jahe6hXEW2ebmPDzjEPRHGjZ46aJHCLlkOX6dftyq69M/BYoq2UV6vDlX9uOdvoAaPxSz7Ht+uCSuvvutu8AhuvXneKb5UtvvD/+9T1wGBnR1g6ik/DCkfcYyQLxEeT0jK2VFypWHCpWRqt0FV8T1hZx5FpY8oKLnrsYKLlYqWmzTmilLjStxBSZTidCiKy3Qs6ZNJlNDzFwe7phNfHJSlHF48NkQWBnSpZcEG1U18x/+YC2lXW9cbk88uHuO5pW/v73/zt/+ONnbrcCKnz48IFPj88G0ALLYp3/LreF+Hy1fXfm3ExC1meiN7HEWgpPlwtaLYi5O5+JcWLJ2TKqrkFbmZOAUy5Pz1yeb9TmIWfq7YrUglNnvztH1MY0Re4+PnA6TfiQuq9ufPz+I9TMeU60vLLkzPW64qVtQu9NA1qFx8+P5FLAOZZaCCmwXG/clswlN2uPHhK1Fa5LxvnAlCa+e/8BfTgTnfDh/Tvu7s5MU+J0N3fQvxEmDyHwh08/8nQzTbIYJ4Rq2evOLHyBZDACziEw/JMz48ux3t8dC0gZC8NtpXkMvH95DPdLqedfsKP7eRzO6ovjvqj/32PqNzcdX9f9u2A6KPoTd6x/2DoDtfbivDZm82BM90Tc0EQYQXjPtuyf/0dNPP4fd/sW/cSG54zlYV9kv/YTxx2Nq+pnYAvSg5/orSkIauNZhtp7BxlqKyx5BS9McUJbZV0XA7H6+00NRPEx4F2gFqWqidNHLF7LNZs/8XGbB15c1xzcWdfWldYRvUcj1Gw6mrn0LklutPwuQARsrlwX077UZjIKtRVC8NDZhGspLMVeW0pBykpyCjiWnCmlokHwWBLaNHtdtw0GcliDxL7mcMbMGYt3PVbkK7ZWiRaLl9oora/d5hlhX9e1ZmtGL+axkd5pSk0qwkmjoOSaWaqSW2NZG5dFySvU6shZWYp1WRRvmnN0lmbpZXwxROZpIgYrd3NByMU6bhn7zG0lc9rjijaAmp5k2exg9xUCaG9zfwQVXo/j1xb4hZ/Y7PQYy3+6n0C+TH++nmkv/MRh7YIM2//t+Ik/iVHzxnmyP7DX770GcvbPfvVov9DJv/3aMLAg8uVxtgfg3Avhn/Gvqhq9fJ74+N13/Lt/N1NrJk1p8yjOBWKcrEzCuUMY3u9FR9/HQxn0ONeZN3r4sHdGM1TM2krVjXrdw/++oO4lMaK00icG9HPonx1Zf7GFv3e2MNdmi2HpCK0xVHoL2JQM1BGhZctiqtoiWrR3tBLp2iatGwWjrqoIPiago4uuI//OFhjGSrHW0E5tMV36w5GxqO+bc2JUx2Ctzp0XY6+IKZeLmvAxtXQaq+AkvkRaR1ZksEaaoKXfWwHZ6qwsZyNdd8F253G+Z1migQsSI+vtd6zPj+TLM/L5D5tTEj/j4oRvSijVmCwdxW3dwKoqpawmxlYztYFPJiwcY9pKt0a3D9MQSpYx6SV24nvnFe+NVdNzTa2sGINm3bpzDZAHLwhhzAQYDBc50AD7HRPvDKjpZWJb5RJuG4fH8WgdR3ah4D4kjMXTGWODITNqYZ33BqSNRUbrZVC9Y8rozjJmtILpFmnpgmvmwEqpHchpW2mgtoqo1Q9TK9LZTz98/x0f3r9jiokhWOyCh+BoJeFLMaHnPie8BHyI+BhwMaAx9jtUIXpqGIy7w0T/FbV5sdXDLRplYsM1OPYSoV+yvS5LbX9C8P6Fv3n1nP6UReQX5bGv9mHZsz1zon0uiZgf2ZQzD8H3NpUA9UJFWWthXRd8bTibOvjag3M1um2lcKumQ5NOCY2OnK11/fq00GolxvvOkGyk6UycJnIu5Gqttwd7EgcuKD7AbTHQp5ZGWSvnKTEnT2k3nIM5GgPTiaCtsSw3cl3MXzm4LVeuyxXEtNucBG5L5nq74p3nNE+mM9Hg+fnZgJOUCM4x3d2Bg8frEyE4ZmbWJXNdCh/u35Fi4uHdA60pa8nc3Z25tGdiUN7d33FZLkzekd7dc7lk05eZIq41VLzZ2xDIy4IT5buPD5zvZsR51txYloVz9FQKebmSguM0J5wIp3m24EoEr4oWYW0rtTZccFaeKQ7ihHNKOnmWS+UPn65QGynNnOfIb3/4jo/vHlDJiFSmeSbNiWmaSC1Qa+Xp6ZFFrzSfwDucBx8E67BoWeFPnz5TaxdMFKFSrUwCsdXGFofJPuSGzd0opF8b8PuE3eO5I0jz529fW+TKWFB2XYFXn+B4LcfvHff7cyzHcXvsj8P3R2DcX9dXn/3ylPdM7GBN013aF5oDr871V5Dm5fat+4kBy2yA/hAhlh2cAbblocjX/IStFVzDGO89zm1ibaYbSpwiRGe6KziWcrVynDQNdAfxxlYs1UqkHL2nhfSSHq1A66Ukod+mNkLhLrugBOdI0TTWtCmZHkc6h4zY2vX21sEYgDkXcikG3vQkdakFyZWiV2I2JnfT3qY7LxSnTGoNJkrrsahgjB7nLRnnvDEXRPAhYYmOZuK6OOuO1buKWWJaOkt7taSfs9hbELRUBEuCgLHBod97FaSJabipmjaPOhqdFYuwamZVx1KVW1Gu2XG5Zta1WvJFTaBZxG2txXMtVC0EEUJwpBSJMaCtGjjjsG7BaB9XZrwsvDaeWXXQ1LpMWVXerhNpw7LH/iPI155M7eurN+fRNmHl8L0/308cZ8xmR2WfJce59YWuyzbfvh0/8WeICe8HHMfenu8RndtO4vWN/NOP+LNn9AvHyggQXlOrBtAjIqSUePf+A/M8s65YPaV0NLVr0wwK5PHgI8hRuvI0bLorMoAaVeuqBBY4N6E5h3Nt727Uz8nW2R2tbIC4nX41PiO95bMPNoecw8VInKZtwkkpjFW4imzX4qa5g0GwltyP3LNzvQ+fui7qRadoboGi4H3cdFGcM5RdenlMbQ0tGbrWzu60trm4TXIRA882vR93BBRGOU5DpULzfQEku6MbIM1BvAzFOmpJw/p4h569EBgCySK9/Mqb0ZOeyw4BFxMl/4ZlmlinGbRS16t1sFLp2jACTSnLQusdmnJZO1pqJVSqpQNdF3xecWuk9hIo8Z6WujZKCIRUaepxzaOazJk0hxB6Daf9GICRoZYO4vg+hibEWRcnS5N31FYVhgr62I8c/tyGcJ8DBxR5m6rb9zrTp8cXpu+naIFNCFDt2IzxHwzAke5EEDo1tOsxddrr+G9kCEa2uXRB0ja0h7ZnzcaEar0mOIjju4/vebi/I4SRhQbpGYkWIy2buLb2qNA7A8qcD71cLBjQquP+7h2wVA437lewZttqB+ZGy0rYcYqv3aVB3aX/e3RWOwgLYILVcvQtmD3a9KsONvFLu/7l9tZ7L7Kgh/fe+pzIoNibCKSo9sBvt3OK0LZSkv3VMSaR0cKxl3vSdh2FpkgzodrcCrlW1AVimvju/D3/v7/7dzw9X5m6uHvwtugVb61F02T6MM9PF5x4ppQQlGVdcdIQGlUry5qJRalg95jMsizcnxMlVzKNmkxPRcSYMK0LiV+uz0iMTNPM6fyedamsS+NyW6nNEdNEmu/IeaU1cGFCnNDwuDRRsWSD+kBpjU+Pj9QKD/cfOd/f4xVu6xCEFGKwTOxpnok+MIXEbz7+hvP5jr///R9NbLc2xEWcT5RmzCJLDDRicvjkmKYT2hzLLYMIpUws6w0RRaL2Ut2wtaKd+rkGcSiZED3zw4NR8qlQM1qFnK0lrtNmmezpzBQCoo1pnggR7u/vmVK0oBshhUQqM9elcFlvuOCZTzNrrTw9L73rXSClE/6ystZqYFvPiFoU7g6zTHc/Nxzhi7G8f3TP5h/8re77Oc7crzENXr/+1rx6HaC+Pffsml7P39cm9rivzbcd9vv6OD2Y2jQQBHqpNLt4bL8pbcuA7loFI1YUfWmf9PVx+jaSc1VtQbeVCPzqKoBv20+M34GtJAPYyr/2eSo9lurxhuhX/YQbfsI5KwPtmiUhRR5OJ37/+z9wuS5MMW7+qXS2tQ8BH0xzc12yaWt663qZczE5AzElIZqaniW6rUGsdIguMCwE7wne0Uovv5eAlEZpBecg+sQ8z4QQ0SasRVlz3Z5dzs0YiyIsbSHk1rs9QVSlukwG1tJIwXRcgvOd9Yido7NSdhUl+ECKweJlrAqiloaWhoi3BiJi4I0EJfWGHV7E7KpYaVctsNZsMWhv1NGaMfSDjyCeilB7XOxcsdIlD0UjS21clsrlWnm8VB4fF/I67oljiq4/A8V5s4EhBabgSVMkRBMpVhXaWrq2nPZSM91ap1vpVKRVRy6NomOcOhSP6Etha4vDpc+rYaR+Yh4c0QyOII0ecAADAoSXfgJ40b56fO5wKm8fc1v38OI7zn17fuIftevTbgC/WOodTvY/hNf605C90crrJbAE4gJTmvn48Tse3j3w+VPherkQfaB5K/fxfdHnOxMCGQrlByACmyCWjfSW/WrWVaLk0gvebKFpIGXPdPpgehoiBq7UDpbUhtNuSLd22QsEYwGk04lWK9JMsV1DR7ORHgCNSd2gC8867ztNzgalDwnnI00c0pHjRsVPcbsOF4KxHnpnH+goeZpMJb54ynKlNOtWpKUaaKBjEe7wrmcUDs+jtmJ0zC6IJs4Gs9EUzQG3anWYStiADumizNp6uU/NhiirvmgF7vCGMfTf8dEo/g60Gsgg3dlEcUyzEKfE8v49+bZw//1veP7jH1ifn7g9fSakZGyXIJTrzVqVI/jrxWj9ecW33gdRGxJiB0vEHBcNp43mhtNuHfR2DFEuEQNhnDPgyIWEjzNxOuNjxEfLVlOLtZPuYMg+D7rDh97aW9i0jvrNbwywxfQfaAY+1Y5uO2/C0dtc0XAY5LZIaNK7RKluSHKuJmImvZRrzNFRzjTqY3U4CcE6rHV2z7rcuFyeWW6LtaWstXe0Ao9jShOnlIxqWytlWfDnmXf3Z77//iN357NVfYlYC0UMLG29a0AIodNXtZee7W5IvMPhbUE5zn+0Ev8ZdP5b3b4MdPUn3H7/xAZYfAl6HbVcXh/ni4Xg8Dn9vRHMu3FeX1koHvf1UwH58e8vsyJjMWyzzeqN6RnL4z5f/is9ABex7h1hOHq6T5C+LzHgvDbzO9P5zPNa+PTjJ56er+idkKYTNOuGZDXtCS+Oy3LFi9XV1zWDh1oWpsl8X4wTjcC69vLcU0JiJHqbiy/jG7OPKUUQ07xJrfD+N79hPt+Ri3A6n1FdWZ9uXHOh6I0wTdTSdcp6YuDu/h3eYV0+1psFlzRrkTqf8SHxfF25n07cbtnYlh7WxbopBZ9ozRH9yUAjSXz/8Qeeny8k55jmE7jI49MT33/3kegddb2SWyZTSCEiGjjFO663lZItGeJDL/tpUJolHlQF5ydGxtOHgHioKrSWuT7f+Pv//ff8w9//wcR+60qMjtPsmdzKZRLm+MFKT5v5XpFIxdq1NhQ/ecjWgS7nlabCnCbWLIR05pZtweB8wKuNiQH8bT0ipdveQxz0cvjKNlyPr4tYCUV7ETvpBty8HLtvzfN9XnztvdcZztffeR24D3aq9IXPi2TqcV8jzcmX7+v+CbvGMXcPZuW4YAF6meHBD8h+z8b50Bf80p3oVxf4vFz2/KpRY9u37Cdk8xOjHALTHpSXmjVy+Pun/ISM/w29mEa3j4HpdOKyZp6enrjeVjgJIUyIVnLJvQGSNRDJZTVdFRytVJqDphk3WZLZb8K1Fv84N0rzQbRZ9yNn5xa8GJvRuQ7qGwvUhYAPyeJ1CTSU3OCWDfRoqnucJ4KrhVi7VowosTgTyq3C6hunyXRAS6XbvUZQb4mNDHlVY4r39VYumSlCLb0JhWo/b7um02nmNEdQpWRLxuaq3K4r69J4vixcl1t3zsasaa1Z5YLzFBWaLVrs/L0jThGJwi1nPj8+8cc/fObHH594vliH1BgdU3KcJk+7m3k4n4jiO+gVmaZo3bq8gWWyrRWsIYfFCsZ4bRJoGqg4atenaWCSCj3hWxnskN0/HO3U4FMInRnyghAgfTXxanvDT0jfubx+p8+xL+bLdjL791/q0+x+wn3DfuIngZq3DOvLf8cB9s+/Dk5f7uMf12G9zvL81PZWZuf164OVEufE3cN7ni8Xnn7/B3xIxAqC1Uu2zhzZRPw2dHE8NEOcVUGbYNIuzQxhqbQQjeKeQg/KHRKt7VoI0ZgbpVB7gOxDQL2nrNmYBdoRODG0vq25DyCl6Urr2jGAgRBi7JNa1s5GMIFIFyLiQ2fKmEFwXezQvmviwRvfwfdyLwetrma3nBlvbUa1a6V0oV1rNdi29e1AHsHEanQru6m1Ukp5IaKM6qZVQJ+MG7LZvfc2Kfpz1G3SGeppYk7mSLbWegeQSJBep2rBrw/RwCBxqOvIe4oWxKOs88R8PltgK1g753jqY8iRTmdqLZv2ivbg3PXrRwx0Gs7Ox66NEgMhTYQ04UMkxESIU3894aaE8wHnEn4wulw3Ct7GBtoOxsPu8QtjZiOBIZ4nqtv4sfvXWzeKCbYpgLRN6I+DAaPf48YAcOxZmS5SZ3B1K2RCd43WS+FwYgh/O+xPZAsKDES1dsA1l61UTr2Bo4oQuyC2qlLXlZN3vJsnvn+wjHUMYRfG1kYtGd8V/Idhl0EJDcYSUxSv0PqbLgTqwTGMMfgiiPp1s02Pv9rcGNDgMc62KSw7g/ZwD9+6n3r4vznSnonogtNHIfhXp/FF8P6Tp697duStLOnrQH23O2bzpNtBlK3ufWgyvQw69lMzBhgENxgRBlBbXKFUjCk2Bt1yu1IRHm8LrTScm4jpjEhjXa60jkxXhQlBqjL5QKsDhK1MMVlbV++5LpmSG1ms1GYthdiEFJNRqGtDUtxiqOA99w93XK83m0su4n3k+XnhtijXyyPrUriVjPhAbsrnp2fOpxMqQkyReZ65P99bsIx13ZtSIudM9JXrteDDgmuQL4Ugjvv7e3veLVObp9RKztYJq7XGH3/8B0SE0+lEa3C7rfhopcWtNNKUEJl5vlWyOlp1lLUgOG6Xwm1pFBzSzAZqbVvpbxNhYbF2p9k0AyiNpV5pNfP444+wZr67O3O5XlGNnM6BeXLMEZxkoCBYJ7opRFKMuOAoNLIWagdZvDgkOB6frtxyAzexVE99WmkOtKXup/bxJDqE/9vmFy2cftFf4udG/xtTpR2ix5fvjOzhcd780u313Hox596Ya/oKWDoey/VF6pvHAfZc/Vho9GvtOFSTt+3FcdG+ZVvHntyeXBjB/TivF9fGqwXGV87zm9u+NT/R969u9xP7QpM3/cTLa7U1SRD5wk9sumhIz8PZWFuXG06Vyy2jDbxLhDjjaZTcu3H244uCNGMiowba0kw43mHxmCK9jGaAuiZH4ES3c3AoznLN+ODwU6Q209lcSzSNliWzZggORDy5QlFhzcaark0ptbMjpOCy2aXgTL8MFVoTREz/puYbXiE6TwpK9NDIKLCumfWWrVvomrndlq0RRc1WNu/QrZPvw/2Z9/d3eG+Mo6qQs3K7ZG7XwtPzwmVZLLHrTJKhVRu5qkJWpXUZCXCIA59MT7K0wuVy4fnxmcfHZ67XG0LjdErc3UUoiSk02hztWmMiTZF5jlZO5qG5Lhfhht1nWweqcxT1ZBUWhVWxZLsTnHS2i0pn1AybeLBRG1g64lxezVM224kcfh8/b/gJgS0+H2uzL2gvr7bjLPzVT3y5/UmMGu0T83C+r7afM3pf8f4vjnEATo7ImL5+7U8LEl6cxeHhD+NrD9teCzFyd/9A+vHHLZNWa8X1VlrUvgjfrkXHOnwzuvtP27RdraTDmAHRB9DQA2FzLKN1d8vLVv85dGXQQYG0zXm335jaS5toHRjqDAQwR9DZHKp9Md2UlheCdhHdFLZrcU6QMJgEbE7OWCcmykrrAsBYi75tXHQB4wEGvZp9BpqoKZdrX5Acy1y2bk3a75XqTpMVsXNxbh89hwkyTMcYKFayooxynQGoaQcpZHtgw6E6nDOxYhWPcYe6wK8acOZDoM0nSjF6ozghhLVnahx1nk2EtxbLyNpqAlrZnKPR87s2T+z6KCEQppk4GTU0TPMO2kwJl1LXohkMlUMwLh4RD4eW2jZcBjQj+z3oN2qvDdcX92zcR0QYrSLHe8PgbMDMFqQPQ6fbGH2xUOjjs9VelwtdqesotWpGy4lsAGNr4zu7npR4q4PuX7dxkzPnaeI+JR5OJ6IfXZyCMd4wsS/XBbz2YFC2MXkcB8aMcFgPXHtvr019M6/wzW+Cds2MfRvAqJWLjXvL7vm/sOfHL78cj9I/Jz0D9vr7XwueXwTAb533wYH+9Gf2DMoY19IDcMNoZStt1R40Sx83ZtJ66SxbqG1Aves16uNyejls1SFYyNZZ8PZ8RUpjLY0pJvCeGCeenz6zrMUW+rAxLtMo71PFeyuPmqaADwZArE83A3catFzJ64JIZA4OXCKEYPO5VqR3ppumxPv373n37j1VoFb7WZbM8/ON58crt5bJteJESVNiWTLBO07zCdSRfKaWxod377ndbogKlyVzu5o4vXcm2r4umaKNvH7meruCCDEEcinEEFlz4XZduF1vpGQgbPRG6XcxMU8TLZt9uJuDMWWqcluuPH26krNwva1UEdZWuOUbqg2PMSu9N1ZNlT6WiwE8a72QZse7hxN/8d33fPjn97i+6iltQVxDpKI0vA+kNJGi526aCcGELJ3zxClBNcr8NFtQe70uxBDN//gTxZ+pLlFqZ4n2Nu5NexmF9ASKbIP1sALcQ+xXk+vl67K/vruIr8dxX80Ovnh9P8ZrRs1rpsKRUbMloH7iu8fTfv3+i1nc2Dr+uMO33DbZXs75sT8DEPZzQ17O/vHpLQo9nNc4/4O1217/dfvW/ARbzDXsvvTQYtvNdi5isbua+MDWDWvzE/K2n2D3E4MdstwWKI1Smq0xxONdZLldqKV2wKcv9OsO0qC2Dy8e7/v+xFGKtdgekY+WhlDxvVzDiViSuFlr7BgDaTIWovOO67LyfL2Zrc2ZLIqIsflLaeSq5KqUquRipU21NqDgRDjPJ8DjnacUY7N431gSpn+pxrLWCsuaqWrdbm+3ldrMF65rYV2WDaBBay/bcpaAOJ24O02kZPqEVU3wd10qy62ZplnJrLWSW+ml+LaOqrWRW0O9A+epTU17RwohQvDgpWvw3BY0LzQqJRRama1blxZEKj44UgpMKTKlRIym8YP0mN2BSO1yMQJ4qnpWHGsHagrQHJiK8uhy3IfbNiRli/3NfwwW2Fvj+wBG9L8PSwm+tub/KT/x5az9ZX5iv4pvz0/8iaVPf47DOX5HDv/+5+G8jpo1ppcB3kd+88NvyevCpz/+A4+ffkTyCqLkdd3EiAfQMK5lAIevryzXsrXenmLEi1BLoZbe8ccBrVKzMRNaNsFYAbxMG7gD4MIQu8LYLv2WSvDbgpODGDA+bWJb0TeqNMuYrldaKYhCTJPtyxlDaNPrUDuvEbp5b9Tr5j1+h0bIeaGVTMlX6rqgNUOndpsuiTFIZJP9N6GyhlCr2wRpUey+BOvY1KqxWqx0KSIxIiluFEO7cPuf0KVZ+uQaANgIAJ2aWPKosd1Ejfv/pC/MBQM+5uCpGK1RJeBOd0zTGaXTOnt7a1Ot7+NhA8LqBkIcAUY7J99P2xZv3ptmSkjGrHHe44N1z/Le43zsOkn91jUrdWrFxJXFaTfKugFdtYLlQOhjwm9BvPejVrSahlCtUDsralyDNjatmr0fIOOC2jD+auCHaSSZw7EF3Oh2Zq18tfaf3jpe2J9D68+rqZVcqcjWurHkTMmFUkwQ1ayples9PV9I2ji1yu8+vOe35zP3yeqWQ5qY7u6JYTZmjfd2/FJotbADXT3zMLSkpNsDTDtqgFw6yuwO+j+/bvvmx3zrICB77GbzwDWqsuOqAn4EC0dgHrZ2iWOrsGVEqjR73w+HaUDkqH/edySbvdSjw6c7wzEnD7XOX+xjbNrbH7MvJHd8eADHSlHTXsLtWSpFugiDlZGK9FrxbgOQ0aWhawBIpbDaPM4WHDcHoo7kJ6o4nCErRAHRwvV2JcTYhdeVWlaCZFBY1wXFWWlfCL0rBlRn+6Uqdc3UnGll4aSem8s8fH/CiZhYrwpSmnWFcxZIfnx3z6fLjeAja8k4UZxkVK9IbpTrlefLhbVWo9iHxP3de+7O93z38UZ0ntuzgdilFH789CMqjvP9iR8/P7PeVusWV5Wgnpor2iDXylqto5ICOWdaKZxPFe9GoGOAvhNlTpH708zD+YwPnk+XC7fbyu2WWXM16rw4cmuUVll7ttV4e4p3Qq2FWgtZrazqd3/xHT98/57vP5z57sMdpxSYUiCmSCkLeb1S8sItL5SmxDkx3U24yTQhWjUV9lM8Q1vI7YZUs8VPny4sRXn/m39CfPjApzVzydU6T6mC1I3Na4h7BurW4tfi3qEZMALaQ/AoNvZV2tYUYE926jbOdy/9aiqofikA3LVl9gCWLcM5AtG3WGWDhWpuSbeVrMgej73FWtjYPJht2RYavAy8tIvAW1fftgGZfUp/YQ/2kNkmyUgq6ABcezKvwaY1om1vzbvdccVEVXFbh8v/TELd/+Tbt+gnbMIFiyNE+/X1WHD4iXHBqj1i9j32sLgO8V/3E9WDCq2DNylMxgTWRqvZWnTTWNaFGLzF5Kpbow/zGZXRZEN6lyTTQrSkAaI4C9hMhkGMieA609yjeLV/gzewJoyYVRxNhXUt3NZCqxnVYvsulZwz1yVzudnPLTdyUVAh+sDDWSg5sKweESuZRRpOrugWv0JZG+uSN4bRmkuP0hy1NlopBAeugxfeiZUGS+Hz02qaMClaohyHqqMWKEXJxcCX67qy5pXcgRqaUnusLz3OrAi5FnxQvHiC96TgkSBE11hCY13brm9WhFYTIo0QHTF5QnCmIyqydcYFRVpFS6OWStOueyrG6FnFRJyrWBXDbrNGU5XWmx5sA/bVVDiszTeB690wmp842vGf9hOl1leg5Us/YZ/70/wEw8Z/g37iZ4AaffVg9z2pvryh+2e+BsL8Y4Ezf94+Xp/rF+jWYaCKOM53D7z/8D0//MU/Ybnd+PzjH/n84488PX4GRpcLZzTpkanvg8G53v66sz+0L/gMN9jZLa0ZmCHNUXLGO4/3SkxW/uJjxIdon6uVmjOuWoCLqJW/+ICfHJKsXlH2WQVqQoobcue6gJZrCL17lQ/beYruIlXOWQ3kBhB5W2D3WBAJpkTeau3AwUpZFvKy9M4/XSfn4PBUh4BsZSC6OoRSlA7YYAyM0vDJACYfJsLpZMySYMDGLjrcv1uxtuRYRkK80Lq4rh8t+TBQYwA4/dsc2TU7YGVCvt4JSQbrR2lFcSUba6YWyzx043FkUY3r1abmTPosN5aH/ekEQrSyJu/2dukuxE3YSltFq1gWRewZ4AIuGrtmtGHXAc6pgTCtC1UZ0CVdRJkOwtiVb0wRqai6fh0j4LDxYzpAA6xpXUBaN2PpxEKL5ugjzUA8bUpbMnV0lerZeUQ2IeK+PqAdjLRRbS1T1AYry9E7rYix2ap1swnAyTtmccTWqMvSy+XExnWK9q/3puOD1WJLn3+DYbPZf29jwxyUBTBVhOojcYzRX6PuN7Y+VlTYW5Ha/Nx0kmR3zG9t20Jz/N43BxyTsCpj/8fP9r82NsHBW/V5vZWGyGYNDQh2smmW2cf3gJ0+DiygPx6pM8bUbIWFQqZj1EOOV2cn2761jyPT0uqEOzAGjHe00j1GBzVNDNFAT6M+W3376XzmuhbO5zMijjVnajVR+GVZbIEjVsoUouktlVbQJixlQbGsawoT0SWWZiVF4Flq5ayRUhsQerBn7B53Tjy8v+eSM9F7zqfOCqoZqSu3Sya6mfPswRk7cc1mF5+fn7k+P9Ny5eF8t3Wrq03R4HhcbtZivKoBNb1nbyt2k2oXdBRnwKklGqyc2Hus4wamy4M2Ptdnfo8y9TLIa87k3kEuZ9NPMH0HZckZEUeKEdFGCo50mnk43yHA+eMHvv/hN3z34Z558syT8HCeSBHSFIkp4iSx3jzXi/kfdZ44nwhTIiQDs2u2ID+XSmkdgFrNTk7TTG7ZfD6QS2XNmUboJRK26Bp6FzZyGtbpT96YY/u4G/N0WNlBmHzbnB3G+qv5+iIwlldfkf2lLeOpY9y/oU9wnPQIsoFMh0X5G9nS1/vSNwzHKEXcdACV/cb0a7eEzTic2GK02wmbpvsFvQiDe+mJLdp3X0+PI6WZD2lbG9yvGL1vbvv2/ISMAEacAaR0AXpe8tbkMNbY3jV/cfQTcfMTmIBuT3AOlrrv3Y9EGsHBdJoorTBNkzX9KIXaxXBLKSaeS2fo92RdrgUvSl3bFqOFaPoposZQVun+S4cUozFMxFkpbUoekWgtogVbuMuF27Ka7a0G+tSysi4Lz09XPj2tPN8qa8+lBR94flp4fFxIU+pNSyqNah3xajH5hNKoWalFt/i1dN1I7Ytpj5K89JItJXTNH0HRMkqhrOuqfdpEisd5lpxNnqHppmfpvTMmfAwG8kRLvDdpKIWUHOdz4nTyWMnWwvP1iefnJ1orxrbpWore2T2OKeC9jQ9ttp5x3sCn2uUhxuso5NZYa2MVR3baQRqLb2vroNw23mWfETLmwT4tXs4WfQHU7PPmOPO+7ideTOJXfuJF7uBXP/GL/MTPAjV/+va17xxf//oJfZ0y9Wecyi/Y5ItRZsY3pYnT+Y6Hd+85392xLgu363VfyGEsBGnHYFy27zuRLweLdLFYGxu0UqnOABdD3WyBHGIkzhM+GZhScj44kAE6jMyWbgHSyBzIQFO2K+vB/yZEaILIriu/i/fdz0gXrLKMouvOR5z0Tjnd0bbGNvS00YplNg3M6OfVAQ/pLZltnT80TfZT3zIlirWdG6VZXQBXXAeTYjTh1xelKoer6wDCAGoQbHSLmJPsz8yuT/YgtWnPgu8WZLhQ+6zDx2iLg9YQ1wxprYLkQ13hQHjRzUYZiNJouYy7hY8mAGkjRvEdqHFIZzLZ89hRjIZKXxh2JXJ74KMEzJD9poaY2yMZlEcDOrT1kqmho8Ee1KiM0L3vlh1BVl5SDF8YoXEFHV3f7rkb+jG2qNKt/feg6drIaT0QOq4WtmExWDtj7KnrGjhjX1Zz4ZyzrL9z1lay1l72VzenckTEh6tyzoMraB0ITb8ad8heYN0CqgiEcIgQfwVqvtjGbTkEwCJ0jaotBH97YShv/Hn0pz9h97cg+I2djVDjtTPXwzmOh/+aFj/s9cBux3lYicbOptzPte3jRtg7mRzGFvQgVy2w3sui6IBFMNuuAaX0Ixj7UZwj+kBthSkFPn54x+PzwvPzBQkTz9fLTkHvdiSGgCtKjIlSC60uxClwf3/P8uM/IK3inXK+S5RcUJeIc0LmxCU3zs2YNClXK8XRRuitVd99fOBxuaKinNMJzmc+3p24fbznerXOUOLMv9QmLGtjWRvXa+bx8YnL0zPPz594fLxwva1IiFgj2JGltXtjwWmjFLvXSbpWg3hjIqoSRVidlQy03o3PuoEYoKutsa4rtTXW1pjnmXm2RcsP333H3d2ZlEyXZ5pmzqcTwcMUAyl4y7p6x/2He6Z5orYVpHJ3TpxOkZg8MXgGuOuCI55maz/uA7e1cHm+cNKZ4GyhJ85xu5no8tqUpayIj+Ax3+IcMc7UcsO7mdr8YcwKe2mpKUf8Y25fi79ev//2gvXr3/n6+8Mo7BnHtyb96+O9fu+L4L6vMZxYkmmQIPX4fjcPhyUAWwLpkMjZ5vph8T4Od9TseX0u418/kjPf+vYt+wn6dfcBZHH6IVF09BOwsyFsSPaY0oDtJh5Rv5239kW9iLWfrq2Souf+/sx1WbktBfGRZVlsXdLU9O57p1UV+7213tHIKSFE1mxJVwmKeNPIQi0OVYHcS0V9Bwx8s1J118GFKJ5UTdPz/n7COwOPbrJwWwu1VgIV2kLJV/KyUtaxwrUE4bIs3K4rVW3F07Q3OemAi3T6Qu1qC04cXkIPnzuDRJUgwuQFL112wBug79QAkJGEHBqVlqAUghOmYDZ+nhJTjJxPJ+5OZ6YYmafEnJIlsr1DnXLLNy63J3yA9x8feHh3JkQht5XHp898+vwjt9sFrYUUPHd3Z7MRXb8y+C2dCDRas4YypVQqFZVmRPemVCfkClmE3NcIArSuRdTaK/sm+1AcE+3FbOgDUl/Pv8NsGXNknxlvfPI/gJ/YeMrfoJ/4xaVPHSf4R9r+Yy12jg/llx9TtRFD5Hw68/79R0KMpGnifHfPw/sP5HWxSSUOoXaK05Y33f9TQ+O96xxMR5/M9tCWZSF6jyRjz4QQiCEync+EacJHa0nqxDKOcn/fM4CN9XbFdaZGXRZGm2xxftOYkUHjUjVKd5h6JxsDhHxKuGCdpIY+jwmVKQyKYejdh0LsYsjFetahJni8ZtblZm1USzXhSqPlWPvAUjdmyQBhXjyR8V5taK7Wgs4Vmq+Ybozv3TYMpNkG9wCjlK1ev2KUzg1IUwtwrQ2aTQjfRYa3BT9ANLbT5m1V+2Lf9t3Dfvu+7xRMZ0t5OvC0EcI7MARWT9tKtm+rjQ8fPM5FRgmUC2ErXJYOcjhxfRW3j0eDyts2Bze8S00PoVTTqTB648GytApky9DH1AGwgci3bbEoXrpRsue6UybtWUrPTMiBLdTGfsRQ5tEZoA1QyAvShdcsE2CBx6Atq3PgByyoXdCabb8+eKIGECEXo9232qitcHLCHAP304nUywkphXq9UKaZmma8T3Ys54yJAxAc/nSGVlEyFTrLzEEII0yCVihSaN7jpmk/6V+3L7Y9Ty99HG/R6AYe9w+wDerj9iIbsv+pX7796sDC6Cj3es8W+LYvjrdnSqVn6GxcuYNtGZ+DPbN6PNfRHWhnONjvTkw/qc+CY1yzzUnf7VYTx+jI55zrgL/RxFulU9YV53qk4Ix+HpwFm9fnZ7Q1Pv/4owH6ISLesS6Z0zzZeNZqXdlqswxeCuS1UJYFRyNMAfFKK5VwCpwezmQal2um5sL7OeDlhPPOMokCIXneff+ep9uVTz8+4WlM08T0MCO864yV0jXW6PoqjtyE261wvdxM0+aycrmufPp84bJknq43LpcLt+vVAlK1YFTEMsrOm110fYx1hj5gPlZR1q4dFsSZaLzC6Xzi/YcHfvu7v+DDb3/gtz/8hg/vHtCa+f7jB6boyXllua3UUqGXfYbg8QLrcuV8PuODkutKLY2QAqnr/YTgcMFZy+1WmU4TDx8eUBUut5Xn68rtuiCinOYTIkKMAVcqba2UqqhYlxBuK+8/vuePn37kn3z8HSGcWdcDIxa6HRrCkA705eT4OaClf+rV77/Mtr1kIe/z4/j+yzr7fTK/Dtxfn86Xp/21JcC+LwP+5csgGAPuwMoHvAr03lbHAHz/7OEaFOoxwj6ehXZh+xGkH4754r7rlzbn1+1XP/F1P+E4+okRgg4/MUql/OYn5As/Yc0ljNHimpVtOoHb5UoTx+22EkI0CQInlKyk1EuyMBtUe+l+kF5+nnOvJnNUzSiCBId3gbUUytrBJO36NqGDCc0Y3iEFUheAPxEJKNEpwaslPNWEgYNUJt+4m4QUA+IjIU7EeEKbcLksPF9XSq7UzshvDPmCHpuK9Pix98JzvrPLDTMLCq5JH2c9fhVLBtJM7gHApYk4z0zTbOBM8Lw7zZynxBQCc0zcn2ZO80zowJj3naEtjSUvPF5XJvFM58THjw/cf7wnnRNK43J7x9PjA7flQisZ069ztsZRS/B77/DDrmFgU211K0NTZ0BKLoWWJhBP6Z2dxHdRaGSLx1/YYY5aYDCs2wsv8CeEuj8H0vyj+4kvXvw2/MTPAjXH7/6cw3nrhL56kvbKzx1+7PkFUvbLt5cP8afP5eV3RExU+Hy+w4m3yVItQylgSHMfcK01/HY5VrfY1OjWIYSOdls2ME2pB7DFCMv9MykZtc+Je3lXdNRDNoL3SLCFa4yx07W0l8dUMxa1IsF1cMXvNbXaQQpnYIy1NlW8g9Tbbg/65nAo9ntn6HS2gtaKlkqrmVIyebEuJKpqxtLRy4K6QW2VoUXS9eFp1K0EZQe4dv8saiBT8AEfAxI79dtbi3DXjZAxIkw42WkzRFQ8hrlb3b+odhzEFk61imUvx3TshsQc5MGys5dtOXGEMMYznSnSKCGYsW0Np7oL3452zr2OVVLsIIwY44OuhyM9IOiMpSEqDYMuJy/MaOsGYNtq3luTl4ypwPkeTBj4Y0l267alqwmqIYLEuAFTTSu6rAaaaaPlZXfAKY0JY4BHLyuwbHXdgR+xLEvTas9JhNbrfNswfvLyWRvLZ5TsmSbFmgs5N0rFuqyIA1eQJW8lgDQ4TxMPU+J+PjGdJsKUEO+oeaWuC21ZaNPaGUkO15lTIxst23DvZYoh9rllD7mVSvNdn+YrSPevAbhtfjDyKlgYLjsICz0g78Nto3Idisj6PDiCuGMb2klje+3gXQdAtO9nOFkdx3vlY0b5oLCPwfEzqO0DVJERxIuAepABaPdS0GbBrcgIti0I3DRDukDkCJikd+excc9Gn47J9U5xphXgXABd9/MXRymWEKhroayZKUXqaoDquq7M84nb7UpTax9dcmF08mgK83wieG+LDRznk2lf4ZSYbF5fbjfWNeNUIEZm77ncClMMnKrRwBEhBs/7dw9cPj9T1wXxnuQC82lGou/d2hoOx7oWmgaWCtfbSj4nrreVz+nK+W7mhx++Nw0wP9FyYX2+UGthyZnbsjKdzrjgOZ/PTCnixeNc4P377xC1AGYOgdOc+PH5E9oayQXu5zPzPDOdTuYPoyVATlMiOOHp848Ep5xSJK83bpcbrSklr/YcxOjxZRZC9KzrlegUn5xpCQyQxguDeRhCsK4nMZqw5WgIgCOvDWG17lQKuVpnlk9PN5aSiWkF8bbIEcff/d3/RuFEqx51+oatGQH4YU79gm20vB2hqPRyhuP8Omb63sr8vZhLX8h+7MyDPdzduBKbLdDeGGHzgS++M+bf6wXxy3McgffQDNzOk/0SbQ4dVvVYgmGIRY7z2dmoPQ44xr3HP16tC1R1i7G2Ume3x6ullK/rmnxj269+4qWfGGVHIwGn2zxsGyMfR5dEMLtDsZjrLT8hzlFb1yLJpj0Wg+ksola6k1IkLwYQVBVjwKsBQYrgo+mlDKDdeytt1VZRbwmt0upWQioqZFHWosSCCQTnQijF2IUxkEIlihCELfGgUq1DbfNojXjO3J+6HmSYmKcTPs7kolwumcs1W7KuWTJW2tBwMTmBEELXeAwEsW5OwQWCD1CtCiA6K9WHA/NHehvyEMiqEDw+JmIIBO/wKHch8O5u5hQjc4xMIRJGGVnJjFKcqkBr1CikMDPfz7x/d+b+/kw8BdQp51Pg3X1iLQt5XVmXniDA2nI73FZFJ32dU4vp2uRiDFsQVJRSG3mtFKLdR2esXN3gB+nj7aWmolVn7Fb5rc1aYY+EwNHW7+ugMXz/o/qJbQ/flp/4GaDmdQDwtQcrX7z/JiL2xXe+DDBegyk7BfHn9vflpmPl/7Pn8fozu0F3znG+u+fyfEF4pG4Dx9BPW9sfNWr6MQew1OvTRExQd7S4a7UiIfXAqd+Lfr5WHtTBA2W4MyuYETPIPsY+cBVqoYqxRKoWY6H0Nqxba0K1Ui3n7Bwl9O44vUXdNmmd6yjiVixkX+9Bp/1n5z8MVavGmhhaJLXWvZbywMCg7+8QJsL2t312XJ/btGTs/jjveitxa21OPxZbZ6WekRnFymoDQJtaec+goAioa/vQG/eeTqPsVziC4HGWTsYks8ndRLqjNTaQMTQ6ONM1Xcaizfkh9Ey/xq6jwm6AdmDGKLHHtujb/RvX0p/nfnZddGzAOrZTG78djEAVHcCOYOBDByXs9hyEkAfTaIOFOjo/eIJ9rI6uVlu3rjGGpLO5uvPff/rCYsQnI/g5XGOtrTuBft9eGFfd7us5Jc5pIoXupHunJ1W6cHDtzCBFxbMRPMd+xgTf5lSfu046vdaesY5Sru3Tv26vt+0JDoab9Hu1DZfxwA+/9vcMw5BdUPENc/w6Q7PbEpDBVZWxr5ffOTrPLdg+vv5qoTic+fG0j5ThfTObYl06zKqNGXi43N76vZ+c0EkQFrA7p4SohKCsFExnajBxTGS91h7gO4cTo2LPybHkxuW24p3rXS5ugHC6u2MpNwswmoNsHedCiDYDK0SfQJUUIi54fM48X1een2+01vju/QdOaSa4SKvCuhpwWoris9nd5CNznFkuV+haXSkZqN6CI6hR4pNEmgRCVYIP5HAlesU7ZVoKkEAd0UemcEf8/iNpSsynEzjHNE3gxIR4W7VMZzoR0swUEw7BixK9CTnXvKK5MXtjLTbvyNqoGEtGayU4wd0lal6IrpHrysPdZKOpJdZ8Q9XAmnUVlIrzpgMkzijujYZBUW2LBaSXLuVWWKvpGdSq9qJ6S/g0WNZCbZCL8Pi0oh57ZiEynybO93dci2XMnfdbZ5wXwemYTD8bZ72YSfv/j4P0VXD7Yv58Jfh+/fmvHlFe/z58xPD8x/n5OmD/+nG/PM5LqvsoK3E6/OGrGOQQcnXig01pYbdF+0VyPHV+6py6fxwac6+zuN/y9i37CWGwbnY/wX65W3xiYvMc/ITgnOKj+Yp8fdtPmI6OxY0es6dzUnJu5JuVPJXWWJYVAWKaWctquTd1W42M4FBtpveC6XeN56MN1pINMKgdQHIOwVErrMUAm3UpOL+avwqRKSbUa09M9EW7N/bPnCYezpWPq1KrR8V0XrwLOBdYa+NyLiy3agweI5XgdJQMW/yXpmQ/KRJjZEoTU5oI3lp7izYDXhyolp5w7lUR4qhOWFuljnEqEJwjiDB7x92USN6TQiD5UZZ15XYtlrDOK7VVoOK9EELi7u5kGjXnSJyDgVMN5gprdazZs9wCZa3U3jqdZnafqjSpVBXWtXK7FXJV029TRbE1RW1dK0g84oL9iDctyT6R5BDHHyajjdfjenuM2LfG8xd+4tX8+Y/lJ0T2ufwN+YmfBGr2h/FTn/rl21s1Yod33/z8/p78mefxpznJjpHQtNPstPFP/ulf0krjxz/8yOVyRURJwdDaKkZNMxBkdz46ABfHzpRxrpdvWAlHPIUufGjdN1QEvGxaL64ZfufEYZSdhqgJgflNd0WtU5C3GlNbsPZOQtEe7xBuw/dzdGLtn9OEC5G9pMZ0BejOaAAQRsuo3XEZUFNqpuSVslrbvZoLec1oUepaybnsceTQptlW6X1P/dfWFyStVujshhitJnZ836eEjxPOJ/MYJdsDK2zaNoL2bkJmnKxhlaLSdpBL2c5FBkNE+oNvbSvbGisu2fEdtpvZOsjiHBIi6hpae41vybSabREnQAw4nAkuV+uu4mPEhYjHgRj91InbpS4YRmPcoD4oa6VRurEJBoYEj6qNo1GuZPPMHNDQ2TG2T0bV2mTrKsZA2gC6DoqUbOwg5/tY6Gyrg+EcsYR0cGd0fxqTR/pzNvCpO5YDMGK/7kbOggADaUpfDMVoCvyl3Mi5dIS/U4C948P9He9TIoqJsIWUCNMJcRELMCqaV1QDzTVw0RaugNS2YU5N66thaZFcVaMdG7n214zoT27jUb6YNzJu5ZcfHw6xf5fuPJvsNb5bcPjW4bbgGgMxxjmM5yeYoOJGd3+ZL914aodjw8tgwsC7cT67ibATG0Bf66WK9toBH92xYoaAsOsij9rLLE3vynkBV1HNDG2awaLRppRsvfOcD/gpEVPEt8bTdSF4x/l8pjxfuS0rHz9+Ry0ry5pNBD1OlGoZ1uADIQi1rgyR9FaMpRklIGXFV+F+vuNhmvFY29N1Ldy843YtBOeotTDNkeQnHs73sFZC70ynzlkvNTFtF6lD68z8WAzQlsocHSmduRsCkE0I4rv+jCNGSLGRUuDd+5PV7ceA1mosO+eR4JhmY616EUQaXpR8EysDVUW1szKnQFU1sePlSsEoz7Us+DhzN1uQf1tXSmlILxWrraDOtBSac+CjaegE38edWhe5qoTJys2qVkpuvYWrktdCXk2UuRahBcdaK+uqLEvjtij3Hx/IdWHNmelkyZT3799T5Z6//+PTptfVLdY+kFVh64jxS7fXM+rll18H3D8ds729/fTnD7HAi/Pp81R6gkjlJ/fzc+e0J0KkF4rJi9isHWzIwFAtsTOC8BE30RfnfW73qd/QN+2G/W2szV8BmlfbN+0npPsJXvoJ+nhrZvM5JsQc3V80vBeQ8spPsPmJWrpQcW+icJom8IHn6wICKSXqkllL4eHuHq2ZNZfOqE+diYOdJ7537rT1Q6ug3p5TXa3RR/TR2n/3OVO0UYoj58qyFOjdNL2zzylK9B4fXRdaF2JIVu6jjlqF2hxNDWSwUlLrAHWfCstUTdzYMmi2NukrIOcgRWWOcD557s4Tp/lsoH5MOBd6NyrrpmQJi9rF6K0/agGK6q7d2EyyIjhLjpxSNBHibk9KydQm6K2ylhtLvhmD0jl8DIQ5kuaJEAOxMzBbX+CbRqJHsfsnCi0rrT9H1MaKKpRmiZJlLeAcTR2tFbaOus7hsG6So7uvQYG1RxLH1gaH8T0G6lvgy/7Ki9nwcm71Pf5H9BMv5qbwTfmJP6E990/t7B/TIf05+3r9MP7UfbwOGkBweOeIIbLcFnLJQCOvC1NHb31wXeyrdSRzp0cO1N0Ve/iNau06xboQnaYZQYx9kgvRe0IwWnerBc2ui1vtNao1r11E1UOIplLuHN6HPvGts47R+YyFoqNntSqiBekLT9GGtIq0oWvTF/7eb+KvOuikvQuPTZ5Gq4XcdWlqzpR1peRCLZWyrLRmNK+qJgpbX1Hv7E6PwMwyxaY9INadKHokRfxk2j0SAtJ1XWR4bme/q7NSHlvoly3nOFo1GjOp0LpujwEadgZauwL/oLagBgI1Mev/emyo3Qt71cAhJ/RnNOitimiltQwD5RbXM+LO9BPCaPfsexcryyIYiLKFrHvw0AMFFVhuKwDeFWQIEYeIuoC2YtpCvUaYrjvEMbAR067QsnZVfyuPEt/Lo7qImwwrdABLRxmbMasMEDMGi1FJ925NuglCa1ntnHquwpxHw5BH6a9BKZW8dNCvNmvVrVY+V3KhZCsN8d7xbj7zm3fveRcDqa7EDuyl6cR0OuFT6jXLHsT0jZwPBuI1Be/wwdt11NrHiy0SDRdUSgN1AXzgLfror9u+ef3Sme1ZGV6YY+Hg2Pprwx3vxZD2vy3OHd8VeWXZddvZAH13iq1swcSevd3B/tfB/WuHPkTCLag2qzLa1h/XljueKtsF6fHKhiMfF+ZscbCfiGwdznTbtbX2bNI2jFZ8t5UuEKQSgmOaEq2APl1AhGVdqHm1LkgxME8zZc1IM5q0dfmLhFCJveQKbbSqnOKEnz0pRpwWHIHb7UbwHlXTONCWmbPDuzvrTuEc0zyRpmj2vlYDabzH08s8Rft5A044nebOcnPc1mxd9JrD48mlUBArc3WFNWcuz2ZjT6cTyfUui74Yhb5hNtZ7hEZeb+TlRi0FJx4RTyvWxaPkTERhvdKA4B1TAEcBB8+XR5Z1QZyw5lsfaza+qlpmM0wT1hxFEKkW5HVtCHtsFmznVimlbeKco6PEuhZwnlutlAJIwLkIeFKaAUeujdvzBb05JHZf416OVn0xufa3XtO+97H9csps/44580X8dJwXYxxLj+07/Ci7X/ryO7Lfv1fncUz+DfB+sCXtO7Z4H6D8l7Hdy0vn+JnjtJN9yo2S22F7xrlvt/F4mscdC4wWq9v5btP2wNgQ4fXiHTozmJfsi295+9b9BK/8xBhjqG7h5/b+0CYbb4w1xQs/YQnb1sVlFUV8Twz7QMQE4GMIFBztZvvJtWyltl48cehUNluANucQF9HW9XSc9E5DGLCC6yUhVopT1XxLbbCWil9BnBKDp8aKGwniXjKW1PzanGYmH4z1gqdWR1Hr7pfXG8taWNdCdMIcgnVEbBZOrtlYMVYOn4056iquClETUQuhZSKOGBzzHJnnZIBX103UEjtQY2LIIw52vbxfkE3rx4vrZbGF3Bq1Zda8cFtv3PJCbR2cCp6UEmGK+JDMD2HMCe1Gx8Apj/eV6gxob1o6e0lpzZ55a0ptwlosYeMM16GqaQgtrbFSyL4iI6YVMaEBPcT8r6fCizG1v/E2prFPhP/UfsL2bfGE0r4pP/ELgZrX5urP3/RwpW8NjONrXyJQ/3/2/rQ5kiRJ18UetcU9AkBmVnX38Fzh5b1C4f//TfxAilDIc6a7KjOBiHC3RflB1dw9kMilpmfOMpXejUogFl/NVNVeffXVLw3l4ZvjUx7IbEv2b3z2VQB0+Nu0YybO5wfm00yM1houeatPOY6mV3uWA7gyampNMLeiMSMBBwz2Mic86zoWj71Wr+LxEiYvoRqXZS3YgpewOHtC2JTcJbqB3cAHvy7tXpfXbMHeXUh13ANv9zy8wQiexv3Xvrers0V1NT2Pflik+4PU8fcWxw7angt+4UwSGYDTrq+yOy6fMO5IVdU+D56hPkzUrgdn6PWV/t5h7nzpQP0dE50a3+9uEGQrZ7qbcGP0jPvp10QIphWDn6eXn3VVF9f1axGQfBhLo8ZZRimF7BPZ96+yt87eFojb2ds1q0SjwPqF2jXtRmSYImuz3Q4Cz+OcXZhNQap1ABgUv22sjlu4/b0HRkM0ug+w79DxKYS4LWYsc4N3iHLBtGb3uNbCWsp2vxVjnIEy5cy//PIX3j898RiFUIQ8T8aoydkFsh38Cnb/Q4zEHHex5B62m2esN7FSM2eldcVKHFN2EO7oOL7urP6sWzp0FhiifoIS5W6q+Qd0y9wZcxEDRu8/tW3WqEwP+x8f9XE8AoPuJXN9OPPdbu0LQdcNcOHK6uWSWzt69jml6nNlK3ls3K9uBY3O4ZNDZgkXFlchOiNyCJ93f2+0sUcCKZ3N/soMaiU3rVo2zKa9tQ2NOaBRua0XJAnzFCk68fn3Z5TOelsoy41aCn95/97aX6tSuweA4USczyaaJwLauK03xMuJWq2kqExTMOafQKPz7uHEtReyRkJtpJK5vtxsLTFD7ApS6CWQZCYFsUxrb9ReMWECJUWhViVMJ9NtUyGnQimVGBOtNtqtM2tEWyFiGgGsCyFF2uVCTTM9NAiFen0m3yZCjpzO1sVpfbmyXhZ6a1y7Pb/WGjEkBLjUFctxNSTANJ9YFjuvSoWgRPLGfFVMZDKEjpZKV0jTTJJMN617gtq46l3czQp008QqrSCxcToHA4Rj4mVdqESeLyvPzy9kgdvLZ8Ic+PDr3yhF+P23Z6ZzQ/RmCYrDvDDXJpvp3WykDl/4KhhE776vPjbvSk6/mHX7p234H2Mp3cqnAXdbPh9GsDnmg39lr73fvCZw3+XCdmGs0C7O8A1hd+FjUvo2xFib2PjSYaQ93khh6DPtJdUm3GlAWzuudv34ergfY3/K4R77JVmp+659cCy1GT9bHBReaQ7+ibc/s5/YFrFv+Inwyk+M97YCeZE3/UR3P2E3YAj6Wuehpd5QUebZtFeuz1drbV2VSy30Vnk6zzzMJwKuUwgQknVX9fug2liLAeM55W0BDsYmrM4+TiEQeyMWJUgjRMhrYZ1WA7OCMLo0RQnMycD9OU/Gno6J1q2tdimNkgNTLqypkkKkxGrMnm5aaVM1LbRaTbOt10qvC3UJrDEao7Ku9LqgbSboSo4P5GDXIGosJxQiVuIVBWIwcEYx9ijNuryWZh2oSi0onVYa1+XGWlc6SszZOuimZL9PiZTibqv9nm1sfvGEObaGUDW9udYbNAOPWldKhVYtqVyHbZRARbjVziqdLqadFmKgO5qgewTx5fJ9rHm21/SLWTVeke2//+P9xHg1hD+fn/gmULPTYMHFP+4Cgx/ZvlXq9PVd/Ni+/+h37s/l/rz01edCCKRT4nw+8/L8G//6X2e6Nh4eH2wCeLbfgAMDJSQYayOIEB0wCSE4E8HbE3tsMhg3NhEOg1qN9qfV60MlEDNWIcNYEpvBVUB98RvUFsIpJUL2kpcxONu4PveUrUOoaHDnFSLQLNPbvbMTOBPhMCj9nFup1GWllJVaG7VW2licO9BhzlUPa3lrTdv6rhIfgt8nrzXN00QcVPYOWk00LIbg+ixephISiokiqrNhHFsxMCQM5+iAyIBNUS8B8oX50MDBAAbUMp6DYaPDbnhJE9ohGgV+23cdYyCw1R/HRJBgkzjEDQxqgF1CRzQQpskTJ166Ffbz2YwpHqwQoAdimkCUEL2MBytP28xaCAQmTMi005zRIriztNXFZqi0dXpdCSS7thCMnVUNgBsizhI9SBmGq/s49fspIaJd6L14i+zuDBYH8FozvQW1kjrBAqEQonUwYA8WlmXh8vLiz9rGcVkWQg48zDP/j//r/87fzjOZhi6B08MD0/lEmmfSdNo6poVkLd1DyqQpYx3TlF5Xn4Pd9IqisZxIGV0Wc5Bd6SlCine24yed/cuthXtbOur7zZGxOSMfzbg5sL++czv18B/lS3+y/T2yIQNkPATK++dGICHbW8fF7ZER+Xb2Y/cN4+/e9RA8HBfIRu8+rkCGbbQLa+QQeTqfeJxBU6K5eEFw1l8IVtokIUAMrN3q4aNEogSmmDhPM49nRVn4+2//4DRNfPjr32hl5flinaFyDJSy0GsiT9Yd6nazLkvnebLAJJou2LIsII0pTJAit7VADlyWjkwQQgMphBSIQck523x2XbEdPNiF/BCjt4cIKQWm5N0MPTCr1RhFIRr1P0SvsQ9CTImcJ1qpvCwXRra7i1LbiqI8f4acE30x1Rjt1n1EEOtCUi/byJumRG2r2cBsWeDbYn9P59lamSMs1Ut3W2Ndb/RumFNV13ALBupbzbq6HhbUbsG2+UOY5hmRyLo0SldKh1ut/LfffuPlZUUkQrQSsDRdefrwN04LaMxmlwYwf5wTh0DvOD7vau/vft9H5evP692rr7Zt4Xq0fcfF8peT97WdPM4b9Xn8tfPc9z9iocPJjwXO/unDWRxswLbYFbowOtZvp6zKrhFy3HS/ouNi+vU5/pu2n+A+8NNPCJgtf+UneMNP6DbuOzman3j4ip+QEDifzwY8hMCqFpOHGJhiZk7CFCt1EtbaeXl+ZsqJx/cf6KVwXRYCSgxWVhM9PlexzkKtLOTsGlt+Z8ooPZJIxdpHqyiKMdxDDMRUSUtBondHGvcGIQUX/HXdmpQikUBwADzGmSllpmSam1dZWNdKq92EladEq5FYIjEF6irQOmtZebm+0Hojp8S0JtY1cX2JlOXM4+MjMSZnXNoCXwmsxWNkFeuEqJ1lvVHbQgjWWXBZViuVR1hL5VoWKzDKJjMRkg+W5MymLEgCDd11D7vHuZasHE0G1I2PymjAYuBh7cq6evdDAr01mjZ6iFTJtBAhZIJXHVjXK2eyDzDi9UQZ6yEHc8YElMMk86XSbmG35/aVbcyZV7Z6O+C/g584Hv/P6Cf+QOnTv/d2sEx3r/33WAjJG78b+DK20dJLRHj/7hfev/+F9+/ek8QmjNEb267Oji386KDdsp/2/QAuCtZVWWux7j3e2i0E2fehBhj02ug6alPzWIHbYlIciXMtD1UlajT9jWBtpgeCPS5PJIJG0x7xkRbybGycEP28q48TBdcxQTutj/Iutaxnad4xKhhtcG0EvJ3fAHgOTqp7O73m7UtHq+wYk9Wsjk5O0USwpCuuXInMe/lLKKtlO0WM/OHMH+uiZM4qTJkuesimHH7soRrpxhcIm5PtHeGgs9LVEOBojprWvbNVcyR+OGD7/ChtsLpZv/7RdluEuhZondCVJriOULRrDGEzK+LMIhuHxngajsTAIEh5wnRoOsOaDuQ8fm3uuHaNdG/FqNtXXZzYx1OP1hGrDyCno6VDa0hMkKztrd37aqK9zVoAIzurZnQMsAXm4GtaF5rDpwxUyhmqGhAUhcuycLlcWa43zu8feXh6JMTI7//6rzymiV9OD/yXv/yVp6BIXallJU8zeZoJ00Q+P1jWe5oMuMmmnxFTcuBwOGTYRMDjYEGZ+nqplSoBzXl7/ef29a06mDtK64/TDzDAghGf9n3sjcX810MAi2HdjpirNcc6nt0W1r9a/A022nCor8nw9597ezsG48fXxr/HoP31OSjGTNv0txkBuP2d6EwxcsqBQEG0EkUdyBdaNxs6e9e1tVVKqVuL2KjeaSkrTw+R2gQwEPlaK8+fn9FWLWMkpseizctFMXsQUyLlRB/U9aSsS7MsUjWbWNqC9kRQa8sakpAsrKeOjne+yGpuO7tnpEScOeogrrqtKqVs98s6qNj9ab179hrW5UKTMxoCZV3c5zo47Hb68+ePAJS6cj4/cJ4eCCG5uGPjthaWdSHGTAyRWiopCXmOxCz0sppp8gRUWSsxJF4uxkxqzbKnvRdytkzJ6DQy4tcBkdu6RQyg8XERYmQKM801Hpo2npeFz5fCb5+fWUsnp4lEoHf417//xq1PzI+/0OPMUtR0D+Q+9HxrzL4WUL3/3Ndjqu8Fl8e3d8bBiFeGKtyrfR0C+28BSG9t23XwRpQm+4J9zGkZ64jt2B5I+1zrg1gr+/phCELeB/6H8/vK/R3v/wTr/23bTz/hs/gH/MQYx0c/Eb/pJzKqGJi/VFqrhDCRJDOnwJwbnUTXQiegMbN0WBaTU8jB5BBaa6Q09GnUwJdg51g97kcs3h8qMU2Ers3KxVUsjo8dWSshFZtz2UqsbL0zOi1FS1CrrTVCCKQYEElUgaqgGpg1W1m9mj2srZneTzKfF0NGUjRWTeus2tC60GiUtiKLQuu8PE+8f/+eh/MjOVl5vLGnlXUphJiZJhPG79oobaHWGzGY8ai9beyY0hpFG00EiUKPeLtvE7oIKSATyCSQoAfzi+M6+ojfxdd/3sSidnWBYKU1KC5sI2JNWkpvFKDFDNOZND/R0xlioiMMnUrb9SsgYRvaBg5tkIbsr96N68PPMb7fZ9NxDrz+4z/OT7xV2XB3Xv8J/cQPATX3x/MF6g9uXzvZHbm++/R3Pv8lAje+t58bjFKPH7tP+2A5lj6NzGAIioTA6fzAhw+/UtaC0TWFdvloD/PgddSvofdOpzkyLlvgti3GxWrTxFk3o2QpjA49XVG6MWkc8JEwqJeKdZIKDhp42RO6sTPGimBzECG4wrRYpnKaGRGnjnbLYAtyv5LWKk5ZsesaTlBkywKo1+F31ylBzeHeL1rYy6LUCp+Cgzn7j4EX4o5AhT3TUA0swIWO8XOxtuTdHpY488NFXnQbB7IhxMdHLoeTu8Odu6JiVMSAQIiWDRGBrXtSs/PzTljbAf1O0dVaPftAEsGpbWkbB4S4f88D8Y2MLoL26gsSMWh3rAwsBHEL44KW7uQOJmUb/KM2di+z81bqXqfMYBiN5ytt+wyjm4CCajMHNoAa7/Y0tGmO5XNmQMc43Swm28UGca0OvHH3Pk5KKS4M7U9O+wZKPZ3PfHj3jqd378jlZkDWITtybLUYczZWTYyWqQ/BxhAcMtK7y7Lx3QxU1I7G6Oyine78c3t76wen57q6OzYKh/koZk+6Hpz0cQn62pJDkGBjRIKNM4wMsbl996zHgPhrTAM5fmeczxufO/qYrwUM4zPHrOn9Z53yLIfRs52HkgRyUKQXWrsR6FYCoKYn03W/L713SikGjDCmvWUopxSJayHGwNPTe9be+H/+v/7fTDlzmrJTugOpN1QraEEV8jQxTcmyhbWxi49H1ltBQ+GUJ1pvdBXWDteq9FtBQmSaO9IabV3JKSE0kGpdnoZGw3i6as8xBmXrXKfjeZk4uAgspbOWQoyJl9uV5+vVtGnyZGyd3ijr4n6pW4lY76SYEClcLx+BwFJWY+UQuK4rjw8zS2ssa0FK5910RipcXi50zKaVWrjdFt69e09vSlkLYPoHIp00BVQ6nUr35MqwUqixgtwymy0KEaQjXVlbZemVl1vlslR+e77w+8uVGDM9NE7TGUW4FOVyq+jJfFe3dQiv22+/XgS+JeR4N3a/kvF//drr2EtG1LuP+i8Wpa8t4xY8bxHv29t3AaLj72qv3C0cvgjR93M+BtrqLx48EVse6xDMf08M83iP3vrcnf3xM3s7Vv3zbj/9xL/NT0xBkV6/9BO90/teXqKq1FIthhK8hXAghcCUVm6rJWNP5zMN+P/+69+ZojEz6UPTxDoTES1Gy3kipQTaqL05A9zK1asz6DV4QhbTU7G+tnWzj701ak6cTkrOkRjxsqBgz9zXOyIG7Bur3hIYYAmAk06I2J6Xl5VGIOXJQI2mhCmRzydrTd4avRZWseSo+DqhaQeJ3NZGjN4hFGO+L0shTyfSuprepVZCtNIvwUT/u4NEtbkuZjBxeAOpKtAJ0fRsUqzIpIRJkAwqxqKpznbx1KmtOcU0K1VdjL4rtQu1eddAEWtGokrtgUWFFhIpWTmzpJmmo2U8+5pCbNYcCgIPcfg+znc/cXjvFZhy/7n/MX5C3zr28ff/xH7iO12f3nog39/ubu530ZIfWwS9vvAv/9739f3zvH949tBePV4f8a3ZMD+dH/jrv/wXfv/40Yxbjny+fbpDv8fAUFWnqbnwmQMtOU9ErNxHHFgw4S9nlUjwdndmZDt7u2oDWuK2aB3CkjG6mKI7Au0dLQ5cBHEhXm8NHk1YVUIkTJMNSu3oulCbAQMxZoa+Syurl+54OZGXcEncwRTtnVILzctdWuts6dRDoD7ad6N60KGxusoYvVV4zs5ucIZDjHZPa4XaDKEeZVDd2y+30ZXK3hMfB2+Tuq2c6ZjdGGDIsDVK97IdQxKMHengCgHthVbLBmQE2btkiQMkI+O7BxGyX48cKb4WiW8GZThrf444YKFyAOpUvVZ7jNMOdLq6aDHi37PzCcFaydJHUO8smLqCX4fpxHjGupXt+LvOjOsweLtsPQBz2rt1T3EQbTzXUXo1fuy9cY+Dl3PhLQ1dxLcb1RbMkQcCrSy+aIIPT+/4yy+/8O7De9pHc8aSMjEE0zvCszXRlPeNqeVAjYy5afd1sIYGYKzaTBi7VRPBnlzwWe6pyj+372w+keTw557hYQObBZ+Hqvf392DXhxMXHQKuwW2W3jMZ/aujlGb3C+LjboC1O3hpX5R9f4fvvhWMj/2/lfl57Zy3LNI4DLslimKZ4UhlTgY+dGcZboB6NAxy00pRpXhpTYiB2is5WTvpKUUDfaIwzZn12nm5XJGnyKTBKNH+v+baUPNptr/rarZMjEnWWmNZV9cLy2g10FYQehduS6NrIJVOvhUekpdiovSRBaRTu2UWA5YF7OimB9Ca1eKPQLn3RimFGDPzPFNa53K9sCwLtZqgcIjJugLWYu1dB2Du4yL0SpPKcluIKbOW4ky6zKeXK9eqfHj/HnLierswq9BK4fPLM9M8U1Yrqb1eb7ws1ch+AnOOpAgP55MDP52mlaReHiqg6vXnPs5DMF2zUq2Ms6lQauflsvCPjy98vKz8/umFtUIO0GthenwkhInn3z+TH57QkKkd1zN7XXq0s33HmDnWwL+Ot6xbXuD1dixhf3P8bh88fmvMJbOzoHspN4dBPj79qu7+LTDpeC5vfWY/8oil9vN6TewXcdFOdGOuDTvTD/54vPbWuXxxyW+8/7XzHq+7muBXFuY/N+Cnn/C/dWsl83U/MaWI9vqln/DQRCQc9P12VnttjZysc9GcEzEsBNc8q61zXVbkdCYFAyta74TgAvYipMlKVHstlNqsJLwVggZLJEg0kXvdE5ZNhVvpGzPEcoMGWMew3+8QrUR0W1YPcXYsfpMI0r2EKgZqwLTOcmQ6JZa1sawLa6nU0gghM4uvrWJAwmS2U7GxU6udW1PW2w0YTUUsGXe9LsRUOJ/OKJ21LcxzBumUspJSontVQKnVY3Jf34jF23E846DEJITsKgmOOfbuDTm6uu8b1QaKdm+1bcUE1nK7h00YuLRKiJGCsPRASDMyP0I+gSRfE+m2fjjgC2MA7uPPW677yx6X293nsI4+jultzMLGGP0RPzHi6xDZz+nf6CdQ3QR/v7b9Z/UT32HUHE9FXv0+bvv/LIuYr52rv/LFTfhyIS+bIJi1wzOR007KE3/9l3/h8eGBeZ75/PE3nj/+5oN8hzDNeNo+my9kJQg55I05IqrQlVYLPQ3xXB9gY6F7nAgxOvDhk8oHngWFbAtem896mGg2UWKIhGQ/iCApEtJkSKGDARUHeVTBu1B1B0eIsqmV97o606O7wKyYholflzjjxsqE7BxqdZaCLzgEITu7RwiIRGKeiHlCUrJylXkmThlE6FHoOcI8oSHsLBb3AuplaObgDx6vdzRyAI32rfv3pHfvGOL00yD05l2QcmQ8GAEXBRbaWqjLjV4r2irz6YyE0XXLGUUqaCmbEQwxeJcnC+LFr0G2rLmDPL2hQzcn+PG77oCBYBZ8pKOM7MjW/hfcaVYzQOJmKySgo61sKvm9LL4vN2renltr3YISdZEuY9ZU9Pm2McQo1VuOV9pyQ8jGxpJE641aFup6NU0iiZAmiC4C1hqRBE3pa0FTpmFU19W7WqWUbbHYr9DgcZr5y6+/8te//Y13v3zg+fpMK9EEmaPVKYdoavAjwIu4wPPIYviY1lpQ693u2jugrVFLYWmVEiNMM3vnr5/bt7bRzQMAwenMbHNnUF+DsrVC3PyHDdr963fOX91G7ABmUz0o7H8/w3E4rd0OeGBv53fIpL4RXN/t41Vw/rVtOOY4AMhh37Esb1Cz2ylnJETq2imt0yWZCDxKa/flQTFGEp00z9yWxTN+iRiVp8eJQudlWdBWKLWwroVTPlOBnLNL6Ea6t85ebiZICcbISznTmxBTI8eE0B36hFpW0Gj2oCpLVUoDTdFdU6cpxnyMdes4KFiQriL3LDzt1FoAcQo4QCeIWMb1Jkw5gcK6FtZytS4fvTHP2YLz1snTTErZtNnqjV4L7WZMlSkE+tpowPLyQsqZZV24LVfKb9VMWKk8Xyrr2shT5Hq90GpnyhPvHx8xweNkIprd2tfmmP2aIIYZNNCqtctFDNAvpfliJ1DWwvPzhZeXKx8/PvP3TzcqkZxPxAB5ipwfH5F0IlwbtwYnSYwyUQ/VbZq8Me6+Fkgex+n9lNoZOCOrN7bwR+2d7EvtMUePUdVbge6bu3nrM2MhcdzX4W8O12bHfhWMq5ECts+9WiHI/Z/3wfR++H/b5ouJtwL1P/P200/cb6MsK3zVTxjAnVL6YT8RYiTSSdPEUlb3E5GUhKfzRKOz1GIJsFJYYyZLdlAkGqBgPaRBhFqrA9F7jNyqgQxxMNj9vnVn8jfwzkjdxINViWpCvbjNMQaRMZd1CA0HJajpmYknz6wqoXvjEIhJmKZM7Z31Zom10hpaG2u10tUcvXuhjHbcgkZbOzRP0vVqsXqMiVo761pRKcZSorHWlalakru1ikihlorSTUvRx8U0ZWMIBTFmdwzkOXOap40paokOtWTDYLR70sI01Nq+TuqKqrXhZlQXaB1qDBSEGhI5nwjTA4hpzPXebW0xHsbd8nYftzt7w17fqzHGR+2LdyyPAziicMee//4m2z0Yx/23+glE7ub0dkKv98Xxev5z+Ik/2J57vwXifd63d18Zxf+e27/teHeP84ubdc/QsRbYaZqZTmfS5eWLoGZHhg9MjYEsHtSvB1Nn/K5OXzShqb1+UwRnsdwHuPvI3MueENl/H6cd7DMhxg0kAMywtuKLcOtmNOqBRbHuFmv1MpgdIFAXhG3NM8DCBtIoLpCl1qrPOkDZeRpI0/eAfJv4496Eux87GB73GoU8pOQ0SUOkZdznUZrS8fvjJVHjHqvYJaLj0ZjIr2dAcaYH4pT1HsYT925aI0hQTOfFnnEIEUKnNQPcCB229uz2/e0xC+Ni2HpdbWVjY9wKpklj4AsMmmzg2MHpfrwq2tQBH1v92bvOXNrQPxvM271xXZ9RpmZ7VkQcEIxjnyAqWI7cyibKy8v2DGVkv3QwpKwdLsj2DI4sNWMVWTcYnKVmrKRG79FZRuJlZoGUEqfHR27rQisFOZ159+4dj49PJkAnwUCt6BmYuyzWfUAlXmO8jzMDYFvrpHHX1LJFLQjNWWe7BTjM8x9xKH+yLesIvLi7YS4z7VTtzULedR3V+6+84bR2Owo+nIdT9Xdfq+qPzZKwo2zx4OTtQJ6NvA/Aj/9+YeNfvX+nPXD0ew7CBmFrVBLEFiXRA/Do3fqWtRBKM2bKpDQMAB37t4DQAPeH2WrxX5YrpTXmKITQOM+RpUQeT5mXayJJ4PJyZQon5ndnlEhpldsKc1Fmb/scQnDRRUv7nU7z1oEpiJCivd9bZW2VnC1FWFQpVWkJsguUd1Vuy0LtzQCGnKzVqYzWpGwlpCJh6wIXBmgvpn81xciUE0Igp4nrbaVUWwDclsJlWWm9k6cTtXZauVFbJ8TIKSfKspBz5n1MaFc+P79wmmaWdWWtN1qv/P7xSggRkUStwvPzjZQFKJymE1PKRLwjSYrEECnLSj7N5JDoWokSDWjuCj3QQ/PujCaALATWtbJW62xVS+N2XVguC5pmmgfEk2Quy8J5fuR/+z/+T/7b7xfz7SoEX7Q2+bbd+RqAM7KZb73+Vrz27xG73R3xD4I0d8cWtnW5yLAZx2zqcdHOF4Za1Lmqfk1fXJXsHvULu2En891z/+o1sQNrb7Gc/qzbTz/xtp8QYWNfDj8xgJoY/oCfwMpIz9MZSZHLeqP0xhwhROV0itxqYIqR6I1EbreFRCbNZwPbeyc0iBVS1G3uqBiQ01SNReNPRIYEAxb7127tobuaxkrQTkbJAjlFJBhj2dYJCSZFY0C8TFQ6SLMYeax5TOowEFsgEkgaScXgLWONW+e+tVagsQBxTcRgYsWjdLR3i7GlK60UUGGeZspaWRYD79daIELrlZfVkqwe/nO7XlE6KZu+TorBzitFF71PpBw5nU6cTic7NmJMl9rR5qwX1a17bm8Wh9ba0O4lfCIEFaqyN2QRY2bWkJjO7wjTA5ImWzu2vgmqbIwTgV3KY1+XiK+F7mNk9kl2GMMbwLnNg/33H7WPX/MAP+onjiskAWf///n8xHe6Pr316qsL5965/2gN17fe/xEq7DjW9/b1lXd4awjd7+9w4xSsWDxaHWOeTP9CwqG+jcPoG5RNNtDFHriXXfgnRrZRmwkNigghKGlovAh3bY67Z/UAZ3jEO42bnfC2H19iABcDEy8Zolur0B2EcElExbKDxSiWzAmJVm7Vq3V76r26drlPeFeH7+wgTXNtE1XTW2jNkWw/Jw5Oa1tkO0ijfkq2e3Htmmz3T9XuX4hbJ6Rt4ooYrbA5+DTODaVbDdpGSdUBvDjAcQTkAAPWDjXF1sbaxZrFxIAFpbdR8qVoUFJMHhwc5gNgQviO7o/OS2M8+OE7iqiDUNoZ5WfH53nEauwe6fYjXpcNDsgMxctuDg9nsmwCzEMwGEG7EILdY6JAb7ZQUKGPMd4r9Xo1oEVwZlbeQEwJGSQi25jCmDytbddrwrzCBvK6caq9W7nRCJhCIIZo3ZwuL6aDcT7z9PTOVPtDtA4FPm6idxATu8EbWDPAzvF6wEqfJAjNWyHqNuYMqKn5bCVeQ0T4Z5D93U3YM6PHcp/RGjFi7EQR2UzObjRf+5n9tW2Io77/VzZ7xBxuK+z/+2eGVlkQOweR4eT3Y4QxT9Bt3Izz2GqJDz7tLpN6+MEDBPe8d95lqEcNtS87p2iYZRNSzEzROg11qpeYjtJCsSknkHKm9GYlga1uovYhBlISznPm/fnM7emB3z89U8sN7U/WzrOZMHwpjQnhPJ0oZSHlmd4ay7LycHqklkZOgRzjeEiWSRR4ua2c5IE5T7RsIIXkbK23e0PXhU6jpUpx8CXFQIhOMw7dW4PDaEfZ2t4ScwTlD6eZmxSW1er+o9hrtRVua6FVZVleWFvj/PjAWlZiitQ1WSiqcLleCBIhwOV2Zakr56cH1ta5rRVrg76ABj59egbpPD7OvHt8xzxN9F4RnYgSCZKozVQFukIgEUmmIdC768tZ6XIr1hUkSDCx9Q5IZCnNQKfWkNCp2mldOc0Ty20lnSrv3z8yv3QCccPZjVYvd3Tzt+KjfVHoyhCHcT7Cz6+xAL4F0HyNZWNz4hBFjQUnbK+r7AXIr7v2SNiFX/eFxGH/jAX8+JF9v3j8ND7pwfYbZuTNhYKxRXdDNbrRDD+8LUhgszn7kmcP0O8+o9syyO6b4KLa96ylP/P200/ww37CudeuCwitDz/B1/2EX1easunJiLH9erNm3zEKKQpTDpxSpkwOhJeFPs00Ar0roQvJO3OmEGm9E0OidYv/Y4ibpqVdgwueq8k1rA46qAhLV25BOE+J1pXWBVde38rS+pZEqw6kCFFG62qL7Q2sEWIXYoSchWkOVHVWpnTrvaHCrax2HSESxQB70wc1SQqa6ZvRlRRv9K7GqEFdgiFhzBmrXBAxbuntdkOpnM8zD+lMCna9MWVOp5k8J2ISUjZJikAwhn5vtGoJeTQgI5mqamuHZuuAEKIlNtRvERigI2LszNYhJc6P7+jTma6R2vTYA8fmjexg524I9/E67qvZ0+4+c18H+QSxZ/GGn7hf4fjY/Y6f2M7klZ+wl972E+pj5MgC+rP6iT/Y9emwUvxfevvyluwgt27/dgdHbrebT6TE//5/+z/4yy/v+fSXX6mf/sHHdeV6u5nube+b0OBoVzrYH+Dvd6uB74r9J1tHihBt8Rkc4bQf1wqp1qkmGMeOrQY37A6vixt6hd7aVj7Vq5f4VGOJWOlLJ2b19tGukWPqvfReCbOBOF2csNJBazFqeas0dw4iYpnTYsWyrVbrcOS3uHcLZFtvWyegMIAMZ/bh5zwW7a1WejLAI06TiWy1Tr8uxJyQbG1LDexJSJ4RFgtGnVljKRB/qG60emloMBq5tbYeZTJiJxLEs6ziJUrslmEwXxxsIiQ0BSthclaL1YfW7TtHdpCCdUtq5lBezyHT8JItM+EhB9t0720/T7HnZEF8NEetHe2rGzpxdSyljxR+aw7QVXfq9oA2ttbtQj+Lly6Jk3ucptmKGxshnR6pl2fq7Yr2hfn9r4TzAzFk12wwUCh4m3WpFaXY6xK2LJeGUXtrjqjUheVy4Xp53vR7miqfP33i8vmZclv48PjE08MjD6cHYkpMD49G/ZW+6TuJGzyrCuvUdSV0K/tL8wzRNEGa9o3BE1OmYx1nVqDnCc2zzdv/LObuP3qTPTA9Otbxprj47XDmfYuc2cb7Wzu1qbdnOkIQF0g8PBTd/rNrCvgWfC5GrFGch5QWBEUhOtvMlwt75nQslGUHEd7c9P4P7fti2sq9d4BVhg1x+ndOmRQTMVhLe6NyL7TblV5WQrCWpQClFmprlFun9M48naDdqMsKViWD9koSeJwn/vLukeXyQis3Pn36B+3piQ9PJ2KyoFW6QFUCgRQjDaEGo2bHEJhmY75Vz1CGCEU713IlzTPdqeK3JJymZIsbAqfpDFS0QymN0VY8ijPspBHEtLSkW9tRdNDAGyFa6ROAkfQjU03uTyPP10/EAPPjA6UqerkwBQusu3Yuzxc+vP/Ay8sL620lT5kUIxrgcrtBypQKy+qLidZNaDMbOy9NMylHHh8yUgtBOjkn61B4mlzfVMlp8sWTA+yiVubWdCvZqK1hXaACS1Eua+FWDKgJUiEEWlNeLgsP7ztalZffPzOFxAa5i08uZPOPb5VxDO2MY5C46aXBxizYZtbraHeM2Tfee/333bF9SAuDtcg2rxWLSTr7Qvwoy75ncn3uvJpiilLDYKAZuH+XJ93dHPtd8mtwBuVoifxah8f80Q4cjFKTdsgSHRkUY/5v57+d7P6Z7nbI/0J9UWBxxM8SWuCnn/A/XvsJvuEnUkykkIgy/IS6n7i5n+DeT3TzE1U7U57RqhaTx7HoNOB7TpE+T5RlodaV58szp9PMaU5oYNPmNNa36eF0iYTQHUAKXspk7BkLT42NZFK5BrrV1llLo7RObUrukLDz7d0SuaNfhviyW/B4UZyZfgDIrHW3ME9pE+QVKSgNkU7rUBfr+hdCAi30aqW9QWBZbpRSoYuL0SuuE2BmVoSQIt0TebUVcs48zCdiFNtnDIQkTKfMPEVO58zpNJHnZG25o4FPvantw7v4Ir42HKwxH96mP5mQ2L24oaE4I93FsdcKSiKlmRASEpLp2Ix7fxeoqt/NV6SJI5DoEIaNu76xdmC7FV+iIj5mDWS5P+K3/IS6jcWBR1XuOtK37/gJ8wb7fl/Npj+Fn/iDQM3rVcv+9+tn+u+9vWUE/7kyhH1/x10PHMFQXLtx8zwjDNZHR3uhrFemeXaRWduf4w1mzl3YVbsviMH0RnBjQyCkuAnzhmMJ0PifCDFHQk6uMXMcIFh3GxcSHhdh3SgOl6jdER0cxbF9tFIh2uJW1c9Tu2cMYfxXu+m59N7261RDmrZn4oCRLbD7Bk4Ym6YZWNPa1trvgF1tIM3xuiQEY/KAgxANQgLXWxGJO8hwmMTiAIlqd+e9lwdpMxCthb7pCJllHiVALuzmSvT7ZBdjhgxPOu5OAI3JjGpzAWLPDm/KWWJBw3iWY3B8YXR0P94YJxt1agTpHngzdGPQAyjkhkWHUTNDLeCMn7YJQZtWRKU5+Ke900slpMX2nyb6crN9iFipXLcOLwE1sExOqCZCzvacDlC3ZUDsOXcdtbMeuLexYMPFsi3bsC6V2/XC7XLZaqJRKMsN0c5pyvzLv/yNp/fvmc8nEEg5IfNE6CfSlAlTRjYxane6ltYB4r6AUOjuoBWQnO3cutIQeozW8cmfxnBrd8+Lf9b2/Ofavkb9Bmy8H52tO+pxJ0fm8KvbK7P/vYXk3QJWdrvkBYUu/q7beJXjYphjkHK/z6NDtreHHXv1+iGYGSvnsc8R/MRgAonn05k5K9dPH7ldnulltZr+mEwEXoRW+9YKtVXrXBFC2zWWPNgPAXIykfvT6URMmeVWWV4uNIQ8JfJk7VEnUVJKhGitr2urpJRRdXA8R5abtwOvxeZaaxasYoxCVaNu35aFXo2qPs+zzTv2MsZemmktAFRrZ2rCjB1xJdpdvyxszyDFxDyZYP5aCutSePfukQdVWhMu15VcTENAm1Crl1LFxDyfaM3AmBDT1ta1LAsq8P7dO9ZSuF2vlOsNrY2nD+85P0zMOfBwykQNpJjI2e5pnB5RtZKwGKNlZLfFg5hIPRCSIWfltnKthZfbjefblaUMTSGozUCsUjtpjoT5gR4za/PkiY4g2jLhitzNsePvd8DJCCrBGDU+Pjv34/PVhOF729dsnYFAmxvaxn53Zi0a7sb+GP/K2/Hc62MG2afhlnvh/oVvsabl8P7952wvW9chHYG5jm/emZ1v2/oBnO2/v95+lj7Z9tNP/HE/kVK88xPL5dlKwbUbszu6n2jGSlbESvJVEemMJhEWVwsxBnKKlKTEZqDwWiprW6iKrQn8OQVVJBsYVUq1DoJp2rugBqwTYWvGRkqRAMw5oV2MjaiNrp1lLdwWYz6mHI1xiLNpuoJ0ki9xjUUS0DCap9hY6M5CicESxEN6IeZEzo1SmoFCNQ3JRWqptiZpeNJ9oVZjrPemVnKEadWAJewoKxqEmGwdElKk0UkpMZ8mznPidEo8Pc6cpsjDaWI6mX8lWjzeurGDWq2s1VjoMbrOm1hiQ2LYx14AHeu0YHo9dIOt1tZZupDOD6Tze0gzKsnlJaz8bItVR0MR2PwpY+3wehvjDlun9O172yA9IBxy97W3tm/Zye4+YivjFTYyxGs/cZw3b5YjvTrmn8FP/CGg5uv72W7TD+zj+w769ef/QxdF2yrfFrd2DvtDkBiJMW2dipROqyem+WydJe46ynjwchhyvZuRGG2+bFIEondsGiwOiWHrAgW7wZcUCTkiKWItTQEv34jBWhGP44xpNtDO7a75Pd/odtiieQR0qsEVyR3U2JA9sQV+N6BGXNBLfcBuAAJmbLqYgxiL4NoHSGM/EveAUo9ozX40a4kWZG9TPjKJwUGakDaaz2gNvWvQBAgd8ai5d3dSqmhtllHYFvJ+7N5Nyk3E3td9+m13MXjnJL93Nh5HFyYDA6SLt+32UHmUTh1KcQxsORL19kjklYnc79MAZcY8GLjSwflqD+DCoPZYrG54PHMTXHbmjTpw06rdy3Fv1sWOJdGBGrxLlSCtIrUS6JCTOUkgTNkFgvfrsQyMLzNUd4BvdA1jz41Zu8NOWReW643lenWarm2tWJeXU575l//Lv/D07olpnmwhN2WCToReiXMmTjPB23EPHZpBab7PLMuhAxlIzK6tpDTxFe9gQ/2APfu57Tb7Tdu+jX22LKGim9q+qmyaAD96rLeO9zW/ouwijd3tjvp+RpvYL+ed192PYPqYiZLdvh7t9Jvn58AzeszyGqNPxDKDAWtxXa430yUIJoxdupWaqloQmdxW1Fqs3CbBnCeqWlelGISchD7DtSam+czL8kKtyvVW+K//+tFsw7szc4RZA/W20HvjfD7TtfNyuRkQGyJNBIkTSczWisIpJ6Y5k5MwzZbRNOZIJ0boq/qc67sAb7ZslwChKUQLXkfwE4OVJ9mixWr1LRgPkAKqldaE88MJmWCpC7droTThSc5ekmRtZB8eZlqrvNwWFCufbH09gAjKuq48vXvi4eHEOmXWnCjXhXePM+9/eeTd+cRpCmQxttGUBRHzXaqmjWXXG1AvKR6BvF1QZF0rS2tcS+XzsvJ8s9a4DWGazwQVSodVKx8eP5DP7+lhBkkGLDUDaUZh9dFXvs763QWY7k4seHX7LzL4l9sc+SNgzZuLyxFP+DxWDotMsfKwLhYAB4Yy2/B6ssUJ8ta5HLYgXpk8Ygx/Xe/WD2/bnqP1/tJmvIoxOSwGxv08vn+IQ16zQMb+h5/efz986j8yfv1faPvpJ+7n0j7vdj8hVgsBjFJ9SAc/sd5uRPWynhBYeze5AoVw5yeqSSVEY29W9S60zlqcu7A0RWKi3BbTn6RS+oX6dOJhSoQkVrbaTMcye1KrltXrxILHnvv6JgJpSlvZkWhHaqG0ynW5mexlhFkSUQNRA6L22ehJzeayBL1Xv6ceY27MB5uzMQjzlK37bajEWG09xpnremNZCl2N7QhWZouXJC2lWXwakq9dgseqrnuDCQWfzxNTSgTtTDFwPiXO58TDQ2Y+Bc5zYp4jOXm1fNCtqgFxrU5R70R6bH1kIE1TpaolCZuOVhiARDTaGupalRYn5of3hIf3kE9IyEjVTacH1LlIY0yN8aV3tvLIULEEsgOgYh237PO2HjJM4TDmB7D4xvYFEHqgzLz2E9u/r/zEWEWIn76KuN7m8C1v29E/g5/4g4yar21j6fUfs/37s2m+eqTXB9kWxDaAjTERUybPMylNVrI0zkWNBqhb/bUZ2+7UsuCL7BiEnDNRDOHedFqi/3i3Ke1KEvGuNtYlR5uVLkGnpAS9E3Mmh4hiVLuQDFiKKbpo5SE7EUb9vDoLxIxIdwFYGUZXAipKXS2rOu7O9uOTtvdm5VCtGj3f28iqAz9Dzbx33Yg9MESydOt+MuVMjokpZhIBqZ1eGyFn4jwzPbyDlDftkC7d6nS1sV+cAxf+R6/dO28Fm2St028NdHLtEkCDobwBNHZiSgSFOB2v9tV4GC2eh87N/tY2Do4mzV5vvqt+EHfejdkIVDaP3ffrGqLDNsr6BjywQYKCdX2ycVHr1eiREuil2EIDYzVZq/MKrSLTye5nr9TnT2ac00xfFyQlwjRbZqBVpFVIyTrV5GxCZuodwGrfupkpEEVdRLWPwWTlZNucdWPYrWa4roWyrpR1tfklTkPWxvu//ZUPHz7wv//f/08e3z+R50xKiendE33O1CmS8kyeT+TzowE2ydpGho3ApQaYxYBkA4eQaB3TQ2C9XVl7p06zKfdvWYl+d74/t7e310HqqzfZxrmvzmUE4dzXDL9V0iHBtJK+5wNG+cfrQ5s8kh1/d/bDXptdHLsRGdkVHJS2N95qySpvAHlvZW23Yx6OEyRwPk0IjbouLsgNwenYvXdWL7tNwcajUd+HYC1IDjRtBIV1Xb1sKTPnxDwp54eZj5+vRr1eCmup5Jw4nc48SwVZmXPm4XzmNGd+//QRlYDGwGVdabWSJCAkkIIA59NEmiIxqtHtWzGh32Qg97JcSDmRU9p8Tm/G0owxkiS6SPu4J4GgSp4Tqt5a1mqHbGz0/ZmogkpCqXCCnBKtC5+frwYExEQthY8fP1E1sJROnmdjKIkypcDn5TMhCs+ffyenzBSEf/n1PfJemR8nHt6dOeXAnIQp2gIsBg+BxzWESIpp67LRfNFgLc2NBbr2TkVYG1xL41Y6jeCZ7kaazpRqoFU6PdLTTIgT4oUXwXObchhHr4PJ1+y+oTEwSqCOSYXXnx+BIvia8HXwelxQhkP8tY3fkXTAuxSOxYVPusDWmDCgBtYc94nPs2+A4XvwrtvyQ2AXow3fpt4zvveVOTkWC3fEVdgyuMd7D3xxv7ejbAsB28kI8H9iM19uP/3El+czFsPjmMcuWBKE0zwBffcTYiUezUu4y+Yn0sZSCVgJq4SAZqH1iqiVQPWmxJQ4ibB0mOaJ9ryw1sraYCnWfCQGK3/tKswpMk+ZnCLX5YaGgCQrX9cQiK7hMpgdycV1Y0xEhboovVWW2ohrQaLQw8Rpzi7wPABdl36Idr+beve83g2oEwwod5Zh3DoWWXJWiFamJqaZKGIsn94CtdpzijFSq5WG9SYMOqrJAQzNyO6VDc2YS0F5mmemFDmdEqeHzMMpMeVAzqYPJ17Cto2nYbPEYswwkvBRoKs3XzHGTEOoKjTxkjvtNMy2VlVWInF+RM7vIT/QxdivaN9Kbc2eHXlnckA8BvAyNGZ2uygH4OB+qPocHDDQwU9s9lEONliO138AJgZQdPAT8oafkM1P7McU96vfUm/5s/iJf4NGzeGM3/z9xwCbL5Cto/H6Cvr1R7cvv78HHNtgvvv3y+2LBzgeqgilFFo11kiU/b0RtGyD3w/de7OOQSiqZgQ3zZYhAihhY74I4P3yDE0WMZZDcGFa7fRWQCDOFtBvbE054H/inW6c3bA5K0c9O9b+rjsA0Y+Kb4OpsYeKtg9n2WjvtNKopVGLtZsb02WwdIZj3YNGH7hiHTJCsjKwlPZymo4ypWQdNEJCo7OKovXpkVad0YIxRjwTO4qhOl5mg7M6/PS769hoG5emLvJrz68HZ+B0ExdDhrDjKD/yUh5hb1U9Ok69MdmHKPAwdGIolmMA3q4dKyMgGrhCiNAcqNlEmMVeV6/h3Uzy0NmRw/CWTaht/E/HU3TW1NBCsrMAUqLXRr9d3WVGYzBhoGMXIXkLdSsFs0yIYlkavMQpEGl+jmGbD3Z+6towfSjej9aO4mGYiLVVdDAxxsAvHz7w4ddfeHx8IqdE9Ey3tGb6SJi4d5omYso74Ll1gTJHHERc7HqnuxKiMR2aZz6StUseXWyGif9JXf/+9s3MeBgVlwdHfggQRgBx3M/+twVj/TgPDtuwLUMo/O64bpPDtmi0MSYyNL3CVgZ5/9V7W/dFlnQLUN6Y72/cF3EbMQ6k2gmipGB2NAF5PtHKwtIqVZWupjOWJBGDzZkpBlKOqMBSV66XK6qwrp1SlBAs+xQFphSYpshSlK5WqrQshcvLjV4T8/mBp/lESGIdRRwkX9rqAVLielmgNnKEnBPTyUR2UxZUTY+r92YAytD4ipHpdGZKGenNA24T4oueIQ6usSYhmNCjWHYxTmET6RtaVROJec7U1khVOLVMKdZJaSkNrROJwHpb6b0QtXFbV2rzhZM2ptNETmZX59NsfliFh9MDH54eeJxn8imT5siUhEgnDv8UIxIziJowshggs1YI6gF/FytXE6GUhqqLs4fGsjaW2qkqLNUSPVNM5BB5OD0yP/0CcaJLIKiNh12/cISHX47t1/GSlZKN8faqTt+t/+sxbsybw4KU+4XsYOkOrQORfVE8pkgU2XTy7n3NMfjeM70jNtqqj1/bhf1lD+AHqDMulkP8tp/zF9/35MbrRf02lxk2wf7YysUFUPOTxwX92/HpdkXji/7+Pfb1h9ue/yfefvqJL8f52LEguw6ijLmopKBv+onWdz8RBYLrxeQgxDShoixFuS0FVSilUwsbuJSikF1geC1qUohqn88pUaPtZ0rGpDEhdAOru3QQJYogtW+6OzEmUopIUHIy4ElboDTTo1lbI/ZG7mrxV0obwGAxdHDwpqPd/t2S3mIJgUA0TTBw0WAhButSWFowseEUmKZEKZ1WlVphzbZOab2TknCrSlHzC9qatQVXqyCYpsg0JU5T5DwHns6Z8zwxnzLz2V7PSawrYDT2pumSGtiw2dXQDw0t/BmLnXdXG7chJJTi6wqhqf10CfQohNPE9PQrYX40BpCCtu5+WthgBB/H9wP/MN42EzXmk8+dAzCib/kJYBcU9dWHsmk7qfuezda6DR1+Ivh1cTiN/XRk8xNR7s9+S3SNM/kT+4lvAjX3B3ht/PRwkHE7v72g+ZEFz3/cokj3f3Ussr+F7r82r/s+RkBiTJLmQZJTuETuJ8b2TdOqiQNc2No979mz7S7qoXhK2YGabQEKScSMina6NhPkCsEFmfRw1DHIAoOKp6q2uB4juw99E1Bx5pAHqvvElQMQYY7D2D2mKt+rK5u3cS/2VogjG3EEasYdDjEaoygGM9opWnlSgJDiVsqiY+Htk3+0IzeaYd9KZgYg0YeosEJXK29yEHOr7VT/F8GE7IKY5soQfcY8t2VV9wltaK1u40QZ49bup8ooQTo8w21sDeOiMIiOqs4MMrGfzVwNcGcY/dEJSjDRYBFogHQH4jwTfaDjjnumGu5OQkLcLYUIIWdQq+mNycAyGVka7Sj9ANLEbTyJw+L7Jer9aJb996FZ09oOnI33h6nJyVoqxhjJKfH09Mi7xydOpzPJAZcoYlkQEohaF7aUv2j3C+IB3K4X1VujlYL62BvPQ8GBGqfhjIX1T4zmn9pE9gD46OTcz20ZoePn73cwhug3srGH732RrWQvuwg+Drd5KWJzTgaYDNuCdnvty/2OvX9jzeH7cE8hvnTezK1yvV15nCB1036yzhDOSmwFaOQQSUFBK1o7acrkkChYMH27rYSQqBXK2oFqwII2Tjnwy9MDqisv12psjrXyj99+4y9/+ytNArVDuyykACnP1FZZbpU5B4IGbtcVaZ30MHF+fCBNiVobKQvr9cY5n8jTiTwFVDp5npimee9+p0IPQlXXFQhuvzA/GULY2p+O34fwvGKZxdoqiGk1nKbJtGfWhSUunHNnjonrVNCnR7QX5hz5x8vK2gUkEkV5eph5Op/QrpzOxhKckvDL0xP/8suvPJ1OaFCIkAR6Wa3cK8QNuJ3mRIxiTFSMCYu30B6gbm9qHbKataYttXG7rZTSTewUYZ4mW8zMDzw8vGd++gAOiN/FAE6N12/EVV8uDL8cmyOjuf39KpO3h+v3+9ymB3p4bl5uezzOMKCvvjsipYB10oGDnf3Kddy/No5gtPaxZt+qbPeDvL0douC3AvTjbo67G0CSvAqavwUw7Oc7AvPvx8I/t/vtz+onGHGxz/9R6jXWCLfblXXSN/1E7Sb2nkNwP2EJy5TNT6zAUirLWhEitQqlDKa/McPnHHg6n+i9cFsNFClr5VN/4d27J/MTDaiFFCBOGcG6JuVoOjRNRzwl5EkIadgKNYH10bmVtpX3ELxrrTfyMH17JWHg71a6GdTuvd1JkxQIcmhbrQTtXoklZE3MKVFLZi2FUquJvjelFBPMV4XrWrkWZe3BlMBqIwcDuYTGNCVSTsw5MufI4zxznjJ5iqQpkqIQRQ2kia4VGv31IM4C8rKt4PGqj4NeuwFGtfsYc0CrD8kAC+trh5BnzvMT0/tfIc90b/G9lQGKeHXDsDmHtcMBHNjt02E9fzc29/WRzbnDH9s35fDNg33zAXv0E6+BksB92c++BztOYGfNjTXctutxmD+xn/gnS59erUD/l9j2ofDHzvmw6vYH1D3z17txOCTGzaHIISsVw6634sgLzYUORaxEycqfAFEkCUHixnqxiS7kabKBI9YRpLeCcUjYRlTwGlfBFuzdhRqDDnDCtV0QFyi2dnFBDBwhhE30FQws6Q2oNpC7d6Gq68K6mLZIWRdqqfShRfOFE7W/RxcI/NxSCMZEUnVqeSKmTMzGpDHAJu6ToXe0Vn8clom12lJnpABDRd8+4vdcHZwRwD8/0FCkbarzfenbNcZBfwwBSRNIcPDFnt/Yr+rg8MjOj1M1MKDbZ8R1jCSGDQHejJQbcQZ6rN3YNOO+SbLrP2qneEBj3++7SQsBOkieva27LT4IRk0NLaDThKaM9oa4GHKPmXh6Z6+tqyHUMSHZSvtCzWjN+7m6epfE5EaubYLCqlYru2XGBnAZ8XkyamLH7BMT+iyFdV1JUUxBPyVa65xOZ86Pj8zzzISSEO8sACKBlGfSNBtQk7LVOcuuy0CMSLZSjFYr6+3K9fmF6eGRNE32/KwGyu6bxN04/4y1f2j7qnMaU87fDyO20A2i3ICMr+/34O3f/IwH6MGZiON1/+/oJGAB+HZaBpj4O1swztBYGV5iLGoHwPw6ODn++eXCYYCQg4E5QNcUIyGodSVT65SnxbqrpZRoNII2D74LvarRpavS6sq1m9YKJELI1FJotRNjNFHssiK9koKB+b2uWBgUWW4Lz9crf//tdzLvydqIp0ypjettoayFoIFyq4gGpimbHlSKdFFqt+RECIE8ZQLW4ShmYZoncp4sKOvezSMYs7J6IB0ONiEE64yYnI2iLpAZQqC2ylq8ZSrq+41o7dQ80R/OICaE+dtvn8lpAq08Pj7y/mXlUuHleuM8Zd4/npmT6blN80wpN4Iof/vlF/724QNJrH2r6WhVarDW2iFGlAAxMXmWuDsTNkk0n98s2E0hUUrxxIHy8nzl42+fuF0Xinc9meeZX375laV0zk/vSO9+IU4nRJRA37RcxmhVMYHHQN8C8yMkfhyXW/Zxmy7DBx5H/OvFroGGrwfzlgkc+/Pg8q36/vDqb9EDY1b3oFyAdjSoh6B9HPOtJF0Y5zDWDT6ZXycRv/jewR+9uQ1b9NZ7B//xb00cHpdNP92IbT/9xL2f2OfXzryRg58wDUuoayH0Ri0FXQugZGdAC1ZqTreyJrqiFUorLL2zrgWIhJBptdCqEqO4nyiINmO+4Fo3EuhBWHohrpn0EogPJyYaYYpIN1ZMa42IddGMRHIK5CyEaJ1NN31Iwexo1zvBYzxG7P6Mu5pWS4gO6juIMGJ1sI5BiCWPo7NXWleCBqI3QhERtEHLlVqnTXaidWVdKuMpl6YsXVh7YCkVemdOgSn5tUymmRPFxJFPycqqYgqEKFuX3xCEGCdCMn3EFEFw1jieJA2jBMiuY5ODqI26NmrxDogjbgbwREqcTszvPsDpkdIV1TKMK3Yk46MM7yBHw3Y07dvcedtP7MDOl36CI6hyHNr7Tt70E0fbt88rn0temzT8RBj+a/vOOP49ePJn9RP/Tho1//Hb95CqH9gD98Pm6/v7quieW1Y50PPGy61W0hACtp3Yx72FnfjvugE7INnYMdqVGLOLTApaq1ELNbgw19jPMOrilD9bgI4yDz9p8G4a5pjEAlBRtNYdPDgs+nt3RoozedRZN00NMOitbwt/9ZbUrXb7aZ1SrJVrrY1B0x5itoC1sXaUPDjFOydjTERv6bcFqW69VZXuwICESK+mkSJe72n3Xa0jVk4mPFabgSAymCRhA6bMKsjBbtl96R5VttERqxRjFAU1VgkRemB0KOljfw4CGaMkWF1tbwyauTparqqkMBnLBQAPFLpTAyVuC5dDXmUfp0GsrbSfLz34eNIDTTa6DJhlttUjHemWybXSW0WISBqgYbJ7EwJhmozJ1K3euJfFAMC2gloLcBP8dHaKBPs8BlQNkEwdhMRL6XSMxc3mOiYfAAn+US8lU9dfwrIjKVlZ1XSaOZ3P1sq4Ncfh1MWCrQwhxOTZb7FW9IpFe3GYN7unrayU2w1tjZQSecr01Vpe1ijW+t0n9N1T+Kdtz3/yba/V2B9138VCLfAwhziCXS8I/EqW5BjM2lMI29O4DwK66xmodLzrJ0Et8O7i1HVv2zj6j6nb0qD9zguMI43r2XQRPJi4P0ks0bcNklfvuyj5mLYE0G7zPOeZ9+/PzCzU5xuqlUAlSjdcVSI9jBIhodOspX2IFFVu6w1qJ4lQ1oVSVyyzW6BBLYV1LdSmdFE0WQe+RRspCdfbM//4x8osjffns7WwxvTIpjhDF2qpzDmTEha0RgNOe4+0Ao/TiTlNBOB2K7TWeffuPVqgakO8Daz2bhBRMBumwRmTG+PNmUbB771nKEM0nYRJJ7vF7ickBWaZ/XHYc5wmY8vEMPO+Nt6/XPn0ciX4/H//9MTteqG0wr/89a/uKwqP5xNPj2ekKyGLgTCLcpoerDpVAlWAnInR/CfdddyCaclJSKQQ0SAUVXqIVG08Xy58/PTJdLcUQrOOKY9P75G1MZ0fmM6PaIiIl2KNxdoG2mMJlpHpt6Ho+jADAB9jz3/t22cP8YAe/An7y+ClTx4pqk9gZRdwjIQ9lpeDXsEo6R0zU/azG75ct4WVnWL0xZeI72tLXvEmC2L4hV2HYV8o2Bph11wY+7ChEr4I78b+90WEk+799mx25hsLguNCfCTd9sXJWPyP8mZzQao7o+hPv/30E2/6CXw+h23+2Tib3E9MulKfr2gffsJKnSRE61K1+QnTBOwxULpyW+vuJ4q14YbBJLdmDbVUs+uiaOzUrr4eEW7LBdpKpvI0TZYcLmpAfUyoWiI4O3gRUyCmQKciEhGsTD0QCCosfaw/hFo6NVZaCESJdtvCzoCWIAjBSlBfPUvG2AiREHcm0gA5tCmakmMPG4JArYXe3b+qASGlGRDXW+M0Zc+HCo8PZ4JAa4UY4JQSVu7rz9CTyyIux5Ci6TpKR1vFxK/tWCpCHS2wwRugmJBu7Z3VO2qJx8SdgIYERNL8QJ4fqES0lSEqxh0a4XZxH/ts42i7cWPkyga50Lgvkd0/+NpPYMCK387NT0jfPhoI29D+lp+wuTygOt3m+fiOsDNjcD/BAfz5s/qJ7wA1e3hwvMBvf/57n/FP/uDi559fJB2DlH3gfpEB/f6ZbLsTNxLHQ7Q+KMYenBzulYxjhgNhzAPUMROG2JTV/9mT6+N7sovxjX2pqrEeQtg6RdlIl+1Sd5qmG4jBOjnUvG9Irx6erzrzRneGSW/NQQ/dfnpXmmt+DJR4gDQxvJoEsrcgHy1OUwqeVTV0XMKY1GxOe9jZDdxy4AIwRXlvcW6CwZVBARSfhLJ5UL81YQS4AxUfR7M24I29NEw2JlJAhvXwduXbRN60UPaRtp2/dmsK1buBR+Ni/F6/9tl3D/hu4HCYWuMXO+dxDvbSKEVymq4cPq+CaRXZ86U77VJs7BlwhbF+6vjOKFHSHdgbpzlojhqQfhhksNEO9fjySLOOaxDXrPFxNrIEvTVEcNHUyHw6M51OZoTH94PVxIbgpXPOuhKRrdWjIvbM/MH33mml0JbFxmKM1hWmVJpCH+ypca5jwPzcvrvpwTbZbAFkF2l763Z+L/Def/dx42NqxEn7B9lM3/iedA/wZWfxicAY8OqK6VZm77YPH/+yl3gG7s9Rjj9Ht/LmNgIzqzUXD8a7A+AigSBps9GiSq+WFQ02AXwB4JlFEbp4Zwjt5GQMkNvzjZiFLJGyFkopVtMvAsFKfZau1NvK2osBtMtCWxYmEfhgpTs5RUKaOJ/PXC83VIWlrJS1EhMohTgFHs+PiGRK6azBFg2tNtIU0S7OtgHEfIakSEgZEdcsi8aCNP8pVvrEeAZ4WaSSQmKeZsCaVDftxOhjgUiQbN8PwjTN3G43Wo/kORBi5sP795zOj/z++++cz4+kGPn46XfqWoiiPD48ErCEQwyY3lyvUJUJax8bUkSjEKZMoFH7YA6yDbogBjzVbt231tpYW+dWKtfFWp+r2kIqTzNpPvN0yqSHd6iEvfviAVjZWDI6mLGyvd99Stz7iPthqIdXZMQkb82x8T4HnzXmkr8R/MXjlNtZPbLFGyP8vwv1x1zS/bXgn++HvRy3I5sHdh9m5QHqIM94ZT8fOTrgV/t7M5DW/VrH/bo79zfO6bh9qZXi13+I6V5/9s++/fQTb217+cuQYwAr025qzcJDiPd+oq300Un24CeCCE2GQK2x/0ybS7itCyEJkUAplVaryQOIIDEwnyaWrqxLYe2dHAK6Vtq6kIHwZDdnyhaX5Wm22KkVVm30BiLJ4q4onOYzkYi0vgWE43/ahVYqNYjp4Egn5WSC6iPp7LFYSFg8N5g1OtYHHVUDgpLHgIrjGKgnYEEwwChEiwFLtTIwCZHWFAmREBK3241pyqh2ai3kZCX2eT7Te2NKwcEG0+axBbYlcDUEehpJUJeXBC/Dt9Kq0Tqst+bnL0iIm2CwMY2U0qFpIKQTU34gnh7pGmi1WULBx4lsY1887h+29z4W3+05HO3znQ33f++KeOTeHh6/t/lAGbb3yKzcB/oXfoJ9TTDW0SMuMj/hz8xtaPB5+S2B8D+Ln/gPYNQMY/M/w/bWE/ln9mdoXQiBnDMpZQZaB5hRd5S9ucBSJOxGR6Jn40w413ZpJUghG/17Y0kAA7Udi2W0wxEgCsG7aOyDdpSZDK8n7CCOLYLjgUJoHzNHgCHR3tZvgEWqzTrzVOsE0ltzzoTR9GrvLOvCshbWtZLTRAyRnEyEt9LoXoeaciKGSJLAlJPdw2x09DRN1vZ5a9UjDnRYTW6cH4gxI3Hy+2mWIsSb3b8U6YV7Zy3DqNlzCSEiedw/uyfJ9We6Ol2zVi9nK9buOUUkFlLO3ko93U8oAUaXrjZahYs9Fwe8Bvum6wh8DUTa9AL870FD3ynww7DpUNnDwgIfC/55+3TzEWClZ9bnaTgWM6xhBCHe1tzRDvDFozGZnPLvjoOgGyipfYTXjqRLtAAmKEg72PzdkLMJWPv1YDW4NKWUxrKsJu6rtkAdzblTirz/9W/85W9/493Te9ptQaozvJJpalhns7R1OQvjNgzzHcY4glpXlsuF5XIhn86kZOyZ28uN8vBAz9laEY+pxs/tj2zuJ7dF58iE2O9fv5t3WdHXTg0Dv3uQI2lgd/awB9p3YYrs80Z217o5b7lfeI7xOj638SIPrx3Pd1B+hxN/a+t+XurXJT7/zA40ltsLKdlcxGniwQdwaZ1e2QKy2kzMG0nEGHh6eiSFyMvtRkzCKWQDzBuIWoeorDCjhGyZQ4DaGiEIpVQIkefrguonbmvl/Yd3zPNsIoZeguR6kaxroUvknIzJ8vJyIYdIWVfmbIzPFBLX6w3RzumUCdIprfA0Z9N3CdHXUqaT1kWdum6lwdF9hAik0UVElRgTU0o0TPS91oJ2IYW83dsUJuYMpXZua+HhPPPw+I7L9UqKkfN55vxwArFys8+XZ7+Hwsv1SgpC02YZYaBHCKJINCbmeJZNOi0MgL2j6gzO1lA17auXlxufL5XrUmk9ULuwejlqenhCphM5PyBppnobRIsZ3hYz3PTqZM84bgHeCJS/EdRsuNKrMTy2Y5mJ2n+2946Az90/A0zC54fyajL4O8OPj3PVY8D75bl8ce4eS46F/Di3cT+CA/BHu/G1YHebt77fEa8LbEzn0TL8e9vrEpfjvoGtu6V6E5nefnqTsf30E/fbnZ9g14AyP1FZlwsp9jf8RDfGZO2bn2htdNtMhBh4fDSA+nK7EpM1amitmx6jCoFEVmFGIZomiqqVKAURT7wGLsuKIJTWeXp8YJ4zTYMlpxGMZN9Zl4oSmVMmSDIJhXZg4nvzhlYbRTs5Cq0KVTrn2fVfUtzjTRxIQYy94c+2G4+IFC0hnMRYmOJd98TPXbsJD+PznahMcTJb3pXTFMh5Zq0V1cj5bMz3ZblRa6W0yvn9E+IlXvasncU91hXi+jqiqDTTC6VvchWGNjQzBr1v2p61dUrr5m8JlN4pvXFrgRYnpulMOD2haaZ28RIwZxyNGzGMqpnJ7TqPgIKBFTtgMoCN43gdY3ifF9sb+5zQ4/d29GKfY/vxtv1sfsJZKezrmgE62rEPfmK/lM1ObOvar2x/Bj/xA0CN3zH6Nz7z2v36q68M6o+zY8b+nMbEERc7nNkhmHnruF/7/I9u9/vZH36IiTRNTPNEiMYsSMm61IzgZBzLBkjcjHaKyVrppWgtuqOh0K01z+iLibaKiy86cDGoYSMA0sO1H+/vYK2AM2WcCaGusm6ggBi7ZiiRB0FVLPMXjd2iqkjvtGLABTFAk4NTMWCh1cbqmdzWOuc5MaVMzsmeXjcDlWImBhPdyjFsNMl8mkkO1EgKkMJGI0RGqVgnuMhkbA3rGYrf33FP/Jn5f8YkHRNVxDIH8QBs4diH+kzpYiUAvVfK5UoIVwMDckanmZiz6Zi4JQnRQCdxNpC1/Kv0Vqxsyo/TWjNFcwl0rXcTdjB6rC0744RMN2VcTx8oh7rF3EWI7UzsuFvLcPBFTzzYQDWxMi+HUum+BAE0eHYGSMkWHu5Uelc2TMfpvkZLHdS+vt0/FNo4t2F/x1wazwMQq/zCSpcmYqrWon2e+etf/8LpfOZ8PvPrX//GaT6RHOiM0bT+BRPQpgtSqzsDbwS76QpFayPu2ajr82duL8+stxtpno1Fs1augJ5OhNPZ7+Uh0/uTWfNj2+vMAAeHJPeW+1vZkbde31hZ7rGPzh7uM0zOL7PxOWwAYxweMisehA+7OmzFfr6yZ1O+dsl+/K9F4KNLSD90tJBR5hk6tdzoYn8PshmDYcahzfKwbd2yZiFakkBbo2shJqF0ZVlXFtfFCiExT5OBr02ZotCnRGnBg3ljuZTWeb7dKL1DSjyoGEtTAvPpbMKKvdD6yul8RoLw+flClsD0MPN8u6ISyDGQOoTSyWksOAIpJxomHq4qpJjRvgtB3hUqiGUgkz+7gJfKbI/avhMwv2DZAmFdF9aycD6fIdu9a61T1hu1rExTotaV0+nMX//yF/7x93/luTV+//iR909PLLcbp3m2ctqmtF4p60LKgSSJJkpoGUKiaqNSsex12HQYWuuUWliuK+va+PR85fPLQswnq75sjdP7D5zf/QL5jMYJJJEk2sKJXdftdTA3XtvHHA7Eb8g3Irw9DPXLl79g1IyFJDZv9wPJ9lxGxHwMpcfvo3mqMhYF+8+x08er09rm8+tzOp7bmKfH6z7E4ZstGZ18vpWRvAua3R5svx/u7+tg/mv7Hfs7PrfxuZHOGHR56xn8c/vpJ77cgrPsdfgJDCQJWMenWm6Og+pOSHbgw/yEn68EAwS6QjSR2+xahL03YjRQfC0ra7EuUCEmZok0Bxd2PzHAFWvm0RQupVjfipTNf8RuHTjzRA4QtaFaCTGjGlnWSsS6QK1lMYHgkI6h+6bxiezlKnuJi99jwdny+3OJYrF1DIEU4q7nKdbeOno5la2ETVuytYqqMk0TiCUtht6k4Mwj7YQYmOcJ7Y21NNZ15TTP1N73UqtgCVAdJXHBRpX6+XfpaOj2TL05i3ZLeLc+qg+UtdgPklEqt1opMRGmMzo9oPFE10TvQ1dpL6EZg0sdMDmOzc20bkNONkBHhmGFDUB50334XBi7jgEKvAABAABJREFUMT/x1mgepbh2J+9N/s7yCf7X7icOezkCoAe/YJ/V7e8/s5/4JlDzNSDkR7Zvf8dv5FhVc3wIryixur/6LUP97WPvC/l/+zaAI7xjhXWmGQ8txq1SdZwU93j8eGCudO4L99G9aBwBMFFi74Kxdefx982u7Rmtu+8JvkB3Ipz0w/t27PGCtXcbAsbbKUIItlAf/9sWEXiAPdgnewefWkeNpQll5pTIMaFYtlRD9xZ2wUXAwg6cpOSslbhNWJsU4X7CogyGjWjcXn19f8foGYygYcAk7IDKHQ1NFVQI3Z6ptSQ1ambHWFG0ivTuLfwE9TpaFbGW554BGKCIgAMm/jm/b3uJz/7Mx7neh88O1si91dpHweGZjgsZD2kYQBljXjbxXX/AMHq4e1SzGf8N1fE73nFn5OM17OPWFkuHbIk6SHQsZTIvuz2HzWwHXABO0GRzIEYDLp+e3jGfZubzA4/v3zPlyTqcSXCQxq5et2NtXsrOzdX3JUUby6r0VlkuL6zLQq2N85zNefdOy8k0enLegJnDXf+5/cgmPupGcAWQ4gY8bs6O3XbBMSi7v9tysHdbXOxB9bFkUDBxWisvGqbj+F0DIEfZ3Hiu2/MN9yHKHpj4sXz+b1kfhtYYr753f+6yGQFAjd1msZK1LD2fEo+TkFqhqmuDqdCq2dwUrZxz1FXHnFmdMi2qrMvNx3JFwVtVl01fYGgITDmyrFemqIQpcVkL2jspuk5VsLapbSmUv//G43VhWRaeTpkpRs+8KjFkS+ii9AqPTw9UArfakLXw7uGBpsZoyVOiNrd1KCKdhWqQzGSJgl7V7CaB07QD8iJCSonRIjcwSlrHGPBAq7l5CUKIidArIQaW2w2zDY3nz5/I00SKQik33r9/ot2q6Q88PgGmD/D7p8/09juPT088PT7S6kqMjSlY63BxH1+7tXVtytZCu4mxUa39q/Lx0wtLz5QeuC4N03Do5Jj55de/MJ3fIXlG1TvnKaRgi4tjwmX8vvn5fhDoPwa121z5ShJtj+fvAtB9vh0SYZupVqLK1k62HALlsW1dBbE53wVPJG0RNcZSPZLfD9nJYa/HInNMlTfsQNgW0xbs98PJHO/Xa+2C47W+vq/bvn1/ejzPwz5Gu9Tdf+ubx3v93lvf+bnx00+8OvfhJxTow0+YoyANP5GF2FYD3d1P9GZ+Io6Sfz/nmBNr3f1EWW+s6+p+wiQK1tKoqk7waEgYfmJliiA5Iihr101zU13Ytq+V9umZtTRabTzMgSkES7yhpBBpHbSaMHqc5419LyLklCyG0264kqp1I1SlNisb7WpJ4xEfiz/T5A056AamhBB3oMbj6T7K6LzkyIAaZ9SEQGvVY/xCECstK2WxZKyYHk1OcfNdpstm57esBdWVaZ7JU/BOv40Q2QAMhi3RwdzadWnc6NGbabpVTZQmrFVpPbCuxpBKDyfi6RHJJ1pI9G5zYpc52i3qttsx7sY6Yv/P/dpu217RHw4AxJiXtjR/7SdGmG2fGILPSKDy5SYyKknsHumdn9gWSnd+IrLPiZ9+Yt9+qPTJjnNUxHoLDPmx7fVN+nJZdMS0v4Bt/ujRvvL7P7O3nZ4I0cGMRgiTBSe97wwOEQNa/JpisByhwibYGzw4tbIaO0pMmZjiLpQaIyMrO/63tRZWa9kn0VpYE4PXsasjyW0Dh4JnYpv1q3NCzVZkw6gXrNVqWFXbRhVtZZRAVYqLkJW1UktzEWHIKXOeElPOpJyp2omOZIcYNrHkIOKlSMFKimLYSsa2QTuAFhFCCmjAWBRNCWmUqNxPRtnRP78i20b3rODU+uCOd58kBmzlnE080vddSzGq4iL0uRFSIdZGnCaICdVO6f0gcOznG4Mr6GNgQW+E5vdR+3YPQhhdvNhYM8PGdgdejrPBZsrBUDsIhO/TdrSXdinAaHfbj/cq3AF92+9jH0HQZgCH1mpiaSGZNlAYGjiydQDT1kxArVn3Gm3VwBuRrTOUuio/IsZCItEThNZJVwNpTvPM0+Mj53fvOD+945e//pWpd2LrhCnT19X0N9SdfbZgJUymuB9SIuZ5Z6EBdV0otxsv//gHy8uNXpWYMlXVnMvTA3I+IVNmq7saN1v2kO5nwP2NbTgiYRfzHn8fxu9bDMtjhuFLJoEt2PsICu4PZ9OLzXJZaRGe/TysLweWN76zZ2DufQ1qAUXwY7RDQCGv0qYydsQI0F8578Mx1QOagDLHyC+PZx6zotfmVHUPTGO0IRgGqNvp3YLMnCIVpVQrFaTDlE+sfaH1StdAiMlEM7sHP70RtDJHA9Bb965847KCdWy6rdZxrbtfSDzRU+A8TaQQSZOVCS7LQkCs3auApAmNiVutdOBhmtAeTB+hG/MNf3IxCM+XhRzNP0gfQRKstZg9zNEWEa2RCJblFEFSoNXOWhZSTNaatujmMyUG1lbABYy7dJblSozCy8uVECMvz5/5+PmF3z9+5Hq58vT4yDRNhJhZ18rnlyshZXqvPOREPs3ukyJlVVpvm77arVvZU5RA61AbrBWWAp+Xlcu1clsqy/XGcr3y1//tf+PD0xPTw3tuLbBU9TFpQFZETcfo1XzY5sghuTBAnX3Y/hgNexuXvrC7+7aOuagGvm/xi41t7457WPjuZR9j/oxxvAX4cozrtoDpbrvDM9+wr4flw34vxucG6vPFPl/Hl9+w3YdTlFfffb19K2v6+vijOcIQdu79p+8AfvqJb/iJ6ucnIRDozCny4fHEUwa9VG7iWlViMX6zk9j9hBpYcfQT1v5ZyXlm6VB7pWOxaveYU1WhN6I2TklIIVkitnUaA8B1Nk71tYOCaCfKbN0yYyT5v12FslpjlRCanXNMSJRtXRJHs5NuZb21dtbSCKHRe6DWYpUHLp+Q/L51Z5WMSgOLkM3+W4MX1yLsDUken/ZuOmLB7n9XA9yDdEQ7tRRyzpR1BREWEZalcLvdTGB4no3BinUi7Es1pow2YmYT4qdDr+Z3TQmom7/1GL53oavQurA2uJXGUuC6dMqycL1eiecHHs6PxIcnVp1obTQ78ZhXDqvhw3Acdnq3p+Lg38GPvBqUux3ly83n073NHmsr9xMDyRy+Yh/md35izJyx7j36CfmKnzi+sl+fbX9WP/EHNWpe38L/ftu3bs5/l+MDI8I1Q+YLdtkDn947TcyIJxc4jccgqzcboirUHlixcZRSdHQ7Ovzoi+Fg2jVjAT3WjgYMpG1Rj7CXPAUfmKpY+q+ioZsql+BosQXQo6xoC8gItvAeXZe0e2cpu47iLfbWpXB5vnK9LaYs7+ru8zSRorWxE1c/Hzev9eqLAwOlhoAwGCOjdxMjDmr6Ka03QqkQKpIaMakbagi1MhbijrywdUUaEvvCBvaAC3ulaNoLG1ovTg21LkVVzQlozkyP76jL6gK0V3StRG8v3Us1Mdo5Q8oGpNW0Zz4HoIGivRLT5OJw1bIvKdu4QVGtSB9Az17edtzukPQdXdnfVfYxIwdDqX1zyHhGfrBMNobPuFfgNeJ+BiEQUjY9IHeMHUVaw/IFmZFB6v78updn2N+H+lO/1ymOsWltFe2nQWtMMRJOJ0KOnB4fefrwnjkmpFunApkj+fToFqgTJBFiJs0n0vlkztqZP6rmJNfrhdvnz1w/feTz338npok4nWiqFKDGSHj8QIgTQa3d7t29Hnf4J0jz7W17xrv/HpsOpz/+frUIPf771uZN83wfr4DLO/8uh4D/GFS/enZbUCFuQ2TT6RgZqT3QlwMov1/qCBwO4bcHSntQEH0BrSrezd7ECaUXlusLZyKtLNR1ha5M0coARQu1F3pvpBCJOSDBOliUdTUau2uKoa5LoIIS6d2o5jladlBUeTyfqK1zWZuzERsJLylVW1jMOTn4qbRSKbW6DoyVfZpofAeidQNZC3lKnB7OrGXlen3hr7/8QogJM80GQOC2oK4LT4/vQJXTfPbYrHO9LjAbNZ7eqb2Sz2fLkkYT8u2YAGPpjbXceEhnSHC9XAkhcTrNxOxszZhZrlcDybWzriutF5TG77/9xnUpXF5euN1uzKeZ3z5+QiSw1MYcM8tSmGYru9WQUIW6dmpRbsuN6Wwg8G2t1NbJ0wRdKWvjuioaZy7LC7fiLMTWOKXAf/n1F359eoLpRLkaKGUMYXseFvzuQM2YJ9v8cB2xtzd5CwM5DP83Als50LVhy3TaQDYm6wBndCwuLbLe5qJlLmUXWzxM/C1QfmUXth+fJuHVOX13G8C5fB+cer2wv7M7X9n3txYDYz/i/u5rm2W/75cOowzyT7/99BPf9BPjvKKA9MJ6vdCJtGpxKM5yieHgJ7SRJDq7ZvcT2ptpTzY7X9NoD6gamBJTMnvfKlGVh/NMqY3rYrZT6AaQDD8B1vwDY/iVtVJyQmInTkKQSO0gZQC9sCyFNFkSrrZKr4WHaTJ9TjEQpTaoVSnF1iqnOaMBco7YGqVTS4UUjBnUG12VmLOtNURMDwYD3rqvNaJENBgTJohpZhL9tvduyejWab5GMdF3WEullMrttph+Wkw8v1yQEFiLJRBCMSZNxFhQqlgXq6LUWhHvWLp2K3WKIUJXauncitI1c1sLt2IsouW20Fvjw/mBp/MDLc/UMuyl+VJTbxTureZxXHE3ru7nywBYuPv769ur97a1FpsNHuuOUfiwve8o7GC3iNi8GczLo17TTz/x437iB4Ga+wcO30eNfgxY+f4C6Hvo1f353RvLHz+PH9i2/QzdFPXONI7s+uK3d0XDoDKNxfXgwZjhVw968DrHITi7TwS9P+5ALbdJsr9ucdQ+2HUskMci2U/DFuXj73Fs3VrGbud5YO2Mhfd4zbo/OdruP72b4FeMkewZTmVnxYxFO4bPu2FL23VbnX/bgJrYDekedZ3aG61VpDVCsPNo7Vi+tItEbbo9bJfjTwxn8IhrCh3dp0+Xrghtu88xT6i1QaIMhfzWkHowVNUD7HGQpujWgUo9/en6LaJ+Pg4ejWeioNL9Ge5CykIA3WuvZRtHh6Fx+G3MzJG12bRqthsg2w3Zns94O4zvH9lM9p293GlkS7sPnx2gHC3QtW/k3X1MbuVVI5LZjb46SKetber902zaTylnoyF3Cxpimogp+/mAYC25Q56sfTkYe8hBvlYry8sz18+fuHz6TK2NmA3gbKr0lNA8EafMzirz5yp3IdxXrdT/aPD4f5Zt3AbRQ7ZlvPetL22e+f6e349x+yvoCEl2Ty93v++7G7u3DKUFCmFkpoQtk7ud3ziVV6b3ePKvs7uCbJTnLYuq+/vBs2Cb1ooqQTspCadsdPN1caZNHGU+FgQ3bSZmGyyLqt2AiqMw+e228rysPK+FtTUTlsQE46MLmRvYI4hEWFbQxjxNJuRdC0rfSna1YSWCi/Jyjfzy7h2KsJRC106aMnnKiFq5KxKptbMshRwSa6n8tn7il/fvmFIkRSFIp9fuGgjCWiuX9cZpmtDWPZtkNrTUwsv1xilGHs5nqnbauprGQWu8XF5ofaXRCCSu641pmpGqNGf4TF24XK/8t3/9V+bp5F1chFJM6P5yuVHKSqmFz5+fSSlzOp14enqkd2WphTiZRs/L5QYqXF9WIiYkX26NVVeaKNdlsVKvPHMtjU8vV25r57ePz9yKMs8TUR+Yg/Lr+yfOOXPrilYrrT0Wo24sGe7H2xibu9W3uRVCOIg4Kpuphc3GbyP8OAHHvrbhuqmUbQGxHGKQ4zzBF5Fjym0hAwe/hvmSfT7rPsHY/c/xvL7U9/BjH6/iMFmPoe0Wg8r+nePlhgFEHRYDx2OOpfpesnW8UX5f/Z5uIILIF6ykLSA/7GbcT3P9349z/wzbTz/xI36iE1Tv/MRys++G8Iaf0IOfUBOpPfqJZVl5Xgov7ieaAy+9NqKXwPberLw8Ra5LQbQf/IQlF4cGDN30XhZVrlnIj490xFpMq5InqwLo3rBCOmhtxlwJ1kjitq6cpmwsbQAStVplQs5KaRWCiR+jnRD83gRj27R1JQchpkjD4scYDfBZyoJqQ0URDSxlJYZIVfFEOYSu1LVwebla1ULyUvjWvDysmI5MVy7XKzElpjwRvSxqKStZAkkTt2VFm1KWjqrF7W3tVG10UdZSkdAJElhL5+VaWJvw8eXGsjbEEfHzPPHh3SPTNHNVoA2wY7AX2WzZNsZejc19SB79hFki9XWH+AA+rivE9zs0xrZ96d0et1kUHAAxce59XuxzRDafNKbvOKeffmK7BX/IT3wHqPnqEoVt8QV3jvpb23/cwuYwoF6dxo+ASW+h99/aeuu02sgxb21GwalmXU3TNYxyj+YYjNMuU/DaemsZh+CBrB8/qPNdTOy1q7drHUCNK4kroF7Ks618uy2aiV7qlMJGb9wekZqOgbW8wwbmaKWtQzvA7kmtHQlmgIsbsVbb1pq7q+nXppTIMZJjNBaOt6XGwZ1Sq+07KaRO8dKgWitlXckxIdKooZDq5Iyh5tdfkVaoxZTdNab9ntjD2ACdAdSYTWr3gEMUJA7myjA8du2mPyNIG8ZMiGmCOCHJmCJtudBaIQZBQ7R2ubVaOZuCBpBmWWk7D7tP0kFj2+jkANpcDHfMI5Req4lIb6VFav86S4QR3B/1X47mZoyBzUodwBivoRy12z7Q/T1BkpmX7qAJdQdexkdH/D5E0dwT2DkNAG98HjduMo43AhS/NzI6NNk8qrUyTRPzaebpnXWfiSGgy0JolRgg5UQ6nQnRGUxermY+rVu3rmWh1YXeKq0UPv/jIy8fP3H9/EKcToSYTURVlZ5n5PxgrYNtIG3yPccg7+f2/W1qhwEiQjv6goOzC7BlKHvwHFEfc1m+DIAZ/tuyZcMh7hlSYWtUs0ccu9MPaqVE3eZlVECCzd1gDjIcjhfi/swVvK22M2FUPGgawQQGgEjHOp51BwYCMSTruNYbAUhiPzkEPjxO/OWXdzxMwu/Xz4hUBO8KoRAkmuiuGECJmM+IRYkY6F3qQtNG0catVW4d4hwJWlnXF7RGpAXmlIiSuCyFKZ14eAhITNS1kUpkqStNu3XMi4F1qTSUVBqlKXpdHegRQutcLldGeYyVBHWmdGK5vfDp43/ldMrkh7MJobfALIGXzx/R0Kn6d9ZW+BDfEU+/UksldGAJBBVCzHZbu3K93kw43oWNrzfrwpGmicutEbrZn95W6zwiSu2duipVIZ0eyI8P1OKLoBQIpfB0ElqFf/x+oRL421+fyDkyR2PsfbxeuN4Ccw6m8VAbLy8LaTrx8PDIui7UshACtMuNnjprgtKVjy8L/+3vv/P3f/xGjBPv/vZXPjx84Ok08fh4IqWILgLdyp+DNGvvSkKCEqKD9qM0VncLVB1HDgpRLQSw6OAAkogzOIfJZ9T7W8temy/OGZThPizQHOM6+PTZP2NRy12Q7BnUhlHxtyw1dzGuffRYu4+LabNf11gg2Hfl8K8F1kOvADb5/C1bH3w+ijM9VUyMf9DJR8B8Z058fKl6+YTbDr3b/744iur2QYMJn6JUNfbtiNHFf4ZtMmaEJ+UY+gvfasTx59l++okf8ROy+4kPT5wnoV8+sVDhe34iBoJ2orezXov7iV65tcrSIUyRqJWyXtASCF2YownyXtfKlGYeHrwMd23EUljdTwx5hVIsIXYtjbl1elNywLQ1G6x1YbAZOkIUJaXMuq5cLh+txXd+zySR0IVeA9fbSkhK6Y1G55EH3qUneuuEatcbJBBCMvukwrIWFi0GtoTIWgqtNVLO9KW6xprdiy42bron05sKpAQpm5i+DrvTmKLSm/Ky3mgI76YJESVqhRi51YXehcAMqtRmCQsJiZwnY+t0Sx60ZUUlohJZG3y+rnx6Wfjt9890Fd49PPDwcOLpwToTSk6wBH/GAtIRDUiPxnIMnij18Tv8hI1DG3LeVZ5RKtUZ2pg2rlXUE/o236KvkdphfijmVwdbbOggje+MpLGVB45OtIeoeWPaGAD000/8c37iDwA131u4vGE9/yffXgsL/dDmHxdR8pzJORNicjzAkHnxB92xLjg7Iirk6EbatWcIwTovuyCrEDYKVO8GeozFd8ccVscitnHmimUCZIAudoKEFNHatpZwxhIxfLDVZQNwwpQdpOm0Upz63skxcVtvjjR7zWU34cSB0AbYSrwQjGWjBRGrr6ytOvOmOYOnE0O0Vq5gYrHe+QoJhHW1QRkCsViHDRvUYqGpdESSsXS60taVXq1UoGEsnNEGz62IUUBlTKsEohudro+SoBgJoTnLx9q44m344umM9kIvlhkwDCUgBdpyI6RMPp3NFjaBVjzrAXQQWbxOdwhnjraFWFbDu2zR7VxCHKVZejCwdyPXFkviAsxvUeM3fERcYDdYVxMHzQCv7X01tN0JbMwaFLoDgzHSxZ99WZ3JovRiVNshpLYFShLpffHhGKjdAgoJQmuG7ueceHz3jpQTecrklJGu6FpQsTKrUUZmlypITFZK5uO1Xl+oy5X68sJyvbAuC+tt4fr5ChKJaebx/S+QEg1opzPh6R3h4eEw//XVPfyDduFPvL0emke7tNlL/+/wEtt3XtvfL/48ZDXlyw9Y2QaHwbs7UB0H8kXnvfffyzb2l/Z9j4BkYzHKoSxRh9P2IBmbq2PNPPQP1O1MDDDnyOOUef905uE0EbSwT1Lbm2zhvUU21g0ouL+waRBcRyYKzCnxeIpEz4YFiZwitA70aOKO1QPV2phSIubMpTRiisxxovXO4u1JU7bM4svlSlsKj6eZ94+P9Nb4/PmZ0gqnhzMxRl5uhcfzAy2ZOOLl5QXkkefbjZQzMUTaunJZCpKV2+WF08OJprCUwuXlQrmu/PruiZwCKYp1zMNLXB3Yfnl54TSfje6esv0rgd4al9uVR3kknyau643l+cY8nzg/nj3Tp9SlEBDW20IIjYfHM4+3gsbM5XZFa6QnmB9OnKZEXRaW65UYApel8On5mZhXllos8dIrdS20DkEjrRU+vVz5+Hzl+XJlXVfmyfz8u4eZxznTtdK0AK6Txl52Oso1B1Pg9Vh83fVacBbiIajeWJQepW/j2sfilr8Qp5F7EGsB6SGw58CS9vlyLEeBPWDeZtvRf2yUifuF7Ft6AFvAOmaVyH08pgcBeotst30fLtVP0zkTcrAXh0znSOAczYcw9BIOs1COEawc/tYx7dnj3P3BjP/eJQXlYH9++hLgp5+wV3/UT5w4u58Yyzn5UT/RQFoHNQBoSpkHkrGFAgQJzNHKocxPmMA7XdHWmVIipMStdjQFCNlKyVuzplLJykIv15VWPvI4TTydT/S+olqprTDNEzFGrkvlPJ+YuulcLutKZ2KqDUnJNL9KpZZCVGFhYToZeHIrhbIU1DUwp2Tdnnpv6Lpu8y0EY/RMaUKBmDKtKkkC2jqlV/I0EXM00f2lkmImzxPN9dzaWogIbS2EqExTJtcOEliWgtZKC5DnZMLDZWXFwMOlNC7XBWIiOwOp90avxnDqYhpELzcDaT49X3i5XokSCY8PnM8TpymjWulaQYJ3/joCJLJpJt2NvWH/FQYyKePXUbPmH9zsJuKMo/3tzU/IvnPZXpNtn2GAnttJyP7Z43z76ScO3/jn/cQf0Kj5OghjN+3OrP5hlsq3932/v3/vY7zex7f2NR424Joyu/K6E2r2rJQagKLH/b7+8QfaW6NHoXcv63F2ggV0xgLpYKrnipWEDM/jgfqx5AigNwcFDuyIbWEfgkf0ut1L7Vaz2UpxNNG/r7Y4wPeto42s7/vIrOqOTquwLaa7uoilH741K2fahIlrtTKWEGm1IjESa6Mlb8UtFYqJ9Y4SLLqBHW0t9Fa8drVBc3Hbat+1DkCO2Po92oLVcT/sXQ6NmBwIcRHiKRP7CQlCv13pLhQsYCBVN3Fn66olrkwft3naWyd442qJOwPLbqcp+W+t0scbmzSe8avwqz/S49SBQcRYQdscHcZ1BA3DmIexlwHyKds/h3HD6JwgmPPezmlYaP9XdwbNfk2HQP8wZUPw+mY/r14M2AkxMJ9mgrdO30rJVCGKjYvkP3G035ZtvNZ1ZblcqNcL68szt5cXyrJS1mI6G/PEdD6b8w6BFgLMMzJlA87e3O7n/88Sp29vm9bFAAC/UmsrjMBjH+vGi/r6/b33KnhN8/53l915DucbEcuyYLPIGAyyze+w2d23r2Vslo3xeWRpJZo6vVVAQwMZ2LhlXkSM+o0oXUwI8ZQT706Jdw+Jp4dMUAPOB0X9ToBS3B6o1fGzLSfsXvWuzug0IfccJ07nMyFH62TRVj69XFmLBahW/97JKTCFhEpgnhJdA7UJpVnN/21pIEJKE4blWheq6/VGq2XjX/e4ErOxctYKv75/D2EipDO1Bi63wjRXSEJbVhpCJPJyuTA9PqI9cls7Hz9f6bVBuDCnQI4QBV6eXzidZqxbXvfuHX0rg2wuhl+WGyJwu1wptXK7XZmmiTRla71aK+uyQO2mV9CVJoHmLchfLjfCY6QHQUkGqPfGeZ4o60KfMsu6QAysvfDy8Wp6AzEBgZTPlLXRED4+L7zcCrXD+XTi6Xzm3cOJKB3RCkPoOEKIagsm1EotPKFjY+dV4KoYU3Mbm2MUjO4eu78Q9xRDa2bMrmMJ1b5n+1t8MTA+YI9YvG2ojf0tbnhjfnxv/hyD6y8/+OXnRznIoKCPWXGM/DY6+oif1MqG4wjIPT4zbYe7QzGctmXY73ccjn8Knn0fz0GMPczBv309HP65fWX76Sfgh/zEOfJ0vvcTOtLy+wV6/J/Y5Uh3P6FdrSFEbbThJ1wDMIjS6sKny826QPXGuqz0Zm2qc4ioBHo2TbI4/ARYuY4EUpxM16ULtXWut9USjWLIbxEhRgN+1ip8eHpEJIPM1CrciulOShLWWpAOUYV6WwnTZKK7VXm5LGbf4sKcIikCaqzunJM9B084d/FqgNqM4a3QqyWNqxbT11wLOWXXXvOKh2YlZMFX2V29v6gIt2XxZxyN2dqsRCuFQFlXQjLwp6H0VriWxUq+RmJYEsvSqNr59LzwfF1MjJ/AacqcTxNJTHahNys72+QmVV30eITTehjoh9mgbHWr96NVD+N4n1OjJHjDEtzuDnnT+3G2M1PGmsfTpttKQnzNc2enf/qJL0/qn9j+oJjw29tOS9pfe/tBvbrqP7Dvf8vnvwm4vAKA7gbOG6/5t/wDbvRd6VxiQKt1N+pqNOzoo35DEyVswI66+K1ugwVqK0bxc0aMLWxho2jKKE0Ble4tra299shA9rFAV4yV4JSOUa6ioi68ZSVATdkACTPqSimFVorvEwiun+JAwNAV6a3SWjVxS9cI6bq3oxufa81oklWbi9pCrZXaGqVW1nVlWgtCIEgkOlBTYyKWumMJQZAeCbVaEN/MGJvImnXhUByo6Y2+FqNiaibkuD267u39tkDXQQm76WK2FaOyqSPSaZoIMdCnmaVW6u3FuiGpWnahG+sjpcmNgiJMgIFuvTko4cYiHMSGt4cboncIw8ExwUQ5j5T2Q31lcM/vujam4WWEeEaA80UWSjfB4E17SPW+I5Sazo4NXu8WNaiIfQA8bsj8nKyFbUeaB/Yyvm403dEWPUVzgKrQq6nshxg4pWljdw0jIgJxmogpEFMkTTMhJa+VBsXG4Hq7cf38wnp5YXl+5vb8TKuN3pXz0wfOT++YXYNCQ6DHSDyfkWwldhuaprvr+2N9VH5ucG/ZBfaOHq9ePy4agxvHbwPj7ADiiBRefWDQUEemRdRKRzwG2QLmMXnG/P5iV6/O41hvPE5cXftJAjB0A7ybHwoxJCvlTAJ0TkH4MGd+fTqRqEStJLJRybUPi8qgvQb1rn1y4GGKdQwMURCx7GmUSMIAm3K5IDGQc6Q2q5m/3aw1q2jgdDpxmk+UWrneFh7PE007t7XTbpWcIqV21rUiEpmmicfTGVrj+eUCKHnKqCh9bfTSSCFRLjdOp0cHXTNNE2uzzGHPnb5Wcsp06ZAyv3+60Ar0/sL1ckFEWFvjYc6cpwitEFAkZmJQRhb6er0y5cyy3EAtS9q7klNiua6028JaCvHDxMv1ysv1SiDw27/+g6jCKSRbaMyJWqoJOS4L8zyhp4mX241aCw+n2ViO08xaCkutTOczy9q43a50ddAHOIXEp+cbnc51bbxcb4QQ+fDuiV/eP3KKgvRKUG/9G20hEAMbIBLU8fkRb4yxdjf47+fN6Jgjh3nTD4C5yB53DPz/GFxulr6z1XPI9rMH428FyK/nydfjpC+3tzUN344Hx2dHK+Xjp+0adr9p8737wtxX2Bt14pA0YPvyFrzrK7vP8Wx80bJ12JKhLQh30fsPxKc/gf59++knvuMnHk8kCuGVn7CB+oaf4Es/EYP5CUSIEtxPFGrrSArkHGjVROyXZaWsK0JgnmfmeabWxnVZCKeJPvzEYiCOCf9WRBLTlDlPM9Ia19vNFsLJOkrVolALkUipK3k6eXI5IiqUJlyLMXSsmUSgKXQCny9WWvTysrKuJr7eOpxPmVMO9FrQ3jnpYCia7lcrlRijN7LYS1xiDKxroS+FtVbkMVHXhWUt0OHl8zOhwSSR2hs6RXqrXJfCbSnEEMlRuN4KtRTmKUMEScn8RCnEPNNaZ6k3I7LE5IlI4fOtUju8LJXnyw3tyuk08f7pkTlbly9bMygSIYpYLt0HoiUpdOviZHZ6hybVf9+UFg9+Iox5o7rNsTHv3gJ9fCRt4MlxTg0fcZyb/95+YqyfXr3In91P/LsANT+2/WdxVl6CIYbJSTDq3chMBsVUvnd3Y1jLoKW5TorEvUVya8qqZVusJtdRsZaliZAzg7XU1Ut6cICm46Unjm2GxDRNSIo+yASyUd7VKT+mwO0dNZxGODK1doU28FprdLq3Ye60YlokinXr6a15+2+oWCtZ7Z0+hIrVavWal2vV3p0oUViWBcFaescYaV6CJDl6kGkmIXlQnrQjMdK8FV935kxdV9Mn6dW6TA1h29pIp4mEqazXVlEgakfJ7lSdXkhHmjF0RO2ZSvKpIZDzRJ9O9MnbVfdG05sBWtU0bExDwZkhYdSYJgNgshuUZuVtqsnBDRMn6+qO98hO6iZsPACcexNh526Yi2c8a7EFkQMnG0Coxj7qzkBBu43FKPSqBnjVatov+5C1e1gKtO7lfG7wYrQ28EOgaDDGxABE7daqt3MAxUJAUvRW3YJ2ZX4474h4s8zLuLSYE/l8Yn7/wVq9p0TKk+tBqdNKK62saKlo6dBAiEznR0JMxDzx8MsvRDfKz+VKPz0hj0+E09lrT0cUdjDtb/uEn9s3tjFmR+ZmOM49KDhaQ9m+cwzOv7ZFZAtQQjjobWyb7sfasq+4Y3URwuPJ+Ba2bx/2dEeptdpj2JkK6sEw6sETIBItWznNnOeZ0zwzT5MLCDZmgackZK1cXi70psTZO/C1tjEBpXcTFRYlBguIR2vOTvc6fGsol3MiTZk4z4TbjdtqoPnl1mit0CQSEbR1amuknGhaSCkwZWHVRkqCrJ3WVnI+kWOkRWtXqqER6EzBWWwCacrO4AvEIKSYkS48P1+Zc0KIrFVRjTQNNI30kIghUsqFmDK324qWK4jQCFxeLjzMGUUJYaKXRhCony88Pj7QaqHXyjxllvVCnhopZdpqHVBut4XT2ezIdSl8/P/8/1ARlnXldl14mGayJIoIVYXn60ptnb///jsPD488PD3RtbN6R5UQopeuBj6/vFBqY5JETDNraXSxNuO1w3ItfLzc0C48v1x4eXnmLx/eM+fAHIW63phTNL+EsjESR+ZSAuK+LYaABtNPGHXxGxsSrLTtbsTbuBw0dJGwzTnZPiF70Mge13vUwkBzgs+ZocERgy07G/rdAPsIvhyD8vGzL1z3YP1+6t6Xnt+BOfs0/GL/R+0R1BY0ngOn+fWFYLoJ41yO9uZoK7ZQXqyb53HxMjQE7q55xN33r969YqzQvolJfqv7x59p++knvu8nklauLxf0tZ/QIc7bLXF29BMoNJMFCCGOhrFMOZFyJkwdud1YSqOtBz9BJCGs3f1EjDSN5ieasGgjup/orZDTTEmu8VILhMaKksVjPIGYs4fWZn9iSIgKzy8Lc7ZSp16UqduxGtZtMxBoy0rKgbpUtK02J4G1LDy07kyFZEzM3ilt4TRPxqhvnSkn2m0h5YmUMrTOaNee55mmyvW28vm6QBBKqZS1MsVEJkAwfdHrrdK08/HTM/M8k3Kmtk5ZV9pgxCeBHrjcbpTaSD0QYmZZG+pJ9tJM6P7j5UZvcLneeHm58P7pgSlFpiT0UiAFT+YOYr14A1cxsKaBukbTJuDreIOVMflc0TfhjA1gGd8doOQAMo66TmNQb2yw4W3cdwz7F8W+1zjYdjnO3MMZ/AE/8Sag8dNP/PcBasYi759hx9zv6yuO/995e0vDRnX8KL0NvQ9xkObAUrCzRdUAEdMq2QGM4wizch4rE6rNuiOJYPo1LtwbBuvBGTEgBpr0Tl+LL8AjMe20PRlctjGgdGdEDDCmbwrxh8kUxASs0APtzvVF8Env4rHqpU6OGdFqdaFha+Xd1ByJWM9u6/ShSq2NEoxRk5JRGGNMpDJZ6ZMzcbo2Qg/0JgY6NLsmbdVpnevWGrr3ag6rd2idmJMDULawtxrcZs5TvIRmILi9b8wSowF6PtffN7pdJOaZNJ8AL+tqFW0gamBIDIGeIkIyORzERCP1aIz8R/ZStWNp2qD2jQE3OnbJABXETDjoYUC6YJgpBg/btAfr/jkZr/l3h4DXdlqKHa8rQ+NnlBkNpP7u+926LPUDcIcDjYhsbeNlWzR4MBWDUQu91f2RlRdSNGc7z8Rk7dxNQNgcVmvN2qZ7ACMxEKeJ2YMDSYk4TeTTCa2VWio9Rpgn5GStvLd7u82Igzm+t6d39uDn9uU2nNsx2Nav3sY9iA045fxrmQTdnePrY9n76gHH3n0AH7Z90Ne3L/qxx/9UthbEx30fPz4ovvgxuyo5RRMNR8gx8f7xPX/99S/85ddfefdwZpoi2ivoQugLoS70qzG9QluIIaGtUNfF/YezIaJlByNiC/eIgcDaTJDc2TcpCxIzpYH0lRCEec7WurQ0QsxEsRbdQQJrLcQYaGp6TyJKjOYbYgokLyl8eDiTM1yXFVSZpkRCrHuFKksxmvcpTy6gp8SYN18WYqZr4eVlQTuEp0gO2QVvE0GMdYcmLrcFUuRaO1UXVJRSFhIwT2fW1glTp65mq0MEIZLnmdIqL9crqBq7JRnoXZpyXRutd/7+j984PzwQNdgSQBIyzyyXZ+vCERPzfAKsA0mpnZgif/98IZ8ycc58ui4mPt4C1+tCq4E4zzy/FJpG5jO8XFfqWvj48XfohSSdOSXLhv//2fvTJ0mSI8sT/LEcqmbmR5x5HzgycVQBqKqu6WuOJdqhodk/eXZp5sPQ7s7UTnd1VXehgMSZQOFMZGZkRPhhh6qKCO8HFlEz9/CIPJDVQz1wBTzD3UxNVU1VhJnl8ePHPuCddZmzLoB7OyPszbbZelfNuvnNeRxWez9T1+u80nzAoKnHtKDycOFrvq0m9GvQfTg/654N7Gmna2P/YE5f314Ug12Zy9VX3Pj+gam96VhtYTHvyz5ots0dfL89N1nqf5tXaz5w9mP1tbaopy3aRWopSS2x0QPhyPq+q380m9BuunXcaTEVluE++Dq3jBrbbv3E5/ATYe8nNOe9n3DVdh/6iWydU3OprHasa5S4a36iC1YWOmVLZkkwTUCxjnwuOAo1PnZKEIHZTzjEC6vFki7AbpxAlRCdJQXUvveQE85bmW0TKPfOtxAb8Y6pZDa7sXK/PcEFkiqlOLx6SoaMY0gTeMcwZqa8I2tmGO27x9CZDo8rpKkxJRQtQlwGJs0Mux2CECQQEXCOMRcDrIpyfnlh3QGjJwmoOFyIDIOV02aolQeFYRzJU0L6wHa9Iy4Cvotc7IyNpAJpN5BG8H1gvUmMCSQ41tuRaZi4vLhANeNF6YN1/HLicLXawhjeAtI0iPbrMivLc3W+VBZJXVfP67Jq05s1bPIZ82pBOZh/rZSw+iXZgwvNPxzOn9lOHswVu6arc/fKDD1Yw1zfbv3E5/MTnwOoeZZ6uF9cPX8BI/Xi9se4+tnrv3/a9rzg4HklTzeVNN302edlj55XGpUri6IUnQd1URsMpeiB5afWutlxSi5z++42XEx7RCpYY5RvXxFqAyAs82bCvd60UsCQ9pzIw2AK1l7BxypQJlVrRPYL8hpUi9g1tdrXXMxktgEqYkZZBFxxWLu7PKPkAjMDx44h86J7HCdyKqSsTJPVZqoTFssFEiyLYoBUwU2JYRgJPtikd54w9Ujw+BKJminqTIytJCj1biU1Fk1K5DzVcxt7h5Qq0wN8LpATMk3V+DiKOGuz7YzZFA4Ux6VasgaUuDZesjkBEcF3PSxNhDZNydrcFgM2dJpIzhN8wLmIB3x0qHozEOKeMUCGXRiYZGJv+85U7ZlQS9sUcC7Oz2EGcSrYNs/6Nmaxch9aq+4DgLAZoUM0XIHSxJjVxsFsrPIEYoAJVT+C2iWq5EROyRhYpcz7OKdVU8ZYUE3HqSHZuSny52T3u2VlQiB01qLbe1P7R8TAuZzI40iaLNuuGCDngkeWC0IXwQdjRBVrL5lSovTRmDSLpS2MmimoTmiPIV2z+s+xG7fb1e25wXfz7jVKbi60BQY1Ln7OitAOZp3U9oHIvBgVwRVmdf2WLWoL0hbA748n82Hn357jG23+y55WK1JZkCbYeNQvuH//Ia+/9joP7z/g9OgIdGIaLxmHhCsZKTuG3TnT5Rl5u8EVxUXHNI2Mw0Ce9sLeLUCwRTJ0fUBcZsqJQiIl6xInzuN9IDvBl4KvrJMuBhRluxtMvB3r5tDHzrqrOPusQ+mDRwW6PNGniKpjzIr3wVpna8I5tbIZFRMkplAKxnIZM2FxBN5KWJ2DDOy2G8ZxQPSULnaMJXF6vLTP+0DwHevLHWfrS7KrQvuuEIOQxkznA2OJLPqex2cboheiF1xSW6jsdgzjlmEaiL4DJ6yHgdj3xOWSkB3nT56yHQrdKrCZCseryDoXdustn1ycAWr2xMEwDkyTaTP0RyckN3A+bCjjxJhhGSJTEjbrgc1mpCdyebFjmArLJAzDQJ5GnBa6LrCInuNFZx0Qg8eHUDv5dQgeJ6E2WNQ5wdECdaXsAZNmj1oArtdMkzAvImth7DympQafHI7bg+E/z41rY11gDjDb8WktVJ8TG900Zw7jpWfOA1cD02ufhQNbu5+k8/ea7818M9y8CGmRVPtENetXjn0lhmtwVvuuB+8fFiVXLOvK4kTFii32rkL2O97gK279x3679ROf0U8ER5pGpmG40gCijbErfmKqfkLNHj/PT2jOdNFjDMSBnKfqJ4Q+xr2fEIcj0Adj6nV5YsoBVT/7ia4DSvMTtjgtyUqzsqpJWqZC6JYglswTse5a47hlHD1ajgkuMJTE8WpBykrIIOK5XA+sd1vTEHOKc5ZkGLGy2y4KXewYLgaCF4IDJtPS1GFkSgNpTHQ+Urww7HbGyo4dkhOb9SXbbcJ5SCWxWkZyykzbHefb9Tx+CspuGJjGEUrh6HRBmjIXux15GBmnTB8jOim79cBmGOjUc3G5YztmQp8r0D+BZmNcBseqjyai75wxOV0AFxEJOLyVdOlh59UGe5W9PRRjhcx2bgYHDueX1E5k1d61OUXTZdpPBjkY9EIrspOD12S2ugcW9MDuPWcN/eykueJTbv0EV7/TDdunADUHd+G57+vBv5+2/ZfvsEQU1cQ0DVycn7HbbWv5jxln6iKwFCWLsRBcnQGqFaQomVBV1J2r+gMHY92HSNWInQGVUnVQGnqfc7I2ydkEtJzzlUKVraOTBMRFY/RUpkMIfh5sWrVpxHmojIics2V6G7XLWa2mFutc1SjZORdSVWpP0wguzOyccRjZ7SZ2u5FPPnnK2XrDkCbu3DvljVdf5u7JCaHvKV7JWUljYpCdlb9g4q8IiHMz2m9snKtjx1onegORgArpgzhSyZyv12yffIICfRc5WvQsusiqXxAXS2NqhEBc9KY+HzxuFu21rYEkJVUgwXuIPVZLGmemyTQOpMnQeymQijBNk5lB59BJQIMFwkEQaRQ3gdqmW1WsHrmmeBpYZKBCHRgKSDOvDrQJkl6jzJVs7KIKookHCVKFriu4owXNpqvkqoq/AU65DXTUu/n4VoplLedUHXmcjM2UTUAuZ2tHHjpzhirGBmueoZlxpQKXqdbl6p66iQghRmLXEWM0llJK5GLXmpON+TQmcjLQx/dLwmI1Px/nLRAhF4anF4xTYlsK7u4D/OoYid3BM56f9MHN+y/fRv1n32YHV/+s/7FgYL8wVKPTNVdqtlGvLxz3jq2x+ZpGkp1jH0RbcHHAijo8/+yADw++d9ByEIDM++jBQZQqjGggoYHblrE86he8/trrfO3r3+DlBy/jnZDHNZdnT9hcPKr6AgM6XbI9f0LabqAUvAughWky4KVoaTO50ucVKzbF5q0zId6SjS3YsjUiEKo2Vpx8FWwHFyIuVpH3bHclhkBwQi7WGraLbi5DpRg4MI0TyZpNmIA8oCRKvQYnoM4Cqpwynff1/KC5sN2sjZ2I6Rc8fXrGOBotfbVcsRszueyI3nF+ecnlZkP2RjWPwaMEdruBnSa6RWCzG+m7QAxCH0y7AC0MWhjGHRTrJuictfCOixWb9Zr1ZlO7NAV2w0jXL0gqjMPIxXrNetiipbDqTWssxI6kMKbM+WbDlAtPLy/IpRBCYNFj5bqCdbrabNgOI5sx8/jyD2hO9F5Y9pEYHdELwTmiGDU8OG/Bt4u4sCCwostKTiOFaV6gaisVpsmCtsBwP2aF6gZqJtTVCTIHg23qqNZyJgug94H19XlWB9JBxs8OYfHcYQZ2nhNt7jwTEu5f2AfSV6fWM4thDspKDoJvd3DwucR/fqkGSU2EtlKFjNBeDo84T2058C1XF7tcWXwcXr+AxRLzqVsWtdmbw3f2CxT7kjo/1/Zy0x38k99u/cRn9xPVlk75mp8AUDV5AZhttMdXhnu2y3V7P4EWpuStdbBiWn8lVz9h3yr6QPB7PxGjVNkDneUSpnEiJ7sQL4L66rFKab0wKkvd1j+xJi1NKlNN3N1Z3DZp5vziwjQqu8BisWA32rGi91ys12yGwfQSnRiYvxSmISGaiAvB70a6GPAOYhA6H6AUBt0xTiMCTA6cmI7mKvRstzu2u4GLiwvUeTbDQIw9ISt5mthut6xH8xOLLrKbjBE55SpvsN0yFeXs8rKKy3u861DJ5GrDL9drLrcT6yGxe3pOSYnooY+BPnpC9Q++PdOZURMRv8DLipBhmgaEaZ9f3dfyzADCVbu9H9N64CesTXcFRObOUFI7/e3ny6ztLdfNbp2HB8O+zY1Z5fGZOfR8PyEHk/DWT/CZ/MQLgRppT33/ypXfZRY0qjfiRlbL1dv+f2Z24Y+hoFoZFBx+n9ZrHeUKMtfuRamq0cYosMlSaseknDPMRAhjHnh11diBdVaydso+F3xoNXQOCmSsC5OI4GOsIqtG82r6N6XsB1zT5CiN1lV0rp9tKtUz46ZOaq1UbFtwG+PFO2/deZyxLVIuME3zMVMqpGSL6WEY2G23bMeRMWeWiwVOHIsYKMVTpDCmjMhkAWr0jOOIsTE8U9+DE2OFOPuOTgSc1faJZBBj42gpjOsd54+ecH5+we8//piLzQU5Z7wIp0crTpdLHp6e8tLDhyxWS7rlEj05wvcdvu+REOcEYmufqgqUjBRf9Rk8Ejq7b92S0A2VlWTt+EQVJTNN4zw148GoMUdmLRZ9dfhzqZpJvZPTHhRr4qHaPtvatasayFNFo90Vxkqp55a9saKCcrkBQ5XtAjgXyFn3YJez62j11q08Cc0WFM2ix6D1Hkl9LtadyXPIFtM6B1wFig7px1BF9kTmzk/eW4v6UvZdvHKuoFBNh1n5kt0zH4OxBXzVZcqZoqO1hhdB+wVusUJ8tLGieyPq5rsFrsq3tfulmr+wvfiT2q6Z1SaWOi9E66rTTL8ZPdPXaMHDc+zy7Dv375tK0cH7oTlvY505DMzwUG2Y20cvB5e6V+Nqx6/Zlea6RcnOGFsqDlGHB6Qo9x885GvvvMMrL79KDAvytOPs7CM+/O2PkXHNg6NTJt0xDBcMuzVMI94FQggMWUlSrIKzXm9QIdR5kSkUMUalOQNj4/m2XihVW0x3lJRx4umjozhXyzszQZOBwWr19OI8pGQdMKLZVi2F6AKLzhkFv5a2hi5QxONVyGPCSg8cU7YuekUcm1QYLy8p0zQL4Trv8V1EIsR+yW6YGKeM8hjVidhBFxzrccvx3TtcbnZM04QLHZvLiWk74ZzjfPeUk+MV23ELZI6WSxZdomTlaLVis844caRpw927d3AhEmLPND5lN2yY8oBIz+XFJf1YGCcDmoc0EmJgvV4TYmBSoTs6Rn1gmwofPn6MOMeHH33McrGk6yInR8cgCQKMmkjA5bAjqefs8pJlCARVYr+k66zUSXPBicdl8NFC2RA6ju6+xGL5kJMdnK2fstk9ZRp3pKn6DVtpsq+iN9hGqAygaqugBuF1TFuhg78Sp8q1CSnXgsIWx8x6XNKC7ZpNrzFN0crIvJ7FnI97UzB+8+t2uTXAFqmZ4n1U3roBNvFWQckVKGrnbTT1PWMiV/tSw9gKdgq2cHSyZ8s+o5FweIHX38PAAtEDlhFafVfVZFPTk5q/gii5BvZWFixXVZxvt1s/8Xn9RF1WKlQ/AUHtmpI2TZq9n3CqVZxcZoZ+8xNePH30ZJG9n6jJNxvsgoiHYnqPLjiLAytwsugWUJItQAV8F1Cc+YkpQTFbNxWTYCgi7FJh2mysA+tcumXNIdRZk45hSkwpI5xTNNHNfmLH8uiY7W4kJetatVkn8jBZbDhccrRasBl3iGaWfU8XIyUXVsslu20xraJpx/HJEb33tazpnM12w27agY+M24Guy4yTqZaM0wAibEf7N2TlqF8i6pjSmo+ePAHn+PjRIxZ9TwyBZb+sZXTKUCYmFS52O4YE55eXLLzHK4TOW6lx7bjbWnC7aLGn9x2r0/v0y4ccD3C2PmOzO9v7iZwRjBBg86ZZ+r2fOJwhh35CVVFxlgBq02KP+xz8c8g3qcDjTX6izYAa07cGOXWSXZ2et37ij/YTn1Oj5gpsdfAaV77AfpPrz+zG7Xrp0mfZrp/rjwFhPv9nK+2sMU/0oLSogR9qFrVIqWwZe6IzUFPLcxpQ41BUPU2I2lg0GZkmYitFgfl2F9XZ0fkQZr0VnRe+xmiYhWDnFuIVJW+Djv0AbcJO1mZ6D9QoTVFerBTFV7oeYjWvB3hdKcVKn1K2cpgpWUZzO3B8fEQMkQd3jm0/KSAG9BQUHwPDMGKLd0ccx7lcyYdQsybWHUqDINnAQhUoqbDd7vjow4/56MOP+dmvf83TizMDTFLhzvER90+OeevBA+SrAyd3Tzm6e8eyuroCV2tA65idny3t95qB9qEKpgmhGwn9AlW1zEeurflKJk3jfL+bBgEOJFdH6qSWl9VyKDGn3xDdop49q6bVZwtqHF6bibOWTLUUuq+4tOCnGrs2ZlG73wcACVAXctM8fg+GuQUxamNRi9V6i9/vMpuEijCbJkNdIKppzzQaoNnNOTSzOAerYRZXgZoQa1es2i1rmoxNk8cKXgvOdRXRtnEd+g7xAWnMLrWOUlOZyN6j3QLXLawk60r01r7kgQ2DZ2zm8zQZbrUHbt4Os5ntp/1Nc/JfwObPxz/4fR8ctOMzBxACxk9pw+3689L9szYTaYLeqkbvFu/m2vlcII0Tp0dHvPnmV3jllddZdlbWs1tf8vEHv+UPv/kFJ71w6o01MQyXTJut1aJ3ftYhK2L6M01AW4vRxVWMKaiA5FKBVIe4gAtiZXw5k3MCB8EJeEHFk8Wyfh5jzAQnhBDn7mbjsGOz2RKjMzaiWnAfnGO56JDBWKHdckHRhKiDEMlTZkqm/TImE2Sfxok8TniEPtYSxRgJMSBOjcW22bFaLjm/vARNrFYdbtlzfHSXxWLFbrD7Ok7ZRBrHHYtFz2K1wscezQNalO12oGSlZGMxnq23pmmGkhB26w1xsSThiN0Ri6Xy8ZNzXOiYdiNDtkr07XYDAmmClHZ4v8C5M46PjxlGZRgnihY2uxGRSC6OYVREC1NSztcDhIjzPWk3sVwsCVJQnUgls3RV3FeYg1gt1rElBs/p8YLTe/fI9Nwf77AbHnB+9oSzJ+dcXlxWMf1aBtUCTL3KKgD2ccB+CB+M4WftlIqVpc1/u732gMLcAAP2+h0tWykqz9jCz7UdGtPZCNR7UyerNh8j+2tonXjKDfbhZpu7X2m0EPqZSPSavZGrb17d+VPPq/M/7dVaYf5MO9fb7fnbrZ/4DH6iaS4WNX0+LXW+3OwnpMbkVgpljTGanyg4sjjS7CcSwUHwnTGNnWMcd2w3W6Zodigf+InFooPmJxYdWbOx0EMkTdli/rEwJSupSlOiVD/RhY4QPD4aEIW3pO5uN9B3PZebLdaSJOJcz2p5St8tGUbFqWMYC9M4UaaRftGxWNbEajb20nYYybUlufMd55vd7CcWKgybHaFbMqkQQk/sCo/PLxEfGXYju2xrsGG3BQcpFcZxCxJRvWC1WrEdTXi+aGG9HVD1pCAMo4FQOSkX6wn1gYJnnEa6rseLYgxVq6A49BNgzxVVgheOjxac3r1Llp574x22wyXn5085f3rO5nJTS9v2XYPNT8ywSf2/PusnKsjSQHpasrJdhzRQsvmUvU1VZN8oiWqjmxH/MkLgWz/xqdsXEBO+Cax50b7/1/Fa9gAdqlgrtu2WNE5zG2crhVHUm9E3xp9lI50q0YUZSZsHg3PGnvCOrMo4jfg+0loje4GcM26aUKqi+0F0pcBUahbPeVwI1oZPFe/9tS9ABSFshJdsKG1KU3U81qWnLe61lkuVXNk5FUeIIRirBkfJMI2pYQKkZKRM9cb0WXQdmgt5s+OTjz5hGkbunR4T73fE6FCUIRWSgrLDuWiaBkVR7+lSpq+OyhYEgdjV8hUP4gMXT884f/yEX/7wpzz63R94+vgp648+5vz8Kdthx3Y38ruiLEPgV8sFmz//kNfefI3Xv/IW90tmcTJRUqGsjGWCOGRqos5irB5JVs8bjdXkQsAvl/QovutxsWfYXpCniZTGKqpspTt26xeo1MROVbErkmcQxjU1+XmsWdmS977+DlJkZlWJ2wc59rxadrVuNdhv+jR7mzJD0daqvRwAUfU8aBOO3rOuTFzZFj3CIdvGjmd03XpFUrtUSWX61PNr1Voyw9q6IVSSoJrDCLEz5ovztSNOqXPFG0DmAs5HpmGYmTwipmPjnNRSwUQZdoyqcLSiP7mHC3sW0N5FNuvUzPbhPL9l03zW7XmUzeYpWkeZvQ9uYbnt8UUBL63HcgcZmNblQeqY2nOkZA7Q98/7gPo6jyVHLtb2OmVhTIVpmhimRB4Tr778Oi89fJUYrJWzUyUPa54++oBh/ZgjjezOHTllxnFHGkei9xRv7LBUbN6V3LSglKyz/B/zMr8yHsE6CUoIZGDIlvFcxp7QBcZhYspqoIl4JgJEyHliquVN1DLSvu/xjpmiLc5TEKJ4wFqRjrst4oTgPVqw4DqYoOI0GCjf9x3ZeVxpWmtqkZszPbHtMDJME4iw6Duj47sJ8Jz0J4yjMg6Ji80GVa1iyCDFkTYDuRSOjxfEGNlu1mx3a5bLI9a7iW0qTNs1i67DX2zYbjeMKqRpJI+Z0B2xOvZcbAemUkgOgnNk15HHieXyhGG7Y7PNODexWHouLkcLzkthsTqh65dMY+LycgK18bAbhTIVRCKqEw8ePEDzjjxc0vXBSsyq5plzdWyL2dacB/K4oaQty6Mjlkd3mNKCVd/TuwVBIpvtlu04VY26Nob3pc5X466DqPYgkbKfW4dzxFi989bWq3L1BQWoY7HMi+Sr8+3zzlMFS05cCwFnQUa3X0DMnktMf+/wM59FN/Cmc98UhF8/xk3bVTHKG94/WFk0/SDlYDE032Ra3uV249ZPfGE/kbX6iYIcjGxBLD7LV/1Ewex/0cwidAQXGGViSuYnkngmCdCZ5thUYz/B/ERX/cScDHaeokIUR/MT02Cdk5y3+xejsUWyFlJtg9x1kVIZeqUUCs5Ao6qxmabGupzou2BJzSHjJHMUj5gmmMbCertDRem7SE4KWUgb6+B3dNQTomfYbtnttiwWK9ZjZpuVPGzpYkA2O3bbLZOKaRtOBR9X9EvPehhJRUkCwQuTBPI4seiPGIeB9TahTHS9q37C2POxXxG6FdOUuNwkUEuMbwfIkil4SoF79+5BGSnjhtAFYvDVT1QdGsxGFDXWeB7XlLwzP3F8h+O0ZLXoWfglT+UJ6+2W7ZTMT4hYy+nqKT7dT7R5ddUWthi8yNVP7Xc+nJXsY5YrOM2Bzbz1E/b+l+gnXgjUfJYv+vm2Zmz1mRvwvKz14ftfFuvmjyq/knbrrSzJyiMaiNEEWUsN1g6yV2qvU1kSKloXyZUi5T14v9f2QCpoIPMALbpH1H3VwmnXAnsASLW2V5s7RO2vfWZZtE5J2Zgv+2lcy1Xq9R7eqnZ8q0mVWaV8SobFOqHqJdjI88Gbsc6FfrLuO+vLDR989DGrxcLEK/sOasekYcrEYaisIgdxZwvvrJAKoYtzm1jvjTU0jhPnj5/y9OPHlCmz7BfIyQkyTSyDZzsMbIcBnTIBWIhjc7Hl7JOnrJYLutViDk4NqKpdhkoDROwH53GarWtUNXSh68y5uCa6m+x3LUy5gk1qrCgqNVCkiuZ67Byu1kzObJh9gNLGfBu3xtaxW+ONYFvF8+rYqgPC7n8DQ+qYq88PVbRYW2DNrXRKZ2FpbfOjKHMnKbVxpFrFgsmotWIxwMgdGKSZiou1HJ+PoVXvxn5v11xyFZb2HqfOhIC9t/tVLHtTlbIrgOPmSeic0HW9tf1GjKWgmTRODLsdJXRIt8D1/TwB9pnpPZr+YnP7R9qLP4HteY6tmZvDbdbPuPa5z7odzgcBG/I18G5P0uqya7mpYPNwvjYDRUspTFNtSxoCi97EDMdhIqXMME1sU2ZMVj4zDKOVUN65x9HRHQRfg9tCHrek7QWxTOTtwDonBG+ldznjYsSlQEJIxYFXo4PXTFrr5KEVrBSxwMtXFiTFWC0lZxNAD/ZecILvA7FA1oAPEe8C47hhGDOpZMZxoEwjinJ0dISI7ktvxZlGy5RwUvCuMucQcrFudi70M3jrHMZsEQNXRJVxNzJMI7vaoaPre8uYOmdZLx/Ae7uPZ1u2LuOcr1m5SJFCkcCQhfFyR+c9OI+uB7ro2W5Ghu1A7I4Zx8JQHJshERdHfPj4HDSzS49tMbIdCV02HbEoTNsdUzGh5VyEzWZkmExfDdcTOuXjT8642AwsVj3iOlbHS3bbgZSEy81E8IGcC+vNyHYYCV1H1wU0WzY6xg7vhOiqPo33+MrOlDoYt+tLfvWLn7N8tOHuy2+zunOKD45cFO87urhknAoyKU6stNVxoD0mYjZ4prK3wo4WLD9/HolczYYeTs4WpO7Fig9Am+qN3LVjf5Y4rR1DYGYIt5PPkGQF/nW+lsM5vaeu3xR8f5rdsPmz3/+zXPeVc9zwfZ7dyYC49rYtKurfRfffV9t/brdbP/EF/UQbw01CwSaHLdCbGHn1EymZ1qTz1gHWS/UTXSCGvZ9wLjBOG0YyacqM40gRkzA4Wq1u9hMp46XgnVLKhCDkImimAlIVMHKmUSMUEzsuyjiMjGliWCfUObq+w1c/oWK6nBCYcmY637F11mpcRYwpjZLx7LIwrkc676yUR0a6YH5iGkZCd8Q0Fabi2A4J3y159PQS1cKQzwnOM+1GQleQ0EFwTDvzE7H6ie1mYhjVOilKhwvKoycXXG4m+lWHuI7lasUwTOQkXG4TwQVKKVxuRnbjODOHNGeiF6SLROeI3hlQ451VKFzzE7/5p1/y6PGOuy+9zfLOHXw0/crgO2K3xE8FSXoAMELjwshn9BP7dcU8Ow78xIGxhpm5ZXmHatVvWItfh2A/i71t6+VbP/HpfuJzM2quZObni3z2iz3vwj/t+99IHXqOwf4yAKTP/GAOTtVO28pB0MNgSSsDYt/hZ24D1hxB3bNosVpS6oQQsQBX69q3/j2DQ6qz0K+v4IA8c1ENcdwvRvcQzH7TSqVsYM0cuFVkr1RApumeNHCtsYacGIXPOQs428Rv7A8AHzwhBmIudCmSh4lxnPjk8RkvP3hA3/f0i6pDo6Z3M05V1VJM70SzATWSCzl1JtwcAnQd4mDYDmzO12wv1njvOV4dsfSBXuCo6xlGM5xlSpAykjMlK8N2x+XZOUfnF+CDAQSihLrYETGmk/OhOpE6qYpRD82weUJnZTjWjtzKh/KUgFTBk4KkNAMYzlkZl0NwPmMsqVY2ZyiM7mUB9veVKjSpOlP+2vjdBxf7p6wza6Vq2tSBoBU4Mf2Xsheqbp8U5kx/Y3XNPJpqTOwYta65tbp2+0WFNKDGuQpWMYM0h+VVlm1O5FzmL9xEuaWp4dUyKjuXsbgMe7JW6DF2qI/WHnzKZE1Mk7VDLN0C33VVe0j3z/CP2G7LnZ7dVLUKme+d3eGCrTnD5ovnzR1apxcfvx23be0cWhrjy8BOqe/5CnYqNlRVTEx7KoVpM3J+ecH5+SXri0vu3LnDq6++RkqZx4+fsNsN5JIZVBhzZpoyw27keLlksVhZgFlts3XeG/Ga6JzgciLtdoh4a60NqHob+8myo2Rntqheu4ml29xWPZiH9uX3It9qQTCIaW85wTR5M1NKoJHVosPpyDiUqing8T7umXPY8eye2T1MKKKZRW9lizln0jRZszuxgJnqioKIZWHHHQ5HiMaYHKsI+XaY0N1I9I7Y9fjY4b1jtx0YpoFdsQ6FsbMSWgNBtrVhR8YtImPCEiDiKQT6ZceYhGlK5FritJuUXIQ0mbPsj5esn25IuzVxUdiOie1uh2q21rKqnK/X5JRZLZa4OFigf3GJIgyTcnx6zPHRMZvtH9iOA8uV42K7ZbPZsN3tKKp4UQKFvNvQdZ4ueDpfhYNrFzwRj/PVnjmhlML52Tm//mDN+LPf4hYLQueILtK7HlQYU2bKtWGAE7robAyXFhwzO2ipK8+mV9ZYAodz5XCeHLb3bhNx/r2WYLtqs2+ajZ8GZD9vu+KR6kJBqZr/NjHmpMRe91GZ97whAH9evHajPmI9/k37XrFRzS/td7jxXK1EWWsnSzlwrY15auViVyn1t0C/bbd+4o/wE8q+qcbBeJqZcS3ZVlp7bbuTuRSCE5wDp4Up7a74iWkwgEcA760t6z6hV/1E7R6bSKCFRe+rnyjGUFEQinXeHM1PeIGSEsM4WNIhRjQrqWRUYDcmym40hknXmZ9wjt1uYEgDQ5kQMbFg5zylJDa7gVSsQ6osesYkmIqPpxCJi44pOSvVVU/ojhgS5GLMJfHCYrnk7GxH3m0JC2U3JXbDgFII3hhKF5stOdWkbxhNAUY3IMKQ4PjkiKPVEZuPPmYzDvRLx+Vux2azYbPboarEGAhSKMMW15ufiAd+glJqAxip4a3ZlYuzc37zhzXjz39vfiI6og900gOOcUo3+4kroD4v9BM628X93Nn7ib31am/b9DM/IXVdqtfsso22z+4nroC2h//e+okbty9Q+gR/9GrnC53vn3eB9FkYO40O7KpWSxqt7VqpQarWyaJqzqiUgooQ6mK2KIyTLeZdRURKgZSExgo1euheY0Sdo2BAwIyPqpW5tMW/sQ72pTM2EGznUsozg0FV57KnVh/ZFut4b+Umc+vl2h48FXLK5Mkch0OJ3tHHjq0fmXJiqouJXIPLECK5L6hzHEdPP2VSLmx3I7/5wyM2U+YbR0f0oYpjFRhzIQ0jQ0qM40TXdfRdR7/o6JdLFosFeMcwmGbJk0ePQeH09C7x/gPKdqCME3l4yLAbastoJY2TdbDKiTTuEJSUYX12SVEhp0wZdlZeFQIxLgj9gtg7YoymlB/8gQkzA+FqVqB33iae96jCMAx2/0pBp8nah1cGi6/HAwOGcL423gPEEURmIMRhZWdSQYvgQjUCzA51BkCa9JwY28ieNzPgQmWwaClGp52BuD0gqmILJs21o5SlnZDgoexFK41RFEGVlKYrSHeDEFvQowdtBlUtU9FKCKnfL1QAS3LZK6mHYN+pgaHOV6zFSvR8DHR9RwmRPE7osGN9uWG3HdgVxZ3eQ/rFp4LDt9uXs91UfmHjYb9deRTNKX9K1gX2TvO68xSxQKLUPwRwNT2jakw5nGkHTKVwsR549MljPv74E54+ecpmveXu3Qu2o5WzXlxc2hgT2JXEbhwZx8Q0ToTKfPHBoaI2RZu2UmPMYZiKc4rR38y221zLkIqx0FKe559pie2BE1Uli8GjDghiPqFUsKTgqs4ZtXX3SC4wTiNFPWiiC46kgZQM3O+6WEXBJwNKYoePgazQdZFF2oP1KZkeQJqyzTkfkeDZTpO1Ft8p0zAgEogxgi+MozKlPAOxKSfrGqLK0fIILY6snuIUzQmKgT7juKtlrwLi2I2J2PcVrI34KHQhshsmnl6cszo+IkbrZnhycsx2u7UWtsWxTYVclJGBcUxstztr25qYRehTmRhLxu12BkCpEruOi/WWuFgRYuL07n2GMTGkkcvtBWfnZ/Rdx6KLdE7pXGEZAseLjj56vINF19UkQLYFlTY9uEK36Fm5E375we/5Tz/5AU+3a7aDteF9cPqQhy+9wvLomNXqmMVqSd9HTo6XHC2iiUrPM0mgAe8viImemX+6n3uH7YgV9q2Psbl4pXz2BdsfBVhb6FMXBvugHExvwdWFS3nxUT71ug7t0ZcJlpRqb5rtcYUqKFmTKi15giW8/nkj1//ytls/8QX8BMaoF6kMzIrQFLES2et+QhwUcVX/jNq62+LQ6dBPeCEFjxE8la7rKJqrn7AunOF5fiIXpjGQJhMQJgQkHLGbLCE7MlzzE8o0Kqn6CVUl52xVAqqslkeoGjiv3krYRTMB8xO5JbURdkPGZHUcOPMTMUR248T55SXLoxUxBBTh+OSYYVf9xNKzy5lcwA0D45TZ7gbzE44ZzJhKxpeM7AZbZym1FHdH7Fe4kDm6c5dhSgxp4mJzwfn5OX0X6auf6J2yCJ7jvmcRjWl53U+0hGjRQuwWrPpjfvmHD/iHn/6Qp9sN22GNFHhwcp8HD6ufODpmsbzJTxxo1bzAT9Sl5w1+Que5twdN7A+ZRYibzb7JT+zXEdfn5Rfabv3EvH0uoObZL/H8Q7/4C3/xm/F8ps4NSNk8UK/u87xj3Pz6DcOxKDlbm9UZ4Gi3XK/d+JSslV1tX5pSqoi+0oU4z4SZwaBVXKp6rZQnczhoLaeC4iyr2cp0KsxZRcUqktpEA0vtaWMIj4Eu9WdmN2jTGoBW7qJ1Voga/blNiLZI984RnWcZO8beMp5jElIFrUTEAmrB9FxirGKY1ulpGCfOzi/5w8ef8MqDO6ag3nUzcyOlwjbvmMaJMQ5MaUnKxdgXXSTEDmr9q3iPiGex6NHQoSmj6YhV+45UYdpibW7H7Y6SRkoaCZ2BL2mcGDYDJRZCzAQXcVLFbUPE+4DzvrbRM7FbceaIpRihNsRo4Ey/oFssmRDTUsm1dV8pjOKIpRBKIVUH4LxWMM/AlFQyLnaIuLltpYggRcn1GZNtHO4DlDKPQZm5dViJnZr+EAcLw1K7KTWiCXV8trFo/2tP3OZS6xxmvzM7bGqwoFr1Z5oTkL3CQkOZhQq4FKwTVBeQEKvmkY1zaSr2zpmODlUrp4oyqwgudJYBcgI5I1rwtZ14cZ6yWCGxrwDmp2+f1UB/+eWg/+Vv17MO7TV74Tleor2t+sJ7eT3onvetY6mZ5/nllrGAKkQulCJstgNnl2sePX7M46fnbDY7hqmwGSY2H37M+XogVOZV1/WoKrsyMKWJXGyu7YaB3W5LzgnpPEmULjj6rjMgxHlciYj46oipwYYx2DQDyTSVjO0oFZCobe/rdYuzltQOtTaedQyXmdYcarlUQksiqbVxFWetUFMecSIs+wUaChebgQnoFx2+C5RprD7IOhKoKqFqEmSFGLwFfr1YljiZIK7rIil1bHSNqFKSshs2jBmjrJeCdz0gpt0wjaQps9tOxNAjzjNJxnvIKGWaSGmiX64Ypky/ODJGo3dshy1d35HGiZyt5ColBXUIga6LbDcDiKOosNuNFOp1jGuGYUJztu9czJb1fU8uxYAU5wxUz3m+t588uWC7G3EOzi7OcaKsVksWq47ToyPrrZQTHqX3kVUX6bsOJ/Xe5kx04H0t1xQD0xfLI07vvcVHZ7D9/s95fH7JlHeM2x3ri4HHZ5csjo65e+8+p3fvcHqyYkpHlNMjTpY9McTDCQGYftl+8HP19wNT1oAaZR+gz3sLc/cbY2bKHL/o9SnZEgMH8/L6uZ6dvFeXCe13+3cvqlmwBapdD7R0SHnhwW843QHQeYjOf1E6+3P3EcjCvvOI2D10mD/Pzrq33TJprm63fuLL8BP7MadixBt5gZ9QL4ivfqJUPyEBVdOxca76iaym64VpkLkY0GnE4rfqJ1CCP/QTwSQYOmFKmSHp7Ce6LrHBFqaalN2wZbrBT0w5MW2ts9MwJBM2dp5JC94ZcDyliZQT/WLFkDJdtyL6iPPCZtgRY7TGJdmYU1MqLNQhEuhiZLcdkdrxaLcbyQhTSUybxDhMaCn0i4hJixbioiepgjdqkHhfdUhNhP+TpxcshxEvcHZxgXOwWvYslpHjoyPC7Ceg9zL7CS/Q9xFXClEwPVC3f/aLxYrTe2/x4Tls//F9Hp9dMCbzE5dnWz55esny+OSKn0h5RMsRxyvzE/MM+Ux+Ym+dn/ET7E2olQwy6zO1Mfasn2jr31s/AV+un/hMQM3zD1QRuM91nz7PzlcN8+ddHB0GJleuYL+O/czXoAdIng1iA11mxko9VwuAWpDWMmto1THJhnAnoQpKuasL5AqiCIK4ynyRTBbBa7HsWBETfmptO+Xa5dZF8UxhUzXQpbZy1me0Z9q12/vStHMOgJwZiKoe1YkQg6ePkWVvtEXvHLs0IWKAikIVHMs4X5DgcTnDZF1EtruBJ0/POV71OOeJsbduI/VepGSMnpTy/BwQIWx7SjHFfScC3hstv4rNzkKcMt+Q+bvlnJm2O/I4kIYtQjKDqZCTtX71zkpsnA9WN+y9gUGu/Wv319X6WpWCFo8PAY2R3HWEvrcyrXEk52L3vhRSZc+ICJISIASoGQ5mvQDx3v5AKA5DkFFKScxsmSY8KW2O1nHUTJ2IcVAbENeefWVLzeOgWebZxLZjUQWEmcEXpV7WgWndg4z12A2kcYcBWbskCzq0AjFSqaDPZNlU5whG6nOcAR9nddne+xmMbKJqKFbKFkzwGXG1Zfofvx0Gl7dB+H67KTtxuD1zpw52admS/b51BB54becag8zGVQuxja6ba3BRtbFUQQLG2HKkbPN6WO9gSDw4OuXNV15ncbRCU+EHP3iPf/rt7xmLdY1ThbAbbcyIAc/FWf32erfl0ePHTGNC+97o5AJdv6Bf3mEnn1jnozTVOMkYZyRQLaRi2gPiCgk1Wqwaa87bzaPZKo8tOoqKtY71HkmCL5VVownB/uj7BYWJVGz8p1wrND2s+p6czNZmVZZHRxQfGcaBpBM4Ty5KMXpOFTufkCKIBHCBJIksigsQxbFaLlh0HeM4sdkMJDKdj7icGcdUywuKidRrYRhHfIjE2OM6z+r4CD8vlLxllsURvKPvIimP7KaE3+zYri85XizRUvAhMKbEnbv3yDlxudlavX/s2GxHVAJTnuzZV4Rb1bEdR/rlgkW/YBqzfTcCzkWGpKwvNmyHAd91rHcbpt3Aqg+WGc+Fu0fHLLqePE1MZaSQKdlTcsJLR/COGIUQe3w1kGIZDhye5eoO9197i2/IKW//9Nc8vby0lui+Y5oy4zTy0vGCV166x8nJKV6EkgqbzUjwHctFJHaBnBMpJXIpVTZMKoDdzPeBrT3YWippr/pR7XCdixaE73ULSvuM1M/Mpt4WTnuA3mzzPFVnv3AwzZ9ZgNdgXtXGdf3E3GnqYE/HQewpV7tVzcF9Pb47fF+aj3rWHrW/2/kOO4bsP3/tM/sv1ywPTZrNtftYKbFl9r/7892C+rbd+okv10+A4igv9hMkXFFwnq7vKTIx5ZoMLXs/sew7csrWPUmVxWqFhuonSjK2kVr3vb2fGC1JKR4kmp/AcmMR/4yfyJKJ3ljT0zU/oaUwjSPOR2LXI9GxXBzhtSBFcCTTxRchBkfXRVI28ebL3cCwXnO0WFgDFh+YUub07oqSMuvNFu9tfbEZJtQFpmys7lJj7qKO7TTRL3oWfT/7CQiIi0xpYn25ZTcM+BhZDzvSsGPVRWPAZ+XO0TF911PSZJ2vyoQWj5a9nwhRCHT4GUyr6yk8y+Ud7r/2Ju9ywls//Q1PLi4soeoj05SZ0shLRz0vP7zH6cmJtSlPhc12JISO1RfyE/tZV5VuZhvX/IPYf/ZgTvUHyt5PmJ2X2fe012/9xJfjJ75g6dOf7rZH7LFyi6KAiXxZp5g9jR0sE6haqu5ME/0qkMC7NA+w4gNJrUxHVQkh4IOfBXqtvdJk7bGdszKooqgLOBwZRdWBt8WviJ/LqGbWTAOD1Ng5WSvT52C/VhZlpTJ6wESx8pmihZQT3jtiH8EJvrO60DEZ3XyYJqYpWZ1vzqRSmFLCp9EYRWIIfCmZTz55Alq4e+eUN151nKyOKyWd2lHLynV2u6HqwGQTFFajaUZfIemi5JwIzjKywXvrejV3yLJsRc6J2Ec0ryj5FM1TFdU15lOMHbFfEo5OCccnhKMja3Hr/V7ItoIgDbhowlc+RhSIQDdNBgqNAzoOB1NyqPWVoAct03GHkzXAlBFnYEazSqqFaRhNKM5VAd3ZGlIZM8acaQGKBCuYMxAlk8edtbuuINEMYuUr5s2seGWzKIfAF1V4L1fh5DpG0oiJ5lWQyUnVbEhmu5yrw9DGlTTQxomV04kxlHxnTCLNhTxO1nKy3YN6Cf6gDE1LQZN17co5gws2B0KoJQj7z31Z0MqnZff+1LYXBuA33KYr++s+EIC5eK9uul8szg62Omq3DyisCFiNRu68geLFOlWMw4hT4e3X3uTll1/i/v373H1wn7jo2FyuWcaOT87OONsMlkVToGRcKYhxKGZB7M12za9+/WvW6w0nR0e1vtzRLY44PnnApvuIUNagya5NQ9WXse+iGC3dBHS1BlCtA4nOrAYtBacZh9lxY8U5Y5ClTJ4mnKS5w6B4T9d5JEMuBr6oKj54Si4su0j0Vt++XW9wzspmvRemKv4efCR2kZJGxmEDxUoRQ+goOEYyGbOxlFQDYuHk9Ig+ZXZjQhG2lwPb7YA4E9R3NRWX82TZ3MkhOSO50NVM5Zh2dIsFKWfOP/mEXJJ9phQkWxA9jSP90YqLzRZ9/JhxN+CcENXs1Pl6W71vYJomExgX5XJrHfgkwlG3opRLm79TYjcmUlYuNzuyJkQn8lRY+EgXOo76SHRKDCbmqC7QB8FLJnYm6hy8I7T6KmmBvVr2G7UAfHHC3YcvofEuf/m97/HRow959Fgp3ZJpUF55+SH/6r/6F/yLv/wr7p7cYdiNrIeB9XZL0cKdVcdq2TPlxGaz5vzynClNzQ3NAWKreb8+B3O1V+4gMG3JAmvhW8PyXDXtnGVQS91/BnVqhN5YnnMQfzhf2/ys+x++23QGWohqSQCZ32sBezuKw64PJ/O1XgnvDxYP7ZzZDnbF7lxnb4hITYgceISbgu5rTqPt0UpNZP7OthUxRmlR3esO3nDsP9Xt1k/8M/kJ8VWM/sBP5ExJCX/gJywZ6sFVPyHGWPbe9GYWXSR4zzQldpuNyWM6E72dasfO4K2MqeSJcRitlD8EQowUkb2fKAmKrR28d9VPlOonYHs5stsNVcReas5ZyWVi2j3rJygw5oGu70kpc3H5mKQJqB2IipUET9NAv1pysd2ij58wDgNOHFEt1jxf7676CWcSBOvtaDo2YcGqO6Lktd3PKVdhfmW9veYnQiRe8xOx+QkveFeInavrkeYncl2T+NlPmB30LJfH3HnwEm+Fu/zFd7/LR48+5ONPlNItmAbl5Zce8i//+q/4q7/4S+6d3mUYJja7gXXVYjtd9axWPSlPrDdrLi4vPqefaGG/HPiJve2d7WfR6h+EtkJo9rvZ8CblcOsnvhw/8Z8VqNlfx7MXdFOG+rNQHT9t32fpTBWU+Fzb/kk01ovmfLXUCPbw/gFiOL+lVQfGYH2ciKmKV3DEuwYsiGmZ1CM4l/cDBzEB2LqIVhfAQcI65DjnKMXjsyIuo95dRRDbkBMxSp+oaZVkRxU8QDE9mlIFr66USLU76LAWfrV1q3NCmArBBZw6vBsZ3EjQgp+Mbmk3ySacOsFN1t1Ks7JerynF2s6+dP8Bq8WS1XJlzBU1McY0WclYyZkYA2WYSF1HFyMhRGs/G3rrfOL397JN8JJT1U4xSqTGqneSrRU6qnR9T786ol8dsbhzj7hcEDrTkznoiG73olhdc6mlAyIGUPg6PkIf6VJPTkum7ZY8VdBJM4190jtnBqMaGedcFRjbs5lapyeFCsDUgeExJ1MpqbUnYxWtKzPrR0pqI5dSancv53AhVqFfnTuAHQ71md110KZaROZxEIKVningvEfVo6Va5QaQqaLZ6m9LkblIXCg4F6yV42CstOCtxXZYLA2IcWIC0A1pcQfZYA6dggFwDYTT2iYYHyhF2FeBHs5Gnms7Pmtp0y2jZr/9MaDViz95+Mzb0Kx5H1UDvi3iQOtcUjWtqzwm0lQ4Wh7x7te/zte/+jUe3L/PYrnEBU8qmfXxmtfefJ0QA1O6sPFbHajNtWwCk2qAYAZ++cuf8+HHH/DKKw/JeDyBuFhx9/5LXHz0W3S9M20CrXotWBclxALtZo+d7hmPc1mgmL1rrWPbd2305Rijsf9GAfFkqccudqdisJagYygUEiLCMA2EYGWbrnbxyCWbXjum0VKmjI/GZvGLjk2AccjkXCjTYPNNM9Mw4ASWi0jKhWGYKBRidAyTdQ/pOodzHeM0WDtrHMEHkGDdUqaRp8M5AUcXAt6ZqHDaDmyGkd0wIR4WiwVDFdJcDyPjdmBblMvtlt2UcSIcr4642Ox4cnZBSpmpZIpCniZCCJRcGHY7Yghsh0S3HhknAyZKKkzn54gI0zQCiaDCKkZWXYfXTJkKWQqRQOh6K3koBSkmcum9s2xszkhWVPx+weisG4p3jhCCsU4fHPO9736Xn//ifS4uz0ipEL3n7p27fOXNt/n2N7/FvZM7NdutbHY7hmkkT1ucmO7PZruhe9zz5OkThnEHcij92GzXfgZpDb5l9oXX7FZd9EmdRy2o1YN/G9Ddjt1+PsvsPtzvC9mJz/iZG77Z5zsNV73EM6VfcDUOa4t1vXperZ89eLuW795ut37in8dPQNMatHgnRktWjhOAo0grcbf9Zz8RC2VKiBPGcSB4+1wuQs7FgHJnpaYolFTw0dgs3nU4r4xj8xNj9RPlwE+E6icSBb3iJ/rO4Z/jJ3L1E+fDiL/uJ3SAYWQ3ToiDfrFgrH5iM0wMVZ/wcrtjqH7iaHXE5Xbg6fklU8qk2vAkTRPBezQXhmGY/URcj4zJQKqSlenyEicwjSNIJtRyplXsCBQ0jRQpiAR8h+lOloLoRBetw9OL/ATZtHbMT0TzE9/5Lu//0vzENOUrfuLPvvVt7p1WP5GVzTAw3uAn+ief8OTp0y/NT7SZZnNJD3AOuWJAG3hx6ye+PD/xqUDNpy1obnrvpu2Pff+z7vP8/eTg/c90mOccs5Un5Rl1VN0bUZSZMdHOdeVeFZ2ZFDmXmWUQswXWBrYUsggyL0BtH4G5dbGZaaVQkJINdGlP3YsJpWmxOss2a8xa7wdY/bFX99okJjqZ5zIZoApq7WWbfPD1s0pJflZOytEW4AXFHSiRG+PHami1CIKzRQO2wN4NcH5xwSJ2hsLXUirK/n6XYiJcuxCQrJALwTlc1+NjJPbd3HrQhQNtkkLNODhcsfbZbdNiIJJzwqKCNN3qiLg6NhDK1/bcMk+nqg2DlTw12Zb6PcU5Y7x40+WJXYcLRpMvqZhAZ3W2IUw1UKa2Z6+HcSbo7Gz27jMtauVrjYZnDK36HC1KQGsWg5pp1vqrPd88P3/a89Q9ywphbirQdIzqKrAGB3CgpIFUDRrnHGXuztSC/FrQV3WXTLOpRTP2mZyzZaEqIu+daQL5YOVhTXRvf+vt3JZ9kv33LhVsyhmloOLrfH225Ommqf9poMstKPPlbTfa5ufdXsHGDI2zZm1OLWNj9i+3ALxS3YsKF+st45B4/aWX+d63/5x3v/EN7t65OwOhlskQxAW6xZIYYsUQ85XTF8kHpjPj1PHxx3/g17/5Fd/85rdYHJ2QS8KHntXJPRZHxwy7xwQJBsKTQQpeHCqlUtfN/mSVWopqNtzX+9LGvauJiKKJnLVitIWu63EukHKqgKqJcaeUazdOnRfdBWWx6EipVMF7NQC7nqPkXFmhBYpnN+zo+x7f9SyDsN3sGLcDzgd67/FugTiI0ajlTmCcMhlh2QccMA2JRedYLJYMg7O20zVDJqr1XhgrbsqFVBRNgg+2KDA74UmAZCxjm2BMQk4jYy6EznRgHp9dItRFRohMGYZhZNGbNlUXPM5HBCHlwtnFBnWR9fYSs2t235d9ZNn1BIEuRpYh2K2cRsY8sAgrvNiCTCiE4Fl0HYsYq2BlQTSZzaudHhxWimF2TVBNrJanvPHa67z77rv85Oc/4vLyCU4im82W3XagpMKi64hdRHCcHB+Ti5LTjimNDMNIDB1OPF3sOLs4Y7PZUPJEUxWzaXMQp8nB6zWCvmLPhIOMXtP44HDFezh555dbuutFodQfC09YRlO/WMD2Bc8HN3mNq/vMIrRwpbz36r2qLzXfert9ru3WT3xeP1Eo2eKsTpQYO+TAT5TqJ3IqluRrLAZnDIS+762hRo0RfTjwEyXVRKNC8QzjQNd1+L5nGYXtZrjZTwTPlJufMMkH8xPKNBhY09/gJ7JSu4Nd9RMkMSa1k9oRyEC3Fqb6DGMWtpvqJ7KxhZ6cXSJirKkQgvmJsfkJRwwe8dFA+6ycXWyrn1iDmM13YuVhyxgIrvmJiNdn/YSZWVub9LGjr36C5/gJcbb+8E5AM0erBW+8/hrvvPsNfvKzH3N5+RihMz+xG9FcWHQ9XfUTYy7P9RMx9JxdnLHdrq2MavYTe5ZKi+sPljE830/YurKlQGeHUHeaQRpu/cSX6Sf+szBq/rnKBG7WivgsQ+KL4mr2+VJyFTlMM+NE5MouV66v/cxQT9GacVOkFHJmFgJz3s0QTC7KMJaZbSP083nEVbZMBWByyqgUxFtHKFWhqLP6TudqGRQ0GFS1kItlV1ULqbIx7PsZ7TwPA61NtTjQXKx1oKqBRWpBnadSMTFBsy5GM6YY28KlhE5mjEIs+JRJPlkbWD9aaRcwjBNPnp4xbHcM2x3LxQLvnE321ipQxJgjKYPCyZ07LI6OWBwd0S9XePFWOuVDRTQrGAMWiDb8slI5AUJvIE9/5w6xWxjdP+cKMhiY0QwQIlWgWc0KNeNUSr3vCuLwsSPWDkv98REKtWvWUMdAsRI2VXwxcp92EY8Hl4wuW3y9t0Az7rWVtWY1gNCZMKZ9vTam675pr1djyO8BYVilYSaAVvaSvWcts5Mt7sQWRU6aqrwBOkXLnNFxlcWidWyVNt5LtZ0VQLRrru9VBo3HmeC284QYrdtWrCOqlPl7UppjUStlQA+ClCruPQ7mtFp/yCsu4ma7cKs38+VtnwdIn8fB7O3re802twk3FxJbAN5eL1rnthMyYh3cdiPr9ZbtZuDlhy/x3e98lz/75je5c+cu4jzjNDGmxDBMnJ2f8bsPfs9PfvZz1ts1JU97MFBbuF/BEAwDKXni8vKS9370I/7lv/w3PFysDKx0HXF1wvL4LtvHH4CLiEyIyxVkNbS09nAzHa7SJp/M84Z6P6TOaxET/nbO2HA2J4N15VObD16C2f1aFlkUKNZq1HlPCB27YbC5rNbSXryJEe+GASkZp8I0DvaTEy4Gll3ParkgNPsijqlkshpgLhT6LhBCYDcm/GJBFzJbdiCCD57oHdvdxJQgTclss3eUGrTkkgmhI/poZaLTaHoMKDrYWLD/mS5XVgNhp2Q+s+97KErszP4FZ+85FxARUmq+VchZSXlLrq3MnQenhRA9R4sF90+PCGRKVryaFoR0EVGsvFYLwXli7Fj2nj54+hjovMc7K3kVCTj1uNplrxTFeRNHd5oIHk5PjvnmN77J3//D6zx69BgEnp5d8OOf/pxvvPMO905PuBOPcd7Tu2jPM3qmFPFirdNzLogYGLZeX7JeXzKOI9NkHShFWqdA5jnTgPaWNQV7BsVRkzy2YGgzrW1zQgcTQixtzopgJd1XBVyvB/dyg93d71sOd32+rTjYZ85L1PlS3VddNMj8mpa6qL3pug5szTOJtMPvPqc7a3JLddYk3K9NZN84Qqzds1rQMZ/jy1FI+7/Odusnvlw/YYmugvMYCzAnQgg18creT2gBLaRhqvO4tu72Hh86hmEgDxZXeyfmJ6T5iXLNTyzMT0Qry7zRT2hG0OonrCW39z1diJ/uJ8SZDueBnwizn5j2fkKmvZ/QjIg/8BOZXJS+60Grn5DqJ3LGOeuOmrJ1UDQ/UQ78xGR+AhPTX/V99RMWl3qqn3DGOIrenlvw3rTFOk8fAosYiN7jvXUrdBIQgglW1MSr+XPFUwjecXpyyjff/SZ//9rrPPrkMeKUs7MLfvqz9/nWu+9y/84pXTzBB8/CRTICnWea9n7CYgfPctn8xAXjaJ0bS9WFbP/anNFP8RN17B1SZaoxVGVeD936iS/fT/yRXZ84uJTPA8bYV7hqr/fHbovHq5t7Zj94ntF//rXs93/R9b7YsaaUGIatsSQq0CFSm2drwzHkykA/1LUQqHoaxpawGvKdPSgR6DuCgMi+zTdAmnItjQn42FnLaNkv0gVjQtgCVqAowXljG9A0PGxQ5pxNDLnqlZSU94NLaw1iMWX47IQgnZVL4XHVeJYKmJSUbbw5R3AgwRHUmDXiHS458BCCkFJGnLUsLzmT/L4+zzvHIgRi8ARvXaOsA4mnpIQTwYtjuViwXK1YHR/TL1cGrvgOj4FXzgmuC7hgKDmlWPlSnTl79NUACOcdLjj8onZaUoPojZZaDDV31ZiIzO1XDX2p4EzJNHYUWNAbuoCwYFytZsYKl1aqk6aJYRwJgC9WHqQUVEOd1CCuoF73LVr1AGTSDJPOHUxmEMUJNbXOTJoVY6GkcTuDcabh4GdnbqCVVtBuP65DFVaGCsbUeyNiANieibWfVTq3fZc9QKmGQBet+a7qRLoYGFKxmnFnwqDeG1RJSCBl1ikyppABkRQ3G/I0DqRhYBp3ZLdAiSAdL8LzPw94fAvmfPnbFf0B9ha3sUHaO3MOv2ZzigJiFGlVY4WMKRm1+ek5l5drXn74kL/63vf4s299k5OTE3DCdpp4fHbOb377W37x/i/49a9+za9+82t++8HvODt7Cppr5zKpIPde8M0pxu5SIU2Zn/7sfX7/wQfce/DQBK29p1udcHL/ZS4e/Za8HUzgvDgTj2+L57aIQIwtok2raf9tW0240uaO4qs9a0EAGAAOYsAuheLFOlhgre5jFT8vJdN5j8SOMiXGcUd/tNyzFbNR752P+BjwIeB9hxYIweNdZ+VEFWgtY5oZj+KafpppF3SLjiCRcRwpmi2L2AtOUpW7snk/TomM4L2AZqbJyju9E/AGKufaIdBhJZAeIWshVwadE0dOmZQmRC1zWrCS5JySLRYm820hWHlrCA7nlL73RpuPC1bB04nDF+tigljNexCHo4B6WwRJrvoMji4GuuCMzVn9luIp2Z5nS6C05zqOA2ncslwpR8sVb77xJu+88y7v/+KX7LYDwzjyi3/6FT9470e88vIDFn1gsWzJGY+oZZe7qCz7TEr2E0Lg+OiEcdwxTROb7ZbddsswjEzTyJQSponQOltZ1r6VsDa/W+p1VpmIlsuxz3A12GzC7PMMvWZHr/x9g8k8jImu7quzMdgzle1izD4c/m4HF1c7VjWJvfrmzD6u/mHfmfPwQvbXdxjktzfbpR3a/cOsZ9NgaKmPuRsPdv0emTUI3OeKjW+3w+3WT/CpfsJiPYcIxEM/IVTbVBNiFNQL07BBqcCzMwFiLVaGSezQtGUcB/qjhSWQ9Xl+IqLa/ASUIlZWNvuJmhhwjlwMjAre0y16ggTGcTrwE+Ak/3F+wh36iXLVT0ymB+R9oKjJA5ifKJ/uJ8KCZfD0zhMUumCSE3s/EUGnK36iq6XEfXAEZ10Ug/PVT1iY7sWhDlxV3p2mkTRtWaIcr1a89eabvPvuu/zil9VPTNM1PxFn9n7zE6ignbWQz7URy95P3Pty/ISTZ/3Ewe+3fuLL9xN/JKPmCmZ07ff6ynPAGHtdDl6X53zmpnN+2qLp067jRQu1q9eyv/971kwpmVyVyq9ei8yfaWVMVuJUNWcOHmaunZ1s4a2knHEp4aepLlSZUU2tI9KQ1wawW+lJ6wDUuslrO898rWWmSZYa5DagpmQDWQxoaR2B2uiv/5RSF+rUkivw6klDqlo9BliIk5khIXXx7rRQxEAOlbqPz9YOsS68Q/DzHfciLGNH3/csFgtWK6Obeu+tvrPYxOq6zoSEu0jorE2z1GtzTirw4vGxdmhSjz9ohe7E1ftngssiNomlOaWSIU97YMQdjtMDZlJ7nnodC63GopZBhWjXmdKEhADJtHZSyiBGKW2CXKiaGDTgVGfBLjk0PhVs0sbsUXtGWr9fQ7L3hsQAmDwNhr5JoyhaSDD/1GOWnIyRg9Zgp0UJbc+KMKNV5+bqV2/jaH5dBJH9vkWNsWUiePYsTHfJnLqr379UUWkUBDUHWzuXZS31KzpSzSZPKZN7h7o6L+ap3Ez2gZ1/Hnp+YBcO9WpuwZrnb83OPW+7ydYegtYNn4a9I5u1MepYNidXg0o6Ug5MU2a3WXNxseb8Ys04jrz+yqv8t//2X/Mvvvsd7t45RRE248B7P/0pf/Pv/pYfvvcjHn30CcNgLVXHcagefJo1rIz8PV8p+8SHBca///0f+NGPfsS7X/8a/ckpRZUYe07uv8TR3YecD+c4N+KcdeyrreHsULov55MWNMzB9j4Izw0Ibi5e6yJED++nB0IVZDSaP2SCGNvRVhF7XbSAMEwVgA0dfRetk1FKtOVGTglRA3pDFywAz6b90q5Vk7EHp1wYxmS6Mi7RdQuCC2RngV7sPLthxDmhq11V8gjisfJf50lZyVOZ7baKXUlREyLPBVtoSC0JLpkJC/iT9wb8q+kyZDVNgowxTHMywNnV4HvZewuI+g5E6X2gU+uQUqbEVByu2tFSEs5b23KpCQAvEJwQvRgQxv7ehGA2wh0Eb95b+cR2c8mwW3OcEz4Ip6d3+NpXv87du3f47cXvUYk8evKEf/jhP/KVr77G6d1jXN/ROetK45SZxr7o1bpoOc80FXz03Dm9Y4KgxbQWtpsN2+2Wy/Wa7bBmTLtaZrrPal6LuOawyuz64ZtXfdtMM6fl/ffHhKsxzuwyPsM2j2ndX07783lbi4VU980bmsM4vKYbz/GCoz8DCHA13yt69XtaPYzO1zR3Rmlz/NZtALd+4p/TT4jsWZYtNBWkavt5wPQTixMcO0DNT1CTxaUQFMQ5ptlPWFOTvuvIU/oUPyEUzbSq++f7CUfXCcFFstNrfmL6kv3E8M/gJzJT0Vs/cesn/rP6iT8CqGlf8BBguQn80Oe8f/X3F+nfXN33n9vrXf8OevB6rRVNxohQbQ/72f2boG2pAo7zuwfsmnJwrpQyIpOdyYnVnGqgq4BPWyxbdlPJWfGeWem6IYSVzjOfK5Vc6+Ud4q0tctFWHlVLe3Jr2VxIKdm++xVtXUD7yiQxhsuw3ZkAcSoGjDjLGJjpNmM+lQJeaveQQEwdKWd8TPtrrWwJVPHAyWrJcrHk6PiY0zt3K8PCgJo8Wa1sALou2s9yiY/WnrtIIXYLfIz4LiBeqmq9ZZfbPfGxMm3cHjW2awHTeUnk3cbKtvzVz2rOcxlZznsBXhWHSJnrieUAfIi9gTR+irguVsVvEzMrJePchEujOZzYA0LoFXwxibnYVSfgbLLr/lqupDylmQqZO38hQskTeRoZNxem2eBqW+uGeosHF9BiLefzNNKMGF0NHCqguB8TMhvLeU0J9Xka7dLAKqmCflrria3eWHLCi6tCfw6cgTZWUmaUVO9DPY7aeebuYwUy8/ybtluGKbNLhbSyFu2ugTNfQpR8k8DwLWiz355xvg0IbM700O/p1c/Nd/TA4bc/Gz44C0GKtRQdc2Gz3bFdD0zbNWnKvPTwZd547XX+8jt/zjff+Sr3To9QUZ5crvnHH/2I/+l//l/4yc/fZ7Md5hSHiKPrI76K51q5Y5tfVB0nZg/aMrW73cg//uM/8m//1V9zfHREFhMLXB6dcHLvAeunHyJMJuTtmpC6r8G1A3XkgzDfsjmZwl5EcgaE601zzlh8JRdwFdg1+NLo07mYLpaYSHvKmWlKluF1xoLsfEAXC6baiWO1WhFrK9Mhjaj3KI40TCz6AJqNFp6t64U6T+w7HNZBKvpAchDEynRTygZK+wq+q7GBQhBCcCRRchGcC0xFGUuupaqultWOFdQ3lgremVh7tkVIrgzHnDOoxxFZxACqOG+6DqKKaLZOTeJISfEOuuBYLayzYlhEUk7zPQnFsuBgGjlpSmg2YeTQe+vAWLufNO20GEItyyx1eAhd7BB15FL1HIJl6S7XF5yfPeH4dEMXTln2S958401efeUVPvjgQ1IpSMr8+je/5QfvvcfLLz8wyvqqEHyPVxsXToSui5wen1BK4fGTx2wuN7BasDo64mi14uTolHK3MI4Dm82G9e6S9facy/Wa3Wazj1tU53l1GHzvA+C2YKzjbH5vr0Ng/1yls1+nsD8bG+nB63JgDw7Ki/XQEjwb8c1L93rpgl1ny4feRLG/EnvetDA4jHcO9z9YELTMLS0T23aQg2NqLUtp+Gq5BWradusn/nn9hKBVS/LAT7T5i7v1E7d+4tZP/BfqJ74QULMHaG4CZm7aDsGOw9de9PnnvXfT3XvR/l/ONj8PLUzTyLDd1vZq9nRKpdrVveZBHryjeDerqLcBUWb02yaWLVIhl8w4TdVZCd6bAfFe5gV2yYVxtzMTHQISjOLehHcp1vVHnaCltq/L4IrfL7Lr41NlrmdsArJtIrkYzJhKZQCVyopIeaZ5qjfWCD5ACBWEKBQKJU0U8VAZLkGVXJSQ0oHTLky70dBu57izWrFarTg6PuX0wX1CjPgQ0ALjZsu43aHTQOw6Qoj4YGVLEhwED9EjXbD2zKJVFyegTexWCz5EmqiWaxVrCl6ZBdnafWraLa31oir1fUBrqz29Nv60zhGxZ4C3UrWuz4zjaOPJCWkYjdFExtVuTT4miihRkwFcOVY9GwON9sLgWud+VYoRsedvUBxSCjBZ5iAncpr2wMoMh1enniYk2DhIw0AeBxojrIFYqpDHLeIDLoQZnWk2XOv40ZRs7DiZmUjXS/+0FKZxRHEErDVkTqmW4mUIe2E5pU6rWqstVadHK7iYc2K3GxmdJy2OcIuljcVrCP8Xm/O3LJrPsglub0+k1CCovaRV0LTtfNVvzHTaiscZO9UctQAEe/QjsEvKdjsw7TaUUTnuVzx8+2u8+cYbvPHaq7z88CXuP7hL7AMahMdPnvL3//Ef+Z/+n/8vfvmrX5FSNvpyFzg6Oub+nTu8+vJLnJwc8+TxJ/yHv/87Hp09Nlpz64imdv2lXrsoJJ14/xe/4L0f/4TX3/oK1BbyEjqO7r5Ef3SfzXBh2k5dtMA9mT4ADZ4XrSSZWrIoDUiHTBOZZ25v6sRseQsEasEijox4xzipdTQRo21HL1gnERMkLiLEVUeahClNrNdbusoyVC30MeKqJsFIwjtjvClm4qIXsiZSGhEvdFDLFwPLo960oRCkCIw1WCmZgIIPZBXonDE0kwW/0VIINeguuGBCnanAlGxRkUo2vym1k10VXhRMJ1/Eng9VoyGnjBcTcXQxMKYR5z0xRiR0dKJ48fRdII8j3jtiF6i6xTg1Kr/zsOwCnXdEPL3rCOqI4gnOoZosMAvVl/quCujX7oJqz6SEzDhtWZ89YXplTTxKxG7B/fuv8pWvvMN7P/whaYBxLJyfXfCDf/g+x13g0bsfcffhyxyf3uVkdcIydiy6wKLv6DvHvTsnBOf56JNHPHn6hCdPH3N6esqdO3dZHR3RLSInpydM6T677ZbN5pLzizMuL8/ZbNbsdltSnsyPF8GLRYtau8wUTHQ1OG8dS0oma7nSm8BV36dQNcSuRWbXQzK9+lI91BWW4+xj0SqCv18g3HRoFcgyu6P6nvm3fBBUl2ufbZ9vdHPLIlPZC3Il49kWBllqWYqr76E4bczRurgwagfqzLip01kL7099u/UTt37i1k/c+olbP/H5/cSnAjUv0nIQOQRb5OD1/R27eZ3zYlDlpnN++oLpiwI1Lz6uXcr1fexmu8bIqOh2M6b2kepEpGlp7Bd+SkX2ai3gjLnVQZSL4nIhidUZagC0HocqoFqM/WLXqFAO2DEIVKc4tw9TYzNI1cWZz1ePdTgJGlMB55vcydxJqKHyUBH4QO1YFGpbZqAYjVM0m6ZrMc0bV8AXreUtbdGuBCMSEp1ndbRiuVyxWC1ZLJeEaO2x9QCRzTtTg7eOTPtyJx+tfta19+ozct6hPtCAGg7uSXu2DXAQV7MZ3joH6eGDqZZgRprNQ+5RvDZTZ6TWhKGdOGNYhWDsIO+RnOu9tolcTBAIREjTZOCXMp/X+4LTMt83wwcbf8bvR7+CsmcpVbUdA5p8rK0BqwVVqWBHRmAGdErJVluMq+VVZpm0FMTZ/SoHpXvSrGgF+uyaZEavdTZS16iPTRentPaSute3mTuQtDKruhUbTyVZiVaeRpJCdh663rR3Kuj5XEz3c2zPs3+fR+Pm//pbG//V5kutCW5FxLPnlYMfGyOtvt9GcR3TtbV7UaVkGEvhYjtwsd2Rk3K6POGrb73Nt975Bq+99jJ3T++wWiwIMVBEmTTz0Ycf87d/9x/5X/7n/5Xf/OY3aMksusgbb77JO1//Ou98/eu8/dZbPLx/j75b8MknnzBNmf/33/xvJOuliaOgYkA3B2NQxXF2cc7f/ce/53t/9Ve8+cabNkdc4Oj0Pncfvspw+RFu2FHIVX+qOmasMxmyb8K9t/9qmUGdLc1sv/dAcRUfxASGffTEECkiTNtaZitW/x5XC6YqjFlUES9EIklhHHaUZDao1bE7b2LwBCHlZKWZzur6+95KUIdpIo2lths1+zWVQhmsG8WUSxXqFUq2DlElFcaxihsGIdSubE4gZyWTscRorRWvNsU782FNX03VXvPe03sTaGyOyzlBvOAIdDESxWxiiCsbFyjeVU2uXHBYbX+1lvOY06qr1vtoCRIR+mjC9FrFerSYNphIZQxiIpom2JwtqKu23R5sMdbfds3idMTFBUdHR7zx+pucnN5h8/E5TSj+t7/5Hf/TJx9zcueUk3sPuPPgJV556VXefuMNvvLma7z28CXunt6h6xec3jkl9B2Lx4Ff/+bXfPDBByyXS15//XUePnzIyckJq8WK1eKYu3fucf/eAy7X51xcnHF2/pTLywt2oyUPtEyzFlqxZbON2WLfxTkTZm0U9hrmzrNfD36/yTQc2uEWH1kcZC/UZehBh8IDlwuzj50PdxBx6xXzc0PseP3v2RzJtRee/Q4NSFC5ej2lrjyaNdu/J/P3mhcQt+2563brJ279xK2fuPUTt37i8/qJFwI1LwZMmuHYG5Cba0yvf6X5necc90XH2Z/3WeBmPwSet4Z6PtZz/Q25+T2Fpgszizi1jjuIgQbVrcwAwMHFHHZpUpi1SfDM6tsNPMmVnRBSIsa+AhVNW8Uo7ylNNnHVV3TWFr9WUoKxHyoCYfojdXFcRZWK7jvmNBRa8Og0zRU12iZj2oMTqmqq62KiYhUtoTgTFbNW3RmHN9HXeodK1S6JxR9MJJAYcSIE7zk6PmaxXLI8OmKxWlq77WCL7wZ2JC9GMwx+D9KEQN/3xL6vbJpK+Kw6MXSdnS8nyqyfoqah1Z64x5gr6vbtqWcAy1Uw7gBYqEiKqIDU8KEaK4UKRDi8CCUEfBfxMVoJlzicD1ab3I5XTLsmp4k8mbMoudTuIR4frPys0RutpMuer1TMVzBQLaeRkhJaMhKjlXl1S1Tz3uCpgYLTOCFurO16R4yPV8vZiqK1HaWgSO2cZSVbeyFrVGdtGqmQcykVJCqtxKoxyFqtuh2rCfQJVstLKXP53iG402o+tezLD6ftjtT3lNDB8sjAQmQ/2Z9jWG+3L3+rFq/6IZsXKqazZC/tnbbW7EUry0dBi1gZnApTKUwpMQ6Jy82Gy92Orl/wlTff4nvf+nO+8ZV3uH/3DqEPM2ipIqzXW97/9T/xf/yHv+Xf//u/44MPPsQ7x/HxMX/x3e/wX//bf8N3v/PnHB8fs+h7vA9oEZbLFd/5zvf42//0D5xvNtbGOtfAtXWL0zoH8IzjxI9/+iN++N4PeOmlh8TFEhVPvzjh3sM3uXj0O9bDBUUnazFaRlQKalV74GIVpaz2p2plHd7Jqzd3b3uhiURal4ycrZxz2XekzQZHwQdPcIKWzDgWo2l7NZutghS3l0QQj6p1RrKOhMEo6DXojS4SnJWLLqKneIVS2YdJcWkyoDQlMmX2N1K1omL0ZHHshgFKto4HoqirKQVpeuiVPu0cBMUVZcqAOhx+DqL7EFnEDo9YByfnqm0UQuzofUCKLUacc9Z6tiRirCW0SdGS6bpoAo+5dsSqoHBwYoL2Tq2zUxcRp3hpoLR17nBVl03ESjVLMVF9FbVSWJpum5CHgeHyknJ/xEVrm/7am69z7+EDPn5yYR36BHZT4uLRmg8ePSWuHrM8/pAYfsbxcslX33iNv/7L7/G973yHN15/nX654Pj4iD6+yrLv+eUvf8n777/PH373e1597TW+8vbbvPTSayxXx/T9iq5bcHx8wt0797l7ec75+TnnFxdcXFyw3V5Q0mAinDT/ZmPjSvCrgqUBpb5wVYDxSnnoC1BypQax0myGiT62uPq5Af3hudq/7QNXQ7Xnf1iuxtx7/Y99HPosOf/6F9izTYE5WTH/r7FDXnghf5rbrZ+49RO3fuLWT+xH8a2f+DQ/8c/cnvv5D+Cf73g37fPHOMoDHLCCCTF2xNibfkkdcK3bUEMBm0ZNDIGcMoJUVXdbgM/6JlR01pmB2bfILjhfGMYAbEnJRHgXiwXOOxCdW2uDtdkzTEaQ4KtGiWmazAyZUJfyAnnKFcXzuD5WAw9opojYNR2AcG1rwIfvunli5tpiDlUIHilipVbqrSypAkxaO4SUlE0wuTI7DP0OdLFjtVjQLXr6ZW23HYMBLc7bvfeewVlJkw8eFzxFKn3NmwiYx2pepRiIUHKq0m92vSUlQGvJ2X6itbIvilEpXdVQ8d5aT6tg97t2H9L2DOchZ2Ba0wLCZysHoxDFoBRdZXOACEMpJrQuguZspqwoaTSRYacQo0OnhFQVd18dtRMhB9N1Eefn72HGqOnEZMumFDFDikO11jnnHZqrZoxmdBjsu2nG+QjOU0RmrRcRwXWd3cNimZ5m9fI0kqdUmVYWTJhdqsyrCiy28ROj6TMJptpv9ck2V6zSLFPy/nnY7dZanmdBQp4m0jgyThPp+BSNC2PTNIOIzM+liSzfbv8826HvayKPhyC+VjDTxqdc2Xf+wYLvlE37aTclhjFRRujDMS+/9QZfe+cd3v36O7z28CVOlysTMCSTUc4uLvjw40/4wXs/4t/93X/gF7/8Jy7XGxTHyekp/82/+df8j//Df8/bb77B6fHKxrO3srsicHx8zJ/92Z/z5ptv8+Of/bwGCAURxaEHwOye1fjRxx/yt//h3/G9736X5atvgLd2yss7L3Fy/3UunnxEYiJ6BRmAgoq1iZX5PqmF9OJmbLIBxFdL7w5YmZXVaPYdlNqS1XuWMTClESd2zdFb5nBKVSTQUannigTTEsj1eGnMqGZ8jPMzFRHGIdVMZc0QOlc1FKBk67Rx3Hc1AFdcHynJUVKmAb6ui/SLiE4RFKZRmcZMyntWaM7F7EJSs2Ep4UomOiH6UJMDjug8oYLVxQmxj8QYSSWx6COSTWi8qDELnSzwwTpvOLBFgHN0PpjQoVh3kuAd3gU6LwRn7Vb7PhKDPXVXkwXBRZyLeJHKqnVokZr8wOy5fSnrDAK4lMi7LeQRJ4UYPXfu3uPu/fuI/BJVU6Nw4hHfMewm0pCRmBnTyGa94/Gjx/z+93/gD3/4iH/1L/+aN958nQf379OHwP17D+m7JffuPuAXv3ifjz74iMuzS97+ypZXXn2Du/fusVwuCGHB0SqyWBxxenKfzXbDxeU5508ecXb2hPXmkqlMFE2g1kHMXEoD4feJqZsyX58lAJ+D3Hqf2n5N6HEe8Xrz55p1uXLew/3qf19YcSTXjteSWc855pU4UA9+r59FD16u7c7bx27sJvInuN36iVs/cesnbv0E3PqJz+snPjdQ8/xSgMO/PiugcvOx9sI+zx7zeSVQN13WM8rS+7+uXeP1v6+/vv9wK2VCqC2I7WbPC+WKujkxMan2b0VBqtRG/S5lD9c1pA2YlbedKsklc2Gl0C0WxGydOFyrcavf0ypwZD8Y6rtX7kHVWzFMpYISYq/P7AdpX9dqD12lr+HrpKsOSLybUc6SMhUirsLH7SOVl9NYFBU0CpUB41pbaScEF+i7nsVqSewX9ItF1acxbRbEISHiOkVzh6IzmyaEgI9hL6zcLmD/QIy1QgOLyn4Xd1B61oAabSVrrauWaw/IJmoDKZw5slmyW2oxUqP8iUIFtlQLTpXQdYQpEbO1lkVkzyKhoselQJpwaiVjWgWNVYvdAzHSkiZFvK81nLLXcRHmDmEFTDcmZ8QFEAMGcz1nKQZklZwNrRaxe1J/3EzdtDFxRWSaNm2UpmmjIgf3/BB93gdelkkxMFCTVo0kaw+fUyL7CbyBlqX+5JQtCKiidXmaSMk6wGjsTKvpmhGYx/eBMbwyu+Xw+q6+duUYt9unb3WuaQ386oCxcShirLM6VcRZZy5rYWzlfEECaTeRp2JB89Ed3njjHg/vvsT9+w948OA+d+7eZbXorD1msTby692GDz/+mB+89x5/9w//wM/e/yVn5xfGEhTh3t27/Nf/9t/w//gf/we+/vZbLLpQ2WgydzdoDLi33nqD7333u7z/q1+haarXJxXA3C8zcjF9BU2F9977MT/44XvcO7lPPD7CuQ7pHHdf/SpPPvmAYRjJBZwL5GwCfc45o7nXYxoIKdWENIq03dbWKUVVDehVnX2MWpRer1/RnFhG8w9KwWFdN/oY8O6IIRWGqbAInrKI7FKiqInBo3ZNKSVUHKGKL0p9lI3aW1IGp2zHHc55FosFgiONE330JIVUA1+zT5Zl9tU/JlUEhxdTRgjWj9WYflWg3KF03uM7IaREKpU5Wr9rEBDNiDi8qAXdzuGyBebijHW47DpSsS5YsQuUkhAttX15ZTrmbGW3XqzltnfEIDgKTgopDcTQ03Ud3pmmQQwmBmmDwRiHWrOHith3rF26bCWnUBLD9pI0bgk64b1ntex5/dXX8f4/MUmq2TVBsUWOKJALzps8f86ZDz74A//r2Rm/+Kdf8L3vfYfvfu87vPna69y9c4d+teStt9/m3r17fPLoEU+ePGFzueEPf/iQYRy5d+8ey+WSrgvEuKCLCxbLFUdHR9w7ucPlxRln508435xxsblkM2zRLFVXwHp3tEWg1PinLdJuNgkyB9dtzLa2rfPnpMUVtmkzJodBLFdt9T6Lu1/qzwvU6vfyzZd0xVyVattdK5XVvf9r77W4rkiLfDCtC90vFkRr8K4HPudg8XxbJnuw3fqJWz9x6ydu/cQVk3DrJw6v/abtj2LU7A/c/j1c1LxogXMTSHN9/6vHVP20Y75oa6UuB6/o/vxtcLzo+FcechVUKiXv2SoH2AC08pTars059kPLBpBQF+Xts+06S0X4qihWcJ6STRB2Ma3IMZgoktSB4wTUGAwqAl6sVEbKLMDWnGNbwFtZj7FxlIJWZ9T6uauvArkNxHCCeF8VquudqAt4RSFbe2gnah2gcBStcm8VJHTeUepnQ21Z7VzVgSmF4D19t2R5dEzsOrp+ge+iCejW63DaSmk601URo3a2Nt2HrBKtABD1XhltcQ/U2L5i37FNlgMlf++s3tSJzMHEPG7UbqpzYo7jEPRqBkXbc633ThVRJXQ9IVs98pQmqJ2+Sn0NTFC6jBnvsjmMrkNcQYuxe0oD41LBtzGkVRFfc1X+pxpzKOMAWnChx0cPYnpG2gCSPFGyUQqD93a9FfRywc+G0g5WZiCrjVknDrygVf7IpkSpRtr+bvXSbaKUmSFTyGkiTJ2VMg2DlQiGAlkpKVFSsg5ZUzLx5SkxDiNjzkzO47qulnfVAGUPU86iX/VJ3Dy3bwPpP2rTpjd1oD1gv9i9NdqvMvd4VsGJx3cBnCdNme3lBh0L9+894I033uCNt7/C3bv3WC2P6EJnQom1K9iYJ87Pzvjo44957733+OGPf8zPfvELPnn8uM5dz6LrePjgPv/qX/9r/of//v/O177yNjF4qJTr1nFvDiYETk+P+Rd//Rf8+//07/nlr35d9Zj2FP29E2nEVcfjJ2f87//b3/DNd77F8eoIcWY7utOH3Hv9HdaXa8r6Y8RFqIC2ZMU5pdQpJJWRKCpzMzXnWrlqmUHQPCVKaaw6Y/jlarMtjs2gEIOz7hu5EIPHF2PGaRHwMKXM0SKSd5mpjDjf2XV7C/4Kxvy04N+YhTH4uhARnO8IPpLr4sp5h5eAz56+iOmQSamJDOyICqUkgvNMU67dRzxBvPmg6htSMd2ElGoANvsT81MhBqJz1nEQ8F0gOEiaicHRxYBkJY8ji27BlIVSEmmyeyHeo4gF+M7R1SSKd5ZY8Nhz8KJE7+iCJ3ghBkff9YTQocW6NC76aPY4pzo0mgOQ6m/dPmjLiXHYMI5b+jwRY+B4teLhvfss+o7dbkspe027znuWfeSl+3foVyu2my3bizXDbsfFxZr33vsxv/n9b/j+D/+Rv/zLv+S73/kOr7/6KneOTzm9d5fT01Ne2+7YbHdzq93Ly0vGcSDGjsWin9m5R/2KVVxyvDzl7p2HnG/OeXL+CU/On7Jbb9lut9a1UJwZdPK+HbLeDHi37UpXjLpgrKHS7J+u2BLY+5oXmOXGrD/Mph5a+eaynvt59nZKq/+/1kBxvtZ2kU2T8Yo04/xe8/kHGgrz77f+BW79xK2fuPUTt37i1k98ET/xJZU+Xb9bXxxQ2W/XgZMveswXnef6jfl0eK2UwjhN7HY7pnGsrbf3g2o+QzWeM7JXDOF2iBku1EpqGnAjUtkN+85Qzjly2LeyK2lkt1XSGIjB03UdEg4foS3ac05ocUj2tjB3DglW+kIFato1llIYhpGUC0XV1LudtQi0zEczIcwGxYnM5T2qaiU+xRDDxqgRhJzbhAUfIlKsrGuxXBD7hdX3Ijg1oGaxWLE8PjGgpusrYGAGKadCccYg6fqePE1zq+aSMtklgg9GcFXAeaTztN71dhktQKgL+erYYF+Hi9gxnVZ9mhntNOBpFl4WA2BMdKzWEKvW7lt51rhp9agG8gVcELolOB9IOSNuwMloXQJyqs/GsjCpUlW7qlHjvCdrmUEUa/+eyfU6mjgvDpwEBMhpZFw/paSJfrXCuVMrEZJAkXIAnbTyvSq8VsugGnLcADWqw5qV18HYLNTIYUr1GqrzKbmOuUwuaqCX8zgfaDWuwzDgQiSOPcOwQ7UYUKYGsJWUSLsdaTdaudNmwzBlSt8j9+8jyyUSYp0CMte0uiB2779M03G7PbMJbe7IAUhZQVK1LE90nugcnY/42KHBMWFdDHbrHV4jX/3aW3z7W9/m5Vde5vjkxMBoak23ZqY0cX55ye/+8AH/8IPv8/3v/4Df/e4DLi7XVpfedVAyq37BO1/5Kv/df/Nf8xd/9Ze88vJLdMFKBlVdLbuTufmdZTgyIQpf+errvPX2q/zqt780sXZpWZC8j60UjOjumMbCP/7je/ztf/g7Hj54yJ2TU/CeuDzh7qtfYX32hKe/XUMa8JKsswYVYG+3ykkto7RMW2NGzsxLtZp7019ivibTSqvHKdYtxExbsO4V3lHSWMshjZ3nnZgulvcslxGnpjWQygRSCA5GClMa6LpoODaldh6MRkYU02fbTgOpdQyhkKXgRAkIuIiPnqJixy6ZIJBVEKyVqYgtqkIQSpmY0oRkq/F3GFDrgeK86SIEWwgE73HBbI/zAfGCNBFzhejNvnjniHHJMI0M44CUbK1me19B34T3ZtelZv1wHo8tYpaLnkUXiNGb8GSIePGkorXU2M2mUtr/xDOnl7HvigpZC2MamcYdpUw4WbKMHS8/eImjoyPOLs/RrHMiqO8C337nq/yr/+pfcu/llzg7O+fDDx7x8Ucf89Gjj/nkySPOzi+4/NnP+O3vf897P/4xf/Hd7/HNd9/lrTfe5O7JKauTY47v3KEUGKeRNCXGcWQYtmy3a5wTFsueo+WSzi/o4xFdXNEvjjk6vsOduxesLy45O3vCxeUZu92GlAdKmdBaZCzyLJPxuXaiBd91/8OAt22633m2H4efn/cTKHXx7Gpwb8pqwrzbDQuCm67p+vnn4HsOrmvwrcaS3XdN3Af6LSawNYbO4MMtI3O/3fqJWz9x6ydu/cSn2olbP/HM9qWVPn3+1dB1UObzH+/KA7nhQV03Ylff34M1h2jfDWe5di2NBmkdjtqgOgSrWp3eM7VtxVgLTgyscb7RPgtN/Lbte2iEG+iTpsnKXErBSyQncyolexN+lb2qjKKgGS0ylzztiSEm7JtzZkqJYZzmmknnmimpi/d6Cww59/ME0pzn7+e9GR2jRE7G6JAKbtQuQe6ApeFjR4gdIUZiCPh6jK7v6BY9seuI/WJ/S+u9UyczGKS+avC0Z1lZSnPpkZgza9Bro69K7bi096b+yrOltkGn7MvVKgrT7qqBEI1lVJEAbQCOGlslty5c2p6n1Qk7IIgJrvXLFQ5hwhkugiCSKCXXUietrdgHYyr5QISZKdTGtYFFeX+9zqySE+vaBG7WLJrR4fbZqvlSz74vXcOCDtVi9E2x8EAbRaoxykqZHZe2e1+PZWVQV7WY7Nd9+WBRJeVc29cr0zAgKVGcQ1Rq2VNiXK8ZdyMpZWvjvVjhjo5wR8f2HGR++vMMaOruzTZ+1u1FRvNFWYE/1c16tqm1Tm82sRoQC0EcXdez7HpCrc8fc+Ls/IJxl3hw5yHf/sY3eOdrX+PhvXuWQbXRRkoTKSXOLi74ze9+zw9+/CP+/h++z69/+1uGYTKRwsoE62Lg5Yev8dd/+Rf8m3/5r/jqV97m+OiIEIMFS7XjXAMVkxqLLefMbrfjk8eP+eUvf8FmvabkiSaDrmKZND0oZvbOWomWUri8vOBv/uZ/41vffJfvffe7gJ1neXyfl15/m93ZH9gOl+CquLta6V/z4zZMPYLa1K2234mYXli11c7tSwOcc9ZZoR6gVJp95TEaqO5skaCaqn0qeMB1kVGzdalQJeOIyyWTmxiGHb7hqdIaERS0JEIXUOcYpolcg07vHAWsC4kz/TFRo4wH8aSUEQKiYvc7ZYJvbMrDskrLHkeUjDE0oQpRFk92AYJlSrsQCOLtO3tHauNOnWnlx0AMJh7qvRDxOOlseaMFLwGlapTVf13bN3i64Fn0gaPFwrKhwZl+lvNQhBgd0QUDn6fWJS82VzUvroR2/9TEUmvJgGA1/V2I3L97j5PjY+Rj+74mtF44OVrxl9/5M/7v/91/w4NXXyWlzMX5msePz/jN73/HT97/KT/66Y/4/Qe/5/GTJzx5+pR/+tWveOedd/jen32H7/35n/PaK69ytDqi7zuO+6M6jgrDbuDi/JyLi3Mef/IRXddxfHSHo9UJi+UKvGO5OCJ2HSerOxwfn3J29gnnF0+4vHzKMG7IZYJWhmHx5p7Be23bR0bsDbHITD8/3G6y0zM1/PC/stcqmD9yEC9Qnj3W4Z/7mO/qYvdQc3B+ni0hYZH5bNvmc9IW5q2NhMyfu2Vr7rdbP3HrJ279xK2fuPUTn99PfApQc+WSn/NeA0L2vz/vpDeDJdeBkP35VPf73qQd8WmLpU9fTO3Bmk/b5itV6wwUYmSvV3OVUaOqc22pc26uHwVD8rTu2YAamfuGNfxA9sduxyuFaRzxKI5ATlWgygk559rmu96XA/plKeAKSJGDTjq2QJ5ysrZ8k9WbOufxWsGZCmAZO8ME1VwIMyiV00RTYfLWZw8KDNthbom974hljBDwFRm3UqUYO5aLhdWBeocPjq7vCbEjLnpyat2GQF2xemWtx/UBFZ3BmjZZpCqsu1b+oxjTpV5D01/Zgyf1vjUhp3bNs55PQUvGnFAt3nEOvIkGCw1p96ia+r+WXAWLDawyHRmZ3Yo4K+la5JqzEUep9zKnOhaqEn8eM9M0VmAoWRmdsxpvqewWLQXNiVaCJc4hXsEZUCO1O5mrrBOtuY0GJhY1cqEIFfCroFQxTRiVgmhrcdg8vtYOWuWAdVXZNhjd1gC7gkgxY1nq2JT9rC9Yh7NclFSUcbNBneClss+SdSLYri8YhkQuoDESj4/g+BR/dFwn3Z75tZ+0LfPgaKrzt/jKl78FdVAzZkotvRNj8UUJ9LGnXy3JAuvdwPnFBbvNwKLr+bN3v8G3v/ktXn7pZY5Wq2orjd03ThNPnj7hV7/+NX///e/z/R++x0ePHrNZb21u1/MtuiWvvfwK3/7mN/nrv/orvvmtb3H33j0TdK/tN6XYeDIlPsz2MfHo6WN+/atf85Of/ISf/OTn/NOvf8UHH3yITH7WsnLiqt0ue/AawbmAloRq4hfv/5S//Xf/O2+/8SovPXjJwEjfc/rgFe698Tbb7TlFE6LgcsHVjGHCkVrAS8G1UsqU90w2O139V2bf0tpkimA2Sk1rgAlIFUBVZ50nfHX2IuRS6CVUHQBQFyjOI+JJOeFLmunsghBs9cE0DPiuQ0loAi8RzQ7vBaJHlrDLW4pmijf2o4+eNCou27Po+4yqfYeUEzmVys4USqlCjM7hQsFFYRwzeXB41yMBQhCij8S6QLPvmCnZetO5KiZZhbsoJLpgQuglFYI3NuoiLOw+l6rNhRCC+aEQPYvY0flA76ytLVVQ3rrdCUY8zCgJL+ClivBLe0YWmdrrUAjknEjTaNh1LoTgOT494eGDe/z8l9Cy7yH2uBA4Oj7hzr073Du9hzjPvXuZV18b+eq7X+XPvvNtvv3Tb/L3f//3/Pi9H/PR40d89OgTHj0942fv/5Kf//x9/uo73+Pdd97h4csvc3p8Qh8jfehYHHesYs8ydPzh49/x69/8E+thx/L4mAcPHnLv3j2Ol0dEHxHXsVwcA0LXLVj2Sy4un7LZnFMmGwdZC9m1MarmQlVxaotdhXpf9hGXCpDlIA48jMWqCH39UCsJbn4DsRbNVxqJHJSyW3LEPiCwz3iy9zuJKrKK+QfLmOd5Prl6SAVyfZ56EKtKW/m6tgi2v52r+x0E3+4g7vpT3m79xK2fuPUTt37i1k98fj/xKe2594v/54MZ1yCjL7R9OuDyf0Zm4rqosaqBK7HrWSyPoLZh861lsnMz0NK2EMJB621D9a1sxBOa/gcwjlNFjSvd0lXwwhuSrFXRZspUR2ClL+osA9DO4Sqy3i56GgaYJsR74nIJ2DlyyaSUGVNqwx0UUs61ttUmT8oJj8cR21LXzlVRJVEghLlmUy/NeToRFkdLUppMLFdrrWkMLI9WhC4SgrX3i11HCJEYO3zX1bbnnhBkvu8h1lIfjZQU0FRb5YWAi01wWOxvH61tOJhT0sNFujF6rFuSBQoNXNhPdIEYjCaZqW3QlUM0deZuOAfBXtNELe9SRJOZFVWkM4DIlUIeMk48uMByZR3EptWIxAvG7YY0jqTkySlRMngtOGeZkDJNjOOA8/YM007RYC3LtbFbSkG8p6RsLc+jJ/RLAwW9N8eQk2VM+kjJVsDpteCj1YOrCJqT/ZRs7KJG0TQIGDBQx4kj1+lbNFPSVEvWaibEcKzKhPJWg5wyuYwG0GRz8loKaRh58sGHOB0RLUgXUI0UPJNzuJM7+MWS/uSUeHKnljtdM25X7LDU/+ar7+u1HZ/Zngce3243beosiEGM0msigz19tyS4gObCxcWay82WcZpYLlZ882tv8+7Xv85rr77G8fGRzVdxDFOiKDw9O+NnP/spf/cf/yM/e/8X/Ob3v2OcTM9J1WzNou94+PAV/uI73+Wv/+Iv+cY773Lv3j36RT8LPFpYU7MyKFPJTGPiw08e8ZP3f8Z/+v73+eEPf8jHHz+ipGKMrQxZK3jrLPsxM/KgBv8VFLclB5th4P/37/+Wd7/5bf5v/+1/hwsR9Y6wPOWlV7/O7vyCj3ejaU/5ZDbca6ViH0QmCGgN5GqA7FogfoAyttfqDZkTBk7ENAlbakHEWIJqFGxc7T5X1OjjCOLFWG0lsQgBV0wGfky1VWwIBuxPCacVtHdCngpTnvCdJS1KhuA7CqXpmoN46ywiSgCKt+sjW2CqauKHIUQrdxX2TD3NRqV3xRIOzmydOE9K5u9M6wrA4T0sFtZKFfLcuaNUkUMfTMcMlKwZzZNlgJ0jxkAXTSCyi676nkKI3trGYveIawsf51wljdauFy1xhSUInBg4b98pUyqgbk+usFx2HB8fE4NnHLMFh7mQcuFivSalWjrsPT5G+r5ndbTi9OSEe/fu8tbrb/LOW1/lb//T3/P+b37F+WbNo0cf83/8u3N+9f4v+cY3v8G73/wGX//a101M8vQOi67Dx8Cde3fx0bLPP/nF+/zovZ+w3v5HVqsjXn74Eq88fIXT07scrZaIE6Zpx27KTHgSnXUF9NZ9Ms9BtI0tS2HIVXt88KfFx/MS6trm5u4/lvU/OMgLwtB5fohZ/cNgvwXh9QqfBfXrnGr6gfPUYr/g3sf7xu5tLzTttSrLB/X4N7G5/5S3Wz9x6ydu/cStn7j1E3xuP/GppU8v6ohysBeHgM11YOXqBci1f9vvn82ZfRan90KxoquvPvOZzwIIeR+IXQ/U0httytCmTN8eZFuINuFeV6l77TzS/j34aahaXRcbcFN/XAUXbAFcjatUxLiybqx1mxgw4A4QpqqZArXcJGWmKZlgVymzon3OzdFoBXzUxNJEajvACtTMJTNSEXhbjIfKWvHemwiuQHZCcELoooEyMRJ8INQW5i4EXAj4EAjOqIPiqqBXO4+nlj6psT6cgQh2z+zHWDnWslu8q52eDkeXeYXGrJErCGYznwqVqupU52dgsKl53lzrfL2ENrjsWnO2DJELSKhslKIGKlWY1nnf5qjdp2go/KKY+K6LAT950z+aJgQ18ehsz9E6AljN8Uytq45Xqqiva2LQDUxzdTx4NyO8ouYUWhmfF1/L0boaVOg8bkHrudw++KjfGye42kpTciZNk7UjrCCNOMGpM0CoatLkcsBOqj+lZFKe8P2KIp3RabsO8T3eR1zscP0S13XExdLYQY2efMOs3puAA9vyQjPzItt2u71oU6c1E2LAc/CRGJfk4qybxTChwMsPXuGVV17htVde4+WHL5uoolGnKMB2GPjk8VN+/vNf8IMf/JAf/PCHfPTxI0pRxpzJBeu24IVXX3qJb3/rW/z1X/8L/uyb3+LlBw/pgpUUqlgAapRXs1mpJFLJPD57yg9+/CP+v3/zN7z3k59xfn7JNCVz9Goiic4ZgLrTPGdLtM4hDrq8ZbEAXQEV4Td/+ID/z9/877z9la/y9a98DVc6lI7lyeu88sbI5ZNzLoYtpAnEwMPqDbjqF6XOswaIVnp31TzbM0xriKLgxO/LCar/0fpeqZTc9n7jwVtwaO1eXfVfnTdNs6LFRLtzpgQM5C0WHEb1BBfIlSo/jROaxajoBVSFnPLc9tI7A+RVa4lCUROiVEtkABZYI1gNqAWzQQQJHqnd6SQauO+dR5zuu78VDKT3incKZIJ4ovekcTTdMDG/rRRyyWgZcZoJXul7YdF5Fl1kESNdCPTB0wWHNTdsizjLGrvKVJy13powvY2iPRO4LaxUoaTaXS+Ry0SQgvNC7AKr1ZLgA2MV5yw6MaaJjx494vzigocvJdNSqCWeCnSd8ODefY77Ja/ef8hbb7/FP/zoh/zopz/ht7/7HevLS377we/58JNH/ODHP+LrX/sa3/nzP+cb73yDt954g9PjExZdx/HJKV2/YHV8h9XxHf7hH3/AL/7pn/j+P7zHsl9w7/SUO3fucHL3lH7RE3sTbc91keRq0wMfPTGEWsrgkKoX0tgF8zxqNgNASg2TD/2wHETqhzZZeb6NtvdnBvJ8qKodV88/76mVxn7QDvWZUvMrp67l7vXg1mFXG4HUFsyqZmrqyVpsx8G/f+rbrZ+49RO3fuLWT9z6ic/vJz6XRs3zQRtB5Nk6spu2/eeu39zPd/7Pf43PvaLnvyP7lZ3UAaHYYjvE7uCBay1dMaPovbfXaq1haXol148tDW2VCuJYTeqhkW11vFKNp6s1pcYGkRnSazo2WRV1zhh9YoasVUKVnCstrzBNiXFMjOOE82YcC6apUkrVvikG0rhqEHMxtXgqeKKK1eXW2/T/Z+/PviRJsvNO8HdFRFVt8zXcY9+X3GtJFEiwSWwFcsBqsHnY7MOZPvPSD3P6H5qHeZiHntPz0mfYIAESIIfNIbYGGiCW2jIr94iMjH1ffHczVRWRebgiauaREZmRhQIBskzzeIYvZmqqoiL3Xvnud78bk0EVIxjnlDEUHUbxA6qywFWlMmmsxRqbSsNsQt/zz6YDHTpnYZRS2iHRYpTxkboc5e5QKrqbyoPSis8+p8M1jGq2ZCBrFmFNs6gzroJ0XZSyMfVNA8REg5uCIfpBCpCF4JDou/KhDnCzWjObYQrjCgRHleaRqS3eKRDXGpMyUCSfnK8rKCAUBIIgwWAKdWCCqHBcAmOyLpAYSeBOzvbo/CTNKVs4bFFii4LcGSvO6Pfk+RqDZlw6oEZSBiYCXkvijHNEk0upTGfoYhrrbj1IYqChwUUbPMVwiLUOrEVcia16CtKUFcaWCrLZXIb14uPzaz/OWuYXvEZPe/DXMvO3Ly+3/Gk8os1V+hYfoG1Vv8g5S78/4sipNY4eOcLKyirDwYh+1cOIsrECnr3JmAePH/PxlU/5/g/f4aOPPuHJ46cJGFY9rxCEfq/HodUVLpw7w9/+mbf52utvcGj9MIOywqJ18DnQJHW0yznDvck+127c4A/+jz/ij//8z3j45DFNK0BihaU28EYM1hWUIjS+oQ0t1lra4POsSQ49ay2oPoAyxQLff+ddLl64xJEjR3ALJcFbxA5ZWD3FoaMP2d16RNPu67XGLscCCEaJuhzQepqZjAdLYWOX/RVIHVNAWZ6JWYnqP01rp9N6zcAuucY6IqLjpUkAi4+GUJTE0ELKfEcTEO/xjafsVdr9ow7UbQNOgXlj0LaoWG19a1RQMhCZjCeasEA6zYScnMjZW++znxSscQn0VWC3lVyqqVlSHwNNKr90zmCNJ4QGCQZbOgrjiNIioh1QnLPqp6NqSRRGKJ2lLC2lg8oJVaHdO1whlEVBFGh9Q4xWyxBkqgWR7UHOUnfaFGl8LUYnY4haHpEYj/l12dcZ48gcfD2VClE+fvqUp5ubtL5V/xD12iWqqKUVw6DfZ3CkYmFhgRMnT/Laq6/yw3ff5aOPPuLRw4fs7+9z//59Hj9+zGfXrnHx/AW+9tZbXLp4kaNHjrI8GFFVPQ6trvP13pD19WN88NHHvPvej7h+/Tobjx/hfYs4TbKUgz794YD+cERVOarS0uul7O1oRH+hz6AoER+o2zER33WajGlOKuuAlDTwz4DqyaZEuvIA4sG/Pf94RpAxtbB97rtSPNBlRrsNbffpqZx3dlssXWAuceaySMF458j4nG+alz7pMfcTcz8x9xNzPzH3E3xlP/ET6vr0ssfLACfPeddfSUbiK5wz99kSQRkZjrKq0gMEH1ScS5G0SGjaJA4lqgj/AiBq9gEbY8gEmIx060crgq892PX1hqTDMsMMUdqlAi02Rkw2zpKco4+EuqEJgaZt2d7eZn9/TNM2FGVFUahuSr6fPKGds8lA6L1EryrrZVWmaxYKV1BPJkz2x6oAb5XVEto2gVqOwqp4ri0TwBUUmZcCLIKL2n47iiLPCqIo8CEGpNT70/Ikxa6j0XpBV7j0maUCPDPPVkRUXd8m1fFci0NMQIHMLB45sHg652htWlhKXDSplEsf3BRMc65QACIGrFTYQol1PqH1MbT4plVtm9T+T0Xr9Jn1h0Koevh6QlX1tVa1rZns79O2Lb5pqPf2upbV1hXdLLK2TKyrxLQhGeoEHBqrLKcsKB28R6Kq5WMdVdXHlVOgxqRpLzazuGbGE0mt1tOXLZK4dINvW6xXMWSdywnEgsQumzqREENHE2wxeFOycuw0vcECRVEhPtezZ1OadYcOgp4vd/xV2JD5AYBo61RrDM6UrKwe4tChNVZXV1lZWmJleZHCKYuOZMeiCLv1hKdPn/DBxx/xp9/7Lh9ducyDR481gyYGX7cUrqIqS1bXjvDKKxd5663XefXSRY4fXmfY7yMpgOZARlCIRkUJvW958ugx3/ve9/mD//0Pee+jj9hvGnCOEFLAg2YMi9KRudhlWdGvHG3wbO/upM1AxmKVRWZTiO8xINq1bWNzmz/+k//Iq6+8ytvfeJvCVHjrKAcLrJ86z87WQ+7fqglxF4MCuc5ZYpvtWsq3zQD12llQj+xzogcN0En3HxJoKlNwOQWFkYBL2lyk9RiCp2maFIhoNFE5q1lO7zECZeWQaJlErZNvvMcaS0ugbSc4aygLTXM3IWqNfptsdFBhSesMYpSBaa3QtmoHbBJLbwP4ttWsc9TbsNYm8Nck8Us120XKVocQadqattEuIaUxlM5hbO7WJ1rfH8GKaPmwBGJoMNEjBEqr9PVeEoUsnFWtNB0i1V0jJStA7WTUss0QwwGProFZLiVIm4q0wczZUhO1fazBYMXqvUVQby5dosP7kLpBwsbWNo83njKuG4YjQ/ZckpMDEfVhzrC4sIArC1YPHeL0qdO8+frrfPTRR3x69Sr37t9nb3eXx48fs7mxwZVPr3Dp4iXeevNNLp07z5H1wwwHQ3q9PiePn2A4WuDosWNcvvwJtz67ysNHD3myscne3h47u3v4R49xRakBeGXpD/qsLC/THF5nUPVYX1plaTiibWsar11a6qah9S1NamCgbN3ENk4LKwZ/MFJKMdRLxX/PIOwmJ9i6RFsua+kGsROZfBZ8V9H9KbCf12G2ATnCiGjIMM3Rpd8m/2SM6dgN84O5n5j7ibmfmPuJuZ/4MfzElwI1Ly5heu6rv+QcL7tZmt1oP/v7l3N6n39oX/zZz3/IaUMfRZGzbOBDamVdllNQJS1AXaUBjMFEFRPOclZTloaCMbO93U0GC6BjuEzV4/N16LvFCNZZ1cYxCtbEmQedy5ZCiLhCOtZKzFS8mJFaUUOY0EuS2rf3mTppMKbXfT/L8/IxJGBFMF6Fc61zKgzmHDa1A5+iwVNEXIEmfbYmRqW/eZWZs86oJkpCbUQvVO8r6q9VlFY/W6x+piQqZkxEI0THUdKzFeO6yaT1hbGbESICRpHwmICMjEqHhF539FLRUq8YlZLYPaEYk7iwQDRIej/ErpwMD95PEN/qNZVVNzWNGMQ6BeBEy5e8b7FBgS/fNKo3FDy+EYIXnLPYwqneT+E6cWkIkNhP6oxT4BAzbXd2XoFxFlNoq3dlD2kpnD5PnTuI6LzujFL6n2jJlcrTGYwtIDG52ui15C4hjHFmXHU667wLMYJ1mLKn4+dDynBkgRtJzz+kKRhnL/+Z9ZoPee738uyfnjnkIFZ3wOZ93lDPwR8AP4GqGnL0yHFOHDvF2qE1FkZDer0S55LOWdBg0QdP4z0PNzZ4970f8c4P3+Xjjy/z4MljDcIUgqUQWFoYcOLYSc5fOM9rb7zGxVcvsrK8yKDfx2abmFlxgAK70ARPHVp2x3t8cuUT/uh//yPe+cG7PHz4mMYHxBS0jdpkayMQcNZgRTWdDh06xMVzZzl/5gxB4N/++/+NazdvUPu2w+xNAkJ9Ai0jETGWGODqlav8/u/+HkfXj3Dq1Bm8DdRE+quHOH7hdeq24cm9qxBrBNUmM1bVK0NiKpIDk3TMlhObxDbMd26Mim57HyicimJGn1h7rU8tXQGT/JE1uoGIunGRALYTyhNqaVPQqF82qk+xQhJJjMTY4lzFYjWgCZHt/TFtW1O5glgHvG8gBoKvyQLwzkGMBW0zwYdWfZzP/khLWpW2ra1KQ0gZ4Rks3RoICcSXaCiqAodgRcAVWFNgjKNwJc4YjNMxNSZ07y+soeeMZkqtUBhDYQvKosAV2lq1dCWZdWitw2FpU+eOjvosU+Dah9gJCaoPSDZL8mbNUUhJ5SqMFGg7ViBa/Z5Us+9UDyzg2Z9MeLq5Rduof80BHcRUbqobQIzgjGPkhlS9ikGvx5FD61w6d4Gbt29x+coVPvnkE27eusXu7g6PHj5ka2uLq59+yomTJ7h08SKXzl/g+NETLC0usTQcUp07x/raKhuvXOTBgwfcvXeXx4+f8HRjg+29Xfb29mibhnEzZm97m8neHnjP0mDAkeUVrDEsra5jncPHmJoW1NRNw7ie0NQN+5N96npM3Uy07ACAgBj1zSF+Bfv6jOE+UBQb9efZ+HH21LMMhGxGkMw8Te4iaglI1mtUq5H8q4Tk0nTF5gzsVymn/2k45n5i7ifmfmLuJ+Z+4qv7iZ8go0YSRelFYMqXgTX5fV+EjOXz5++fc5aXcopf1XGmXWZCz3Rwoah6yjZRTCFtPNGHNTP4s3eesBYyCZRIokhJ95pcLpJFh5K5maL0SW8kAyDA9IFLUhKPqfQltcUmsWWUMZMAIzEYo4Y6RhXi8t4zmah4rrWWqqoOjJrSLVPZTIxJfyQJWTnbXZtNWiyzQI12sjLTdncoeID3nVCx9SVRglr+xB2TZ+dUHlsjHZCQMwNCBryy4VbV/czwCAA+33++sTTCZnZ2heziE5CTxtQIFC6BDamuMrGXyDWoMS/RtKhtBhb03+B17GzqwtQBEZLuR0pEVEvHxIAxBu9qBPBNjRgIrYp7uew0ijT2Yoh4BWuTAF1X/sTBVSjps40xSdcnjWOQVE4WFQhLYIxCabNr5xnSoAjGqmBcBjTJAGL3/HVU9e/Tcj1rHLasuraDwXt1RtNZ182BDEgfRHFfrvTy5Y6f2Il+Ko4L5y9y/NhJDq8dZTQY0SsrEI+ROLUVRPb3xzx89IhPPrvKX7zzQ977+CM2Hm4S26i2zgiDXsX60iKXTp7mtQsXOXfmPKdOn2ZhdRnjTOqUl9hiYrrsKMn+tSGws7/H5auf8r13f8gP3vkh169exzee3HrVGBU/j2gbUmeEQa/HsaNHuHT+PG+98Tqvv/Iq68uHGNcTHj96zJ07d2h92zluSYBz8lgKKosGePWk5vt//j3OnTrD4ncWWFpZ1OAXYfnIcU61Ad+M2XlyrwPjp7Yodkkf1Q7LHepmbIQIEh05r0piGRox+m1MQH0MhMZD9B1FOAA2rVHx4GPWn0oZSitY45OIZMBGKJLNrwpHHRts4RBRkW5jDFYihTPU44baK/Xf2sQAlaDuM3jaNtA2onoDbbL9hWoLSO7Up2JkHavTOYPixAHaFkKLCBQGbGEojNFrtI5gVR/MSaFaZ0RsYQlBcE5LHgyCE+g5R885SqsZUlcmwNsVulmwjuADIbZ4H1NWO3a+utsUmBQwJ3vU2UpJsySSwHeHNQVl0cPZUuOGEPFBaFplGhqbhNwBojCZTNjc2mLSKCMzRM0um5lYyaAbkuynCutwPcOgrFgYDDh2+AgXz13ga2+8yeUrV7h85Qp3bt9mc2uTp0+f8njzCVeuXeGHa4e5dO4ir168xPETp1hcWWZpNGI06HPs6FFee/VVdvd22NneYXt3m52tLXb39tjc2mJ7d5u6nmCtZXd7m+2tTZZHI6xZoVcNKasS1WQINN6zP95nPB6ztz9md2+H7Z0txuNd6mYv6URoWfHnknSzIUD6VeevZzao6U/T1+d4S1IIJ1k/4PNH1nYQy4Hge0pVT4zVqAXAqnFi8MSOWd1d4xyoOXDM/cTcT8z9BHM/MfcTX9lP/IRLn6YT4+DtvTxI88UgyvP+9p9iUzULEIFIxBphefUQu0+fsLuVXpVAGkESu8MknsHsqfL2P78WEFFdjvQpIkbVotPfbQI7bOEoCjct9UlME+89vk3CsInl0V1L/gyESVPTNA1N3XRVuW1Q0dg26uf61nddjozRRRNj0PpDSWrxgrJaEmAVrNduWMbhjJbZGBEkCYDpdblOg8aK60AOIvjGY0Kq0fNq2KEB65jWlDFlqcSQBJMdkpgkuVTKpIWqBKGYBG27Lb6Or83dtp4FGaxS7LyfXjcGhxBMFl0LWGeVvtg03bONs3NX9DNAwQpTKOgWraEC6slYdW4iXQnYsywfax3G6NwprMO7EmsUIGrbGt82WFfMMGoK7daVSp9iUJFoUutIkTSUCbDytN01TkE/HSyxNokTpzFN5U8RzWBERM+bxkNiKqMSwRW5RWEktg1t3apDqyrKINRNi6/rRHmNBB+ofWBYlfQXFhkMBqnKLBJEG5qr8Xym3EmeZ0HnAfFfx/HNb3yLhcGI0pWpk0IGLiONb9ifTNjY2OSjjz7m+++8wyeXr/DgyRPGbUvlSopEiz127AivXrrIaxcvcuHMGdZWD9EvB7iiILd1R6LaIiAmGneIUNc127u7fHb9Ot9/9x3eeeddrt26zbhuMVmP3xhsKcmWQSHQKxwnjh/n9ddf4+1vfpMLZ8+ytramHQ+ioR/7/Ny3foY//bM/5frtWwTRoLUToUzrSv170gGwho3tLf7oT/6YU+fO8K1vvY0tHUEsrhyyevws7WSHa03N/uZDQqxTsCG0IqoNlUDWGPS+deORgr5czhrSNfgUHxjwBKKo3piEiCk0KxpDxCcq9hS0VWZjiOrPJK0pKxbEp7SkAvliIBhDCA4jFt9MlFIONF4zd6XVTYFeo8OHnM0TvNdOKaFVX+eKgnrSIOTYJuCzD2Bqs7K2Fhi8RHxT03qPWEORu92hJbpinZql0FD7hrKwOInarcMYClfomMSAw9ArSoqioEgZVWcstqOh69i6RKGH7A9larazllpyMFkLTEzSlMjsTiP4qOxPV/Q00I4g0YOfMN7dJvpWGbshaOkv0LYtmxsb1M1YN7EpWZAFF0ParIWZOAJStGIsVWUpioLBYMDhtTXOnznLN7/2dW7dusX169e5efsW9588ZGNjg0+vXOX2jdt8+MEHnD53jrOXLnLi5EkOLa8yGg1ZHgxYWzuEQQihpa0b2tYznkyYTMbs7e2yv7+P9w2uLPAI47qmKPsY0U4kkQhNo91K2oChJgadG+O6Zn88IcQGZ4SiLDphUci6GrrR1YRM6JIp+U/ZH+i3OhZZ58KkwDompccuKJ7ZwHfBt+gYa64oIkE3k16UcZs3yF1iIOoszuun26Qb0wED82PuJ+Z+Yu4n5n5i7id+HD/xlYCal2erHAQ2pr9//jkyTUj/Pn3t5z+fmZt5FgyC/KD0JfHA36cfO1Xbnv7tZcCh6TWqkJil6g1xSRcl2eJk3GIHSqgzontqWvqh92GcdJ+QOxBFwFiXJkYk9z6OEWLriTaC1YkVvAc8wadr61DWBDIYrSVtWk8dJkorq2vqumZS17Stx/vApKmxLqphDVOQIsZI09QYIzirSt102iT5XiVpn2QR3ZC5XlgyAi7dWEiIiMtOJLkBZzGuwBYVtiq7DAihRWKAaLEmlZ+JIRKngsMmMzACIqr7krtGdQtSbEKyowIRsxMii7YwMw8Toynr12hpmU9ZmdSxKNEdO6FcmWFJ5acaSVh2YpMYwJUUkcTEmo616vb4DojSM0i67zxJevjQYmtLWxsFc4rULcsWWjJltJSJ6cxL5w3pvDZlUqJq/MSoUIhM5wxRC5mipms6OZ7Oo8TsNjMomJvuJXGtmbXQiQcnIeuclvE+4FutQ7VFQdUf0h8tYsSRASBCTLVuaWFM01TPXacvWsY/qUB5nhl9/rG6ekhrs4NSnUVUvG9ra5u7Dx/w6bVrvPvuu1y+/ClPn27g20CMQmULFocjzpw6zjff+jpfe+NNjh87xsLCAkVZpLlm1JlKSLTXqHXhogD1/v4ej5484cOPP+aH77zLx5evcO/BA7yPtFGIwXTAdYiqHVY4pbAfXlnhG2++xc/93M9x8dIlVpaXNSArUleQCPjIxQsX+MZbb/Lg4UOaGJjEmDJXyVGn2S/JrgdgEls++exTfvf3/4CjR49w5sRJrCu0A16/4PCZizTNmBuXa9rdx1iJ5I5+kYhNwK0PnsxUnVk+GkwHTykaRBuBNgYw0GrEoeB3FPAZFJeZMsQIRk2iJqm1FFdbZqptNjaC+KQ/FTs6d4iabTao7oAk9mb0EeuyTpb6r7r2tKHVIN86hlUf33p8rUDxxHtMBJ8Co1yrncXxWw8uJjZk2xBTSWdpdLMXQ4uzgnWCi5p8CEa7txCtCkZah8VS2BJnwcZA5bRjS1k4jEs579wtJZU3iIhmITtzp8GcD/o5U7uofi3bpRBDEj0nbR50vG1Z4noVGIMPDSE0TPa32N3ZVD8S0xxICQYTI/t7u7RtAyamzjea7e+C7xDBT0twFZGf+jQjlp5zVGVJr6pYO3SI82fPsvm1r/Hw4UNu3bvLjRs3uPbZZ9y7d497Dx9x98kT3vv0MofW13j94iucO3OGY0ePsrq8wsJgxEJ/gF3QcQ0+bRp8i/cNPgYmvqGJHgkaN8QY8a2yDOq6Znd/j83NTXY3t3m6+ZRHm495svGE8WQf62A06DMaDigrr+1mcwlDinFUGyAVlMeuiGCaJNOBSIF6JrSqU4pdDC/TGCtH1KSoMndGBF1DIRJECBhN2ERNoMR0Xi0zkGkZ/GyGNMYUp82PuZ+Y+4m5n5j7ibmf+Op+4guBmrzRetHPX/DOF57vx33vF79+ek3Ty5sFWH6c63jeuafiXdZYyqqHLQoFIZLCuLIwYgdizF5UV+P2zLXkrynqN508uWWcAGRKXXpvNlahTeKtqeSEGBNY4YhI1ya8aRr9aluatiEkPRql1Ali9HxWps/ae0/btLRNo9ySJNYrxMzwSvdBEvBqFcyIin5n1Xgg1Zl6orHdWITgsbj0fqvCvfoHBbRyL7PU0jFBz/q65IjxIdWXJlArLQZ5tnaxa+c2fb4Kbsp04nT3PgUFck1h/spK7oqCdlZYcwL5Oc7OQ0E9ZDTaESkNXC637MqkTEz3nQxJvhYx6iyNUPgyOQtlMRmXNIGs63R/rLUHDHEMrdYyty2I0iIleHI3K2OsAmqSWwpO2TT5rvVZ6nkPFCJ1L5kFUGfumxSUeK+3lkT4snK/9wFbFRRlj6LqoZyooHM5KiNs+szk2cf3Uvboq+lsHbRzz7OB8+PgoYr9OuXGkwlbO9vcvH2bdz54j/c/+IC79+6xubnVOcnCOZYWFzl39hxvvvUmb77xBqeOn2BY9XHWJJA1ZyPb9BmA0druSdswnky4c/ce73/0IX/+59/js2vX2NzaJsSg1NIEOBa5Q1gWfDeRQdXj0sXz/Pzf/Xt84+vf4NixY1hruxagIYG0mam3emiFX/rFX+T9jz7i2u3buvYkAcfJNnQ05ygp4xXZ25/w/R98n9OnTrL8a7/G2soqbaovL4fLHD//Gnu7O9y9uodv9ykEKpP0vzKMLSlKTkLxWvNuuo4IuVkEIl3m1mWkNAZovQbgkldWYsElIXUF12P3JPWfJOwoSikPYmhiYisa2y15Y/Q6PF43XwR8GxFn1F4n+2rI5ZWuW/u5Q5+vdeMQ87oK0/vUIDcq/V1yG9aCEFS00YlqYjmnfzOiNtIag40mmV3RFqzG4ZLuQCmWyjkVhiws4vSZkYT/rbUohp14pzFAJw2ohyQ7GOOMNex8hiS9sFyOC66wDAY9ql6FON1UNjHydHubjc0tfIgzqSAd4dZ79vf3mYwn2rExCVZm/9KZxhxXfIFts4mBW5YlvV6PhYUF1tfXOXfhAltvbXL71m2uXv2Ujy9f5ta9Ozx68pTHjx5x87NrrK6ucv7MWS5euMj5M2c5fvQoS4tL9HqGoixTRlnXQgi+y2F6H/K0xQfdlNd1zebTDW7fvsXtm3e4/+ABGzsb7NdjfGypyoKVpUUmizWDUclwOKLfd2lD56cJH0m+oYu1jG5QonqJlCvSbGd27yl4mi0Pee4huuHXzjikkmY6l6brfOobZrUGcmLi2bGfH3M/MfcTcz8x9xNzP/Hj+In/xF2fftLHzKbwOYDMT/7I4IS25usNR5S9Aa4sCZOxPiCjhkpZbsr0MHIQkMlHZqLkrjgZpFE8QjfZWQPXoFJSNpUVESM+qJZHaFtsWQJBxc/aiHMFlVV2ivctda3Us8a3qqpdjwkego8Er+U4kYgrCgrrUimR0hCFlvF4AiFoaZMx+AQKRAmIQCEl0qHkAIHg28zCwyPE2CSNGFX+B5SNET2RHrYqidEzq+uTwYCYDRqJnZLEg0G1dfRcQUGrmESSs36PojGp7CoJfOUBn936z3yudTaBMYE6s5pI9MwmqZHPlKcJMQUhkpDwNl2rYG1S9dbC31Q3LdiqQHJ5Ugya1QmBkJT9VbMmgX/GppRG0JrudgxECicUlcMWPTrWjIDJwsCSf20So8VMEeKgpUWuqHBVT8dUBPHq9IWgYFhGf22ep1PgKo9fSMZHdWXUyUcf9PpDpG1aLXtqPW3dEhJQ07aeXjVQfRrrklaRZi6kK3eSZ/49AHWmn2eN6U/WFrw8QP3Tefi2YdI0PN3Y4PKVq7z3wYe89+EHPHj0mEld65z2gV5VsrQw4uL5c3zja2/x9TffYu3wEfr9IaV12BR0qvCdwQrEUKP6BVC3np29fW7fucsP332X7//gh9y+c5eNjU1lFXbAoGarJPXaIAZ6RcHSaIFTJ47ztTff4Btf+zpnz1+g1+93wfazjjmmILdwjjdef4Nf/qVf4jd++7d4srWVWn+mDNsMqCfQtUO1Vtjc2uF3f+/3ObJ+mF/8+b/HwnDIpPUE67DDVU5efIvJ/j5P7lxFwphSU44JlKbTOuv+33UKsCmwlVSGGDpw16CbCE3p6fV1IHcGVVNw0VHIuyNZs0RHx4AVR+sDhqwPkDYCwRN8q5sbo5T2mFiC0WvppTUWYywhBNqmYdJMsGKx6O6hKwOY1U9I9sUmkXJJ/tOIwRlJ+goGF7OmgN6ztXrzYl3SCdBOgoUtKKzF0FIYS1nYlCnVbLAYNJtlYtJfUL8WgpZfenwCjK1uukyO5ZK/I23E8qYsb95SskZEA/DeoEdZaXc+HyN18Dze3GRzZ0fPlRMEyaT5NrC/P2a8v0/btNpRL28o05PSZMaLj3wt+fusPeeco6oq+k3D4nDIkbV1Lp47z9fe+hpXr1/j40+vcP3mDe4/fsjdO3d59OAhV65c4eSJE1y6cIlXXnmF48ePs7i4xMJwqJoPVjc0oEFocNIlikIIOD8thS5cQeX6IIbd8ZjN7Z3kk1q2ZYzEXDq8RwyRqiy1bMGoX4hoyUHonoNhtpPALHtBYt5MSWcjngXjDw4a3WuDJDffjSfdvP2iMc/nF5HPBeQ/rcfcT8z9xNxPzP3E3E9Mz/2yfuIrdX162de9TAb6J7/xef7n/GUz4HqZ+UHp74yxWFcwGC7SHwwpyx57+/u6gFJHopBSB977DmlT26cPpdOYkRkmDfmzFAnMmiG5E1CRSl2Mc7iyQnyLFxWY1cJNizWOWOj76qbBRGjbhrpWtfXc3an1kSZtnH0rqS5VMwwxzVrFKZRVU9c1+AZrDIV1KuKE4CPE0BJ8i28dJoS8BogBJmQjJNCqgFjhyq6tnfc1veGAstent7dL1RvgXElRlLiqUqAgKAotzqYMSKrnEyAGQtsQWk/0EWMb7b60Z7RrkTFgBNsfdDCnoCvKe69iZum5xJjVUUCi0LZN1/LQJl2bEDyhaZVhUriUIZhmGqbdwaQDRGJQRf0YI9aVGFcgRalj1EyU6eJ96l7lEOfQM0y/EAErxCIgfe144Os6ac4IprQQrZZsxdA5BZ23OgaxSGcLERMgmkb/lkqlyEyhkNBnVxCbCRkcIzOhYoTYJsAmAoliaCzGCcE3aoATmCUIEgK+rmkbT2hVwV9b7+nnGKe6S+R7VbfcjaveyItWqaRrTM8gzgK3syBPZNYcfBUb9Dw7MmfX6HH9xg0++ugj3v/wQz76+DKPn2zokkXnXq/qM+j3ePXSRd7++lu8/uolThw7Sr9XYW2lWlNRpoEjgIhSoUNNCIGtnV2uXrvBD999j3ff+4Br12+yt7+v9jNEjDW0dYOzFmdsBxYXTlgYLXHx3Hm++bWv8fqrr3Dm1CmGgwGm7HUZupzhmAXTdQ1qaefK8hK/9As/z0eXP+Evvv892mDwSa9KQtDvxSRNqMTuE0OIgdt37vLb//b/y8LCAn/rZ7+lNfDGgbEM149z7s2fIUTP5t1rTJpddcqKd2pJqWRAPSjQbLTkU+upFUA1xqkGQS6fTELdNgWFatl0XFV3LIX0nwsOsiilIetCRaRrO0pMcY7JwY8GQhaDc6kDh/epbCEoDTgqpbn1OcjW1RiSrdIEl465SXoSXdmkMNXQImX8xKqtl5Shk9hlSTs2qk1dNGL6vOC1pt0ZKucS2VCfd+h8n2hwnMQ5jdXnh+QtypRRKwFsss4CM90fp8FdiBErEWMLTFHRHy4gRYkXS+thUrc8fPyE3d19Nako4K1sAb2v4NMGKqaNndeOfJF0TclWPmvLZtm/z4vHclbPOYc1hqoo6ff6LC8vc/LkSV577TVu37/Lh598zKefXuXevbs8ffKUjadPuX7tOpevXObCxYtcOH+R06dPsbgwol9VDHoVpSu6MUEEZw3ee4qioKxKhoMBy0vLHF0/xqlTp7lw8RIPHj+kaes0J1QLwxWqO2GtkMm2IfqZwNkkunvKT8yaYzONxTr/NR2uzsfNjtXM6JGTNpLETqPEadfJbqM/fV8OtJ8d78+f+6f3mPuJuZ+Y+4m5n5j7ia/uJ74yo2b2or/sNX8Vx8sDPy+3CXve+Q6ea/b76WAbYyl7fcqqp4wa0gIhLQyt3qDTpHkGmesM/czvu+3+zOdbaxOKqro42vpaS10yUJHfIyiIhKgIlQ8B37R433ZlTkr5DLRey6G897RtklsS0TrCqLXBiukos8LT0vioiukxQrRa3hOUahZ8i28skutcIXWfYvrVajs/Z1VTBVDBqUlDUY1pxhMm1S7OlZRVRTUcYaxT8a+qhy3dlBaZRysEfKNATWh917nIGBW2NclZhRC6zkY2adlEAVzokgcxGVvQms0MNggkdo50NaI5QdLVjBK0ftdMQZ/u3+B1XENEjEWcSQs7do5HJ4YaLIPTzlcxgy5xel3GJEDEqVBxul9b6DMnRGjbzhiFJNosRhujx0jKPkhX62ySuFuaNDrP8700s0ww6bIxU6DsmbVkDNFnB6FBSExwvo6BfoVOfM5M2T8Iua+ldI4lkxNnj/xzBl7kwN+m3ecy0Cqfe193vc8cL0TP4ce2Mf+lH//T/+t/5s6d22zu7Co4LBokOedYGI04f+EC33r7m7zx+qscXT+k1N5Cw5cgQghavx9E8KSW7T4wrsdsbj3l8ief8MN3fsQ7773Pg4dP2J/U2pJRVDvKpCxT4SxFEljs9SpWV9e4cOEsb73xBq+++gonjx9nOBjgrJ2y6tJUeX62RCnRErWG/Ozp0/zjf/SPePj4EZ9du6FArTUQPJa0eYgQ0WhA8UJtyfnRJx/zb/7dv2NxeYlXX31V28ZaQ5Qei8dOc47AZwKb967j2zEira5/NCiMPgk/JgBTomiQIdN7MInGHVKmKneGEKe+IhKTXoBP9mtaujm9/6jZKEOKVjRQs+kaIhHV29IgVJxmuJsoRB9oo0m2S+no1kpXomuyv0ssyJjFF0nPPwWtkDK4+vJOz8BgcVa7fYQkDql+T8FZZZ6nERLNljkjOJTV6qTAYiCkdq4I3ghSGIqyUB5fUP8YQyCimwzdTMYZKyI8LwzJpPRnmbMYi+2NqEbLiOvRBCEg7O2NuXv3HpPxJO2ZYmKJKutRkjZcWZQ4a7EzJcPQ7dEIz1zMs3FGTmx8LhjMG7i0ybPWUjhH1a9YWFrkyLGjnDt3jtu3b3Pt2jVu37rF48eP2dra4vpn17h96zYfffARZ86d5cLF85w4cZy11VWWFxbolSWuqJBUsmxsyuxjcKLJnn7ZY2FxgfWj6+zs76s+XgbwQ0haF8pjbZox48ke4/Eek8k+jfcqOho1ox1j2vjMzOPOOhuQJO6ZwfxnH+Cz61/dT4r3YqQz/SnOyn/LYzo7ts9S3OeHHnM/MfcTcz8x9xNzP/HV/cSPXfr0lwVjXsTAeXbzM/unL/rMWQMSO8sKz27inj2+CMnKWiJ6/mc+z1gGgyH90YjecER4cE8NkoAHsEypVOLU+MxQy4wxiE3oapiZLiHimS4e52yaXIoYl1Vim5QFNhiahN5m4SNnHbiSEAK+nlDXYyABDzFQZ52a8SRN3sB4PNG20NbinVUjGiIhGTUvAtYT0iIlJgpgVK0T6jzyECatlrxEEnqcxjFEYutVTCuiNYvGap2o29GuUYXTNnrG4JxjsLhAUfUoej36iysUwz6uVxF922ViYt3gawVqfOsTGGOw1lAV2kJPy6Y8xjls1UfKMgEmjqIoSDC7PpsMfCRASEAdViCVUHntrBU1K+GbRgETAhSFgjVBnbCCEn4KTMQIwWBUCl4XaGjTJFenKqL6O4rsBtWS0YlBjK3SSENLiB5bKmBnncOVpTrnGAm1aiYRA6FpOkBGjFPHE7WrljjtxFUUJdFP9D6JiCkVcDGGaCYkpAcyIp9ElKNoEDBdWdnBJqJqUrmPYUYoKxnU0HoFpZzFVWUHpk0BlinSP12Ps+v6WRvy/HX+MmbqZTVoDn5el3v6qT/ef/8jfALunCuRGFldXOLVixd56803ePPrX+fY0aP0KmXiqU3LAtTSgcQSI433jJsJDx4/4r0PP+B73/seV658ypMnT/E+AcdiD3RYKJwlek/lLKN+j5NHj/P6a6/yxuuvce7CWQ4dOqRic047xMXsXJ95hAcAdOiYhaD2ut/r8fY3vs5//Q9/lX/+67/Bk40tohiMJDpzFmDI80RIYn6R6CN/8b3vs7C4yGhxkVMnj+FwtGKIRY+FY6c52TbUTcPe03vYsK8sO9A1LTYF0aCd1wKqUJkC1fTZksF2lI4bEogcYkyZtSlPLd/zgUMiSJjaL0gZqYS1p4DHRAX0RQQrCQCOFqyCp97r+nVFiTFtyiSla0haZUTdOKWKSlqgzdlLSTlIoxecBdWjxJSBhRjz+Og1+lSNavN5TcRJpDCqU+CsdiKJEbWNPoIVCknaazMaZiElLEIK1vNOp8vEojbH5AcNCcTWuZIZmEYMxlX0F9epRqvg+vig7XE3Nja5d/su3s+UuiZtLmViivrENG+nn8SMYYsvbYZmg/AuME+lyhl3B3CmwBQFRVUxGgw5tnaY1y++wtbWFk+ePuXp06fcuXOHO3fvcv/+A/7jn/wJP3znB5w8dZJLr1zkwtlznDx+nIWFJaqqR+EKnM06aBqMW2uJ1lOWjqpfsuBH+JwESZujnN2MBNq2pm1rJpMx+/t77O/vs727w97+LuPJmNa3SZsk6eMhSQcE3ajnsg2NnlP5wBfY/ee4AZl5nfD82PFZvzVn1EyPuZ+Y+4m5n5j7ibmf+Op+4m+IRs0XzaC/PicnCSl+3mFEGCws0h8uUvYHWmYTpyCRAhRToEnSojxId0rgxswiEgGX6xZFukkpIlhbUJQVVVVRVCUhiVq5sqL1ychGrwYngRCubJUZ4j2Nn1DXNW1Ts7e7q+8Jaqhd7CwPoW1TyZChQQXLfJNqPEWo95UmGEMkJpHi6FM3pDYvHtEx0bvS7lU+D0rAFbUCMgmYESNYEUpXaJtnDOOn2zinLfqGyxu4QR/bK2nbrI4t+ElDaFulUfqAKR3GWYqyQtqJLhpXgJ8oIlz2cL0eprCYwqqArVOmTtFXdpQrStXLIVl97wnOgtFgQdXEk0FraxVJTvBE9ArAhUwbTXXXvm1VhHh/nFBYndmuKLGuwBTllM2URN0kTQjjUnlWUKaQNQfL5USUUio2a9IkgCkG8E0XFFhXIAlg0883GCwilmhsAqIiGHVS0YeuG1ni1SZwKXRZAWIuHZuCjdoi3hJRVpKYBMgURQJ8WlqfhOKKkrLqUxRVEtN6HsB6YFW+cE2+/PG8cz/7uV/2GfPgOx8+GorSIUZYWV7mzMkTfPPNN3n7ra9x7PgxeoMBNs3N3N1AxCk9VQSxhrZt2d3d5f6DB/zg3Xf43js/5MrVq2xv7afywxTgooGzy13UaLEGFkaLvHbxIl9/4w1euXiBk8ePs7K8jC1U5MvHXNap9i7Po1n21eyR42gROgAUEZYWFvjlX/wlbt26wx/80X9ke39XAe5MZyWzzqRbDzF9td7zx//xTxgtDvmn/+S/4ciRIxTVgDpCVfY5dPIsTTPh2oeeyeY9iE3SHkjMMZsLGhW01c2IAvgkQfuYM46CrjUJ2io2BHy2XQn8NdkQzWSVNKulv48RJFGIc5auwyeTHVDMWTRbl21PFAqn8yFi8F46cXWliUckGDCJsp1GTZsKmi6AMSkj2+lCBJ/q2JnJvJLazGoWOEbbJQe0W6FQWIOV6ZdL2UgxkbKssM6pDQ+RGOiCbs2AQfC6CTAzcyPPoLwryoUBhnztkpidFlf2GS6tY6sRSAHR0tQ1D+7e596du8oEFYMV1ehSzQY9n3NFYtWmMSdlkePUXsnMfFYqvcYMITM4mQbfMzM8zdFUXz/zfLLmhhVL5QYQIqPBgLXVQ5w4cYKmadjd3eXxo8fcuXOPDy5/xCdXL/P+Rx9y+eoVThw9yiuXLnHh/EWOHj3G6tIyw+GQXllRWJs2QtOycOcEsYX60IgGzgiI6zTvvPeaGPEtdVPT1BP29vfY3tlic3uDre1N6nas4xe9MimCZAeZF/3MrWvm/3NZ7ZnXdGtXSJv1FEynGG+Wvv6iQDxvnObH3E/M/cTcT8z9xNxPzB4v6yd+YkDNy5UKfNF7ZwGM2U3T8w3kS5z1C35+ZiLOfMaXX/P0tUVZUVT6ZYwF7+nMbWpiLzMGhWTMM2XTFtJttH1qaTd9vUkGPT3gDH5Yhy0KbFnovAoB69SZkQyWtZK6QFk8yaAYFUDutFZi7roTlZqZnEyHsscAwSRUWZIoloIRJicQolInm0mdQJt4YFJb58gtq2NA28kl9Mq1vgNqTBJgNgITY9VIRqGdFDinNLvowe7tPwPUQGg8bdMQvKdt26ThYynKHqHehxgxRQFe9VjEFZT9PqYwGGcoej1Mochwb9inqCpcWeH6VTJeSRW+yECIQaxTOmmMxLadySiIquBH04nrEpVNop2zahVVk9g5QOkpSCfGpXZvEL3v6J/qxCTRU01i/KSvqKVDkkqHJLV9mhoVnQeSnIGYRGcVnZez/3boUV4dUSmpBIidVExuTR666CQyNe4ZeFQmkgJyB9ZTd20mZUCUtWOLUrtWHTBWn1/3GUd6HlgjMkM7JL/mecfzgy14eXv15Z/x03X0RwVLi4ucP3eOb739Nq9cuMSR9cMsDocpO2IxRoNd7WKXaNER/KRmUrfcffCAv/jhD/ju97/PjZu3eLKxQYzQBoNIAdFjrSH6FpNqzUtnGQ1GnDlzmr/9t/4W3/z61zi8fphhDviRjvFlZqdhZJo5yb/rHuV0LosRYgIiEcFYh/WGo4eO8k/+0T9hY3OXP/vunzNuG411vTIXEYcnECXomjaoHRDY3NnhP/zeH9CrSv7xf/OPWD9cghHaIBTFkMMnXyXEkmsffZfx5mPE7yNtjQleg0FSK1CT7LEPmBSIx6i11s6VSBvwtlXBQzSzaVN2OmQpKKNlrCHbL6tdJkLa6BgpQFzyBQoQV1Zoo7IsvbeEKIRoaL2oJmUwaVMgRFogIM5rJ0EMPqSgxCWWX4AYVFQ8+kiWCjU5iEXBbrWlhhhFW9K63F0xKrBvcqc7zbxa0QyuniEJz1sLziHOJFH+tAELiX3YtlMbEqdZ4sJZQgq/o2gZcMz9IqIhRkPEYY1QGKPdVCKEIARXUS4cor+0irGl9gQJnv3dbW7cuM7G5jZ10IxlNmtq+3WDUZUVhVMGqG6qYkoWpJLWtBaCZnw0ex29+hwfiK7ASqF+kNSy2BgCFi+GKB4IRMPUfotmgCXZd7FCYSscUPQqYggsLi5yaG2NE6dOcvrCGV698RqfXP6Eq599xo0bt7hz+y7vvvcjTh4/wfnz5zh96jSH19dZHI7o9/qagHEFjgKiYBFMCJq0ES2D8Ga6SsWaFLyXlK5HqBpGvR4L/QGLwwW2RotsbD1mZ2+Tup3gA8S8kQwhE2ZJERdOhNiVHyfbLxkcgMRrBkgsg0gUM31tyugjOasep7E+PsVtMdmQv2xi4b+MY+4n5n5i7ifmfmLuJ766n/ixNWq+ymu/3FHlcz77ulk60Mt+7ixy+OzxvOvQusWDt/Wi640H/i3KiqrXo+r1Mc4mNkQeeqU5qmhwEs4NqmMSQ6RtW6q8gY5CXdddazTdiCd0WDKYow/fWIcrSoqyhxfNHriyIJeauKLAWJeyAhYTgjbuKRxlO6BpWpxrMNYS20CQkJBjPZf2sc/GT6mJuZVyyOrwIah+WIeYp019hOBnJmNiBqmrUCdoUFtoar3XwmoNskFb6cUIJgqFWEZVRVE4ytIxnjS4SpkuKkCWgACEpmlUKX4ywVhJpU8lbdOq4JRVw5xbUFf9Sl9noOz3FfgqCvrDHkWvoihLquFAn4e1mF6BLaw64KJSZkoyZDEkam5CTY0RpM2ibAm59oF6MmEyHhMm+5AU6q0xxDbgej4BFrocfdsk0E2BIcIMUONKdRh1g8SIcSWmqhBnO2BPu2KpxTHOJXaWSbXKUQWvjNWOTElQLwNoMUAUn4A37dyVq4MJ6fcJBU6kU3y6xykVMzGcmoaIIeE902xM+l8UIYjpxjQLTGeQJiP22XyIZJvyLIgTu79Dfv2BT3uJ49nzThHw59mveaZ0evydv/23NfC+9AqrK8tUZUnpkj5U4lFHIkhIZXsRsOxs73L3zn3effd9vvvOD7l87TO2d3e1BaWPqXtEcoghAcRGsEQWF4acPnWSn/nG13n77bc5ffo0vV7v89mJGaeqV5L/nQHBu3n1zBHpXpPnI9FQFJZzZ87yj//r7xBCw/sff8Dm9jatRp4ahAdtFxsMGsRH1QczxvL0yVP+f//+d6jKil/7tV9jdWUFL9DiKHoLnDhzEWs8Nz55j90Ht0CaNAYqQJlvREXr0uISEqBrpkFW0FUnoJoDOYsmygzM9lZPkQJdwPgcrShQLDElF9qgrO9U35+2ABpoark41mh2K0qLj4HGN0mEUcdcdRxsF/AZQf1UjJioQU/ONBoxGiCT0x+5DFg1BZTSnrTBJLXdTCL81mhW1KRspTGq8Wac2kHtpheJKViVA+BvNiT6PzEyzb3EiEgOsFJAluaPtnxVHyfGEEVLbRdX1xiMlhFb0AZP0waePH3E5SuX2Z/sE0TnmczSrmPEGBgN+5Rl2QXD3YOP+Sr1fSbFG6BZ653xmCdPnlCVfRaGS/RKR+FSkC95jJOtzOeK03uZXSvd+OesYBrfvnNU/R790ZD1I4e5cOE8t+/c4cqVK3x27TPu3bvDX9y9y3vvv8exY8c4deIkRw8f4eSJ4xw5cpTRwhK9/oDKFRTO4azrSlUAQtB+uzbmxFWyBUYTVqXrU5QlZdWjPxgwHA3Y3B6yufWUnd096sanjaYcWPmQ1o0IgTAjtplfkj1bfm3WnstrRTX89G3S2YapnwgzY6eJqPkx9xNzPzH3E3M/MfcTP46f+BtS+jR75Buf3TT9dTq62U2aXlcG1ZyzjJaWWT18BGstbdN2Brvb3AI+JKOQ2jQHYhL9VVFiEYfImJhYLjEqYuucpSwLNVp59iXWhNbQqhBbv9fHmoaIKOiQ+rHHqFkFEgOj7PdpvacNHru9QxjXjMcTNja2OzCoLAuK1ALcRkmCuroRDzOEoe4r00yzX0iovYggpcU4i3WCK0ttxxwDBE9ZqeBXk8c4RiQm7ZIQMQ3sN2OKJFzVqzJ7qcS3fjrOhcVUPaQ3gsURTdvQ1jU7GxtM6omOdWlYXF2nNxgyGIy4de8ufrIPbU2RAAJnLf2qpCwryrKk3+9TVIUCX32Hs+rYirKkHI2U0VQUSBJ4dmWvE8XVdnBxKtzctkzGY+rxGJoaVxa4wmFcQYiBth7TbLZUgz7GWi1pMwaTUXjfJmdoiDaocw+1OjRTYW2BNb1kmD1ilNoaiR1QKJLAoxhTe3AwZZFU6y3Rm8SgUR0cUC6ROp0E0M0sCe9zW3VAbCeMFYKnaWoVsA5JLC+gTKuotNsQI23d4guLVFbBJ8lUyi9a63+VdiA+8+/8eNnjf/i//g8sLS9SlSWGiLEgSccINNNgEkjYRM+Tp1tcv3GTH/zgHd577yPu3rnH7nhMFCUlKr05aTbFVrNCNlKVBQvDASePH+Hrb73Fz7z9NsdPnGBxYaEDuXOXtp/EMZ2PuZRVa5tBqArL3/7GN1lbXeY//N7v8r/9zn9gY3NbOzgY6UQsJemPtV7LREV0XT158oR/9+/+PWVV8Z1/+A9ZWVpUliMRV1ScOHuRsnBck8jeo1uENhLiBMEnlt3sPE0BgUYnEA0i2vUhhBfP5xw0ZJ9EyixOwcns6zRSC0E3EVFMyhzmMlc9nxAxRoHhkANDiRgxBNHoLraNsgIjnVZD3jSplmXsxOCzoD3Y5P+cyi2g4HuMRu2dkIRJHWIizpgkqohS2lNm1NoUPMdICKJVAImjn8UMs0ZCGiEgiVziO8+uGUlB+3lYMj1eTAr2jILQUjgGC4ssrq5jqwHROAJCG2pu3r7BZ9c/ZdKOiUlXQq8DHWu008bKyhKDQR+bdqLxGRMo6FoLMWrMIYa6Ddy+94jv//AdqqrPubNnOXHsCMsLQ8oIzkZsARaTym2nG48cK36RFTxIA4/0qoqqVzEajTh8+DAXLlzg7t273Lp1k2vXr3Pj+g3u3r7Preu36ZUVh1ZXOXrsGKfOnuHo0WOsr6+zMBoxGgwpUvxSFi7tNfLGQ+e4bialy1yKs6odUZaUgz79hRGD0QJbWztsbm6zt7urgvqS51Ia5+A1sZbuw3R/141MtwWJidUaZzKiorHS8+jsmqTSjU7+zCzE+tN+zP3E3E/A3E/M/cTcT3xVP/FjAzUvK8D58sez53hBTdjz3vnMAHz5Z7z4NbMZ/M9flzzzWqHXHzBYWESMIRDxIS3EmMgneWOcTxr1D10HnMycQQ2S1wpRTFTsVIWSMmgVZ5TRE0UvOJxzWpv3DNCr7JW0aFP3oRBbQkiUt9ZT1y27O6m+N5IMlTJPLDoYMd0HqSZQKYemcyZZYDii7y+cwxYW26/038LRG46I3hPalma8SzkcKlgBdHyLGAlNq1o2bUASG6MJgI0EFwkOYmKPYAxSFhSLSxSDIW4woJ1MGO/usONr2l01mtKvMEuL0OtTO8fECW2j9xQn41SSJVRFQVUUlEVBv6gUtCodZU9LsKxVIKvc2cWWJaYqsD0tlaoGDcYV2iLQWkJCT0MItN7jmzaBXQEJARNDV1OtGkIt1iUR40RxjAQIWoZmUutuZCbA6AyFsmQMqBO1Rhd9mida3iSJupkYMVGNiOR+dlZLqWIw+jxmcNJELNVfxCye5jvqqyTqoDJyfHLUMf8qAZAqHpy9ddO04EqcLXBp3HR5TIMe/flZvP7ZdRi7933+OJj9+DI7cdDeyAt+/+L3/7Qexw4fVbtJQESps6k2Umv9Y8u4abn/8BEfffIJP3rvAz786GMePnrCZL9BxClQFwJOps0srYAtHM5a1tdXuXD+Aq+9colXX7nE0SOHWVhYxBUlMDPH0vHybE4+97qD86T7jhh9VwcvQFVVvHb+PL2y4N6dO/zJn3+XJjto1Oab5AdsYjs2Sdw7xsjDhw/5rd/+N5S9il/+hV/g0NISxha0CK4Ysn7yPNYarr4X2X50kxgaTAo4Z11YpuWq1zfdNUvKNL5oDLLeVAiqrqhBrkFCzgqnUzINuoKPiaovyb7oy7rkdHpfJNfvq29QYUhSVxCfNNskiUmimUtgyr2z3ekEM5PJit0/XSvNFJZZo7/TLKk2WtEgHJwD5yJGkrhlZCaAN/q8ZJok6liD2Y6R232mBExM/yb7akyiTUtEP9zhekMWVtYYLK5iqwEeofWezd0tPrnyMU83H+Nj09HHJd2LMWCJ9Hsl6+ur9Ps9cgvTmB1tHoRI9z5Q17k3abh17yHff+dD6tZz+dpNXr10gUvnznBkbZVRv6IfK1y3yTXdBqAz2jNTbHY9zK6rCEn00WlCpDIURcFwOOLQoUOcPXOOt97Y4MGDB9y8eZM7t25x/9597ty5z42bt/nz73+fldUVTp48ybFjxzh25Cjrh9dZXFxkNBwyqMpEfddWyoVzKU8l+Cj4aEBSuYFYjCnoVUNkyVKWI8piyFP7hK2tLWUI5HtI/jIiKS6LyUdm5bVIlv/MfmAaRH8+mZDnSdcyWlMc+lQSqDA/5n5i7ifmfmLuJ+Z+4sfxE18I1PykypxexhjOUoP+MrjPVwWNDl5SRr66s82e+YAxBp18/eGQhaUVBWpi1PKmNPAmgPctoOUlBAseoo/4VsVvxWgZjEQtjQre4xCcO/hoInnT39J6NRrOah/6UDiapu3AH0WbdRo5I7Q+0vqWpt6jmexRT/Zo6wnNpKYeN+zujpnsT2ibRlufJWNrje3oYFnnxBhLYbVbU2EtZVlS2iSuS6CqCqphT78WR4ltUrC4skZoW9p6wtbThwyXlyirMvmM6WY7tgnA8oFCBD+u8Xtj6hChVxB7Fc45pChUALhXMVw/wmBllaXDR6l399nZeMJW2Kd+os6ov7hE7/ARRITxeA8/KPHiaQ3sbW3TpM5RhS0pjaUwlp5YetZSOUuvV1KWDucMZWEpKi2VclWPYmFA2e/RX1jAFgWmUA0hrEuoH7RBW6PHoEJxxhuMh+hbvNPOVEEU1ZfgQCzWaQtxBUZajBVsYdN8UuMv4hAM4gMxNpB+VgAvEoNgjNMSLQBCbgZFVuIXY5HCQdR26YSICbGbb/qAJAGY6ffRJ8aMGplObC5GvG+nCLIx2i7Sa5t4WxRpPkHT1NhqgCu0Fbu10/k+6/w6eqXIj5GZfNZYTtGnKRj04gBlfrzcIRJTVi49J1HxvxAjT7c2uHH3Fh99/DE/+tH7XLt+k+3dXeq61TmZAm8hUVeJFNbSqyoWFxY4efIwr1y6wCuvvsLpk6dYWBzRq6oknCc86yzys3z23xdf+8HStueBdXHWSadMqRj1rJVznDx6lF/++b/H1atXufvgiTIWrcVgCBIwUQiimRnnXLeu6tZz+84d/tW//m2MGL79i78IwxGFs7StULo+q8fPIUa4+oFl8/41aPY0wxN0swOqOUWYDcIz403Xi/c+UbsF36bWpnGq6dR1IBQNG3I3QA3Q9e8+b3BygC2hC1zJXTXQYDlrcwnQti2h1c8ypBJbkoaVGLAQSbXnZua6op5fO78IzJYnh+RnTRZlnJbuOmeT9oBS9gsrlIUG+8YmCn2Q7rqBroNdbt8JibEaD2YE9bqBJMAuYrBWxTCN0/ILYy22qKAY0F9cZWntOEV/RBRH27bUvuHO3dt8+PEH1E2t3T6MXoNxJl2fBvOLCyMOr61RVdU0A5euZDpOej+mUIFJ3wR29sd8+tlNnm6NqZuGp1uXuX3vPlev3eDVC+c4feIoRw6tsDDs0y+VMh9n1oJJscyXHcLB9WWMYJzDAVVZMuwNWFs5xMnjJ3jlwkU2Nze7YPzqZ59x485NHj58yL1793DOMRwOOXToEOvr66yvrXH0yGGOHD7MwsICg36P4aBPv1fhnE3lAYYQGmLH/G2JsVHGbfJ9zqn+WTPeT3p+KbYKiRGQx1P0jrp5nBMEcnAcZu3FQRo7HatUVTFi9/fMcP5pP+Z+Yu4n5n5i7ifmfuKr+4m/VHvuZ43bfz4bnmegZpj5Oc68hud8P/05RChcRb8/0DKWAG3jKSvXgTa+FUS0tbX3ikgaa3FGuk1r1Nmfvs9gkXQPNCaoLcZIaBtCPcG3Db1ejyIWSFCj2raeNgTVXxE1qDoZW3xd4yd7xKbGhkC/LAijAWVRUJV99nb2GO+P2dnZoW4a2jZQtxPaGLRhExEvpLpDLdsajRZYHY5YP7RGDAHvW+yoR7U0ZLAwZDRSilpRlvQWV7ECvp2Aa1leXaWqeqktuEm3n1BbIIpgnaEdj6n39oihVZHfqk9Z9VWA1hVUVUU5GFJWfaqeqoUbC0fOnGS4NCRGKAeLYErV2CGwfOQIbd3SjmtC8RC/t89kPCGaHrUPCqDsbtPs7+PrCW1TMyxLBmXJodGQqipVO6coKfplYt1UuKrEVSVFv0+ZypiMaAcoLQGzSqWrS9qqVH0cWsRYTGGoJxO8bymqHi6VkGF1TCIQfANtq+0YY1RdmqLAlBXOloqkx6QzBCo8pi6qm9dZVDimMcZo224jWiYGrWa3Mpo8k6CIURljPjNpUprEt00G7VO5E+pcRRLzRgHIuk6MqnrCeDyhNwiIdRhTdJpMB8ufYgoiDjrCz6/H2TX6n4sN+i/nMFYJzF70WdeThkePH3Hlyqe8+8H7fPTpZW7fuk3TBLRlatD6/OSknFVpwMpZRgPVFDh//jznL57n7JkTrB1apd/vJx2CTHdOHx5jByz/JI4vYooqHpldtorMBYn0egU/8/Y3+OiTT/i3//532NmfINalMDMqkS1tUKKo3hRBA8wYI9ev3+A3/9W/hhj55V/4BZYXFilcQR2Ewg1YPnqOS67g+ocVj25/SpiMIWp5ocSAs6R1moHHKagKdFT/kITETb6veHD/ElLm1ISUgTTK5gwpC6RBORrj5wyd5CSbV02rFKAHvHZrSZRxrd/OGloRkki7GIOfER1XinicCWBSZjglCmIEMTkZosKV1qrGgMSAFXAiFFbLDkonqmkQQEIKlk2SuI8RQkqAoNeeRfxn50OM2Q4aEAfRMnXZqYzUJJ0MY4niKMoBq2snWFg+grhBYtcGtrc2ee+9H3Hj2jUFr8Wiip/SZXyzZtvqyiprh9a7BgDPPUQIxgGWEAN123Dv/gNu3b7DeFxrDEDk8cY2O7ufcufeA46trXL25DEunT/DkaNHWFxcoKoqTDTYLKqa18JzsqQHPp4ZizsTxwA4UWp6rygY9Qesr61x8uRJLr1yia89fsyt2ze5+tlVrl+/zr3797Wt65MnXL58mbKqWFhYZGV5haNH1jl67Agnjh1lfW2N5ZUlBsMRRVEiOIKPtI1nMt5nf3+H/f1dxk3L/njC7u4Ou7vbjMf7iIlUVUm/36OwRWqVHJIJyXFHnttmutZjTCCDlq4fyBY/E4zHGJnKJ8SZr/kx9xNzPzH3E3M/MfcTX91P/KU0ar6q0furfv3LnitmK8LsfHneIE3R2elcnD0PWOcoe30WllfZ29phsrfXiXYhqk9jAwSJRBPTRhkKKZit6dQVLp1Rnj7M2KHTwScjlxgnAhirnYtCDNi2xfgWY11CvVPtm/dKBUNwxlAUjn6/gmTA8GB9RQkYH9i3NXXbMpEW47UYq41aSxoRCJE6BPbqmmoyYUWENgYm9QQ/joyWhgqaVH3KosCVhSLKEjHR0esPqXoDqp7quijKnEupLIkbiCkMvl/TDob4tsaWBa6oKKthB9SU6XcusTXEWVxZMFhYJAuYuWpIxBC8x7YFruzjm5amnMDGNt40NHGiKvg2Qmtp7T51iOzXDds7O2wYQ2Ud2zt79EsVteoVpZZFFZaicArUlKUybIaDpA8jhBhwhV5Xv1dQ9nqUvR6QDLc12FAQy4KIS3RPh5NSr4nMMAkK2sVpy2stibLdDI4pexSTU9MW29JN784kSJ7K2dk9i8DHmRfHTiBtCvhY/T0QkyBejNrhKh8+RFofVPRPhJjL7tokBmcdpigRm8GkL1vzOZORwZu8HvN7XwTi/OSPn6Rt+s/9mPgJrfc83djkzt17vP/+R3zwwUfcvHWLzd1dZcMFg0TXiT9ao5k+a4XSOVYWF3nztdf4+ltvceHiOVbX1+gNB5TOdk4+A3k+ZWSfRy19+TLYlzl0PpmOVQiIgocRIRiL0UaPrKws8/d/5ds83dzm//jTP2eSg9GgQWcUlPctiS4bBdWTMtS+5bMb1/kXv/Gb1JMJ/+Db32Z1aYlgC4KUFHbI4toZXv16j6roc/fqJ/hmW32Hj/gkLpjXtWpbxS4emgYO6Rd5HcWQgvAE2HYZo/S7GTbbbOYs5uBCAl0gja4/iUk/LGqXiPwZiKhemiRNgS7rOM0ASnfufARyPwfJUX8XEElnX63VIFyCdvVwdirWSMoqh6gJkqRKSWbUaVY4+VqSRka3IdA766jsYiFm/5THKSSQOQXRUmBsxWBhlaVDRyl6S/hoiRJp25qbN2/wzg9/wNbGpraeFZvGXnTzEcGg2nQnT5xkeXml0xh7JtxNo6c6EAGh9i17+/vcvHmTx4+fAEbLbSOIWPbGLf7xNlubu1y/fpNPLn/KhVfOcvbcaU4cPcbCaES/rOgVpbY1RviyFfQ5Kzhjgo0ou199ucWj7Zl7g4rF5UVOnzzBG6++yr3797l+8wZXr37G7Tu3uf/gAbv7Y7Z2J9y8c48PL19mNOiztrbCyRPHOXfuDCeOH+Pw2mGWl1YobEX0Ebwntg372zvcf/KEJ5ubbG4+ZW9/FxFwThiNBiwtLbGwsNy1tA1prSDT+xFmxjvNcwhpfhz0MweTC3keJz859xPdMfcTcz8x9xNzPzGzZIC5n9D58cV+4ktLn76KEXteidOPe44X/fxFpVXPe81z0b3nGunPT279+4uvNUYw1tHrDVg9fIynDx6ws6FG0To9mw/aFcckmqA1JgliaWlMhI4xo12JpgBN/gJVn/Zeu+loaZDSC40xVP0eIkoftE1NzIyJNI1i8PhUruScI8bIIGhbN2sEGo/zJRWGAkMxmTBuGqyptdtTDDQx0AafUPPIpG2om5advX0a79mfTNja3qZqDKuri6pT43q40lEUBUZs2tALvf6QsjekrHrYssAWWlJlrSrhCwYRizhDDC2xbWja/dTxqqAohpgM1DiXGDkpgxKUVtdbWAJTEYIgrgKU7aFaMR5ft9TFGNx9fBTqJrAwKHCiAEIYV4h1eISdusY3Hgmw5XYZOEtpLb2ypFcWOGv0qyqxRaH1l4tDrEn1unhc4Sgqx+rqEr1Bn95gAJI0gZzFxr7W9KLIbW5XbaQCyaVzPgn9omBOakU+S0GMKaMgPtUVe6/1pSJdx6acQcnfdeJvebLHmEqAFayJzCLBulaMNVr65MO0m0CMBN8qcBShbQNNE5IY3FRs2HvfgTS2rDph7eev02xTprWfM6949h0veM3nzz277kWeb1fmx8sdn352hY8vX+bdd9/n6mfXefxkk8mkTW0KDcFoFwaX6sMJHiuGflVweO0Qr7/6Km9/4xtcPH+e1ZVlyl6JOENS8aOj8wpddzUhZfxiPPB0n62TntYDf/54UQ3xQf+RZo+kADBO107Ap1JXECOcP3+O//6//z/ThsiffPe71HWjcbbRjoBIgCBgEsU7WqKANZbWe27fuc1v/qt/RfAt/6dv/worK2tEE1MXvpLh8hEuvfkt+sWAu1c/ZGfzATE2hFgTo9cgP5DqqjuMNX22BtQqeBg7W0CInd9RjNfMrId0rzOZUg2wcs1/CroxWBGizfpWEQl0BPYMoGZtMy/TTKgGrflZSrITIWVIk91L2dYoYartJpphRQISLYKjtIXSqkWfkA8eZwUM2m0RtXUSU8kn6TOjfqYIxJA6nkRJ49HNBKa/UGasGEnxc56HDjEFZW/EofVjjBZWsa6ijUL0LdtbW3zw/vtcvfLpdLcUk06Y5KBP73fQH3DqxGkWF5ZUjy5PxOlj6ex4iGi20Aeebm7z6aefsr29hVBpaYOQOiVCHQMSDc24YWvzOp/ducGRj9c5f/Yc50+f5uTRYxxaXmZxOKQsVGz+oGWciVIjnciidNcTM/6f/o3d0Dmjz1esNkqg12dhMOTI4SOcO3uWt958izt373D16mdcu3mTe/cf83TjKePxPlvb22xsbXD1s6u8+/57nDx2lEvnznHxwiUOrx1hYTjCJZ+8urqCVJowEYnUk302N58S8TTNGES76gwHI4qq6livuRvK9I7yHU83XDplI7MPo0uKdOZhNsH3ZQL5Pz3H3E/M/cTcT8z9xNxPfHU/8Tew69Nf5/G8jd4zr/gcGCUYV3LywiUe3LnJ5pNHhDbpfIgQBNrULclIQGJAgtY52sImka4pgyY/2pB0TWyRSkyEA5mA/NDFGqp+H+McvmlwtaP1vlsKFgHv8UZRZFOUlLbAmkI/KUDoBwpX0g4ivUmD3d6jGteUrtaOTzHgo4condE+5D0tuhnfe3iPJ1vb3HuywTh4Jh4aY3nzlWUFGUyBM5bWt+DBmAJnSpwtca6iKAut2bQulW0l+qIIBEf0BWXU7kbGFThXJZTT4UqXxkWNp4hHqBgNlimsx/tkMFNdaagibTOhkX3MJDD0omBCXbPc1FTW4oyh6fU5vloQFlapV492gUBqYQSAcYKtHCDENmCd01IuY6nKvkLFRrWHmrZhbzzm8ZNNjIGytBw9epjVw1kKEmMAAQAASURBVIcYLo4o/Ji2zfdVKNJvBRhqgoWobRFTJyVTlpiixNhCEXadFOrwjFPjHgRioy3jJeEvwXddFnQqZWcnYCzRFIhpSZ4cjNO5Fjy+9ckJxw5k7MKb5Bg8dIJwERWF86kkMAsr122DLUt6owVGK4eUFfRCIzULpOavWdDmee8TvmgNP//1s581P77K8X//f/w/uX/vPuNJTQiaCQtRFHBFNQVU3LrBWGEwrDh6eI2vvfUGb3/j65w7e4aVlRUV97M2ZZ2YeRxT9pSFaVT0Eo/reQJ3058TjTVO7S+kQAy0vBBJIHB2rvmbHGjkLKJqSJ09c4r/yz/7J+zsb/G9d95jEgLRGlqfnbsyIb3od957BIOJgaZuuHPvFr/xW79B23q+/cvf5tiRoyDgraMWixmtc+r1HuVgwLXL77H95B7B7+HbPSQFtoTUQSOSzq/jH6IGojZm8xCIRtey0tlJRiJtepJeQYgBm7KpbdvqwIshBlHtrRRqi480vk4BvvIvDaqTFtHSzRiVf28ka56lQBqIRmiDbg4k5rPqg44hEFA7ZQun2WCNPDEhUlqDkRYkEpImgrWGaC3eJt8nVjNqkjvMJBVJoir5JU0II5ZIzjZH1VBLsbck8B0xRJvKEwSMRBXH7w1ZOHyC0foxTL8iSkvwkXHjuXH7Jn/+ve/zdHuHNho8lojFRhW1nM0eL41GnDp2gmHZB2fwNmd+9SukYM/gcQRqH9Im7j6f3bjFpG4wRmh9AFtg2tS2GJK+ZUUTDJOtXfZ37nLrxkN+tPox58+e4dK5M1w4c5rDh1bpD3qUvQojKqYf8rqJGeBPcUlC9PP15yA2IJ2Z1sec2ikL4LQRgQsFvV6PpcUlThw9xqXzF9nY2OD2jVtcv3mDG7duce/BPTa2N9ne3+Pxk6dsbW5y/bPP+MG773D29FnOnD7NiRMnWF5cxFpH1e9ztD/g0MoKF06d4umTx9x/eI/t3S32d/cozBOsBKxdxNikvYDV5g5AzvJrUC2pe40BM31GOeI2uTVwzPocmj0n/RxfxlD9FBxzPzH3E3M/MfcTcz/x1f3ETwyo+SJE6OXFhL/8eJnX/TgiyLMbwullfn4jePAe9HtjDKOFZYYLi/QGQ8abOx0S7NMEVaYMqnBuMt0w6dAYNQYxo9iJteJDUhCPcbohToANIilrkBaiseDUUJEojMGnDlGAM4Ze1UvoecTYScfOaeoGYwzWKaWvbb0aSFG19RBDMux6yyp87NOPQg+Hq4b0lg2bkzGyO+bB9Tv0TcFoNKLX69HrDagnY2LwVJWj3xtq7WBUJFJk9ivVYcbp+Ctqrm3uskBXFgeTtMgVkjGaKQha9hQRjCv07yFC6zGTGrs3ptjd45B1DIZDJsCo36O0qhwe+30FOHygnUwUABEFT9qmSchqxBYKFBFRIWGnrJ9yNMQUDlMY2uCpm5q6nrC7v0tT7xOCthHf3tiiqWv69ZCBH1H2elQ9MwOIhASKKFBjTK4LRrVtjMVYbVEXE71WRDR4MBExNiH/CggqrB46FDvGCL5lOumTWFpi74hx6phy7XGao/icPVEtpiy4ZZxLl61jHbyWOvm27VD3um3xziFW252/eL0+7/fxuX9/kWjw59/znDPO3PsXvOoLz/HTfHzy6fUU5OlzKIzWMHvv8T5SFDo3B4Mex44e5muvv87Pfuttzp89w9LSIkVRHACqY6ZBM+s7AOLnfMjsY/8y9ubn/6YB1zQrmD80dtpwue5Y7ezBuZdtTXcNSR/s9Vdf45/90/+OetLy/kefsDdpcKIbE5JwZN5QmM6+mS4Au3//Af/6t3+b3b19fvUf/H1OHTuOxIgXoXCOcrDAsfOvUfT7fPbxuzy+e42mrjFG9chcTCWVMUObGgjpZiJvGKb3cuC+DiyB/DySkKRRe+sTszIG9Wdp26IBMTm7HaaaBSl6jSGpMcRucPEht7KU5A/TeEqK2DqmX54TuUZfSw1MjKnLYnJMMaY2pCHtJRSk9/pYu9px0232unCqC5RiuumpTqAG3OqXIGd/rYCzKkDprEFswWBpheX1Y/QWlgmmIIjF43n09DHf/f73uPzpZZq2AVN04y0GYqL7C8qyPHb8GIfW1yh6JSF1aIndtU3/BSDFDlubO1y7fpMnT7Zo2wC0xDDdyeZSax+iJkSKAiM9QmjZ2avZ3X/AgwcPuXz5MhfOnOH1Vy5x+vRJ1tcPMRwMVJetLAmhTYFnyhjnc8+C6KKxgfB5mzobcU2fu6Hf79Pr9RiNRhw5fJhzp8/w5tM3uP/wIbfv3ub6zZvcvnuHe/fusbW5wd7OPrs7t7h7+z4/fOdd1g8f5sSJExw/fpxDa4dZXl5h1O8xWF1lbXWFM6dPsbWzyeb2JjvbO7QTz1jGVAODuCJl5eNMWfD02s2Bq8/MUqbjmu5IJBIklypr8P4FJumn6pj7iXy6uZ+Y+4m5n8j3NfcTX+4n/soZNS9D/fyy8qRnz/fjHl8MGB2YFkyFZl50rune1hjDYDRiuLBIfzRivLmdSi51SXtRyl6IWsLUlZ+kBWdmJmGMQY1SBlrSxljx3CnmJiZPidgh4xirrI5g8L7VLlIxlThZR2/QJ5tkg8G3qhlSl5NOJFaM0G+LjmLY5hpa1ClJBJPoGYoXGQpjWS56HBku8nRvl51mws79x9yKkdHCAv1+n6rqM5mMIQYWlxdYXlqhLLRUyLTadjFLqShVMNWAZmpGFGWozBhgfZbpPclBZtDGt56mbogYCleSlfglBGR/jN3bQ/b2WCtKwmgRen3NIiSxZNvrE6I6DV8rUGOMUFaOyWSiwUX0OJfAEmORnurxlL2KcrSA65XYXknrG5oE1Gxub7Gzs8l4dxu/t8t4d68DsJy1WDFQ9bpnGzMCle5PtXxIWkdOqZnGdvMxzM4tY7QMycfky1TbKKY+7lqSpMiugjE693PJVPTabSqmdu4hldtFUlmenwrIZfDQpFrOjOplkCZ4T2HV6TStJ1jNxLiyOLCWnr8m8/HFwdXUZrz8+55/PO/9B4GfefA9PZqQwsgQsBIJBLVpBJyJDPuO9bU1vv7WW3zr7W9y8cI5VpeX6JhzcRqUzbZOhc/7gWdtt7XmwN++qHT22fdOa4hjCiRmo5rO0h64vumJE0gs042Hc0kA0xj+1jd/hlh7/pd//uu8/9HHNGnNeIGItkO1CD7ZfkGIQQPJ1gfuP3rEb/3bf8vW9ha/9p3v8MrFC5TW0TQ1jSuxxYjV069gqgqc5d71KzTjLawIEoMKjouW3IKeV7rI4vmTNycFIAXpQe1pzgSnMA5Qin5Mtjb7pRhDZxNy8KFU8hSMhFQ+m1iBksY0QifyGGIGjQ9Gmp3nizINVEWzmrbLVCkLUD935jlGtXUdjR66biW57CFf0+xGMEeXQtRxFZP8tWbHnIHCRIw1YHsUwyVW1o8zWjkM5YDGlDTBsDMZ88mVy/zF977L5uYmQUTVAkQwosKdUbK2BVRlxekzZ1heW6XV2YJJbNaoE6irrvAx0npP44XNrX1u336IJrMdIYj6pZhcZ/IPOtFAnCNS0EwCHoc10HjPvQcbPH2yzWfXb3H61HEunDvL6VOnWFtbYXE4ZDjoUThH0nlVP5M3WamF67MW84uOWaZwjoOKoqBX9RgOhxw5coRLFy6wsbHBo4cPuXPnDjfv3ObWrVvcu3+fzZ1tNjZ2lM5/7QaDwYC19XVOnTzJ+TOnOXvyFCsLI5aWlllZWaFpGvZ299je2WF7d4+29ThLimmiMhhM2ngFHf9uQ55Xz8zNzdodMcoQ0WWWgvUvKKv5aTrmfmLuJ+Z+Yu4n5n7iq/uJv3GlT3/99bzZQD3vOhJQkMSqdMGY1KZ7gdXDx9je2ODJnXuJfZABBwVpfMiGUBd52zT6KVFFgWPIZVGBtm0REXzTYkS0ftAE2qalaRtCbImpT48eCsiYotRztyqe6wotK6qqSmmUCQASEVrf4oO2Wt6fTKBpCUBvUCgAIcJk4lNJUUKIEaw4og9YMRRiGJYVvaKiKkussyrtFSPjpF2zvzFhe7zJeDKmDZ5x/xHs1SyuLLO0vsZocYmy36M3GFL2SspSuzkZa/B1SzOZYIxQ9ftUPYs4yGh8bFW0Nq8Mg8Hv1zy9c4+n9x4gGFbWDlNYh/UeMxkzmIyxrVeQaP1wgn4ibd2AqDOwCwsglhgjzc6Odlwi4qpcCqTPwjmLcRYpC6qVRYp+j2rQw/QqFUouHKFt8KHF+5YjfsLe3g77Ozts3L3LZHcbX9dYIqZtMT7QK3uUZYF1FmLAt2ns07RUiq1N5WFJ+yWmcrn0PKeZHZMckKeZ7BMmNcSIK0qiD+CTEFvI4sMZ0NG22nW9S0jMmFkxurbVNu4xZUgigNGAQv3/tMzJN63qJzmDEUNZVUysU80ha2fW3LNr7Tkr8K/dPsBBUHd+gApyFU5wBjTkCgwHPdbX1vjmN77Bz/7stzhz+jTLiwvafUHSPIvK4HpWJT8fn8+MvhiEy8579ucvz5xOM53xQNCncPYLryEFMwevWbW1Qoj0y5K/+7M/i4TA//Q//7+5euMmXhFWfb2EJEpotKtbbNOtGKwtqH1gY3ub3/n9P+Dp5gb/7J/+U169dInSFXgbAUcjwvDIaV4pSnr9Ebc/+5jJ7iat3ycGjyo/TAPPGFNMINP1loOfWW0BIXaaVdpCMtOX1T4QhRhSPfyU66kZVXHp89que0hM4ooa+zUzehDTAFwD4EgIbZekMka6Z6ibgySyblx3nRoMoyXFoqKRzlqs1bJLkzdWMRDi9FkdLCOeBt0hBerG2k74XyntaqdEdFY4yRsAQcRBOWS0coSFtWMUw0W8KWmw7Dct9x4+5Hs/+D6fXbumwHmITB2/Xrd2kVAfvrgw4uTpEwwXR2BT7X9MQx2m+5OY9BGiCI1vefR4kwcPNiCWgE8Cmq4LILt5kOy1MQZxJfio2nCiGmPOFtStBuKPn25y5dMbHDm8xonjhzl3+hRnTp7g0OoKo+GAsigxlq48AZM2XMxQvw+st4Pr6EWb5tlAvCpL+lXF4nDEicNHuXTuPJtb2zx88oRbd25z4/Ztbt+9w/2HD3j49AlPN7bY3Nri1o2bfPz++1w4d46vv/km506fZv3QKoPekNFgmZXlhp29HbZ3d9jd31bmaXe9lpwkyQwDYkxSkVpVfMAeHPhen2eXZPkb4bP+JhxzPzH3E3M/MfcTcz/xVf3ElwI1X2TEnkWhv4zt8uy5vqxUKp/3RX973mtmF9WPu6k7+PlqrJ5/rim7oywrBqMFhguLuLIkNK1eQ15rkJTDBe+hTTQ189xLjB1YE0NI4sBaktS2uultmoamaTDGEmyBK9y07TKqol0SCbbt2DktynBo8+J02q2o16uUfeMDLYJxBhuFqiyIXjfdOi7K/rFiMNZhjaU0jn7VoyoclSu0BtQoeBXE0nhP4z2TtmG/qfVnPNJEwsYOW5OW/d5TTFFgywrXK1QwuCzwTct4b4/9nV16gx7DhQUGC4v0h0NsoZv8XtWjdCWFdfR6fQqxMJkwaJMJ8IHB9g5OtG65EKj6A6wYLIJ1yWGESFuPFS0FYirNEcDJCF9P1KkZwTjpFpWxRttkl45yaUTR71EO+9gqdTMyhhgr7XYUPUU9xlpD4SwmeOq9Ae1kTNvU2inLOSwgPkIbCL5VJD7Ni4TU6LUlSmFIQUMI2hWsyyYIqYQpMWQSgwpE+WIxBR9xKuxFDF3GKKYC1/z+DMCFGPCt75wUkOZPpG1i6lSVa3QFcQYnhXaAiiC2oCgrrHXdXR2Y/cnjfH7NZZBUZl731Y4vf8+LANrPnemrf/h/oUeBUJQWK1BYYWVpgRPHDvPG66/x1ltvcerECZaXl5NjTQ0VYkyibLFzts8G3s/7eTajAqmUNGcbZxz6bCD+okPnJ3QoL7MOOIGcLzhU3Hp6zXo9SegblMpfOr719jfZ2t7kf/n//HNu3b2ntc1BOtqrVT4zweeA3qRWqrrW9vf3+fO/+C77e/v8d//tf8vXv/YWPePAqP5ZNCX9Q8d55RtDFlfWuX7lAzbu3KTe36Y0go2+u6couu6t6KZndmwPjEdUpxVCJHrtOEIKNr0PeJ9GbCbTrJnHALgUOBsCvnserc+ZSc0Sd8Hgs2MaQgdCi9HrVFmAiG9ber0CsUJotaZbbH7eStNO2xtNKKQ6ckl2zTrVZZsVDs1zJUT1fz4EjHHM2hiD0Y1TmmM2zy+xeHGIregvrLN69AyD5XVwPVoR6rplZ3eXH777Lv/xz/6Mcd0itszWt0t+QNRSUaCwjmNHjnD65CnKstD9Wq6BTyUBIvl5TWdt4wN37z9kd3eMtQWgXflMbiMbY5oGSWfCt5hoEVsgNujUjTEB5yEJwkfaGHi6vc/Wzk2u37jN++99wonjRzl39jSnT5/iyOHDLC4uUlUVZVWpXzOJ6i4pFA8poZSvI+2wIp+PCfOz6dZvTOUZRYEVgxQlg6pieXmF48dPcP78eZ5ubvJoIwXjN29y685tHty7y/bWFg8fPuTJo0fcuH6dt15/na+98SanTp5icWkVV5QsLS4zGA7Z3R+ys7PNeLyHxICfuT4wRAmQ2j3njd+sjZraJxVczcsr0/7nx9xPTK9n7ifmfmLuJ+Z+4uX9xEsxap6HYH8RmPK8977o5xf97qt8zhed88uu/fmHGpYY8348v372fbPoGDhX0B+MGC4sUVY9ar+nHXdkes7cMUmANhnrQEJzO0XwfK8hGZ6p/ocaPy0l8W1L2zRYY/Gu7YCaWWoVRlRJ3utGm+BpI5gQsEbrJZ2zFEWBszXOWmpUrwYXobDa7QitjJGEXlujG29nLKUrqHoVpbUU1lAaQ2EthXG4oqeIoSQj0bbU3rNXT9iZjJnUDfV4m327QzCpjWGp7aats4z3x+zt7LC3vcNoYcRoaYnh4iLDxQWK1F1p1B8y6A/p9/q4hYRwty1DRDVw8JRNgyHq9RYFVb+PLUpMEiSOUfWA2rrq9FiaVgESY9TYegOhbSEGXFno3zJI4yxUjnI0wHVATaEGWx8GkdT1y6pT0GxRpO6XtON9xvs7FNapAYso08V77e5lpJtumQZskhPWmaVmOCZQhU6/J9FLs4BwpnF2M1Lnucz8hg4tjt3fI0wBmpRR8a225Daa0kiO0tMGj5Gk20O6Vn0hk3GDD4BYiqLEpu5QXYBwYH0/H0WPM69/1rJ9MVD87N+etUuzv/viDNv09fMDoG8j/cpx4vhRXrl4gddefYWLF86xvr5Gr9/DSO7qFZNANjOBkc6T5zmz52VMn/dcZgPwZ1//hbZeptmcaSgYD/zzvCMmx5ADIb2fOJ0UApFAGwKDUcUv/MJ/ReMb/sW//FfcuPMAjOBIumNRIKid8VHXcQDMTIeAtm750bs/Yntzk+985zv83b/7d1leXkWco0518b3+KicuDBgsHuJq/x3uXb/CeH+TMoKJDZLOGyJqV56p+c+BaM6a6r5EA2tCAmUl2R1rkmaAfgVmnpWA6mE1RNo0lJpo0CFKm63u/tPIR2WaSoqNo+RNCYRg8F7PH3zEi8eK4JzBmogVtVlWTBJxJBmKgMEg1nTB5+zm7MCcCqkdsE3lpKR6/xhSVlHp+cZoeWeMBlP0CM7RXzjE2vGzLK4dR9yAgPrNpqm5/PH7/O9/8Hvcvf+IGDWTbsR1C0A1DHT+l8bQdwVvvPIKxw8fpnQuzdGUKDExlRnoOAtJ8yEGtrY3uf/gPpO61vLnVNKq75ZpQjuNTWg9bd0gDkQskETn88RPzyjrSfgQqdvA7v4mjzZ2uXL9Liurn3D8xDFOnTjBieNHOLS6wuJoyHAwoCwchVNdhllTm4NaESFHqc+L0Q4cyY/awiEI0VtMjBSl0Ov3WF5c5Pixo5w/c5bNNzZ58PABd+/e4tatm9y8dYt7Dx7w8NEj/vBP/oSrn13nzddf5+KlVzh+/Bij0QgRGA5HOOfY36+Y1DV7k7FuyrIdyV1Nuo3MQXvQrSPoND/C5/zrT/cx9xNzPzH3E3M/MfcTX91PzEuf/pJHHnxbFCyvHaaeTFhdP8KTe3cY7+2iiz5vpRPKHICoYIsRpeAVVaEtlwFrDK33hNAyaWoqKRNyGWjbhrq21OMJzrqOBldUyqpxZQnoxtoGh3eN6oQ0Le1+UiwPXoWtnMW5grZpKYuS4CP74wlikiZOAS5pWTWtbspNZtM4h7MO5wpcaXEogmzF4kyBc47Kagtp6ywmlWCRmER1M6FuGvYmYyZNTd007Nc143FN42vqEOgJVKZgeWmFQoRi3FC0W/QmkaLXoyhL3F6g6Htcv6GIVu/JGBaGI6Q/IEnaUybR3xgixeICUpbEssIFXSg+BnxdE9qG2NbIvurpSIzY0tDiCE6Re1NYjDMYa3HDHq5XUgwr3LCPqUpsv8QmkVyRBGREBcuME0xhKeoSayK1FdrKUVaFLt6kpRPbCaEBfIEUTimHhjSeJbaowLgOLo8KKWOKEq0N9njf0NYTQtsSvAI4zmkwpGi2mVIRm0bnZ2JyIRFTFUgQfCqv8vt75JbxPnjwKmjtigIJKuhGgLau8+KgdCaxyLRzWOtbmtaz2Ku0TC6h6EpZnQVTZ1fZDJD0RZHRi1fpj/Ge+fGyx8998y1ef+MNXn3lFU6dOsHCwoiyUsMRRbL0EcbYadvUlJWzKTD7sszo7M8Hg/GDQWQ+DvqRKbA3/bVuCA4UFc8G4aLB1wudZ4QuWkynO7ABMPrlY2C0OOJXvv3LNE3gN3/r33Ht1m0VfydCEKIY1VCIEfBpY2KQ0HZijD56Prt6jV//X3+dJ48e8ivf/iWOnziFlD1qHDEIlRuxdOQcF8sevdECt65+QLP5gNC0KjIZhUjAPrPBeV4GOqbgO8RA1uw0JhKjTSUIMZVaBvxsEG4CPrS0viHQpMBdNbxCpAv8SVnzHNTkUMWIA0ziDGvwIhKxxhHxhODxDRRVqdR1E9CmHFH9lmggbsy0Xlzy2Z99Rvke0zU5Y7G20A1Dpr9jDnQesUa7E2Ic0VW40SKHjp9l9dhpXG+BFvXdTdty6+Y1/vgPf5/LH31Im4X4gaIo0lh7RFQ3TGKkdAVHDq3x5iuvsry4mLKiCrh34pry+QCw9S1379/l9p3b041hinu1BW/i/YaZ+65bYoiYvt6TAS1vjVnkMZVbo1laY03KPAu7rWe807Cx/4gbD57w4ZVrHFpZ4uj6IY4fWePYkXUOrx1iYTRg0K/o9Xoz9zyzRg8sphesMQ5afRGIVjAxxSPRYE1BVRUMexWroxHH1w7x6tkzbGxucvfRA27fv8+Vq1e5eeMG9x894tEf/zE/+uB9Lly8wPlz5zh+4gRLi4tact0b4FyJQajbhrpp8VHHMVUUqK15URDe/YvO4+4Zzo+5n2DuJ+Z+Yu4n5n7iK/uJrwTUvCyL5quc54t+96LXvBQK/pc4vgCwe+HfjRiGwwWWV9dYPXyY3c2nNJMxaQtNZ06M1uU1vsUaVRPXtZmRNukeYAiBumnS5l1wVhKrwdNMamKvB0Fbfvu6oU2ggHOuE531bauLMqlExZiFYiO5/Z1BaY7WiLZWa9rE5AFrLTG35Y4ZF0jdqYiohkqLNxYndG3pjKTyHGPBWDDps4w6m9IZQq9iYdDvGDdeVCROwQBSCzS1JIakwSMGV1UYq8CPAGVPW8MNR0Oss2rIGyWlSULnbaWCwhGDqZyyYApDrFMrP1N0Bi7gFURok5hz8AqSiMWJgBHEGopeSTHq43olblBhB5V2enIO60zqyqRUyBgiwRh9XgLGGQRPUTjaekLZU0FhYvqcqsKVZSpxSmNqDZKRfDHdc4nJSKZJpsGDTxTTjEan5yJWz2mLsptXAIEmlTql4taUgQmzOsNkJ40i6UaBmph+aaylSLo+IWnl+Nbj20DTeNq2wceIGKGsSqwxU7bPgXU28zkvBGfSivoylP0ljlkzElMg9pOydT8Nx//4P/7fOHToEFVVaiCZg2SJauOYUlVzEDKbWIT8vXT/qq3KcyEeeC75+y45J9K9RyQH6+lDug+c6isRk9qWTAu544F/9XokZ/G6i5z94SCwOJ2P+n0kqth3aiM6GC7wne98B6TkN3/r33Dz3m3axH5LbGKwuQMAaJ8PpbcbERXkjpGHDx/zb/7Nb/P06UN+9R9+h3PnLtLvLYAr8W2kchXDQ8d4ZWGB5fXDXP3wh2zcv4Hf38L4Wtt7aq9MtU2pG5za4EQJF9UBQAQJubg3sTqj73QIsvZCBpcBQvRAQJxNdGqbMlv6WdGY7uHrY1FRUW21qj4CMYR0Pbm9aN7gxLRpMmg22QBGbKKlq0g+xnRsSGulE0i0adOXqf0xJD2GJARoc/09Xjcc1iGigLwx6XqN6YLvYHusrB5l/dhpesMlcJokmUwmPNl4yp/92Z/xp3/2p2zv7hBciYmpEXGeY+i9YvQmXVHw2iuvcv7sefq9fpetlTyXc1vd2IXUhBjZ2dnj2rUbPHr8JF23Vb07cvmI0v+zop2P2jggtgFbm3TdumaDT8C50D2DmBIWzqZ4wBQ00VB7cEaoN/Z4vLnDZzdvMSgcK4sjjq2rVsGxY0c4cvgwKyvLDPp9isJSpPjEGa3vnw3Edfloa14Iac3JjE3J9+0hKmPZGNFSBCv0+iVlr6A/GLKwtMLq4cOcOX+R1157g7t37/LZ1WvcvHGdO3du8N3vfo8PPviI06fP8MorFxU8WBpQuYJ+WWKMdo7UtZfGI5UYGNEyBCHvibTNsIhg8/qfWqD5wdxPTP849xNzPzH3E3M/8fJ+4ifKqHkRcPLjAjMvAmT+U7JuXv7ahbLXY7gwYrS8QtnrYZxVhkbMQMy0Di2E8IyAV0Si6TobgRrutmlprRoYl8p0gletGi1nUicSgse3HmlbbSdHWuCk02WDF7U8Rh2iLmRBkrEyOGtpGi3xQcBYwZJah+duQRllT1/KihBiBgMSsixJNIr8eyPT0imb1fBR0V1rkcKmTbuoK0gUS6W/hXwbRFvoeUXpl7YqcVVJf9DXdtIxEqkxcepoTL+HJIRbJIJFa1gbFcXNQEhMzQQU2MggSNBrT8Y4GhBrcVXZdXayvRJbFiosbFMXqPTcRCS1ZxRiETp9IEFLoVypDCTvW7KCvq2UlWNcYs0IaUyVlUTMizt2AccUd5ka6tkgIQLGFRjrlOGEQCS1cacD4/Tcel7vA7kNd0c1hlSOpWh6rmMW0fvyqTtUiKkcqvU0dUvbep1x1nZgYpz1sDNr6+WA2y99Sbc2p2bw82/q7PoLP+cvDwb9l3wcP3ki+cmuqjoNaOzmhkES2pdBsHhgnk0P6V5jOgGvnOU6mHHQmNnmn9K5wtQ+QbIfIf09z3MFOfX3ua1n5NnHa+SZziIH5o4BbPdT3ix0XxFlnKUgSxD6g4J/8Pd/haqq+F9/8ze4ces2baYRp0Spl1SuKImKHJOWmXXdmtrY3uV3/vAPebSxya/+g1/lG1//JkuLK4hYQhsprWDLEWtn36S3coz71y9z5/K7bN+/Bu2eijaKYMUrI9NAMKoPgPdYaQANJCRqF7eQSyt1YJBMz8ZoHXsOEKMniieKxaucIviICzom3nryZiWimmcE1W/T+lqINjEc05zKrSusTYGbgDEtREGiS3PApUeine6yEKk1unUQARtTikE0WNKGsOr3tIWu4GkJEsAKUgjGlEQkdfNQTYTGOEw5ZPnwCY6ePMdgYRVcSRMCDZHtvV1+8O67/P4f/hEPn26CtSDqQ2wMSEwxgbH6fK0K84+WFnnrG19nfX1dM8si+BgwHc0/ReOpY4T3UNeeB/efcOXKZ4wnLW1IHQDRuB5azbiHQBs0W+5DKp+IBtkXChcprGaoI2Em+IaQWJeCblTaqIkUDemhbkIK7QMiAceY+482uX7jPr33P2b10BLHjx7jxLHDHDm8xtrqCodWlllcXKAsClxhKWxa61FFRq3RLpBtrKcrL+r6kxzRiklZ4CSbYGZ78RisLZEQsVWP4chzaPkQJ4+e4JXzl7h//x7Xr13m008/4/qNO7z/ow/59OpVzl84yaVXz3Dy+HGWeou4sk9VWZpQa0FIbNVOiJYBWwETpUu2aWBwcNOugADzg7mfyNcy9xNzPzH3E3M/8VX8xE8MqPmrBE+epdz9TdswZQDEFY7eYMjK+mEGCyN2tzcYJ6AmT5rc3YkkJCQxYmJ2VKlWMvunEAhNQ5MWgDWCE4uXmESFPa1XIS7tEKblO61EBUliRpaVASJ2SumMiSaRBWWLogAjVHXLZFwrBQ+QwuCsGsq2VcHYGAPRN4niZTsBJbEGW6YuSFYBCmuMtsYzFmttasNHBssRsYpQG4sxTtXcU3lVB06IQOpUZayFVAcrIuAsrurhehXFcFEBnBjxbgzBk9khrt/H9nqY/kC7W0UtLQtNYs14bfcX6ga/PyZ5ha60zFSlghulwxZWy596DtMvkbLAlIWWO1mryHpq222NnU4SE3G2SJ/tMc7gy4LQNPiyp0ynBKDpuVwnJCwJhckdxHRSdRxFBad8TCriQYWFYw4w9Geifr4tC3BJVd6HxGqJdHXgIqqF5BuauqFtWnyT2DH5vIUFq2Bam7R7QBArWi9nDNF72tDQtJ66aajbgDinQsKu6IQBQwcYpqH6TwjEzo+//JGfY/46KND4eVv9RfZ71tbP/pzt/udo68nDhc7I5sC7exUx5Ndl4TlJc90c+Jxnr+sLuiWCaOB64NqJmMSY1GtOtlcivtXAc2l5xC/8/H9FUTl+/V/+Sy5/ek0zpCL4KAhOAfvoE5CZs7kzIymWehL4/vff4eH9J9y+dZdf/MVf5NjRY4g4fDCEqIJ/i8vrLA1HrC0vcfvKCnevX2Zv5ykSG1rfYqO2D7VECom0vqGNHiHpR2WgHDpAfrpSU8AdAznskGiwKTGh8Ksy6GxIgUvqZJGhWZ98VxJqU+HQFGDa/GnWaD13Eo50JmKtUCTGohiDtZaiVLZmYQxa8h40YAs5UEvBdxck5Q2TIWIT+B8whMSgVEHLPA7GGHzUr9XlQxw/fZ7ltaNI0UO13wPjpuaza9f4nd/9Xa5du5bTIEnIXrvekYRNdRpGiIGicLz26kXefPM1BgsDjQ+CV6HMPLezz9RRJUTY2Zvw6bXPuHX3HpO2pSVqZ5OkIxZjiyfSxog2+QuEdL+5PagPquWg+8mUWIg5maP+0XufsuRoEB9nqPZoQKoZ7IgJgbExlPuOzZ09bt15yKAqGQ76LC+OOHb0CCePH+fY0cOsrS2zuDCg39eukYULmBBwxtLtt1M73al/6Lbp0zUxXfpkMF715ZyyVltLWRYMhwNWlpc4eeIor77yJp9du8kHH37Ep1cv84MfvMv1G1d59dWLvHr+FdaPHKOshvR6jsZ7YtMoeyILhsaZxAIgRsceZnTe/obFqn+dx9xP5Dud+4m5n5j7ibmfeHk/8WMDNc8DTJ6XeX5xPehX+6wXfeZXOcfLvverXGemlim6b3BFycrho4xWVtne3GCytw+iC8aHjKwpEBFjwIdICFqjSUL6Q0Z00c1zSAugaRpFbIF6MmE8HmOMoaoqnCuhRA2F96oOrr3clEIXI5IWlwCSBKoysifGYkWoqoqqNyESqes2AT2AM8pQiSSwJrF4pCVEUQOWDRo6B3KZFiJYtO1eQFs/20wTtMnMisEWRWKMiOq6tG1H6RRQnR7ncINecqJoSVfhiM4pgGP1/a5wkGqHxVhMLwEfBm0hnQCJGKMCJXVNbD1+PCY0DbY02jrLKOjihj1MWSCFVdV4I0hpsUUCoIwK+JrUOtuaLO5s8kQBBBNjyjJouRV26iQkO1wixhYdQp3LloCOceRRCp/a5ZwFilPmS/AE39JMalrfEEPAiZBJXbHV2tNpbZO+3rdtAmmUuto2NU2jYE1mYkUCEtWAG5NYXsm4t5NxAg3jtFtUOl9bN7gIpgipDM7iUvcwOvDpy9dmflnMiN+XrNnYBWdfvq6/6DzzcqjnH8/a+y8LsJ99/Zc/u+lrn/lrCr5nGIIyfd8U3MwigR2mOTPVbMquSgI2p8dsx4vu82b/btoDP4tIJ/6efLTaBTSQM0aI0bO4POIXf/7vUBWOX/+Xv8nVa9fZb1raYFLIaQhtUL8hEFKWrdvkhCSWiOHajVv869/+bR48vM+vfPvbXLx4AcoBhXE0MdIAhZSsn7rE4tIhltdOcv3KD3ly/xbtRIAGiS20HiMBEwNeLAaroKtRxp1J/M/pkChQrM8vry6DE4OQaPhEjLFJALMhEnBMA6cg0m0+EEmszaB1/ukhWREKUfpzMGrrCguVs5SFJdPCi8JROc2OGiElPwJ6A6nUIV8omrnvyo3FEMQSxWKSfoHegz67HKy3AWJZsnToGMfPXGTx0DGkGNJEg4+BSdNw4+Ytfvf3fo/33n+ftvVdsF3EXBaa93/KsowCViKH11b42Z99m/XDh3Rjl+aLzifNypsU2IWgfrMNnkdPN/jgk0/Z3t+n9lofH6Mntg147eQS0hoIoHR/o3oQMf01RE/jY9qOSqcX0nhNyEj0mKC0dvUviQEQSZuVtEHO6wKDD4ZxE3FoQ4N2r2V7d4v7Dze4fPU2w8GHLC/0OXZkjeMnDnP8+BEOr62yemiF0XCBftXDpcy4FZNKHeiiLf0wMxN96X/ZQvj04mw/TNqkOecoy5JBr8fK8mGOHj3FubMXuPzpJ7z3wTtcu/EpP/j+j7hz5z5vvPEWp06dYWFhkcI5+kWhTQdC0CRbmvs5X6KjYiA2z7iaua+AuZ+Yvb65n5j7ibmfmPuJl/UTfylGzcuWOj0PrHmeQNUXneeLSpC+KgDz4wA2L3YE0v0jaN3faGmZ4eIy/dECW48fd+9XMSqTSoBsB3gQtZyJhCp/TjAtbXi9MbStx4hoe+66pnGWpm5wRa3XYATfgqTOP9pdPE5LTNJ+NXb3pI5Ku04ZFSQuClzraVKL8ZjvOTuWQAf+KFJuu9Io1WIJmCj44JFglBoadMGTnJQ6o2SI88LpulapFQ2NIr54FDcXLZNy/X73WcSoYE8usbK5ZMqmZ6UGB6cIRQye6FsFMkKrLaszUOO96sRI1PNIciulMmlMacFZBdSNIElQ2My0JDfJwJmkPyRJKEqprVoHqx0bE9smiURHq9cbU/ola9OQAgkdl1TyFCME37WtzLTg3PowJF2d4BPo0qqCtZRlAhZjYhHFDqSJM+/taosT2u59iw/tFBSKaqyz89JbVJDR5zbeQVt4e++TkNw0m2UlodiZLpmE0NID+/wae+5y/TLQ5YvX+ME1/NUD6TnrZ3rkoHP259njWTt6wLa9wP7P0sM/n32d9R+QaezaXSOv2+yQ9X0xaJ1z96YDwJ2yGGfdQi4DnL1Wva10/cnWzoKA5kDpJ8nGRaJJ69N7XctAVZb8nZ/7WQpr+Rf/8jf58PIV2jbV2oP6h6Ck6+7egwo2GuuSQLcnEnj8ZIPf/b3f4/btm/zqr/4qP/P1tzm0soaEoKWg1hKjxY7WOfX6Esuri1y7/BG3rl1hd/MR3u8jfoIl2RTndOSsKJPRJOp5tEiQacI5gcZODL6TcVDhPk04hCSWbxAHbYwUKYzUGSJJsy0JEkbNnJoQkjC94EQojHbu0PavUYPkVAFqRDUDSpup7iTdNd08dH4LpWlHlKqfC38hn9d2ZbFGIi5lZUNU4mEUB6ZiYeUIx8+9ysrRM9j+Il4srffUvuHeg4f84R/9EX/0x3/C7t5evkMsSXshpDmTZoy12i1vUBZ84803eOvNNxgOB2pPRe8jJH8ocEA4MwTDuK25efc+V6/fYm9cUzeRIGne+JCyxarJ0HUClMzKzJtWtf1tVMFW60pMopTnjoEmBoQ07un9LgW/Gj+IzjOxdJ1bjLYFFuMwtsI6k7qWBHzbsLFbs7W1y81bdyl+JCwvDjhydI2TJ49z5vRpThw7yeryCoN+n15ZURQOl8oUgKn2W0yJqC5JlLQSukhd17C1UzaHMUK/N6AMkaqoGA5GHFpb5fTpU3z08ft8+PH73Lxzgz/9s79ga2uHS5cusbK0RFmWlMaqVoVMdTHUfEmaUWnj3GltfjHA8NN0zP3E3E/M/cTcT8z9xFf3E3+tXZ9eBqyBv55N0cuCUPpL/V+MYI1j7fBRjpw8zXhvl8e3b9G2TZp4Ee+0NMYVTmvmRBkNbduqIFc22pDKl3R8vPdpo687fQuM9/aQGCmKStHetoXY0rYOa7U7ECSnlz4jpMWU2RHBR6xTa2ZAGTWTCT4BNXXdkBkaJunnSBRok5NLZTw+qIp53U6IOKJ16TqDAjkmEtLiBQhJDju4ABEkGqJN9FNjEGcIuw1xUhObBlf2VIRu0KNYXtFORm0LdUO0BmOlGzNl1aAGleQovF5n29TEusHXDX7y/2fvv58sy677XvCz9t7n3HvTVVVWlu+q9r6B7gYaBAhPAiRFiSJHeuQoxihiYuLFxMz8Nv/PzIs3b/TexEh6okTRCiBAWMID7b2rLtPlbZp7zzbzw1r73JtZVd3VQAMSiXs6qjPzmmP3Xmvt7/qu75pQtraIqVN9GFE7HJqGMGr78iHXBqQxQCInPT8nhKDdr3xo9KcPqv8SgjnaagWEbRZBMNGtRimA9tmUtLYRzEEV1Ppbh6ZemyYXINo5i9Vdlr6dt46XSLZyripg7EMwsCqTDcUvOVMqGJOS1paibKkYI5OuI2ftAqXf1QhBbBxUymkq0zbiqUt0kwkb6xtQIKZMBFwTCG1gMAh4ywQ4522clxlR4ZvNvVnQdnuw9P724ZeV0ZwH4HDj/X+/v3cC5e8HnG/LQN4UbC8zTlDt25R5pXTYHp3e9vnZ8yvb9q2vbD/HbboGgjn70vuvatvqfnTaGohrYupaSK7jfmG0wCee+jjDQcu//1//lB/97BkkFyZmYyjFOuUZFRkoZKsytKCKApLZGk949rnnOHPmDK/9xqt8/nOf5777HqBpB6SkHRuCdzRuyK4Dd/Poyhp7Dx3jtZef5/zJt9i6foGGzkpinakqKCAsBkBrVlIztSLggiNWfStRjYTgvC5UcuwXOrlkpZHXwvGZhU3JFuRimemigWcjSml3lD4opiSC1457haQZUQeNdwRfqe5aXmxPgJSzdrGYCWSr3aqZw0pRxjJfAlqiW1T/IYmAH7Jr70GO3PMQq4fuxA2WSa5VFmEWzl+6zHf//u/5+je+weUrV3WhhHbAcMh0PBbzURY4upw5cvAwn/jYx9m/tkbTtNRVmFZIK82/2l2KjvAuZa6tj3njrXe4cPEKW5tarlykajtUqY9MLg4l9Kv4ZQXcKdYFJasPLuLBaXZ74JWBGsfaVcaXhAeC1y5+VA06045z1jQgF0epQvOIjZNA0za0TWtzORK7SN7aopts0qWOi1c3uXTtbd46foqnn32ZA/v2c/TIUQ7s38eB/ftZ3bOb0WjAaDigbRsa03WjFJVjsHusAo06T7bP9TL9vejCJEjBNZoEads1lpcXWVtb5ejRY7z0yos8/8LzvPTSy4w3t3jowQfYu7rGYDDEO8tZm04IzsQ8c7VBNVFkGfrbTAz+Y9/mfmLuJ+Z+Yu4n5n6i2qDb9xO/NKDmVkb4vSmK7/36r2L7wOck0xrLCpu1TcuhO44RJ2PeevFZ8rqyGor1r9NboCU5tX1d443xYbfHiRjCXdkSBVKiM3TQe2FromUmfj2oir6xRdygJTQtzUxtLdR7L2CTpQcTypSVAUb/Ct66DKmifN/r3QnNwJEl9W3cckpKCfSZlKIOOhTcMZdBmZj6O0LwAUSNj1kkChnZ9JAF1zR41xK3tsjjMcRO2TSTEX5rwuT8RROrStotwDtKCoplpIgLwXyuGjpSUpQ8Jcp43IM8Oaq4mQ8e33oFYyqeEgTJCooRBHxRMN0HwnCAb0Lfmcl5E0OuIseljosKzEwBmvpLpSkiAec120CckIuyevqPWsesGdjXwLGoXssHxAdSmpBjpCTNQ+TKwkrJAgCn94U6nvSzVZ+n9Jo2hvcWbUWudEVl/SjFVwEr5xt1UCmZUy59xNJ1HV3XWecpIadCjpnRcMho0DJoGiUHiQqSWTxz0znWz5X+jlRU/ObTcce3b+dDMw/mg9idOUhTt1tlMW+1ee9v+V797s0yDDfb72yWov8nqGOu9tQ+UwNI29tNrmPmGHXK2rCWOqer/S7Y/NZj78z+agAlGjw6FQ03DTlEILlCItO0DR97/KMsjoYMBgO+88MfksbaT0LsAp1TliA54bPNp1znhGqHObvGU++e4a+/8je8dfwtPvfZz/HJT/4me1fXyEAq3ijpLX60hwN3L7G4epBzJ9/inddf5MK7x4lb10zEMINkC3KrvdLOgOoLtBOeFA3YdQwopb3kgmSPFBU5TCUTSyE7bZepNsjueYGSM0b8pzinFHYRHHr8YEC8KxCqJQhC05rIvojKZXkQV6jlvMUeavVeBXClBuJ6vIz0Nl+YapppDlqILkDTsryqwfeBY/fDcIWOhlIcXddx7eplfvLTn/Jf/varvP3OCRRQl+niC2vjWv2iddbzxTEcDvjoI4/x2EOPsjhahGJZ3DIN2LN1nXG9jRViLly4eJlX33ibzY2Jib5rCWwN9nMpNl5ruXPN4mvWUpxYF0O9+yrQqEzP0A4YuhGTtiXHCRInuJI1AC/oeDDf5LEuj+hipjhHdmKLRWXPDtqG0WioYvxFtTi6ZsDWZktOY8SpzllCuHx1zJWrJ3jz7XfZtbzMrt3L7F3dw761VQ7sX2PfvjWWV5YYjlqGwyHDpqXxQZseVEaq6FyvS7Gcp/ZBFyG1BMYy441nKSzQtgdZXFxm/75DHDpwhGee+QnvHD9Bjpn77r+fPXv2sjAaElrt/FL9GJZAgyn7Vy2EzCwGfr23uZ+Y+4m5n5j7ibmf+OB+4raAmg8KnLwfUv6L7H8W8PlF9Go+rO+V+lLtfAOAY2llD7v37mNx927GW5uULio6W6ZaIjphbEDIzsWniY1Bz7ApuSjyKxCTYxIjzk0Yj8dMxmNDgYv2sRePC2nmnA3pZ8rW6TszWdmL4kzS1+j5JuBS0vM0odo6iZ1XGqjahmn9r/7TdmiRrAh7Aoq6FDWYXkVpowFDPiBOiJMxrljJT/KmbxIhRUgdKY6J4y2IkVgimTIFSoIHtFSqhEDp2T87gJpJR67ARM6qaxOcteueel0VSK5lSGJizE7bb7cNrjVx4aYxVoiflvGIOqP6HGfX9EWkF5pSDRoPdijng9YVl8oPpQfvCsWYurVleDZ7ooysHBM5KqOmCoxl674ktd60Mldq1idnimnIaLmTZT1qGVT/WRuvSQ2N66mRRYEh0fdUSynb75o9ilkBOifCYNDSNq11/JoJhPp5PAvG7JhnzAZbH2x7/+/NQZdfZNsZgM9uN9MamN3eCxivdPad+6nfmWZD+2/Ry/3bTxFn9LQ8BUz79+07dct1F2ojvXPbju/q/CioLlepAXl17rO6C0LlfpcypcNL6eMzCwgLbQg8dP99/Ov//b9iYWmBb3znu1y6vq4ZGL1QJfNZhg0piGTtTpnFNLGUkVeKY31jg6ef+RmnTp3kzTff4Iuf/yJ3330PS4vLCI6tgrUYdQx3HeDOld3sP3iYk2++wom3XmHjymkmG9f7jHC9b8XEFkNQ/a0uTSxhq9eqAG8hS7KgVwNAJU7bY7DF0fQuaVZUP6eBfnCOxmmA7L3gGwdeaIrQ+oA0IA0KjgtI0fsjVXhAmLlvosFgzpo0n33idZEnJuBPNvuoD6i4QGgX2L3/IHfc/RB7Dx7DD5eY0NAVgZS5dvUazz7zDH/1V3/FG2++bfcgawJBjHFo9lI7iRTLKOt13nHoEE898SR79+xlEAakpAOkFIzCXsjOxmTRe5dypouZ85cuce78BT1XNftGk9ex7vvSZ7Hae03MaInuNBB3WUs/nG9AVF+tbQb4YcugDIndhDzeRFI0Wrqdo/fkGoDXcmgRihfViciWxPLgJFuwazFTcDAYkVKh66CWlWALVAqkDJeurnPx6jVOnHqXpg0sLYzYtWuJ1b27OXBoH/vX9rG2upflxSUWhkMWBkPaJhCC9PR3GySzVoIiyRbDBfHJYhJhMBiyGgYsDJZYGC2we2WF5154hrfeeosXXnyZY8fuYu+eXSwvDxksjnr2bik63cWSGULNlBoDeb7N/cTcT8z9xNxPzP3Ez+EnPhRGzXvpx/y3v90M7Jme+/uDTDcu81IqLK3sZu3AYQ7deTeXz18gpk0ar+BDrPssupBWB2aULOvyUwEP3buCOyrMq+c87tCOQAJuY4PWN5RUcCOPuEwmkXxCgi6KVZFbS1xySXjv8U0gl0xXdJGvaKLQDlpwQiyZLmm5VEpaF4pNIt94JINLhdKVGbAmkjM4ChHV45XsiRRC2yCugcbpYj4mUtfRDkeKOI6h8Q2SoEQhp2jdiiIld8TxBpTMVikKtpRCMxzh2wGuCXRNIC0s4JtG2+/Vx5uzTZJs5UB95StinZykVRGybOr0SDYjrvo2EoK28xu02uo7NMiMgLEPDWpEnAoiz2RR9FnPoKWmyeKaANHE0rI644JmF4gdBs8oM2k2E5OtVaSrzzZBSpSkQAmk6b1DMx1KjXWm0aP/sv2euk7L4gxoiVFbaqcZjRttuS24xquwG1hpmAYgMWsHsm7SaRvurHTcNJlQCjRNy/LSIiGY3FzVGMp6b8q2OceO36cBTp0nN9veH7itz+SGb77Pd27xzj8UE/dL3t7bRtZnVuxnfW1nUL5zH8WA49nAG51fM8CbmwmklaarQWvpMyG2D/PqM6OMKZhqW69pbVF2DRb7jNM0IHdgAfhMNsrugwrpTceHxrDT0K8UjS4yECnGXHPcc//9/Mmf/DEru3fz13/7Nc6dv0jK1bNbVtFpiaNeTSK7pNX8xWi9JmoYc+b0uQv8zd9+nbeOn+Dzn/kcn3jyKfbtXaNph31GzQPiWlb2HmFhaZUDR+7h1Dsv8e7xN7l24Qyl24AyoZSE5vBMiysXXBGCBJILdNkzzoUUt3pZxaqZZeivlWxqBhUD9Z3o8+/1Aip93clUcN5+HwRPE7wG2tYZRLXBvOZCFTPWUoK6aLD/KSO+UBxkp0C5MjwdZI9ziSyRVAqpeCY54NshaweOcvSeB1k9dA9+uEhXtNSUnNnY2uSFl1/kz//qr3j5lVdJMeJN1LDYg882xFyuI07PXXJkYXGRj33sozz08EMMhws2AAvauaJP4ZAKUBwBFesEyDFy+eJFxuNNZTg2gVLAiScEFZR0KNVcqepOu/SJZpydVKq9jUox5qSrGnrQhkDrR6QmEsOAFCeI+RqxWCFZQJ2NVVnIykSti14yORYmEvEhIRLsxti7Toj27IK3hS6a2Y191xNHTsJ4M3N98zpnL23QnDrP4psn2b1rD6u7V9m3d5UDe3dzcG03e1eXGS0MGAwHmnByjuA11slJ9TB8aG3uallvFcDPBcQ5FhaG7Pf7aAcNS7tWWFha5pXXXuX1N99gfXMf+/buZlfZw8LiAqFpde0u3hiiSRm4pdqxOaMG5n5i7ifmfmLuJ+Z+4ufxE+8L1Mwa15vXff7qt//ax9+25RlLy9StOHGMFpe468FHOfHmW4y3xuTJWI1tymQ3bcVcETW1U1rWhBmmUgs9DV1OpuPhRDVhvDiiT2xsbBDHHd3GhIXRiHY4pO0izfKo172JsSPFzhbeBlYYU4Rk1KtKtxPHsB0Q2w7JkLpCyoVoTIsGj0eU1uhFS4W8gFfjAcWMrCMLJoA8IcWoiGo2iS4Rgh8iTkt6Eg6K1TsOW4ok4paW+ZSuIxbIqTO2CJRg7cNJ0I2J3VjFff3U2ReUxSJOmUBhYajASwhERZJURb6oAYHcgxsVhBGvwsG+aRQFr+BaaBAfkDCwa5I6AGxAGIw66+xN7yXH3Lcc1DaHFjSg9acq1Fyg/2kUuTJTDlf03qTYWflRJuWJsmuK6t9Mg5ti5VEJYhVUzmaYdEx0UXWJFKDRltw5af2udiabCtmlpO9llLZaS6VqF6eYIuPJBO88CwsLDAYDnEDqOtU4Klr+V4l/NeiZDWa2b79sZGQazM23299uzxxL/3MacM8G5dv3Nc2Mbg/U9V//abYF1TXG7b9SaewgzJ7kzQG73gZvO91p9nOb+KVFLn0AnqfnV8tZ3zsLPAO81oANOHbsGP/dv/jfsLq2yp/92V/y9jsnwWnbR4q2AvW+UV0w6zoh1v3NoexFaxwKCJvjjqeffZ6T75zm5Rde5stf/C3uvvceFhYXaJxHmkC0Dg0SFth14Bi719Y4dueDvPv265w78QbXLp0hdtehRJMAVPtNytppQWPY3n6mkvvElLMMoWbABCnbFz0VMne2n6ongBRdbIguaFrf0rQt3plPRLRcePZ5gNlFo+GjC7FS/Y09q+zRsktrv+uLJiG6kogxI6KA/P7DR7nzgcdY3X8UGaxQXCBbV7zNzQ1efvVl/vyv/oKfPfccXRcxJQi8U9+cjV5fB6SU0ncwbJrAY48+zGc/8ynW1vbig3aVUS2J6WUVqiux79r3uxS5cuUyMUVCq97YZB4J4vEm7ui8p7hA8c6yJg5X3LSEYOb8iquZYxCnopBN09DVLHxUdoBkVIDUbrv2ASw9W7hetu65kApkIt53KkBpC9YYM9GSRyVNkOJqfhHs3FS/QPUOii0SchHSJNNd2eTaeub0mauM2lMsDQOruwbsW11m/6ED7D9wgNXVPSwtLjAcDgimAdL4gGCUdLvnqiFQFw6qn9a2DbtWVmjawHA4ZHllhWeefYa3336b8XiLaHZheVkFMjVRo3FUfY5lOsh/7be5n5j7ibmfmPuJuZ/44H7iPYGaWergztdvBZZ8mGVON9s+LJDmvU5j9hA7aZQ3+TRmXWZe0u5O3jfsXt3HnrV9jDfWuXb+HLXsROtS6Z1FrpY/554iqg9z+5EwSpuzrjoRIfrIRCaqCZIywWawbwI+tUhR3DXbwrwyMvqMQDE4Y4Zq6JzQBE8TAqlJTCaqCaP7UZV56x9HMMtZTME7e0W2pTilrjmjCOZEQlt219IdB4QcIYvpq+ik1frRAqLiwBICOEciE1MH5uAyWSeqK4oxxQmS1IBMH7aJtHmnLbFJZvAz2Xl7fvW4+vnqCcSQeuc9LoRej8Y5BXFcLR8rM4LY28aKPu8adCjwhgFiteSsdlxKxiCaareUmSyDitFNVclzZdpkYxiZ408pKouoCBKkv4bajrvkyqbJM2CNdY2yfVQhZUQMlNIxkW1MllL6Nt6F0rdOrM4j50LX6fvee9o24CvgWDQ08r4hDEaKWmfruGXWqtdT2hGgvZf92F7mBz8f4PJ+3/lw7M8/pm1n9w7Y/iyggm+wM/itAez2bVpyh9kCcTWY3nms6d82vCy4nY6f9zjzbd+d/iwz429K2XczFPdtAbgJftc5LpKNGbnTDsx8dUd2OFeWHLC6uoff//KX2b9nL//xz/6C5158RYFp50lZA0fvA0WLSw3I1WupIu3VR9e5ev7CBb75rW9x/O23efITT/Ibn/gEd955JyMZEMRrQCaOJnh8WGBl/zF27dnPsXse4OzJNzl58g0unT9LHF+n5DEOBXodEFwBIsUlXNCug8Uix2QUXx80MCQqE08QK/1Uc1vNR/COJqjmmqsZVNHYMaeIE6WKV92tes9CCIjUslvZ5kNzzhpcFiiiC4hSNCCWnq1aiASkaVlcWeXQ0fs4du+j7Np3B9kNQXwvwL/VjXnj7bf4z3/xF/z06afZmGxZ4Cq9z64sWVA3maQgRVu5Buc4dsdhvvCZz3L/PffTNo3pXtTsfo271CcFKh1coDiSCOtbm5y7dBnxKs4uLuD9AIfXe5qS/tMHRKl+Ssn/0yBZcj8Psh20akuUHCk52viKxDShxAkuaRtWJ0KOFlvYP7JmG11RRn4VuEwZkp8QfcB6Bk47hRT1QzVjKShNfNrwVudP1VaoDPEUC2Ur4pshXVfY2hpz5epVTpw6Q/PKcXbt3s3+/WscPLCPtbW97Nm9wq6VRUbDEYs+61j3lqGn9N1basLMIYzaAd4JYf9BBk1D6wPPPv8s58+d78dd07SMRovmByud3WLk3h7Nt7mfmPuJuZ+Y+4m5n/jgfuLnAmre7/O385kPQ1/mdvZxs+NtP8/pYK9Gsr59W6doE5p600VBDxVH8uzee4DDd91DzpGNK5cpSUtMJAtNE8zR6GI3ZeVzOFfpidJryNRryBVUITKh2EBxUFCWjo8K1DihGQ7wMSJWqpJynmrjVMDGFu91/VmKooSlQCOedmDlUV3SFstJgZGUE9mU2H1oyR6Sh04yvmlh0FLbVQtCiZkSFVjI9fvJwJpuTJJEKI6UOlz0xC6oQrig4sKjIRn9XiwqWOydU4DGQwkmjGU6LaXroGjpD94T2kbbFTohpbEKt7mizBvn+ocuVTumAhyC/gweFxp82+INsNGfVnuYIyJ+ZvDUQVorb52OkYrcU4xxlJTRUjpiNybnaAiufmT2OZWsLRAB04zRzk0VqNE22omcOgVCnFf6nrULLwbSlJQU8TeHknI08K0o8DUDHIl3lnUwBL0PqAoxRWLXgRct/RJnTgpizGxtjamt2IeDVg1+rnNDaNohw4VdOOeJcaIdufKYG4MnM5AfAHeZDfZuryRq9uft7n++wY0B+Hb7agE0mgEpRW7IHMw+nxo41QB8FnAtbO+yYSabCi/XLOrs45Y6YW7Y6hib9Qs7r6syHcsNvlCptvZTQ64bguqbjZF6Xc5tF8r0Jp5nH2JlOOJzn/oU+1bX+A9/9ud8/0c/4erGOlEcMWsGLBfBFRMtd8nOI1ut8xR0V7A0MIkdr73xOm+efpNnnn+GT3/603z8yY+xtnc/C8MFghNycUiBDhi0K4z2LXLnnv2sHbuPUyff5syJV7h24SRpaxO1Z1HFBkm0PiMIWRqj9QsTTOvKAHcnhRQrnX72nqrQY81mBa/UbO8EL1pTb5p8OHFW249pb21/6ILup2psOQuKk9MMdbGkRDIGIsWRnMcNl9i9dz/H7nmQQ3fez2BpjdwskAi4DF0cs765wctvvMZ//su/4Ec/+TEb3RgJQcsM+rhh+hzFxmcWsSxzZm3PHj7/6c/w1JMfZ2lhCefqwjKbIOf2fTRifszKNcbjjotXrnL+8hWa4SI+QggDQjNC8KSuo0ikSMS5QvFVa8CrOzJKpB5DwfFcx6ZonFCylo5Ec10ld30Q7lLGW7lqqaKWlpCoiZ9cBBWRVL0MLc+19802B69+tSRPKs7iGl3EOHGIryyEYvuHVLLpuNWEkcNnFfL3oUUkEFPk+rXE5euXOHn6CkvLJ1leGrGyvMCBA2scPniAw6ur7FpeYnl5RNvaWBLpYyVyISZNqjTO4xcWVKfhoYcZDYf89JmfceH8BYbDIcEHZG9gMBjpQlE8pTibgdOF/K/7NvcTcz8x9xNzPzH3Ex/cT/z8GjVixqtHf/8xOKPt11Anwntem9WFTnE9qDfFiWcwXOCeBx9mNBqyefUqZ08c18VtdqorUsqMmrmCPrFk1ZAxpgZMDXfO9TNTKmfwniYHnHMk1NBECpPYIZOxCf+Wfl/ipBY0IhTT1dL36/U650gl0zSNAiApK+0vJmJUdkVJma6LlCzEWOhKYZCF7D05eIIPRAreAQEtERJR+mNjrcNzZpOIiwmfMGRcy42awUDPvRGi6/puQlEig3aAtC0xCLkkXLL7hDkiJ4hodyHxAgMFVqT1WuToPeJVGFjBGUG13U0ryLR9RLC2cQPVwmlbquiXor3q9CiGFEsFfnrItR8R+rwMLCnZUGhl1uSkHbvIiWJCX3276lKmTJhU+mPnqjWTInEyNn2grOJfwWu2oQY0KVNKInVRwcKSe0ZM7DoFfsrUZGiWpRirKOBcwHlHKQosxUnsmTjKZEqUkphYW/cuRiYxMxyNWFleZs/KLkrKRFS7pptM2FzfIFy5zuq+gzTNkDKIbGxdVR2hnG+Yjx9s+8dgj/5hbDvLY7fZS0HHOkzBxzLzZj/idJsN5vvvMBuk1y4X/RdmMo/bzorbHQM7BSmpQcBNYvdtNe3bXqvHKv1CYPt5v3/ioxfbLCoI773n4Yce4P+8+q85eOggf/O3X+PchYsUByE4KIEc1R7kIpb1UmKzBsAa6DrvrOZam29Oxls899ILnHz3FM88+xy/8YlP8tGPPsG+tX0MB0OceIo4YoYgnrZpWdi3wN271zh851HOHH+Fd985zvWL55msX6VLCq4WpE8EZOv4pkKFtjTIVsJJpiYSS9bEgA+a4/NS6f6WVfSaWQzBK3OzZtBLtmxpzSjq/mqnmFIMyKb6Tr0zvRUuotm7As41hNEKKwePcNd9D3LgjrtolvYQaUgSSFlwObK+tcmLr7zMf/rz/8wPf/Jj1rc2STuGWTG/XPUUquHPOdF4YXFhwMeefJzPf/Yz7FvbR9u0dlp6v2bH+RTQVz+UyMQMm5OON4+/w5Wr16FID4BrGYXThIqxLZP5FskOR7TgW6bzCrXbMH05l6JxREqEthCaRse1sxikaIY8U8hJf1bWZcn1+m2eZ+vA4rR5opSCbxqK8/jc4clQWjpR/yZV5008zuk1xaT6Z8l8n9LcwftA2wwJgyFNOzTBRkGkJXhd6KfSWXeQDbw/z9vvnGJxNOTI2ipHjxzi6NFD7Nu3m8XRyEpzHa1rkKAPNZlOoBRNNuxf24dvWrI4nn/+Wa5cvmLZ0gGy4hkMTAuugHeelNLcE9k29xNzPzH3E9PnPfcTcz9xu37ithg10xf6/1lm/YO7oB6/Fdn27dtl2HwYTJwP+3vF2Ab1r/4P0VrR5V17GK9tsP/QHVy5cJ6crytbIc1AO7ZIRqagzJTWCTLNNfSf1zIXobMB6pyO8lS0pm8SO3w3wWVnLBlDHEGBjFprVx2IzZpaf6jrdDV+TRsIKZFFWTRUIVjBak31XyOBWDKTmEgUAl5rHaV2itId94w/58hSFKTKVe0+q8q9Y1palGWm1AY68+Q5dVppmyrYYrv1AQneNHgEN2y1dKlV5gfeKc3RTUGXWUcq4vR8g8MPBqpN470ZCHOwYggwCjDVYCJbUNADNc6hgrm15MxYMvU/Y7DUky/WyUn/mTOrTJiSKeg556TGNcdIipHa1cvboxSZvT6mJU/WEUq/q9o0alinJVV9KZ617EPKtBuVved9oIhjEjtyF3VIpGT1pBp0LS0usbiwSBMCk6zq/84LOUe6rQ3Wr15mYXGFZtDim0A7WCB1YxVDNgc6nVe3u+0EXG9jDu8IlD6sEstfh+292qhCHTIyY9Pq5K9zZrq5nQHNjn1pTDNTDlfqF5RRt5MtufM5Tr2OUGoHAftuPaCeVeF9SxZu4QL7U7BAspSZK60+dPqH7mrG1iveqwKJvhEOHtrPH//xH3HoyEH+8q/+mldfe53xZELrHH7QMkkJbfCmwYKjkMQySmL3SDRjJrngRJmcFy5c4nuXfsCrr73O088+y6d+81M8/OBD7Nm1h8FgBEXIviHmTIMjhCELew5y99IuDh17mAunT3L67de5cOYE69cukJLSgmOMxKi1+D4IwTKZMSsDcEpVFqJ1CPTaNFPpw8HTNg2DplGQn+ozVJSy3i9dXHiC96bDlkg59Rps3liEeda3otoMWh4A4+xYWtrD/jvu4Y77HmLt4BH8aInkBmRxpFRIJXHl+lWee/ZZ/vwv/4Kf/OynbE7GvY0U7/pSgtrmc3ZYOMA7ofHC/ffezRc//1mOHTtK06q+WSb2C4s6Bmb9v6/nIcIkF86dv8irr77OtWvrpCRGIy9kcThfiDmSs4LduSQiEVfAWxZcB4XeiyqyWmnifac/ICfwvkCwDKb5HSsKYDZmKK7W3Vu5AoIQAIcX1THwTjPeLgSKb3FRn4YvDakkomkbIJ6Co5RMKljrXm1bjJU0ND7QhKBdHyvLVTRQdhaaJLJKZEQrqZ1ENjY2uXDxCqfeOc0rr7/BoUP7OHb0EHffeZRDBw6yvLRMHjgaE9VUHQHreuI0+tq9spv77r4PSuGll5/n/PnzlFI4VIQ9ewJhMKQuoJy/ySr+13Sb+4kbz1F/mfuJuZ+Y+4m5n7j19r5AzQ0mSGZ+qc/AXnm/xc02dPk9P/nzb7e7yHpvzZkP8Pkyg/zXmtd+F4qWLi6tkNc6jtx1LyffepPJZMJ4c11rEZ3ry2d0R0IVKMmlSn3pOHegHYLs75R1MSxdIoRojActD+pSB53Dj52i0F6BjB5i8x6Trq6n2v+okBAoUOKDpxkE2lIoLipdrYsUV9T4ZOWxOAo4TyyFEjt8VqFj5z1N2/TK7KrirgZVKW/0AEBJCbLgXKYlTzMvtT4VUb0aCilHpEu4aDWqwRO8w/uAazxuMFTApnH4YaOTNARlqqjVnz7XHlCpxtrh2wF+0BAGre7T+V5pXAOBbMiwASJuKpbl7JrUURjm0aP8U3Aml9yXG1G7OPXtw63ttWkPZStdU6DGqVBciuRo4somUqxq7GJgnO/BMdWlib3QWYrTfxYqKDIdo5ZZITPPRo+vpVv6km8HCLB1tSN10bIjhUkX6aKOiF0ru1hZXNBabEGfI0IpkfHmdbpL5xgMF1ncvYdRWGY4WqTznjgZ0+UtNfR1XvTz88O3HrcP5N4YNM63G7fZACLn+rs52GIDAdh5P7d1KJSZYLa+1Gc1bRSUHpXU78+MjW0JTCz4nt2ftU1lZ3bX9qR0319km0b1ZfZPCvSE7hv9puDI4pVo7LQT4K5dS3z5tz/PkYMH+PO/+HN++rOfcv7iFUIzRDv0BbXLJA2qZFqGmyjUjJo5EW3RKZ4UE+cvnOdb3/4Gr772Co9/5DE+9sRHeeihx9i1e03P1NiGRTLZBVxYYbB7F0eW9rPv0N2cOfEGx998mXNnTlDGGxS21F5m7QJYSjIKtJZF1gSAWDAXxBGsS0utsQ9+mgXF/IAT8N4SDCi1XcF//W7XqS32ph1WilLJRUQF7Hvb4ch4uuIIi7s4cv+j3HXfI+xeO4Q0QybFWSa10E3GbGxc54c/+Sn/+c//nBdeeJHxZNzvSVCzW+v2i9TKc7GA0MYswh2HDvKFz36Gxx55iMXR0IJEQSPLqV0ttlqov6dcyfCwvrHJy6+8xhtvvMXW+iYiAZFCxmmXjiZbdnECOWqZsmRcAnBaAmGdOApiXW6mo7IKPRY0NMhJGZOqreFxojoG05hHA2XtBCI4TIBSBClBn4dombG38SiWfBHvKTSqP5AzJYtVeU+vN6PNCIrTY1SB/8YF2uDVz3uvC3fzu65Y8J2TLga7iWm4aSdEKYUxhc3zE85fvsTbJ07w+ptvce/dd3PP3Xdz5NAhlkcj2rbVcWRqDFI02TQYDtm7ukbOiUm3xUsvv8jZs+cAj3OBXau2IESp+eUXtiP/eLe5n6j70J9zPzH3E3M/MfcTO7cPpT33zu2D6sj8svb9qyrHqsg6wDZw3dSofWhZWNnDkXvu5/Bbb4CDd4+v945DJ6i1OwOcr8ZCtyqIJZKmSKYxanJKTMpYB3cpBO9pF4aUIMQc2drYVBFd72hGw36foW2QJL0f9C4gwRHjxF7T44cQkOyIpTBqhFAcvsBYqmZIoST1hlkUzQWgWPu0quUyaPGtlmdlZqryhCniXIIu9imk0lf0GggTDNRSY5tEKyaDCyQxdox3lCZAaKBtkbbV7k5OkfGyDZQqEDu6ogbBeU8YLuBDUOaMc7SjBUJr5VdWE0oygKnHKdWjpGylVubjc4nUFtQKv1QHNFWXrxTPyrJRI6G6PTkpJTNFK5Oy59bLeeVCihNS7LRUSECclTtJg3PBMljKOqpzJRdVrk9VRNj23CXVrElJsw3SBziVFipIEygxUmIkJnQ8wra23Dllrq9rFiE0DYPG03hHjhmilnqpElNLjhO69StcOHOCyXiDOF5l9dBBBsMR7aBls0DXTcglfvBJ+Uvd5mDNrbabBd7qVGcC7z7Klm0/QOv9Z1/YacKdM1X/CjhjY7Oy3LbtcMpArC+XMus/6men8HT/Qcty3vict+9v+svONMT7jI8KCPd/zixCKKqKCFSNKyEzGrY88fhjHDq4xte+dpS/+srXOHX2ImmStAMfVu8sSj925lNKTiTJdlnSiyWWnAnem5/KnDl7mm984yzP/OwHPProEzz11G9y//0Psbq6GxkE7YAhDZSGWGDQDBjuGnL38m4OHbub0yfe4sw7r3H+1AnWr14iTyZAJqcOSsQLWs9dQPAarJVKY552q8g50XVjcnKWOQ00QfW2FAR3vVZDpchXw6tBq4HhM8Kbswu0TKCEEXtW93H4noe48/6HWd61hrgBUURB8FJIacLFi+f46U9/zL//sz/nzbffYdJ1Cn4beD0TMdthtq/6RDRzt7a6ym9/4Qt89tOfZmV5GRdUs0wp8Q7JzsZMBfKZ+SfgPOOu4/S7Z3n6mee4fPkyJWv8kEnEolnPIFajnzotpfU2ipO1sy0OsvlfEd2HBQEWwfTSIFJEOf/F8qROS5JzQZNMFCsWdlYi63ogXpC+a4g2g5zGLOREcRlvi+ciHnGNjkMdnJqfFE1+6PEz4kzQPwS8V3F6cWLBd1Fflax8QbTUN6eOHCdWbq5nq21i9Z52uePK9U2uv/YWJ0+d4e13TvHoQw9x951HWFtdZXE0IgRjVIjDKQmfwWDAnj2r3HfPfeSUePa55zh37iyhCTSDhsXlJVsExj4XNt+m29xP3Ozvm2xzPzH3E3M/8WvvJ96/PTc70OuZ12fs3Mzge5+d3eqtOkFuGMzT7b2AmZ31r7fax/ttP3+JVP8bZmFsU7jB+8DC8jJ79u9n/fpVLp59l5I6nQTmUMTanmkjIjX+1Sj1mwnAzhyJXIqVOglbkwmjlBSxLYUIuOzI2eEG07peVxfpogCHE5Tqlqq4kQmXmaCUFwfeQ1NIWWvqYimU7MhFaYnOS98qT5lpTjmqHp1cReEKF4J1CdLJWnpLI/hQ+jrK4qx9oHM4H1RXJrgegKhOTJwoemtMk2JMsFSKKc4XiIWS1eDU1negImNOFF0P7YDQBHxQcau+3Mm5nt6q9Zn2/WqEUUCOMqOr0vtyMaBF6YUVlIFiWYSybT+621mjPv2Z0XrQ+n7qlElTWzwqUbh2qGoUVUbLkUqux7djl2Lz2gySgX5923N60qKefxaK0Sc1G1WFkEvPotG23npuTQisLI1ovApwMQNIUbLWsaZEKmPi5jrjEAjOsbWyzGBhqLTWtlWBZKtv9b0TnQZpsu0e3Wp77zn9XjZnZ2B1Y5A330S4ISNqfhad5DJzG/O2v8VlRGzeFLFMzTQo1i5jFphQ58Y0aPA9i3H7GKgZ1fey5+Kg9iKo41MoykRDg8SblTneGNjfeIxSs7DbXpu+kHNn16TXvV3MspiGWB1latuS3ZcDBw7zz//gX3D06H385d98hadfeJFr6xsgnpQ9QsJlR/Fmb82/OCstncgECgrgFz1eMoB4q4ucnVzlwre+y/MvvMx999/H448/zqOPPMy+tb0sDZcYOqUljycTCAHnR4xWF7lr1wEOH32QC2dO8/brL3H6+BtsXj9P2rqCJA0Q2yZATrROCA6SC+QQkNBoMoGottg3ZvHo3WkRs/Vg56u09poZTY3Hl4JMImUSKUBHJjodQa0M2CgBWdjLnoN3c+Seh1g7cIjR0jJFgpphVFx9HCecu3Seb377m/zNV77CiRNnSDHrsyi1JNf35+ZL0Y6HokkED0rfL7A0bPncJz/Ol774OfYfOIhvAjV8JU/0ejQ9AVUnrThz7joGuy6xvrHJSy+9wtvH3+k1HiideR+B0iHiCM4bDRwkCZKSljeEatenwuxFqt+a2j4ntnAQwedCgwMfwDsyCUqElHBFs58Z0QWdZF1MYOtXl23eWLk0DskFStQMbCrqTzI4CQQPTrJ1rCmAN7F/naNisYoPFiMJ1thAWafkjGQIwYNrcCXgHOQy0dJkQT9TAOcoSe/cxHQ6NsfX2Ji8xbkLl3n33bt57KEHOXpoP7uXFhgOWlsMOXQwFxZGI/atHiDdVdjcHPPyay9x/uJZlpeWGA0GuEFL2Vmj82u8zf3E3E/M/cTcT8z9xAf3E7epUXOzhZBs+/WG5Y0Zm6na+U2/Of3MzOff63xutaja+b1flc7EDadrC3n9vf6mAqrDhUVW9x/k+tWrjBaX2Vi/TCmKZFZAxpmmisKbKgzr7CAiooyGihCr56MUU57uIrgxi12nR3V+RvPFEWY0P1wypFlUz6XUPmmTKeDgvCOlqMJOzoEvFFS4uEvWGjo4Ra9FEI+hkDbBDaRRW6IMEif0dDYFplzPIqGoISm5EGPsQZcEqpgdPBI8vm30HHMm2+cqDa7+S1p0SC4O5xWXL07ICZoQ9NaJqBhbCIRGxYu3ATXe2DUilJ4HpNs2RN4CBFcSViBJ5dFAtqBiKsZVOz+VUtuUTwE0Gy4GopSZf3rMZGVJJWsGos8G1Iku4LxXSmnwKMqRKTFaiZUiyb1wcDXEpbblNsCogjVSrzOriHRvvDUgSVaeNZ50jMcdKReC84zahj27lgjBGUFLjWixa5dSIEZyGZPcBmOnaPTo2i4ttQsN7WDA1nhMLhBTRGp9KTNzbPaZ9Ddvdn7efpB8q89OX+7Rt9ve56/DVsdNNoAVnAJ71Y5U50eNk/P0Fhr9Wn9X4LTMBNilqHPHCK6QbdAatyxvp4uKgY9Q+gzq9m06OBya2akvVQ2vaddWnSvSryFmslnYGN527Omxyi1er8fZ/onCVBzTRrf0o3nbPqo/XVpa4jOf+TSHjtzB17/5Tf7uW9/h1Ltn2IoRF2zhABaAO81GJeti4ZXi7TI4s0PKT4QsSjsvJXH27FnOXzjPSy+9yN1338UTjz/BRx/5CHcdOcZoYQEvMMlJAfoC4loW9+xnaWUPB4/cwYWzJzlz4nWOv/kyl869i5RIAAKFUCIlTlCtS4+0Kp7vc8Y7DbCUql5LTWs7UGiC6Q0UTSAEs9ESBHKGkK1xhCNnb7RxoXND9uw9zNrR+9l79D6W1w7im4GyOrMWMKRS2Bhv8u7Zs/ztN77OV776Vd49dxZymAbes8+zDu1iz6yOlZIJzrNruMBvfPxJfudLv8UdR47Qtm3/XOs4mPaoqSzSuuLQ61b2Y+Hdd9/l6Wee4/r1DQtStezYuwrRo61kRbOaKemevdM55Iwpu32Uln4dWGMQHe/OQP+iZQRtwIknS+6TPK6W/YojOyGbP3c274qNKe386PG+pfhg9jxpMJ4LKaVp4sCJLWqsfJfSZ1+1dBq8+Z4O9YMpJivV1WvAtfjQ4JwnNJkmDYhj04UTFdJUqnrpcyQiniKwsbnJyfEW69euc+nSJR5/5EEeuOcYq7t3M2gH2uhAQJmmjsXhiIP7D5BSZBInvHX8Tc6fO89otMCu1T1IE7ip2uyv4Tb3E/XYcz8x9xNzPzH3E7fvJ34ppU+32nqb+0te6GwzVr9ssKaHHG0U99vMcYtNBN9w6NjdiPdsbW3y6rM/ZWtzg27ckUKmbQJeVAC3SOnpWRlTiDdhXxGYTHJ/napLYxak69gcb1AYMhqMiDESrI10HMce9c/Wis85hwRvdC9M6FW7DikIooh6yVm7JRlDJCVHFO0v700bhyLErCCRE4fPQk6eIAoaVPeVUsI77XOl11VbR6sDzBVMSLlnbHjf6j5cQ46KQEuBMklkSfocmganBY6KPI+v471ntLhIM1gwRF0YDofGOgksrOzGD1p809CEpi9xKiJGRdOAghl65KwJy33ORBkiiLZlVwNrtLpcWyKaXa0gz82GkhMzCGaOcyTF1Cvkd+MxOWodpXPTcQ6aRfAG7FV2TEkRquZN0q5PKZmThV6TJsXYCxMLYuCV6vnEqEYudZFmqKK/NUhJMXLl8jU2tiYmzCbsXllgZXmB1V3LDNsGKSrUVbGnXCDGji5FujTRDFSOUDqunR/omHKOpeVF/MYmKW1y5uwllpdHDActC6Nh31TrfSbn+31g2/17731sD5jmYM1067puJlOq/qYPH8UAxLrtvG0yW/8sveOvf7tSyevFsjoWjJeybR5u3+qzymwfItsD8lJQltiMCZca24t2ptBgpM6z2QvYfmy54TXLpm67dA2ebxhvRW6g8m/b947PO+dwouD8nceO8L/73/4x9959F1/56td47vnnWd8aE4t27VPf4Q1mzpChNbcvogLwJScQDcJNvgBQ35li5tLFy1y48BNee+0NfvTDn/DUk5/gIx95jDuOHGZpcZHWN6oD4ISJgJOG4eoaR3fv4uDRY9zz0Ec4+c5bnDz+JtcunSNvrUM3RvwWzidc45CghHyXdD/OWY26OC3jbJqehVlXRLpMk/6fFF3slaBM0nEsiB8iMmIwWGJ57QCH77qPPQeP0S6vgh/QpaTd6AQmJbO5tcUrr7zK177+df7++9/j8pXLuOIs0zfzyGaMT7FHX2rwSsEXGA0annjsMf75P/tnPPTQwwwGA0Bt7rRzy84xxMyCdGrXNzbWee2NNzl5+l26BNDgndbc9/GdaZJ5H2hbPWeTQu3HTR/Zzxy12NisYv91waP/Cq4BHxzFulRMki5wRFQvQRmvgpiAY9UfKKJOOojH4xHxRBFihqgO3kqAZ30r/QU5qRoj0zmjLVwrOzRuC8CdlUAnJwitJmgk0BRlZuaiMUbtZCD1wQmIFE0alUxMmYvX19l67Q02tzZZ31zn4QfuZ//aGqNBiw86Linq/xcHQw7tP8B4/CBbG2MuXbzA+fPnaUdDFsLSryRh+A9hm/uJuZ+Y+4m5n5j7iQ/uJ24LqPlFgRXZboV024Zj/GKO7FYLrV+Fg7zpMWT2l7Lt98WlFVb37ufQ0Ts58cbrTMYd460xToQkmSgR55ptKHxl0IRG6zVBdVJmOkPrott+jicdiFNUDzH6GISccEEZO1LFYgUFSoqAU1AGwdTRjXmRDcW0ydXQkEvGh6yLcx970dtsdYoiQpFELto+O5PUYHjpRY+zsXKc8zqgrTyKyrgoFcmHHKO2/a6lNIbmNsOBCekK7aDFN0pv1PbbqrEzGAwYDEeEpiGEQDsa4n1AmkAYjfChwQdvKHh9WmIgskKpuWfOaJYBqZmVqbGcAmeqIl7ZI/TMG4DtzJLKiCr6ljGlpr+n2p3JgBopWY1FL6CGGjmndboiopo1KdpbpQdpVCyr9GM2WxetVJlWdg3ORNcohVQ/bwBfQZXVu5zZGndsbU2YdNlKnjSLMRw0DNvWgC9vkU3S2lGEUOj3m1MiTsYGkBXG69eYbKzQDReQ5UXapiEEz5XLV7h48RzD4YCjdxxmNBzhTaysbJtjNzqY29l2ll5utynzQPu9thgjfQhqaNw07t4ZhO7cZGYgg7IQp0/UEWbGue0P+rl4s7rcaU369O/Zc5vuzH4v01e30elTdczFTnNHILztMrYvNHom6Y6hWDXMKshqSo43BPc7O4kUy4CJrRBS1i5/3ub95z79Ke6/+y6++c1v8dVvfIszFy4qw83uRZKMCu5pNw/N7CWkJHIf1zrVJvBG4++pzgq8X7u2zosvvcKbb53g23//93z08Y/wqd/4De644wiru3fTti3FOZpBoANEPH55yN7lvew6eBd3PfgEl959mzMn3uLS2dN0G5eRPMb7hDgDlruEdxC8lag6j/iAC42Vt4JkvR8xJluwocxTrLuhd4gLuKbFyzK7lg6xdvguVo8eY3nPXmiGRBRMT5atHMfI+evXeOaZZ/gvf/MVnn/ueTY3N/E+aGLBq62prIA+gLYtm30UtFx+cTDgyY88xh/+wT/lkYceZGFhtO0Zzmp0TG0PMxiw2fKiGeKzFy7w0iuvsbEV8W6gtlQq2zNRM67iPE07UIo9QNZnvLPEo/cBTI81e019ybVUH6idWjS505JcRruQCHhnDFSvpcRFF865ZlOsKDcVrNWtEetzXVjrIJuyhPVmZAuwQfBO+hukb6v4qKClElpDoPM0SySXDhVtFJzXBVzOieI0tqEzm+Cc2Zvqo4UsEIGrm1u8/s5JJt2YmDMP3Zc4sLaXhYUBjddWwdJlihcWBiMOHzjC1taEF158jmtXr3Hl8mWGiwvMN93mfqLufO4n5n5i7ifmfuL2/cSHwqi5XebKTirYzwOk3G6Z1K9+s2vZAdL0eibo4n8wWmBl9yoHjxxlcXkX69euKVvBe5wkomAIqEEA1iVJB583xoiK6pKVMial9EBCASZdByJ48TTitS4wZnLxBBpl7QDJ2l4HF3oHUoGa/opSJhnCXmv/nBlCnxMpK3VPWRnJEFSb7DYBC/rTecEFR2gC0WhsJKWx9g5s5tk6q0l2ThDTNiFnVJBKX2+axnrQC4PhUCeXq+yjRgVth0MGoxGhaWkGA9rhAFfrXY1tpEwUu+46LmdAgGlIUB1/bwqmT9fALUVyKxCTTdelGg5ry90bkxkQp8wYYfsjl2IIr+4TMaDX6pXrOaiIsCLd2nJPv686Q8rqiZ0CePWUa+enbF2wKmurZqtyzqQ4U/Ilei45JyZRW9htbo6JURFo56BtPIO2YdC2Wq5m5yhWq+tEjbErCUikHGfKrTKTjetMNtbpFpYoWVlmbRPYXN/kzLnTNK1nOBxw8MA+oxjOKMv324dlF25ln/5bsjv/9Tfva+YN+zkbiMLs/arQpmYlykyJn32+1/uu7UqdZvQkzQTnZRp4e7/jMSmV/QbRxbLT38zQxg0UnnUnGgzUOYu9PxM09zO6P3OmdGCLtHcMk9mEhdBfqH23/mH73jGoZwMnLZG16y4QvNab33n0KP/iD/85Dz7yCF/7xrf44Q9/zPr6Ol3MdAWyN1E/C/wqdbqkeu1ZWYsWaBacZb0tUHRCFsfmeMIbx49z+uxZfvqzp3ns0Ud44qOPc9/993Hw4D7wA5I4mkbrtZ0PSBixNFxi995VDt15D1cvnOX86eNcufCutmyNG0hO0CTyeJNJN2HYONrQ4puBBW+l7xyoovvK7NOSCYeEBrxQXEMq4Ntl1vbfw9qh+1laO4QsLFCcJxahiNLBcymMx2Pefvc03/jed/n61/6OU6dOU1JBJCh703QJatnBTlp7/2yyMkVHg8BHHnmYf/FHf8RHH3uMpaUFC46l//6252tDpRY11KEtltHb2Iy8+c4pTp25gPNDxAeEQC2f7bs5ijENnGPQtCCO2E3M1uqir+yYBzd09CgWd4hql8WS2NjapMXTDjxkDcJTaMjGMtDSac2UOudNckAAFdTPqFZEzrnX5FMXJuSZ41XhT00QRFvsJEtNWYKEbHOxUGPy+v36HFJKECcMQ0MIA01S+YbSZGICJPeJCKBfXGliKtejgfNsTiLHT51jMnmWzY0tHrz/Po4c2s/K0ohR02pyq0DTelaWlzh88DCbG+u88sarXLt6jaVd6yytLDPf5n6invHcT8z9xNxPzP3EB/ETv9LSpw9r+28HoJk9j+ng6DF0uQkXKQsLC8scvesBjt17PzF2XLlwntxFIqgh6SLBg3eFglNGS1HGig8e7z1t29B1HZDIyWr5StYSJ5eQScdmhugCrfMUHygEBTGCtbyrYInoSNaJaYt10IW1L/iUeoRfDHkMIZBSVIAmZEpprZ30FOTQEhql2A0GQ2O1tLi2YdJ1xhKpBslkeUQNTzAmRtM02v7MRH0VpBKC01bcg9GIQdPig8fuFoICCgsry4TBAN80uNAQ2oZ2OKQZDhXV9b5/ilIyPTtmFpGdfcrV0G57nrlerAqfm7OKsYOSjRk0k/vZNiDqfTeKbrZjG9hTmSzOTY2zbzylKEhHUW16hyreI1rvKaIUREGsBlyUwZISEhQ4mYzHjLfG09ptu7+qMS/EmJiMJ4zHHU3TENpAphAnHSlPuHZ9iyuXrrG5OUZ8YDBoGbSBPSsLLC0uMhyNEN9M76dUto6+5LxHSkeejJlMtDwvjpXxtLW4SDscMBmvMhqN2L1rF/vX1vjBD77HuXNneeXlV/jib32eI4cPs29tDclmuFV62p7RL8tG/Ldie/7b2WZLTTUWmoYTN5pq6V+vwcBUcHEWqazzJds7qjtQg29tbunodZ92HGJHTsCA1e0fqsF8Zc9B75P1E66+uDOStp3tCOjr94tlP29vqNQP1cLQen9uBRLad/J057MB3fLuXTz18Y9x19138ZGHH+Lvvv5NXn/jTa5tbdLlQszJgF50H8VA8uLJNVBDEEkW7OvbCuaC0pa1A8jW1pjj75zkzLtn+OlPn+aBB+7nE089wUMPPciRI0dYGC7gnWeSi4kqNkhYoG0H7Nu1l9XDx1i/fIGL505y5vRxrl25hHSJ6K7i4yaOSMmqYyGifRQcU1FIYRoMlwIlDIniKK5lac8+1g7fzerBu2gX9xLFE53h10510MaTMRubm7zw/Av87be+wU+eeYYLFy/146FmzVUDofRufWcALaJiis4FRoOWRx66n3/5R3/IRz/6GIsLC2Zz3+Np1kWYLezqi+IcJcPV65u88eYJNjYj4geIBPNZCajlCtb9wrLL7WCgFPRctLujHmEmH2KZWnE7xmnpuzD2drsIKWUmk65fODvLRmPJm3qsqiPgkqhoJGjsUqY6dDW9UIewq1nWmkEGpBS6bozRFawLjS0aKT0dPfe/T6eGBhMJctLg2AUIA/OZWgbc25yiiwXNOAu1c0mm6FjJsJUjp89eZDJ5kevXN9jcup877zjM6q4VWu+U7h/BB8/KrhXuuOMOrq5f5cyFc1y+eJHhTLfNX+dt7ifoz3fuJ+Z+Yu4n5n7idv3ELwTU7EQLdw7KD/L9ut2KZXO7n/15z+nnLZOqjqQ3nO/7jYw4oWkHHDp6jGtXLnH6+FvEzU0DOrLWzpkNz64ogwQh5owUZ1Q/p0wUO3fRzseqNSKiYl8lq9q1FCKZxtgypRTrTa/IYIrT7kMqcKtOyRny6rwnNFZ6Y8cNjeuNXyjF8IViyGX9T9uCO680u9DUEiOhDYGUMl1KBmaosQ8hqPCXqLVsmkDbDnBtYxkIO6+iAmGND7TDoS7044RgHaxy7mjaRsWBBy2+bbUTUhN6wEfZJdWpo6U0NjGzFm72vlbcFHyzK9WuTSlZcFDoO1sVK+vqwRTzYqqkfLNRpBo4ubJvpuPWOU82cTfJaZpRMaaMqv3mGcjYhPYM3CsVJHKCVDCnTIWDszFv+nInE3euoJ3z3oSflaoYTdMmpkK0fQRfGA0HLIwGLAyHtG1r1Efp2633U8QAG1/qZSc2N9YVfOwahgsLdJsbdFubdJOOwWBA27bceedRDuw7wKWLl3jhuRcZjYbcd/89PPnkk+xa3qVOsdfZ09H382wi1QnutAcG0s3M9fmm2yxVVqdoDSQzN7tX22i1WUW2Y4yk1JFSVOBS6medUWmVrqwd30IvsF5uCFSn52HeGKj2dOe5VEfsrPTOlM9tK8y07SyunxNqGHbur9jY0LFTnfnNt5v4mtmOcZQ+eNl5z+p9E6xEVYSYDND1xnQUYd/qbv7J736JRx98kO987/t887t/zxvHj2tNuIuqf5YgZ9HuBwVK0eybaHqT2iFOHKphZgF4SWJT2SvYnwoXL17ihz/4Ia+9/CJ3332Mj37ko3z08cc5euwoS4tL2oLTO5LzOLTLQggL7F5aZWntEGtH7uXqpQtcOXeW6+dPE6+dg8k6AW23mRFy7vBAcF6v1dXASYHZ6D2DxVV2rx1l7+F7GO7aj19YJokjYkkJCjlFNre2OHv2HN/74Y/49re+zRtvv8XWeIxL1iVDnN1jZQKKaOvbnc+i1up7r9nJxx55iP/uX/wRTzz+GCtLC9qJoj4vbhVn6GJQh6yFhqJ2O6bMuQuXeOfkWWJyFLyNMz0fJ4VskWxBfWhMiZhUK805T4ppZmFb6fR5Ksx4Q1zUTz7NnHvNFKcugVN/V4wpm20BW6yjoQBinUaqrL7S1/N0fljwn8y/eOdp6jO1+xNLJjvtKOmKxT0GxFtnVguW6fXK+msRK5XuOnCZQAOuofhIilvElN/DP+j490W7fsQi5OKYdHDp0nVefOkNNjY2uX79Og/cezf71/Yw8i34AjnTDDy7di1z+PAh1rc2GW+NuX79+i2O9eu1zf2EfnruJ+Z+Yu4n5n7ig/iJXxqjZmeN24e1fRhg0M+73WpfU2P/HseaWeCLDby1Awe5cPZdlnfv5pqBJbmoMLAOLMG5rMK7otojKlymx9L6VQVMnHMKEORsP80VCGQpKq5rp9fX+NkCOln75n5yGFBDVvYNiC3Uy3ShXfVc7HlMfY0CNFXrxDsDetoBrooXOwNyCiTVWu9BmKZplC0jDilFNWXaBjdo+1vpnUOsxCoEr9ozTYNQaNqg+EvU93zwhLYhDFqtYfWeqhLfb71xcr3Lrk909rnXWky9sVaOlGvAUIGRYq8r6KKuwVlJkd8+JoqBMvVIuSqOu/6+OucprqimUBF1hvb8S++0Xf9cRKoQWDYjOwNW9sAehobXf/QBgCC1akoNsKvtyR3KzElMukw0gWNEg6LhoGVhOGAwGBBCY4ESOsbM4Nb7J05L4MQyDltbW3gn5NjQbW3QjTdJ4y1tP54zTdOw/8A+Dhw4wDvvnOTM6TO88PwLdLHjwKGDjEYjBu1gGzD74etWzQZ2/eOZb9CLuglF+Z0C9KPa7EMpU1DUPp1TInZjJlsbbGysMx5vEWOn5cxeO68pUNvStoEmBEppKSVa3bU31tbsw9D5oPOgUDOtss0+S39uUjuFlCqWZ/sSC4r6mNgYhzPGYfsIm4697WNDoMye4TTInr4hM//6w818Y6dvEWpJ7axG1rQhSMJb57ejdx7jXx4+zEOPPsLXvvktfvTTH3Pl8gW6rDXTGmuLtqusV5/1vsR6zaKguHbo02N7rzXbiNNuD0CKmauXr/D8sy/y5utv8fff+x6PP/FRHn3sUY4du5O1fWs0bault0W5gI043HCFlcECK6v7OXj4LjaunOPq2ZNcOXeSyfVL5MkmLkeIWRl/2hcUcZ4kjiwB1w7Ys/cwqwePsbrvTtxwDzkMiTjVFxANElNKXLh0iRdeeolvfvPbPPfcC1y7el3LhYt6gAosi0V3IlMrXdCArG6aNCgstAMee+QR/sUf/SFPPP4RRqNW9bnElOFNL2EGT58OAStzrkG6iIb6OWfGky3ePH6cs+fPM+kS0WxuIeEkovkMb98WJAkpT5iIwzUBXXBo4sBGZ19Gm3NBfKNzxQa6D8asrMmgmpUWoGSli4smkATVGCi59JlQXVRrMJpMNC+XREo1aaGZzZIzxTkIDeI9XlT0si5kxXtK8ESyCuL3rZln55CR3WXGrtf3YyZLpHjtFhi8kIvHx0CK03JZEWYWCNNyZUeB4qZCkkDKjsvXNth89Q2ub1yj5ETw97O6e0W11BptArG4uMD+/Qe4cv0ap959l6uXrjDfmPuJevVzPzH3E3M/MfcTH8BPfKhAze1q1fw8+/1lb7+sc7/hOOgDzimy//AxJpMJGxvXeeOF57h25TLr164xGUeSc6ohQ4RGNVS6mOw8lZWiSueqaTNotTYzFavvoy62dYJnSUxSp3V4seDaoCwKhDSZWAmMUg9NkobUZXzBdEX07AEdoNa6zDda3qJK664HC1Rx3inwEgJhMDDRYKFkmIwnSuFrUL0Ym1zNoDXkVLVszKzo+RRFW1cWF6a0RhEar8yd4coKrvWG7Cdt39c0hMGAMBqZUzZXJ8ZQFAfWJjt1E0XFDWHuWTTMCHkptEW1ntryWsV6iwFeJaVpG8Ue1GoAA2DUYkzvqGg9ZjbRXxGvQIpzhKYB9Jx8CJTc9cAH4hFUB0aMuSROyDH13bK0w1NW4eAummHXgeG8N8edKckCFdMfKiJqIB0U50jAeNxxfX2T9c0ttra2ABgOh+xaWmRlcYHRqKUZtIRGATlqpwDzOrPla+I9bTPBBc/G5iYlJYIThsPAaHkXk8Vl4mRMThE3aFjZtcgjjzzK5saEn/z4x7z04mucOXOW6xvX+JM/+RMO7j/I0miRlLoPbabOt9vcXB9LmB+3sLCnBAvidBxKicRuKo4d05hrm5e5fPki58+f01afly6zNemIBRaHDat7dnPw0EEO7T/A4SNHWBiNaDTmYDKJFEpfV+3EGw3aOufVjGPvSKddFIJIjzCrvVTdpJ2CetXJ14Bse8B/41aBdDO+9Ysz/3SfqlfVn9yO/TreewyWPuBRUH26tEnOES2Dhws0g8Bjj32EY3feySc+9jG+/e1v8cILL3Dh0iVcQLsxZGM3IhTnKS5RitpdJ4JLDhJE1M6Ya1GNL0tVOQc5O2JyXN/ouPLa25x8912+9d3vcs999/Dkk0/w8AMPcmD/QRZHi2DAfQGyCL5pCb5laXGFwdoRVjYus3HhFFfefZOtK2dJm5u4pF1HnEDCU8ICYXEPu/cdZu+he1navRcZDIgSiEWDRYcnx0w3GXP89Cn+7rvf5Tvf/yGnTp4mbnVIUjp6nxmertM0+JaIM/H9JJ6MBbxOO5AsDBue+shH+KM//EMee/RRRqOBZp8tiNu2eKs/zDkrhVu7qDhx1izAkXIhlsiV9Wu88dbrbE026KImP3KWnimbSyGJ4LPQZM3yZYSx2U0v6ltjtM5/fRGtXqBDcGL22qkfwdU56yglEGPClQ7nMuKKCY8KThpC8XSTSE6RVJLeQwu2lc2pfj3FiBSM8apzMGQrq44RR8E7jK0AvjRIGCI5E7PqjtR2zEW01DVbC9Xp3DGfmkFKoEQhdZHg1UYgSVmtLoBkxMqES/1P+qUXqbg+maGf86Skx9sYT3j7nZOMBg37VnezsjCiMRaHOKE0gaXFRQ7uO8DGtXUuX778Xubi12eb+4lt29xPzP3E3E/M/cTt+IkPBNTcDpixE1T5oOVG7wfK3Oz9Dwtk+WUCQrN71hIhBUX27T/Ek5/4NEeP3cO7J9/hxNtv8NozP1VR3uDoog7I7PKMerx938AR59HuSJIp2RnFSxfpMSZjljhDiw0pjR3ip7omFaGszAdBeq2aCuAUsQ4+pQo1ad0hMBWLxRyOqM5MY4K+vm1xooarpELTCj40tIOCGOujpKJ97Y2+2gxULFapZYVBCISmYdgOeq0e5xyubXFBFbtDcKaXW5TNEwK+GeJ9Sy1rqeh/Vg/GtPxJUVzJ9Po1PTZl7bWyiRpr3ab0TKAis86VvsVdfbmUrMrq9Z46oaR6AJ304qphb6aGoRREMs5VV23lWQXCYIh5CVUpN5S65K5n9ZSsLbdj17F+/Treq3gYWTV1evZMssAD1EA5y/BkBQC7lNgcd3RdJqeCwzEYNgyahpWlBYaDhrZpGAwGmkURQ+dzqleHRmqiTtFK6Gr5XkqRFLMKa22sM5lsEjtr3W3b4SOHOH/hAntW17h6/RpXr1znpz96mmNHj/HYo4/xxONP4LKxhm41D29rjr//Z34F2PE/nE3SzA2vbDkb16VQSgS0BXvXbZFLZjhc4OqVDV585Xl++OPvU1Jka2uLn/70adY3NhknQDzOZYIXFhcX2b1rFwf27+exRx/j/vvu4/7772dxaRcimF6Xfke7G1gmscyy2LYHujtdRs/6usl2O/5FdtgAfbGGqjPHLkLt/KBTWYzReMNR3/+Y1Ouo9kGD8TxzHbUl6srSEr/xiad46P57efrpZ/n+D3/Asy+8wPWNTfUnXstCYypWz+4tKBTET68t26LKyRT0nvpgpwFTAXHC+mbHlfVzvHvuIs+98DKHD+zn4Yce5uEHH+a+e+5ldc8eFoeN6rG5gJcAzuOHQ5YGy6ws7WXf2mE2r5zn6qWzbFy7wub6FbrxFq4ZsLxnP7v3HWHPgSMMltbI4ulEofRIgZKIsePi+Qs89/yzfP1b3+K5l19hfTzWBZtrKBbUV/FJZPaemoi9JQxcUZvuBFzJ7F5e5Dd/4xP8wT/5XR566EEGgxbvHdRy2Fs8xen9kmrC+0A950RBiDFz9twF3nnnNJNxIkdPER3bhUhxiSxZ6foqzYGzRW9JCZ9RYUfnKeKIRQNJ58Uy6d58ja8PkSoiVsT8Yok6f0vUVqe5UMQhon4klUxMkUnsiEXLmMXo4DVpIwji6Rm2tRRYqemFVBJdijgaXA0ffF0MWCmAlfLWzGUl1NdFTL2n/cyxxUmXEi5FXGNMWu/79rj9BNIvI6WWPs+yHnQMqPRGZYVmNje32NqaqP8U7boixQQwvTAajdizezd7V1dZn5c+6Tb3E3rouZ9g7ifmfmLuJ27fT3wgoOa9DNT7fa9uN1PBvtVnd27vdewPs9Rh9oHeTgnXzrrQW70/+1aRgscxWlxiNBqxa88ao6VlXPCceuNVJuNNSk6k5HEmUhzCFGWvaQnFRMSMh/Z3p4IxSdtnVzS6WvwK1hSX6VXlDVSogls77+bse7WkB1FqY6GyaDxenA5wVOC2Uit9pc4xrVvNdq6VFpdSwlVKndPvV9aPK4V2OFQ9GnG9GLBvTHfGB6QNeHMMWUrf0cmFBueCPYc8FdCt9/LGETDzU61xMSS2WMlT/xlTUhfLiEwpppVd1N9eKBmx+6ZjQB1xzaaIMYScD70BKbGjZmfUMPl+jPnGyn2kkKVQYqKk2GvM1BrTYqroKXZQtAQrMwPS1KupvytGo4GBQLJxNOmi6iSJYzAYsDgcaMnToFXmlPcE76fzoWcNzQBZMyCgs7EhqLJ+ipHNzU2lNncTKyuz60DYtWeFtX1r7NmzyqnT73D12gYb727w4gsvs7iwxL333svScAE1oDcLaObbL2eLOt7NCc3W9QoZ8oQYO0Qyw0HD1tYWzz79U776tb/jZ8/9hGvXr/DH//Jf8rnPfo5rV6/z0589p6CuKIsMKXQxc+HSFS5fuc7bb59gNBxy55138sSTj/HEkx/j8OHDeBeYbKV+fot4pEztWx3Vmj2tgfF2S/dB/MV7JiG2ZaSS2dlqG9QOgWKmyhicsSk3Oa/33GYmr4YmKqE5PU/1ATEXfHDs27uX3/rC53jkkQf52dPP8u3vfpdXX3+D69eva6mhC6RcEFFKdLXbxaE2zAJvZ8A3NdDq9bAsaMKo99KSknDx0jrXr73Bm2+9w/f+/kfcdeedPPjAA3zksYe4445DrCwtKzsyNL0AIdLiw4iVpf0s7r+TzfWrXLl0nvVrV2gHA1b3HWJx917CcJHsWrqsWddYtFvh5uYmr772Kt/7zvf58Y9+ypnz54kCysxWqnY2fQPtEKGJgZxKb0OmVkzvq5RM4xz79u7hs5/+JP/kd3+HO+86xmDQmARZBaerI5Ub3My2OGjmQVZPg3OMJ4l3Tpzm2uUNVOFSSDla50cVQayBaC4Qs+DxUIREIXUZF6yLZDMg+EYBcq0WsXOoQv6mDZD0LHL18Vbeq1mFTHGCDwNaywwWl7TtatFVTy4FLzo2vFHjKTralf2r11ml+7Mo5b2kDpcbghiDV2sXQBwZ0yTIGtzXmya2r1Ly9rkoWg6QciLFrKTkMNRxWgP7rqNPvMwsyDWzW8Utq8/XkvJpyXSi8YG9e/eyuncN3wx09mZsEZvxvrCwsMDevXvnGjX9NvcTO7e5n5j7ibmfmPuJ9/MT/yC7Pv2qtp8XmHrf/drPXJQm53zD0u41jg0X2LPvANeuXOb46y9z7tQ7eExPJFulXW0FaHtySK+GLTbSs4E0sUTEG4iTDI33FUCoAESeUtjMFJRsOLkBFPXziiLXRbfWB4emasdobapSHCslVMuXXDBHipVDDQc6QVIkTSYMmgGA6p4YIOGddYxyHu8CoW1phyOawVDBHVvsN4Mhvm1VKNeLtu6zSeWagerjhAYXrA4zR6SqStUnIa4v+akOZYqq5f7ndvQUwx0EnO+zHgLEnDFomJpO6F1qRcVnturQKsNJfEtMEy1Xih3ZRITFayahghc+NGpsRIWGU5wQJ5PtyLEB/Q7PaLhIzNmYVrl3nAoSqTMtCClnbXOo4ROTnBlPJqxvbuGcpxkM2bd3N6M20HqlwzZN6IG5noclYvddprfTACnXOgbDluFoEfEDUh4z7sZcu7rOxvUNtjY2LXOAURlhaWmBffv2cs+99/Hqay8gFJrQ8P2//yEb19dZXlrgt3/7yzQhMBlPbnM2zrdfdCuWIYGpBhJkm2c6LkuOhEHg1OmTfOUrX+HvvvEtLl66QpJIM3AsLi1y99138a/+1b/iytV1XnvjOKFpNDAVzWg1oVHH7lu2tjqee+55Xn7lGb7xja/xm7/5GX7ri19i794DuEkipUKMExwNSjcziLhOQm4uFPd+oPtt35NtAbW+sv1ws8G2BRNl9j3H7W87M0XbA3jF9IuyDfurzhw5fIh9+/bxkcce5Yc/+jE/+tGPeOvt41xd39SuGUUFCWsmLVnCwIvSf52bnqOzYDuVqH+Jlrh6F4i5oITCwiQnUuo4feYcZ86d5/kXXuTb3/k29z9wD489+gj33Xsv+/YdZDRaUnZlKTS+JYQBDBYYLq7S7DnE7m6Md552OER8Q1dExSBF6eHjSeT0mXf50U9+wne+8x3eevNt8lhtSc4FL0HLW33NkFnHCawrRtbyUREVZneojXcUgoMjB/fxpd/+Al/6rc9z6OABwrBBadfWBrWoNcXsV7Vh/TOZTV71i0NAiopiFljf2uLt46eYTDLFhCCnfqTus4Aow1EDRI/zrS4kfNAuGw582+oVFMglamxQy3YLM8D+NOAsuSA5arhcMpligpGBNoAbOIqHxqNNYSaFlAq+CMEJoR9tpW+QMHuddbmYSqbECb5rrDTW/K+I0tetFFgzlUUdWj+PdZ+zbAF7RfedC13ySFIWQCrapUP6hM3Md/qEDGbP6uvTgFzvVcfSwoj9+/ezvLxM8MHuj8Y9XhzFOUIILC8vs7q6esuZ++u0zf3ETe7J3E/M/cTcT8z9xPv4ifcEarbrcvxqtp3ASCnbb9AHBU5+HlHjSjd7L/bPrfZ3WwwcZu+ptfdK4H1gaWUPjz71KVzQmr9Lp09Sguqw5KJddJhpz1ZEBV+3LYQrOllqZx/910U1DrVt3Ham08z5G9hDLvgKzNT3bZDhakcg6z5V54UxYYLXBTrGjtGGR3rsdhC09jh7ihdCaAAh1BZrBsJ4Udpd8J7QtsqwqYJVVmdZcqJkU6fPoh2KfDBEVU2mGisTqapCyWKicD1rqsrDzQA41YDeCHNTy590Rk4ZLIgjtMOpIRGsVncWHBL7WlaVfPuJnUcmmUiXR0JrzJdabqXPHCfaJlEEipDHHTkmYzvpUfoQwJkolg/0KvDV6FKULgioAFphPIkK5qRMLEKXMpOoNNnGOdrgGTSBtgk0wdOIELw3ZNz1HaRq+Vhv4OvoF8EjBK9jAefIFGKMrHepZ9Xo860GU5/VcDjgyNGjtCYeXMOJkydP8ZWvfJX7H3iQA/v3szBcMJrz9me3PUjZAbxtm6Gz26/O/v1D3HQcA+J7ABgSOU9UMyhFBqOW559/lv/fv/+3PP30s6QCTTvqAzzftDjn+chHPsKf/PEf8z/+v/8NZ85dIJEJIaiGkglQxklH13Vsba3jxonr19/gneOnee7ZF/ln/+wPePLjH6fxhdA4uq2OquVEtV19EACzHTc+qG95f58ya6eLxRzFXtrhJ3Yeu9xq3L73sbddn+1GddFk2gGFrKWwwHDQcuzYHRw8eIBPPPUxnn/+eb77gx/yxutvcu3qOjkrPTyj4LnUDhql4LxpaWEUYLuuXkjeO8QCV2X9GSBcimX9YHNzwjsnTnHq9CmefuZnHDlyiHvvuZdHH/sod911N3t27wE/IAl4sU4gfkAzUMH9JCaoCHTWUeLq1Wu88PwLfP3v/o4XXn6Z8xcvIHgaaUA8vhQLllBB/jYQU2f4vqmieY9mhYuJJnrrJFJ47JEH+L3f+W2e+viTrO7ZhW8CuZZR1OFflzl5+/PeGR/sZB9qjFzoUubSleucOHWGmEGCV99lnQnFeavhLwRrJqCLika1zPCkAoVkCwuP4Eg50cUJJXe4Wslc7evMoHG5lt0W7TwoQqoZSfO7UlRUUoXhBSmZhArfB2SqF8v20uDp2M398WI3ofOetgn62fqMQkC6xgJ2fdJi3s0qsC2LuX3RKTL9pzFCbd/qrL3r1KfOxkM3m47TkmkN2h2RXUsL2smjbfBetMvrzBdrycBgMJgDNbbN/cSttrmfmPuJuZ+Y+4mfE6iZOYXb+9itvv0BDdvNvvuLatDcSsfmVuVXP49Wzvu9X1FDNVl2LEwlvChlKjQN+w4c5uKRY1y7cplrl85DjqSScUVItqjWdmu5Hzy6r5lrEL2OlBLOCSk5UlZ9keyzLc7zVGdleuI9MJFLwZUMWXTRbGikcxWVVe5ERYaFgjh6hk8pqPCUoChOEcQUuJ1ROYvXzkwikLNM9+u07Z33zkqnfM/6UBbI9FkVAzmKOLSxkkCteRS7pkKPfmopztQ4VHAIphNwej8roGWgRqlPjW1gTQVpFIzS1tQV/FCgJhtYtP07YgBSPWBt9ejsBEWkbz2tWDW9ZdESZkO2azvweu4GjlSwpgd4zNSKE9WzSTpGkgFSuWgddxcTXZeYJIxdo0alaQLDNtAGBdC8d8Z6clMmlausrXqfmAkoqiPS7l0heFzw9oy0/Gk8GTMZb/X3aDpvtV372tpeBsOhjTE9xvXr67z91nHeeustmhBYOLxww5z/IGbo5/3er+MmWVAxPEEzPeogx5MNSupoByO+/4Mf8D/9z/8Tb779Nk07oBShuEBORfW4JJCyjrEvfOFzXL12lX/zP/9/uXL1GpKg20rkbkLjPR3CruVlBsFx4fIFQtMSHTz33IucPHmaL3/5Nf7pH/wTdi0vI5IZb0YoBe9bqj5Vf+6/tIdbKewGzvbBd31te8Bw6xat9vY237X9uzv9mmxrRTsLRlrwLPUeiAUV2i3v2F3HOHBwPx/56KO89OIr/ORHP+PFF1/lyvo6HZlEoovR5nroLylZEKfmXn1C1SVwlskTqWWhfgoil0Ix2YpxjFy6eJVrV9d55ZU3+MEPfsTdd93FIw8/zKOPPsqRw4dZWljSrK1TIUW1bcoALAKbky3eOf4OP/7Bj/nRD3/MyVOn2eo6oDGWY7bLFpxkazqRTYBfF3gV4HcFJIgtLDU7vGdlhY8/8Rj/9J/8Dg/cfw8LiwuajZPq22efjdu2iNqZgb8xI+9ANHNXBGLKnDr9LhcvXaHLSX1iUIo3CL5pjEUrM40FKgW8WLlqIudO24i6VtmuzlMQupLIKaLLDW/PS6xri+hitwB4cKggo40l9awFcsKLlbw6IVDoSiZPOiRnFby063RFNEtJLWUt9BG06PBPXUecTJCgPr6I68X9S3F9ybErUb8zE/tMg3DdvOjYz/Z+7Lw2RsDhxRFle1ZYn8M2Vzzje+o/HUNB4MDe3aztXqYNEMgUo98jmuzIFtg3TcPi4iLzbe4nbr7N/cTcT8z9xNxPvLef+GBiwjcZSL+q7cMwlLe7j1+aUZbpj/7OFdf/LqZFsrSyi3sffJRdu3Zz5eI5Lp87zdb1q9aOWwezl7qfWnu4vW6x5EzKmTjRciKM6eKdw0UhxUi2BXVd8NoJ6SJe0IW8icGW7IhdwovWhgZvBS5FJ5ITbbnMDENFHFrrJ9pa3NmATrh+Me+tY5MTMUasdV0KWgY0LesCyOTUQaUjylRASsh9K/EK1PRgzfTS+ocg0xfoVfUrMACWEbCv5dRPRgWd9JpLVLV4c234pmriWDmY7QtxhspqWVaO1tI7maiWgUk5aZcDTaboM0m59CCIL45U9LPa4hzTMVLB4PrslREVVRE+ax1pUYIUqf6Nzt+YIltbY7por4kwGU/oush4POHq+hgxoea13Sssj1STZtRqWZoyaCrQNX1eaoimIFQVUa6QlxOhCY5h62mGA3wIhuQXNtbXuXb1Ci4r+FQ1d3IuNE3DHXccYtfKHs4NzrM1XkeArotcvnyFb3z975iMx+zfvx8vHnC3sFM1CHr/7WZfn4M3060UB8X1QUhOmUlcJ3abeO/4/g9/yL/5n/8Nx0+8rfTmVHBNwzhlUiy04vC+0bLIQQOl8PkvfJZXX3uFr33167TBsbK8zP79Bzh29ChHj9zB/fffz9Zkwv/r//0/8c6Jk2xuKntqa+s0f/of/1cuXDzNH/7hP+PYsTshw8b6ptqRHaA0N3Vh9TO/gH+zzgNYADrdX/19qkVw8/G5fYCVbRndW322GizASgFkdv+WWStSd6KBXwiBnHSOhdZzx5EDHDl4kCc/8gQvv/I6z7/0Es++9Dynzp5mc0s7xDmn5yTO9cfLpTBjgS1IU7tfwXURC6akBuwqeOiddmHpJo4mOM6eOs/lc5d498QpSkys7d7N7oUFPIWSvYpAZs2b5Zy5dPkST7/wM779ne/w6guvsLkxJicQVDdNfKakztaIUw+s/S1KD5DXDjQpJ6RkvBca33Dk4CG+8NnP8ttf+AxHjhygaRzFCYgnlmJ5yNnnbgmP0j+Qmee3E0CeLsrqY97c2uKdE6cYd0mjSVHmabDFq/gGwVHytEQ5Z0iStKQ4KUXfkfGS8VIMXA+0DYwnyUicHvB6xsUWUIU+mYB4iq8BuCYbrFekPlsa62roCIBLkW4SNXbob6dou95Sel00XbxZEE6hiBCZ0PkGV8CFhmyKnbUMgWx1vLUOfCYCqszQunnTyShF27+WMoZWy8ynlkqzn7V8ZDbgnu5pJgC3kum28RzYt5fdy0s0TpVDgm8QH8gFJnG6L+eEtm2Zb3M/cfObMvcTcz8x9xNzP/HefuK2gJptwMJ8+7k3W7LO/LX994qghtCysLTM0p69LKzu4/KVy3TlGi1a/oTUWs/SP5gKP4iUOqZtwBdtmyaRLkQTHobQeVLcIufM4tKioahCSslUvr0OuKwgj3hHQPDiCU1D02otH07Q5kUKHngfegMjzsqfUEZO7qLWPdLRBCtlGrYK8hhwg1SgRpW3nTMFcDOMFNVbmbbP1uuhApUY+GGslgo6OfvADMdkugIvdp2V9rbNMRcT46p/OXrUAwOi7PqcobradspKmUwN33BWKgOoxA6iCWzZ/cp5RgcHUXtjYmeafRB8z9RRkEYNU8E8IiVnYkrKnrL6Uf2nwFC95lwgRtWqSSmbsXTgAkW01d2ky5QU8RRaJywPGpYWhiwMh4Sm6bs2NY3Xe44BMtYJjERfVlXrvvWWeIoTmuBZHLYMQsB7VfEXH0gpMRmPmYw3yUmzXMosgqYJ7FpZZO/aPs6dPcf4zHoPBlLgtdfeZNeu3ezbt8bjj38ML0KKlZQ7334ZWyqat1J9KUdOY7Y21mlb4bXX3uDf/+mfcvzEO4h4nZ8AJh4OGiQM2gZ1iIVTx0+QS+b3fud3GfrA3tVVjt11N0eOHWPPnlUWhguMhgucfvc0TdOysbFFMxwiTojdhOG4cPrtN/jTf/u/8Lu///s8+ODjLC40xMkYCLgQLKC1CPWGLFf9O227zu1Jihvvw7ZAWuQmfrMPS28amG3f9zSbdkOAXqQ2Xdi27xrnl1m3Yuey7ZBl1r5lckk2v1TYj6KC8AcO7WPP3lU++sSjfPbUp/jJ0z/l2Wee5cQ7p7i2vkERrQ3PFJ3zFiSVkvHOkXI0MF7zccWCJ8nFMnaeVJIKBYoKG4YCKSa8FA7sW+Nzn/kMn/zkp9izdx/OO3JOZDJJhEmOdF3m7beO8/ff/S5//5MfcO7CBXJUUNdZQKQGSEuEhRlBfNPMcGSSCZxq+9qkZrnA4sKA+++7ly9/8Yt88qmPs3fvHrV3YsGkOHzOuN5uzy6yerOMdm+RfmjJtsy4gtrFWJIpw9Vr1zl79hxOAoNGKeFN2xKali4qAF5SUntvTE3NTyilXIPuqe/zTmg8DIeBEQusb3R02SHZQfE9s9OL+aqimWTxRf2Cyk8iCDka8N9BmiS8eMQpab4RT0ID7iSahaYoOzflaXayAD5Z/OJMUyAnum6CC56WBjG/JVUtLWm2tlLSs3X4qOO6ajGUoi1ptXQWyElZGC7gXVOfjM0FXXzVZ1+FQ5EJZBXYRHSRp12CCqPRAgfW9qu+mmsQ04vwXmsEfMnaEcc6oIibR88w9xPT1+Z+Yu4n5n5i7idu30/cNqPmhvl+s8/8V2LbvNd51O3nPZ8Pc1+2x22/lW3vSG8gNre2uHTlKmfOX+LS1etsbU5ofNDJb0a8FGPcldLvTd/L245QbAIUA29SVj2QyVg76wxGQ2U0iDOjRM/yKE7vgVh9Y3BTcV5tya0ixWKghJZDOSobBmNSCJBKNPZL6dun6ffEABLX77OW/DingI1kenyzAiJiBobKpiXXX4zmZ3e0zBi+6nCLZQy0Jqj3qFWDJ/fPuPT3tbJ06kTsn1p/7gbSiPRe0PX7sL1lekeVc1atn+oU0OcjhR5oyalTBqeIGcKaDZk+z/rdSqVLxqbKydgo1vUpGzMo50JM+rlc6sPWs8y5EHM2NXehbQLDEBgNW4ZtYNA0NFU02GiUwfu+beRU82c6d2ZDGkSmAssiBBFarw6ilmblgrKEkjGPKsRpQULbNiwvr7CwuKT2W6bj6Pq165w9e5bjx4/z0EOPMGgHOCezVWHvud3+3L4di/jrsYk5KCdQJHJ94yqlJC5eusZ/+I//iRdeflmZeAKOROmiClyLp5SO0WABJ4WUEz4HLl68yNlz5zh44CB/+M//gLYdsLRnD2HQMu4i2QlXrl/jP/yHP+WN118ll8zWZEzTtpSUuH5ti42r11m55yh//mf/K1tfWudjT/wmvgmMJ5EYTXVf/I4YeGcAfusURW9HmAbJN/qKGTCYmwftN992fnA6/vsdbXMc1SPYIZkJwme/V/eULQCXOmfLzNJAKPi+dLMZeJbCAo898hD33nMXX/z0Z3jlldf58U9/xsuvvc6Fy1fIUYUhixgd3DQovAuA+obibG5l0P85O67O2+IV3JaUaYLjkQcf4ne+/CWe+sRTrOzeAyJ0SRdv4xyJpXBtfZOf/ORpvv133+SlF19mM2m7Ur09rg/0cEUDZNPPwjq85BQpedLbXKz7oHMwaAJLC4s88fhH+f3f+z0efuA+lpcXezuTp2aTINUfz/qM6ftILY2deRY7F0nUewSTLnL63bOcP38JijAILcmCyfF4i4JXH53Uv2TrTiPm97xzev1MKd1IBLZYXlwiNIEurtNtdWQsCZJ1wZEtLk1FdL+1zWsRyJmUO6RokBq7jISoWgfFZoMt7nLOJMkz1PEaMNvFF6xVqd4DzarnmSxvUTdRNMvrRUsqtBqjPtti4pEWBFBQQU5lkkrJSNbAXIqQuoT4ZMPfoazVWhih+3BFE1QiThmyVaBSMpIF8bB3zyr79u2jaVqKeL2cvtslOF81KHSBkG/X+fwj3+Z+Yu4n5n5i7ifmfuKD+4nbEhP+x7DdnEb24ezrtr+HPur6e5002wy+CF3sOHnqFM8++yzf/f6PKJN1WimEJrDkBooyiw1oU8WeiiRVC7zdaKv98RQTJN5KYyZbm6SUWFiKDAYDE5ryRg0ruCZATgbSBEVqvacJwUSCDUhJqZ9kCrSYqKw3MAej+yWdNME3eK9lQjJTP6gtmxXsqcCNM/0TvTsG3oSmv0wo1H73xVqjOVEhW+emE2HmAcw8jSklU+txgwqhiZDLtM21PhYrtRJHTp1ea9XoERNWJlBTGGLUQMlqOIoZGhWsyqoNE5NC6c5AFju9lCHGjpwiqdukbRpwniQedWimlm9ATTa0OOVMjJEuZy2jSokSMzlFckrE2KneTCqMJwlt2ifgvAE0hS51jCcdOWm2Y2VpkcXRgMWFIUujAW3TTEvoRAGW4FVELKNeabbMaRuRRbDrreV+GSmZUatMofrRkpW9mKJSI2sGSB2MdhLbs2eVlZVd/Rivuknj8Zh33z3DCy+8wCd/45Ps2b2H4XBkRvBWwdTPN5/nm24BRzYRt83NTa6tX2W00PIX/+Vv+P5PfkxMGd9o+WLwQnCexaVl9u0/yP6D+zhy5BBre/fRxYxIYs/qXq5eu86169cJq7sZjoaMlhfZHI+ZTMYMm5a//uu/4Ktf/S904zGN94yTtVgsni5nXnnzJHsPrPLgQ0f567/8T+RJ5OOf+DzNoGFjqyMitEHd3/bw9NbOcmf9/4flHm819na+Pvt32Xbw0vsV/et99t+jwrCdbi/bfq2+o2kaSimMhkPuOHoHhw8f5qnfeIrX3niTnz3zHM8+/zzH3znB1tYYvAZhqWh2SpxqBFSqd1HEHUQ1zKoOggZLmYXBAh9/4qP8wT/7PR5+8EGGo1EPlWu3EK2rf/Ott/n6N7/FMz97ljOnz/T2lVIXE7PPtWanawcXZ3badAtyhpxog9LuB23DsaNH+OLnP8enP/VJDh86wKBtpwvNmS4mt16izUTo72VaRM+rtgLOBTa3Ot5++yTr62O8axWoz5koWGBq4vwW9JbqC0RUiLNffWkGVUqmlC0Wdw946OE7EPGsb1zl+sYWXYy6mEhFu28kZepqNtpU0VQgDUoHeWytaYVYIjkMcI3HW6eYVAqxaNeWTCa52hmkXmwdgkIsunAsfbYSjSVipMRI9g71d6pnImS1M4VeY0/HqnFW7flPkxczx8uZSeooMWhWXwI4Tbhoc0ZLMBXVy3M+aKfKXMhdhxcoJTPwwpFDB9i7d48JrdbxLBTzqDX5o1R8W7zMt7mf+AW3uZ+Y+4m5n/j19BPz9ty/4k1u8lvdnInlHn/nLX78ox/x3e9+h9def4vWOxZHLbuWl2mcEAj44KltvgqFJtiCc4buFVOkFEGJHplJF4GAE/1+O1xAKDQ+9PBRMxxq9yAguEA02pwKSrVW2qJCXQrgeFwxqqHR4hQt1JrWXosGNQwlqSK5BAVpHN5U2qu4mLFwqkCtU2X4XCKloBQ5r+Q6nYi5B1GcldA4e7/HZwRT82bKwqlodgVrBJPq1TuhkIh9Skw5vTJEnNL7+jImCsW0y8Qmas5WZlSg1kDmymwpmawXC5gxMZ2ZCqiMx1uUpG25m2YICDl2VNFp8YGSCiVHcorELjGedHRdVOAmaXlWipEUtR51azLRsqhU6HJB9VsUuOkKrG9sceniZQbeszAasLy8wK6FEW0baAcNo9EI37YKghWl+znvNMvhxLIRdskY8NZIbxT1Wdg1W8bBO8dC42i9fn8StdtUFzObmxvamnwnf1eE0cKI4cLISvaqeDHkLFy+fIXXXn2TZ599lgceeIBjx46+50ycb7/YVkoheEeMHevrV2kHDc+++CJf+eY32EyRJjT44Dh65DB3Hz3KoQMHOXz4Dg4cPMxwYREJjnY4wvkBoRmwvGsPKyuXGG9tsbh7F/sPHaRpW7a6jsFgwLe//U3+43/6D6xvXMOLU8F0HClmy5IoUPv9H/6Ew4eXeeSh+/jPf/bvIMMTT32W0eIil65p207VMapOsqZtahA+rVK+yVVrBuY2h9GNQbab+e7Nw7idc2Z2y+81fusEfM8PTH8togkDqa0wMz0IX8+j/u2Dp4sdu3Yv8fEnP8rDDz7A5z79SV5+6WWee/Z53nzrbS5evMjWJOG9I6FZN4oyJRPKItRMWcIBQSMgdi2v8PlPfZbf+50vc8/dx2gaa5WJaAe6XLh27Ro/e/ppvv533+SVV19jvDUmJ2UAet/0Gcta9y29Z5Pe4mfEKleF0LR2/zeRNGHf2l4+9clP8unf/CQPPfAAiwsjQvD93XbO9ZmvDyeRZYGkqVHGAmcvXOKtd06RkgrTpxw1t+ys+WtlZRbTTXDFii/Mx2asrl8/l9MY5zY5cvgoH/vY/Vy8tM5zz7+obXBTR0wRSdAQrKQBkwQtTApIiUiOuLLFwkAYNJ7161tMOkf0GWk8gaZfoHSYpkPR0tyclOHparLDnlHC6gbQuMFV2nhM0CVwmtgRo7xnyVpCDcYQte85r6wH3XGVCJiyjS0A1tjdAnRx4BsTwzewH62h1spmIXW6I/WlEyR3rCwtcuTgfpZXlrRUw0IRjCWgc1a10bBnkdM8CQBzP3G792j7NvcTcz+hD2DuJ359/cQvBNTcagD+otnp2+n09GGxY37e7QMds2z7Ycjw7Guqs5JLYjwZ8/rrr/Pmm29w4sQJtjbH5MYTgofQ4EKL84GUbcq5KhK17QgVNNSSp5yhi3Rdh3PaFrngdMEtWjqCARjeRHwV6DUDVooJ3eZeR0WKvueco3ioWu1TyBrrgFQZFoILtftRfxumi/hqMPRuWDkLMwbU3i4KaiAzaHVlcXhnjA1hlkmkXmaaS9gOYJfp+04MfClKd6yYzsxN7dubC0r7yHWH+q9UAeZS65bt/uWsr1edGJFeMLlUBowBOSlFFQfOWesZAcHhnOrK6P2K9ly0xCnGZIBM7s+1AnYpW6vtmFRM2O63atkU1apBiF1Hjh1N4xk1gaWFEaOFISF4bbneND0LSuxeVEaU9M9Bpo+yKL2vFLtXpdjTnZYqFYFB42m9EJwacD3XSEwGnc0+BGMvNW1L0zTbshagQF83iVy5coV3TrzD3rW97D+wj0E77BlI01F16+395vecgTPdvNP5n7oxwWn7y+9851tcvHwFrCb33nvu5v/63//33HPnMYaNCtzFUrQThOkTjZaWaNqWPYNATmOuX7vK2oE1BqMB3WRCSYnjb7/Fv/v3/453z55h4FtKVrAvWV2yuEBxwuYkk3PkL/7yb/g//ev/Ix/9yCP82Z/9W1zT8NiTn6Ztha2t6ywMFxGZamkBNj/Vcd/6Kd88+K7B3/v7h7Ijg7Kd1dVrVZUaHMu298otzuxmQfuNGd567mLnkfuKTaUL5xuuowbhmUyR0tvnxYUBDz9wH/fddSe/+YmneO3113n2ued49rkXePfcedY3xzrbnAa+Tmr3DQXHndPxs2/vXj73mU/zu7/9exw5dIAQjDUIdDGx1SXOnD/HN77xDb75zW9x4cL5PvtW53Ux29cD/oX+3tVri0Xp1hnp/XAbPE0z4IF77uXLX/oSTz31FGt7V038UP1jmrFxs8/5duzAzZ7F7Gs68oRUhElMvP7mcc6evaDC8iJouS29CLxpRmKZCksWCLmI+h0TjiQnSpwgZYswGHP3nfvZu3vAlcsXoXSQur41sktO83xJqeGZTPHqb5w4fI60PvPQ/fcyGo144bk32NhaJ3fgu4b+zuds2dJMjJ1mD43mnno2qDMfYbEEyZ6Pt3PuSF4bCtREFK4moRK1NFmgLwfO9XlQ/Z70/skV7QxSu0uKc+BFqefFoS2iVYOjlEyK6o9jVvF/ckcokYHP7NuzwsH9awwGrcYBTOOKOh5i0jlVmz/kvF3D5Nd1m/uJ6Tb3E3M/sXOb+4m5n7jV9l+VUfN+RuqD6MPcDnByq8/8srV1FISfAZaoCMB0weicsLk14dKVy/z4xz/mpRdf5PSJkzoQRIgJBgsrtAsjQhC6jWtAwWXIzlo/I7OH0fIoM0xdjLjgDajxeJ/x1mK5Z4oIiPc0tQuUsV9K0RZusesQEaJzNI22a5O+LAltKW2lKgJ91ydn3YEqAllitJrDAjlTUq3lrEZTeqFgBXvVkvYDPSWluRn7xongvIPawlum99e+gTqaCj7Rn3Oxc1Br7nuQJo3HuCYgQeuTC2X6XRdsnwkk2rmZUcmZ1HVo+0kt38ooAFNSVGGvYmVdwSmTJidSp4JSs9oyancUcdXyqoaYallTNAaJgjWxU5CmVzSfQYtjTnQpqbiYgUpOtFPSZBIZT1RkOncdrRQWB4HlxSEry4u9oXHe41vtuEB1XrU7Qi596z/vfV87WijGboKctKuVUHV79DllB8PWM2gcjbfyra6jm3SkPK2p7eeOqNh20w5o2hbvAyl19jlt5d7FCeOrW7z++hscOLCfO+44wmBtZPflxvk9+9I/pnLPX+WWugndeJOl0YBnnnuFl55/AYejGQxZHIyYTDLnzl/g4IEDhBBogtoZVzIuNPh2pJm03OFcYWXPEt5HFcgrKmhdYsef/6c/4/hbx2lCSzSQtIiBhmSqPlcRmGTh8tUJf/EXf8P/4V/9CXcc3s+f/vv/hdHyCofvfIBCYmurMGgXEVHF/e0ALzcdL3VT9tw0UK4/b+ZDbsev7NzX7P5uDMBnzmPHZ/uTu+Wx3bbAtK+9rxlTm6G1lWU9dtXU0r/tHGzd0g5a9h/Yx969e3ji8Y/w1vHjPPv8izz77Iu8dfwdLl+9RqEQS6IdBLrxBGWCBu44vJ/f/fJv8+lP/SZr+/arXlXRoHIrdmxsdTz7wot89et/x3PPP8+1K1e0Q0dRofn6/J2VY9Zte813DeBy7xe9gCuJ3UsLfPzxp/jylz7PI488zHAwVO2Foo6sIMwG3jufTX+EmXu1c6vllTdbnIk4yJlchEuXr/PKq6+zuTXW7F8p1K6ByWy7c2XaCaMkSspkvAk7FkgRL4VhcITWkbrEvn0r3H3sMN4lrl+9iEiHuAmu28SlDpdbc5meQiGVTgX6LaCX3HHk8AE++dRjgOf0yTNcuHyVlCakboKIJ2fpGwPkoozemgGuC0wnlvXMRcXjqYtJ7UZSKLgYwUeaHAzon1mEFNNbMP8hRSUkNWbwRk0XipVRB4spENHuK8ZatgFCSh05dxokaw2GMVytEwgJVxKFhBM4sG+Ntb17aZpGrymXPjmhYwKgaMOG4AiNxm7zTbe5n5j7ibmfmPuJuZ+AD+In/sGWPtUB/Q9zYbXDfNo1nDp1iqeffYbvf/97nD55ko3NDUTAe89wNOSOY8dYbBwuTrg03lQFbnQwd13SMiGrv6laMTlHY78J3SSxwYSYM6UMoLQIwlYXkRBwudDkBE67LSlVNSh9LGW6rS1KF2GS8AuVUKJtqcUJJThDq6Uv51ExYV3cO2uzXRJUChhgStkg2dg2ZeY+mf5KBYRKwWqS9Bfdn7YgdymTvHWLsu5T1Tu5SnmjMPVRAig6WlJWNpETXHZkK+vqqXIVOJp1fiJ9Zys1QAqipKTlSMryCZQc7WbpsXPJPbqfY0eOkRQ7zRwgDBrVAgL68q9SIHWZzavXiUnLm9rBQK9opt1cphAnHXYAUsp0XdKSqFwUZi8QO9hc32Rja5PrG+usre5hediwOtrD7pVlRktLjBYXaJuGyn5pQtPfOy+W5rD7Kz70gA4l4QwtrxpAtQ3ezKjvDa+QabwwCMFKvytDSrt/bav1FUdotGNY8IEQGlLuqMNGgUgt5Xv+uRdZWlxiaWmZT31qd1+Kd2N5+YcPzv5abQI5RRoHgcLzTz/NZGOTXQtLxCwMmhEXzl/if/gf/kf2ru7mjjuO8MBDD3HfAw+wZ9cyoQlkF1hY3sWu3Ss4yYTWMRoIJY+5dvEKly9c1jJJjLIbAi54YpcokjUAN3tYbH5lAuubgTfePM3ffvVr/O6Xvsjbb7/N//L/+X/yf/m//z9Y2bWPrc0NRByDNkDRFpQ6ptMNw2JnIKvdSOwW3CSDdkPQvO3725lg+iGbE+bEy7bXdo7R2UBQP9MfY8bu1fd3frfPHs6C9AKKsm8PMuv1OVdBWqtxr/fBAlW8lqmOwoAHH7yP++67ly9+/nO8+tobPPPMM7zw4oucevcU48kWRTK+abnz2B380R/8Uz75iY+zuLQIXunQ3ju2uo6zFy/yze98j69941u8e+YcMWaaZkiJEQomel5BYw3SijE/a9ltBad1eaYLNucKjsThA3v5/d/+Ip/+zU9y8NABBsOhguQi2g0C9Z2l3GA0PtB26zjFfGVxTLrMm2+d4NS7Z/WeFu1k4VyjQHfOiGipaknFtOFs0VkK2caUKwkpHasru1hbXaKwzOHDq+xb3UM3nrC1ucHCKLC8HPDOM5FEmmQtvS2J4oWUx8RJh/cgMbEwCDxy/zHuumM/5y9eQSSS00TnWRNJkshZwDtN2PRjp/6zkmyz96UUXLZxKjpndb1U6OgoKSAxE3DWslXLoa3qQjOcpoUG02SQWOwCVgJgiYQihS4nnbOSCMmRugmx2yCmCTXjrKXcTH2VZKXWl8RoYYEjdxxm1649eNdO52mB2iFHS5Mz2thDaLKn636hofOPZ5v7ibmfmPuJ99zmfmLuJ262/cqBml8UWJk1dFPj8f77vF3B0NvZ1y/Mupmu9JUB4hxXrl7mxIkTvPTii5w/d5aNjQ2rryu0g5alpUWWV5ZpSiKP1ciqKFoGU49WzaQ8ZYrMHgplK3grlUk5E3PGpQySaFImpEyK0dSoTSjXGCug7fJKQZHZXFk81qrMQZFiU83Op1RE167WftaOTNXq34gw1wW8QHUqTgd0b/YNoS8G8mCTumQ1nDlGBYZEUPaNtz3PMGvEugFVlDMlM4bGBDHDLSYoVjD0vT/XMj0X1CGnLhK3JpSScD6YMSp2HYpk55R7UCenzsqekjkM3Z9zXr8nWLcmbYNXHa0i0VaBbFVFuWgryxS7/vRS1vbbqvuSkGzA3iSxubFBN5nQOMfCQNtkB4HBcMigVTDE232Yzh99tn0JlKn+S0Woc+7JTL43kPp3ZZIJRhNFDRZFW296EiVHfd/5njEjPbqtx+5Lser5MUW/K/PJOcf6+ianTp3mlVde5ZFHHmF5eZm2HfQA0S+y/cMEiH85mzLBIsPhkEvnz/Dma6+wPBoxyYEkgZygbYaUkjn+zglefu01vvatb7P/0EEevPcunnzyozz2+MfxQbWukiTyZIuUI3HjGtcuX+WNV1/nnrvu4/d/7/d47rmXOXvxknY/sKyMtUpDpCgwWqDQIH6R8WSdH/34ae44tMbHnvwIf/3Vb/Cf/vTf8sf/6l8jMmRz6zreD7V7GUBxfQZnp6mf/l12vF62ZcN2bjd/vWz7UT9XX6xZlwrqzm4y+3fZHvgXxzYRySmLUCygLJYA2LkIEJTGvz24rwF7ARzmD+wYIqL0Z+o+IWheG58KBw7sZd/aKh974jFOvHOCp5/+Kc88/wLHT55ibf9+fv/3/ykfe+JxlhcXwTs6C9o2N8e88eabfPPb3+Xvf/gTLly+opoSOA0+s2i/ilI0oBZlVUajVBcMTK62C7X12skhMxwEnnj0MX7/t77A4w8/yK5duxADpYs4ihmqun+7cf39vN3N4sXeZ0x9c5neX6tRv3ZtnRdefJkr165pRtCpDS3BIznZ8ynqD7KKamJ+WEdrNkHODmRCyWMWhivsP3CIpaUhFy9eYmNri/HmFmtru1netZtuc4vrl69z/tw1Ll/eZBIhEvFBGI1GjIKDOOHgnhUeuu9OFgaeq5fPE7sxTXCMY9JzyxmKJ6dCztHGDKZbV2+gZeirHyilt9y1uqOgCzDJygKG6dgNYUCS2PtjF/rC/378aqmFtvwt1vKVrIL7XYp0OYEIwbWQowbhcWxlOWiyKBfNRk/XbiCFvfvWOHLHEQaDgc6lPj0q1llyunhGctXNx/m5r4C5n9DX535i7idu3OZ+Yu4n3stP/FKAml/FIubnOcaHdV479/N+wM10Ak4NrkzfoJTCmTNneO2113jumWe4fPESk/GkHzij0ZBdu3axtLRM6bYYZy236TrVMaH1eAnG9dKFci5Vy2R6HqkUo70pPS4mRfVygdYW876L+CKKGHprg03RFnox6WK80O9HaweroSvbr7lUFLHYZFBzVMV+dWBL3/p7uiCf+Wfoox7HUYtk+4mRi9YrFlGhYTRjkkIAGgOaiurX1GdVy6Zs+tdMROq6fgI5b/XIheks7K9DzGDk3jwUUeHebjxhsrmlzqiBgODc9Hn0AE1MxG6iHZmKGlRHBZAU5VXDHNXgorWlFdgrSdky0t8qE+OKkRhjf16p16hJJiYt5FQYjydsrG8gpbC0NGJ5NKIxMbTBYKgdvkLowa7qjNQo6djw9t40Jil9/S/VeVSDVME79Np6EC6pE5GS8ERKmuh48552MDJm1HY9ohACbdPQNMHOoToyPQcxoGsy7jh58jQ+OD772c/QNC2DwXCmFLGe13YQ971A3ZtRW3/tN+lIkmkXF3n1R6/SDB0HD6xy7vwGXXIUVwxUa1hZWcWtr3Nt/Tpvvn6ct956k+dff5X/29oBdu9dwwNSHJsbickWhKFj74FDdMlx9cpVjhw9zD/53S/z7/7tf6DLEIuQSSqInpMKqKeiNoKCoyHmBa5vbvC1b/+A3//9z/PIIw/wvW9+myN33MNvfvYLjOOEeO08u3etIVn1l4J3BozO2vrps9d/t+aqTsf9zTcn0ywcvZkWg9kzpKgmso63bfvSTCXQZ46mYbu+P2OKe1/ThyrWIc2xHSSXmX0U012o+yuA5ILLUYOKYtoAZhu80/JPihCL2lfnLdByhcVmkQceepB77ryHz3zmC7x77gzihTvuvJNmNGAigiuaDbx+/RrPPv8cf/u1r/Hiq69z9foWiMdREEkU58l4CkIgE8SajBbtplCCgAvk7GiKg04zYMU7Qpmwe/cin/7Nj/OlL3yO+++6h2EY9Pe6F4Csd7zaiZn5/kHnflZnqHcxl6ohb5lbvVddTJx79yyn3jlhHTUgkimSKD6TfSZtTmiKIFmXPKnouBATq6egPtgVOgrvXrxMTGPa1jEYtJw4cYr1jQ26lNm9uMRoYQVi5PziZdY33uHS+oTiwOVMEOHovjUOHFgjuMKhA7s4fMd+YoqsX1tneThk7/KIja2OJB2ZCUhj/lnvl6NAUd+stHTLCv//2fvTZsuS6zwTfNx9D2e4Y8xDRkRG5IxMzAABEADBIgRQFAlJVlJ1qaqtrcvaZG1tZdb9C/ovdH/qstaHMpNKLVWpWlVNSUVRBEiKIEAMJIYEMpEjMiJjniPufM7Ze7v76g/L9z7n3ojIjBwAYTgr88a999wz7MHd1/J3vetd6VrbqBoWYh1is5T5TM0FrFPdPgImRhzafSdkGboVURarJyIpWWBFMFGgaQixJkoDQanqwQd8FKJ1uCzHWz22SJtAQf2MaMeZxqjPtdFgojAY9Hn05EkOHDhAVlgwsYt3WmZGG+NZ41JrWo2vMle8o/HyK2tzP3GPzf3E3E+0NvcTcz/xIPulLX36pba04Lk8Z2t7h5s3b/Bv/82/5cc/ep5XfvKS1mUmdgfA4uIiBw4cYHFxme2tSEgoQIjKHDHG4KzgjNHKlvTVIuTa1cgmypcunJOqIUQdn8NBj8ar3koUQ+aVUlgUebcZN8bgiqJ1QdpaGo9IjUVblNnMIm2ZSruBF1EwSV+WHINRgCUt7y4v9JLEQPA1YrQ2OSbFcmVpKBIpVvS6tNQ1C9Jq00QtHbICJjbqiKNJ4lcxOYykeSIO61BGTmq7J8FPnY7Jpx4pUVenC2/sjivEttbZ4auKZlJRjyuyIlNwBTQoaNFtUTQWiQTfMKnGNE1D8IFev6/lOUa62kcFoVrYPIMiVzTYx1TiRAInjJZcpXrhNrsiohRI71NL7sZ3GjfDfo9+WXLowH6WloZdB6UiL5SpEiPG2bTY6VhyrgXw0g3lXuc9+4OdGQutMLJeS+0kpi3DI84YiszhCOSFoxz26Pf79wgGGwMus1r2lNq8qz6QOl8fQscCG/R6bK5v8PL2Ft/4xjf59Kc/w9NPP0XusgQ8mZn3fXvG3ZxFc3/zoSLPHT40nH3zDR45eYRLl28wGETGEyGgHc0QvW+D3gCDJbdjtiYbbG1ugwi5VcHH2HiaJhLEMt6pISs5fuoUt67fYH1tk9/8zc/w4gsv8ZOXXsVIJDcGK1py6LAkuUiEBN5KBlJw/dYWP/rxS3z+N3+TK+dv8Sf//n/jxKOnOXDwGKPxFmWvz7BYwGBU+2k6vDub6gPsHj977e3GUiv4J0Sl7GpkTMsPtNK5Cehg1ymE3RKsbRdYJ7Bcdr1QX90G2DPf2yxQlw3a9fxpwK9rZncYM9lbFfyTbr0x7eI+s2mgA7pbqn1e9jh27BiHjhxCrBBN2+1D2YDj0TY/+P73+ZM//aq2cq0DJoLEgM0szjqisYmNB5JauWpWO20xjIFEb44hkhtL7hzeCkePHuWLf+tzfP6zv8GBfSs4cpQk2Z3cnnuXfJDcv8z6YdeE9h2nq2X6LKNJxlFV8dOz57h9ex2JqTxTUpCeBAczY1J2tM2L6pfKOkq6L63mgtCEwNraOjdvlhw9egCRSF1XxGjJSouJsL0z4dbtNTZ3Rni024qK4Tf4akKeZRw6uMy+fUPG4zHbW9vEKBw7epTlpX1sj8dsjgNrI89OJTrvjOrFESwmtqXDbXLGYW2GtY7M6nmJc0SrZcTGOLJ0/8S6NDbT5i51hjQkrYyomgBBNBFiogbapvE00hDF60Y26b4FMWB1k6Bs+lb4ky6pJQaiUbZn9J4MhzWG1aVlTjzyCAsLC11yYPdASHfZtAml9h53295fe5v7iXtt7ifmfmLW5n5i7ifuZ79SQM1/qmz3203CKbMlLXyJFbG5vc2lSxd56Scv8cKPf8yVy5epqiotLIrVGmNYGA7Zt7KigrktyugcLsswoth6CLHFYmG2s5IxrWxaJ6Hmo9ZeOhGCKNjQpBIoMERnyUU7TU1bH7fIuaTFIQIBaxQcsKKOpD1foQVYBLGZTrqODZMWZBEkaqmOsmkiJhoIlhhCAlKmQI1JDqYt/UEstm21FxWFNladmIkCNk5RWrRuUxKQizGYaLr3b5kdMVEYoxecdUnnZ1ruJBKnky3p8EhaKDutGNOyjhRwaaqG6YoqkCiAIQTq2lMnTZmQaIoSI76agEScU/ErBZQ0exISiOPrWsdUgt5D0vgx2K7lnQ+RpvE0dUPT1NSTCUZgYdCjt7BAv1cyGPZTmZGyZNp7TmJLmTTmsqR7pKVwpvOw+ndlKBnX1pdOHf00y2C6b7FJej4+CSxHLa1zRugVOYN+n7I/SECMSSNPnbi1kBe5dqFqj7Wba3TZI5dl+OBpas8LP36RAwcOsrqywqlTJ1WwmZl1QnbP47eb03PQZmpVPWZxuMDGxm2uXDnPk0+e5tXX30gijk7pni17ygqZdQzKHiYKIVYYHzAhUk8qtqIGYibLuHrlCn/z/b/hscfO8NSTT7CwsAjiyG3J7/3BH3Dp6jXC2u00qiJiDCGtsxIt0aZw1TiM5ARf8vprlzh57DLPPfc4f/S1r/PnX/1jvvL3/wuiFGxtbFDuK8ltSVvmt9eX7BKDfIty9LS8PdCm9He6LIvAlP2LSb/MRL/tvwaMmRFtT2uAaWPglL3c+3md/+nSqG3ALPc8t3vESJcNFdLGgN0stLfyt/ewT51muFwUrek2liykk3IGbyz9vODo/oPsbGxxd20TaZrUodDR7gYiqNA9ELrjdd2xqLC4RWLA5YYyt3zsuaf527/3RZ566jS9Xk5unbaYnWFb7i09eFCJwjsxs+e7mobNIHgx3Ly7xas/Pa8bDpvpfQzpRH0ktw6TZQRfp/PTe22MxhIp8lYw3ViMGJwx5M5w8uRRnn32abZHW4QQaBqDtQUbG1tcvHyd81ducHdzgpDhg2DFEELk1q3bGCcU2Sn6hXDx0oTxaEzdRJZXVlhZzajqiptr28TbW3jG1N4QjWCLAhcD2oI0BeXYFICrj8lMuodOA2sF5GfW8yQCi6RNdZRuQ2LQ0hWfsp0hemLjMT5gY9s0NnS+FmMgpo1qsKklinQ3Re9xmCZqYspiWSjygqNHDnH82DHKXq/Ty9t1j83MWE/Dpd24KjV/bnM/ca/N/cTs585cl7mfSDb3E3M/8T615343A/ShEcaHfO/7bbIe9Np76jh/TpuudvNKAlRu3b7FG2ff4Pvf+xtee/UVdra38c2U1SHG4KxhcXHIyspSqvrR2jrrVKcjtuyMVB4DCiwYUGAkTc6YqHkmKtDgrNOe9aksxvoACdRoAZYYs+mxdKMKBRUEjNHNtkggxgTCYGi1WBBtRZ1l0oE0CYZPuMduoMY6LZUxUTfw7SIfJWITwqLHklB6cViKKUASYzdnbWyBI5sQ0JgmRHImMSotVOIUrIm6edfyJAMZWJcqOhMYIjG0b0Gr/B1TidoUjLOqHB+VU+MbT6uUL75Jn6UCzXXd0DQe6yxtK+3oA9VkgpFIURbY3CX9mSah2Kp83tRVKlHLdGGKU2ehIE2gTkLCTdPgfUNdT8idY9BbZt/SMkVRkJW5MlcSUNMJzbWXy2hNp8tagWb9kjQWOkDGJDGvLo8j7RsAJIAnQS6SWpF7T+zKnzTr1e+VLAyHFP1+0graM48sZLkCNdOsT7eSpi+TgKeMpvG88vIrnDjxCIcPH+LUqZMJ9GuxptZp37sOPOwa8uts3ldAj6tXLrK9tU6vl7GxucZ4UmLMgCyzFEUxBX0FcquCjxhPCDV+MqEa7xCairI34OadO/x//uX/yA9/+DwLwwGnz5zi05/6DT724Y+xf1/JRz72YT73uc/wZ1/9Y/atrnDk8BGuX7/BxSvX8UEF89R3K/gs5AQiW9sNP3npVb78O5/l6SdO8dff+jpPPvEUTz7zUTY31ljoL5APlYKqgPPU9gacb50p3RN4zryRegDbZbd0SbTT/JkRRZTTs+8ZlyZ1WWMaQ7Rguq5Lu59/T6bUhvaTErK55+3TV7tedjpUaGBr5D7HtOtcpye7C0QFcCZl+TTwtxKxNgN0LV1eWOTzn/kMH/zAM7x5/jwvvvQyzz//Ajdv3qX2gUArTU9KE1vEuOQjtExX3xcyA2KF5eUFPvfp3+Bvf/ELHD12mCxHwW1RH9t2+TDIPefxfgTfeollpsygjQFUuHLceM5fvsa1G7cxtiBGO920xogJkSzLIcvwpsY61caw3Tqd6OzWpvPW83diWVoc8OGPfIhTpx/l0qWLLC2PEHLqCm7e3uTO5phJcHicxqnp6hqbUTUVt2/d5OC+RQ4dWKKa1NRVQwwW6yIhekbjMaPRDnU91mtoM8BhXJ6uc0HnE5MvEJOCbIt22NCoQbUsmOpjIEkrIqpHMTEiBC0VDg3B1zTRJ98XtBtkjEx5m5pMghR/WEGkSXFOG/qmiEKinrsIkoRSnbHk1rCyOOSx06c4cGD/Q2XL063TIxBhezR6T2PoV8XmfuJem/uJ3Z9N+4lzP9Fd4bmfmPuJXylGzS+ytayHvCzY3tnh6vXr/OEf/q+88tJLvPzii2xvbOJDULFZ0U23MYbV1SX27d/H8uoKjfeIaL1e5nJqk5SNBJ2wEYJEvA+KRGYoIyExV3zU3u91MDjvaaxS/SyGGCBzAWsb+mWuE6EHwUf1BdYktoXBZpbQeG3DHGpcPiGLQTVNOvZHYoCEgPgM29MJYKybcQgAEYkNKvarqtwIRN9oyRKpjCeJBUPrfCLGKqPFpA5VYTxRIWRr8VWNKwpsluGygui1tbjJskRbE2XESKK/Wgs2J/iG4CPNeEIserg8x5YuOba4uxV0VmCzHEJSQo8BYw1ZWSJW61h9KkcilTGNdjb1OKzSMmsf8CFS5hlN8ISobe58UJDLRDARvPdUoxGT7S2sdRRlifc+qdKnEiufypq8UNUVdd2wMxpTjSY0jbaXWxoMGPT77F/dR7/f7xg0RVFOGVu0YlumY9m4TrgXdvmRhOTFkBTw0+tJzxTu48CE1O5dAaSmrpWVZWHQKzmwbz+HDx+hP9RyrHsnE2R5gcvyNtezJ+bQR/OiTIt5ZH3jLt/+9ne4dv06x08c5+jhIwwHQ+ra737Zzwez/ZUyn2ijr7/6MmVu8U3N5tYmTVjUe2BTvXGIZC6jyDJ1bnlOXhhGoy1y5ygyS17mbG1u8q//53/N9777Q+q6YrS1zZ1bt3jlxRf52vE/4YPPfZAPPfdhTp85ySc+/mG++Du/w+lHT3Pjxm3+xb/6//I3P/ixdj+QmBy+grLRFNR1xtWrd7h6/QYfeOYJ3njjPN/6xl9w4sQZsAPu3L1Dv7+ABDBOx979MmjI/QLw2bHehrHpLymtOqv31IKg+rjOlLYu3aa3agHtLsA2Wr4ZUD9gZ2Zb96ktmMo0MN91jLO/3zf4TseYnr87oL434HgQwHlP1hGDliiq9kL3fm0SwWiAb7Ocgwf2s291mWeeeprP/+bnePHFl/jJS69x4fIl1jY2cECQgBgIWEQS6dmk+y4REwNHjxzkdz7/eX7ntz7H4X1LnR6CkBiPCFGCrs/vsWPHgy1R4lPmW1KGM0jER2Fza8xrr59jUvsUuBmQ6RrsQ8SKUOYFIW8IIeCMVUk6TfWqRmoIaUMW0wYucuDQQY4+cgJcxs7EszP2ZFkGLqco+5isQMwEY1xiq0ZiFJy1gKPfy3jszGkePXmCzY01JlWDzTIa79neqbh2/TZ3NrapgiFGm+5xSiZlBa0OaZCIkalWBUATA9ZoV0OEbgvaJgqsMXiv2VabaOLqL8baSSRG9eMp4SNRO/Aoo9MwvZRCFK8JHYnQCN44XOaAqH9L976Nv2ymJQSFtRw7fJBHTz7CYNAHZ7tZvifsTjmCttwAfGrYsLG58TMaV79cNvcTMw92NvcTcz8xPfO5n5j7ifvZz1xM+EGo6bt5r5/na98Pa8/dWQtWN+dXrl7j4sWL/PD5H/LCj37EtatX2RntEGLo+tu3dY7WOZaWlllYWKDf70+vpZkOZK1CClqmw3TRFVEhWdMtdBZrYjd4QtJ/AVXNtsbqBDSWxlmsDVR1IM8NzgjRRGImOJdp62hnFeiIEe9V3NgAAd9t1o1VNkSUmNqdKZIr0XRdlVpaokgCTlRoRlu4NT4xakhOQ4u7YlqojY2YplEwyqATEoFgwAba8h1rtH7WgJaKZdpRSa+dQGK4hBg7nZlqa5tQ1mRlSWEHOlmtLixA8pRtjbPWe6rKugJJIaoGS/CNiupGrWfE5gmdhyYEQqqxFMA3qeORMdiiQESooxBHE6L3NHVFlhcYY7q2gljNPLSTPwShqirG4zGTqmJ7a4QEFSpeGAxVl6bXo+z3FJyxupA7lyWgRsvLFEwyM5o0Jp2/otm0WSSRVAgt3XVpS5VoF8H0j7GJxhsiITF8QuOJXhdPI9Ab9Fjav5/VQ4cpe7OMminlVwSyosS5nKZJrchnFu92HkzniyXLCra2trl08RLf+dZ3+OQnP8mpU6fI86IrX9OoSj+rXV11DHF/wGluADRNoK5rLpy/QK8omIzHjEcTanrk1OQYSnKMKL0zhJxeWdIrS4bDkiwzDMqC4aDPzmjMv/3DP+Svvv5N8EJuHWVeEKVBQsOtG1f55tptvv+97/L4Y0/wld//Ozz1xBPkWcby6j6+8pXf5403L7C1U7G9M8YaSzCeYCNBHFk2YGu8xUuvnOP4saM898zjPP/Cq7zx+ss89YFPsLGxztLiKgsLS12640EZM2OmAdveP+91PTPSXfq7aWv623mTYM2ZALwNhHfT0dMqaFRssMsatkNdUlJgV6C899h3bw7uOa82SIQElU+f3tLZH9Z2BeBGEuOuDVG0NFWzprputJ04MdrdbXFhwMJjZzh14gSf/dxneeXV1/nBD77Pa6+9xt31DQJai++MwxnBENL1EE6fPMHvfflLfOJjH2VpcYhxLduxhZDTf6KB2/3O6v2IIbpsdrtOiXYWEZQ6fvXKNa5evaZ/s20Am3YJotpzuXG40hG8p65rXedSWa4xgo2qARYlYsRjsFiTsbLvIHl/kVElvH72Eq+9/lPKcsCRo8dxvZLBoE9/a0I9rqlipR0TBUK0YB0nTjzCJz7+UVaWFnj11THO5QiGuqlY29zmztaESQ2StMJsGpGqkafJFAATlereiq6KQZMVKamTWUuMjW4A0LgCAWM1QSAobb1uxoRmhEhEjNNkxp7VOW3nup9n+Z1W2oA8TjsydvdZ/Wi3GYiBhf6Ax06d4sjBg+RZBta16aPdN3kXyD8tWw8xsLa29p7H0K+Czf3E3E88yOZ+Yu4nYO4nHmQ/c0bNf2qwZNYehp42C4bcc+R7gfC3frg7dwFiCEwmE944d45XX36Zv/7Od3jz7Fm2t7dUuCl1UWp1d5U1k7G0tMRgONS2wrFdKFqQQN87hIg1No2BKS0sypT21iHmaV8do6CCRkITIpkNLfaQ2jm3XYIgGpsQ6ERFbOlgCVzxXkERa5QaaK3FOks+o2IdY8CKUwZLFEzbTcjaDqUkIbUSVYckhBaokUSDSwNfoiK7NmJcQ8sAURAglSaJJQbd5AevaKwYMFHPs2NyJrZRTG2tm1oZHn5SQVJJz/oKjlisMn/UO+qxSrouqZsT6R5E7wmhIfiGwhUEI2DBZnnSBRKlaCYQSoG1oIu0c9g8Q4XJG3xVaxvvJDgsrYh0Art0wWxbcHuqqmI0njAejxmNRhQuIy8KFoZDFgYDer1SuzrlSZhYRO+ZsR3V0xh15Na2AtQ21Vy246gF+naDGF3mZ9dMmII4hGnJU2i8lj61GkEI/cGAxdV9LO0/QFYUiS117wTL8hLrMnyTGE4z/3ZPTw7PWAVqqknF7dt3eP6Hz3P4yGGWV1c4dPCgeoMOuJyCTOz6WHPf85wbYCybm1vcuH6do4cWGY1GeB+pYqCRmtJYbOYoshxIGRLfdB3F8iKn1+8D8Gd/+jW+++1vs9BfoOeGiDQUhSFKg7GeXq8EIMssH/vYh3j0icepJRJ8zc3rNxlPRhw9eoi7L79O7pSdJyYQrScEAZPh7ICLV+5y4/pNTp88ziuvnuV7f/NdTj/2LNb22djYYDhc5N7Adfac9/xq7g26dz89zYt2LRYNorvxlnQSWvG6LBFzZ4PotsxPqcHKhLQzgVp3WDNZ0vube8DjJP/Szut2E9BF3+/NBExIFMGkmBbSemJTOev0OnWREEikLHMOHdzPvpVP8sFnnuD8+fM8/6Mf85NXXuPqjbtUjSfLBIkNRZ7zsQ9/lN/90hd56qkn6ZclxmqgLyb5zSgp09qCu3vXrJ+d2dQpBjHUTc3Fi5fYWF9LnQFVX6z14ppJVsHCIs8pigLfanqlZI41lswKgVYU1WDEYsVTBeHytbvcun2b7//oJW7duk2W52yMKvbt248hUjroZQZxVpmc1iLWUJQ5Tz31OEcOH6SpG3Z2xvgmEI2WyWqfvh6N1Jhgu9jJYJIugmWXzoXANBwmxTta9hqAGFV030vQ84iQF4Ou+6RF1Odbr2XCrWhk6p4gWKLRWIigfiPamBI7aZokzY6YkkLJ/erxxKgc+jQSnIFjhw/x2OlTLC0M0/0w0OnU3d9m/UTTNNxdu/s+jZxfcpv7ibmfeBib+wlg7idam/uJeenTW9uDgOaHeWna5JZZwc3NDS5eushf/eVf8lff+Etu3bjBxvo6da0lKSEEInHXxziX0e/3OP7IcZaWFslyR1P7ThPFpObrAvgQkVDjrCXPs13HrvW+6TSMI4h0mi4h6iSom0DuHE4cWWYJUaiqBu8jvbIgc5bMquiWaxoaH7qJQ4wMzaDLJlhD6vyUYUo9lnbAx67Tk0nnrIJWeriJidGyVoyhCbV+BgLGqcOSQDWeYJxTIeGkqaIUvCQMJSoEHEX1T3z0ZFmOS23Ag/dggk7S1AEp+iZ1X/JEiZTDAXmR47IMSY+Js9hcaymjRIIfEYKeW/ABaZQaFyUwGY8JISSgR5Xlc+eAnI3tHbZGI0bbowTIWbJh2XVIChKRoLo0vtEuBQZDVvSwWU+1ZqInt1qyFoJnNJ5QVTV1XTPe3mFnZ5tqMiHGyOJyj6XFBQ7s38dgMCDPswTMdAOjA17a7IxN49daNwVprNsNRJKcfAL4uixPCwrCrkUZhEY8TVPjqwpf1TRVTQgeH7Wu+MDxRzhy6jSHTpzGZfk9QUQLoxRFofozdXMvay9lQqIoiyfPMhrnCN7QVDU//OEP6Q/7bG5t8nu/93coslydom9rsmdRWLnns+e225zJmIy32dra4tETB7SsLXiCeAVym4baqrMsshxjhaqpcE6ZgdVkmytXrnDn9k3+49f+jH6es9gvQRx+vIM1nqzMKQooejlLKys89cyzfPazv0GUSJEXbK6v88//xb/g5COn+K//63/E/+u/+yfcuLZO8KHreNEWfzfBsDOGN85e5rd/6xM89tgJXnj5Zc6fP8ejZz7I3fU1Vvfto98bMhXzu9emQzOFqruG6r2PzdLLO9ZXStG1jyulPdGZ23HYfUuU9plwsdUbkPSzxjkPP0pbHbDZc2qp+rPj/Z5Teyi735G0PkAtgKowGBW3bwMl0mbDYlJNfLp2xnLg4Cr7Vpd46qknuXrtJj964WW+/8PnuXP3Bv1ezqc++Ul++wu/zbEjh8lzZVtiTedKOo2sDmyOTLcdu6/NezU9F2gpnSYlKrQpqeHu3XUuXLyI9yoEb50hBunuK6IBY4gRMRZX9rBeu+O4dH2M0AWZesQ5FkfwwvmLV/mjf/+n3Llzl43NTTAFVSNcvX5LmQRkRIlkWUbZA9cknTdnWF7qc/LRM4hx3Lp7iwuXr7O+sUl/uERR9snyEpM1BLxe15jg8pZB0KaIhcTmjdM4HKGuNRliUoLBpPsS0pfFEJwjxhxnEzvAGbxR/yttcN8O1BT0K8mzU/aY6ZYDEUOw2jcHSXNHkq5eK8ZvHCEEhv2S06cf5fixIxRFhrWmaxpg7fTeprPu7ndbui7pHG/dvvWex9Gvgs39xNxP3N/mfmLuJ5j7ibfwE+8LUPPLnl2ezdib2QdnYLTpRNqDiCeUVSlctlvQVB9khwsXL/GD55/nwvk3efWVl7h14zrVZKKbU+9VlyZOqVTtR2d5Tn8wYGVllbLsYZJIcKfTYkjtyzKimFSPqH+3ru3aYzAZHSvCx9CdpEGRQYlC1QSsDYhYnMvwQRXDnc0UYRYHWZbU0YXQ+ESbNGAtTVMreoiQOy3jEZ8EgZPjJYIxHhyqUyNC9IGmCRRZBlZoJJJnqpZts0w1VxLlzbi2NhItcUprZ/BaLiTW4kx7A1M5UDctSFQ59DqGpNqdFuC2v711OTYv9fNTy25aIWFnE53NtrNMGSFRWVAhooBPDMSo9zWk381khHEZxjqqWsuSxqMRTaOoPijVN0ulRcSA+JgAIGUVqfO2CnB5RZG9V6Hgum7Y2NyimlQ0dUNoVLA4zzKyzLK4uMDi0gL94YA8L3DWprVxGgZMOwMkkNHYqahfAgU7Vy+aaTAaAWDakqn0Oy0FOE5bFVpj9Xr4QKgVFGuaBt/oPY4iWOc4dPIMi/sPUvb7eybazLRsSwM74I3ubivVc7rIm5SRUNaVI5jAeDTm7E/fABFOnjjJmdNnWF5a0rHegont2r73EOZIzT1mMYS6wdcVZWkhj4htiL7C+ApUqgoxmoFZWllidWmJ3/3Slxgs9Xj+xz/gz//iz1i/eZtQTRgMCxaGhl4vY1+5yvKw5ODhJY4e28/S6irFwgqrB08QDFQSCY3wp1/9S55//icUWcE//Af/kM/+xmf4w3/7RwTTQHRktMwswZiMwJBzl9b58MaYx04f5uVXX+SHP/wuxx99jio0rG/dpiz6XWv4Lllo2uB3z8DoguhpJmhWL2Cvte9zz3s86G/3XPNkMgVDQeeuYXdQPf08OkB912Zg9vg6qmF3SLt94Du0+8zgzq8KTs9DgBC0A0PL/ZeZ62eTEL0ErEvAr80YZos8sbjMqdNn+OQnP86NG1cZDPo88shxlpaXlJXZUtxjxIhN569MSSR0xyQomP6zsIghWouL4JBUBgxNEC5dvcG1m+uILbBG8AhYLcU1pBjWghfPyHtcMYACRMYgqvkhAkFU9D4Ssc4gQbDi2N6s2Nq+im4Ge12pqzTCaEtwJcSsxPVLysKQR/WZzlkWFwvWtyacvXybH7/wKq9fvoOvI8PJDitLqkWXOY/LhBBdYt6CiR4jDTjtwChBG7raFJjGgLZKDZOUHVWmrApbah7fmfaueJAaxGgnQzICOZGApdasqKRS4KjBMwINUbOmQtJ8UP8QHYiJ2OgRSaKQqcWyAGJRyruBw0cP8ejjp1haXcBm0xJja61uJlozJuU6JJGM2zbAwtb2FlevXP6ZjKtfNpv7CeZ+4gE29xNzPzH3Ew/2E+8JqJm2ONs9zfair78otjfL/4BnkZ5034dJSK7Z8zBMy1cm4zF319a4efMmP/jR83z3O9/h6pXL3LpxfYrHik7EGFLXIdm9wGVZRq/XY2G4QJ6lEqLuOabbqKoOjCX4mrZBd4a2lbYJVGhLg0xC7lsEFoQgWoLjnAo2lSGJAANiDY1PArkd8ijEEHA2U0aGMfgYMSGotkpCeKOA9412JTJGWWBpIc1awWFRNlBLPVVKXzumUseqlBmYRe0hgTWgHaMQcEqbbR2GtKcYBUxEUk2nMO2O1HbH6i6HsSoenGUKltSVLg7WgHFgXHfvpT2GJAAdgtGfg8eHWhkiIRCDMj5cFsE56rqimkyoJ5UeR5apoFQItJTOGALifQKlEpiUxm0nGBwioYlUdc1kMmG0vU1V1/gm6AJmDS7L6fW0prs/6HUtuC0GozVXtNhKB9KQSrySplIH0sw4Ri2cle6FU6BGr2YUmWFCTYMQaXTsxMRc0o5PKkoN4PKcfUdPMFxcJksAVgv8dPedhJ+hw8M5p0CNwIMyRCaNJ2MtJlq8r7h54ybWWl5//XVWlpcpy4J+2dszysyub21QAG+3hvx6WeEc294TQ0ORZWQ97dRhIkQJBANOHD54rIePf/xjHDt0mGNHj3L23DmymFMYy4HlHocPHuTA/iFHjx3gyNHDHDpwmDIvUibDEMkpB6vk2TK+iTjneP21N/jaV/+Upm7Y3NwEhCefepKyV1CP6hRTtlnLaXC7M5pw+fIVPvHRxzhz6gTn33yVjfWbrO47yGS0TVhR/av2+fdmOmcHBjPvz67nPzgAv9dmH3/gc+59Uffjg3zyQ9tbvO6dv+PuV3QzpruG91qMcdfvChZHXWraznlJhLDVwypMzqlTJzlx4hht6a1I1HUlvU47OOi6r+tE7DZkb3Pa791M+py2zZxV0cTt0YjzF86zMxolKnubsJkC4gZlnQYfaeoam/Uo8oJxU9E0kQzpxB21glOQIJo5CG3GjqSRp0xJ53QttHmPvOyrRlqExLPH2gh4aqn5mx+9Qu/V89y4cYtxbSA6wk6FyJaWI6PBurY2Vl0J7YqRklYp2RDrJOoYISS9NjHqR4xJG412uRW9aNG05eBtXllFUZXcbkG8htWCxgAmBdqi2VoDWNHAXiQF1uk2IKErVW47Q3azWmBxYcDjj53mkaNHKYuye1ymH7NrALdJd/VDygCpfcWt2ypIO7e5n5j7iYd7xdxPzP3E3E/stl/70qfpxkt/TyDuPRvEB1piQVjj2BmNWNvY5MWfvMg3v/GXvP7aq7zy0k8IUXVUylxLaWKM1I22ZQ5B9Up2sXoM9HoFi4sLrKysUBRF+vsUoLEuw7ms68TUbuB9Y+j3dENunEOaQEzewTqbEGNogmL6IW3+W/2RvGpUbMsYDG3r6nbJSgu8eHKjLZ2zLGM02lHVbRGisYgoeBJDQ9Z1C3JJnMto2z/R94ohYJ0iuC1bBzFgbdfxR7f8ku6PUacYtayoGY+IWUaWZZhSy2Gs1S5OPnX00XusHYLEKGWwbesmM+9tCUSvNZCEiPikf2JLaNvGda/RY5SmUT0fr8/3jbbA1tIoT2wCjdEOVCbL2N7YZLS5RTWeUA762lY9NR6KqdViqOvEQLLk1imzJpWota3Eo/esbWxRTSZUkzHb29tYY3HWUvR69Ps9emXJwnDQiVE7a7VeGW37rsBZu/boGDGQxpdT4CvPO8AMr63tSF0SFABMQE56LQm0axf9lpWj56fC01VVUdU1jW/wwdNUDdZmDIZDHn3mgyztP6hg2X1MInivLf8wQlHk1FWaqykAamtfpW1XbsBlDhcdURzBWzY3tqirmj/92p/irOXZZ5/lmaefnrZj7Chus4HW3O5nRqI6w8QKWx4ukhsLQeu7Q26UstpYil7OmTNnqEYj/pd//a9Zu7sFMVDmNV/+0uf48HOP0ssFa5Q1NwEqA44hmVukXyyR5UPG4xrrDDvjbf7kT77G5tYWUYRJXYERjhw5RFmWbI23waSWiu29TOMkAlevXmf4uY/wsY98iDf/6C+5ef0cj505ha8bonhINfFthgRmg7XZYHn28em4easgfNba7OX0/d7ZmGuTI3vf55fJ7gd+hhBmruHsdW7hezPzmNFNWivsLklMvw3MOnxZo7Cf12UyIl33EjGCMRbfBO7evculS5cTozAFz23XF6aUdl97PdsQQSLW5WR5xsQbkEjWRpiYtrmgctyjTTRz9SWaKbZEnJYGk6kYZJv9t3ptYqqt9z5y/fYO1lZEKRCTEdAy4a2dCgw0Xj/bIOTOToPTFK9IaMALoQm0KZe2SMRC12rVOCDEdmpCewpRsBLIBCwWh8GJIYpV5kWYjhnT3mciRgQnKulh0aQMRlJyKd2LLtmQIeLTJsCQWeHYwQM8eeYMq0vLOFIbXMDdZ4zOtmMWwNgcEMb1NpevXefmnblGDcz9RPvY3E+8N5v7ibmf+HXzEz8ToOYXJdv8oI5TD7NATRHn9Jr0um7jadpNo6prX795g9dff51zb77Jd7/zbS5dPM/G+johNMpusJYsUyZJCIltEaeAQTfqjLIhBoMBK6srXQvldlG3xmnJk8uwWYbNHFmed12EqkmDMTFp1eSYGjIixhRkRY64qTNp20Zbqy2aMYaJ95SZI0sFuz4EpBZ88FRZpjo4LqPIC5x14CDPcz0vVb/t2t6B4EJQnRMsaYbrBl5a8EgVrwXRVoexZbyAybXdd55bQmySwvcUJBAktVtLC6/EFAwYzdSkHoaCspdCjEjTTDMnYlSwOHXcypzBZdrlyNp8Kq4bI00z0oXGWYzL02fHDlyajMY4q2g3WCajsbKliLhSBYTxNVjtbGQzx3g8wSQHUxPIci01kxDSUmMIRsuvJIpe3xjxdU01mbCztZMWYMvSYECWAKuyp50SyqJgOBjQK0vyLNPFKwlDWzOlitoW/Evna5zDZA6TZV13LjAISsUUUR2aVkzMzTp/WspfGtJCYk8JTd2oNk1d4RuPbzyh1q/hvv0sHzvByqHDlP1BOwtnZ6RSQyXRo9P87I7PTBfg1nm1s1wMGJfAp+iSCn6gqmouXbrED3/4POPJhKWlJQ4eOEBRFB1aL227sNYhzu0eM1bIcy2zs8awvLhImeU4MYSoYuUBQRyUTY61lhOPnODPv/anWFPgygKTBy5cv8Kpxw4zlJLS9ekNFllaHBAkIzQ5i4tHMDFjMh6Dbchyy4s/eIkXXnxRS0hbKqmBpeUlijKxstpM5swxiwhB4MbtdZpa+OQnPs4PXniVq5d/ysLgb5EvLSImpizdVES7Df7uuQa7AnDTfd0v+H4r//Mwgfre5/08A+77dzX52Xz+vfT7aQlop7nQtsvsgu4225qyot3hJm23FtM1pCSL/k3n+v3jhfdqbVjYrmEC1CFw+do1bt66NaVTS1usO1WXsO3ANZYQItV4RDkY4vIM12QpOJ/SsjXRbLS82FpyY1MyR7Ojkvx6QGh8xFMhFixOWyHbjBC0g4g1BdE4gqi2nUkNC8RA1TSpxFeZnRiwhSaPMBaJGrQaZ4muRqxX/z0zR6QVp+/ut/p/ICn2OTrtANGA3emREsQQW201pBsfIkrt391BRTOtUQcKGN3sBOMxNieKQUS7XjpgoSx5/NGTnDp+nEGvlzbead6lTHune0AbY8zecF33dkZjrl67xubW9vs2ln6Zbe4n5n7iZ/VZcz8x9xO/yn7ifQFqflnQ2bcCkB60SKqw7fT1KqSrpSdN0zCeTNja3uG111/jxRd+zBtvvMHLL73I9vYWvmmSU3JdCVATQ1os4q4FYrZe1DpH2esxHC6QF0UaALrCG5vey+km2rpMW0cbrausm4a81gHjktaI8frdZSoii1WqmbOWzOnm3mXagrkJAedM148+RKWVNT7iG0+eZZhSBYejKHhgrSMIiISk2ZLUxq1urK0RrFGlcOsDxgbEuKSzY7vnaw2ilkEZY8jSeRlnFOU1M8UtZjr0Ba0lbTtEtZOuZQl1EzNpoSjWo9v50DR0tahRxaKcCDZz4PTzY2onHaMHa7F51PuVwLYQlG5IliVam0kiwAEh4g1gfXfMLnNkAnF7h1YhXKIyokxyCi2FTwXDSOwjFW9uUrlT9B7nDJnTxbbIc/KioOyX9IqSIi8oy5Iiz8lcNgVoZp1YEonWzgra3QlnFaxJQsLd/GkR9RmQZ1cpkCicQ+scDQlc02MPtWrSeN8QfdKrSW3bB0srrB49Tjkc4rJsVxZDZr63rK6YGFXWTufnrlcofWvXfN4FtAI+BrY2t7h48SJFkfP444/T7/VYWloidxmtWN594q25zVhWltqZrleChZXVZYbDHnc2KozJwZgOSN7e2eHylSt88qMf44nHH+cHz/+IfFBi6wnX1oYsHHqUA6sHKewAKIlWu89tbG7TXyyIMdBQI3nNqJqAgS984bf56lf/jPGoxuUO6yy9QY9ev6TrTCE6ztqMqTEQjWN7UnP52m1+83Of4nOf/zRf//bzhFixf+kwo3HEOl27RLSNpTFtNwrYE9Kzq3MBZtfcgXceeO997P0IEB8ma/uf0u63weja3qYEtLWSOhROM1R7/Wk3d5n9vb0vKfBOkXi7Frbv9f4H32BFQd8ggo/C9qjijbPnGVeeGHNiorRj6JqXWmNwQOx2DS2bsiHLM4qyJASvYvM2w4oK0zuXp059jsy5TjeuCzxTEwAfGupmooKMYshxiLHYGAjisQ6azFD5iC7T2ubUIZiY9NiSD7RWEOt07XaO4AwmanY2NCXe1rQLqbW6tRCJmFTDr/mNaaArMSb9gaSNpinIpMunegN6StOdddsdJKbNTkqIKwHeqG9qy6ttCt6jKFtVouoRWAdHDx7mmSceY9/KEi6zunky6djaABzZNWbamdkmKWIIrN29y8WLF1UMc25zP6GfMPcT74PN/cTcT8Cvj5/4tS99am0W5G4npLUuIX+GJniquubu2jpbGxtsbW5w5+5d7qytcevWLb77nb/i/Lmz3L19O00I3QAbbFeOo22vo5ZuhFkUd3ZXKuR5wXC4wNLSMkVR4hIzxLmM6Dwmy3BZjstysqzAZSV5XlJPKqqqwhAJoVCQBpsmbaC0FpcrC8d7T1kU9PsZZVGmiemZjMfU3oCx5BkdqBQaFRjulSVZ3iNi8QISAs6lU7D6/BB0QMc6kGcG53QS+MZrqYyxFIWWzFhnEwiiei9ZliOSYyy4mCvVzSiQIImtohDoNBshGKIBLwHVENONepZALWctvmmQ4PFNnZTDFbRQnRrdwPsgRCMEIjZTvNoISB2oqxofGqoQ6JWlghtWgbu68dRNjXif0GSHRKFpGqq6pl6fJIFkx9LSUuqApUJgWeaS0DNU4wmIkBU5zigANB6Npw4hAc2hqfF1TVlk5Jl+SQwUhQIzw4WhAjRZQVEUZAmgc9Z1xF5d4FWM12UZZJku2gnptvc4atGSMlXRUsaNa+mQ6jBF9JhdnlguiaIZfSQ2Hj+Z0EwmNFWFr2t83RCaQDEYsHr0EY6cfjLVeu+ZEzNodPvl61r1iYydDoW0DMbkrLSNuy7ebYtK0wZGRgXCvPecf/M821vb9AdDiqLk5ImTHDpwsEPh6T79Fzdw+U9pRTlAhg29wRAfAwcOH+DAoX1cuH5Z295HgzERFyzWCD/4/g/4O1/6Mp///Of50Y9/zJ1bN8EJ+w4eJu8fwvb2IZJB0EApzyPLqwUmN1TVDtF4TGaY7NR85nOf5+lnPsoLL7zMuXNbCjg6Q69f0h/0aKnLCqCqa1awztKIozE5r7x+ntoHPvzRZ/mzb32bS1cvcuLE04hpuk4S1qRFrhtsD6BE78mgzO3dWRd0zz6GSd0wIJrYbSb0viZNrJlnI3s3QLt+6542e0/fd5MUJM4kGgTD9Rt3OH/hGiE4ophEZ58J/ruNBESr7UTbYwy+piwKemVPE0bek1tHbjMyp6L/0Wj9uzHTjKGkTKANYINggqEJ6DqJkJkaFyv6WWBQREbjHbY2oQqaLRUyrM1JaRwQnQOZdaoz0jRIkWNNmRoROARHlpe4bEIImgGORjOfLkyB/1aAse19aTDYqGkYE8GItphtGwkAaU6mRE3KRUejv7fXz7SPdyNkuplTsF91B6wTrHgWBiVPP/kop04coz8oEWNSx5l2nLSf9Ba3PHpCU3HrxnVu37yBBP/ex9GvgM39xIzN/cT7YnM/kb7N/cSvtJ/4TwfUSPeP2s8RvW0HeVtLiqgIsHZgivgQ2NreYTwes7W1zdWr11jf2GBtfY1bN28xHu0wGY/Y2txke3uT7a1Nrl+/RjUZE2NIrdB0Q+hsoniJZvB9KsFpuxbtXTPA0Ov1WFxYZGVlhSzL1YHEiEllT5kLOJfj8gIXIkXZUJQl1TgHgcmkRiLKlkmbb4PBjyaYXg9nHMPhUMt4rII50TcKIAg0XjVGMqfq5iqaq4MwRO2M431ItyyghUZ6XZVRk1pxR08MgnMKbrSopAmB2jc4IlF7ytGJd0kgBpBawFqypOsD6jStdfh2VQGMzRR8cnovY0wbdIkEPOIEcVkS/NVyF4lBS31aHZQExLbtziUGdna2sU5rNDPnUnelitFoB7MwJMszxAjjJtI0XtFhrclBRLV/xBpsnpHbUt8ry1SXyEe8D+RFmdgjys4RmyuAExR0Ct4rwJRYKRIFk0qdekXOcNjv2mxHifR7PXr9PgsLC9qO3CmI47qyJjul+lmbskoZNs+VRZPEqQ3TGmu9J6lot20LbwwutYE3oEwbM5MpSqiyiCBB9XSaqqKuKpq6pmk8Te3xPiDGsO/EKQ6cOsP+4yfVYcyipsz8LCmTIkbLylJ7wk4YegY02vt92jFtivNpYGaoG8+du2t8/3vfZ3lpme2tbQYf/ziDfl+Bt/Q6Rcy7acq8GErNFj16EllYXmF7NGJxaZGjjxyBn1xQphiZUqGMMvNee+1VfvCD7/P5z3yWjzz3Qf74P/wxHsPa7W0m40g1CPh6B1+PoVYn7foZfjQiEPChwUTDwsIBlpdWyLIBR48d5fz5nwI6VLMip9fr7RpP0vmcNE6zglrgjfOXefnV13n2I09w8tRxXn7lZT79G1+m1y8ZjWoNNLrsjEkdNO/nhKXza8b8crBMf9Gsnc/3tZSRagNVkbbzXCsMb9NGq73X7Ry9T5Z0FngVw892KqdjSNnSqvG8eeEyd9e3iMEQjUndOEglwSkrl5bd4NTLGkTbhUaDEaHMCtxwkcpHpaMbm7THtCtIRP1taMXfEcRHFaoPEfEhaRNYMltTuDGrg5onT69w/FDJlasV331xnaYSQsiIlIjrgzgMqo2XKoP1uqLJCVsUGJuh7FiLLXJsXWimt6Ob6zpuZDdjuYvNjCiVXdO7nd6YGE0SWK+6A9P2qtN53WUyabOpsRsBkRbET2OlzbiLx+WR48f288QTp1hZXdLEE4I1TrPV7Wt58HDRoRUZ7Wxx5dIFNtfuYlr1+19zm/uJ1uZ+4r3a3E/M/QT8+viJhwJqdpU3/Bzs/tS9ByHQux/vfmsRypm/Gms7+pFqZtSEEGi8ZzKesL2zw2Si32/evMXm1ibra+tcv36Dza1NNjc3WV9bo6omNPWE8WhENRlTVfrzFD+YloUYmzaSoMLBrcJ2S9GbOcoWgSuLkn6/T78/wNqkT2NJWjKuo44pqybohjzXL2sdTV3RGK+gQJ5jiFhjiT4SGo91jqwodIKjPef1OFoWhaLRjY8d9U/Zfybt10VZKUnwqmUqsAeNDDEmhgsdSGNDAOuRMN34KkN0ZtMtES8e55ukmdKCCKka01gEBZO6NuEYLZ9SnXCCWGgX5HTtp5v1dlHWs9bnRCxmKtxbVQquuIx+r48PAR8iTWotHUWZN1WjwF4Myghqr0RIdbDGWpzJu5Kb4EN3LNbO0PWkFeZN1y+GVBIWOqCmpec5C0WuIIy17ThL2jS9krwotNQpAU2upWy2bfGM6crmTCqbmr0mLQK+K5vQUU2t3o/ESGnn6K61oaOgStcZKyShZe99p9GEMbiiZPnocRb3HaQ3XGxfPjP/Zw4h/SBiEqgo3Zh8kE0ddUtdTW3Ho+lmXoxQ1w23bt3m3NmzlGXJiZMnOH70KEVR7n7D1rHPY6vOjAFXFiwsr7K5fQtrhEMH9qXshOluqAQhRtjY2uLP/uLP+ehHP8SXvvRFfviDH3Dh8lUuvXmJb379r/jIR56j33OUuWGht0LZKyETtkabCng3YGLGyv4DIJYyy3n01An+5ruQu4zMZuQup1eWUyH0FIkbSYFQ1BLJCGyNG37445/w3Ief5AOPPc7X/+on3Llzg8OHj6NONyKS8iUt0tlSart50o7DNtCzu+bQvb7z7Xzp/QdYuz7vygKaafDx8wn63+rY7z3fe47pAS83D/7TvUcgu7UFNAic/Uy6zPjsWt/6OYyy/abr3s8ythE036Yh9MbmJufOXaCeNBgKFZEkQIzK6k5jKdACyhkZql2n67qyH6MxuCInzzQDalIJb5CAj0GbsAbVZYsxBd3BQNDNZBRN5jgLfeNZzLd47vEFPvvJVQ7ug6tXh6zvbPGT1zbZHA8RsSkQ1mYAMViCiQS0+55zDqkbbOHJ8xxnHSYDEwtCUVBL0BasJnXYsHnnKyIKtEtUzTatWZAU+kQIjbJSjcHaDEzWxRkRiFYTCkYElwJ3/Uqxi5jUPSSNBEH9qvUggRAqFhd6nHn8MU6cPEm/P5iW/t4zpzTQE0keRNKmzui2PMTA2voaFy5cYGtrE+/njBqY+4m5n5i1uZ+4z9HO/cTcT9zXHgqoeTuA5l1N+tmN4EN9zl6g5u0nzey7W5tKNYC6rpnUNevrG2xtb7G9vc3NW7e4cvkqt27d5sKFC5w7e5aNjQ22NjbSZnh6HCE0hOCJ6cLqqSji2KI1xhpt8m5JLJOIb5q0SdcNbHdas9fPQH8wYLiw0DEjJNXUOWeQTDfteVHQND1iEGJRUZYFdVlQFCXj8QgRYTLJKIpcN+gWbIw0NNoSWy8K1lkGi4up00+qW0yXtW686p+gPtQ5B9YSRJjUDTEGIFOAgRZoagc+NN4jmYIVIQpN44kiZCK4ELHOEWMkawVuU5tuXUQiTVOnY8xwznSMGpcpiJFkyxEktZsLSFCxYeeEDIONAVL75hijavEwFYQ2VrR+0wdyWypw1zTpvlvyPMOsGGVDRaGJkUntMT5QNTVNElEOPiCiTJ3M5VS+AQzOObIiI/hA03jEazvvmBaC6IMiwV41fRyOED0hBh1fwWMAZwx5psLKmXPkeZ7aU1tc5uiVyqYpy5KiUKFnmzSITOd0zLQEKkuCwS3IJga8JABMsM7q31v4UJLGS6bdxNKEbcMNnbupo5gkhhSiJXehaWiaWr/qmrr22oIzLykXljj29HOsHDlGXvbume/TJaEF1PSr7XLWsuJaIFGnYgL2zLR8K0vMJWOMto03CWNvKc9RGO2MeOGFF9je2mJldZnFxQVWlx15litTq11L0vV4IFz+62axJisKllf38+arZ6nHE/YtLyedK4cystI3a/BEfvjjH/HdH/wNv/O5L/Dlv/1l/vt/+s9Y31jntVde5Quf+00WegVFkeFsgcsc6+u3qP2EixcvceDgUY4cPomzOTZaciscOXQAZyDPchwZTgx5luGjZlfEapbKosCwFXAhEh1UIfLaT88x2tjhqVOn+I9f+w7nzr7CoUNHuxaeIlrfPcVVlXILZpf/03EILUj81j5qt0+7P5NsalO68wyomoIUDPfGCT8Tmwb797fZa7GnQ8lDvDOw53ruDeTbAJ/uuyTwthWM7Jiy3Tu2x+GYrVVv1wOz5/f315I3NNo22AfD5StXuXrtuvohtEuiI+hWQFR/K6a549Jan1vXBbk4C5klGEGsEKOC3+IbrAg+aDe9KBEbLNYHhFqD0eCQWKTEh5CbQE7N0G1x5mjkNz+6wJnjW/SKMcNS+O3mMJNJw2vnAJ9Ti76OVN5MAsBj6mfqmxqqCoocmzlcar9qTYbFEtO/IoDVdTXiVQxzZk01FrwNmhU2ESeBjIg1OcFm1CYDE3QyGyDJb6pn0p8CrSaFSWFWmmdi8Inxa00giidzhuPHj/H4E0+zsLwv6SxM51iXwErH2JZFmzaJkZJJXgJVXXP12jUuXr5E43XjNTfmfmLuJ2Zs7if2ntXcT8z9xIPsF1Kj5v6ToAVm0mpzz9/UrNFhbVpBUgOTasL25hbbOztcu3qNGzdvsr62zo0bt7h56yYb6+vcunmdu3fWmEwmTCYTfNJNQSLi23uhQrkqRhTu+ezuGKxN5SYmOZ7YATMiMwvY3nXM6CZzeXmZpaVlhsPF5ABS3/nMduiwdQWZa5A8EIucoten7DcMFxbY3NzQMp9JxSTPusoV8hwbBesF2dohK3NsURCaBps5clcgxiFBgSQJoWuxbE1OnjbpdYj4UOHzjCgGHz0tscUltoVxBpdHXGJtCIbGh64VeYiCDdoBK0uLSyGGLJ8CKSGA1J5IRS7QaYskMCiIEOpG6yiN7USrEHBZpPZB0VVrusVLS8lMB5ypWrgirnVTU1eq89NUbVs5i81U2jfESBMbwkRvVoiRqqmp60bHTNL9WRgOlUmTZWR5gTH6/jZCLT4BdYKdQfqxOja0PGtCbBpl6Bghdxm5c5RFQVmq3kyrLeNSSVVv0Kcse5RFQZblXVcnl7mOXWaco1Op0ZugN03a8W3S9dUMgjEqvGWMUUHnPJsuYpDEhRWYsRqVYEigVQxEH/ATBWeaulYNpXFFPanBOIb7DrH6yGn2HTtJb7D4oOWghWz0XqXp0zSqDRRCe6yzHRdMd8wzPrjLroDqTwmGKEHBvHT+mxubnD37JuFPvkp/0Ofxxx7nzKOPpjrXWeBobq1NxmPKsse+fQf53p273L1zl+WlRYrcMg6B2ZanbVvInZ2KP/qjP+GDT3+QT336M3zvRz/mu9/9a948d46dnR36ZYGIagjduHmdN86+xtLqIjHC6uo+yqJMa0TAWlhZXdFgJcs1exKmjk9E55uu51OhdEmU2rqOnL94hXNvXuCZp55gdf8ir732Ip/45OdwztHUylqU+/qeWWt91FvQsmeeu1dEcldQ/ZYmQJz+3GVKZxaTn6PtDpJ/pp/E1P+bPY/da3uPRZNZs+J+P5ujvK8lxuSkqnnj3Jts7exAllHXTQroEgvX5RhMYsmW5HlB7rRrpIFOEN83DR7B5hkmRpqqoplMsAJREtAvESsZNhraaFGIiGkwxmOsJw85mWxxcP+ET31iH2cebVgY3MUwYTEr+OBTR9jZfIR6fJsLNxq2G2iM1vgTDUjbkVITLDFAU1fYicP1LNhMu6bkDvFZt0kSYjeETUpyZZmZdvSzyh6VxCRNT1RWrbU4Z5IfDUAqw04bXv1x5nXtLZCpJwnpw23QMTEcDnj2mWc4dfIk/bLHOwZXRLrM7Wg85vz589y4caNjzs5t7iemNvcTcz/xAJv7ibmfuI+9JVDzViVPP0vq3CzC2n607qNmP3MWZZ4+HqMQYmAyHjMejxmNR9y+fZv19XU2Nze5evUaN2/eZGN9k9u377C+vs7OzjZbm+uMdkapbfZUgMq0nIIoHbMldiJEZubg0o+mRVzTUSY2Tbs51wdnF4/2Zz0PYwzD4ZBev0de5NNFOmX+tfwpSyyTjOgyBQQy7fhTlD1cluEbbantfSBzgeAiIYtJZCvpXYeYNtOVtj5Meia657b49oSsAhzWqmhv5T1dw3BjuxIUa6As86kmirHKHImRJgTtPCXgcr2u2gZNMInO5oOq5zurna8k6YMEH8C0wrEWUj1lK3RsIxirzlivsQETiD52k1bbQuZkKNU0xIhPnaa6rk+igltN0xC8R6yiqpOqwmCTzk1UeiDauryqKurULjuK4JxTHZ40ANpyK9XtAZ9Kn5BI7rTzgEmAQfBaIhSaBkJQvNcqgybLXFJqz5KQsSNrzynLKIpU8tRSCWnHYNvpKenPdESuNrXScWbSKJyWBkrUmk2Tyu5wtvP3ph3G6f5Kp2OjIsmtNo2ej8fXqR13Ov9yYZnB6gGWDx+j7KVOT23AZGYmfpoZkdmsCDSNdpDSFottpqlLeXRrRbsoTkGatl45zW/ZvX6EIOyMRly+dIWXX3oZorCyvMT+1f0J3NH37Og9c6OuayyWo0eOMZk0XLlyjV5Z0u/lbI4DpBrkNjA1JkOi4Y2fvsn3f/A8v/1bv8WXvvQlzp49y43r13j99dc58JlPEURzW3lecOzocRZXFllcWiYv+mAMTVMnTQBh0O+TZRl5rgF40zSku6+3qq2/TmJ9WoNs9dhMzs54xIsvvcaHnvsAZ06f5LVzr7Kzs8FwuI8oUTsYdLhf5+3fg5kZPwAzb55+f4v3N3sC8Psey1v551/Sgdu5TV2AzK4H3zqgVl/OnssyG0P87GxaBe+4e2ed8xcu4yP4GPFGuvJKaxwuyxVQt+rfNQHhCXWtnTNCoGoaAoLJM/qDvuqoGUcIQvBNYoNr5jCKduLQPbABsRgjWDxWJhRxi6MrFZ/62JDnPiAMhjexrsaQYaJnabjGxz64yGR0gOpbt7ixCTsxZyKoBltqr9r5Gat6a6FpiHlDTAkD8gxpHFGSD5KYunromqCxROt7ImK040aHs3fU93TXksYCkrKlXUaaB0xPmflJCLb9PKGfZ5x59FGeevJJVlaWlYXcMp4fxmZi1Rgjo9EON27cYGdnB2M0STS3uZ94dzb3E+/Y5n5i7if41fIT75hR87MEaN5KIKqDNMzsb21LPBBRQdWmaRhXE67euMHlS5e4fPkyr7/6Gnfv3GFrc5P1jU22traYjCeMdsYJUU8TOp3a/ZCtrr1zbGWJ2mOePf5WC2P2NW2HnySwm3a3Rj+oOzdEz986y9LSEoPBQIEaaxPBQdL+02FdJMsLYq4b+pAV5EVJWTb0+j2Koq8lUaHCN57GZjgXyYtAjCaBAwrUBGmIPlCESFYW2CIH5xCr0kpiUKCm7IFEvFdR3dzZTtjK1UxbP1tLkRtMpl2d2k5XjRfyLCfPLblxkLppSSoD0i5YAesiJgn4SgJzJERirHYDC9EjUQiNJxoVpW18EglOKt91XRMlgoWyLMmyQO5jQqZJIFCza5Rp++iENEd10jKa4KwDA8EHjFVG0LiqmEwmNL7B+4YsV7aOMAWO6sbT6rXEKFSVgjEiQraQhJCNpWm0I5Wva2LTaNWctcqmyTIy14pytSh6ruBMXqSW3P0ERmWJHjgFN43NsMYlskyqx03AjV6ImBxa0tcBTIwYDzbTkjSTWqUr8pbCEEkhzkxLdqU6hqRLo2LIvlaGUlPVWrIkMNh/iJXf6pRbAADB8klEQVQjJ9h/4lGyorx3zs0yd7o5SCfCXVUTqrpKQM3udWl2DZEoSeR5D+Dcgjl7lhtrHd5Hbt28w7e++W021tdZ3bfC8odXKMoMmLKgfrZu+5fHtNQNDh4+ipBx9doNHnv8cZaHfW6vbxFbR5o6MRir/m1np+KrX/0zPvTcB3n66af54hd/hz/8N/8/vv3tb/HB5z7A4uIiEWE4HLK0tIBYVFhcDL5pyLKiA8xd0loqy1I7z3kFh8WYBDgqKNeOp6RIQMRgTEYTHK//9AI+CKcfPcl3f/Bj1u7eYriwAgnIFYlg3Kwj0vN/jyk3vTazXkV0Ts7Y3g5sxsz8fVfAMfu8+43Qtz7W956UmSYffhb08Pb9FSie1VVjV3nifT/bqI+evpd+l9Yf77lee6/Fuzsfk+6tZVJ73rxwiVu31ggRmhhwWU5eljiXA2ba3TAKdVXp2kUgJsBbgmZKowEngcZZXNmncBnBOXxVIdak3UirRdAyBHIMjgwtg87smENLW/zmJ/bxqY8P2Le6jrUNIQwJcZEYHXm2wf59GR//yALr6zv8zQtbyHiBGEo8iWIvrX6aQ4yKXhICvq6TVkAB1mHzIunzRbDKZLXG6qY4+aVWh65NjrVM0668FpQpmdgB1lqCKCNSExFCi6O3HVL03rUC94mBafVxZwyrS0t88AMf4MTx4/SKQrOv8hY+Jc0302L1XamFpAB8xN27d7skTZb9QhLXf+429xNzP7H7/ed+YteHzv3E3E88wH4hPciuesU0llqmik29oEOI1HXN1tYao/GY7Z0d3rxwgfMXLvLmufP89NVXGY3G1FXFZDxOmhaexnsVfu32mx38mjZgM5MuLYqSGANC3D0p75mPu29YC9SI6KSZfXz22e36aTDkLmd1dR8Li4uUZQ+bBmMLqit6qhclFKr5kntPyBt84en1+/SHfUQCk1EgBAUfatuQ5UAOKpDlsDF0jI0wBvENmQwweaFeEjo2BhiicZrwcBGc1TpiEcIM1UFGlqIoKHIVukWcorV1gw9CiJAVWvzrrMViaLzHE7A2KI01BAKCy3RRUqCqhcYTGtwuwhhlaqSuWC7TUquIItEhBsQLEg3WeZyracEeVRYPtKwb0AyL957ae13grWiAYZLmS1HifaQJNaPxmPFkgjHoOZcF1lmqqsLXTYdsM6PzU9cNzhgFXsQy2R7T1DWT0Ug1aUQoM0evV5I5bS2eRic+BHrWkuc5Zb+nYE1ZUpRa9tR2gMqM6YBem2UYqwCSiR5xqf42y7FZq++iol0GZfq4EBXcyXJcmWnZk7W0ZMR28igwE/QrATUxRLxXRtJspyffeKpqjBhLf2WVI09+gP0nHmVx/8GHd2wpLolRqCYV1WSinR2MmdGqaedZRETXCmusAnbpHoCSrKV7flpAu28a0F27do26rtjaGZHnfU6cOMGhgwfTevDegq5fJfO+oa4bFobL9PoLXLt6nWeefpqVpT72yhraV97RZriEtC4ivP7GG3z9m9/gd7/8JT7/+c/xyis/4cc/ep43zp3lQx/+CCr81pZ/WiTYJKw+C+xJB4YOBoOOxeh9k+5xqyuU/jGiQYIEgsYpZC7n9p0t7tzd4MiRwxS55cLFN3nk5GMontk6jHalNvdZ/99JkJY8+OxxvdWzO5ap7HnuLNho93x//61l6b39897f4HtXEidFPtNDMSlGuPcz925c1Fpwd/rYg17/Xk1S/BKAjZ0d3njzIqOqIYrFSNSsZjqK4BtiVYEIMZUFi4j6oBgTW1G1zGwbA/iGWJQqGp9pWWyIqjvQUtixWt5hMBTGUEiFjXc4vBL47McW+fQn+xw8MMbaiPf72akOcvWmAWs5ddSRZZ5DhwKf+dQqk6bhh6/sEHYMjR0SjNWgVz9umriKgegryB1WNOFkXYZ1gRBqnT9WRTNJ8Y3I9A0M4IxFLFMmMhp8a9LBaUImlRVHCSljSzpXQanuBqarfbrXAjHiDAzLHo8/+ihPnnmMpeFQGcUiu0b4LoZ3+4+ZbjXbcShopnRnZ8TW1laX2JsDNWpzPzG1uZ9onzf3EzD3E3M/8dZ+4h11ffp52G6QZqo3oe2zI/Vkws7OiPF4wtbWFlevXmVtfZ07d+5w/sIFbly/wfXrN7h57YaKxCYxI924qejsblR5dhEkAZvtY7qox1QWI8js02aPerbaIr10tuSChN5NQZrZc21LMqx1ZFnGwsIivbJP5rKUWUi0TKR7ncSIywskRkKW4/KcLM8T06KgzvMEaqWOS8ETvMUlxodYo6imiJYYhYAYCHWNw2Iybe1trZuyltK5WpvYFUYnkZH2GkMTIsYHZjsMGZSB4qKWDindFIKLZFZHbivera3BDRjFdVvlfUGSmjdanqYVxApgxFZs2WlJFKAa4Pq6ECMmeJxMNX5iynw4l0phgiEiHZvGx6SnAxgfsbZWQAfBB2UWTaoK7z3WGry3OKslP8YYQt0kpDR29DgRCMHr+4ilnoBvaoJvVIXcGKw1ZJlTdkwCalrhYzCUvV73lRfKpslzFdKztPNFr5NgkvK7S+M11YAn5pOCUwbTLjiClqJlGTbTkjpFSnWxb5c1WtQ6xg60kFTaF2LoujppKZcylJq6VvX4fp/hgUMsHjxMf3FZwTjTju20+O6JL9pDax8WkVRyVqlD2hMUmJlpfT9rQV/T0i27OTkNsgRtAb61tc2FNy/wox//mKqqKIuCpcUlpW6+E9rjr7BJFOqqodcfsm/1IFcuX8PXFUcO7ce+chFJYGg3bpIZI4wnFV//xjd55umnOHniOF/5yh/w//4n/4Sv/+U3OHXmcVaHw+kaGtv1Ru+QiDrYmNYUEWFpaYlO66mup4FzWsA6MN4I2pwSRBxBLGsbO9y8cYdnnn2c1ZUVzp8/x+d+S7DW0NQNLs8eIvR8qCsG92Q69w76zrXfx8ye58G0u8fbHaHZM8HeP5uewu73/5nED12aavfnPFxDgvbnNoqfrj3vh+09hmihjsKVm7e5eOWaUszRcUyI1JMxYqpUXi04bBLLjwrUGy05FpPa+bbHHyF4gw8q+u/yDJu5pAEmyV9ZrKjofmZqnGyTs8bRAzt87lPH+NRHhxw8VGNMhY+LbFcnePPKkOdfvUPez7HuOEcOjun31jh92tCEVSbNbX782iZbjWEsA0RMAu/B4DAGZfRKTXQOyUot17YZ1jZI24VwRnBxV/CUNre6ZJgUZJOSXQbjVJ8Nn2lXnnQtogimo9iHbtzpuIjd+DRAjiETw5F9+/nos89x4ugxyjzXj7MGCe9sjrTJsxgj29vb7OzsaALEauJqbnM/8S6u2NxPvFeb+4m5n/gV8BMPAdTIvb+1J/I+Taz2XaR9zxnUrM2W175hPBlz5+4al69cZW1tjVs3b/HqK69y/cYNrl65ws2bN2iqmuC9omnG3DPl2pu768E2C79rg5dAlo5NM7NVlL0Dpj0Ls2sRmDJqpjWw3bPvc+2sNRRFztLSEr1eH2uTqFJ3PfR1NurmMualoqV5RZ7nhKIgL5XZkU8KnMvScaiuim8U3NBmVIZobFKlj+oPghAnk9RuG/Jer9vQa8lXe46ppbO16hCJyaEomGbSzzEGslx1b6LoHA0xUlU1IcTUlchprV9aaEJQgETLjlL7OR+JEsiyjCxzxKht7LRoTfT5ojBE4326N0lrB518KmKs5x9TqU6MgaKYMjGCKJDkvTKv6sYrLRajr09lNJJqJGOMWGOQaCAIBK2ntLTort6zThNIIPqmW3RCVWmbOREKp52YrJkBajIFarJM265b5+gPBhRlSdnrUfT6SSRZy6c6KT6b6X3CKKPGmHQoLiFiBpxlmmxKYzEqe8tmDpupDlKrPaOElGkVrQZFaW50OjyRGKbtt2PQzlW+bqirCRhLubDEyrGTLB86Sm9hQemJyN7JNzM/20W6Dbp0HrWi3zHOLrSizuAtUJp2PRGRVEbmOjHpNJrS88BYRzVpuHr5Gn/1zb9itDNiZWWF4RNDfd3PIK74ZbTMZWxvbzMYDDl85CgvfO9Fbt26zZFDB1D4M2BMmo+tEyWt99Zw8dIl/upb3+LvfeXvcObMab7whd/iL7/5bT768Rf5/Kc+pfMtSREZ9B4bo3NMmz4G6romhMBwOMCHgA+BOgXlrdOSNgBP6zo2aCmdsQQxjMYV167f4qMf/xCHDx3i+rWrVFWFMUWnP/D+WVdFrWbaOdBd1Qe8rrty0y+Z+fltrSVwy32f/d59+jsPZt/ZVZ15//tM9Xd0/F3w/X5vSMw0pkBvz/ZkwuvnznF3fUs7dbQf25ZTG9t6VzBRW41qb1BiEmLszizFAsSozMWmochzjLOJQZko4UYwYjHiMKYmMzWDfIcnTjg++7FjfOiZktWVCc4FGsmomlUuXevxwmueN646xAUKKfjEh0qOHtimKO/w2JkFan+cJl7nhTe2qOoSmT0fqxNVBV4D3lps3kBKJFhjuzOJ7ZrbJbDasvE2UptuNNtkk5Yyp/gDq+u9GMB12gdTUVpSEAxgidGoT4oRh2F5uMAzjz/JE6fPsNDrkQrCd++FH+p2t0XDGj/sDcCHw+E7fMNfTZv7iXdjcz8x+4p39f5zPzH3E7/kfuIXg5M5Q2OyWbq4xrG5scHm5iZXLl3i7JvnuXXrFlevXOH69etsrG9y984dNtfXaJrUdiwNYZvl0zn1kFdT0nO7mtRWu+a+T6Q73ml2fvfk7wSEpd3Utqc6Re86MfeoA8xlGWWvp/o0Se/EZFOBoSxlBWJQMWPd5IPpNdDopr/u9RkMhviqoRqNUms0BUm8D7o5tdoGTVteuxk2UJrwVQUhqDBaWSJitcd714YbirxHludkqeSnqWuq8YR6MqJqJp2wcAQFaqJQlA6TZTQhdOLCZVFgndPSm1RnWMeGndGEYXIsQSL1eESRF6o1k6cOPDOTxWC1lVq61j7U6XGlo02qqkNaXSpFwhhiEzsKbBCh9g1N3TDa2aGqGxqvx1pXdQJ2cvJEHXTOkpdlAmsivqpV6DfPmLa1Fl1k032Tpkac7WovjQFnDb3CKUsmy7BOwZp2rOh4UKHoPC8xzqXPV1Exm2Xafa7tNGZtgmna2lw7O1jTIj/jeIx20SLT52YJABSJSPAJPJ3CqRrUxC6giUjSqAkJjdMWgD5UVLV+1XXDyvGTrD7yKIef+ACDxSVFux9ybgp0ZU8+BsajHSajHUJo9mCmHRy7mwo5w16LsUXNZxy5Yaq7N30RbYbtjdd+yvrdNc6dPcvvf+UPOHP6NCdOnHio4/9Vt8wN2Nrepl9kHD1ylG9sNly4cJOF/gLLvR6jsVWBdtQhdYA8qr8Vqshf//Xf8MEPPcvpM4/y+d/6bc6evcA3/vzrPPvEk+zfv49IjcWQ4chcjpUMsBgnSAiMtzdweBaHfZrgaQQmXsNzTbaYNAWUGo9ADEXHvooxUMXIm1evIiZy9NAq587/FD8ZM1wY4l3s3qOFgFtxOzWzaxy2Gdm2XeP9bJd3ETvzvHRtZl5ndmU3hdgN1tQFAtsF8CIpMAEwCkjOtERAporiM0e/54B2nctsDTd75tvb2+5yX7P7vdNndUDs7lemD9T30Ks/9YctuNo9T2x3bPdz+/foNXQ/TPUL3u48Hvi3JGoIypZsOxT6GKh9YC11k6urGhNyZS4a022H2i8tkyYB5CmATAL6QgMu6H0Wh4iu+7auiFmGzXNsWWJ8gw0eZwQkYGgo7RarCzs8edLxuU8e4JknSga9DWwRaBiy3RzmzeuLPP/6mNcvNty67fGNkI23GA769MsVDi57ekXDU6dLfL1E3VzkJ29eo/JLiFmiDtpCVQmYFongvcdVYzIsmbXK2nWWJhod00Yp+hil+DtBM8Yhoq1UjSaDDHiJ1KEmcyXWWRW3jxaLU0apGHAOosHaEsETYkOkAQm4aAkSCdGAyzly4jgf+PAzHDi8TFaCsYJBy2Ux04YA94yN5Lfbe9Yye0HPd2trm9F4nNY8w9LC0tuOrV8Hm/sJmPuJB9vcT8z9xNxP3N/eBVCjK5ZpZ83ePz3IpkhF+pYWC6ZiPjFGdjY32R6NuHbtOjduXGft7hrXr17j6rVrbGxscPfOXTY2NqkmE8ajUVf+oAQcmzbgb3XkD/hDTHV6kr63z+wAn+mPu+Zu++PMTZoCMy2Vqn3x7ILaPbt7qzzP6Q8G5EWh4ktGkcXpmqULrTExle4UCqbmJVlRkvmGouxRFiV5nuOcm+nI1C7SSjeTbC941KJ96V7FgDQ1kYhYR8Sqdg1mN04vSdDXJ40Sr0AXxpDlBYhRtotziHFEjG7qRbs7ZaJkFEkTL6ROQb5ulNWRmDaN91pvGIJq4qBoceZcOg8FQoJXJFTFtUgMCoMPTcducpnqtAhgne0cRJOyK3VdM6lq1c4Jgbr2WrKUblTb9rrMc62PFCGmkibbFpO29ywxQgzSlRiZGNMiGsnzrPsq8ows/WxTW3EwSTQ4J88LsiLHJqS4Zb04l6mjTWVSxrZOyiRmYzt69FoKqDbPzJw0zmlNawJ7Oqe5J6qYZYspXiNJ7Dl2192n6xZS/XcUwfUGLB95hOXDxxgu78MmMenZidStCMbsmX4zld8CMUQm4zFVNaGlKpo08duObe37TYM9mC2lNIkmORsQiBGmdappnUvOv2ka1u6uEULgm9/4BteuXuXMmTM8ceYxft0tcyXjnRuMS8eBg4cRk3P58k2eeeIMg7IPO00KoBTo1VhQgxRrLDE03Lq9xl/85TdZWllh/8oKf/8rf5d/9S//FX/5l9/g97/yd+j3Sw07RUFtm6ZQy27c2FjDOcfiwmICaiOTqkkuPOVO0jootAtOO0809PMiXL52jdFozMryIvVkTFNXiXUVNNaV6Sp+T7C4y/HsDph3+YfZv+3Kcs4G67NB4XQ8tr/pPJyOVekclKE7PaM/xO5vsvcj3gW7/d5M0sNmJ7WGm25NnHGt3deuS8N0iWhPzbarRPJru0skuO/Pux+cff473Ek8wHZtw9KtMgZ8DNqxI0YuX77G1WvXu1JsM93GpdfpIra3PFpQvTFrHVhlj1prMDF5MFGWpw+RvLC4vKAse8RqGxcbMjOh1x9xdJ/no8+u8pEPDDh1wlD0dgBPwyJb40Ocv76P51+NnL1suHl3xMb6OrEJXAkLvPzqKgvlIvkTB1no36I3mPDME0OCnETMHc6e3WFn0qPBElH2q0iGCDReYDLBmIysKHFW6eg+eIjqg8S2PrKNLfVeRXW2SOsPpF2zVasvK0pl+0rApfhGAigJNCLREI2W40bfICHiosXhWFpe4tlnn+bRR08wGPbBtncjzbsZ1sKs9sCDYsg2EG/qmo3NDbxXdojFsLq88r6Ms192m/uJ9re5n3jLV879xNxPzP3ELnsboGbPUmNSvVw6wCnlKN4fAHnQO5qkDQGpG1IS9QqeW3fucPXadb73vb/hwvkL3L1zl7W7a2xtblBNKsaTibI72oUwbZxnCQKzoMqDzmj2gRbVbjeick9qfeYymHbD116SB6Gsu2/VW10fSRvCPM87No1NG2eDlh51wFZCFoUcEwUTIWQFLi/J8oa86CUxX23TLCYkx5NEZMWkTlTCbDcwY2bPRSmfsam0u5Kx2gbcOTAunZ0CD8Som3KflMaDaoYYZyiKXifenGV5Rx0NMUKaJAHwAk5AYqTxDU1d00yqVOqUYZ0jBG3J3YQkYJucmrOqfh5FKXRVVRH8TNtmm8ATmYIJLrh0BmkRTgtf7T1VXVPXNU3dJL0VBRtAQR2TmCx5llOWpbaY80k0uBWYus8gM+kTLcmJS8QQyZ2lzKednfIsoyiKDnRxzlEUhbZfz1WLyJikHZTuibMuJUzS/bOJjZMAws7fGpecUETLUaUbqdZZbPteIUzBuI5F1TJpZhxEev8OrEn3yAevXzHgmwaw5P0hS0ceYfHAUfqLyx2oOuO6ds+SXQHLjHMWBWqqyYS6qmac1cwcuc+COVvy1Cq7gzqzjhlkNSMxXRRS6aRJNaU722xtb7Ez2uHq1atcv36d//0/+q8eMKt/fcwYi/eR9Y1Nllf2MVxY4ur1G5w+dZL+YIi5sz5TKm7QrKB+BW0URvSR7//geT7wgQ+w/JEPc+rEI/z2Fz7Pn37jL3j6uaf5wDNP46y2bYw4QmrlaoxDJHDt5h3y/oDecIgxhrqaUE8mqRZ56hC0jFX7eEjnNvW4YoTbt+8yHo1ZWlyirmpGoxEH2sDo/bxobUQ5vYoPzKpO47H2by0teOa5s4G8gC6w0NZtd5nW93gSe7Hb983usxlof+9w2717HPYE0XKfJ0z/2IG5D2P3y4o+OGCfWasMGJKvAcQKk/GYs2fPs7M9BvIk9GgTsy+kZMQ0WTW7fmEMPkY0g+e0y6g1SYdAae9ewPqGLJQUDrLC0zQb5HaHfYuBZx5b4GMfOsSZUw3Li5vgKiY4gltia3SCC5eXeOlV4Y3zhuu3I+tb2zT1XZyp2Nga8+b5jH42JM/6PPXEKgvlbZYWhA89voz4jDxc59ULGwS3SBVdypKGrptjIxPE5vSM+s7MOKIxNDGt1aAMU6NJHGNTssHkYKz6QgwmRhWaTCKRlAaXOUJs0gI+ZTDXoSKEGh9rQmiUfRw0wZg7x5OPnuIjTz/DoZVVMixW0EC/3UHRzpv73PPZITfzPQKj0Yhbt24nv6cx3b59+x5qzP2q29xPvAub+4ndNvcTcz/xa+gn3hKoOX782M9iqr2lPX7mDAD/1T/8Bz/vj57b3Ob2czaz64d7AxADuOR+en2g7zi0ssD/8//xf/85HuXc3spCgLI3ZH3zNtZm7D94hKsX3+DuxiZLS8vkbgNCYs7N3GMj2gXOZgVBPNs7E776tT/l5PFjFIcP8clPfpRLt67wv/zh/8p/e+j/wtEjxzRBYJxqWqEU1aquuHbzFmV/oNkTZxjtbFFNJiCmc8oSY2KOC1qX3QbhABZrMra3R6yvb5LnOQKMJ2MNEuzsuLx/oPeWlOf7/q2DUDtAtN0QTOna7ev3vs4+4G+7X4fIlOV3/yPrEhu70jJd8PvW53mvMONMe8wHBqxyT6zcZsBmg/DuKXtOae97y1sG3tPjmr7ru7O3Pq8W/NUAupEIztF4z7UbNzl79jzWOIKoFp3LHFE0EaDjM95zTm3SJJhAqBsIhsw4zZSaCNZjTMRSY+uGPKvoFYGiWGe4sMHJYyVPPb7K46d6HN5fUWS3IG9oWGQcjrK2ucJr5wa8cTZw6aLnxq0Jaxt3aZotyhwGZY+mgZt3N3Bv9hG3gMv7PH58Hyu9LYa9ER9+2lIUB7F/vcbrFyesjfo0odTA24p2yxHTsS0z5yicgyzHNEIQi8msCucBEh1WYprjWUpKJJZniGl8GIKJytIlwxBpqgrfNCpOGSHEmiiNln5YLTOI0WOc4fixI3zyQx/i0aPHKF2GY8/mOiUj2rG9d4x3e900Ztu0XgiB7Z0d1tfX8d4joi1X9+2fAzUw9xPdo3M/wdxPzP3E3E88vJ/4xdComdvc5ja3uf1SmkRDrz/k7ptnWVkdsP/gIV595SfcvrvB8soyhU1BXrT4RM+1Bq3hRXWHYupS8Ob5i3zrO9/hP/+D36e30Od3f/fL/NN/9s/54z/+E/7Rf/mPWFpYUmZa6sbhgKYac+vWDZaWlih6JSEEmqbGNzXQUn81E2KMaNUhQJstTW1dI4bJuGFzc5vV5R4GqCZVYiSqgHsrJG7eYSB3bwA+y8RsHXwbxIFIoAuyZ9pJwu5NTHoC9wos7abRmxTJ7j0KDbal+3mvVuVbbSqAxFykY/PNBsN7X2vaj5qJhdu2pB21e+a8bMr63u+47rX2+t3fzH3O6a0o7bPsvPZ3mQnM9p5XJ4Yu0mk7BIGqCZw7d5GN9W1E2oAOXGYpbclkErtyzfb9Z8tLMWCsR2JNJhbTeJyBzAlYT+YaenZCYSyHhgscP9bj+LEeJ473OHQQVlcjebGGMxMEaPw+tupHuLZ2lNfPW356ecz1GzvcvH2Xjc27hDDCmAZHn8ItEcOImm1ublzFXjhAZvZjqlUeP5mz2L/OwsKIJx4rCe4AWb7Ja2/WbOzkBDugseANSbND2bEtbT3LcmxpEWMhN6ojMMPSDSJYVyhTNaXnrXWIDySyO943NM2EppkQg9cvH5UUaaPS1KPB4rocwGBQ8oGnHufJM6cY9oqkh6CsY0kDdO+4veeeCylTrdpu1hiCCD4Etra2WF9fT3p40Ov1GA7mYsIw9xMPdY3mfmLuJ+Z+Yu4n9tgcqJnb3OY2t7m9axOTUeQ9JnXD1vaY5dUD+Ag376xx6tRJFocFt9a2EcmSeFtAxGAkdA7ZiUrCCZZvfeev+cAzT/PBZ59maWmJv/v7f8D/9D/9zxzcd4C/95WvkBc5zjTE4HHWsL12i/U7N3nm2Q8w6PdwzjAZj/BNpR04jAZg+knqNCXV5Wvg2pZzOpqmYWtziwP7FgCom1pfa7uo/UGJ0nvs7WrbZSaiVH+dBBVMG/RFpu1UWxHI9BozezD3SSV2x0Cis0v3ui47LJqtnh7ETJb0gYf+4ID8bWL16Zs+6P3lAR/bBsFv+/b371DycC9+e3vLzcjMtdOrbfDBsLlZc/bcJepKN1TGTIXXrc1wLgea7v33jhlBMEEobSCXLYa9imHWUBaeQd+xtJhzYNlw+PACJ0/t5/DhkoXFil5vTJaNsbnggZoVJs0yG1v7ePNyyfmLwuXrnitr69xZu87O9h2i3yKzDY4eZb6fIt9P7T2RNcbVFrfvCuekRxYzmlDy2JmDrC7eZbgQeeYxS2lXWOpVvPJGZLu2jE2Jtw4tk8+ZHbtGDMYknTJnU+0/WCLiIyZEmhghxkSPF2Iqo9YxbSF4xDeIr0E8VlRbULvAStrA6Q7PAEWecfrEMT703FMcPrSPLFf9P3F2OqofsDnblSm1dHPIgmobWENVV9y6fZu19TWCV0274XDI0vJcTBjmfuJBNvcT9xzN9C3mfmLuJ+Z+Yg7UzG1uc5vb3N69BR/JsoLhcJGd0Tr79h+g1x9wd32d448cY3mxx92NTYIIwagD1WrilqIqxLb7QYjcurvB//YnX+Pw0SMcP3SQx888xh/87b/Df/gPf8zhfSt87vO/qQzY2DDe3uHKm68x2V7n0IF9tDm39c0NQvAIHhNbB2pTyixlrEid/QQwVqmwSUPBmOOISGozn+rB38M1uteh63nrscwEptOHd5uQHpzqK90TfO/SF9ibSW3/PiMiL9OPfB/i0/fHZmPcvafwtgcpu1Oi7+Uw9tD2H/JViGiWT0xG0xguXLzBpUs38T6iZROOJmqr1LxwKkAqYRd1etdnY8goyZiwb7HhNz64n9PHHINym+HQsLRYsLDgGAwdRW8bm69jbEDQzpmN7zOJy2yMV7h0s8f5K3DpyoT1u1tsbmxzZ/MG48k21tdkAiYYnNWOjYtLQ6JZZDy5S9NUVONNbso1ImPGdoUdM+SZRwtWhmsMiw2ePA4Ds0i/8Lx6cczNHcvYZ0SZandEm65T9zOIRAipS44I0gSi9yqw6T2SNiwhqNisc4bM5pgYMbHBxAaJHgM4o3p1yn5wysaQiBXDwdUVPvj04zx64ij9hR5YS0zaDcYY7TyJsiAeNNuFVtpNZqarPnc0GnHx0kW2trYAsNayurrK4sLiQ46fX22b+4m3t7mfeEib+4m5n/g18hNzoGZuc5vb3Ob2rs0HT2YtK8ur3Lh5hX5/yIGDh7l25QJ1U7Oysoi9ch1EiAQQzU9qZqOlMQstZ9m6jNdee4M/+/Ov81/+/b9Hf7HHJz/xcdbv3ORf/A//FMeE48cPUU9GmKbBVyNOnzjOsNdnMppQ9i1ra2uajULQrpUzvQJSBxAI6myTMFzwEcmFyXhCjIKxliIvuCdP1/64N3G2x2fvacrapmqnf5PZF85mQQ1aw36fzxFJ2c42H6dfUzX9afAw+y+0meG2fSkPTG12e4MH2IPj0XZDsfvFe58/jaV3/8Hc96/to2+bhn3P9nZU93t1FtoXtq9Pd0AA45iMK15/7SwbGyMMjhAjWW5T62GDdQ7rcg3ag++C8LYdq94pg0Pr9Q+u5nz644c5dWSDXi44NwY3ggxcBt4IwTiEBQKL1HWfze0+V28VnL9Wc+F64M6WY2N9g+31a/jxbTwBG8FEi5WCGCw2z1kc5hw9OqAsVxhvr7FTR4xExtUtrt7eorKRcWPwdcEzpxY4tjxicbDDmZMF5APIR0xeq6kriw/QRIfHpaknCAFDBhiitt/QbGcUpPZ47wkx0IRGae1pc6PzxmJzFaM3KdtvRKbSqSJaPoDTTT5Cryx59NRJnn3maVaWFzHOECQixqbrnWbOfe7vA3VDzHRchhDZ3Nzk6tWrjEdjEO1IeWDffvq93jsbiL+iNvcTex7v/jz3E/d7/txPzP3E3E+ozYGauc1tbnOb27s2mws+NqyurkKEwpWcPnWGN8/+lI31TVaWVynzIZOxCrtFooa+xmK6wFNdoA2RLFqMh+/91Q948tQTfO6zn6IsDL/zt77AzZvn+d5ff4v805+iV5aEGJlMAv/4H/+3VHXk9Zd/yv6D+7l29TISI844goQpzdUI1qTOANLSX5UKqwEWND6wszNCiAwXBxiXAiIDVvntGFLrV0yXoZyNp6XNwuoV6k5R0pcxsWsbK21mUxwtdd2InQmqU9CirdrSpWrbzLMnjm0fT4GFBCQKbTcPgzKItVNe2znCdu/xcIHuvQGq3He3cO9zp+9v2v+779pv0eBsGxC125LpSb6zLhsPOPoHPH9Xt7gHBNv3Fc1M2yCDxWBxJhLEc+f2dc6f+ymOoNlCDNFHMI4olqqJ9HolznmCb5AY06hJVykl9k30GOOxWUWZrbPYW8O5NaLp4e0AMExiQcUi47jEzmSJuxuOm7cqrt4y3LjrWN+csL0zYnt7m9HGGtRbmFinTnieIBXYEkNJrxhw6vAKzz6+wvW7jju3LjEZF4g0RJnQVDW3rjtCEwhhBV/vJ5zucfTAZfoLtzl9YkLfLlOEyPdeXePahrDtB1SxBGPJiThpiDYnBiHEhhgDMdQYIhI8weu4nW7MzXS/aFAxSAw+QhSnG2nRbpJEg1hLExoyZzASWd23ygc/9ByHjx0j75XEVqci6N2b6qi+taqIADZqStUYkDRWG99w4+ZNbl6/gYuKMPRdyeH9hylt+Zbj8dfF5n5i7ifmfmLuJ+Z+4p37iTlQM7e5zW1uc3vXZqzDYiiKHr1yQFPXHDt2grLsc/fOGiePH+bg/mW2r9xS55bE1WIKWVrfZ9BOB4gGXXfX1vj3//6PeeT4UR47c4KiLPkH//B/x8U3z3Hy5GPsP3AAW2Rcu3Kd1X2HyVzJcHiVy1cuceGNN8mMIaSMU5SIsU4Dz6hZKQ38zDRDa8EZQ5nnhKbBGEuvNwBS8N556ZRxtNPf0kFPr8kuAUibkpSGGE33fvqyaZbU7Hq3lLWZ0RgwKUOqopVm5m90zwHuo2mwO3BtW3tORQ+nNPeHsbcTjrz3mB6UWp6aMTPHuufVu5/3zoLth7WHCbYfmEGFlGGLXfA8qWp++tOz3Flbx6eAbJrfBmPNtMWqTYKh6b6GGKabk7QtAd0wBYJKZdiCRha5s7nCqDnEyOdsji13Ng237kbW1hvWNxq2dmp2JhN2RmOqaoL3FbEek4nW8UuU1AE5J2Ap85LV5QEnjgw5c6zPwlC4cmGJne0xm6OAxBxjIk09Ye3uTYKM8JMJk9Eizz6xn0eOlCyUDUeONnzC5XjjmDy/xeaWp/GW6IRgSpz0ESY0YULwDUYjZ6JvgCSaGWavu00b2HStbESsS+KMmg1t2yuLCDEIzggmCmVueeqx0zzx2BlWlpfJnU0yk9NNKTK9v3s76ey9123qv2U7iIGd0YjLly9z584dQtRxMBgOOXDwAMbNw2yY+4m5n3jLZzP3E3M/MfcT97e5B5nb3OY2t7m9exOLMZY8g0MHj3L96gWOHjnOqZOnuXXtAr6ecOrEQa7fusa4CQRTELAqtiZ740hDRNsuGmO5euMa/+bf/Rv+z//4/8S+lQUWhiv89m//LmXZB2Bcb3Ho8FGyvI9vIr2y5LOf/iw3rl0nRsvl6zdY39jEWodxjibE5EVtqodug99EiZVAkWf4pqHX69Pr9Qk+JgdtOwcvZnrgZk92RUwbTKuugDL3rf4sBokzWUJ9WvtKOsc/Q1FnJti2hpQJbWvUZ7t4pGOS2SC8DbJnnjUTfLe//6wC2/di70dW9OdjScdCInpHHLfW1nn59bOMa82MYiLWWK1bb697jMQYMNZirE4Ga01Xq69JeB2fQSCKoYlCdBnCkI2dBV46azl7wzCuha3xhNE4UjeWnZ3AaKeimqzj6w18DJpJNIKzEeJM7Xy0iCmwWY/FhQWOHV3ixNGSfQtjMgenH1nk2o0NRjU0McOYgJGGut5hbb2hqTyTOjKq9jOeHOXM8W0WB9c5enSL34g9djZzttY3GW1XBOto7Are9MBUNH6E942OawREy0yMscQgXcYftOtPu1l2zmmW0hrtBCRxupE0eo2dQG7hxOHDPPf0Uxw9cJDCZmnGv7ciCUn/RASJkfWNDc5fOM/2aEd1KQ0s79/H4spyp7Hwa29zPzH3Ez8Dm/uJuZ/4VfcTc6BmbnOb29zm9q5NRJ2ktXD40FFu3bjG0tIiH/nIx/n3F8+yubnOE089zvkLP+XqzS0aKcAYPHTOsqOSGs28RjQAm9QVP37hRf78P/4F//nf/Qr9/pCNjRFLKyXbOzusb97m+PHjWJshocJYw+bmFl/84pf44pd/jz/64//An3z1qwyGQ5b37ePS5StcvnI1ZZ8M1tpOoM4iZM5R5gU7OyOGg0XKckBMrWKnOV2lzxrTBsea5mup6V2MJSDakCC9VoPwLjtq2sBXwGimqH1/MxuM07Y2pUvrSGrzKbMBePuZ0h7SNAN6P9HD2WD2Xr2A+we67zUonuan0GuWHnhQMLT3uB/2OH9epuKh6X6l4LkJcOnKdS5dvYEXixGDsxam2zKsiYQoSGwo+z0wPeJkQgghPUf3UkrVBjGWEDOaaAkmw7mShn3c3vS8cb1ie6emqibUVUVTV1STCTFGXPTga30/Y8Dq5i0AWKeshWjIsz7Ly8ucOLrMk4/t58SxIQu9QJZnnD6xj0vXt6nCDnc3xvhmhKZ+I3UduBM2qIxla+JYX1+gGmc88/gKC+VNThwzfP5Tq+xsjxj94A5r9ZDK1EgxJsYJwVfE4NOADXqdDMTguzGuqeHQjWcjYGLAiKVLoqaNMRZttSrgiCz2+zzzxGM8dfo0w16Z5qlNeiP33ssH3eN7HkvDToDReMyNGze4cPEio/EYMZCXBUeOHmVhafE9Bfq/Sjb3E3M/8bA29xNzPzH3E1ObAzVzm9vc5ja3d28dJdyxsrrKgQMHybLABz/4Ib733W9w7eZtPvPZj/ORDz3J+te/z7jRjEcgYI0GJq2rnQ07MRCNofaer33tT3numQ/w4eeeI0bY2B6xuLzCzTu3uXN3g16vR1HkHDvxCGXZ10wL8JW//xVOPnqSffsPcOToUf7ZP/sfuHH9Go2PWGvJnCPGgDNGv6yjKPtsbm2yunqAfm9IjF1yC8y0Ej4i6fg1i5UUDNCElNEYRdrXzmZBd1++NoaUFFyb7n2nAbjMvD5K3P0G3QWbpmTu1QKYhr7vjJK+91jfQ8BrZrYwMtsNQb86Ur/c/zh/YTO6UTS7bzN8FLZGE1796ZuMJg0GR5blED0++PQKg4i2E/V1hZQ5WZbhnMOndp0tzVoQggQyHFVt2RlFgliMcWTlkLwURuNNbt68RWjGSKiRWIPU6KsNxrqOjWBE55slQ5zBWMMgL1ldXuGRo6s8dmKRpx8/xNJiSV5YrCk5cbzgA+sN4/Flom/Y2NIyDa37N/g44e72TcaVZ7KzjK/6NPWQJ08f5sCK59jxhs9/epXJqOb5Vxpu1zXRbNA0DcF7pM3mC8QYphfWKJtB08utpoaO4xA8ztpEY48zQpOpa4oImbM8cvQwH3jyMfavLJFZA9amDfKDg20R0Y35A/7WTtiYru/OaMT5ixe4ev2ankuMDAdDjh49QlmUPHh7+Wtmcz8x9xMP9+K5nwDmfmLuJ1qbAzVzm9vc5ja3d21CwBiLNYa8yDl69DDr6zc5duwkn/3cF/h3/+5/5s7du3z2U5/glRfe4Mq1hmgMwWhbU2OyPe83zUQYgbrxNN5z+dIlPvnRj2DzAskyyCwnH32MosywNukWWEuIQktZX15dYWllmZdffokfPf88Z994A3wkE0Ai0lQUNifPLKGOGGNxeZ/rly6y/8CjOJfha32/2eC7FXOUlP2MoqJ1+pgGZW1LWdMF1oFd0beZzX7GaXb0HuVHCxLUjbeBa8fdNdPntG+6Kx+p3819MkOz9o6yne9nENyexn3e+xcx2J61XWUBGLyPBJNx/eYd3jj3JnXtcU4FRUPXiSIlBWPqJCOeuqkpej2MszPbpZnNioFITuNzxmMNfq0NZC7Q75cU1kETkDpoVwvRwFicIEZLRKwRjKjegbUFZTmg6A0oeiUHVpd54pEDPP7IkBNHM/avlmRFH8mWwBYsLu/w1GM1sakoLZy73LC24wmpVMNgCLFmPFnnThN46VzJqArsjFf4yLPL7F/d4fEnLMH3qJrrvPjmiI0QsLiZjLDddc7GSDekJbVNjnE6hq2xmKgBt5UkEJm2qW32dDjs8dRTj3Pq1CMUvQzjlHMgxkDUOfIgtsBbbVKNgWg1a9/4htu3b/Paa6+xsbGpGiUYVpdXOHTgILlz+Lp5t0PsV8rmfmLuJ961zf3E3E/8GvuJOVAzt7nNbW5ze9dmbeoWYUCI7D+wj/F4jcGgx3/2xb/Fiy+9wEsvv8pnPvFhPvepT/Nv/923aZqIy1tiees61Tl2dFGjVOBeWfClL32Z3/rCbzFcWiArS0yRE8Tgij4xNEQTCUTquqKqAzdv3+Xq5cu88fqr/PV3vsu5n56lqRqMwLAsybIcY4XDhw/z2JnHObhvH1/96h8hTPBYbq1t8oEPn0IEYog4W6QgIQXUAprxUkqwpM4eIhpEmZQibXUCunzgrg4dGoErVXtKZ0dmRCTbR+V+waiZ+bIzu5bdmdSW3r77sV+w4HY2oftLYPdkc60jCkzqwKtvnOP2nTWsNUiIBGmmt6YTIkxCiDFSNzW2yHHO4Zwj+Daj2qU3EbE0tWO0E0As1tTk+YThwFGWHmsriBNA9QXEGsRlRAMStYWvA6xxquthc1zWZ7C0wtFjh3nyzH6eOm5YHGxR9ITgFgnuCB6DyyOHDvTJnjpE6XKK3oDXr97l5voGvm6IoSAzDiRSs8PauKG5Koyqhirs4xMfLDi8Gnj8MctnRwfZqK7xxhWojcWnspA2+N69Twyp40xM43+6uTSiApCg323amBpUnyPLHCdOnuCJJx9neWWRzBkwuhGKbeD/EPd39p61FhO1PkZhe3ubC5cucvbcOeqmBoHMOg4dOMjq4jIEgSbsfftfS5v7ibmfeM829xNzP8Gvn5+YAzVzm9vc5ja3d23WTeuqwZLnBfsPHCBEz4mTJ/jyl3+ff/Uv/zsuXr7B53/70/zoJ6/x6pu3VHCuy+rp66fZIQOiLVCLzHH68cd49InHcRaiETyRJkSMj4xHO9xZu835C2/yxtk3ePXV17l06SrbW5uMNjeQECjygpWlRZYXl/jsZz7DY489RhMb6qbm9Kkz9Msef/P977C9dYfxqKKeeB49dZrYRCRa8jxPrWIj0nZtEJuCZfWzRlIGzJiU/TEpojDdBqUNwrVTh2aIdOfSbkHa3Ufs4q8pnX130NdmYNtnTV8wbbMKqlMwG0O8k+D7foH721Hi3/L9DXTCDOn3LjumO7hdzzUzYdL9ZP3ez43FO80WtxR7vZUOiZE7d9d59fWfUjc1xmRE8cRgEZsEImciTIu+R6w9LguURUHmAqHRun5QFoJYfU2IhtGOxdcFDMZkWcXCoE8vbyhyock8xIYo0xILHYsOkUgUtM0qUI0nNE2klglLPcOd5YKthYJBEcB4rLMEUyAmIy8KCgPZgZzMPUI2PAKD23DpKmvrG4x3xsRmgsRaxSOjZ2070NQekQpjl/mN55ZZHWY8/UzB9TW4tX6b8ZbFO5MEK00aF7qBMEYp43oN0vWyusHtgvDUqwe0S461NgXxwuryAs8+8yQnHjlGr9cHS6dnoq9Ve9BYnv17uzpNxVV1LIYQ2Njc5OzZc9y8eZPoVR+h7A04fvQ4S4vLukF/6FH1q21zPzH3E3uf8+A/MvcTyeZ+Yu4n5kDN3OY2t7nN7V2bycGIxYpVYqqxrCzvY33jBs5lfP7z/xkvPv9D/uzPv8v/9f/2f+AzX3yWN/7HP8GO9mOCIKZh6qYMBovgEMDlDmMtO5MxXiLRGCaTijvrG1y8dJlXX3mdl3/yElcvX+LundvU4wpnHP1eH+c9H3rsGayzbG5v8H/8b/4bqmrMZ37z02xsbrByYJU//49/wX//z/8po+0xl65e4/jR/dy4doN9S/vYv7KfpvK4bKBBltVgWyTo79F0wXeM2lFAWz1GsJqRwtC1ZwUQm7KtSalAJEI0xEQP7p4ngdlodC/ddrY2uhOsnD6y5w5NNzjdPXuXger96v8f/r2kTTDrPmTPxuued5Hun5kPe2fH+7D2bq5H95o0FsQbLl28wtWrNxBjkRixVrdYIe002pDR2hQRRiHESDPxlFmPzBXUpkmBn2YJnbFgG4KB9U2YTIYsyDaGikEpDHJL7voIFc55jLfYWOClwkSwwXXjV69n0Dr/umFn7Q7nRltUt3bYvH2Qj3xkgeMnHMPhDs5t4mwPqAhUBOOxRY/+YMDS4jKLizWTWCJyh2bkkaoiBp2jPlRsNcL5ayMwW+Sm4CNPrTJcaP7/7P3ZlyxXdt4J/s45ZuZjRLjHHHfGjARyQiLngZnMgWQmmZxEqVpTrVKvpaVSda/Vf0K/90M/VPXqrq5SU5RUqiWVVEWKSVIiiUQiE0DOmZiBe3Fx5znm8PDJzM45ux+OuYfHnXBxAeQE+wC/HuFubuPx2N+2b59vc/SYZeHVXTYHjtxGeIoWtDhECUr5osWxKpJHYdQxSEThveDF4ZUK59lEiCv+coinGhseOnqER+6/h+lmE2XiMKVgNObEjRMnuJGEaxVMJkUkJE2jFHhEwBHEKwaDAWfPnuX48dcY9HpoH0rtZ1vzLC0dJE6qeCfYsqAGKONEGSfKOFHGiTJO3E2cKG/UlChRokSJu0ZkQrDUPhBwozVaQaM+w2CYMTs/yx/9vf+K/+f/4//ON594hi//xq/z6ssX+f4PT2FdjENPSqRFgbYgXpDcIRhOvf4Gzz79LGtr1zhz9hyvv3GKa6vX2N3dBS94a/HWUatU+NpXf4uPf/RjbG1uUUkqrBxc4f/7P/2PHD12lK3tTaJKhaRWxzo4f/EyP33+BZyVQJ6N4fTZc3z2058kSar0h45KHMi096oIwhHiPfhCJR2pNfjQESQqzOzGnC4QbcGjXKF6FUqoFIz0esEmEPBbY0+le3O9/melHt7B2kBGiUOhll6n4v4yQqlg3DlIB7x+8nV2O7uIigJpLBJKxajsOnQwUT6Mby2CVgohw0uOiTRaa6wQFESlsYU6aEXT6WYMUkAMkXbUa4rpmTpJ0gseHmJQotCiME6hTBjXQYQWxNvinAtaGUQ0vUGPC9l5PNtkapbH1TGOHnTUa1uYJMb6Lr2BsLpuOX3uCmcvZly4usvqVodemmEHuyiXorBoFVLnUPKd0R8K5y91+TFQ1Ud4+H2z1JvTtNpdoiu7mDyQbe9D2XpQk10g4CNVUsI4GX2htA5Jfji/GiUaoxVKPPiclaVFHn3kYZaXl4njeHSVGCVzdzzc9vKrGx7WWra2t3jltde4cPEi1jq0Cin00tISc3NzxffT3dF39L2AMk6UceIO11bGiTJOlHFiAuWNmhIlSpQocdeI4jDvXYsCMWgVAmpjqs3Wzga9QZ+HHnmE3/+D/4o/+9//F+6/9yG+/ltf5cLZP+bslS5e1ZjUyjSgvWc8Pzt3PPOtb/Oj7z5LlmUIMEhzFhbm+fxnPsXK8gpvnDjJT3/yEx593/v4u3/nDzhz+g0Ey8b2Lh/5xOMsH1jh8rUrzC/Ms765gfOe/9+/+td85+lncKJQkUFwrG1t0WgkPPT+D+KVCeqSMgQzSL3nM+AIc7oLY0pU8CjY6XZoz0yhvA9K6XiO+kgZHSlgRbNOCeRdblAFr/cPUGMyPDnv/U47XPxieA2E1KqQnYqXJsvYZV/J9w3ERY3/+YWCAFYcl65e4czZsxhtsN4QOtaMxnQg37o4Jq100SIUMAIqx/mUOKoSxRGeMLaUAmUiojgmNjGZT+kPwDmNUZZGxdGaialUDIoYkTDmlC9MU51Di8NEoVuN94IrlEYnHoUB5ej7Luc3c7ITjiieoRJPcfSgJzKONLNcvNbnhROrnDzd4crVLt3ekMFwEDqUuIwYixFXqJqB7OYIgmEwVJy7uEurfpXWQg0xdSq1hCg2mDh4dyivkSJ5gNBOVUmYjjEa596HUndVjIOgoqoigQkeKFP1Kg8/dC/333cvzWaz+Jx/0/F/Q+cY9hofj8raZfwfDNIhFy5c4I03TtLr9jBagRNq1SoHDxxgamoKEcE5T56XZsJQxokyTtwpyjhRxokyTkyivFFTokSJEiXuGiNyqAtFRzxoHYE21GpT9PpdqnHCF774G5w+eZK/+PMn+G/+m7/PV774af7dn30T23eIMkVZtyqIN8S6mGOsoFaJqdWq3HfPPZw+fQa84ou/9nn+/j/8Q/Is5+WDhzh5/AT1WpVqrcJ3n32a8xcvcujIPWxtb/L13/06U9NNOru7vPDSi8zNz/HUt79DtzdAUDjviYxiu9Pj8LH7WVo+TJaDiWuIMkUQVjgH3obOCBRtA7Qx9NMhL730Aj/+0ff42OOP8dHHPkISF47/eY4u/AiQENSLQx0Tb5ERsQgYJR+j8xtek5sS8cn3bnV9boU9H4NbL3Orjgd3h+u2IxQHPtmlZG+7+7d3exL1s0oyRvuktcZ7jxMYWscbp8+wub0TTBgLgggatEKwgRRDUc4fSLhTDi8WJRof6rKJ4jh4bygwkcHEFYzJiXVOLrvsdBXOxcRmSDUe0p5pUK9ERDrG+QitLEqHEm8vHq0cRw4cYrbdIk0ztju7rG1u0RvmeDGgBTGOgXNcXc94+bVV2lMxs60ltBY6HcfJc9u88sYml64N6Gx3waZoscRi0VrAO8AHTw1UUGsVeA9WDL2h4dr6kE7X05jWRJEmigzGhCkhwRNBgjosCq3BhXYhjExWtZYxGQcKlTSUqceRxojl0IFFHn34fpYWF4JfiHM3HRd7PgJyE/IdRqMfl7AXLVYluI4479nZ7XDyjTe4cOEiw8EArRQGxfzcPAcPHqRarYax4cqKmhHKOFHGiTtHGSfKOFHGiRHKGzUlSpQoUeKuoYO2uUcgdfhHECrVJsM0ZWNzm4X5Nn/n7/0j/qf/8X/gz7/xX/j6736R46cu8b0fnyB1go4ScuvRSlGvVZifbbGztcWj738fX/nNr7C5vcGnPvlp/uSP/xXPPv1dIq2oJAn5MOPw4SPcf/8DnDt3gY31Df7wj/6Q/mDAMM35m7/+z3zqU5/i8qVL/Of/8l949bXXmGm1SKIE73oICqVD8XG73ebxxz+NUCV3mmqlAsrgvMfaFG9DHbvRCqUFHWlW1zf49rPP8syz36Gzs8XFS5eZnmlz7OiRopkkiFdj4oWo0PVxQhkdW0Qqte/168n35Oujx42dB2TfMm8Fb7b8O0NyRxoUY/J9q+3s257av+TPW/2dNA3c2Opw/ORpnFVBKSx2dKSsoTQej5Iwt10Ecu8DydMKjR6rhEk1RjtB6WDAqrQZf7cGNmJ1M8P6CqgBUTSkNdWgUTVEOg6dKpRFKQcSysWbzQYf/ejjPPq+RxARLl29wtPf+wHHT53B58XYE1Aeciesb+7yxrmrHD42hYqmuLI25PSZHa5e67Kx2cGIJ5IcLRbvMjAKCp8EGY1HAS2CE4dogxVFP7Xk1qOASCmSJMakao8kiyr8OoJCrJUvRoofk3DvPd6PiLknWDp4NJ7pZoMH77+PY4cP06jXADDG3PS67b9+1yWhIoUtRPG+YuIZhmnKpcuXOf766+x0dhiZwkZas7K0xOzsLFpr8jwf72uJMk6UceKtoowTZZwo4wSUN2pKlChRosTbgJYwvzfwjhHLVIBCS0SzMUe3u8b65gZLhw7x9//R/5l/8T//D/ztk0/ztd/6MqtrW7xx9jID69AmARE++/nP8vf/3h/x3ae/zUxrit/82pd59bVXqdRjPv3ZT/L888/x3HM/4b4HDrG0dJB773mIz3/+S/z3/6//nj/+kz/hN3/rS+Ad33ziSV588SV+/MMfcPDQIax1/NEf/CFRUqHfT/mTf/VvyJ0FHeYxf+D9H+H+ex8hSzW1eg0wZC4nyy3eeSIdUanEKCVkueX4a6/zV3/zTV569TUGwyEijs6ZC/yHP/1P/Nf/+B8y22oT6QicL5TkompbTxJPmTDwK36/CQGdJN2Tv1//vojat47b4frPv7sQwI2ykImdGD2pvV9u9mnZ//a77bvwZuscbd8LXLqyxuUr63gfSLQxCueC34SjmApRTPvQ2hSkzRNFJqh8xqBNBa0iICiIXglePMpahBwvjp4Il6/u0u03qNcEozNaDWG6HlGJYvJMo7QvFL7CklJpGvUm8/PzJHFMUq/zyqkz+NNnEBWK7iMXysmVZPSHGeeuWk5fOYSpLHL28g6XLvXY3e6h/YCK9kQajNLkWmGtRSkdDBsnSsEVKvgQ4PAorLd4n6MRKiYiiWPiJFQfOBdK4UcKLwTyPOq+EaaBSEgswtkHgo+CVqGl7OGDB3n04fcx357FaI2fGCzXJ6m3qyyQieeJrQOK3OaFSnqSM2fPjMvVvfdMTbc4fPgwM9PT40TBe4cdt9F9b6OME2WcuDOUcaKME2WcmER5o6ZEiRIlSrwNRIRabY+okepQlIKKRqmEWq1Orz+g0+vx0KMf5B/843/Cv/43/29q1Zf5nd/8df6X//DnXN3sYpUHpTGR4dh997KyPMv2ziZpPmBxeY7z5y/xgQ+/n3/23/5T6tU6cdXQnJrh/IULPPu97+MFfvzT5zh78QzL83M0kgpf/c3f4MjRYzzw4EMklSpLSytY51hdW+cbf/7nXF1dRWvN0uIyn/7EZxAfE+k6JqqQZpbUpSgNURwRGwVi6XR2+OlzP+Gvv/ktTrxxFosmzSxKKbLhgB//5HkOHT7Eb3/1t6lWDBTlzFr2ynADQsGsUXqCmO4n0G9VvbwbUn1LMnITknv3pFZAuYLhjJTSyfeD4n4rYn2zV3+2aunkFIK95263x6uvnaQ/yBG/562gVEH2tMJ5jVaGSGmiKArdPCKDMhqjdPAFIMy/F9F4JWR5FgirczgZgnicG3B1tcPmlmK2DSayTNVhrtWgUc/oDSQoslpACVppPOAkdIBR2mCimKRaQ4xBrEV7iLxBe1AqI3c5Gzue18/tgB5y7mLK9k6G8o5EBszNTHHvofuYmmqxubvJuQsX2NzcKdR/NSbNwRozpCDgcIBIXvTqKabB6GCK6VyYwqGKLj6E+gVGFFihQHu8H6mcNvy9kWD9MVVv8OADD3Dk0BHiKGZyYF2vxQs3my5x3ZWWPacBkb3vwTBNuXz5Midef52tra3xsnFkWDmwwsGDB6kkFawL1rHWOZwr2z4FlHGijBN3gjJOlHGijBOTKG/UlChRokSJtwlFcNeXMY9U7AWuuNJkOo7odHZIhimPPf4xcvtP+Hf/5l9QiWt87Stf4k+/8Z/p9DMshtdfP8nVtS0aDc3cgRUuX1tlqtlka2eX2TnHgSOHefmll3n66Wew1pMOhgAcPDjPpz75cWZnWzzyvoeZaU7RaDRAa06+cYr7HniY9e1tzly4yCDNUNUKFsd0pcZjH/4AS8uLeEBFCXnqceKJjCaKFcYALidLM3784x/xb/+3/8i1jU1ygdx5nJNArr0w6PX51hNP8OA99/KBR9+P8gqtBCUOXSiCQmECqEJLyfCqCmW6ar/PAFyvjPris8W553oy+taI6fVk5F0jtqPNjEvZ1b43g5nmzRHMAENdcSgT31Ozil/Ha7t+/29J6uXNE53RnPPQrSFQSgBRERbN1fUdXj95hizzeOdR2uAllKujFJGJSSoJRhsiE1RRpXSRoHqcd1gLDkAZTBxhNCg/xA/7wZAUC5KRyZC1juXaRsR9hyMi1aOR9Gm1G1QaCr9jIfNoZ0CDMoAThsMMwYCOUDqolHiPIbSFRXm8tqDAOs9g4Ll4fgctHdbWOmRpH+NTmrUaH/3w43zio59hemaWzd0tnnvheX74gx+xtrERjBy1wVmHF48Rh3aCjyKcShAfo4ixEaH7jYrQOnQzQQsajxp5mCh/3QUuFGYc3nuM0YhzGAUHlld46IEHaLVaREYH89aJLGk02rwO19NcPz9iYox4BK9Dib8OFwmlFLl4BoMBp8+d5dSZ0+Q2AxXaxVar0xw+dJjZ9hxeQe4t1locDkt5o2YPZZwo48SdbGi8Aco4UcaJ93qcKG/UlChRokSJu8YkaVLXBTUFIZASoUyD5rRhd3cLJOYTn/kCtSTiT/74f+bQocN8+de/wF/99ROkorl46TIvvXaC2VYVmw156cUXsVnOqVOn6Ozs0OvsBhKnIz720Y9y8eIF/tE//Adsba7x2GOPsbO9TXu2zenTZ6n3BmhjmJpp8dyLL/LNbz/NqbMX2N7pMOj3qFSqPHD/fTz2oQ9ijKY5NY31QoQnig061qCD94BLLTihUW/iRZHnjqG15N4DCiVFJwUs6+tr/OVffoOjhw8x05gOOqBS4BxiorD7Wu8rVVfFvGulR4rznr/AHgEvCoZv8BbYX7Z7O1xfln0ny759qOt+unG9t9uUKvj6JG1/J9TTO+2IMmaDEq61F0itcOrMBba2doOKp1QwEhQhihMqlSpJUkFFUUgcJHR4cDbD+0AkvbPhNVHBWFXV0NoQK0AHtU2JoL0HpdjtK66sWlzeQEVbVOMhc3Nt6k1DHEfkqcG7otVr0VAmTbPQxQOF0pokjom0wo30TOUQZRFRKB2DN3R3hqzVt+l0O9i8h5KU5cWDfPDRD3Ho0BHiSo1mexqlIra3OnR+8lP6gwFqlBhpiEShRbDKICoGH6PF4FVIZIyOg2qsHKgc8GgJ3XO88qFFrQRfkPF0DR1SrcgolPbUkoj777uXgysrVJMYxEHxPaJQVkd5qkAw4JwYOJOq6chjwBPK5NXoRoL3pOmQK1ev8vobJ1nbWMd7R1QQ/fnZNocPHWZ6qhV0YS9BJfWe3JZdn6CME2WcuFOUcaKME2WcmER5o6ZEiRIlSrwN3EYxViObREBBZGKazWmGvR2SSPPhxz/OP61U+Jd//C9R2nDfgw/y0vE3SNMh//Jf/jGzU3WuXLoAznP08CFWVpZZarXwueMDH/wAVzc2+e3f+W1OvP46MzMt7rv//qBYxjVOnbvC/+df/GuMgiSJ2NzYZLfbY6uzCyrCaIP2nvvuv49Pf+KztFtzzM8tAmHecxJptFY4sWTDjDzL8NahRHPfvQ/wmU98iv/wp/8HLksRVDCVGx9tjjjDC6++yt9+61v83td+BxNpNAodmaJda2gZqQrJc6R8jkj2zXwG3gpx/lVDqITfI8vXn4ExKb/BNPPt4no1N3Sg8EqxvbXDyTdOBZ8BEbQxJElCFMeFuaMGEewwxbkwD937URtRV5gIumJigwIfkWeGRFfRKkabCmIHKAFPjPYGmw+5fHWbnV5Mo67QJmW2pZhvJVypNtjpeTwW1Ej5tKRp2L4CjNFUkoTYGBz2uuMsiCvCYNil09lgMOggkhNHipWVJVYOLGNijZMcYwyLSwvcc88xTrz+OoPBoDgmwaugOgbiG45ZI0QIWjwehzeCijQ6Cq2alYRSfFWo4eG7sXexR68ZExIao2Futs39997DzEwDbQBRWA1eiu9UcWRaAql+8+9OqHgYlbVDIOTDLOXUmdOceuMUeZqGfXVQiRIOrxxkeWERozWpdTgneAfWCllWVtQElHGijBPvPso4UcaJX7U4Ud6oKVGiRIkSdw25DQFXIiAaLyEMCgoTJVTrU+x2d8ltxEPv+xD/9J//X/lXf/KvWDt7IbSztI6zZ85wUSsipTh0YJl/+I//a7qdHVw+5JGHHiSpVriyuo5WcOToUXY6XV458X3Onj3H1WurnDl3gYtXriIuB5cTKRXK1YMGQiIRRw4f4hOPf5LDB4+xvHSIen0KbRJMFIPLghKaDRmkWejokVkiHRGZiE9+7OO89OKL/PiF53HiUVEcVBelUCYKJbB5zlNPP80jD7+PRx94CB0F6UprHVQgfSuSfXvC/XYJ+VtZ/s2WvR3JvdPt3MlxKAkq1/6tFbqpYpz63Klfwls5B7pQFAOVDBKmF8XZ8xe4cPFKaI9aKKWj7WVZRp7bIK7aiaSg2Gu8Dw/tQ+cOpREsPs/wcYKJIrSpgBqGxE5ivICXGqvra1xZ7bEwa/BmwMxMyuKsphYndFQFrwRTbMx5T5qF8YtSGFUkCcYUlQ0j7VmhjcFaAeUQycjyLs4P0MZTr1U4fOQQ1XoVpYUsz1HGkCQxBw4eYHFxkc2tLXJrCwJbpBaFQqzEYyTsl/Ee5y0ej+iifL04uxr2pg2gQkccTVjhaNwLII5IKY4dPsTBlSWS2ATyblSheBbXwoflgw9rUItve+1H50RC61UFpHnOtdVrvHb8OFevXsMoE8aD88zPznLsyDGmp1tBIbUe7xTOKWwu5OWNGqCME2WcKONEGSfKOHE3caK8UVOiRIkSJe4aNwYzmXjdFx0KFL7oZqGVQZmYSm2KXr9Lb9jnvgce4Z//X/5v/Ot/86958tvfYbjbxWhwSuMVdIZDVLXC6oVtppt1us7yk+/8gPm5BZ56+hlefvU1ev0h6xvb9AdZICoqkCSNItahSwjeo5SmktQ4euAwn/zYJ3j4wfdx5MgxZlqzVCo1lI7JM0ua9kmzlE6vT+Y9WWY5d/Y87ekWK4sLzExP8bnPfoYTJ0/Q6fWDKhMbrPdoE2GMohIndDq7/O0T3+TwykGqc/MYBTqK9pG1/R4DoNT+dpFa64nfFLB/jv7P1izx54PRKBuXH4+YrN57/62ehTs5b3sKbPFA4UTRH2YcP3ma3d6A3Bakz3tS78nzHCcSVHs/IvDjjY5XZowGLXixRfm1wvkMm+fEcSUkaVGEeI+g0USIVNnaES5dTXngvmlq1ZRavMvKfMJULWbDVLE6B60Q71GRJs3Sonw+dPioJAk6sNo9RVBpxAtaK0Kb05ws7eBdCmJpNGc4cGAFE0c48ViXgQ9kfrbd5tChA5w6/QbOe5yz+CAkEunCVyPUhoPLEZvjchsunzZoHWF9BkoFrwUJyWmY8qGLFyDSJiQw1qHE02hUOXr4AHOtKWKj0DpMKQjtXyl49KjHyOhqyr6E74bkFtAE5RYV2uPuDnq8cfo0p8+cJk2HKC9ogcREHFw+wIHlFeIkwYonGJ0GBdp7T5aVU5+gjBNlnPjZoIwTZZz4VYsT5Y2aEiVKlChx1xg57I+wT/USwStXzCUGlMJ6UGJQCpoz8+zubLN6bYvFhWX++T/777jn2L38H3/+Dc5fukSG4AU6/T5/8V/+mk9+/GMcP/4qf/PUt3j9+OuIc6TDDOcp1FiDc4EkSVEijh8pLwqjIprNGe69734e++BjPPahx1g5dICp6Rm0MTgPdjikPxgwHHboDfoMc8/m7i7PP/ciTz/9NAcPHOCf/ON/xEK7xeMf+QhvnHqDbz75LTAGpxXVSiV0TTCaShwTa82Z02d4/qUX+a3f+DJG6QlCPSplvwMiOF7mbqjmW8MvYsn8qPR/7wUY1yzDmKHfaTJyN0mLFBsWpbmyeo2z5y/gRY2JnMD4WSmN1oXxpdyYQDBSxAmdPkYH5YWi3F3QOsKYhJwc8RZQONEM05gLl3O6/SkqNUukOiy2W8y3K1xetwy9BlGI10EpTTOyPA9l5UoTRzGm8L2QQhUcn1uliu+LkKZdtHiUEubn55ltzxdk2dMvjFnjOKLZbHDo0CFmZmYYrq6hVJiuYcQXiqNHEbpeREYhOJx1iArTXJIEvFgUHqV1MIrUQhRHe6TbC957nLUo49EKFudbHFxeoF6Ni8RBB3PO8Bdg/7dE7V2DG+ZDTF7jMVcP5yZ3ltWNdV49cZyrq6tYV5hriqLVanH06DFm5+bBGPLc4rzD+RznLHmekmXDtzzOfhVRxokyTvwsUMaJMk78qsWJ8kZNiRIlSpS4a9h8olxXBbUiEBKFiEdh8UqHYlVl0EWHUS0K8cJUc5Z0sMvW+g71eoU//P0/4P2PfID//c/+lO9873t0ez3y/oDvPPkUz37nGbIsxUswXzPaFESjUBwLprNXQA94iwKSuMLygYN84IOP8fGPf5ojR44yPz9PXKvivTDMLekgZdDt0+/t0su6WBEuX1vjm9/+Ds+/+BK9boeNzjrPv/oCX/vyb9CcmuJ3f+frXL18hVNnzmGqCaI1Ck0UJSRJRKQVcWz40Q9/yNEjh/jgBz8AfsQff3UUzp81ab/Rg+DdTUyU7NE6ax2nTp1la2unSPz278lk+fVYtRutRxf77YNCaTCFEaIf5xPeWazLiCo1YlXDZSlW+gW59Fhf4dLlPusbMe1WQhJlzM14lhfrvHE5ZzdV+DSQYC/CME+xzqK0xmhNksTEUTTm3DJmpyFjLURGpOjQU61UOHzoCFNTLVAa5yxr6+vYPKNWqxLFCcvLSywuLrK2vobSiohQ5q+coDUYpYmi4suvBCMGiDA6RuIYtKBUUcQuBrRH67Bf3rpA2p3gfOiKE2vH8tIc83MtosLHYzTdQOODKju6Lipopb44TH3d92/SJDJUUwQ124pjt9fl9LmznDj5Ov1+H7TGO0GbiKWlFQ4fOUK10SDHk0nwfRCxOJ+T2yFp1n9Hx+EvK8o4UcYJKONEGSfKOPFW40R5o6ZEiRIlStw1nJskXiGIioxDOAofnPkxiBqV+O49xDniqIqpQTrsM+j3eOiBB/jv/tl/y0cf+wjf+MY3OH/+At3+AJumiHicBBXJ+cmycB1iroxaZAYSHsURywtL3H//g3z4scd55P0fYmnlYOiyYCJy5+kPBwx6A4bdPmmvT5YOSMl59fXXeeKp73DyzNlg6phEDPKMJ556kkceepiH73+Ao8eO8Hu/97v8r//rv2N30MdrTaQikighTmKMgTiJ6Pf7/O0TT9CebXPowEGMuglxC0dTHNP1Z/qtEdzbzuO/BfG/03n77wRG27rj9YvsPwMyfrkgsoXq91bWeSebhYmS6DCid3d7vHb8OMM0xzo17jQyYq6jcmgRVVQL7K0v8G+FL1rrhkXVOGkEwdoMZTNMpUoUxcRxjDcKZ23wrSBhY6vLufO7HDmsmYo9zZqwNF+j2eyz2TXY3KBEcN6Rpil5HhJRrRVJFBftX6FwoAznTY/OoUe8oFSYTjE9Nc2hQ0dIkiqIZpjmnDt3gX53h+WlJdqzVVqtFgdWVnjj1BvkeRdEo3ygxMYYqtUKURzjFcRxQq3iyXwFdIwXT2LqoBxIILjep1jrcLnFWYv3HnFhRyOtqDeqHDiwzMxME2PCGRRlQu4jMupTMq6amBw9o1kFN3TyGKnchbqb5Tmbm5ucPHmStbW1vQRJCfVGnQOHDjI7v4CJI4ZZjhdXdGfJsTYjy4ak6eAdG4u/zCjjRBkn7gZlnCjjxHs9TpQ3akqUKFGixF0jz/dKNsfVoEWpduCSo1dtKDMnlCaLglyNlA2FIUFXIiQbcG1tk7hi+OznPsvDDz3ID7/7fb77zHc5d+EC270uxmjEqKCGyEjlKRSRQoxpNCq02zPce89DfPiDH+Ph972fxeUl6o0GOgbrPVnaJx2m9Ps9Bt0Bg14P7zy7ux1+/PwLPPXMM2xsbwGBiBilibXm2uVVvvnNJzm0fIDZ6Wk++vhjXLx4ge88810GaU61EhNHGh1pvFI4BI9w9coVnnziCX739/6AdruFEY8uHPUECmO7SZ+Bt4c7byn6i4Hb7qlikmIXZeJq/ObIWPCdP14B8YXSZhjmjtMXLnPpyioutxgd45GgSrowd1+8FAapgQB65YtxDyJF54+CrDtl0EqHcVAofE48OmhuKO+I4xou9uCHRMqBKPq2wuuXenwwnaGeJFRVyqGFjPmW4/JqRO4jlLIo0QwHGc6FaR0iQpQY4ooJyqvSKO2DV0EwO0BEcOJQYolNzFx7luWFpUD+tWJ32OXi1Qv0t7bZ2dpiemqaRq3KoUMHaNbr9Lo9YqURo3HKE3mhhkGbCG8ijEpIKoY0V4jKQWkMUeiAkabkeYojKIzeebx1RQVEuLYWT7O9wsLBA0T1KsQaUWGfRWuMk3D+tOB1GBnee7QIeEF8OA/e+5v4DwQzWSeQ5hmXr17m+GuvkPV7RN6Te09kDAuLCxw+coyp5gziQHuPdnlooeuELMvJ85wsT9/h8fjLiTJOlHHinUIZJ8o48V6KE+WNmhIlSpQocdfIMrvv9/2dJvZaF974/qjEVKOVxqDAC1pFRHGN4WBAf9ClUm3ypS//Jo9/6KM898LzvPjaK5y9fJFOb5dsMMDmFm0i4jjM+Z+dnWN5eZmDB5c5evQQx44+xPLyUWq1qdA5AMtgMCDNcgb9Ib1uj0GvR5ZmKCAyES+++CJP/O0T7A76oEKrSqMVRhsiHfb3J889z4P3389Xfv3XadTrfPWrv8XG5javnTiJ1qCNCrKY0lAoYih45ZXXmGrN8Rtf/hLNWoKJdJifvpexvON4N+fj3+qzd1XifoemjdeNqDExfzfO3uQ6vQjDLOel147T6fXD9AUVxox4QitSpUMqMCKMCvTNjqt4aaxWqkAvw5x9Xcy1d0gE2mhMXMHloTOEEGEl4fK1AVev1lhuxpgoozXjWF5ocupCRtod4OwQbcDbDJeniLcoJcRRRCWpoNXoOoWxp4sS/FECLcpjjGZpYZHW9DSR0mTWsbvTYXtrm/7mFlcuX+bAygGiOGFlcYmlxUXW1tahILdeQoeOWmKIKwodhSTE48jzIU40OqrgBbLBEJemeLE4le8lM0W5P8X0gUhr5ttt2jNtkrg4jr1C/OuUbW74G3TLa63CNBzvwVrL9vY2p8+c4drqKs77YsqMZ6o+xdHDR1leWkYpjXUO6xzOObzzQd3NLTbPydPyRg2UcaKMEzf/bBknyjhRxonbx4nyRk2JEiVKlLhr2Hyvs8RYKZ0g2eM63/DOvvdFgWiPQuPRRMqQO8GYhEolxmvIs5TeMKNSn+bTn/k1PvrJT9HPhmxtb9Ld2UKAOK5SrTeJ4gpeFHFcoTldp9WeplFvoVQF5xVpmpJmgdin/QGDXp9+v0+e54gXImNI6jH3HD1Ks1FnkA3xGrQxRFGEMYbYGLQOKtPfPPlN7rvvHj70/vfTbrf5va9/nUHv33Nl7RoOHxQaCUaATjTeB3O8H/3oR8y2W3zuM58is5bIaEYk6GYUs8TPF6GNZ+gOc2V1nTfOnCMHvNHghYoxmCgQMYF9ydTox8mEZF/3liD5IkqKhh4hwXPO4fIcohhlNKYSo/MkJJzEiK+wtd3n/JmMRw43qDZ7NJuWwwfmmDuV09neYWgdCWDtkDwdIC5HG0OsDYmOMBKSFycevEbp0MVCvBS5o6FRb3DkyGFq1RoGjeQZzUqVDzz8CDvr6+TDlF63y+zsHO2ZGY4dOszZ02fpdgdFebkiMtBsRFSrDh2lWNcnS3OyVOMwROLROgYJ8/YRV3TyAHShiMvet6MWGw7OzzHbbO61uy3O6Yh8T/7FmUx/3uybpQiNmb1zrK+tcfrUafqDPqLBWk+kDCtzi9xz9BhTzWmcCLlzWBGcSEgYvOCtxWU5PrdvssX3Bso4UcaJX3WUcaKME+9GnChv1JQoUaJEibuGC+LNeD5vKKPei4lKw/4QOEHOx8RE8EpwSgCNdyp0xxAhriRBYRFHlvZRLqfWaDDbapFEhiiKETRp7tjtDdAmodGcolqvhJJyr0nTnDSz9Ppd+v0eve4uaa/LcDDAOhtISRxTqVZJkoT777uPr3z5i3zjr/6SQZ6hTISJIuIoIjExxkR4o+gPhvzZX3yD2dk2h5YPcOzoEX73d36H//if/pT1nW28VyCBEuTWYbQCJ/S6PZ761lNMTzf58AcexRcqFX6UtLyzuKG15G28Bybfu5OS+HfCHHK0nRvWNdq07PsxvDE54f+6nOWdNqxUSuNQpLnjxOtn2NzuIjrG2mAo6LxQqcahm0PuUNdNSxibMd7sfHpBCOqchLqBsKx1+DyHegxaYeIIHUVk2chEsUqWa86dtWx9CBpNR5IMWJ6PWJhNuHwtIs0MgsV5S2aHCB4tilqlyj1H7sFljmG/T6+oHLC2UPxk5KLoac3McPDQIZIkCb4FccyhpRWW5ufpdTpcuXqV3m6X2fYctWqV5aVlZppTdLs9VHGNIqOp1TSVxCLKk+YDBoMB1lYQk5DnkCRhOTEKmwfzTESwPkwn0BRGmgjNSoWDC/NM12voQmEOW5Jg5qnC80g+V8VwuN2o2PMeELwXut0eZ8+d48y5s+TWhjJ/72k1pzh28AgrC8tEUYwjtJf1CA6QouOIyy02y3HWva2x96uCMk6UceKd2L8yTpRx4r0WJ8obNSVKlChR4q7hR+73BUW6fh5vIJVFibsa60eMwqYmEEKtg62bUhqlTNG6VI2rwo2KaFSraOVBFWWr3mO9w1qPiSJarTpxHMzoHEKa5mRpSr8/ZDAY0u916fV6DIcDXDrEOYuKDI2pJtV6HZdbpmZmqMQxX/7SF7l85RIvvvoKDjAmJjYxkQ5zsyWKsM5z9tx5vv300/z+73ydmfoU73v4YX595/P8zbeeZGe3R5Z7RIKiJiIYNArY2NriyW89RXu2xbGjhwETzpeogrjc/fVg4pzeDRm9KRl+l+GL+f379uOWReqFqigedKEyT5hIvtP+A6I1zgk7nR4nTp4mz0JXCVA458m9xQnEcYyzhfnjmHcF9WxE/0bXZPS9MVrjxeO9C98IFcaL1oLkefA3qBi01kRJjE4N4iKcKNLMc/lqxqVVz+yCIYlTZqf6HF42nLkY0e1FuNxjndDrD0AJJjLMzMzw6c98lg9/6IMMB306nS673S7bOzt0uj3W19a5cu0Kw2GfA8srtGZmQCus93gEE0dhX4xikKXs7HQYZilxHLO4tMjC/DxX166FlswOjEA1UURRTuZCxYK1Od5HiFiUCdM6jDZYCR4feNnrKzIuIAgq5Fx7hoX5FpFRGBPO3+jiK5HCOLQoZfcS7gwQyutHRP16zwHv/fi7k1nL5s4Wb5w6xU5np1C/IY4iFucXuffYvcxMz4AK1995CZ1GnMc7h/WONM/IbD5yBX3Po4wTZZx4J1DGiTJOvNfiRHmjpkSJEiVKvA3sJ9wjFXRPKZ1QTgGUCq1XlQIxgXBrQetgsKeURhfz+1XxrE3R/cOM2rp6nHc4PE40KtFUTFTQekWe5wzSIf1hRr/bZTAYkKUp6TBlOBiQ5zkaaDaa1Gam0EnE66fe4Kc//gm//ZXf5LEPfpCpqTr/p7/3d+n88S5Xrl1DaUNiKkQ6RgCrFCYCUZbnXnyBpaVFvvDZX6NWrfCpT32CTq/Dd57+LgqLdYERaAnH4axDtHD23DmeePJJ/uAPfp/59ixqpJi+B3AjSR5nZ2PIxFs3qKXXi6pK3/jiOwAhcDjr4czZC1y6eBXvFNoHPdQXJC7LcuI4QWuHH/kGSMgP1IRwOkn0QlI6ZovjvRcRcB6Uw6U5XkWF9wVEkcG6Ynll2NwVjp/qce89TSpTQ1qNLkcPJCzO1VjfajC0mu7QcXVtnd1en5mZGBPHzC8uoBfnwIfvUm49uXVkec6lS5d58slvcuHcWQ4dOEBzKvh2DNIhnd0uXjxxEodEMY4CCe/uMjc7R6vdZmFpkeiN18hTS2SqJFFMs14hMp5B6snTCfVQJHQT8QqlDMbEiPMoXGFaqQoV2VFRimoSMb8wy3RrCmId/EsKhqxE0CKj1aH9qHoDnCpO801U9Ukibr2nmw44e/ECp8+fZTBMgyeDF5q1OseOHGV5eZm4UsGr0OpVJHQpUj5MD8i9J/eOXDyunJ5SoIwTZZx46yjjRBknioN9z8aJ8kZNiRIlSpS4axQeiBPTf0cEXBVq3Z5SOnpda43WBiURoNHao4wvCHZBvosuB5MqqwC590XZrSAqRsUxRim8+NAJIE0Z9Pr0BkOGaUaeDcmznDzLyLMcnGWqWqExNcVUu0XPpnzn+9/jez/4Pp3tbSpJwpHDhzh6aIX77ruHv/MHf8B//NM/o7O7S6QTjDIgCu0DoxYNwyzl209/m5npKT7xkY8RRYpf/7XPsLO1zXPPv4RB47wNXoAI1glKK5z3vHbiddrf/jZf/cpXaVYbe9XZ7w0eDuwn2nLTN978dLyrXUu0otfv8+qrJxgOcpTTaB/Uei3gDFjrSBKFSWL8MAudWQqTRLUnm96gQosXxLui3H3cjLhgjR6bZsQ6Jko0RikqscHlHvEWr4ShaN44u8u1a1O06xqjN1icX2RpocnZS45ezzPMMk68cZbDR47w0IMPkCRVlI6JNCjlMXFMlCiqaKwE5bc922a42+HIocMkSYIVz3avy3MvPc/q2hq1eo1mo04cRexsbVOp15lpt4mrFZYPHKA5M0Xv2hoKqFaqTE81iSJDlmcMUw+ix4cpQJ7ZsB86xmODCj6SSItr670jrlRYXJynOl3HKY9WBrRGFyS4OKt7125yDBVTaEICt6eWTk418N6z3dvl1NkzrG9uIoTOLAbFwuwcx44cYboVlGNB4UVCguBDImGdI/c2EHDnyhs1Bco4UcaJt4syTpRx4r0YJ8obNSVKlChR4q5hzGT3jkmirdH6egKuxgTcmEDAFRptfFBUTSD0Y5XUh3WKAu+F3OW4ojRcaY1og4jQHw7J+n0G/R7ZcBBc9DNLnuV4b8nzHGctcRwxMzNDa6ZFbWqK85cv8tff+iYvvfYqubXUaw3OnDnHU08/wx/+3leZabX4+Mc/zm6ny1//7RN4KygMQkGatBDHBrzQ7/Z44m+fpDXV5sEH7qNWr/OlL32RrY1Nzp09j1J+nHiY2GAqEdVahfpUne3NLdZXV5k6dBS0LowzFcH/bo+VivhCKd47/yPicCsTwtvhZ122/ubYK2K/WQcGuelv4XnkfQF7x3W7c7Pv2PdJsGp/BqQUaW65dOUqb5w6jRKNkrCx8cckEDfnhSgORo7KeaCYejGRQIoKHTPwwVQwlOLrsRni+HsUNNrQGSIJBF0XZdVa6VBGjcfqiGvrjjPnhtx3KKFe26E9ZTm8MsXrZ3M2d3q4zHHuwhW+/fR32dreZmlpmWZjhlotIY4NcVwhNhHKhIRYnCJJqiwsLtCancUrTS6enV6f519+mZOnThJFhkjpYKwaxdRqDQ4eOkQcx8wvL9KebbO+tgFOU68nNBsJRitsDmkqiESMCLZ4wfocpxNMca68+DDNQQW/AaMU4KnXKywszlOrVcPUgeI63GBbMXnNAS0KT+FNMGrRW2QAk2pp7hzXrq1y5tw5ur1eKJf3Qr1a4/DKIZaWl0mq1dBK2TtE/DiLEBdec87hvAvve0+JMk6UceKdRBknyjjx3okT5Y2aEiVKlChx19Da3ECu955HCmpBxLVGTyilWqlg/qYjRiKRFOLIqGxcvOCtw7tgxRZrHZSVPCOzGYPhgH6vT5oOsbnFexe6c1iPzVLSbIgxhnqzwezcPFPTLbSO+fELz/Hkt5/i7JkzaK1pxHU0EBnDc8+9wMqRZT7/uc9RSSp84XOfp7fT4/s/+BFZ7rDKoRPB5TmxJGg02io2rq7x5De/RWNmhoWlRebm5/nab36Zn/7wR5gopjHdptacotGoUa1XaTQb1Op16tUaiYmICeX+mQlz28VDpBNAEPHj83kr3nwnpo5vhp8HKR+rw/s48fXHMaEu4scEXRUEzI8GzuQnJhXJW5ybPc4dlC4tCnGEzhaiUJEhzVKOv/4Gnc4u4qOQhCnBY/HiUF6Bismdo1JJUHGEZCkRDiXgJJBuq8ArKai1R3tPREKk40CmfY4TwahADr23eGfxroJQwaHAGJKkQuYs4MidMEinOH5ywOMfmKJWS0iiPkdXGizPe66tQyfzZBm8fvINLl48w1SjQaM2RW2qwUx7hpnpGVozbaYb0zQaTdJhyqDXoz7dQAx005TUOVbXN7l2bQ2fW/qDAcbEuDwn0YZrly/T73aZabeZbs+wsLDAuZOX0C6iVhcqjQzRCf1U00s9TgyEZsvgHcYoxGdIFEEMWZ4Fs0oJI8HoMN2j3ZqiPT1N5HTxt2ByXBQ/e9m7/sX3RQGRhOqEQIlHbWH92BfEC3R7fS5euMSVS5fI8ywkWkox257l6JF7mWm1g8jrPd5acBI+7xXOgVhBnAVrQxvpX7Qc9+eEMk6UceLtoowTZZx4L8aJ8kZNiRIlSpS4a0SRARgrooF46zEB1zqUb+8n5oW/AAaNQdgrN/Xi8aPg6AszPSCKQrhyec5wOKA/GLDb74dy9TzHO4c4F1qrphneWpRSNOpVplvTzMzMMDU9g3jNU99+mie+/SRbO9vUqqEkXokQaYM2mnTY5/vPPsuRgys8dN9D1Bo1vvjlX2ezs81zL7xIFEe02y2mG01mpqZpNhpMT09Ta9RpTk+TO8f3vvc98l6Pz33i4/zhH/0dtIlQUQUpzosUbVnHyrIPSpkVT567QMCtkCtPJU5wzmEMODcqfb419rX1fBuE/F0tE78Zrle7Jrc/aZwpk+/J3tzzW+zunSUVozRAUCb8PLIp3N7pcuLEKbLM4X2h3EvRv0EJRoVrarOMuJIQRRHWaLy48F6xfS2MsydVEEuNgIS59ogPpqijfSnK3J33OOeIohilIuKkQp6l2DzHa8fQKy6t9zl9qcfCUg0TCQuzjvuP1Tl3eYth15Knltxl7OQp/f4OWoUuOFprUEKSxDQaNeqNGgrY2Nhgob3Ij37UpDU3DzripZdfpbe9jaQZkSq6awi4NOXqhYt0NjaYm5lhqpKwvLBElFSJtGZmukqznoAE41brJsrVJy68Fxv+ImiF0TFeLBCMYr11RFozPz/PzPQMkQmJv1Zq7OVw3UUfX/vJbjFjVXT8897YyfKcjc0Nzp47y/b2NhQtVOu1GocOHmFl5QBxUg2jZFQaP1Zb/Vgx9zaopYj/BaxG+PmgjBNlnHjHUMaJMk68h+JEeaOmRIkSJUrcNaI4qB1K6/GzVoUqqvdK3kcEfN9DDIgBCeXAwkixGLVADMZxIkKaW4bDAflwyGAwYJgOsTaQkOFwSDYYkg1TvHXEcUyz2WSmNcNMa5pGs06lWsGYhF4vZXdnCzscUI10QYIgiiMqlQpxHFOv1YgVvPbSSyzPL+CsYJKEz/365zh14QzT09P80e/9PivLyyRxjIkilNFgNKKgn2b89d/8NWuXL/GhDzzC4vw8SptgXgfgXaDfSjEYDMmzjKlmE6c03d1dzlw4w4XzF8kGOfV6g/vvu5djxw5jInMDSf1Fxa2IxztB6q8vSx+1+n2zbd9mjcV59YzauRZV62R5zuuvn+batU2Uiot58IJg8eQYpdFicNbhlWBzSyVJMHGM8w5RClWYhBoJzR2EURtR0OLR2KCES+jwURR6h+PQ4JzDWkcUJQiCNjFxUgHlUNqgtaFnNSfODbn//hnmZzKa1V2OHZjhwHyb4XbGrh3ivQ77IyBOIV7hQzsd+mlGv5viZAOlFYinu3OBS5dWiZIq2kR0Ol1sbhGn0ZHBZjkajSJiY32HK5dWWZhbQmlFqzVPc3qGfLfD9EyFei0CnzMcZOT5iDDL3ukXj3OgtSv8R8LfhdH1dNaRNCosLCzSaDRQei8JvVm74H1ke3JMSKGoyohEhyTfKUU/HXL56lXOnz9Hmg4J3YUU7VabY0ePMTs7R2SioLY6irKOUYn8qH1u0brWBbNQ5yYMMd/DKONEGSduhjJOlHGijBO3jxPljZoSJUqUKHHXiKL9xNqY60vc2ff7JLyEclDvBSdhHq+C4J4PWPF4L6TD0DJ1OByGMvVhynDYZzDcZdjvkw6GKKBerbEw12J+bp7pVotqo04UR5hIo41BUNQbVb7wxc/TH3Tp9XaDF0GrxczMDO12m1qtxvT0FNVahTiJWVvf4M//4i84eOgQn//CF5lfnEOsZ7bVYrY1E5IFRZiLXBxXbAzTU1Oc6XXZ2NxkaXkJ76HT7XLpyhXW1lbp97vUmk0uXbnE2toaX//ab7MwN883v/Ukx0+c4NChI7SnWxx/7TivvvIKX//6V3nwofsDKVHmrq7Vu63uXz/n/51a38Qr+9a/Z7iobrH8naxztNo91U6pkCiJUvSGQ147/gbDocUXJdFKgxRdOATBi8N7QEe4LEclFeI4weYZzjk0BNUNxs07RmqvgoJoFu8XxxbGVehO463DWYsTXyS3hqRaI05iTKRxYtBxgytr17h6LWe2AYnZZWVumnsPTNG5tortZaQ2RRsbRqoCHWm8E7wrlFsTgwNRGi+aXFnStIvRKV7A2dB+WElUJBzBKFGriM3dIT9+/jV2Bzmzs202trtoY6gknvl2hWocyr27vZw0V+H8FuqiiMKJJbQcVkRRDCiUhM49xUmiUa8x125TSZLCb+DGa3mrMbCva0fRilVGKqdSZM7S2e1w6colrq1eRYrrlkQxiwuLLC0uUavVQWnE++tIvg+qeqGMeufGXVucKz1qoIwTZZy4cf1lnCjjRBkn3jxOlDdqSpQoUaLEXSOU2RZkW+mg5hUIhKL4RWBkgjdZri5+FMTcmIBopXDOk6V9+v0Bw8GA4bBPOhzS6+7S3d2l193F2pQ4MjSbUyzMzzPbbjMzM0OjXieKE8REULR9FQTnPdrEHDhwgL/3d/8I8NQbjbGSa4zBi2CMARWc+XcHKZs7O3hj0JHhK1/6MsoHMuC8wytIs4xrq6tcunSJ4XBIvdYkHwzxzrO1tYX3nvX1Db711DO8evwEjWqVKDZsdzvsdLsorbi2tobRhlePH6c10+a3futr1Cs1Hn30/WysrdJsNhHvMdoUhGQ/yb1ZgvPzwPWq1TtLxm/0D5gsbb/ZObmzdRfqpVIEAwKF9wqH4cLFa5y/cIncjch/kTiqoOKjCjKudPALsA6XO6IoQulAVEVkrMgrFfw2QjcIoEgyGY0/pXA+aKlxFAVTUKWBYt680mgErSOMjoI/gtIgGd2dlFMn1rlnaZ7KjKVZ3+CBewzpbka7kTMcZpjYoYwlzzOctWhtcFYzHAhZrkhTsE6RO0UuCqcExOBF402E4HBovFi0ykHFWFFk1vLK6yc5e/EStXoVlGJ3a50j8xHzsxUqMfRT2OnmpBKHbjzsEfBQZq6xxVSUUQtiL6DwaA3T003a7Zlx9cX142Mfyb7lGAoX3IsHgUCdFWmWsb61xbkL59ntdsJUBYFGvc6hlQPMtmaJiqklvvCF3GuhG/5+eW8Ls9CRUur5pSlteJdRxokyTkyijBNlnCjjxJ3FifJGTYkSJUqUuGvEUQUIxEQpjdlXahrUkL0XKObthof1FhEC+dUaxONczjDNGA4GdLsd0nRIr9tle3uLbqdDr7eLd45KUmG+3WZlZYX27CyNZpNqLahHSmtCHwUFSgqCpAq11OA9TLdbqGLftNYorbDe4RGydMgwzUPwNzFJtU6318c7j3eeN06cYKpe42jjGIPhkGe+912e++lPcVlOpAzeq2AoaC1bm5sMh0N+9MMf8fKLL/GRjzzORx//CJVqhbMXz/PkU09x+dpVtre2OXroMLVandXVNZ761reZa88SGUO9XkEpXZTgehS39x4ocee4kaIrnAelYtKh56WX32Bru8dYkB3VpAfrwqCU6kLNK+rgXW6JVEI1Shg6i/O2UEoDqUQCifcSukt4dFAnVSDbKtIYExFHERVDKDHXSVgGhUOKpCGYr0baUUtSVuYqNCodkBSvLUatcv89DQ7MLzLoLoWONonFRBbrUqzziGhsLthc0+/lpAPHMHX0ehkbuzn9fspuZ8BuJ2O37+kNFZk12ELutcRYqjhdxYuw203Z3fUoIhLtaE/XaM9ExMYxGGRsdlKGPsIz8gLYO+9qXNo+KmsXvPIgjsgo5udbzMzU0W/Roff6EvfJMncBrLMMhgNW11Y5f+ECuc3RShFpzcLcHCvLy0w1p9BKk3s7/uzk+gMZdzhnx+TbF54RJco4UcaJX26UcaKMEz+vOFHeqClRokSJEncNY/aHEZkoDx6pH3vvjXwFRupUMORTCpzLydM0GED2unQ6Hfq7O2xvbdLZ2SHLUsR7GvU68yvLLC0uMTe7SKPZIEoSTBxBMf/fiRRl3yqoMQUB9wJZmuI91OKIztYWwzRlcXkJowy587z+xklefvkVrl5ZQ5SmUquy0+kSR4bhIGXj6jo/+N4PWViY48DRw/z0hed55tlnuffoMT710Y/Rmprh2tV1nn76GS5cPMdup0M6HHLy5EkOrKzw+c/9GrPtFqKE2fk5BPjzb3yD9dVVZqan+dxnPsuPfvwcp0+f4RxnsS5n0O+ysDDLV7/6ZR588MGf2bV9T2DEo8ZMXAVS6hWXLq1x4sS5YGqomFD2AnEbJXmevEiJNMo6rMqoRBGxiclNRC4WCKXT4+9AsWllIrQyqMgENd7EaKMxOibSiop2eBGsV+NkVUbjWjyiLFGUMd/yfOpjx7j/YJOp5gZeF9+XSoIagnU5ZCnVSGg3KiS1KtZphgOHtZbp5jQiweAwz3JA4ZQiz4VeN2Wnk7PdcVxZH7K6OWBzq8fuTkann9EZWIYuxUmCF1Uk2RUajRpzsw2m6gbI6fZTNjsDMpmmaCwcLsEou1GhzNy5oOCiwtkVsVQqCYuLszSa1aL64oYLd+tLXBDkm5FvkVBB0enucvHyJdY318O6xVOt1jm0cpDFuQWiOA4KKWrv79d1Ze3jlqvOlzdqrkMZJ8o48UuNMk6UceLnFCfKGzUlSpQoUeKuoVRw3A/CidorT2VCUZoIdl5c8TmFVqGTh80tw36ffjcooZ2dLdZXV9nZ3CAfDjGRodFssrC4yPziAu12m+nmNHGlhjYmGFRqFZpxFsZtqFA27C14L1y7epUTr53gypVrOOep15tcunSRzGX8w3/0D1heWuC7332WZ7/zDPVqnZWDh/ECp86dod/ZpVavsbO5zeLiAlorNjc3GPb7vPT887SbTb74+V/j3qPHwAuHDh2mWq/y7//Dv2dja4dOb8DQOdozU9RbTVxUlP47y6HDh6lWqqytruNyxyMPP8rhg/eGIO4suU354Q9/wMsvv8DpM+c4euxeKslb9x54K74Db2XZW5eY763rpu1Ory8/VgphcrvBKnGvUn2U1N16Wzfbxs1+v77kPoxZjVaAeJQypMOc06fOcm11vSBeo23v7bfRoZNEUOQB73HiUVZwPiGKDFFk0K44NjUyPtVBzdcRUZSgTYSODMpotImAUYm34NCgPEoJGjcu8/YonAJP8AewwyGRalCvxag4tHWNVAwWVq9eYXvNUqs0UV7TmgaUxWURF86s0+8OeeSROvWmw6ldev0OzWYbUxe0gbnZmGzYZNCr8IH3xQxth91el91dzdXVTS5e2ebClQHX1gbsdBXOVxBiWpUKB+aaNJseryy91LDbBXBjtV9pKJwqw3F7QPlQpaBGPiSKalJhbnaOpJKgR91WiiR+smz8BpJ9k98RCR1WBJRX+Nyxvb3D+Qvn6XV7KC8oD9P1JgeWFpmZmiLWIbFXE6UeRVF+UL29IM4jzoPziHV4a/G2vFEDZZwo40QZJ8o4UcaJu4kT5Y2aEiVKlChx15CCgCMqqJMjh/siwMGo9eCEthSYDs550jRj0O/R73bY3dnmyuULbK6vkWcplSii3Woxt7jA/MIirblZao0mURITxQkog4Ra+iIEq+LforTYeazNOf7acZ746yfodXu0Z9oIcOL4KbZ3O9Snqmxub+NcxjPfforpxjR/8PXfZ/nAIZQxnLt0kT/7xn/iytWr7HR2WFlaIqkmdDoder0u3c4uc+02SwtLoexcC9Z7Dhw5RGt+jt1+HyfQas9y8eplzl46zz333I8XwXlhbW2D4SAF69ne3GZzfZOXXznBfffey6PvfwSROvV6jSSOmZ5uYXQ8Ps63fK0KMnwr4vp2TSRvRb4nn2+3b/sPa38CV2ygWHZEnG++/dsZBU4us7e/e8+CRrxie7vDq68ex1qHiC4IeDHpPFBujHiU94FMiy7WKYhyWMkxxmDiGJ0qPAqjDVEUYeIkGDKqGBUZKK6JLya1j0q7RQQ7WqcPZE4iAyZBUFgCkcx7lsv9bV55ZcjB5RZz9YhIxSilyWxGmvVozc4T6yYbm1eZXYpIlGeYWdY3umQDYW1tl8P1CqJzeoM+leosJvY4NQRv6aeeU6fOs7KyyPyKpz1rsXmDo4fm+Zgc4NragHOXepw+2+PchS7bOylzDcehhQr1SkqOpdN19HsWJEWRIGiQ4PvhvRo170AEnHeYkU+D0kw1mrTb7VCZMTo/o4RbJsbQxLW+nnyPVj4i3wh4B1masb66xrUrl3EuIxJFbCIW5udZWFikXq9htMblHny45jIi3lK0ii6uVzCQ3FNKSwSUcaKMEyOUcaKME2WcuPM4Ud6oKVGiRIkSdw3xo5L1iUBYlN9K8V8hL4zN3wRPmqYMen2GgyE721tcu3qZjbVVhv0elcjQXphnbm6O2fk5WrOz1Gp1kmoVHcWgC4O+m/CsQO0DnHNsbmzwxN8+QZqmfO1rv81DDz4ECCdeP8Of/8VfsNPdZHtzi872Bp1uj1/73Oc5dOxYUKyU4ti9x/jIRx/nL//qr1jdWOPee++lVm+y2x+iTYV6c5pra5tcW92gfmyq2AnPxuYG/W4Pa3NclvH4hz7EX/7lX/Gf/+wbfPAjj7O8vMzG+jov/PQ50l4fU63R7/Y4dPAAJ46f4LvPPs2rr7yANgrvLZ/9zKd430MPot/EduB68vnzNI68WSvMu1wT11/sd/I4lfJFaXrYR+vh9JlznDx1Bi8ax15HCQCNRosgbkTiw7geCaagyK0jch5tDCapYSJHNYkDATcxmBiUwYlH9lwHxy2HfUHmnLWAA+dwLsdECdW6QUUxygsagyNmZwAvn1rl/ocjptsVkniA9wOiOGFqKmF7fRObbrPb3cD7Ki4XdnaGZNkuJq5xbe0Ss0vLVGsxxBV6WY7JPSbR5NaztrHJldVrSCQ05mep1SOwjkHPolVCeyZh6UCd939giQsX+1y6mBGTsLIoKOnhnGJra4csywryPZmkj66nIKIBwbtg1qmB2GjmF+ZoTU+PvRsmBgIjZTkImLdQR0c/U6icEvwfrHN0+z0uXbrE1uYmGoUXT1ytMb+0RGt2jiipkotglccrKdon7+n6IoSuRC4o5Q7BK3AKcikraqCME2WcuDXKOFHGiTJOlBU1JUqUKFHiXcA+Al4opkXFZ1ARtA/qqAqBzdqcLBvS7XbpdzrsbGyyvrbKbmcH8aHse2F+joWFBabmZqnXGySVCiaKUUXr1JEJpLoNoVNF0ey5M2dZX1vjy1/+Ch/68AepVes453j8I49x7uwZnn7m2/R2dqjUkmAiqQ06ivA+KLrOeQRw3rO+sUlciak16vT6Q1CGDz/2Uf7qL/6Sv/6bJ/jUJz/J3OwcW9ub/OAH32Pt2jUa9QbD7oAPP/pBIgff/d73ePapp4iL1pHtVouPfuQxYmOoRIal+Tl+9+tf4+rVq2TZkDiOaLdbzMxMEScxN806fgFxvWr5dlXYdxdhjAoKh2JzZ5cXX3mV3Hq8GEQroFAxAa1C+bs4h1aacc+GIk9QaqIVsYlIavXQwjM2KAkkUzw4HN5ZlIQxlmcZ1tqCgIdON9bZ8P0Rj3hX8HSHIUajEWdRpoaPW1ze6fGjF69x+NBhKlFCFA2h4lhamaGW5OSpY1ktUm8qRFna7Qofefwe4qhGf7CDNhloTa0Z0+1s4zcUrfYULjNsb+yiMWxv7rK7M0WjWcfEjs72gHNnznHP/W2OzNZo1Ay1uMZ9h+eQHNrNnCSybHccWxtdrFU4AXEUVRUTSjoUx1hUVAgorUgqEcuLC0xPTxFHMYxV0oIEj4fWm5e2S1GSPmqVnDnL5tYWFy9dot/rQ1GmPjU9zeLSMvXmFBhDnlmcjLp/jEj8Xom8+CJhEsEhBQlX5FJW1UAZJ8o4cXOUcaKME2WcuH2cKG/UlChRokSJt4Ewd3sU/MIU7MJMT0voNYnCOovNMobDAYN+j+2tLdavXqGztYm1OdPTTWammsy228zOzdGcahDXGujIoHWE0qH0d8R0pNBc4ebkzkuYP9zd3SUyhtnZWeI4Gc8TVkozPz+P0YrO1hbvP/QosY545eVXed+Dj9Jut9AYrl69yksvvcRgMGB7ewutNNVKldW1dQaDAR/8wAfY3enw4x/9iH//7/83atUqIo5KNeHee+9FFacgiSI++pHHue/YPVxcvcpgOKRRb7C8tESj0QiKUByjtWZ6qs701L3jsuaRKZ5SBANM7yfKu289t398hYr3R2XlNztfd6s03o5YT5Lwm837v25NE5Xr+41FR6Xit9vnt6LE3qiiBULmUWTOc/7yFU6du4BTCgdB6VfBw0JJKDM3Shfz4hmTba1N8BEwIYkzJkaUAaOL74XgbOhg45yQew/eId4W5oJuQjEErUO5dzA/8GEdzmLzDBMlQTVUMT42eKZJ7YDXz63y+umc2ek5GonCSRcTaxaWp/A+Q+kYUQrv6kzNGPDhu9to1YAMtGemXaVer6K8J9YGbTQHV2ZZWYzoD7r4dAebOrxS9Ae72CxjplGjGgtp1keGDnxOs1YlNhFKHIN+zuZ6lzytIFGCSGjTHIazZ5TAKx2SZ/HFOXd56NyzMEucROGc7w3/QqHeP11iP+G+fkyEay2EQ09tzurGOteuXcPmOYhglGJmpsXs7DyVSg1XeE/44r+xkl2o2d47vHOID4aTHhCtijH1i5x4/ixRxokyTtwcZZwo40QZJ249JssbNSVKlChR4q6xF+BGpbh2TEpGgdHanOFgwKDXK8j3JqvXrjHodogjw8LCArOzs7RbLaanp6k36iRJgtcmlLVqA4RgrYrSeQV7UfgmUMU+zEzP4J3n/LnzPPK+R0mqVbwSBr0uZ86dwXnHbqfDwZUDvP+R9/OTnzzHv/23/5ZHH3kfzjlOvHGSMxfOY9OM3e0dertdZlttLpw/z+7ONvccPsKXvvAFHnnoIc6dPctgMGB6eorDRw4x257FW0elUkFpjXOe9vwcM/PtoiBW7Slqe2eRPclNBwVPirJdRs/FEm9COCfJ+a3m/t+KwL8TeCfV0dExvx3c8jgldKXJckfuhJdfO8Hmzg6Z0zivgnlkMd8dCUmQKMFoE/wEYkMcx0RRAkqjjQl9KgTES+jA4Sy9QQ+XZwUZJ7R31YISV5DQsE7vgiob6RgvsleEIHtl7t45VBQhKtQEKF3ByzSd3Yzv/3iLleVF7rmnRqS3Q/tSGYDOwHhyW8f7NtZrFDlaC4IFKiHXMJpKA8T3w35EsHSwXoxhCWXwZkiWGmp1xeEjbbTKwcVUojpGhHNnT7I436J+cCWcYuXRUYIiQkkMBfneS7DCCVPF8YjShPTHMT3dZH5uliSK9hTKm6iik+vb//p1SikhQc+dpdPvcmX1Glvb2yCCFqjXaizOLzDdmMaoGPEK0EEjFRmXs4+JuPPgi/IQBI3CaI0xGq3eZA7KewRlnCjjxO22/46tizJOlHHiVytOlDdqSpQoUaLEXUPGJZsjtXQvmCKhTLff7TIc9Ol1Oqxdu8bO1hbOWZqNJq32NPPzi7RabWqNGpWkgolMCMBajdXRMXWSyW1xS1Ym3qOU4p577mFxcZFnn30W6z0f+OCHyLKM5154gZdefQnnHelwQC2p8Ftf+Q1mplo8/9wLfPuJJ9GRoT0/x5e/8EUG6YB6pUYtTvjMJz/JB97/MAdWVsDnVGLNscMHOXroAEhQYZXWoywAAA84NSIOE2aFhDJpP0EO1cS/CMEIc/LwJwgGvDWV83p18RcHapxPvZtJwc0govBW8B6urq7zyvHj5M7iMKB1sM7wHoNGRxrnBbTBxAlxHJNEhsjEAOTWFeTO4ayg44ioWkHEk6dDbJYGQk8wpNTFcWsVkkvvXTEFBJzNgTCOxgmXAu8t3ls0Bo+glccojfgag+EUJ09v8O0fbJL6BVrVJokeMteGpDJExNPt1Tl/1rPZ8VifoXVOFDmq1ZhaJaZWS6hUFHGiqSQxsdFoZYkkJU7qVJIYJZqaSrjvAcEOU5zr4r3CxAlJzVOtGxrTNaIqWOnTmGly5J4ljl9OyXoa5/XYWHGUhI5ao2odVFRvMyIjzM/P0m5NExkdEhqlJv7uhHNZXMnx+LnZY/Sed0HlzZxle2eHCxcv0ut1Gf3Zmmo0WFlYpl6po7zeq9CQ8dN+ku8l7I/3aFEYpYi0ITExtaTy7g7eXxKUcaKME+8MyjhRxon3Vpwob9SUKFGiRIm7xigQhg4dIVZ578ltTp7l9Lp9et1ddra32FxdpdfdpVap0JpqM7s4x3S7RaPZpF6vEycVjDHoYu62Fwd+RFELYltwRoFQmnoLEqmUwjnH3OwcX/rSl/jbv32CZ55+mp/85Kcorcms5eg9x7DDAQvzC7jcMttq8Rtf+gqPfegxdnd2QAnN1gyz83OIhDabkTYoBUofCHPAdSD7WocyXB1pcjeaSy1oo3E+FLaqOMJ6R6T2TAWDmgyixtopo44oUJDvcdIBgnvLiuHtztE7RcKvX89b6RgyUorluuXUmx3p5AcmyPsN+3D9Jq8rj9fa4L3Ce8XxEyfZ3N4BU/gLeAltOFFEUYxJYlRRuq50aBfqrWOQDbDW4ryMHyJQa9SJfIxRUKskDGwWVM5iPxQmlHDLnka+b+qBojCR9Cgdxop3QVnVo/GvhAgFxOSuwSBz/OD5Nc6cuUhDdlieV3zpi8c4cqyGKI/3bS5e7POjVzpc29piONykUgGjHIlRVCuapCJU64aZ6Rna03Va0zEL8zHz7QaNWkKtElE1lijqEk8JSBTK75UjquXMLTVpzNTB5CiVkVQdS8uzNJvbrPdzlKoihfcASNHRo3BxEB++Awpq9RoHVpaZmmoExdnLmCiPn65TSm81ziQsUHTS8QyHKevr61y4eIE8z1FKE0Wa2akZFtqz1CpVIq2xvvBBKD6/n9j7CRIuaBW8KQIBj7BJcvsx/B5BGSfKOHGzbZRxoowTZZy4fZwob9SUKFGiRIm7hsaNSWMwUdMMM0uvP2TQ69Hf7bK9tc7GxjVsNqBWr9Jut1iYX2Sq1SKu1qhWK8RRXJSuq1DGOw6gIUCPynmDqhJevx15VEBEUF/e98CDLM3N8cYbp7i2ukqj0eDAkSMcOHgQ7xyVOKZar5N7j0kiVg4us3xwYbymUfnsmBgVrysd2r6K0mGOulb4gkX58ArejYrQAwyB/4W0Qo2Pc48TynUq0P6jGhE0uDXJHS99B2qjfrP2IG8FE9dj31zwWy4+qYgWxAtAJrtjhOt9Q0vXt7hr48Rtv+Re/ORwwGZnhxdefpk0syARMTFGK7RRwQMjjhATxpTzOT51iPM4u9dic3TYShFahuYZxgYDUpI6uRWGgx4Ki8LinKCUIVx3xs9hnGvE5XjxKKUxJsKLwkpI8iJRKFGAAQ06AXGGgUsYbtfZ2tRUnObK5S6zM13aMy2mWhnNhub+B5c5vV7j6q6hO4zo9ANR1ipDEVQ/pzK0XifWitgIzYai3aqytNhmeaHFocUGiws1ZmYMjYqQKNAqI67kTM8nmMjjUSgfoXyCyw3OFa1tVfAPcYXy6YvSf62C30KWW7RRTDWbrCwtU0uqaB/IrRdQyowJdbiWnvHfiX0l7WGR0Na1mBYjBu8sg/6Aq1cvs721ycg+JYoT5ueXmGm3iGoR1rgwOqzH+NB5ZVTU7r0F5xDxWBwusHSMgTgyuNiQ2PgtjtRfTZRxoowTY5RxoowTZZy44zhR3qgpUaJEiRJvA6ZoVwl57kizAb3BgE5nl363y87WBpsbaxgjtGZbzLbazLZnmZlpk1Rq6CgamyPCrRU3YXK+8fW62o2QCSZkjGZhcZGFxcU9Eh/FxVxqt5/QKia2E7Y8WVC+nwcG5epWHgijZKEQvNhXmn+TY31zjBKBNyfNd1Pm/nZV07fy6dsnT0UWs28Zdd0yb237oiaSnLHyHF5wOKyHN06d4tLlK4io0G1CCUlcQUcKr0KLzjy3pGkalDMXDAVl5IuhRor+aDwJzlm8tcRJjJcIjIHIhHGIG0l9E/uzV9rvfegyMnJFFCjMCUMlQmxtsS0dVmM0oiFPHUrHKDFo3aAzjPjpyzusHI557LFpIpOyvFjj4QearG31GPSE7sCS+d1QaO8F5TROO5SDXCm0OHo9y+pan5OnOlTj87TqhoXFiMNHprnnyAKHl6eYbxlq1Zx63aHxKBdh8xhnI7a3u/T6fZxEY6PWKEowSqGNJopCtxPrLEpblAhTU1PMttthDn84ycXY0EXCtp9wFzUUN5DwUWIjEkh/luXs7u5y5coV+r0ezlq0UjQbTRYXF2k0m+jI4FUwhgwJYngoCd1V8D48E8w9RQnaKIwxRJEhdhG+rKgpUMaJMk4ElHGijBNlnLjzOFHeqClRokSJEncNh8JZR57npOmQXneX3d3w2NpYI8sGVBJFq9VifnGBmekWzeY0lUotdD7Q+l2ZZ+6BUdU4xTZCSawPnT4UOBfUTGNMUZr6ju9GiXcItyqFv6PPFrMC1JiE75HdsIBhZ7fD8y++TK/XR+kqzgu5zzEofObxCE48edEWNCqSIEGNx86e6rxH/pzLGWZDdBLjCB4TogoircBMHMKN3U8C4VTFtIdA/lToKZFn2DQlThJEK7wCpRXK6PE0CKUV1kMWzXB2fch3frzN3Mosxw5As7rNI/fNsLXVJB3EnL06YJDmQIbxgvEx4PHKozwgxe8uQimHWEgHlqubjuOnd1icd7zvvh6/9ok5jh2OUboTqLCvga7QzyOubqyTOodJasRSRau4uCZ7RpHO5tjcIs5iIsXy0iKzrRbRKEEv/pVRA1TZI9z7fQYmn9n3s1KK3Fo2Nza5fPkyeZ7jrcXEMbOzsywsLFCt1RAJ7ZZDK2k/wcH3VwTslbaHaQda6/EjKW/UAGWcKPGzQRknKOMEv1pxorxRU6JEiRIl7hr9NCfLUob9HsNej+Ggx87mOpub69g8ZWq6Tnu2zezcPFPTM9TqTeKkhjYxkQ6lvO8WwtTmCaVVfKGEhleiKHTY8N6ORZiiMnmsVr3TycGdqpHXq5dvxdzxre7zne7TnSz3Zktcv2d7x/fm27qhrH2sht9szXvviwotNkctcEPBfNFNArAC5y9d4/WTp/GicblHirL63FpcmJcACrSEzh9KKcR5vN9/fSZ3MaxfcN6S2wwVJ5gogmLqhlK6IHe3OnOjlRXEXkArCQKht3iXgS88EJTGK0EZQxQnhelljkODqpO6JV47u87yj7do/docy7M9Fmbgww+36OxW2Rlq+pt9rI0L48kYpfLxPoRqCAWqFpIH68Nu6Tq5rbLdN3SzBDFNtLZoIryrkaUzZDTZ6im2drcxcYOaaeLzKCzjHdZmRdtZi7M5zlmUctSqDQ6uLNOo14K3x+ik7pvOciPp3k+K986tFMTdescwHXJ19Rpra2vjdSVxwvzcPNPTLZK4gpdRq101Jt/hfOh9CXv4fCDgIw+CkeHlz9Ls9BcZZZx4i/tUxombrrOME2WceK/FifJGTYkSJUqUuGv0+336/R7dzg5pv0dna52drQ2SSDM/12KmPUWrPcfUVItqrUkUV0AFAjJSR26Hm5n+3VECpPYUsvFn1fiXvfVoRoLU5FvvWJL1dsvEf5lwt0c6Nki8g7Ew6vyw77wWRPf265diQATCq7QO6idCd5jx/Euv0e1lOBsUz5HS7vH7uL1GBe8I78ckyxiz50shoRvFaPd0UebuvSdWUElivK3QGw6AMC7lun0dQanQvhOCshp0WYUKM/rBWxCHUlE4Pq1QcYSyMWKz8D1ThtSDSJ2d/iw/fX6DI4sx7Y/XqZgBhxan+dCjTVY7PYY+YWs7wVqHKAHlUaoglC5kpsbEKBROBHSE9zUayRStVsIDD8wyN+8wZhOosbPT4MxZh0uqnLuWs9VrYuJpxAZFNHcDrLO43OKcBQTxDgil4u3pJksL88RxhIhHK12YSQoibnzx90rZPYWb4zipHpXOS1H+PjqXvV6fK1eu0Ov38d5jtKHZaNCeadGoN9DajMdMINSFylr8YfHe45zHWostkgYRj/OueC88lxU1AWWcuPP9/1VHGSfKOFHGiTuPE+WNmhIlSpQocdfo7GzR7/XY7eyws7VBr7NNYjQzMzPML8wz3Z6m2ZimWm1i4ioqUBhGbv13q/rdTEG87pP7mjZoBfu6ZEwSqxvku5u9eOO23ww3Sx7eKql/JztuvJsQZEKFvhHXNdC4yXmQm7w/etz+nI/FsDc5tZqgekmhenmtcUpx/soFjhcqqVGGkTA6eVyjY1AEtXRs41m8p/VoP0f7z56C5xzeZuBiTBQRFy05xdtCwd9/3GOF13u80vsOLeSRAl7wNkdcjkiMVzqQdK3RUYQyEeKK74DKEDTO1djYbPC9H2yytFDn4WNVqkmPY4cVj+9GpGmMDOt07BDrhijlx+qiV25UegBicErjPMw0Yubbiofvq/DAUUOz2kErR5rVOH3O81+eOEdqhnRszHonIbURw3RIPuwhUiQxfuQh4JCi7WwcK5aXFlhcmCc2upiEELpwBMPMUfePcO5DFb9Bi+Cc4H0hawtj8u2LpCm3OZ3uLpvbW6RpiveeKIqYak4xNztHrVoH9trA4kGKcTNST70LSclY4XU51mXkWU6aZaRpirW2vFFToIwTt0YZJ/ZQxokyTpRxYj/KGzUlSpQoUeKusbu1Sa/XZW1tlUGvR6NWZW6uzfz8HK3ZNrWpBtVKg8jU0MqAyLibBT4Yq90Kb0Y+b0dm96hb8fuEGgqBr705sX1ny9nvFm9JIZ7ArY7v3ZqOMdKrbvpewYd+HhiRZjV6KIUDrBcG4njlxOusb24jKpSGj8gzBfkcye7jdehJgk5BovdUXNgj3wrw1mJRJHEVrQyJjvBJhWzow9z2W0xXENgrjS6OA5FQ1i6CdxabW3RicUQ4QkeMKIrwJsI7EO/QehBahvo6uZ/m3KWMZ36wzfzUMouLA2aaXR57dJZhdx43GHLWrbPZ66CI0ICXoAKiQseekAXEJNUGrZkq9x6M+PDDCQfmdqmoDjjodOHE2Q4nz2cMTY6vxFgV0+v3SdMu+IxC4gYJyqYxGh2H81yrJRxYWWZ6qhmuoSq6mygdSvj9niKt9OSY9oDGe1OcOwcS1GZrHb4oN+/2umxvb4f2tToYVM62WrRbLaIoCteFcD1d0VrV+72HK8i3tcE4NLc5WZaRphmD4ZDhcIj3nqmpqXd8PP8yoowT7z7KOPH2UMaJMk7AL16cKG/UlChRokSJu8ba6hW2tjbx3jHVbDA/N8fi4hJTM9PUGnWSShVl4tCOVIRQQS7gPWJuRthkP7u5ASPFcbTILSQyKRSlvRr1Nz+Yfdu9O9L7y4S7UWCv/8ydnpubL3Xdq+N1v4Uk4/YbmNiS2hsTBfETpVnb2OD46yfJrcNaAUdo/zuhePric3sjbf85kOsSyZGpY+Dwo1adGu8cRKF1aBLFOJ3inR+f09G/kz4GIzVQ6VHL39FehOPxzoYy8JGiOmrPagw5oSWoxuFxiM9xuk4/neLF1zocXFjjc5+p0Zzepd0wfOR99zDsOgZuyIAt8r5hohIclMajQUUk1VD+vTgHH3rfNA8ccTSSDTQDrDWsbw7Z2OqTS8z2bg7OIjplOMzwPkWPtObiHBmjaTRrVCoVYiXMTjVYWlhAa0V/0MflOVEcU63VQxm8zalWqqRZSpoOGfmKIJ5KpUJ/MMDmjjiOqVXrpGnGcDggqVTpDQZs7ewgIiwvL7Ozs4MWaM20qdUbqMiE0vRCGR35GIxUV+9deEh4dt5irSXPc4bDAYPBkOFgAEq9s22Nf4lRxolfXpRxoowTZZz4+cWJ8kZNiRIlSpS4a6yvXgIU01PTLC0uMDe/QH1qmkqjQVQJJeyBfRfzgkdQgng1JsihdHhCa1OqKHUdf4CRchEIjsIVQTysQjFJjMZhr1CZ5Caq637y+PZL2N9t/KyTvrd03KKK5Oq2C038vL9knTepSdeoEeccf1zCZsdru9XGJTQAxajgNqDEERnNMMs5+crrXL1wFQQiHeElmAW6PAs+AkqTFd4IokLXjJF+ig5j0WAYGQNCuE6jczdWFsWT5Y6kokJrzlijYw0utPEMi4Xxryg6fnhXlGYX1pZKMdJMRYevi7U5JrfEUYIIaOeJRKFMjJicTEB8PZBHo8gkA2twnSm+89NtmgtVPvr+aabiLsvtKzz+4Tk6vkJfWly7akn7KfjC0FEUDkVUrTE9M83BxZiPPBrx6MNDphpXUbqLlyoDX2OYQhLnJPE2dnsX72NMJUJ7h8tBdDG1BUA0zjuyNMfEmuZUjbnZaaaaNTKb4qwliSJ8nlOpWPr9LmmW4pUnjmPygaXf71OtVhkOh8RZUC2TJCHLLNVK+K5naYY2ETv9Lt1Bl0otYT5uESlwmWN+boFKrY43oWzdicf78LN4CVMTxOIlx0temFvm5HnGYDBkMBiQZyk2G2LzlOnpaVrTzdt+I94rKOPEzw5lnCjjRBknfnXiRHmjpkSJEiVK3DVy75mdabG8tMzCwiLNqSmqjSY6iVFaByd8NQq1N1r5jTiehDr3AMWYON8cxTt+VEZMYWa3b817Wxtv/xbr2fvILyVupVb+LBTe/SRdcaszffuT++b7OflpERkT7/GQuaNrVyRxRpN7R6834OWXXqbfHyDKgHjiuEKtVmPgPc5m+zwutNJoFeak70/39u+bc26cKI7myAuhza93LpRga0OUJKRZhneT5fASxnJRJh/yDl9kGsEccqyWesIXyPnwXSh04GDgqNCRAa+xzhNFCUZplHegItCwtu34wU92mWlM8eh9hiTZYmWlysc+NE9mFSrL2JAug2FKXrQonq7XabfbrCwkfOhB+NgHmsy3rmF0DlQZDGe4dE2zm9aROMGZHGVilI7HppdudL1GyVMxTrM8oy4xSRRz8NBBms1AXrXWVGs1hoMBw3QYko7IkOc5lUoFEaFWCyrrYDAgz3PiOEZrTZZmQVn1Dus9WzvbdHZ36HR2cC7H2ZxGo0ZjrsHCwjxTzSaR0WTiCF4HrvBHCN4IztuilD2oo1mWkQ4zhsNAwLMsYzAYoLVmcXGRpaWlOxmYv/Io48TPH2WcKONEGSd++eJEeaOmRIkSJUrcNdqzcywuLDK/sMRUc4pqrY6J46AsiUeKeb9eFfRsgljLmEwUKOQukaIseO+lG6AUaC8F+Z74+Hjdgsffkbp4M0XwTtqc/qqWut8pbiDf7+rpkNH/Y1FcJliwwL5xMnltFHvk1CsFaKyHN86c5fKVqxhjcL4Yj+LRShEnCd5bvDjG3UZkv0/A2MfyuuGx3xw0lJkHU8eMPBsicRS6yCiNmiifnzQuHfskIEVy4ZhsGstIMxUQFwgiRWtSi6CNRiUxRnmMMsRRFaMj8IJBSLTCmBkuXF7nhz8dMlWPOXRgSJKscs+BZbSbww26HLcZq95jhzGNeoWFmSorszEffrDGRz7QZ2FmnVhtIx4y3+LkOXjyOxdY30no9KvsDBK8aaBMjDEGowmdL5wDkVDBEOYaMN2cotmoU6tWObC8QrVaJYoiBoPBeJ6/eE+W50RRRD8bFHP/c+r1RtFBQ6gkEc6GhGGYZUSDQTivWpHEFXr9Ljs724CgjSJJEg4dOsTi0jyNehXvBascSnwg6c6PDSZlwm8gy/LikZFltngtI89z2u02hw8f5uDBg3cz2H/lUMaJ9y7KOEEZJ8o4cddxorxRU6JEiRIl7hoLSyvMzc0zNdOimlQwURFWCvbsxBf9O4r/ZK+QWSbkkv1kbkR4Jrc0Wc8cftAy/nQgWBOtFMbdJQrvgJuVs79Zyfbbef96cv5m3UfeLAm41bJvt9vHO1euL4i8uyR88vLLJAnnRqX0es+IsLggSpN7RXcw5LkXX2JzewfrFdpEKMBmlizOiZOYLDeIdeMS9bEqOzkN4zrcYBQJKB1UTfEWl2dEkUEpAypCxwle0mL6hg6eHAoUGqWEUVPWCWExdO2Q0X6oMD/eh+0I4dvgtULHEdXIgI5RKkZEIS4osE4rcu/wdp7X3linUc353KfrrCzn1JNV7js8i6hpdNRFvSEMsiaNiuHwguUjjyR8+H1Cu7mKlj6gsDLDhasxf/2tMzz/8pCd1GLxeD+DiupBuTUKjcFohXfgRtUMCowOZf+S59SShEqlQr1ep9FoYLQmTVOUAmMM01PTVGt1dnd3ybIMhaHfC+pkEldoNur0ul3SNKNWq1Gt1bDOIgqcd3S7XQaDPsZoTGxQopltt5lqNsPfEecQ67E2KKJe9tqohm4glsw6UmvHj9yF1/I8R0RoNBrMzc3RbrfvfsD/CqGMEzdHGSfeeZRxIqCME78acaK8UVOiRIkSJe4ardl5mlMzJEkFNSIqzoU+p14h6AniJHuET0ai0/UMKlAIRMaMSyk9JtoUxCpwdzVWyEJrxYIAjZ5HZc83MXp8M/PHt0pM72Rdd6Ks3m7Zm+3Tz9MX4YbOFe+ycDwWJdUogZtQx69TLPedPwkqpAg4FebPnzl/iZOnz+HQePEoV3TtUIosS0kqMVEcY102yXy5/iDDMJWJc6Bu2AcFaKNDu1aXg1RAxagoIRIfSJsKX5lgyhjanaqis4j3Bf1WOpBtJWhtMCYm0oHEax06kXhG6qMCUUViOqLxquicGjpUYDw5MZ3BLM+9vE4UWT7zyRoHFy2V6Br3HLU4ahjtuXrVsjCb8JH313noWJ/21DqR6uCJsb7F+vYUT//gIs+/NqAznCMVg1MGqIQte4v3CmMMWhtEOxh7i4TzNuz3qWjP8uICBw4cYG5uFqUhiWN8MR3AKIWJDYKm3W6PifEkQRZnqdVqJNUKQvA1EKVozkyzurrGYDAszqlGPNTrdZrNKUCTpjneCc6BcyGptNbjbdi+c0KWF+pompPnDudGZN2R21DyXq/XqdfrVKvVux/wv0Io48RoH8s4UcaJMk6UceLO40R5o6ZEiRIlStw1pmdmSSqVoIp60IZxGbqoETkJy440nxHXFimINoASlFb7PARC+XsoRlaFqjoq4x2tb0R3ZKSKFq+NOh9MksRJ/KKUo9+Ngvvzwt22wH1nUJBZtY9nX7cPt/qshDadJsJjGOY5Lx8/wcbmDkpFRMajxiRX4bzHOkscR2S5wfkw5z+Q4TBNYpQIhCeFL1pzTpJwNTHfIlBiQRw4a5EowSmNjhOiSkI6HOKcC0XrRQ4aOLTGiUcpjdaBssVxQhTHaKWITIRSEUpHCBqFQxcWqVpr8OAlEO9QzT8qhRcQF4wfdYXtwTQ/emGdyOR87pNTzLf71KJtHjrWppE0uXo148BynZWFIbX4GlHUw0uFLG+x1Z3l6e+v8sz3N+n2Z8DM4GyOE4rKCItSFu/AqypJUiVzYR7/6FDFe9CeSGkOLC7TbDbwIigvGK3RWo+q0hERrLMF8d4rN/eFT4B3Fu8c1rvgKaE1omAwHHLl2lVOnjzNxvoWjWY9dAip1HEO0tQiEiGiyR1YG0i4d4K3grce61wg4NaSu0C4szw8chdK3RHBGDP2PyhRxom3izJO3CnKOFHGiV+tOFHeqClRokSJEneNuBIUUu+DJioj6bIIlKIMRbFuIStNEOyiFD28taeMjlpYjlSoEfYRLDXWVCeWZY+A884RxrdSbn43eDutXd8Jsv52tz1Zxn13eHcTjrB/QeUUUVy5usrx108hSiMotGjAFQRP4UTIspx6o4aJIrI0Df4BAFJ07Rip9Dq0WN3nVbFvikUx3kVQ4hHx5DYn8h4xOhDrKAKlEXF4BF0knlopxEREkcZEQblV2oDSaGNQSuF9MKTURSsVJcHMEhSm+CJY75G9bwUoh8KjfNhmxoBMLNlOzHe+t0E27PKlXzvAwmyfqu5wbAWOrgha75DoHE2K84aBn2Jrt8Gz37vKE09dYm2zhlVN7IhcKwVii++5xVpBExFHFbQuDDeV4AlmjLGC+bk2B5aXiUyEdx5twDpXeBUwKoLHetlTSb3Dj4i4c4h3eG/DcSvBK3CFQeSpM2d47bXX6fe6zLZbNOpVDDHDQRbK7J3CipBbwVrBWo/NC6U0C6XreZaT5/m41WqeB8NIZy02z/HeMUxT+v0+WZa9q2P7lwVlnHj7KONEGSfKOPHeixPljZoSJUqUKHHXUFK0JISi5LYg1UWF8Ej2kXF9+WRp8qjQVgV/gjGb3reFiRcVqOvat964R4HwKMbl7SNMklWZZO8TOzZRkLx/HwLLus1292PPB2G07+F5pOXerOvFrVTd267/us+/k6X4d/fZm29fJk74+NRMtnR4s21N/Dt+TW5Y4OYQMBg8hjR3vPTqcS5duYqg8M6Op0CMVTuEzFkSEXRSgTzHi8eo0AF11A5YAXiFduARlFGgC8KIQona+26IFO2HZSTBgYkQAaNjtIlwzqOQoIBqTWwiVKUCBVFXyhDFcVBaC58HDyAe70AjREqPh2rYfiCu2nscPphe4sE7JBOcz0hdD60E7SyDnuep710FZfjCp6dZWUqoRLvALlo5hAjrY1LX5vy1Ot/9wUWe+f41VjcbeDVDmnucDPF4MBFKWcT7UGrvwWKJtAvbK66NUoqkUqUWKw4dPsjs7AxaFcdlBfF+XFXhigTfiQRFW0JJuXcOch8MM/G44nSL8iGhsjm7nQ6XL19me3ubfm+XbmeLZr3G1EN1qpUKWhu8BLIeCL3gLbjcY61FrCW3BeHOHXnuSDNbkPGiw4cPy253dtjY3qI1N3dH4/tXHWWcuDnKOHHdq2WcKONEGSf2obxRU6JEiRIl7hq6CHhea6RQzFQhYyoFCl+Q7QnzPNhTOhUYkaDwEN7wKpg8jvwFKD6llGesPAEyUq/G+ujoMfp3gvxwHUfzxfzsieWUHjW0VPvXIoX2tU8R9NwK+/0DpGCKxXkQUES3JfNvNl3ixjn/+/ft3Srff/P13I78j8j3nv/E9QpjoaffdHuTQ+Gme3EbLh/yQI2zwvrWDi8ff528IMSjMYcKI1VEEB3m5g+tJ4qr6CTD5yneecxYlZxIJqzHRBrR4HRQCbWKCgIcdk4QvPJopcmdxeVDojjCoIijCnHiQRm01lQiQ4wiMgarwamilF4ceB0U0FFyOTonIoG0Kgo1F4wG0RI8D7wjz4bBLFEKouod3juEsO9eFM4Z1nYrfOsHa1jZ5XOfOsKhpSkS43DiyH2VflbnzAXFE9+5xIuvrrLeqZBJfc/joMgAXDg5iHi0L66BOBxDlHeEEn8BrXHOU5tucvjwAWr1BD0i3cW1DW1PC5W6SJO8CNaH0nWcR1tBe8FK+NsQ9ick7Fmasb62zsUL58myAUjwEkjiOjMzTeqNGioy///2zm1Jchtbzx8AZmZlHfogjTQjaUYayQq/wb5y+Ans8DPb4Qs7wuELy6eZ2Z7R9N5S69R1zspMEsBavlggk5mVVd1das1uafB3VGcWCQIgCdb6wX9hrTJHyoBYphQxoh9TIkskpY4cEykJMWZiFHLP9kXIKqy6Nd+9+IGvv3nO8eNH+wfl3xmqnbiNaifu3lftRLUT1U4Y6ouaioqKiooHozeSIlJca/1AClWNgPcK3haBVQa+pbpRIm/FKuhlT7TElNsQ3zwQvqK1uu22R7Xchtu404/JoevJP31yy+FERwrfAy7U3xBv0j3+X9LV/lWwdY/uLOQQhKTKn/7xH/nq6+eYrliOVh0mg73CDo6cM9OpYzKZErOgOZpCWSR1yw4C4h2TxiPO1qY7dTQuQCGA6lOZIFjwR0HJucXrlEmY431gNj1gMp2iqky8w2Ujfhqa0kebFGiMBO8IgULCXVkpIiTRMsHzZcILGgARYmyJ3Qopyqlqxhv1RrSouupxzEiqfH+25D/95zNWS8+//Tfv8/tPHgGOy8tDvvjfC/7rf/ua//uXM5bxAMIJ3s3J2dr0zjKO5JgQB5oT1iuPOE/SgPNCUlNQjbzCe++8w28/+JCJb3Ymarr10wfRFBVyCRBJtiCg9ufBY0sIjKQLmdXyhufPv+LF998RY8Q7R3Ceo8Mjnj59h4P5HOctPa6SbZKi2ZYZ5ERKHTGtTQ3NmZgs/kDKxc1dMimnEigys1qu+f77Fzx69O2bH/Q/Q1Q78fah2ondQtVOVDvx9tmJ+qKmoqKiouLB6Il3j23ipdxLj5SB8ELvju02rMp4hxGJQjI29Sk4P+wsFGpE9rWQ+rvb3k6b2dOx/XEANpOBDf6liHhPRHavvfXp1d3a39ZglG8aipKdcnG14Isv/gfteo1jAurL/kyRNIFyX0WQ2MHBjFkzQX0ilqCG/Y3XfsIYlKj9+njdpANWaHwgBXNVD2qTxCZMYTKjCQ2+KHo+BJrQFCUTcFKy4zj6HLM2wbT9OSVTCss4EMmWjhXPpJkSwoTsAM00zoPLQMZpto4hOOy7J+BocH4CQNcpjZtxdv2I//hfvueHywX/8A8f4f2UP/3xgj//xfHdi0Ouuoy4A2KaIGLn7MszqjmjxUVfcip994izMJZMIRUS7VBmzQGf/PYjfvXkHYJibuxwJwnXcr6aM5LErn2mTJA8JUItqBBTx+X5Bc+/+mcWi6vhOfah4fHjpzx+/ITp7MAmVT3xxtRSW0KTETWV1OIqCClHYuroUkeMHbHr6EocAu8ammbKet3x7bff/3QD+2eEaif+9qh24vVQ7US1E2+jnagvaioqKioqHoyeBI5V0LFrda+U9tu3yhQDqWLuxJ6NUqrYenG0cKNdsutG7rNjzVN1REJ1aGuXbCpSiI39ZuKYbog/PakvIpfjXsa9Hddg8/2uQ/aR31cJajkmJPtSye4r+2PwY+oY97Xv11gB274v7ta1unXPRr/3bv9Dfa6vY8/kSZWkwpdffsmzZ381F+9+wta37hgycjg8XtXS06TW0ptSXLS1xNFwmxHiPKgmUGHinaUVFQuN6lxg4g+YhEATgqUdDVPENYh6vDrQDF5R9eV5sPFozWg/+wQySCbnEpAwJ6IYiVUyuaj5BwdHNM0MJ97c752RXCSjknBei2orpig6h3cWDkG0gXBEJ0JSyNHx3//nKX/88p8IYYroY/Dvk6cNpANSzIgGczXPHVk6nFjqUrIiztpNkmh8U55ZIDRIIefTJvD05JhPP/mYw4MDHL64w2/uXz/hFJFCkktMguKaryIW5lPVJhlqGVYEoW1bzs/O+Oabb1gtVwQXQJTpZMbjR+9wdHRCCBMTbIsKayNk0xZqywJyTsSUSSkSc7RYBDmRciTnhChMpgccHp3gw4Tzi6vXemZ+qah2YtPuvu/VTlQ7Ue1EtRP7UF/UVFRUVFQ8GHcRcCNXZvj3ZXtQCt8VirpUohQ4kP546JdS0/+yj2AN8Q5GfaKsOR6X3lVxN07rpfLhw/5ZwtfSxui7KozTw/Z92Is9am1/Xi89dg92Jzn7m3w10nwXgX8T2FW4xtu3Jyg/Tm4exzHgDpXbOcdqueR/ffEFN1dXeG3K3QxlTNm6/SyCqOLx+DIZ027J9OgRYRpw0SEpW+rP4iIvCL4Q8uAsG4iqIDh80xAmU8JkStMYAffeI9mRxLKIeG+qvjpIkkAsZWh/bjkZ8Uw5GnlGLVNF6hBR1E+MTJcMHaKQ8wTvA86Za7ikTChkNedoo95hASRFcE4JpnOW6+eR0q/IIaKHXC6gmUyZH5/gJhMkZ0I8RrqlpVhNEU0dmtZo7lA8JekJIKBYmlknw4Si92gITvn1e+/wm/ffI4RgT19RSsdjZqOSFmJcgkNq7lPelnEgCQDRTMyJxXLJV998w3c/nCJaUrcCx4fHPH3yLrPZEThfljSUesTiRvR1iioiSkyWuSPmRErR3NgLAU85kUVpfMPsYM50NifG+KPG9y8F1U5s+rAX1U5UO1HtRLUTe1Bf1FRUVFRUPBg55y0Cvq3gGbEZBz0c9muhuN5SYRrx2ZAno8UDBd9s9GMSapvHKumG3JnaMaa6W8RvpITeIm5DcxultFfihj1vkET+UrG1XnxnO/y463ZLmd66P7f3n744Ja7XfPrb39E0UwQPvqyV957Qr3cXxZUgkFksqOP0YE7Oynp5Qo6Rdr0ma7ZMEipDgECnvcLZIH6Cb2Y4Pymqn2ApSEvKVKW0bUQxZ4sFEDST4pqui1g2i2Tu6qX+ZhJwIgQRnCiiCXUZdQmcPUM5duY2r54sCjEBSk5CFxPiBQnGLJ0ogUzjhcY3CM6W7ztbsy/qEWZ4GnIOBDzBZ1K0YIndek23viGlFie2Tl9zQl2fgcSup/fBVGCvqBN8ed5DCEwbz2effsKTx49w3pMk2QRhh3gPSmmJN5BzRlPuZ18W5NOBepvAiCrrtuXs8oK//PUZ55fXqJ/gxDKmPHnylKdP32U+P7S/N9oHcrW/SaoeFW+eHBlSFGJMtLGj61q62NHF/jPSxY4sRuR90zCdTQlNePAY/yWh2olqJ+5CtRPVTlQ7cbedqC9qKioqKioejPsIuIMhEGQI4bYS1/MS7b8OcmhRSHvFcqNO9uR4101d1dIkmtF/uUu3tbRn/4h8j9VRlB3CPjpE9yt0DFdBb8ujPxH2nfPbMEHYXmrwZurrP++//obfvPdr/sO/+/f40JiC6DwEI8DOeVxZPoEq3vvi4m2u0uosoKTEZBkbJJE000kyQhiNCGrOiEISpRNHKxBTYr1eElNHipEYI90607WJrk2kLtN2LavYsood625NbjMxt2jOeGcpSglYIMcUrY+WUxQlg8s4l8FnhEDOayZhZss+1BHUW6DDmOhioqMjlbSn3qpm4iMTH8iqJc6iB+/xziPkMml2pMUNTZqS2sT6Zsl6eUXs1kjqhhUhvRtEsDiZNsl2kFVwlOc8ZXDCxMN7777DZ59+yuzggN6hfN8Sjg0RV3IJyNinwLUyNuXWkl42ZWGxuuGfnz/nq2++JYpD8SCJ+WTG08dPOTo8xruGGBN4Z6laCwHfqjerZfDoIm27Zt2tWbetxRtInf3ESJKAZC2hLDwHB7M3MNp//qh2otqJV0G1E9VOVDuxjfqipqKioqLiwUjFpT30BHzXxV0tsr6q0AumphD1+yxdqzAiitq7smcc5k4+El+t3Ch0wKBoDoH+zMUY50oZc1N1bNztfSHFQ6yD4n/rSouyxef69e0j8uhGuq4z99dNPzfnUdgEg8s8mAo1UhDvcsMefw5EZKi0P5cygRlIqN+0v8X6byuWr4J98QP29XO37L62Xtb+fg798n47VyZTqpbG023GRD8iZgdTPvjgfcbTrj4AaX9vylDBeYczuRQV2zFeMjGMN8sLbEOtnzviSgYJV8igTeNE+3XzimbIyQhi6hJtjKzWa1arFav1msXihsuLCxbXC5ara9arFcvlmtVqzfJmbUS6S8SUiNKRSQhCVoubkAHNmUnIOPUoGSGirgRATJalIktGgKRC57y524upjd4HvGuwq5DAC86D3Dia6RQE2sUN6/UK1RKAkkAIk55144LHeU8Idj11GI4yEFwnwmeffMxv3nuXSXB4ZwE9+zG9Ty3NImSxMiLDhbebp4rPmYCQUuT66oJnz77k/OKUmFaowNR5jo4POTk5ZjadoJpJSVBf1F2weBJI+RcRIllbizEQMxIjQSNeW3Jck3PCBY/XgMORxVT0+XRy79j9e0G1E1Q7sadstRPVTlQ7cb+dqC9qKioqKioejCwZX9RJVxRO5yz9qlOHekqk/57A2XE9IR6IkttQnF4l7bVTP9Bw26taXFe3eNlGxRxcnF8qEMpQp1n8Pl3lroaqo5++/PhkRh3Hjfo/Uo7GnXEbd/q7iO2d6p8qOgq8OSixW53YPe7NqJP7sM9dfaxejsl4v21f/ATn2EvA++rvuh63N21iQqjbLWfXqb/nY0ptWxhdOrESXm+V7q+4649146EgOGfqox+qLllnvK3wZwKqYXQN7GAj6Da2sgg5CaKRruvouki7jqxWHavliuvFDTfLJefXp1wsLrm4vOB6sWRx07JcJ7J4vHdFvc2IU6SB2NnY89ITWpsIiJY0r2wmz85ytiIajZA6618zmRJ8IMcO0YxzivdGvkOY4l0Yrpn3fvjp72N/pbx3PHn8iM8//5ST40MgY9k4GCaou+7sAwHXMjnaPGBoea48IElYr1Z8+903PHv2VxaLKzTn8qIgcHB4yOHRIc0kEGNHUm8E3HsLIqpS+iBDEE5TXzO5BKaUHMmxpetaFOVgfgg6BeeJKYPzhEl9UQPVTmw1Xe1EtRPVTlQ78Yp2or6oqaioqKh4MHLOiBNTRpwjjLMsIKiU2ANqRNx2u5G6tyFwY9JmxKQn58aDxDnLsgCDkR5j69gRJx3rhdATI906bijYbxurL1vkef91uGt9/d6ybNxw30SQxA3JvU0qtz4Hn+Mf1+a47bv6s7t/a6nDWEl/Sd13qa6vi5de5327N0Pw1v47a9OdMv1YvKM/WiaBzjlC6J8LU2ubJuCcZz43UqdiZF3VlHlxSiLTdmu6rqNtW9brjsVixWJh6urV1RUXFxfl55Kz0zOurq6KO/aaqIngLXFJVCPgFk5BETGCLZrxoVdRPU4muAYcE5rgzPs9OJqmYdLMcD6AgFcdniPTi7W4jCtCAoUPP3iP3/32A+YHplja+Zd1/zvku483kLPFYmA81mzWCygZpcuRH87O+MMf/8Tz589JMdHgcOqYNoGTkxOOjk9QHMvVylLBeosL0biAqrPzVbBYmh4wd/UYI23bslotWa3WiAjz+Zzj48fkFFjcrFmtIzE7y45SUe3EqO/3/b61r9qJaieqnfi7txPVglRUVFRUPBib2AP9mu1CLIpr7KBcWhZKU4JwiPTu3/cRVVfclZ3pW2qu5kH73zeK45h82+em6kFTdM6EL7etUPZu4Vtw4y/lILdhY2MCNq5rH/m8dV7aq2tue9u4+R1X9vswVp/GSqFzMi51Z1v72n219u4vs6uUjon3PgL+Kqrr3j6Pj9ndcKvEy/t8177Xwdak7o773I+9PpipzaE8G0XXg7PMNMNqBfXluy2/EIX5wYyj+UFR7yxzhi8KbIyZtu1ou47lzYrLiyvOzi44PT3j+xff8uLslMvLSy4ur1jc3LBuW9q2IyZBvJKzICjBOwSP91Nm00OaZmITbBIuWH99KAEwnf0d8Lo9kSqisonGDuYHEz779GPe+9VTnNNhYpoz4CgEeMedPedR0MzxDWLwnkginN8s+POzZ/zp//2Z68UCTwlYKY7ZdMbR0TFhMmUdE1KWx/jg8L4h0eCcN7KfxParGyZAMXXc3CxYrpa0XctkNuPRo6fM50dcXq7porBaJ1arREqeimonoNqJu8pUO0G1E9VO3DlG6ouaioqKiooHo0+7mgvRdhRl1AMlfeWGQJnqYGQds8LlOO/9FlErX+y4YrAdxoGld0t2t0llT+xUbH9fl+9Js8MysvbbrSPc1lOHmktfdrbqaN/oWtyFjTJWJg066usd5G6fu/vYFX6X3I6P2SLcI9l4HPzuVXBX/+5qd5cw9WV6t+Yx+X6Z0vqq2C1tXM/up7pXpd8b7Dun8fY3gY0nQP98lP5qQtUN+90waMv30aTK4RicxxWcL+RcFV/GWeM88+kcOESfPkE+/NCCLKZMG9es1iuubxZcXl7x4vSMF6ennJ6ecXp2ztnlOYvra26WS7oYESkEfHZMaBqSWDYL0WTzBr9ZduKdxSOBEmxz9LdBsQCSH33wPv/688+YTadY/AIlC6hzqIwJt8Vs6OsZj2ww93NweO/IIrQp8eLsnP/zhz/wzbffkcXSOmtWJj4wm045Oj7GNxPamMqEWHEC3kcCDRAQwVKp5ozkXCYEGZFEjB1t1wJwdHTE4eERKp4uJtZdolknrq87njx5c2Pm54xqJ7avxV2odqLaidttVDvx92wn6ouaioqKiooHQ0SKUd0mX2YohRJjr0TrK8pnMcxOZSDRY5Wq/75NPO3/IjL29Mrq6esblXejz4F8j5SacsCm/GbjDqErrfUNWwd5fVo3rnGbFb6M2N0ipPcW36WjsvM5DiL5cuyqla9adnwPewL+Mlf23UnF7r5XJ8DjSch+xXlfXff166Hk2+Zpd0xgytDakGy3U7T/vR/xu6qb2GhVN9rniupo290mAIIFv1TFC4SJ5+DwkMePD/m1vksXI1mUrovEnOm6aOT8+orz83NOzy84O7vk8vKGxc3a3OdXC65vrlmtVyTNliGFgGror7q1W+7/cO4iHEynfP7Zv+KjDz9iOpmguom7oEVhHdKslu/D2BiuUZmYlImWYmR/ebPkq6++4quvv2a9XtOndQZwIQyEOYSGJBBTBJcJzhRppwHvG1SDBfNMHSknRCwFbs6RlCKqynw+5+T4hMlkyuXlgsXN0oJ/ZsfiJrK4ia83YH6hqHbi9VHtRLUT1U5UO1Ff1FRUVFRUPBi9Gubd9lrh3iiKWtpIdZYSFTzea1GDZFB+erV0oygW/dI5enMusjG+zoHnNlEffncMZN+oTfnXq3SveZ7byqi7RapelaC5vvM/ldBeqrYJUFFIdaOUvgz3qaKv1Y0R6R6T75e1O/58uDJZlilYRaO7dn99uy74Pzm0Z9/bBJqBdNv2ogdu+jn8p0CGopeaMjyaSDpQ7b0ANk05bN7ryvPkg+cgTMmizGYTpB/eWXHuQxQh5kyKmXWbWC5bbhY3XJy/4OzslBfnp1xcXnN2ccXF5ZKbZUsXO7Jku+aNXduU0rAE5unjJ3z+2eecHJ/g1A2TCBuqt13Zx2R8F+PlAyklrq4uefbXf+L0xakFenRqASVx+CZwfHLC4fwQ5z1tzLRdwrlI45Ip1urwfgLqLd1qbsm5QzQhmlE1oj6dTpnP54TG0rauliuyKC5MyOpZLFuuFu2PHSW/CFQ7sWn3VVDtxP3tVjtR7cTfi52oL2oqKioqKh6Mnmz3HGDjvm4riXtFyLmxMNnHKjBieBfxsZSKYiS8l0LYEMx9auOG6OlQ1uEGOjMcf+9ZaWl76ImdQy+86YbSvT569Wpn644b9dCTWyqp3tuqG5WjuOoOZ/sAXvlj3Lp3Cfi+eu9r66EYtyRWIX2QQrh9Drtkf1e1/+nQt+k3n+PUwWDq4Xi5xc7YNqlVLL1qGVgln4WVcKGUL2v7nWxIuAPE3Olt2YizY9WWqTRNQHLGhcDMTcgiHB973K8aEEHzx3Qp0qVI22WuFmvOL244Pb3k9PyM8/Mzzs/Pubq64nqxYHF9TZsywQd+//vf8/HvPiYQjNDiLJWy2jmba/82Cb/rXtiE2vblnLm6uOKH775ndbNEskVIsAk/uOA5OjpiPp/jQyC3HW3s8BrJPhJcPz4SOdsSnBgjMbammKaueIcEJiVJS9t2OKc0kwmHRwFZZkSh7SLrdfWogWonXh/VTozru6+th6LaiWonfg52wv3N3ghWVFRUVFRUVFRUVFRUVFRUVNyLGo6+oqKioqKioqKioqKioqKi4i1BfVFTUVFRUVFRUVFRUVFRUVFR8ZagvqipqKioqKioqKioqKioqKioeEtQX9RUVFRUVFRUVFRUVFRUVFRUvCWoL2oqKioqKioqKioqKioqKioq3hLUFzUVFRUVFRUVFRUVFRUVFRUVbwn+P8gRhUJZ2SfDAAAAAElFTkSuQmCC\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "if image_to_image:\n", + " result = get_final_image(final_frames_list, crop_frames_list, full_frames[0], tfm_array_list, handler)\n", + " show_images([source[0][:, :, ::-1], target_full, result], ['Source Image', 'Target Image', 'Swapped Image'], figsize=(20, 15))\n", + "else:\n", + " get_final_video(final_frames_list,\n", + " crop_frames_list,\n", + " full_frames,\n", + " tfm_array_list,\n", + " OUT_VIDEO_NAME,\n", + " fps, \n", + " handler)\n", + " add_audio_from_another_video(path_to_video, OUT_VIDEO_NAME, \"audio\")" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "id": "naughty-edition", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Full pipeline took 1.514739751815796\n" + ] + }, + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/home/jovyan/.local/lib/python3.8/site-packages/ipykernel/ipkernel.py:283: DeprecationWarning: `should_run_async` will not call `transform_cell` automatically in the future. Please pass the result to `transformed_cell` argument and any exception that happen during thetransform in `preprocessing_exc_tuple` in IPython 7.17 and above.\n", + " and should_run_async(code)\n" + ] + } + ], + "source": [ + "print(f'Full pipeline took {time.time() - START_TIME}')\n", + "if not image_to_image:\n", + " print(f\"Video saved with path {OUT_VIDEO_NAME}\")" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "facesh", + "language": "python", + "name": "facesh" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.8" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/apex/.gitignore b/apex/.gitignore new file mode 100644 index 0000000000000000000000000000000000000000..9c1aa26fee800ebc7b544b5216669406f1ec3985 --- /dev/null +++ b/apex/.gitignore @@ -0,0 +1,6 @@ +apex.egg-info +dist +build +docs/build +*~ +__pycache__ diff --git a/apex/.gitmodules b/apex/.gitmodules new file mode 100644 index 0000000000000000000000000000000000000000..6479428db0dd65069c9261a9eeff02e32813561d --- /dev/null +++ b/apex/.gitmodules @@ -0,0 +1,7 @@ +[submodule "apex/contrib/csrc/multihead_attn/cutlass"] + path = apex/contrib/csrc/multihead_attn/cutlass + url = https://github.com/NVIDIA/cutlass.git + branch = v1.2.0 +[submodule "apex/contrib/csrc/cudnn-frontend"] + path = apex/contrib/csrc/cudnn-frontend + url = https://github.com/NVIDIA/cudnn-frontend.git diff --git a/apex/.nojekyll b/apex/.nojekyll new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/LICENSE b/apex/LICENSE new file mode 100644 index 0000000000000000000000000000000000000000..3d1e9454ff796daeba01a60f5131491d02f026fa --- /dev/null +++ b/apex/LICENSE @@ -0,0 +1,11 @@ +All rights reserved. + +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. \ No newline at end of file diff --git a/apex/README.md b/apex/README.md new file mode 100644 index 0000000000000000000000000000000000000000..a761def7b7effd9cedfa9357ddca745964a9f852 --- /dev/null +++ b/apex/README.md @@ -0,0 +1,146 @@ +# Introduction + +This repository holds NVIDIA-maintained utilities to streamline +mixed precision and distributed training in Pytorch. +Some of the code here will be included in upstream Pytorch eventually. +The intention of Apex is to make up-to-date utilities available to +users as quickly as possible. + +## Full API Documentation: [https://nvidia.github.io/apex](https://nvidia.github.io/apex) + +## [GTC 2019](https://github.com/mcarilli/mixed_precision_references/tree/master/GTC_2019) and [Pytorch DevCon 2019](https://github.com/mcarilli/mixed_precision_references/tree/master/Pytorch_Devcon_2019) Slides + +# Contents + +## 1. Amp: Automatic Mixed Precision + +`apex.amp` is a tool to enable mixed precision training by changing only 3 lines of your script. +Users can easily experiment with different pure and mixed precision training modes by supplying +different flags to `amp.initialize`. + +[Webinar introducing Amp](https://info.nvidia.com/webinar-mixed-precision-with-pytorch-reg-page.html) +(The flag `cast_batchnorm` has been renamed to `keep_batchnorm_fp32`). + +[API Documentation](https://nvidia.github.io/apex/amp.html) + +[Comprehensive Imagenet example](https://github.com/NVIDIA/apex/tree/master/examples/imagenet) + +[DCGAN example coming soon...](https://github.com/NVIDIA/apex/tree/master/examples/dcgan) + +[Moving to the new Amp API](https://nvidia.github.io/apex/amp.html#transition-guide-for-old-api-users) (for users of the deprecated "Amp" and "FP16_Optimizer" APIs) + +## 2. Distributed Training + +`apex.parallel.DistributedDataParallel` is a module wrapper, similar to +`torch.nn.parallel.DistributedDataParallel`. It enables convenient multiprocess distributed training, +optimized for NVIDIA's NCCL communication library. + +[API Documentation](https://nvidia.github.io/apex/parallel.html) + +[Python Source](https://github.com/NVIDIA/apex/tree/master/apex/parallel) + +[Example/Walkthrough](https://github.com/NVIDIA/apex/tree/master/examples/simple/distributed) + +The [Imagenet example](https://github.com/NVIDIA/apex/tree/master/examples/imagenet) +shows use of `apex.parallel.DistributedDataParallel` along with `apex.amp`. + +### Synchronized Batch Normalization + +`apex.parallel.SyncBatchNorm` extends `torch.nn.modules.batchnorm._BatchNorm` to +support synchronized BN. +It allreduces stats across processes during multiprocess (DistributedDataParallel) training. +Synchronous BN has been used in cases where only a small +local minibatch can fit on each GPU. +Allreduced stats increase the effective batch size for the BN layer to the +global batch size across all processes (which, technically, is the correct +formulation). +Synchronous BN has been observed to improve converged accuracy in some of our research models. + +### Checkpointing + +To properly save and load your `amp` training, we introduce the `amp.state_dict()`, which contains all `loss_scalers` and their corresponding unskipped steps, +as well as `amp.load_state_dict()` to restore these attributes. + +In order to get bitwise accuracy, we recommend the following workflow: +```python +# Initialization +opt_level = 'O1' +model, optimizer = amp.initialize(model, optimizer, opt_level=opt_level) + +# Train your model +... +with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() +... + +# Save checkpoint +checkpoint = { + 'model': model.state_dict(), + 'optimizer': optimizer.state_dict(), + 'amp': amp.state_dict() +} +torch.save(checkpoint, 'amp_checkpoint.pt') +... + +# Restore +model = ... +optimizer = ... +checkpoint = torch.load('amp_checkpoint.pt') + +model, optimizer = amp.initialize(model, optimizer, opt_level=opt_level) +model.load_state_dict(checkpoint['model']) +optimizer.load_state_dict(checkpoint['optimizer']) +amp.load_state_dict(checkpoint['amp']) + +# Continue training +... +``` + +Note that we recommend restoring the model using the same `opt_level`. Also note that we recommend calling the `load_state_dict` methods after `amp.initialize`. + +# Requirements + +Python 3 + +CUDA 9 or newer + +PyTorch 0.4 or newer. The CUDA and C++ extensions require pytorch 1.0 or newer. + +We recommend the latest stable release, obtainable from +[https://pytorch.org/](https://pytorch.org/). We also test against the latest master branch, obtainable from [https://github.com/pytorch/pytorch](https://github.com/pytorch/pytorch). + +It's often convenient to use Apex in Docker containers. Compatible options include: +* [NVIDIA Pytorch containers from NGC](https://ngc.nvidia.com/catalog/containers/nvidia%2Fpytorch), which come with Apex preinstalled. To use the latest Amp API, you may need to `pip uninstall apex` then reinstall Apex using the **Quick Start** commands below. +* [official Pytorch -devel Dockerfiles](https://hub.docker.com/r/pytorch/pytorch/tags), e.g. `docker pull pytorch/pytorch:nightly-devel-cuda10.0-cudnn7`, in which you can install Apex using the **Quick Start** commands. + +See the [Docker example folder](https://github.com/NVIDIA/apex/tree/master/examples/docker) for details. + +# Quick Start + +### Linux + +For performance and full functionality, we recommend installing Apex with +CUDA and C++ extensions via +``` +git clone https://github.com/NVIDIA/apex +cd apex +pip install -v --disable-pip-version-check --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./ +``` + +Apex also supports a Python-only build (required with Pytorch 0.4) via +``` +pip install -v --disable-pip-version-check --no-cache-dir ./ +``` +A Python-only build omits: +- Fused kernels required to use `apex.optimizers.FusedAdam`. +- Fused kernels required to use `apex.normalization.FusedLayerNorm`. +- Fused kernels that improve the performance and numerical stability of `apex.parallel.SyncBatchNorm`. +- Fused kernels that improve the performance of `apex.parallel.DistributedDataParallel` and `apex.amp`. +`DistributedDataParallel`, `amp`, and `SyncBatchNorm` will still be usable, but they may be slower. + +Pyprof support has been moved to its own [dedicated repository](https://github.com/NVIDIA/PyProf). +The codebase is deprecated in Apex and will be removed soon. + +### Windows support +Windows support is experimental, and Linux is recommended. `pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" .` may work if you were able to build Pytorch from source +on your system. `pip install -v --no-cache-dir .` (without CUDA/C++ extensions) is more likely to work. If you installed Pytorch in a Conda environment, make sure to install Apex in that same environment. diff --git a/apex/apex/RNN/README.md b/apex/apex/RNN/README.md new file mode 100644 index 0000000000000000000000000000000000000000..9e86fd8fc1eecb066b10814fea5967acbb67fe7b --- /dev/null +++ b/apex/apex/RNN/README.md @@ -0,0 +1 @@ +Under construction... diff --git a/apex/apex/RNN/RNNBackend.py b/apex/apex/RNN/RNNBackend.py new file mode 100644 index 0000000000000000000000000000000000000000..b9d4937efa583710c2eddb617da10bd824db9371 --- /dev/null +++ b/apex/apex/RNN/RNNBackend.py @@ -0,0 +1,365 @@ +import torch +import torch.nn as nn +from torch.autograd import Variable + +import torch.nn.functional as F + +import math + + +def is_iterable(maybe_iterable): + return isinstance(maybe_iterable, list) or isinstance(maybe_iterable, tuple) + + +def flatten_list(tens_list): + """ + flatten_list + """ + if not is_iterable(tens_list): + return tens_list + + return torch.cat(tens_list, dim=0).view(len(tens_list), *tens_list[0].size() ) + + +#These modules always assumes batch_first +class bidirectionalRNN(nn.Module): + """ + bidirectionalRNN + """ + def __init__(self, inputRNN, num_layers=1, dropout = 0): + super(bidirectionalRNN, self).__init__() + self.dropout = dropout + self.fwd = stackedRNN(inputRNN, num_layers=num_layers, dropout = dropout) + self.bckwrd = stackedRNN(inputRNN.new_like(), num_layers=num_layers, dropout = dropout) + self.rnns = nn.ModuleList([self.fwd, self.bckwrd]) + + #collect hidden option will return all hidden/cell states from entire RNN + def forward(self, input, collect_hidden=False): + """ + forward() + """ + seq_len = input.size(0) + bsz = input.size(1) + + fwd_out, fwd_hiddens = list(self.fwd(input, collect_hidden = collect_hidden)) + bckwrd_out, bckwrd_hiddens = list(self.bckwrd(input, reverse=True, collect_hidden = collect_hidden)) + + output = torch.cat( [fwd_out, bckwrd_out], -1 ) + hiddens = tuple( torch.cat(hidden, -1) for hidden in zip( fwd_hiddens, bckwrd_hiddens) ) + + return output, hiddens + + def reset_parameters(self): + """ + reset_parameters() + """ + for rnn in self.rnns: + rnn.reset_parameters() + + def init_hidden(self, bsz): + """ + init_hidden() + """ + for rnn in self.rnns: + rnn.init_hidden(bsz) + + def detach_hidden(self): + """ + detach_hidden() + """ + for rnn in self.rnns: + rnn.detachHidden() + + def reset_hidden(self, bsz): + """ + reset_hidden() + """ + for rnn in self.rnns: + rnn.reset_hidden(bsz) + + def init_inference(self, bsz): + """ + init_inference() + """ + for rnn in self.rnns: + rnn.init_inference(bsz) + + +#assumes hidden_state[0] of inputRNN is output hidden state +#constructor either takes an RNNCell or list of RNN layers +class stackedRNN(nn.Module): + """ + stackedRNN + """ + def __init__(self, inputRNN, num_layers=1, dropout=0): + super(stackedRNN, self).__init__() + + self.dropout = dropout + + if isinstance(inputRNN, RNNCell): + self.rnns = [inputRNN] + for i in range(num_layers-1): + self.rnns.append(inputRNN.new_like(inputRNN.output_size)) + elif isinstance(inputRNN, list): + assert len(inputRNN) == num_layers, "RNN list length must be equal to num_layers" + self.rnns=inputRNN + else: + raise RuntimeError() + + self.nLayers = len(self.rnns) + + self.rnns = nn.ModuleList(self.rnns) + + + ''' + Returns output as hidden_state[0] Tensor([sequence steps][batch size][features]) + If collect hidden will also return Tuple( + [n_hidden_states][sequence steps] Tensor([layer][batch size][features]) + ) + If not collect hidden will also return Tuple( + [n_hidden_states] Tensor([layer][batch size][features]) + ''' + def forward(self, input, collect_hidden=False, reverse=False): + """ + forward() + """ + seq_len = input.size(0) + bsz = input.size(1) + inp_iter = reversed(range(seq_len)) if reverse else range(seq_len) + + hidden_states = [[] for i in range(self.nLayers)] + outputs = [] + + for seq in inp_iter: + for layer in range(self.nLayers): + + if layer == 0: + prev_out = input[seq] + + outs = self.rnns[layer](prev_out) + + if collect_hidden: + hidden_states[layer].append(outs) + elif seq == seq_len-1: + hidden_states[layer].append(outs) + + prev_out = outs[0] + + outputs.append(prev_out) + + if reverse: + outputs = list(reversed(outputs)) + ''' + At this point outputs is in format: + list( [seq_length] x Tensor([bsz][features]) ) + need to convert it to: + list( Tensor([seq_length][bsz][features]) ) + ''' + output = flatten_list(outputs) + + ''' + hidden_states at this point is in format: + list( [layer][seq_length][hidden_states] x Tensor([bsz][features]) ) + need to convert it to: + For not collect hidden: + list( [hidden_states] x Tensor([layer][bsz][features]) ) + For collect hidden: + list( [hidden_states][seq_length] x Tensor([layer][bsz][features]) ) + ''' + if not collect_hidden: + seq_len = 1 + n_hid = self.rnns[0].n_hidden_states + new_hidden = [ [ [ None for k in range(self.nLayers)] for j in range(seq_len) ] for i in range(n_hid) ] + + + for i in range(n_hid): + for j in range(seq_len): + for k in range(self.nLayers): + new_hidden[i][j][k] = hidden_states[k][j][i] + + hidden_states = new_hidden + #Now in format list( [hidden_states][seq_length][layer] x Tensor([bsz][features]) ) + #Reverse seq_length if reverse + if reverse: + hidden_states = list( list(reversed(list(entry))) for entry in hidden_states) + + #flatten layer dimension into tensor + hiddens = list( list( + flatten_list(seq) for seq in hidden ) + for hidden in hidden_states ) + + #Now in format list( [hidden_states][seq_length] x Tensor([layer][bsz][features]) ) + #Remove seq_length dimension if not collect_hidden + if not collect_hidden: + hidden_states = list( entry[0] for entry in hidden_states) + return output, hidden_states + + def reset_parameters(self): + """ + reset_parameters() + """ + for rnn in self.rnns: + rnn.reset_parameters() + + def init_hidden(self, bsz): + """ + init_hidden() + """ + for rnn in self.rnns: + rnn.init_hidden(bsz) + + def detach_hidden(self): + """ + detach_hidden() + """ + for rnn in self.rnns: + rnn.detach_hidden() + + def reset_hidden(self, bsz): + """ + reset_hidden() + """ + for rnn in self.rnns: + rnn.reset_hidden(bsz) + + def init_inference(self, bsz): + """ + init_inference() + """ + for rnn in self.rnns: + rnn.init_inference(bsz) + +class RNNCell(nn.Module): + """ + RNNCell + gate_multiplier is related to the architecture you're working with + For LSTM-like it will be 4 and GRU-like will be 3. + Always assumes input is NOT batch_first. + Output size that's not hidden size will use output projection + Hidden_states is number of hidden states that are needed for cell + if one will go directly to cell as tensor, if more will go as list + """ + def __init__(self, gate_multiplier, input_size, hidden_size, cell, n_hidden_states = 2, bias = False, output_size = None): + super(RNNCell, self).__init__() + + self.gate_multiplier = gate_multiplier + self.input_size = input_size + self.hidden_size = hidden_size + self.cell = cell + self.bias = bias + self.output_size = output_size + if output_size is None: + self.output_size = hidden_size + + self.gate_size = gate_multiplier * self.hidden_size + self.n_hidden_states = n_hidden_states + + self.w_ih = nn.Parameter(torch.Tensor(self.gate_size, self.input_size)) + self.w_hh = nn.Parameter(torch.Tensor(self.gate_size, self.output_size)) + + #Check if there's recurrent projection + if(self.output_size != self.hidden_size): + self.w_ho = nn.Parameter(torch.Tensor(self.output_size, self.hidden_size)) + + self.b_ih = self.b_hh = None + if self.bias: + self.b_ih = nn.Parameter(torch.Tensor(self.gate_size)) + self.b_hh = nn.Parameter(torch.Tensor(self.gate_size)) + + #hidden states for forward + self.hidden = [ None for states in range(self.n_hidden_states)] + + self.reset_parameters() + + def new_like(self, new_input_size=None): + """ + new_like() + """ + if new_input_size is None: + new_input_size = self.input_size + + return type(self)(self.gate_multiplier, + new_input_size, + self.hidden_size, + self.cell, + self.n_hidden_states, + self.bias, + self.output_size) + + + #Use xavier where we can (weights), otherwise use uniform (bias) + def reset_parameters(self, gain=1): + """ + reset_parameters() + """ + stdev = 1.0 / math.sqrt(self.hidden_size) + for param in self.parameters(): + param.data.uniform_(-stdev, stdev) + ''' + Xavier reset: + def reset_parameters(self, gain=1): + stdv = 1.0 / math.sqrt(self.gate_size) + + for param in self.parameters(): + if (param.dim() > 1): + torch.nn.init.xavier_normal(param, gain) + else: + param.data.uniform_(-stdv, stdv) + ''' + def init_hidden(self, bsz): + """ + init_hidden() + """ + for param in self.parameters(): + if param is not None: + a_param = param + break + + for i, _ in enumerate(self.hidden): + if(self.hidden[i] is None or self.hidden[i].data.size()[0] != bsz): + + if i==0: + hidden_size = self.output_size + else: + hidden_size = self.hidden_size + + tens = a_param.data.new(bsz, hidden_size).zero_() + self.hidden[i] = Variable(tens, requires_grad=False) + + + def reset_hidden(self, bsz): + """ + reset_hidden() + """ + for i, _ in enumerate(self.hidden): + self.hidden[i] = None + self.init_hidden(bsz) + + def detach_hidden(self): + """ + detach_hidden() + """ + for i, _ in enumerate(self.hidden): + if self.hidden[i] is None: + raise RuntimeError("Must initialize hidden state before you can detach it") + for i, _ in enumerate(self.hidden): + self.hidden[i] = self.hidden[i].detach() + + def forward(self, input): + """ + forward() + if not inited or bsz has changed this will create hidden states + """ + self.init_hidden(input.size()[0]) + + hidden_state = self.hidden[0] if self.n_hidden_states == 1 else self.hidden + self.hidden = self.cell(input, hidden_state, self.w_ih, self.w_hh, b_ih=self.b_ih, b_hh=self.b_hh) + if(self.n_hidden_states > 1): + self.hidden = list(self.hidden) + else: + self.hidden=[self.hidden] + + if self.output_size != self.hidden_size: + self.hidden[0] = F.linear(self.hidden[0], self.w_ho) + + return tuple(self.hidden) diff --git a/apex/apex/RNN/__init__.py b/apex/apex/RNN/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..d70674666969bb874cd7c0af9193510c6c26f0c2 --- /dev/null +++ b/apex/apex/RNN/__init__.py @@ -0,0 +1,3 @@ +from .models import LSTM, GRU, ReLU, Tanh, mLSTM + +__all__ = ['models'] diff --git a/apex/apex/RNN/cells.py b/apex/apex/RNN/cells.py new file mode 100644 index 0000000000000000000000000000000000000000..32b61a1be18a9788f83865cbb15fa32e1aaa0fc1 --- /dev/null +++ b/apex/apex/RNN/cells.py @@ -0,0 +1,84 @@ +import torch +import torch.nn as nn +import torch.nn.functional as F + +from .RNNBackend import RNNCell + +from torch.nn._functions.thnn import rnnFusedPointwise as fusedBackend + +import math + + +class mLSTMRNNCell(RNNCell): + """ + mLSTMRNNCell + """ + + def __init__(self, input_size, hidden_size, bias = False, output_size = None): + gate_multiplier = 4 + super(mLSTMRNNCell, self).__init__(gate_multiplier, input_size, hidden_size, mLSTMCell, n_hidden_states = 2, bias = bias, output_size = output_size) + + self.w_mih = nn.Parameter(torch.Tensor(self.output_size, self.input_size)) + self.w_mhh = nn.Parameter(torch.Tensor(self.output_size, self.output_size)) + + self.reset_parameters() + + def forward(self, input): + """ + mLSTMRNNCell.forward() + """ + #if not inited or bsz has changed this will create hidden states + self.init_hidden(input.size()[0]) + + hidden_state = self.hidden[0] if self.n_hidden_states == 1 else self.hidden + + self.hidden = list( + self.cell(input, hidden_state, self.w_ih, self.w_hh, self.w_mih, self.w_mhh, + b_ih=self.b_ih, b_hh=self.b_hh) + ) + + if self.output_size != self.hidden_size: + self.hidden[0] = F.linear(self.hidden[0], self.w_ho) + return tuple(self.hidden) + + + def new_like(self, new_input_size=None): + if new_input_size is None: + new_input_size = self.input_size + + return type(self)( + new_input_size, + self.hidden_size, + self.bias, + self.output_size) + +def mLSTMCell(input, hidden, w_ih, w_hh, w_mih, w_mhh, b_ih=None, b_hh=None): + """ + mLSTMCell + """ + + if input.is_cuda: + igates = F.linear(input, w_ih) + m = F.linear(input, w_mih) * F.linear(hidden[0], w_mhh) + hgates = F.linear(m, w_hh) + + state = fusedBackend.LSTMFused.apply + return state(igates, hgates, hidden[1], b_ih, b_hh) + + hx, cx = hidden + + m = F.linear(input, w_mih) * F.linear(hidden[0], w_mhh) + gates = F.linear(input, w_ih, b_ih) + F.linear(m, w_hh, b_hh) + + ingate, forgetgate, cellgate, outgate = gates.chunk(4, 1) + + ingate = F.sigmoid(ingate) + forgetgate = F.sigmoid(forgetgate) + cellgate = F.tanh(cellgate) + outgate = F.sigmoid(outgate) + + cy = (forgetgate * cx) + (ingate * cellgate) + hy = outgate * F.tanh(cy) + + return hy, cy + diff --git a/apex/apex/RNN/models.py b/apex/apex/RNN/models.py new file mode 100644 index 0000000000000000000000000000000000000000..dd7adce04781a305749643b5caec7cae854a73ad --- /dev/null +++ b/apex/apex/RNN/models.py @@ -0,0 +1,54 @@ +import torch + +from torch.nn._functions.rnn import LSTMCell, RNNReLUCell, RNNTanhCell, GRUCell + +from .RNNBackend import bidirectionalRNN, stackedRNN, RNNCell +from .cells import mLSTMRNNCell, mLSTMCell + +def toRNNBackend(inputRNN, num_layers, bidirectional=False, dropout = 0): + """ + :class:`toRNNBackend` + """ + + if bidirectional: + return bidirectionalRNN(inputRNN, num_layers, dropout = dropout) + else: + return stackedRNN(inputRNN, num_layers, dropout = dropout) + + +def LSTM(input_size, hidden_size, num_layers, bias=True, batch_first=False, dropout=0, bidirectional=False, output_size = None): + """ + :class:`LSTM` + """ + inputRNN = RNNCell(4, input_size, hidden_size, LSTMCell, 2, bias, output_size) + return toRNNBackend(inputRNN, num_layers, bidirectional, dropout=dropout) + +def GRU(input_size, hidden_size, num_layers, bias=True, batch_first=False, dropout=0, bidirectional=False, output_size = None): + """ + :class:`GRU` + """ + inputRNN = RNNCell(3, input_size, hidden_size, GRUCell, 1, bias, output_size) + return toRNNBackend(inputRNN, num_layers, bidirectional, dropout=dropout) + +def ReLU(input_size, hidden_size, num_layers, bias=True, batch_first=False, dropout=0, bidirectional=False, output_size = None): + """ + :class:`ReLU` + """ + inputRNN = RNNCell(1, input_size, hidden_size, RNNReLUCell, 1, bias, output_size) + return toRNNBackend(inputRNN, num_layers, bidirectional, dropout=dropout) + +def Tanh(input_size, hidden_size, num_layers, bias=True, batch_first=False, dropout=0, bidirectional=False, output_size = None): + """ + :class:`Tanh` + """ + inputRNN = RNNCell(1, input_size, hidden_size, RNNTanhCell, 1, bias, output_size) + return toRNNBackend(inputRNN, num_layers, bidirectional, dropout=dropout) + +def mLSTM(input_size, hidden_size, num_layers, bias=True, batch_first=False, dropout=0, bidirectional=False, output_size = None): + """ + :class:`mLSTM` + """ + inputRNN = mLSTMRNNCell(input_size, hidden_size, bias=bias, output_size=output_size) + return toRNNBackend(inputRNN, num_layers, bidirectional, dropout=dropout) + + diff --git a/apex/apex/__init__.py b/apex/apex/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..7027b032e6ffc08af52d56277b13a9bb6ef2332d --- /dev/null +++ b/apex/apex/__init__.py @@ -0,0 +1,20 @@ +# May help avoid undefined symbol errors https://pytorch.org/cppdocs/notes/faq.html#undefined-symbol-errors-from-pytorch-aten +import torch +import warnings + +if torch.distributed.is_available(): + from . import parallel + +from . import amp +from . import fp16_utils + +# For optimizers and normalization there is no Python fallback. +# Absence of cuda backend is a hard error. +# I would like the errors from importing fused_adam_cuda or fused_layer_norm_cuda +# to be triggered lazily, because if someone has installed with --cpp_ext and --cuda_ext +# so they expect those backends to be available, but for some reason they actually aren't +# available (for example because they built improperly in a way that isn't revealed until +# load time) the error message is timely and visible. +from . import optimizers +from . import normalization +from . import pyprof diff --git a/apex/apex/amp/README.md b/apex/apex/amp/README.md new file mode 100644 index 0000000000000000000000000000000000000000..a87b5010e374dd3c0c4b794cf9057a8b5a984924 --- /dev/null +++ b/apex/apex/amp/README.md @@ -0,0 +1,72 @@ +# amp: Automatic Mixed Precision + +## Annotating User Functions + +Nearly all PyTorch user code needs nothing more than the two steps +above to use amp. After all, custom layers are built out of simpler +PyTorch components, and amp already can see those. + +However, any custom C++ or CUDA code is outside of amp's (default) +view of things. For example, suppose I implemented a new recurrent +cell called a "forgetful recurrent unit" that calls directly into a +CUDA backend: + +```python +from backend import FRUBackend + +def fru(input, hidden, weight, bias): + # call to CUDA code + FRUBackend(input, hidden, weight, bias) +``` + +In this case, it is possible to get a runtime type mismatch. For +example, you might have `input` in fp16, and `weight` in fp32, and amp +doesn't have the visibility to insert an appropriate cast. + +amp exposes two ways to handle "invisible" backend code: function +annotations and explicit registration. + +#### Function annotation + +The first way to handle backend code is a set of function annotations: + +- `@amp.half_function` +- `@amp.float_function` +- `@amp.promote_function` + +These correspond to: + +- Cast all arguments to fp16 +- Cast all argumnets fo fp32 +- If there are any type mismatches, cast everything to the widest type + +In our example, we believe that the FRU unit is fp16-safe and will get +performance gains from casting its arguments to fp16, so we write: + +```python +@amp.half_function +def fru(input, hidden, weight, bias): + #... +``` + +#### Explicit registration + +The other way to handle backend code is with explicit function +registration: + +- `amp.register_half_function(module, function_name)` +- `amp.register_float_function(module, function_name)` +- `amp.register_promote_function(module, function_name)` + +When using this API, `module` is the containing class or module for +the function, and `function_name` is the _string_ name of the +function. Note that the function must be registered before the call to +`amp.initalize()`. + +For our FRU unit, we can register the backend function directly: + +```python +import backend + +amp.register_half_function(backend, 'FRUBackend') +``` diff --git a/apex/apex/amp/__init__.py b/apex/apex/amp/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..34d080a69ed614b138e3f3798c5876c558a00daa --- /dev/null +++ b/apex/apex/amp/__init__.py @@ -0,0 +1,5 @@ +from .amp import init, half_function, float_function, promote_function,\ + register_half_function, register_float_function, register_promote_function +from .handle import scale_loss, disable_casts +from .frontend import initialize, state_dict, load_state_dict +from ._amp_state import master_params, _amp_state diff --git a/apex/apex/amp/__version__.py b/apex/apex/amp/__version__.py new file mode 100644 index 0000000000000000000000000000000000000000..3a83701b29dea1314ed7de69bdbc0a59f2f6badd --- /dev/null +++ b/apex/apex/amp/__version__.py @@ -0,0 +1,2 @@ +VERSION = (0, 1, 0) +__version__ = '.'.join(map(str, VERSION)) diff --git a/apex/apex/amp/_amp_state.py b/apex/apex/amp/_amp_state.py new file mode 100644 index 0000000000000000000000000000000000000000..1ac9d31160ebff4a0ea346fa6f28bb7680015040 --- /dev/null +++ b/apex/apex/amp/_amp_state.py @@ -0,0 +1,69 @@ +# This is a "header object" that allows different amp modules to communicate. +# I'm a C++ guy, not a python guy. I decided this approach because it seemed most C++-like. +# But apparently it's ok: +# http://effbot.org/pyfaq/how-do-i-share-global-variables-across-modules.htm +import os +import torch + +TORCH_MAJOR = int(torch.__version__.split('.')[0]) +TORCH_MINOR = int(torch.__version__.split('.')[1]) + + +if TORCH_MAJOR == 1 and TORCH_MINOR < 8: + from torch._six import container_abcs +else: + import collections.abc as container_abcs + + +class AmpState(object): + def __init__(self): + self.hard_override=False + self.allow_incoming_model_not_fp32 = False + self.verbosity=1 + + +# Attribute stash. Could also just stash things as global module attributes. +_amp_state = AmpState() + + +def warn_or_err(msg): + if _amp_state.hard_override: + print("Warning: " + msg) + else: + raise RuntimeError(msg) + # I'm not sure if allowing hard_override is a good idea. + # + " If you're sure you know what you're doing, supply " + + # "hard_override=True to amp.initialize.") + + +def maybe_print(msg, rank0=False): + distributed = torch.distributed.is_available() and \ + torch.distributed.is_initialized() and \ + torch.distributed.get_world_size() > 1 + if _amp_state.verbosity > 0: + if rank0: + if distributed: + if torch.distributed.get_rank() == 0: + print(msg) + else: + print(msg) + else: + print(msg) + + +# def iter_params(param_groups): +# for group in param_groups: +# for p in group['params']: +# yield p + + +def master_params(optimizer): + """ + Generator expression that iterates over the params owned by ``optimizer``. + + Args: + optimizer: An optimizer previously returned from ``amp.initialize``. + """ + for group in optimizer.param_groups: + for p in group['params']: + yield p diff --git a/apex/apex/amp/_initialize.py b/apex/apex/amp/_initialize.py new file mode 100644 index 0000000000000000000000000000000000000000..28c5bbbdfe5448f1f648e6328fadfa723afd2a0a --- /dev/null +++ b/apex/apex/amp/_initialize.py @@ -0,0 +1,263 @@ +import torch +from torch._six import string_classes +import functools +import numpy as np +import sys +from types import MethodType +import warnings +from ._amp_state import _amp_state, warn_or_err, container_abcs +from .handle import disable_casts +from .scaler import LossScaler +from ._process_optimizer import _process_optimizer +from apex.fp16_utils import convert_network +from ..fp16_utils import FP16_Optimizer as FP16_Optimizer_general +from ..contrib.optimizers import FP16_Optimizer as FP16_Optimizer_for_fused + +if torch.distributed.is_available(): + from ..parallel import DistributedDataParallel as apex_DDP + from ..parallel.LARC import LARC + + +def to_type(dtype, t): + if isinstance(t, torch.Tensor): + if not t.is_cuda: + # This should not be a hard error, since it may be legitimate. + warnings.warn("An input tensor was not cuda.") + # GANs require this. + # if t.requires_grad: + # warn_or_err("input data requires grad. Since input data is not a model parameter,\n" + # "its gradients will not be properly allreduced by DDP.") + if t.is_floating_point(): + return t.to(dtype) + return t + else: + # Trust the user's custom batch type, that's all I can do here. + return t.to(dtype) + + +# Modified from torch.optim.optimizer.py. This is a bit more general than casted_args in utils.py. +def applier(value, fn): + if isinstance(value, torch.Tensor): + return fn(value) + elif isinstance(value, string_classes): + return value + elif isinstance(value, np.ndarray): + return value + elif hasattr(value, "to"): # Allow handling of custom batch classes + return fn(value) + elif isinstance(value, container_abcs.Mapping): + return {applier(k, fn) : applier(v, fn) for k, v in value.items()} + elif isinstance(value, container_abcs.Iterable): + return type(value)(applier(v, fn) for v in value) + else: + # Do I want this to fire off even if someone chooses to pass something ordinary like + # an int or float? May be more annoying than it's worth. + # print("Warning: unrecognized type in applier. If your input data is a custom class, " + # "provide it with a .to(dtype) method which converts its floating-point Tensors to dtype. " + # "Amp will check for your custom to() and invoke it to cast the batch's " + # "floating-point Tensors to the appropriate type. " + # "Also, if your data is a custom class, it is your responsibility to ensure that " + # "any Tensors you want to be cuda are already cuda." + return value + + +def check_models(models): + for model in models: + parallel_type = None + if isinstance(model, torch.nn.parallel.DistributedDataParallel): + parallel_type = "torch.nn.parallel.DistributedDataParallel" + if ('apex_DDP' in sys.modules) and isinstance(model, apex_DDP): + parallel_type = "apex.parallel.DistributedDataParallel" + if isinstance(model, torch.nn.parallel.DataParallel): + parallel_type = "torch.nn.parallel.DataParallel" + if parallel_type is not None: + raise RuntimeError("Incoming model is an instance of {}. ".format(parallel_type) + + "Parallel wrappers should only be applied to the model(s) AFTER \n" + "the model(s) have been returned from amp.initialize.") + + +def check_params_fp32(models): + for model in models: + for name, param in model.named_parameters(): + if param.is_floating_point(): + if 'Half' in param.type(): + warn_or_err("Found param {} with type {}, expected torch.cuda.FloatTensor.\n" + "When using amp.initialize, you do not need to call .half() on your model\n" + "before passing it, no matter what optimization level you choose.".format( + name, param.type())) + elif not param.is_cuda: + warn_or_err("Found param {} with type {}, expected torch.cuda.FloatTensor.\n" + "When using amp.initialize, you need to provide a model with parameters\n" + "located on a CUDA device before passing it no matter what optimization level\n" + "you chose. Use model.to('cuda') to use the default device.".format( + name, param.type())) + + # Backward compatibility for PyTorch 0.4 + if hasattr(model, 'named_buffers'): + buf_iter = model.named_buffers() + else: + buf_iter = model._buffers + for obj in buf_iter: + if type(obj)==tuple: + name, buf = obj + else: + name, buf = obj, buf_iter[obj] + if buf.is_floating_point(): + if 'Half' in buf.type(): + warn_or_err("Found buffer {} with type {}, expected torch.cuda.FloatTensor.\n" + "When using amp.initialize, you do not need to call .half() on your model\n" + "before passing it, no matter what optimization level you choose.".format( + name, buf.type())) + elif not buf.is_cuda: + warn_or_err("Found buffer {} with type {}, expected torch.cuda.FloatTensor.\n" + "When using amp.initialize, you need to provide a model with buffers\n" + "located on a CUDA device before passing it no matter what optimization level\n" + "you chose. Use model.to('cuda') to use the default device.".format( + name, buf.type())) + + +def check_optimizers(optimizers): + for optim in optimizers: + bad_optim_type = None + if isinstance(optim, FP16_Optimizer_general): + bad_optim_type = "apex.fp16_utils.FP16_Optimizer" + if isinstance(optim, FP16_Optimizer_for_fused): + bad_optim_type = "apex.optimizers.FP16_Optimizer" + if bad_optim_type is not None: + raise RuntimeError("An incoming optimizer is an instance of {}. ".format(bad_optim_type) + + "The optimizer(s) passed to amp.initialize() must be bare \n" + "instances of either ordinary Pytorch optimizers, or Apex fused \n" + "optimizers.\n") + + +class O2StateDictHook(object): + def __init__(self, fn): + self.fn = fn + + def __call__(self, module, state_dict, prefix, local_metadata): + for key in state_dict: + param = state_dict[key] + if 'Half' in param.type(): + param = param.to(torch.float32) + state_dict[key] = param + + +def _initialize(models, optimizers, properties, num_losses=1, cast_model_outputs=None): + from .amp import init as amp_init + + optimizers_was_list = False + if isinstance(optimizers, torch.optim.Optimizer) or ('LARC' in globals() and isinstance(optimizers, LARC)): + optimizers = [optimizers] + elif optimizers is None: + optimizers = [] + elif isinstance(optimizers, list): + optimizers_was_list = True + check_optimizers(optimizers) + else: + check_optimizers([optimizers]) + raise TypeError("optimizers must be either a single optimizer or a list of optimizers.") + + if isinstance(models, torch.nn.Module): + models_was_list = False + models = [models] + elif isinstance(models, list): + models_was_list = True + else: + raise TypeError("models must be either a single model or a list of models.") + + check_models(models) + + if not _amp_state.allow_incoming_model_not_fp32: + check_params_fp32(models) + + # In the future, when FP16_Optimizer can be deprecated and master weights can + # become an attribute, remember to stash master weights before casting the model. + + if properties.cast_model_type: + if properties.keep_batchnorm_fp32: + for model in models: + convert_network(model, properties.cast_model_type) + else: + for model in models: + model.to(properties.cast_model_type) + + input_caster = functools.partial(to_type, properties.cast_model_type) + if cast_model_outputs is not None: + output_caster = functools.partial(to_type, cast_model_outputs) + else: + output_caster = functools.partial(to_type, torch.float32) + + for model in models: + # Patch the forward method to cast incoming data to the correct type, and + # outgoing data to float32, so "the user never needs to call .half()." + # I like writing things explicitly more than decorators. + def patch_forward(old_fwd): + def new_fwd(*args, **kwargs): + output = old_fwd(*applier(args, input_caster), + **applier(kwargs, input_caster)) + return applier(output, output_caster) + return new_fwd + + model.forward = patch_forward(model.forward) + + # State dict trick to recast any preexisting per-param state tensors + for optimizer in optimizers: + optimizer.load_state_dict(optimizer.state_dict()) + + # patch model.state_dict() to return float32 params + for model in models: + for module in model.modules(): + module._register_state_dict_hook(O2StateDictHook(functools.partial(to_type, torch.float32))) + + elif cast_model_outputs is not None: + output_caster = functools.partial(to_type, cast_model_outputs) + + for model in models: + def patch_forward(old_fwd): + def new_fwd(*args, **kwargs): + output = old_fwd(*args, **kwargs) + return applier(output, output_caster) + return new_fwd + + model.forward = patch_forward(model.forward) + + for i, optimizer in enumerate(optimizers): + optimizers[i] = _process_optimizer(optimizer, properties) + + _amp_state.loss_scalers = [] + for _ in range(num_losses): + _amp_state.loss_scalers.append(LossScaler(properties.loss_scale, + min_loss_scale=_amp_state.min_loss_scale, + max_loss_scale=_amp_state.max_loss_scale)) + + if properties.patch_torch_functions: + # handle is unused here. It's accessible later through a global value anyway. + handle = amp_init(loss_scale=properties.loss_scale, verbose=(_amp_state.verbosity == 2)) + for optimizer in optimizers: + # Disable Amp casting for the optimizer step, because it should only be + # applied to FP32 master params anyway. + def patch_step(old_step): + def new_step(self, *args, **kwargs): + with disable_casts(): + output = old_step(*args, **kwargs) + return output + return new_step + + optimizer.step = MethodType(patch_step(optimizer.step), optimizer) + + if optimizers_was_list: + if models_was_list: + return models, optimizers + else: + return models[0], optimizers + else: + if models_was_list: + if len(optimizers) == 0: + return models + else: + return models, optimizers[0] + else: + if len(optimizers) == 0: + return models[0] + else: + return models[0], optimizers[0] diff --git a/apex/apex/amp/_process_optimizer.py b/apex/apex/amp/_process_optimizer.py new file mode 100644 index 0000000000000000000000000000000000000000..471289bba6e267e5167a80b867f75b134717e1df --- /dev/null +++ b/apex/apex/amp/_process_optimizer.py @@ -0,0 +1,489 @@ +import types +from ..fp16_utils import master_params_to_model_params +from ..multi_tensor_apply import multi_tensor_applier +from ._amp_state import maybe_print +import torch +from ..optimizers import FusedSGD + + +class AmpOptimizerState(object): + def __init__(self): + pass + + +def _master_params_to_model_params(self): + stash = self._amp_stash + if multi_tensor_applier.available: + if len(stash.all_fp16_params) > 0: + multi_tensor_applier( + stash.multi_tensor_scale, + stash.dummy_overflow_buf, + [stash.all_fp32_from_fp16_params, stash.all_fp16_params], + 1.0) + else: + for fp16_group, fp32_from_fp16_group in zip(stash.fp16_groups, stash.fp32_from_fp16_groups): + master_params_to_model_params(fp16_group, fp32_from_fp16_group) + + +def lazy_init_with_master_weights(self): + stash = self._amp_stash + stash.fp16_groups = [] + stash.fp32_from_fp16_groups = [] + stash.fp32_from_fp32_groups = [] + for i, param_group in enumerate(self.param_groups): + # maybe_print("FP16_Optimizer processing param group {}:".format(i)) + fp16_params_this_group = [] + fp32_params_this_group = [] + fp32_from_fp16_params_this_group = [] + for i, param in enumerate(param_group['params']): + if param.requires_grad: + if param.type() == 'torch.cuda.HalfTensor': + # maybe_print("FP16_Optimizer received torch.cuda.HalfTensor with {}" + # .format(param.size())) + fp16_params_this_group.append(param) + master_param = param.detach().clone().float() + master_param.requires_grad = True + param_group['params'][i] = master_param + fp32_from_fp16_params_this_group.append(master_param) + # Reset existing state dict key to the new master param. + # We still need to recast per-param state tensors, if any, to FP32. + if param in self.state: + self.state[master_param] = self.state.pop(param) + elif param.type() == 'torch.cuda.FloatTensor': + # maybe_print("FP16_Optimizer received torch.cuda.FloatTensor with {}" + # .format(param.size())) + fp32_params_this_group.append(param) + param_group['params'][i] = param + else: + raise TypeError("Optimizer's parameters must be either " + "torch.cuda.FloatTensor or torch.cuda.HalfTensor. " + "Received {}".format(param.type())) + + stash.fp16_groups.append(fp16_params_this_group) + stash.fp32_from_fp16_groups.append(fp32_from_fp16_params_this_group) + stash.fp32_from_fp32_groups.append(fp32_params_this_group) + + stash.all_fp16_params = [] + for group in stash.fp16_groups: + stash.all_fp16_params += group + + stash.all_fp32_from_fp16_params = [] + for group in stash.fp32_from_fp16_groups: + stash.all_fp32_from_fp16_params += group + + stash.all_fp32_from_fp32_params = [] + for group in stash.fp32_from_fp32_groups: + stash.all_fp32_from_fp32_params += group + + # all_fp16_grad_stash is only needed for fused optimizers. + stash.all_fp16_grad_stash = [None for _ in stash.all_fp16_params] + # stash.all_fp32_from_fp16_grad_stash = [None for _ in stash.all_fp32_from_fp16_params] + stash.all_fp32_from_fp32_grad_stash = [None for _ in stash.all_fp32_from_fp32_params] + + for param in stash.all_fp32_from_fp16_params: + param.grad = None + + for param in stash.all_fp32_from_fp32_params: + param.grad = None + + # Leverage state_dict() and load_state_dict() to recast preexisting per-param state tensors + self.load_state_dict(self.state_dict()) + + +def post_backward_models_are_masters(scaler, params, stashed_grads, scale_override=None): + grads_have_scale, stashed_have_scale, out_scale = scaler.loss_scale(), 1.0, 1.0 + + # not much to do if scale == 1.0 and static scaling + if scaler.loss_scale() == 1.0 and not scaler.dynamic: + # Clear the stash. + for i in range(len(stashed_grads)): + stashed_grads[i] = None + return + + if scale_override is not None: + grads_have_scale, stashed_have_scale, out_scale = scale_override + + # This is a lot of python overhead... + grads_needing_unscale = [] + grads_needing_unscale_with_stash = [] + stashed = [] + for param, stashed_grad in zip(params, stashed_grads): + if param.grad is None and stashed_grad is not None: + param.grad = stashed_grad + elif param.grad is not None and stashed_grad is None: + grads_needing_unscale.append(param.grad) + elif param.grad is not None and stashed_grad is not None: + grads_needing_unscale_with_stash.append(param.grad) + stashed.append(stashed_grad) + else: # param.grad is None and stashed_grad is None + continue + + # unscale() implements grads*(1/scale), so "scale" should be grads_have_scale/out_scale. + if len(grads_needing_unscale) > 0: + scaler.unscale( + grads_needing_unscale, + grads_needing_unscale, + None, # unused_scale, currently present to avoid API breakage elsewhere + models_are_masters=True, + scale_override=grads_have_scale/out_scale) + + if len(grads_needing_unscale_with_stash) > 0: + scaler.unscale_with_stashed( + grads_needing_unscale_with_stash, + stashed, + grads_needing_unscale_with_stash, + scale_override=(grads_have_scale, stashed_have_scale, out_scale)) + + # Clear the stash. + for i in range(len(stashed_grads)): + stashed_grads[i] = None + + +def prepare_backward_with_master_weights(self): + stash = self._amp_stash + + self._amp_lazy_init() + + for i, param in enumerate(stash.all_fp16_params): + # Set up to leverage grad copy elision. + # This may behave differently from an unpatched optimizer if zero_grad is used and the param is unused. + param.grad = None + + # for i, param in enumerate(stash.all_fp32_from_fp16_params): + # stash.all_fp32_from_fp16_grad_stash[i] = param.grad + + for i, param in enumerate(stash.all_fp32_from_fp32_params): + stash.all_fp32_from_fp32_grad_stash[i] = param.grad + # Set up to leverage grad copy elision: + param.grad = None + + +def post_backward_with_master_weights(self, scaler): + stash = self._amp_stash + + self._amp_lazy_init() + + # This is a lot of python overhead... + fp16_grads_needing_unscale = [] + new_fp32_grads = [] + fp16_grads_needing_unscale_with_stash = [] + preexisting_fp32_grads = [] + for fp16_param, fp32_param in zip(stash.all_fp16_params, + stash.all_fp32_from_fp16_params): + if fp16_param.grad is None and fp32_param.grad is not None: + continue + elif fp16_param.grad is not None and fp32_param.grad is None: + fp32_param.grad = torch.empty_like(fp32_param) + fp16_grads_needing_unscale.append(fp16_param.grad) + new_fp32_grads.append(fp32_param.grad) + elif fp16_param.grad is not None and fp32_param.grad is not None: + fp16_grads_needing_unscale_with_stash.append(fp16_param.grad) + preexisting_fp32_grads.append(fp32_param.grad) + else: # fp16_param.grad is None and fp32_param.grad is None: + continue + + if len(fp16_grads_needing_unscale) > 0: + scaler.unscale( + fp16_grads_needing_unscale, + new_fp32_grads, + scaler.loss_scale(), + models_are_masters=False) + + if len(fp16_grads_needing_unscale_with_stash) > 0: + scaler.unscale_with_stashed( + fp16_grads_needing_unscale_with_stash, + preexisting_fp32_grads, + preexisting_fp32_grads) + + # fp32 params can be treated as they would be in the "no_master_weights" case. + post_backward_models_are_masters( + scaler, + stash.all_fp32_from_fp32_params, + stash.all_fp32_from_fp32_grad_stash) + + +def lazy_init_no_master_weights(self): + stash = self._amp_stash + stash.all_fp16_params = [] + stash.all_fp32_params = [] + for i, param_group in enumerate(self.param_groups): + for i, param in enumerate(param_group['params']): + if param.type() == 'torch.cuda.HalfTensor': + stash.all_fp16_params.append(param) + elif param.type() == 'torch.cuda.FloatTensor': + stash.all_fp32_params.append(param) + else: + raise TypeError("Optimizer's parameters must be either " + "torch.cuda.FloatTensor or torch.cuda.HalfTensor. " + "Received {}".format(param.type())) + + stash.all_fp16_grad_stash = [None for _ in stash.all_fp16_params] + stash.all_fp32_grad_stash = [None for _ in stash.all_fp32_params] + + +def prepare_backward_no_master_weights(self): + stash = self._amp_stash + + self._amp_lazy_init() + + for i, param in enumerate(stash.all_fp16_params): + stash.all_fp16_grad_stash[i] = param.grad + # Set up to leverage grad copy elision: + param.grad = None + + for i, param in enumerate(stash.all_fp32_params): + stash.all_fp32_grad_stash[i] = param.grad + # Set up to leverage grad copy elision: + param.grad = None + + +def post_backward_no_master_weights(self, scaler): + stash = self._amp_stash + + self._amp_lazy_init() + + split_types = ((stash.all_fp16_params, stash.all_fp16_grad_stash), + (stash.all_fp32_params, stash.all_fp32_grad_stash)) + + for params, stashed_grads in split_types: + post_backward_models_are_masters(scaler, params, stashed_grads) + + +##################################################################################### +# FusedSGD versions +##################################################################################### + +# FusedSGD never explicitly materializes the fp32 gradients for "fp32 from fp16" master params +# outside the kernel, so we must accumulate directly into the model grads. +def prepare_backward_with_master_weights_FusedSGD(self): + if self.materialize_master_grads: + prepare_backward_with_master_weights(self) + else: + stash = self._amp_stash + + self._amp_lazy_init() + + for i, param in enumerate(stash.all_fp16_params): + stash.all_fp16_grad_stash[i] = param.grad + # Set up to leverage grad copy elision: + param.grad = None + + for i, param in enumerate(stash.all_fp32_from_fp32_params): + stash.all_fp32_from_fp32_grad_stash[i] = param.grad + # Set up to leverage grad copy elision: + param.grad = None + + +def post_backward_with_master_weights_FusedSGD(self, scaler): + if self.materialize_master_grads: + post_backward_with_master_weights(self, scaler) + else: + stash = self._amp_stash + + self._amp_lazy_init() + + grads_have_scale = scaler.loss_scale() + stashed_have_scale = self.most_recent_scale + out_scale = grads_have_scale + if self.scale_set_by_backward: + out_scale = min(grads_have_scale, self.most_recent_scale) + + split_types = ((stash.all_fp16_params, stash.all_fp16_grad_stash), + (stash.all_fp32_from_fp32_params, stash.all_fp32_from_fp32_grad_stash)) + + + # unscale_with_stashed() implements grads*1/scale + stashed_grads*1. + # stashed_grads are scaled by self.most_recent_scale. + for params, stashed_grads in split_types: + post_backward_models_are_masters(scaler, params, stashed_grads, + (grads_have_scale, stashed_have_scale, out_scale)) + + self.most_recent_scale = out_scale + self.scale_set_by_backward = True + + +def prepare_backward_no_master_weights_FusedSGD(self): + prepare_backward_no_master_weights(self) + + +def post_backward_no_master_weights_FusedSGD(self, scaler): + post_backward_no_master_weights(self, scaler) + + +def _amp_lazy_init(self): + stash = self._amp_stash + + if not stash.lazy_init_called: + self._lazy_init_maybe_master_weights() + stash.lazy_init_called = True + + +def _process_optimizer(optimizer, properties): + if hasattr(optimizer, "_amp_stash"): + raise RuntimeError("A given optimizer should only be passed through amp.initialize once.") + else: + optimizer._amp_stash = AmpOptimizerState() + + optimizer._amp_stash.lazy_init_called = False + optimizer._amp_stash.already_patched = False + optimizer._amp_stash.params_have_scaled_gradients = False + + for name in ("_lazy_init_maybe_master_weights", + "_master_params_to_model_params", + "_prepare_amp_backward", + "_post_amp_backward", + "_amp_lazy_init"): + if hasattr(optimizer, name): + raise RuntimeError("Incoming optimizer already has {} defined.".format(name)) + + # TODO: Centralize exposure and import error checking for the C backend. + if multi_tensor_applier.available: + import amp_C + optimizer._amp_stash.multi_tensor_scale = amp_C.multi_tensor_scale + optimizer._amp_stash.multi_tensor_l2norm = amp_C.multi_tensor_l2norm + optimizer._amp_stash.dummy_overflow_buf = torch.cuda.IntTensor([0]); + + if properties.master_weights: + optimizer._lazy_init_maybe_master_weights = types.MethodType( + lazy_init_with_master_weights, optimizer) + + optimizer._master_params_to_model_params = types.MethodType( + _master_params_to_model_params, optimizer) + + old_step = optimizer.step + def new_step(self, closure=None): + if closure is not None: + raise RuntimeError("Currently, Amp does not support closure use with optimizers.") + retval = old_step() + if not isinstance(self, FusedSGD): + self._master_params_to_model_params() + # Clear the master grads that wouldn't be zeroed by model.zero_grad() + for param in self._amp_stash.all_fp32_from_fp16_params: + param.grad = None + return retval + optimizer.step = types.MethodType(new_step, optimizer) + + old_zero_grad = optimizer.zero_grad + def new_zero_grad(self): + stash = self._amp_stash + self._amp_lazy_init() + # Zero the model grads. + for param in stash.all_fp16_params: + if param.grad is not None: + param.grad.detach_() + param.grad.zero_() + for param in stash.all_fp32_from_fp32_params: + if param.grad is not None: + param.grad.detach_() + param.grad.zero_() + # Clear the master grads that are independent of model grads + for param in self._amp_stash.all_fp32_from_fp16_params: + param.grad = None + optimizer.zero_grad = types.MethodType(new_zero_grad, optimizer) + + if isinstance(optimizer, FusedSGD): + optimizer._prepare_amp_backward = types.MethodType( + prepare_backward_with_master_weights_FusedSGD, optimizer) + optimizer._post_amp_backward = types.MethodType( + post_backward_with_master_weights_FusedSGD, optimizer) + else: + optimizer._prepare_amp_backward = types.MethodType( + prepare_backward_with_master_weights, optimizer) + optimizer._post_amp_backward = types.MethodType( + post_backward_with_master_weights, optimizer) + else: + optimizer._lazy_init_maybe_master_weights = types.MethodType( + lazy_init_no_master_weights, optimizer) + + if isinstance(optimizer, FusedSGD): + optimizer._prepare_amp_backward = types.MethodType( + prepare_backward_no_master_weights_FusedSGD, optimizer) + optimizer._post_amp_backward = types.MethodType( + post_backward_no_master_weights_FusedSGD, optimizer) + else: + optimizer._prepare_amp_backward = types.MethodType( + prepare_backward_no_master_weights, optimizer) + optimizer._post_amp_backward = types.MethodType( + post_backward_no_master_weights, optimizer) + + optimizer._amp_lazy_init = types.MethodType(_amp_lazy_init, optimizer) + + old_add_param_group = optimizer.add_param_group + + def new_add_param_group(self, new_group): + stash = self._amp_stash + + if not stash.lazy_init_called: + self._lazy_init_maybe_master_weights() + stash.lazy_init_called = True + + assert isinstance(new_group, dict), "param group must be a dict" + + new_params = new_group['params'] + if isinstance(new_params, torch.Tensor): + new_group['params'] = [new_params] + elif isinstance(new_params, set): + raise TypeError('optimizer parameters need to be organized in ordered collections, but ' + 'the ordering of tensors in sets will change between runs. Please use a list instead.') + else: + new_group['params'] = list(new_params) + + if properties.master_weights: + # Mutate new_group in-place to use FP32 master params + fp16_params_this_group = [] + fp32_params_this_group = [] + fp32_from_fp16_params_this_group = [] + for i, param in enumerate(new_group['params']): + if param.requires_grad: + if param.type() == 'torch.cuda.HalfTensor': + fp16_params_this_group.append(param) + master_param = param.detach().clone().float() + master_param.requires_grad = True + new_group['params'][i] = master_param + fp32_from_fp16_params_this_group.append(master_param) + elif param.type() == 'torch.cuda.FloatTensor': + fp32_params_this_group.append(param) + new_group['params'][i] = param + else: + raise TypeError("Optimizer's parameters must be either " + "torch.cuda.FloatTensor or torch.cuda.HalfTensor. " + "Received {}".format(param.type())) + + stash.fp16_groups.append(fp16_params_this_group) + stash.fp32_from_fp16_groups.append(fp32_from_fp16_params_this_group) + stash.fp32_from_fp32_groups.append(fp32_params_this_group) + + stash.all_fp16_params += fp16_params_this_group + stash.all_fp32_from_fp16_params += fp32_from_fp16_params_this_group + stash.all_fp32_from_fp32_params += fp32_params_this_group + + # stash.all_fp32_from_fp16_grad_stash = [None for _ in stash.all_fp32_from_fp16_params] + stash.all_fp32_from_fp32_grad_stash += [None for _ in fp32_params_this_group] + + # It should be ok to let params be added with existing .grad attributes. + # for param in fp16_params_this_group: + # param.grad = None + + # for param in fp32_from_fp16_params_this_group: + # param.grad = None + + # for param in stash.fp32_params_this_group: + # param.grad = None + else: + for param in new_group['params']: + if param.type() == 'torch.cuda.HalfTensor': + stash.all_fp16_params.append(param) + stash.all_fp16_grad_stash.append(None) + elif param.type() == 'torch.cuda.FloatTensor': + stash.all_fp32_params.append(param) + stash.all_fp32_grad_stash.append(None) + else: + raise TypeError("Optimizer's parameters must be either " + "torch.cuda.FloatTensor or torch.cuda.HalfTensor. " + "Received {}".format(param.type())) + + old_add_param_group(new_group) + + optimizer.add_param_group = types.MethodType(new_add_param_group, optimizer) + + return optimizer diff --git a/apex/apex/amp/amp.py b/apex/apex/amp/amp.py new file mode 100644 index 0000000000000000000000000000000000000000..1eed72d07b63730ca1906da44cdc569cb9425433 --- /dev/null +++ b/apex/apex/amp/amp.py @@ -0,0 +1,177 @@ +from . import compat, rnn_compat, utils, wrap +from .handle import AmpHandle, NoOpHandle +from .lists import functional_overrides, torch_overrides, tensor_overrides +from ._amp_state import _amp_state +from .frontend import * + +import functools +import itertools + +import torch + + +_DECORATOR_HANDLE = None +_USER_CAST_REGISTRY = set() +_USER_PROMOTE_REGISTRY = set() + + +def _decorator_helper(orig_fn, cast_fn, wrap_fn): + def wrapper(*args, **kwargs): + handle = _DECORATOR_HANDLE + if handle is None or not handle.is_active(): + return orig_fn(*args, **kwargs) + inner_cast_fn = utils.verbosify(cast_fn, orig_fn.__name__, + handle.verbose) + return wrap_fn(orig_fn, inner_cast_fn, handle)(*args, **kwargs) + return wrapper + + +# Decorator form +def half_function(fn): + wrap_fn = functools.partial(wrap.make_cast_wrapper, try_caching=True) + return _decorator_helper(fn, utils.maybe_half, wrap_fn) + + +def float_function(fn): + wrap_fn = functools.partial(wrap.make_cast_wrapper, try_caching=False) + return _decorator_helper(fn, utils.maybe_float, wrap_fn) + + +def promote_function(fn): + wrap_fn = functools.partial(wrap.make_promote_wrapper) + return _decorator_helper(fn, utils.maybe_float, wrap_fn) + + +# Registry form +def register_half_function(module, name): + if not hasattr(module, name): + raise ValueError('No function named {} in module {}.'.format( + name, module)) + _USER_CAST_REGISTRY.add((module, name, utils.maybe_half)) + + +def register_float_function(module, name): + if not hasattr(module, name): + raise ValueError('No function named {} in module {}.'.format( + name, module)) + _USER_CAST_REGISTRY.add((module, name, utils.maybe_float)) + + +def register_promote_function(module, name): + if not hasattr(module, name): + raise ValueError('No function named {} in module {}.'.format( + name, module)) + _USER_PROMOTE_REGISTRY.add((module, name)) + + +# Top-level function to insert _all_ the hooks. +def init(enabled=True, loss_scale="dynamic", enable_caching=True, verbose=False, allow_banned=False): + global _DECORATOR_HANDLE + + if not enabled: + handle = NoOpHandle() + _DECORATOR_HANDLE = handle + return handle + + handle = AmpHandle(loss_scale, enable_caching, verbose) + + # 0) Force-{fp16, fp32} for user-annotated functions + for mod, fn, cast_fn in _USER_CAST_REGISTRY: + try_caching = (cast_fn == utils.maybe_half) + wrap.cached_cast(mod, fn, cast_fn, handle, + try_caching, verbose) + _USER_CAST_REGISTRY.clear() + + # 0.5) Force-promote for user-annotated functions + for mod, fn in _USER_PROMOTE_REGISTRY: + wrap.promote(mod, fn, handle, verbose) + _USER_PROMOTE_REGISTRY.clear() + + # 1) Force-{fp16, fp32} on white- / black-list functions + override_modules = [functional_overrides, + torch_overrides, + tensor_overrides] + cast_table = [('FP16_FUNCS', utils.maybe_half), + ('FP32_FUNCS', utils.maybe_float)] + for module, (list_name, cast_fn) in itertools.product(override_modules, + cast_table): + for fn in getattr(module, list_name): + try_caching = (cast_fn == utils.maybe_half) + wrap.cached_cast(module.MODULE, fn, cast_fn, handle, + try_caching, verbose) + + # 1.5) Pre-0.4, put the blacklist methods on HalfTensor and whitelist + # methods on FloatTensor, since they're distinct types. + if compat.tensor_is_float_tensor(): + for fn in tensor_overrides.FP16_FUNCS: + wrap.cached_cast(torch.cuda.FloatTensor, fn, utils.maybe_half, + handle, try_caching=True, verbose=verbose) + for fn in tensor_overrides.FP32_FUNCS: + wrap.cached_cast(torch.cuda.HalfTensor, fn, utils.maybe_float, + handle, try_caching=False, verbose=verbose) + + # 2) Enable type-promotion on multi-arg functions and methods. + # NB: special handling for sequence fns (e.g. `torch.cat`). + promote_modules = [torch_overrides, tensor_overrides] + promote_table = [('CASTS', wrap.promote), + ('SEQUENCE_CASTS', wrap.sequence_promote)] + for promote_mod, (list_name, promote_fn) in itertools.product(promote_modules, + promote_table): + for fn in getattr(promote_mod, list_name): + promote_fn(promote_mod.MODULE, fn, handle, verbose) + + # 2.5) Pre-0.4, add blacklist methods directly to HalfTensor and FloatTensor types + if compat.tensor_is_float_tensor(): + for cls, (list_name, promote_fn) in itertools.product([torch.cuda.FloatTensor, + torch.cuda.HalfTensor], + promote_table): + for fn in getattr(tensor_overrides, list_name): + promote_fn(cls, fn, handle, verbose) + + # 3) For any in-place version of a blacklist function, error if any input is fp16. + # NB: this is overly conservative. + for fn in utils.as_inplace(torch_overrides.FP32_FUNCS): + wrap.err_if_any_half(torch_overrides.MODULE, fn, handle) + + # 3.5) For any in-place blacklist method, error if called on fp16 tensor + for fn in utils.as_inplace(tensor_overrides.FP32_FUNCS): + wrap.err_if_arg0_half(tensor_overrides.MODULE, fn, handle, verbose) + if compat.tensor_is_float_tensor(): + wrap.err_if_arg0_half(torch.cuda.HalfTensor, fn, handle, verbose) + + # 4) For other in-place methods, match the type of self tensor + for fn in utils.as_inplace(itertools.chain( + tensor_overrides.FP16_FUNCS, + tensor_overrides.CASTS)): + wrap.promote_match_arg0(tensor_overrides.MODULE, fn, handle, verbose) + if compat.tensor_is_float_tensor(): + wrap.promote_match_arg0(torch.cuda.HalfTensor, fn, handle, verbose) + wrap.promote_match_arg0(torch.cuda.FloatTensor, fn, handle, verbose) + + # 5) RNNs + RNN cells are whitelisted specially + if rnn_compat.has_old_rnns(): + wrap.rnn_cast(torch.nn.backends.thnn.backend, 'RNN', handle, verbose) + if not rnn_compat.has_old_rnns(): + # Patch in our own indirection of `_VF` in modules/rnn s.t. it is mutable. + torch.nn.modules.rnn._VF = rnn_compat.VariableFunctionsShim() + # Wrap all the rnns + for x in rnn_compat.RNN_NAMES: + wrap.new_rnn_cast(x.upper(), handle, verbose) + + # Wrap all the RNN cells + rnn_compat.whitelist_rnn_cells(handle, verbose) + + # 6) Place error+print message on banned functions. + # Or, if allow_banned, then cast to FP32. + for fn, err_msg in functional_overrides.BANNED_FUNCS: + if allow_banned: + wrap.cached_cast(functional_overrides.MODULE, fn, utils.maybe_float, + handle, try_caching=True, verbose=verbose) + else: + wrap.err_if_any_half(functional_overrides.MODULE, fn, handle, err_msg) + + _DECORATOR_HANDLE = handle + + _amp_state.handle = handle + + return handle diff --git a/apex/apex/amp/compat.py b/apex/apex/amp/compat.py new file mode 100644 index 0000000000000000000000000000000000000000..22276bd47d058e71e9e4bcf380e3ff9749325447 --- /dev/null +++ b/apex/apex/amp/compat.py @@ -0,0 +1,46 @@ +import torch + +# True for post-0.4, when Variables/Tensors merged. +def variable_is_tensor(): + v = torch.autograd.Variable() + return isinstance(v, torch.Tensor) + +def tensor_is_variable(): + x = torch.Tensor() + return type(x) == torch.autograd.Variable + +# False for post-0.4 +def tensor_is_float_tensor(): + x = torch.Tensor() + return type(x) == torch.FloatTensor + +# Akin to `torch.is_tensor`, but returns True for Variable +# objects in pre-0.4. +def is_tensor_like(x): + return torch.is_tensor(x) or isinstance(x, torch.autograd.Variable) + +# Wraps `torch.is_floating_point` if present, otherwise checks +# the suffix of `x.type()`. +def is_floating_point(x): + if hasattr(torch, 'is_floating_point'): + return torch.is_floating_point(x) + try: + torch_type = x.type() + return torch_type.endswith('FloatTensor') or \ + torch_type.endswith('HalfTensor') or \ + torch_type.endswith('DoubleTensor') + except AttributeError: + return False + +def scalar_python_val(x): + if hasattr(x, 'item'): + return x.item() + else: + if isinstance(x, torch.autograd.Variable): + return x.data[0] + else: + return x[0] + +# Accounts for the possibility that some ops may be removed from a namespace. +def filter_attrs(module, attrs): + return list(attrname for attrname in attrs if hasattr(module, attrname)) diff --git a/apex/apex/amp/frontend.py b/apex/apex/amp/frontend.py new file mode 100644 index 0000000000000000000000000000000000000000..da0f05dc9993b337f756f426b34349af940d53ed --- /dev/null +++ b/apex/apex/amp/frontend.py @@ -0,0 +1,442 @@ +import torch +from ._initialize import _initialize +from ._amp_state import _amp_state, warn_or_err, maybe_print +from collections import OrderedDict + + +class Properties(object): + """ + This class has two purposes: to establish a set of default properties, + and to route setting of these attributes through __setattr__ so that (in theory) + they can be checked for consistency with other existing args. + """ + def __init__(self): + self.options = { + "enabled" : False, + "opt_level" : None, + "cast_model_type" : None, + "patch_torch_functions" : False, + "keep_batchnorm_fp32" : None, + "master_weights" : None, + "loss_scale" : 1.0, + # Reserved for future functionality + # "fused_optimizer" : False, + # "enable_ddp_interop" : False, + } + + """ + This function allows updating several options at a time without routing through + __setattr__ checks, to avoid "you can't get there from here" scenarios. + Currently not intended to be exposed; users are expected to select an opt_level + and apply consistent modifications. + """ + def _update_options_dict(self, new_options): + for k, v in new_options: + if k in self.options: + self.options[k] = v + else: + raise ValueError("Tried to set unexpected option {}".format(k)) + """ + The members of "options" are not direct attributes of self, so access attempts + will roll down to __getattr__. This borrows from the logic in torch.nn.Module. + """ + def __getattr__(self, name): + if "options" in self.__dict__: + options = self.__dict__["options"] + if name in options: + return options[name] + raise AttributeError("'{}' object has no attribute '{}'".format( + type(self).__name__, name)) + + def __setattr__(self, name, value): + if "options" in self.__dict__: + if name in self.options: + # print("setting {} {}".format(name, value)) + if name == "cast_model_type": + if self.opt_level == "O1" and value is not None: + if value is not False: + if value is not torch.float32: + warn_or_err("O1 inserts casts around Torch functions rather than " + "model weights, so with O1, the model weights themselves " + "should remain FP32. If you wish to cast the model to a " + "different type, use opt_level='O2' or 'O3'. " + + "cast_model_type was {}".format(value)) + self.options[name] = value + elif name == "patch_torch_functions": + if self.opt_level != "O1" and value: + warn_or_err("Currently, patch_torch_functions=True should only be set by " + "selecting opt_level='O1'.") + self.options[name] = value + elif name == "keep_batchnorm_fp32": + if self.opt_level == "O1" and value is not None: + warn_or_err("With opt_level O1, batchnorm functions are automatically patched " + "to run in FP32, so keep_batchnorm_fp32 should be None." + + " keep_batchnorm_fp32 was {}".format(value)) + if value == "False": + self.options[name] = False + elif value == "True": + self.options[name] = True + else: + assert (value is True or value is False or value is None),\ + "keep_batchnorm_fp32 must be a boolean, the string 'True' or 'False', "\ + "or None, found keep_batchnorm_fp32={}".format(value) + self.options[name] = value + elif name == "master_weights": + if self.opt_level == "O1" and value is not None: + warn_or_err("It doesn't make sense to use master_weights with O1. " + "With O1, your model weights themselves should be FP32.") + self.options[name] = value + elif name == "loss_scale": + if value == "dynamic": + self.options[name] = value + else: + self.options[name] = float(value) + else: + self.options[name] = value + else: + super(Properties, self).__setattr__(name, value) + + +""" O0-O3 are convenience wrappers to establish defaults for typically used mixed precision options. """ + +class O3: + brief = "O3: Pure FP16 training." + more = "Calls .half() on your model, converting the entire model to FP16.\n"\ + "A casting operation is also inserted to cast incoming Tensors to FP16,\n"\ + "so you don't need to change your data pipeline.\n"\ + "This mode is useful for establishing a performance ceiling.\n"\ + "It's also possible training may 'just work' in this mode.\n"\ + "If not, try other optimization levels." + + def __call__(self, properties): + properties.enabled = True + properties.opt_level = "O3" + properties.cast_model_type = torch.float16 + properties.patch_torch_functions = False + properties.keep_batchnorm_fp32 = False + properties.master_weights = False + properties.loss_scale = 1.0 + # properties.fused_optimizer = False + # properties.enable_ddp_interop = False + return properties # modified in place so this isn't really necessary + + +class O2: + brief = "O2: FP16 training with FP32 batchnorm and FP32 master weights.\n" + more = "Calls .half() on your model, converting the entire model (except for batchnorms)\n"\ + "to FP16. Batchnorms are retained in FP32 for additional stability.\n"\ + "The forward pass is patched to cast incoming Tensors to FP16, so you don't need to change\n"\ + "your data pipeline.\n"\ + "O2 creates FP32 master weights outside the model and patches any optimizers to update\n"\ + "these master weights, then copy the master weights into the FP16 model weights.\n"\ + "Master weights can also improve convergence and stability." + + def __call__(self, properties): + properties.enabled = True + properties.opt_level = "O2" + properties.cast_model_type = torch.float16 + properties.patch_torch_functions = False + properties.keep_batchnorm_fp32 = True + properties.master_weights = True + properties.loss_scale = "dynamic" + # properties.fused_optimizer = False + # properties.enable_ddp_interop = False + return properties # modified in place so this isn't really necessary + + +class O1: + brief = "O1: Insert automatic casts around Pytorch functions and Tensor methods.\n" + more = "The type of your model's weights is not altered. However, internally,\n"\ + "Pytorch functions are patched to cast any Tensor Core-friendly ops to FP16 for speed,\n"\ + "while operations that might benefit from the additional stability of FP32 are patched\n"\ + "to cast their inputs to fp32.\n"\ + "O1 is the safest way to try mixed precision training, and is recommended when\n"\ + "trying mixed precision training for the first time." + + def __call__(self, properties): + properties.enabled = True + properties.opt_level = "O1" + properties.cast_model_type = None + properties.patch_torch_functions = True + properties.keep_batchnorm_fp32 = None + properties.master_weights = None + properties.loss_scale = "dynamic" + # properties.fused_optimizer = False + # properties.enable_ddp_interop = False + return properties # modified in place so this isn't really necessary + + +class O0: + brief = "O0: Pure FP32 training.\n" + more = "Your models are checked to make sure parameters are FP32, but otherwise the\n"\ + "types of weights and internal Pytorch operations are not altered. This mode disables any\n"\ + "FP16 arithmetic, although other optimizations like DDP interop may still be requested.\n" + + def __call__(self, properties): + properties.enabled = True + properties.opt_level = "O0" + properties.cast_model_type = torch.float32 + properties.patch_torch_functions = False + properties.keep_batchnorm_fp32 = None + properties.master_weights = False + properties.loss_scale = 1.0 + # properties.fused_optimizer = False + # properties.enable_ddp_interop = False + return properties # modified in place so this isn't really necessary + + +opt_levels = {"O3": O3(), + "O2": O2(), + "O1": O1(), + "O0": O0()} + + +# allow user to directly pass Properties struct as well? +def initialize( + models, + optimizers=None, + enabled=True, + opt_level="O1", + cast_model_type=None, + patch_torch_functions=None, + keep_batchnorm_fp32=None, + master_weights=None, + loss_scale=None, + cast_model_outputs=None, + num_losses=1, + verbosity=1, + min_loss_scale=None, + max_loss_scale=2.**24 + ): + """ + Initialize your models, optimizers, and the Torch tensor and functional namespace according to the + chosen ``opt_level`` and overridden properties, if any. + + ``amp.initialize`` should be called **after** you have finished + constructing your model(s) and + optimizer(s), but **before** you send your model through any DistributedDataParallel wrapper. + See `Distributed training`_ in the Imagenet example. + + Currently, ``amp.initialize`` should only be called **once**, + although it can process an arbitrary number of + models and optimizers (see the corresponding `Advanced Amp Usage topic`_). + If you think your use case requires ``amp.initialize`` to be called more than once, + `let us know`_. + + Any property keyword argument that is not ``None`` will be interpreted as a manual override. + + To prevent having to rewrite anything else in your script, name the returned models/optimizers + to replace the passed models/optimizers, as in the code sample below. + + Args: + models (torch.nn.Module or list of torch.nn.Modules): Models to modify/cast. + optimizers (optional, torch.optim.Optimizer or list of torch.optim.Optimizers): Optimizers to modify/cast. + REQUIRED for training, optional for inference. + enabled (bool, optional, default=True): If False, renders all Amp calls no-ops, so your script + should run as if Amp were not present. + opt_level (str, optional, default="O1"): Pure or mixed precision optimization level. Accepted values are + "O0", "O1", "O2", and "O3", explained in detail above. + cast_model_type (``torch.dtype``, optional, default=None): Optional property override, see + above. + patch_torch_functions (bool, optional, default=None): Optional property override. + keep_batchnorm_fp32 (bool or str, optional, default=None): Optional property override. If + passed as a string, must be the string "True" or "False". + master_weights (bool, optional, default=None): Optional property override. + loss_scale (float or str, optional, default=None): Optional property override. If passed as a string, + must be a string representing a number, e.g., "128.0", or the string "dynamic". + cast_model_outputs (torch.dtype, optional, default=None): Option to ensure that the outputs + of your model(s) are always cast to a particular type regardless of ``opt_level``. + num_losses (int, optional, default=1): Option to tell Amp in advance how many losses/backward + passes you plan to use. When used in conjunction with the ``loss_id`` argument to + ``amp.scale_loss``, enables Amp to use a different loss scale per loss/backward pass, + which can improve stability. See "Multiple models/optimizers/losses" + under `Advanced Amp Usage`_ for examples. If ``num_losses`` is left to 1, Amp will still + support multiple losses/backward passes, but use a single global loss scale + for all of them. + verbosity (int, default=1): Set to 0 to suppress Amp-related output. + min_loss_scale (float, default=None): Sets a floor for the loss scale values that can be chosen by dynamic + loss scaling. The default value of None means that no floor is imposed. + If dynamic loss scaling is not used, `min_loss_scale` is ignored. + max_loss_scale (float, default=2.**24): Sets a ceiling for the loss scale values that can be chosen by + dynamic loss scaling. If dynamic loss scaling is not used, `max_loss_scale` is ignored. + + Returns: + Model(s) and optimizer(s) modified according to the ``opt_level``. + If either the ``models`` or ``optimizers`` args were lists, the corresponding return value will + also be a list. + + Permissible invocations:: + + model, optim = amp.initialize(model, optim,...) + model, [optim1, optim2] = amp.initialize(model, [optim1, optim2],...) + [model1, model2], optim = amp.initialize([model1, model2], optim,...) + [model1, model2], [optim1, optim2] = amp.initialize([model1, model2], [optim1, optim2],...) + + # This is not an exhaustive list of the cross product of options that are possible, + # just a set of examples. + model, optim = amp.initialize(model, optim, opt_level="O0") + model, optim = amp.initialize(model, optim, opt_level="O0", loss_scale="dynamic"|128.0|"128.0") + + model, optim = amp.initialize(model, optim, opt_level="O1") # uses "loss_scale="dynamic" default + model, optim = amp.initialize(model, optim, opt_level="O1", loss_scale=128.0|"128.0") + + model, optim = amp.initialize(model, optim, opt_level="O2") # uses "loss_scale="dynamic" default + model, optim = amp.initialize(model, optim, opt_level="O2", loss_scale=128.0|"128.0") + model, optim = amp.initialize(model, optim, opt_level="O2", keep_batchnorm_fp32=True|False|"True"|"False") + + model, optim = amp.initialize(model, optim, opt_level="O3") # uses loss_scale=1.0 default + model, optim = amp.initialize(model, optim, opt_level="O3", loss_scale="dynamic"|128.0|"128.0") + model, optim = amp.initialize(model, optim, opt_level="O3", keep_batchnorm_fp32=True|False|"True"|"False") + + The `Imagenet example`_ demonstrates live use of various opt_levels and overrides. + + .. _`Distributed training`: + https://github.com/NVIDIA/apex/tree/master/examples/imagenet#distributed-training + + .. _`Imagenet example`: + https://github.com/NVIDIA/apex/tree/master/examples/imagenet + + .. _`Advanced Amp Usage`: + https://nvidia.github.io/apex/advanced.html + + .. _`Advanced Amp Usage topic`: + https://nvidia.github.io/apex/advanced.html#multiple-models-optimizers-losses + + .. _`let us know`: + https://github.com/NVIDIA/apex/issues + """ + _amp_state.opt_properties = Properties() + _amp_state.verbosity = verbosity + + if not enabled: + if optimizers is None: + return models + else: + return models, optimizers + + if not torch.backends.cudnn.enabled: + raise RuntimeError( + "Amp requires torch.backends.cudnn.enabled = True") + + if opt_level not in opt_levels: + raise RuntimeError( + "Unexpected optimization level {}. ".format(opt_level) + + "Options are 'O0', 'O1', 'O2', 'O3'. Note that in `O0`, `O1`, etc., the prefix O is the letter O, " + + "not the number zero.") + else: + _amp_state.opt_properties = opt_levels[opt_level](_amp_state.opt_properties) + maybe_print("Selected optimization level {}".format(opt_levels[opt_level].brief), True) + maybe_print("Defaults for this optimization level are:", True) + for k, v in _amp_state.opt_properties.options.items(): + maybe_print("{:22} : {}".format(k, v), True) + + _amp_state.min_loss_scale = min_loss_scale + _amp_state.max_loss_scale = max_loss_scale + + maybe_print("Processing user overrides (additional kwargs that are not None)...", True) + # I chose to have the keyword arguments listed directly in the argument list, + # instead of **kwargs, so I can't use kwargs.items() here. + if enabled is not None: + _amp_state.opt_properties.enabled = enabled + if opt_level is not None: + _amp_state.opt_properties.opt_level = opt_level + if cast_model_type is not None: + _amp_state.opt_properties.cast_model_type = cast_model_type + if patch_torch_functions is not None: + _amp_state.opt_properties.patch_torch_functions = patch_torch_functions + if keep_batchnorm_fp32 is not None: + _amp_state.opt_properties.keep_batchnorm_fp32 = keep_batchnorm_fp32 + if master_weights is not None: + _amp_state.opt_properties.master_weights = master_weights + if loss_scale is not None: + _amp_state.opt_properties.loss_scale = loss_scale + + maybe_print("After processing overrides, optimization options are:", True) + for k, v in _amp_state.opt_properties.options.items(): + maybe_print("{:22} : {}".format(k, v), True) + + return _initialize(models, optimizers, _amp_state.opt_properties, num_losses, cast_model_outputs) + + +def state_dict(destination=None): + if destination is None: + destination = OrderedDict() + + for idx, loss_scaler in enumerate(_amp_state.loss_scalers): + destination['loss_scaler%d' % idx] = { + 'loss_scale': loss_scaler.loss_scale(), + 'unskipped': loss_scaler._unskipped, + } + return destination + + +def load_state_dict(state_dict): + # Check if state_dict containes the same number of loss_scalers as current setup + if len(state_dict) != len(_amp_state.loss_scalers): + print('Warning: state_dict contains {} entries, while {} loss_scalers are used'.format( + len(state_dict), len(_amp_state.loss_scalers))) + + state_dict = state_dict.copy() + + nb_loss_scalers = len(_amp_state.loss_scalers) + unexpected_keys = [] + # Initialize idx outside, since unexpected_keys will increase it if enumerate is used + idx = 0 + for key in state_dict: + if 'loss_scaler' not in key: + unexpected_keys.append(key) + else: + if idx > (nb_loss_scalers - 1): + print('Skipping loss_scaler[{}], since num_losses was set to {}'.format( + idx, nb_loss_scalers)) + break + _amp_state.loss_scalers[idx]._loss_scale = state_dict[key]['loss_scale'] + _amp_state.loss_scalers[idx]._unskipped = state_dict[key]['unskipped'] + idx += 1 + + if len(unexpected_keys) > 0: + raise RuntimeError( + 'Error(s) in loading state_dict. Unexpected key(s) in state_dict: {}. '.format( + ', '.join('"{}"'.format(k) for k in unexpected_keys))) + + +# TODO: is this necessary/useful? +# def check_option_consistency(enabled=True, +# opt_level=None, +# cast_model_type=None, +# patch_torch_functions=None, +# keep_batchnorm_fp32=None, +# master_weights=None, +# loss_scale=None, +# enable_ddp_interop=None, +# hard_override=False): +# """ +# Utility function that enables users to quickly check if the option combination they intend +# to use is permitted. ``check_option_consistency`` does not require models or optimizers +# to be constructed, and can be called at any point in the script. ``check_option_consistency`` +# is totally self-contained; it does not set any amp global state or affect anything outside +# of itself. +# """ +# +# if not enabled: +# return +# +# if opt_level not in opt_levels: +# raise RuntimeError("Unexpected optimization level. Options are 'O0', 'O1', 'O2', 'O3'.") +# else: +# opt_properties = opt_levels[opt_level](Properties()) +# print("Selected optimization level {}", opt_levels[opt_level].brief) +# print("Defaults for this optimization level are:") +# for k, v in opt_properties.options: +# print("{:22} : {}".format(k, v)) +# +# print("Processing user overrides (additional kwargs that are not None)...") +# for k, v in kwargs: +# if k not in _amp_state.opt_properties.options: +# raise RuntimeError("Unexpected kwarg {}".format(k)) +# if v is not None: +# setattr(opt_properties, k, v) +# +# print("After processing overrides, optimization options are:") +# for k, v in opt_properties.options: +# print("{:22} : {}".format(k, v)) diff --git a/apex/apex/amp/handle.py b/apex/apex/amp/handle.py new file mode 100644 index 0000000000000000000000000000000000000000..0be567ca48cfdaf184fc9f2f90e9cf4ffb8c2b6a --- /dev/null +++ b/apex/apex/amp/handle.py @@ -0,0 +1,281 @@ +import contextlib +import warnings +import sys +import torch + +from . import utils +from .opt import OptimWrapper +from .scaler import LossScaler +from ._amp_state import _amp_state, master_params, maybe_print + +if torch.distributed.is_available(): + from ..parallel.LARC import LARC + + +# There's no reason to expose the notion of a "handle". Everything can happen through amp.* calls. +@contextlib.contextmanager +def scale_loss(loss, + optimizers, + loss_id=0, + model=None, + delay_unscale=False, + delay_overflow_check=False): + """ + On context manager entrance, creates ``scaled_loss = (loss.float())*current loss scale``. + ``scaled_loss`` is yielded so that the user can call ``scaled_loss.backward()``:: + + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + + On context manager exit (if ``delay_unscale=False``), the gradients are checked for infs/NaNs + and unscaled, so that ``optimizer.step()`` can be called. + + .. note:: + If Amp is using explicit FP32 master params (which is the default for ``opt_level=O2``, and + can also be manually enabled by supplying ``master_weights=True`` to ``amp.initialize``) + any FP16 gradients are copied to FP32 master gradients before being unscaled. + ``optimizer.step()`` will then apply the unscaled master gradients to the master params. + + .. warning:: + If Amp is using explicit FP32 master params, only the FP32 master gradients will be + unscaled. The direct ``.grad`` attributes of any FP16 + model params will remain scaled after context manager exit. + This subtlety affects gradient clipping. See "Gradient clipping" under + `Advanced Amp Usage`_ for best practices. + + Args: + loss(Tensor): Typically a scalar Tensor. The ``scaled_loss`` that the context + manager yields is simply ``loss.float()*loss_scale``, so in principle + ``loss`` could have more than one element, as long as you call + ``backward()`` on ``scaled_loss`` appropriately within the context manager body. + optimizers: All optimizer(s) for which the current backward pass is creating gradients. + Must be an optimizer or list of optimizers returned from an earlier call + to ``amp.initialize``. For example use with multiple optimizers, see + "Multiple models/optimizers/losses" under `Advanced Amp Usage`_. + loss_id(int, optional, default=0): When used in conjunction with the ``num_losses`` argument + to ``amp.initialize``, enables Amp to use a different loss scale per loss. ``loss_id`` + must be an integer between 0 and ``num_losses`` that tells Amp which loss is + being used for the current backward pass. See "Multiple models/optimizers/losses" + under `Advanced Amp Usage`_ for examples. If ``loss_id`` is left unspecified, Amp + will use the default global loss scaler for this backward pass. + model(torch.nn.Module, optional, default=None): Currently unused, reserved to enable future + optimizations. + delay_unscale(bool, optional, default=False): ``delay_unscale`` is never necessary, and + the default value of ``False`` is strongly recommended. + If ``True``, Amp will not unscale the gradients or perform model->master + gradient copies on context manager exit. + ``delay_unscale=True`` is a minor ninja performance optimization and can result + in weird gotchas (especially with multiple models/optimizers/losses), + so only use it if you know what you're doing. + "Gradient accumulation across iterations" under `Advanced Amp Usage`_ + illustrates a situation where this CAN (but does not need to) be used. + + .. warning:: + If ``delay_unscale`` is ``True`` for a given backward pass, ``optimizer.step()`` cannot be + called yet after context manager exit, and must wait for another, later backward context + manager invocation with ``delay_unscale`` left to False. + + .. _`Advanced Amp Usage`: + https://nvidia.github.io/apex/advanced.html + """ + if not hasattr(_amp_state, "opt_properties"): + raise RuntimeError("Invoked 'with amp.scale_loss`, but internal Amp state has not been initialized. " + "model, optimizer = amp.initialize(model, optimizer, opt_level=...) must be called " + "before `with amp.scale_loss`.") + + if not _amp_state.opt_properties.enabled: + yield loss + return + + if isinstance(optimizers, torch.optim.Optimizer) or ('LARC' in globals() and isinstance(optimizers, LARC)): + optimizers = [optimizers] + + loss_scaler = _amp_state.loss_scalers[loss_id] + loss_scale = loss_scaler.loss_scale() + + if ((not _amp_state.opt_properties.master_weights) + and (not loss_scaler.dynamic) + and loss_scale == 1.0): + yield loss.float() + # Needing to drop the cache here as well is an ugly gotcha. + # But for now I think it's necessary to short-circuit. + # Probably ok to skip this if not delay_unscale + if _amp_state.opt_properties.patch_torch_functions: + _amp_state.handle._clear_cache() + return + + if not delay_unscale: + if isinstance(optimizers, list): + for optimizer in optimizers: + if not optimizer._amp_stash.params_have_scaled_gradients: + optimizer._prepare_amp_backward() + + yield (loss.float())*loss_scale + + if delay_unscale: + for optimizer in optimizers: + optimizer._amp_stash.params_have_scaled_gradients = True + else: + # FusedSGD may take care of unscaling as part of their step() methods. + # if not isinstance(optimizers, FP16_Optimizer_for_fused): + loss_scaler.clear_overflow_state() + for optimizer in optimizers: + optimizer._post_amp_backward(loss_scaler) + optimizer._amp_stash.params_have_scaled_gradients = False + # For future fused optimizers that enable sync-free dynamic loss scaling, + # should_skip will always be False. + should_skip = False if delay_overflow_check else loss_scaler.update_scale() + if should_skip: + for optimizer in optimizers: + if not optimizer._amp_stash.already_patched: + # Close on loss_scaler and loss_id as well, to be safe. Probably not + # necessary because amp.scale_loss is already creating a temporary scope. + def patch_step(opt, loss_scaler, loss_id): + opt_step = opt.step + def skip_step(closure=None): + if closure is not None: + raise RuntimeError("Currently, Amp does not support closure use with optimizers.") + maybe_print(("Gradient overflow. Skipping step, loss scaler " + + "{} reducing loss scale to {}").format(loss_id, + loss_scaler.loss_scale())) + # TODO: I don't like the special casing for different optimizer implementations. + # Maybe skip should delegate to a method owned by the optimizers themselves. + if hasattr(opt._amp_stash, "all_fp32_from_fp16_params"): + # Clear the master grads that wouldn't be zeroed by model.zero_grad() + for param in opt._amp_stash.all_fp32_from_fp16_params: + param.grad = None + if hasattr(opt, "most_recent_scale"): + opt.most_recent_scale = 1.0 + opt.scale_set_by_backward = False + opt.step = opt_step + opt._amp_stash.already_patched = False + return skip_step + optimizer.step = patch_step(optimizer, loss_scaler, loss_id) + optimizer._amp_stash.already_patched = True + + # Probably ok to skip this if not delay_unscale + if _amp_state.opt_properties.patch_torch_functions: + _amp_state.handle._clear_cache() + + +# Free function version of AmpHandle.disable_casts, another step on the +# path to removing the concept of "AmpHandle" +@contextlib.contextmanager +def disable_casts(): + _amp_state.handle._is_active = False + yield + _amp_state.handle._is_active = True + + +class AmpHandle(object): + def __init__(self, loss_scale="dynamic", enable_caching=True, verbose=False): + self._enable_caching = enable_caching + self._verbose = verbose + self._cache = dict() + self._default_scaler = LossScaler(loss_scale) + self._is_active = True + self._all_wrappers = [] + + def is_active(self): + return self._is_active + + @contextlib.contextmanager + def _disable_casts(self): + self._is_active = False + yield + self._is_active = True + + def wrap_optimizer(self, optimizer, num_loss=1): + self._default_scaler = None + return OptimWrapper(optimizer, self, num_loss) + + @contextlib.contextmanager + def scale_loss(self, loss, optimizer): + raise RuntimeError("The old Amp API is no longer supported. Please move to the new API, " + "documented here: https://nvidia.github.io/apex/amp.html. Transition guide: " + "https://nvidia.github.io/apex/amp.html#transition-guide-for-old-api-users") + + if not self.is_active(): + yield loss + return + + if self._default_scaler is None: + raise RuntimeError( + 'After calling `handle.wrap_optimizer()`, you must explicitly ' + + 'use `optimizer.scale_loss(loss)`.') + + # TODO: this code block is duplicated here and `opt.py`. Unify. + loss_scale = self._default_scaler.loss_scale() + yield loss * loss_scale + + self._default_scaler.clear_overflow_state() + self._default_scaler.unscale( + master_params(optimizer), + master_params(optimizer), + loss_scale) + should_skip = self._default_scaler.update_scale() + if should_skip: + optimizer_step = optimizer.step + def skip_step(): + maybe_print('Gradient overflow, skipping update') + optimizer.step = optimizer_step + optimizer.step = skip_step + + self._clear_cache() + + def _clear_cache(self): + self._cache.clear() + + # Experimental support for saving / restoring uncasted versions of functions + def _save_func(self, mod, fn, func): + self._all_wrappers.append((mod, fn, func)) + + def _deactivate(self): + for mod, fn, func in self._all_wrappers: + utils.set_func(mod, fn, func) + self._all_wrappers = [] + + @property + def has_cache(self): + return self._enable_caching + + @property + def cache(self): + return self._cache + + def remove_cache(self, param): + if self.has_cache and param in self.cache: + del self.cache[param] + + @property + def verbose(self): + return self._verbose + +class NoOpHandle(object): + def is_active(self): + return False + + @contextlib.contextmanager + def _disable_casts(self): + yield + + def wrap_optimizer(self, optimizer, num_loss=1): + return OptimWrapper(optimizer, self, num_loss) + + @contextlib.contextmanager + def scale_loss(self, loss, optimizer): + yield loss + + @property + def has_cache(self): + return False + + @property + def verbose(self): + return False + + def _clear_cache(self): + pass + + def _deactivate(self): + pass diff --git a/apex/apex/amp/lists/__init__.py b/apex/apex/amp/lists/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/apex/amp/lists/functional_overrides.py b/apex/apex/amp/lists/functional_overrides.py new file mode 100644 index 0000000000000000000000000000000000000000..dd009cec6e7a4dd55cee0273802b625479fe25b6 --- /dev/null +++ b/apex/apex/amp/lists/functional_overrides.py @@ -0,0 +1,80 @@ + +# TODO: think about the following two. They do weird things. +# - torch.nn.utils.clip_grad (but it should always be fp32 anyway) +# - torch.nn.utils.weight_norm + +# Notes: +# F.instance_norm uses batch_norm internally. Which correctly handles +# fp16 in/out with fp32 weights. So we shouldn't do anything for +# either of these. +# F.normalize calls `input.norm()` internally, so it's redundant, but +# kept here in case impl. changes. +# F.cosine_similarity is same: calls `x.norm()` internally. + +import torch.nn.functional + +MODULE = torch.nn.functional + +FP16_FUNCS = [ + 'conv1d', + 'conv2d', + 'conv3d', + 'conv_transpose1d', + 'conv_transpose2d', + 'conv_transpose3d', + 'conv_tbc', # Undocumented / maybe new? + 'linear', +] + +FP32_FUNCS = [ + + # Interpolation/Upsampling TODO: Remove for 1.2 + 'interpolate', + 'grid_sample', + + # Pointwise + 'softplus', + 'softmin', + 'log_softmax', + 'softmax', + 'gelu', + + # Normalization + 'layer_norm', + 'group_norm', + 'local_response_norm', + 'normalize', + 'cosine_similarity', + + # Loss functions + # TODO: which of these can be fp16? + 'poisson_nll_loss', + 'cosine_embedding_loss', + 'cross_entropy', + 'hinge_embedding_loss', + 'kl_div', + 'l1_loss', + 'mse_loss', + 'margin_ranking_loss', + 'multilabel_margin_loss', + 'multilabel_soft_margin_loss', + 'multi_margin_loss', + 'nll_loss', + 'binary_cross_entropy_with_logits', + 'smooth_l1_loss', + 'soft_margin_loss', + 'triplet_margin_loss', + 'ctc_loss' +] + +BANNED_FUNCS = [ + ('binary_cross_entropy', + ("\namp does not work out-of-the-box with `F.binary_cross_entropy` or `torch.nn.BCELoss.` " + "It requires that the output of the previous function be already a FloatTensor. \n\n" + "Most models have a Sigmoid right before BCELoss. In that case, you can use\n" + " torch.nn.BCEWithLogitsLoss\nto combine Sigmoid+BCELoss into a single layer " + "that is compatible with amp.\nAnother option is to add\n" + " amp.register_float_function(torch, 'sigmoid')\nbefore calling `amp.init()`.\n" + "If you _really_ know what you are doing, you can disable this warning by passing " + "allow_banned=True to `amp.init()`.")) +] diff --git a/apex/apex/amp/lists/tensor_overrides.py b/apex/apex/amp/lists/tensor_overrides.py new file mode 100644 index 0000000000000000000000000000000000000000..18f3e5dcf221d545eebad9e354b4998e82e06dc2 --- /dev/null +++ b/apex/apex/amp/lists/tensor_overrides.py @@ -0,0 +1,63 @@ +from .. import compat +from . import torch_overrides + +import importlib + +import torch + +# if compat.variable_is_tensor() and not compat.tensor_is_variable(): +MODULE = torch.Tensor +# else: +# MODULE = torch.autograd.Variable + + +FP16_FUNCS = compat.filter_attrs(MODULE, [ + '__matmul__', +]) + +FP32_FUNCS = compat.filter_attrs(MODULE, [ + '__ipow__', + '__pow__', + '__rpow__', + + # Cast to fp32 before transfer to CPU + 'cpu', +]) + +CASTS = compat.filter_attrs(MODULE, [ + '__add__', + '__div__', + '__eq__', + '__ge__', + '__gt__', + '__iadd__', + '__idiv__', + '__imul__', + '__isub__', + '__itruediv__', + '__le__', + '__lt__', + '__mul__', + '__ne__', + '__radd__', + '__rdiv__', + '__rmul__', + '__rsub__', + '__rtruediv__', + '__sub__', + '__truediv__', +]) + +# None of these, but here to make code cleaner. +SEQUENCE_CASTS = [] + +# We need to grab all the methods from torch_overrides and add them to +# the Tensor lists as well, as almost all methods are duplicated +# between `torch` and `torch.Tensor` (and check with `hasattr`, +# because a few random ones aren't defined on Tensor) +_self_mod = importlib.import_module(__name__) +for attrname in ['FP16_FUNCS', 'FP32_FUNCS', 'CASTS', 'SEQUENCE_CASTS']: + lst = getattr(_self_mod, attrname) + for fn in getattr(torch_overrides, attrname): + if hasattr(MODULE, fn): + lst.append(fn) diff --git a/apex/apex/amp/lists/torch_overrides.py b/apex/apex/amp/lists/torch_overrides.py new file mode 100644 index 0000000000000000000000000000000000000000..7dedb05a83f590e2a2519cdc98a80408673ba691 --- /dev/null +++ b/apex/apex/amp/lists/torch_overrides.py @@ -0,0 +1,115 @@ +import torch + +from .. import utils + +MODULE = torch + +FP16_FUNCS = [ + # Low level functions wrapped by torch.nn layers. + # The wrapper layers contain the weights which are then passed in as a parameter + # to these functions. + 'conv1d', + 'conv2d', + 'conv3d', + 'conv_transpose1d', + 'conv_transpose2d', + 'conv_transpose3d', + 'conv_tbc', + 'prelu', + + # BLAS + 'addmm', + 'addmv', + 'addr', + 'matmul', + 'mm', + 'mv', +] + +FP32_FUNCS = [ + # Pointwise + 'acos', + 'asin', + 'cosh', + 'erfinv', + 'exp', + 'expm1', + 'log', + 'log10', + 'log2', + 'reciprocal', + 'rsqrt', + 'sinh', + 'tan', + + # Other math + 'pow', + + # Reduction + 'cumprod', + 'cumsum', + 'dist', + # 'mean', + 'norm', + 'prod', + 'std', + 'sum', + 'var', + + # Misc + 'renorm' +] + +version_strings = torch.__version__.split('.') +version_major = version_strings[0] +version_minor = version_strings[1] +version_num = float(version_major + "." + version_minor) +# Before torch 1.1, mean must be blacklisted. +if version_num < 1.1: + FP32_FUNCS.append('mean') + +# Before CUDA 9.1, batched matmul was missing fast FP16 kernels. We +# check the CUDA version -- if at least 9.1, then put the bmm +# functions on the fp16 list. Otherwise, put them on the fp32 list. +_bmms = ['addbmm', + 'baddbmm', + 'bmm'] + +if utils.is_cuda_enabled(): + # workaround https://github.com/facebookresearch/maskrcnn-benchmark/issues/802 + if utils.get_cuda_version() >= (9, 1, 0): + FP16_FUNCS.extend(_bmms) + else: + FP32_FUNCS.extend(_bmms) + +# Multi-tensor fns that may need type promotion +CASTS = [ + # Multi-tensor math + 'addcdiv', + 'addcmul', + 'atan2', + 'cross', + 'bilinear', + 'dot', + + # Element-wise _or_ tensor-wise math + 'add', + 'div', + 'mul', + + # Comparison + 'eq', + 'equal', + 'ge', + 'gt', + 'le', + 'lt', + 'ne' +] + +# Functions that take sequence arguments. We need to inspect the whole +# sequence and cast to the widest type. +SEQUENCE_CASTS = [ + 'cat', + 'stack' +] diff --git a/apex/apex/amp/opt.py b/apex/apex/amp/opt.py new file mode 100644 index 0000000000000000000000000000000000000000..baf311684de179e3026f15bae99d7aae9e266ce6 --- /dev/null +++ b/apex/apex/amp/opt.py @@ -0,0 +1,103 @@ +import contextlib +import warnings + +from .scaler import LossScaler, master_params +from ._amp_state import maybe_print + +import numpy as np + +class OptimWrapper(object): + def __init__(self, optimizer, amp_handle, num_loss): + self._optimizer = optimizer + self._amp_handle = amp_handle + self._num_loss = num_loss + self._loss_idx = 0 + self._skip_next = [False] * num_loss + self._loss_scaler = [LossScaler('dynamic') for _ in range(num_loss)] + + @contextlib.contextmanager + def scale_loss(self, loss): + if not self._amp_handle.is_active(): + yield loss + return + + # When there are multiple losses per-optimizer, we need + # to save out current grad accumulation, since we won't be + # able to unscale this particulare loss once the grads are + # all mixed together. + cached_grads = [] + if self._loss_idx > 0: + for p in master_params(self._optimizer): + if p.grad is not None: + cached_grads.append(p.grad.data.detach().clone()) + else: + cached_grads.append(None) + self._optimizer.zero_grad() + + loss_scale = self._cur_loss_scaler().loss_scale() + yield loss * loss_scale + + self._cur_loss_scaler().clear_overflow_state() + self._cur_loss_scaler().unscale( + master_params(self._optimizer), + master_params(self._optimizer), + loss_scale) + self._skip_next[self._loss_idx] = self._cur_loss_scaler().update_scale() + self._loss_idx += 1 + + if len(cached_grads) > 0: + for p, cached_grad in zip(master_params(self._optimizer), + cached_grads): + if cached_grad is not None: + p.grad.data.add_(cached_grad) + cached_grads = [] + + def _cur_loss_scaler(self): + assert 0 <= self._loss_idx < self._num_loss + return self._loss_scaler[self._loss_idx] + + def step(self, closure=None): + if not self._amp_handle.is_active(): + return self._optimizer.step(closure=closure) + + self._loss_idx = 0 + + for group in self._optimizer.param_groups: + for p in group['params']: + self._amp_handle.remove_cache(p) + + if closure is not None: + raise NotImplementedError( + 'The `closure` argument is unsupported by the amp ' + + 'optimizer wrapper.') + if any(self._skip_next): + maybe_print('Gradient overflow, skipping update') + self._skip_next = [False] * self._num_loss + else: + return self._optimizer.step(closure=closure) + + # Forward any attribute lookups + def __getattr__(self, attr): + return getattr(self._optimizer, attr) + + # Forward all torch.optim.Optimizer methods + def __getstate__(self): + return self._optimizer.__getstate__() + + def __setstate__(self): + return self._optimizer.__setstate__() + + def __repr__(self): + return self._optimizer.__repr__() + + def state_dict(self): + return self._optimizer.state_dict() + + def load_state_dict(self, state_dict): + return self._optimizer.load_state_dict(state_dict) + + def zero_grad(self): + return self._optimizer.zero_grad() + + def add_param_group(self, param_group): + return self._optimizer.add_param_group(param_group) diff --git a/apex/apex/amp/rnn_compat.py b/apex/apex/amp/rnn_compat.py new file mode 100644 index 0000000000000000000000000000000000000000..d062ae26587031430b215d66f6062177b9881630 --- /dev/null +++ b/apex/apex/amp/rnn_compat.py @@ -0,0 +1,53 @@ +from . import utils, wrap + +import torch +_VF = torch._C._VariableFunctions +RNN_NAMES = ['rnn_relu', 'rnn_tanh', 'gru', 'lstm'] + +def _gen_VF_wrapper(name): + def wrapper(*args, **kwargs): + return getattr(_VF, name)(*args, **kwargs) + return wrapper + +# Some python magic to generate an object that has the rnn cell functions +# defined on it, all of which call into corresponding _VF version. +# Intended to patch torch.nn.modules.rnn._VF (aka, the ref named "_VF" +# imported at module scope within torch.nn.modules.rnn). This should +# not affect third-party importers of _VF.py. +class VariableFunctionsShim(object): + def __init__(self): + for name in RNN_NAMES: + for suffix in ['', '_cell']: + fn_name = name + suffix + setattr(self, fn_name, _gen_VF_wrapper(fn_name)) + +def has_old_rnns(): + try: + torch.nn.backends.thnn.backend.LSTMCell + return True + except: + return False + +def whitelist_rnn_cells(handle, verbose): + # Different module + function names in old/new RNN cases + if has_old_rnns(): + fn_names = ['RNNReLUCell', 'RNNTanhCell', 'LSTMCell', 'GRUCell'] + mod = torch.nn.backends.thnn.backend + else: + fn_names = [x + '_cell' for x in RNN_NAMES] + mod = torch.nn.modules.rnn._VF + assert isinstance(mod, VariableFunctionsShim) + + # Insert casts on cell functions + for fn in fn_names: + wrap.cached_cast(mod, fn, utils.maybe_half, handle, + try_caching=True, verbose=verbose) + + if has_old_rnns(): + # Special handling of `backward` for fused gru / lstm: + # The `backward` method calls Tensor.sum() (blacklist) internally, + # and then the resulting grad_input has the wrong type. + # TODO: where else is this a problem? + for rnn_type in ['GRUFused', 'LSTMFused']: + mod = getattr(torch.nn._functions.thnn.rnnFusedPointwise, rnn_type) + wrap.disable_casts(mod, 'backward', handle) diff --git a/apex/apex/amp/scaler.py b/apex/apex/amp/scaler.py new file mode 100644 index 0000000000000000000000000000000000000000..99888bc6fcebe7e3cd7378bc49e030835b5b9e10 --- /dev/null +++ b/apex/apex/amp/scaler.py @@ -0,0 +1,217 @@ +import torch +from ..multi_tensor_apply import multi_tensor_applier +from ._amp_state import _amp_state, master_params, maybe_print +from itertools import product + +def scale_check_overflow_python(model_grad, master_grad, scale, check_overflow=False): + # Exception handling for 18.04 compatibility + if check_overflow: + cpu_sum = float(model_grad.float().sum()) + if cpu_sum == float('inf') or cpu_sum == -float('inf') or cpu_sum != cpu_sum: + return True + + if master_grad is not model_grad: # copy_ probably internally short-circuits this + master_grad.copy_(model_grad) + if scale != 1.0: + master_grad.mul_(scale) + return False + +def axpby_check_overflow_python(model_grad, stashed_grad, master_grad, a, b, check_overflow=False): + # Exception handling for 18.04 compatibility + if check_overflow: + cpu_sum = float(model_grad.float().sum()) + if cpu_sum == float('inf') or cpu_sum == -float('inf') or cpu_sum != cpu_sum: + return True + + # if master_grad is not model_grad: # copy_ probably internally short-circuits this + # master_grad.copy_(model_grad) + assert stashed_grad.dtype == master_grad.dtype + converted_model_grad = model_grad.data.to(master_grad.dtype) + master_grad.data = a*converted_model_grad.data + b*stashed_grad.data + return False + +class LossScaler(object): + warned_no_fused_kernel = False + warned_unscaling_non_fp32_grad = False + has_fused_kernel = False + + def __init__(self, + loss_scale, + init_scale=2.**16, + scale_factor=2., + scale_window=2000, + min_loss_scale=None, + max_loss_scale=2.**24): + if loss_scale == "dynamic": + self.dynamic = True + self._loss_scale = min(max_loss_scale, init_scale) + else: + self.dynamic = False + self._loss_scale = loss_scale + self._max_loss_scale = max_loss_scale + self._min_loss_scale = min_loss_scale + self._scale_seq_len = scale_window + self._unskipped = 0 + self._has_overflow = False + self._overflow_buf = torch.cuda.IntTensor([0]) + if multi_tensor_applier.available: + import amp_C + LossScaler.has_fused_kernel = multi_tensor_applier.available + LossScaler.multi_tensor_scale_cuda = amp_C.multi_tensor_scale + LossScaler.multi_tensor_axpby_cuda = amp_C.multi_tensor_axpby + else: + if not LossScaler.warned_no_fused_kernel: + maybe_print( + "Warning: multi_tensor_applier fused unscale kernel is unavailable, " + "possibly because apex was installed without --cuda_ext --cpp_ext. " + "Using Python fallback. Original ImportError was: " + + repr(multi_tensor_applier.import_err), + True) + LossScaler.has_fused_kernel = False + LossScaler.warned_no_fused_kernel = True + + def loss_scale(self): + return self._loss_scale + + def unscale_python(self, model_grads, master_grads, scale): + for model, master in zip(model_grads, master_grads): + if model is not None: + if not LossScaler.warned_unscaling_non_fp32_grad: + if master.dtype != torch.float32: + maybe_print( + "Attempting to unscale a grad with type {} ".format(master.type()) + + "Unscaling non-fp32 grads may indicate an error. " + "When using Amp, you don't need to call .half() on your model.") + LossScaler.warned_unscaling_non_fp32_grad = True + self._has_overflow = scale_check_overflow_python(model, + master, + 1./scale, + self.dynamic) + if self._has_overflow and self.dynamic: + break + + # unused_scale keeps some of the old API alive for hopefully a short time. + def unscale(self, model_grads, master_grads, unused_scale, models_are_masters=False, scale_override=None): + if self._has_overflow: + return + + scale = self._loss_scale + if scale_override is not None: + scale = scale_override + + if scale == 1.0 and models_are_masters and not self.dynamic: + return + + if LossScaler.has_fused_kernel: + # if (not LossScaler.warned_unscaling_non_fp32_grad + # and master_grads[0].dtype == torch.float16): + # print("Warning: unscaling grads that are not FP32. " + # "Unscaling non-fp32 grads may indicate an error. " + # "When using Amp, you don't need to call .half() on your model.") + # # Setting this to True unconditionally allows the possibility of an escape + # # if never-before-seen non-fp32 grads are created in some later iteration. + # LossScaler.warned_unscaling_non_fp32_grad = True + multi_tensor_applier(LossScaler.multi_tensor_scale_cuda, + self._overflow_buf, + [model_grads, master_grads], + 1./scale) + else: + self.unscale_python(model_grads, master_grads, scale) + + # Defer to update_scale + # If the fused kernel is available, we only need one D2H memcopy and sync. + # if LossScaler.has_fused_kernel and self.dynamic and not self._has_overflow: + # self._has_overflow = self._overflow_buf.item() + + def unscale_with_stashed_python(self, + model_grads, + stashed_master_grads, + master_grads, + a, + b): + for model, stashed, master in zip(model_grads, stashed_master_grads, master_grads): + if model is None and stashed is None: + continue + else: + if not LossScaler.warned_unscaling_non_fp32_grad: + if master.dtype != torch.float32: + maybe_print( + "Attempting to unscale a grad with type {} ".format(master.type()) + + "Unscaling non-fp32 grads may indicate an error. " + "When using Amp, you don't need to call .half() on your model.") + LossScaler.warned_unscaling_non_fp32_grad = True + self._has_overflow = axpby_check_overflow_python(model, + stashed, + master, + a, + b, + self.dynamic) + if self._has_overflow and self.dynamic: + break + + def unscale_with_stashed(self, + model_grads, + stashed_master_grads, + master_grads, + scale_override=None): + if self._has_overflow: + return + + grads_have_scale, stashed_have_scale, out_scale = self._loss_scale, 1.0, 1.0 + if scale_override is not None: + grads_have_scale, stashed_have_scale, out_scale = scale_override + + if LossScaler.has_fused_kernel: + if (not LossScaler.warned_unscaling_non_fp32_grad + and master_grads[0].dtype == torch.float16): + print("Warning: unscaling grads that are not FP32. " + "Unscaling non-fp32 grads may indicate an error. " + "When using Amp, you don't need to call .half() on your model.") + # Setting this to True unconditionally allows the possibility of an escape + # if never-before-seen non-fp32 grads are created in some later iteration. + LossScaler.warned_unscaling_non_fp32_grad = True + multi_tensor_applier(LossScaler.multi_tensor_axpby_cuda, + self._overflow_buf, + [model_grads, stashed_master_grads, master_grads], + out_scale/grads_have_scale, # 1./scale, + out_scale/stashed_have_scale, # 1.0, + 0) # check only arg 0, aka the incoming model grads, for infs + else: + self.unscale_with_stashed_python(model_grads, + stashed_master_grads, + master_grads, + out_scale/grads_have_scale, + out_scale/stashed_have_scale) + + # Defer to update_scale + # If the fused kernel is available, we only need one D2H memcopy and sync. + # if LossScaler.has_fused_kernel and self.dynamic and not self._has_overflow: + # self._has_overflow = self._overflow_buf.item() + + def clear_overflow_state(self): + self._has_overflow = False + if self.has_fused_kernel: + self._overflow_buf.zero_() + + # Separate so unscale() can be called more that once before updating. + def update_scale(self): + # If the fused kernel is available, we only need one D2H memcopy and sync. + if LossScaler.has_fused_kernel and self.dynamic and not self._has_overflow: + self._has_overflow = self._overflow_buf.item() + + if self._has_overflow and self.dynamic: + should_skip = True + if(self._min_loss_scale): + self._loss_scale = max(self._min_loss_scale, self._loss_scale/2.) + else: + self._loss_scale = self._loss_scale/2. + self._unskipped = 0 + else: + should_skip = False + self._unskipped += 1 + + if self._unskipped == self._scale_seq_len and self.dynamic: + self._loss_scale = min(self._max_loss_scale, self._loss_scale*2.) + self._unskipped = 0 + + return should_skip diff --git a/apex/apex/amp/utils.py b/apex/apex/amp/utils.py new file mode 100644 index 0000000000000000000000000000000000000000..0590cd70a1a3f78bbb13ef80d99441432b5fb649 --- /dev/null +++ b/apex/apex/amp/utils.py @@ -0,0 +1,210 @@ +from . import compat + +import functools +import itertools + +import torch + +def is_cuda_enabled(): + return torch.version.cuda is not None + +def get_cuda_version(): + return tuple(int(x) for x in torch.version.cuda.split('.')) + +def is_fp_tensor(x): + if is_nested(x): + # Fast-fail version of all(is_fp_tensor) + for y in x: + if not is_fp_tensor(y): + return False + return True + return compat.is_tensor_like(x) and compat.is_floating_point(x) + +def is_nested(x): + return isinstance(x, tuple) or isinstance(x, list) + +def should_cache(x): + if is_nested(x): + # Fast-fail version of all(should_cache) + for y in x: + if not should_cache(y): + return False + return True + return isinstance(x, torch.nn.parameter.Parameter) and \ + type_string(x) == 'FloatTensor' + +def collect_fp_tensor_types(args, kwargs): + def collect_types(x, types): + if is_nested(x): + for y in x: + collect_types(y, types) + else: + types.add(type_string(x)) + + all_args = itertools.chain(args, kwargs.values()) + types = set() + for x in all_args: + if is_fp_tensor(x): + collect_types(x, types) + return types + +def type_string(x): + return x.type().split('.')[-1] + +def maybe_half(x, name='', verbose=False): + if is_nested(x): + return type(x)([maybe_half(y) for y in x]) + + if not x.is_cuda or type_string(x) == 'HalfTensor': + return x + else: + if verbose: + print('Float->Half ({})'.format(name)) + return x.half() + +def maybe_float(x, name='', verbose=False): + if is_nested(x): + return type(x)([maybe_float(y) for y in x]) + + if not x.is_cuda or type_string(x) == 'FloatTensor': + return x + else: + if verbose: + print('Half->Float ({})'.format(name)) + return x.float() + +# NB: returneds casted `args`, mutates `kwargs` in-place +def casted_args(cast_fn, args, kwargs): + new_args = [] + for x in args: + if is_fp_tensor(x): + new_args.append(cast_fn(x)) + else: + new_args.append(x) + for k in kwargs: + val = kwargs[k] + if is_fp_tensor(val): + kwargs[k] = cast_fn(val) + return new_args + +def cached_cast(cast_fn, x, cache): + if is_nested(x): + return type(x)([cached_cast(y) for y in x]) + if x in cache: + cached_x = cache[x] + if x.requires_grad and cached_x.requires_grad: + # Make sure x is actually cached_x's autograd parent. + if cached_x.grad_fn.next_functions[1][0].variable is not x: + raise RuntimeError("x and cache[x] both require grad, but x is not " + "cache[x]'s parent. This is likely an error.") + # During eval, it's possible to end up caching casted weights with + # requires_grad=False. On the next training iter, if cached_x is found + # and reused from the cache, it will not actually have x as its parent. + # Therefore, we choose to invalidate the cache (and force refreshing the cast) + # if x.requires_grad and cached_x.requires_grad do not match. + # + # During eval (i.e. running under with torch.no_grad()) the invalidation + # check would cause the cached value to be dropped every time, because + # cached_x would always be created with requires_grad=False, while x would + # still have requires_grad=True. This would render the cache effectively + # useless during eval. Therefore, if we are running under the no_grad() + # context manager (torch.is_grad_enabled=False) we elide the invalidation + # check, and use the cached value even though its requires_grad flag doesn't + # match. During eval, we don't care that there's no autograd-graph + # connection between x and cached_x. + if torch.is_grad_enabled() and x.requires_grad != cached_x.requires_grad: + del cache[x] + else: + return cached_x + + casted_x = cast_fn(x) + cache[x] = casted_x + return casted_x + +def verbosify(cast_fn, fn_name, verbose): + if verbose: + return functools.partial(cast_fn, name=fn_name, verbose=verbose) + else: + return cast_fn + +def as_inplace(fns): + for x in fns: + yield x + '_' + +def has_func(mod, fn): + if isinstance(mod, dict): + return fn in mod + else: + return hasattr(mod, fn) + +def get_func(mod, fn): + if isinstance(mod, dict): + return mod[fn] + else: + return getattr(mod, fn) + +def set_func(mod, fn, new_fn): + if isinstance(mod, dict): + mod[fn] = new_fn + else: + setattr(mod, fn, new_fn) + +def set_func_save(handle, mod, fn, new_fn): + cur_fn = get_func(mod, fn) + handle._save_func(mod, fn, cur_fn) + set_func(mod, fn, new_fn) + +# A couple problems get solved here: +# - The flat_weight buffer is disconnected from autograd graph, +# so the fp16 weights need to be derived from the input weights +# to this forward call, not the flat buffer. +# - The ordering of weights in the flat buffer is...idiosyncratic. +# First problem is solved with combination of set_ (to set up +# correct storage) and copy_ (so the fp16 weight derives from the +# fp32 one in autograd. +# Second is solved by doing ptr arithmetic on the fp32 weights +# to derive the correct offset. +# +# TODO: maybe this should actually use +# `torch._cudnn_rnn_flatten_weight`? But then I need to call +# on first iter and cache the right offsets. Ugh. +def synthesize_flattened_rnn_weights(fp32_weights, + fp16_flat_tensor, + rnn_fn='', + verbose=False): + fp16_weights = [] + fp32_base_ptr = fp32_weights[0][0].data_ptr() + for layer_weights in fp32_weights: + fp16_layer_weights = [] + for w_fp32 in layer_weights: + w_fp16 = w_fp32.new().half() + offset = (w_fp32.data_ptr() - fp32_base_ptr) // w_fp32.element_size() + w_fp16.set_(fp16_flat_tensor.storage(), + offset, + w_fp32.shape) + w_fp16.copy_(w_fp32) + if verbose: + print('Float->Half ({})'.format(rnn_fn)) + fp16_layer_weights.append(w_fp16) + fp16_weights.append(fp16_layer_weights) + return fp16_weights + +# Roughly same as above, just the `fp32_weights` aren't nested. +# Code kept separate for readability. +def new_synthesize_flattened_rnn_weights(fp32_weights, + fp16_flat_tensor, + rnn_fn='', + verbose=False): + fp16_weights = [] + fp32_base_ptr = fp32_weights[0].data_ptr() + for w_fp32 in fp32_weights: + w_fp16 = w_fp32.new().half() + offset = (w_fp32.data_ptr() - fp32_base_ptr) // w_fp32.element_size() + w_fp16.set_(fp16_flat_tensor.storage(), + offset, + w_fp32.shape) + w_fp16.copy_(w_fp32) + if verbose: + print('Float->Half ({})'.format(rnn_fn)) + fp16_weights.append(w_fp16) + return fp16_weights diff --git a/apex/apex/amp/wrap.py b/apex/apex/amp/wrap.py new file mode 100644 index 0000000000000000000000000000000000000000..559d0558d9a6605f92d37b15d3563f056ad7e318 --- /dev/null +++ b/apex/apex/amp/wrap.py @@ -0,0 +1,276 @@ +from . import compat +from . import utils +from ._amp_state import _amp_state +from . import rnn_compat + +import functools + +import torch + +def make_cast_wrapper(orig_fn, cast_fn, handle, + try_caching=False): + @functools.wraps(orig_fn) + def wrapper(*args, **kwargs): + if not handle.is_active(): + return orig_fn(*args, **kwargs) + + if try_caching and handle.has_cache: + args = list(args) + for i in range(len(args)): + if utils.should_cache(args[i]): + args[i] = utils.cached_cast(cast_fn, args[i], handle.cache) + for k in kwargs: + if utils.should_cache(kwargs[k]): + kwargs[k] = utils.cached_cast(cast_fn, kwargs[k], handle.cache) + new_args = utils.casted_args(cast_fn, + args, + kwargs) + return orig_fn(*new_args, **kwargs) + return wrapper + +def cached_cast(mod, fn, cast_fn, handle, + try_caching=False, verbose=False): + if not utils.has_func(mod, fn): + return + + orig_fn = utils.get_func(mod, fn) + cast_fn = utils.verbosify(cast_fn, fn, verbose) + wrapper = make_cast_wrapper(orig_fn, cast_fn, handle, try_caching) + utils.set_func_save(handle, mod, fn, wrapper) + +# `handle` arg is unused, but simplifies API to make `make_cast_wrapper` +# Annoyingly, make_promote_wrapper still uses the global handle. Once everyone +# is on the new API and I am free to get rid of handle, I can clean this up. +def make_promote_wrapper(orig_fn, cast_fn, handle=None): + @functools.wraps(orig_fn) + def wrapper(*args, **kwargs): + if not _amp_state.handle.is_active(): + return orig_fn(*args, **kwargs) + + types = utils.collect_fp_tensor_types(args, kwargs) + + if len(types) <= 1: + return orig_fn(*args, **kwargs) + elif len(types) == 2 and types == set(['HalfTensor', 'FloatTensor']): + new_args = utils.casted_args(cast_fn, + args, + kwargs) + return orig_fn(*new_args, **kwargs) + else: + raise NotImplementedError('Do not know how to handle ' + + 'these types to promote: {}' + .format(types)) + return wrapper + +def promote(mod, fn, handle, verbose=False): + orig_fn = utils.get_func(mod, fn) + maybe_float = utils.verbosify(utils.maybe_float, fn, verbose) + wrapper = make_promote_wrapper(orig_fn, maybe_float) + utils.set_func_save(handle, mod, fn, wrapper) + +def sequence_promote(mod, fn, handle, verbose=False): + orig_fn = utils.get_func(mod, fn) + maybe_float = utils.verbosify(utils.maybe_float, fn, verbose) + @functools.wraps(orig_fn) + def wrapper(seq, *args, **kwargs): + if not _amp_state.handle.is_active(): + return orig_fn(seq, *args, **kwargs) + + types = set([utils.type_string(x) for x in seq]) + if len(types) <= 1: + return orig_fn(seq, *args, **kwargs) + elif types == set(['HalfTensor', 'FloatTensor']): + cast_seq = utils.casted_args(maybe_float, + seq, {}) + return orig_fn(cast_seq, *args, **kwargs) + else: + # TODO: other mixed-type cases aren't due to amp. + # Just pass through? + return orig_fn(seq, *args, **kwargs) + utils.set_func_save(handle, mod, fn, wrapper) + +def promote_match_arg0(mod, fn, handle, verbose=False): + if not utils.has_func(mod, fn): + return + + orig_fn = utils.get_func(mod, fn) + @functools.wraps(orig_fn) + def wrapper(arg0, *args, **kwargs): + assert compat.is_tensor_like(arg0) + if not _amp_state.handle.is_active(): + return orig_fn(arg0, *args, **kwargs) + + if utils.type_string(arg0) == 'HalfTensor': + cast_fn = utils.maybe_half + elif utils.type_string(arg0) == 'FloatTensor': + cast_fn = utils.maybe_float + else: + return orig_fn(arg0, *args, **kwargs) + cast_fn = utils.verbosify(cast_fn, fn, verbose) + new_args = utils.casted_args(cast_fn, args, kwargs) + return orig_fn(arg0, *new_args, **kwargs) + utils.set_func_save(handle, mod, fn, wrapper) + +def err_if_any_half(mod, fn, handle, custom_err_msg=None): + if not utils.has_func(mod, fn): + return + + orig_fn = utils.get_func(mod, fn) + @functools.wraps(orig_fn) + def wrapper(*args, **kwargs): + types = utils.collect_fp_tensor_types(args, kwargs) + if 'HalfTensor' in types: + if custom_err_msg: + raise NotImplementedError(custom_err_msg) + else: + raise NotImplementedError('Cannot call in-place function ' + + '{} with fp16 arguments.'.format(fn)) + else: + return orig_fn(*args, **kwargs) + utils.set_func_save(handle, mod, fn, wrapper) + +def err_if_arg0_half(mod, fn, handle, verbose=False): + if not utils.has_func(mod, fn): + return + + orig_fn = utils.get_func(mod, fn) + @functools.wraps(orig_fn) + def wrapper(arg0, *args, **kwargs): + assert compat.is_tensor_like(arg0) + if utils.type_string(arg0) == 'HalfTensor': + raise NotImplementedError('Cannot call in-place method ' + + '{} on fp16 Tensors.'.format(fn)) + else: + cast_fn = utils.verbosify(utils.maybe_float, fn, verbose) + new_args = utils.casted_args(cast_fn, args, kwargs) + return orig_fn(arg0, *new_args, **kwargs) + utils.set_func_save(handle, mod, fn, wrapper) + +# Current RNN approach: +# - Wrap top-level `RNN` function in thnn backend +# - Will call into either CudnnRNN or AutogradRNN +# - Each of these are factory functions that return a per-iter +# `forward` function +# - We interpose on the factory function to: +# 1) Interpose on the actual forward function and put in casts +# 2) Insert an fp16 `flat_weight` if necessary +def rnn_cast(backend, fn, handle, verbose=False): + orig_rnn = utils.get_func(backend, fn) + @functools.wraps(orig_rnn) + def rnn_wrapper(*args, **kwargs): + flat_weight = kwargs.get('flat_weight') + if flat_weight is not None: + # We replace `flat_weight` with an uninitialized fp16 + # Tensor. The "actual" weight tensors (provided in `forward`), + # will then be set up as ptrs into the buffer and have the + # corresponding fp32 values copied in. + # We need to call `copy` on the "actual" weights so that the + # autograd graph correctly backprops from the wgrads computed + # inside cuDNN (on fp16 weights) into the fp32 weights. + assert utils.type_string(flat_weight) == 'FloatTensor' + if compat.tensor_is_float_tensor() or compat.tensor_is_variable(): + # Pre-0.4. A little slower, since it zeros out memory. + flat_weight_fp16 = flat_weight.new().half().resize_(flat_weight.shape) + else: + flat_weight_fp16 = torch.empty_like(flat_weight, + dtype=torch.float16) + kwargs['flat_weight'] = flat_weight_fp16 + else: + flat_weight_fp16 = None + + forward = orig_rnn(*args, **kwargs) + @functools.wraps(forward) + def fwd_wrapper(*fargs, **fkwargs): + assert len(fargs) == 3 or len(fargs) == 4 + inputs, weights, hiddens = fargs[:3] + assert utils.is_fp_tensor(inputs) + assert isinstance(weights, list) + cast_fn = utils.verbosify(utils.maybe_half, + fn, + verbose) + new_args = [] + + # 0) Inputs + new_args.append(cast_fn(inputs)) + + # 1) Weights + if flat_weight_fp16 is not None: + fp16_weights = utils.synthesize_flattened_rnn_weights( + weights, flat_weight_fp16, fn, verbose) + else: + fp16_weights = [[cast_fn(w) for w in layer] + for layer in weights] + new_args.append(fp16_weights) + + # 2) Inputs: either a tuple (for LSTM) or single tensor + if isinstance(hiddens, tuple): + new_args.append(tuple(cast_fn(x) for x in hiddens)) + elif utils.is_fp_tensor(hiddens): + new_args.append(cast_fn(hiddens)) + else: + # Hiddens can, in principle, be `None` -- pass through + new_args.append(hiddens) + + # 3) Batch sizes (0.4 or later only) + if len(fargs) == 4: + new_args.append(fargs[3]) + + return forward(*new_args, **fkwargs) + return fwd_wrapper + utils.set_func_save(handle, backend, fn, rnn_wrapper) + +def new_rnn_cast(fn, handle, verbose=False): + # Forward+backward compatibility around https://github.com/pytorch/pytorch/pull/15744 + # For rnn backend calls that route through _rnn_impls, we must patch the ref + # that _rnn_impls stashed. For rnn backend calls that directly invoke + # _VF., e.g. _VF.lstm, we can patch onto VariableFunctionsShim, + # which in turn has patched the ref named "_VF" in torch.nn.modules.rnn. + if utils.has_func(torch.nn.modules.rnn._rnn_impls, fn): + mod = torch.nn.modules.rnn._rnn_impls + else: + mod = torch.nn.modules.rnn._VF + assert isinstance(mod, rnn_compat.VariableFunctionsShim) + fn = fn.lower() + orig_fn = utils.get_func(mod, fn) + cast_fn = utils.verbosify(utils.maybe_half, fn, verbose) + @functools.wraps(orig_fn) + def wrapper(*args, **kwargs): + # Exact call signature from modules/rnn.py + assert len(args) == 9 + assert len(kwargs) == 0 + + if not _amp_state.handle.is_active(): + return orig_fn(*args, **kwargs) + + if isinstance(args[6], bool): + params_idx = 2 # Not PackedSequence case + else: + params_idx = 3 # PackedSequence case + + new_args = [] + for i, arg in enumerate(args): + if i == params_idx: + num_params = sum([x.numel() for x in arg]) + fp16_weight_buf = args[0].new_empty((num_params,), + dtype=torch.half) + casted_weights = utils.new_synthesize_flattened_rnn_weights( + arg, fp16_weight_buf, fn, verbose) + new_args.append(casted_weights) + elif utils.is_fp_tensor(arg): + new_args.append(cast_fn(arg)) + else: + new_args.append(arg) + + return orig_fn(*new_args) + utils.set_func_save(handle, mod, fn, wrapper) + +def disable_casts(mod, fn, handle): + if not utils.has_func(mod, fn): + return + + orig_fn = utils.get_func(mod, fn) + @functools.wraps(orig_fn) + def wrapper(*args, **kwargs): + with handle._disable_casts(): + return orig_fn(*args, **kwargs) + utils.set_func_save(handle, mod, fn, wrapper) diff --git a/apex/apex/contrib/__init__.py b/apex/apex/contrib/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/apex/contrib/bottleneck/__init__.py b/apex/apex/contrib/bottleneck/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..4acbc25d7664ecbe464c709171a309a8ae2fea27 --- /dev/null +++ b/apex/apex/contrib/bottleneck/__init__.py @@ -0,0 +1 @@ +from .bottleneck import Bottleneck diff --git a/apex/apex/contrib/bottleneck/bottleneck.py b/apex/apex/contrib/bottleneck/bottleneck.py new file mode 100644 index 0000000000000000000000000000000000000000..7c4e01a5337701a4088d89b5ebdd7f560aa4ff07 --- /dev/null +++ b/apex/apex/contrib/bottleneck/bottleneck.py @@ -0,0 +1,214 @@ +import torch +from torch import nn +import fast_bottleneck + +def kaiming_uniform_(tensor, a=0, mode='fan_in', nonlinearity='leaky_relu'): + weight_tensor_nchw = tensor + nn.init.kaiming_uniform_(weight_tensor_nchw, a=a, mode=mode, nonlinearity=nonlinearity) + +class FrozenBatchNorm2d(torch.nn.Module): + """ + BatchNorm2d where the batch statistics and the affine parameters are fixed + """ + def __init__(self, n): + super(FrozenBatchNorm2d, self).__init__() + self.register_buffer("weight", torch.ones(n)) + self.register_buffer("bias", torch.zeros(n)) + self.register_buffer("running_mean", torch.zeros(n)) + self.register_buffer("running_var", torch.ones(n)) + + def get_scale_bias(self, nhwc=False): + scale = self.weight * self.running_var.rsqrt() + bias = self.bias - self.running_mean * scale + if nhwc: + scale = scale.reshape(1, 1, 1, -1) + bias = bias.reshape(1, 1, 1, -1) + else: + scale = scale.reshape(1, -1, 1, 1) + bias = bias.reshape(1, -1, 1, 1) + return scale, bias + + def forward(self, x): + scale, bias = self.get_scale_bias() + return x * scale + bias + + +@torch.jit.script +def drelu_dscale1(grad_o, output, scale1): + relu_mask = (output>0).half() + dx_relu = relu_mask * grad_o + g1 = dx_relu * scale1 + return g1, dx_relu + +@torch.jit.script +def drelu_dscale2(grad_o, output, scale1, scale2): + relu_mask = (output>0).half() + dx_relu = relu_mask * grad_o + g1 = dx_relu * scale1 + g2 = dx_relu * scale2 + return g1, g2 + +class BottleneckFunction(torch.autograd.Function): + @staticmethod + def forward(ctx, nhwc, stride_1x1, scale, bias, x, *conv): + # TODO: clean up order of tensors + args = [x, *conv[0:3], *scale[0:3], *bias[0:3]] + ctx.downsample = len(conv) > 3 + if ctx.downsample: + args.append(conv[3]) + args.append(scale[3]) + args.append(bias[3]) + + # weight buffers are always in nhwc while shape can be nhwc or channels_last + # here we pass in flag and let c++ handle it + # alternatively, we can put all sizes into a fixed format and pass it in + outputs = fast_bottleneck.forward(nhwc, stride_1x1, args) + ctx.save_for_backward(*(args+outputs)) + # save relu outputs for drelu + ctx.nhwc = nhwc + ctx.stride_1x1 = stride_1x1 + return outputs[2] + + # backward relu is not exposed, MUL with mask used now + # only support dgrad + @staticmethod + def backward(ctx, grad_o): + outputs = ctx.saved_tensors[-3:] + + if ctx.downsample: + grad_conv3, grad_conv4 = drelu_dscale2(grad_o, outputs[2], ctx.saved_tensors[6], ctx.saved_tensors[11]) + else: + grad_conv3, grad_conv4 = drelu_dscale1(grad_o, outputs[2], ctx.saved_tensors[6]) + + # create input vector for backward + t_list = [*ctx.saved_tensors[0:10]] + t_list.append(grad_conv3) + t_list.append(grad_conv4) + + # outputs used for wgrad and generating drelu mask + t_list.append(outputs[0]) + t_list.append(outputs[1]) + + # in case there is downsample + if ctx.downsample: + t_list.append(ctx.saved_tensors[10]) + + grads = fast_bottleneck.backward(ctx.nhwc, ctx.stride_1x1, t_list) + + return (None, None, None, None, *grads) + +bottleneck_function = BottleneckFunction.apply + +def conv3x3(in_planes, out_planes, stride=1, groups=1, dilation=1): + """3x3 convolution with padding""" + return nn.Conv2d(in_planes, out_planes, kernel_size=3, stride=stride, + padding=dilation, groups=groups, bias=False, dilation=dilation) + +def conv1x1(in_planes, out_planes, stride=1): + """1x1 convolution""" + return nn.Conv2d(in_planes, out_planes, kernel_size=1, stride=stride, bias=False) + +class Bottleneck(torch.nn.Module): + # Bottleneck in torchvision places the stride for downsampling at 3x3 convolution(self.conv2) + # while original implementation places the stride at the first 1x1 convolution(self.conv1) + # according to "Deep residual learning for image recognition"https://arxiv.org/abs/1512.03385. + # This variant is also known as ResNet V1.5 and improves accuracy according to + # https://ngc.nvidia.com/catalog/model-scripts/nvidia:resnet_50_v1_5_for_pytorch. + # here we put it at 1x1 + + def __init__(self, in_channels, bottleneck_channels, out_channels, stride=1, groups=1, + dilation=1, norm_func=None, use_cudnn=False, explicit_nhwc=False): + super(Bottleneck, self).__init__() + if groups != 1: + raise RuntimeError('Only support groups == 1') + if dilation != 1: + raise RuntimeError('Only support dilation == 1') + if norm_func == None: + norm_func = FrozenBatchNorm2d + else: + raise RuntimeError('Only support frozen BN now.') + + if stride != 1 or in_channels != out_channels: + self.downsample = nn.Sequential( + conv1x1(in_channels, out_channels, stride), + norm_func(out_channels), + ) + else: + self.downsample = None + + # Both self.conv2 and self.downsample layers downsample the input when stride != 1 + self.conv1 = conv1x1(in_channels, bottleneck_channels, stride) + self.conv2 = conv3x3(bottleneck_channels, bottleneck_channels) + self.conv3 = conv1x1(bottleneck_channels, out_channels) + self.relu = nn.ReLU(inplace=True) + self.stride = stride + + self.bn1 = norm_func(bottleneck_channels) + self.bn2 = norm_func(bottleneck_channels) + self.bn3 = norm_func(out_channels) + + self.use_cudnn = use_cudnn + + # setup conv weights + self.w_conv = [self.conv1.weight, self.conv2.weight, self.conv3.weight] + if self.downsample is not None: + self.w_conv.append(self.downsample[0].weight) + + # init weight in nchw format before possible transpose + for w in self.w_conv: + kaiming_uniform_(w, a=1) + + # TODO: prevent unsupported case usage + # support cases + # native cudnn + # normal yes no + # channel_last yes yes + # explicit_nhwc no yes + self.explicit_nhwc = explicit_nhwc + if self.explicit_nhwc: + for p in self.parameters(): + with torch.no_grad(): + p.data = p.data.permute(0,2,3,1).contiguous() + return + + def forward(self, x): + if self.use_cudnn: + # calculate scale/bias from registered buffers + # TODO: make this better + s1, b1 = self.bn1.get_scale_bias(self.explicit_nhwc) + s2, b2 = self.bn2.get_scale_bias(self.explicit_nhwc) + s3, b3 = self.bn3.get_scale_bias(self.explicit_nhwc) + w_scale = [s1, s2, s3] + w_bias = [b1, b2, b3] + if self.downsample is not None: + s4, b4 = self.downsample[1].get_scale_bias(self.explicit_nhwc) + w_scale.append(s4) + w_bias.append(b4) + + out = bottleneck_function(self.explicit_nhwc, self.stride, w_scale, w_bias, x, *self.w_conv) + return out + + if self.explicit_nhwc: + raise RuntimeError('explicit nhwc with native ops is not supported.') + + # fallback to native ops + identity = x + + out = self.conv1(x) + out = self.bn1(out) + out = self.relu(out) + + out = self.conv2(out) + out = self.bn2(out) + out = self.relu(out) + + out = self.conv3(out) + out = self.bn3(out) + + if self.downsample is not None: + identity = self.downsample(x) + + out += identity + out = self.relu(out) + + return out diff --git a/apex/apex/contrib/bottleneck/test.py b/apex/apex/contrib/bottleneck/test.py new file mode 100644 index 0000000000000000000000000000000000000000..2c3c6213025240b15f21a9c161c749925158268d --- /dev/null +++ b/apex/apex/contrib/bottleneck/test.py @@ -0,0 +1,71 @@ +import torch +from bottleneck import Bottleneck +torch.manual_seed(23337) + +# use True to print layerwise sum for all outputs in reference code path +DEBUG = False#True + +for stride, o_channel in [(1,32), (1,128), (2,32)]: + print("testing stride ==", stride, ", in_channel == 32 , out_channel ==", o_channel) + a_ = torch.randn(17,32,28,28) + + a = a_.cuda().half().to(memory_format=torch.channels_last).requires_grad_() + model = Bottleneck(32,8,o_channel,stride=stride).cuda().half().to(memory_format=torch.channels_last) + + # test model + b = model(a) + b.mean().backward() + d_grad = a.grad.float() + a.grad = None + torch.cuda.synchronize() + + if DEBUG: + print("[DEBUG] ref dx :", d_grad.sum().item()) + # print wgrad. we don't need to reset since later cpp print before accumulation + for i, w in enumerate(model.w_conv): + print("[DEBUG] ref wgrad{} :".format(i+1), w.grad.sum().item()) + + wgrads = [] + for w in model.w_conv: + wgrads.append(w.grad.float()) + + model.use_cudnn = True + model.zero_grad() + c = model(a) + c.mean().backward() + + torch.cuda.synchronize() + print("comparing native and channels_last:") + print("max error fprop:", (b-c).abs().max().item(), "max elem:", b.abs().max().item()) + print("max error dgrad:", (d_grad-a.grad.float()).abs().max().item(), "max elem:", d_grad.abs().max().item()) + for i, (w, wgrad) in enumerate(zip(model.w_conv, wgrads)): + print("max error wgrad{}:".format(i+1), (wgrad - w.grad.float()).abs().max().item(), "max elem:", wgrad.abs().max().item()) + + nhwc_a = a_.permute(0,2,3,1).contiguous().cuda().half().requires_grad_() + nhwc_model = Bottleneck(32,8,o_channel,stride=stride,explicit_nhwc=True, use_cudnn=True).cuda().half() + for p,q in zip(model.parameters(), nhwc_model.parameters()): + # model's storage is already in nhwc, we clone and assign to explicit nhwc model + q.data.copy_(p.data.permute(0,2,3,1).contiguous()) + for p,q in zip(model.buffers(), nhwc_model.buffers()): + q.data.copy_(p.data) + + d = nhwc_model(nhwc_a) + d.mean().backward() + torch.cuda.synchronize() + + # reset reference to cudnn channels_last permute + #c_s = c.storage().tolist() + #d_s = d.storage().tolist() + #print(max([x-y for x,y in zip(c_s,d_s)])) + c = c.contiguous(memory_format=torch.contiguous_format).permute(0,2,3,1).contiguous() + d_grad = a.grad.float().permute(0,2,3,1).contiguous() + wgrads = [] + for w in model.w_conv: + wgrads.append(w.grad.float().permute(0,2,3,1).contiguous()) + + torch.cuda.synchronize() + print("comparing nhwc and channels_last:") + print("max error fprop:", (d-c).abs().max().item(), "max elem:", c.abs().max().item()) + print("max error dgrad:", (d_grad-nhwc_a.grad.float()).abs().max().item(), "max elem:", d_grad.abs().max().item()) + for i, (w, wgrad) in enumerate(zip(nhwc_model.w_conv, wgrads)): + print("max error wgrad{}:".format(i+1), (wgrad - w.grad.float()).abs().max().item(), "max elem:", wgrad.abs().max().item()) diff --git a/apex/apex/contrib/csrc/bottleneck/bottleneck.cpp b/apex/apex/contrib/csrc/bottleneck/bottleneck.cpp new file mode 100644 index 0000000000000000000000000000000000000000..1bca25b404a1941bb0fc3d9f1b581f0d3f7eefbd --- /dev/null +++ b/apex/apex/contrib/csrc/bottleneck/bottleneck.cpp @@ -0,0 +1,1612 @@ +#include +#include // for getcudnnhandle +#include +#include +#include +#include + +#include + +#ifdef DEBUG +#define DEBUG_MSG(str) do { std::cout << str << std::endl; } while( false ) +#else +#define DEBUG_MSG(str) do { } while ( false ) +#endif + +#ifdef DEBUG_CUDNN +#define DEBUG_CUDNN_MSG(buf, str) do { buf << str << std::endl; } while( false ) +#else +#define DEBUG_CUDNN_MSG(buf, str) do { } while ( false ) +#endif + +#define checkCudnnErr(...) \ + do { \ + int err = checkCudnnError(__VA_ARGS__, #__VA_ARGS__, __FILE__, __LINE__); \ + if (err) { \ + return; \ + } \ + } while (0) + + +int checkCudnnError(cudnnStatus_t code, const char* expr, const char* file, int line) { + if (code) { + printf("CUDNN error at %s:%d, code=%d (%s) in '%s'\n", file, line, (int)code, cudnnGetErrorString(code), expr); + return 1; + } + return 0; +} + +void checkError(cudaError_t code, char const * func, const char *file, const int line, bool abort = true); +#define checkCUDAError(val) { checkError((val), #val, __FILE__, __LINE__); } // in-line regular function + +void checkError(cudaError_t code, char const * func, const char *file, const int line, bool abort) +{ + if (code != cudaSuccess) + { + const char * errorMessage = cudaGetErrorString(code); + fprintf(stderr, "CUDA error returned from \"%s\" at %s:%d, Error code: %d (%s)\n", func, file, line, code, errorMessage); + if (abort){ + cudaDeviceReset(); + exit(code); + } + } +} + +void generateStrides(const int64_t* dimA, int64_t* strideA, int nbDims, cudnnTensorFormat_t filterFormat) { + // For INT8x4 and INT8x32 we still compute standard strides here to input + // into the cuDNN functions. We will manually scale by resizeFactor in the cpu ref. + if (filterFormat == CUDNN_TENSOR_NCHW) { + strideA[nbDims - 1] = 1; + for (int64_t d = nbDims - 2; d >= 0; d--) { + strideA[d] = strideA[d + 1] * dimA[d + 1]; + } + } else { + // Here we assume that the format is CUDNN_TENSOR_NHWC + strideA[1] = 1; + strideA[nbDims - 1] = strideA[1] * dimA[1]; + for (int64_t d = nbDims - 2; d >= 2; d--) { + strideA[d] = strideA[d + 1] * dimA[d + 1]; + } + strideA[0] = strideA[2] * dimA[2]; + } +} + + +int getFwdConvDilatedFilterDim(int filterDim, int dilation) { + return ((filterDim - 1) * dilation) + 1; +} + +int getFwdConvPaddedImageDim(int tensorDim, int pad) { + return tensorDim + (2 * pad); +} + +int getFwdConvOutputDim( + int tensorDim, + int pad, + int filterDim, + int stride, + int dilation) +{ + int p = (getFwdConvPaddedImageDim(tensorDim, pad) - getFwdConvDilatedFilterDim(filterDim, dilation)) / stride + 1; + return (p); +} + +enum { + X_TENSOR, + Y_TENSOR, + W_TENSOR, + Z_TENSOR, + B_TENSOR, + AFTERADD_TENSOR, + AFTERBIAS_TENSOR, + AFTERCONV_TENSOR, + OPTIONAL, + AFTEROPT_TENSOR, +}; + +using common_conv_descriptors = + std::tuple; + + +common_conv_descriptors +create_common_descriptors(int64_t* x_dim_padded, + int64_t* padA, + int64_t* convstrideA, + int64_t* dilationA, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType, + cudnnConvolutionMode_t mode) { + const int convDim = 2; + + int64_t strideA_padded[4]; + int64_t outstrideA_padded[4]; + int64_t filterstrideA_padded[4]; + + generateStrides(w_dim_padded, filterstrideA_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(x_dim_padded, strideA_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(y_dim_padded, outstrideA_padded, 4, CUDNN_TENSOR_NHWC); + + return common_conv_descriptors(cudnn_frontend::TensorBuilder() + .setDim(4, x_dim_padded) + .setStrides(4, strideA_padded) + .setId('x') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, outstrideA_padded) + .setId('y') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, w_dim_padded) + .setStrides(4, filterstrideA_padded) + .setId('w') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::ConvDescBuilder() + .setDataType(CUDNN_DATA_FLOAT) + .setMathMode(mode) + .setNDims(convDim) + .setStrides(convDim, convstrideA) + .setPrePadding(convDim, padA) + .setPostPadding(convDim, padA) + .setDilation(convDim, dilationA) + .build()); +} + +using common_convbias_descriptors = std::tuple; + +common_convbias_descriptors +create_conv_bias_add_act_descriptors(int64_t* x_dim_padded, + int64_t* padA, + int64_t* convstrideA, + int64_t* dilationA, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType) { + const int convDim = 2; + + int64_t b_dim_padded[4]; + b_dim_padded[0] = 1; + b_dim_padded[1] = y_dim_padded[1]; + b_dim_padded[2] = 1; + b_dim_padded[3] = 1; + + int64_t x_stride_padded[4]; + int64_t y_stride_padded[4]; + int64_t w_stride_padded[4]; + int64_t b_stride_padded[4]; + + generateStrides(w_dim_padded, w_stride_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(x_dim_padded, x_stride_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(y_dim_padded, y_stride_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(b_dim_padded, b_stride_padded, 4, CUDNN_TENSOR_NHWC); + + return common_convbias_descriptors(cudnn_frontend::TensorBuilder() + .setDim(4, x_dim_padded) + .setStrides(4, x_stride_padded) + .setId('x') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setId('y') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, w_dim_padded) + .setStrides(4, w_stride_padded) + .setId('w') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, b_dim_padded) + .setStrides(4, b_stride_padded) + .setId('z') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, b_dim_padded) + .setStrides(4, b_stride_padded) + .setId('b') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setVirtual() + .setId('A') // after add + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setVirtual() + .setId('B') // after bias + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setId('C') // after conv + .setAlignment(16) + .setVirtual() + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setId('i') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setId('D') // after optional add + .setAlignment(16) + .setVirtual() + .setDataType(dataType) + .build()); +} + +// tensor descriptors used for dgrad +enum { + X_OR_DX_TENSOR, + DY_TENSOR, + W_OR_DW_TENSOR, + SCALE_TENSOR, + RELU_TENSOR, + AFTER_DCONV_TENSOR, + AFTER_DRELU_TENSOR, +}; + +using dconv_descriptors = std::tuple; + +dconv_descriptors +create_dconv_descriptors(int64_t* x_dim_padded, + int64_t* padA, + int64_t* convstrideA, + int64_t* dilationA, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType) { + const int convDim = 2; + + int64_t b_dim_padded[4]; + b_dim_padded[0] = 1; + b_dim_padded[1] = x_dim_padded[1]; + b_dim_padded[2] = 1; + b_dim_padded[3] = 1; + + int64_t x_stride_padded[4]; + int64_t y_stride_padded[4]; + int64_t w_stride_padded[4]; + int64_t b_stride_padded[4]; + + generateStrides(w_dim_padded, w_stride_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(x_dim_padded, x_stride_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(y_dim_padded, y_stride_padded, 4, CUDNN_TENSOR_NHWC); + generateStrides(b_dim_padded, b_stride_padded, 4, CUDNN_TENSOR_NHWC); + + return dconv_descriptors(cudnn_frontend::TensorBuilder() + .setDim(4, x_dim_padded) + .setStrides(4, x_stride_padded) + .setId('x') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, y_dim_padded) + .setStrides(4, y_stride_padded) + .setId('y') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, w_dim_padded) + .setStrides(4, w_stride_padded) + .setId('w') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, b_dim_padded) + .setStrides(4, b_stride_padded) + .setId('s') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, x_dim_padded) + .setStrides(4, x_stride_padded) + .setId('r') + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, x_dim_padded) + .setStrides(4, x_stride_padded) + .setVirtual() + .setId('A') // after dconv + .setAlignment(16) + .setDataType(dataType) + .build(), + cudnn_frontend::TensorBuilder() + .setDim(4, x_dim_padded) + .setStrides(4, x_stride_padded) + .setVirtual() + .setId('B') // after drelu + .setAlignment(16) + .setDataType(dataType) + .build()); +} + +// create a cache for plan +std::unordered_map plan_cache; + +// TODO: better name +std::string getConvFusionString(int64_t* x_dim_padded, + int64_t* padA, + int64_t* convstrideA, + int64_t* dilationA, + int64_t* w_dim_padded, + cudnnDataType_t dataType, + std::string fusion_string) { + + for(int i=0;i<4;i++) { + fusion_string += 'X'; + fusion_string += std::to_string(x_dim_padded[i]); + } + for(int i=0;i<4;i++) { + fusion_string += 'W'; + fusion_string += std::to_string(w_dim_padded[i]); + } + for(int i=0;i<2;i++) { + fusion_string += 'P'; + fusion_string += std::to_string(padA[i]); + } + for(int i=0;i<2;i++) { + fusion_string += 'S'; + fusion_string += std::to_string(convstrideA[i]); + } + for(int i=0;i<2;i++) { + fusion_string += 'D'; + fusion_string += std::to_string(dilationA[i]); + } + fusion_string += 'T'; + fusion_string += std::to_string(dataType); + return fusion_string; +} + +cudnn_frontend::ExecutionPlan& getOrCreatePlan(cudnnHandle_t handle_, + std::stringstream& log_buf, + cudnn_frontend::OperationGraph& opGraph, + std::string cache_string, + bool use_heuristic = true){ + auto it = plan_cache.find(cache_string); + if (it != plan_cache.end()) { + DEBUG_CUDNN_MSG(log_buf, "Found plan in cache"); + return it->second; + } else { + if (use_heuristic){ + // TODO: confirm which mode to use + auto heuristics = cudnn_frontend::EngineHeuristicsBuilder() + .setOperationGraph(opGraph) + .setHeurMode(CUDNN_HEUR_MODE_INSTANT) + .build(); + // try 3 times for now as WAR for no heuristic training + int max_tries = 3, count = 0; + auto& engine_configs = heuristics.getEngineConfig(max_tries); + while(true) { + try { + plan_cache.emplace(cache_string, std::move(cudnn_frontend::ExecutionPlanBuilder() + .setHandle(handle_) + .setEngineConfig(engine_configs[count], opGraph.getTag()) + .build())); + break; + } catch (cudnn_frontend::cudnnException e) { + if (++count == max_tries) throw e; + } + } + }else{ + DEBUG_CUDNN_MSG(log_buf, "No plan in cache"); + // How many engines support this operation graph ? + auto total_engines = opGraph.getEngineCount(); + DEBUG_CUDNN_MSG(log_buf, opGraph.describe() << " has " << total_engines << " engines."); + // We have to randomly pick one engine from [0, total_engines) + // Selecting "0" by default + auto engine = cudnn_frontend::EngineBuilder().setGlobalEngineIdx(0).setOperationGraph(opGraph).build(); + DEBUG_CUDNN_MSG(log_buf, engine.describe()); + auto& knobs = engine.getSupportedKnobs(); + for (auto it = std::begin(knobs); it != std::end(knobs); ++it) { + DEBUG_CUDNN_MSG(log_buf, it->describe()); + } + if (knobs.begin() != knobs.end()) { + DEBUG_CUDNN_MSG(log_buf, "Updated knob choice"); + knobs.begin()->setChoice(knobs.begin()->getMinValue() + 1); + DEBUG_CUDNN_MSG(log_buf, knobs.begin()->describe()); + } + + // Createmplacee the requisite engine config + auto engine_config = cudnn_frontend::EngineConfigBuilder().setEngine(engine).build(); + DEBUG_CUDNN_MSG(log_buf, engine_config.describe()); + plan_cache.emplace(cache_string, std::move(cudnn_frontend::ExecutionPlanBuilder().setHandle(handle_).setEngineConfig(engine_config).build())); + } + + return plan_cache.find(cache_string)->second; + } +} + +void +run_conv_scale_bias_add_activation(int64_t* x_dim_padded, + int64_t* pad, + int64_t* convstride, + int64_t* dilation, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType, + at::Half* devPtrX, + at::Half* devPtrW, + at::Half* devPtrY, + at::Half* devPtrZ, + at::Half* devPtrB, + at::Half* devPtrI) { + cudnnHandle_t handle_ = torch::native::getCudnnHandle(); + std::stringstream log_buf; + try { + int convDim = 2; + + // Creates the necessary tensor descriptors + common_convbias_descriptors tensors = create_conv_bias_add_act_descriptors( + x_dim_padded, pad, convstride, dilation, w_dim_padded, y_dim_padded, dataType); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + + // Define the add operation + auto scaleDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_MUL) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, scaleDesc.describe()); + + // Define the bias operation + auto biasDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_ADD) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, biasDesc.describe()); + + // optional add + auto addDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_ADD) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, addDesc.describe()); + + // Define the activation operation + auto actDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_RELU_FWD) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, actDesc.describe()); + + // Define the convolution problem + auto convDesc = cudnn_frontend::ConvDescBuilder() + .setDataType(CUDNN_DATA_FLOAT) + .setMathMode(CUDNN_CROSS_CORRELATION) + .setNDims(convDim) + .setStrides(convDim, convstride) + .setPrePadding(convDim, pad) + .setPostPadding(convDim, pad) + .setDilation(convDim, dilation) + .build(); + DEBUG_CUDNN_MSG(log_buf, convDesc.describe()); + + float alpha = 1.0f; + float beta = 0.0f; + + // Create a convolution Node + auto conv_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_CONVOLUTION_FORWARD_DESCRIPTOR) + .setxDesc(std::get(tensors)) + .setwDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setcDesc(convDesc) + .setAlpha(alpha) + .setBeta(beta) + .build(); + DEBUG_CUDNN_MSG(log_buf, conv_op.describe()); + + // Create a Add Node with scaling parameters. + auto scale_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(conv_op.getOutputTensor()) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setpwDesc(scaleDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, scale_op.describe()); + + // Create a Bias Node. + auto bias_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(scale_op.getOutputTensor()) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setpwDesc(biasDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, bias_op.describe()); + + // Create a optional add Node. + auto add_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(bias_op.getOutputTensor()) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setpwDesc(addDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, add_op.describe()); + + + // Create an Activation Node. + auto act_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(devPtrI ? add_op.getOutputTensor() : bias_op.getOutputTensor()) + .setyDesc(std::get(tensors)) + .setpwDesc(actDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, act_op.describe()); + + // Create an Operation Graph. In this case it is convolution add bias activation + std::array ops = {&conv_op, &scale_op, &bias_op, devPtrI ? &add_op : &act_op, &act_op}; + + auto opGraph = cudnn_frontend::OperationGraphBuilder() + .setHandle(handle_) + .setOperationGraph(devPtrI ? ops.size() : 4, ops.data()) + .build(); + + // Create string encoding for plan caching + auto cache_string = getConvFusionString(x_dim_padded, pad, convstride, dilation, w_dim_padded, dataType, opGraph.getTag()); + DEBUG_CUDNN_MSG(log_buf, "[convstring] " << cache_string); + + auto& plan = getOrCreatePlan(handle_, log_buf, opGraph, cache_string); + DEBUG_CUDNN_MSG(log_buf, "Plan tag: " << plan.getTag()); + + auto workspace_size = plan.getWorkspaceSize(); + DEBUG_CUDNN_MSG(log_buf, plan.describe() << " requires workspace " << workspace_size); + + void* workspace_ptr = nullptr; + auto workspace_tensor = at::empty({(workspace_size+3)/4}, at::TensorOptions(at::kCUDA).dtype(at::kFloat)); + if (workspace_size > 0) { + workspace_ptr = workspace_tensor.data_ptr(); + } + void* data_ptrs[] = {devPtrX, devPtrY, devPtrW, devPtrZ, devPtrB, devPtrI}; + int64_t uids[] = {'x', 'y', 'w', 'z', 'b', 'i'}; + auto variantPack = cudnn_frontend::VariantPackBuilder() + .setWorkspacePointer(workspace_ptr) + .setDataPointers(devPtrI ? 6 : 5, data_ptrs) + .setUids(devPtrI ? 6 : 5, uids) + .build(); + DEBUG_CUDNN_MSG(log_buf, "variantPack " << variantPack.describe()); + cudnnStatus_t status = cudnnBackendExecute(handle_, plan.get_raw_desc(), variantPack.get_raw_desc()); + checkCudnnErr(status); + cudnn_frontend::throw_if([status]() { return (status != CUDNN_STATUS_SUCCESS); }, "Plan execute error"); + } catch (cudnn_frontend::cudnnException e) { + std::cout << log_buf.str() << "[ERROR] Exception " << e.what() << std::endl; + } +} + +void +run_conv_scale_bias(int64_t* x_dim_padded, + int64_t* pad, + int64_t* convstride, + int64_t* dilation, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType, + at::Half* devPtrX, + at::Half* devPtrW, + at::Half* devPtrY, + at::Half* devPtrZ, + at::Half* devPtrB) { + cudnnHandle_t handle_ = torch::native::getCudnnHandle(); + std::stringstream log_buf; + try { + int convDim = 2; + + // Creates the necessary tensor descriptors + common_convbias_descriptors tensors = create_conv_bias_add_act_descriptors( + x_dim_padded, pad, convstride, dilation, w_dim_padded, y_dim_padded, dataType); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + + // Define the add operation + auto scaleDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_MUL) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, scaleDesc.describe()); + + // Define the bias operation + auto addDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_ADD) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, addDesc.describe()); + + // Define the convolution problem + auto convDesc = cudnn_frontend::ConvDescBuilder() + .setDataType(CUDNN_DATA_FLOAT) + .setMathMode(CUDNN_CROSS_CORRELATION) + .setNDims(convDim) + .setStrides(convDim, convstride) + .setPrePadding(convDim, pad) + .setPostPadding(convDim, pad) + .setDilation(convDim, dilation) + .build(); + DEBUG_CUDNN_MSG(log_buf, convDesc.describe()); + + float alpha = 1.0f; + float beta = 0.0f; + + // Create a convolution Node + auto conv_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_CONVOLUTION_FORWARD_DESCRIPTOR) + .setxDesc(std::get(tensors)) + .setwDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setcDesc(convDesc) + .setAlpha(alpha) + .setBeta(beta) + .build(); + DEBUG_CUDNN_MSG(log_buf, conv_op.describe()); + + // Create a Add Node with scaling parameters. + auto scale_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(conv_op.getOutputTensor()) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) // TODO: change enum to aftermul + .setpwDesc(scaleDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, scale_op.describe()); + + // Create a Bias Node. + auto add_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(scale_op.getOutputTensor()) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setpwDesc(addDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, add_op.describe()); + + // Create an Operation Graph. In this case it is convolution add bias activation + std::array ops = {&conv_op, &scale_op, &add_op}; + + auto opGraph = cudnn_frontend::OperationGraphBuilder() + .setHandle(handle_) + .setOperationGraph(ops.size(), ops.data()) + .build(); + + // Create string encoding for plan caching + auto cache_string = getConvFusionString(x_dim_padded, pad, convstride, dilation, w_dim_padded, dataType, opGraph.getTag()); + DEBUG_CUDNN_MSG(log_buf, "[convstring] " << cache_string); + + auto& plan = getOrCreatePlan(handle_, log_buf, opGraph, cache_string); + DEBUG_CUDNN_MSG(log_buf, "Plan tag: " << plan.getTag()); + + auto workspace_size = plan.getWorkspaceSize(); + DEBUG_CUDNN_MSG(log_buf, plan.describe() << " requires workspace " << workspace_size); + + void* workspace_ptr = nullptr; + auto workspace_tensor = at::empty({(workspace_size+3)/4}, at::TensorOptions(at::kCUDA).dtype(at::kFloat)); + if (workspace_size > 0) { + workspace_ptr = workspace_tensor.data_ptr(); + } + void* data_ptrs[] = {devPtrX, devPtrY, devPtrW, devPtrZ, devPtrB}; + int64_t uids[] = {'x', 'y', 'w', 'z', 'b'}; + auto variantPack = cudnn_frontend::VariantPackBuilder() + .setWorkspacePointer(workspace_ptr) + .setDataPointers(5, data_ptrs) + .setUids(5, uids) + .build(); + DEBUG_CUDNN_MSG(log_buf, "variantPack " << variantPack.describe()); + cudnnStatus_t status = cudnnBackendExecute(handle_, plan.get_raw_desc(), variantPack.get_raw_desc()); + checkCudnnErr(status); + cudnn_frontend::throw_if([status]() { return (status != CUDNN_STATUS_SUCCESS); }, "Plan execute error"); + } catch (cudnn_frontend::cudnnException e) { + std::cout << log_buf.str() << "[ERROR] Exception " << e.what() << std::endl; + } +} + + +void +run_dconv_drelu_dscale(int64_t* x_dim_padded, + int64_t* pad, + int64_t* convstride, + int64_t* dilation, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType, + at::Half* devPtrX, + at::Half* devPtrW, + at::Half* devPtrY, + at::Half* devPtrZ, + at::Half* devPtrR) { + cudnnHandle_t handle_ = torch::native::getCudnnHandle(); + std::stringstream log_buf; + try { + int convDim = 2; + + // Creates the necessary tensor descriptors + dconv_descriptors tensors = create_dconv_descriptors( + x_dim_padded, pad, convstride, dilation, w_dim_padded, y_dim_padded, dataType); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + + // Define the convolution problem + auto convDesc = cudnn_frontend::ConvDescBuilder() + .setDataType(CUDNN_DATA_FLOAT) + .setMathMode(CUDNN_CROSS_CORRELATION) + .setNDims(convDim) + .setStrides(convDim, convstride) + .setPrePadding(convDim, pad) + .setPostPadding(convDim, pad) + .setDilation(convDim, dilation) + .build(); + DEBUG_CUDNN_MSG(log_buf, convDesc.describe()); + + // Define the activation backward operation + auto actDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_RELU_BWD) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, actDesc.describe()); + + // Define the scale backward operation + auto scaleDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_MUL) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, scaleDesc.describe()); + + float alpha = 1.0f; + float beta = 0.0f; + + // Create a convolution Node + auto conv_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR) + .setdxDesc(std::get(tensors)) + .setwDesc(std::get(tensors)) + .setdyDesc(std::get(tensors)) + .setcDesc(convDesc) + .setAlpha(alpha) + .setBeta(beta) + .build(); + DEBUG_CUDNN_MSG(log_buf, conv_op.describe()); + + // TODO: do we need getOutputTensor(), and what it returns in backward case? + // Create an relu backward Node. + auto act_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setdyDesc(std::get(tensors)) + .setxDesc(std::get(tensors)) + .setdxDesc(std::get(tensors)) + .setpwDesc(actDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, act_op.describe()); + + // Create a Scale Node. + auto scale_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(std::get(tensors)) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setpwDesc(scaleDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, scale_op.describe()); + + // Create an Operation Graph. In this case it is convolution add bias activation + std::array ops = {&conv_op, &act_op, &scale_op}; + + auto opGraph = cudnn_frontend::OperationGraphBuilder() + .setHandle(handle_) + .setOperationGraph(ops.size(), ops.data()) + .build(); + + // Create string encoding for plan caching + auto cache_string = getConvFusionString(x_dim_padded, pad, convstride, dilation, w_dim_padded, dataType, opGraph.getTag()); + DEBUG_CUDNN_MSG(log_buf, "[convstring] " << cache_string); + + auto& plan = getOrCreatePlan(handle_, log_buf, opGraph, cache_string); + DEBUG_CUDNN_MSG(log_buf, "Plan tag: " << plan.getTag()); + + auto workspace_size = plan.getWorkspaceSize(); + DEBUG_CUDNN_MSG(log_buf, plan.describe() << " requires workspace " << workspace_size); + + void* workspace_ptr = nullptr; + auto workspace_tensor = at::empty({(workspace_size+3)/4}, at::TensorOptions(at::kCUDA).dtype(at::kFloat)); + if (workspace_size > 0) { + workspace_ptr = workspace_tensor.data_ptr(); + } + void* data_ptrs[] = {devPtrX, devPtrY, devPtrW, devPtrZ, devPtrR}; + int64_t uids[] = {'x', 'y', 'w', 's', 'r'}; + auto variantPack = cudnn_frontend::VariantPackBuilder() + .setWorkspacePointer(workspace_ptr) + .setDataPointers(5, data_ptrs) + .setUids(5, uids) + .build(); + DEBUG_CUDNN_MSG(log_buf, "variantPack " << variantPack.describe()); + cudnnStatus_t status = cudnnBackendExecute(handle_, plan.get_raw_desc(), variantPack.get_raw_desc()); + checkCudnnErr(status); + cudnn_frontend::throw_if([status]() { return (status != CUDNN_STATUS_SUCCESS); }, "Plan execute error"); + } catch (cudnn_frontend::cudnnException e) { + std::cout << log_buf.str() << "[ERROR] Exception " << e.what() << std::endl; + } +} + +void +run_dconv(int64_t* x_dim_padded, + int64_t* pad, + int64_t* convstride, + int64_t* dilation, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType, + at::Half* devPtrX, + at::Half* devPtrW, + at::Half* devPtrY, + cudnnBackendDescriptorType_t mode) { + cudnnHandle_t handle_ = torch::native::getCudnnHandle(); + std::stringstream log_buf; + try { + int convDim = 2; + + // Creates the necessary tensor descriptors + dconv_descriptors tensors = create_dconv_descriptors( + x_dim_padded, pad, convstride, dilation, w_dim_padded, y_dim_padded, dataType); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + + // Define the convolution problem + auto convDesc = cudnn_frontend::ConvDescBuilder() + .setDataType(CUDNN_DATA_FLOAT) + .setMathMode(CUDNN_CROSS_CORRELATION) + .setNDims(convDim) + .setStrides(convDim, convstride) + .setPrePadding(convDim, pad) + .setPostPadding(convDim, pad) + .setDilation(convDim, dilation) + .build(); + DEBUG_CUDNN_MSG(log_buf, convDesc.describe()); + + float alpha = 1.0f; + float beta = 0.0f; + + // Create a convolution Node + // mode should be one of following + // CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR + // CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_FILTER_DESCRIPTOR + auto conv_op_builder = cudnn_frontend::OperationBuilder(mode); + if (mode == CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR) { + conv_op_builder.setdxDesc(std::get(tensors)) + .setwDesc(std::get(tensors)) + .setdyDesc(std::get(tensors)) + .setcDesc(convDesc) + .setAlpha(alpha) + .setBeta(beta); + } + else { + conv_op_builder.setxDesc(std::get(tensors)) + .setdwDesc(std::get(tensors)) + .setdyDesc(std::get(tensors)) + .setcDesc(convDesc) + .setAlpha(alpha) + .setBeta(beta); + } + auto conv_op = conv_op_builder.build(); + DEBUG_CUDNN_MSG(log_buf, conv_op.describe()); + + // Create an Operation Graph. In this case it is convolution add bias activation + std::array ops = {&conv_op}; + + auto opGraph = cudnn_frontend::OperationGraphBuilder() + .setHandle(handle_) + .setOperationGraph(ops.size(), ops.data()) + .build(); + + // Create string encoding for plan caching + auto cache_string = getConvFusionString(x_dim_padded, pad, convstride, dilation, w_dim_padded, dataType, opGraph.getTag()); + DEBUG_CUDNN_MSG(log_buf, "[convstring] " << cache_string); + + auto& plan = getOrCreatePlan(handle_, log_buf, opGraph, cache_string); + DEBUG_CUDNN_MSG(log_buf, "Plan tag: " << plan.getTag()); + + auto workspace_size = plan.getWorkspaceSize(); + DEBUG_CUDNN_MSG(log_buf, plan.describe() << " requires workspace " << workspace_size); + + void* workspace_ptr = nullptr; + auto workspace_tensor = at::empty({(workspace_size+3)/4}, at::TensorOptions(at::kCUDA).dtype(at::kFloat)); + if (workspace_size > 0) { + workspace_ptr = workspace_tensor.data_ptr(); + } + void* data_ptrs[] = {devPtrX, devPtrY, devPtrW}; + int64_t uids[] = {'x', 'y', 'w'}; + auto variantPack = cudnn_frontend::VariantPackBuilder() + .setWorkspacePointer(workspace_ptr) + .setDataPointers(3, data_ptrs) + .setUids(3, uids) + .build(); + DEBUG_CUDNN_MSG(log_buf, "variantPack " << variantPack.describe()); + cudnnStatus_t status = cudnnBackendExecute(handle_, plan.get_raw_desc(), variantPack.get_raw_desc()); + checkCudnnErr(status); + cudnn_frontend::throw_if([status]() { return (status != CUDNN_STATUS_SUCCESS); }, "Plan execute error"); + } catch (cudnn_frontend::cudnnException e) { + std::cout << log_buf.str() << "[ERROR] Exception " << e.what() << std::endl; + } +} + +void +run_dconv_add(int64_t* x_dim_padded, + int64_t* pad, + int64_t* convstride, + int64_t* dilation, + int64_t* w_dim_padded, + int64_t* y_dim_padded, + cudnnDataType_t dataType, + at::Half* devPtrX, + at::Half* devPtrW, + at::Half* devPtrY, + at::Half* devPtrR) { + cudnnHandle_t handle_ = torch::native::getCudnnHandle(); + std::stringstream log_buf; + try { + int convDim = 2; + + // Creates the necessary tensor descriptors + dconv_descriptors tensors = create_dconv_descriptors( + x_dim_padded, pad, convstride, dilation, w_dim_padded, y_dim_padded, dataType); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + DEBUG_CUDNN_MSG(log_buf, std::get(tensors).describe()); + + // Define the convolution problem + auto convDesc = cudnn_frontend::ConvDescBuilder() + .setDataType(CUDNN_DATA_FLOAT) + .setMathMode(CUDNN_CROSS_CORRELATION) + .setNDims(convDim) + .setStrides(convDim, convstride) + .setPrePadding(convDim, pad) + .setPostPadding(convDim, pad) + .setDilation(convDim, dilation) + .build(); + DEBUG_CUDNN_MSG(log_buf, convDesc.describe()); + + // Define the add backward operation + auto addDesc = cudnn_frontend::PointWiseDescBuilder() + .setMode(CUDNN_POINTWISE_ADD) + .setMathPrecision(CUDNN_DATA_FLOAT) + .build(); + DEBUG_CUDNN_MSG(log_buf, addDesc.describe()); + + float alpha = 1.0f; + float beta = 0.0f; + + // Create a convolution Node + auto conv_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR) + .setdxDesc(std::get(tensors)) + .setwDesc(std::get(tensors)) + .setdyDesc(std::get(tensors)) + .setcDesc(convDesc) + .setAlpha(alpha) + .setBeta(beta) + .build(); + DEBUG_CUDNN_MSG(log_buf, conv_op.describe()); + + // TODO: do we need getOutputTensor(), and what it returns in backward case? + // Create add Node. + auto add_op = cudnn_frontend::OperationBuilder(CUDNN_BACKEND_OPERATION_POINTWISE_DESCRIPTOR) + .setxDesc(std::get(tensors)) + .setbDesc(std::get(tensors)) + .setyDesc(std::get(tensors)) + .setpwDesc(addDesc) + .build(); + DEBUG_CUDNN_MSG(log_buf, add_op.describe()); + + // Create an Operation Graph. In this case it is convolution add bias activation + std::array ops = {&conv_op, &add_op}; + + auto opGraph = cudnn_frontend::OperationGraphBuilder() + .setHandle(handle_) + .setOperationGraph(ops.size(), ops.data()) + .build(); + + // Create string encoding for plan caching + auto cache_string = getConvFusionString(x_dim_padded, pad, convstride, dilation, w_dim_padded, dataType, opGraph.getTag()); + DEBUG_CUDNN_MSG(log_buf, "[convstring] " << cache_string); + + auto& plan = getOrCreatePlan(handle_, log_buf, opGraph, cache_string); + DEBUG_CUDNN_MSG(log_buf, "Plan tag: " << plan.getTag()); + + auto workspace_size = plan.getWorkspaceSize(); + DEBUG_CUDNN_MSG(log_buf, plan.describe() << " requires workspace " << workspace_size); + + void* workspace_ptr = nullptr; + auto workspace_tensor = at::empty({(workspace_size+3)/4}, at::TensorOptions(at::kCUDA).dtype(at::kFloat)); + if (workspace_size > 0) { + workspace_ptr = workspace_tensor.data_ptr(); + } + void* data_ptrs[] = {devPtrX, devPtrY, devPtrW, devPtrR}; + int64_t uids[] = {'x', 'y', 'w', 'r'}; + auto variantPack = cudnn_frontend::VariantPackBuilder() + .setWorkspacePointer(workspace_ptr) + .setDataPointers(4, data_ptrs) + .setUids(4, uids) + .build(); + DEBUG_CUDNN_MSG(log_buf, "variantPack " << variantPack.describe()); + cudnnStatus_t status = cudnnBackendExecute(handle_, plan.get_raw_desc(), variantPack.get_raw_desc()); + checkCudnnErr(status); + cudnn_frontend::throw_if([status]() { return (status != CUDNN_STATUS_SUCCESS); }, "Plan execute error"); + } catch (cudnn_frontend::cudnnException e) { + std::cout << log_buf.str() << "[ERROR] Exception " << e.what() << std::endl; + } +} + + +// inputs contains x,w,z,b,(i) +std::vector bottleneck_forward(bool explicit_nhwc, int stride_1X1, std::vector inputs) { + + std::cout << std::fixed; + // create output vector + std::vector outputs; + auto output_format = explicit_nhwc ? at::MemoryFormat::Contiguous : at::MemoryFormat::ChannelsLast; + + // setup dimensions + int64_t dimA[] = {0, 0, 0, 0}; + int64_t filterdimA1[] = {0, 0, 0, 0}; + int64_t filterdimA2[] = {0, 0, 0, 0}; + int64_t filterdimA3[] = {0, 0, 0, 0}; + int64_t filterdimA4[] = {0, 0, 0, 0}; + + // All dim calculation after this order of n,c,h,w + int axis[] {0,1,2,3}; + if (explicit_nhwc) { + axis[0] = 0; + axis[1] = 3; + axis[2] = 1; + axis[3] = 2; + } + for (int dim=0;dim<4;dim++) { + dimA[dim] = inputs[0].size(axis[dim]); + filterdimA1[dim] = inputs[1].size(axis[dim]); + filterdimA2[dim] = inputs[2].size(axis[dim]); + filterdimA3[dim] = inputs[3].size(axis[dim]); + } + if (stride_1X1 != 1 || filterdimA3[0] != dimA[1]) { + for (int dim=0;dim<4;dim++) { + filterdimA4[dim] = inputs[10].size(axis[dim]); + } + } + + // output dim in n,c,h,w used by backend + int64_t outdimA1[] = {0, 0, 0, 0}; // Computed Below + int64_t outdimA2[] = {0, 0, 0, 0}; // Computed Below + int64_t outdimA3[] = {0, 0, 0, 0}; // Computed Below + + // use these fixed value for test run + int64_t padA[] = {0, 0}; + int64_t padA1[] = {1, 1}; + int64_t dilationA[] = {1, 1}; + int64_t convstrideA[] = {1, 1}; + int64_t convstride1X1[] = {stride_1X1, stride_1X1}; + + // compute output from pad/stride/dilation + outdimA1[0] = dimA[0]; + outdimA1[1] = filterdimA1[0]; + for (int dim = 0; dim < 2; dim++) { + outdimA1[dim + 2] = getFwdConvOutputDim(dimA[dim + 2], padA[dim], filterdimA1[dim + 2], convstride1X1[dim], dilationA[dim]); + } + + outdimA2[0] = outdimA1[0]; + outdimA2[1] = filterdimA2[0]; + for (int dim = 0; dim < 2; dim++) { + outdimA2[dim + 2] = getFwdConvOutputDim(outdimA1[dim + 2], padA1[dim], filterdimA2[dim + 2], convstrideA[dim], dilationA[dim]); + } + + outdimA3[0] = outdimA2[0]; + outdimA3[1] = filterdimA3[0]; + for (int dim = 0; dim < 2; dim++) { + outdimA3[dim + 2] = getFwdConvOutputDim(outdimA2[dim + 2], padA[dim], filterdimA3[dim + 2], convstrideA[dim], dilationA[dim]); + } + + // Create output tensor in the correct shape in pytorch's view + int64_t outdim1[] = {0, 0, 0, 0}; + int64_t outdim2[] = {0, 0, 0, 0}; + int64_t outdim3[] = {0, 0, 0, 0}; + if (explicit_nhwc) { + axis[0] = 0; + axis[1] = 2; + axis[2] = 3; + axis[3] = 1; + } + for (int dim=0;dim<4;dim++) { + outdim1[dim] = outdimA1[axis[dim]]; + outdim2[dim] = outdimA2[axis[dim]]; + outdim3[dim] = outdimA3[axis[dim]]; + } + + // run + at::Half* x = inputs[0].data_ptr(); + at::Half* w = inputs[1].data_ptr(); + at::Half* z = inputs[4].data_ptr(); + at::Half* b = inputs[7].data_ptr(); + auto out1 = at::empty(outdim1, inputs[0].type(), output_format); + at::Half* y1 = out1.data_ptr(); + + run_conv_scale_bias_add_activation(dimA, + padA, + convstride1X1, + dilationA, + filterdimA1, + outdimA1, + CUDNN_DATA_HALF, + x, + w, + y1, + z, + b, + nullptr); + + DEBUG_MSG("[DEBUG] new relu1 : " << out1.to(at::kFloat).sum().item()); + + w = inputs[2].data_ptr(); + z = inputs[5].data_ptr(); + b = inputs[8].data_ptr(); + auto out2 = at::empty(outdim2, inputs[0].type(), output_format); + at::Half* y2 = out2.data_ptr(); + + run_conv_scale_bias_add_activation(outdimA1, + padA1, + convstrideA, + dilationA, + filterdimA2, + outdimA2, + CUDNN_DATA_HALF, + y1, + w, + y2, + z, + b, + nullptr); + DEBUG_MSG("[DEBUG] new relu2 : " << out2.to(at::kFloat).sum().item()); + + // create output of conv3 + auto out3 = at::empty(outdim3, inputs[0].type(), output_format); + at::Half* y3 = out3.data_ptr(); + + // create output of conv4 that may exist + auto identity = at::empty_like(out3); + at::Half* yi = identity.data_ptr(); + + if (stride_1X1 != 1 || filterdimA3[0] != dimA[1]){ + + w = inputs[10].data_ptr(); + z = inputs[11].data_ptr(); + b = inputs[12].data_ptr(); + run_conv_scale_bias(dimA, + padA, + convstride1X1, + dilationA, + filterdimA4, + outdimA3, + CUDNN_DATA_HALF, + x, + w, + yi, + z, + b); + DEBUG_MSG("[DEBUG] new downsample : " << identity.to(at::kFloat).sum().item()); + } + else { + yi = x; + } + + w = inputs[3].data_ptr(); + z = inputs[6].data_ptr(); + b = inputs[9].data_ptr(); + + run_conv_scale_bias_add_activation(outdimA2, + padA, + convstrideA, + dilationA, + filterdimA3, + outdimA3, + CUDNN_DATA_HALF, + y2, + w, + y3, + z, + b, + yi); + DEBUG_MSG("[DEBUG] new relu3 : " << out3.to(at::kFloat).sum().item()); + + outputs.push_back(out1); + outputs.push_back(out2); + outputs.push_back(out3); + + return outputs; +} + +std::vector bottleneck_backward(bool explicit_nhwc, int stride_1X1, std::vector inputs) { + + bool requires_grad = inputs[0].requires_grad(); + + std::cout << std::fixed; + // create output vector + std::vector outputs; + auto output_format = explicit_nhwc ? at::MemoryFormat::Contiguous : at::MemoryFormat::ChannelsLast; + + // setup dimensions + int64_t dimA[] = {0, 0, 0, 0}; + int64_t filterdimA1[] = {0, 0, 0, 0}; + int64_t filterdimA2[] = {0, 0, 0, 0}; + int64_t filterdimA3[] = {0, 0, 0, 0}; + int64_t filterdimA4[] = {0, 0, 0, 0}; + + // All dim calculation after this order of n,c,h,w + int axis[] {0,1,2,3}; + if (explicit_nhwc) { + axis[0] = 0; + axis[1] = 3; + axis[2] = 1; + axis[3] = 2; + } + for (int dim=0;dim<4;dim++) { + dimA[dim] = inputs[0].size(axis[dim]); + filterdimA1[dim] = inputs[1].size(axis[dim]); + filterdimA2[dim] = inputs[2].size(axis[dim]); + filterdimA3[dim] = inputs[3].size(axis[dim]); + } + if (stride_1X1 != 1 || filterdimA3[0] != dimA[1]) { + for (int dim=0;dim<4;dim++) { + filterdimA4[dim] = inputs[14].size(axis[dim]); + } + } + + // output dim in n,c,h,w used by backend + int64_t outdimA1[] = {0, 0, 0, 0}; // Computed Below + int64_t outdimA2[] = {0, 0, 0, 0}; // Computed Below + int64_t outdimA3[] = {0, 0, 0, 0}; // Computed Below + + // use these fixed value for test run + int64_t padA[] = {0, 0}; + int64_t padA1[] = {1, 1}; + int64_t dilationA[] = {1, 1}; + int64_t convstrideA[] = {1, 1}; + int64_t convstride1X1[] = {stride_1X1, stride_1X1}; + + // compute output from pad/stride/dilation + outdimA1[0] = dimA[0]; + outdimA1[1] = filterdimA1[0]; + for (int dim = 0; dim < 2; dim++) { + outdimA1[dim + 2] = getFwdConvOutputDim(dimA[dim + 2], padA[dim], filterdimA1[dim + 2], convstride1X1[dim], dilationA[dim]); + } + + outdimA2[0] = outdimA1[0]; + outdimA2[1] = filterdimA2[0]; + for (int dim = 0; dim < 2; dim++) { + outdimA2[dim + 2] = getFwdConvOutputDim(outdimA1[dim + 2], padA1[dim], filterdimA2[dim + 2], convstrideA[dim], dilationA[dim]); + } + + outdimA3[0] = outdimA2[0]; + outdimA3[1] = filterdimA3[0]; + for (int dim = 0; dim < 2; dim++) { + outdimA3[dim + 2] = getFwdConvOutputDim(outdimA2[dim + 2], padA[dim], filterdimA3[dim + 2], convstrideA[dim], dilationA[dim]); + } + + // Create output tensor in the correct shape in pytorch's view + int64_t outdim1[] = {0, 0, 0, 0}; + int64_t outdim2[] = {0, 0, 0, 0}; + int64_t outdim3[] = {0, 0, 0, 0}; + if (explicit_nhwc) { + axis[0] = 0; + axis[1] = 2; + axis[2] = 3; + axis[3] = 1; + } + for (int dim=0;dim<4;dim++) { + outdim1[dim] = outdimA1[axis[dim]]; + outdim2[dim] = outdimA2[axis[dim]]; + outdim3[dim] = outdimA3[axis[dim]]; + } + + // dconv3+drelu2+dscale2 + at::Half* conv_in = inputs[13].data_ptr(); + at::Half* dy3 = inputs[10].data_ptr(); + + DEBUG_MSG("[DEBUG] new dconv3 : " << inputs[10].to(at::kFloat).sum().item()); + + // wgrad + auto wgrad3 = at::empty_like(inputs[3]); + at::Half* dw3 = wgrad3.data_ptr(); + run_dconv(outdimA2, + padA, + convstrideA, + dilationA, + filterdimA3, + outdimA3, + CUDNN_DATA_HALF, + conv_in, + dw3, + dy3, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_FILTER_DESCRIPTOR); + + // dgrad + auto grad_out2 = at::empty(outdim2, inputs[0].type(), output_format); + at::Half* dy2 = grad_out2.data_ptr(); + at::Half* w = inputs[3].data_ptr(); + at::Half* z = inputs[5].data_ptr(); + + at::Half* relu2 = inputs[13].data_ptr(); + + run_dconv_drelu_dscale(outdimA2, + padA, + convstrideA, + dilationA, + filterdimA3, + outdimA3, + CUDNN_DATA_HALF, + dy2, + w, + dy3, + z, + relu2); + + DEBUG_MSG("[DEBUG] new dconv2 : " << grad_out2.to(at::kFloat).sum().item()); + + // dconv2+drelu1+dscale1 + conv_in = inputs[12].data_ptr(); + + // wgrad + auto wgrad2 = at::empty_like(inputs[2]); + at::Half* dw2 = wgrad2.data_ptr(); + run_dconv(outdimA1, + padA1, + convstrideA, + dilationA, + filterdimA2, + outdimA2, + CUDNN_DATA_HALF, + conv_in, + dw2, + dy2, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_FILTER_DESCRIPTOR); + + // dgrad + auto grad_out1 = at::empty(outdim1, inputs[0].type(), output_format); + at::Half* dy1 = grad_out1.data_ptr(); + w = inputs[2].data_ptr(); + z = inputs[4].data_ptr(); + + at::Half* relu1 = inputs[12].data_ptr(); + // fused dgrad + run_dconv_drelu_dscale(outdimA1, + padA1, + convstrideA, + dilationA, + filterdimA2, + outdimA2, + CUDNN_DATA_HALF, + dy1, + w, + dy2, + z, + relu1); + +/* + // backward strided conv cannot be fused + // if stride == 1 but channel changes, we can fuse here + if (stride_1X1 != 1){ + // dgrad + run_dconv(outdimA1, + padA1, + convstride1X1, + dilationA, + filterdimA2, + outdimA2, + CUDNN_DATA_HALF, + dy1, + w, + dy2, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR); + + // mul fused mask + grad_out1.mul_(inputs[15]); + } + else { + at::Half* relu1 = inputs[12].data_ptr(); + // fused dgrad + run_dconv_drelu_dscale(outdimA1, + padA1, + convstride1X1, + dilationA, + filterdimA2, + outdimA2, + CUDNN_DATA_HALF, + dy1, + w, + dy2, + z, + relu1); + } +*/ + DEBUG_MSG("[DEBUG] new dconv1 : " << grad_out1.to(at::kFloat).sum().item()); + + // create grads of conv4 that may exist + auto grad_x_conv4 = at::empty_like(inputs[0]); + at::Half* dx_conv4 = grad_x_conv4.data_ptr(); + at::Tensor wgrad4; + + // x used for dconv1 and dconv4 wgrad + at::Half* x = inputs[0].data_ptr(); + + if (stride_1X1 != 1 || filterdimA3[0] != dimA[1]){ + w = inputs[14].data_ptr(); + at::Half* dy_conv4 = inputs[11].data_ptr(); + if (requires_grad) { + run_dconv(dimA, + padA, + convstride1X1, + dilationA, + filterdimA4, + outdimA3, + CUDNN_DATA_HALF, + dx_conv4, + w, + dy_conv4, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR); + // we don't print here since we can't hook out this grad in pytorch alone to compare, due to addition with dx + // DEBUG_MSG("[DEBUG] new dx_identity : " << grad_x_conv4.to(at::kFloat).sum().item()); + } + // wgrad + wgrad4 = at::empty_like(inputs[14]); + at::Half* dw4 = wgrad4.data_ptr(); + run_dconv(dimA, + padA, + convstride1X1, + dilationA, + filterdimA4, + outdimA3, + CUDNN_DATA_HALF, + x, + dw4, + dy_conv4, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_FILTER_DESCRIPTOR); + } + else { + // if there is no downsample, dx_conv4 is fork of drelu3 + dx_conv4 = inputs[11].data_ptr(); + } + + // dconv1+add + // wgrad + auto wgrad1 = at::empty_like(inputs[1]); + at::Half* dw1 = wgrad1.data_ptr(); + run_dconv(dimA, + padA, + convstride1X1, + dilationA, + filterdimA1, + outdimA1, + CUDNN_DATA_HALF, + x, + dw1, + dy1, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_FILTER_DESCRIPTOR); + + // dgrad + w = inputs[1].data_ptr(); + auto grad_x = at::empty_like(inputs[0]); + at::Half* dx = grad_x.data_ptr(); + + // backward strided conv cannot be fused + // if stride == 1 but channel changes, we can fuse here + if (requires_grad){ + if (stride_1X1 != 1){ + run_dconv(dimA, + padA, + convstride1X1, + dilationA, + filterdimA1, + outdimA1, + CUDNN_DATA_HALF, + dx, + w, + dy1, + CUDNN_BACKEND_OPERATION_CONVOLUTION_BACKWARD_DATA_DESCRIPTOR); + // add 2 together + grad_x.add_(grad_x_conv4); + } + else { + run_dconv_add(dimA, + padA, + convstride1X1, + dilationA, + filterdimA1, + outdimA1, + CUDNN_DATA_HALF, + dx, + w, + dy1, + dx_conv4); + } + } + + DEBUG_MSG("[DEBUG] new dx : " << grad_x.to(at::kFloat).sum().item()); + DEBUG_MSG("[DEBUG] new wgrad1 : " << wgrad1.to(at::kFloat).sum().item()); + DEBUG_MSG("[DEBUG] new wgrad2 : " << wgrad2.to(at::kFloat).sum().item()); + DEBUG_MSG("[DEBUG] new wgrad3 : " << wgrad3.to(at::kFloat).sum().item()); + outputs.push_back(grad_x); + outputs.push_back(wgrad1); + outputs.push_back(wgrad2); + outputs.push_back(wgrad3); + + if (stride_1X1 != 1 || filterdimA3[0] != dimA[1]) { + DEBUG_MSG("[DEBUG] new wgrad4 : " << wgrad4.to(at::kFloat).sum().item()); + outputs.push_back(wgrad4); + } + + return outputs; +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &bottleneck_forward, "Bottleneck block forward"); + m.def("backward", &bottleneck_backward, "Bottleneck block backward"); +} diff --git a/apex/apex/contrib/csrc/fmha/fmha_api.cpp b/apex/apex/contrib/csrc/fmha/fmha_api.cpp new file mode 100644 index 0000000000000000000000000000000000000000..e3e25e8b8e3f26c264dd99ae37e8fb6f752f75e9 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/fmha_api.cpp @@ -0,0 +1,305 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include +#include + +#include "fmha.h" + +void run_fmha_fp16_128_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + bool is_training, + cudaStream_t stream); +void run_fmha_fp16_256_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + bool is_training, + cudaStream_t stream); +void run_fmha_fp16_384_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + bool is_training, + cudaStream_t stream); +void run_fmha_fp16_512_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + bool is_training, + cudaStream_t stream); + +void run_fmha_dgrad_fp16_128_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + cudaStream_t stream); +void run_fmha_dgrad_fp16_256_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + cudaStream_t stream); +void run_fmha_dgrad_fp16_384_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + cudaStream_t stream); +void run_fmha_dgrad_fp16_512_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, + cudaStream_t stream); + +void set_params(Fused_multihead_attention_fprop_params ¶ms, + // sizes + const size_t b, + const size_t s, + const size_t h, + const size_t d, + // device pointers + void *qkv_packed_d, + void *cu_seqlens_d, + void *seqlens_d, + void *o_packed_d, + void *s_d, + float p_dropout) { + + Data_type acc_type = DATA_TYPE_FP32; + Data_type data_type = DATA_TYPE_FP16; + + // Reset the parameters + memset(¶ms, 0, sizeof(params)); + + // Set the pointers and strides. + params.qkv_ptr = qkv_packed_d; + params.qkv_stride_in_bytes = get_size_in_bytes(h * 3 * d, data_type); + params.o_ptr = o_packed_d; + params.o_stride_in_bytes = get_size_in_bytes(h * d, data_type); + + params.cu_seqlens = static_cast(cu_seqlens_d); + params.seqlens = static_cast(seqlens_d); + + // S = softmax(P) + params.s_ptr = s_d; + params.s_stride_in_bytes = get_size_in_bytes(b * h * s, data_type); + + // Set the dimensions. + params.b = b; + params.h = h; + params.s = s; + params.d = d; + + // Set the different scale values. + const float scale_bmm1 = 1.f / sqrtf(d); + constexpr float scale_softmax = 1.f; + constexpr float scale_bmm2 = 1.f; + + set_alpha(params.scale_bmm1, scale_bmm1, acc_type); + set_alpha(params.scale_softmax, scale_softmax, acc_type); + set_alpha(params.scale_bmm2, scale_bmm2, data_type); + + // Set this to probability of keeping an element to simplify things. + params.p_dropout = 1.f - p_dropout; + params.rp_dropout = 1.f / params.p_dropout; + TORCH_CHECK(p_dropout < 1.f); + set_alpha(params.scale_dropout, params.rp_dropout, data_type); +} + +constexpr uint32_t NUM_HEADS_DIM = 2; +constexpr uint32_t THREE_DIM = 1; + +std::vector +mha_fwd(const at::Tensor &qkv, // total x num_heads x 3 x head_size, total := \sum_{i=0}^{b} s_i + const at::Tensor &cu_seqlens, // b+1 + const at::Tensor &seqlens, // b + const float p_dropout, + const int max_seq_len, + const bool is_training, + c10::optional gen_) { + auto dprops = at::cuda::getCurrentDeviceProperties(); + TORCH_CHECK(dprops->major == 8 && dprops->minor == 0); + int seq_len = 512; + auto launch = &run_fmha_fp16_512_64_sm80; + if( max_seq_len <= 128 ) { + seq_len = 128; + launch = &run_fmha_fp16_128_64_sm80; + } else if( max_seq_len <= 256 ) { + seq_len = 256; + launch = &run_fmha_fp16_256_64_sm80; + } else if( max_seq_len <= 384 ) { + seq_len = 384; + launch = &run_fmha_fp16_384_64_sm80; + } else if( max_seq_len <= 512 ) { + seq_len = 512; + launch = &run_fmha_fp16_512_64_sm80; + } else { + TORCH_CHECK(false); + } + + constexpr int warps_m = 1; + constexpr int warps_n = 4; // this leads to an upper bound + const int mmas_m = seq_len / 16 / warps_m; + const int mmas_n = seq_len / 16 / warps_n; + + const int elts_per_thread = 8 * mmas_m * mmas_n; + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + + TORCH_CHECK(qkv.dtype() == torch::kFloat16); + TORCH_CHECK(cu_seqlens.dtype() == torch::kInt32); + TORCH_CHECK(seqlens.dtype() == torch::kInt32); + + TORCH_CHECK(qkv.is_cuda()) + TORCH_CHECK(cu_seqlens.is_cuda()) + + TORCH_CHECK(qkv.is_contiguous()) + TORCH_CHECK(cu_seqlens.is_contiguous()) + TORCH_CHECK(seqlens.is_contiguous()) + + TORCH_CHECK(cu_seqlens.dim() == 1); + TORCH_CHECK(seqlens.dim() == 1); + TORCH_CHECK(qkv.dim() == 4); + + const auto sizes = qkv.sizes(); + + TORCH_CHECK(sizes[THREE_DIM] == 3); + + const int batch_size = cu_seqlens.numel() - 1; + TORCH_CHECK(seqlens.numel() == batch_size); + const int total = sizes[0]; + const int num_heads = sizes[NUM_HEADS_DIM]; + const int head_size = sizes[3]; + TORCH_CHECK(batch_size > 0); + TORCH_CHECK(head_size == 64); + auto opts = qkv.options(); + + auto ctx = torch::empty({ total, num_heads, head_size }, opts); + + auto s = torch::empty({ batch_size, num_heads, seq_len, seq_len }, opts); + + auto gen = at::get_generator_or_default( + gen_, at::cuda::detail::getDefaultCUDAGenerator()); + + Fused_multihead_attention_fprop_params params; + + set_params(params, + batch_size, + seq_len, + num_heads, + head_size, + qkv.data_ptr(), + cu_seqlens.data_ptr(), + seqlens.data_ptr(), + ctx.data_ptr(), + s.data_ptr(), + p_dropout); + + // number of times random will be generated per thread, to offset philox counter in thc random + // state + int64_t counter_offset = elts_per_thread; + at::PhiloxCudaState rng_engine_inputs; + + if( is_training ) { + // See Note [Acquire lock when using random generators] + std::lock_guard lock(gen->mutex_); + params.philox_args = gen->philox_cuda_state(counter_offset); + } + + launch(params, is_training, stream); + + return { ctx, s }; +} + +std::vector +mha_bwd(const at::Tensor &dout, // total x num_heads, x head_size + const at::Tensor &qkv, // total x num_heads x 3 x head_size, total := \sum_{i=0}^{b} s_i + at::Tensor &softmax, // b x h x s x s softmax and dmask - will be overwritten with dP + const at::Tensor &cu_seqlens, // b+1 + const at::Tensor &seqlens, // b + const float p_dropout, // probability to drop + const int max_seq_len // max sequence length to choose the kernel +) { + auto dprops = at::cuda::getCurrentDeviceProperties(); + TORCH_CHECK(dprops->major == 8 && dprops->minor == 0); + int seq_len = 512; + auto launch = &run_fmha_dgrad_fp16_512_64_sm80; + if( max_seq_len <= 128 ) { + seq_len = 128; + launch = &run_fmha_dgrad_fp16_128_64_sm80; + } else if( max_seq_len <= 256 ) { + seq_len = 256; + launch = &run_fmha_dgrad_fp16_256_64_sm80; + } else if( max_seq_len <= 384 ) { + seq_len = 384; + launch = &run_fmha_dgrad_fp16_384_64_sm80; + } else if( max_seq_len <= 512 ) { + seq_len = 512; + launch = &run_fmha_dgrad_fp16_512_64_sm80; + } else { + TORCH_CHECK(false); + } + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + + TORCH_CHECK(qkv.dtype() == torch::kFloat16); + TORCH_CHECK(dout.dtype() == torch::kFloat16); + TORCH_CHECK(softmax.dtype() == torch::kFloat16); + TORCH_CHECK(cu_seqlens.dtype() == torch::kInt32); + TORCH_CHECK(seqlens.dtype() == torch::kInt32); + + TORCH_CHECK(qkv.is_cuda()); + TORCH_CHECK(cu_seqlens.is_cuda()); + + TORCH_CHECK(qkv.is_contiguous()); + TORCH_CHECK(cu_seqlens.is_contiguous()); + TORCH_CHECK(seqlens.is_contiguous()); + + TORCH_CHECK(cu_seqlens.dim() == 1); + TORCH_CHECK(seqlens.dim() == 1); + TORCH_CHECK(qkv.dim() == 4); + + const auto sizes = qkv.sizes(); + + TORCH_CHECK(sizes[THREE_DIM] == 3); + + const int batch_size = cu_seqlens.numel() - 1; + TORCH_CHECK(seqlens.numel() == batch_size); + const int num_heads = sizes[NUM_HEADS_DIM]; + const int head_size = sizes[3]; + TORCH_CHECK(batch_size > 0); + TORCH_CHECK(head_size == 64); + + auto dqkv = torch::empty_like(qkv); + + Fused_multihead_attention_fprop_params params; + + set_params(params, + batch_size, + seq_len, + num_heads, + head_size, + qkv.data_ptr(), + cu_seqlens.data_ptr(), + seqlens.data_ptr(), + dout.data_ptr(), // we set o_ptr to dout + softmax.data_ptr(), // softmax gets overwritten by dP! + p_dropout); + + // we're re-using these scales scales + Data_type acc_type = DATA_TYPE_FP32; + set_alpha(params.scale_bmm1, 1.f, acc_type); + set_alpha(params.scale_softmax, 1.f / sqrtf(head_size), acc_type); + set_alpha(params.scale_bmm2, 1.f, DATA_TYPE_FP16); + params.dqkv_ptr = dqkv.data_ptr(); + + launch(params, stream); + return { dqkv, softmax }; +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.doc() = "Fused Multi-head Self-attention for BERT"; + m.def("fwd", &mha_fwd, "Forward pass"); + m.def("bwd", &mha_bwd, "Backward pass"); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha.h b/apex/apex/contrib/csrc/fmha/src/fmha.h new file mode 100644 index 0000000000000000000000000000000000000000..3c699c9b0e7010bddc2fe5cc23c0560dfb43665c --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha.h @@ -0,0 +1,92 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include +#include + +#include +#include + +#include + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct Qkv_params { + // The QKV matrices. + void *qkv_ptr; + + // The stride between rows of the Q, K and V matrices. + size_t qkv_stride_in_bytes; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct Fused_multihead_attention_fprop_params : public Qkv_params { + + // The dQKV matrices. + void *dqkv_ptr; + + // The O matrix (output). + void *o_ptr; + + // The stride between rows of O. + int64_t o_stride_in_bytes; + + // The pointer to the S matrix, overwritten by the dP matrix (bwd). + void *s_ptr; + // The stride between rows of the S matrix. + int64_t s_stride_in_bytes; + + // The dimensions. + int b, h, s, d; + + // The scaling factors for the kernel. + uint32_t scale_bmm1, scale_softmax, scale_bmm2; + + // array of length b+1 holding starting offset of each sequence. + int *cu_seqlens; + + // array of length b holding the actual sequence lenghts. + int *seqlens; + + // The dropout probability (probability of keeping an activation). + float p_dropout; + + // Scale factor of 1 / (1 - p_dropout). + float rp_dropout; + + // Scale factor of 1 / (1 - p_dropout), in half2. + uint32_t scale_dropout; + + // Random state. + at::PhiloxCudaState philox_args; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/gemm.h b/apex/apex/contrib/csrc/fmha/src/fmha/gemm.h new file mode 100644 index 0000000000000000000000000000000000000000..b6c9f2c9c3d4dce5cbf0621b6bd4b0299acfa2c5 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/gemm.h @@ -0,0 +1,317 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include + +#define FMHA_DIV_UP(m, n) (((m) + (n)-1) / (n)) + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Data_type_, int NUM_ELTS_, int BITS_PER_ELT_, int ALIGNMENT_ > +struct Fragment_base_ { + + // The data type. + using Data_type = Data_type_; + // default input type + using Input_type_ = Data_type_; + // Does it store the array of elements. + enum { HAS_ELTS = BITS_PER_ELT_ >= 8 }; + // The number of elements. + enum { NUM_ELTS = NUM_ELTS_ }; + // The size of element in bits. + enum { BITS_PER_ELT = BITS_PER_ELT_ }; + // The size of byte of a single register. + enum { BYTES_PER_REG = 4 }; + // The size in bits. + enum { BITS_PER_REG = BYTES_PER_REG * 8 }; + // The number of registers needed to store the fragment. + enum { NUM_REGS = Div_up::VALUE }; + // The size in bytes (as returned by sizeof(Fragment_base<>). + enum { SIZE_IN_BYTES = NUM_REGS * BYTES_PER_REG }; + // The alignment. + enum { ALIGNMENT = ALIGNMENT_ > 0 ? ALIGNMENT_ : Min::VALUE }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The type of the elements. + typename Data_type_, + // The number of elements. + int NUM_ELTS_, + // The alignment if you want to force a value -- use 0 otherwise. + int ALIGNMENT_ = 0, + // The base class. + typename Base_ = Fragment_base_ +> +struct alignas(static_cast(Base_::ALIGNMENT)) Fragment : public Base_ { + + // The size of a load/store. + enum { BYTES_PER_LOAD_STORE = Base_::NUM_REGS * sizeof(uint32_t) }; + + // Clear the fragment. Using PTX in that code seems to produce better SASS... + inline __device__ void clear() { + #pragma unroll + for( int ii = 0; ii < Base_::NUM_REGS; ++ii ) { + asm volatile("mov.u32 %0, 0; \n" : "=r"(this->reg(ii)) : ); + } + } + + // Immutable access to a register. + inline __device__ const uint32_t& reg(int ii) const { + return this->regs_[ii]; + } + + // Mutable access to a register. + inline __device__ uint32_t& reg(int ii) { + return this->regs_[ii]; + } + + uint32_t regs_[Base_::NUM_REGS]; + + // Immutable access to the elements. + inline __device__ const Data_type_& elt(int ii) const { + return reinterpret_cast(&this->regs_[0])[ii]; + } + + // Mutable access to the elements. + inline __device__ Data_type_& elt(int ii) { + return reinterpret_cast(&this->regs_[0])[ii]; + } + + // Immutable access to the elements with a cast. + template< typename Cast_type > + inline __device__ const Cast_type& elt_as(int ii) const { + return reinterpret_cast(&this->regs_[0])[ii]; + } + + // Mutable access to the elements. + template< typename Cast_type > + inline __device__ Cast_type& elt_as(int ii) { + return reinterpret_cast(&this->regs_[0])[ii]; + } + + // Add another fragment. + inline __device__ void add(const Fragment &other) { + #pragma unroll + for( int ii = 0; ii < NUM_ELTS_; ++ii ) { + this->elt(ii) += other.elt(ii); + } + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Layout > +struct Fragment_a : public Fragment { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Layout > +struct Fragment_b : public Fragment { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct Fragment_accumulator : public Fragment { + + // The base class. + using Base = Fragment; + + // Add two fragments. + template< typename Other_fragment_ > + inline __device__ void add(const Other_fragment_ &other) { + for( int ii = 0; ii < Base::NUM_ELTS; ++ii ) { + this->elt(ii) = this->elt(ii) + other.elt(ii); + } + } + + // Do the HMMA. + template< typename Layout_a, typename Layout_b > + inline __device__ void mma(const Fragment_a &a, + const Fragment_b &b) { + asm volatile( \ + "mma.sync.aligned.m16n8k16.row.col.f32.f16.f16.f32 \n" \ + " {%0, %1, %2, %3}, \n" \ + " {%4, %5, %6, %7}, \n" \ + " {%8, %9}, \n" \ + " {%0, %1, %2, %3}; \n" \ + : "+f"( elt(0)), "+f"( elt(1)), "+f"( elt(2)), "+f"( elt(3)) + : "r"(a.reg(0)), "r"(a.reg(1)), "r"(a.reg(2)), "r"(a.reg(3)) + , "r"(b.reg(0)), "r"(b.reg(1))); + asm volatile( \ + "mma.sync.aligned.m16n8k16.row.col.f32.f16.f16.f32 \n" \ + " {%0, %1, %2, %3}, \n" \ + " {%4, %5, %6, %7}, \n" \ + " {%8, %9}, \n" \ + " {%0, %1, %2, %3}; \n" \ + : "+f"( elt(4)), "+f"( elt(5)), "+f"( elt(6)), "+f"( elt(7)) + : "r"(a.reg(0)), "r"(a.reg(1)), "r"(a.reg(2)), "r"(a.reg(3)) + , "r"(b.reg(2)), "r"(b.reg(3))); + } + +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Fragment, int M, int N > +inline __device__ void clear(Fragment (&frag)[M][N]) { + #pragma unroll + for( int mi = 0; mi < M; ++mi ) { + #pragma unroll + for( int ni = 0; ni < N; ++ni ) { + frag[mi][ni].clear(); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Accumulator_type, int WARPS_K > +struct Clear_accumulator { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int WARPS_K > +struct Clear_accumulator { + template< typename Acc, int M, int N > + static inline __device__ void apply(Acc (&acc)[M][N], bool = false) { + fmha::clear(acc); + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +inline __device__ void gemm(Acc (&acc)[M][N], const A (&a)[M], const B (&b)[N]) { + + #pragma unroll + for( int mi = 0; mi < M; ++mi ) { + #pragma unroll + for( int ni = 0; ni < N; ++ni ) { + acc[mi][ni].mma(a[mi], b[ni]); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The number of rows in the CTA tile. + int M_, + // The number of cols in the CTA tile. + int N_, + // The number of elements in the the K dimension of the GEMM loop. + int K_, + // The number of rows of warps. + int WARPS_M_, + // The number of cols of warps. + int WARPS_N_, + // The number of warps in the K dimension of the GEMM loop. + int WARPS_K_> +struct Cta_tile_ { + + enum { M = M_, N = N_, K = K_ }; + // The number of warps. + enum { WARPS_M = WARPS_M_, WARPS_N = WARPS_N_, WARPS_K = WARPS_K_ }; + // The number of warps per CTA. + enum { WARPS_PER_CTA = WARPS_M * WARPS_N * WARPS_K }; + // The number of threads per warp. + enum { THREADS_PER_WARP = 32 }; + // The number of threads per CTA. + enum { THREADS_PER_CTA = WARPS_PER_CTA * THREADS_PER_WARP }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct Hmma_tile { + // The number of elements computed with a single warp-MMA. + enum { M_PER_MMA = 16, N_PER_MMA = 16, K_PER_MMA = 16 }; + + // The number of elements computed with a single CTA-MMA. + enum { + M_PER_MMA_PER_CTA = M_PER_MMA * Cta_tile::WARPS_M, + N_PER_MMA_PER_CTA = N_PER_MMA * Cta_tile::WARPS_N, + K_PER_MMA_PER_CTA = K_PER_MMA * Cta_tile::WARPS_K + }; + + // The number of MMAs needed to compute the GEMM. + enum { + MMAS_M = Div_up::VALUE, + MMAS_N = Div_up::VALUE, + MMAS_K = Div_up::VALUE, + }; + + // The number of elements computed per warp. + enum { + M_PER_WARP = MMAS_M * M_PER_MMA, + N_PER_WARP = MMAS_N * N_PER_MMA, + K_PER_WARP = MMAS_K * K_PER_MMA, + }; + +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +using A_type = uint16_t; +using B_type = uint16_t; +using C_type = uint16_t; +using Accumulator_type = float; +using Epilogue_type = float; + +constexpr int BITS_PER_ELEMENT_A = sizeof(A_type) * 8; +constexpr int BITS_PER_ELEMENT_B = sizeof(B_type) * 8; +constexpr int BITS_PER_ELEMENT_C = sizeof(C_type) * 8; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +using Cta_tile_extd = Cta_tile_; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +using Cta_tile_with_k_with_padding = Cta_tile_extd::VALUE, + Cta_tile_::WARPS_M, + Cta_tile_::WARPS_N, + Cta_tile_::WARPS_K>; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/gmem_tile.h b/apex/apex/contrib/csrc/fmha/src/fmha/gmem_tile.h new file mode 100644 index 0000000000000000000000000000000000000000..484ea2546f1f9e627d4caa63a011c9450a40478b --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/gmem_tile.h @@ -0,0 +1,426 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The number of bits per element. + int BITS_PER_ELEMENT, + // The number of rows of Q, K or V loaded by this tile. + int ROWS, + // The number of columns. + int COLS +> +struct Gmem_tile_qkv { + + // The size of each LDG. + enum { BYTES_PER_LDG = 16 }; + // The size of a row in bytes. + enum { BYTES_PER_ROW = COLS * BITS_PER_ELEMENT / 8 }; + + // The number of threads to load a "row" of the matrix. + enum { THREADS_PER_ROW = BYTES_PER_ROW / BYTES_PER_LDG }; + + // The number of "rows" loaded per LDG. + enum { ROWS_PER_LDG = Cta_tile::THREADS_PER_CTA / THREADS_PER_ROW }; + // The number of LDGs needed to load a chunk of the Q matrix. + enum { LDGS = fmha::Div_up::VALUE }; + + // Ctor. + template< typename Params, typename BInfo > + inline __device__ Gmem_tile_qkv(const Params ¶ms, int qkv_offset, const BInfo &binfo, int tidx) + : params_qkv_stride_in_bytes_(params.qkv_stride_in_bytes) + , actual_seqlen(binfo.actual_seqlen) + , qkv_ptr_(reinterpret_cast(params.qkv_ptr)) { + + // Compute the position in the sequence (within the CTA for the moment). + int row = tidx / THREADS_PER_ROW; + // Compute the position of the thread in the row. + int col = tidx % THREADS_PER_ROW; + + // Store the row as we need it to disable the loads. + row_ = row; + + // The row offset in the batched GEMM. For each seq element, we store QKV in that order. + int64_t row_offset = (int64_t)row * params.qkv_stride_in_bytes; + // Add the block index. + row_offset += (int64_t)((binfo.sum_s * 3 + qkv_offset) * binfo.h + binfo.bidh) * BYTES_PER_ROW; + + // Assemble the final pointer. + qkv_ptr_ += row_offset + col * BYTES_PER_LDG; + } + + // Store data to shared memory. + template< typename Smem_tile > + inline __device__ void commit(Smem_tile &smem_tile) { + smem_tile.store(fetch_); + } + + // Load data from memory. + template< typename Smem_tile > + inline __device__ void load(Smem_tile &smem_tile) { + const void *ptrs[LDGS]; + uint32_t preds[LDGS]; + #pragma unroll + for( int ii = 0; ii < LDGS; ++ii ) { + ptrs[ii] = qkv_ptr_ + (int64_t)ii * ROWS_PER_LDG * params_qkv_stride_in_bytes_; + preds[ii] = ((row_ + ii * ROWS_PER_LDG) < min(ROWS, actual_seqlen)); + fetch_[ii] = make_uint4(0, 0, 0, 0); + } + + // not packing predicates removes restrictions (e.g. FP16 384, 4 warps) + Ldg_functor fct(fetch_, ptrs); + #pragma unroll + for( int ii = 0; ii < LDGS; ++ii ) { + fct.load(ii, preds[ii]); + } + } + + // Store data to memory. + inline __device__ void store(const uint4 (&data)[LDGS]) { + #pragma unroll + for( int ii = 0; ii < LDGS; ++ii ) { + char *ptr = qkv_ptr_ + (int64_t)ii * ROWS_PER_LDG * params_qkv_stride_in_bytes_; + if( (row_ + ii * ROWS_PER_LDG) < min(ROWS, actual_seqlen) ) { + fmha::stg(ptr, data[ii]); + } + } + } + + // Move the pointer to the next location. + inline __device__ void move() { + qkv_ptr_ += (int64_t)ROWS * params_qkv_stride_in_bytes_; + actual_seqlen -= ROWS; + } + + // The stride between rows for the QKV matrice. + int64_t params_qkv_stride_in_bytes_; + // The pointer. + char *qkv_ptr_; + // The fetch registers. + uint4 fetch_[LDGS]; + // Keep track of the row the thread is processing as we move the tile. + int row_; + // The length of the sequence loaded by that memory tile. + int actual_seqlen; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Cta_tile > +struct Gmem_tile_o { + + // The mma tile. + using Mma_tile = fmha::Hmma_tile; + + // The size of each element. + enum { BYTES_PER_ELEMENT = 2 }; + // The size of a row in bytes. + enum { BYTES_PER_ROW = Cta_tile::N * BYTES_PER_ELEMENT }; + + // The number of threads to store a "row" of the matrix. + enum { THREADS_PER_ROW = 16 }; + // The size of each STG. + enum { BYTES_PER_STG = BYTES_PER_ROW / THREADS_PER_ROW }; + + // The number of "rows" stored per iteration of the loop. The output of 1 MMA. + enum { ROWS = Cta_tile::M }; + // The number of "rows" stored per iteration of the loop. The output of 1 MMA. + enum { ROWS_PER_LOOP = ROWS <= 64 ? ROWS : (int)Mma_tile::M_PER_MMA_PER_CTA }; + // The number of outter loop for the stores. + enum { LOOPS = ROWS / ROWS_PER_LOOP }; + + // The number of "rows" stored per STG. + enum { ROWS_PER_STG = Cta_tile::THREADS_PER_CTA / THREADS_PER_ROW }; + // Do we have to guard against partial writes/reads. + enum { HAS_INCOMPLETE_STG = Cta_tile::M % ROWS_PER_STG != 0 }; + // The number of STGs needed to store a chunk of the Q matrix. + enum { STGS_PER_LOOP = fmha::Div_up::VALUE }; + // The number of STGs needed to store a chunk of the Q matrix in total. + enum { STGS = STGS_PER_LOOP * LOOPS }; + + // Ctor. + template + inline __device__ Gmem_tile_o(const Params ¶ms, const BInfo &binfo, int tidx) + : params_o_stride_in_bytes_(params.o_stride_in_bytes) + , actual_seqlen_(binfo.actual_seqlen) + , o_ptr_(reinterpret_cast(params.o_ptr)) { + + // Compute the position in the sequence (within the CTA for the moment). + int row = tidx / THREADS_PER_ROW; + // Compute the position of the thread in the row. + int col = tidx % THREADS_PER_ROW; + + // Store the row as we need it to disable loads. + row_ = row; + + // The row offset in the batched GEMM. + int64_t row_offset = (int64_t)row * params.o_stride_in_bytes + binfo.bidx * BYTES_PER_ROW; + // Assemble the final pointer. + o_ptr_ += row_offset + col * BYTES_PER_STG; + + // Is that thread active on the last STG? + if( HAS_INCOMPLETE_STG ) { + is_active_for_last_stg_ = row + (STGS - 1) * ROWS_PER_STG < Cta_tile::M; + } + } + + // Store data to global memory. + inline __device__ void store(const uint4 (&src)[STGS_PER_LOOP], int mi) { + + #pragma unroll + for( int ii = 0; ii < STGS_PER_LOOP; ++ii ) { + int jj = mi * STGS_PER_LOOP + ii; + if( this->row_ + jj * ROWS_PER_STG >= this->actual_seqlen_ ) { + break; + } + + float x = reinterpret_cast(src[ii].x); + float y = reinterpret_cast(src[ii].y); + float z = reinterpret_cast(src[ii].z); + float w = reinterpret_cast(src[ii].w); + uint2 out = float4_to_half4(x, y, z, w); + if( !HAS_INCOMPLETE_STG || (jj < STGS - 1 || this->is_active_for_last_stg_) ) { + fmha::stg(this->o_ptr_ + jj * ROWS_PER_STG * this->params_o_stride_in_bytes_, out); + } + } + } + + // Move the pointer to the next location. + inline __device__ void move() { + row_ += ROWS; + o_ptr_ += (int64_t)ROWS * params_o_stride_in_bytes_; + } + + // The stride between rows for the QKV matrice. + int64_t params_o_stride_in_bytes_; + // The pointer. + char *o_ptr_; + // Is the thread active for the last STG? + int is_active_for_last_stg_; + // Keep track of the row to disable loads. + int row_; + // The length of the sequence loaded by that memory tile. + int actual_seqlen_; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Cta_tile, int BYTES_PER_ELEMENT > +struct Gmem_tile_mma_sd { + + // The mma tile. + using Mma_tile = fmha::Hmma_tile; + + // Each STG stores 8 elements. + enum { BYTES_PER_STG = BYTES_PER_ELEMENT * 8 }; + // The number of MMAs in the M dimension. + enum { MMAS_M = Mma_tile::MMAS_M }; + // The number of MMAs in the N dimension. + enum { MMAS_N = Mma_tile::MMAS_N }; + // The number of rows computed per MMA per thread block. + enum { M_PER_MMA_PER_CTA = Mma_tile::M_PER_MMA_PER_CTA }; + // The number of cols computed per MMA per thread block. + enum { N_PER_MMA_PER_CTA = Mma_tile::N_PER_MMA_PER_CTA }; + // The number of threads per block. + enum { THREADS_PER_CTA = Cta_tile::THREADS_PER_CTA }; + // The size of each row in bytes. I.e. how many bytes are stored per STG. + enum { BYTES_PER_ROW = THREADS_PER_CTA * BYTES_PER_STG }; + // The fixed sequence length. + enum { SEQLEN = Cta_tile::N }; + // The distance between two blocks (in bytes). + enum { BLOCK_STRIDE_BYTES = SEQLEN * SEQLEN * BYTES_PER_ELEMENT }; + // The distance between elements stored per loop (in bytes). + enum { LOOP_STRIDE_BYTES = MMAS_M * MMAS_N * BYTES_PER_ROW }; + + // The type of elements stored per STG. + using Type = typename fmha::Uint_from_size_in_bytes::Type; + + // Ctor. + template + inline __device__ Gmem_tile_mma_sd(void *ptr, const Params ¶ms, const int tidx) + : ptr_(static_cast(ptr)) { + + // The block index for the batch. + const int bidb = blockIdx.y; + // The block index for the head. + const int bidh = blockIdx.x; + // The block index. + size_t bidx = bidb * params.h + bidh; + + // Set store location for each thread at the beginning of the loop + ptr_ += bidx * BLOCK_STRIDE_BYTES + tidx * BYTES_PER_STG; + } + + // Store to global memory. + inline __device__ void store(const Type &data, const int mi, const int ni) { + size_t offset = (mi * MMAS_N + ni) * BYTES_PER_ROW; + fmha::stg(ptr_ + offset, data); + } + + // Load from global memory. + inline __device__ void load(Type &data, const int mi, const int ni) { + size_t offset = (mi * MMAS_N + ni) * BYTES_PER_ROW; + fmha::ldg(data, ptr_ + offset); + } + + // Move to the next tile. + inline __device__ void move() { + ptr_ += LOOP_STRIDE_BYTES; + } + + // The pointer in global memory. + char *ptr_; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Cta_tile, typename Base = Gmem_tile_mma_sd > +struct Gmem_tile_mma_s : public Base { + + // The number of mmas in the vertical dimension. + enum { M = Base::MMAS_M }; + // The number of mmas in the horizontal dimension. + enum { N = Base::MMAS_N }; + // The type of the vectors stored by each STG. + using Type = typename Base::Type; + + // Ctor. + template< typename Params > + inline __device__ Gmem_tile_mma_s(void *ptr, const Params ¶ms, const int tidx) + : Base(ptr, params, tidx) { + } + + // Store to global memory. + template + inline __device__ void store(const float (&softmax)[2 * M][4 * N], const Mask &mask) { + #pragma unroll + for( int mi = 0; mi < M; mi++ ) { + #pragma unroll + for( int ni = 0; ni < N; ni++ ) { + + float tmp00 = softmax[2 * mi + 0][4 * ni + 0]; + float tmp01 = softmax[2 * mi + 0][4 * ni + 1]; + float tmp02 = softmax[2 * mi + 0][4 * ni + 2]; + float tmp03 = softmax[2 * mi + 0][4 * ni + 3]; + + float tmp10 = softmax[2 * mi + 1][4 * ni + 0]; + float tmp11 = softmax[2 * mi + 1][4 * ni + 1]; + float tmp12 = softmax[2 * mi + 1][4 * ni + 2]; + float tmp13 = softmax[2 * mi + 1][4 * ni + 3]; + + uint4 dst; + dst.x = fmha::float2_to_half2(tmp00, tmp01); + dst.y = fmha::float2_to_half2(tmp02, tmp03); + dst.z = fmha::float2_to_half2(tmp10, tmp11); + dst.w = fmha::float2_to_half2(tmp12, tmp13); + if( mask.is_valid(mi, ni, 0, 0) ) { + Base::store(dst, mi, ni); + } + } + } + } + + // Load from global memory. + template + inline __device__ void load(uint4 (®s)[M][N], const Mask &mask) { + #pragma unroll + for( int mi = 0; mi < M; mi++ ) { + #pragma unroll + for( int ni = 0; ni < N; ni++ ) { + regs[mi][ni] = make_uint4(0, 0, 0, 0); + if( mask.is_valid(mi, ni, 0, 0) ) { + Base::load(regs[mi][ni], mi, ni); + } + } + } + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The base class. + typename Base = fmha::Gmem_tile_qkv +> +struct Gmem_tile_dout : public Base { + + // Ctor. + template + inline __device__ Gmem_tile_dout(const Params ¶ms, const BInfo &binfo, int tidx) + : Base(params, 0, binfo, tidx) { + + this->qkv_ptr_ = reinterpret_cast(params.o_ptr); + this->params_qkv_stride_in_bytes_ = params.o_stride_in_bytes; // needed for move + + // Compute the position of the thread in the row. + int col = tidx % Base::THREADS_PER_ROW; + + // The row offset in the batched GEMM. For each seq element, we store O in that order. + int64_t row_offset = (int64_t)this->row_ * params.o_stride_in_bytes + binfo.bidx * Base::BYTES_PER_ROW; + + // Assemble the final pointer. + this->qkv_ptr_ += row_offset + col * Base::BYTES_PER_LDG; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Cta_tile, typename Base = fmha::Gmem_tile_o > +struct Gmem_tile_dq : public Base { + + // Ctor. + template + inline __device__ Gmem_tile_dq(const Params ¶ms, const BInfo &binfo, int tidx) + : Base(params, binfo, tidx) { + this->o_ptr_ = reinterpret_cast(params.dqkv_ptr); + this->params_o_stride_in_bytes_ = params.qkv_stride_in_bytes; // needed for move + + // Compute the position of the thread in the row. + int col = tidx % Base::THREADS_PER_ROW; + + // The row offset in the batched GEMM. For each seq element, we store O in that order. + int64_t row_offset = (int64_t)this->row_ * params.qkv_stride_in_bytes + + (binfo.sum_s * 3 * binfo.h + binfo.bidh) * Base::BYTES_PER_ROW; + + // Assemble the final pointer. + this->o_ptr_ += row_offset + col * Base::BYTES_PER_STG; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha + diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/kernel_traits.h b/apex/apex/contrib/csrc/fmha/src/fmha/kernel_traits.h new file mode 100644 index 0000000000000000000000000000000000000000..965212070d3d36f7a8183375d9a5be288e71316e --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/kernel_traits.h @@ -0,0 +1,95 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct FMHA_kernel_traits { + + // The CTA description for the 1st GEMM. + using Cta_tile_p = fmha::Cta_tile_extd; + // The CTA description for the 2nd GEMM. + using Cta_tile_o = fmha::Cta_tile_extd; + + // Do we use one buffer for K and V. + enum { SHARE_SMEM_FOR_K_AND_V = (FLAGS & 0x8u) != 0u }; + + // The global memory tile to load Q. + using Gmem_tile_q = fmha::Gmem_tile_qkv; + + // The shared memory tile to swizzle Q. + using Smem_tile_q = fmha::Smem_tile_a; + + // The global memory tile to load K. + using Gmem_tile_k = fmha::Gmem_tile_qkv; + // The shared memory tile to swizzle K. + using Smem_tile_k = fmha::Smem_tile_b; + + // The global memory tile to load V. + using Gmem_tile_v = fmha::Gmem_tile_qkv; + // The shared memory tile to swizzle V. + using Smem_tile_v = fmha::Smem_tile_v; + + // The global memory tile to store O. + using Gmem_tile_o = fmha::Gmem_tile_o; + // The shared memory tile for O. + using Smem_tile_o = fmha::Smem_tile_o; + + // The global memory tile to load/store S. + using Gmem_tile_s = fmha::Gmem_tile_mma_s; + + // The shared memory tile to transpose S. + using Smem_tile_st = fmha::Smem_tile_mma_transposed; + + using Gmem_tile_do = fmha::Gmem_tile_dout; + + // Make sure the number of threads match. + static_assert((int)Gmem_tile_o::THREADS_PER_ROW == (int)Smem_tile_o::THREADS_PER_ROW, ""); + + // The number of threads. + enum { THREADS = Cta_tile_p::THREADS_PER_CTA }; + // Make sure the number of threads matches both CTAs. + static_assert((int)THREADS == (int)Cta_tile_o::THREADS_PER_CTA, ""); + + // The amount of shared memory needed to load Q and K. + enum { BYTES_PER_SMEM_QK = Smem_tile_q::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE }; + // The extra amount of shared memory needed to load V. + enum { BYTES_PER_SMEM_V = SHARE_SMEM_FOR_K_AND_V ? 0u : Smem_tile_v::BYTES_PER_TILE }; + // The amount of shared memory needed for Q, K and V.. + enum { BYTES_PER_SMEM_QKV = BYTES_PER_SMEM_QK + BYTES_PER_SMEM_V }; + // The amount of shared memory needed to load Q and store O. + enum { BYTES_PER_SMEM_QO = Smem_tile_q::BYTES_PER_TILE + Smem_tile_o::BYTES_PER_TILE }; + + // The amount of shared memory needed for Q, K, V and O. + enum { BYTES_PER_SMEM = fmha::Max::VALUE }; + // Make sure we have enough shared memory. + static_assert(Smem_tile_q::BYTES_PER_TILE + Smem_tile_o::BYTES_PER_TILE <= BYTES_PER_SMEM, ""); +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/mask.h b/apex/apex/contrib/csrc/fmha/src/fmha/mask.h new file mode 100644 index 0000000000000000000000000000000000000000..02db0822152bf6a6898091d5d8a9e792b0271370 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/mask.h @@ -0,0 +1,76 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +namespace fmha { + + +template +struct Mask { + using Mma_tile = fmha::Hmma_tile; + + template + __device__ Mask(const Params ¶ms, const BInfo &blockInfo, int tidx) { + + actual_seqlen = blockInfo.actual_seqlen; + + const int warp = tidx / Cta_tile::THREADS_PER_WARP; + const int lane = tidx % Cta_tile::THREADS_PER_WARP; + + static_assert(Cta_tile::WARPS_K == 1, ""); + + // find the warp in the Cta tile + const int warp_n = (warp / Cta_tile::WARPS_M); + const int warp_m = (warp % Cta_tile::WARPS_M); + // decompose warp into 8x4 tile + const int quad = lane / 4; + const int tid = (lane % 4) * 2; + row = warp_m * 16 + quad; + col = warp_n * 16 + tid; + } + + inline __device__ bool is_valid(const int mi, const int ni, const int ii, const int jj) const { + + // ii and jj iterate over the 2x4 fragment + const bool col_valid = (ni * Mma_tile::N_PER_MMA_PER_CTA + col + (jj & 2) * 4 + (jj & 1)) < actual_seqlen; + //&& (row + mi * Mma_tile::M_PER_MMA_PER_CTA + ii * 8) < actual_seqlen; + return col_valid; + // return row_valid && col_valid; + } + + inline __device__ void load(int it) { + row_offset = it * Cta_tile::M + row; + } + int row_offset; + + int row; + int col; + int actual_seqlen; +}; + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/smem_tile.h b/apex/apex/contrib/csrc/fmha/src/fmha/smem_tile.h new file mode 100644 index 0000000000000000000000000000000000000000..73273bcef090a91bf07e7b031561ebaa3d84478d --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/smem_tile.h @@ -0,0 +1,1253 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include +#include + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The description of the tile computed by this CTA. + typename Cta_tile, + // The number of rows in the 2D shared memory buffer. + int M_, + // The number of cols. + int N_, + // The size in bits of each element. + int BITS_PER_ELEMENT_, + // The number of bytes per STS. + int BYTES_PER_STS_ = 16, + // The number of buffers. (Used in multistage and double buffer cases.) + int BUFFERS_PER_TILE_ = 1, + // Do we enable the fast path for LDS.128 and friends. + int ENABLE_LDS_FAST_PATH_ = 0, + // The number of rows that are used for the XOR swizzling to allow fast STS/LDS. + int ROWS_PER_XOR_PATTERN_ = 8, + // The number of cols that are used for the XOR swizzling to allow fast STS/LDS. + int COLS_PER_XOR_PATTERN_ = 1, + // Use or not predicates + bool USE_PREDICATES_ = true +> +struct Smem_tile_without_skews { + + // The size in bits of each element. + enum { BITS_PER_ELEMENT = BITS_PER_ELEMENT_ }; + // The size in bytes of a single STS. + enum { BYTES_PER_STS = BYTES_PER_STS_ }; + // The number of elements per STS. + enum { ELEMENTS_PER_STS = BYTES_PER_STS * 8 / BITS_PER_ELEMENT }; + // To support arbitrary N, we pad some values to a power-of-2. + enum { N_WITH_PADDING = Next_power_of_two::VALUE }; + // The number of bytes per row without packing of rows. + enum { BYTES_PER_ROW_BEFORE_PACKING = N_WITH_PADDING * BITS_PER_ELEMENT / 8 }; + // The number of bytes per row -- we want at least 128B per row. + enum { BYTES_PER_ROW = Max::VALUE }; + // The number of rows in shared memory (two rows may be packed into a single one). + enum { ROWS = M_ * BYTES_PER_ROW_BEFORE_PACKING / BYTES_PER_ROW }; + + // The number of threads per row. + enum { THREADS_PER_ROW_UNBOUNDED = BYTES_PER_ROW / BYTES_PER_STS }; + // The number of threads per row. + enum { THREADS_PER_ROW = Min::VALUE }; + + // The number of STS per row. + enum { STS_PER_ROW = BYTES_PER_ROW / THREADS_PER_ROW / BYTES_PER_STS }; + // It must be at least one. + static_assert(STS_PER_ROW >= 1, ""); + // The number of rows written with a single STS. + enum { ROWS_PER_STS = Cta_tile::THREADS_PER_CTA / THREADS_PER_ROW }; + // Make sure we write to at least one row per STS. Thanks Dr. Obvious ;) + static_assert(ROWS_PER_STS >= 1, ""); + // The number of STS needed to store all rows. + enum { STS_PER_COL = Div_up::VALUE }; + // The number of STS in total. + enum { STS = STS_PER_COL * STS_PER_ROW }; + + // The size of one buffer in bytes in shared memory. + enum { BYTES_PER_BUFFER = STS * BYTES_PER_STS * Cta_tile::THREADS_PER_CTA }; + // The number of buffers. + enum { BUFFERS_PER_TILE = BUFFERS_PER_TILE_ }; + // The size in bytes of total buffers. + enum { BYTES_PER_TILE = BYTES_PER_BUFFER * BUFFERS_PER_TILE }; + // The boundary for smem_read_offset and smem_write_offset increment. + enum { BYTES_PER_TILE_INC_BOUNDARY = BYTES_PER_TILE - BYTES_PER_BUFFER }; + + // Do we enable the LDS.128 fast path? + enum { ENABLE_LDS_FAST_PATH = ENABLE_LDS_FAST_PATH_ }; + static_assert(ENABLE_LDS_FAST_PATH == 0); + // The number of rows that are used for the XOR swizzling to allow fast STS/LDS. + enum { ROWS_PER_XOR_PATTERN = ROWS_PER_XOR_PATTERN_ }; + // The number of cols that are used for the XOR swizzling to allow fast STS/LDS. + enum { COLS_PER_XOR_PATTERN = COLS_PER_XOR_PATTERN_ * 16 / BYTES_PER_STS }; + // Use or not predicates + enum { USE_PREDICATES = USE_PREDICATES_ }; + + // The type of elements that are stored in shared memory by each thread. + using Store_type = typename Uint_from_size_in_bytes::Type; + + // Ctor. + inline __device__ Smem_tile_without_skews(void *smem, int tidx) + : smem_(__nvvm_get_smem_pointer(smem)) { + + // The row written by a thread. See doc/mma_smem_layout.xlsx. + int smem_write_row = tidx / THREADS_PER_ROW; + + // The XOR pattern. + int smem_write_xor = smem_write_row % ROWS_PER_XOR_PATTERN * COLS_PER_XOR_PATTERN; + // Compute the column and apply the XOR pattern. + int smem_write_col = (tidx % THREADS_PER_ROW) ^ smem_write_xor; + + // The offset. + this->smem_write_offset_ = smem_write_row*BYTES_PER_ROW + smem_write_col*BYTES_PER_STS; + + // TODO: Why not merge it with the read offset? + this->smem_read_buffer_ = __shfl_sync(0xffffffff, 0, 0); + this->smem_write_buffer_ = __shfl_sync(0xffffffff, 0, 0); + } + + // Compute the store pointers. + template< int N > + inline __device__ void compute_store_pointers(uint32_t (&ptrs)[N]) { + #pragma unroll + for( int ii = 0; ii < N; ++ii ) { + // Decompose the STS into row/col. + int row = ii / STS_PER_ROW; + int col = ii % STS_PER_ROW; + + // Assemble the offset. + int offset = smem_write_offset_ + row*ROWS_PER_STS*BYTES_PER_ROW; + + // Take the column into account. + if( STS_PER_ROW > 1 ) { + offset += col*THREADS_PER_ROW*BYTES_PER_STS; + } + + // Apply the XOR pattern if needed. + if( ROWS_PER_STS < ROWS_PER_XOR_PATTERN ) { + const int m = row * ROWS_PER_STS % ROWS_PER_XOR_PATTERN; + offset ^= m * COLS_PER_XOR_PATTERN * BYTES_PER_STS; + } + + // Assemble the final pointer :) + ptrs[ii] = smem_ + offset + smem_write_buffer_; + } + } + + inline __device__ void debug_reset() { + for( int buffer = 0; buffer < BYTES_PER_TILE; buffer += BYTES_PER_BUFFER) { + for( int row = 0; row < ROWS; ++row ) { + for( int col = 0; col < BYTES_PER_ROW; col += 4 ) { + if( threadIdx.x == 0 ) { + uint32_t val = 0x0; + sts(val, smem_ + row*BYTES_PER_ROW + col + buffer); + } + } + } + } + } + + // Print the content of the tile (only for debug ;)). + inline __device__ void debug_print() const { + for( int buffer = 0; buffer < BYTES_PER_TILE; buffer += BYTES_PER_BUFFER) { + for( int row = 0; row < ROWS; ++row ) { + for( int col = 0; col < BYTES_PER_ROW; col += 4 ) { + if( threadIdx.x == 0 ) { + uint32_t val; + lds(val, smem_ + row*BYTES_PER_ROW + col + buffer); + printf("block=(x=%2d, y=%2d, z=%2d) (smem_=%2d, buffer=%2d, row=%2d, byte=%4d)=0x%08x\n", + blockIdx.x, + blockIdx.y, + blockIdx.z, + smem_, + buffer, + row, + col, + val); + } + } + } + } + } + + // Move the read offset to next buffer. + inline __device__ void move_to_next_read_buffer() { + if( BUFFERS_PER_TILE > 1 && smem_read_buffer_ >= BYTES_PER_TILE_INC_BOUNDARY ) { + this->smem_read_buffer_ -= BYTES_PER_TILE_INC_BOUNDARY; + } else if( BUFFERS_PER_TILE > 1 ) { + this->smem_read_buffer_ += BYTES_PER_BUFFER; + } + } + + // Move the read offset to next buffer. TODO: Remove this member function!!! + inline __device__ void move_next_read_buffer() { + this->move_to_next_read_buffer(); + } + + // Move the read offset to next N buffer (circular-buffer). + inline __device__ void move_to_next_read_buffer(int N) { + if( BUFFERS_PER_TILE > 1 ) { + this->smem_read_buffer_ += N * BYTES_PER_BUFFER; + this->smem_read_buffer_ -= smem_read_buffer_ >= BYTES_PER_TILE ? BYTES_PER_TILE : 0; + } + } + + // Move the read offset to next N buffer (circular-buffer). TODO: Remove this member function!!! + inline __device__ void move_next_read_buffer(int N) { + this->move_to_next_read_buffer(N); + } + + // Move the write offset to next buffer. + inline __device__ void move_to_next_write_buffer() { + if( BUFFERS_PER_TILE > 1 && smem_write_buffer_ >= BYTES_PER_TILE_INC_BOUNDARY ) { + this->smem_write_buffer_ -= BYTES_PER_TILE_INC_BOUNDARY; + } else if( BUFFERS_PER_TILE > 1 ) { + this->smem_write_buffer_ += BYTES_PER_BUFFER; + } + } + + // Move the write offset to next buffer. TODO: Remove that member function! + inline __device__ void move_next_write_buffer() { + this->move_to_next_write_buffer(); + } + + // Move the read offset. + inline __device__ void move_read_offset(int delta) { + this->smem_read_offset_ += delta; + } + + // Move the write offset. + inline __device__ void move_write_offset(int delta) { + this->smem_write_offset_ += delta; + } + + // Store to the tile in shared memory. + template< int N > + inline __device__ void store(const Store_type (&data)[N], uint64_t = 0) { + uint32_t smem_ptrs[N]; + this->compute_store_pointers(smem_ptrs); + sts(smem_ptrs, data); + } + + // Store to the tile in shared memory. + template< int N, int M > + inline __device__ void store(const Store_type (&data)[N], uint32_t (&preds)[M], uint64_t = 0) { + uint32_t smem_ptrs[N]; + this->compute_store_pointers(smem_ptrs); + sts(smem_ptrs, data, preds); + } + + // Store to the tile in shared memory. + template< int N > + inline __device__ void store(const Store_type (&data)[N], uint32_t preds, uint64_t = 0) { + this->store(data, preds); + } + + // Store to the tile in shared memory. + template< int N > + inline __device__ void store(const void* (&gmem_ptrs)[N], uint32_t preds, uint64_t = 0) { + uint32_t tmp[1] = { preds }; + this->store(gmem_ptrs, tmp); + } + + // The shared memory pointer. + uint32_t smem_; + // The read offset. Reserve 4 offsets if needed. + int smem_read_offset_; + // The write offset. + int smem_write_offset_; + // The buffer base offset for read. + int smem_read_buffer_; + // The buffer base offset for write. + int smem_write_buffer_; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The layout of the tile. + typename Layout, + // The size of the STS. + int BYTES_PER_STS = 16, + // The number of buffers per tile. + int BUFFERS_PER_TILE = 1, + // Use or not predicates + bool USE_PREDICATES = true +> +struct Smem_tile_a { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int MMAS_K, int MMAS_K_WITH_PADDING > +struct Compute_reset_mask { + // The potential mask. + enum { HALF = MMAS_K_WITH_PADDING / 2 }; + // The remainder. + enum { MOD = MMAS_K % HALF }; + // The final value. + enum { VALUE = (MMAS_K == MOD ? 0 : HALF) | Compute_reset_mask::VALUE }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int MMAS_K_WITH_PADDING > +struct Compute_reset_mask<0, MMAS_K_WITH_PADDING> { + enum { VALUE = 0 }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int MMAS_K > +struct Compute_reset_mask { + enum { VALUE = MMAS_K - 1 }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +struct Rows_per_xor_pattern_a { + // The size in bits. + enum { N_IN_BITS = N * fmha::BITS_PER_ELEMENT_A }; + // The number of rows. + enum { VALUE = N_IN_BITS <= 256 ? 2 : (N_IN_BITS <= 512 ? 4 : 8) }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +struct Rows_per_xor_pattern_row_a : public Rows_per_xor_pattern_a { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The size of the STS. + int BYTES_PER_STS, + // The number of buffers per tile. + int BUFFERS_PER_TILE, + // How many rows to use for the XOR pattern to avoid bank conflicts? + int ROWS_PER_XOR_PATTERN_ = Rows_per_xor_pattern_row_a::VALUE +> +struct Smem_tile_row_a : public Smem_tile_without_skews { + // The MMA tile. + using Mma_tile = fmha::Hmma_tile; + // The base class. + using Base = Smem_tile_without_skews; + // The fragment. + using Fragment = Fragment_a; + + // When we use padding to reach a power of two, special care has to be taken. + using Cta_tile_with_padding = Cta_tile_with_k_with_padding; + // The number of MMAs. + using Mma_tile_with_padding = fmha::Hmma_tile; + + // The size of a single LDS in bytes. + enum { BYTES_PER_LDS = 16 }; + + // Ctor. + inline __device__ Smem_tile_row_a(void *smem, int tidx) : Base(smem, tidx) { + + // For documentation on the layout, see doc/mma_smem_layout.xlsx. + + // The number of warps. + const int WARPS_M = Cta_tile::WARPS_M; + const int WARPS_N = Cta_tile::WARPS_N; + const int WARPS_K = Cta_tile::WARPS_K; + + static_assert(WARPS_M == 1); + static_assert(WARPS_N == 4 || WARPS_N == 8); + static_assert(WARPS_K == 1); + static_assert(Base::ROWS_PER_XOR_PATTERN == 8); + + // The row and column read by the thread. + int smem_read_row = (tidx & 0x0f); + int smem_read_col = (tidx & 0x07); + smem_read_col ^= (tidx & 0x10) / 16; + + // The shared memory offset. + this->smem_read_offset_ = smem_read_row*Base::BYTES_PER_ROW + smem_read_col*BYTES_PER_LDS; + } + + // Rewind smem_read_offset for last LDS phase in main loop. + inline __device__ void reverse_smem_read_offset(int ki = 0) { + // Undo the pointer increment for the next ni. + // Should match the load function below for ki = 0. + if( Mma_tile_with_padding::MMAS_K >= 2 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * 2; + } + } + + // Load from shared memory. + inline __device__ void load(Fragment (&a)[Mma_tile::MMAS_M], int ki) { + #pragma unroll + for( int mi = 0; mi < Mma_tile::MMAS_M; ++mi ) { + // Jump by as many matrix rows as needed (a row in smem may pack multiple matrix rows). + int offset = mi * Mma_tile::M_PER_MMA_PER_CTA * Base::BYTES_PER_ROW_BEFORE_PACKING; + + // Load using LDSM.M88.4. + uint4 tmp; + ldsm(tmp, this->smem_ + this->smem_read_offset_ + this->smem_read_buffer_ + offset); + + // Store the value into the fragment. + a[mi].reg(0) = tmp.x; + a[mi].reg(1) = tmp.y; + a[mi].reg(2) = tmp.z; + a[mi].reg(3) = tmp.w; + } + + // Move the offset to the next possition. See doc/mma_smem_layout.xlsx. + static_assert(Mma_tile_with_padding::MMAS_K < 64, "Not implemented"); + if( Mma_tile_with_padding::MMAS_K >= 32 && ki % 16 == 15 ) { + this->smem_read_offset_ ^= 31 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 16 && ki % 8 == 7 ) { + this->smem_read_offset_ ^= 15 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 8 && ki % 4 == 3 ) { + this->smem_read_offset_ ^= 7 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 4 && ki % 2 == 1 ) { + this->smem_read_offset_ ^= 3 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 2 ) { + this->smem_read_offset_ ^= 1 * BYTES_PER_LDS * 2; + } + } + + // Reset the read offset. + inline __device__ void reset_read_offset() { + // The number of MMAs in the K dimension. + enum { MMAS_K = Mma_tile::MMAS_K }; + // The number of MMAs in the K dimension when we include padding. + enum { MMAS_K_WITH_PADDING = Mma_tile_with_padding::MMAS_K }; + // Assemble the mask. + enum { MASK = Compute_reset_mask::VALUE }; + + // Reset the read offset. + this->smem_read_offset_ ^= MASK * BYTES_PER_LDS * 2; + } + +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The size of the STS. + int BYTES_PER_STS, + // The number of buffers per tile. + int BUFFERS_PER_TILE +> +struct Smem_tile_a + : public Smem_tile_row_a { + // The base class. + using Base = Smem_tile_row_a; + + // Ctor. + inline __device__ Smem_tile_a(void *smem, int tidx) : Base(smem, tidx) { + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The layout of the tile. + typename Layout, + // The size of the STS. + int BYTES_PER_STS = 16, + // The number of buffers per tile. + int BUFFERS_PER_TILE = 1, + // Use or not predicates + bool USE_PREDICATES = true +> +struct Smem_tile_b { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +struct Rows_per_xor_pattern_b { + // The size in bits. + enum { N_IN_BITS = N * fmha::BITS_PER_ELEMENT_B }; + // The number of rows. + enum { VALUE = N_IN_BITS <= 256 ? 2 : (N_IN_BITS <= 512 ? 4 : 8) }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +struct Rows_per_xor_pattern_col_b : public Rows_per_xor_pattern_b { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The size of the STS. + int BYTES_PER_STS, + // The number of buffers per tile. + int BUFFERS_PER_TILE, + // How many rows to use for the XOR pattern to avoid bank conflicts? + int ROWS_PER_XOR_PATTERN_ = Rows_per_xor_pattern_col_b::VALUE +> +struct Smem_tile_col_b : public Smem_tile_without_skews { + // The MMA tile. + using Mma_tile = fmha::Hmma_tile; + // The base class. + using Base = Smem_tile_without_skews; + // The fragment. + using Fragment = Fragment_b< Col>; + + // When we use padding to reach a power of two, special care has to be taken. + using Cta_tile_with_padding = Cta_tile_with_k_with_padding< Cta_tile>; + // The number of MMAs. + using Mma_tile_with_padding = fmha::Hmma_tile; + + // The size of a single LDS in bytes. + enum { BYTES_PER_LDS = 16 }; + + // The number of STS per thread + enum { STS_PER_THREAD_ = Base::ROWS * Base::THREADS_PER_ROW / Cta_tile::THREADS_PER_CTA }; + // The number of STS per thread must be at least 1. + enum { STS_PER_THREAD = Max<1, STS_PER_THREAD_>::VALUE }; + + // Ctor. + inline __device__ Smem_tile_col_b(void *smem, int tidx) : Base(smem, tidx) { + + // For documentation on the layout, see doc/mma_smem_layout.xlsx. + + // The number of warps. + const int WARPS_M = Cta_tile::WARPS_M; + const int WARPS_N = Cta_tile::WARPS_N; + const int WARPS_K = Cta_tile::WARPS_K; + static_assert(Base::ROWS_PER_XOR_PATTERN == 8); + static_assert(WARPS_M == 1); + static_assert(WARPS_N == 4 || WARPS_N == 8); + static_assert(WARPS_K == 1); + + // The masks to select the warps. + const int WARP_MASK_N = Warp_masks::N; + + // The divisor for the warps. + const int WARP_DIV_N = WARPS_M * 1 * Cta_tile::THREADS_PER_WARP; + + // The row and column read by the thread. + int smem_read_row = (tidx & WARP_MASK_N) / WARP_DIV_N * Mma_tile::N_PER_MMA + + (tidx & 0x07) + + (tidx & 0x10) / 2; + int smem_read_col = (tidx & 0x07); + smem_read_col ^= (tidx & 0x08) / 8; + // The shared memory offset. + this->smem_read_offset_ = smem_read_row*Base::BYTES_PER_ROW + smem_read_col*BYTES_PER_LDS; + } + + // Rewind smem_read_offset for last LDS phase in main loop. + inline __device__ void reverse_smem_read_offset(int ki = 0) { + // Undo the pointer increment for the next ni. + // Should match the load function below for ki = 0. + if( Mma_tile_with_padding::MMAS_K >= 2 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * 2; + } + } + + // Load from shared memory. + inline __device__ void load(Fragment (&b)[Mma_tile::MMAS_N], int ki) { + #pragma unroll + for( int ni = 0; ni < Mma_tile::MMAS_N; ++ni ) { + // Jump by as many matrix rows as needed (a row in smem may pack multiple matrix rows). + int offset = ni * Mma_tile::N_PER_MMA_PER_CTA * Base::BYTES_PER_ROW_BEFORE_PACKING; + + // Load using LDSM.M88.4. + uint4 tmp; + ldsm(tmp, this->smem_ + this->smem_read_offset_ + this->smem_read_buffer_ + offset); + + // Store the value into the fragment. + b[ni].reg(0) = tmp.x; + b[ni].reg(1) = tmp.y; + b[ni].reg(2) = tmp.z; + b[ni].reg(3) = tmp.w; + } + + // Move the offset to the next possition. See doc/mma_smem_layout.xlsx. + static_assert(Mma_tile_with_padding::MMAS_K < 64, "Not implemented"); + if( Mma_tile_with_padding::MMAS_K >= 32 && ki % 16 == 15 ) { + this->smem_read_offset_ ^= 31 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 16 && ki % 8 == 7 ) { + this->smem_read_offset_ ^= 15 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 8 && ki % 4 == 3 ) { + this->smem_read_offset_ ^= 7 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 4 && ki % 2 == 1 ) { + this->smem_read_offset_ ^= 3 * BYTES_PER_LDS * 2; + } else if( Mma_tile_with_padding::MMAS_K >= 2 ) { + this->smem_read_offset_ ^= 1 * BYTES_PER_LDS * 2; + } + } + + // Reset the read offset. + inline __device__ void reset_read_offset() { + // The number of MMAs in the K dimension. + enum { MMAS_K = Mma_tile::MMAS_K }; + // The number of MMAs in the K dimension when we include padding. + enum { MMAS_K_WITH_PADDING = Mma_tile_with_padding::MMAS_K }; + // Assemble the mask. + enum { MASK = Compute_reset_mask::VALUE }; + + // Reset the read offset. + this->smem_read_offset_ ^= MASK * BYTES_PER_LDS * 2; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The size of the STS. + int BYTES_PER_STS, + // The number of buffers per tile. + int BUFFERS_PER_TILE +> +struct Smem_tile_b< Cta_tile, Col, BYTES_PER_STS, BUFFERS_PER_TILE > + : public Smem_tile_col_b { + + // The base class. + using Base = Smem_tile_col_b< Cta_tile, BYTES_PER_STS, BUFFERS_PER_TILE>; + + // Ctor. + inline __device__ Smem_tile_b(void *smem, int tidx) : Base(smem, tidx) { + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +struct Rows_per_xor_pattern_row_b : public Rows_per_xor_pattern_b< N> { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The size of the STS. + int BYTES_PER_STS, + // The number of buffers per tile. + int BUFFERS_PER_TILE, + // How many rows to use for the XOR pattern to avoid bank conflicts? + int ROWS_PER_XOR_PATTERN_ = Rows_per_xor_pattern_row_b::VALUE, + // How many cols to use for the XOR pattern to avoid bank conflicts? + int COLS_PER_XOR_PATTERN_ = 1 +> +struct Smem_tile_row_b : public Smem_tile_without_skews { + + // The MMA tile. + using Mma_tile = fmha::Hmma_tile; + // The base class. + using Base = Smem_tile_without_skews; + // The fragment. + using Fragment = Fragment_b; + + // Can we use LDSM? No if the data type is 32-bit large. + enum { USE_LDSMT = fmha::BITS_PER_ELEMENT_B == 16 }; + // The size of a single LDS in bytes. + enum { BYTES_PER_LDS = USE_LDSMT ? 16 : 4 }; + // The number of elements per LDS. + enum { ELEMENTS_PER_LDS = BYTES_PER_LDS * 8 / fmha::BITS_PER_ELEMENT_B }; + + // The number of STS per thread + enum { STS_PER_THREAD_ = Base::ROWS * Base::THREADS_PER_ROW / Cta_tile::THREADS_PER_CTA }; + // The number of STS per thread must be at least 1. + enum { STS_PER_THREAD = Max<1, STS_PER_THREAD_>::VALUE }; + + // Ctor. + inline __device__ Smem_tile_row_b(void *smem, int tidx) : Base(smem, tidx) { + + // The number of warps. + const int WARPS_M = Cta_tile::WARPS_M; + const int WARPS_N = Cta_tile::WARPS_N; + const int WARPS_K = Cta_tile::WARPS_K; + static_assert(WARPS_K == 1); + static_assert(WARPS_M == 4 || WARPS_M == 8); + static_assert(WARPS_N == 1); + + // The masks to select the warps. + const int WARP_MASK_N = Warp_masks::N; + const int WARP_MASK_K = Warp_masks::K; + + // The divisor for the warps. + const int WARP_DIV_N = WARPS_M * 1 * Cta_tile::THREADS_PER_WARP; + const int WARP_DIV_K = WARPS_M * WARPS_N * Cta_tile::THREADS_PER_WARP; + + // The row/col read by the thread. + int smem_read_row, smem_read_col; + + static_assert(USE_LDSMT); + static_assert(Base::ROWS_PER_XOR_PATTERN == 8); + + smem_read_row = (tidx & WARP_MASK_K) / WARP_DIV_K * Mma_tile::MMAS_K * 16 + + (tidx & 0x07) + (tidx & 0x08); + smem_read_col = (tidx & 0x07); + smem_read_col ^= (tidx & WARP_MASK_N) / WARP_DIV_N * 2 + (tidx & 0x10) / 16; + + // The shared memory offset. + this->smem_read_offset_ = smem_read_row*Base::BYTES_PER_ROW + smem_read_col*BYTES_PER_LDS; + + // Fill zeroes for group conv + } + + // Rewind smem_read_offset for last LDS phase in main loop. + inline __device__ void reverse_smem_read_offset(int ki = 0) { + // The size of each element in bits. + const int BITS_PER_ELT = fmha::BITS_PER_ELEMENT_B; + // The size in bytes of the data needed to compute an MMA per CTA. + const int BYTES_PER_MMA_PER_CTA = Mma_tile::N_PER_MMA_PER_CTA * BITS_PER_ELT / 8; + + #pragma unroll + for( int ni = 0; ni < Mma_tile::MMAS_N; ++ni ) { + // Undo the pointer increment for the next ni. + // Should match the load function below for ki = 0. + if( BYTES_PER_MMA_PER_CTA >= 128 ) { + // Nothing to do! + } else if( BYTES_PER_MMA_PER_CTA == 64 && Mma_tile::MMAS_N > 1 ) { + this->smem_read_offset_ ^= BYTES_PER_MMA_PER_CTA; + } else if( BYTES_PER_MMA_PER_CTA == 64 ) { + // Nothing to do! + } else if( BYTES_PER_MMA_PER_CTA == 32 && Mma_tile::MMAS_N == 4 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * (ni % 2 == 0 ? 2 : 6); + } else if( BYTES_PER_MMA_PER_CTA == 32 && Mma_tile::MMAS_N == 2 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * 2; + } + } + + // Reset smem_read_offset for odd MMAS_N > 1 (npo2 kernels) + if( BYTES_PER_MMA_PER_CTA == 64 && Mma_tile::MMAS_N > 1 && + Mma_tile::MMAS_N % 2 == 1 ) { + this->smem_read_offset_ ^= BYTES_PER_MMA_PER_CTA; + } + } + + // Load from shared memory. + inline __device__ void load(Fragment (&b)[Mma_tile::MMAS_N], int ki) { + // The size of each element in bits. + const int BITS_PER_ELT = fmha::BITS_PER_ELEMENT_B; + // The size in bytes of the data needed to compute an MMA per CTA. + const int BYTES_PER_MMA_PER_CTA = Mma_tile::N_PER_MMA_PER_CTA * BITS_PER_ELT / 8; + + #pragma unroll + for( int ni = 0; ni < Mma_tile::MMAS_N; ++ni ) { + // Prepare the offset. + int offset = ki * Base::ROWS_PER_XOR_PATTERN * 2 * Base::BYTES_PER_ROW; + if ( BYTES_PER_MMA_PER_CTA == 32 ) { + offset += this->smem_read_offset_; + } else if ( BYTES_PER_MMA_PER_CTA == 64 ) { + offset += this->smem_read_offset_ + (ni/2) * BYTES_PER_MMA_PER_CTA * 2; + } else { + offset += this->smem_read_offset_ + (ni ) * BYTES_PER_MMA_PER_CTA; + } + + // Load the data using LDSM.MT88.2. + uint32_t ptr = this->smem_ + this->smem_read_buffer_ + offset; + uint4 tmp; + if( USE_LDSMT ) { + ldsmt(tmp, ptr); + } else { + lds(tmp.x, (ptr ) + 0*Base::BYTES_PER_ROW); + lds(tmp.y, (ptr ) + 4*Base::BYTES_PER_ROW); + lds(tmp.z, (ptr ^ 32) + 0*Base::BYTES_PER_ROW); + lds(tmp.w, (ptr ^ 32) + 4*Base::BYTES_PER_ROW); + } + + // Store those values in the fragment. + b[ni].reg(0) = tmp.x; + b[ni].reg(1) = tmp.y; + b[ni].reg(2) = tmp.z; + b[ni].reg(3) = tmp.w; + + // Move the pointer for the next ni. I expect the compiler to not recompute those. + if( BYTES_PER_MMA_PER_CTA >= 128 ) { + // Nothing to do! + } else if( BYTES_PER_MMA_PER_CTA == 64 && Mma_tile::MMAS_N > 1 ) { + this->smem_read_offset_ ^= BYTES_PER_MMA_PER_CTA; + } else if( BYTES_PER_MMA_PER_CTA == 64 ) { + // Nothing to do! + } else if( BYTES_PER_MMA_PER_CTA == 32 && Mma_tile::MMAS_N == 4 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * (ni % 2 == 0 ? 2 : 6); + } else if( BYTES_PER_MMA_PER_CTA == 32 && Mma_tile::MMAS_N == 2 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * 2; + } + } + + // Reset smem_read_offset for odd MMAS_N > 1 (npo2 kernels) + if( BYTES_PER_MMA_PER_CTA == 64 && Mma_tile::MMAS_N > 1 && + Mma_tile::MMAS_N % 2 == 1 ) { + this->smem_read_offset_ ^= BYTES_PER_MMA_PER_CTA; + } + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + // The dimensions of the tile computed by the CTA. + typename Cta_tile, + // The size of the STS. + int BYTES_PER_STS, + // The number of buffers per tile. + int BUFFERS_PER_TILE +> +struct Smem_tile_b + : public Smem_tile_row_b { + + // The base class. + using Base = Smem_tile_row_b; + + // Ctor. + inline __device__ Smem_tile_b(void *smem, int tidx) : Base(smem, tidx) { + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct Smem_tile_v : public fmha::Smem_tile_without_skews { + + // The base class. + using Base = Smem_tile_without_skews; + // The MMA tile. + using Mma_tile = fmha::Hmma_tile; + // The fragment. + using Fragment = Fragment_b< fmha::Col>; + + // The size of a single LDS in bytes. + enum { BYTES_PER_LDS = 16 }; + + // Ctor. + inline __device__ Smem_tile_v(void *smem, int tidx) : Base(smem, tidx) { + + // The row/col read by the thread. + int read_row, read_col; + + static_assert(Cta_tile::WARPS_M == 1 && Cta_tile::WARPS_N == 1 && (Cta_tile::WARPS_K == 4 || Cta_tile::WARPS_K == 8)); + + read_row = (tidx & 0xe0) / 2 + (tidx & 0x0f); + read_col = (tidx & 0x07); + read_col ^= (tidx & 0x10) / 16; + + // The shared memory offset. + this->smem_read_offset_ = read_row * Base::BYTES_PER_ROW + read_col * BYTES_PER_LDS; + } + + // Load from shared memory. + inline __device__ void load(Fragment (&b)[Mma_tile::MMAS_N], int ki) { +#pragma unroll + for( int ni = 0; ni < Mma_tile::MMAS_N; ++ni ) { + // Jump by 16 * #warps row. + int row = ki * 16 * Cta_tile::WARPS_K; + + // Load the data using LDSM.MT88.2. + uint4 tmp; + fmha::ldsmt(tmp, this->smem_ + this->smem_read_offset_ + row * Base::BYTES_PER_ROW); + b[ni].reg(0) = tmp.x; + b[ni].reg(1) = tmp.y; + b[ni].reg(2) = tmp.z; + b[ni].reg(3) = tmp.w; + + // Move the pointer for the next ni. I expect the compiler to not recompute those. + if( Mma_tile::MMAS_N == 4 ) { + this->smem_read_offset_ ^= BYTES_PER_LDS * (ni % 2 == 0 ? 2 : 6); + } else { + assert(false); // Not implemented! + } + } + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct Smem_tile_o { + + // The MMA tile. + using Mma_tile = fmha::Hmma_tile; + // The accumulators. + using Accumulator = fmha::Fragment_accumulator; + // The accumulators. + using Data_type = typename Accumulator::Data_type; + + // The size of each element. + enum { BYTES_PER_ELEMENT = sizeof(Data_type) }; + // The size of each STS. + enum { BYTES_PER_STS = 8 }; + // The size of each row in shared memory. + enum { BYTES_PER_ROW = Cta_tile::N * Cta_tile::WARPS_K * BYTES_PER_ELEMENT }; + + // The size of each LDS. + enum { BYTES_PER_LDS = 16 }; + enum { THREADS_PER_ROW = 16 }; + + // The number of rows. + enum { ROWS = Cta_tile::M }; + // The number of "rows" to process per loop iteration (in the "epilogue"). + enum { ROWS_PER_LOOP = ROWS <= 64 ? ROWS : (int)Mma_tile::M_PER_MMA_PER_CTA }; + // The number of outer loops. + enum { LOOPS = ROWS / ROWS_PER_LOOP }; + // Make sure it matches our expectations. + static_assert(LOOPS == 1 || LOOPS == (int)Mma_tile::MMAS_M, ""); + + // The number of rows loaded per LDS. + enum { ROWS_PER_LDS = Cta_tile::THREADS_PER_CTA / THREADS_PER_ROW }; + // Do we have to guard against partial writes/reads. + enum { HAS_INCOMPLETE_LDS = ROWS_PER_LOOP % ROWS_PER_LDS != 0 }; + // The total number of LDS per loop. + enum { LDS_PER_LOOP = fmha::Div_up::VALUE }; + + // The amount of shared memory. + enum { BYTES_PER_TILE = ROWS_PER_LOOP * BYTES_PER_ROW }; + + // The write pointer. + uint32_t smem_write_, smem_read_; + // Is the thread active for the last LDS of the series? + int is_active_for_last_lds_; + + static_assert(BYTES_PER_ROW == 64 * 4 * Cta_tile::WARPS_K); + static_assert(LOOPS == 1 || LOOPS == (int)Mma_tile::MMAS_M, ""); + + // Ctor. + inline __device__ Smem_tile_o(void *smem, int tidx) { + + // Get a 32-bit value for the shared memory address. + uint32_t smem_ = __nvvm_get_smem_pointer(smem); + + static_assert(Cta_tile::WARPS_M == 1 && Cta_tile::WARPS_N == 1 && (Cta_tile::WARPS_K == 4 || Cta_tile::WARPS_K == 8)); + + int write_row = (tidx & 0x1c) / 4; + int write_col = (tidx); + + // Assemble the write pointer. + smem_write_ = smem_ + write_row * BYTES_PER_ROW + write_col * BYTES_PER_STS; + + // The element read by each thread. + int read_row = tidx / THREADS_PER_ROW; + int read_col = tidx % THREADS_PER_ROW; + + // Take the XOR pattern into account for the column. + read_col ^= 2 * (read_row & 0x7); + + // Assemble the read pointer. + this->smem_read_ = smem_ + read_row * BYTES_PER_ROW + read_col * BYTES_PER_LDS; + + // Is that thread active on the last LDS? + if( HAS_INCOMPLETE_LDS ) { + this->is_active_for_last_lds_ = read_row + (LDS_PER_LOOP - 1) * ROWS_PER_LDS < Cta_tile::M; + } + } + + // Load the output fragments. + inline __device__ void load(uint4 (&out)[LDS_PER_LOOP]) const { + #pragma unroll + for( int ii = 0; ii < LDS_PER_LOOP; ++ii ) { + + // Load the elements before the reduction (split-K). + uint4 tmp[Cta_tile::WARPS_K]; + #pragma unroll + for( int jj = 0; jj < Cta_tile::WARPS_K; ++jj ) { + int imm = ii * ROWS_PER_LDS * BYTES_PER_ROW + jj * Cta_tile::N * BYTES_PER_ELEMENT; + if( !HAS_INCOMPLETE_LDS || (ii < LDS_PER_LOOP - 1 || this->is_active_for_last_lds_) ) { + fmha::lds(tmp[jj], this->smem_read_ + imm); + } + } + + // Perform the reduction. + out[ii] = tmp[0]; + #pragma unroll + for( int jj = 1; jj < Cta_tile::WARPS_K; ++jj ) { + out[ii] = fmha::fadd4(out[ii], tmp[jj]); + } + } + } + // Store the accumulators. + template + inline __device__ void store(const Accumulator (&acc)[M][N], int mi) { + enum { M_PER_MMA = Mma_tile::M_PER_MMA_PER_CTA }; + #pragma unroll + for( int ni = 0; ni < Mma_tile::MMAS_N; ++ni ) { + + // The number of MMAs that are stored per loop iteration. + enum { MMAS_M_PER_LOOP = Mma_tile::MMAS_M / LOOPS }; + + // Store 1st column of the different MMAs. + #pragma unroll + for( int mj = 0; mj < MMAS_M_PER_LOOP; ++mj ) { + // Precompute the immediates to jump between rows. + int row_0 = (mj * M_PER_MMA + 0) * BYTES_PER_ROW; + int row_1 = (mj * M_PER_MMA + 8) * BYTES_PER_ROW; + uint2 tmp0, tmp1; + tmp0.x = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(0); + tmp0.y = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(1); + + tmp1.x = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(2); + tmp1.y = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(3); + + // Store. + fmha::sts(this->smem_write_ + row_0, tmp0); + fmha::sts(this->smem_write_ + row_1, tmp1); + } + + // Swizzle the write pointer using a XOR of 16B. + this->smem_write_ ^= 32; + + // Store 2nd column of the different MMAs. + #pragma unroll + for( int mj = 0; mj < MMAS_M_PER_LOOP; ++mj ) { + // Precompute the immediates to jump between rows. + int row_0 = (mj * M_PER_MMA + 0) * BYTES_PER_ROW; + int row_1 = (mj * M_PER_MMA + 8) * BYTES_PER_ROW; + + uint2 tmp0, tmp1; + tmp0.x = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(4); + tmp0.y = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(5); + + tmp1.x = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(6); + tmp1.y = acc[mi * MMAS_M_PER_LOOP + mj][ni].reg(7); + // Store. + fmha::sts(this->smem_write_ + row_0, tmp0); + fmha::sts(this->smem_write_ + row_1, tmp1); + } + + // Cancel the previous XOR of 1 + swizzle the write pointer using a XOR of 32B or 64B. + this->smem_write_ ^= (ni & 1) ? 7 * 32 : 3 * 32; + } + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct Smem_tile_mma { + + using Mma_tile = fmha::Hmma_tile; + using Fragment = fmha::Fragment_a; + + enum { COLS = Cta_tile::N }; + enum { BYTES_PER_ELT = 2 }; + enum { BYTES_PER_STS = 4 }; + enum { BYTES_PER_ROW = COLS * BYTES_PER_ELT }; // TODO + enum { BYTES_PER_TILE = Cta_tile::M * BYTES_PER_ROW }; + + enum { WARPS_M = Cta_tile::WARPS_M }; + enum { WARPS_N = Cta_tile::WARPS_N }; + enum { WARPS_K = Cta_tile::WARPS_K }; + + static_assert(WARPS_K == 1); + inline __device__ Smem_tile_mma(char *smem, int tidx) { + smem_ = __nvvm_get_smem_pointer(smem); + + int write_col, write_row; + static_assert(WARPS_M == 1 && (WARPS_N == 4 || WARPS_N == 8) || (WARPS_M == 4 || WARPS_N == 8) || WARPS_N == 1); + if( WARPS_M == 1 && (WARPS_N == 4 || WARPS_N == 8) ) { + write_row = (tidx & 0x1c) / 4; + write_col = (tidx & 0xe0) / 4 + (tidx & 0x03); + } else { + write_row = (tidx & 0xe0) / 2 + (tidx & 0x1c) / 4; + write_col = (tidx & 0x03); + } + write_col ^= (write_row & 0x07) * 4; + + write_offset_ = write_row * BYTES_PER_ROW + write_col * BYTES_PER_STS; + } + + template + inline __device__ void store(const uint4 (®s)[M][N]) { + static_assert(COLS == Cta_tile::N); + for( int mi = 0; mi < M; mi++ ) { + for( int ni = 0; ni < N; ni++ ) { + size_t offset = write_offset_ + mi * WARPS_M * 16 * BYTES_PER_ROW + ni * WARPS_N * 16 * BYTES_PER_ELT; + fmha::sts(smem_ + offset + 0 * BYTES_PER_ROW, regs[mi][ni].x); + fmha::sts(smem_ + offset + 8 * BYTES_PER_ROW, regs[mi][ni].z); + offset ^= 4 * BYTES_PER_STS; + fmha::sts(smem_ + offset + 0 * BYTES_PER_ROW, regs[mi][ni].y); + fmha::sts(smem_ + offset + 8 * BYTES_PER_ROW, regs[mi][ni].w); + } + } + } + + uint32_t smem_; + uint32_t write_offset_; + uint32_t warp_m; + uint32_t warp_n; + uint32_t lane; +}; + +template< typename Cta_tile, typename Base = Smem_tile_mma< Cta_tile>> +struct Smem_tile_mma_transposed : public Base { + enum { BYTES_PER_LDS = 16 }; + enum { BYTES_PER_ROW = Base::BYTES_PER_ROW }; + enum { BYTES_PER_ELT = Base::BYTES_PER_ELT }; + enum { WARPS_M = Base::WARPS_M }; + enum { WARPS_N = Base::WARPS_N }; + static_assert(WARPS_M == 1 && (WARPS_N == 4 || WARPS_N == 8)); + using Fragment = typename Base::Fragment; + inline __device__ Smem_tile_mma_transposed(char *smem, int tidx) : Base(smem, tidx) { + + static_assert(WARPS_M == 1 && (WARPS_N == 4 || WARPS_N == 8)); + int read_row, read_col; + read_row = (tidx & 0x0f); + read_col = (tidx & 0xe0) / 16 + (tidx & 0x1c) / 16; + + read_col ^= (read_row & 0x07); + read_offset_ = read_row * BYTES_PER_ROW + read_col * BYTES_PER_LDS; + } + + template + inline __device__ void load(Fragment (&frag)[M][N]) { + static_assert(Base::COLS == Cta_tile::N); + for( int mi = 0; mi < M; mi++ ) { + for( int ni = 0; ni < N; ni++ ) { + size_t offset = read_offset_ + mi * WARPS_M * 16 * BYTES_PER_ROW + ni * WARPS_N * 16 * BYTES_PER_ELT; + uint4 dst; + fmha::ldsmt(dst, this->smem_ + offset); + frag[mi][ni].reg(0) = dst.x; + frag[mi][ni].reg(1) = dst.z; // Fragment A regs col major! + frag[mi][ni].reg(2) = dst.y; + frag[mi][ni].reg(3) = dst.w; + } + } + } + + uint32_t read_offset_; +}; + +template< typename Cta_tile, typename Base = Smem_tile_mma< Cta_tile>> +struct Smem_tile_mma_epilogue : public Base { + enum { BYTES_PER_LDS = 16 }; + enum { BYTES_PER_ROW = Base::BYTES_PER_ROW }; + enum { BYTES_PER_ELT = Base::BYTES_PER_ELT }; + enum { THREADS_PER_ROW = BYTES_PER_ROW / BYTES_PER_LDS }; + static_assert(THREADS_PER_ROW * BYTES_PER_LDS == BYTES_PER_ROW); + enum { ROWS_PER_LDS = Cta_tile::THREADS_PER_CTA / THREADS_PER_ROW }; + enum { NUM_LDS = Cta_tile::M / ROWS_PER_LDS }; + static_assert(NUM_LDS * ROWS_PER_LDS == Cta_tile::M); + enum { WARPS_M = Base::WARPS_M }; + enum { WARPS_N = Base::WARPS_N }; + static_assert((WARPS_M == 4 || WARPS_N == 8) || WARPS_N == 1); + using Fragment = typename Base::Fragment; + + inline __device__ Smem_tile_mma_epilogue(char *smem, int tidx) : Base(smem, tidx) { + const int read_row = tidx / THREADS_PER_ROW; + int read_col = tidx % THREADS_PER_ROW; + read_col ^= (read_row & 0x07); + read_offset_ = read_row * BYTES_PER_ROW + read_col * BYTES_PER_LDS; + } + + inline __device__ void load(uint4 (&data)[NUM_LDS]) { + for( int ii = 0; ii < NUM_LDS; ii++ ) { + size_t offset = read_offset_ + ii * ROWS_PER_LDS * BYTES_PER_ROW; + fmha::lds(data[ii], this->smem_ + offset); + } + } + + template + inline __device__ void store(const uint4 (®s)[M][N]) { + for( int mi = 0; mi < M; mi++ ) { + for( int ni = 0; ni < N; ni++ ) { + size_t offset = (this->write_offset_ ^ (ni * 32)) + mi * WARPS_M * 16 * BYTES_PER_ROW; + fmha::sts(this->smem_ + offset + 0 * BYTES_PER_ROW, regs[mi][ni].x); + fmha::sts(this->smem_ + offset + 8 * BYTES_PER_ROW, regs[mi][ni].z); + offset ^= 4 * Base::BYTES_PER_STS; + fmha::sts(this->smem_ + offset + 0 * BYTES_PER_ROW, regs[mi][ni].y); + fmha::sts(this->smem_ + offset + 8 * BYTES_PER_ROW, regs[mi][ni].w); + } + } + } + + uint32_t read_offset_; +}; + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/softmax.h b/apex/apex/contrib/csrc/fmha/src/fmha/softmax.h new file mode 100644 index 0000000000000000000000000000000000000000..22bf1abdfc2f57889c82b8f63b3b341aff33d591 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/softmax.h @@ -0,0 +1,478 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct Sum_ { + enum { IS_SUM = 1 }; + static inline __device__ float apply(float x, float y) { + return x + y; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct Max_ { + enum { IS_SUM = 0 }; + static inline __device__ float apply(float x, float y) { + return x > y ? x : y; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ float apply_exp_(float x, float max) { + return __expf(x - max); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct Softmax_base { + + // The Mma tile. + using Mma_tile = fmha::Hmma_tile; + + // The number of MMAs in M/N dimensions. + enum { MMAS_M = Mma_tile::MMAS_M }; + enum { MMAS_N = Mma_tile::MMAS_N }; + + // The number of groups of warp such that we have at most 4 warps writing consecutive elements. + enum { GROUPS = fmha::Div_up::VALUE }; + // The number of elements that we are going to store per row. + enum { ELEMENTS_PER_ROW = Cta_tile::WARPS_N / GROUPS }; + // The number of rows. + enum { ROWS = Cta_tile::M * GROUPS }; + // The total number of elements. + enum { ELEMENTS = ROWS * ELEMENTS_PER_ROW }; + + // Ctor. + template + inline __device__ Softmax_base(const Params ¶ms, void *smem, int bidb, int tidx) + : // packed_mask_ptr_(reinterpret_cast(params.packed_mask_ptr)), + smem_(reinterpret_cast(smem)), tidx_(tidx) { + + // Move to the 1st mask loaded by the thread+ tidx; + // packed_mask_ptr_ += bidb * params.packed_mask_stride_in_bytes + tidx * sizeof(uint32_t); + + // Extract the position in the warp. + int warp = tidx / Cta_tile::THREADS_PER_WARP; + int lane = tidx % Cta_tile::THREADS_PER_WARP; + + // Decompose the warp index into M and N. + int warp_m = warp % Cta_tile::WARPS_M; + int warp_n = warp / Cta_tile::WARPS_M; + + // Decompose the warp-n index into group/position-inside-the-group. + int warp_g = warp_n / ELEMENTS_PER_ROW; + int warp_i = warp_n % ELEMENTS_PER_ROW; + + // The location written by the threads. + int write_row = warp_g * (ROWS / GROUPS) + warp_m * Mma_tile::M_PER_MMA + lane / 4; + int write_col = warp_i; + + // Assemble the write pointer. + smem_write_ = &smem_[write_row * ELEMENTS_PER_ROW + write_col]; + + // Assemble the read pointer. + smem_read_ = &smem_[warp_m * Mma_tile::M_PER_MMA + lane / 4]; + } + + template + inline __device__ void apply_mask(const Mask &mask) { + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + #pragma unroll + for( int ii = 0; ii < 2; ++ii ) { + #pragma unroll + for( int ni = 0; ni < MMAS_N; ++ni ) { + #pragma unroll + for( int jj = 0; jj < 4; ++jj ) { + if( !mask.is_valid(mi, ni, ii, jj) ) { + elt_[2 * mi + ii][4 * ni + jj] = -INFINITY; + } + } + } + } + } + } + + // Apply the exp to all the elements. + inline __device__ void apply_exp(const float (&max)[MMAS_M * 2]) { + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + #pragma unroll + for( int ni = 0; ni < MMAS_N * 4; ++ni ) { + elt_[mi][ni] = apply_exp_(elt_[mi][ni], max[mi]); + } + } + } + + // Do a CTA-wide reduction. + template + inline __device__ void reduce_1x4(float (&dst)[MMAS_M * 2]) { + +#if defined(USE_SAME_SUM_ORDER_IN_SOFTMAX_AS_REF_CODE) + if( Functor::IS_SUM ) { + // Apply the summation inside the thread. + float tmp[MMAS_M * 2][2]; + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + tmp[mi][0] = 0.f; + tmp[mi][1] = 0.f; + #pragma unroll + for( int ni = 0; ni < MMAS_N; ++ni ) { + tmp[mi][0] += elt_[mi][4 * ni + 0]; + tmp[mi][0] += elt_[mi][4 * ni + 1]; + tmp[mi][1] += elt_[mi][4 * ni + 2]; + tmp[mi][1] += elt_[mi][4 * ni + 3]; + } + dst[mi] = tmp[mi][0] + tmp[mi][1]; + } + } else +#endif // defined(USE_SAME_SUM_ORDER_IN_SOFTMAX_AS_REF_CODE) + { + // Apply the functor for each row inside a thread. + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + dst[mi] = elt_[mi][0]; + #pragma unroll + for( int ni = 1; ni < MMAS_N * 4; ++ni ) { + dst[mi] = Functor::apply(dst[mi], elt_[mi][ni]); + } + } + } + + // Apply the functor for each row inside each group of 4 threads. + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + dst[mi] = Functor::apply(dst[mi], __shfl_xor_sync(uint32_t(-1), dst[mi], 1)); + __syncwarp(); + dst[mi] = Functor::apply(dst[mi], __shfl_xor_sync(uint32_t(-1), dst[mi], 2)); + __syncwarp(); + } + + // Store the different values. + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + if( tidx_ % 4 == 0 ) { + smem_write_[(mi * Mma_tile::M_PER_MMA_PER_CTA + 0) * ELEMENTS_PER_ROW] = dst[2 * mi + 0]; + smem_write_[(mi * Mma_tile::M_PER_MMA_PER_CTA + 8) * ELEMENTS_PER_ROW] = dst[2 * mi + 1]; + } + } + + // Make sure the values are in shared memory. + __syncthreads(); + + // Load 8 values (one for each warp). The /8 corresponds to /(4*2) where 4 is from the + // float4. + float4 tmp[1]; + if( tidx_ < Cta_tile::M ) { + tmp[0] = reinterpret_cast(&smem_[0 * ELEMENTS / 2])[tidx_]; + } + + // Compute the reduction of those 8 values in a binary-tree fashion. + tmp[0].x = Functor::apply(tmp[0].x, tmp[0].y); + tmp[0].z = Functor::apply(tmp[0].z, tmp[0].w); + tmp[0].x = Functor::apply(tmp[0].x, tmp[0].z); + + // Make sure we can write to shared memory. + __syncthreads(); + + // Store the value back to shared memory. + if( tidx_ < Cta_tile::M ) { + smem_[tidx_] = tmp[0].x; + } + + // Make sure the data is in shared memory. + __syncthreads(); + + // Finally read the values. + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + dst[2 * mi + 0] = smem_read_[mi * Mma_tile::M_PER_MMA_PER_CTA + 0]; + dst[2 * mi + 1] = smem_read_[mi * Mma_tile::M_PER_MMA_PER_CTA + 8]; + } + } + + // Do a CTA-wide reduction. + template + inline __device__ void reduce_1x8(float (&dst)[MMAS_M * 2]) { + +#if defined(USE_SAME_SUM_ORDER_IN_SOFTMAX_AS_REF_CODE) + if( Functor::IS_SUM ) { + // Apply the summation inside the thread. + float tmp[MMAS_M * 2][2]; + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + tmp[mi][0] = 0.f; + tmp[mi][1] = 0.f; + #pragma unroll + for( int ni = 0; ni < MMAS_N; ++ni ) { + tmp[mi][0] += elt_[mi][4 * ni + 0]; + tmp[mi][0] += elt_[mi][4 * ni + 1]; + tmp[mi][1] += elt_[mi][4 * ni + 2]; + tmp[mi][1] += elt_[mi][4 * ni + 3]; + } + dst[mi] = tmp[mi][0] + tmp[mi][1]; + } + } else +#endif // defined(USE_SAME_SUM_ORDER_IN_SOFTMAX_AS_REF_CODE) + { + // Apply the functor for each row inside a thread. + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + dst[mi] = elt_[mi][0]; + #pragma unroll + for( int ni = 1; ni < MMAS_N * 4; ++ni ) { + dst[mi] = Functor::apply(dst[mi], elt_[mi][ni]); + } + } + } + + // Apply the functor for each row inside each group of 4 threads. + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + dst[mi] = Functor::apply(dst[mi], __shfl_xor_sync(uint32_t(-1), dst[mi], 1)); + __syncwarp(); + dst[mi] = Functor::apply(dst[mi], __shfl_xor_sync(uint32_t(-1), dst[mi], 2)); + __syncwarp(); + } + + // Store the different values. + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + if( tidx_ % 4 == 0 ) { + smem_write_[(mi * Mma_tile::M_PER_MMA_PER_CTA + 0) * ELEMENTS_PER_ROW] = dst[2 * mi + 0]; + smem_write_[(mi * Mma_tile::M_PER_MMA_PER_CTA + 8) * ELEMENTS_PER_ROW] = dst[2 * mi + 1]; + } + } + + // Make sure the values are in shared memory. + __syncthreads(); + + // Load 8 values (one for each warp). The /8 corresponds to /(4*2) where 4 is from the + // float4. + float4 tmp[2]; + if( tidx_ < Cta_tile::M ) { + tmp[0] = reinterpret_cast(&smem_[0 * ELEMENTS / 2])[tidx_]; + tmp[1] = reinterpret_cast(&smem_[1 * ELEMENTS / 2])[tidx_]; + } + + // Compute the reduction of those 8 values in a binary-tree fashion. + tmp[0].x = Functor::apply(tmp[0].x, tmp[0].y); + tmp[0].z = Functor::apply(tmp[0].z, tmp[0].w); + tmp[1].x = Functor::apply(tmp[1].x, tmp[1].y); + tmp[1].z = Functor::apply(tmp[1].z, tmp[1].w); + tmp[0].x = Functor::apply(tmp[0].x, tmp[0].z); + tmp[1].x = Functor::apply(tmp[1].x, tmp[1].z); + tmp[0].x = Functor::apply(tmp[0].x, tmp[1].x); + + // Make sure we can write to shared memory. + __syncthreads(); + + // Store the value back to shared memory. + if( tidx_ < Cta_tile::M ) { + smem_[tidx_] = tmp[0].x; + } + + // Make sure the data is in shared memory. + __syncthreads(); + + // Finally read the values. + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + dst[2 * mi + 0] = smem_read_[mi * Mma_tile::M_PER_MMA_PER_CTA + 0]; + dst[2 * mi + 1] = smem_read_[mi * Mma_tile::M_PER_MMA_PER_CTA + 8]; + } + } + + // Do a CTA-wide reduction. + template + inline __device__ void reduce(float (&dst)[MMAS_M * 2]) { + static_assert(Cta_tile::WARPS_M == 1 && (Cta_tile::WARPS_N == 4 || Cta_tile::WARPS_N == 8)); + if( Cta_tile::WARPS_M == 1 && Cta_tile::WARPS_N == 4 ) { + reduce_1x4(dst); + } else if( Cta_tile::WARPS_M == 1 && Cta_tile::WARPS_N == 8 ) { + reduce_1x8(dst); + } else { + assert(false); + } + + // Make sure we are done reading from shared memory. + __syncthreads(); + } + + // Scale all the elements. + inline __device__ void scale(const float (&sum)[MMAS_M * 2]) { + // Precompute the inverse sum to normalize. Without -use_fast_math, it makes a huge deal. + float inv_sum[MMAS_M * 2]; + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + inv_sum[mi] = (sum[mi] == 0.f || sum[mi] != sum[mi]) ? 1.f : 1.f / sum[mi]; + } + + // Update the values. + #pragma unroll + for( int mi = 0; mi < MMAS_M * 2; ++mi ) { + #pragma unroll + for( int ni = 0; ni < MMAS_N * 4; ++ni ) { + elt_[mi][ni] *= inv_sum[mi]; + } + } + } + + // The pointer to the mask. + const char *packed_mask_ptr_; + // Shared memory for the CTA-wide reduction. + float *smem_, *smem_write_, *smem_read_; + // The current thread index. + int tidx_; + // The elements. + float elt_[MMAS_M * 2][MMAS_N * 4]; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct Softmax : public Softmax_base { + + // The base class. + using Base = Softmax_base; + // The fragment. + using Fragment_a = fmha::Fragment_a; + + static_assert(Fragment_a::NUM_REGS == 4); + + // The MMAs. + enum { MMAS_M = Base::MMAS_M }; + enum { MMAS_N = Base::MMAS_N }; + + // The accumulators. + using Accumulator = fmha::Fragment_accumulator; + using Accumulator_out = Fragment; + static_assert(Accumulator_out::NUM_REGS == 4); + + static_assert(std::is_same::value); + + // Ctor. + template + inline __device__ Softmax(const Params ¶ms, void *smem, int bidb, int tidx) + : Base(params, smem, bidb, tidx), params_scale_bmm1_(params.scale_bmm1) { + } + + // Store the tile after softmax. + template + inline __device__ void store(Gmem_tile &gmem_tile) { + Accumulator_out acc[MMAS_M][MMAS_N]; + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + #pragma unroll + for( int ni = 0; ni < MMAS_N; ++ni ) { + + // The elements. + float tmp_00 = this->elt_[2 * mi + 0][4 * ni + 0]; + float tmp_01 = this->elt_[2 * mi + 0][4 * ni + 1]; + float tmp_02 = this->elt_[2 * mi + 0][4 * ni + 2]; + float tmp_03 = this->elt_[2 * mi + 0][4 * ni + 3]; + float tmp_10 = this->elt_[2 * mi + 1][4 * ni + 0]; + float tmp_11 = this->elt_[2 * mi + 1][4 * ni + 1]; + float tmp_12 = this->elt_[2 * mi + 1][4 * ni + 2]; + float tmp_13 = this->elt_[2 * mi + 1][4 * ni + 3]; + + // Transform to accumulators. + acc[mi][ni].reg(0) = fmha::float2_to_half2(tmp_00, tmp_01); + acc[mi][ni].reg(1) = fmha::float2_to_half2(tmp_10, tmp_11); + acc[mi][ni].reg(2) = fmha::float2_to_half2(tmp_02, tmp_03); + acc[mi][ni].reg(3) = fmha::float2_to_half2(tmp_12, tmp_13); + } + } + + // Delegate to the gmem tile to store. + gmem_tile.store(acc); + } + + // Pack the data to a fragment for the next GEMM. + template + inline __device__ void pack(Fragment_a (&dst)[K][M]) const { + #pragma unroll + for( int mi = 0; mi < M; ++mi ) { + #pragma unroll + for( int ki = 0; ki < K; ++ki ) { + + // 1st row - 4 elements per row. + float tmp_00 = this->elt_[2 * mi + 0][4 * ki + 0]; + float tmp_01 = this->elt_[2 * mi + 0][4 * ki + 1]; + float tmp_02 = this->elt_[2 * mi + 0][4 * ki + 2]; + float tmp_03 = this->elt_[2 * mi + 0][4 * ki + 3]; + + // 2nd row - 4 elements per row. + float tmp_10 = this->elt_[2 * mi + 1][4 * ki + 0]; + float tmp_11 = this->elt_[2 * mi + 1][4 * ki + 1]; + float tmp_12 = this->elt_[2 * mi + 1][4 * ki + 2]; + float tmp_13 = this->elt_[2 * mi + 1][4 * ki + 3]; + + // Pack to 4 registers. + dst[ki][mi].reg(0) = fmha::float2_to_half2(tmp_00, tmp_01); + dst[ki][mi].reg(1) = fmha::float2_to_half2(tmp_10, tmp_11); + dst[ki][mi].reg(2) = fmha::float2_to_half2(tmp_02, tmp_03); + dst[ki][mi].reg(3) = fmha::float2_to_half2(tmp_12, tmp_13); + } + } + } + + // Scale FP32 fragments + inline __device__ void unpack(const Accumulator (&acc)[MMAS_M][MMAS_N]) { + const float scalef = reinterpret_cast(this->params_scale_bmm1_); + + #pragma unroll + for( int mi = 0; mi < MMAS_M; ++mi ) { + #pragma unroll + for( int ni = 0; ni < MMAS_N; ++ni ) { + // 1st row - 4 elements per row. + this->elt_[2 * mi + 0][4 * ni + 0] = acc[mi][ni].elt(0) * scalef; + this->elt_[2 * mi + 0][4 * ni + 1] = acc[mi][ni].elt(1) * scalef; + this->elt_[2 * mi + 0][4 * ni + 2] = acc[mi][ni].elt(4) * scalef; + this->elt_[2 * mi + 0][4 * ni + 3] = acc[mi][ni].elt(5) * scalef; + // 2nd row - 4 elements per row. + this->elt_[2 * mi + 1][4 * ni + 0] = acc[mi][ni].elt(2) * scalef; + this->elt_[2 * mi + 1][4 * ni + 1] = acc[mi][ni].elt(3) * scalef; + this->elt_[2 * mi + 1][4 * ni + 2] = acc[mi][ni].elt(6) * scalef; + this->elt_[2 * mi + 1][4 * ni + 3] = acc[mi][ni].elt(7) * scalef; + } + } + } + const uint32_t params_scale_bmm1_; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha/utils.h b/apex/apex/contrib/csrc/fmha/src/fmha/utils.h new file mode 100644 index 0000000000000000000000000000000000000000..2bd03e9b36d78cfe642523c292ffc31a519091f8 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha/utils.h @@ -0,0 +1,953 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include +#include +#include + +extern "C" __device__ uint32_t __nvvm_get_smem_pointer(void *ptr); + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct Row {}; +struct Col {}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int M, bool = (M & (M-1)) == 0 > +struct Next_power_of_two { +}; + +template< int M > +struct Next_power_of_two< M, true > { enum { VALUE = M }; }; +template<> +struct Next_power_of_two< 3, false> { enum { VALUE = 4 }; }; +template<> +struct Next_power_of_two< 5, false> { enum { VALUE = 8 }; }; +template<> +struct Next_power_of_two< 6, false> { enum { VALUE = 8 }; }; +template<> +struct Next_power_of_two< 7, false> { enum { VALUE = 8 }; }; +template<> +struct Next_power_of_two< 9, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 10, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 11, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 12, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 13, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 14, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 15, false> { enum { VALUE = 16 }; }; +template<> +struct Next_power_of_two< 24, false> { enum { VALUE = 32 }; }; +template<> +struct Next_power_of_two< 48, false> { enum { VALUE = 64 }; }; +template<> +struct Next_power_of_two< 80, false> { enum { VALUE = 128 }; }; +template<> +struct Next_power_of_two< 96, false> { enum { VALUE = 128 }; }; +template<> +struct Next_power_of_two<112, false> { enum { VALUE = 128 }; }; +template<> +struct Next_power_of_two<144, false> { enum { VALUE = 256 }; }; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, bool = (N & (N-1)) == 0 > +struct Prev_power_of_two { +}; + +template< int N > +struct Prev_power_of_two< N, true > { enum { VALUE = N }; }; +template<> +struct Prev_power_of_two< 3, false> { enum { VALUE = 2 }; }; +template<> +struct Prev_power_of_two< 5, false> { enum { VALUE = 4 }; }; +template<> +struct Prev_power_of_two< 6, false> { enum { VALUE = 4 }; }; +template<> +struct Prev_power_of_two< 7, false> { enum { VALUE = 4 }; }; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int M, int N > +struct Div_up { + enum { VALUE = (M + N-1) / N }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int A, int B > +struct Max { + enum { VALUE = A >= B ? A : B }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int A, int B, int C > +struct Max_3 { + enum { VALUE = Max::VALUE, C>::VALUE }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int A, int B > +struct Min { + enum { VALUE = A <= B ? A : B }; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int SIZE_IN_BYTES > +struct Uint_from_size_in_bytes { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct Uint_from_size_in_bytes<1> { + using Type = uint8_t; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct Uint_from_size_in_bytes<2> { + using Type = uint16_t; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct Uint_from_size_in_bytes<4> { + using Type = uint32_t; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct Uint_from_size_in_bytes<8> { + using Type = uint2; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct Uint_from_size_in_bytes<16> { + using Type = uint4; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int WARPS_M, int WARPS_N, int WARPS_K > +struct Warp_masks { +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct Warp_masks<8, 1, 1> { enum { M = 0xe0, N = 0x00, K = 0x00 }; }; +template<> +struct Warp_masks<4, 2, 1> { enum { M = 0x60, N = 0x80, K = 0x00 }; }; +template<> +struct Warp_masks<4, 1, 2> { enum { M = 0x60, N = 0x00, K = 0x80 }; }; +template<> +struct Warp_masks<4, 1, 1> { enum { M = 0x60, N = 0x00, K = 0x00 }; }; +template<> +struct Warp_masks<2, 4, 1> { enum { M = 0x20, N = 0xc0, K = 0x00 }; }; +template<> +struct Warp_masks<2, 2, 2> { enum { M = 0x20, N = 0x40, K = 0x80 }; }; +template<> +struct Warp_masks<2, 2, 1> { enum { M = 0x20, N = 0x40, K = 0x00 }; }; +template<> +struct Warp_masks<2, 1, 2> { enum { M = 0x20, N = 0x00, K = 0x40 }; }; +template<> +struct Warp_masks<2, 1, 1> { enum { M = 0x20, N = 0x00, K = 0x00 }; }; +template<> +struct Warp_masks<1, 8, 1> { enum { M = 0x00, N = 0xe0, K = 0x00 }; }; +template<> +struct Warp_masks<1, 4, 2> { enum { M = 0x00, N = 0x60, K = 0x80 }; }; +template<> +struct Warp_masks<1, 4, 1> { enum { M = 0x00, N = 0x60, K = 0x00 }; }; +template<> +struct Warp_masks<1, 2, 2> { enum { M = 0x00, N = 0x20, K = 0x40 }; }; +template<> +struct Warp_masks<1, 2, 1> { enum { M = 0x00, N = 0x20, K = 0x00 }; }; +template<> +struct Warp_masks<1, 1, 4> { enum { M = 0x00, N = 0x00, K = 0x60 }; }; +template<> +struct Warp_masks<1, 1, 2> { enum { M = 0x00, N = 0x00, K = 0x20 }; }; +template<> +struct Warp_masks<1, 1, 1> { enum { M = 0x00, N = 0x00, K = 0x00 }; }; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename T > +inline __device__ __host__ T div_up(T m, T n) { + return (m + n-1) / n; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline int clz(int x) { + for( int i = 31; i >= 0; --i ) { + if( (1 << i) & x ) { + return 31 - i; + } + } + return 32; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline int find_log_2(int x, bool round_up = false) { + int a = 31 - clz(x); + if( round_up ) { + a += (x & (x-1)) ? 1 : 0; + } + return a; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hadd2(uint32_t a, uint32_t b) { + uint32_t c; + asm volatile("add.f16x2 %0, %1, %2;\n" : "=r"(c) : "r"(a), "r"(b)); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hmin2(uint32_t a, uint32_t b) { + uint32_t c; + asm volatile("min.f16x2 %0, %1, %2;" : "=r"(c) : "r"(a), "r"(b)); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hmul2(uint32_t a, uint32_t b) { + uint32_t c; + asm volatile("mul.f16x2 %0, %1, %2;\n" : "=r"(c) : "r"(a), "r"(b)); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint2 hmul4(uint2 a, uint2 b) { + uint2 c; + c.x = hmul2(a.x, b.x); + c.y = hmul2(a.y, b.y); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint4 hmul8(uint4 a, uint4 b) { + uint4 c; + c.x = hmul2(a.x, b.x); + c.y = hmul2(a.y, b.y); + c.z = hmul2(a.z, b.z); + c.w = hmul2(a.w, b.w); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint4 hmul8(uint32_t a, uint4 b) { + uint4 c; + c.x = hmul2(a, b.x); + c.y = hmul2(a, b.y); + c.z = hmul2(a, b.z); + c.w = hmul2(a, b.w); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hrelu2(uint32_t x, uint32_t lb = 0) { + uint32_t res; +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 800 + asm volatile( "max.f16x2 %0, %1, %2;\n" : "=r"(res) : "r"(x), "r"(lb)); +#else + const uint32_t zero = 0u; + asm volatile( \ + "{\n" \ + "\t .reg .f16x2 sela;\n" \ + "\t set.gtu.u32.f16x2 sela, %1, %2;\n" \ + "\t and.b32 %0, sela, %1;\n" + "}\n" : "=r"(res) : "r"(x), "r"(zero)); +#endif + return res; +} +static inline __device__ uint32_t habs2(uint32_t x) { + uint32_t res; + asm volatile( "abs.f16x2 %0, %1;\n" : "=r"(res) : "r"(x)); + return res; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +template< typename T > +static inline __device__ T clamp(T x, T lb, T ub) { + return x < lb ? lb : (x > ub ? ub : x); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint16_t clamp_to_zero(uint16_t x) { + uint16_t mask; + asm volatile("set.gtu %0, %1, 0;" : "=h"(mask) : "h"(x)); + return mask & x; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint16_t float_to_half(float f) { + uint16_t h; + asm volatile("cvt.rn.f16.f32 %0, %1;" : "=h"(h) : "f"(f)); + return h; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t float2_to_half2(float a, float b) { + uint32_t c; +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 800 + asm volatile("cvt.rn.f16x2.f32 %0, %1, %2;\n" : "=r"(c) : "f"(b), "f"(a)); +#else + uint16_t lo = float_to_half(a); + uint16_t hi = float_to_half(b); + asm volatile("mov.b32 %0, {%1, %2};\n" : "=r"(c) : "h"(lo), "h"(hi)); +#endif + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t float_to_half2(float a) { + return float2_to_half2(a,a); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t float2_to_half2(const float2 &f) { + return float2_to_half2(f.x, f.y); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint2 float4_to_half4(float x, float y, float z, float w) { + uint2 d; + d.x = float2_to_half2(x, y); + d.y = float2_to_half2(z, w); + return d; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hfma2(uint32_t a, uint32_t b, uint32_t c) { + uint32_t d; + asm volatile("fma.rn.f16x2 %0, %1, %2, %3;\n" : "=r"(d) : "r"(a), "r"(b), "r"(c)); + return d; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hfma2_relu(uint32_t a, uint32_t b, uint32_t c) { + uint32_t d; +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 800 + asm volatile("fma.rn.f16x2.relu %0, %1, %2, %3;" : "=r"(d) : "r"(a), "r"(b), "r"(c)); +#else + d = hrelu2(hfma2(a, b, c)); +#endif + return d; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t h0_h0(uint32_t x) { + uint32_t y; + asm volatile("{.reg .f16 lo, hi; mov.b32 {lo, hi}, %1; mov.b32 %0, {lo, lo};}\n" + : "=r"(y) : "r"(x)); + return y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ float h0_to_float(uint32_t h2) { + float f; + asm volatile("{\n" \ + ".reg .f16 lo, hi;\n" \ + "mov.b32 {lo, hi}, %1;\n" \ + "cvt.f32.f16 %0, lo;\n" \ + "}\n" : "=f"(f) : "r"(h2)); + return f; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t h1_h1(uint32_t x) { + uint32_t y; + asm volatile("{.reg .f16 lo, hi; mov.b32 {lo, hi}, %1; mov.b32 %0, {hi, hi};}\n" + : "=r"(y) : "r"(x)); + return y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint16_t hadd(uint16_t a, uint16_t b) { + uint16_t d; + asm volatile("add.f16 %0, %1, %2;" : "=h"(d) : "h"(a), "h"(b)); + return d; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint32_t hadd(uint32_t a, uint32_t b) { + return hadd2(a, b); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint2 hadd4(uint2 a, uint2 b) { + uint2 c; + c.x = hadd2(a.x, b.x); + c.y = hadd2(a.y, b.y); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint2 hadd(uint2 a, uint2 b) { + return hadd4(a, b); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint4 hadd8(uint4 a, uint4 b) { + uint4 c; + c.x = hadd2(a.x, b.x); + c.y = hadd2(a.y, b.y); + c.z = hadd2(a.z, b.z); + c.w = hadd2(a.w, b.w); + return c; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint4 fadd4(uint4 a, uint4 b) { + float4 c; + c.x = reinterpret_cast(a.x) + reinterpret_cast(b.x); + c.y = reinterpret_cast(a.y) + reinterpret_cast(b.y); + c.z = reinterpret_cast(a.z) + reinterpret_cast(b.z); + c.w = reinterpret_cast(a.w) + reinterpret_cast(b.w); + return reinterpret_cast(c); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint4 hadd(uint4 a, uint4 b) { + return hadd8(a, b); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ float half_to_float(uint16_t h) { + float f; + asm volatile("cvt.f32.f16 %0, %1;\n" : "=f"(f) : "h"(h)); + return f; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ float2 half2_to_float2(uint32_t x) { + uint16_t lo, hi; + asm volatile("mov.b32 {%0, %1}, %2;\n" : "=h"(lo), "=h"(hi) : "r"(x)); + return make_float2(half_to_float(lo), half_to_float(hi)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ void half2_to_float2(float &x, float &y, uint32_t h) { + float2 tmp = half2_to_float2(h); + x = tmp.x; + y = tmp.y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint16_t hfma(uint16_t a, uint16_t b, uint16_t c) { + uint16_t d; + asm volatile("fma.rn.f16 %0, %1, %2, %3;" : "=h"(d) : "h"(a), "h"(b), "h"(c)); + return d; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ uint16_t hmul(uint16_t a, uint16_t b) { + uint16_t d; + asm volatile("mul.f16 %0, %1, %2;" : "=h"(d) : "h"(a), "h"(b)); + return d; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline __device__ float sigmoid(float x) { + return 1.f / (1.f + expf(-x)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void clear(uint16_t &dst) { + dst = uint16_t(0); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void clear(uint32_t &dst) { + dst = 0u; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void clear(uint2 &dst) { + dst = make_uint2(0u, 0u); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void clear(uint4 &dst) { + dst = make_uint4(0u, 0u, 0u, 0u); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// P R E D I C A T E P A C K I N G +// +//////////////////////////////////////////////////////////////////////////////////////////////////// +enum { BYTES_PER_REG = 4, PREDS_PER_BYTE = 4, PREDS_PER_REG = BYTES_PER_REG * PREDS_PER_BYTE }; + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// G E N E R I C P R E D I C A T E D L D G S T S +// +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, int M, typename Functor > +inline __device__ void load_(Functor &fct, const uint32_t (&preds)[M]) { + + // The number of complete bytes (where we use all the predicates in a byte). + enum { COMPLETE = N / PREDS_PER_BYTE }; + // Make sure we did allocate enough predicates. + static_assert(Div_up::VALUE <= M, ""); + // The remainder. + enum { REMAINDER = N - COMPLETE * PREDS_PER_BYTE }; + // Make sure we got the math right and the remainder is between 0 and 3. + static_assert(REMAINDER >= 0 && REMAINDER <= 3, ""); + // The mask to extract the predicates. + enum { COMPLETE_MASK = (1 << PREDS_PER_BYTE) - 1 }; + + // Clear the fetch registers. + #pragma unroll + for( int ii = 0; ii < N; ++ii ) { + fct.clear(ii); + } + + // Run complete steps. + bool p[PREDS_PER_BYTE]; + #pragma unroll + for( int ii = 0; ii < COMPLETE; ++ii ) { + + // The predicate. + uint32_t reg = preds[ii / BYTES_PER_REG]; + + // Extract the predicates. + #pragma unroll + for( int jj = 0; jj < PREDS_PER_BYTE; ++jj ) { + uint32_t mask = 1u << (ii % BYTES_PER_REG * 8 + jj); + p[jj] = (reg & mask) != 0u; + } + + // Issue the loads. + #pragma unroll + for( int jj = 0; jj < PREDS_PER_BYTE; ++jj ) { + fct.load(ii * PREDS_PER_BYTE + jj, p[jj]); + } + } + + // Skip the rest of the code if we do not have a remainder. + if( REMAINDER > 0 ) { + + // The mask to extract the predicates. + enum { REMAINDER_MASK = (1 << REMAINDER) - 1 }; + + // The predicate register. + uint32_t reg = preds[COMPLETE / BYTES_PER_REG]; + + // Extract the predicates. + #pragma unroll + for( int jj = 0; jj < PREDS_PER_BYTE; ++jj ) { + uint32_t mask = 1u << (COMPLETE % BYTES_PER_REG * 8 + jj); + p[jj] = (reg & mask) != 0u; + } + + // Issue the loads. + #pragma unroll + for( int ii = 0; ii < REMAINDER; ++ii ) { + fct.load(COMPLETE * PREDS_PER_BYTE + ii, p[ii]); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int M, typename Functor > +inline __device__ void load_(Functor &fct, uint32_t preds) { + uint32_t tmp[1] = { preds }; + load_(fct, tmp); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// L D G +// +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldg(uint8_t &dst, const void *ptr) { + dst = *reinterpret_cast(ptr); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldg(uint16_t &dst, const void *ptr) { + dst = *reinterpret_cast(ptr); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldg(uint32_t &dst, const void *ptr) { + dst = *reinterpret_cast(ptr); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldg(uint2 &dst, const void *ptr) { + dst = *reinterpret_cast(ptr); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldg(uint4 &dst, const void *ptr) { + dst = *reinterpret_cast(ptr); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Data_type, int N > +struct Ldg_functor { + // Ctor. + inline __device__ Ldg_functor(Data_type (&fetch)[N], const void* (&ptrs)[N]) + : fetch_(fetch), ptrs_(ptrs) { + } + + // Clear the element. + inline __device__ void clear(int ii) { + fmha::clear(fetch_[ii]); + } + + // Trigger the loads. + inline __device__ void load(int ii, bool p) { + if( p ) { + ldg(fetch_[ii], ptrs_[ii]); + } + } + + // The fetch registers. + Data_type (&fetch_)[N]; + // The pointers. + const void* (&ptrs_)[N]; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Data_type, int N, int M > +inline __device__ void ldg_(Data_type (&fetch)[N], const void* (&ptrs)[N], uint32_t (&preds)[M]) { + Ldg_functor fct(fetch, ptrs); + load_(fct, preds); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, int M > +inline __device__ void ldg(uint8_t (&fetch)[N], const void* (&ptrs)[N], uint32_t (&preds)[M]) { + ldg_(fetch, ptrs, preds); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, int M > +inline __device__ void ldg(uint16_t (&fetch)[N], const void* (&ptrs)[N], uint32_t (&preds)[M]) { + ldg_(fetch, ptrs, preds); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, int M > +inline __device__ void ldg(uint32_t (&fetch)[N], const void* (&ptrs)[N], uint32_t (&preds)[M]) { + ldg_(fetch, ptrs, preds); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, int M > +inline __device__ void ldg(uint2 (&fetch)[N], const void* (&ptrs)[N], uint32_t (&preds)[M]) { + ldg_(fetch, ptrs, preds); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N, int M > +inline __device__ void ldg(uint4 (&fetch)[N], const void* (&ptrs)[N], uint32_t (&preds)[M]) { + ldg_(fetch, ptrs, preds); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// L D S +// +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void lds(uint16_t &dst, uint32_t ptr) { + asm volatile("ld.shared.b16 %0, [%1];\n" : "=h"(dst) : "r"(ptr)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void lds(uint32_t &dst, uint32_t ptr) { + asm volatile("ld.shared.b32 %0, [%1];\n" : "=r"(dst) : "r"(ptr)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void lds(uint2 &dst, uint32_t ptr) { + asm volatile("ld.shared.v2.b32 {%0, %1}, [%2];\n" : "=r"(dst.x), "=r"(dst.y) : "r"(ptr)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void lds(uint4 &dst, uint32_t ptr) { + asm volatile("ld.shared.v4.b32 {%0, %1, %2, %3}, [%4];\n" + : "=r"(dst.x) + , "=r"(dst.y) + , "=r"(dst.z) + , "=r"(dst.w) + : "r"(ptr)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// L D S M +// +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldsm(uint32_t &dst, uint32_t ptr) { +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 730 + asm volatile("ldmatrix.sync.aligned.m8n8.x1.shared.b16 {%0}, [%1];\n" + : "=r"(dst) : "r"(ptr)); +#endif +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldsmt(uint32_t &dst, uint32_t ptr) { +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 730 + asm volatile("ldmatrix.sync.aligned.m8n8.x1.trans.shared.b16 {%0}, [%1];\n" + : "=r"(dst) : "r"(ptr)); +#endif +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldsm(uint2 &dst, uint32_t ptr) { +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 730 + asm volatile("ldmatrix.sync.aligned.m8n8.x2.shared.b16 {%0, %1}, [%2];\n" + : "=r"(dst.x), "=r"(dst.y) : "r"(ptr)); +#endif +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldsmt(uint2 &dst, uint32_t ptr) { +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 730 + asm volatile("ldmatrix.sync.aligned.m8n8.x2.trans.shared.b16 {%0, %1}, [%2];\n" + : "=r"(dst.x), "=r"(dst.y) : "r"(ptr)); +#endif +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldsm(uint4 &dst, uint32_t ptr) { +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 730 + asm volatile("ldmatrix.sync.aligned.m8n8.x4.shared.b16 {%0, %1, %2, %3}, [%4];\n" + : "=r"(dst.x), "=r"(dst.y), "=r"(dst.z), "=r"(dst.w) : "r"(ptr)); +#endif +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void ldsmt(uint4 &dst, uint32_t ptr) { +#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 730 + asm volatile("ldmatrix.sync.aligned.m8n8.x4.trans.shared.b16 {%0, %1, %2, %3}, [%4];\n" + : "=r"(dst.x), "=r"(dst.y), "=r"(dst.z), "=r"(dst.w) : "r"(ptr)); +#endif +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// S T G +// +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void stg(void *ptr, uint8_t val) { + *reinterpret_cast(ptr) = val; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void stg(void *ptr, uint16_t val) { + *reinterpret_cast(ptr) = val; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void stg(void *ptr, uint32_t val) { + *reinterpret_cast(ptr) = val; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void stg(void *ptr, uint2 val) { + *reinterpret_cast(ptr) = val; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void stg(void *ptr, uint4 val) { + *reinterpret_cast(ptr) = val; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +// +// S T S +// +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void sts(uint32_t ptr, uint16_t val) { + asm volatile("st.shared.b16 [%0], %1;\n" : : "r"(ptr), "h"(val)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void sts(uint32_t ptr, uint32_t val) { + asm volatile("st.shared.b32 [%0], %1;\n" : : "r"(ptr), "r"(val)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void sts(uint32_t ptr, uint2 val) { + asm volatile("st.shared.v2.b32 [%0], {%1, %2};\n" + : + : "r"(ptr) + , "r"(val.x) + , "r"(val.y)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +inline __device__ void sts(uint32_t ptr, uint4 val) { + asm volatile("st.shared.v4.b32 [%0], {%1, %2, %3, %4};\n" + : + : "r"(ptr) + , "r"(val.x) + , "r"(val.y) + , "r"(val.z) + , "r"(val.w)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename Data_type, int N > +inline __device__ void sts_(uint32_t (&ptrs)[N], const Data_type (&data)[N]) { + #pragma unroll + for( int ii = 0; ii < N; ++ii ) { + sts(ptrs[ii], data[ii]); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +inline __device__ void sts(uint32_t (&ptrs)[N], const uint16_t (&data)[N]) { + sts_(ptrs, data); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +inline __device__ void sts(uint32_t (&ptrs)[N], const uint32_t (&data)[N]) { + sts_(ptrs, data); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +inline __device__ void sts(uint32_t (&ptrs)[N], const uint2 (&data)[N]) { + sts_(ptrs, data); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +inline __device__ void sts(uint32_t (&ptrs)[N], const uint4 (&data)[N]) { + sts_(ptrs, data); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_128_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_128_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..bed79b8483e063f9547748c04aefac2adf58b85b --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_128_64_kernel.sm80.cu @@ -0,0 +1,60 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_dgrad_kernel_1xN_reload.h" + +using Kernel_traits = FMHA_kernel_traits< 128, 64, 16, 1, 4, 0x08u>; + +extern "C" __global__ void fmha_dgrad_fp16_128_64_sm80_kernel(Fused_multihead_attention_fprop_params params) { + fmha::compute_dv_1xN(params); + fmha::compute_dq_dk_1xN(params); +} + +void run_fmha_dgrad_fp16_128_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, cudaStream_t stream) { + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + using Smem_tile_s = fmha::Smem_tile_mma_transposed< Kernel_traits::Cta_tile_p>; + constexpr int smem_size_s = Smem_tile_s::BYTES_PER_TILE; + static_assert(smem_size_s == 16 * 128 * 2); + static_assert(smem_size_o == 16 * 64 * 4 * Kernel_traits::Cta_tile_p::WARPS_N); + + constexpr int smem_size_dv = smem_size_s + 2 * smem_size_q + smem_size_v + smem_size_softmax; + constexpr int smem_size_dq_dk = smem_size_s + smem_size_o + smem_size_q + smem_size_v; + constexpr int smem_size = std::max(smem_size_dv, smem_size_dq_dk); + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute( + fmha_dgrad_fp16_128_64_sm80_kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + dim3 grid(params.h, params.b); + fmha_dgrad_fp16_128_64_sm80_kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_256_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_256_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..f93c628cad6f43fff63383d6d5efdce8677f35cc --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_256_64_kernel.sm80.cu @@ -0,0 +1,60 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_dgrad_kernel_1xN_reload.h" + +using Kernel_traits = FMHA_kernel_traits< 256, 64, 16, 1, 4, 0x08u>; + +extern "C" __global__ void fmha_dgrad_fp16_256_64_sm80_kernel(Fused_multihead_attention_fprop_params params) { + fmha::compute_dv_1xN(params); + fmha::compute_dq_dk_1xN(params); +} + +void run_fmha_dgrad_fp16_256_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, cudaStream_t stream) { + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + using Smem_tile_s = fmha::Smem_tile_mma_transposed< Kernel_traits::Cta_tile_p>; + constexpr int smem_size_s = Smem_tile_s::BYTES_PER_TILE; + static_assert(smem_size_s == 16 * 256 * 2); + static_assert(smem_size_o == 16 * 64 * 4 * Kernel_traits::Cta_tile_p::WARPS_N); + + constexpr int smem_size_dv = smem_size_s + 2 * smem_size_q + smem_size_v + smem_size_softmax; + constexpr int smem_size_dq_dk = smem_size_s + smem_size_o + smem_size_q + smem_size_v; + constexpr int smem_size = std::max(smem_size_dv, smem_size_dq_dk); + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute( + fmha_dgrad_fp16_256_64_sm80_kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + dim3 grid(params.h, params.b); + fmha_dgrad_fp16_256_64_sm80_kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_384_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_384_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..ff117f06dbb2737ddf24a914a32ad037313aa119 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_384_64_kernel.sm80.cu @@ -0,0 +1,60 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_dgrad_kernel_1xN_reload.h" + +using Kernel_traits = FMHA_kernel_traits< 384, 64, 16, 1, 8, 0x08u>; + +extern "C" __global__ void fmha_dgrad_fp16_384_64_sm80_kernel(Fused_multihead_attention_fprop_params params) { + fmha::compute_dv_1xN(params); + fmha::compute_dq_dk_1xN(params); +} + +void run_fmha_dgrad_fp16_384_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, cudaStream_t stream) { + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + using Smem_tile_s = fmha::Smem_tile_mma_transposed< Kernel_traits::Cta_tile_p>; + constexpr int smem_size_s = Smem_tile_s::BYTES_PER_TILE; + static_assert(smem_size_s == 16 * 384 * 2); + static_assert(smem_size_o == 16 * 64 * 4 * Kernel_traits::Cta_tile_p::WARPS_N); + + constexpr int smem_size_dv = smem_size_s + 2 * smem_size_q + smem_size_v + smem_size_softmax; + constexpr int smem_size_dq_dk = smem_size_s + smem_size_o + smem_size_q + smem_size_v; + constexpr int smem_size = std::max(smem_size_dv, smem_size_dq_dk); + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute( + fmha_dgrad_fp16_384_64_sm80_kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + dim3 grid(params.h, params.b); + fmha_dgrad_fp16_384_64_sm80_kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_512_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_512_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..58550195984b1bbb3980df6cd29d1028aef790aa --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_512_64_kernel.sm80.cu @@ -0,0 +1,60 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_dgrad_kernel_1xN_reload.h" + +using Kernel_traits = FMHA_kernel_traits< 512, 64, 16, 1, 8, 0x08u>; + +extern "C" __global__ void fmha_dgrad_fp16_512_64_sm80_kernel(Fused_multihead_attention_fprop_params params) { + fmha::compute_dv_1xN(params); + fmha::compute_dq_dk_1xN(params); +} + +void run_fmha_dgrad_fp16_512_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, cudaStream_t stream) { + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + using Smem_tile_s = fmha::Smem_tile_mma_transposed< Kernel_traits::Cta_tile_p>; + constexpr int smem_size_s = Smem_tile_s::BYTES_PER_TILE; + static_assert(smem_size_s == 16 * 512 * 2); + static_assert(smem_size_o == 16 * 64 * 4 * Kernel_traits::Cta_tile_p::WARPS_N); + + constexpr int smem_size_dv = smem_size_s + 2 * smem_size_q + smem_size_v + smem_size_softmax; + constexpr int smem_size_dq_dk = smem_size_s + smem_size_o + smem_size_q + smem_size_v; + constexpr int smem_size = std::max(smem_size_dv, smem_size_dq_dk); + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute( + fmha_dgrad_fp16_512_64_sm80_kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + dim3 grid(params.h, params.b); + fmha_dgrad_fp16_512_64_sm80_kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_kernel_1xN_reload.h b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_kernel_1xN_reload.h new file mode 100644 index 0000000000000000000000000000000000000000..3d4bd229c1dce0a4c36e967f9cfea315e4be74c1 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_dgrad_kernel_1xN_reload.h @@ -0,0 +1,599 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include "fmha_kernel.h" +#include +#include + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +inline __device__ void compute_dv_1xN(const Params ¶ms) { + + // The description of the CTA tile for the 1st batched GEMM. + using Cta_tile_p = typename Kernel_traits::Cta_tile_p; + // The description of the CTA tile for the 2nd batched GEMM. + using Cta_tile_dv = + fmha::Cta_tile_extd; + + static_assert(Cta_tile_dv::M == 512 || Cta_tile_dv::M == 384 || Cta_tile_dv::M == 256 || Cta_tile_dv::M == 128); + static_assert(Cta_tile_dv::N == 64); + static_assert(Cta_tile_dv::K == 16); + + // The MMA tile for the 1st GEMM. + using Mma_tile_p = fmha::Hmma_tile; + // The MMA tile for the 2nd GEMM. + using Mma_tile_dv = fmha::Hmma_tile; + + // The global memory tile to load Q. + using Gmem_tile_q = typename Kernel_traits::Gmem_tile_q; + // The shared memory tile to swizzle Q. + // using Smem_tile_q = typename Kernel_traits::Smem_tile_q; + using Smem_tile_q = fmha::Smem_tile_a; + // The shared memory tile to reload Q as fragment b. + using Smem_tile_qt = fmha::Smem_tile_b; + + // The global memory tile to load K. + using Gmem_tile_k = typename Kernel_traits::Gmem_tile_k; + // The shared memory tile to swizzle K. + using Smem_tile_k = typename Kernel_traits::Smem_tile_k; + + // The global memory tile to load V. + using Gmem_tile_v = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle V. + using Smem_tile_v = typename Kernel_traits::Smem_tile_v; + + // The global memory tile to store O. + using Gmem_tile_o = typename Kernel_traits::Gmem_tile_o; + // The shared memory tile to swizzle O. + using Smem_tile_o = typename Kernel_traits::Smem_tile_o; + + // The global memory tile to store dV. + using Gmem_tile_dv = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle dV. + using Smem_tile_dv = fmha::Smem_tile_mma_epilogue; + static_assert(Smem_tile_dv::NUM_LDS == Gmem_tile_dv::LDGS); + static_assert(Smem_tile_dv::THREADS_PER_ROW == Gmem_tile_dv::THREADS_PER_ROW); + + using Gmem_tile_s = typename Kernel_traits::Gmem_tile_s; + using Smem_tile_st = typename Kernel_traits::Smem_tile_st; + using Gmem_tile_do = typename Kernel_traits::Gmem_tile_do; + + // Shared memory. + extern __shared__ char smem_[]; + + // The block index for the batch. + const int bidb = blockIdx.y; + // The block index for the head. + const int bidh = blockIdx.x; + // The thread index. + const int tidx = threadIdx.x; + + const BlockInfoPadded binfo(params, bidb, bidh, tidx); + if( binfo.stop_early() ) + return; + Mask mask(params, binfo, tidx); + + // Allocate the global memory tile loader for Q. + Gmem_tile_do gmem_q(params, binfo, tidx); // treating dout as Q + // Allocate the shared memory tile loader for Q. + Smem_tile_q smem_q(&smem_[0], tidx); + Smem_tile_qt smem_qt(&smem_[0], tidx); + Smem_tile_st smem_s(&smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE], tidx); + + // Allocate the global memory tile loader for K. + Gmem_tile_k gmem_k(params, 2, binfo, tidx); // treating V as K + // Allocate the shared memory tile loader for K. + Smem_tile_k smem_k(&smem_[Smem_tile_q::BYTES_PER_TILE], tidx); + + // Trigger the loads for Q. + gmem_q.load(smem_q); + // Trigger the loads for K. + gmem_k.load(smem_k); + + // Commit the data for Q and K to shared memory. + gmem_q.commit(smem_q); + gmem_k.commit(smem_k); + + // Make sure the data is in shared memory. + __syncthreads(); + + // Load the fragments for Q. + typename Smem_tile_q::Fragment frag_q[2][Mma_tile_p::MMAS_M]; + smem_q.load(frag_q[0], 0); + + typename Smem_tile_qt::Fragment frag_qt[2][Mma_tile_dv::MMAS_N]; + static_assert(Smem_tile_qt::Fragment::NUM_REGS == 4); + static_assert(Mma_tile_dv::MMAS_K == 1); + smem_qt.load(frag_qt[0], 0); + + // Load the fragments for K. We keep the data in registers during the entire kernel. + typename Smem_tile_k::Fragment frag_k[2][Mma_tile_p::MMAS_N]; + smem_k.load(frag_k[0], 0); + + enum { BITS_PER_ELT_S = sizeof(fmha::A_type) * 8 }; + + Gmem_tile_s gmem_s(params.s_ptr, params, tidx); + + // Create the object to do the softmax. + using Softmax = fmha::Softmax; + Softmax softmax( + params, &smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_st::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE], bidb, tidx); + + enum { THREADS_PER_ROW = 32 }; + enum { M = Mma_tile_p::MMAS_M }; + enum { N = Mma_tile_p::MMAS_N }; + + // Declare the accumulators for the 2nd gemm. + fmha::Fragment_accumulator acc_dv[Mma_tile_dv::MMAS_M][Mma_tile_dv::MMAS_N]; + fmha::Clear_accumulator::apply(acc_dv); + + // Load over the entire sequence length. + for( int loop = 0, outer = 0; loop < Cta_tile_p::N; loop += Cta_tile_p::M, outer++ ) { + if( loop >= binfo.actual_seqlen ) + break; + + // Load S + uint4 s_regs[M][N]; + gmem_s.load(s_regs, mask); + fmha::Fragment_accumulator acc_p[Mma_tile_p::MMAS_M][Mma_tile_p::MMAS_N]; + fmha::Clear_accumulator::apply(acc_p); + // Do this part of P^T = (Q * K^T)^T. + #pragma unroll + for( int ki = 1; ki < Mma_tile_p::MMAS_K; ++ki ) { + // Trigger the load from shared memory for the next series of Q values. + smem_q.load(frag_q[ki & 1], ki); + smem_k.load(frag_k[ki & 1], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_p, frag_q[(ki - 1) & 1], frag_k[(ki - 1) & 1]); + } + + // Store s * dmask to smem for transpose + smem_s.store(s_regs); + + // Declare the accumulators for the 1st gemm. + // Do the final stage of math. + { + int ki = Mma_tile_p::MMAS_K; + fmha::gemm(acc_p, frag_q[(ki - 1) & 1], frag_k[(ki - 1) & 1]); + } + + // Convert from the accumulator type to FP32 for Softmax. + softmax.unpack(acc_p); + + float s_mat[2 * M][4 * N]; + + #pragma unroll + for( int mi = 0; mi < M; mi++ ) { + #pragma unroll + for( int ni = 0; ni < N; ni++ ) { + uint4 &dst = s_regs[mi][ni]; + fmha::half2_to_float2(s_mat[2 * mi + 0][4 * ni + 0], s_mat[2 * mi + 0][4 * ni + 1], dst.x); + fmha::half2_to_float2(s_mat[2 * mi + 0][4 * ni + 2], s_mat[2 * mi + 0][4 * ni + 3], dst.y); + fmha::half2_to_float2(s_mat[2 * mi + 1][4 * ni + 0], s_mat[2 * mi + 1][4 * ni + 1], dst.z); + fmha::half2_to_float2(s_mat[2 * mi + 1][4 * ni + 2], s_mat[2 * mi + 1][4 * ni + 3], dst.w); + } + } + + float d_s[2 * M][4 * N]; + + #pragma unroll + for( int mi = 0; mi < M; mi++ ) { + #pragma unroll + for( int ii = 0; ii < 2; ii++ ) { + #pragma unroll + for( int ni = 0; ni < N; ni++ ) { + #pragma unroll + for( int jj = 0; jj < 4; jj++ ) { + const float s_dmask = s_mat[2 * mi + ii][4 * ni + jj]; + const bool drop = reinterpret_cast(s_dmask) & 0x80000000; + d_s[2 * mi + ii][4 * ni + jj] = drop ? 0.f : softmax.elt_[2 * mi + ii][4 * ni + jj] * params.rp_dropout; + softmax.elt_[2 * mi + ii][4 * ni + jj] = d_s[2 * mi + ii][4 * ni + jj] * fabsf(s_dmask); + } + } + } + } + + float p_sum[2 * M]; + softmax.template reduce(p_sum); + + #pragma unroll + for( int mi = 0; mi < M; mi++ ) { + #pragma unroll + for( int ii = 0; ii < 2; ii++ ) { + #pragma unroll + for( int ni = 0; ni < N; ni++ ) { + #pragma unroll + for( int jj = 0; jj < 4; jj++ ) { + const float scalef = reinterpret_cast(params.scale_softmax); + softmax.elt_[2 * mi + ii][4 * ni + jj] = (d_s[2 * mi + ii][4 * ni + jj] - p_sum[2 * mi + ii]) * + fabsf(s_mat[2 * mi + ii][4 * ni + jj]) * scalef; + } + } + } + } + // Trigger the load for the next Q values. We're using double buffering, so reading qt is safe + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + smem_q.move_to_next_write_buffer(); + gmem_q.move(); + gmem_q.load(smem_q); + } + + typename Smem_tile_st::Fragment frag_s[Mma_tile_dv::MMAS_K][Mma_tile_dv::MMAS_M]; + smem_s.load(frag_s); + for( int ki = 0; ki < Mma_tile_dv::MMAS_K; ki++ ) { + for( int mi = 0; mi < Mma_tile_dv::MMAS_M; mi++ ) { + for( int ii = 0; ii < Smem_tile_st::Fragment::NUM_REGS; ii++ ) { + frag_s[ki][mi].reg(ii) = fmha::hmul2(frag_s[ki][mi].reg(ii), params.scale_dropout); + frag_s[ki][mi].reg(ii) = fmha::hrelu2(frag_s[ki][mi].reg(ii)); + } + } + } + + gmem_s.store(softmax.elt_, mask); + gmem_s.move(); + + #pragma unroll + for( int ki = 1; ki < Mma_tile_dv::MMAS_K; ++ki ) { + // Trigger the load from shared memory for the next series of Q values. + smem_qt.load(frag_qt[ki & 1], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_dv, frag_s[(ki - 1)], frag_qt[(ki - 1) & 1]); + } + + // Do the final stage of math. + { + int ki = Mma_tile_dv::MMAS_K; + fmha::gemm(acc_dv, frag_s[(ki - 1)], frag_qt[(ki - 1) & 1]); + } + // Commit the values for Q into shared memory. + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + gmem_q.commit(smem_q); + } + + // Make sure we are reading from the correct buffer. + smem_q.move_to_next_read_buffer(); + smem_qt.move_to_next_read_buffer(); + + // Make sure the data is in shared memory. + __syncthreads(); + + // Trigger the loads for the values of Q for the next iteration. + smem_q.load(frag_q[0], 0); + smem_k.load(frag_k[0], 0); + smem_qt.load(frag_qt[0], 0); + + } // Outer loop over the sequence length. + + // Epilogue swizzle for dV + Smem_tile_dv smem_dv(&smem_[Kernel_traits::Smem_tile_q::BYTES_PER_TILE], tidx); + uint4 dv[Mma_tile_dv::MMAS_M][Mma_tile_dv::MMAS_N]; + #pragma unroll + for( int mi = 0; mi < Mma_tile_dv::MMAS_M; ++mi ) { + #pragma unroll + for( int ni = 0; ni < Mma_tile_dv::MMAS_N; ++ni ) { + // 1st row - 4 elements per row. + float tmp00 = acc_dv[mi][ni].elt(0); + float tmp01 = acc_dv[mi][ni].elt(1); + float tmp02 = acc_dv[mi][ni].elt(4); + float tmp03 = acc_dv[mi][ni].elt(5); + // 2nd row - 4 elements per row. + float tmp10 = acc_dv[mi][ni].elt(2); + float tmp11 = acc_dv[mi][ni].elt(3); + float tmp12 = acc_dv[mi][ni].elt(6); + float tmp13 = acc_dv[mi][ni].elt(7); + + dv[mi][ni].x = fmha::float2_to_half2(tmp00, tmp01); + dv[mi][ni].y = fmha::float2_to_half2(tmp02, tmp03); + dv[mi][ni].z = fmha::float2_to_half2(tmp10, tmp11); + dv[mi][ni].w = fmha::float2_to_half2(tmp12, tmp13); + } + } + + smem_dv.store(dv); + __syncthreads(); + uint4 dv_out[Smem_tile_dv::NUM_LDS]; + smem_dv.load(dv_out); + Qkv_params dv_params; + dv_params.qkv_ptr = params.dqkv_ptr; + dv_params.qkv_stride_in_bytes = params.qkv_stride_in_bytes; + Gmem_tile_dv gmem_dv(dv_params, 2, binfo, tidx); + gmem_dv.store(dv_out); +} + +template +inline __device__ void compute_dq_dk_1xN(const Params ¶ms) { + + // The description of the CTA tile for the 1st batched GEMM. + using Cta_tile_p = typename Kernel_traits::Cta_tile_p; + using Cta_tile_o = typename Kernel_traits::Cta_tile_o; + // The description of the CTA tile for the 2nd batched GEMM. + using Cta_tile_dk = + fmha::Cta_tile_extd; + static_assert(Cta_tile_dk::M == 512 || Cta_tile_dk::M == 384 || Cta_tile_dk::M == 256 || Cta_tile_dk::M == 128); + static_assert(Cta_tile_dk::N == 64); + static_assert(Cta_tile_dk::K == 16); + + // The MMA tile for the 1st GEMM. + using Mma_tile_p = fmha::Hmma_tile; + using Mma_tile_o = fmha::Hmma_tile; + // The MMA tile for the 2nd GEMM. + using Mma_tile_dk = fmha::Hmma_tile; + + // The global memory tile to load Q. + using Gmem_tile_q = typename Kernel_traits::Gmem_tile_q; + // The shared memory tile to swizzle Q. + using Smem_tile_q = typename Kernel_traits::Smem_tile_q; + + // The global memory tile to load K. + using Gmem_tile_k = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle K. + using Smem_tile_k = typename Kernel_traits::Smem_tile_v; // K is used like V in fprop + + // The global memory tile to load V. + using Gmem_tile_v = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle V. + using Smem_tile_v = typename Kernel_traits::Smem_tile_v; + + // The global memory tile to store O. + // using Gmem_tile_o = typename Kernel_traits::Gmem_tile_o; + using Gmem_tile_o = fmha::Gmem_tile_dq; + // The shared memory tile to swizzle O. + using Smem_tile_o = typename Kernel_traits::Smem_tile_o; + + // The global memory tile to store dK. + using Gmem_tile_dk = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle dK. + using Smem_tile_dk = fmha::Smem_tile_mma_epilogue; + static_assert(Smem_tile_dk::NUM_LDS == Gmem_tile_dk::LDGS); + static_assert(Smem_tile_dk::THREADS_PER_ROW == Gmem_tile_dk::THREADS_PER_ROW); + + // The shared memory tile to reload Q transposed. + using Smem_tile_qt = fmha::Smem_tile_b; + + using Gmem_tile_s = typename Kernel_traits::Gmem_tile_s; + + using Smem_tile_st = typename Kernel_traits::Smem_tile_st; + + + enum { M = Mma_tile_p::MMAS_M }; + enum { N = Mma_tile_p::MMAS_N }; + static_assert(M == Mma_tile_o::MMAS_M); + static_assert(N == Mma_tile_o::MMAS_K); + // Shared memory. + extern __shared__ char smem_[]; + + // The block index for the batch. + const int bidb = blockIdx.y; + // The block index for the head. + const int bidh = blockIdx.x; + // The thread index. + const int tidx = threadIdx.x; + + const BlockInfoPadded binfo(params, bidb, bidh, tidx); + if( binfo.stop_early() ) + return; + + Mask mask(params, binfo, tidx); + + // Allocate the global memory tile loader for Q. + Gmem_tile_q gmem_q(params, 0, binfo, tidx); + // Allocate the shared memory tile loader for Q. + Smem_tile_q smem_q(&smem_[0], tidx); + Smem_tile_qt smem_qt(&smem_[0], tidx); + Smem_tile_st smem_s(&smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE + Smem_tile_o::BYTES_PER_TILE], tidx); + + // Allocate the global memory tile loader for K. + Gmem_tile_k gmem_k(params, 1, binfo, tidx); + // Allocate the shared memory tile loader for K. + Smem_tile_k smem_k(&smem_[Smem_tile_q::BYTES_PER_TILE], tidx); + + // Allocate the global memory tile loader for O. + Gmem_tile_o gmem_o(params, binfo, tidx); + // Allocate the shared memory tile loader for O. We use the same as K so be careful!!! + Smem_tile_o smem_o(&smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE], tidx); + + // Trigger the loads for Q. + gmem_q.load(smem_q); + // Trigger the loads for K. + gmem_k.load(smem_k); + + Gmem_tile_s gmem_s(params.s_ptr, params, tidx); + // Load dP + uint4 s_regs[M][N]; + gmem_s.load(s_regs, mask); + gmem_s.move(); + + // Commit the data for Q and K to shared memory. + gmem_q.commit(smem_q); + gmem_k.commit(smem_k); + + // Make sure the data is in shared memory. + __syncthreads(); + + typename Smem_tile_qt::Fragment frag_qt[2][Mma_tile_dk::MMAS_N]; + smem_qt.load(frag_qt[0], 0); + typename Smem_tile_k::Fragment frag_k[2][Mma_tile_o::MMAS_N]; + smem_k.load(frag_k[0], 0); + + enum { BITS_PER_ELT_S = sizeof(fmha::A_type) * 8 }; + + enum { THREADS_PER_ROW = 32 }; + + // Declare the accumulators for the 2nd gemm. + fmha::Fragment_accumulator acc_dk[Mma_tile_dk::MMAS_M][Mma_tile_dk::MMAS_N]; + fmha::Clear_accumulator::apply(acc_dk); + + // Load over the entire sequence length. + for( int loop = 0, outer = 0; loop < Cta_tile_p::N; loop += Cta_tile_p::M, outer++ ) { + if( loop >= binfo.actual_seqlen ) + break; + + // Pack dP as Fragment_a + fmha::Fragment_a frag_p[Mma_tile_o::MMAS_K][Mma_tile_o::MMAS_M]; + #pragma unroll + for( int mi = 0; mi < M; mi++ ) { + #pragma unroll + for( int ni = 0; ni < N; ni++ ) { + uint4 &dst = s_regs[mi][ni]; + frag_p[ni][mi].reg(0) = dst.x; // row 0, cols 0,1 + frag_p[ni][mi].reg(1) = dst.z; // row 8, cols 0,1 + frag_p[ni][mi].reg(2) = dst.y; // row 0, cols 8,9 + frag_p[ni][mi].reg(3) = dst.w; // row 8, cols 8,9 + } + } + + // Declare the accumulators for the 1st gemm. + fmha::Fragment_accumulator acc_o[Mma_tile_o::MMAS_M][Mma_tile_o::MMAS_N]; + fmha::Clear_accumulator::apply(acc_o); + + // Do this part of O = P^T * V^T. dQ = dP x dK + #pragma unroll + for( int ki = 1; ki < Mma_tile_o::MMAS_K; ++ki ) { + // Trigger the load from shared memory for the next series of Q values. + smem_k.load(frag_k[ki & 1], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_o, frag_p[ki - 1], frag_k[(ki - 1) & 1]); + } + + // Do the final stage of math. + { + int ki = Mma_tile_o::MMAS_K; + fmha::gemm(acc_o, frag_p[ki - 1], frag_k[(ki - 1) & 1]); + } + + // Store dP to smem for transpose + smem_s.store(s_regs); + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + // Load next part of S + gmem_s.load(s_regs, mask); + gmem_s.move(); + smem_q.move_to_next_write_buffer(); + gmem_q.move(); + gmem_q.load(smem_q); + } + // Loop over MMAS_M. + #pragma unroll + for( int ii = 0; ii < Gmem_tile_o::LOOPS; ++ii ) { + + // Swizzle the elements and do the final reduction. + smem_o.store(acc_o, ii); + + // Make sure the data is in shared memory. + __syncthreads(); + + // Load from shared memory. + uint4 out[Gmem_tile_o::STGS_PER_LOOP]; + smem_o.load(out); + + // Make sure the data was read from shared memory. + if( ii < Gmem_tile_o::LOOPS - 1 ) { + __syncthreads(); + } + + // Output the values. + gmem_o.store(out, ii); + } + + // Move to the next part of the output. + gmem_o.move(); + + typename Smem_tile_st::Fragment frag_s[Mma_tile_dk::MMAS_K][Mma_tile_dk::MMAS_M]; + smem_s.load(frag_s); + + #pragma unroll + for( int ki = 1; ki < Mma_tile_dk::MMAS_K; ++ki ) { + // Trigger the load from shared memory for the next series of Q values. + smem_qt.load(frag_qt[ki & 1], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_dk, frag_s[(ki - 1)], frag_qt[(ki - 1) & 1]); + } + + // Do the final stage of math. + { + int ki = Mma_tile_dk::MMAS_K; + fmha::gemm(acc_dk, frag_s[(ki - 1)], frag_qt[(ki - 1) & 1]); + } + + // Commit the values for Q into shared memory. + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + gmem_q.commit(smem_q); + } + + // Make sure the data is in shared memory. + __syncthreads(); + + // Trigger the loads for the values of Q for the next iteration. + smem_qt.load(frag_qt[0], 0); + smem_k.load(frag_k[0], 0); + + } // Outer loop over the sequence length. + + // Epilogue swizzle for dK + Smem_tile_dk smem_dk(&smem_[0], tidx); + uint4 dk[Mma_tile_dk::MMAS_M][Mma_tile_dk::MMAS_N]; + + #pragma unroll + for( int mi = 0; mi < Mma_tile_dk::MMAS_M; ++mi ) { + #pragma unroll + for( int ni = 0; ni < Mma_tile_dk::MMAS_N; ++ni ) { + // 1st row - 4 elements per row. + float tmp00 = acc_dk[mi][ni].elt(0); + float tmp01 = acc_dk[mi][ni].elt(1); + float tmp02 = acc_dk[mi][ni].elt(4); + float tmp03 = acc_dk[mi][ni].elt(5); + // 2nd row - 4 elements per row. + float tmp10 = acc_dk[mi][ni].elt(2); + float tmp11 = acc_dk[mi][ni].elt(3); + float tmp12 = acc_dk[mi][ni].elt(6); + float tmp13 = acc_dk[mi][ni].elt(7); + + dk[mi][ni].x = fmha::float2_to_half2(tmp00, tmp01); + dk[mi][ni].y = fmha::float2_to_half2(tmp02, tmp03); + dk[mi][ni].z = fmha::float2_to_half2(tmp10, tmp11); + dk[mi][ni].w = fmha::float2_to_half2(tmp12, tmp13); + } + } + + smem_dk.store(dk); + __syncthreads(); + uint4 dk_out[Smem_tile_dk::NUM_LDS]; + smem_dk.load(dk_out); + Qkv_params dk_params; + dk_params.qkv_ptr = params.dqkv_ptr; + dk_params.qkv_stride_in_bytes = params.qkv_stride_in_bytes; + Gmem_tile_dk gmem_dk(dk_params, 1, binfo, tidx); + gmem_dk.store(dk_out); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_128_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_128_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..cc325080ca11f1310c362f2e9884a5a236e96ffe --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_128_64_kernel.sm80.cu @@ -0,0 +1,58 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_fprop_kernel_1xN.h" + +using Kernel_traits = FMHA_kernel_traits< 128, 64, 16, 1, 4, 0x08u>; + +extern "C" __global__ void fmha_fprop_fp16_128_64_sm80_train_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +extern "C" __global__ void fmha_fprop_fp16_128_64_sm80_predict_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +void run_fmha_fp16_128_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, bool is_training, cudaStream_t stream) { + + auto kernel = is_training ? &fmha_fprop_fp16_128_64_sm80_train_kernel : &fmha_fprop_fp16_128_64_sm80_predict_kernel; + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + constexpr int smem_size = smem_size_q + std::max(smem_size_v, smem_size_o + smem_size_softmax); + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute(kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + + dim3 grid(params.h, params.b); + kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_256_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_256_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..f3547ccc5c30f99182cd5a31258b5487041c7421 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_256_64_kernel.sm80.cu @@ -0,0 +1,58 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_fprop_kernel_1xN.h" + +using Kernel_traits = FMHA_kernel_traits< 256, 64, 16, 1, 4, 0x08u>; + +extern "C" __global__ void fmha_fprop_fp16_256_64_sm80_train_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +extern "C" __global__ void fmha_fprop_fp16_256_64_sm80_predict_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +void run_fmha_fp16_256_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, bool is_training, cudaStream_t stream) { + + auto kernel = is_training ? &fmha_fprop_fp16_256_64_sm80_train_kernel : &fmha_fprop_fp16_256_64_sm80_predict_kernel; + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + constexpr int smem_size = smem_size_q + std::max(smem_size_v, smem_size_o + smem_size_softmax); + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute(kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + + dim3 grid(params.h, params.b); + kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_384_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_384_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..f29851dfc466c8d83ffc488a84fea14aab1aa185 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_384_64_kernel.sm80.cu @@ -0,0 +1,57 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_fprop_kernel_1xN_reload_v.h" + +using Kernel_traits = FMHA_kernel_traits< 384, 64, 16, 1, 4, 0x08u>; + +extern "C" __global__ void fmha_fprop_fp16_384_64_sm80_train_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +extern "C" __global__ void fmha_fprop_fp16_384_64_sm80_predict_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +void run_fmha_fp16_384_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, bool is_training, cudaStream_t stream) { + + auto kernel = is_training ? &fmha_fprop_fp16_384_64_sm80_train_kernel : &fmha_fprop_fp16_384_64_sm80_predict_kernel; + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + constexpr int smem_size = smem_size_v + smem_size_o + smem_size_softmax; + + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute(kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + + dim3 grid(params.h, params.b); + kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_512_64_kernel.sm80.cu b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_512_64_kernel.sm80.cu new file mode 100644 index 0000000000000000000000000000000000000000..1dad26a0b26d58e25da697fbd037120eef1810d2 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_fp16_512_64_kernel.sm80.cu @@ -0,0 +1,56 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#include "fmha.h" +#include "fmha_fprop_kernel_1xN.h" + +using Kernel_traits = FMHA_kernel_traits< 512, 64, 16, 1, 8, 0x08u>; + +extern "C" __global__ void fmha_fprop_fp16_512_64_sm80_train_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +extern "C" __global__ void fmha_fprop_fp16_512_64_sm80_predict_kernel(Fused_multihead_attention_fprop_params params) { + fmha::device_1xN(params); +} + +void run_fmha_fp16_512_64_sm80(const Fused_multihead_attention_fprop_params ¶ms, bool is_training, cudaStream_t stream) { + + auto kernel = is_training ? &fmha_fprop_fp16_512_64_sm80_train_kernel : &fmha_fprop_fp16_512_64_sm80_predict_kernel; + + constexpr int smem_size_softmax = Kernel_traits::Cta_tile_p::M * Kernel_traits::Cta_tile_p::WARPS_N * sizeof(float); + constexpr int smem_size_q = Kernel_traits::Smem_tile_q::BYTES_PER_TILE; + constexpr int smem_size_v = Kernel_traits::Smem_tile_v::BYTES_PER_TILE; + constexpr int smem_size_o = Kernel_traits::Smem_tile_o::BYTES_PER_TILE; + + constexpr int smem_size = smem_size_q + std::max(smem_size_v, smem_size_o + smem_size_softmax); + if( smem_size >= 48 * 1024 ) { + FMHA_CHECK_CUDA(cudaFuncSetAttribute(kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, smem_size)); + } + dim3 grid(params.h, params.b); + kernel<<>>(params); +} diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_fprop_kernel_1xN.h b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_kernel_1xN.h new file mode 100644 index 0000000000000000000000000000000000000000..b7fbd6ebf089e994fbee661ca2d72125aacadba2 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_kernel_1xN.h @@ -0,0 +1,338 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include "fmha_kernel.h" +#include +#include + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template inline __device__ void device_1xN(const Params ¶ms) { + + // The description of the CTA tile for the 1st batched GEMM. + using Cta_tile_p = typename Kernel_traits::Cta_tile_p; + // The description of the CTA tile for the 2nd batched GEMM. + using Cta_tile_o = typename Kernel_traits::Cta_tile_o; + + // The MMA tile for the 1st GEMM. + using Mma_tile_p = fmha::Hmma_tile; + // The MMA tile for the 2nd GEMM. + using Mma_tile_o = fmha::Hmma_tile; + + // The global memory tile to load Q. + using Gmem_tile_q = typename Kernel_traits::Gmem_tile_q; + // The shared memory tile to swizzle Q. + using Smem_tile_q = typename Kernel_traits::Smem_tile_q; + + // The global memory tile to load K. + using Gmem_tile_k = typename Kernel_traits::Gmem_tile_k; + // The shared memory tile to swizzle K. + using Smem_tile_k = typename Kernel_traits::Smem_tile_k; + + // The global memory tile to load V. + using Gmem_tile_v = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle V. + using Smem_tile_v = typename Kernel_traits::Smem_tile_v; + + // The global memory tile to store O. + using Gmem_tile_o = typename Kernel_traits::Gmem_tile_o; + // The shared memory tile to swizzle O. + using Smem_tile_o = typename Kernel_traits::Smem_tile_o; + + using Gmem_tile_s = typename Kernel_traits::Gmem_tile_s; + + // Shared memory. + extern __shared__ char smem_[]; + + // The block index for the batch. + const int bidb = blockIdx.y; + // The block index for the head. + const int bidh = blockIdx.x; + // The thread index. + const int tidx = threadIdx.x; + + const BlockInfoPadded binfo(params, bidb, bidh, tidx); + if( binfo.stop_early() ) + return; + + auto seeds = at::cuda::philox::unpack(params.philox_args); + + Philox ph(std::get<0>(seeds), binfo.tidx_global, std::get<1>(seeds)); + + Mask mask(params, binfo, tidx); + + // Allocate the global memory tile loader for Q. + Gmem_tile_q gmem_q(params, 0, binfo, tidx); + // Allocate the shared memory tile loader for Q. + Smem_tile_q smem_q(&smem_[0], tidx); + + // Allocate the global memory tile loader for K. + Gmem_tile_k gmem_k(params, 1, binfo, tidx); + // Allocate the shared memory tile loader for K. + Smem_tile_k smem_k(&smem_[Smem_tile_q::BYTES_PER_TILE], tidx); + + // Allocate the global memory tile loader for V. + Gmem_tile_v gmem_v(params, 2, binfo, tidx); + // The base pointer of smem_v; + char *smem_v_ = nullptr; + if( Kernel_traits::SHARE_SMEM_FOR_K_AND_V ) { + smem_v_ = &smem_[Smem_tile_q::BYTES_PER_TILE]; + } else { + smem_v_ = &smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE]; + } + // Allocate the shared memory tile loader for V. We use the same as K so be careful!!! + Smem_tile_v smem_v(smem_v_, tidx); + + // Allocate the global memory tile loader for O. + Gmem_tile_o gmem_o(params, binfo, tidx); + // Allocate the shared memory tile loader for O. We use the same as K so be careful!!! + Smem_tile_o smem_o(&smem_[Smem_tile_q::BYTES_PER_TILE], tidx); + + // Trigger the loads for Q. + gmem_q.load(smem_q); + // Trigger the loads for K. + gmem_k.load(smem_k); + // Trigger the loads for K. + gmem_v.load(smem_v); + + // Commit the data for Q and K to shared memory. + gmem_q.commit(smem_q); + gmem_k.commit(smem_k); + + // Commit the data for V to shared memory. + if( !Kernel_traits::SHARE_SMEM_FOR_K_AND_V ) { + gmem_v.commit(smem_v); + } + + // Make sure the data is in shared memory. + __syncthreads(); + + // Load the fragments for Q. + typename Smem_tile_q::Fragment frag_q[2][Mma_tile_p::MMAS_M]; + smem_q.load(frag_q[0], 0); + + // Load the fragments for K. We keep the data in registers during the entire kernel. + typename Smem_tile_k::Fragment frag_k[Mma_tile_p::MMAS_K][Mma_tile_p::MMAS_N]; + #pragma unroll + for( int ki = 0; ki < Mma_tile_p::MMAS_K; ++ki ) { + smem_k.load(frag_k[ki], ki); + } + + // Commit the data for V to shared memory if it has not been done already. + if( Kernel_traits::SHARE_SMEM_FOR_K_AND_V ) { + // Make sure we are done loading the fragments for K. + __syncthreads(); + + // Commit the data to shared memory for V. + gmem_v.commit(smem_v); + + // Make sure the data is in shared memory. + __syncthreads(); + } + + // Load the fragments for V. We keep the data in registers during the entire kernel. + typename Smem_tile_v::Fragment frag_v[Mma_tile_o::MMAS_K][Mma_tile_o::MMAS_N]; + #pragma unroll + for( int ki = 0; ki < Mma_tile_o::MMAS_K; ++ki ) { + smem_v.load(frag_v[ki], ki); + } + + enum { BITS_PER_ELT_S = sizeof(fmha::A_type) * 8 }; + + Gmem_tile_s gmem_s(params.s_ptr, params, tidx); + + // Create the object to do the softmax. + using Softmax = fmha::Softmax< Cta_tile_p, Kernel_traits>; + Softmax softmax(params, &smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_o::BYTES_PER_TILE], bidb, tidx); + + enum { THREADS_PER_ROW = 32 }; + + // Load over the entire sequence length. + for( int loop = 0, outer = 0; loop < Cta_tile_p::N; loop += Cta_tile_p::M, outer++ ) { + if( loop >= binfo.actual_seqlen ) + break; + + // Declare the accumulators for the 1st gemm. + fmha::Fragment_accumulator acc_p[Mma_tile_p::MMAS_M][Mma_tile_p::MMAS_N]; + fmha::Clear_accumulator::apply(acc_p); + + // Do this part of P^T = (Q * K^T)^T. + #pragma unroll + for( int ki = 1; ki < Mma_tile_p::MMAS_K; ++ki ) { + + // Trigger the load from shared memory for the next series of Q values. + smem_q.load(frag_q[ki & 1], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_p, frag_q[(ki - 1) & 1], frag_k[(ki - 1)]); + } + + // Do the final stage of math. + { + int ki = Mma_tile_p::MMAS_K; + fmha::gemm(acc_p, frag_q[(ki - 1) & 1], frag_k[(ki - 1)]); + } + + // Store the P matrix. +#if defined(STORE_P) + gmem_p.store(acc_p); +#endif + // Load the mask for that iteration. + mask.load(outer); + + // Convert from the accumulator type to FP32 for Softmax. + softmax.unpack(acc_p); + + // Apply the mask. + softmax.apply_mask(mask); + + if( Kernel_traits::SHARE_SMEM_FOR_K_AND_V && loop == 0 ) { + // if we share K and V, it could be that V was not fully read yet but we write into smem for reduction + __syncthreads(); + } + // Compute the max. + float p_max[Mma_tile_p::MMAS_M * 2]; + softmax.template reduce(p_max); + + // Make sure we are done reading shared memory. + __syncthreads(); + + // Compute the exponential value. + softmax.apply_exp(p_max); + + // Compute the sum. + float p_sum[Mma_tile_p::MMAS_M * 2]; + softmax.template reduce(p_sum); + + // Finalize softmax on the accumulators of P^T. + softmax.scale(p_sum); + + if( Is_training ) { + auto encode_dropout = [](bool keep, float val) { return keep ? val : -val; }; + #pragma unroll + for( int mi = 0; mi < Mma_tile_p::MMAS_M; mi++ ) { + #pragma unroll + for( int ii = 0; ii < 2; ii++ ) { + #pragma unroll + for( int ni = 0; ni < Mma_tile_p::MMAS_N; ni++ ) { + float4 tmp = uniform4(ph()); + // We encode the dropout pattern in the sign bit of the non-negative softmax to distinguish from + // pre-existing zeros + softmax.elt_[2 * mi + ii][4 * ni + 0] = + encode_dropout(tmp.x <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 0]); + softmax.elt_[2 * mi + ii][4 * ni + 1] = + encode_dropout(tmp.y <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 1]); + softmax.elt_[2 * mi + ii][4 * ni + 2] = + encode_dropout(tmp.z <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 2]); + softmax.elt_[2 * mi + ii][4 * ni + 3] = + encode_dropout(tmp.w <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 3]); + } + } + } + gmem_s.store(softmax.elt_, mask); + gmem_s.move(); + } + + // Trigger the load for the next Q values. + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + smem_q.move_to_next_write_buffer(); + gmem_q.move(); + gmem_q.load(smem_q); + } + + using Frag_p = fmha::Fragment_a< fmha::Row>; + Frag_p frag_p[Mma_tile_o::MMAS_K][Mma_tile_o::MMAS_M]; + softmax.pack(frag_p); + #pragma unroll + for( int ki = 0; ki < Mma_tile_o::MMAS_K; ki++ ) { + #pragma unroll + for( int mi = 0; mi < Mma_tile_o::MMAS_M; mi++ ) { + #pragma unroll + for( int ii = 0; ii < Frag_p::NUM_REGS; ii++ ) { + //"Apply" the dropout. + frag_p[ki][mi].reg(ii) = fmha::hmul2(frag_p[ki][mi].reg(ii), params.scale_dropout); + frag_p[ki][mi].reg(ii) = fmha::hrelu2(frag_p[ki][mi].reg(ii)); + } + } + } + + // Declare the accumulators for the 1st gemm. + fmha::Fragment_accumulator acc_o[Mma_tile_o::MMAS_M][Mma_tile_o::MMAS_N]; + fmha::Clear_accumulator::apply(acc_o); + + // Do this part of O = P^T * V^T. + #pragma unroll + for( int ki = 0; ki < Mma_tile_o::MMAS_K; ++ki ) { + fmha::gemm(acc_o, frag_p[ki], frag_v[ki]); + } + + // Loop over MMAS_M. + #pragma unroll + for( int ii = 0; ii < Gmem_tile_o::LOOPS; ++ii ) { + + // Swizzle the elements and do the final reduction. + smem_o.store(acc_o, ii); + + // Make sure the data is in shared memory. + __syncthreads(); + + // Load from shared memory. + uint4 out[Gmem_tile_o::STGS_PER_LOOP]; + smem_o.load(out); + + // Make sure the data was read from shared memory. + if( ii < Gmem_tile_o::LOOPS - 1 ) { + __syncthreads(); + } + + // Output the values. + gmem_o.store(out, ii); + } + + // Move to the next part of the output. + gmem_o.move(); + + // Commit the values for Q into shared memory. + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + gmem_q.commit(smem_q); + } + + // Make sure the data is in shared memory. + __syncthreads(); + + // Trigger the loads for the values of Q for the next iteration. + smem_q.load(frag_q[0], 0); + + } // Outer loop over the sequence length. +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_fprop_kernel_1xN_reload_v.h b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_kernel_1xN_reload_v.h new file mode 100644 index 0000000000000000000000000000000000000000..50fd43f6beaafa6fc5930f8f8f267812d83df589 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_fprop_kernel_1xN_reload_v.h @@ -0,0 +1,322 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include "fmha_kernel.h" +#include +#include + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template inline __device__ void device_1xN(const Params ¶ms) { + + // The description of the CTA tile for the 1st batched GEMM. + using Cta_tile_p = typename Kernel_traits::Cta_tile_p; + // The description of the CTA tile for the 2nd batched GEMM. + using Cta_tile_o = typename Kernel_traits::Cta_tile_o; + + // The MMA tile for the 1st GEMM. + using Mma_tile_p = fmha::Hmma_tile; + // The MMA tile for the 2nd GEMM. + using Mma_tile_o = fmha::Hmma_tile; + + // The global memory tile to load Q. + using Gmem_tile_q = typename Kernel_traits::Gmem_tile_q; + // The shared memory tile to swizzle Q. + using Smem_tile_q = typename Kernel_traits::Smem_tile_q; + + // The global memory tile to load K. + using Gmem_tile_k = typename Kernel_traits::Gmem_tile_k; + // The shared memory tile to swizzle K. + using Smem_tile_k = typename Kernel_traits::Smem_tile_k; + + // The global memory tile to load V. + using Gmem_tile_v = typename Kernel_traits::Gmem_tile_v; + // The shared memory tile to swizzle V. + using Smem_tile_v = typename Kernel_traits::Smem_tile_v; + + // The global memory tile to store O. + using Gmem_tile_o = typename Kernel_traits::Gmem_tile_o; + // The shared memory tile to swizzle O. + using Smem_tile_o = typename Kernel_traits::Smem_tile_o; + + using Gmem_tile_s = typename Kernel_traits::Gmem_tile_s; + + // Shared memory. + extern __shared__ char smem_[]; + + // The block index for the batch. + const int bidb = blockIdx.y; + // The block index for the head. + const int bidh = blockIdx.x; + // The thread index. + const int tidx = threadIdx.x; + + const BlockInfoPadded binfo(params, bidb, bidh, tidx); + if( binfo.stop_early() ) + return; + + Mask mask(params, binfo, tidx); + + auto seeds = at::cuda::philox::unpack(params.philox_args); + Philox ph(std::get<0>(seeds), binfo.tidx_global, std::get<1>(seeds)); + + static_assert(2 * Mma_tile_p::MMAS_M * 4 * Mma_tile_p::MMAS_N <= 64); + + // Allocate the global memory tile loader for K. + Gmem_tile_k gmem_k(params, 1, binfo, tidx); + // Allocate the shared memory tile loader for K. + Smem_tile_k smem_k(&smem_[0], tidx); + + // Allocate the global memory tile loader for V. + Gmem_tile_v gmem_v(params, 2, binfo, tidx); + // The base pointer of smem_v; + char *smem_v_ = nullptr; + if( Kernel_traits::SHARE_SMEM_FOR_K_AND_V ) { + smem_v_ = &smem_[0]; + } else { + smem_v_ = &smem_[Smem_tile_q::BYTES_PER_TILE + Smem_tile_k::BYTES_PER_TILE]; + } + static_assert(Kernel_traits::SHARE_SMEM_FOR_K_AND_V); + static_assert(Smem_tile_k::BYTES_PER_TILE == Smem_tile_v::BYTES_PER_TILE); + // Allocate the shared memory tile loader for V. We use the same as K so be careful!!! + Smem_tile_v smem_v(smem_v_, tidx); + + // Allocate the global memory tile loader for Q. + Gmem_tile_q gmem_q(params, 0, binfo, tidx); + // Allocate the shared memory tile loader for Q. + Smem_tile_q smem_q(&smem_[Smem_tile_v::BYTES_PER_TILE], tidx); + + // Allocate the global memory tile loader for O. + Gmem_tile_o gmem_o(params, binfo, tidx); + // Allocate the shared memory tile loader for O. We use the same as K so be careful!!! + Smem_tile_o smem_o(&smem_[Smem_tile_v::BYTES_PER_TILE], tidx); + + // Trigger the loads for Q. + gmem_q.load(smem_q); + // Trigger the loads for K. + gmem_k.load(smem_k); + // Trigger the loads for K. + gmem_v.load(smem_v); + + + // Commit the data for Q and K to shared memory. + gmem_q.commit(smem_q); + gmem_k.commit(smem_k); + + // Commit the data for V to shared memory. + if( !Kernel_traits::SHARE_SMEM_FOR_K_AND_V ) { + gmem_v.commit(smem_v); + } + + // Make sure the data is in shared memory. + __syncthreads(); + + // Load the fragments for Q. + typename Smem_tile_q::Fragment frag_q[1][Mma_tile_p::MMAS_M]; + + // Load the fragments for K. We keep the data in registers during the entire kernel. + typename Smem_tile_k::Fragment frag_k[Mma_tile_p::MMAS_K][Mma_tile_p::MMAS_N]; + #pragma unroll + for( int ki = 0; ki < Mma_tile_p::MMAS_K; ++ki ) { + smem_k.load(frag_k[ki], ki); + } + + // Commit the data for V to shared memory if it has not been done already. + if( Kernel_traits::SHARE_SMEM_FOR_K_AND_V ) { + // Make sure we are done loading the fragments for K. + __syncthreads(); + + // Commit the data to shared memory for V. + gmem_v.commit(smem_v); + + } + + enum { BITS_PER_ELT_S = sizeof(typename fmha::A_type) * 8 }; + + Gmem_tile_s gmem_s(params.s_ptr, params, tidx); + + // Create the object to do the softmax. + using Softmax = fmha::Softmax< Cta_tile_p, Kernel_traits>; + Softmax softmax(params, &smem_[Smem_tile_v::BYTES_PER_TILE + Smem_tile_o::BYTES_PER_TILE], bidb, tidx); + + constexpr int SMEM_BYTES_SOFTMAX = Softmax::ELEMENTS * sizeof(float); + static_assert(SMEM_BYTES_SOFTMAX == Cta_tile_p::M * Cta_tile_p::WARPS_N * sizeof(float)); + + enum { THREADS_PER_ROW = 32 }; + + const float pinv = 1.f / params.p_dropout; + + // Load over the entire sequence length. + for( int loop = 0, outer = 0; loop < Cta_tile_p::N; loop += Cta_tile_p::M, outer++ ) { + if( loop >= binfo.actual_seqlen ) + break; + + // Declare the accumulators for the 1st gemm. + fmha::Fragment_accumulator acc_p[Mma_tile_p::MMAS_M][Mma_tile_p::MMAS_N]; + fmha::Clear_accumulator::apply(acc_p); + #pragma unroll + for( int ki = 0; ki < Mma_tile_p::MMAS_K; ++ki ) { + + // Trigger the load from shared memory for the next series of Q values. + smem_q.load(frag_q[0], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_p, frag_q[0], frag_k[ki]); + } + + // Load the mask for that iteration. + mask.load(outer); + + // Convert from the accumulator typ e to FP32 for Softmax. + softmax.unpack(acc_p); + + // Apply the mask. + softmax.apply_mask(mask); + + static_assert(2 * Mma_tile_p::MMAS_M * 4 * Mma_tile_p::MMAS_N <= 64); + + // Compute the max. + float p_max[Mma_tile_p::MMAS_M * 2]; + softmax.template reduce(p_max); + + // Make sure we are done reading shared memory. + __syncthreads(); + // Compute the exponential value. + softmax.apply_exp(p_max); + // Compute the sum. + float p_sum[Mma_tile_p::MMAS_M * 2]; + softmax.template reduce(p_sum); + + // Finalize softmax on the accumulators of P^T. + softmax.scale(p_sum); + + __syncthreads(); + if( Is_training ) { + auto encode_dropout = [](bool keep, float val) { return keep ? val : -val; }; + #pragma unroll + for( int mi = 0; mi < Mma_tile_p::MMAS_M; mi++ ) { + #pragma unroll + for( int ii = 0; ii < 2; ii++ ) { + #pragma unroll + for( int ni = 0; ni < Mma_tile_p::MMAS_N; ni++ ) { + float4 tmp = uniform4(ph()); + // We encode the dropout pattern in the sign bit of the non-negative softmax to distinguish from + // pre-existing zeros + softmax.elt_[2 * mi + ii][4 * ni + 0] = + encode_dropout(tmp.x <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 0]); + softmax.elt_[2 * mi + ii][4 * ni + 1] = + encode_dropout(tmp.y <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 1]); + softmax.elt_[2 * mi + ii][4 * ni + 2] = + encode_dropout(tmp.z <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 2]); + softmax.elt_[2 * mi + ii][4 * ni + 3] = + encode_dropout(tmp.w <= params.p_dropout, softmax.elt_[2 * mi + ii][4 * ni + 3]); + } + } + } + + gmem_s.store(softmax.elt_, mask); + gmem_s.move(); + } + + // Trigger the load for the next Q values. + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + smem_q.move_to_next_write_buffer(); + gmem_q.move(); + gmem_q.load(smem_q); + } + typename Smem_tile_v::Fragment frag_v[1][Mma_tile_o::MMAS_N]; + + using Frag_p = fmha::Fragment_a< fmha::Row>; + Frag_p frag_p[Mma_tile_o::MMAS_K][Mma_tile_o::MMAS_M]; + softmax.pack(frag_p); + #pragma unroll + for( int ki = 0; ki < Mma_tile_o::MMAS_K; ki++ ) { + #pragma unroll + for( int mi = 0; mi < Mma_tile_o::MMAS_M; mi++ ) { + #pragma unroll + for( int ii = 0; ii < Frag_p::NUM_REGS; ii++ ) { + //"Apply" the dropout. + frag_p[ki][mi].reg(ii) = fmha::hmul2(frag_p[ki][mi].reg(ii), params.scale_dropout); + frag_p[ki][mi].reg(ii) = fmha::hrelu2(frag_p[ki][mi].reg(ii)); + } + } + } + + // Declare the accumulators for the 1st gemm. + fmha::Fragment_accumulator acc_o[Mma_tile_o::MMAS_M][Mma_tile_o::MMAS_N]; + fmha::Clear_accumulator::apply(acc_o); + + #pragma unroll + for( int ki = 0; ki < Mma_tile_o::MMAS_K; ++ki ) { + // Trigger the load from shared memory for the next series of V values. + smem_v.load(frag_v[0], ki); + // Do the math for the values already in registers. + fmha::gemm(acc_o, frag_p[ki], frag_v[0]); + } + + // Loop over MMAS_M. + #pragma unroll + for( int ii = 0; ii < Gmem_tile_o::LOOPS; ++ii ) { + + // Swizzle the elements and do the final reduction. + smem_o.store(acc_o, ii); + + // Make sure the data is in shared memory. + __syncthreads(); + + // Load from shared memory. + uint4 out[Gmem_tile_o::STGS_PER_LOOP]; + smem_o.load(out); + + // Always sync after last iter: shared smem_q and smem_o! + __syncthreads(); + + // Output the values. + gmem_o.store(out, ii); + } + // same smem as o + + // Move to the next part of the output. + gmem_o.move(); + + // Commit the values for Q into shared memory. + if( loop + Cta_tile_p::M < Cta_tile_p::N ) { + gmem_q.commit(smem_q); + } + + // Make sure the data is in shared memory. + __syncthreads(); + + } // Outer loop over the sequence length. +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_kernel.h b/apex/apex/contrib/csrc/fmha/src/fmha_kernel.h new file mode 100644 index 0000000000000000000000000000000000000000..5fafa50db802238896c138bcebcb22a9b9fab3f0 --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_kernel.h @@ -0,0 +1,133 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include + +#include +#include +#include +#include +#include +#include + +namespace fmha { + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template struct BlockInfo {}; + +template <> struct BlockInfo<1> { + + int actual_seqlen; + int bidx; + int sum_s; + int bidh; + int bidb; + + template + __device__ BlockInfo( const Params ¶ms, + const int bidb, + const int bidh, + const int tidx ) + : bidb( bidb ), bidh( bidh ) { + + // The block index. + sum_s = params.b * params.s; + actual_seqlen = params.s; + bidx = bidb * params.h + bidh; + } + + __device__ bool stop_early() const { + return false; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template <> struct BlockInfo<2> { + + int actual_seqlen; + int bidx; + int sum_s; + int bidh; + int bidb; + + template + __device__ BlockInfo( const Params ¶ms, + const int bidb, + const int bidh, + const int tidx ) + : bidb( bidb ), bidh( bidh ) { + + // The block index. + sum_s = params.cu_seqlens[bidb]; + actual_seqlen = params.cu_seqlens[bidb + 1] - sum_s; + bidx = sum_s * params.h + bidh; + } + + __device__ bool stop_early() const { + return actual_seqlen == 0; + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +struct BlockInfoPadded { + + template + __device__ BlockInfoPadded( const Params ¶ms, + const int bidb, + const int bidh, + const int tidx ) + : bidb( bidb ), bidh( bidh ), h(params.h) { + + // The block index. + sum_s = params.cu_seqlens[bidb]; + actual_seqlen = params.seqlens[bidb]; + bidx = sum_s * params.h + bidh; + + tidx_global = (bidb * params.h + bidh) * THREADS_PER_CTA + tidx; + } + + __device__ bool stop_early() const { + return actual_seqlen == 0; + } + + int actual_seqlen; + int bidx; + int sum_s; + int bidh; + int bidb; + int tidx_global; + int h; +}; + + +} // namespace fmha diff --git a/apex/apex/contrib/csrc/fmha/src/fmha_utils.h b/apex/apex/contrib/csrc/fmha/src/fmha_utils.h new file mode 100644 index 0000000000000000000000000000000000000000..de07cc78e331497034ea8dadbac87051cd5c0a2d --- /dev/null +++ b/apex/apex/contrib/csrc/fmha/src/fmha_utils.h @@ -0,0 +1,92 @@ +/****************************************************************************** + * Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. + * + ******************************************************************************/ + +#pragma once + +#include +#include +#include +#include +#include + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +#define FMHA_CHECK_CUDA( call ) \ + do { \ + cudaError_t status_ = call; \ + if( status_ != cudaSuccess ) { \ + fprintf( stderr, \ + "CUDA error (%s:%d): %s\n", \ + __FILE__, \ + __LINE__, \ + cudaGetErrorString( status_ ) ); \ + exit( 1 ); \ + } \ + } while( 0 ) + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +enum Data_type { DATA_TYPE_FP16, DATA_TYPE_FP32, DATA_TYPE_INT32, DATA_TYPE_INT8 }; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline void set_alpha( uint32_t &alpha, float norm, Data_type dtype ) { + if( dtype == DATA_TYPE_FP16 ) { + half x = __float2half_rn( norm ); + uint16_t h = reinterpret_cast( x ); + ushort2 h2 = { h, h }; + alpha = reinterpret_cast( h2 ); + } else if( dtype == DATA_TYPE_FP32 ) { + alpha = reinterpret_cast( norm ); + } else if( dtype == DATA_TYPE_INT32 ) { + int32_t inorm = static_cast( norm ); + alpha = reinterpret_cast( inorm ); + } else { + assert( false ); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline size_t get_size_in_bytes( size_t n, Data_type dtype ) { + switch( dtype ) { + case DATA_TYPE_FP32: + return n * 4; + case DATA_TYPE_FP16: + return n * 2; + case DATA_TYPE_INT32: + return n * 4; + case DATA_TYPE_INT8: + return n; + default: + assert( false ); + return 0; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + diff --git a/apex/apex/contrib/csrc/groupbn/batch_norm.cu b/apex/apex/contrib/csrc/groupbn/batch_norm.cu new file mode 100644 index 0000000000000000000000000000000000000000..9f0e6c854ced65a7c0b9097f48c7657f6fa1abf3 --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/batch_norm.cu @@ -0,0 +1,333 @@ +#include +#include +#include + +#include "THC/THC.h" + +#include "batch_norm.h" + +#include + +#include "compat.h" + +#define cudaCheckErrors(msg) \ + do { \ + cudaError_t __err = cudaGetLastError(); \ + if (__err != cudaSuccess) { \ + fprintf(stderr, "Fatal error: %s (%s at %s:%d)\n", \ + msg, cudaGetErrorString(__err), \ + __FILE__, __LINE__); \ + fprintf(stderr, "*** FAILED - ABORTING\n"); \ + exit(1); \ + } \ + } while (0) + +static size_t round_up_to_multiple(size_t x, int multiple) { + return ((x + multiple - 1) / multiple) * multiple; +} + +// TODO: Stop manually allocating CUDA memory; allocate an ATen byte +// tensor instead. +struct Workspace { + Workspace(size_t size) : size(size), data(NULL) { + data = THCudaMalloc(at::globalContext().lazyInitCUDA(), size); + } + Workspace(const Workspace&) = delete; + Workspace(Workspace&&) = default; + Workspace& operator=(Workspace&&) = default; + ~Workspace() { + if (data) { + THCudaFree(at::globalContext().lazyInitCUDA(), data); + } + } + + size_t size; + void* data; +}; + +// Return {y} +at::Tensor nhwc_bn_fwd_train( + const at::Tensor& x, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + const bool fuse_relu, + void * my_data, + void * pair_data, + void * pair_data2, + void * pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop) { + + const int N = x.size(0); + const int H = x.size(1); + const int W = x.size(2); + const int C = x.size(3); + + // generating new magic number and use that for sync + int* magic = magic_tensor.DATA_PTR(); + *magic = (*magic + 1) & 0xff; + + // Allocate output tensor + at::Tensor y = at::empty({N, H, W, C}, x.options()); + + // Create wrapper + NhwcBatchNorm *bn = new NhwcBatchNorm(); + + bn->setInputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W, bn_group); + bn->setOutputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W); + + bn->setConstants(momentum, epsilon); + + // set pointers within the wrapper + bn->setInputOutputPointers(x.DATA_PTR(), + nullptr, + y.DATA_PTR(), + nullptr); + + bn->setWeightPointers({scale.DATA_PTR(), bias.DATA_PTR()}, {nullptr, nullptr}); + bn->setParameterPointers({running_mean.DATA_PTR(), running_inv_var.DATA_PTR()}); + + // deal with workspace(s) + auto workspace_bytes = bn->numWorkspaceBytes(); + // We'll create explicit tensors for the first 2 workspace ptrs, then allocate & offset + // an allocated workspace for the others + size_t total_workspace_bytes = 0; + std::vector workspace_offsets; + + for (auto index = 3; index < workspace_bytes.size(); ++index) { + total_workspace_bytes = round_up_to_multiple(total_workspace_bytes, 512); + workspace_offsets.push_back(total_workspace_bytes); + + auto alloc_bytes = workspace_bytes[index]; + total_workspace_bytes += alloc_bytes; + } + + // Allocate the workspace + Workspace ws(total_workspace_bytes); + + std::vector workspace; + workspace.push_back(minibatch_mean.DATA_PTR()); + workspace.push_back(minibatch_inv_var.DATA_PTR()); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const int retired_cta_bytes = workspace_bytes[2]; + void* retired_ctas = ret_cta.DATA_PTR(); + assert(ret_cta.size(0)>=retired_cta_bytes); + workspace.push_back(retired_ctas); + + for (auto index = 3; index < workspace_bytes.size(); ++index) { + void *ptr = reinterpret_cast(ws.data) + workspace_offsets[index-3]; + workspace.push_back(ptr); + } + + bn->setWorkspacePointers(workspace, workspace_bytes); + + // Don't fuse in ReLU for now at least + bn->fwd(stream, fuse_relu, my_data, pair_data, pair_data2, pair_data3, bn_group, *magic, occupancy, grid_dim_x, coop); + + return y; +} + +at::Tensor nhwc_bn_fwd_eval( + const at::Tensor& x, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& ret_cta, + const int bn_group, + const float momentum, + const float epsilon, + const bool fuse_relu) { + + const int N = x.size(0); + const int H = x.size(1); + const int W = x.size(2); + const int C = x.size(3); + + // Allocate output tensor + at::Tensor y = at::empty({N, H, W, C}, x.options()); + + // Create wrapper + NhwcBatchNorm *bn = new NhwcBatchNorm(); + + bn->setInputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W, bn_group); + bn->setOutputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W); + + bn->setConstants(momentum, epsilon); + + // set pointers within the wrapper + bn->setInputOutputPointers(x.DATA_PTR(), + nullptr, + y.DATA_PTR(), + nullptr); + + bn->setWeightPointers({scale.DATA_PTR(), bias.DATA_PTR()}, {nullptr, nullptr}); + bn->setParameterPointers({running_mean.DATA_PTR(), running_inv_var.DATA_PTR()}); + + // deal with workspace(s) + auto workspace_bytes = bn->numWorkspaceBytes(); + // We'll create explicit tensors for the first 2 workspace ptrs, then allocate & offset + // an allocated workspace for the others + size_t total_workspace_bytes = 0; + std::vector workspace_offsets; + + for (auto index = 3; index < workspace_bytes.size(); ++index) { + total_workspace_bytes = round_up_to_multiple(total_workspace_bytes, 512); + workspace_offsets.push_back(total_workspace_bytes); + + auto alloc_bytes = workspace_bytes[index]; + total_workspace_bytes += alloc_bytes; + } + + // Allocate the workspace + Workspace ws(total_workspace_bytes); + + std::vector workspace; + workspace.push_back(nullptr); + workspace.push_back(nullptr); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const int retired_cta_bytes = workspace_bytes[2]; + void* retired_ctas = ret_cta.DATA_PTR(); + assert(ret_cta.size(0)>=retired_cta_bytes); + workspace.push_back(retired_ctas); + + for (auto index = 3; index < workspace_bytes.size(); ++index) { + void *ptr = reinterpret_cast(ws.data) + workspace_offsets[index-3]; + workspace.push_back(ptr); + } + + bn->setWorkspacePointers(workspace, workspace_bytes); + + // Don't fuse in ReLU for now at least + bn->fwdInference(stream, fuse_relu); + + return y; + +} + +std::vector nhwc_bn_bwd( + const at::Tensor& x, + const at::Tensor& dy, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + const bool fuse_relu, + void * my_data, + void * pair_data, + void * pair_data2, + void * pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop) { + // shape + const int N = x.size(0); + const int H = x.size(1); + const int W = x.size(2); + const int C = x.size(3); + + // generating new magic number and use that for sync + int* magic = magic_tensor.DATA_PTR(); + *magic = (*magic + 1) & 0xff; + + // outputs + at::Tensor x_grad, scale_grad, bias_grad; + + // Allocate outputs + x_grad = at::empty_like(x); + scale_grad = at::empty_like(scale); + bias_grad = at::empty_like(bias); + + // Create wrapper + NhwcBatchNorm *bn = new NhwcBatchNorm(); + + bn->setInputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W, bn_group); + bn->setOutputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W); + + bn->setConstants(momentum, epsilon); + + // set pointers within the wrapper + bn->setInputOutputPointers(x.DATA_PTR(), + x_grad.DATA_PTR(), + nullptr, + dy.DATA_PTR()); + + bn->setWeightPointers({scale.DATA_PTR(), bias.DATA_PTR()}, {scale_grad.DATA_PTR(), bias_grad.DATA_PTR()}); + bn->setParameterPointers({running_mean.DATA_PTR(), running_inv_var.DATA_PTR()}); + + // deal with workspace(s) + auto workspace_bytes = bn->numWorkspaceBytes(); + // We'll create explicit tensors for the first 2 workspace ptrs, then allocate & offset + // an allocated workspace for the others + size_t total_workspace_bytes = 0; + std::vector workspace_offsets; + + for (auto index = 3; index < workspace_bytes.size(); ++index) { + total_workspace_bytes = round_up_to_multiple(total_workspace_bytes, 512); + workspace_offsets.push_back(total_workspace_bytes); + + auto alloc_bytes = workspace_bytes[index]; + total_workspace_bytes += alloc_bytes; + } + + // Allocate the workspace + Workspace ws(total_workspace_bytes); + + std::vector workspace; + workspace.push_back(minibatch_mean.DATA_PTR()); + workspace.push_back(minibatch_inv_var.DATA_PTR()); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const int retired_cta_bytes = workspace_bytes[2]; + void* retired_ctas = ret_cta.DATA_PTR(); + assert(ret_cta.size(0)>=retired_cta_bytes); + workspace.push_back(retired_ctas); + + for (auto index = 3; index < workspace_bytes.size(); ++index) { + void *ptr = reinterpret_cast(ws.data) + workspace_offsets[index-3]; + workspace.push_back(ptr); + } + + bn->setWorkspacePointers(workspace, workspace_bytes); + + bn->dgrad(stream, fuse_relu, my_data, pair_data, pair_data2, pair_data3, bn_group, *magic, occupancy, grid_dim_x, coop); + + return std::vector{x_grad, scale_grad, bias_grad}; +} + +int nhwc_bn_fwd_occupancy() { + int device_id=-1; + cudaGetDevice(&device_id); + + //max occupancy supported by the code is 2 + return NhwcBatchNorm::smem_driven_fwd_occupancy(device_id, 2); +} + +int nhwc_bn_bwd_occupancy() { + int device_id=-1; + cudaGetDevice(&device_id); + + //max occupancy supported by the code is 2 + return NhwcBatchNorm::smem_driven_bwd_occupancy(device_id, 2); +} + + diff --git a/apex/apex/contrib/csrc/groupbn/batch_norm.h b/apex/apex/contrib/csrc/groupbn/batch_norm.h new file mode 100644 index 0000000000000000000000000000000000000000..8885abae80201389c4fd215c80ebdd9cd08be493 --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/batch_norm.h @@ -0,0 +1,734 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ + +/*! + * Copyright (c) 2018 by Contributors + * \file nhwc_batch_norm.h + * \brief CUDA NHWC Batch Normalization code + * \author Shankara Rao Thejaswi Nanditale, Dick Carter, Evgeni Krimer +*/ +#ifndef MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_H_ +#define MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_H_ + +#include + +#include +#include +#include + +#include "nhwc_batch_norm_kernel.h" +#include "cuda_utils.h" + + +#define VERBOSE_DEFAULT false + +class NhwcBatchNorm { + public: + NhwcBatchNorm() { + name_ = "nhwc_batchnorm"; + createTensorDescriptor(&X_tensor_desc_); + createTensorDescriptor(&Y_tensor_desc_); + } + + ~NhwcBatchNorm() { + destroyTensorDescriptor(X_tensor_desc_); + destroyTensorDescriptor(Y_tensor_desc_); + } + + void die() { + std::cerr << "batchnorm not initialized" << std::endl; + exit(-1); + } + + void fwd(cudaStream_t stream, bool use_relu, void* my_data, void* pair_data, void* pair_data2, void* pair_data3, const int bn_group, const int magic, const int occupancy, const int grid_dim_x, const bool coop); + void dgrad(cudaStream_t stream, bool use_relu, void* my_data, void* pair_data, void* pair_data2, void* pair_data3, const int bn_group, const int magic, const int occupancy, const int grid_dim_x, const bool coop); + void fwdInference(cudaStream_t stream, bool use_relu); + dim3 calc_fwd_grid(int *loop, const int grid_dim_x); + dim3 calc_bwd_grid(int *loop, const int grid_dim_x); + + void setInputDescriptor(const cudnnTensorFormat_t format, + const cudnnDataType_t data_type, + int n, int c, int h, int w, int bn_group) { + m_ = n * h * w; + int m_bn_adjusted = m_ * bn_group; + c_ = c; + // factor to scale sum of squared errors to get saved variance. Must be 1/nhw. + svar_inv_count_ = 1.f / m_bn_adjusted; + // factor to scale sum of squared errors to get running variance. Should be 1/(nhw-1). + int divisor = m_bn_adjusted - 1; + // nhw == 1 is unlikely, but by setting the rvar_inv_count_ == 1.f, we avoid running var infs. + rvar_inv_count_ = divisor == 0 ? 1.f : 1.f / divisor; + setTensorDescriptor(X_tensor_desc_, format, data_type, n, c, h, w); + } + + void setOutputDescriptor(const cudnnTensorFormat_t format, + const cudnnDataType_t data_type, + int n, int c, int h, int w) { + setTensorDescriptor(Y_tensor_desc_, format, data_type, n, c, h, w); + } + + const std::vector numWorkspaceBytes() const; + + void setWorkspacePointers( + const std::vector& workspace, + const std::vector& num_workspace_bytes); + + void setInputOutputPointers(void* X, void* dX, void* Y, void *dY) { + X_ = X; + dX_ = dX; + Y_ = Y; + dY_ = dY; + } + + // Sets the pointers for the scale and weight (in that order) data and derivative buffers. + void setWeightPointers(const std::vector& weight_pointers, + const std::vector& deriv_pointers) { + assert(weight_pointers.size() == 2); + assert(deriv_pointers.size() == 2); + scale_ = static_cast(weight_pointers[0]); + bias_ = static_cast(weight_pointers[1]); + dscale_ = static_cast(deriv_pointers[0]); + dbias_ = static_cast(deriv_pointers[1]); + } + + // Sets the pointers for the population mean and variance buffers, in that order. + void setParameterPointers(const std::vector& param_pointers) { + assert(param_pointers.size() == 2); + population_mean_ = static_cast(param_pointers[0]); + population_variance_ = static_cast(param_pointers[1]); + } + + void setConstants(const double exp_avg_factor, const double eps) { + exp_avg_factor_ = exp_avg_factor; + eps_ = eps; + } + + void processCudnnStatus(const cudnnStatus_t& status, + const std::string& string = std::string(), + bool verbose = VERBOSE_DEFAULT) { + if (status != CUDNN_STATUS_SUCCESS) + LOG(FATAL) << string << " " << cudnnGetErrorString(status); + else if (verbose) + LOG(INFO) << string << " " << cudnnGetErrorString(status); + } + + void checkCudaStatus(const std::string& string = std::string(), + bool verbose = VERBOSE_DEFAULT) { + cudaError_t status = cudaGetLastError(); + if (status != cudaSuccess) + LOG(FATAL) << string << " " << cudaGetErrorString(status); + else if (verbose) + LOG(INFO) << string << " " << cudaGetErrorString(status); + } + + size_t size_retired_ctas(int grid_y) const { + // Note that the value of max_grid_y to handle known GPUs is about 160. + const int max_grid_y = 1024; + if (grid_y > max_grid_y) + LOG(INFO) << "GPU capabilities exceeds assumptions."; + const int retired_cta_bytes = max_grid_y * 2 * sizeof(int); + // Since the region will be initialized once and used for many kernels, + // the idea is to return an ample size that will cover all uses. + return retired_cta_bytes; + } + + cudnnTensorDescriptor_t X_tensor_desc_ = nullptr; + cudnnTensorDescriptor_t Y_tensor_desc_ = nullptr; + + void* X_ = nullptr; + void* dX_ = nullptr; + void* Y_ = nullptr; + void* dY_ = nullptr; + + // Learned scale and bias weights. + float* scale_ = nullptr; + float* dscale_ = nullptr; + float* bias_ = nullptr; + float* dbias_ = nullptr; + + // Computed population mean and variance parameters. + float* population_mean_ = nullptr; + float* population_variance_ = nullptr; + + // Workspace buffers for minibatch mean and variance (computed in fwd, needed by bwd). + float* minibatch_mean_ = nullptr; + float* minibatch_variance_ = nullptr; + + int m_ = 0; // Number of values per channel that BN is normalizing. + int c_ = 0; // Number of channels over which BN is normalizing. + + float svar_inv_count_ = 0.f; // factor to scale sum of squared errors to get saved variance + float rvar_inv_count_ = 0.f; // factor to scale sum of squared errors to get running variance + + double exp_avg_factor_ = 0.; + double eps_ = 0.; + std::string name_; + + private: + void setTensorDescriptor(cudnnTensorDescriptor_t descriptor, + cudnnTensorFormat_t format, + cudnnDataType_t data_type, + int n, int c, int h, int w) { + cudnnStatus_t status = CUDNN_STATUS_SUCCESS; + status = cudnnSetTensor4dDescriptor(descriptor, format, data_type, n, c, h, w); + processCudnnStatus(status, "set tensor descriptor"); + } + + void createTensorDescriptor(cudnnTensorDescriptor_t *descriptor) { + cudnnStatus_t status = CUDNN_STATUS_SUCCESS; + status = cudnnCreateTensorDescriptor(descriptor); + processCudnnStatus(status, "create tensor_descriptor"); + } + + void destroyTensorDescriptor(cudnnTensorDescriptor_t descriptor) { + cudnnStatus_t status = CUDNN_STATUS_SUCCESS; + status = cudnnDestroyTensorDescriptor(descriptor); + processCudnnStatus(status, "destroy tensor_descriptor"); + } + + protected: + float *partial_sums_ = nullptr; + int *partial_counts_ = nullptr; + int *retired_ctas_ = nullptr; + + void _setFwdParams(NhwcBatchNormFwdParams *params) const; + void _setFwdInferenceParams(NhwcBatchNormFwdInferenceParams *params) const; + void _setBwdParams(NhwcBatchNormBwdParams *params) const; + + // @todo: ability to configure these? + // Kernel params + static const int USE_ONLINE_APPROACH = 1; + static const int THREADS_PER_CTA = 512; + static const int THREADS_PER_PIXEL = 16; + static const int C_ELEMENTS_PER_CTA = 64; + static const int ELEMENTS_PER_LDG = C_ELEMENTS_PER_CTA / THREADS_PER_PIXEL; + static const int MAX_SMEM_WITHOUT_OPT_IN = 48 * 1024; + + typedef uint16_t StorageType; + //typedef float StorageType; + // increasing this to 6 causes spills in fwd kernel! + static const int PIXELS_PER_THREAD_IN_REGISTERS_FWD = 5; + static const int PIXELS_PER_THREAD_IN_REGISTERS_BWD = 3; + static const int PIXELS_PER_THREAD_IN_SMEM_FWD = 10; + static const int PIXELS_PER_THREAD_IN_SMEM_BWD = 5; + + static const int PIXELS_PER_THREAD_FWD = PIXELS_PER_THREAD_IN_REGISTERS_FWD + \ + PIXELS_PER_THREAD_IN_SMEM_FWD; + static const int PIXELS_PER_THREAD_BWD = PIXELS_PER_THREAD_IN_REGISTERS_BWD + \ + PIXELS_PER_THREAD_IN_SMEM_BWD; + static const int PIXELS_PER_THREAD_FWD_INFERENCE = 4; + + // Derived params + static const size_t SMEM_SIZE_FWD = PIXELS_PER_THREAD_IN_SMEM_FWD*THREADS_PER_CTA*\ + ELEMENTS_PER_LDG*sizeof(StorageType); + static const size_t SMEM_SIZE_BWD = PIXELS_PER_THREAD_IN_SMEM_BWD*THREADS_PER_CTA*\ + ELEMENTS_PER_LDG*2*sizeof(StorageType); + static const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + static const int PIXELS_PER_CTA_FWD = THREADS_PER_CTA/THREADS_PER_PIXEL * \ + PIXELS_PER_THREAD_FWD; + static const int PIXELS_PER_CTA_BWD = THREADS_PER_CTA/THREADS_PER_PIXEL * \ + PIXELS_PER_THREAD_BWD; + static const int PIXELS_PER_CTA_FWD_INFERENCE = THREADS_PER_CTA/THREADS_PER_PIXEL * \ + PIXELS_PER_THREAD_FWD_INFERENCE; + + // max grid.y in case of group bn is limited by exchange buffer size + static const int MAX_GBN_BLOCK_Y = 256; + + // Helper function to launch the forward kernel. + + // We calculate (based on smem usage) the achievable occupancy and make sure we run a kernel + // version that was compiled with that occupancy in its launch bounds. This way, we avoid + // needless register spills. + void _fwdKernelLauncher(cudaStream_t stream, NhwcBatchNormFwdParams params, + dim3 grid_dim, int outer_loops, bool use_relu, const int occupancy, const bool coop) { + +#define LAUNCH_FWD_KERNEL(OUTER_LOOPS, USE_RELU, USE_ADD_RELU, COMPILED_FOR_OCCUPANCY, COOP) \ + do { \ + CHECK(SMEM_SIZE_FWD <= MAX_SMEM_WITHOUT_OPT_IN) << "Nhwc batchnorm kernel smem too big."; \ + auto fwd_func = nhwc_batch_norm_fwd< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_FWD, \ + PIXELS_PER_THREAD_IN_SMEM_FWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + USE_RELU, \ + USE_ADD_RELU, \ + COMPILED_FOR_OCCUPANCY>; \ + if (COMPILED_FOR_OCCUPANCY > 1) { \ + cudaFuncSetAttribute(fwd_func, cudaFuncAttributePreferredSharedMemoryCarveout, 100); \ + checkCudaStatus(name_ + " fwd ser coop kernel (cudaFuncSetAttribute carveout)"); \ + } \ + void *params_ptr = static_cast(¶ms); \ + using FWD_FUNC = decltype(nhwc_batch_norm_fwd< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_FWD, \ + PIXELS_PER_THREAD_IN_SMEM_FWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + USE_RELU, \ + USE_ADD_RELU, \ + COMPILED_FOR_OCCUPANCY>); \ + if (COOP) { \ + cudaLaunchCooperativeKernel(fwd_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_FWD, \ + stream); \ + } else { \ + cudaLaunchKernel(fwd_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_FWD, \ + stream); \ + } \ + checkCudaStatus(name_ + " fwd ser coop kernel"); \ + } while (0) + + // Don't try for an occupancy > 2 as this will squeeze register use and create spills. + if (outer_loops == 1 && use_relu) { + if (occupancy >= 2) + LAUNCH_FWD_KERNEL(1, true, false, 2, coop); + else + LAUNCH_FWD_KERNEL(1, true, false, 1, coop); + } else if (outer_loops == 1 && !use_relu) { + if (occupancy >= 2) + LAUNCH_FWD_KERNEL(1, false, false, 2, coop); + else + LAUNCH_FWD_KERNEL(1, false, false, 1, coop); + } else if (use_relu) { + if (occupancy >= 2) + LAUNCH_FWD_KERNEL(0, true, false, 2, coop); + else + LAUNCH_FWD_KERNEL(0, true, false, 1, coop); + } else { + if (occupancy >= 2) + LAUNCH_FWD_KERNEL(0, false, false, 2, coop); + else + LAUNCH_FWD_KERNEL(0, false, false, 1, coop); + } +#undef LAUNCH_FWD_KERNEL + } + + // Helper function to launch the backward kernel. + + void _bwdKernelLauncher(cudaStream_t stream, NhwcBatchNormBwdParams params, + dim3 grid_dim, int outer_loops, bool use_relu, const int occupancy, const bool coop) { +#define LAUNCH_BWD_KERNEL(OUTER_LOOPS, COMPILED_FOR_OCCUPANCY, COOP) \ + do { \ + CHECK(SMEM_SIZE_BWD <= MAX_SMEM_WITHOUT_OPT_IN) << "Nhwc batchnorm kernel smem too big."; \ + auto bwd_func = nhwc_batch_norm_bwd< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_BWD, \ + PIXELS_PER_THREAD_IN_SMEM_BWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + COMPILED_FOR_OCCUPANCY>; \ + if (COMPILED_FOR_OCCUPANCY > 1) { \ + cudaFuncSetAttribute(bwd_func, cudaFuncAttributePreferredSharedMemoryCarveout, 100); \ + checkCudaStatus(name_ + " bwd coop serial kernel (cudaFuncSetAttribute carveout)"); \ + } \ + void *params_ptr = static_cast(¶ms); \ + using BWD_FUNC = decltype(nhwc_batch_norm_bwd< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_BWD, \ + PIXELS_PER_THREAD_IN_SMEM_BWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + COMPILED_FOR_OCCUPANCY>); \ + if (COOP) { \ + cudaLaunchCooperativeKernel(bwd_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_BWD, \ + stream); \ + } else { \ + cudaLaunchKernel(bwd_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_BWD, \ + stream); \ + } \ + checkCudaStatus(name_ + " bwd coop serial kernel"); \ + } while (0) + +#define LAUNCH_BWD_RELU_KERNEL(OUTER_LOOPS, COMPILED_FOR_OCCUPANCY, COOP) \ + do { \ + CHECK(SMEM_SIZE_BWD <= MAX_SMEM_WITHOUT_OPT_IN) << "Nhwc batchnorm kernel smem too big."; \ + auto bwd_relu_func = nhwc_batch_norm_bwd_relu< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_BWD, \ + PIXELS_PER_THREAD_IN_SMEM_BWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + COMPILED_FOR_OCCUPANCY>; \ + if (COMPILED_FOR_OCCUPANCY > 1) { \ + cudaFuncSetAttribute(bwd_relu_func, cudaFuncAttributePreferredSharedMemoryCarveout, 100); \ + checkCudaStatus(name_ + " bwd-relu coop serial kernel (cudaFuncSetAttribute carveout)"); \ + } \ + void *params_ptr = static_cast(¶ms); \ + using BWD_RELU_FUNC = decltype(nhwc_batch_norm_bwd_relu< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_BWD, \ + PIXELS_PER_THREAD_IN_SMEM_BWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + COMPILED_FOR_OCCUPANCY>); \ + if (COOP) { \ + cudaLaunchCooperativeKernel(bwd_relu_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_BWD, \ + stream); \ + } else { \ + cudaLaunchKernel(bwd_relu_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_BWD, \ + stream); \ + } \ + checkCudaStatus(name_ + " bwd-relu coop serial kernel"); \ + } while (0) + + // Don't try for an occupancy > 2 as this will squeeze register use and create spills. + if (outer_loops == 1 && use_relu) { + if (occupancy >= 2) + LAUNCH_BWD_RELU_KERNEL(1, 2, coop); + else + LAUNCH_BWD_RELU_KERNEL(1, 1, coop); + } else if (outer_loops == 1 && !use_relu) { + if (occupancy >= 2) + LAUNCH_BWD_KERNEL(1, 2, coop); + else + LAUNCH_BWD_KERNEL(1, 1, coop); + } else if (use_relu) { + if (occupancy >= 2) + LAUNCH_BWD_RELU_KERNEL(0, 2, coop); + else + LAUNCH_BWD_RELU_KERNEL(0, 1, coop); + } else { + if (occupancy >= 2) + LAUNCH_BWD_KERNEL(0, 2, coop); + else + LAUNCH_BWD_KERNEL(0, 1, coop); + } +#undef LAUNCH_BWD_KERNEL + } + + public: + + // Calculate the expected fwd kernel occupancy, as dictated by shared memory usage. + static int smem_driven_fwd_occupancy(int device_id, const int max_cta_per_sm) { + using namespace at::cuda::utils; + int fwd_reduction_bytes = THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG*sizeof(float); + int fwd_smem_bytes = SMEM_SIZE_FWD + fwd_reduction_bytes; + int occupancy = MaxSharedMemoryPerMultiprocessor(device_id) / fwd_smem_bytes; + return std::min(max_cta_per_sm, occupancy); + } + + // Calculate the expected bwd kernel occupancy, as dictated by shared memory usage. + static int smem_driven_bwd_occupancy(int device_id, const int max_cta_per_sm) { + using namespace at::cuda::utils; + int bwd_reduction_bytes = THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG*sizeof(float); + int bwd_smem_bytes = SMEM_SIZE_BWD + bwd_reduction_bytes; + int occupancy = MaxSharedMemoryPerMultiprocessor(device_id) / bwd_smem_bytes; + return std::min(max_cta_per_sm, occupancy); + } +}; + +const std::vector NhwcBatchNorm::numWorkspaceBytes() const { + assert(c_ > 0); + + // choose the max memory required between fwd/bwd passes + int grid_x_fwd = div_up(m_, PIXELS_PER_CTA_FWD); + int grid_x_bwd = div_up(m_, PIXELS_PER_CTA_BWD); + int grid_x = max(grid_x_fwd, grid_x_bwd); + int grid_y = div_up(c_, C_ELEMENTS_PER_CTA); + + const size_t num_mean_bytes = c_ * sizeof(float); + const size_t num_variance_bytes = num_mean_bytes; + const size_t size_sums = grid_y*grid_x*THREADS_PER_PIXEL*\ + ELEMENTS_PER_LDG*2*sizeof(float); + const size_t size_counts = grid_y*grid_x*sizeof(int); + + return {num_mean_bytes, num_variance_bytes, + size_retired_ctas(grid_y), size_sums, size_counts}; +} + +void NhwcBatchNorm::setWorkspacePointers( + const std::vector& workspace, + const std::vector& num_workspace_bytes) { + assert(workspace.size() == 5); + assert(num_workspace_bytes.size() == 5); + + minibatch_mean_ = static_cast(workspace[0]); + minibatch_variance_ = static_cast(workspace[1]); + retired_ctas_ = static_cast(workspace[2]); + partial_sums_ = static_cast(workspace[3]); + partial_counts_ = static_cast(workspace[4]); +} + +void NhwcBatchNorm::_setFwdParams(NhwcBatchNormFwdParams *params) const { + params->gmem_src = static_cast(X_); + params->gmem_dst = static_cast(Y_); + params->gmem_src1 = nullptr; + params->gmem_bias = bias_; + params->gmem_scale = scale_; + params->gmem_running_mean = population_mean_; + params->gmem_running_var = population_variance_; + params->gmem_saved_mean = minibatch_mean_; + params->gmem_saved_var = minibatch_variance_; + params->gmem_relu_bitmask = nullptr; + params->nhw = m_; + params->c = c_; + params->svar_inv_count = svar_inv_count_; + params->rvar_inv_count = rvar_inv_count_; + params->gmem_sums = partial_sums_; + params->gmem_counts = partial_counts_; + params->gmem_retired_ctas = retired_ctas_; + params->var_eps = eps_; + params->outer_loops = 0; + params->exp_avg_factor = static_cast(exp_avg_factor_); + params->c_blks = div_up(c_, C_ELEMENTS_PER_CTA); +} + +void NhwcBatchNorm::_setFwdInferenceParams(NhwcBatchNormFwdInferenceParams + *params) const { + params->gmem_src = static_cast(X_); + params->gmem_dst = static_cast(Y_); + params->gmem_src1 = nullptr; + params->gmem_bias = bias_; + params->gmem_scale = scale_; + params->gmem_mean = population_mean_; + params->gmem_var = population_variance_; + params->nhw = m_; + params->c = c_; + params->var_eps = eps_; +} + +void NhwcBatchNorm::_setBwdParams(NhwcBatchNormBwdParams *params) const { + params->gmem_src = static_cast(X_); + params->gmem_dy = static_cast(dY_); + params->gmem_dst = static_cast(dX_); + params->gmem_dst1 = nullptr; + params->gmem_relu_bitmask = nullptr; + params->gmem_dscale = dscale_; + params->gmem_dbias = dbias_; + params->gmem_scale = scale_; + params->gmem_bias = bias_; + params->gmem_saved_mean = minibatch_mean_; + params->gmem_saved_var = minibatch_variance_; + params->nhw = m_; + params->c = c_; + params->svar_inv_count = svar_inv_count_; + params->gmem_sums = partial_sums_; + params->gmem_retired_ctas = retired_ctas_; + params->outer_loops = 0; + params->c_blks = div_up(c_, C_ELEMENTS_PER_CTA); +} + +void NhwcBatchNorm::fwdInference(cudaStream_t stream, bool use_relu) { + bool ptrs_are_set = + X_tensor_desc_ != nullptr + && Y_tensor_desc_ != nullptr + && scale_ != nullptr + && bias_ != nullptr + // && minibatch_mean_ != nullptr + // && minibatch_variance_ != nullptr + && population_mean_ != nullptr + && population_variance_ != nullptr + && X_ != nullptr + // && dX_ != nullptr + && Y_ != nullptr + // && dY_ != nullptr + // && dscale_ != nullptr + // && dbias_ != nullptr + && partial_sums_ != nullptr + && partial_counts_ != nullptr; + + if (!ptrs_are_set) + die(); + + dim3 grid_dim; + grid_dim.x = div_up(m_, PIXELS_PER_CTA_FWD_INFERENCE); + grid_dim.y = div_up(c_, C_ELEMENTS_PER_CTA); + + // @todo: maybe just move this inside initialize routine? + NhwcBatchNormFwdInferenceParams params; + _setFwdInferenceParams(¶ms); + + if (use_relu) { + nhwc_batch_norm_fwd_inference + + <<>>(params); + checkCudaStatus(name_ + " fwd_inference-relu kernel"); + } else { + nhwc_batch_norm_fwd_inference + + <<>>(params); + checkCudaStatus(name_ + " fwd_inference kernel"); + } +} + +dim3 NhwcBatchNorm::calc_fwd_grid(int *loop, const int grid_dim_x) { + dim3 grid_dim; + grid_dim.x = div_up(m_, PIXELS_PER_CTA_FWD); + int c_blks = div_up(c_, C_ELEMENTS_PER_CTA); + unsigned int max_grid_x = grid_dim_x; + if (grid_dim.x <= max_grid_x) { + *loop = 1; + if (max_grid_x / grid_dim.x > 1) { + grid_dim.y = std::min(c_blks, static_cast(max_grid_x / grid_dim.x)); + assert(grid_dim.y 1) { + grid_dim.y = std::min(c_blks, static_cast(max_grid_x / grid_dim.x)); + assert(grid_dim.y> 1); + + dim3 grid_dim = calc_fwd_grid(¶ms.outer_loops, grid_dim_x); + _fwdKernelLauncher(stream, params, grid_dim, params.outer_loops, use_relu, occupancy, coop); +} + +void NhwcBatchNorm::dgrad(cudaStream_t stream, bool use_relu, void* my_data, void* pair_data, void* pair_data2, void* pair_data3, + const int bn_group, const int magic, const int occupancy, const int grid_dim_x, const bool coop) { + bool ptrs_are_set = + X_tensor_desc_ != nullptr + && Y_tensor_desc_ != nullptr + && scale_ != nullptr + && (bias_ != nullptr || !use_relu) + && minibatch_mean_ != nullptr + && minibatch_variance_ != nullptr + // && population_mean_ != nullptr + // && population_variance_ != nullptr + && X_ != nullptr + && dX_ != nullptr + // && Y_ != nullptr + && dY_ != nullptr + && dscale_ != nullptr + && dbias_ != nullptr; + + if (!ptrs_are_set) + die(); + + // reset of retired_cta_count no longer needed + + NhwcBatchNormBwdParams params; + _setBwdParams(¶ms); + params.my_data = my_data; + params.pair_datas[0] = pair_data; + params.pair_datas[1] = pair_data2; + params.pair_datas[2] = pair_data3; + params.magic = magic; + params.sync_iters = (bn_group==8)?3:(bn_group >> 1); + params.wgrad_coeff = 1.0 / bn_group; + + dim3 grid_dim = calc_bwd_grid(¶ms.outer_loops, grid_dim_x); + _bwdKernelLauncher(stream, params, grid_dim, params.outer_loops, use_relu, occupancy, coop); +} + +#endif // MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_H_ diff --git a/apex/apex/contrib/csrc/groupbn/batch_norm_add_relu.cu b/apex/apex/contrib/csrc/groupbn/batch_norm_add_relu.cu new file mode 100644 index 0000000000000000000000000000000000000000..0d60267c0c9e71e5c2382ea69c90e3e2d956d6bb --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/batch_norm_add_relu.cu @@ -0,0 +1,345 @@ +#include +#include +#include + +#include "THC/THC.h" + +#include "batch_norm_add_relu.h" + +#include + +#include "compat.h" + +//FIXME move the common stuff to common h file +#define cudaCheckErrors(msg) \ + do { \ + cudaError_t __err = cudaGetLastError(); \ + if (__err != cudaSuccess) { \ + fprintf(stderr, "Fatal error: %s (%s at %s:%d)\n", \ + msg, cudaGetErrorString(__err), \ + __FILE__, __LINE__); \ + fprintf(stderr, "*** FAILED - ABORTING\n"); \ + exit(1); \ + } \ + } while (0) + +static size_t round_up_to_multiple(size_t x, int multiple) { + return ((x + multiple - 1) / multiple) * multiple; +} + +// TODO: Stop manually allocating CUDA memory; allocate an ATen byte +// tensor instead. +struct Workspace { + Workspace(size_t size) : size(size), data(NULL) { + data = THCudaMalloc(at::globalContext().lazyInitCUDA(), size); + } + Workspace(const Workspace&) = delete; + Workspace(Workspace&&) = default; + Workspace& operator=(Workspace&&) = default; + ~Workspace() { + if (data) { + THCudaFree(at::globalContext().lazyInitCUDA(), data); + } + } + + size_t size; + void* data; +}; + +// Return {y} +at::Tensor nhwc_bn_addrelu_fwd_train( + const at::Tensor& x, + const at::Tensor& z, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& bitmask, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + void * my_data, + void * pair_data, + void * pair_data2, + void * pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop) { + + const int N = x.size(0); + const int H = x.size(1); + const int W = x.size(2); + const int C = x.size(3); + + // generating new magic number and use that for sync + int* magic = magic_tensor.DATA_PTR(); + *magic = (*magic + 1) & 0xff; + + // Allocate output tensor + at::Tensor y = at::empty({N, H, W, C}, x.options()); + + // Create wrapper + NhwcBatchNormAddRelu *bn = new NhwcBatchNormAddRelu(); + + bn->setInputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W, bn_group); + bn->setOutputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W); + + bn->setConstants(momentum, epsilon); + + // set pointers within the wrapper + bn->setInputOutputPointers(x.DATA_PTR(), + nullptr, + y.DATA_PTR(), + nullptr, + z.DATA_PTR(), + nullptr); + + bn->setWeightPointers({scale.DATA_PTR(), bias.DATA_PTR()}, {nullptr, nullptr}); + bn->setParameterPointers({running_mean.DATA_PTR(), running_inv_var.DATA_PTR()}); + + // deal with workspace(s) + auto workspace_bytes = bn->numWorkspaceBytes(); + // We'll create explicit tensors for the first 2 workspace ptrs, then allocate & offset + // an allocated workspace for the others + size_t total_workspace_bytes = 0; + std::vector workspace_offsets; + + for (auto index = 4; index < workspace_bytes.size(); ++index) { + total_workspace_bytes = round_up_to_multiple(total_workspace_bytes, 512); + workspace_offsets.push_back(total_workspace_bytes); + + auto alloc_bytes = workspace_bytes[index]; + total_workspace_bytes += alloc_bytes; + } + + // Allocate the workspace + Workspace ws(total_workspace_bytes); + + std::vector workspace; + workspace.push_back(minibatch_mean.DATA_PTR()); + workspace.push_back(minibatch_inv_var.DATA_PTR()); + workspace.push_back(bitmask.DATA_PTR()); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const int retired_cta_bytes = workspace_bytes[3]; + void* retired_ctas = ret_cta.DATA_PTR(); + assert(ret_cta.size(0)>=retired_cta_bytes); + + workspace.push_back(retired_ctas); + + for (auto index = 4; index < workspace_bytes.size(); ++index) { + void *ptr = reinterpret_cast(ws.data) + workspace_offsets[index-4]; + workspace.push_back(ptr); + } + + bn->setWorkspacePointers(workspace, workspace_bytes); + + // Don't fuse in ReLU for now at least + bn->fwd(stream, my_data, pair_data, pair_data2, pair_data3, bn_group, *magic, occupancy, grid_dim_x, coop); + + return y; +} + +at::Tensor nhwc_bn_addrelu_fwd_eval( + const at::Tensor& x, + const at::Tensor& z, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& ret_cta, + const int bn_group, + const float momentum, + const float epsilon) { + + const int N = x.size(0); + const int H = x.size(1); + const int W = x.size(2); + const int C = x.size(3); + + // Allocate output tensor + at::Tensor y = at::empty({N, H, W, C}, x.options()); + + // Create wrapper + NhwcBatchNormAddRelu *bn = new NhwcBatchNormAddRelu(); + + bn->setInputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W, bn_group); + bn->setOutputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W); + + bn->setConstants(momentum, epsilon); + + // set pointers within the wrapper + bn->setInputOutputPointers(x.DATA_PTR(), + nullptr, + y.DATA_PTR(), + nullptr, + z.DATA_PTR(), + nullptr); + + bn->setWeightPointers({scale.DATA_PTR(), bias.DATA_PTR()}, {nullptr, nullptr}); + bn->setParameterPointers({running_mean.DATA_PTR(), running_inv_var.DATA_PTR()}); + + // deal with workspace(s) + auto workspace_bytes = bn->numWorkspaceBytes(); + // We'll create explicit tensors for the first 2 workspace ptrs, then allocate & offset + // an allocated workspace for the others + size_t total_workspace_bytes = 0; + std::vector workspace_offsets; + + for (auto index = 4; index < workspace_bytes.size(); ++index) { + total_workspace_bytes = round_up_to_multiple(total_workspace_bytes, 512); + workspace_offsets.push_back(total_workspace_bytes); + + auto alloc_bytes = workspace_bytes[index]; + total_workspace_bytes += alloc_bytes; + } + + // Allocate the workspace + Workspace ws(total_workspace_bytes); + + std::vector workspace; + workspace.push_back(nullptr); + workspace.push_back(nullptr); + workspace.push_back(nullptr); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const int retired_cta_bytes = workspace_bytes[3]; + void* retired_ctas = ret_cta.DATA_PTR(); + assert(ret_cta.size(0)>=retired_cta_bytes); + workspace.push_back(retired_ctas); + + for (auto index = 4; index < workspace_bytes.size(); ++index) { + void *ptr = reinterpret_cast(ws.data) + workspace_offsets[index-4]; + workspace.push_back(ptr); + } + + bn->setWorkspacePointers(workspace, workspace_bytes); + + // Don't fuse in ReLU for now at least + bn->fwdInference(stream); + + return y; + +} + +std::vector nhwc_bn_addrelu_bwd( + const at::Tensor& x, + const at::Tensor& dy, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& bitmask, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + void * my_data, + void * pair_data, + void * pair_data2, + void * pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop) { + // shape + const int N = x.size(0); + const int H = x.size(1); + const int W = x.size(2); + const int C = x.size(3); + + // generating new magic number and use that for sync + int* magic = magic_tensor.DATA_PTR(); + *magic = (*magic + 1) & 0xff; + + // outputs + at::Tensor x_grad, z_grad, scale_grad, bias_grad; + + // Allocate outputs + x_grad = at::empty_like(x); + z_grad = at::empty_like(x); + scale_grad = at::empty_like(scale); + bias_grad = at::empty_like(bias); + + // Create wrapper + NhwcBatchNormAddRelu *bn = new NhwcBatchNormAddRelu(); + + bn->setInputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W, bn_group); + bn->setOutputDescriptor(CUDNN_TENSOR_NHWC, CUDNN_DATA_HALF, N, C, H, W); + + bn->setConstants(momentum, epsilon); + + // set pointers within the wrapper + bn->setInputOutputPointers(x.DATA_PTR(), + x_grad.DATA_PTR(), + nullptr, + dy.DATA_PTR(), + nullptr, + z_grad.DATA_PTR()); + + bn->setWeightPointers({scale.DATA_PTR(), bias.DATA_PTR()}, {scale_grad.DATA_PTR(), bias_grad.DATA_PTR()}); + bn->setParameterPointers({running_mean.DATA_PTR(), running_inv_var.DATA_PTR()}); + + // deal with workspace(s) + auto workspace_bytes = bn->numWorkspaceBytes(); + // We'll create explicit tensors for the first 2 workspace ptrs, then allocate & offset + // an allocated workspace for the others + size_t total_workspace_bytes = 0; + std::vector workspace_offsets; + + for (auto index = 4; index < workspace_bytes.size(); ++index) { + total_workspace_bytes = round_up_to_multiple(total_workspace_bytes, 512); + workspace_offsets.push_back(total_workspace_bytes); + + auto alloc_bytes = workspace_bytes[index]; + total_workspace_bytes += alloc_bytes; + } + + // Allocate the workspace + Workspace ws(total_workspace_bytes); + + std::vector workspace; + workspace.push_back(minibatch_mean.DATA_PTR()); + workspace.push_back(minibatch_inv_var.DATA_PTR()); + workspace.push_back(bitmask.DATA_PTR()); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const int retired_cta_bytes = workspace_bytes[3]; + void* retired_ctas = ret_cta.DATA_PTR(); + assert(ret_cta.size(0)>=retired_cta_bytes); + workspace.push_back(retired_ctas); + + for (auto index = 4; index < workspace_bytes.size(); ++index) { + void *ptr = reinterpret_cast(ws.data) + workspace_offsets[index-4]; + workspace.push_back(ptr); + } + + bn->setWorkspacePointers(workspace, workspace_bytes); + + bn->dgrad(stream, my_data, pair_data, pair_data2, pair_data3, bn_group, *magic, occupancy, grid_dim_x, coop); + + return std::vector{x_grad, z_grad, scale_grad, bias_grad}; +} + +int nhwc_bn_addrelu_fwd_occupancy() { + int device_id=-1; + cudaGetDevice(&device_id); + + //max occupancy supported by the code is 2 + return NhwcBatchNormAddRelu::smem_driven_fwd_occupancy(device_id, 2); +} + +int nhwc_bn_addrelu_bwd_occupancy() { + int device_id=-1; + cudaGetDevice(&device_id); + + //max occupancy supported by the code is 2 + return NhwcBatchNormAddRelu::smem_driven_bwd_occupancy(device_id, 2); +} + diff --git a/apex/apex/contrib/csrc/groupbn/batch_norm_add_relu.h b/apex/apex/contrib/csrc/groupbn/batch_norm_add_relu.h new file mode 100644 index 0000000000000000000000000000000000000000..6be3bb6771e04939c762ff76bef12baedb3a077c --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/batch_norm_add_relu.h @@ -0,0 +1,681 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ + +/*! + * Copyright (c) 2018 by Contributors + * \file nhwc_batch_norm_add_relu.h + * \brief CUDA NHWC Batch Normalization code with fused addition + * \author Shankara Rao Thejaswi Nanditale, Dick Carter, Maxim Milakov, Evgeni Krimer +*/ +#ifndef MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_ADD_RELU_H_ +#define MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_ADD_RELU_H_ + +#include + +#include +#include +#include + +#include "nhwc_batch_norm_kernel.h" +#include "cuda_utils.h" + + +#define VERBOSE_DEFAULT false + +class NhwcBatchNormAddRelu { + public: + NhwcBatchNormAddRelu() { + name_ = "nhwc_batchnormaddrelu"; + createTensorDescriptor(&X_tensor_desc_); + createTensorDescriptor(&Y_tensor_desc_); + } + + ~NhwcBatchNormAddRelu() { + destroyTensorDescriptor(X_tensor_desc_); + destroyTensorDescriptor(Y_tensor_desc_); + } + + void die() { + std::cerr << "batchnormaddrelu not initialized" << std::endl; + exit(-1); + } + + void fwd(cudaStream_t stream, void* my_data, void* pair_data, void* pair_data2, void* pair_data3, const int bn_group, const int magic, const int occupancy, const int grid_dim_x, const bool coop); + void dgrad(cudaStream_t stream, void* my_data, void* pair_data, void* pair_data2, void* pair_data3, const int bn_group, const int magic, const int occupancy, const int grid_dim_x, const bool coop); + void fwdInference(cudaStream_t stream); + dim3 calc_fwd_grid(int *loop, const int grid_dim_x); + dim3 calc_bwd_grid(int *loop, const int grid_dim_x); + + void setInputDescriptor(const cudnnTensorFormat_t format, + const cudnnDataType_t data_type, + int n, int c, int h, int w, int bn_group) { + m_ = n * h * w; + int m_bn_adjusted = m_ * bn_group; + c_ = c; + // factor to scale sum of squared errors to get saved variance. Must be 1/nhw. + svar_inv_count_ = 1.f / m_bn_adjusted; + // factor to scale sum of squared errors to get running variance. Should be 1/(nhw-1). + int divisor = m_bn_adjusted - 1; + // nhw == 1 is unlikely, but by setting the rvar_inv_count_ == 1.f, we avoid running var infs. + rvar_inv_count_ = divisor == 0 ? 1.f : 1.f / divisor; + setTensorDescriptor(X_tensor_desc_, format, data_type, n, c, h, w); + } + + void setOutputDescriptor(const cudnnTensorFormat_t format, + const cudnnDataType_t data_type, + int n, int c, int h, int w) { + setTensorDescriptor(Y_tensor_desc_, format, data_type, n, c, h, w); + } + + const std::vector numWorkspaceBytes() const; + + void setWorkspacePointers( + const std::vector& workspace, + const std::vector& num_workspace_bytes); + + void setInputOutputPointers(void* X, void* dX, void* Y, void *dY, void* addend, void* dAddend) { + X_ = X; + dX_ = dX; + Y_ = Y; + dY_ = dY; + addend_ = addend; + dAddend_ = dAddend; + } + + // Sets the pointers for the scale and weight (in that order) data and derivative buffers. + void setWeightPointers(const std::vector& weight_pointers, + const std::vector& deriv_pointers) { + assert(weight_pointers.size() == 2); + assert(deriv_pointers.size() == 2); + scale_ = static_cast(weight_pointers[0]); + bias_ = static_cast(weight_pointers[1]); + dscale_ = static_cast(deriv_pointers[0]); + dbias_ = static_cast(deriv_pointers[1]); + } + + // Sets the pointers for the population mean and variance buffers, in that order. + void setParameterPointers(const std::vector& param_pointers) { + assert(param_pointers.size() == 2); + population_mean_ = static_cast(param_pointers[0]); + population_variance_ = static_cast(param_pointers[1]); + } + + void setConstants(const double exp_avg_factor, const double eps) { + exp_avg_factor_ = exp_avg_factor; + eps_ = eps; + } + + void processCudnnStatus(const cudnnStatus_t& status, + const std::string& string = std::string(), + bool verbose = VERBOSE_DEFAULT) { + if (status != CUDNN_STATUS_SUCCESS) + LOG(FATAL) << string << " " << cudnnGetErrorString(status); + else if (verbose) + LOG(INFO) << string << " " << cudnnGetErrorString(status); + } + + void checkCudaStatus(const std::string& string = std::string(), + bool verbose = VERBOSE_DEFAULT) { + cudaError_t status = cudaGetLastError(); + if (status != cudaSuccess) + LOG(FATAL) << string << " " << cudaGetErrorString(status); + else if (verbose) + LOG(INFO) << string << " " << cudaGetErrorString(status); + } + + size_t size_retired_ctas(int grid_y) const { + // Note that the value of max_grid_y to handle known GPUs is about 160. + const int max_grid_y = 1024; + if (grid_y > max_grid_y) + LOG(INFO) << "GPU capabilities exceeds assumptions."; + const int retired_cta_bytes = max_grid_y * 2 * sizeof(int); + // Since the region will be initialized once and used for many kernels, + // the idea is to return an ample size that will cover all uses. + return retired_cta_bytes; + } + + cudnnTensorDescriptor_t X_tensor_desc_ = nullptr; + cudnnTensorDescriptor_t Y_tensor_desc_ = nullptr; + + void* X_ = nullptr; + void* dX_ = nullptr; + void* Y_ = nullptr; + void* dY_ = nullptr; + void* addend_ = nullptr; + void* dAddend_ = nullptr; + + // Learned scale and bias weights. + float* scale_ = nullptr; + float* dscale_ = nullptr; + float* bias_ = nullptr; + float* dbias_ = nullptr; + + // Computed population mean and variance parameters. + float* population_mean_ = nullptr; + float* population_variance_ = nullptr; + + // Workspace buffers for minibatch mean and variance (computed in fwd, needed by bwd). + float* minibatch_mean_ = nullptr; + float* minibatch_variance_ = nullptr; + + int m_ = 0; // Number of values per channel that BN is normalizing. + int c_ = 0; // Number of channels over which BN is normalizing. + + float svar_inv_count_ = 0.f; // factor to scale sum of squared errors to get saved variance + float rvar_inv_count_ = 0.f; // factor to scale sum of squared errors to get running variance + + double exp_avg_factor_ = 0.; + double eps_ = 0.; + std::string name_; + + private: + void setTensorDescriptor(cudnnTensorDescriptor_t descriptor, + cudnnTensorFormat_t format, + cudnnDataType_t data_type, + int n, int c, int h, int w) { + cudnnStatus_t status = CUDNN_STATUS_SUCCESS; + status = cudnnSetTensor4dDescriptor(descriptor, format, data_type, n, c, h, w); + processCudnnStatus(status, "set tensor descriptor"); + } + + void createTensorDescriptor(cudnnTensorDescriptor_t *descriptor) { + cudnnStatus_t status = CUDNN_STATUS_SUCCESS; + status = cudnnCreateTensorDescriptor(descriptor); + processCudnnStatus(status, "create tensor_descriptor"); + } + + void destroyTensorDescriptor(cudnnTensorDescriptor_t descriptor) { + cudnnStatus_t status = CUDNN_STATUS_SUCCESS; + status = cudnnDestroyTensorDescriptor(descriptor); + processCudnnStatus(status, "destroy tensor_descriptor"); + } + + protected: + float *partial_sums_ = nullptr; + int *partial_counts_ = nullptr; + int *retired_ctas_ = nullptr; + unsigned int *relu_bitmask_ = nullptr; + + void _setFwdParams(NhwcBatchNormFwdParams *params) const; + void _setFwdInferenceParams(NhwcBatchNormFwdInferenceParams *params) const; + void _setBwdParams(NhwcBatchNormBwdParams *params) const; + + // @todo: ability to configure these? + // Kernel params + static const int USE_ONLINE_APPROACH = 1; + static const int THREADS_PER_CTA = 512; + static const int THREADS_PER_PIXEL = 16; + static const int C_ELEMENTS_PER_CTA = 64; + static const int ELEMENTS_PER_LDG = C_ELEMENTS_PER_CTA / THREADS_PER_PIXEL; + static const int MAX_SMEM_WITHOUT_OPT_IN = 48 * 1024; + + typedef uint16_t StorageType; + // increasing this to 6 causes spills in fwd kernel! + static const int PIXELS_PER_THREAD_IN_REGISTERS_FWD = 5; + static const int PIXELS_PER_THREAD_IN_REGISTERS_BWD = 3; + static const int PIXELS_PER_THREAD_IN_SMEM_FWD = 10; + static const int PIXELS_PER_THREAD_IN_SMEM_BWD = 5; + + static const int PIXELS_PER_THREAD_FWD = PIXELS_PER_THREAD_IN_REGISTERS_FWD + \ + PIXELS_PER_THREAD_IN_SMEM_FWD; + static const int PIXELS_PER_THREAD_BWD = PIXELS_PER_THREAD_IN_REGISTERS_BWD + \ + PIXELS_PER_THREAD_IN_SMEM_BWD; + static const int PIXELS_PER_THREAD_FWD_INFERENCE = 4; + + // Derived params + static const size_t SMEM_SIZE_FWD = PIXELS_PER_THREAD_IN_SMEM_FWD*THREADS_PER_CTA*\ + ELEMENTS_PER_LDG*sizeof(StorageType); + static const size_t SMEM_SIZE_BWD = PIXELS_PER_THREAD_IN_SMEM_BWD*THREADS_PER_CTA*\ + ELEMENTS_PER_LDG*2*sizeof(StorageType); + static const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + static const int PIXELS_PER_CTA_FWD = THREADS_PER_CTA/THREADS_PER_PIXEL * \ + PIXELS_PER_THREAD_FWD; + static const int PIXELS_PER_CTA_BWD = THREADS_PER_CTA/THREADS_PER_PIXEL * \ + PIXELS_PER_THREAD_BWD; + static const int PIXELS_PER_CTA_FWD_INFERENCE = THREADS_PER_CTA/THREADS_PER_PIXEL * \ + PIXELS_PER_THREAD_FWD_INFERENCE; + + // max grid.y in case of group bn is limited by exchange buffer size + static const int MAX_GBN_BLOCK_Y = 256; + + // Helper function to launch the forward kernel. + + // We calculate (based on smem usage) the achievable occupancy and make sure we run a kernel + // version that was compiled with that occupancy in its launch bounds. This way, we avoid + // needless register spills. + void _fwdKernelLauncher(cudaStream_t stream, NhwcBatchNormFwdParams params, + dim3 grid_dim, int outer_loops, const int occupancy, const bool coop) { +#define LAUNCH_FWD_KERNEL(OUTER_LOOPS, USE_RELU, USE_ADD_RELU, COMPILED_FOR_OCCUPANCY, COOP) \ + do { \ + CHECK(SMEM_SIZE_FWD <= MAX_SMEM_WITHOUT_OPT_IN) << \ + "Nhwc batchnormaddrelu kernel smem too big."; \ + auto fwd_func = nhwc_batch_norm_fwd< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_FWD, \ + PIXELS_PER_THREAD_IN_SMEM_FWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + USE_RELU, \ + USE_ADD_RELU, \ + COMPILED_FOR_OCCUPANCY>; \ + if (COMPILED_FOR_OCCUPANCY > 1) { \ + cudaFuncSetAttribute(fwd_func, cudaFuncAttributePreferredSharedMemoryCarveout, 100); \ + checkCudaStatus(name_ + " fwd ser coop kernel (cudaFuncSetAttribute carveout)"); \ + } \ + void *params_ptr = static_cast(¶ms); \ + using FWD_FUNC = decltype(nhwc_batch_norm_fwd< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_FWD, \ + PIXELS_PER_THREAD_IN_SMEM_FWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + USE_RELU, \ + USE_ADD_RELU, \ + COMPILED_FOR_OCCUPANCY>); \ + if (COOP) { \ + cudaLaunchCooperativeKernel(fwd_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_FWD, \ + stream); \ + } else { \ + cudaLaunchKernel(fwd_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_FWD, \ + stream); \ + } \ + checkCudaStatus(name_ + " fwd ser coop kernel"); \ + } while (0) + + // Don't try for an occupancy > 2 as this will squeeze register use and create spills. + if (outer_loops == 1) { + if (occupancy >= 2) + LAUNCH_FWD_KERNEL(1, false, true, 2, coop); + else + LAUNCH_FWD_KERNEL(1, false, true, 1, coop); + } else { + if (occupancy >= 2) + LAUNCH_FWD_KERNEL(0, false, true, 2, coop); + else + LAUNCH_FWD_KERNEL(0, false, true, 1, coop); + } +#undef LAUNCH_FWD_KERNEL + } + + // Helper function to launch the backward kernel. + + void _bwdKernelLauncher(cudaStream_t stream, NhwcBatchNormBwdParams params, + dim3 grid_dim, int outer_loops, const int occupancy, const bool coop) { +#define LAUNCH_BWD_ADD_RELU_KERNEL(OUTER_LOOPS, COMPILED_FOR_OCCUPANCY, COOP) \ + do { \ + CHECK(SMEM_SIZE_BWD <= MAX_SMEM_WITHOUT_OPT_IN) << \ + "Nhwc batchnormaddrelu kernel smem too big."; \ + auto bwd_add_relu_func = nhwc_batch_norm_bwd_add_relu< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_BWD, \ + PIXELS_PER_THREAD_IN_SMEM_BWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + COMPILED_FOR_OCCUPANCY>; \ + if (COMPILED_FOR_OCCUPANCY > 1) { \ + cudaFuncSetAttribute(bwd_add_relu_func, \ + cudaFuncAttributePreferredSharedMemoryCarveout, 100); \ + checkCudaStatus(name_ + \ + " bwd-add-relu coop serial kernel (cudaFuncSetAttribute carveout)"); \ + } \ + void *params_ptr = static_cast(¶ms); \ + using BWD_ADD_RELU_FUNC = decltype(nhwc_batch_norm_bwd_add_relu< \ + StorageType, \ + THREADS_PER_CTA, \ + THREADS_PER_PIXEL, \ + PIXELS_PER_THREAD_IN_REGISTERS_BWD, \ + PIXELS_PER_THREAD_IN_SMEM_BWD, \ + ELEMENTS_PER_LDG, \ + USE_ONLINE_APPROACH, \ + OUTER_LOOPS, \ + COMPILED_FOR_OCCUPANCY>); \ + if (COOP) { \ + cudaLaunchCooperativeKernel(bwd_add_relu_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_BWD, \ + stream); \ + } else { \ + cudaLaunchKernel(bwd_add_relu_func, \ + grid_dim, \ + THREADS_PER_CTA, \ + ¶ms_ptr, \ + SMEM_SIZE_BWD, \ + stream); \ + } \ + checkCudaStatus(name_ + " bwd-add-relu coop serial kernel"); \ + } while (0) + + // Don't try for an occupancy > 2 as this will squeeze register use and create spills. + if (outer_loops == 1) { + if (occupancy >= 2) + LAUNCH_BWD_ADD_RELU_KERNEL(1, 2, coop); + else + LAUNCH_BWD_ADD_RELU_KERNEL(1, 1, coop); + } else { + if (occupancy >= 2) + LAUNCH_BWD_ADD_RELU_KERNEL(0, 2, coop); + else + LAUNCH_BWD_ADD_RELU_KERNEL(0, 1, coop); + } +#undef LAUNCH_BWD_KERNEL + } + + public: + // Calculate the expected fwd kernel occupancy, as dictated by shared memory usage. + static int smem_driven_fwd_occupancy(int device_id, const int max_cta_per_sm) { + using namespace at::cuda::utils; + int fwd_reduction_bytes = THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG*sizeof(float); + int fwd_smem_bytes = SMEM_SIZE_FWD + fwd_reduction_bytes; + int occupancy = MaxSharedMemoryPerMultiprocessor(device_id) / fwd_smem_bytes; + return std::min(max_cta_per_sm, occupancy); + } + + // Calculate the expected bwd kernel occupancy, as dictated by shared memory usage. + static int smem_driven_bwd_occupancy(int device_id, const int max_cta_per_sm) { + using namespace at::cuda::utils; + int bwd_reduction_bytes = THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG*sizeof(float); + int bwd_smem_bytes = SMEM_SIZE_BWD + bwd_reduction_bytes; + int occupancy = MaxSharedMemoryPerMultiprocessor(device_id) / bwd_smem_bytes; + return std::min(max_cta_per_sm, occupancy); + } +}; + +const std::vector NhwcBatchNormAddRelu::numWorkspaceBytes() const { + assert(c_ > 0); + + // choose the max memory required between fwd/bwd passes + int grid_x_fwd = div_up(m_, PIXELS_PER_CTA_FWD); + int grid_x_bwd = div_up(m_, PIXELS_PER_CTA_BWD); + int grid_x = max(grid_x_fwd, grid_x_bwd); + int grid_y = div_up(c_, C_ELEMENTS_PER_CTA); + + const size_t num_mean_bytes = c_ * sizeof(float); + const size_t num_variance_bytes = num_mean_bytes; + + int elems_per_group = ((m_ + 31) & ~31) * 2; + int group_count = div_up(c_, C_ELEMENTS_PER_CTA); + const size_t bitmask_bytes = elems_per_group * group_count * sizeof(unsigned int); + + const size_t size_sums = grid_y*grid_x*THREADS_PER_PIXEL*\ + ELEMENTS_PER_LDG*2*sizeof(float); + const size_t size_counts = grid_y*grid_x*sizeof(int); + + return {num_mean_bytes, num_variance_bytes, bitmask_bytes, + size_retired_ctas(grid_y), size_sums, size_counts}; +} + +void NhwcBatchNormAddRelu::setWorkspacePointers( + const std::vector& workspace, + const std::vector& num_workspace_bytes) { + assert(workspace.size() == 6); + assert(num_workspace_bytes.size() == 6); + + minibatch_mean_ = static_cast(workspace[0]); + minibatch_variance_ = static_cast(workspace[1]); + relu_bitmask_ = static_cast(workspace[2]); + retired_ctas_ = static_cast(workspace[3]); + partial_sums_ = static_cast(workspace[4]); + partial_counts_ = static_cast(workspace[5]); +} + +void NhwcBatchNormAddRelu::_setFwdParams(NhwcBatchNormFwdParams *params) const { + params->gmem_src = static_cast(X_); + params->gmem_dst = static_cast(Y_); + params->gmem_src1 = static_cast(addend_); + params->gmem_bias = bias_; + params->gmem_scale = scale_; + params->gmem_running_mean = population_mean_; + params->gmem_running_var = population_variance_; + params->gmem_saved_mean = minibatch_mean_; + params->gmem_saved_var = minibatch_variance_; + params->gmem_relu_bitmask = relu_bitmask_; + params->nhw = m_; + params->c = c_; + params->svar_inv_count = svar_inv_count_; + params->rvar_inv_count = rvar_inv_count_; + params->gmem_sums = partial_sums_; + params->gmem_counts = partial_counts_; + params->gmem_retired_ctas = retired_ctas_; + params->var_eps = eps_; + params->outer_loops = 0; + params->exp_avg_factor = static_cast(exp_avg_factor_); + params->c_blks = div_up(c_, C_ELEMENTS_PER_CTA); +} + +void NhwcBatchNormAddRelu::_setFwdInferenceParams(NhwcBatchNormFwdInferenceParams + *params) const { + params->gmem_src = static_cast(X_); + params->gmem_dst = static_cast(Y_); + params->gmem_src1 = static_cast(addend_); + params->gmem_bias = bias_; + params->gmem_scale = scale_; + params->gmem_mean = population_mean_; + params->gmem_var = population_variance_; + params->nhw = m_; + params->c = c_; + params->var_eps = eps_; +} + +void NhwcBatchNormAddRelu::_setBwdParams(NhwcBatchNormBwdParams *params) const { + params->gmem_src = static_cast(X_); + params->gmem_dy = static_cast(dY_); + params->gmem_dst = static_cast(dX_); + params->gmem_dst1 = static_cast(dAddend_); + params->gmem_relu_bitmask = relu_bitmask_; + params->gmem_dscale = dscale_; + params->gmem_dbias = dbias_; + params->gmem_scale = scale_; + params->gmem_bias = bias_; + params->gmem_saved_mean = minibatch_mean_; + params->gmem_saved_var = minibatch_variance_; + params->nhw = m_; + params->c = c_; + params->svar_inv_count = svar_inv_count_; + params->gmem_sums = partial_sums_; + params->gmem_retired_ctas = retired_ctas_; + params->outer_loops = 0; + params->c_blks = div_up(c_, C_ELEMENTS_PER_CTA); +} + +void NhwcBatchNormAddRelu::fwdInference(cudaStream_t stream) { + bool ptrs_are_set = + X_tensor_desc_ != nullptr + && Y_tensor_desc_ != nullptr + && scale_ != nullptr + && bias_ != nullptr + // && minibatch_mean_ != nullptr + // && minibatch_variance_ != nullptr + && population_mean_ != nullptr + && population_variance_ != nullptr + && X_ != nullptr + // && dX_ != nullptr + && Y_ != nullptr + && addend_ != nullptr + // && dY_ != nullptr + // && dscale_ != nullptr + // && dbias_ != nullptr + && partial_sums_ != nullptr + && partial_counts_ != nullptr; + + if (!ptrs_are_set) + die(); + + dim3 grid_dim; + grid_dim.x = div_up(m_, PIXELS_PER_CTA_FWD_INFERENCE); + grid_dim.y = div_up(c_, C_ELEMENTS_PER_CTA); + + // @todo: maybe just move this inside initialize routine? + NhwcBatchNormFwdInferenceParams params; + _setFwdInferenceParams(¶ms); + + nhwc_batch_norm_fwd_inference + + <<>>(params); + checkCudaStatus(name_ + " fwd_inference-relu kernel"); +} + +dim3 NhwcBatchNormAddRelu::calc_fwd_grid(int *loop, const int grid_dim_x) { + dim3 grid_dim; + grid_dim.x = div_up(m_, PIXELS_PER_CTA_FWD); + int c_blks = div_up(c_, C_ELEMENTS_PER_CTA); + unsigned int max_grid_x = grid_dim_x; + if (grid_dim.x <= max_grid_x) { + *loop = 1; + if (max_grid_x / grid_dim.x > 1) { + grid_dim.y = std::min(c_blks, static_cast(max_grid_x / grid_dim.x)); + assert(grid_dim.y 1) { + grid_dim.y = std::min(c_blks, static_cast(max_grid_x / grid_dim.x)); + assert(grid_dim.y> 1); + + dim3 grid_dim = calc_fwd_grid(¶ms.outer_loops, grid_dim_x); + _fwdKernelLauncher(stream, params, grid_dim, params.outer_loops, occupancy, coop); +} + +void NhwcBatchNormAddRelu::dgrad(cudaStream_t stream, void* my_data, void* pair_data, void* pair_data2, void* pair_data3, + const int bn_group, const int magic, const int occupancy, const int grid_dim_x, const bool coop) { + bool ptrs_are_set = + X_tensor_desc_ != nullptr + && Y_tensor_desc_ != nullptr + && scale_ != nullptr + && bias_ != nullptr + && minibatch_mean_ != nullptr + && minibatch_variance_ != nullptr + && relu_bitmask_ != nullptr + // && population_mean_ != nullptr + // && population_variance_ != nullptr + && X_ != nullptr + && dX_ != nullptr + // && Y_ != nullptr + && dY_ != nullptr + && dAddend_ != nullptr + && dscale_ != nullptr + && dbias_ != nullptr + && retired_ctas_ != nullptr; + + if (!ptrs_are_set) + die(); + + // reset of retired_cta_count no longer needed + + NhwcBatchNormBwdParams params; + _setBwdParams(¶ms); + + params.my_data = my_data; + params.pair_datas[0] = pair_data; + params.pair_datas[1] = pair_data2; + params.pair_datas[2] = pair_data3; + params.magic = magic; + params.sync_iters = (bn_group==8)?3:(bn_group >> 1); + params.wgrad_coeff = 1.0 / bn_group; + + dim3 grid_dim = calc_bwd_grid(¶ms.outer_loops, grid_dim_x); + _bwdKernelLauncher(stream, params, grid_dim, params.outer_loops, occupancy, coop); +} + +#endif // MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_ADD_RELU_H_ diff --git a/apex/apex/contrib/csrc/groupbn/cuda_utils.h b/apex/apex/contrib/csrc/groupbn/cuda_utils.h new file mode 100644 index 0000000000000000000000000000000000000000..9f003840c05834e257f256917dd12e63fede9580 --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/cuda_utils.h @@ -0,0 +1,20 @@ +#include +#ifndef CUDA_UTILS_H +#define CUDA_UTILS_H + +namespace at { +namespace cuda { + +namespace utils { + +static inline int MaxSharedMemoryPerMultiprocessor(int device_id) { + return getDeviceProperties(device_id)->sharedMemPerMultiprocessor; +} + + +} +} +} + + +#endif diff --git a/apex/apex/contrib/csrc/groupbn/interface.cpp b/apex/apex/contrib/csrc/groupbn/interface.cpp new file mode 100644 index 0000000000000000000000000000000000000000..8cea5f9d9359899fdbf710ffbebedf947acab5e6 --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/interface.cpp @@ -0,0 +1,175 @@ +#include +#include +#include + +#include +#include +#include +#include +#include "ATen/Scalar.h" +#ifndef VERSION_GE_1_1 +#include "ATen/Type.h" +#endif +#include "ATen/Tensor.h" +#include "ATen/Storage.h" +#include "ATen/Generator.h" + + +namespace py = pybind11; + +int64_t get_buffer_size( + const int bn_sync_steps); + +void* get_data_ptr( + const at::Tensor& data); + +void* get_remote_data_ptr( + const at::Tensor& handle, + const int64_t offset); + +void close_remote_data( + const at::Tensor& handle); + +at::Tensor nhwc_bn_fwd_train( + const at::Tensor& x, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + const bool fuse_relu, + void* my_data, + void* pair_data, + void* pair_data2, + void* pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop); + +at::Tensor nhwc_bn_fwd_eval( + const at::Tensor& x, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& ret_cta, + const int bn_group, + const float momentum, + const float epsilon, + const bool fuse_relu); + +std::vector nhwc_bn_bwd( + const at::Tensor& x, + const at::Tensor& dy, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + const bool fuse_relu, + void* my_data, + void* pair_data, + void* pair_data2, + void* pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop); + +at::Tensor nhwc_bn_addrelu_fwd_train( + const at::Tensor& x, + const at::Tensor& z, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& bitmask, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + void* my_data, + void* pair_data, + void* pair_data2, + void* pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop); + +at::Tensor nhwc_bn_addrelu_fwd_eval( + const at::Tensor& x, + const at::Tensor& z, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& ret_cta, + const int bn_group, + const float momentum, + const float epsilon); + +std::vector nhwc_bn_addrelu_bwd( + const at::Tensor& x, + const at::Tensor& dy, + const at::Tensor& scale, + const at::Tensor& bias, + const at::Tensor& running_mean, + const at::Tensor& running_inv_var, + const at::Tensor& minibatch_mean, + const at::Tensor& minibatch_inv_var, + const at::Tensor& bitmask, + const at::Tensor& ret_cta, + const float momentum, + const float epsilon, + void* my_data, + void* pair_data, + void* pair_data2, + void* pair_data3, + const int bn_group, + const at::Tensor& magic_tensor, + const int occupancy, + const int grid_dim_x, + const bool coop); + +int nhwc_bn_fwd_occupancy(); +int nhwc_bn_bwd_occupancy(); + +int nhwc_bn_addrelu_fwd_occupancy(); +int nhwc_bn_addrelu_bwd_occupancy(); + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + + m.def("get_buffer_size", &get_buffer_size, "get_buffer_size"); + m.def("get_data_ptr", &get_data_ptr, "get_data_ptr"); + m.def("get_remote_data_ptr", &get_remote_data_ptr, "get_remote_data_ptr"); + m.def("close_remote_data", &close_remote_data, "close_remote_data"); + + m.def("bn_fwd_nhwc", &nhwc_bn_fwd_train, "bn_fwd_nhwc"); + m.def("bn_fwd_eval_nhwc", &nhwc_bn_fwd_eval, "bn_fwd_eval_nhwc"); + m.def("bn_bwd_nhwc", &nhwc_bn_bwd, "bn_bwd_nhwc"); + + m.def("bn_fwd_nhwc_occupancy", &nhwc_bn_fwd_occupancy, "bn_fwd_nhwc_occupancy"); + m.def("bn_bwd_nhwc_occupancy", &nhwc_bn_bwd_occupancy, "bn_bwd_nhwc_occupancy"); + + m.def("bn_addrelu_fwd_nhwc", &nhwc_bn_addrelu_fwd_train, "bn_addrelu_fwd_nhwc"); + m.def("bn_addrelu_fwd_eval_nhwc", &nhwc_bn_addrelu_fwd_eval, "bn_addrelu_fwd_eval_nhwc"); + m.def("bn_addrelu_bwd_nhwc", &nhwc_bn_addrelu_bwd, "bn_addrelu_bwd_nhwc"); + + m.def("bn_addrelu_fwd_nhwc_occupancy", &nhwc_bn_addrelu_fwd_occupancy, "bn_addrelu_fwd_nhwc_occupancy"); + m.def("bn_addrelu_bwd_nhwc_occupancy", &nhwc_bn_addrelu_bwd_occupancy, "bn_addrelu_bwd_nhwc_occupancy"); +} + diff --git a/apex/apex/contrib/csrc/groupbn/ipc.cu b/apex/apex/contrib/csrc/groupbn/ipc.cu new file mode 100644 index 0000000000000000000000000000000000000000..b8387c363cb74ad6e491dffab79fb2206d685717 --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/ipc.cu @@ -0,0 +1,132 @@ +#include +#include +#include + +#include "THC/THC.h" + +#include + +#include "compat.h" + + +#define cudaCheckErrors(msg) \ + do { \ + cudaError_t __err = cudaGetLastError(); \ + if (__err != cudaSuccess) { \ + fprintf(stderr, "Fatal error: %s (%s at %s:%d)\n", \ + msg, cudaGetErrorString(__err), \ + __FILE__, __LINE__); \ + fprintf(stderr, "*** FAILED - ABORTING\n"); \ + exit(1); \ + } \ + } while (0) + +template<> +struct std::hash { + size_t operator() (const cudaIpcMemHandle_t& handle) const { + size_t hash = 0; + uint8_t* ptr = (uint8_t*)&handle; + assert(sizeof(uint8_t) == 1); + for (int i=0; i +struct std::equal_to { + bool operator() (const cudaIpcMemHandle_t &lhs, + const cudaIpcMemHandle_t &rhs) const { + return (std::memcmp((void*) &lhs, + (void*) &rhs, + sizeof(cudaIpcMemHandle_t)) == 0); + } +}; + +namespace { + +namespace gpuipc { +//from: src/operator/nn/cudnn/nhwc_batch_norm_kernel.h +// The number of threads per pixel. +const int THREADS_PER_PIXEL = 16; +// The number of elements per ldg. +const int ELEMENTS_PER_LDG = 4; +// The number of reducing ops, each uses its own space : mean, var, dscale, dbias +const int REDUCE_OPS = 4; +// Maximum block.y supported - limited due to buffer allocation +const int MAX_BLOCK_Y = 256; +const int MAX_OFFSET = REDUCE_OPS*MAX_BLOCK_Y; +const int BYTES_PER_ELEM = 4; +// Buffer size per sync step +const int SINGLE_SYNC_BUFFER_BYTES = MAX_OFFSET*THREADS_PER_PIXEL*2*ELEMENTS_PER_LDG*BYTES_PER_ELEM; +}; + +class IpcMemHandleRegistry { +public: + void* getPtr(const cudaIpcMemHandle_t& handle, int64_t offset) { + if (registry_.count(handle) == 0) { + registry_.insert(std::make_pair(handle, RegistryEntry())); + registry_[handle].dev_ptr = ipcOpenMem(handle); + } + registry_[handle].ref_count++; + return (((uint8_t*)registry_[handle].dev_ptr) + offset); + } + + void releasePtr(const cudaIpcMemHandle_t& handle) { + if (registry_.count(handle) == 0) { + } + if (--registry_[handle].ref_count == 0) { + ipcCloseMem(registry_[handle].dev_ptr); + registry_.erase(handle); + } + } + + struct RegistryEntry { + void* dev_ptr; + int ref_count; + RegistryEntry() : dev_ptr(NULL) , ref_count(0) {} + }; + +protected: + std::unordered_map registry_; + + void* ipcOpenMem(const cudaIpcMemHandle_t& handle) { + void *data; + cudaIpcOpenMemHandle(&data, handle, cudaIpcMemLazyEnablePeerAccess); + cudaCheckErrors("ipc init"); + return data; + } + + void ipcCloseMem(void* dev_ptr) { + cudaIpcCloseMemHandle(dev_ptr); + cudaCheckErrors("ipc close"); + } + +}; + +} + +static IpcMemHandleRegistry ipc_mem_registry; + +int64_t get_buffer_size(const int bn_sync_steps) { + return bn_sync_steps * gpuipc::SINGLE_SYNC_BUFFER_BYTES; +} + +void* get_remote_data_ptr(const at::Tensor& handle, const int64_t offset) { + cudaIpcMemHandle_t my_handle; + memcpy((unsigned char *)(&my_handle), handle.DATA_PTR(), sizeof(my_handle)); + return ipc_mem_registry.getPtr(my_handle, offset); +} + +void close_remote_data(const at::Tensor& handle) { + cudaIpcMemHandle_t my_handle; + memcpy((unsigned char *)(&my_handle), handle.DATA_PTR(), sizeof(my_handle)); + ipc_mem_registry.releasePtr(my_handle); +} + +void* get_data_ptr( + const at::Tensor& data) { + return data.DATA_PTR(); +} diff --git a/apex/apex/contrib/csrc/groupbn/nhwc_batch_norm_kernel.h b/apex/apex/contrib/csrc/groupbn/nhwc_batch_norm_kernel.h new file mode 100644 index 0000000000000000000000000000000000000000..8430f3099424c8667a6cb1b4e089fd1d391fad6f --- /dev/null +++ b/apex/apex/contrib/csrc/groupbn/nhwc_batch_norm_kernel.h @@ -0,0 +1,2685 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ + +/*! + * Copyright (c) 2018 by Contributors + * \file nhwc_batch_norm_kernel.h + * \brief CUDA NHWC Batch Normalization code + * \author Shankara Rao Thejaswi Nanditale, Dick Carter, Maxim Milakov, Evgeni Krimer +*/ +#ifndef MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_KERNEL_H_ +#define MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_KERNEL_H_ + +#include +#include + +#define DEVICE_FUNCTION static inline __device__ + +// CTA margin used by cooperative launch. Can be overridden by env var NHWC_BATCHNORM_LAUNCH_MARGIN. +#define NHWC_BATCHNORM_LAUNCH_MARGIN_MIN 3 +#define NHWC_BATCHNORM_LAUNCH_MARGIN_DEFAULT NHWC_BATCHNORM_LAUNCH_MARGIN_MIN + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< typename T, int ELEMENTS_PER_LDG > +struct PackedStorage { + enum { PACKED_ELEMENTS_PER_LDG = ELEMENTS_PER_LDG }; + typedef T Type; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int ELEMENTS_PER_LDG > +struct PackedStorage { + enum { PACKED_ELEMENTS_PER_LDG = ELEMENTS_PER_LDG/2 }; + typedef int Type; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void from_float(int (&dst)[N], const float (&src)[2*N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + uint16_t lo, hi; + asm volatile("cvt.rn.f16.f32 %0, %1;" : "=h"(lo) : "f"(src[2*i+0])); + asm volatile("cvt.rn.f16.f32 %0, %1;" : "=h"(hi) : "f"(src[2*i+1])); + asm volatile("mov.b32 %0, {%1, %2};" : "=r"(dst[i]) : "h"(lo), "h"(hi)); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void from_float(float (&dst)[N], const float (&src)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + dst[i] = src[i]; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void to_float(float (&dst)[2*N], int (&src)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + uint16_t lo, hi; + asm volatile("mov.b32 {%0, %1}, %2;" : "=h"(lo), "=h"(hi) : "r"(src[i])); + asm volatile("cvt.f32.f16 %0, %1;" : "=f"(dst[2*i+0]) : "h"(lo)); + asm volatile("cvt.f32.f16 %0, %1;" : "=f"(dst[2*i+1]) : "h"(hi)); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void to_float(float (&dst)[N], float (&src)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + dst[i] = src[i]; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void ldg(int (&dst)[1], const uint16_t *gmem) { + dst[0] = __ldg((const int*) gmem); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void ldg_stream(int (&dst)[1], const uint16_t *gmem) { + unsigned int tmp; + asm volatile ("ld.global.cs.nc.s32 %0, [%1];" : "=r"(tmp) : "l" ((const uint *)gmem)); + dst[0] = tmp; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void ldg(int (&dst)[2], const uint16_t *gmem) { + int2 tmp = __ldg((const int2*) gmem); + dst[0] = tmp.x; + dst[1] = tmp.y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void ldg_stream(int (&dst)[2], const uint16_t *gmem) { + int2 tmp; + asm volatile ("ld.global.cs.nc.v2.s32 {%0,%1}, [%2];" + : "=r"(tmp.x), "=r"(tmp.y) : "l"((const int2 *)gmem)); + dst[0] = tmp.x; + dst[1] = tmp.y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void ldg(float (&dst)[N], const uint16_t *gmem) { + int tmp[N/2]; + ldg(tmp, gmem); + to_float(dst, tmp); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void ldg_stream(float (&dst)[N], const uint16_t *gmem) { + int tmp[N/2]; + ldg_stream(tmp, gmem); + to_float(dst, tmp); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void stg(uint16_t *gmem, int (&src)[1]) { + reinterpret_cast(gmem)[0] = src[0]; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void stg_stream(uint16_t *gmem, int (&src)[1]) { + unsigned int tmp = src[0]; + asm volatile ("st.global.cs.s32 [%0], %1;" + :: "l"((uint *)gmem) , "r"(tmp)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void stg(uint16_t *gmem, int (&src)[2]) { + reinterpret_cast(gmem)[0] = make_int2(src[0], src[1]); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void stg_stream(uint16_t *gmem, int (&src)[2]) { + asm volatile ("st.global.cs.v2.s32 [%0], {%1,%2};" + :: "l"((uint *)gmem) , "r"(src[0]), "r"( src[1])); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void stg(uint16_t *gmem, float (&src)[N]) { + int tmp[N/2]; + from_float(tmp, src); + stg(gmem, tmp); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void stg_stream(uint16_t *gmem, float (&src)[N]) { + int tmp[N/2]; + from_float(tmp, src); + stg_stream(gmem, tmp); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void read_from_gmem(float (&dst)[2], const float *gmem, int idx) { + float2 tmp = __ldg(reinterpret_cast(&gmem[2*idx])); + dst[0] = tmp.x; + dst[1] = tmp.y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void read_from_gmem(float (&dst)[4], const float *gmem, int idx) { + float4 tmp = __ldg(reinterpret_cast(&gmem[4*idx])); + dst[0] = tmp.x; + dst[1] = tmp.y; + dst[2] = tmp.z; + dst[3] = tmp.w; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void read_from_smem(float (&x)[2], const float *smem, int idx) { + float2 tmp = *(const float2*) &smem[2*idx]; + x[0] = tmp.x; + x[1] = tmp.y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void read_from_smem(int (&x)[1], const int *smem, int idx) { + x[0] = smem[idx]; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void read_from_smem(float (&x)[4], const float *smem, int idx) { + float4 tmp = *(const float4*) &smem[4*idx]; + x[0] = tmp.x; + x[1] = tmp.y; + x[2] = tmp.z; + x[3] = tmp.w; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void read_from_smem(int (&x)[2], const int *smem, int idx) { + int2 tmp = *(const int2*) &smem[2*idx]; + x[0] = tmp.x; + x[1] = tmp.y; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void write_to_gmem(float *gmem, int idx, const float (&src)[2]) { + reinterpret_cast(&gmem[2*idx])[0] = make_float2(src[0], src[1]); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void write_to_gmem(float *gmem, int idx, const float (&src)[4]) { + reinterpret_cast(&gmem[4*idx])[0] = make_float4(src[0], src[1], src[2], src[3]); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void scaled_write_to_gmem(float *gmem, int idx, const float (&src)[4], const float coeff) { + reinterpret_cast(&gmem[4*idx])[0] = make_float4(src[0]*coeff, src[1]*coeff, src[2]*coeff, src[3]*coeff); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void write_to_smem(float *smem, int idx, const float (&x)[2]) { + reinterpret_cast(&smem[2*idx])[0] = make_float2(x[0], x[1]); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void write_to_smem(int *smem, int idx, const int (&x)[1]) { + smem[idx] = x[0]; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void write_to_smem(float *smem, int idx, const float (&x)[4]) { + reinterpret_cast(&smem[4*idx])[0] = make_float4(x[0], x[1], x[2], x[3]); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +DEVICE_FUNCTION void write_to_smem(int *smem, int idx, const int (&x)[2]) { + reinterpret_cast(&smem[2*idx])[0] = make_int2(x[0], x[1]); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void zero_array(int (&dst)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + dst[i] = 0; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int N > +DEVICE_FUNCTION void zero_array(float (&dst)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + dst[i] = 0.f; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void add(float (&x)[N], const float (&y)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + x[i] += y[i]; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void multiply(float (&x)[N], const float (&y)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + x[i] *= y[i]; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void scale_(float (&x)[N], float scalar) { + #pragma unroll + for (int i = 0; i < N; ++i) { + x[i] *= scalar; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void normalize(float (&x)[N], const float (&bias)[N], + const float (&scale)[N], const float (&m1)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + x[i] = bias[i] + scale[i] * (x[i] - m1[i]); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION Storage relu(Storage in) { + Storage zero = (Storage)0.f; + return (in < zero)? zero : in; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void relu_activation(float (&x)[N]) { + #pragma unroll + for (int i = 0; i < N; ++i) { + x[i] = relu(x[i]); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +template< int THREADS_PER_CTA > +DEVICE_FUNCTION void parallel_sums_16x2(float *smem, float (&x)[4], int nhw, + void* params_my_data, void** params_pair_datas, int off, + const int magic, + const int sync_iters) { + // The size of a warp. + const int THREADS_PER_WARP = 32; + // The number of warps in a CTA. + const int WARPS_PER_CTA = THREADS_PER_CTA / THREADS_PER_WARP; + // The number of threads per pixel. + const int THREADS_PER_PIXEL = 16; + // The number of elements per ldg. + const int ELEMENTS_PER_LDG = 4; + // The number of reducing ops, each uses its own space : mean, var, dscale, dbias + const int REDUCE_OPS = 4; + // Maximum block.y supported - limited due to buffer allocation + const int MAX_BLOCK_Y = 256; + const int MAX_OFFSET = REDUCE_OPS*MAX_BLOCK_Y; + // The warp decomposition. + const int warp_id = threadIdx.x / THREADS_PER_WARP; + const int lane_id = threadIdx.x % THREADS_PER_WARP; + // total size of data per sync iter + const int data_total = MAX_OFFSET*THREADS_PER_PIXEL*ELEMENTS_PER_LDG*2; + + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + x[i] += __shfl_sync(0xffffffffU, x[i], THREADS_PER_PIXEL+lane_id); + } + + // The warp leaders, write to SMEM. + if (lane_id < THREADS_PER_PIXEL) { + write_to_smem(smem, warp_id*THREADS_PER_PIXEL + lane_id, x); + } + + // The data is in SMEM. Do the final reduction. + __syncthreads(); + + // The 1st warp does all the work. + // We do the final reduction each half-warp sequentially reduces the final values. + if (warp_id == 0) { + read_from_smem(x, smem, threadIdx.x); + + #pragma unroll + for (int offset = 1; + offset < WARPS_PER_CTA/(THREADS_PER_WARP / THREADS_PER_PIXEL); ++offset) { + float y[ELEMENTS_PER_LDG]; + // Read the mean and variance from the other pixel. + read_from_smem(y, smem, threadIdx.x + offset*THREADS_PER_WARP); + // Compute the updated sum. + add(x, y); + } + + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + x[i] += __shfl_sync(0xffffffffU, x[i], THREADS_PER_PIXEL+lane_id); + } + + // Make sure the data was read from SMEM. + __syncwarp(); + + // Store the final values. + if (threadIdx.x < THREADS_PER_PIXEL) { + // probably could do it earlier, before sync + + for (int sync_iter=0; sync_iter < sync_iters; ++sync_iter) { + //float* params_pair_data = (reinterpret_cast(params_pair_datas))[sync_iter]; + void* params_pair_data = params_pair_datas[sync_iter]; + + // skip the space consumed by previous sync iterations + const int xbuf_offset = sync_iter*data_total; + // data starts after flags, but have to skip previous + const int data_offset = xbuf_offset + + off*ELEMENTS_PER_LDG*THREADS_PER_PIXEL*2 + + ELEMENTS_PER_LDG*threadIdx.x*2; + + // after sums for this GPU were computed, let CTA0 broadcast the sum to over GPU + if (blockIdx.x == 0) { + volatile float * write_data = + &((reinterpret_cast(params_pair_data))[data_offset]); + + // write the data to memory region to be reflected to other GPU + asm volatile ("st.global.wt.v4.b32 [%0], {%1,%2,%3,%4};" + :: "l"(write_data) , "f"(x[0]), "r"(magic), "f"(x[2]), "r"(magic)); + + asm volatile ("st.global.wt.v4.b32 [%0], {%1,%2,%3,%4};" + :: "l"(write_data+4) , "f"(x[1]), "r"(magic), "f"(x[3]), "r"(magic)); + } + + // now each CTA (on each GPU) reads the data written by CTA 0 of the other GPU + volatile float * read_data = + &((reinterpret_cast(params_my_data))[data_offset]); + + float other[4]; + uint32_t other_flag_a, other_flag_b; + do { + asm volatile ("ld.volatile.global.v4.b32 {%0, %1, %2, %3}, [%4];" + : "=f"(other[0]), "=r"(other_flag_a), "=f"(other[2]), "=r"(other_flag_b) : "l"(read_data)); + } while ((other_flag_a != magic) || (other_flag_b != magic)); + + do { + asm volatile ("ld.volatile.global.v4.b32 {%0, %1, %2, %3}, [%4];" + : "=f"(other[1]), "=r"(other_flag_a), "=f"(other[3]), "=r"(other_flag_b) : "l"(read_data+4)); + } while ((other_flag_a != magic) || (other_flag_b != magic)); + + add(x, other); + } + // finally, after syncing up and accounting for partial sums from + // other GPUs as required, write the result + + + write_to_smem(smem, threadIdx.x, x); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int THREADS_PER_CTA > +DEVICE_FUNCTION void parallel_sums_8x4(float *smem, float (&x)[4], int nhw) { + // The size of a warp. + const int THREADS_PER_WARP = 32; + // The number of warps in a CTA. + const int WARPS_PER_CTA = THREADS_PER_CTA / THREADS_PER_WARP; + // The number of threads per pixel. + const int THREADS_PER_PIXEL = 8; + // The number of elements per ldg. + const int ELEMENTS_PER_LDG = 4; + // The warp decomposition. + const int warp_id = threadIdx.x / THREADS_PER_WARP; + const int lane_id = threadIdx.x % THREADS_PER_WARP; + + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + x[i] += __shfl_sync(0xffffffffU, x[i], THREADS_PER_PIXEL+lane_id); + x[i] += __shfl_sync(0xffffffffU, x[i], THREADS_PER_PIXEL*2+lane_id); + } + + // The warp leaders, write to SMEM. + if (lane_id < THREADS_PER_PIXEL) { + write_to_smem(smem, warp_id*THREADS_PER_PIXEL + lane_id, x); + } + + // The data is in SMEM. Do the final reduction. + __syncthreads(); + + // The 1st warp does all the work. + // We do the final reduction each half-warp sequentially reduces the final values. + if (warp_id == 0) { + read_from_smem(x, smem, threadIdx.x); + + #pragma unroll + for (int offset = 1; + offset < WARPS_PER_CTA/(THREADS_PER_WARP / THREADS_PER_PIXEL); ++offset) { + float y[ELEMENTS_PER_LDG]; + // Read the mean and variance from the other pixel. + read_from_smem(y, smem, threadIdx.x + offset*THREADS_PER_WARP); + // Compute the updated sum. + add(x, y); + } + + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + x[i] += __shfl_sync(0xffffffffU, x[i], THREADS_PER_PIXEL+lane_id); + x[i] += __shfl_sync(0xffffffffU, x[i], THREADS_PER_PIXEL*2+lane_id); + } + + // Make sure the data was read from SMEM. + __syncwarp(); + + // Store the final values. + if (threadIdx.x < THREADS_PER_PIXEL) { + write_to_smem(smem, threadIdx.x, x); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int THREADS_PER_CTA, int THREADS_PER_PIXEL, int ELEMENTS_PER_LDG > +DEVICE_FUNCTION void parallel_sums(float *smem, float (&x)[ELEMENTS_PER_LDG], int nhw) { + // The size of a warp. + const int THREADS_PER_WARP = 32; + // The number of warps in a CTA. + const int WARPS_PER_CTA = THREADS_PER_CTA / THREADS_PER_WARP; + // The number of pixels computed by a single warp. + const int PIXELS_PER_WARP = THREADS_PER_WARP / THREADS_PER_PIXEL; + + // The position in the warp. + const int nhw_in_warp = nhw % PIXELS_PER_WARP; + // The C in the warp. + const int c_in_warp = threadIdx.x % THREADS_PER_PIXEL; + + // Store the values to shared memory. + write_to_smem(smem, threadIdx.x, x); + + // Compute the parallel sums. + for (int offset = PIXELS_PER_WARP/2; offset > 0; offset /= 2) { + // NOP. + __syncwarp(); + + // Read the running sum from the other thread. + float y[ELEMENTS_PER_LDG]; + if (nhw_in_warp < offset) { + read_from_smem(y, smem, threadIdx.x + offset*THREADS_PER_PIXEL); + } + + // Compute the updated sum. + add(x, y); + + // NOP. + __syncwarp(); + + // Update the sum in SMEM. + if (offset > 1 && nhw_in_warp < offset) { + write_to_smem(smem, threadIdx.x, x); + } + } + + // The warps are done. Do the final reduction at the CTA level. + __syncthreads(); + + // The warp leaders, write to SMEM. + const int idx = (threadIdx.x/THREADS_PER_WARP)*THREADS_PER_PIXEL + c_in_warp; + if (nhw_in_warp == 0) { + write_to_smem(smem, idx, x); + } + + // The data is in SMEM. Do the final reduction. + __syncthreads(); + + // Read the 1st element to prepare the work. + if (nhw < WARPS_PER_CTA/2) { + read_from_smem(x, smem, threadIdx.x); + } + + // We have the running mean and running m2. Let's build the mean/var of the CTA. + for (int offset = WARPS_PER_CTA/2; offset > 0; offset /= 2) { + // NOP. + __syncwarp(); + + // Read the mean and variance from the other pixel. + float y[ELEMENTS_PER_LDG]; + if (nhw < offset) { + read_from_smem(y, smem, threadIdx.x + offset*THREADS_PER_PIXEL); + } + + // Compute the updated sum. + add(x, y); + + // NOP. + __syncwarp(); + + // Store the mean/var for the different pixels. + if (nhw < offset) { + write_to_smem(smem, threadIdx.x, x); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< int THREADS_PER_PIXEL, int ELEMENTS_PER_LDG > +struct ParallelSums { + template< int THREADS_PER_CTA > + DEVICE_FUNCTION void dispatch(float *smem, float (&x)[ELEMENTS_PER_LDG], int nhw) { + parallel_sums(smem, x, nhw); + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template<> +struct ParallelSums<16, 4> { + template< int THREADS_PER_CTA > + DEVICE_FUNCTION void dispatch(float *smem, float (&x)[4], int nhw) { + parallel_sums_16x2(smem, x, nhw, 0, 0, 0, 0, 0); + } + + template< int THREADS_PER_CTA > + DEVICE_FUNCTION void dispatchX(float *smem, float (&x)[4], int nhw, void* params_my_data, void** params_pair_datas, int off, const int magic, const unsigned int& sync_iters) { + parallel_sums_16x2(smem, x, nhw, params_my_data, params_pair_datas, off, magic, sync_iters); + } +}; + +template<> +struct ParallelSums<8, 4> { + template< int THREADS_PER_CTA > + DEVICE_FUNCTION void dispatch(float *smem, float (&x)[4], int nhw) { + parallel_sums_8x4(smem, x, nhw); + } +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +static inline int div_up(int m, int n) { + return (m + n - 1) / n; +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +// It is expected that all threads in the CTA enter this function! +DEVICE_FUNCTION void inter_block_sync(int* gmem_retired_ctas, int expected_count, bool master) { + + // Register the CTA. + if (threadIdx.x == 0) { + // Issue the membar. + __threadfence(); + // Notify that the CTA is done. + int val_to_add = 1; + if (master) { + val_to_add = -(expected_count - 1); + } + atomicAdd(gmem_retired_ctas, val_to_add); + } + + // Are all CTAs done? + if (threadIdx.x == 0) { + int retired_ctas = -1; + do { + __threadfence(); + asm volatile ("ld.global.cg.b32 %0, [%1];" + : "=r"(retired_ctas) : "l"(gmem_retired_ctas)); + } while (retired_ctas != 0); + } + __syncthreads(); + +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct NhwcBatchNormFwdInferenceParams { + // The input/output tensors. + uint16_t *gmem_src, *gmem_dst, *gmem_src1; + // the final mean and variance as calculated during the training process + float *gmem_mean, *gmem_var; + // The bias/scale. + float *gmem_bias, *gmem_scale; + // The dimensions. + int nhw, c; + // epsilon + float var_eps; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +// No DESIRED_OCCUPANCY launch bounds needed, as this is not launched cooperatively +template< + typename Storage, + int THREADS_PER_CTA, + int THREADS_PER_PIXEL, + int ELEMENTS_PER_LDG, + bool USE_RELU, + bool USE_ADD_RELU +> +__global__ __launch_bounds__(THREADS_PER_CTA) + void nhwc_batch_norm_fwd_inference(NhwcBatchNormFwdInferenceParams params) { + // The number of pixels loaded in a single LDG. + const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + // The number of C elements per CTA. + const int C_ELEMENTS_PER_CTA = THREADS_PER_PIXEL*ELEMENTS_PER_LDG; + + // The start position in the NHW dimension where the CTA starts. + const int cta_nhw_stride = gridDim.x * PIXELS_PER_LDG; + // Compute the NHW coordinate of the thread in the CTA. + const int thread_in_cta_nhw = threadIdx.x / THREADS_PER_PIXEL; + // thread's starting point in NHW + const int thread_nhw = thread_in_cta_nhw + blockIdx.x * PIXELS_PER_LDG; + + // The position in the C dimension where the CTA starts. + const int cta_c = blockIdx.y * C_ELEMENTS_PER_CTA; + // Compute the C coordinate of the thread in the CTA. + const int thread_in_cta_c = threadIdx.x % THREADS_PER_PIXEL; + // Compute the C coordinate of the thread. + const int thread_c = cta_c + thread_in_cta_c*ELEMENTS_PER_LDG; + + // Is the thread working on a valid C dimension? + const int is_valid_c = thread_c < params.c; + + float mean[ELEMENTS_PER_LDG], var[ELEMENTS_PER_LDG]; + float scale[ELEMENTS_PER_LDG], bias[ELEMENTS_PER_LDG]; + zero_array(mean); + zero_array(var); + zero_array(scale); + zero_array(bias); + if (is_valid_c) { + read_from_gmem(var, ¶ms.gmem_var[cta_c], thread_in_cta_c); + read_from_gmem(scale, ¶ms.gmem_scale[cta_c], thread_in_cta_c); + read_from_gmem(mean, ¶ms.gmem_mean[cta_c], thread_in_cta_c); + read_from_gmem(bias, ¶ms.gmem_bias[cta_c], thread_in_cta_c); + } + + // Update the scale with the stddev and eps. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + scale[i] *= rsqrtf(var[i] + params.var_eps); + } + + // The base pointers for reading/writing + uint16_t *const gmem_src = ¶ms.gmem_src[thread_c]; + uint16_t *const gmem_dst = ¶ms.gmem_dst[thread_c]; + const uint16_t *gmem_src1 = nullptr; + if (USE_ADD_RELU) { + gmem_src1 = ¶ms.gmem_src1[thread_c]; + } + + // apply BN + for (int nhw = thread_nhw; nhw < params.nhw; nhw += cta_nhw_stride) { + float x_math[ELEMENTS_PER_LDG]; + zero_array(x_math); + if (is_valid_c) { + ldg(x_math, &gmem_src[nhw*params.c]); + } + + // Normalize and apply activation function + normalize(x_math, bias, scale, mean); + if (USE_ADD_RELU) { + float x1_math[ELEMENTS_PER_LDG]; + ldg(x1_math, &gmem_src1[nhw*params.c]); + add(x_math, x1_math); + relu_activation(x_math); + } else if (USE_RELU) { + relu_activation(x_math); + } + + if (is_valid_c) { + stg(&gmem_dst[nhw*params.c], x_math); + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct NhwcBatchNormFwdParams { + // The input/output tensors. + uint16_t *gmem_src, *gmem_dst, *gmem_src1; + // The bias/scale. + float *gmem_bias, *gmem_scale; + // running mean/var (refer BN API from cudnn doc) + float *gmem_running_mean, *gmem_running_var; + // saved mean/var (refer BN API from cudnn doc) + float *gmem_saved_mean, *gmem_saved_var; + // ReLU bitmask + unsigned int *gmem_relu_bitmask; + // The dimensions. + int nhw, c; + // factor to scale sum of squared errors to get saved variance. Must be 1/nhw. + float svar_inv_count; + // factor to scale sum of squared errors to get running variance. Should be 1/nhw or 1/(nhw-1). + float rvar_inv_count; + // The buffer to do the reduction for mean, stddev and count. + float *gmem_sums; + // The buffer to count items in the different CTAs. + int *gmem_counts; + // The counters of retired CTAs. + int *gmem_retired_ctas; + // The epsilon to apply to the computation of the variance. + float var_eps; + // outer loop count + int outer_loops; + // exponential average factor + float exp_avg_factor; + // number of CTAs along .x dimension + int c_blks; + + void* my_data; + void* pair_datas[4]; + int magic; + int sync_iters; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + typename Storage, + int THREADS_PER_CTA, + int THREADS_PER_PIXEL, + int PIXELS_PER_THREAD_IN_REGISTERS, + int PIXELS_PER_THREAD_IN_SMEM, + int ELEMENTS_PER_LDG, + int USE_ONLINE_APPROACH, + int OUTER_LOOPS_, + bool USE_RELU, + bool USE_ADD_RELU, + int DESIRED_OCCUPANCY +> +__global__ __launch_bounds__(THREADS_PER_CTA, DESIRED_OCCUPANCY) + void nhwc_batch_norm_fwd(NhwcBatchNormFwdParams params) { + // The number of pixels loaded in a single LDG. + const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + // The number of pixels computed per CTA stored in registers. + const int PIXELS_PER_CTA_IN_REGISTERS = PIXELS_PER_THREAD_IN_REGISTERS * PIXELS_PER_LDG; + // The number of pixels computed per CTA stored in SMEM. + const int PIXELS_PER_CTA_IN_SMEM = PIXELS_PER_THREAD_IN_SMEM*PIXELS_PER_LDG; + // The number of C elements per CTA. + const int C_ELEMENTS_PER_CTA = THREADS_PER_PIXEL*ELEMENTS_PER_LDG; + + // Shared memory to do CTA-wide parallel sums. + __shared__ float smem[THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG]; + + // Compute the NHW coordinate of the thread in the CTA. + const int thread_in_cta_nhw = threadIdx.x / THREADS_PER_PIXEL; + + // The adapter for the storage. + typedef PackedStorage PackedStorage_; + // The data type for packed storage in SMEM. + typedef typename PackedStorage_::Type PackedStorageType; + // The number of elements in the packed storage. + const int PACKED_ELEMENTS_PER_LDG = PackedStorage_::PACKED_ELEMENTS_PER_LDG; + // Registers to keep the data live for the persistent approach. + PackedStorageType x_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + + // Shared memory buffer to store the extra pixels. + extern __shared__ PackedStorageType smem_storage_packed[]; + + for (int c_blk_index = blockIdx.y; c_blk_index < params.c_blks; c_blk_index += gridDim.y) { + // The position in the NHW dimension where the CTA starts. + int cta_nhw_regs = blockIdx.x * PIXELS_PER_CTA_IN_REGISTERS; + // The position in the NHW dimension where the CTA starts for the portion in SMEM. + int cta_nhw_smem = blockIdx.x * PIXELS_PER_CTA_IN_SMEM; + + // The position in the C dimension where the CTA starts. + const int cta_c = c_blk_index * C_ELEMENTS_PER_CTA; + // Compute the C coordinate of the thread in the CTA. + const int thread_in_cta_c = threadIdx.x % THREADS_PER_PIXEL; + // Compute the C coordinate of the thread. + int thread_c = cta_c + thread_in_cta_c*ELEMENTS_PER_LDG; + + // Is the thread working on a valid C dimension? + const int is_valid_c = thread_c < params.c; + + // Clamp thread_c so that we load from valid locations even if we don't use the value + if (!is_valid_c) + thread_c = params.c - 4; + + // Single pass numerically stable algorithm, see: + // https://en.wikipedia.org/wiki/Algorithms_for_calculating_variance#Online_algorithm + // + // n = 0, mean = 0.0, M2 = 0.0 + // + // for x in data: + // n += 1 + // delta = x - mean + // mean += delta/n + // delta2 = x - mean + // M2 += delta*delta2 + // + // if n < 2: + // return float('nan') + // else: + // return M2 / (n - 1) + + // Register to store the number of elements read so far. + float count = 0.f, mean[ELEMENTS_PER_LDG], m2[ELEMENTS_PER_LDG]; + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + mean[i] = 0.f; + m2[i] = 0.f; + } + + // The number of elements loaded by this CTA. + int cta_count = 0; + // The base pointer to load from. + const uint16_t *gmem_src = ¶ms.gmem_src[thread_c]; + + // outer loops + int OUTER_LOOPS = OUTER_LOOPS_ == 1? 1 : params.outer_loops; + // Load the batch of elements. Compute the mean/var across those elements. + const int pixels_per_iteration = PIXELS_PER_CTA_IN_REGISTERS*gridDim.x; + + if (OUTER_LOOPS_ != 1) { + // We cannot load everything to store persistently, so let's makes sure registers and + // smem are fully utilized, offset is evenly divisible by 32 + int offset = (pixels_per_iteration * OUTER_LOOPS + + PIXELS_PER_CTA_IN_SMEM * gridDim.x - params.nhw) & ~31; + cta_nhw_regs -= offset; + cta_nhw_smem -= offset; + } + + #pragma unroll 1 + for (int loop_i = 0; loop_i < OUTER_LOOPS; ++loop_i) { + // The nhw position. + int nhw_regs = cta_nhw_regs + loop_i*pixels_per_iteration; + // Update the number of elements loaded by this CTA. TODO: Skip if <= 0!!! + cta_count += max(min(nhw_regs + PIXELS_PER_CTA_IN_REGISTERS, params.nhw) - + max(nhw_regs, 0), 0); + + // Load the data and compute the local mean/sum and the variance. + if (USE_ONLINE_APPROACH) { + // Read the elements from memory. + float is_valid[PIXELS_PER_THREAD_IN_REGISTERS]; + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = nhw_regs + thread_in_cta_nhw + i*PIXELS_PER_LDG; + zero_array(x_storage[i]); + is_valid[i] = 0.f; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + if (loop_i == OUTER_LOOPS - 1) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + } else { + ldg(x_storage[i], &gmem_src[idx*params.c]); + } + is_valid[i] = 1.f; + } + } + + // Do the math. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float. + float x_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + + // Update the count. + count += is_valid[i]; + // Invert the count. + float inv_count = is_valid[i] ? 1.f / count : 0.f; + + // Update the mean and m2 using deltas. + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + float delta0 = x_math[j] - mean[j]; + mean[j] += delta0 * inv_count; + float delta1 = x_math[j] - mean[j]; + m2[j] += delta0 * delta1 * is_valid[i]; + } + } + } else { + // Read the elements from memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = nhw_regs + thread_in_cta_nhw + i*PIXELS_PER_LDG; + zero_array(x_storage[i]); + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + if (loop_i == OUTER_LOOPS - 1) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + } else { + ldg(x_storage[i], &gmem_src[idx*params.c]); + } + count += 1.f; + } + } + + // Sum the elements in registers. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float. + float x_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + + // Update the mean and m2 using deltas. + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + mean[j] += x_math[j]; + } + } + + // Compute the mean. + float inv_count = 1.f / count; + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + mean[j] *= inv_count; + } + + // Compute the variance. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float. + float x_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + + // Is it a valid pixel? + float is_valid = i < static_cast(count) ? 1.f : 0.f; + // Update the mean and m2 using deltas. + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + m2[j] += (x_math[j] - mean[j]) * (x_math[j] - mean[j]) * is_valid; + } + } + } + } + + // The elements to load and store in SMEM. + int smem_nhw = OUTER_LOOPS*pixels_per_iteration + cta_nhw_smem; + // Load elements from SMEM, update the CTA count. + int pixels_in_smem = min(smem_nhw + PIXELS_PER_CTA_IN_SMEM, params.nhw) - max(smem_nhw, 0); + if (pixels_in_smem > 0) { + cta_count += pixels_in_smem; + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + float is_pixel_valid = (((unsigned int)idx < + (unsigned int)params.nhw) && is_valid_c) ? 1.f : 0.f; + + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG]; + ldg_stream(x_storage_local, &gmem_src[(is_pixel_valid ? idx : 0)*params.c]); + + // The offset to store in SMEM. + const int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + // Store in SMEM. + write_to_smem(&smem_storage_packed[offset], threadIdx.x, x_storage_local); + // Update the count. + count += is_pixel_valid; + // Invert the count. + float inv_count = is_pixel_valid ? 1.f / count : 0.f; + + float x_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + // Update the mean and m2 using deltas. + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + float delta0 = x_math[j] - mean[j]; + mean[j] += delta0 * inv_count; + float delta1 = x_math[j] - mean[j]; + m2[j] += delta0 * delta1 * is_pixel_valid; + } + } + } + + // We scale the mean by the number of elements. It brings more stability. + float m1[ELEMENTS_PER_LDG]; + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + m1[i] = mean[i] * count; + } + + // Run the parallel sum accross the CTA to get the local sum. + ParallelSums::dispatch( + smem, m1, thread_in_cta_nhw); + __syncthreads(); + + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(m1, smem, thread_in_cta_c); + __syncthreads(); + + // Adjust the variance. + float inv_cta_count = 1.f / static_cast(cta_count); + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + float mean_diff = m1[i]*inv_cta_count - mean[i]; + m2[i] = m2[i] + mean_diff * mean_diff * count; + } + + // Run the parallel sum accross the CTA to get the local adjusted variance. + ParallelSums::dispatch( + smem, m2, thread_in_cta_nhw); + + // The workspace in global memory is distributed across the different CTA. + int gmem_sums_offset = c_blk_index*gridDim.x*C_ELEMENTS_PER_CTA*2; + + // Write the data for the CTA to global memory. + float *gmem_sums = ¶ms.gmem_sums[gmem_sums_offset]; + if (threadIdx.x < THREADS_PER_PIXEL) { + const int idx = blockIdx.x*THREADS_PER_PIXEL + threadIdx.x; + write_to_gmem(&gmem_sums[ 0], idx, m1); + write_to_gmem(&gmem_sums[C_ELEMENTS_PER_CTA*gridDim.x], idx, m2); + } + + // The memory location to store the number of pixels per CTA. + int *gmem_counts = ¶ms.gmem_counts[c_blk_index*gridDim.x]; + if (threadIdx.x == 0) { + gmem_counts[blockIdx.x] = cta_count; + } + + // Read the bias and scale. + float bias[ELEMENTS_PER_LDG], scale[ELEMENTS_PER_LDG]; + if (is_valid_c) { + read_from_gmem(bias, ¶ms.gmem_bias[cta_c], thread_in_cta_c); + read_from_gmem(scale, ¶ms.gmem_scale[cta_c], thread_in_cta_c); + } + + // The counters to count how many CTAs have retired at this point. + // A given cta uses the same counter every other time through the outer loop. + int *gmem_retired_ctas = ¶ms.gmem_retired_ctas[c_blk_index % (2 * gridDim.y)]; + inter_block_sync(gmem_retired_ctas, gridDim.x, blockIdx.x == 0); + + // Reset the mean to compute the global mean. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + m1[i] = 0.f; + } + + // Build the global mean. + #pragma unroll 1 + for (int idx = threadIdx.x; idx < THREADS_PER_PIXEL*gridDim.x; idx += THREADS_PER_CTA) { + float tmp[ELEMENTS_PER_LDG]; + read_from_gmem(tmp, gmem_sums, idx); + add(m1, tmp); + } + + if (params.sync_iters>0) + { + ParallelSums::dispatchX( + smem, m1, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+3, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, m1, thread_in_cta_nhw); + } + __syncthreads(); + + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(m1, smem, thread_in_cta_c); + __syncthreads(); + + // Normalize the mean. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + m1[i] = m1[i] * params.svar_inv_count; + } + + // Reset the variance. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + m2[i] = 0.f; + } + + // for add+relu fusion + const uint16_t *gmem_src1 = nullptr; + if (USE_ADD_RELU) { + gmem_src1 = ¶ms.gmem_src1[thread_c]; + } + + // Build the global variance. + #pragma unroll 1 + for (int idx = threadIdx.x; idx < THREADS_PER_PIXEL*gridDim.x; idx += THREADS_PER_CTA) { + // Read the means computed by different CTAs (again). Reuse tmp if we have 1 iteration. + float tmp_mean[ELEMENTS_PER_LDG], tmp_var[ELEMENTS_PER_LDG]; + read_from_gmem(tmp_mean, &gmem_sums[ 0], idx); + read_from_gmem(tmp_var, &gmem_sums[C_ELEMENTS_PER_CTA*gridDim.x], idx); + + // Read the number of pixels visited by a given CTA. + cta_count = __ldg(&gmem_counts[idx / THREADS_PER_PIXEL]); + + // Compute the diff to update the variance. + float mean_diff[ELEMENTS_PER_LDG], inv_cta_count = 1.f / static_cast(cta_count); + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + mean_diff[i] = m1[i] - tmp_mean[i]*inv_cta_count; + } + + // Update the variance. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + m2[i] += tmp_var[i] + mean_diff[i]*mean_diff[i]*static_cast(cta_count); + } + } + + if (params.sync_iters>0) + { + ParallelSums::dispatchX( + smem, m2, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+2, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, m2, thread_in_cta_nhw); + } + __syncthreads(); + + read_from_smem(m2, smem, thread_in_cta_c); + + // Finalize the stddev. + // becasue saved var and running var may have different denominator, we don't do it here + // scale_(m2, inv_count); + + // store the saved mean/var + float svarinv[ELEMENTS_PER_LDG]; + bool is_valid_for_saving = is_valid_c && blockIdx.x == 0 && thread_in_cta_nhw == 0; + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + svarinv[i] = rsqrtf(m2[i] * params.svar_inv_count + params.var_eps); + } + if (is_valid_for_saving) { + write_to_gmem(params.gmem_saved_mean, thread_c/ELEMENTS_PER_LDG, m1); + write_to_gmem(params.gmem_saved_var, thread_c/ELEMENTS_PER_LDG, svarinv); + } + + // store the running mean/var + float rmean[ELEMENTS_PER_LDG], rvar[ELEMENTS_PER_LDG]; + zero_array(rmean); + zero_array(rvar); + if (params.exp_avg_factor != 1.f && is_valid_for_saving) { + read_from_gmem(rmean, params.gmem_running_mean, thread_c/ELEMENTS_PER_LDG); + read_from_gmem(rvar, params.gmem_running_var, thread_c/ELEMENTS_PER_LDG); + } + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + rmean[i] = (1.f - params.exp_avg_factor) * rmean[i] + \ + params.exp_avg_factor * m1[i]; + rvar[i] = (1.f - params.exp_avg_factor) * rvar[i] + \ + params.exp_avg_factor * (m2[i] * params.rvar_inv_count); + } + if (is_valid_for_saving) { + write_to_gmem(params.gmem_running_mean, thread_c/ELEMENTS_PER_LDG, rmean); + write_to_gmem(params.gmem_running_var, thread_c/ELEMENTS_PER_LDG, rvar); + } + + // Update the scale with the stddev and eps. + multiply(scale, svarinv); + + // The base pointer to write to. + uint16_t *const gmem_dst = ¶ms.gmem_dst[thread_c]; + + unsigned int *const gmem_relu_bitmask = params.gmem_relu_bitmask + + ((params.nhw + 31) & ~31) * 2 * c_blk_index; + + // Store the elements in registers. + #pragma unroll 1 + for (int loop_i = OUTER_LOOPS-1; loop_i >= 0; --loop_i) { + // The value for nhw. + int out_nhw = cta_nhw_regs + loop_i*pixels_per_iteration; + + // Normalize the elements and write to memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_valid_nhw = + static_cast(idx) < static_cast(params.nhw); + const bool is_valid = is_valid_nhw && is_valid_c; + // Convert to float. + float x_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + + // Normalize and apply activation function + normalize(x_math, bias, scale, m1); + if (USE_ADD_RELU) { + float x1_math[ELEMENTS_PER_LDG]; + ldg_stream(x1_math, &gmem_src1[(is_valid ? idx : 0)*params.c]); + add(x_math, x1_math); + unsigned int relu_mask; + int lane_id = threadIdx.x & 31; + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + bool rectified = x_math[i] < 0.0F; + unsigned int local_relu_mask = __ballot_sync(0xFFFFFFFFU, rectified); + if (lane_id == i) { + // Thread 0 remembers the relu_mask from the first time through this + // loop, Thread 1 the next, Thread 2 the next, and Thread 3 the last. + relu_mask = local_relu_mask; + } + if (rectified) { + x_math[i] = 0.0F; + } + } + if (is_valid_nhw && (lane_id < ELEMENTS_PER_LDG)) { + gmem_relu_bitmask[idx * 2 + lane_id] = relu_mask; + } + } else if (USE_RELU) { + relu_activation(x_math); + } + + // Write back. + if (is_valid) { + stg_stream(&gmem_dst[idx*params.c], x_math); + } + } + + // The next value of nhw. + out_nhw -= pixels_per_iteration; + + // Read the next elements from memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + } + } + } + + // Normalize the elements from SMEM and write them out. + if (pixels_in_smem > 0) { + #pragma unroll 2 + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_valid_nhw = + static_cast(idx) < static_cast(params.nhw); + const bool is_valid = is_valid_nhw && is_valid_c; + + // Read from SMEM. + const int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG]; + read_from_smem(x_storage_local, &smem_storage_packed[offset], threadIdx.x); + float x_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + + // Normalize and apply activation function + normalize(x_math, bias, scale, m1); + if (USE_ADD_RELU) { + float x1_math[ELEMENTS_PER_LDG]; + ldg_stream(x1_math, &gmem_src1[(is_valid ? idx : 0)*params.c]); + add(x_math, x1_math); + unsigned int relu_mask; + int lane_id = threadIdx.x & 31; + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + bool rectified = x_math[i] < 0.0F; + unsigned int local_relu_mask = __ballot_sync(0xFFFFFFFFU, rectified); + if (lane_id == i) { + relu_mask = local_relu_mask; + } + if (rectified) { + x_math[i] = 0.0F; + } + } + if (is_valid_nhw && (lane_id < ELEMENTS_PER_LDG)) { + gmem_relu_bitmask[idx * 2 + lane_id] = relu_mask; + } + } else if (USE_RELU) { + relu_activation(x_math); + } + + // Write back. + if (is_valid) { + stg_stream(&gmem_dst[idx*params.c], x_math); + } + } + } + // We're about to start on the next c-blk. Needed? + __syncthreads(); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +struct NhwcBatchNormBwdParams { + // The input/output tensors. + uint16_t *gmem_src, *gmem_dy, *gmem_dst, *gmem_dst1; + // dscale/dbias + float *gmem_dscale, *gmem_dbias; + // The scale and bias. + float *gmem_scale, *gmem_bias; + // The mean/inv-var saved from fwd pass + float *gmem_saved_mean, *gmem_saved_var; + // ReLU bitmask + unsigned int *gmem_relu_bitmask; + // The dimensions. + int nhw, c; + // factor to scale sum of squared errors to get saved variance. Must be 1/nhw. + float svar_inv_count; + // The buffer to do the reduction for dscale and dbias + float *gmem_sums; + // The counters of retired CTAs. + int *gmem_retired_ctas; + // outer loop count + int outer_loops; + // number of CTAs along .x dimension + int c_blks; + + void* my_data; + void* pair_datas[4]; + int magic; + int sync_iters; + float wgrad_coeff; +}; + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void relu_bwd(float (&dy)[N], const float (&x)[N], + const float (&mean_var_scale_bias)[N], + const float (&var_scale)[N], bool valid_data) { + #pragma unroll + for (int j = 0; j < N; ++j) { + float y = (x[j] * var_scale[j]) + mean_var_scale_bias[j]; + if ((y <= 0.f) && valid_data) { + dy[j] = 0.f; + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void relu_bwd(float (&dy)[N], const float (&y)[N], bool valid_data) { + #pragma unroll + for (int j = 0; j < N; ++j) { + if ((y[j] <= 0.f) && valid_data) { + dy[j] = 0.f; + } + } +} + +template +DEVICE_FUNCTION void relu_bwd(float (&dy)[N], const bool (&rectified)[N], bool valid_data) { + #pragma unroll + for (int j = 0; j < N; ++j) { + if (rectified[j] && valid_data) { + dy[j] = 0.f; + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void relu_bwd_for_dx(float (&dy)[N], + const float (&x)[N], + const float (&mean_var_scale_bias)[N], + const float (&var_scale)[N]) { + #pragma unroll + for (int j = 0; j < N; ++j) { + float y = (x[j] * var_scale[j]) + mean_var_scale_bias[j]; + if (y <= 0.f) { + dy[j] = 0.f; + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void relu_bwd_for_dx(float (&dy)[N], const float (&y)[N]) { + #pragma unroll + for (int j = 0; j < N; ++j) { + if (y[j] <= 0.f) { + dy[j] = 0.f; + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void bwd_update(float (&dscale)[N], float (&dbias)[N], + const float (&dy)[N], const float (&x)[N], + const float (&mean)[N], float inv_count) { + #pragma unroll + for (int j = 0; j < N; ++j) { + float delta0 = dy[j] - dbias[j]; + dbias[j] += delta0 * inv_count; + delta0 = (dy[j] * (x[j] - mean[j])) - dscale[j]; + dscale[j] += delta0 * inv_count; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template +DEVICE_FUNCTION void bwd_dx(float (&dx)[N], const float (&dy)[N], + const float (&var)[N], const float (&x)[N], const float (&mean)[N], + const float (&dscale)[N], const float (&dbias)[N], float inv_count) { + #pragma unroll + for (int j = 0; j < N; ++j) { + float tmp1 = dy[j] - (dbias[j]* inv_count); + float tmp2 = dscale[j] * inv_count; + float tmp3 = x[j] - mean[j]; + dx[j] = var[j] * (tmp1 - (tmp2 * tmp3)); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + typename Storage, + int THREADS_PER_CTA, + int THREADS_PER_PIXEL, + int PIXELS_PER_THREAD_IN_REGISTERS, + int PIXELS_PER_THREAD_IN_SMEM, + int ELEMENTS_PER_LDG, + int USE_ONLINE_APPROACH, + int OUTER_LOOPS_, + int DESIRED_OCCUPANCY +> +__global__ __launch_bounds__(THREADS_PER_CTA, DESIRED_OCCUPANCY) + void nhwc_batch_norm_bwd(NhwcBatchNormBwdParams params) { + // The number of pixels loaded in a single LDG. + const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + // The number of pixels computed per CTA stored in registers. + const int PIXELS_PER_CTA_IN_REGISTERS = PIXELS_PER_THREAD_IN_REGISTERS * PIXELS_PER_LDG; + // The number of pixels computed per CTA stored in SMEM. + const int PIXELS_PER_CTA_IN_SMEM = PIXELS_PER_THREAD_IN_SMEM*PIXELS_PER_LDG; + // The number of C elements per CTA. + const int C_ELEMENTS_PER_CTA = THREADS_PER_PIXEL*ELEMENTS_PER_LDG; + + // Shared memory to do CTA-wide parallel sums. + __shared__ float smem[THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG]; + + // The adapter for the storage. + typedef PackedStorage PackedStorage_; + // The data type for packed storage in SMEM. + typedef typename PackedStorage_::Type PackedStorageType; + // The number of elements in the packed storage. + const int PACKED_ELEMENTS_PER_LDG = PackedStorage_::PACKED_ELEMENTS_PER_LDG; + // Registers to keep the data live for the persistent approach. + PackedStorageType x_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + PackedStorageType dy_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + + // Shared memory buffer to store the extra pixels. + extern __shared__ PackedStorageType smem_storage_packed[]; + + for (int c_blk_index = blockIdx.y; c_blk_index < params.c_blks; c_blk_index += gridDim.y) { + // The position in the NHW dimension where the CTA starts. + int cta_nhw_regs = blockIdx.x * PIXELS_PER_CTA_IN_REGISTERS; + // The position in the NHW dimension where the CTA starts for the portion in SMEM. + int cta_nhw_smem = blockIdx.x * PIXELS_PER_CTA_IN_SMEM; + // Compute the NHW coordinate of the thread in the CTA. + const int thread_in_cta_nhw = threadIdx.x / THREADS_PER_PIXEL; + + // The position in the C dimension where the CTA starts. + const int cta_c = c_blk_index * C_ELEMENTS_PER_CTA; + // Compute the C coordinate of the thread in the CTA. + const int thread_in_cta_c = threadIdx.x % THREADS_PER_PIXEL; + // Compute the C coordinate of the thread. + const int thread_c = cta_c + thread_in_cta_c*ELEMENTS_PER_LDG; + + // Is the thread working on a valid C dimension? + const int is_valid_c = thread_c < params.c; + + // Registers to store the mean used for entire duration + float mean[ELEMENTS_PER_LDG]; + zero_array(mean); + if (is_valid_c) { + read_from_gmem(mean, params.gmem_saved_mean, thread_c/ELEMENTS_PER_LDG); + } + + // accumulation related registers + float count = 0.f, dscale[ELEMENTS_PER_LDG], dbias[ELEMENTS_PER_LDG]; + zero_array(dscale); + zero_array(dbias); + + // The number of elements loaded by this CTA. + int cta_count = 0; + // The base pointers to load from. + const uint16_t *gmem_src = ¶ms.gmem_src[thread_c]; + const uint16_t *gmem_dy = ¶ms.gmem_dy[thread_c]; + + // outer loops + int OUTER_LOOPS = OUTER_LOOPS_ == 1? 1 : params.outer_loops; + // Load the batch of elements. Compute sum across them + const int pixels_per_iteration = PIXELS_PER_CTA_IN_REGISTERS*gridDim.x; + + if (OUTER_LOOPS_ != 1) { + // We cannot load everything to store persistently, so let's makes sure registers and + // smem are fully utilized + int offset = params.nhw - pixels_per_iteration * OUTER_LOOPS - + PIXELS_PER_CTA_IN_SMEM * gridDim.x; + cta_nhw_regs += offset; + cta_nhw_smem += offset; + } + + #pragma unroll 1 + for (int loop_i = 0; loop_i < OUTER_LOOPS; ++loop_i) { + // The nhw position. + int nhw_regs = cta_nhw_regs + loop_i*pixels_per_iteration; + // Update the number of elements loaded by this CTA. TODO: Skip if <= 0!!! + cta_count += max(0, min(PIXELS_PER_CTA_IN_REGISTERS, params.nhw-nhw_regs)); + + // Read the elements from memory. + float is_valid[PIXELS_PER_THREAD_IN_REGISTERS]; + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = nhw_regs + thread_in_cta_nhw + i*PIXELS_PER_LDG; + zero_array(x_storage[i]); + zero_array(dy_storage[i]); + is_valid[i] = 0.f; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + if (loop_i == OUTER_LOOPS - 1) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + ldg_stream(dy_storage[i], &gmem_dy[idx*params.c]); + } else { + ldg(x_storage[i], &gmem_src[idx*params.c]); + ldg(dy_storage[i], &gmem_dy[idx*params.c]); + } + is_valid[i] = 1.f; + } + } + + // Do the math. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float and update + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + to_float(dy_math, dy_storage[i]); + + // Update the count. + count += is_valid[i]; + // Invert the count. + float inv_count = is_valid[i] ? 1.f / count : 0.f; + + bwd_update(dscale, dbias, dy_math, x_math, mean, inv_count); + } + } + + // The elements to load and store in SMEM. + int smem_nhw = OUTER_LOOPS*pixels_per_iteration + cta_nhw_smem; + // Load elements from SMEM, update the CTA count. + int pixels_in_smem = min(PIXELS_PER_CTA_IN_SMEM, params.nhw-smem_nhw); + if (pixels_in_smem > 0) { + cta_count += pixels_in_smem; + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + bool is_pixel_valid = (((unsigned int)idx < + (unsigned int)params.nhw) && is_valid_c); + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG], + dy_storage_local[PACKED_ELEMENTS_PER_LDG]; + zero_array(x_storage_local); + zero_array(dy_storage_local); + if (is_pixel_valid) { + ldg_stream(x_storage_local, &gmem_src[idx*params.c]); + ldg_stream(dy_storage_local, &gmem_dy[idx*params.c]); + } + + // The offset to store in SMEM. + int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + // Store in SMEM. + write_to_smem(&smem_storage_packed[offset], threadIdx.x, x_storage_local); + offset += PIXELS_PER_THREAD_IN_SMEM*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + write_to_smem(&smem_storage_packed[offset], threadIdx.x, dy_storage_local); + // Update the count. + count += is_pixel_valid; + // Invert the count. + float inv_count = is_pixel_valid ? 1.f / count : 0.f; + + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + to_float(dy_math, dy_storage_local); + + bwd_update(dscale, dbias, dy_math, x_math, mean, inv_count); + } + } + + // We scale the mean by the number of elements. It brings more stability. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + dbias[i] *= count; + dscale[i] *= count; + } + + // dscale parallel sum + ParallelSums::dispatch( + smem, dscale, thread_in_cta_nhw); + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dscale, smem, thread_in_cta_c); + __syncthreads(); + + // dbias parallel sum + ParallelSums::dispatch( + smem, dbias, thread_in_cta_nhw); + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dbias, smem, thread_in_cta_c); + __syncthreads(); + + // The workspace in global memory is distributed across the different CTA. + int gmem_sums_offset = c_blk_index*gridDim.x*C_ELEMENTS_PER_CTA*2; + // Write the data for the CTA to global memory. + float *gmem_sums = ¶ms.gmem_sums[gmem_sums_offset]; + if (threadIdx.x < THREADS_PER_PIXEL) { + const int idx = blockIdx.x*THREADS_PER_PIXEL + threadIdx.x; + write_to_gmem(&gmem_sums[ 0], idx, dscale); + write_to_gmem(&gmem_sums[C_ELEMENTS_PER_CTA*gridDim.x], idx, dbias); + } + + // The counters to count how many CTAs have retired at this point. + // A given cta uses the same counter every other time through the outer loop. + int *gmem_retired_ctas = ¶ms.gmem_retired_ctas[c_blk_index % (2 * gridDim.y)]; + inter_block_sync(gmem_retired_ctas, gridDim.x, blockIdx.x == 0); + + // Reset the accumulators for global summation + zero_array(dscale); + zero_array(dbias); + + // Build the global accumulation + #pragma unroll 1 + for (int idx = threadIdx.x; idx < THREADS_PER_PIXEL*gridDim.x; idx += THREADS_PER_CTA) { + float tmp1[ELEMENTS_PER_LDG], tmp2[ELEMENTS_PER_LDG]; + read_from_gmem(tmp1, gmem_sums, idx); + read_from_gmem(tmp2, gmem_sums+C_ELEMENTS_PER_CTA*gridDim.x, idx); + + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + dscale[i] += tmp1[i]; + dbias[i] += tmp2[i]; + } + } + + // dscale parallel sum + if (params.sync_iters>0) { + ParallelSums::dispatchX( + smem, dscale, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+1, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, dscale, thread_in_cta_nhw); + } + + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dscale, smem, thread_in_cta_c); + __syncthreads(); + + // dbias parallel sum + if (params.sync_iters>0) { + ParallelSums::dispatchX( + smem, dbias, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+0, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, dbias, thread_in_cta_nhw); + } + + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dbias, smem, thread_in_cta_c); + + // inv-var + float var[ELEMENTS_PER_LDG]; + zero_array(var); + if (is_valid_c) { + read_from_gmem(var, params.gmem_saved_var, thread_c/ELEMENTS_PER_LDG); + } + + // Normalize the dscale. + multiply(dscale, var); + + // store dscale/dbias + bool is_valid_for_saving = is_valid_c && blockIdx.x == 0 && thread_in_cta_nhw == 0; + if (is_valid_for_saving) { + if (params.sync_iters>0) + { + scaled_write_to_gmem(params.gmem_dscale, thread_c/ELEMENTS_PER_LDG, dscale, params.wgrad_coeff); + scaled_write_to_gmem(params.gmem_dbias, thread_c/ELEMENTS_PER_LDG, dbias, params.wgrad_coeff); + } else { + write_to_gmem(params.gmem_dscale, thread_c/ELEMENTS_PER_LDG, dscale); + write_to_gmem(params.gmem_dbias, thread_c/ELEMENTS_PER_LDG, dbias); + } + } + + // scale + float scale[ELEMENTS_PER_LDG]; + zero_array(scale); + if (is_valid_c) { + read_from_gmem(scale, params.gmem_scale, thread_c/ELEMENTS_PER_LDG); + } + + // Further normalize the dscale to be used in dx calculation + multiply(dscale, var); + // scale the inv-var as well, afterwards + multiply(var, scale); + + // inverse count + float inv_count = params.svar_inv_count; + + // The base pointer to write to. + uint16_t *const gmem_dst = ¶ms.gmem_dst[thread_c]; + + // Store the elements in registers. + #pragma unroll 1 + for (int loop_i = OUTER_LOOPS-1; loop_i >= 0; --loop_i) { + // The value for nhw. + int out_nhw = cta_nhw_regs + loop_i*pixels_per_iteration; + + // Normalize the elements and write to memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float. + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + to_float(dy_math, dy_storage[i]); + + float dx[ELEMENTS_PER_LDG]; + bwd_dx(dx, dy_math, var, x_math, mean, dscale, dbias, inv_count); + + // Write back. + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + stg_stream(&gmem_dst[idx*params.c], dx); + } + } + + // The next value of nhw. + out_nhw -= pixels_per_iteration; + + // Read the next elements from memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + ldg_stream(dy_storage[i], &gmem_dy[idx*params.c]); + } + } + } + + // Normalize the elements from SMEM and write them out. + if (pixels_in_smem > 0) { + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_valid = ((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c; + if (is_valid) { + // Read from SMEM. + int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG], + dy_storage_local[PACKED_ELEMENTS_PER_LDG]; + read_from_smem(x_storage_local, &smem_storage_packed[offset], threadIdx.x); + offset += PIXELS_PER_THREAD_IN_SMEM*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + read_from_smem(dy_storage_local, &smem_storage_packed[offset], threadIdx.x); + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + to_float(dy_math, dy_storage_local); + + float dx[ELEMENTS_PER_LDG]; + bwd_dx(dx, dy_math, var, x_math, mean, dscale, dbias, inv_count); + + // Write back. + stg_stream(&gmem_dst[idx*params.c], dx); + } + } + } + // We're about to start on the next c-blk. Needed? + __syncthreads(); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + typename Storage, + int THREADS_PER_CTA, + int THREADS_PER_PIXEL, + int PIXELS_PER_THREAD_IN_REGISTERS, + int PIXELS_PER_THREAD_IN_SMEM, + int ELEMENTS_PER_LDG, + int USE_ONLINE_APPROACH, + int OUTER_LOOPS_, + int DESIRED_OCCUPANCY +> +__global__ __launch_bounds__(THREADS_PER_CTA, DESIRED_OCCUPANCY) + void nhwc_batch_norm_bwd_relu(NhwcBatchNormBwdParams params) { + // The number of pixels loaded in a single LDG. + const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + // The number of pixels computed per CTA stored in registers. + const int PIXELS_PER_CTA_IN_REGISTERS = PIXELS_PER_THREAD_IN_REGISTERS * PIXELS_PER_LDG; + // The number of pixels computed per CTA stored in SMEM. + const int PIXELS_PER_CTA_IN_SMEM = PIXELS_PER_THREAD_IN_SMEM*PIXELS_PER_LDG; + // The number of C elements per CTA. + const int C_ELEMENTS_PER_CTA = THREADS_PER_PIXEL*ELEMENTS_PER_LDG; + + // Shared memory to do CTA-wide parallel sums. + __shared__ float smem[THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG]; + + // The adapter for the storage. + typedef PackedStorage PackedStorage_; + // The data type for packed storage in SMEM. + typedef typename PackedStorage_::Type PackedStorageType; + // The number of elements in the packed storage. + const int PACKED_ELEMENTS_PER_LDG = PackedStorage_::PACKED_ELEMENTS_PER_LDG; + // Registers to keep the data live for the persistent approach. + PackedStorageType x_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + PackedStorageType dy_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + + // Shared memory buffer to store the extra pixels. + extern __shared__ PackedStorageType smem_storage_packed[]; + + for (int c_blk_index = blockIdx.y; c_blk_index < params.c_blks; c_blk_index += gridDim.y) { + // The position in the NHW dimension where the CTA starts. + int cta_nhw_regs = blockIdx.x * PIXELS_PER_CTA_IN_REGISTERS; + // The position in the NHW dimension where the CTA starts for the portion in SMEM. + int cta_nhw_smem = blockIdx.x * PIXELS_PER_CTA_IN_SMEM; + // Compute the NHW coordinate of the thread in the CTA. + const int thread_in_cta_nhw = threadIdx.x / THREADS_PER_PIXEL; + + // The position in the C dimension where the CTA starts. + const int cta_c = c_blk_index * C_ELEMENTS_PER_CTA; + // Compute the C coordinate of the thread in the CTA. + const int thread_in_cta_c = threadIdx.x % THREADS_PER_PIXEL; + // Compute the C coordinate of the thread. + const int thread_c = cta_c + thread_in_cta_c*ELEMENTS_PER_LDG; + + // Is the thread working on a valid C dimension? + const int is_valid_c = thread_c < params.c; + + + // Registers to store the mean/var/scale/bias used for the entire duration + // Register usage optimizations: + // 1. Can combine bias - (mean * var * scale) into a single register + // 2. Can combine var * scale into a single register + float varscale[ELEMENTS_PER_LDG]; + zero_array(varscale); + if (is_valid_c) { + read_from_gmem(varscale, params.gmem_saved_var, thread_c/ELEMENTS_PER_LDG); + } + float tmp[ELEMENTS_PER_LDG]; + zero_array(tmp); + if (is_valid_c) { + read_from_gmem(tmp, params.gmem_scale, thread_c/ELEMENTS_PER_LDG); + } + multiply(varscale, tmp); + float mean[ELEMENTS_PER_LDG]; + zero_array(mean); + if (is_valid_c) { + read_from_gmem(mean, params.gmem_saved_mean, thread_c/ELEMENTS_PER_LDG); + } + zero_array(tmp); + if (is_valid_c) { + read_from_gmem(tmp, params.gmem_bias, thread_c/ELEMENTS_PER_LDG); + } + float mean_var_scale_bias[ELEMENTS_PER_LDG]; + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + mean_var_scale_bias[i] = tmp[i] - (mean[i] * varscale[i]); + } + + // accumulation related registers + float count = 0.f, dscale[ELEMENTS_PER_LDG], dbias[ELEMENTS_PER_LDG]; + zero_array(dscale); + zero_array(dbias); + + // The number of elements loaded by this CTA. + int cta_count = 0; + // The base pointers to load from. + const uint16_t *gmem_src = ¶ms.gmem_src[thread_c]; + const uint16_t *gmem_dy = ¶ms.gmem_dy[thread_c]; + + // outer loops + int OUTER_LOOPS = OUTER_LOOPS_ == 1? 1 : params.outer_loops; + // Load the batch of elements. Compute sum across them + const int pixels_per_iteration = PIXELS_PER_CTA_IN_REGISTERS*gridDim.x; + + if (OUTER_LOOPS_ != 1) { + // We cannot load everything to store persistently, so let's makes sure registers and + // smem are fully utilized + int offset = params.nhw - pixels_per_iteration * OUTER_LOOPS - + PIXELS_PER_CTA_IN_SMEM * gridDim.x; + cta_nhw_regs += offset; + cta_nhw_smem += offset; + } + + #pragma unroll 1 + for (int loop_i = 0; loop_i < OUTER_LOOPS; ++loop_i) { + // The nhw position. + int nhw_regs = cta_nhw_regs + loop_i*pixels_per_iteration; + // Update the number of elements loaded by this CTA. TODO: Skip if <= 0!!! + cta_count += max(0, min(PIXELS_PER_CTA_IN_REGISTERS, params.nhw-nhw_regs)); + + // Read the elements from memory. + float is_valid[PIXELS_PER_THREAD_IN_REGISTERS]; + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = nhw_regs + thread_in_cta_nhw + i*PIXELS_PER_LDG; + zero_array(x_storage[i]); + zero_array(dy_storage[i]); + is_valid[i] = 0.f; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + if (loop_i == OUTER_LOOPS - 1) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + ldg_stream(dy_storage[i], &gmem_dy[idx*params.c]); + } else { + ldg(x_storage[i], &gmem_src[idx*params.c]); + ldg(dy_storage[i], &gmem_dy[idx*params.c]); + } + is_valid[i] = 1.f; + } + } + + // Do the math. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float and update + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + to_float(dy_math, dy_storage[i]); + + // Update the count. + count += is_valid[i]; + // Invert the count. + float inv_count = is_valid[i] ? 1.f / count : 0.f; + + relu_bwd(dy_math, x_math, mean_var_scale_bias, varscale, is_valid[i]); + bwd_update(dscale, dbias, dy_math, x_math, mean, inv_count); + } + } + + // The elements to load and store in SMEM. + int smem_nhw = OUTER_LOOPS*pixels_per_iteration + cta_nhw_smem; + // Load elements from SMEM, update the CTA count. + int pixels_in_smem = min(PIXELS_PER_CTA_IN_SMEM, params.nhw-smem_nhw); + if (pixels_in_smem > 0) { + cta_count += pixels_in_smem; + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + bool is_pixel_valid = (((unsigned int)idx < + (unsigned int)params.nhw) && is_valid_c); + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG], + dy_storage_local[PACKED_ELEMENTS_PER_LDG]; + zero_array(x_storage_local); + zero_array(dy_storage_local); + if (is_pixel_valid) { + ldg_stream(x_storage_local, &gmem_src[idx*params.c]); + ldg_stream(dy_storage_local, &gmem_dy[idx*params.c]); + } + + // The offset to store in SMEM. + int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + // Store in SMEM. + write_to_smem(&smem_storage_packed[offset], threadIdx.x, x_storage_local); + offset += PIXELS_PER_THREAD_IN_SMEM*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + write_to_smem(&smem_storage_packed[offset], threadIdx.x, dy_storage_local); + // Update the count. + count += is_pixel_valid; + // Invert the count. + float inv_count = is_pixel_valid ? 1.f / count : 0.f; + + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + to_float(dy_math, dy_storage_local); + + relu_bwd(dy_math, x_math, mean_var_scale_bias, varscale, is_pixel_valid); + bwd_update(dscale, dbias, dy_math, x_math, mean, inv_count); + } + } + + // We scale the mean by the number of elements. It brings more stability. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + dbias[i] *= count; + dscale[i] *= count; + } + + // dscale parallel sum + ParallelSums::dispatch( + smem, dscale, thread_in_cta_nhw); + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dscale, smem, thread_in_cta_c); + __syncthreads(); + + // dbias parallel sum + ParallelSums::dispatch( + smem, dbias, thread_in_cta_nhw); + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dbias, smem, thread_in_cta_c); + __syncthreads(); + + // The workspace in global memory is distributed across the different CTA. + int gmem_sums_offset = c_blk_index*gridDim.x*C_ELEMENTS_PER_CTA*2; + // Write the data for the CTA to global memory. + float *gmem_sums = ¶ms.gmem_sums[gmem_sums_offset]; + if (threadIdx.x < THREADS_PER_PIXEL) { + const int idx = blockIdx.x*THREADS_PER_PIXEL + threadIdx.x; + write_to_gmem(&gmem_sums[ 0], idx, dscale); + write_to_gmem(&gmem_sums[C_ELEMENTS_PER_CTA*gridDim.x], idx, dbias); + } + + // The counters to count how many CTAs have retired at this point. + // A given cta uses the same counter every other time through the outer loop. + int *gmem_retired_ctas = ¶ms.gmem_retired_ctas[c_blk_index % (2 * gridDim.y)]; + inter_block_sync(gmem_retired_ctas, gridDim.x, blockIdx.x == 0); + + // Reset the accumulators for global summation + zero_array(dscale); + zero_array(dbias); + + // Build the global accumulation + #pragma unroll 1 + for (int idx = threadIdx.x; idx < THREADS_PER_PIXEL*gridDim.x; idx += THREADS_PER_CTA) { + float tmp1[ELEMENTS_PER_LDG], tmp2[ELEMENTS_PER_LDG]; + read_from_gmem(tmp1, gmem_sums, idx); + read_from_gmem(tmp2, gmem_sums+C_ELEMENTS_PER_CTA*gridDim.x, idx); + + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + dscale[i] += tmp1[i]; + dbias[i] += tmp2[i]; + } + } + + // dscale parallel sum + if (params.sync_iters>0) { + ParallelSums::dispatchX( + smem, dscale, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+1, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, dscale, thread_in_cta_nhw); + } + + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dscale, smem, thread_in_cta_c); + __syncthreads(); + + // dbias parallel sum + if (params.sync_iters>0) { + ParallelSums::dispatchX( + smem, dbias, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+0, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, dbias, thread_in_cta_nhw); + } + + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dbias, smem, thread_in_cta_c); + + // Normalize the dscale. + float var[ELEMENTS_PER_LDG]; + zero_array(var); + if (is_valid_c) { + read_from_gmem(var, params.gmem_saved_var, thread_c/ELEMENTS_PER_LDG); + } + multiply(dscale, var); + + // store dscale/dbias + bool is_valid_for_saving = is_valid_c && blockIdx.x == 0 && thread_in_cta_nhw == 0; + if (is_valid_for_saving) { + if (params.sync_iters>0) + { + scaled_write_to_gmem(params.gmem_dscale, thread_c/ELEMENTS_PER_LDG, dscale, params.wgrad_coeff); + scaled_write_to_gmem(params.gmem_dbias, thread_c/ELEMENTS_PER_LDG, dbias, params.wgrad_coeff); + } else { + write_to_gmem(params.gmem_dscale, thread_c/ELEMENTS_PER_LDG, dscale); + write_to_gmem(params.gmem_dbias, thread_c/ELEMENTS_PER_LDG, dbias); + } + } + + // Further normalize the dscale to be used in dx calculation + float scale[ELEMENTS_PER_LDG]; + zero_array(scale); + if (is_valid_c) { + read_from_gmem(scale, params.gmem_scale, thread_c/ELEMENTS_PER_LDG); + } + multiply(dscale, var); + // scale the inv-var as well, afterwards + multiply(var, scale); + + // inverse count + float inv_count = params.svar_inv_count; + + // The base pointer to write to. + uint16_t *const gmem_dst = ¶ms.gmem_dst[thread_c]; + + // Store the elements in registers. + #pragma unroll 1 + for (int loop_i = OUTER_LOOPS-1; loop_i >= 0; --loop_i) { + // The value for nhw. + int out_nhw = cta_nhw_regs + loop_i*pixels_per_iteration; + + // Normalize the elements and write to memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + // Convert to float. + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + to_float(dy_math, dy_storage[i]); + relu_bwd_for_dx(dy_math, x_math, mean_var_scale_bias, var); + + float dx[ELEMENTS_PER_LDG]; + bwd_dx(dx, dy_math, var, x_math, mean, dscale, dbias, inv_count); + + // Write back. + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + stg_stream(&gmem_dst[idx*params.c], dx); + } + } + + // The next value of nhw. + out_nhw -= pixels_per_iteration; + + // Read the next elements from memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + ldg_stream(dy_storage[i], &gmem_dy[idx*params.c]); + } + } + } + + // Normalize the elements from SMEM and write them out. + if (pixels_in_smem > 0) { + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_valid = ((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c; + if (is_valid) { + // Read from SMEM. + int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG], + dy_storage_local[PACKED_ELEMENTS_PER_LDG]; + read_from_smem(x_storage_local, &smem_storage_packed[offset], threadIdx.x); + offset += PIXELS_PER_THREAD_IN_SMEM*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + read_from_smem(dy_storage_local, &smem_storage_packed[offset], threadIdx.x); + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + to_float(dy_math, dy_storage_local); + relu_bwd_for_dx(dy_math, x_math, mean_var_scale_bias, var); + + float dx[ELEMENTS_PER_LDG]; + bwd_dx(dx, dy_math, var, x_math, mean, dscale, dbias, inv_count); + + // Write back. + stg_stream(&gmem_dst[idx*params.c], dx); + } + } + } + // We're about to start on the next c-blk. Needed? + __syncthreads(); + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// + +template< + typename Storage, + int THREADS_PER_CTA, + int THREADS_PER_PIXEL, + int PIXELS_PER_THREAD_IN_REGISTERS, + int PIXELS_PER_THREAD_IN_SMEM, + int ELEMENTS_PER_LDG, + int USE_ONLINE_APPROACH, + int OUTER_LOOPS_, + int DESIRED_OCCUPANCY +> +__global__ __launch_bounds__(THREADS_PER_CTA, DESIRED_OCCUPANCY) + void nhwc_batch_norm_bwd_add_relu(NhwcBatchNormBwdParams params) { + // The number of pixels loaded in a single LDG. + const int PIXELS_PER_LDG = THREADS_PER_CTA / THREADS_PER_PIXEL; + // The number of pixels computed per CTA stored in registers. + const int PIXELS_PER_CTA_IN_REGISTERS = PIXELS_PER_THREAD_IN_REGISTERS * PIXELS_PER_LDG; + // The number of pixels computed per CTA stored in SMEM. + const int PIXELS_PER_CTA_IN_SMEM = PIXELS_PER_THREAD_IN_SMEM*PIXELS_PER_LDG; + // The number of C elements per CTA. + const int C_ELEMENTS_PER_CTA = THREADS_PER_PIXEL*ELEMENTS_PER_LDG; + + // Shared memory to do CTA-wide parallel sums. + __shared__ float smem[THREADS_PER_PIXEL*(THREADS_PER_CTA/32)*ELEMENTS_PER_LDG]; + + // The adapter for the storage. + typedef PackedStorage PackedStorage_; + // The data type for packed storage in SMEM. + typedef typename PackedStorage_::Type PackedStorageType; + // The number of elements in the packed storage. + const int PACKED_ELEMENTS_PER_LDG = PackedStorage_::PACKED_ELEMENTS_PER_LDG; + // Registers to keep the data live for the persistent approach. + PackedStorageType x_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + PackedStorageType dy_storage[PIXELS_PER_THREAD_IN_REGISTERS][PACKED_ELEMENTS_PER_LDG]; + + // Shared memory buffer to store the extra pixels. + extern __shared__ PackedStorageType smem_storage_packed[]; + + for (int c_blk_index = blockIdx.y; c_blk_index < params.c_blks; c_blk_index += gridDim.y) { + // The position in the NHW dimension where the CTA starts. + int cta_nhw_regs = blockIdx.x * PIXELS_PER_CTA_IN_REGISTERS; + // The position in the NHW dimension where the CTA starts for the portion in SMEM. + int cta_nhw_smem = blockIdx.x * PIXELS_PER_CTA_IN_SMEM; + // Compute the NHW coordinate of the thread in the CTA. + const int thread_in_cta_nhw = threadIdx.x / THREADS_PER_PIXEL; + + // The position in the C dimension where the CTA starts. + const int cta_c = c_blk_index * C_ELEMENTS_PER_CTA; + // Compute the C coordinate of the thread in the CTA. + const int thread_in_cta_c = threadIdx.x % THREADS_PER_PIXEL; + // Compute the C coordinate of the thread. + const int thread_c = cta_c + thread_in_cta_c*ELEMENTS_PER_LDG; + + // Is the thread working on a valid C dimension? + const int is_valid_c = thread_c < params.c; + + float mean[ELEMENTS_PER_LDG]; + zero_array(mean); + if (is_valid_c) { + read_from_gmem(mean, params.gmem_saved_mean, thread_c/ELEMENTS_PER_LDG); + } + + // accumulation related registers + float count = 0.f, dscale[ELEMENTS_PER_LDG], dbias[ELEMENTS_PER_LDG]; + zero_array(dscale); + zero_array(dbias); + + // The number of elements loaded by this CTA. + int cta_count = 0; + // The base pointers to load from. + const uint16_t *gmem_src = ¶ms.gmem_src[thread_c]; + const uint16_t *gmem_dy = ¶ms.gmem_dy[thread_c]; + uint16_t *gmem_dst1 = ¶ms.gmem_dst1[thread_c]; + + // outer loops + int OUTER_LOOPS = OUTER_LOOPS_ == 1? 1 : params.outer_loops; + // Load the batch of elements. Compute sum across them + const int pixels_per_iteration = PIXELS_PER_CTA_IN_REGISTERS*gridDim.x; + + if (OUTER_LOOPS_ != 1) { + // We cannot load everything to store persistently, so let's makes sure registers and + // smem are fully utilized, offset is evenly divisible by 32 + int offset = (pixels_per_iteration * OUTER_LOOPS + PIXELS_PER_CTA_IN_SMEM * gridDim.x - + params.nhw) & ~31; + cta_nhw_regs -= offset; + cta_nhw_smem -= offset; + } + + const unsigned int *const gmem_relu_bitmask = params.gmem_relu_bitmask + + ((params.nhw + 31) & ~31) * 2 * c_blk_index; + + #pragma unroll 1 + for (int loop_i = 0; loop_i < OUTER_LOOPS; ++loop_i) { + // The nhw position. + int nhw_regs = cta_nhw_regs + loop_i*pixels_per_iteration; + // Update the number of elements loaded by this CTA. TODO: Skip if <= 0!!! + cta_count += max(0, min(PIXELS_PER_CTA_IN_REGISTERS, params.nhw-nhw_regs)); + + int lane_id = threadIdx.x & 31; + + // Read the elements from memory. + float is_valid[PIXELS_PER_THREAD_IN_REGISTERS]; + unsigned int relu_mask[PIXELS_PER_THREAD_IN_REGISTERS]; + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = nhw_regs + thread_in_cta_nhw + i*PIXELS_PER_LDG; + zero_array(x_storage[i]); + zero_array(dy_storage[i]); + is_valid[i] = 0.f; + const bool is_valid_nhw = + static_cast(idx) < static_cast(params.nhw); + if (is_valid_nhw) { + if (is_valid_c) { + if (loop_i == OUTER_LOOPS - 1) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + ldg_stream(dy_storage[i], &gmem_dy[idx*params.c]); + } else { + ldg(x_storage[i], &gmem_src[idx*params.c]); + ldg(dy_storage[i], &gmem_dy[idx*params.c]); + } + is_valid[i] = 1.f; + } + + if (lane_id < ELEMENTS_PER_LDG) { + relu_mask[i] = gmem_relu_bitmask[idx * 2 + lane_id]; + } + } + } + + // Do the math. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = nhw_regs + thread_in_cta_nhw + i*PIXELS_PER_LDG; + // Convert to float and update + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + bool rectified[ELEMENTS_PER_LDG]; + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + rectified[j] = ((__shfl_sync(0xFFFFFFFFU, relu_mask[i], j) & + (1U << lane_id)) != 0); + } + to_float(x_math, x_storage[i]); + to_float(dy_math, dy_storage[i]); + + // Update the count. + count += is_valid[i]; + // Invert the count. + float inv_count = is_valid[i] ? 1.f / count : 0.f; + + relu_bwd(dy_math, rectified, is_valid[i]); + bwd_update(dscale, dbias, dy_math, x_math, mean, inv_count); + + // Lastly we need 'dy' only for BN, so store the 'relu-dgrad'ed version + from_float(dy_storage[i], dy_math); + + // dZ for elementwise add + if (is_valid[i]) { + if (loop_i == OUTER_LOOPS - 1) { + stg_stream(&gmem_dst1[idx*params.c], dy_storage[i]); + } else { + stg(&gmem_dst1[idx*params.c], dy_storage[i]); + } + } + } + } + + // The elements to load and store in SMEM. + int smem_nhw = OUTER_LOOPS*pixels_per_iteration + cta_nhw_smem; + // Load elements from SMEM, update the CTA count. + int pixels_in_smem = min(PIXELS_PER_CTA_IN_SMEM, params.nhw-smem_nhw); + if (pixels_in_smem > 0) { + cta_count += pixels_in_smem; + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_pixel_valid_nhw = + static_cast(idx) < static_cast(params.nhw); + const bool is_pixel_valid = is_pixel_valid_nhw && is_valid_c; + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG], + dy_storage_local[PACKED_ELEMENTS_PER_LDG]; + unsigned int relu_mask; + int lane_id = threadIdx.x & 31; + zero_array(x_storage_local); + zero_array(dy_storage_local); + if (is_pixel_valid_nhw) { + if (is_valid_c) { + ldg_stream(x_storage_local, &gmem_src[idx*params.c]); + ldg_stream(dy_storage_local, &gmem_dy[idx*params.c]); + } + if (lane_id < ELEMENTS_PER_LDG) { + relu_mask = gmem_relu_bitmask[idx * 2 + lane_id]; + } + } + bool rectified[ELEMENTS_PER_LDG]; + #pragma unroll + for (int j = 0; j < ELEMENTS_PER_LDG; ++j) { + rectified[j] = ((__shfl_sync(0xFFFFFFFFU, relu_mask, j) & + (1U << lane_id)) != 0); + } + + // The offset to store in SMEM. + int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + // Store in SMEM. + write_to_smem(&smem_storage_packed[offset], threadIdx.x, x_storage_local); + offset += PIXELS_PER_THREAD_IN_SMEM*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + // Update the count. + count += is_pixel_valid; + // Invert the count. + float inv_count = is_pixel_valid ? 1.f / count : 0.f; + + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + to_float(dy_math, dy_storage_local); + + relu_bwd(dy_math, rectified, is_pixel_valid); + bwd_update(dscale, dbias, dy_math, x_math, mean, inv_count); + + from_float(dy_storage_local, dy_math); + // dZ for elementwise add + if (is_pixel_valid) { + stg_stream(&gmem_dst1[idx*params.c], dy_storage_local); + } + // only store the 'relu-dgrad'ed version! + write_to_smem(&smem_storage_packed[offset], threadIdx.x, dy_storage_local); + } + } + + // We scale the mean by the number of elements. It brings more stability. + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + dbias[i] *= count; + dscale[i] *= count; + } + + // dscale parallel sum + ParallelSums::dispatch( + smem, dscale, thread_in_cta_nhw); + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dscale, smem, thread_in_cta_c); + __syncthreads(); + + // dbias parallel sum + ParallelSums::dispatch( + smem, dbias, thread_in_cta_nhw); + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dbias, smem, thread_in_cta_c); + __syncthreads(); + + // The workspace in global memory is distributed across the different CTA. + int gmem_sums_offset = c_blk_index*gridDim.x*C_ELEMENTS_PER_CTA*2; + // Write the data for the CTA to global memory. + float *gmem_sums = ¶ms.gmem_sums[gmem_sums_offset]; + if (threadIdx.x < THREADS_PER_PIXEL) { + const int idx = blockIdx.x*THREADS_PER_PIXEL + threadIdx.x; + write_to_gmem(&gmem_sums[ 0], idx, dscale); + write_to_gmem(&gmem_sums[C_ELEMENTS_PER_CTA*gridDim.x], idx, dbias); + } + + // The counters to count how many CTAs have retired at this point. + // A given cta uses the same counter every other time through the outer loop. + int *gmem_retired_ctas = ¶ms.gmem_retired_ctas[c_blk_index % (2 * gridDim.y)]; + inter_block_sync(gmem_retired_ctas, gridDim.x, blockIdx.x == 0); + + // Reset the accumulators for global summation + zero_array(dscale); + zero_array(dbias); + + // Build the global accumulation + #pragma unroll 1 + for (int idx = threadIdx.x; idx < THREADS_PER_PIXEL*gridDim.x; idx += THREADS_PER_CTA) { + float tmp1[ELEMENTS_PER_LDG], tmp2[ELEMENTS_PER_LDG]; + read_from_gmem(tmp1, gmem_sums, idx); + read_from_gmem(tmp2, gmem_sums+C_ELEMENTS_PER_CTA*gridDim.x, idx); + + #pragma unroll + for (int i = 0; i < ELEMENTS_PER_LDG; ++i) { + dscale[i] += tmp1[i]; + dbias[i] += tmp2[i]; + } + } + + // dscale parallel sum + if (params.sync_iters>0) { + ParallelSums::dispatchX( + smem, dscale, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+1, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, dscale, thread_in_cta_nhw); + } + + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dscale, smem, thread_in_cta_c); + __syncthreads(); + + // dbias parallel sum + if (params.sync_iters>0) { + ParallelSums::dispatchX( + smem, dbias, thread_in_cta_nhw, params.my_data, params.pair_datas, 4*c_blk_index+0, params.magic, params.sync_iters); + } else { + ParallelSums::dispatch( + smem, dbias, thread_in_cta_nhw); + } + + __syncthreads(); + // The values in shared memory correspond to the CTA-wide sums. + read_from_smem(dbias, smem, thread_in_cta_c); + + // Normalize the dscale. + float var[ELEMENTS_PER_LDG]; + zero_array(var); + if (is_valid_c) { + read_from_gmem(var, params.gmem_saved_var, thread_c/ELEMENTS_PER_LDG); + } + multiply(dscale, var); + + // store dscale/dbias + bool is_valid_for_saving = is_valid_c && blockIdx.x == 0 && thread_in_cta_nhw == 0; + if (is_valid_for_saving) { + if (params.sync_iters>0) + { + scaled_write_to_gmem(params.gmem_dscale, thread_c/ELEMENTS_PER_LDG, dscale, params.wgrad_coeff); + scaled_write_to_gmem(params.gmem_dbias, thread_c/ELEMENTS_PER_LDG, dbias, params.wgrad_coeff); + } else { + write_to_gmem(params.gmem_dscale, thread_c/ELEMENTS_PER_LDG, dscale); + write_to_gmem(params.gmem_dbias, thread_c/ELEMENTS_PER_LDG, dbias); + } + } + + // Further normalize the dscale to be used in dx calculation + float scale[ELEMENTS_PER_LDG]; + zero_array(scale); + if (is_valid_c) { + read_from_gmem(scale, params.gmem_scale, thread_c/ELEMENTS_PER_LDG); + } + multiply(dscale, var); + // scale the inv-var as well, afterwards + multiply(var, scale); + + // inverse count + float inv_count = params.svar_inv_count; + + // The base pointer to write to. + uint16_t *const gmem_dst = ¶ms.gmem_dst[thread_c]; + + // Store the elements in registers. + #pragma unroll 1 + for (int loop_i = OUTER_LOOPS-1; loop_i >= 0; --loop_i) { + // The value for nhw. + int out_nhw = cta_nhw_regs + loop_i*pixels_per_iteration; + + // Normalize the elements and write to memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_valid = ((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c; + // Convert to float. + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage[i]); + to_float(dy_math, dy_storage[i]); + + float dx[ELEMENTS_PER_LDG]; + bwd_dx(dx, dy_math, var, x_math, mean, dscale, dbias, inv_count); + + // Write back. + if (is_valid) { + stg_stream(&gmem_dst[idx*params.c], dx); + } + } + + // The next value of nhw. + out_nhw -= pixels_per_iteration; + + // Read the next elements from memory. + #pragma unroll + for (int i = 0; i < PIXELS_PER_THREAD_IN_REGISTERS; ++i) { + const int idx = out_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + float y[ELEMENTS_PER_LDG]; + zero_array(y); + if (((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c) { + ldg_stream(x_storage[i], &gmem_src[idx*params.c]); + ldg_stream(dy_storage[i], &gmem_dst1[idx*params.c]); + } + } + } + + // Normalize the elements from SMEM and write them out. + if (pixels_in_smem > 0) { + for (int i = 0; i < PIXELS_PER_THREAD_IN_SMEM; ++i) { + const int idx = smem_nhw + thread_in_cta_nhw + i*PIXELS_PER_LDG; + const bool is_valid = ((unsigned int)idx < (unsigned int)params.nhw) && is_valid_c; + if (is_valid) { + // Read from SMEM. + int offset = i*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + PackedStorageType x_storage_local[PACKED_ELEMENTS_PER_LDG], + dy_storage_local[PACKED_ELEMENTS_PER_LDG]; + read_from_smem(x_storage_local, &smem_storage_packed[offset], threadIdx.x); + offset += PIXELS_PER_THREAD_IN_SMEM*THREADS_PER_CTA*PACKED_ELEMENTS_PER_LDG; + read_from_smem(dy_storage_local, &smem_storage_packed[offset], threadIdx.x); + float x_math[ELEMENTS_PER_LDG], dy_math[ELEMENTS_PER_LDG]; + to_float(x_math, x_storage_local); + to_float(dy_math, dy_storage_local); + + float dx[ELEMENTS_PER_LDG]; + bwd_dx(dx, dy_math, var, x_math, mean, dscale, dbias, inv_count); + + // Write back. + stg_stream(&gmem_dst[idx*params.c], dx); + } + } + } + // We're about to start on the next c-blk. Needed? + __syncthreads(); + } +} + +#endif // MXNET_OPERATOR_NN_CUDNN_NHWC_BATCH_NORM_KERNEL_H_ diff --git a/apex/apex/contrib/csrc/layer_norm/ln_api.cpp b/apex/apex/contrib/csrc/layer_norm/ln_api.cpp new file mode 100644 index 0000000000000000000000000000000000000000..abea8a1dce246f031c41d588185a0ad4a7723db5 --- /dev/null +++ b/apex/apex/contrib/csrc/layer_norm/ln_api.cpp @@ -0,0 +1,106 @@ +#include +#include "ATen/cuda/CUDAContext.h" + +void ln_fwd_cuda(at::Tensor &y, at::Tensor &mu, at::Tensor &rsigma, + const at::Tensor &x, const at::Tensor &gamma, + const at::Tensor &beta, const float epsilon, const int rows, const int cols, + cudaStream_t stream); + +void ln_bwd_cuda(at::Tensor &dx, at::Tensor &dgamma, at::Tensor &dbeta, + const at::Tensor &dw, const at::Tensor &x, + const at::Tensor &mu, const at::Tensor &rsigma, + const at::Tensor &gamma, const int rows, const int cols, cudaStream_t stream); + + +std::vector ln_fwd(const at::Tensor &x, // BxSxhidden_size + const at::Tensor &gamma, // hidden_size + const at::Tensor &beta, // hidden_size + const float epsilon +) { + + TORCH_CHECK(x.is_cuda()) + TORCH_CHECK(gamma.is_cuda()) + TORCH_CHECK(beta.is_cuda()) + + TORCH_CHECK(x.is_contiguous()); + auto sizes = x.sizes(); + TORCH_CHECK(sizes.size() == 2); + + const int rows = sizes[0]; + const int cols = sizes[1]; + + auto dtype = x.scalar_type(); + + TORCH_CHECK(gamma.dtype() == dtype); + TORCH_CHECK(beta.dtype() == dtype); + + TORCH_CHECK(gamma.sizes() == beta.sizes()); + TORCH_CHECK(gamma.numel() == cols); + + TORCH_CHECK(epsilon >= 0.f); + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + + auto y = torch::empty_like(x); + + auto opts = x.options(); + + auto mu = torch::empty({rows}, opts.dtype(torch::kFloat32)); + auto rsigma = torch::empty({rows}, opts.dtype(torch::kFloat32)); + + ln_fwd_cuda(y, mu, rsigma, x, gamma, beta, epsilon, rows, cols, stream); + + return {y, mu, rsigma}; +} + + + +std::vector ln_bwd(const at::Tensor &dw, // BxSxhidden_size + const at::Tensor &x, // BxSxhidden_size + const at::Tensor &mu, // BxS, FP32! + const at::Tensor &rsigma, // BxS, FP32! + const at::Tensor &gamma // hidden_size +) { + + TORCH_CHECK(x.is_cuda()); + TORCH_CHECK(dw.is_cuda()); + TORCH_CHECK(mu.is_cuda()); + TORCH_CHECK(rsigma.is_cuda()); + TORCH_CHECK(gamma.is_cuda()); + + TORCH_CHECK(x.is_contiguous()); + TORCH_CHECK(dw.is_contiguous()); + + auto sizes = x.sizes(); + TORCH_CHECK(sizes.size() == 2); + TORCH_CHECK(dw.sizes() == sizes); + auto rows = sizes[0]; + auto cols = sizes[1]; + + auto dtype = x.scalar_type(); + TORCH_CHECK(dw.dtype() == dtype); + TORCH_CHECK(gamma.dtype() == dtype); + TORCH_CHECK(mu.dtype() == torch::kFloat32); + TORCH_CHECK(rsigma.dtype() == torch::kFloat32); + TORCH_CHECK(mu.sizes() == rsigma.sizes()); + TORCH_CHECK(mu.numel() == rows); + + TORCH_CHECK(gamma.numel() == cols); + + + auto stream = at::cuda::getCurrentCUDAStream().stream(); + + auto dx = torch::empty_like(x); + auto dgamma = torch::empty_like(gamma); + auto dbeta = torch::empty_like(gamma); + + ln_bwd_cuda(dx, dgamma, dbeta, dw, x, mu, rsigma, gamma, rows, cols, stream); + + return {dx, dgamma, dbeta}; +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.doc() = "CUDA LayerNorm"; // optional module docstring + m.def("ln_fwd", &ln_fwd, "Run LayerNorm forward kernel"); + m.def("ln_bwd", &ln_bwd, "Run LayerNorm backward kernel"); +} diff --git a/apex/apex/contrib/csrc/layer_norm/ln_bwd_semi_cuda_kernel.cu b/apex/apex/contrib/csrc/layer_norm/ln_bwd_semi_cuda_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..1f6cbd556bec991b2c5788d30d1f00ec3c39c5da --- /dev/null +++ b/apex/apex/contrib/csrc/layer_norm/ln_bwd_semi_cuda_kernel.cu @@ -0,0 +1,438 @@ +#include "utils.cuh" +#include "ln_kernel_traits.h" +#include "ATen/cuda/CUDAContext.h" + +template +__global__ __launch_bounds__(Ktraits::THREADS_PER_CTA) void ln_bwd_kernel(void * __restrict__ dx_, + void * __restrict__ dg_, + void * __restrict__ db_, + const void * __restrict__ dw_, + const void * __restrict__ x_, + const void * __restrict__ mu_, + const void * __restrict__ rs_, + const void * __restrict__ g_, + const int rows + ){ + using Vec = typename Ktraits::Vec; + + enum { BYTES_PER_LDG = Ktraits::BYTES_PER_LDG }; + enum { ROWS_PER_CTA = Ktraits::ROWS_PER_CTA }; + enum { WARPS_M = Ktraits::WARPS_M }; + enum { WARPS_N = Ktraits::WARPS_N }; + enum { THREADS_PER_ROW = Ktraits::THREADS_PER_ROW }; + enum { COLS = Ktraits::COLS }; + enum { BYTES_PER_ROW = Ktraits::BYTES_PER_ROW }; + enum { LDGS = BYTES_PER_ROW / Ktraits::BYTES_PER_ROW_PER_CTA }; + static_assert(LDGS * Ktraits::BYTES_PER_ROW_PER_CTA == BYTES_PER_ROW, ""); + enum { NUM_ELTS = Vec::NUM_ELTS }; + using vec_t = typename Ktraits::vec_t; + using base_t = typename Ktraits::base_t; + using compute_t = typename Ktraits::compute_t; + const int tidx = threadIdx.x; + const int bidx = blockIdx.x; + const int lane = tidx % THREADS_PER_WARP; + const int warp = tidx / THREADS_PER_WARP; + const int warp_m = warp / Ktraits::WARPS_N; + const int warp_n = warp % Ktraits::WARPS_N; + const int tid_r = warp_n * THREADS_PER_WARP + lane; + + const int r = bidx * Ktraits::ROWS_PER_CTA + warp_m; + const int c = warp_n * THREADS_PER_WARP + lane; + + const char *dw_ptr = static_cast(dw_); + const char *x_ptr = static_cast(x_); + const char *g_ptr = static_cast(g_); + char *dx_ptr = static_cast(dx_); + const compute_t *mu_ptr = static_cast(mu_); + const compute_t *rs_ptr = static_cast(rs_); + static_assert(COLS == THREADS_PER_ROW * LDGS * NUM_ELTS, ""); + + // smem for final reduction + //__shared__ compute_t smem_[ROWS_PER_CTA * COLS]; + extern __shared__ compute_t smem_[]; + // static_assert(sizeof(smem_dw_sum) == 32*1024,""); + // Using the grid stride loop we can assign multiple rows to each thread + // by using a number of CTAs smaller than rows / ROWS_PER_CTA + // We accumulate them here, one in smem, one in registers, because the smem + // capacity is limited compute_t * dw_sum = &smem_dw_sum[warp_m * COLS + tid_r + // * LDGS * NUM_ELTS]; + compute_t dwy_sum[LDGS * NUM_ELTS]; + compute_t dw_sum[LDGS * NUM_ELTS]; + + memset(dwy_sum, 0, sizeof(compute_t) * LDGS * NUM_ELTS); + memset(dw_sum, 0, sizeof(compute_t) * LDGS * NUM_ELTS); + // Debug 8 rows, 4B, 1024 cols + + __shared__ compute_t smem_mdy[ROWS_PER_CTA * WARPS_N]; + __shared__ compute_t smem_mdyy[ROWS_PER_CTA * WARPS_N]; + compute_t *mdy_shared = &smem_mdy[warp_m * WARPS_N]; + compute_t *mdyy_shared = &smem_mdyy[warp_m * WARPS_N]; + + constexpr float rn = 1.f / float(COLS); + Vec gamma[LDGS]; + int col = c; +#pragma unroll + for (int it = 0; it < LDGS; it++) { + gamma[it].load_from(g_ptr + col * BYTES_PER_LDG); + col += Ktraits::THREADS_PER_ROW; + } + // TODO if ROWS_PER_CTA does not divice rows, we might get divergence in the + // last blocks with syncthreads! + // grid stride over rows + #pragma unroll 1 + for (int row = r; row < rows; row += gridDim.x * ROWS_PER_CTA) { + const compute_t mu_r = mu_ptr[row]; + const compute_t rs_r = rs_ptr[row]; + Vec dw[LDGS], x[LDGS], dx[LDGS]; + int col = c; +#pragma unroll + for (int it = 0; it < LDGS; it++) { + dw[it].load_from(dw_ptr + row * BYTES_PER_ROW + col * BYTES_PER_LDG); + x[it].load_from(x_ptr + row * BYTES_PER_ROW + col * BYTES_PER_LDG); + col += THREADS_PER_ROW; + } + // local reductions + compute_t dy[LDGS * NUM_ELTS]; + compute_t y[LDGS * NUM_ELTS]; + + compute_t mdy_local = 0.f; + compute_t mdyy_local = 0.f; +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < Vec::NUM_ELTS; jt++) { + compute_t x_tmp = x[it].data.elt[jt]; + compute_t y_tmp = rs_r * (x_tmp - mu_r); + compute_t dy_tmp = gamma[it].data.elt[jt] * dw[it].data.elt[jt]; + compute_t dw_tmp = dw[it].data.elt[jt]; + + mdy_local += dy_tmp; + mdyy_local += dy_tmp * y_tmp; + + dy[it * NUM_ELTS + jt] = dy_tmp; + y[it * NUM_ELTS + jt] = y_tmp; + + dwy_sum[it * NUM_ELTS + jt] += dw_tmp * y_tmp; + dw_sum[it * NUM_ELTS + jt] += dw_tmp; + } + } + + // reduction across row for mdy, mdyy + if (WARPS_N == 1) { // no need to go through smem! +#pragma unroll + for (int it = 1; it < THREADS_PER_WARP; it *= 2) { + mdy_local += __shfl_xor_sync(uint32_t(-1), mdy_local, it); + mdyy_local += __shfl_xor_sync(uint32_t(-1), mdyy_local, it); + } + + mdy_local *= rn; + mdyy_local *= rn; + + } else { + +#pragma unroll + for (int it = 16; it > 0; it /= 2) { + mdy_local += __shfl_down_sync(uint32_t(-1), mdy_local, it); + mdyy_local += __shfl_down_sync(uint32_t(-1), mdyy_local, it); + } // lane 0 holds the result! + + if (lane == 0) { + mdy_shared[warp_n] = mdy_local; + mdyy_shared[warp_n] = mdyy_local; + } + + __syncthreads(); + if (warp_n == 0 && lane == 0) { + mdy_local = 0.f; + mdyy_local = 0.f; + for (int it = 0; it < WARPS_N; it++) { + mdy_local += mdy_shared[it]; + mdyy_local += mdyy_shared[it]; + } + mdy_shared[0] = mdy_local; + mdyy_shared[0] = mdyy_local; + } + __syncthreads(); + + mdy_local = mdy_shared[0] * rn; + mdyy_local = mdyy_shared[0] * rn; + } + +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + compute_t dy_tmp = dy[it * NUM_ELTS + jt]; + compute_t y_tmp = y[it * NUM_ELTS + jt]; + compute_t dx_tmp = + compute_t(rs_r) * (dy_tmp - mdyy_local * y_tmp - mdy_local); + dx[it].data.elt[jt] = dx_tmp; + } + } + + col = c; +#pragma unroll + for (int it = 0; it < LDGS; it++) { + dx[it].store_to(dx_ptr + row * BYTES_PER_ROW + col * BYTES_PER_LDG); + col += Ktraits::THREADS_PER_ROW; + } + + } // end: grid stride loop + + // Finalize reduction of part dgamma and dbeta for this CTA + // by reducing over the rows held across the WARPS_M warps + + enum { NUM_RES = COLS / Ktraits::THREADS_PER_CTA }; + static_assert(NUM_RES * Ktraits::THREADS_PER_CTA == COLS, ""); + + compute_t *smem_write; + + smem_write = &smem_[warp_m * COLS + tid_r * NUM_ELTS]; +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + smem_write[jt] = dw_sum[it * NUM_ELTS + jt]; + } + smem_write += THREADS_PER_ROW * NUM_ELTS; + } + __syncthreads(); + compute_t cta_dw_sum[NUM_RES]; + memset(cta_dw_sum, 0, sizeof(compute_t) * NUM_RES); + for (int it = 0; it < ROWS_PER_CTA; it++) { + for (int jt = 0; jt < NUM_RES; jt++) { + cta_dw_sum[jt] += smem_[it * COLS + tidx + jt * Ktraits::THREADS_PER_CTA]; + } + } + __syncthreads(); + + smem_write = &smem_[warp_m * COLS + tid_r * NUM_ELTS]; +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + smem_write[jt] = dwy_sum[it * NUM_ELTS + jt]; + } + smem_write += THREADS_PER_ROW * NUM_ELTS; + } + __syncthreads(); + compute_t cta_dwy_sum[NUM_RES]; + memset(cta_dwy_sum, 0, sizeof(compute_t) * NUM_RES); + for (int it = 0; it < ROWS_PER_CTA; it++) { + for (int jt = 0; jt < NUM_RES; jt++) { + cta_dwy_sum[jt] += + smem_[it * COLS + tidx + jt * Ktraits::THREADS_PER_CTA]; + } + } + + compute_t *dgamma_part = static_cast(dg_) + bidx * COLS + tidx; + for (int jt = 0; jt < NUM_RES; jt++) { + *dgamma_part = cta_dwy_sum[jt]; + dgamma_part += Ktraits::THREADS_PER_CTA; + } + + compute_t *dbeta_part = static_cast(db_) + bidx * COLS + tidx; + for (int jt = 0; jt < NUM_RES; jt++) { + *dbeta_part = cta_dw_sum[jt]; + dbeta_part += Ktraits::THREADS_PER_CTA; + } +} + +template +__global__ __launch_bounds__(Ktraits::THREADS_PER_CTA) void ln_bwd_finalize_kernel(void * __restrict__ dg_, + void * __restrict__ db_, + const void * __restrict__ dg_part_, + const void * __restrict__ db_part_, + const int rows + ){ + using Vec = typename Ktraits::Vec; + enum { NUM_ELTS = Vec::NUM_ELTS }; + + + using vec_t = typename Ktraits::vec_t; + using base_t = typename Ktraits::base_t; + using compute_t = typename Ktraits::compute_t; + + enum { BYTES_PER_LDG = Ktraits::BYTES_PER_LDG }; + enum { ROWS_PER_CTA = Ktraits::ROWS_PER_CTA }; + enum { WARPS_M = Ktraits::WARPS_M }; + enum { WARPS_N = Ktraits::WARPS_N }; + enum { THREADS_PER_ROW = Ktraits::THREADS_PER_ROW }; + enum { COLS = Ktraits::COLS }; + enum { BYTES_PER_ROW = Ktraits::BYTES_PER_ROW }; + enum {VEC_COLS = BYTES_PER_ROW / BYTES_PER_LDG}; + //dbg + static_assert(VEC_COLS == COLS / NUM_ELTS, ""); + //static_assert(VEC_COLS == 1024,""); + const int tidx = threadIdx.x; + const int bidx = blockIdx.x; + const int lane = tidx % THREADS_PER_WARP; + const int warp = tidx / THREADS_PER_WARP; + const int warp_m = warp / Ktraits::WARPS_N; + const int warp_n = warp % Ktraits::WARPS_N; + const int tid_c = warp_n * THREADS_PER_WARP + lane; + const int c =bidx * THREADS_PER_ROW + tid_c; + const int r = warp_m; + + __shared__ compute_t smem_[(WARPS_M - 1) * THREADS_PER_ROW * NUM_ELTS]; + + //Will probably run this with WARPS_N = 1 and grid = 1024 / (32*4) = 8, or NUM_ELTS=1 and grid = 32 + // and WARPS_M = 4 (or 1??) + for(int col = c; col < VEC_COLS; col += gridDim.x * THREADS_PER_ROW){ + const char* dg_part_ptr = static_cast(dg_part_) + r * BYTES_PER_ROW + col * BYTES_PER_LDG; + const char* db_part_ptr = static_cast(db_part_) + r * BYTES_PER_ROW + col * BYTES_PER_LDG; + + compute_t dg_sum[NUM_ELTS]; + compute_t db_sum[NUM_ELTS]; + memset(dg_sum, 0, sizeof(compute_t) * NUM_ELTS); + memset(db_sum, 0, sizeof(compute_t) * NUM_ELTS); + #pragma unroll + for(int row = r; row < rows;row += ROWS_PER_CTA){ + Vec dg; + Vec db; + dg.load_from(dg_part_ptr); + db.load_from(db_part_ptr); + dg_part_ptr += ROWS_PER_CTA * BYTES_PER_ROW; + db_part_ptr += ROWS_PER_CTA * BYTES_PER_ROW; + + #pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + dg_sum[jt] += dg.data.elt[jt]; + db_sum[jt] += db.data.elt[jt]; + } + } + + // Finalize the reduction across rows of the CTA + compute_t * smem_write; + smem_write = smem_ + (warp_m -1) *THREADS_PER_ROW * NUM_ELTS + tid_c; + + if (warp_m > 0) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + *smem_write = dg_sum[jt]; + smem_write+=THREADS_PER_ROW; + } + } + __syncthreads(); + compute_t *smem_read ; + smem_read = smem_ + tid_c ; + if (warp_m == 0) { +#pragma unroll + for (int it = 0; it < WARPS_M - 1; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + dg_sum[jt] += *smem_read; + smem_read += THREADS_PER_ROW; + } + } + } + + __syncthreads(); + + smem_write = smem_ + (warp_m -1) *THREADS_PER_ROW * NUM_ELTS + tid_c; + + if (warp_m > 0) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + *smem_write = db_sum[jt]; + smem_write+=THREADS_PER_ROW; + } + } + __syncthreads(); + smem_read = smem_ + tid_c; + if (warp_m == 0) { +#pragma unroll + for (int it = 0; it < WARPS_M - 1; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + db_sum[jt] += *smem_read; + smem_read += THREADS_PER_ROW; + } + } + + using vout_t = typename Vec_type::Type; + union { + vout_t raw; + out_t elt[NUM_ELTS]; + } dg_out, db_out; + + // out_t dg_out[NUM_ELTS], db_out[NUM_ELTS]; +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + dg_out.elt[jt] = dg_sum[jt]; + db_out.elt[jt] = db_sum[jt]; + } + vout_t *dg_ptr = reinterpret_cast(dg_) + col ; + vout_t *db_ptr = reinterpret_cast(db_) + col ; + *dg_ptr = dg_out.raw; + *db_ptr = db_out.raw; + } + } +} + +template +void launch(at::Tensor &dx, at::Tensor &dgamma, at::Tensor &dbeta, + at::Tensor &dgamma_part, at::Tensor &dbeta_part, + const at::Tensor &dw, const at::Tensor &x, + const at::Tensor &mu, const at::Tensor &rsigma, + const at::Tensor &gamma, const int rows, const int cols, const int gridx, cudaStream_t stream){ + + if (cols == 1024) { + using Ktraits = Kernel_traits; + + if (Ktraits::SMEM_BYTES >= 48 * 1024) { + AT_CUDA_CHECK(cudaFuncSetAttribute( + ln_bwd_kernel, cudaFuncAttributeMaxDynamicSharedMemorySize, + Ktraits::SMEM_BYTES)); + } + + ln_bwd_kernel + <<>>( + dx.data_ptr(), dgamma_part.data_ptr(), dbeta_part.data_ptr(), + dw.data_ptr(), x.data_ptr(), mu.data_ptr(), rsigma.data_ptr(), + gamma.data_ptr(), rows); + + using Ktraits2 = Kernel_traits; + + constexpr int grid2 = + DIVUP(1024, Ktraits2::THREADS_PER_ROW * Ktraits2::Vec::NUM_ELTS); + + ln_bwd_finalize_kernel + <<>>( + dgamma.data_ptr(), dbeta.data_ptr(), dgamma_part.data_ptr(), + dbeta_part.data_ptr(), gridx); + } else { + assert(false && "Not implemented"); + } + + AT_CUDA_CHECK(cudaPeekAtLastError()); +} + +void ln_bwd_cuda(at::Tensor &dx, at::Tensor &dgamma, at::Tensor &dbeta, + const at::Tensor &dw, const at::Tensor &x, + const at::Tensor &mu, const at::Tensor &rsigma, + const at::Tensor &gamma, const int rows, const int cols, cudaStream_t stream) { + + + const auto dtype = x.scalar_type(); + + + const auto props = at::cuda::getCurrentDeviceProperties(); + const int smCount = props->multiProcessorCount; + // Launch 2 CTAs per SM + const int grid = 2 * smCount; + + //request workspace for two-step reduction. We always reduce in FP32. + auto opts = x.options(); + auto dbeta_part = torch::empty({grid, cols}, opts.dtype(torch::kFloat32)); + auto dgamma_part = torch::empty({grid, cols}, opts.dtype(torch::kFloat32)); + + if (dtype == torch::kFloat16) { + launch(dx, dgamma, dbeta, dgamma_part, dbeta_part, dw, x, mu, rsigma, gamma, rows, cols, grid, stream); + } else if (dtype == torch::kFloat32) { + launch(dx, dgamma, dbeta, dgamma_part, dbeta_part, dw, x, mu, rsigma, gamma, rows, cols, grid, stream); + } else { + assert(false && "Not implemented"); + } + +} \ No newline at end of file diff --git a/apex/apex/contrib/csrc/layer_norm/ln_fwd_cuda_kernel.cu b/apex/apex/contrib/csrc/layer_norm/ln_fwd_cuda_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..b96762a802940704f95793340fc2f5be437b8603 --- /dev/null +++ b/apex/apex/contrib/csrc/layer_norm/ln_fwd_cuda_kernel.cu @@ -0,0 +1,186 @@ +#include "utils.cuh" +#include "ln_kernel_traits.h" +#include "ATen/cuda/CUDAContext.h" + +template +__global__ __launch_bounds__(Ktraits::THREADS_PER_CTA) void ln_fwd_kernel( + void *__restrict__ y_, void *__restrict__ mu_, void *__restrict__ rsigma_, + const void *__restrict__ x_, const void *__restrict__ gamma_, + const void *__restrict__ beta_, const float epsilon, int rows) { + + using Vec = typename Ktraits::Vec; + + using base_t = typename Ktraits::base_t; + using compute_t = typename Ktraits::compute_t; + enum { NUM_ELTS = Vec::NUM_ELTS }; + enum { WARPS_N = Ktraits::WARPS_N }; + enum { WARPS_M = Ktraits::WARPS_M }; + enum { ROWS_PER_CTA = Ktraits::ROWS_PER_CTA }; + + enum { THREADS_PER_ROW = Ktraits::THREADS_PER_ROW }; + enum { BYTES_PER_LDG = Ktraits::BYTES_PER_LDG }; + static_assert(BYTES_PER_LDG == 16, ""); + + enum { BYTES_PER_ROW = Ktraits::BYTES_PER_ROW }; + enum { LDGS = BYTES_PER_ROW / Ktraits::BYTES_PER_ROW_PER_CTA }; + static_assert(LDGS * Ktraits::BYTES_PER_ROW_PER_CTA == BYTES_PER_ROW, ""); + + const int tidx = threadIdx.x; + const int bidx = blockIdx.x; + const int lane = tidx % THREADS_PER_WARP; + const int warp = tidx / THREADS_PER_WARP; + const int warp_n = warp % WARPS_N; + const int warp_m = warp / WARPS_N; + + const int c = warp_n * THREADS_PER_WARP + lane; + const int r = bidx * ROWS_PER_CTA + warp_m; + + const char *x_ptr = static_cast(x_); + + const char *g_ptr = static_cast(gamma_); + const char *b_ptr = static_cast(beta_); + + char *y_ptr = static_cast(y_); + compute_t *mu_ptr = static_cast(mu_); + compute_t *rs_ptr = static_cast(rsigma_); + + Vec gamma[LDGS]; + Vec beta[LDGS]; +#pragma unroll + for (int it = 0, col = c; it < LDGS; it++) { + gamma[it].load_from(g_ptr + col * BYTES_PER_LDG); + beta[it].load_from(b_ptr + col * BYTES_PER_LDG); + col += THREADS_PER_ROW; + } + + constexpr compute_t rn = 1.f / compute_t(Ktraits::COLS); + for (int row = r; row < rows; row += gridDim.x * ROWS_PER_CTA) { + Vec x[LDGS]; +#pragma unroll + for (int it = 0, col = c; it < LDGS; it++) { + x[it].load_from(x_ptr + row * BYTES_PER_ROW + col * BYTES_PER_LDG); + col += THREADS_PER_ROW; + } + compute_t xf[LDGS * NUM_ELTS]; +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + xf[it * NUM_ELTS + jt] = compute_t(x[it].data.elt[jt]); + } + } + + compute_t mu_local = 0.f; + +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + mu_local += xf[it * NUM_ELTS + jt]; + } + } + +#pragma unroll + for (int it = 1; it < THREADS_PER_WARP; it *= 2) { + mu_local += __shfl_xor_sync(uint32_t(-1), mu_local, it); + } + mu_local *= rn; + if(lane == 0){ + mu_ptr[row] = mu_local; + } + compute_t var_local = 0.f; + +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + compute_t diff = xf[it * NUM_ELTS + jt] - mu_local; + var_local += diff * diff; + } + } + +#pragma unroll + for (int it = 1; it < THREADS_PER_WARP; it *= 2) { + var_local += __shfl_xor_sync(uint32_t(-1), var_local, it); + } + compute_t rsigma = rsqrtf(var_local * rn + epsilon); + if(lane == 0){ + rs_ptr[row] = rsigma; + } + +#pragma unroll + for (int it = 0; it < LDGS; it++) { +#pragma unroll + for (int jt = 0; jt < NUM_ELTS; jt++) { + base_t tmp = (rsigma * (xf[it * NUM_ELTS + jt] - mu_local)); + x[it].data.elt[jt] = gamma[it].data.elt[jt] * tmp + beta[it].data.elt[jt]; + } + } + +#pragma unroll + for (int it = 0, col = c; it < LDGS; it++) { + x[it].store_to(y_ptr + row * BYTES_PER_ROW + col * BYTES_PER_LDG); + col += THREADS_PER_ROW; + } + } +} +template +void launch( + at::Tensor & y, // BxSxhidden_size + at::Tensor & mu, + at::Tensor & rsigma, + const at::Tensor & x, // BxSxhidden_size + const at::Tensor & gamma, + const at::Tensor & beta, + const float epsilon, + const int rows, + const int cols, + const int max_gridx, + cudaStream_t stream +){ + + if (cols == 1024) { + using Ktraits = Kernel_traits; + const int grid = + std::min(DIVUP(rows, Ktraits::ROWS_PER_CTA), max_gridx); + + ln_fwd_kernel<<>>( + y.data_ptr(), mu.data_ptr(), rsigma.data_ptr(), x.data_ptr(), + gamma.data_ptr(), beta.data_ptr(), epsilon, rows); + + } else { + assert(false && "Not implemented"); + } + + AT_CUDA_CHECK(cudaPeekAtLastError()); +} + +void ln_fwd_cuda( + at::Tensor & y, // BxSxhidden_size + at::Tensor & mu, + at::Tensor & rsigma, + const at::Tensor & x, // BxSxhidden_size + const at::Tensor & gamma, + const at::Tensor & beta, + const float epsilon, + const int rows, const int cols, + cudaStream_t stream +){ + + const auto dtype = x.scalar_type(); + const auto props = at::cuda::getCurrentDeviceProperties(); + const int max_gridx = props->maxGridSize[0]; + + //TODO + // - Using dispatch macro costs 1% perf wtf?!?! + // - Tune FP32 warps + // - Add more sizes + if (dtype == torch::kFloat16) { + launch(y, mu, rsigma, x, gamma, beta, epsilon, rows, cols, max_gridx, stream); + } else if (dtype == torch::kFloat32) { + launch(y, mu, rsigma, x, gamma, beta, epsilon, rows, cols, max_gridx, stream); + } else { + assert(false && "Not implemented"); + } + +} \ No newline at end of file diff --git a/apex/apex/contrib/csrc/layer_norm/ln_kernel_traits.h b/apex/apex/contrib/csrc/layer_norm/ln_kernel_traits.h new file mode 100644 index 0000000000000000000000000000000000000000..3dda2a688f35defd32cc1d39a5a128e273714425 --- /dev/null +++ b/apex/apex/contrib/csrc/layer_norm/ln_kernel_traits.h @@ -0,0 +1,28 @@ +#pragma once + +constexpr uint32_t THREADS_PER_WARP = 32; + +template +struct Kernel_traits { + enum { WARPS_M = WARPS_M_ }; + enum { WARPS_N = WARPS_N_ }; + enum { COLS = COLS_ }; + enum { BYTES_PER_LDG = BYTES_PER_LDG_ }; + + using Vec = Vec; + + using vec_t = typename Vec::vec_t; + using base_t = typename Vec::base_t; + using packed_t = typename Vec::packed_t; + using compute_t = typename Vec::compute_t; + using packed_compute_t = typename Vec::packed_compute_t; + + enum { THREADS_PER_ROW = WARPS_N * THREADS_PER_WARP }; + enum { THREADS_PER_CTA = WARPS_M * THREADS_PER_ROW }; + enum { ROWS_PER_CTA = WARPS_M }; + + enum { BYTES_PER_ROW = COLS * sizeof(base_t) }; + enum { BYTES_PER_ROW_PER_CTA = THREADS_PER_ROW * BYTES_PER_LDG }; + enum {SMEM_BYTES = ROWS_PER_CTA * COLS * sizeof(compute_t)}; +}; diff --git a/apex/apex/contrib/csrc/layer_norm/utils.cuh b/apex/apex/contrib/csrc/layer_norm/utils.cuh new file mode 100644 index 0000000000000000000000000000000000000000..683fee2bfc0bc67e5c62b8bdfe545ab8f35ee9de --- /dev/null +++ b/apex/apex/contrib/csrc/layer_norm/utils.cuh @@ -0,0 +1,95 @@ +#pragma once + +#include "torch/extension.h" +#include // for CUDNN_CHECK + +#define DIVUP(x, y) (((x) + ((y)-1)) / (y)) + +#define DISPATCH_FLOAT_AND_HALF(TYPE, NAME, ...) \ + [&] { \ + const auto &the_type = TYPE; \ + /* don't use TYPE again in case it is an expensive or side-effect op */ \ + at::ScalarType _st = ::detail::scalar_type(the_type); \ + switch (_st) { \ + AT_PRIVATE_CASE_TYPE(at::ScalarType::Float, float, __VA_ARGS__) \ + AT_PRIVATE_CASE_TYPE(at::ScalarType::Half, at::Half, __VA_ARGS__) \ + default: \ + AT_ERROR(#NAME, " not implemented for '", toString(_st), "'"); \ + } \ + }() + +template struct Vec_type {}; + +template <> struct Vec_type<16> { + using Type = uint4; + static __device__ inline Type zero() { return make_uint4(0, 0, 0, 0); } +}; +template <> struct Vec_type<8> { + using Type = uint2; + static __device__ inline Type zero() { return make_uint2(0, 0); } +}; + +template <> struct Vec_type<4> { + using Type = uint32_t; + static __device__ inline Type zero() { return 0; } +}; + +template <> struct Vec_type<2> { + using Type = uint16_t; + static __device__ inline Type zero() { return 0; } +}; + +template struct TypeInfo { + using base_t = T; + using packed_t = T; + using compute_t = float; + using packed_compute_t = float; +}; + +template <> struct TypeInfo { + using base_t = half; + using packed_t = half2; + using compute_t = float; + using packed_compute_t = float2; +}; + +template struct Vec { + + using base_t = typename TypeInfo::base_t; + using packed_t = typename TypeInfo::packed_t; + using compute_t = typename TypeInfo::compute_t; + using packed_compute_t = typename TypeInfo::packed_compute_t; + + static_assert(Bytes % sizeof(base_t) == 0, ""); + static_assert(Bytes % sizeof(packed_t) == 0, ""); + enum { BYTES_PER_THREAD = Bytes }; + enum { NUM_ELTS = Bytes / sizeof(base_t) }; + enum { NUM_PACKED = Bytes / sizeof(packed_t) }; + using vec_t = typename Vec_type::Type; + using store_t = union { + vec_t raw; + base_t elt[NUM_ELTS]; + packed_t packed[NUM_PACKED]; + }; + store_t data; + + __device__ Vec() { data.raw = Vec_type::zero(); } + + __device__ inline void load_from(const char *ptr) { + data.raw = *reinterpret_cast(ptr); + } + + __device__ inline void load_or_zero(const char *ptr, const bool is_valid) { + data.raw = is_valid ? *reinterpret_cast(ptr) + : Vec_type::zero(); + } + + __device__ inline void store_to(char *ptr) const { + *reinterpret_cast(ptr) = data.raw; + } + + __device__ inline void store_valid(char *ptr, const bool is_valid) const { + if (is_valid) + *reinterpret_cast(ptr) = data.raw; + } +}; diff --git a/apex/apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout.cpp b/apex/apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout.cpp new file mode 100644 index 0000000000000000000000000000000000000000..d2573bdf1ae7f9c14f14d156305752e7a9a2a61f --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout.cpp @@ -0,0 +1,91 @@ +#include +#include +#include + +namespace multihead_attn { +namespace fused_softmax { +namespace additive_mask_softmax_dropout { + +std::vector fwd_cuda( + bool is_training, + int heads, + torch::Tensor const& input, + const half* pad_mask, + float dropout_prob + ); + +torch::Tensor bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& softmax_results, + torch::Tensor const& dropout_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool is_training, + int heads, + torch::Tensor const& input, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(input.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Half, "Only BYTE is supported"); + } + + return fwd_cuda( + is_training, + heads, + input, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +torch::Tensor bwd( + bool use_mask, + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& softmax_results, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); +// AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + softmax_results, + dropout_mask, + dropout_prob + ); +} + +} // end namespace mask_softmax_dropout +} // end namespace fused_softmax +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::fused_softmax::additive_mask_softmax_dropout::fwd, "Self Multihead Attention masked softmax dropout -- Forward."); + m.def("backward", &multihead_attn::fused_softmax::additive_mask_softmax_dropout::bwd, "Self Multihead Attention masked softmax dropout -- Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..bc8cd3b54353a4a6e07ed638095be0facb2f126e --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout_cuda.cu @@ -0,0 +1,131 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "softmax.h" +#include "dropout.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace fused_softmax { +namespace additive_mask_softmax_dropout { + +std::vector fwd_cuda( + bool is_training, + int heads, + torch::Tensor const& input, + const half* pad_mask, + float dropout_prob + ) +{ + const int attn_batches = input.size(0); + const int sequences = attn_batches / heads; + const int q_seq_len = input.size(1); + const int k_seq_len = q_seq_len; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = input.options().requires_grad(false); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* input_ptr = static_cast(input.data_ptr()); + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(input_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + softmax_success = dispatch_additive_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(input_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + + + if (is_training) { + //use at:: function so that C++ version generates the same random mask as python version + auto dropout_tuple = at::_fused_dropout(softmax_results, 1.0f-dropout_prob); + dropout_results = std::get<0>(dropout_tuple); + dropout_mask = std::get<1>(dropout_tuple); + } + + // Matmul2 + + return { + dropout_results, + dropout_mask, + softmax_results + }; +} + +torch::Tensor bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& softmax_results, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + const int attn_batches = output_grads.size(0); + const int q_seq_len = output_grads.size(1); + const int k_seq_len = q_seq_len; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations +// torch::Tensor input_grads = torch::empty_like(output_grads); + + // Apply Dropout Mask and Scale by Dropout Probability + // Softmax Grad + dispatch_masked_scale_softmax_backward_stream( + static_cast(output_grads.data_ptr()), + static_cast(output_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + 1.0/(1.0-dropout_prob), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, stream); +//backward pass is completely in-place + return output_grads; +} +} +} +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/dropout.h b/apex/apex/contrib/csrc/multihead_attn/dropout.h new file mode 100644 index 0000000000000000000000000000000000000000..6edf2300ff48d361665690d584f1629d770f7b1e --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/dropout.h @@ -0,0 +1,308 @@ +#include + +#ifdef OLD_GENERATOR +#include +#else +#include +#endif + +#include +#include + +#include + +const int UNROLL = 4; + +template < + typename scalar_t, + typename accscalar_t, + typename IndexType + > +__global__ void apex_fused_dropout_kernel(scalar_t const *inputs, + scalar_t *outputs, + uint8_t *mask, + IndexType totalElements, + accscalar_t p, + std::pair seeds + ) +{ + accscalar_t pinv = accscalar_t(1)/p; + IndexType idx = blockIdx.x * blockDim.x + threadIdx.x; + + curandStatePhilox4_32_10_t state; + curand_init( + seeds.first, + idx, + seeds.second, + &state); + + IndexType rounded_size = ((totalElements - 1)/(blockDim.x * gridDim.x * UNROLL)+1) * blockDim.x * gridDim.x * UNROLL; + for (IndexType linearIndex = idx; + linearIndex < rounded_size; + linearIndex += gridDim.x * blockDim.x*UNROLL) { + float4 rand = curand_uniform4(&state); + scalar_t src[UNROLL]; + rand.x = rand.x <= p; + rand.y = rand.y <= p; + rand.z = rand.z <= p; + rand.w = rand.w <= p; + + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + src[ii] = inputs[li]; + } + } + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + outputs[li] = src[ii]*(&rand.x)[ii]*pinv; + mask[li] = (uint8_t)(&rand.x)[ii]; + } + } + __syncthreads(); + } +} + +template < + typename scalar_t, + typename accscalar_t, + typename IndexType + > +__global__ void apex_dropout_add_kernel(scalar_t const *inputs, + scalar_t const *add_inputs, + scalar_t *outputs, + uint8_t *mask, + IndexType totalElements, + accscalar_t p, + std::pair seeds + ) +{ + accscalar_t pinv = accscalar_t(1)/p; + IndexType idx = blockIdx.x * blockDim.x + threadIdx.x; + + curandStatePhilox4_32_10_t state; + curand_init( + seeds.first, + idx, + seeds.second, + &state); + + IndexType rounded_size = ((totalElements - 1)/(blockDim.x * gridDim.x * UNROLL)+1) * blockDim.x * gridDim.x * UNROLL; + for (IndexType linearIndex = idx; + linearIndex < rounded_size; + linearIndex += gridDim.x * blockDim.x*UNROLL) { + float4 rand = curand_uniform4(&state); + scalar_t src[UNROLL]; + scalar_t add_src[UNROLL]; + rand.x = rand.x <= p; + rand.y = rand.y <= p; + rand.z = rand.z <= p; + rand.w = rand.w <= p; + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + src[ii] = inputs[li]; + add_src[ii] = add_inputs[li]; + } + } + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + accscalar_t int1 = src[ii] * (&rand.x)[ii] * pinv; + outputs[li] = static_cast(static_cast(add_src[ii]) + int1); + mask[li] = (uint8_t)(&rand.x)[ii]; + } + } + __syncthreads(); + } +} + +template < + typename scalar_t, + typename accscalar_t, + typename IndexType + > +__global__ void apex_add_kernel( scalar_t const *inputs, + scalar_t const *add_inputs, + scalar_t *outputs, + IndexType totalElements + ) +{ + IndexType idx = blockIdx.x * blockDim.x + threadIdx.x; + IndexType rounded_size = ((totalElements - 1)/(blockDim.x * gridDim.x * UNROLL)+1) * blockDim.x * gridDim.x * UNROLL; + for (IndexType linearIndex = idx; + linearIndex < rounded_size; + linearIndex += gridDim.x * blockDim.x*UNROLL) { + scalar_t src[UNROLL]; + scalar_t add_src[UNROLL]; + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + src[ii] = inputs[li]; + add_src[ii] = add_inputs[li]; + } + } + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + outputs[li] = src[ii] + add_src[ii]; + } + } + __syncthreads(); + } +} + +template +__global__ void apex_masked_scale_kernel(scalar_t const *inputs, + scalar_t *outputs, + uint8_t const *mask, + IndexType totalElements, + accscalar_t scale + ) +{ + IndexType idx = blockIdx.x * blockDim.x + threadIdx.x; + IndexType rounded_size = ((totalElements - 1)/(blockDim.x * gridDim.x * UNROLL)+1) * blockDim.x * gridDim.x * UNROLL; + for (IndexType linearIndex = idx; + linearIndex < rounded_size; + linearIndex += gridDim.x * blockDim.x*UNROLL) + { + scalar_t src[UNROLL]; + scalar_t msk[UNROLL]; + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + src[ii] = static_cast(inputs[li]); + msk[ii] = static_cast(mask[li]); + } + } + for (int ii = 0; ii < UNROLL; ii++) { + IndexType li = linearIndex + blockDim.x * gridDim.x * ii; + if (li < totalElements) { + outputs[li] = static_cast(src[ii]) * scale * static_cast(msk[ii]); + } + } + } +} + +template < + typename scalar_t, + typename accscalar_t, + typename IndexType + > +void apex_fused_dropout_cuda(scalar_t const *inputs, + scalar_t *outputs, + uint8_t *mask, + IndexType totalElements, + accscalar_t p) +{ + auto gen = at::cuda::detail::getDefaultCUDAGenerator(); + + int block_size = 256; + dim3 dim_block(block_size); + dim3 grid((totalElements + block_size -1)/block_size); + unsigned int blocks_per_sm = at::cuda::getCurrentDeviceProperties()->maxThreadsPerMultiProcessor/block_size; + grid.x = std::min((unsigned int)at::cuda::getCurrentDeviceProperties()->multiProcessorCount * blocks_per_sm, grid.x); + + //number of times random will be generated per thread, to offset philox counter in thc random state + int64_t counter_offset = ((totalElements - 1)/(block_size*grid.x*UNROLL)+1)*UNROLL; + std::pair rng_engine_inputs; + { + // See Note [Acquire lock when using random generators] +#ifdef OLD_GENERATOR + std::lock_guard lock(gen->mutex_); + rng_engine_inputs = gen->philox_engine_inputs(counter_offset); +#else + std::lock_guard lock(gen.mutex()); + rng_engine_inputs = at::check_generator(gen)->philox_engine_inputs(counter_offset); +#endif + } + + apex_fused_dropout_kernel<<>>(inputs, outputs, mask, totalElements, p, rng_engine_inputs); + THCudaCheck(cudaGetLastError()); +} + +template < + typename scalar_t, + typename accscalar_t, + typename IndexType + > +void apex_dropout_add_cuda(scalar_t const *inputs, + scalar_t const *add_inputs, + scalar_t *outputs, + uint8_t *mask, + IndexType totalElements, + accscalar_t p) +{ + auto gen = at::cuda::detail::getDefaultCUDAGenerator(); + + int block_size = 256; + dim3 dim_block(block_size); + dim3 grid((totalElements + block_size -1)/block_size); + unsigned int blocks_per_sm = at::cuda::getCurrentDeviceProperties()->maxThreadsPerMultiProcessor/block_size; + grid.x = std::min((unsigned int)at::cuda::getCurrentDeviceProperties()->multiProcessorCount * blocks_per_sm, grid.x); + + //number of times random will be generated per thread, to offset philox counter in thc random state + int64_t counter_offset = ((totalElements - 1)/(block_size*grid.x*UNROLL)+1)*UNROLL; + std::pair rng_engine_inputs; + { + // See Note [Acquire lock when using random generators] +#ifdef OLD_GENERATOR + std::lock_guard lock(gen->mutex_); + rng_engine_inputs = gen->philox_engine_inputs(counter_offset); +#else + std::lock_guard lock(gen.mutex()); + rng_engine_inputs = at::check_generator(gen)->philox_engine_inputs(counter_offset); +#endif + } + + apex_dropout_add_kernel<<>>(inputs, add_inputs, outputs, mask, totalElements, p, rng_engine_inputs); + THCudaCheck(cudaGetLastError()); +} + +template < + typename scalar_t, + typename accscalar_t, + typename IndexType + > +void apex_add_cuda(scalar_t const *inputs, + scalar_t const *add_inputs, + scalar_t *outputs, + IndexType totalElements + ) +{ + int block_size = 256; + dim3 dim_block(block_size); + dim3 grid((totalElements + block_size -1)/block_size); + unsigned int blocks_per_sm = at::cuda::getCurrentDeviceProperties()->maxThreadsPerMultiProcessor/block_size; + grid.x = std::min((unsigned int)at::cuda::getCurrentDeviceProperties()->multiProcessorCount * blocks_per_sm, grid.x); + + apex_add_kernel<<>>(inputs, add_inputs, outputs, totalElements); + THCudaCheck(cudaGetLastError()); +} + +template +void apex_masked_scale_cuda(scalar_t const *inputs, + scalar_t *outputs, + uint8_t const *mask, + IndexType totalElements, + accscalar_t scale + ) +{ + int block_size = 256; + dim3 dim_block(block_size); + dim3 grid((totalElements + block_size -1)/block_size); + unsigned int blocks_per_sm = at::cuda::getCurrentDeviceProperties()->maxThreadsPerMultiProcessor/block_size; + grid.x = std::min((unsigned int)at::cuda::getCurrentDeviceProperties()->multiProcessorCount * blocks_per_sm, grid.x); + + apex_masked_scale_kernel<<>>(inputs, outputs, mask, totalElements, scale); + THCudaCheck(cudaGetLastError()); +} + + diff --git a/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn.cpp b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn.cpp new file mode 100644 index 0000000000000000000000000000000000000000..35d4d110958ee68221cdf860c13a1cdbdb086251 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn.cpp @@ -0,0 +1,156 @@ +#include +#include + +namespace multihead_attn { +namespace encdec { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ); +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_q_results, + torch::Tensor const& input_lin_kv_results, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(inputs_q.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs_kv.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights_q.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(input_weights_kv.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + + AT_ASSERTM(inputs_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + } + + return fwd_cuda( + use_time_mask, + is_training, + heads, + inputs_q, + inputs_kv, + input_weights_q, + input_weights_kv, + output_weights, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +std::vector bwd( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_q_results, + torch::Tensor const& input_lin_kv_results, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(matmul2_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_q_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_kv_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs_q.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs_kv.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights_q.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(input_weights_kv.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(matmul2_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_q_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_kv_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + matmul2_results, + dropout_results, + softmax_results, + input_lin_q_results, + input_lin_kv_results, + inputs_q, + inputs_kv, + input_weights_q, + input_weights_kv, + output_weights, + dropout_mask, + dropout_prob + ); +} + +} // end namespace cublas_gemmex +} // end namespace encdec +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::encdec::cublas_gemmex::fwd, "Encdec Multihead Attention Forward."); + m.def("backward", &multihead_attn::encdec::cublas_gemmex::bwd, "Encdec Multihead Attention Backward."); +} diff --git a/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..be67ee06b2094bc041660354b6cf43ac3861d9ea --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_cuda.cu @@ -0,0 +1,556 @@ +#include +#include + +#include +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "strided_batched_gemm.h" +#include "softmax.h" +#include "dropout.h" +#include "layer_norm.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace encdec { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs_q.size(2); + const int sequences = inputs_q.size(1); + const int q_seq_len = inputs_q.size(0); + const int k_seq_len = inputs_kv.size(0); + const int batches_q = sequences * q_seq_len; + const int batches_kv = sequences * k_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_q_dim = embed_dim; + const int output_lin_kv_dim = 2 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim_q = attn_batches * head_dim; + const int lead_dim_kv = attn_batches * 2 *head_dim; + const int batch_stride_q = head_dim; + const int batch_stride_kv = 2 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = inputs_q.options().requires_grad(false); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor input_lin_q_results = torch::empty({q_seq_len, sequences, output_lin_q_dim}, act_options); + torch::Tensor input_lin_kv_results = torch::empty({k_seq_len, sequences, output_lin_kv_dim}, act_options); + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + torch::Tensor matmul2_results = torch::empty({q_seq_len, attn_batches, head_dim}, act_options); + torch::Tensor outputs = torch::empty_like(inputs_q, act_options); + + // Input Linear Results Pointers to Q, K, and V of interviewed activations + void* q_lin_results_ptr = static_cast(input_lin_q_results.data_ptr()); + void* k_lin_results_ptr = static_cast(input_lin_kv_results.data_ptr()); + void* v_lin_results_ptr = static_cast(static_cast(input_lin_kv_results.data_ptr()) + head_dim); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + char a_layout_t{'t'}; + char a_layout_n{'n'}; + char b_layout_n{'n'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + // Input Linear Q Fwd + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_q_dim, + batches_q, + embed_dim, + static_cast(&alpha), + static_cast(input_weights_q.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(inputs_q.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + q_lin_results_ptr, + CUDA_R_16F, + output_lin_q_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear KV Fwd + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_kv_dim, + batches_kv, + embed_dim, + static_cast(&alpha), + static_cast(input_weights_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(inputs_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + k_lin_results_ptr, + CUDA_R_16F, + output_lin_kv_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul1 of Dot-Product Attention Plus scaling by 1/Sqrt(head size) + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + scale, + static_cast(k_lin_results_ptr), + lead_dim_kv, + batch_stride_kv, + static_cast(q_lin_results_ptr), + lead_dim_q, + batch_stride_q, + beta, + static_cast(softmax_results_ptr), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + if (use_time_mask) { + softmax_success = dispatch_time_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + q_seq_len); + } else { + softmax_success = dispatch_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + } + assert(softmax_success); + + if (is_training) { + apex_fused_dropout_cuda( + static_cast(softmax_results.data_ptr()), + static_cast(dropout_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0f - dropout_prob)); + } + + // Matmul2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + alpha, + static_cast(v_lin_results_ptr), + lead_dim_kv, + batch_stride_kv, + (is_training) ? static_cast(dropout_results.data_ptr()) : static_cast(softmax_results.data_ptr()) , + k_seq_len, + k_seq_len*q_seq_len, + beta, + static_cast(matmul2_results.data_ptr()), + head_dim*attn_batches, + head_dim, + attn_batches); + + // Output Linear + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + embed_dim, + batches_q, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(outputs.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO1_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_lin_q_results, + input_lin_kv_results, + softmax_results, + dropout_results, + dropout_mask, + matmul2_results, + outputs + }; +} + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_q_results, + torch::Tensor const& input_lin_kv_results, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs_q.size(2); + const int sequences = inputs_q.size(1); + const int q_seq_len = inputs_q.size(0); + const int k_seq_len = inputs_kv.size(0); + const int batches_q = sequences * q_seq_len; + const int batches_kv = sequences * k_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_q_dim = embed_dim; + const int output_lin_kv_dim = 2 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim_q = attn_batches * head_dim; + const int lead_dim_kv = attn_batches * 2 *head_dim; + const int batch_stride_q = head_dim; + const int batch_stride_kv = 2 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations + torch::Tensor input_q_grads = torch::empty_like(inputs_q); + torch::Tensor input_kv_grads = torch::empty_like(inputs_kv); + torch::Tensor input_weight_q_grads = torch::empty_like(input_weights_q); + torch::Tensor input_weight_kv_grads = torch::empty_like(input_weights_kv); + torch::Tensor output_weight_grads = torch::empty_like(output_weights); + // Intermediate Tensor Allocations + at::Tensor output_lin_grads = torch::empty_like(matmul2_results); + at::Tensor matmul2_grads = torch::empty_like(dropout_results); + at::Tensor input_lin_q_output_grads = torch::empty_like(input_lin_q_results); + at::Tensor input_lin_kv_output_grads = torch::empty_like(input_lin_kv_results); + + auto q_lin_results_ptr = static_cast(input_lin_q_results.data_ptr()); + auto k_lin_results_ptr = static_cast(input_lin_kv_results.data_ptr()); + auto v_lin_results_ptr = static_cast(input_lin_kv_results.data_ptr()) + head_dim; + + auto q_lin_grads_ptr = static_cast(input_lin_q_output_grads.data_ptr()); + auto k_lin_grads_ptr = static_cast(input_lin_kv_output_grads.data_ptr()); + auto v_lin_grads_ptr = static_cast(input_lin_kv_output_grads.data_ptr()) + head_dim; + + char a_layout_n{'n'}; + char a_layout_t{'t'}; + char b_layout_n{'n'}; + char b_layout_t{'t'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + + // Output Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches_q, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Output Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + embed_dim, + batches_q, + static_cast(&alpha), + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul2 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + alpha, + static_cast(v_lin_results_ptr), + lead_dim_kv, + batch_stride_kv, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + beta, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Matmul2 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + alpha, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + v_lin_grads_ptr, + lead_dim_kv, + batch_stride_kv, + attn_batches); + + // Apply Dropout Mask and Scale by Dropout Probability + apex_masked_scale_cuda( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0 / (1.0 - dropout_prob))); + + // Softmax Grad + bool softmax_success = false; + softmax_success = dispatch_softmax_backward( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + assert(softmax_success); + + // Matmul1 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + scale, + k_lin_results_ptr, + lead_dim_kv, + batch_stride_kv, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + q_lin_grads_ptr, + lead_dim_q, + batch_stride_q, + attn_batches); + + // Matmul1 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + scale, + q_lin_results_ptr, + lead_dim_q, + batch_stride_q, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + k_lin_grads_ptr, + lead_dim_kv, + batch_stride_kv, + attn_batches); + + // Input Linear Q Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches_q, + output_lin_q_dim, + static_cast(&alpha), + static_cast(input_weights_q.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_q_dim, + static_cast(&beta), + static_cast(input_q_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear Q Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_q_dim, + batches_q, + static_cast(&alpha), + static_cast(inputs_q.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_q_dim, + static_cast(&beta), + static_cast(input_weight_q_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear KV Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches_kv, + output_lin_kv_dim, + static_cast(&alpha), + static_cast(input_weights_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(k_lin_grads_ptr), + CUDA_R_16F, + output_lin_kv_dim, + static_cast(&beta), + static_cast(input_kv_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear KV Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_kv_dim, + batches_kv, + static_cast(&alpha), + static_cast(inputs_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(k_lin_grads_ptr), + CUDA_R_16F, + output_lin_kv_dim, + static_cast(&beta), + static_cast(input_weight_kv_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_q_grads, + input_kv_grads, + input_weight_q_grads, + input_weight_kv_grads, + output_weight_grads + }; +} + +} // end namespace cublas_gemmex +} // end namespace encdec +} // end namespace multihead_attn diff --git a/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add.cpp b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add.cpp new file mode 100644 index 0000000000000000000000000000000000000000..314e9a9eee7faafd5db6ffc762f3efe72d0dc7b5 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add.cpp @@ -0,0 +1,198 @@ +#include +#include + +namespace multihead_attn { +namespace encdec_norm_add { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ); + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_q_results, + torch::Tensor const& input_lin_kv_results, + torch::Tensor const& lyr_nrm_results, + torch::Tensor const& lyr_nrm_mean, + torch::Tensor const& lyr_nrm_invvar, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + torch::Tensor const& dropout_add_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(inputs_q.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs_kv.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_gamma_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(lyr_nrm_beta_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(input_weights_q.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(input_weights_kv.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + + AT_ASSERTM(inputs_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_gamma_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_beta_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + } + + return fwd_cuda( + use_time_mask, + is_training, + heads, + inputs_q, + inputs_kv, + lyr_nrm_gamma_weights, + lyr_nrm_beta_weights, + input_weights_q, + input_weights_kv, + output_weights, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +std::vector bwd( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_q_results, + torch::Tensor const& input_lin_kv_results, + torch::Tensor const& lyr_nrm_results, + torch::Tensor const& lyr_nrm_mean, + torch::Tensor const& lyr_nrm_invvar, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + torch::Tensor const& dropout_add_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(matmul2_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_q_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_kv_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_mean.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(lyr_nrm_invvar.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(inputs_q.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs_kv.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_gamma_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(lyr_nrm_beta_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(input_weights_q.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(input_weights_kv.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_add_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(matmul2_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_q_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_kv_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_mean.type().scalarType() == at::ScalarType::Float, "Only FLOAT is supported"); + AT_ASSERTM(lyr_nrm_invvar.type().scalarType() == at::ScalarType::Float, "Only FLOAT is supported"); + AT_ASSERTM(inputs_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_gamma_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_beta_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_q.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights_kv.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + AT_ASSERTM(dropout_add_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + matmul2_results, + dropout_results, + softmax_results, + input_lin_q_results, + input_lin_kv_results, + lyr_nrm_results, + lyr_nrm_mean, + lyr_nrm_invvar, + inputs_q, + inputs_kv, + lyr_nrm_gamma_weights, + lyr_nrm_beta_weights, + input_weights_q, + input_weights_kv, + output_weights, + dropout_mask, + dropout_add_mask, + dropout_prob + ); +} + +} // end namespace cublas_gemmex +} // end namespace encdec_norm_add +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::encdec_norm_add::cublas_gemmex::fwd, "Encdec Multihead Attention Plus Layer Norm and Residual Add Forward."); + m.def("backward", &multihead_attn::encdec_norm_add::cublas_gemmex::bwd, "Encdec Multihead Attention Plus Layer Norm and Residual Add Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..9d6bb10ba04f2846a007e2ca9a2ee6dc5fd6b6d3 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add_cuda.cu @@ -0,0 +1,640 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "strided_batched_gemm.h" +#include "softmax.h" +#include "dropout.h" +#include "layer_norm.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace encdec_norm_add { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs_q.size(2); + const int sequences = inputs_q.size(1); + const int q_seq_len = inputs_q.size(0); + const int k_seq_len = inputs_kv.size(0); + const int batches_q = sequences * q_seq_len; + const int batches_kv = sequences * k_seq_len; + const int total_tokens_q = batches_q * embed_dim; + const int head_dim = embed_dim / heads; + const int output_lin_q_dim = embed_dim; + const int output_lin_kv_dim = 2 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim_q = attn_batches * head_dim; + const int lead_dim_kv = attn_batches * 2 *head_dim; + const int batch_stride_q = head_dim; + const int batch_stride_kv = 2 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = inputs_q.options().requires_grad(false); + auto lyr_nrm_options = act_options.dtype(torch::kFloat32); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor lyr_nrm_mean = torch::empty({batches_q}, lyr_nrm_options); + torch::Tensor lyr_nrm_invvar = torch::empty({batches_q}, lyr_nrm_options); + torch::Tensor lyr_nrm_results = torch::empty_like(inputs_q, act_options); + + torch::Tensor input_lin_q_results = torch::empty({q_seq_len, sequences, output_lin_q_dim}, act_options); + torch::Tensor input_lin_kv_results = torch::empty({k_seq_len, sequences, output_lin_kv_dim}, act_options); + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + torch::Tensor matmul2_results = torch::empty({q_seq_len, attn_batches, head_dim}, act_options); + torch::Tensor output_lin_results = torch::empty_like(inputs_q, act_options); + torch::Tensor dropout_add_mask = torch::empty_like(inputs_q, mask_options); + torch::Tensor outputs = torch::empty_like(inputs_q, act_options); + + // Input Linear Results Pointers to Q, K, and V of interviewed activations + void* q_lin_results_ptr = static_cast(input_lin_q_results.data_ptr()); + void* k_lin_results_ptr = static_cast(input_lin_kv_results.data_ptr()); + void* v_lin_results_ptr = static_cast(static_cast(input_lin_kv_results.data_ptr()) + head_dim); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + char a_layout_t{'t'}; + char a_layout_n{'n'}; + char b_layout_n{'n'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + // Layer Norm + HostApplyLayerNorm( + static_cast(lyr_nrm_results.data_ptr()), + static_cast(lyr_nrm_mean.data_ptr()), + static_cast(lyr_nrm_invvar.data_ptr()), + static_cast(inputs_q.data_ptr()), + static_cast(batches_q), // n1 + static_cast(embed_dim), // n2 + 1.0e-5, + static_cast(lyr_nrm_gamma_weights.data_ptr()), + static_cast(lyr_nrm_beta_weights.data_ptr())); + + // Input Linear Q Fwd + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_q_dim, + batches_q, + embed_dim, + static_cast(&alpha), + static_cast(input_weights_q.data_ptr()), + CUDA_R_16F, + embed_dim, + //static_cast(inputs_q.data_ptr()), + static_cast(lyr_nrm_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + q_lin_results_ptr, + CUDA_R_16F, + output_lin_q_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear KV Fwd + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_kv_dim, + batches_kv, + embed_dim, + static_cast(&alpha), + static_cast(input_weights_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(inputs_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + k_lin_results_ptr, + CUDA_R_16F, + output_lin_kv_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul1 of Dot-Product Attention Plus scaling by 1/Sqrt(head size) + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + scale, + static_cast(k_lin_results_ptr), + lead_dim_kv, + batch_stride_kv, + static_cast(q_lin_results_ptr), + lead_dim_q, + batch_stride_q, + beta, + static_cast(softmax_results_ptr), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + if (use_time_mask) { + softmax_success = dispatch_time_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + q_seq_len); + } else { + softmax_success = dispatch_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + } + assert(softmax_success); + + if (is_training) { + apex_fused_dropout_cuda( + static_cast(softmax_results.data_ptr()), + static_cast(dropout_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0f - dropout_prob)); + } + + // Matmul2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + alpha, + static_cast(v_lin_results_ptr), + lead_dim_kv, + batch_stride_kv, + (is_training) ? static_cast(dropout_results.data_ptr()) : static_cast(softmax_results.data_ptr()), + //static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + static_cast(matmul2_results.data_ptr()), + head_dim*attn_batches, + head_dim, + attn_batches); + + // Output Linear + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + embed_dim, + batches_q, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_results.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO1_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // End-of-block Dropout-Add + if (is_training) { + apex_dropout_add_cuda( + static_cast(output_lin_results.data_ptr()), + static_cast(inputs_q.data_ptr()), + static_cast(outputs.data_ptr()), + static_cast(dropout_add_mask.data_ptr()), + total_tokens_q, + (1.0f - dropout_prob)); + } else { + apex_add_cuda( + static_cast(output_lin_results.data_ptr()), + static_cast(inputs_q.data_ptr()), + static_cast(outputs.data_ptr()), + total_tokens_q); + } + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + lyr_nrm_results, + lyr_nrm_mean, + lyr_nrm_invvar, + input_lin_q_results, + input_lin_kv_results, + softmax_results, + dropout_results, + dropout_mask, + matmul2_results, + dropout_add_mask, + outputs + }; +} + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_q_results, + torch::Tensor const& input_lin_kv_results, + torch::Tensor const& lyr_nrm_results, + torch::Tensor const& lyr_nrm_mean, + torch::Tensor const& lyr_nrm_invvar, + torch::Tensor const& inputs_q, + torch::Tensor const& inputs_kv, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights_q, + torch::Tensor const& input_weights_kv, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + torch::Tensor const& dropout_add_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs_q.size(2); + const int sequences = inputs_q.size(1); + const int q_seq_len = inputs_q.size(0); + const int k_seq_len = inputs_kv.size(0); + const int batches_q = sequences * q_seq_len; + const int batches_kv = sequences * k_seq_len; + const int total_tokens_q = batches_q * embed_dim; + const int head_dim = embed_dim / heads; + const int output_lin_q_dim = embed_dim; + const int output_lin_kv_dim = 2 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim_q = attn_batches * head_dim; + const int lead_dim_kv = attn_batches * 2 *head_dim; + const int batch_stride_q = head_dim; + const int batch_stride_kv = 2 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations + torch::Tensor input_q_grads = torch::empty_like(inputs_q); + torch::Tensor input_kv_grads = torch::empty_like(inputs_kv); + torch::Tensor lyr_nrm_gamma_grads = torch::empty_like(lyr_nrm_gamma_weights); + torch::Tensor lyr_nrm_beta_grads = torch::empty_like(lyr_nrm_beta_weights); + torch::Tensor input_weight_q_grads = torch::empty_like(input_weights_q); + torch::Tensor input_weight_kv_grads = torch::empty_like(input_weights_kv); + torch::Tensor output_weight_grads = torch::empty_like(output_weights); + // Intermediate Tensor Allocations + at::Tensor dropout_add_grads = torch::empty_like(output_grads); + at::Tensor output_lin_grads = torch::empty_like(matmul2_results); + at::Tensor matmul2_grads = torch::empty_like(dropout_results); + at::Tensor input_lin_q_output_grads = torch::empty_like(input_lin_q_results); + at::Tensor input_lin_kv_output_grads = torch::empty_like(input_lin_kv_results); + at::Tensor input_lin_q_grads = torch::empty_like(inputs_q); + + auto q_lin_results_ptr = static_cast(input_lin_q_results.data_ptr()); + auto k_lin_results_ptr = static_cast(input_lin_kv_results.data_ptr()); + auto v_lin_results_ptr = static_cast(input_lin_kv_results.data_ptr()) + head_dim; + + auto q_lin_grads_ptr = static_cast(input_lin_q_output_grads.data_ptr()); + auto k_lin_grads_ptr = static_cast(input_lin_kv_output_grads.data_ptr()); + auto v_lin_grads_ptr = static_cast(input_lin_kv_output_grads.data_ptr()) + head_dim; + + char a_layout_n{'n'}; + char a_layout_t{'t'}; + char b_layout_n{'n'}; + char b_layout_t{'t'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + + // Dropout Add Backward + apex_masked_scale_cuda( + static_cast(output_grads.data_ptr()), + static_cast(dropout_add_grads.data_ptr()), + static_cast(dropout_add_mask.data_ptr()), + total_tokens_q, + (1.0 / (1.0 - dropout_prob))); + + // Output Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches_q, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(dropout_add_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Output Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + embed_dim, + batches_q, + static_cast(&alpha), + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(dropout_add_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul2 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + alpha, + static_cast(v_lin_results_ptr), + lead_dim_kv, + batch_stride_kv, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + beta, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Matmul2 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + alpha, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + v_lin_grads_ptr, + lead_dim_kv, + batch_stride_kv, + attn_batches); + + // Apply Dropout Mask and Scale by Dropout Probability + apex_masked_scale_cuda( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0 / (1.0 - dropout_prob))); + + // Softmax Grad + bool softmax_success = false; + softmax_success = dispatch_softmax_backward( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + assert(softmax_success); + + // Matmul1 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + scale, + k_lin_results_ptr, + lead_dim_kv, + batch_stride_kv, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + q_lin_grads_ptr, + lead_dim_q, + batch_stride_q, + attn_batches); + + // Matmul1 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + scale, + q_lin_results_ptr, + lead_dim_q, + batch_stride_q, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + k_lin_grads_ptr, + lead_dim_kv, + batch_stride_kv, + attn_batches); + + // Input Linear Q Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches_q, + output_lin_q_dim, + static_cast(&alpha), + static_cast(input_weights_q.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_q_dim, + static_cast(&beta), + //static_cast(input_q_grads.data_ptr()), + static_cast(input_lin_q_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear Q Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_q_dim, + batches_q, + static_cast(&alpha), + static_cast(inputs_q.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_q_dim, + static_cast(&beta), + static_cast(input_weight_q_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear KV Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches_kv, + output_lin_kv_dim, + static_cast(&alpha), + static_cast(input_weights_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(k_lin_grads_ptr), + CUDA_R_16F, + output_lin_kv_dim, + static_cast(&beta), + static_cast(input_kv_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear KV Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_kv_dim, + batches_kv, + static_cast(&alpha), + static_cast(inputs_kv.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(k_lin_grads_ptr), + CUDA_R_16F, + output_lin_kv_dim, + static_cast(&beta), + static_cast(input_weight_kv_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Fused Layer Norm Bwd with Residual Add + HostLayerNormGradient( + static_cast(input_lin_q_grads.data_ptr()), + static_cast(output_grads.data_ptr()), + static_cast(lyr_nrm_mean.data_ptr()), + static_cast(lyr_nrm_invvar.data_ptr()), + inputs_q, + static_cast(batches_q), // n1 + static_cast(embed_dim), // n2 + static_cast(lyr_nrm_gamma_weights.data_ptr()), + static_cast(lyr_nrm_beta_weights.data_ptr()), + 1.0e-5, + static_cast(input_q_grads.data_ptr()), + static_cast(lyr_nrm_gamma_grads.data_ptr()), + static_cast(lyr_nrm_beta_grads.data_ptr()) + ); + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_q_grads, + input_kv_grads, + lyr_nrm_gamma_grads, + lyr_nrm_beta_grads, + input_weight_q_grads, + input_weight_kv_grads, + output_weight_grads + }; +} + +} // end namespace cublas_gemmex +} // end namespace encdec_norm_add +} // end namespace multihead_attn diff --git a/apex/apex/contrib/csrc/multihead_attn/layer_norm.h b/apex/apex/contrib/csrc/multihead_attn/layer_norm.h new file mode 100644 index 0000000000000000000000000000000000000000..a6258a0c572886fc7e4954949ddb6f6943a824e3 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/layer_norm.h @@ -0,0 +1,740 @@ +#include "ATen/ATen.h" +#include + +#include +#include + +template __device__ +void cuWelfordOnlineSum( + const U curr, + U& mu, + U& sigma2, + U& count) +{ + count = count + U(1); + U delta = curr - mu; + U lmean = mu + delta / count; + mu = lmean; + U delta2 = curr - lmean; + sigma2 = sigma2 + delta * delta2; +} + +template __device__ +void cuChanOnlineSum( + const U muB, + const U sigma2B, + const U countB, + U& mu, + U& sigma2, + U& count) +{ + U delta = muB - mu; + U nA = count; + U nB = countB; + count = count + countB; + U nX = count; + if (nX > U(0)) { + nA = nA / nX; + nB = nB / nX; + mu = nA*mu + nB*muB; + sigma2 = sigma2 + sigma2B + delta * delta * nA * nB * nX; + } else { + mu = U(0); + sigma2 = U(0); + } +} + +template __device__ +void cuWelfordMuSigma2( + const T* __restrict__ vals, + const int n1, + const int n2, + const int i1, + U& mu, + U& sigma2, + U* buf) +{ + // Assumptions: + // 1) blockDim.x == warpSize + // 2) Tensor is contiguous + // 3) 2*blockDim.y*sizeof(U)+blockDim.y*sizeof(int) shared memory available. + // + // compute variance and mean over n2 + U count = U(0); + mu= U(0); + sigma2 = U(0); + if (i1 < n1) { + // one warp normalizes one n1 index, + // synchronization is implicit + // initialize with standard Welford algorithm + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + const T* lvals = vals + i1*n2; + int l = 4*thrx; + for (; l+3 < n2; l+=4*numx) { + for (int k = 0; k < 4; ++k) { + U curr = static_cast(lvals[l+k]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + } + for (; l < n2; ++l) { + U curr = static_cast(lvals[l]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + // intra-warp reductions + for (int l = 0; l <= 4; ++l) { + int srcLaneB = (threadIdx.x+(1<(muB,sigma2B,countB,mu,sigma2,count); + } + // threadIdx.x == 0 has correct values for each warp + // inter-warp reductions + if (blockDim.y > 1) { + U* ubuf = (U*)buf; + U* ibuf = (U*)(ubuf + blockDim.y); + for (int offset = blockDim.y/2; offset > 0; offset /= 2) { + // upper half of warps write to shared + if (threadIdx.x == 0 && threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int wrt_y = threadIdx.y - offset; + ubuf[2*wrt_y] = mu; + ubuf[2*wrt_y+1] = sigma2; + ibuf[wrt_y] = count; + } + __syncthreads(); + // lower half merges + if (threadIdx.x == 0 && threadIdx.y < offset) { + U muB = ubuf[2*threadIdx.y]; + U sigma2B = ubuf[2*threadIdx.y+1]; + U countB = ibuf[threadIdx.y]; + cuChanOnlineSum(muB,sigma2B,countB,mu,sigma2,count); + } + __syncthreads(); + } + // threadIdx.x = 0 && threadIdx.y == 0 only thread that has correct values + if (threadIdx.x == 0 && threadIdx.y == 0) { + ubuf[0] = mu; + ubuf[1] = sigma2; + } + __syncthreads(); + mu = ubuf[0]; + sigma2 = ubuf[1]/U(n2); + // don't care about final value of count, we know count == n2 + } else { + mu = WARP_SHFL(mu, 0); + sigma2 = WARP_SHFL(sigma2/U(n2), 0); + } + } +} + +template<> __device__ +void cuWelfordMuSigma2( + const at::Half* __restrict__ vals, + const int n1, + const int n2, + const int i1, + float& mu, + float& sigma2, + float* buf) +{ + // Assumptions: + // 1) blockDim.x == warpSize + // 2) Tensor is contiguous + // 3) 2*blockDim.y*sizeof(U)+blockDim.y*sizeof(int) shared memory available. + // + // compute variance and mean over n2 + float count = 0.0f; + mu= float(0); + sigma2 = float(0); + + if (i1 < n1) { + // one warp normalizes one n1 index, + // synchronization is implicit + // initialize with standard Welford algorithm + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + const at::Half* lvals = vals + i1*n2; + int l = 8*thrx; + if ((((size_t)lvals)&3) != 0) { + // 16 bit alignment + // first thread consumes first point + if (thrx == 0) { + float curr = static_cast(lvals[0]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + ++l; + } + // at this point, lvals[l] are 32 bit aligned for all threads. + for (; l+7 < n2; l+=8*numx) { + for (int k = 0; k < 8; k+=2) { + float2 curr = __half22float2(*((__half2*)(lvals+l+k))); + cuWelfordOnlineSum(curr.x,mu,sigma2,count); + cuWelfordOnlineSum(curr.y,mu,sigma2,count); + } + } + for (; l < n2; ++l) { + float curr = static_cast(lvals[l]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + // intra-warp reductions + for (int l = 0; l <= 4; ++l) { + int srcLaneB = (threadIdx.x+(1< 1) { + float* ubuf = (float*)buf; + float* ibuf = (float*)(ubuf + blockDim.y); + for (int offset = blockDim.y/2; offset > 0; offset /= 2) { + // upper half of warps write to shared + if (threadIdx.x == 0 && threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int wrt_y = threadIdx.y - offset; + ubuf[2*wrt_y] = mu; + ubuf[2*wrt_y+1] = sigma2; + ibuf[wrt_y] = count; + } + __syncthreads(); + // lower half merges + if (threadIdx.x == 0 && threadIdx.y < offset) { + float muB = ubuf[2*threadIdx.y]; + float sigma2B = ubuf[2*threadIdx.y+1]; + float countB = ibuf[threadIdx.y]; + cuChanOnlineSum(muB,sigma2B,countB,mu,sigma2,count); + } + __syncthreads(); + } + // threadIdx.x = 0 && threadIdx.y == 0 only thread that has correct values + if (threadIdx.x == 0 && threadIdx.y == 0) { + ubuf[0] = mu; + ubuf[1] = sigma2; + } + __syncthreads(); + mu = ubuf[0]; + sigma2 = ubuf[1]/float(n2); + // don't care about final value of count, we know count == n2 + } else { + mu = WARP_SHFL(mu, 0); + sigma2 = WARP_SHFL(sigma2/float(n2), 0); + } + } +} + +template U rsqrt(U v) { + return U(1) / sqrt(v); +} +template<> float rsqrt(float v) { + return rsqrtf(v); +} +template<> double rsqrt(double v) { + return rsqrt(v); +} + +namespace { +// This is the un-specialized struct. Note that we prevent instantiation of this +// struct by putting an undefined symbol in the function body so it won't compile. +// template +// struct SharedMemory +// { +// // Ensure that we won't compile any un-specialized types +// __device__ T *getPointer() +// { +// extern __device__ void error(void); +// error(); +// return NULL; +// } +// }; +// https://github.com/NVIDIA/apex/issues/246 +template +struct SharedMemory; + +template <> +struct SharedMemory +{ + __device__ float *getPointer() + { + extern __shared__ float s_float[]; + return s_float; + } +}; + +template <> +struct SharedMemory +{ + __device__ double *getPointer() + { + extern __shared__ double s_double[]; + return s_double; + } +}; +} + +template __global__ +void cuApplyLayerNorm( + T* __restrict__ output_vals, + U* __restrict__ mean, + U* __restrict__ invvar, + const T* __restrict__ vals, + const int n1, + const int n2, + const U epsilon, + const T* __restrict__ gamma, + const T* __restrict__ beta + ) +{ + // Assumptions: + // 1) blockDim.x == warpSize + // 2) Tensors are contiguous + // + for (auto i1=blockIdx.y; i1 < n1; i1 += gridDim.y) { + SharedMemory shared; + U* buf = shared.getPointer(); + U mu,sigma2; + cuWelfordMuSigma2(vals,n1,n2,i1,mu,sigma2,buf); + const T* lvals = vals + i1*n2; + T* ovals = output_vals + i1*n2; + U c_invvar = rsqrt(sigma2 + epsilon); + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + if (gamma != NULL && beta != NULL) { + for (int i = thrx; i < n2; i+=numx) { + U curr = static_cast(lvals[i]); + ovals[i] = gamma[i] * static_cast(c_invvar * (curr - mu)) + beta[i]; + } + } else { + for (int i = thrx; i < n2; i+=numx) { + U curr = static_cast(lvals[i]); + ovals[i] = static_cast(c_invvar * (curr - mu)); + } + } + if (threadIdx.x == 0 && threadIdx.y == 0) { + mean[i1] = mu; + invvar[i1] = c_invvar; + } + } +} + +template __device__ +void cuLoadWriteStridedInputs( + const int i1_block, + const int thr_load_row_off, + const int thr_load_col_off, + const int i2_off, + const int row_stride, + U* warp_buf1, + U* warp_buf2, + const T* input, + const T* dout, + const int i1_end, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar + ) +{ + int i1 = i1_block+thr_load_row_off; + if (i1 < i1_end) { + U curr_mean = mean[i1]; + U curr_invvar = invvar[i1]; + for (int k = 0; k < blockDim.y; ++k) { + int i2 = i2_off + k; + int load_idx = i1*n2+i2; + int write_idx = thr_load_row_off*row_stride+thr_load_col_off+k; + if (i2(input[load_idx]); + U curr_dout = static_cast(dout[load_idx]); + warp_buf1[write_idx] = curr_dout; + warp_buf2[write_idx] = curr_dout * (curr_input - curr_mean) * curr_invvar; + } else { + warp_buf1[write_idx] = U(0); + warp_buf2[write_idx] = U(0); + } + } + } else { + for (int k = 0; k < blockDim.y; ++k) { + int write_idx = thr_load_row_off*row_stride+thr_load_col_off+k; + warp_buf1[write_idx] = U(0); + warp_buf2[write_idx] = U(0); + } + } +} + +template __device__ +void cuLoadAddStridedInputs( + const int i1_block, + const int thr_load_row_off, + const int thr_load_col_off, + const int i2_off, + const int row_stride, + U* warp_buf1, + U* warp_buf2, + const T* input, + const T* dout, + const int i1_end, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar + ) +{ + int i1 = i1_block+thr_load_row_off; + if (i1 < i1_end) { + U curr_mean = mean[i1]; + U curr_invvar = invvar[i1]; + for (int k = 0; k < blockDim.y; ++k) { + int i2 = i2_off + k; + int load_idx = i1*n2+i2; + int write_idx = thr_load_row_off*row_stride+thr_load_col_off+k; + if (i2(input[load_idx]); + U curr_dout = static_cast(dout[load_idx]); + warp_buf1[write_idx] += curr_dout; + warp_buf2[write_idx] += curr_dout * (curr_input - curr_mean) * curr_invvar; + } + } + } +} + +template __global__ +void cuComputePartGradGammaBeta( + const T* __restrict__ dout, + const T* __restrict__ input, + const int n1, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar, + U epsilon, + U* part_grad_gamma, + U* part_grad_beta) +{ + const int numsegs_n1 = (n1+blockDim.y*blockDim.y-1) / (blockDim.y*blockDim.y); + const int segs_per_block = (numsegs_n1 + gridDim.y - 1) / gridDim.y; + const int i1_beg = blockIdx.y * segs_per_block * blockDim.y*blockDim.y; + const int i1_beg_plus_one = (blockIdx.y+1) * segs_per_block * blockDim.y*blockDim.y; + const int i1_end = i1_beg_plus_one < n1 ? i1_beg_plus_one : n1; + const int row_stride = blockDim.x+1; + const int thr_load_col_off = (threadIdx.x*blockDim.y)&(blockDim.x-1); + const int thr_load_row_off = (threadIdx.x*blockDim.y)/blockDim.x + threadIdx.y*blockDim.y; + const int i2_off = blockIdx.x * blockDim.x + thr_load_col_off; + SharedMemory shared; + U* buf = shared.getPointer(); // buf has at least blockDim.x * blockDim.y * blockDim.y + (blockDim.y - 1)*(blockDim.x/blockDim.y) elements + U* warp_buf1 = (U*)buf; + U* warp_buf2 = warp_buf1 + blockDim.y * blockDim.y * row_stride; + // compute partial sums from strided inputs + // do this to increase number of loads in flight + cuLoadWriteStridedInputs(i1_beg,thr_load_row_off,thr_load_col_off,i2_off,row_stride,warp_buf1,warp_buf2,input,dout,i1_end,n2,mean,invvar); + for (int i1_block = i1_beg+blockDim.y*blockDim.y; i1_block < i1_end; i1_block+=blockDim.y*blockDim.y) { + cuLoadAddStridedInputs(i1_block,thr_load_row_off,thr_load_col_off,i2_off,row_stride,warp_buf1,warp_buf2,input,dout,i1_end,n2,mean,invvar); + } + __syncthreads(); + // inter-warp reductions + // sum within each warp + U acc1 = U(0); + U acc2 = U(0); + for (int k = 0; k < blockDim.y; ++k) { + int row1 = threadIdx.y + k*blockDim.y; + int idx1 = row1*row_stride + threadIdx.x; + acc1 += warp_buf1[idx1]; + acc2 += warp_buf2[idx1]; + } + warp_buf1[threadIdx.y*row_stride+threadIdx.x] = acc1; + warp_buf2[threadIdx.y*row_stride+threadIdx.x] = acc2; + __syncthreads(); + // sum all warps + for (int offset = blockDim.y/2; offset > 1; offset /= 2) { + if (threadIdx.y < offset) { + int row1 = threadIdx.y; + int row2 = threadIdx.y + offset; + int idx1 = row1*row_stride + threadIdx.x; + int idx2 = row2*row_stride + threadIdx.x; + warp_buf1[idx1] += warp_buf1[idx2]; + warp_buf2[idx1] += warp_buf2[idx2]; + } + __syncthreads(); + } + int i2 = blockIdx.x * blockDim.x + threadIdx.x; + if (threadIdx.y == 0 && i2 < n2) { + int row1 = threadIdx.y; + int row2 = threadIdx.y + 1; + int idx1 = row1*row_stride + threadIdx.x; + int idx2 = row2*row_stride + threadIdx.x; + part_grad_beta[blockIdx.y*n2+i2] = warp_buf1[idx1] + warp_buf1[idx2]; + part_grad_gamma[blockIdx.y*n2+i2] = warp_buf2[idx1] + warp_buf2[idx2]; + } +} + +template __global__ +void cuComputeGradGammaBeta( + const U* part_grad_gamma, + const U* part_grad_beta, + const int part_size, + const int n1, + const int n2, + T* grad_gamma, + T* grad_beta) +{ + // sum partial gradients for gamma and beta + SharedMemory shared; + U* buf = shared.getPointer(); + int i2 = blockIdx.x * blockDim.x + threadIdx.x; + if (i2 < n2) { + // each warp does sequential reductions until reduced part_size is num_warps + int num_warp_reductions = part_size / blockDim.y; + U sum_gamma = U(0); + U sum_beta = U(0); + const U* part_grad_gamma_ptr = part_grad_gamma + threadIdx.y * num_warp_reductions * n2 + i2; + const U* part_grad_beta_ptr = part_grad_beta + threadIdx.y * num_warp_reductions * n2 + i2; + for (int warp_offset = 0; warp_offset < num_warp_reductions; ++warp_offset) { + sum_gamma += part_grad_gamma_ptr[warp_offset*n2]; + sum_beta += part_grad_beta_ptr[warp_offset*n2]; + } + // inter-warp reductions + const int nbsize3 = blockDim.x * blockDim.y / 2; + for (int offset = blockDim.y/2; offset >= 1; offset /= 2) { + // top half write to shared memory + if (threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int write_idx = (threadIdx.y - offset) * blockDim.x + threadIdx.x; + buf[write_idx] = sum_gamma; + buf[write_idx+nbsize3] = sum_beta; + } + __syncthreads(); + // bottom half sums + if (threadIdx.y < offset) { + const int read_idx = threadIdx.y * blockDim.x + threadIdx.x; + sum_gamma += buf[read_idx]; + sum_beta += buf[read_idx+nbsize3]; + } + __syncthreads(); + } + // write out fully summed gradients + if (threadIdx.y == 0) { + grad_gamma[i2] = sum_gamma; + grad_beta[i2] = sum_beta; + } + } +} + +template __global__ +void cuComputeGradInput( + const T* __restrict__ dout, + const T* __restrict__ dout_resid, + const T* __restrict__ input, + const int n1, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar, + U epsilon, + const T* gamma, + T* grad_input) +{ + for (auto i1=blockIdx.y; i1 < n1; i1 += gridDim.y) { + U sum_loss1 = U(0); + U sum_loss2 = U(0); + const U c_mean = mean[i1]; + const U c_invvar = invvar[i1]; + const T* k_input = input + i1*n2; + const T* k_dout = dout + i1*n2; + const T* k_dout_resid = dout_resid + i1*n2; + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + if (gamma != NULL) { + int l = 4*thrx; + for (; l+3 < n2; l+=4*numx) { + for (int k = 0; k < 4; ++k) { + const U c_h = static_cast(k_input[l+k]); + const U c_loss = static_cast(k_dout[l+k]); + sum_loss1 += c_loss * static_cast(gamma[l+k]); + sum_loss2 += c_loss * static_cast(gamma[l+k]) * (c_h - c_mean) * c_invvar; + } + } + for (; l < n2; ++l) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + sum_loss1 += c_loss * static_cast(gamma[l]); + sum_loss2 += c_loss * static_cast(gamma[l]) * (c_h - c_mean) * c_invvar; + } + } else { + int l = 4*thrx; + for (; l+3 < n2; l+=4*numx) { + for (int k = 0; k < 4; ++k) { + const U c_h = static_cast(k_input[l+k]); + const U c_loss = static_cast(k_dout[l+k]); + sum_loss1 += c_loss; + sum_loss2 += c_loss * (c_h - c_mean) * c_invvar; + } + } + for (; l < n2; ++l) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + sum_loss1 += c_loss; + sum_loss2 += c_loss * (c_h - c_mean) * c_invvar; + } + } + // intra-warp reductions + for (int mask = blockDim.x/2; mask > 0; mask /= 2) { + sum_loss1 += WARP_SHFL_XOR(sum_loss1, mask); + sum_loss2 += WARP_SHFL_XOR(sum_loss2, mask); + } + // inter-warp reductions + if (blockDim.y > 1) { + SharedMemory shared; + U* buf = shared.getPointer(); + for (int offset = blockDim.y/2; offset > 0; offset /= 2) { + // upper half of warps write to shared + if (threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int wrt_i = (threadIdx.y - offset) * blockDim.x + threadIdx.x; + buf[2*wrt_i] = sum_loss1; + buf[2*wrt_i+1] = sum_loss2; + } + __syncthreads(); + // lower half merges + if (threadIdx.y < offset) { + const int read_i = threadIdx.y * blockDim.x + threadIdx.x; + sum_loss1 += buf[2*read_i]; + sum_loss2 += buf[2*read_i+1]; + } + __syncthreads(); + } + if (threadIdx.y == 0) { + buf[2*threadIdx.x] = sum_loss1; + buf[2*threadIdx.x+1] = sum_loss2; + } + __syncthreads(); + if (threadIdx.y !=0) { + sum_loss1 = buf[2*threadIdx.x]; + sum_loss2 = buf[2*threadIdx.x+1]; + } + } + // all threads now have the two sums over l + U fH = (U)n2; + U term1 = (U(1) / fH) * c_invvar; + T* k_grad_input = grad_input + i1*n2; + if (gamma != NULL) { + for (int l = thrx; l < n2; l+=numx) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + const T c_resid= static_cast(k_dout_resid[l]); + U f_grad_input = fH * c_loss * static_cast(gamma[l]); + f_grad_input -= sum_loss1; + f_grad_input -= (c_h - c_mean) * c_invvar * sum_loss2; + f_grad_input *= term1; + k_grad_input[l] = static_cast(f_grad_input)+c_resid; + } + } else { + for (int l = thrx; l < n2; l+=numx) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + const T c_resid= static_cast(k_dout_resid[l]); + U f_grad_input = fH * c_loss; + f_grad_input -= sum_loss1; + f_grad_input -= (c_h - c_mean) * c_invvar * sum_loss2; + f_grad_input *= term1; + k_grad_input[l] = static_cast(f_grad_input)+c_resid; + } + } + } +} + +template +void HostApplyLayerNorm( + T* output, + U* mean, + U* invvar, + const T* input, + int n1, + int n2, + double epsilon, + const T* gamma, + const T* beta + ) +{ + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const dim3 threads(32,4,1); + const uint64_t maxGridY = at::cuda::getCurrentDeviceProperties()->maxGridSize[1]; + const dim3 blocks(1, std::min((uint64_t)n1, maxGridY), 1); + int nshared = + threads.y > 1 ? + threads.y*sizeof(U)+(threads.y/2)*sizeof(U) : + 0; + cuApplyLayerNorm<<>>( + output, + mean, + invvar, + input, + n1,n2, + U(epsilon), + gamma,beta); +} + +template +void HostLayerNormGradient( + const T* dout, + const T* dout_resid, + const U* mean, + const U* invvar, + const at::Tensor& input, + int n1, + int n2, + const T* gamma, + const T* beta, + double epsilon, + T* grad_input, + T* grad_gamma, + T* grad_beta + ) +{ + auto stream = at::cuda::getCurrentCUDAStream().stream(); + + if (gamma != NULL && beta != NULL) { + // compute grad_gamma(j) and grad_beta(j) + const int part_size = 16; + const dim3 threads2(32,4,1); + const dim3 blocks2((n2+threads2.x-1)/threads2.x,part_size,1); + const int nshared2_a = 2 * sizeof(U) * threads2.y * threads2.y * (threads2.x + 1); + const int nshared2_b = threads2.x * threads2.y * sizeof(U); + const int nshared2 = nshared2_a > nshared2_b ? nshared2_a : nshared2_b; + at::Tensor part_grad_gamma = at::empty({part_size,n2}, input.options().dtype(input.scalar_type()==at::ScalarType::Half ? at::ScalarType::Float : input.scalar_type())); + at::Tensor part_grad_beta = at::empty_like(part_grad_gamma); + cuComputePartGradGammaBeta<<>>( + dout, + static_cast(input.data_ptr()), + n1,n2, + mean, + invvar, + U(epsilon), + static_cast(part_grad_gamma.data_ptr()), + static_cast(part_grad_beta.data_ptr())); + + const dim3 threads3(32,8,1); + const dim3 blocks3((n2+threads2.x-1)/threads2.x,1,1); + const int nshared3 = threads3.x * threads3.y * sizeof(U); + cuComputeGradGammaBeta<<>>( + static_cast(part_grad_gamma.data_ptr()), + static_cast(part_grad_beta.data_ptr()), + part_size, + n1,n2, + grad_gamma, + grad_beta); + } + + // compute grad_input + const uint64_t maxGridY = at::cuda::getCurrentDeviceProperties()->maxGridSize[1]; + const dim3 blocks1(1, std::min((uint64_t)n1, maxGridY), 1); + const dim3 threads1(32,4,1); + int nshared = + threads1.y > 1 ? + threads1.y*threads1.x*sizeof(U) : + 0; + cuComputeGradInput<<>>( + dout, + dout_resid, + static_cast(input.data_ptr()), + n1,n2, + mean, + invvar, + U(epsilon), + gamma, + grad_input); +} diff --git a/apex/apex/contrib/csrc/multihead_attn/masked_softmax_dropout.cpp b/apex/apex/contrib/csrc/multihead_attn/masked_softmax_dropout.cpp new file mode 100644 index 0000000000000000000000000000000000000000..4d93b8a497048acece8f3f09fc7e96a9133e0fc7 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/masked_softmax_dropout.cpp @@ -0,0 +1,93 @@ +#include +#include + +namespace multihead_attn { +namespace fused_softmax { +namespace mask_softmax_dropout { + +std::vector fwd_cuda( + bool is_training, + int heads, + torch::Tensor const& input, + const uint8_t* pad_mask, + float dropout_prob + ); + +torch::Tensor bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& softmax_results, + torch::Tensor const& dropout_mask, + const uint8_t *padding_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool is_training, + int heads, + torch::Tensor const& input, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(input.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + } + + return fwd_cuda( + is_training, + heads, + input, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +torch::Tensor bwd( + bool use_mask, + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& softmax_results, + torch::Tensor const& dropout_mask, + torch::Tensor const& padding_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); +// AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + softmax_results, + dropout_mask, + use_mask ? static_cast(padding_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +} // end namespace mask_softmax_dropout +} // end namespace fused_softmax +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::fused_softmax::mask_softmax_dropout::fwd, "Self Multihead Attention masked softmax dropout -- Forward."); + m.def("backward", &multihead_attn::fused_softmax::mask_softmax_dropout::bwd, "Self Multihead Attention masked softmax dropout -- Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/masked_softmax_dropout_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/masked_softmax_dropout_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..2d26cba3534afac8fb93cc6761780bf3530401cf --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/masked_softmax_dropout_cuda.cu @@ -0,0 +1,147 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "softmax.h" +#include "dropout.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace fused_softmax { +namespace mask_softmax_dropout { + +std::vector fwd_cuda( + bool is_training, + int heads, + torch::Tensor const& input, + const uint8_t* pad_mask, + float dropout_prob + ) +{ + const int attn_batches = input.size(0); + const int sequences = attn_batches / heads; + const int q_seq_len = input.size(1); + const int k_seq_len = q_seq_len; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = input.options().requires_grad(false); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* input_ptr = static_cast(input.data_ptr()); + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(input_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + softmax_success = dispatch_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(input_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + + + if (is_training) { + //use at:: function so that C++ version generates the same random mask as python version + auto dropout_tuple = at::_fused_dropout(softmax_results, 1.0f-dropout_prob); + dropout_results = std::get<0>(dropout_tuple); + dropout_mask = std::get<1>(dropout_tuple); + } + + // Matmul2 + + return { + dropout_results, + dropout_mask, + softmax_results + }; +} + +torch::Tensor bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& softmax_results, + torch::Tensor const& dropout_mask, + const uint8_t *padding_mask, + float dropout_prob + ) +{ + const int attn_batches = output_grads.size(0); + const int q_seq_len = output_grads.size(1); + const int k_seq_len = q_seq_len; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations +// torch::Tensor input_grads = torch::empty_like(output_grads); + + // Apply Dropout Mask and Scale by Dropout Probability + // Softmax Grad + if (padding_mask == nullptr) { + dispatch_masked_scale_softmax_backward_stream( + static_cast(output_grads.data_ptr()), + static_cast(output_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + 1.0/(1.0-dropout_prob), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, stream); + } else{ + dispatch_masked_scale_softmax_backward_masked_out_stream( + static_cast(output_grads.data_ptr()), + static_cast(output_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + static_cast(padding_mask), + 1.0/(1.0-dropout_prob), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + heads, stream); + + } +//backward pass is completely in-place + return output_grads; +} +} +} +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/philox.h b/apex/apex/contrib/csrc/multihead_attn/philox.h new file mode 100644 index 0000000000000000000000000000000000000000..6c30a45c939321566f167a0b6c9e4be571bde335 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/philox.h @@ -0,0 +1,90 @@ +#pragma once +//Philox CUDA. + +class Philox { +public: + __device__ inline Philox(unsigned long long seed, + unsigned long long subsequence, + unsigned long long offset) { + key.x = (unsigned int)seed; + key.y = (unsigned int)(seed >> 32); + counter = make_uint4(0, 0, 0, 0); + counter.z = (unsigned int)(subsequence); + counter.w = (unsigned int)(subsequence >> 32); + STATE = 0; + incr_n(offset / 4); + } + __device__ inline uint4 operator()() { + if(STATE == 0) { + uint4 counter_ = counter; + uint2 key_ = key; + //7-round philox + for(int i = 0; i < 6; i++) { + counter_ = single_round(counter_, key_); + key_.x += (kPhilox10A); key_.y += (kPhilox10B); + } + output = single_round(counter_, key_); + incr(); + } + //return a float4 directly + //unsigned long ret; + //switch(STATE) { + // case 0: ret = output.x; break; + // case 1: ret = output.y; break; + // case 2: ret = output.z; break; + // case 3: ret = output.w; break; + //} + //STATE = (STATE + 1) % 4; + return output; + } +private: + uint4 counter; + uint4 output; + uint2 key; + unsigned int STATE; + __device__ inline void incr_n(unsigned long long n) { + unsigned int nlo = (unsigned int)(n); + unsigned int nhi = (unsigned int)(n >> 32); + counter.x += nlo; + if (counter.x < nlo) + nhi++; + counter.y += nhi; + if (nhi <= counter.y) + return; + if (++counter.z) + return; + ++counter.w; + } + __device__ inline void incr() { + if (++counter.x) + return; + if (++counter.y) + return; + if (++counter.z) + return; + ++counter.w; + } + __device__ unsigned int mulhilo32(unsigned int a, unsigned int b, + unsigned int *result_high) { + *result_high = __umulhi(a, b); + return a*b; + } + __device__ inline uint4 single_round(uint4 ctr, uint2 key) { + unsigned int hi0; + unsigned int hi1; + unsigned int lo0 = mulhilo32(kPhiloxSA, ctr.x, &hi0); + unsigned int lo1 = mulhilo32(kPhiloxSB, ctr.z, &hi1); + uint4 ret = {hi1 ^ ctr.y ^ key.x, lo1, hi0 ^ ctr.w ^ key.y, lo0}; + return ret; + } + static const unsigned long kPhilox10A = 0x9E3779B9; + static const unsigned long kPhilox10B = 0xBB67AE85; + static const unsigned long kPhiloxSA = 0xD2511F53; + static const unsigned long kPhiloxSB = 0xCD9E8D57; +}; +// Inverse of 2^32. +#define M_RAN_INVM32 2.3283064e-10f +__device__ __inline__ float4 uniform4(uint4 x) { + return make_float4(x.x * M_RAN_INVM32, x.y * M_RAN_INVM32, x.z * M_RAN_INVM32,x.w * M_RAN_INVM32); + +} diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn.cpp b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn.cpp new file mode 100644 index 0000000000000000000000000000000000000000..ba096516db526ba14c3b7176946beb30135616e5 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn.cpp @@ -0,0 +1,132 @@ +#include +#include + +namespace multihead_attn { +namespace self { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ); + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + } + + return fwd_cuda( + use_time_mask, + is_training, + heads, + inputs, + input_weights, + output_weights, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +std::vector bwd( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(matmul2_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(matmul2_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + matmul2_results, + dropout_results, + softmax_results, + input_lin_results, + inputs, + input_weights, + output_weights, + dropout_mask, + dropout_prob + ); +} + +} // end namespace cublas_gemmex +} // end namespace self +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::self::cublas_gemmex::fwd, "Self Multihead Attention Forward."); + m.def("backward", &multihead_attn::self::cublas_gemmex::bwd, "Self Multihead Attention Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias.cpp b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias.cpp new file mode 100644 index 0000000000000000000000000000000000000000..9ed393a40df49db3baa3bc0e3d99e4e6527d0668 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias.cpp @@ -0,0 +1,139 @@ +#include +#include + +namespace multihead_attn { +namespace self_bias { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& input_biases, + torch::Tensor const& output_biases, + const uint8_t* pad_mask, + float dropout_prob + ); + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + //torch::Tensor const& input_biases, + //torch::Tensor const& output_biases, + torch::Tensor const& dropout_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& input_biases, torch::Tensor const& output_biases, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + } + + return fwd_cuda( + use_time_mask, + is_training, + heads, + inputs, + input_weights, + output_weights, + input_biases, + output_biases, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +std::vector bwd( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(matmul2_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(matmul2_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + matmul2_results, + dropout_results, + softmax_results, + input_lin_results, + inputs, + input_weights, + output_weights, + dropout_mask, + dropout_prob + ); +} + +} // end namespace cublas_gemmex +} // end namespace self +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::self_bias::cublas_gemmex::fwd, "Self Multihead Attention with Bias -- Forward."); + m.def("backward", &multihead_attn::self_bias::cublas_gemmex::bwd, "Self Multihead Attention with Bias -- Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask.cpp b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask.cpp new file mode 100644 index 0000000000000000000000000000000000000000..2bca0ade0d22ccb3d581b5008294e8120445dc62 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask.cpp @@ -0,0 +1,143 @@ +#include +#include +#include + +namespace multihead_attn { +namespace self_bias_additive_mask { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& input_biases, + torch::Tensor const& output_biases, + const half* pad_mask, + float dropout_prob + ); + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + // torch::Tensor const& softmax_results, + torch::Tensor const& bmm1_results, + torch::Tensor const& pad_mask, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + //torch::Tensor const& input_biases, + //torch::Tensor const& output_biases, + torch::Tensor const& dropout_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& input_biases, torch::Tensor const& output_biases, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(use_mask , "no mask is not supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Half, "Only Half is supported"); + } + + return fwd_cuda( + use_time_mask, + is_training, + heads, + inputs, + input_weights, + output_weights, + input_biases, + output_biases, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + +std::vector bwd( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& bmm1_results, + torch::Tensor const& pad_mask, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(matmul2_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(matmul2_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda( + heads, + output_grads, + matmul2_results, + dropout_results, + bmm1_results, + pad_mask, + input_lin_results, + inputs, + input_weights, + output_weights, + dropout_mask, + dropout_prob + ); +} + +} // end namespace cublas_gemmex +} // end namespace self +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::self_bias_additive_mask::cublas_gemmex::fwd, "Self Multihead Attention with Bias -- Forward."); + m.def("backward", &multihead_attn::self_bias_additive_mask::cublas_gemmex::bwd, "Self Multihead Attention with Bias -- Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..58c806d868d6110571a7dc1aa96337ace4204502 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask_cuda.cu @@ -0,0 +1,463 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "strided_batched_gemm.h" +#include "softmax.h" +#include "dropout.h" +#include "layer_norm.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace self_bias_additive_mask { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& input_biases, + torch::Tensor const& output_biases, + const half* pad_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta_zero = 0.0; + const float beta_one = 1.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = inputs.options().requires_grad(false); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor input_lin_results = torch::empty({q_seq_len, sequences, output_lin_dim}, act_options); + torch::Tensor bmm1_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + torch::Tensor matmul2_results = torch::empty({q_seq_len, attn_batches, head_dim}, act_options); + torch::Tensor outputs = torch::empty_like(inputs, act_options); + + // Input Linear Results Pointers to Q, K, and V of interviewed activations + void* q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + void* k_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + head_dim); + void* v_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + 2*head_dim); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* bmm1_results_ptr = static_cast(bmm1_results.data_ptr()); + void* dropout_results_ptr = static_cast(dropout_results.data_ptr()); + + char a_layout_t{'t'}; + char a_layout_n{'n'}; + char b_layout_n{'n'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + // Input Linear Fwd + input_lin_results.copy_(input_biases); + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(inputs.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta_one), + q_lin_results_ptr, + CUDA_R_16F, + output_lin_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul1 of Dot-Product Attention Plus scaling by 1/Sqrt(head size) + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + scale, + static_cast(k_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(q_lin_results_ptr), + lead_dim, + batch_stride, + beta_zero, + static_cast(bmm1_results_ptr), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + // Padded Softmax + bool softmax_success = false; + if (is_training) { + softmax_success = dispatch_additive_masked_softmax_dropout( + reinterpret_cast(dropout_results_ptr), + (is_training) ? reinterpret_cast(dropout_mask.data_ptr()) : nullptr, + reinterpret_cast(bmm1_results_ptr), + pad_mask, + attn_batches*q_seq_len*q_seq_len, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences, + 1.0f-dropout_prob, + stream); + } else { + softmax_success = dispatch_additive_masked_softmax( + reinterpret_cast(dropout_results_ptr),//this is actually softmax results, but making it consistent for the next function + reinterpret_cast(bmm1_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + + // Matmul2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta_zero, + static_cast(matmul2_results.data_ptr()), + head_dim*attn_batches, + head_dim, + attn_batches); + + outputs.copy_(output_biases); + + // Output Linear + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta_one), + static_cast(outputs.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO1_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_lin_results, + bmm1_results, + dropout_results, + dropout_mask, + matmul2_results, + outputs + }; +} + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& bmm1_results, + torch::Tensor const& pad_mask, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations + torch::Tensor input_grads = torch::empty_like(inputs); + torch::Tensor input_weight_grads = torch::empty_like(input_weights); + torch::Tensor output_weight_grads = torch::empty_like(output_weights); + // Intermediate Tensor Allocations + at::Tensor output_lin_grads = torch::empty_like(matmul2_results); + at::Tensor matmul2_grads = torch::empty_like(dropout_results); + at::Tensor input_lin_output_grads = torch::empty_like(input_lin_results); + + auto q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + auto k_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + head_dim; + auto v_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + 2*head_dim; + + auto q_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()); + auto k_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + head_dim; + auto v_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + 2*head_dim; + + char a_layout_n{'n'}; + char a_layout_t{'t'}; + char b_layout_n{'n'}; + char b_layout_t{'t'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + + // Output Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + // Output Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + embed_dim, + batches, + static_cast(&alpha), + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + auto output_bias_grads = output_grads.view({-1, embed_dim}) .sum(0, false); + // MatMul2 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + beta, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Matmul2 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + alpha, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + v_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Apply Dropout Mask and Scale by Dropout Probability + // Softmax Grad + dispatch_masked_scale_softmax_backward_recompute( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + reinterpret_cast(bmm1_results.data_ptr()), + reinterpret_cast(pad_mask.data_ptr()), + static_cast(dropout_mask.data_ptr()), + 1.0/(1.0-dropout_prob), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len/sequences, + attn_batches*q_seq_len, + stream); + + // Matmul1 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + scale, + k_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + q_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Matmul1 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + scale, + q_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + k_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + // Input Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + output_lin_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(input_lin_output_grads.data_ptr()), + //static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_dim, + batches, + static_cast(&alpha), + static_cast(inputs.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + auto input_bias_grads = input_lin_output_grads.view({-1, output_lin_dim}).sum(0, false); + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_grads, + input_weight_grads, + output_weight_grads, + input_bias_grads, + output_bias_grads + }; +} + +} // end namespace cublas_gemmex +} // end namespace self +} // end namespace multihead_attn diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..fdb26fc15e0a23f53067482ddbab32c0d8a36786 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_cuda.cu @@ -0,0 +1,471 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "strided_batched_gemm.h" +#include "softmax.h" +#include "dropout.h" +#include "layer_norm.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace self_bias { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& input_biases, + torch::Tensor const& output_biases, + const uint8_t* pad_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta_zero = 0.0; + const float beta_one = 1.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = inputs.options().requires_grad(false); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor input_lin_results = torch::empty({q_seq_len, sequences, output_lin_dim}, act_options); + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + torch::Tensor matmul2_results = torch::empty({q_seq_len, attn_batches, head_dim}, act_options); + torch::Tensor outputs = torch::empty_like(inputs, act_options); + + // Input Linear Results Pointers to Q, K, and V of interviewed activations + void* q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + void* k_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + head_dim); + void* v_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + 2*head_dim); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + char a_layout_t{'t'}; + char a_layout_n{'n'}; + char b_layout_n{'n'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + // Input Linear Fwd + input_lin_results.copy_(input_biases); + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(inputs.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta_one), + q_lin_results_ptr, + CUDA_R_16F, + output_lin_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul1 of Dot-Product Attention Plus scaling by 1/Sqrt(head size) + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + scale, + static_cast(k_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(q_lin_results_ptr), + lead_dim, + batch_stride, + beta_zero, + static_cast(softmax_results_ptr), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + if (use_time_mask) { + softmax_success = dispatch_time_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + q_seq_len); + } else { + softmax_success = dispatch_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + } + + + if (is_training) { + //use at:: function so that C++ version generates the same random mask as python version + auto dropout_tuple = at::_fused_dropout(softmax_results, 1.0f-dropout_prob); + dropout_results = std::get<0>(dropout_tuple); + dropout_mask = std::get<1>(dropout_tuple); + } + + // Matmul2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + (is_training) ? static_cast(dropout_results.data_ptr()) : static_cast(softmax_results.data_ptr()) , + k_seq_len, + k_seq_len*q_seq_len, + beta_zero, + static_cast(matmul2_results.data_ptr()), + head_dim*attn_batches, + head_dim, + attn_batches); + + outputs.copy_(output_biases); + + // Output Linear + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta_one), + static_cast(outputs.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO1_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_lin_results, + softmax_results, + dropout_results, + dropout_mask, + matmul2_results, + outputs + }; +} + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations + torch::Tensor input_grads = torch::empty_like(inputs); + torch::Tensor input_weight_grads = torch::empty_like(input_weights); + torch::Tensor output_weight_grads = torch::empty_like(output_weights); + // Intermediate Tensor Allocations + at::Tensor output_lin_grads = torch::empty_like(matmul2_results); + at::Tensor matmul2_grads = torch::empty_like(dropout_results); + at::Tensor input_lin_output_grads = torch::empty_like(input_lin_results); + + auto q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + auto k_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + head_dim; + auto v_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + 2*head_dim; + + auto q_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()); + auto k_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + head_dim; + auto v_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + 2*head_dim; + + char a_layout_n{'n'}; + char a_layout_t{'t'}; + char b_layout_n{'n'}; + char b_layout_t{'t'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + + // Output Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + // Output Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + embed_dim, + batches, + static_cast(&alpha), + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + auto output_bias_grads = output_grads.view({-1, embed_dim}) .sum(0, false); + // MatMul2 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + beta, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Matmul2 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + alpha, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + v_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Apply Dropout Mask and Scale by Dropout Probability + // Softmax Grad + dispatch_masked_scale_softmax_backward_stream( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + 1.0/(1.0-dropout_prob), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, stream); + + // Matmul1 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + scale, + k_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + q_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Matmul1 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + scale, + q_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + k_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + // Input Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + output_lin_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(input_lin_output_grads.data_ptr()), + //static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_dim, + batches, + static_cast(&alpha), + static_cast(inputs.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + auto input_bias_grads = input_lin_output_grads.view({-1, output_lin_dim}).sum(0, false); + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_grads, + input_weight_grads, + output_weight_grads, + input_bias_grads, + output_bias_grads + }; +} + +} // end namespace cublas_gemmex +} // end namespace self +} // end namespace multihead_attn diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..55d44a4c4b6a0f061e4aafcb47442e65a3f1adbc --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_cuda.cu @@ -0,0 +1,469 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "strided_batched_gemm.h" +#include "softmax.h" +#include "dropout.h" +#include "layer_norm.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace self { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = inputs.options().requires_grad(false); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor input_lin_results = torch::empty({q_seq_len, sequences, output_lin_dim}, act_options); + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + torch::Tensor matmul2_results = torch::empty({q_seq_len, attn_batches, head_dim}, act_options); + torch::Tensor outputs = torch::empty_like(inputs, act_options); + + // Input Linear Results Pointers to Q, K, and V of interviewed activations + void* q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + void* k_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + head_dim); + void* v_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + 2*head_dim); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + char a_layout_t{'t'}; + char a_layout_n{'n'}; + char b_layout_n{'n'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + // Input Linear Fwd + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(inputs.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + q_lin_results_ptr, + CUDA_R_16F, + output_lin_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul1 of Dot-Product Attention Plus scaling by 1/Sqrt(head size) + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + scale, + static_cast(k_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(q_lin_results_ptr), + lead_dim, + batch_stride, + beta, + static_cast(softmax_results_ptr), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + if (use_time_mask) { + softmax_success = dispatch_time_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + q_seq_len); + } else { + softmax_success = dispatch_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + } + assert(softmax_success); + + if (is_training) { + apex_fused_dropout_cuda( + static_cast(softmax_results.data_ptr()), + static_cast(dropout_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0f - dropout_prob)); + } + + // Matmul2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + (is_training) ? static_cast(dropout_results.data_ptr()) : static_cast(softmax_results.data_ptr()) , + k_seq_len, + k_seq_len*q_seq_len, + beta, + static_cast(matmul2_results.data_ptr()), + head_dim*attn_batches, + head_dim, + attn_batches); + + // Output Linear + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(outputs.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_lin_results, + softmax_results, + dropout_results, + dropout_mask, + matmul2_results, + outputs + }; +} + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& inputs, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations + torch::Tensor input_grads = torch::empty_like(inputs); + torch::Tensor input_weight_grads = torch::empty_like(input_weights); + torch::Tensor output_weight_grads = torch::empty_like(output_weights); + // Intermediate Tensor Allocations + at::Tensor output_lin_grads = torch::empty_like(matmul2_results); + at::Tensor matmul2_grads = torch::empty_like(dropout_results); + at::Tensor input_lin_output_grads = torch::empty_like(input_lin_results); + + auto q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + auto k_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + head_dim; + auto v_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + 2*head_dim; + + auto q_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()); + auto k_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + head_dim; + auto v_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + 2*head_dim; + + char a_layout_n{'n'}; + char a_layout_t{'t'}; + char b_layout_n{'n'}; + char b_layout_t{'t'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + + // Output Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Output Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + embed_dim, + batches, + static_cast(&alpha), + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(output_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul2 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + beta, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Matmul2 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + alpha, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + v_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Apply Dropout Mask and Scale by Dropout Probability + apex_masked_scale_cuda( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0 / (1.0 - dropout_prob))); + + // Softmax Grad + bool softmax_success = false; + softmax_success = dispatch_softmax_backward( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + assert(softmax_success); + + // Matmul1 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + scale, + k_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + q_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Matmul1 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + scale, + q_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + k_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Input Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + output_lin_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_dim, + batches, + static_cast(&alpha), + static_cast(inputs.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_grads, + input_weight_grads, + output_weight_grads + }; +} + +} // end namespace cublas_gemmex +} // end namespace self +} // end namespace multihead_attn diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add.cpp b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add.cpp new file mode 100644 index 0000000000000000000000000000000000000000..a5442bc300f5d4a050ab1406df51cb73b43b453e --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add.cpp @@ -0,0 +1,173 @@ +#include +#include + +namespace multihead_attn { +namespace self_norm_add { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ); + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& lyr_nrm_results, + torch::Tensor const& lyr_nrm_mean, + torch::Tensor const& lyr_nrm_invvar, + torch::Tensor const& inputs, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + torch::Tensor const& dropout_add_mask, + float dropout_prob + ); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector fwd( + bool use_mask, + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& pad_mask, + float dropout_prob + ) +{ + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_gamma_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(lyr_nrm_beta_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_gamma_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_beta_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + + if (use_mask) { + AT_ASSERTM(pad_mask.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(pad_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + } + + return fwd_cuda( + use_time_mask, + is_training, + heads, + inputs, + lyr_nrm_gamma_weights, + lyr_nrm_beta_weights, + input_weights, + output_weights, + use_mask ? static_cast(pad_mask.data_ptr()) : nullptr, + dropout_prob + ); +} + + +std::vector bwd( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& lyr_nrm_results, + torch::Tensor const& lyr_nrm_mean, + torch::Tensor const& lyr_nrm_invvar, + torch::Tensor const& inputs, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + torch::Tensor const& dropout_add_mask, + float dropout_prob + ) +{ + AT_ASSERTM(output_grads.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(matmul2_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(softmax_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(input_lin_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_results.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_mean.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(lyr_nrm_invvar.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(inputs.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(lyr_nrm_gamma_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(lyr_nrm_beta_weights.dim() == 1, "expected 1D tensor"); + AT_ASSERTM(input_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(output_weights.dim() == 2, "expected 2D tensor"); + AT_ASSERTM(dropout_mask.dim() == 3, "expected 3D tensor"); + AT_ASSERTM(dropout_add_mask.dim() == 3, "expected 3D tensor"); + + AT_ASSERTM(output_grads.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(matmul2_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(softmax_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_lin_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_results.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_mean.type().scalarType() == at::ScalarType::Float, "Only FLOAT is supported"); + AT_ASSERTM(lyr_nrm_invvar.type().scalarType() == at::ScalarType::Float, "Only FLOAT is supported"); + AT_ASSERTM(inputs.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_gamma_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(lyr_nrm_beta_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(input_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(output_weights.type().scalarType() == at::ScalarType::Half, "Only HALF is supported"); + AT_ASSERTM(dropout_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + AT_ASSERTM(dropout_add_mask.type().scalarType() == at::ScalarType::Byte, "Only BYTE is supported"); + + return bwd_cuda(heads, + output_grads, + matmul2_results, + dropout_results, + softmax_results, + input_lin_results, + lyr_nrm_results, + lyr_nrm_mean, + lyr_nrm_invvar, + inputs, + lyr_nrm_gamma_weights, + lyr_nrm_beta_weights, + input_weights, + output_weights, + dropout_mask, + dropout_add_mask, + dropout_prob + ); +} + +} // end namespace cublas_gemmex +} // end namespace self_norm_add +} // end namespace multihead_attn + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &multihead_attn::self_norm_add::cublas_gemmex::fwd, "Self Multihead Attention Plus Layer Norm and Residual Add Forward."); + m.def("backward", &multihead_attn::self_norm_add::cublas_gemmex::bwd, "Self Multihead Attention Plus Layer Norm and Residual Add Backward."); +} + diff --git a/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add_cuda.cu b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..278c195a61c5deea6241ab6d5ea818fb74832608 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add_cuda.cu @@ -0,0 +1,556 @@ +#include +#include + +#include +#include +#include +#include +#include +#include "THC/THC.h" +#include +#include +#include + +#include "strided_batched_gemm.h" +#include "softmax.h" +#include "dropout.h" +#include "layer_norm.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +namespace multihead_attn { +namespace self_norm_add { +namespace cublas_gemmex { + +std::vector fwd_cuda( + bool use_time_mask, + bool is_training, + int heads, + torch::Tensor const& inputs, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + const uint8_t* pad_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int total_tokens = batches * embed_dim; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // There is no reason to use more than one stream as every kernel is + // sequentially dependent + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // 3 Intermediate Results + Output (Note: dropout intermediates are generated by ATen library code) + auto act_options = inputs.options().requires_grad(false); + auto lyr_nrm_options = act_options.dtype(torch::kFloat32); + auto mask_options = act_options.dtype(torch::kUInt8); + + torch::Tensor lyr_nrm_mean = torch::empty({batches}, lyr_nrm_options); + torch::Tensor lyr_nrm_invvar = torch::empty({batches}, lyr_nrm_options); + torch::Tensor lyr_nrm_results = torch::empty_like(inputs, act_options); + + torch::Tensor input_lin_results = torch::empty({q_seq_len, sequences, output_lin_dim}, act_options); + torch::Tensor softmax_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_results = torch::empty({attn_batches, q_seq_len, k_seq_len}, act_options); + torch::Tensor dropout_mask = torch::empty({attn_batches, q_seq_len, k_seq_len}, mask_options); + torch::Tensor matmul2_results = torch::empty({q_seq_len, attn_batches, head_dim}, act_options); + torch::Tensor output_lin_results= torch::empty_like(inputs, act_options); + torch::Tensor dropout_add_mask = torch::empty_like(inputs, mask_options); + torch::Tensor outputs = torch::empty_like(inputs, act_options); + + // Input Linear Results Pointers to Q, K, and V of interviewed activations + void* q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + void* k_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + head_dim); + void* v_lin_results_ptr = static_cast(static_cast(input_lin_results.data_ptr()) + 2*head_dim); + + // Softmax Intermediate Result Ptr (used by Matmul1 -> Softmax) + void* softmax_results_ptr = static_cast(softmax_results.data_ptr()); + + char a_layout_t{'t'}; + char a_layout_n{'n'}; + char b_layout_n{'n'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + // Layer Norm + HostApplyLayerNorm( + static_cast(lyr_nrm_results.data_ptr()), + static_cast(lyr_nrm_mean.data_ptr()), + static_cast(lyr_nrm_invvar.data_ptr()), + static_cast(inputs.data_ptr()), + static_cast(batches), // n1 + static_cast(embed_dim), // n2 + 1.0e-5, + static_cast(lyr_nrm_gamma_weights.data_ptr()), + static_cast(lyr_nrm_beta_weights.data_ptr())); + + // Input Linear Fwd + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + output_lin_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + //static_cast(inputs.data_ptr()), + static_cast(lyr_nrm_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + q_lin_results_ptr, + CUDA_R_16F, + output_lin_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul1 of Dot-Product Attention Plus scaling by 1/Sqrt(head size) + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + scale, + static_cast(k_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(q_lin_results_ptr), + lead_dim, + batch_stride, + beta, + static_cast(softmax_results_ptr), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Padded Softmax + bool softmax_success = false; + if (pad_mask == nullptr) { + softmax_success = dispatch_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + } else { + if (use_time_mask) { + softmax_success = dispatch_time_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + q_seq_len); + } else { + softmax_success = dispatch_masked_softmax( + reinterpret_cast(softmax_results_ptr), + reinterpret_cast(softmax_results_ptr), + pad_mask, + k_seq_len, + k_seq_len, + attn_batches*q_seq_len, + attn_batches*q_seq_len/sequences); + } + } + assert(softmax_success); + + if (is_training) { + apex_fused_dropout_cuda( + static_cast(softmax_results.data_ptr()), + static_cast(dropout_results.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0f - dropout_prob)); + } + + // Matmul2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + (is_training) ? static_cast(dropout_results.data_ptr()) : static_cast(softmax_results.data_ptr()) , + //static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + static_cast(matmul2_results.data_ptr()), + head_dim*attn_batches, + head_dim, + attn_batches); + + // Output Linear + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_results.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // End-of-block Dropout-Add + if (is_training) { + apex_dropout_add_cuda( + static_cast(output_lin_results.data_ptr()), + static_cast(inputs.data_ptr()), + static_cast(outputs.data_ptr()), + static_cast(dropout_add_mask.data_ptr()), + total_tokens, + (1.0f - dropout_prob)); + } else { + apex_add_cuda( + static_cast(output_lin_results.data_ptr()), + static_cast(inputs.data_ptr()), + static_cast(outputs.data_ptr()), + total_tokens); + } + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + lyr_nrm_results, + lyr_nrm_mean, + lyr_nrm_invvar, + input_lin_results, + softmax_results, + dropout_results, + dropout_mask, + matmul2_results, + dropout_add_mask, + outputs + }; +} + +std::vector bwd_cuda( + int heads, + torch::Tensor const& output_grads, + torch::Tensor const& matmul2_results, + torch::Tensor const& dropout_results, + torch::Tensor const& softmax_results, + torch::Tensor const& input_lin_results, + torch::Tensor const& lyr_nrm_results, + torch::Tensor const& lyr_nrm_mean, + torch::Tensor const& lyr_nrm_invvar, + torch::Tensor const& inputs, + torch::Tensor const& lyr_nrm_gamma_weights, + torch::Tensor const& lyr_nrm_beta_weights, + torch::Tensor const& input_weights, + torch::Tensor const& output_weights, + torch::Tensor const& dropout_mask, + torch::Tensor const& dropout_add_mask, + float dropout_prob + ) +{ + const int embed_dim = inputs.size(2); + const int sequences = inputs.size(1); + const int q_seq_len = inputs.size(0); + const int k_seq_len = q_seq_len; + const int batches = sequences * q_seq_len; + const int total_tokens = batches * embed_dim; + const int head_dim = embed_dim / heads; + const int output_lin_dim = 3 * embed_dim; + const int attn_batches = heads * sequences; + const int lead_dim = attn_batches * 3 * head_dim; + const int batch_stride = 3 * head_dim; + const int dropout_elems = attn_batches * q_seq_len * k_seq_len; + const float alpha = 1.0; + const float beta = 0.0; + const float scale = 1.0 / sqrt(static_cast(head_dim)); + + // TODO: Streams can be used in Backprop but I haven't added more than one + // in my first attempt to create the code + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + + // Output Tensor Allocations + torch::Tensor input_grads = torch::empty_like(inputs); + torch::Tensor lyr_nrm_gamma_grads = torch::empty_like(lyr_nrm_gamma_weights); + torch::Tensor lyr_nrm_beta_grads = torch::empty_like(lyr_nrm_beta_weights); + torch::Tensor input_weight_grads = torch::empty_like(input_weights); + torch::Tensor output_weight_grads = torch::empty_like(output_weights); + // Intermediate Tensor Allocations + torch::Tensor dropout_add_grads = torch::empty_like(output_grads); + torch::Tensor output_lin_grads = torch::empty_like(matmul2_results); + torch::Tensor matmul2_grads = torch::empty_like(dropout_results); + torch::Tensor input_lin_output_grads = torch::empty_like(input_lin_results); + torch::Tensor input_lin_grads = torch::empty_like(inputs); + + auto q_lin_results_ptr = static_cast(input_lin_results.data_ptr()); + auto k_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + head_dim; + auto v_lin_results_ptr = static_cast(input_lin_results.data_ptr()) + 2*head_dim; + + auto q_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()); + auto k_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + head_dim; + auto v_lin_grads_ptr = static_cast(input_lin_output_grads.data_ptr()) + 2*head_dim; + + char a_layout_n{'n'}; + char a_layout_t{'t'}; + char b_layout_n{'n'}; + char b_layout_t{'t'}; + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + + // Dropout Add Backward + apex_masked_scale_cuda( + static_cast(output_grads.data_ptr()), + static_cast(dropout_add_grads.data_ptr()), + static_cast(dropout_add_mask.data_ptr()), + total_tokens, + (1.0 / (1.0 - dropout_prob))); + + // Output Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + embed_dim, + static_cast(&alpha), + static_cast(output_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(dropout_add_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Output Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + embed_dim, + batches, + static_cast(&alpha), + static_cast(matmul2_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(dropout_add_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(&beta), + static_cast(output_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // MatMul2 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_t, + b_layout_n, + k_seq_len, + q_seq_len, + head_dim, + alpha, + static_cast(v_lin_results_ptr), + lead_dim, + batch_stride, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + beta, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + attn_batches); + + // Matmul2 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + alpha, + static_cast(output_lin_grads.data_ptr()), + head_dim*attn_batches, + head_dim, + static_cast(dropout_results.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + v_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Apply Dropout Mask and Scale by Dropout Probability + apex_masked_scale_cuda( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + static_cast(dropout_mask.data_ptr()), + dropout_elems, + (1.0 / (1.0 - dropout_prob))); + + // Softmax Grad + bool softmax_success = false; + softmax_success = dispatch_softmax_backward( + static_cast(matmul2_grads.data_ptr()), + static_cast(matmul2_grads.data_ptr()), + reinterpret_cast(softmax_results.data_ptr()), + k_seq_len, + k_seq_len, + attn_batches*q_seq_len); + assert(softmax_success); + + // Matmul1 Dgrad1 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_n, + head_dim, + q_seq_len, + k_seq_len, + scale, + k_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + q_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Matmul1 Dgrad2 + gemm_switch_fp32accum( state, + a_layout_n, + b_layout_t, + head_dim, + k_seq_len, + q_seq_len, + scale, + q_lin_results_ptr, + lead_dim, + batch_stride, + static_cast(matmul2_grads.data_ptr()), + k_seq_len, + k_seq_len*q_seq_len, + beta, + k_lin_grads_ptr, + lead_dim, + batch_stride, + attn_batches); + + // Input Linear Dgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + embed_dim, + batches, + output_lin_dim, + static_cast(&alpha), + static_cast(input_weights.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + //static_cast(input_grads.data_ptr()), + static_cast(input_lin_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + //CUBLAS_GEMM_ALGO10_TENSOR_OP)); + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Input Linear Wgrad + THCublasCheck(cublasGemmEx(handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + embed_dim, + output_lin_dim, + batches, + static_cast(&alpha), + //static_cast(inputs.data_ptr()), + static_cast(lyr_nrm_results.data_ptr()), + CUDA_R_16F, + embed_dim, + static_cast(q_lin_grads_ptr), + CUDA_R_16F, + output_lin_dim, + static_cast(&beta), + static_cast(input_weight_grads.data_ptr()), + CUDA_R_16F, + embed_dim, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP)); + + // Fused Layer Norm Bwd with Residual Add + HostLayerNormGradient( + static_cast(input_lin_grads.data_ptr()), + static_cast(output_grads.data_ptr()), + static_cast(lyr_nrm_mean.data_ptr()), + static_cast(lyr_nrm_invvar.data_ptr()), + inputs, + static_cast(batches), // n1 + static_cast(embed_dim), // n2 + static_cast(lyr_nrm_gamma_weights.data_ptr()), + static_cast(lyr_nrm_beta_weights.data_ptr()), + 1.0e-5, + static_cast(input_grads.data_ptr()), + static_cast(lyr_nrm_gamma_grads.data_ptr()), + static_cast(lyr_nrm_beta_grads.data_ptr()) + ); + + THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); + + return { + input_grads, + lyr_nrm_gamma_grads, + lyr_nrm_beta_grads, + input_weight_grads, + output_weight_grads + }; +} + +} // end namespace cublas_gemmex +} // end namespace self_norm_add +} // end namespace multihead_attn diff --git a/apex/apex/contrib/csrc/multihead_attn/softmax.h b/apex/apex/contrib/csrc/multihead_attn/softmax.h new file mode 100644 index 0000000000000000000000000000000000000000..e669fd4e6a402610097569a307625a4b6b22b155 --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/softmax.h @@ -0,0 +1,2641 @@ +#pragma once +#include +#include +#include +#include "philox.h" + +#include +#include +#include +#include +#include +#include + +namespace { + template + __device__ __inline__ void copy_vector(Datatype *dst, const Datatype *src); + + template <> + __device__ __inline__ void copy_vector<__half, 1>(__half *dst, const __half *src) { *dst = *src; } + + template <> + __device__ __inline__ void copy_vector(float *dst, const float *src) { *dst = *src; } + + template <> + __device__ __inline__ void copy_vector<__half, 4>(__half *dst, const __half *src) { *((float2*) dst) = *((float2*) src); } + template <> + __device__ __inline__ void copy_vector(uint8_t *dst, const uint8_t *src) { *dst = *src; } + + template <> + __device__ __inline__ void copy_vector(uint8_t *dst, const uint8_t *src) {*((half2*) dst) = *((half2*) src); } + + template + __device__ __inline__ void apply_mask(Datatype *dst, Datatype value, const uint8_t *src); + + template <> + __device__ __inline__ void apply_mask<__half, 1>(__half *dst, __half value, const uint8_t *src) { + if (*src == 1) { *dst = value; } + } + template + __device__ __inline__ void apply_additive_mask(Datatype *dst, const Datatype *additive_mask); + template <> + __device__ __inline__ void apply_additive_mask<__half, 1>(__half *dst, const __half *additive_mask) { + *dst += *additive_mask; + } + template <> + __device__ __inline__ void apply_additive_mask<__half, 4>(__half *dst, const __half *additive_mask) { + *dst += *additive_mask; + *(dst+1) += *(additive_mask+1); + *(dst+2) += *(additive_mask+2); + *(dst+3) += *(additive_mask+3);} +} // namespace anonymous + +//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// +// Warp Softmax forward +//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +__global__ void softmax_warp_forward(input_t *dst, const output_t *src, int batch_size, int stride, int element_count) +{ + assert(ELEMENTS_PER_LDG_STG==1); + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + + src += first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + dst += first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + + // load data from global memory + input_t elements_input[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + elements_input[i][it + element] = -std::numeric_limits::infinity(); + } + + if (element_index < batch_element_count) { + copy_vector(&elements_input[i][it], src + i * element_count + it * WARP_SIZE); + } + + } + } + + // convert input_t to acc_t + acc_t elements[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + //elements[i][it] = expf(elements[i][it] - max_value[i]); + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + //dst[i * element_count + it * WARP_SIZE] = elements[i][it] / sum[i]; + output_t out[ELEMENTS_PER_LDG_STG]; + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = elements[i][it + element] / sum[i]; + } + copy_vector(dst + i * element_count + it * WARP_SIZE, out); + } + else { + break; + } + } + } +} + + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using softmax_forward_func = void(*)(input_t *dst, const output_t *src, int batch_size, int stride, int element_count); + +template +bool warp_softmax_kernel(int log2_elements, int &warp_size, int &batches_per_warp, softmax_forward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + switch (log2_elements) { + case 0: // 1 + kernel = &softmax_warp_forward; + break; + case 1: // 2 + kernel = &softmax_warp_forward; + break; + case 2: // 4 + kernel = &softmax_warp_forward; + break; + case 3: // 8 + kernel = &softmax_warp_forward; + break; + case 4: // 16 + kernel = &softmax_warp_forward; + break; + case 5: // 32 + kernel = &softmax_warp_forward; + break; + case 6: // 64 + kernel = &softmax_warp_forward; + break; + case 7: // 128 + kernel = &softmax_warp_forward; + break; + case 8: // 256 + kernel = &softmax_warp_forward; + break; + case 9: // 512 + kernel = &softmax_warp_forward; + break; + case 10: // 1024 + kernel = &softmax_warp_forward; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_softmax(output_t *dst, const input_t *src, int softmax_elements, int softmax_elements_stride, int batch_count) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + softmax_forward_func kernel; + int warp_size, batches_per_warp; + if (!warp_softmax_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(dst, src, batch_count, softmax_elements_stride, softmax_elements); + return true; + } + return false; +} + +template +__global__ void additive_masked_softmax_dropout_warp_forward_vec4(output_t *dst, uint8_t *dropout_mask, const input_t *src, const input_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride, at::PhiloxCudaState philox_args, float p) +{ + + assert(ELEMENTS_PER_LDG_STG==4); + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + int tid = blockIdx.x * blockDim.x * blockDim.y + threadIdx.y * blockDim.x + threadIdx.x; + acc_t pinv = acc_t(1)/p; + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + //vectorize if element_count is multiple of 4, else don't vectorize + input_t elements_input[WARP_BATCH][WARP_ITERATIONS]; + + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + src += thread_offset; + dst += thread_offset; + dropout_mask += thread_offset; + + // load data from global memory + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + int pad_thread_offset = ( (first_batch + i) / pad_batch_stride) * stride + ELEMENTS_PER_LDG_STG * local_idx; + const half* curr_mask = pad_mask + pad_thread_offset; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + //masking_value is a large negative value + elements_input[i][it + element] = -10000; + } + + if (element_index < batch_element_count) { + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + copy_vector(&elements_input[i][it], src + itr_idx); + apply_additive_mask(&elements_input[i][it], curr_mask + itr_jmp); //(__half)-std::numeric_limits::infinity() + } + + } + } + // convert input_t to acc_t + acc_t elements[WARP_BATCH][WARP_ITERATIONS]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + auto seeds = at::cuda::philox::unpack(philox_args); + Philox ph(std::get<0>(seeds), tid, std::get<1>(seeds)); + uint8_t rands[WARP_BATCH][WARP_ITERATIONS]; + float4 rand_num; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it+=ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + rand_num = uniform4(ph()); + rands[i][it] = (rand_num.x <= p) > 0.5; + rands[i][it+1] = (rand_num.y <= p) > 0.5; + rands[i][it+2] = (rand_num.z <= p) > 0.5; + rands[i][it+3] = (rand_num.w <= p) > 0.5; + copy_vector(dropout_mask + i * element_count + it * WARP_SIZE, &rands[i][it]); + } + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + output_t out[ELEMENTS_PER_LDG_STG]; + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = rands[i][it+element] * (pinv * (elements[i][it + element] / sum[i])); + } + copy_vector(dst + i * element_count + it * WARP_SIZE, out); + + } + else { + break; + } + } + } +} + + +template +__global__ void additive_masked_softmax_dropout_warp_forward(output_t *dst, uint8_t *dropout_mask, const input_t *src, const input_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride, at::PhiloxCudaState philox_args, float p) +{ + assert(ELEMENTS_PER_LDG_STG==1); + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + int tid = blockIdx.x * blockDim.x * blockDim.y + threadIdx.y * blockDim.x + threadIdx.x; + acc_t pinv = acc_t(1)/p; + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + //vectorize if element_count is multiple of 4, else don't vectorize + input_t elements_input[WARP_BATCH][WARP_ITERATIONS]; + + int thread_offset = first_batch * stride + local_idx; + src += thread_offset; + dst += thread_offset; + dropout_mask += thread_offset; + + // load data from global memory + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + int pad_thread_offset = ( (first_batch + i) / pad_batch_stride) * stride + local_idx; + const half* curr_mask = pad_mask + pad_thread_offset; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += 1) { + int element_index = local_idx + it * WARP_SIZE; + #pragma unroll + for (int element = 0;element < 1;++element) { + //masking_value is a large negative value + elements_input[i][it + element] = -10000; + } + + if (element_index < batch_element_count) { + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + copy_vector(&elements_input[i][it], src + itr_idx); + apply_additive_mask(&elements_input[i][it], curr_mask + itr_jmp); + } + + } + } + // convert input_t to acc_t + acc_t elements[WARP_BATCH][WARP_ITERATIONS]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + curandStatePhilox4_32_10_t state; + auto seeds = at::cuda::philox::unpack(philox_args); + curand_init( + std::get<0>(seeds), + tid, + std::get<1>(seeds), + &state); + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += 1) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < element_count) { + output_t out[1]; + acc_t softmax_out[1]; + uint8_t dropout_mask_temp[1]; + //generate a vector of random numbers here + float rand = curand_uniform(&state); + float *rand_ptr = (float*)(&rand); + #pragma unroll + for (int element = 0;element < 1;++element) { + softmax_out[element] = (elements[i][it + element] / sum[i]); + rand_ptr[element] = rand_ptr[element] <= p; + out[element] = rand_ptr[element] * pinv * softmax_out[element]; + dropout_mask_temp[element] = rand_ptr[element] > 0.5; // just to distinguish 0.0f and 1.0f + } + copy_vector(dst + i * element_count + it * WARP_SIZE, out); + copy_vector(dropout_mask + i * element_count + it * WARP_SIZE, dropout_mask_temp); + + } + else { + break; + } + } + } +} + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using additive_masked_softmax_dropout_forward_func = void(*)(output_t *dst, uint8_t *dropout_mask, const input_t *src, const input_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride, at::PhiloxCudaState philox_args, float p); + + +template +bool warp_additive_masked_softmax_dropout_kernel(int element_count, int log2_elements, int &warp_size, int &batches_per_warp, additive_masked_softmax_dropout_forward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + bool flag_vec4 = (element_count % 4 == 0); + switch (log2_elements) { + case 0: // 1 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 1: // 2 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 2: // 4 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 3: // 8 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 4: // 16 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 5: // 32 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 6: // 64 + kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 7: // 128 + if (flag_vec4) kernel = &additive_masked_softmax_dropout_warp_forward_vec4; + else kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 8: // 256 + if (flag_vec4) kernel = &additive_masked_softmax_dropout_warp_forward_vec4; + else kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 9: // 512 + if (flag_vec4) kernel = &additive_masked_softmax_dropout_warp_forward_vec4; + else kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 10: // 1024 + if (flag_vec4) kernel = &additive_masked_softmax_dropout_warp_forward_vec4; + else kernel = &additive_masked_softmax_dropout_warp_forward; + break; + case 11: // 2048 + if (flag_vec4) kernel = &additive_masked_softmax_dropout_warp_forward_vec4; + else kernel = &additive_masked_softmax_dropout_warp_forward; + break; + default: + return false; + } + return true; +} + + + +template +bool dispatch_additive_masked_softmax_dropout(output_t *dst, uint8_t *dropout_mask, const input_t *src, const input_t *pad_mask, int totalElements, int softmax_elements, int softmax_elements_stride, int batch_count, int pad_batch_stride, float p, cudaStream_t streamid)// p is the probability to keep, not drop +{ + + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 2048) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + additive_masked_softmax_dropout_forward_func kernel; + int warp_size, batches_per_warp; + if (!warp_additive_masked_softmax_dropout_kernel(softmax_elements, log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + c10::optional gen_; + auto gen = at::get_generator_or_default(gen_, at::cuda::detail::getDefaultCUDAGenerator()); + int64_t counter_offset = (totalElements/(blocks*threads_per_block)+1); + at::PhiloxCudaState rng_engine_inputs; + { + std::lock_guard lock(gen->mutex_); + rng_engine_inputs = gen->philox_cuda_state(counter_offset); + } + + // compute launch size + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(dst, dropout_mask, src, pad_mask, batch_count, softmax_elements_stride, softmax_elements, pad_batch_stride, rng_engine_inputs, p); + return true; + } + return false; +} + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +__global__ void additive_masked_softmax_warp_forward(input_t *dst, const output_t *src, const input_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride) +{ + assert(ELEMENTS_PER_LDG_STG==1); + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + src += thread_offset; + dst += thread_offset; + + // load data from global memory + input_t elements_input[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + int pad_thread_offset = ( (first_batch + i) / pad_batch_stride) * stride + ELEMENTS_PER_LDG_STG * local_idx; + const half* curr_mask = pad_mask + pad_thread_offset; + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + //masking_value is a large negative value + elements_input[i][it + element] = -10000; + } + + if (element_index < batch_element_count) { + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + copy_vector(&elements_input[i][it], src + itr_idx); + //apply_mask(&elements_input[i][it], + // (__half)-std::numeric_limits::infinity(), + // curr_mask + itr_jmp); + elements_input[i][it] += *(curr_mask + itr_jmp); + } + + } + } + + // convert input_t to acc_t + acc_t elements[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + //elements[i][it] = expf(elements[i][it] - max_value[i]); + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + //dst[i * element_count + it * WARP_SIZE] = elements[i][it] / sum[i]; + output_t out[ELEMENTS_PER_LDG_STG]; + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = elements[i][it + element] / sum[i]; + } + copy_vector(dst + i * element_count + it * WARP_SIZE, out); + } + else { + break; + } + } + } +} + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using additive_masked_softmax_forward_func = void(*)(input_t *dst, const output_t *src, const half *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride); + +template +bool warp_additive_masked_softmax_kernel(int log2_elements, int &warp_size, int &batches_per_warp, additive_masked_softmax_forward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + switch (log2_elements) { + case 0: // 1 + kernel = &additive_masked_softmax_warp_forward; + break; + case 1: // 2 + kernel = &additive_masked_softmax_warp_forward; + break; + case 2: // 4 + kernel = &additive_masked_softmax_warp_forward; + break; + case 3: // 8 + kernel = &additive_masked_softmax_warp_forward; + break; + case 4: // 16 + kernel = &additive_masked_softmax_warp_forward; + break; + case 5: // 32 + kernel = &additive_masked_softmax_warp_forward; + break; + case 6: // 64 + kernel = &additive_masked_softmax_warp_forward; + break; + case 7: // 128 + kernel = &additive_masked_softmax_warp_forward; + break; + case 8: // 256 + kernel = &additive_masked_softmax_warp_forward; + break; + case 9: // 512 + kernel = &additive_masked_softmax_warp_forward; + break; + case 10: // 1024 + kernel = &additive_masked_softmax_warp_forward; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_additive_masked_softmax(output_t *dst, const input_t *src, const input_t *pad_mask, int softmax_elements, int softmax_elements_stride, int batch_count, int pad_batch_stride) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + additive_masked_softmax_forward_func kernel; + int warp_size, batches_per_warp; + if (!warp_additive_masked_softmax_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(dst, src, pad_mask, batch_count, softmax_elements_stride, softmax_elements, pad_batch_stride); + return true; + } + return false; +} + +template +bool dispatch_additive_masked_softmax_stream(output_t *dst, const input_t *src, const input_t *pad_mask, int softmax_elements, int softmax_elements_stride, int batch_count, int pad_batch_stride, cudaStream_t streamid) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + additive_masked_softmax_forward_func kernel; + int warp_size, batches_per_warp; + if (!warp_additive_masked_softmax_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + // launch + kernel<<>>(dst, src, pad_mask, batch_count, softmax_elements_stride, softmax_elements, pad_batch_stride); + return true; + } + return false; +} + + + + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +__global__ void masked_softmax_warp_forward(input_t *dst, const output_t *src, const uint8_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride) +{ + assert(ELEMENTS_PER_LDG_STG==1); + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + src += thread_offset; + dst += thread_offset; + + // load data from global memory + input_t elements_input[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + int pad_thread_offset = ( (first_batch + i) / pad_batch_stride) * stride + ELEMENTS_PER_LDG_STG * local_idx; + const uint8_t* curr_mask = pad_mask + pad_thread_offset; + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + elements_input[i][it + element] = -std::numeric_limits::infinity(); + } + + if (element_index < batch_element_count) { + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + copy_vector(&elements_input[i][it], src + itr_idx); + apply_mask(&elements_input[i][it], + (__half)-std::numeric_limits::infinity(), + curr_mask + itr_jmp); + } + + } + } + + // convert input_t to acc_t + acc_t elements[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + //elements[i][it] = expf(elements[i][it] - max_value[i]); + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + //dst[i * element_count + it * WARP_SIZE] = elements[i][it] / sum[i]; + output_t out[ELEMENTS_PER_LDG_STG]; + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = elements[i][it + element] / sum[i]; + } + copy_vector(dst + i * element_count + it * WARP_SIZE, out); + } + else { + break; + } + } + } +} + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using masked_softmax_forward_func = void(*)(input_t *dst, const output_t *src, const uint8_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride); + +template +bool warp_masked_softmax_kernel(int log2_elements, int &warp_size, int &batches_per_warp, masked_softmax_forward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + switch (log2_elements) { + case 0: // 1 + kernel = &masked_softmax_warp_forward; + break; + case 1: // 2 + kernel = &masked_softmax_warp_forward; + break; + case 2: // 4 + kernel = &masked_softmax_warp_forward; + break; + case 3: // 8 + kernel = &masked_softmax_warp_forward; + break; + case 4: // 16 + kernel = &masked_softmax_warp_forward; + break; + case 5: // 32 + kernel = &masked_softmax_warp_forward; + break; + case 6: // 64 + kernel = &masked_softmax_warp_forward; + break; + case 7: // 128 + kernel = &masked_softmax_warp_forward; + break; + case 8: // 256 + kernel = &masked_softmax_warp_forward; + break; + case 9: // 512 + kernel = &masked_softmax_warp_forward; + break; + case 10: // 1024 + kernel = &masked_softmax_warp_forward; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_masked_softmax(output_t *dst, const input_t *src, const uint8_t *pad_mask, int softmax_elements, int softmax_elements_stride, int batch_count, int pad_batch_stride) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + masked_softmax_forward_func kernel; + int warp_size, batches_per_warp; + if (!warp_masked_softmax_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(dst, src, pad_mask, batch_count, softmax_elements_stride, softmax_elements, pad_batch_stride); + return true; + } + return false; +} + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +__global__ void time_masked_softmax_warp_forward(input_t *dst, const output_t *src, const uint8_t *pad_mask, int batch_size, int stride, int element_count, int mod_seq_len) +{ + assert(ELEMENTS_PER_LDG_STG==1); + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + src += thread_offset; + dst += thread_offset; + + // load data from global memory + input_t elements_input[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + int pad_thread_offset = ( (first_batch + i) % mod_seq_len) * stride + ELEMENTS_PER_LDG_STG * local_idx; + const uint8_t* curr_mask = pad_mask + pad_thread_offset; + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + elements_input[i][it + element] = -std::numeric_limits::infinity(); + } + + if (element_index < batch_element_count) { + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + copy_vector(&elements_input[i][it], src + itr_idx); + apply_mask(&elements_input[i][it], + (__half)-std::numeric_limits::infinity(), + curr_mask + itr_jmp); + } + + } + } + + // convert input_t to acc_t + acc_t elements[WARP_BATCH][WARP_ITERATIONS]; + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + //elements[i][it] = expf(elements[i][it] - max_value[i]); + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + //dst[i * element_count + it * WARP_SIZE] = elements[i][it] / sum[i]; + output_t out[ELEMENTS_PER_LDG_STG]; + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = elements[i][it + element] / sum[i]; + } + copy_vector(dst + i * element_count + it * WARP_SIZE, out); + } + else { + break; + } + } + } +} + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using time_masked_softmax_forward_func = void(*)(input_t *dst, const output_t *src, const uint8_t *pad_mask, int batch_size, int stride, int element_count, int mod_seq_len); + +template +bool warp_time_masked_softmax_kernel(int log2_elements, int &warp_size, int &batches_per_warp, time_masked_softmax_forward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + switch (log2_elements) { + case 0: // 1 + kernel = &time_masked_softmax_warp_forward; + break; + case 1: // 2 + kernel = &time_masked_softmax_warp_forward; + break; + case 2: // 4 + kernel = &time_masked_softmax_warp_forward; + break; + case 3: // 8 + kernel = &time_masked_softmax_warp_forward; + break; + case 4: // 16 + kernel = &time_masked_softmax_warp_forward; + break; + case 5: // 32 + kernel = &time_masked_softmax_warp_forward; + break; + case 6: // 64 + kernel = &time_masked_softmax_warp_forward; + break; + case 7: // 128 + kernel = &time_masked_softmax_warp_forward; + break; + case 8: // 256 + kernel = &time_masked_softmax_warp_forward; + break; + case 9: // 512 + kernel = &time_masked_softmax_warp_forward; + break; + case 10: // 1024 + kernel = &time_masked_softmax_warp_forward; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_time_masked_softmax(output_t *dst, const input_t *src, const uint8_t *pad_mask, int softmax_elements, int softmax_elements_stride, int batch_count, int mod_seq_len) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + time_masked_softmax_forward_func kernel; + int warp_size, batches_per_warp; + if (!warp_time_masked_softmax_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(dst, src, pad_mask, batch_count, softmax_elements_stride, softmax_elements, mod_seq_len); + return true; + } + return false; +} + +int log2_ceil_native(int value) { + int log2_value = 0; + while ((1 << log2_value) < value) ++log2_value; + return log2_value; +} + +template +__device__ __forceinline__ T WARP_SHFL_XOR_NATIVE(T value, int laneMask, int width = warpSize, unsigned int mask = 0xffffffff) +{ +#if CUDA_VERSION >= 9000 + return __shfl_xor_sync(mask, value, laneMask, width); +#else + return __shfl_xor(value, laneMask, width); +#endif +} + +template +__device__ __forceinline__ void warp_reduce_sum(acc_t* sum) { + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + acc_t b = WARP_SHFL_XOR_NATIVE(sum[i], offset, WARP_SIZE); + sum[i] = sum[i] + b; + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// +// Warp softmax backward functions as fused variants of at::softmax_backward_data function +//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// + +//softmax backward data function is taken from native pytorch, elementwise mul is fused in the epolog, as well as masking and scaling for fusing dropout + +template +__global__ void masked_scale_softmax_warp_backward_masked_dgrad(output_t *gradInput, const input_t *grad, const input_t *output, const uint8_t *mask, const uint8_t *pad_mask, acc_t scale, int batch_size, int stride, int element_count, int heads) +{ + // WARP_SIZE and WARP_BATCH must match the return values batches_per_warp and warp_size of method warp_softmax_backward_kernel. + constexpr int next_power_of_two = 1 << log2_elements; + constexpr int WARP_SIZE = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + constexpr int WARP_ITERATIONS = next_power_of_two / WARP_SIZE; + constexpr int WARP_BATCH = (next_power_of_two <= 128) ? 2 : 1; + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x % WARP_SIZE; + + // the first element to process by the current thread + int thread_offset = first_batch * stride + local_idx; + grad += thread_offset; + output += thread_offset; + gradInput += thread_offset; + mask += thread_offset; + + // The nested loops over WARP_BATCH and then WARP_ITERATIONS can be simplified to one loop, + // but I think doing so would obfuscate the logic of the algorithm, thus I chose to keep + // the nested loops. + // This should have no impact on performance because the loops are unrolled anyway. + + // load data from global memory + acc_t grad_reg[WARP_BATCH][WARP_ITERATIONS] ; + acc_t output_reg[WARP_BATCH][WARP_ITERATIONS] ; + for (int i = 0; i < WARP_BATCH; ++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + for (int it = 0; it < WARP_ITERATIONS; ++it) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < batch_element_count) { + grad_reg[i][it] = (input_t)((acc_t)mask[i*element_count+it*WARP_SIZE] * (acc_t)grad[i*element_count+it*WARP_SIZE] * (acc_t)scale )*output[i*element_count+it*WARP_SIZE]; + output_reg[i][it] = output[i*element_count+it*WARP_SIZE]; + } else { + grad_reg[i][it] = acc_t(0); + output_reg[i][it] = acc_t(0); + } + } + } + + acc_t sum[WARP_BATCH]; + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + sum[i] = grad_reg[i][0]; + #pragma unroll + for (int it = 1; it < WARP_ITERATIONS; ++it) { + sum[i] += grad_reg[i][it]; + } + } + warp_reduce_sum(sum); + + // store result + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0; it < WARP_ITERATIONS; ++it) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < element_count) { + // compute gradients + int total_ind = thread_offset + i*element_count + it*WARP_SIZE; + int pad_mask_ind = element_count*(total_ind/(heads * element_count * element_count)) + total_ind%element_count; + uint8_t pad_mask_element = 1 - pad_mask[pad_mask_ind]; + if (pad_mask_element == 0) gradInput[i*element_count+it*WARP_SIZE] = 0; + else { + if (is_log_softmax) { + gradInput[i*element_count+it*WARP_SIZE] = (grad_reg[i][it] - std::exp(output_reg[i][it]) * sum[i]); + } else { + gradInput[i*element_count+it*WARP_SIZE] = (grad_reg[i][it] - output_reg[i][it] * sum[i]); + } + } + } + } + } +} +template +void dispatch_masked_scale_softmax_backward_masked_out(output_t *grad_input, const input_t *grad, const input_t *output, const uint8_t *mask, const uint8_t *pad_mask, acc_t scale, int softmax_elements, int softmax_elements_stride, int batch_count, int heads) +{ + TORCH_INTERNAL_ASSERT( softmax_elements >= 0 && softmax_elements <= 1024 ); + if (softmax_elements == 0) { + return; + } else { + int log2_elements = log2_ceil_native(softmax_elements); + const int next_power_of_two = 1 << log2_elements; + + // This value must match the WARP_SIZE constexpr value computed inside softmax_warp_backward. + int warp_size = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + + // This value must match the WARP_BATCH constexpr value computed inside softmax_warp_backward. + int batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + int warps_per_block = (threads_per_block / warp_size); + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + // Launch code would be more elegant if C++ supported FOR CONSTEXPR + switch (log2_elements) { + case 0: // 1 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 1: // 2 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 2: // 4 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 3: // 8 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 4: // 16 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 5: // 32 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 6: // 64 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 7: // 128 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 8: // 256 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 9: // 512 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 10: // 1024 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + default: + break; + } + } +} + +template +void dispatch_masked_scale_softmax_backward_masked_out_stream(output_t *grad_input, const input_t *grad, const input_t *output, const uint8_t *mask, const uint8_t *pad_mask, acc_t scale, int softmax_elements, int softmax_elements_stride, int batch_count, int heads, cudaStream_t streamid) +{ + TORCH_INTERNAL_ASSERT( softmax_elements >= 0 && softmax_elements <= 1024 ); + if (softmax_elements == 0) { + return; + } else { + int log2_elements = log2_ceil_native(softmax_elements); + const int next_power_of_two = 1 << log2_elements; + // This value must match the WARP_SIZE constexpr value computed inside softmax_warp_backward. + int warp_size = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + // This value must match the WARP_BATCH constexpr value computed inside softmax_warp_backward. + int batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + int warps_per_block = (threads_per_block / warp_size); + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + // Launch code would be more elegant if C++ supported FOR CONSTEXPR + switch (log2_elements) { + case 0: // 1 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 1: // 2 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 2: // 4 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 3: // 8 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 4: // 16 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 5: // 32 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 6: // 64 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 7: // 128 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 8: // 256 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 9: // 512 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + case 10: // 1024 + masked_scale_softmax_warp_backward_masked_dgrad + <<>>(grad_input, grad, output, mask, pad_mask, scale, batch_count, softmax_elements_stride, softmax_elements, heads); + break; + default: + break; + } + } +} + +template +__global__ void masked_scale_softmax_warp_backward(output_t *gradInput, const input_t *grad, const input_t *output, const uint8_t *mask, acc_t scale, int batch_size, int stride, int element_count) +{ + // WARP_SIZE and WARP_BATCH must match the return values batches_per_warp and warp_size of method warp_softmax_backward_kernel. + constexpr int next_power_of_two = 1 << log2_elements; + constexpr int WARP_SIZE = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + constexpr int WARP_ITERATIONS = next_power_of_two / WARP_SIZE; + constexpr int WARP_BATCH = (next_power_of_two <= 128) ? 2 : 1; + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x % WARP_SIZE; + + // the first element to process by the current thread + int thread_offset = first_batch * stride + local_idx; + grad += thread_offset; + output += thread_offset; + gradInput += thread_offset; + mask += thread_offset; + + // The nested loops over WARP_BATCH and then WARP_ITERATIONS can be simplified to one loop, + // but I think doing so would obfuscate the logic of the algorithm, thus I chose to keep + // the nested loops. + // This should have no impact on performance because the loops are unrolled anyway. + + // load data from global memory + acc_t grad_reg[WARP_BATCH][WARP_ITERATIONS] ; + acc_t output_reg[WARP_BATCH][WARP_ITERATIONS] ; + for (int i = 0; i < WARP_BATCH; ++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + for (int it = 0; it < WARP_ITERATIONS; ++it) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < batch_element_count) { + grad_reg[i][it] = (input_t)((acc_t)mask[i*element_count+it*WARP_SIZE] * (acc_t)grad[i*element_count+it*WARP_SIZE] * (acc_t)scale )*output[i*element_count+it*WARP_SIZE]; + output_reg[i][it] = output[i*element_count+it*WARP_SIZE]; + } else { + grad_reg[i][it] = acc_t(0); + output_reg[i][it] = acc_t(0); + } + } + } + + acc_t sum[WARP_BATCH]; + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + sum[i] = grad_reg[i][0]; + #pragma unroll + for (int it = 1; it < WARP_ITERATIONS; ++it) { + sum[i] += grad_reg[i][it]; + } + } + warp_reduce_sum(sum); + + // store result + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0; it < WARP_ITERATIONS; ++it) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < element_count) { + // compute gradients + if (is_log_softmax) { + gradInput[i*element_count+it*WARP_SIZE] = (grad_reg[i][it] - std::exp(output_reg[i][it]) * sum[i]); + } else { + gradInput[i*element_count+it*WARP_SIZE] = (grad_reg[i][it] - output_reg[i][it] * sum[i]); + } + } + } + } +} + + + + + +template +__global__ void masked_scale_softmax_warp_backward_recompute(output_t *gradInput, const input_t *grad, const input_t *softmax_input, const input_t *pad_mask, const uint8_t *mask, acc_t scale, int batch_size, int stride, int pad_batch_stride, int element_count) +{ + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x % WARP_SIZE; + //vectorize if a row length is multiple of 4 + int flag_vec4 = element_count & 3 == 0; + acc_t grad_reg[WARP_BATCH][WARP_ITERATIONS] ; + input_t elements_input[WARP_BATCH][WARP_ITERATIONS] ; + + // the first element to process by the current thread + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + + grad += thread_offset; + softmax_input += thread_offset; + gradInput += thread_offset; + mask += thread_offset; + + // The nested loops over WARP_BATCH and then WARP_ITERATIONS can be simplified to one loop, + // but I think doing so would obfuscate the logic of the algorithm, thus I chose to keep + // the nested loops. + // This should have no impact on performance because the loops are unrolled anyway. + + // load data from global memory + for (int i = 0; i < WARP_BATCH; ++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + int pad_thread_offset = ( (first_batch + i) / pad_batch_stride) * stride + ELEMENTS_PER_LDG_STG * local_idx; + const input_t* curr_mask = pad_mask + pad_thread_offset; + #pragma unroll + for (int it = 0; it < WARP_ITERATIONS; it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + //masking_value is a large negative value + elements_input[i][it + element] = -10000; + grad_reg[i][it+element] = acc_t(0); + } + + if (element_index < batch_element_count) { + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + copy_vector(&elements_input[i][it], softmax_input + itr_idx); + apply_additive_mask(&elements_input[i][it], curr_mask + itr_jmp); //(__half)-std::numeric_limits::infinity() + uint8_t mask_temp[ELEMENTS_PER_LDG_STG]; + input_t grad_temp[ELEMENTS_PER_LDG_STG]; + copy_vector(&mask_temp[0], mask + itr_idx); + copy_vector(&grad_temp[0], grad + itr_idx); + #pragma unroll + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + grad_reg[i][it+element] = ((acc_t)mask_temp[element] * (acc_t)grad_temp[element] * (acc_t)scale ); + } + } + + } + } + // load data from global memory + + // convert input_t to acc_t + // TODO : remove this, input is already acc_t type in register + acc_t elements[WARP_BATCH][WARP_ITERATIONS] ; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;++it) { + elements[i][it] = elements_input[i][it]; + } + } + + constexpr uint32_t FULL_MASK = 0xffffffff; + + // compute local max_value + + // take the max_value of the first element to avoid one max call + acc_t max_value[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = elements[i][0]; + } + + #pragma unroll + for (int it = 1;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = (max_value[i] > elements[i][it]) ? max_value[i] : elements[i][it]; + } + } + + // reduction max_value + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + float val[WARP_BATCH]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + val[i] = __shfl_xor_sync(FULL_MASK, max_value[i], offset, WARP_SIZE); + } + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + max_value[i] = max_value[i] > val[i] ? max_value[i] : val[i]; + } + } + + // compute local sum + acc_t sum[WARP_BATCH] { 0.0f }; + + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + //elements[i][it] = expf(elements[i][it] - max_value[i]); + elements[i][it] = std::exp(elements[i][it] - max_value[i]); + sum[i] += elements[i][it]; + } + } + + // reduction sum + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it ++) { + elements[i][it] = elements[i][it] / sum[i]; + grad_reg[i][it] = grad_reg[i][it] * elements[i][it]; + } + } + + acc_t grad_sum[WARP_BATCH]; + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + grad_sum[i] = grad_reg[i][0]; + #pragma unroll + for (int it = 1; it < WARP_ITERATIONS; ++it) { + grad_sum[i] += grad_reg[i][it]; + } + } + warp_reduce_sum(grad_sum); + + // store result + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0; it < WARP_ITERATIONS; it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + // compute gradients + output_t grad_input_reg[ELEMENTS_PER_LDG_STG]; + #pragma unroll + for (int element=0; element(gradInput + i * element_count + it * WARP_SIZE, grad_input_reg); + } + } + } +} + + + +template +using masked_scale_softmax_warp_backward_recompute_func = void(*)(output_t *gradInput, const input_t *grad, const input_t *softmax_input, const input_t *pad_mask, const uint8_t *mask, acc_t scale, int batch_size, int stride, int pad_batch_stride, int element_count); + +template +bool masked_scale_softmax_warp_backward_recompute_kernel(int element_count, int log2_elements, int &warp_size, int &batches_per_warp, masked_scale_softmax_warp_backward_recompute_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + bool flag_vec4 = (element_count % 4 == 0); + switch (log2_elements) { + case 0: // 1 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 1: // 2 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 2: // 4 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 3: // 8 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 4: // 16 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 5: // 32 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 6: // 64 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 7: // 128 + kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 8: // 256 + if (flag_vec4) kernel = &masked_scale_softmax_warp_backward_recompute; + else kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 9: // 512 + if (flag_vec4) kernel = &masked_scale_softmax_warp_backward_recompute; + else kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 10: // 1024 + if (flag_vec4) kernel = &masked_scale_softmax_warp_backward_recompute; + else kernel = &masked_scale_softmax_warp_backward_recompute; + break; + case 11: // 2048 + if (flag_vec4) kernel = &masked_scale_softmax_warp_backward_recompute; + else kernel = &masked_scale_softmax_warp_backward_recompute; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_masked_scale_softmax_backward_recompute(output_t *grad_input, const input_t *grad, const input_t *softmax_input, const input_t *pad_mask, const uint8_t *mask, acc_t scale, int softmax_elements, int softmax_elements_stride, int pad_batch_stride, int batch_count, cudaStream_t streamid) +{ + + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 2048) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + masked_scale_softmax_warp_backward_recompute_func kernel; + int warp_size, batches_per_warp; + if (!masked_scale_softmax_warp_backward_recompute_kernel(softmax_elements, log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + + // compute launch size + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(grad_input, grad, softmax_input, pad_mask, mask, scale, batch_count, softmax_elements_stride, pad_batch_stride, softmax_elements); + return true; + } + return false; +} + + +template +void dispatch_masked_scale_softmax_backward_stream(output_t *grad_input, const input_t *grad, const input_t *output, const uint8_t *mask, acc_t scale, int softmax_elements, int softmax_elements_stride, int batch_count, cudaStream_t streamid) +{ + TORCH_INTERNAL_ASSERT( softmax_elements >= 0 && softmax_elements <= 1024 ); + if (softmax_elements == 0) { + return; + } else { + int log2_elements = log2_ceil_native(softmax_elements); + const int next_power_of_two = 1 << log2_elements; + // This value must match the WARP_SIZE constexpr value computed inside softmax_warp_backward. + int warp_size = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + // This value must match the WARP_BATCH constexpr value computed inside softmax_warp_backward. + int batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + int warps_per_block = (threads_per_block / warp_size); + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + // Launch code would be more elegant if C++ supported FOR CONSTEXPR + switch (log2_elements) { + case 0: // 1 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 1: // 2 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 2: // 4 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 3: // 8 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 4: // 16 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 5: // 32 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 6: // 64 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 7: // 128 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 8: // 256 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 9: // 512 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + case 10: // 1024 + masked_scale_softmax_warp_backward + <<>>(grad_input, grad, output, mask, scale, batch_count, softmax_elements_stride, softmax_elements); + break; + default: + break; + } + } +} + +// elementwise multiplication called in at::softmax_backward_data is fused inside softmax dgrad kernel +// as a result of fusion, intermediate multiplication result is stored in fp32 in registers, instead of fp16 +template +__global__ void softmax_warp_backward_fused_native(output_t *gradInput, const input_t *grad, const input_t *output, int batch_size, int stride, int element_count) +{ + // WARP_SIZE and WARP_BATCH must match the return values batches_per_warp and warp_size of method warp_softmax_backward_kernel. + constexpr int next_power_of_two = 1 << log2_elements; + constexpr int WARP_SIZE = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + constexpr int WARP_ITERATIONS = next_power_of_two / WARP_SIZE; + constexpr int WARP_BATCH = (next_power_of_two <= 128) ? 2 : 1; + + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x % WARP_SIZE; + + // the first element to process by the current thread + int thread_offset = first_batch * stride + local_idx; + grad += thread_offset; + output += thread_offset; + gradInput += thread_offset; + + // The nested loops over WARP_BATCH and then WARP_ITERATIONS can be simplified to one loop, + // but I think doing so would obfuscate the logic of the algorithm, thus I chose to keep + // the nested loops. + // This should have no impact on performance because the loops are unrolled anyway. + + // load data from global memory + acc_t grad_reg[WARP_BATCH][WARP_ITERATIONS] ; + acc_t output_reg[WARP_BATCH][WARP_ITERATIONS] ; + for (int i = 0; i < WARP_BATCH; ++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + for (int it = 0; it < WARP_ITERATIONS; ++it) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < batch_element_count) { + grad_reg[i][it] = grad[i*element_count+it*WARP_SIZE]*output[i*element_count+it*WARP_SIZE]; + output_reg[i][it] = output[i*element_count+it*WARP_SIZE]; + } else { + grad_reg[i][it] = acc_t(0); + output_reg[i][it] = acc_t(0); + } + } + } + + acc_t sum[WARP_BATCH]; + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + sum[i] = grad_reg[i][0]; //* output_reg[i][0]; + #pragma unroll + for (int it = 1; it < WARP_ITERATIONS; ++it) { + sum[i] += grad_reg[i][it];// * output_reg[i][it]; + } + } + warp_reduce_sum(sum); + + // store result + #pragma unroll + for (int i = 0; i < WARP_BATCH; ++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0; it < WARP_ITERATIONS; ++it) { + int element_index = local_idx + it * WARP_SIZE; + if (element_index < element_count) { + // compute gradients + if (is_log_softmax) { + gradInput[i*element_count+it*WARP_SIZE] = (grad_reg[i][it] - std::exp(output_reg[i][it]) * sum[i]); + } else { + gradInput[i*element_count+it*WARP_SIZE] = (grad_reg[i][it] - output_reg[i][it] * sum[i]); + } + } + } + } +} + +template +void dispatch_softmax_backward_fused_native(output_t *grad_input, const input_t *grad, const input_t *output, int softmax_elements, int softmax_elements_stride, int batch_count) +{ + TORCH_INTERNAL_ASSERT( softmax_elements >= 0 && softmax_elements <= 1024 ); + if (softmax_elements == 0) { + return; + } else { + int log2_elements = log2_ceil_native(softmax_elements); + const int next_power_of_two = 1 << log2_elements; + + // This value must match the WARP_SIZE constexpr value computed inside softmax_warp_backward. + int warp_size = (next_power_of_two < C10_WARP_SIZE) ? next_power_of_two : C10_WARP_SIZE; + + // This value must match the WARP_BATCH constexpr value computed inside softmax_warp_backward. + int batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + int warps_per_block = (threads_per_block / warp_size); + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + // Launch code would be more elegant if C++ supported FOR CONSTEXPR + switch (log2_elements) { + case 0: // 1 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 1: // 2 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 2: // 4 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 3: // 8 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 4: // 16 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 5: // 32 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 6: // 64 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 7: // 128 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 8: // 256 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 9: // 512 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + case 10: // 1024 + softmax_warp_backward_fused_native + <<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + break; + default: + break; + } + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// +// Warp softmax backward +//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// + +template +__global__ void softmax_warp_backward(__half *gradInput, const __half *grad, const __half *output, int batch_size, int stride, int element_count) +{ + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + + // the first element to process by the current thread + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + grad += thread_offset; + output += thread_offset; + gradInput += thread_offset; + + // load data from global memory + input_t grad_reg_input[WARP_BATCH][WARP_ITERATIONS] = {0.0f}; + input_t output_reg_input[WARP_BATCH][WARP_ITERATIONS] = {0.0f}; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < batch_element_count) { + copy_vector(&grad_reg_input[i][it], grad + i * element_count + it * WARP_SIZE); + copy_vector(&output_reg_input[i][it], output + i * element_count + it * WARP_SIZE); + } + + } + } + + // convert half to floating point + acc_t grad_reg[WARP_BATCH][WARP_ITERATIONS]; + acc_t output_reg[WARP_BATCH][WARP_ITERATIONS]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + grad_reg[i][it] = grad_reg_input[i][it]; + output_reg[i][it] = output_reg_input[i][it]; + } + } + + + // compute thread local sum + acc_t sum[WARP_BATCH] = {0}; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += grad_reg[i][it] * output_reg[i][it]; + + } + } + + // reduction sum + constexpr uint32_t FULL_MASK = 0xffffffff; + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + // compute gradients + output_t out[ELEMENTS_PER_LDG_STG]; + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = (output_reg[i][it+element] * (grad_reg[i][it+element] - sum[i])); + } + // store them in global memory + copy_vector(gradInput + i * element_count + it * WARP_SIZE, out); + } + } + } +} + + + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using softmax_backward_func = void(*)(output_t *gradInput, const input_t *grad, const input_t *output, int batch_size, int stride, int element_count); + +template +bool warp_softmax_backward_kernel(int log2_elements, int &warp_size, int &batches_per_warp, softmax_backward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + switch (log2_elements) { + case 0: // 1 + kernel = &softmax_warp_backward; + break; + case 1: // 2 + kernel = &softmax_warp_backward; + break; + case 2: // 4 + kernel = &softmax_warp_backward; + break; + case 3: // 8 + kernel = &softmax_warp_backward; + break; + case 4: // 16 + kernel = &softmax_warp_backward; + break; + case 5: // 32 + kernel = &softmax_warp_backward; + break; + case 6: // 64 + kernel = &softmax_warp_backward; + break; + case 7: // 128 + kernel = &softmax_warp_backward; + break; + case 8: // 256 + kernel = &softmax_warp_backward; + break; + case 9: // 512 + kernel = &softmax_warp_backward; + break; + case 10: // 1024 + kernel = &softmax_warp_backward; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_softmax_backward(output_t *grad_input, const input_t *grad, const input_t *output, int softmax_elements, int softmax_elements_stride, int batch_count) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + softmax_backward_func kernel; + int warp_size, batches_per_warp; + if (!warp_softmax_backward_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + return true; + } + return false; +} + +template +bool dispatch_softmax_backward_stream(output_t *grad_input, const input_t *grad, const input_t *output, int softmax_elements, int softmax_elements_stride, int batch_count, cudaStream_t streamid) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + softmax_backward_func kernel; + int warp_size, batches_per_warp; + if (!warp_softmax_backward_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + // launch + kernel<<>>(grad_input, grad, output, batch_count, softmax_elements_stride, softmax_elements); + return true; + } + return false; +} + +template +__global__ void masked_softmax_warp_backward(__half *gradInput, const __half *grad, const __half *output, const uint8_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride) +{ + int first_batch = (blockDim.y * blockIdx.x + threadIdx.y) * WARP_BATCH; + + // batch_size might not be a multiple of WARP_BATCH. Check how + // many batches have to computed within this WARP. + int local_batches = batch_size - first_batch; + if (local_batches > WARP_BATCH) + local_batches = WARP_BATCH; + + // there might be multiple batches per warp. compute the index within the batch + int local_idx = threadIdx.x; + + // the first element to process by the current thread + int thread_offset = first_batch * stride + ELEMENTS_PER_LDG_STG * local_idx; + grad += thread_offset; + output += thread_offset; + gradInput += thread_offset; + + // load data from global memory + input_t grad_reg_input[WARP_BATCH][WARP_ITERATIONS] = {0.0f}; + input_t output_reg_input[WARP_BATCH][WARP_ITERATIONS] = {0.0f}; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + int batch_element_count = (i >= local_batches) ? 0 : element_count; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < batch_element_count) { + copy_vector(&grad_reg_input[i][it], grad + i * element_count + it * WARP_SIZE); + copy_vector(&output_reg_input[i][it], output + i * element_count + it * WARP_SIZE); + } + + } + } + + // convert half to floating point + acc_t grad_reg[WARP_BATCH][WARP_ITERATIONS]; + acc_t output_reg[WARP_BATCH][WARP_ITERATIONS]; + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + for (int it = 0;it < WARP_ITERATIONS;++it) { + grad_reg[i][it] = grad_reg_input[i][it]; + output_reg[i][it] = output_reg_input[i][it]; + } + } + + + // compute thread local sum + acc_t sum[WARP_BATCH] = {0}; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;++it) { + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += grad_reg[i][it] * output_reg[i][it]; + + } + } + + // reduction sum + constexpr uint32_t FULL_MASK = 0xffffffff; + #pragma unroll + for (int offset = WARP_SIZE / 2; offset > 0; offset /= 2) { + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + sum[i] += __shfl_xor_sync(FULL_MASK, sum[i], offset, WARP_SIZE); + } + } + + // store result + #pragma unroll + for (int i = 0;i < WARP_BATCH;++i) { + if (i >= local_batches) + break; + int pad_thread_offset = ( (first_batch + i) / pad_batch_stride) * stride + ELEMENTS_PER_LDG_STG * local_idx; + const uint8_t* curr_mask = pad_mask + pad_thread_offset; + #pragma unroll + for (int it = 0;it < WARP_ITERATIONS;it += ELEMENTS_PER_LDG_STG) { + int element_index = ELEMENTS_PER_LDG_STG * local_idx + it * WARP_SIZE; + if (element_index < element_count) { + // compute gradients + output_t out[ELEMENTS_PER_LDG_STG]; + for (int element = 0;element < ELEMENTS_PER_LDG_STG;++element) { + out[element] = (output_reg[i][it+element] * (grad_reg[i][it+element] - sum[i])); + } + // store them in global memory + int itr_jmp = it * WARP_SIZE; + int itr_idx = i * element_count + itr_jmp; + // It is kind of unfortunate this has to be here to zero something out that is close to + // zero in the first place + apply_mask(&out[0], 0.0, curr_mask + itr_jmp); + copy_vector(gradInput + itr_idx, out); + } + } + } +} + + + +// WARP_BATCH number of batches. +// WARP_ITERATOINS The number of iterations required for one warp to iterate over all data. +// WARP_SIZE number of elements working on a single batch, has to be a power of two. +// ELEMENTS_PER_LDG_STG has to be 1. +template +using masked_softmax_backward_func = void(*)(output_t *gradInput, const input_t *grad, const input_t *output, const uint8_t *pad_mask, int batch_size, int stride, int element_count, int pad_batch_stride); + +template +bool warp_masked_softmax_backward_kernel(int log2_elements, int &warp_size, int &batches_per_warp, masked_softmax_backward_func &kernel) { + // determine size of a warp + const int next_power_of_two = 1 << log2_elements; + warp_size = (next_power_of_two < 32) ? next_power_of_two : 32; + + // determine how many batches a warp should process. + batches_per_warp = (next_power_of_two <= 128) ? 2 : 1; + + switch (log2_elements) { + case 0: // 1 + kernel = &masked_softmax_warp_backward; + break; + case 1: // 2 + kernel = &masked_softmax_warp_backward; + break; + case 2: // 4 + kernel = &masked_softmax_warp_backward; + break; + case 3: // 8 + kernel = &masked_softmax_warp_backward; + break; + case 4: // 16 + kernel = &masked_softmax_warp_backward; + break; + case 5: // 32 + kernel = &masked_softmax_warp_backward; + break; + case 6: // 64 + kernel = &masked_softmax_warp_backward; + break; + case 7: // 128 + kernel = &masked_softmax_warp_backward; + break; + case 8: // 256 + kernel = &masked_softmax_warp_backward; + break; + case 9: // 512 + kernel = &masked_softmax_warp_backward; + break; + case 10: // 1024 + kernel = &masked_softmax_warp_backward; + break; + default: + return false; + } + return true; +} + +template +bool dispatch_masked_softmax_backward(output_t *grad_input, const input_t *grad, const input_t *output, const uint8_t *pad_mask, int softmax_elements, int softmax_elements_stride, int batch_count, int pad_batch_stride) +{ + if (softmax_elements == 0) { + return true; + } else if (softmax_elements <= 1024) { + // compute function index. there's a function for each power of two size up to 1024. + int log2_elements = 0; + while ((1 << log2_elements) < softmax_elements) ++log2_elements; + + masked_softmax_backward_func kernel; + int warp_size, batches_per_warp; + if (!warp_masked_softmax_backward_kernel(log2_elements, warp_size, batches_per_warp, kernel)) { + return false; + } + + // use 128 threads per block to maximimize gpu utilization + constexpr int threads_per_block = 128; + + // compute warps per block. + int warps_per_block = (threads_per_block / warp_size); + + // compute launch size + int batches_per_block = warps_per_block * batches_per_warp; + int blocks = (batch_count + batches_per_block - 1) / batches_per_block; + dim3 threads(warp_size, warps_per_block, 1); + + // launch + kernel<<>>(grad_input, grad, output, pad_mask, batch_count, softmax_elements_stride, softmax_elements, pad_batch_stride); + return true; + } + return false; +} diff --git a/apex/apex/contrib/csrc/multihead_attn/strided_batched_gemm.h b/apex/apex/contrib/csrc/multihead_attn/strided_batched_gemm.h new file mode 100644 index 0000000000000000000000000000000000000000..af7126b1b63a64aba2ed21e8290d5ea69ab07a1e --- /dev/null +++ b/apex/apex/contrib/csrc/multihead_attn/strided_batched_gemm.h @@ -0,0 +1,407 @@ +#include +#include + +//#include +#include +#include +#include +#include + +#include +#include "THC/THC.h" +#include + +#include "cutlass/cutlass.h" +#include "cutlass/gemm/gemm.h" +#include "cutlass/gemm/wmma_gemm_traits.h" + +// symbol to be automatically resolved by PyTorch libs +extern THCState *state; + +cublasOperation_t convertTransToCublasOperation(char trans) { + if (trans == 't') return CUBLAS_OP_T; + else if (trans == 'n') return CUBLAS_OP_N; + else if (trans == 'c') return CUBLAS_OP_C; + else { + THError("trans must be one of: t, n, c"); + return CUBLAS_OP_T; + } +} + +void CublasStridedBatchedGemm(THCState *state, char transa, char transb, long m, long n, long k, + float alpha, const half *a, long lda, long strideA, const half *b, long ldb, long strideB, + float beta, half *c, long ldc, long strideC, long batchCount, cublasGemmAlgo_t algo=CUBLAS_GEMM_DEFAULT_TENSOR_OP) { + cublasOperation_t opa = convertTransToCublasOperation(transa); + cublasOperation_t opb = convertTransToCublasOperation(transb); + + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + cudaStream_t stream = at::cuda::getCurrentCUDAStream().stream(); + cublasSetStream(handle, stream); + float fAlpha = alpha; + float fBeta = beta; + //THCublasCheck(cublasSetMathMode(handle, CUBLAS_TENSOR_OP_MATH)); + THCublasCheck(cublasGemmStridedBatchedEx(handle, + opa, opb, (int)m, (int)n, (int)k, + (void*)&fAlpha, a, CUDA_R_16F, (int)lda, strideA, + b, CUDA_R_16F, (int)ldb, strideB, + (void*)&fBeta, c, CUDA_R_16F, (int)ldc, strideC, + (int)batchCount, CUDA_R_32F, algo)); + //THCublasCheck(cublasSetMathMode(handle, CUBLAS_DEFAULT_MATH)); +} + +template +void CutlassGemm_FP32Accum(cudaStream_t stream, long m, long n, long k, + float alpha, const half *a, long lda, long strideA, const half *b, long ldb, long strideB, + float beta, half *c, long ldc, long strideC, long batchCount) { + //printf("CUTLASS-> %c%c M: %ld N: %ld K: %ld %d%d%d LDA: %ld LDB: %ld LDC: %ld strideA: %ld strideB: %ld strideC: %ld Alpha: %f Beta: %f\n", ((int)A_LAYOUT == 0 ? 'T' : 'N'), ((int)B_LAYOUT ==0 ? 'T' : 'N'), m, n, k, SRC_A,SRC_B,DST_C, lda, ldb, ldc, strideA, strideB, strideC, alpha, beta); + typedef cutlass::gemm::WmmaGemmTraits< + A_LAYOUT, + B_LAYOUT, + cutlass::Shape<32, 16, 16>, + half, + half, + half, + cutlass::gemm::LinearScaling, + float, + typename cutlass::gemm::WmmaGemmAccumulatorsPerWarp >::Shape, + typename cutlass::Shape<16, 16, 16>, + SRC_A, //kScalarsPerLdgA_ + SRC_B, //kScalarsPerLdgB_ + SRC_A, //KScalarsPerLdsA_ + SRC_B, //KScalarsPerLdsB_ + DST_C, //kScalarsPerLdgCAndStgD_ + DST_C/2, //kScalarsPerStsD_ + DST_C/2 //kScalarsPerLdsD_ + > + WmmaGemmTraits; + + typedef cutlass::gemm::Gemm Gemm; + typename Gemm::Params params; + + + int result = params.initialize( + m, // M dimension for each batch + n, // N dimension for each batch + k, // K dimension for each batch + alpha, // scalar alpha + a, + lda, + strideA, // distance in memory between the first element of neighboring batch + b, + ldb, + strideB, // distance in memory between the first element of neighboring batch + beta, // scalar beta + c, // source matrix C + ldc, + strideC, // distance in memory between the first element of neighboring batch + c, // destination matrix C (may be different memory than source C matrix) + ldc, + strideC, // distance in memory between the first element of neighboring batch + batchCount + ); + + AT_ASSERTM(result == 0, "Failed to initialize CUTLASS Gemm::Params object."); + + // batchCount in cutlass batched GEMM kernels maps to gridDim.z, which is limited to 16 bits. + // To implement batched GEMM with larger batch size, we fragment it into + // smaller batched GEMMs of gridDim.z <= 64k + long batchesLeft = batchCount; + long iterBatchCount = std::min(batchesLeft, static_cast((1 << 16) - 1)); + + do { + //printf("CUTLASS-> %c%c M: %ld N: %ld K: %ld %d%d%d LDA: %ld LDB: %ld LDC: %ld strideA: %ld strideB: %ld strideC: %ld Alpha: %f Beta: %f TotalBatches: %ld iterBatchCount %ld\n", ((int)A_LAYOUT == 0 ? 'T' : 'N'), ((int)B_LAYOUT ==0 ? 'T' : 'N'), m, n, k, SRC_A,SRC_B,DST_C, lda, ldb, ldc, strideA, strideB, strideC, alpha, beta, batchesLeft, iterBatchCount); + int result = params.initialize( + m, // M dimension for each batch + n, // N dimension for each batch + k, // K dimension for each batch + alpha, // scalar alpha + a, + lda, + strideA, // distance in memory between the first element of neighboring batch + b, + ldb, + strideB, // distance in memory between the first element of neighboring batch + beta, // scalar beta + c, // source matrix C + ldc, + strideC, // distance in memory between the first element of neighboring batch + c, // destination matrix C (may be different memory than source C matrix) + ldc, + strideC, // distance in memory between the first element of neighboring batch + iterBatchCount + ); + + AT_ASSERTM(result == 0, "Failed to initialize CUTLASS Gemm::Params object."); + // Launch the CUTLASS GEMM kernel. + THCudaCheck(Gemm::launch(params, stream)); + + // Update batched GEMM params based on completed work + batchesLeft = batchesLeft - iterBatchCount; + a += iterBatchCount * strideA; + b += iterBatchCount * strideB; + c += iterBatchCount * strideC;; + + iterBatchCount = std::min(batchesLeft, static_cast((1 << 16) - 1)); + + } while(batchesLeft > 0); +} + +void gemm_switch_fp32accum(THCState *state, char transa, char transb, long m, long n, long k, + float alpha, const half *a, long lda, long strideA, const half *b, long ldb, long strideB, + float beta, half *c, long ldc, long strideC, long batchCount) { + auto stream = c10::cuda::getCurrentCUDAStream(); + //printf("GEMM -> %c%c M: %i N: %i K: %i Alpha: %f Beta: %f\n", (transa == 't' ? 'T' : 'N'), (transb =='t' ? 'T' : 'N'), m, n, k, alpha, beta); + if ( (transa == 't') && (transb == 'n') ) { + if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x7)) { CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); } + /*if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x7)) { + int m_rem = m % 64; + int n_rem = n % 64; + if ( (m_rem > 48) && ( m <= 192) && (n_rem > 48) && (n <= 192 ) ) { + CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); + } else if ( (m_rem > 32) && ( m > 192) && (n_rem > 32) && (n > 192) ) { + CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); + } else { + CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); + } + }*/ + else if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else { CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + } else if ( (transa == 'n') && (transb == 'n') ) { + if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x7)) { CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); } + /*if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x7)) { + int m_rem = m % 64; + int n_rem = n % 64; + if ( (m_rem > 48) && ( m <= 192) && (n_rem > 48) && (n <= 192 ) ) { + CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); + } else if ( (m_rem > 32) && ( m > 192) && (n_rem > 32) && (n > 192) ) { + CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); + } else { + CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); + } + }*/ + else if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else { CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + } else if ( (transa == 'n') && (transb == 't') ) { + if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x7)) { CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); } + /*if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x7)) { + int m_rem = m % 64; + int n_rem = n % 64; + if ( (m_rem > 48) && ( m <= 192) && (n_rem > 48) && (n <= 192 ) ) { + CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); + } else if ( (m_rem > 32) && ( m > 192) && (n_rem > 32) && (n > 192) ) { + CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount, CUBLAS_GEMM_ALGO0_TENSOR_OP); + } else { + CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); + } + }*/ + else if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x7) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x3) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x7) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x3) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x7)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x3)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else if (!(lda & 0x1) && !(ldb & 0x1) && !(ldc & 0x1)) { CutlassGemm_FP32Accum(stream, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + else { CublasStridedBatchedGemm(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); } + } else { + AT_ASSERTM(false, "TransA and TransB are invalid"); + } +} + +void adjustLdLevel3(char transa, char transb, int64_t m, int64_t n, int64_t k, int64_t *lda, int64_t *ldb, int64_t *ldc) +{ + int transa_ = ((transa == 't') || (transa == 'T')); + int transb_ = ((transb == 't') || (transb == 'T')); + + // Note: leading dimensions generally are checked that they are > 0 and at least as big the result + // requires (even if the value won't be used). + if(n <= 1) + *ldc = std::max(m, 1); + + if(transa_) + { + if(m <= 1) + *lda = std::max(k, 1); + } + else + { + if(k <= 1) + *lda = std::max(m, 1); + } + + if(transb_) + { + if(k <= 1) + *ldb = std::max(n, 1); + } + else + { + if(n <= 1) + *ldb = std::max(k, 1); + } + +} + +void HgemmStridedBatched(THCState *state, char transa, char transb, long m, long n, long k, + float alpha, const half *a, long lda, long strideA, const half *b, long ldb, long strideB, + float beta, half *c, long ldc, long strideC, long batchCount) +{ + if( (m >= INT_MAX) || (n >= INT_MAX) || (k >= INT_MAX) || (lda >= INT_MAX) || (ldb >= INT_MAX) || (ldc >= INT_MAX) || (batchCount >= INT_MAX) ) + + { + THError("Cublas_SgemmStridedBatched only supports m, n, k, lda, ldb, ldc, batchCount" + "with the bound [val] <= %d", INT_MAX); + } + + adjustLdLevel3(transa, transb, m, n, k, &lda, &ldb, &ldc); + + //gemm_switch(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); + gemm_switch_fp32accum(state, transa, transb, m, n, k, alpha, a, lda, strideA, b, ldb, strideB, beta, c, ldc, strideC, batchCount); +} + +/****** +at::Tensor strided_batched_gemm_cuda( + float beta, + at::Tensor in_result, + float alpha, + at::Tensor batch1, + at::Tensor batch2) { + + bool transpose_result; + char transpose_batch1, transpose_batch2; + int64_t lda, ldb, ldc; + at::Tensor result, input1, input2; + if (in_result.stride(1) == 1) + { + transpose_result = false; + result = in_result; + ldc = result.stride(2); + } + else if (in_result.stride(2) == 1) + { + transpose_result = true; + + at::Tensor swap = batch2; + batch2 = batch1; + batch1 = swap; + + result = in_result; + ldc = result.stride(1); + } else { + AT_ASSERTM(false, "result should be contiguous"); + } + + if (batch1.stride(transpose_result ? 2 : 1) == 1 && + batch1.stride(transpose_result ? 1 : 2) != 0) { + transpose_batch1 = 'n'; + input1 = batch1; + lda = input1.stride(transpose_result ? 1 : 2); + } else if (batch1.stride(transpose_result ? 1 : 2) == 1 && + batch1.stride(transpose_result ? 2 : 1) != 0) { + transpose_batch1 = 't'; + input1 = batch1; + lda = input1.stride(transpose_result ? 2 : 1); + } else { + AT_ASSERTM(false, "input1 should be contiguous"); + } + + if (batch2.stride(transpose_result ? 2 : 1) == 1 && + batch2.stride(transpose_result ? 1 : 2) != 0) { + transpose_batch2 = 'n'; + input2 = batch2; + ldb = input2.stride(transpose_result ? 1 : 2); + } else if (batch2.stride(transpose_result ? 1 : 2) == 1 && + batch2.stride(transpose_result ? 2 : 1) != 0) { + transpose_batch2 = 't'; + input2 = batch2; + ldb = input2.stride(transpose_result ? 2 : 1); + } else { + AT_ASSERTM(false, "input2 should be contiguous"); + } + int64_t num_batches = result.size(0); + + HgemmStridedBatched( + state, + transpose_batch1, + transpose_batch2, + result.size(transpose_result ? 2 : 1), + result.size(transpose_result ? 1 : 2), + input1.size(transpose_result ? 1 : 2), + alpha, + static_cast(input1.data_ptr()), lda, input1.stride(0), + static_cast(input2.data_ptr()), ldb, input2.stride(0), + beta, + static_cast(result.data_ptr()), ldc, result.stride(0), + num_batches); + + return in_result; +} + +***/ diff --git a/apex/apex/contrib/csrc/optimizers/fused_adam_cuda.cpp b/apex/apex/contrib/csrc/optimizers/fused_adam_cuda.cpp new file mode 100644 index 0000000000000000000000000000000000000000..c03c90fe31b73425425b7f1b276de8eb5d59d30a --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/fused_adam_cuda.cpp @@ -0,0 +1,86 @@ +#include + +// CUDA forward declaration +void fused_strided_check_finite(at::Tensor & overflow_flag, at::Tensor & p_copy, int stride, int clear_overflow_first); + +void fused_adam_cuda(at::Tensor & p, at::Tensor & p_copy, at::Tensor & m, at::Tensor & v, at::Tensor & g, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay); +void fused_reversible_adam_cuda(at::Tensor & p, at::Tensor & p_copy, at::Tensor & m, at::Tensor & v, at::Tensor & g, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay); +void fused_maybe_adam_undo_cuda(at::Tensor & overflow_flag, at::Tensor & p, at::Tensor & m, at::Tensor & v, at::Tensor & g, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay); + +void fused_adam_cuda_mt(int chunk_size, at::Tensor overflow_flag, std::vector> tensor_lists, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay); + +void maybe_cast_cuda(at::Tensor & overflow_flag, at::Tensor & p_in, at::Tensor & p_out); +void maybe_cast_cuda_mt(int chunk_size, at::Tensor overflow_flag, std::vector> tensor_lists); + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +// C++ interface +void strided_check_finite( + at::Tensor& overflow_flag, + at::Tensor& p_copy, + int stride, + int clear_overflow_first + ) { + CHECK_INPUT(p_copy); + fused_strided_check_finite(overflow_flag, p_copy, stride, clear_overflow_first); +} +void adam(at::Tensor & p, at::Tensor & p_copy, at::Tensor & m, at::Tensor & v, at::Tensor & g, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay) { + CHECK_INPUT(p); + if (p_copy.numel() > 0) CHECK_INPUT(p_copy); + CHECK_INPUT(m); + CHECK_INPUT(v); + CHECK_INPUT(g); + int64_t num_elem = p.numel(); + AT_ASSERTM(m.numel() == num_elem, "number of elements in m and p tensors should be equal"); + AT_ASSERTM(v.numel() == num_elem, "number of elements in v and p tensors should be equal"); + AT_ASSERTM(g.numel() == num_elem, "number of elements in g and p tensors should be equal"); + AT_ASSERTM(p_copy.numel() == num_elem || p_copy.numel() == 0, "number of elements in p_copy and p tensors should be equal, or p_copy should be empty"); + + fused_adam_cuda(p, p_copy, m, v, g, lr, beta1, beta2, eps, grad_scale, step, mode, bias_correction, decay); +} +void reversible_adam(at::Tensor & p, at::Tensor & p_copy, at::Tensor & m, at::Tensor & v, at::Tensor & g, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay) { + CHECK_INPUT(p); + if (p_copy.numel() > 0) CHECK_INPUT(p_copy); + CHECK_INPUT(m); + CHECK_INPUT(v); + CHECK_INPUT(g); + int64_t num_elem = p.numel(); + AT_ASSERTM(m.numel() == num_elem, "number of elements in m and p tensors should be equal"); + AT_ASSERTM(v.numel() == num_elem, "number of elements in v and p tensors should be equal"); + AT_ASSERTM(g.numel() == num_elem, "number of elements in g and p tensors should be equal"); + AT_ASSERTM(p_copy.numel() == num_elem || p_copy.numel() == 0, "number of elements in p_copy and p tensors should be equal, or p_copy should be empty"); + + fused_reversible_adam_cuda(p, p_copy, m, v, g, lr, beta1, beta2, eps, grad_scale, step, mode, bias_correction, decay); +} +void maybe_adam_undo(at::Tensor & overflow_flag, at::Tensor & p, at::Tensor & m, at::Tensor & v, at::Tensor & g, float lr, float beta1, float beta2, float eps, float grad_scale, int step, int mode, int bias_correction, float decay) { + CHECK_INPUT(p); + CHECK_INPUT(m); + CHECK_INPUT(v); + CHECK_INPUT(g); + int64_t num_elem = p.numel(); + AT_ASSERTM(m.numel() == num_elem, "number of elements in m and p tensors should be equal"); + AT_ASSERTM(v.numel() == num_elem, "number of elements in v and p tensors should be equal"); + AT_ASSERTM(g.numel() == num_elem, "number of elements in g and p tensors should be equal"); + + fused_maybe_adam_undo_cuda(overflow_flag, p, m, v, g, lr, beta1, beta2, eps, grad_scale, step, mode, bias_correction, decay); +} +void maybe_cast(at::Tensor & overflow_flag, at::Tensor & p_in, at::Tensor & p_out) { + CHECK_INPUT(p_in); + CHECK_INPUT(p_out); + int64_t num_elem = p_in.numel(); + AT_ASSERTM(p_out.numel() == num_elem, "number of elements in p_in and p_out should be equal"); + + maybe_cast_cuda(overflow_flag, p_in, p_out); +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("strided_check_finite", &strided_check_finite, "Strided finite check."); + m.def("adam", &adam, "Adam optimized CUDA implementation."); + m.def("reversible_adam", &reversible_adam, "Reversible Adam optimized CUDA implementation."); + m.def("adam_mt", &fused_adam_cuda_mt, "Multi tensor Adam optimized CUDA implementation."); + m.def("maybe_adam_undo", &maybe_adam_undo, "Undo function for Adam optimized CUDA implementation."); + m.def("maybe_cast", &maybe_cast, "Unpack byte tensor containing e5m2 floats."); + m.def("maybe_cast_mt", &maybe_cast_cuda_mt, "Unpack byte tensor containing e5m2 floats."); +} diff --git a/apex/apex/contrib/csrc/optimizers/fused_adam_cuda_kernel.cu b/apex/apex/contrib/csrc/optimizers/fused_adam_cuda_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..ac622ac31517467408bec1f7605dcaf83aadbc9c --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/fused_adam_cuda_kernel.cu @@ -0,0 +1,1036 @@ +#include "ATen/ATen.h" +#include "ATen/cuda/CUDAContext.h" +#include "ATen/cuda/detail/IndexUtils.cuh" +#include +#include +#include +#include +#include "ATen/TensorUtils.h" +// #include "ATen/Type.h" +#include "ATen/AccumulateType.h" +#include +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +#include "type_shim.h" + +typedef enum{ + ADAM_MODE_0 =0, // eps under square root + ADAM_MODE_1 =1 // eps outside square root +} adamMode_t; + +template +__global__ void adam_cuda_kernel( + T* __restrict__ p, + GRAD_T* __restrict__ p_copy, // For mixed precision training, pass NULL if not needed + T* __restrict__ m, + T* __restrict__ v, + const GRAD_T * __restrict__ g, + const float b1, + const float b2, + const float eps, + const float grad_scale, + const float step_size, + const size_t tsize, + adamMode_t mode, + const float decay) +{ + //Assuming 2D grids and 2D blocks + const int blockId = gridDim.x * blockIdx.y + blockIdx.x; + const int threadsPerBlock = blockDim.x * blockDim.y; + const int threadIdInBlock = threadIdx.y * blockDim.x + threadIdx.x; + const int i = (blockId * threadsPerBlock + threadIdInBlock); + const int totThreads = gridDim.x*gridDim.y*threadsPerBlock; + + for (int j = i; j < tsize; j+=totThreads) { + T scaled_grad = g[j]/grad_scale; + m[j] = b1*m[j] + (1-b1)*scaled_grad; + v[j] = b2*v[j] + (1-b2)*scaled_grad*scaled_grad; + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(v[j] + eps); + else // Mode 1 + denom = sqrtf(v[j]) + eps; + float update = (m[j]/denom) + (decay*p[j]); + p[j] = p[j] - (step_size*update); + if (p_copy != NULL) p_copy[j] = (GRAD_T) p[j]; + } +} + +template +struct AdamFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata& tl, + const float b1, + const float b2, + const float eps, + const float grad_scale, + const float step_size, + adamMode_t mode, + const float decay) + { + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + T* p = (T *)tl.addresses[0][tensor_loc]; + p += chunk_idx*chunk_size; + T* m = (T *)tl.addresses[1][tensor_loc]; + m += chunk_idx*chunk_size; + T* v = (T *)tl.addresses[2][tensor_loc]; + v += chunk_idx*chunk_size; + GRAD_T* g = (GRAD_T *)tl.addresses[3][tensor_loc]; + g += chunk_idx*chunk_size; + GRAD_T* p_copy = NULL; + if (DEPTH == 5) { + p_copy = (GRAD_T *)tl.addresses[4][tensor_loc]; + p_copy += chunk_idx*chunk_size; + } + + n -= chunk_idx*chunk_size; + + T incoming_p[ILP]; + T incoming_m[ILP]; + T incoming_v[ILP]; + T incoming_g[ILP]; + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && + chunk_size % ILP == 0 && + is_aligned(p) && + is_aligned(m) && + is_aligned(v) && + is_aligned(g) && + is_aligned(p_copy)) + { + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + GRAD_T tmp_g[ILP]; + load_store(incoming_p, p, 0, i_start); + load_store(incoming_m, m, 0, i_start); + load_store(incoming_v, v, 0, i_start); + load_store(tmp_g, g, 0, i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + incoming_g[ii] = static_cast(tmp_g[ii]); + T scaled_grad = incoming_g[ii]/grad_scale; + incoming_m[ii] = b1*incoming_m[ii] + (1-b1)*scaled_grad; + incoming_v[ii] = b2*incoming_v[ii] + (1-b2)*scaled_grad*scaled_grad; + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(incoming_v[ii] + eps); + else // Mode 1 + denom = sqrtf(incoming_v[ii]) + eps; + float update = (incoming_m[ii]/denom) + (decay*incoming_p[ii]); + incoming_p[ii] = incoming_p[ii] - (step_size*update); + if (DEPTH == 5) tmp_g[ii] = static_cast(incoming_p[ii]); + } + load_store(p, incoming_p, i_start, 0); + load_store(m, incoming_m, i_start, 0); + load_store(v, incoming_v, i_start, 0); + if (DEPTH == 5) load_store(p_copy, tmp_g, i_start, 0); + } + } + else + { + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) { + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + incoming_p[ii] = 0; + incoming_m[ii] = 0; + incoming_v[ii] = 0; + incoming_g[ii] = 0; + + int i = i_start + threadIdx.x + ii*blockDim.x; + if (i < n && i < chunk_size) { + incoming_p[ii] = p[i]; + incoming_m[ii] = m[i]; + incoming_v[ii] = v[i]; + incoming_g[ii] = static_cast(g[i]); + } + } + + // note for clarification to future michael: + // From a pure memory dependency perspective, there's likely no point unrolling + // the write loop, since writes just fire off once their LDGs arrive. + // Put another way, the STGs are dependent on the LDGs, but not on each other. + // There is still compute ILP benefit from unrolling the loop though. +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int j = i_start + threadIdx.x + ii*blockDim.x; + + if(j < n && j < chunk_size) { + T scaled_grad = incoming_g[ii]/grad_scale; + m[j] = b1*incoming_m[ii] + (1-b1)*scaled_grad; + v[j] = b2*incoming_v[ii] + (1-b2)*scaled_grad*scaled_grad; + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(v[j] + eps); + else // Mode 1 + denom = sqrtf(v[j]) + eps; + float update = (m[j]/denom) + (decay*incoming_p[ii]); + p[j] = incoming_p[ii] - (step_size*update); + if (DEPTH == 5) p_copy[j] = (GRAD_T) p[j]; + } + } + } + } + } +}; + +void fused_adam_cuda( + at::Tensor & p, + at::Tensor & p_copy, + at::Tensor & m, + at::Tensor & v, + at::Tensor & g, + float lr, + float beta1, + float beta2, + float eps, + float grad_scale, + int step, + int mode, + int bias_correction, + float decay) +{ +// using namespace at; + + //Get tensor size + int tsize = p.numel(); + //Determine #threads and #blocks + const int threadsPerBlock = 512; + const dim3 blocks((tsize+threadsPerBlock-1)/threadsPerBlock); + AT_ASSERTM(at::cuda::detail::canUse32BitIndexMath(p), "parameter tensor is too large to be indexed with int32"); + //Constants + float step_size = 0; + if (bias_correction == 1) { + const float bias_correction1 = 1 - std::pow(beta1, step); + const float bias_correction2 = 1 - std::pow(beta2, step); + step_size = lr * std::sqrt(bias_correction2)/bias_correction1; + } + else { + step_size = lr; + } + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + if (g.scalar_type() == at::ScalarType::Half) { +//all other values should be fp32 for half gradients + AT_ASSERTM(p.scalar_type() == at::ScalarType::Float, "expected parameter to be of float type"); +//dispatch is done on the gradient type + using namespace at; // prevents "toString is undefined" errors + DISPATCH_FLOAT_AND_HALF(g.scalar_type(), 0, "adam_cuda_kernel", + using accscalar_t = at::acc_type; + adam_cuda_kernel<<>>( + p.DATA_PTR(), + p_copy.numel() ? p_copy.DATA_PTR() : NULL, + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } else { + using namespace at; + DISPATCH_DOUBLE_AND_FLOAT(g.scalar_type(), 0, "adam_cuda_kernel", + adam_cuda_kernel<<>>( + p.DATA_PTR(), + NULL, //don't output p_copy for fp32, it's wasted write + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } + THCudaCheck(cudaGetLastError()); + +} + +void fused_adam_cuda_mt( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, // p, m, v, g, p_copy + float lr, + float beta1, + float beta2, + float eps, + float grad_scale, + int step, + int mode, + int bias_correction, + float decay) { + + //Constants + float step_size = 0; + if (bias_correction == 1) { + const float bias_correction1 = 1 - std::pow(beta1, step); + const float bias_correction2 = 1 - std::pow(beta2, step); + step_size = lr * std::sqrt(bias_correction2)/bias_correction1; + } + else { + step_size = lr; + } + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + size_t tl_sz = tensor_lists.size(); + AT_ASSERTM(tl_sz == 4 || tl_sz == 5, "expected tensor lists of size 4 or 5"); + + if (tensor_lists[3][0].scalar_type() == at::ScalarType::Half) { +//alher values should be fp32 for half gradients + AT_ASSERTM(tensor_lists[0][0].scalar_type() == at::ScalarType::Float, "expected parameter to be of float type"); +//dich is done on the gradient type + if (tl_sz == 5) { + DISPATCH_FLOAT_AND_HALF(tensor_lists[3][0].scalar_type(), 0, "adam_cuda_mt_kernel", + using accscalar_t = at::acc_type; + multi_tensor_apply<5>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + AdamFunctor<5, accscalar_t, scalar_t_0>(), + beta1, + beta2, + eps, + grad_scale, + step_size, + (adamMode_t) mode, + decay); + ); + } else { + DISPATCH_FLOAT_AND_HALF(tensor_lists[3][0].scalar_type(), 0, "adam_cuda_mt_kernel", + using accscalar_t = at::acc_type; + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + AdamFunctor<4, accscalar_t, scalar_t_0>(), + beta1, + beta2, + eps, + grad_scale, + step_size, + (adamMode_t) mode, + decay); + ); + } + } else { + if (tl_sz == 5) { + DISPATCH_DOUBLE_AND_FLOAT(tensor_lists[3][0].scalar_type(), 0, "adam_cuda_mt_kernel", + multi_tensor_apply<5>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + AdamFunctor<5, scalar_t_0, scalar_t_0>(), + beta1, + beta2, + eps, + grad_scale, + step_size, + (adamMode_t) mode, + decay); + ); + } else { + DISPATCH_DOUBLE_AND_FLOAT(tensor_lists[3][0].scalar_type(), 0, "adam_cuda_mt_kernel", + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + AdamFunctor<4, scalar_t_0, scalar_t_0>(), + beta1, + beta2, + eps, + grad_scale, + step_size, + (adamMode_t) mode, + decay); + ); + } + } + THCudaCheck(cudaGetLastError()); +} + +template +__device__ void convert(const FROM_T vi, TO_T& vo) +{ + vo = static_cast(vi); +} + +template <> +__device__ void convert(const float vi, uint8_t& vo) +{ + union S + { + float as_float; + int as_int; + }; + S s; + s.as_float = vi; + s.as_int = s.as_int & 0xFF800000; + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_half = static_cast(vi + s.as_float / 8.0f); + vo = t.as_byte[1]; +} + +template <> +__device__ void convert(const uint8_t vi, float& vo) +{ + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_byte[0] = 0; + t.as_byte[1] = vi; + vo = static_cast(t.as_half); +} + +template <> +__device__ void convert(const at::Half vi, uint8_t& vo) +{ + union S + { + float as_float; + int as_int; + }; + S s; + s.as_float = static_cast(vi); + s.as_int = s.as_int & 0xFF800000; + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_half = static_cast(vi + s.as_float / 8.0f); + vo = t.as_byte[1]; +} + +template <> +__device__ void convert(const uint8_t vi, at::Half& vo) +{ + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_byte[0] = 0; + t.as_byte[1] = vi; + vo = t.as_half; +} + +template +__global__ void strided_check_finite_cuda_kernel( + volatile int* noop_gmem, + GRAD_T* __restrict__ p_copy, + const size_t tsize, + int stride, + int clear_overflow_first) +{ + //Assuming 2D grids and 2D blocks + const int blockId = gridDim.x * blockIdx.y + blockIdx.x; + const int threadsPerBlock = blockDim.x * blockDim.y; + const int threadIdInBlock = threadIdx.y * blockDim.x + threadIdx.x; + const int i = (blockId * threadsPerBlock + threadIdInBlock) * stride; + const int totThreads = gridDim.x*gridDim.y*threadsPerBlock*stride; + + if (clear_overflow_first) { + if (i == 0) { + *noop_gmem = 0; + } + __syncthreads(); + } + + for (int j = i; j < tsize; j+=totThreads) { + GRAD_T pi = p_copy[j]; + if (!isfinite(pi)) { + *noop_gmem = 1; + } + } +} +template <> +__global__ void strided_check_finite_cuda_kernel( + volatile int* noop_gmem, + uint8_t* __restrict__ p_copy, + const size_t tsize, + int stride, + int clear_overflow_first) +{ + //Assuming 2D grids and 2D blocks + const int blockId = gridDim.x * blockIdx.y + blockIdx.x; + const int threadsPerBlock = blockDim.x * blockDim.y; + const int threadIdInBlock = threadIdx.y * blockDim.x + threadIdx.x; + const int i = (blockId * threadsPerBlock + threadIdInBlock) * stride; + const int totThreads = gridDim.x*gridDim.y*threadsPerBlock*stride; + + if (clear_overflow_first) { + if (i == 0) { + *noop_gmem = 0; + } + __syncthreads(); + } + + for (int j = i; j < tsize; j+=totThreads) { + at::Half pi; + convert(p_copy[j], pi); + if (!isfinite(pi)) { + *noop_gmem = 1; + } + } +} + +template +__global__ void maybe_cast_kernel( + volatile int* overflow_flag, + const FROM_T* p_in, + TO_T* p_out, + const size_t tsize) +{ + if (overflow_flag && *overflow_flag != 0) return; + + //Assuming 2D grids and 2D blocks + const int blockId = gridDim.x * blockIdx.y + blockIdx.x; + const int threadsPerBlock = blockDim.x * blockDim.y; + const int threadIdInBlock = threadIdx.y * blockDim.x + threadIdx.x; + const int i = (blockId * threadsPerBlock + threadIdInBlock); + const int totThreads = gridDim.x*gridDim.y*threadsPerBlock; + + FROM_T pi[ILP]; + TO_T po[ILP]; + + for(int j_start = 0; j_start < tsize; j_start+=totThreads*ILP) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + pi[ii] = 0; + + int j = j_start + i + totThreads*ii; + if (j < tsize) { + pi[ii] = p_in[j]; + } + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + convert(pi[ii], po[ii]); + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int j = j_start + i + totThreads*ii; + if (j < tsize) { + p_out[j] = po[ii]; + } + } + } +} + +template +__global__ void reversible_adam_cuda_kernel( + T* __restrict__ p, + REDU_T* __restrict__ p_copy, // For mixed precision training, pass NULL if not needed + T* __restrict__ m, + T* __restrict__ v, + const GRAD_T * __restrict__ g, + const float b1, + const float b2, + const float eps, + const float grad_scale, + const float step_size, + const size_t tsize, + adamMode_t mode, + const float decay) +{ + //Assuming 2D grids and 2D blocks + const int blockId = gridDim.x * blockIdx.y + blockIdx.x; + const int threadsPerBlock = blockDim.x * blockDim.y; + const int threadIdInBlock = threadIdx.y * blockDim.x + threadIdx.x; + const int i = (blockId * threadsPerBlock + threadIdInBlock); + const int totThreads = gridDim.x*gridDim.y*threadsPerBlock; + + T mi[ILP]; + T vi[ILP]; + T pi[ILP]; + T gi[ILP]; + + bool overflow = false; + for(int j_start = 0; j_start < tsize; j_start+=totThreads*ILP) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + mi[ii] = T(0); + vi[ii] = T(0); + pi[ii] = T(0); + gi[ii] = GRAD_T(0); + + int j = j_start + i + totThreads*ii; + if (j < tsize) { + pi[ii] = p[j]; + mi[ii] = m[j]; + vi[ii] = v[j]; + gi[ii] = static_cast(g[j]); + } + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + T scaled_grad = gi[ii]/grad_scale; + if (isfinite(scaled_grad)) { + mi[ii] = b1*mi[ii] + (1-b1)*scaled_grad; + vi[ii] = b2*vi[ii] + (1-b2)*scaled_grad*scaled_grad; + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(vi[ii] + eps); + else // Mode 1 + denom = sqrtf(vi[ii]) + eps; + float update = (mi[ii]/denom) + (decay*pi[ii]); + pi[ii] = pi[ii] - (step_size*update); + } else { + overflow = true; + } + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int j = j_start + i + totThreads*ii; + if (j < tsize) { + m[j] = mi[ii]; + v[j] = vi[ii]; + p[j] = pi[ii]; + if (p_copy != NULL) { + convert(pi[ii], p_copy[j]); + } + } + } + } + + if (p_copy != NULL) { + __syncthreads(); + if (overflow) { + convert(float(INFINITY), p_copy[0]); + } + } +} + +template +__global__ void maybe_adam_undo_cuda_kernel( + volatile int* overflow_flag, + T* __restrict__ p, + T* __restrict__ m, + T* __restrict__ v, + const GRAD_T * __restrict__ g, + const float b1, + const float b2, + const float eps, + const float grad_scale, + const float step_size, + const size_t tsize, + adamMode_t mode, + const float decay) +{ + // NB! Skip undo kernel when overflow flag is NOT set + if (overflow_flag && *overflow_flag == 0) return; + + //Assuming 2D grids and 2D blocks + const int blockId = gridDim.x * blockIdx.y + blockIdx.x; + const int threadsPerBlock = blockDim.x * blockDim.y; + const int threadIdInBlock = threadIdx.y * blockDim.x + threadIdx.x; + const int i = (blockId * threadsPerBlock + threadIdInBlock); + const int totThreads = gridDim.x*gridDim.y*threadsPerBlock; + + T mi[ILP]; + T vi[ILP]; + T pi[ILP]; + T gi[ILP]; + + for(int j_start = 0; j_start < tsize; j_start+=totThreads*ILP) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + mi[ii] = T(0); + vi[ii] = T(0); + pi[ii] = T(0); + gi[ii] = GRAD_T(0); + + int j = j_start + i*ILP; + if (j < tsize) { + pi[ii] = p[j]; + mi[ii] = m[j]; + vi[ii] = v[j]; + gi[ii] = static_cast(g[j]); + } + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + T scaled_grad = gi[ii]/grad_scale; + if (isfinite(scaled_grad)) { + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(vi[ii] + eps); + else // Mode 1 + denom = sqrtf(vi[ii]) + eps; + pi[ii] = (pi[ii] + step_size*(mi[ii]/denom)) / (1.0f - step_size*decay); + mi[ii] = (mi[ii] - (1-b1)*scaled_grad) / b1; + vi[ii] = (vi[ii] - (1-b2)*scaled_grad*scaled_grad) / b2; + // Make sure round off errors don't create (small) negative value. + // This can happen if we have to revert the very first step. + vi[ii] = vi[ii] >= 0.0f ? vi[ii] : 0.0f; + } + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int j = j_start + i*ILP; + if (j < tsize) { + m[j] = mi[ii]; + v[j] = vi[ii]; + p[j] = pi[ii]; + } + } + } +} + +template +struct MaybeCastFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* overflow_flag, + TensorListMetadata& tl) + { + if (overflow_flag && *overflow_flag != 0) return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + FROM_T* p_in = (FROM_T *)tl.addresses[0][tensor_loc]; + p_in += chunk_idx*chunk_size; + TO_T* p_out = (TO_T *)tl.addresses[1][tensor_loc]; + p_out += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + int dim = chunk_size < n ? chunk_size : n; + + FROM_T pi[ILP]; + TO_T po[ILP]; + + for(int j_start = 0; j_start < dim; j_start+=blockDim.x*ILP) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + pi[ii] = FROM_T(0); + int j = j_start + threadIdx.x + ii*blockDim.x; + if (j < dim) { + pi[ii] = p_in[j]; + } + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + convert(pi[ii], po[ii]); + } + +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int j = j_start + threadIdx.x + ii*blockDim.x; + if (j < dim) { + p_out[j] = po[ii]; + } + } + } + } +}; + +void fused_strided_check_finite( + at::Tensor & overflow_flag, + at::Tensor & p_copy, + int stride, + int clear_overflow_first) +{ + //Get tensor size + int tsize = p_copy.numel(); + int niter = (tsize + stride - 1) / stride; + + //Determine #threads and #blocks + const int threadsPerBlock = 512; + //In order to avoid race condition, blocks must be 1 when clear_overflow_first flag is set. + const dim3 blocks(clear_overflow_first ? 1 : (niter+threadsPerBlock-1)/threadsPerBlock); + AT_ASSERTM(at::cuda::detail::canUse32BitIndexMath(p_copy), "parameter tensor is too large to be indexed with int32"); + + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + using namespace at; // prevents "toString is undefined" errors + DISPATCH_FLOAT_HALF_AND_BYTE(p_copy.scalar_type(), 0, "check_finite_cuda_kernel", + strided_check_finite_cuda_kernel<<>>( + overflow_flag.DATA_PTR(), + p_copy.DATA_PTR(), + tsize, + stride, + clear_overflow_first); + ); + THCudaCheck(cudaGetLastError()); +} + +void fused_reversible_adam_cuda( + at::Tensor & p, + at::Tensor & p_copy, + at::Tensor & m, + at::Tensor & v, + at::Tensor & g, + float lr, + float beta1, + float beta2, + float eps, + float grad_scale, + int step, + int mode, + int bias_correction, + float decay) +{ +// using namespace at; + + //Get tensor size + int tsize = p.numel(); + //Determine #threads and #blocks + const int threadsPerBlock = 512; + const dim3 blocks((tsize+threadsPerBlock-1)/threadsPerBlock); + AT_ASSERTM(at::cuda::detail::canUse32BitIndexMath(p), "parameter tensor is too large to be indexed with int32"); + //Constants + float step_size = 0; + if (bias_correction == 1) { + const float bias_correction1 = 1 - std::pow(beta1, step); + const float bias_correction2 = 1 - std::pow(beta2, step); + step_size = lr * std::sqrt(bias_correction2)/bias_correction1; + } + else { + step_size = lr; + } + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + if (g.scalar_type() == at::ScalarType::Half) { + //all other values should be fp32 for half gradients + AT_ASSERTM(p.scalar_type() == at::ScalarType::Float, "expected parameter to be of float type"); + //dispatch is done on the gradient type + using namespace at; // prevents "toString is undefined" errors + if (p_copy.numel() == 0 || p_copy.scalar_type() == g.scalar_type()) { + DISPATCH_FLOAT_AND_HALF(g.scalar_type(), 0, "adam_cuda_kernel", + using accscalar_t = at::acc_type; + reversible_adam_cuda_kernel<<>>( + p.DATA_PTR(), + p_copy.numel() ? p_copy.DATA_PTR() : NULL, + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } else { + AT_ASSERTM(p_copy.scalar_type() == at::ScalarType::Byte, "expected parameter to be of byte type"); + DISPATCH_FLOAT_AND_HALF(g.scalar_type(), 0, "adam_cuda_e5m2_kernel", + using accscalar_t = at::acc_type; + reversible_adam_cuda_kernel<<>>( + p.DATA_PTR(), + p_copy.DATA_PTR(), + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } + } else { + using namespace at; + DISPATCH_DOUBLE_AND_FLOAT(g.scalar_type(), 0, "adam_cuda_kernel", + reversible_adam_cuda_kernel<<>>( + p.DATA_PTR(), + NULL, //don't output p_copy for fp32, it's wasted write + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } + THCudaCheck(cudaGetLastError()); +} + +void maybe_cast_cuda( + at::Tensor & overflow_flag, + at::Tensor & p_in, + at::Tensor & p_out) +{ + //Get tensor size + int tsize = p_in.numel(); + AT_ASSERTM(tsize == p_out.numel(), "p_in.numel() must equal p_out.numel()"); + //Determine #threads and #blocks + const int threadsPerBlock = 512; + const dim3 blocks((tsize+threadsPerBlock-1)/threadsPerBlock); + AT_ASSERTM(at::cuda::detail::canUse32BitIndexMath(p_in), "parameter tensor is too large to be indexed with int32"); + //Constants + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + DISPATCH_FLOAT_HALF_AND_BYTE(p_in.scalar_type(), 0, "maybe_cast_cuda" + DISPATCH_FLOAT_HALF_AND_BYTE(p_out.scalar_type(), 1, "maybe_cast_cuda", + maybe_cast_kernel<<>>( + overflow_flag.numel() ? overflow_flag.DATA_PTR() : NULL, + p_in.DATA_PTR(), + p_out.DATA_PTR(), + tsize); )) + THCudaCheck(cudaGetLastError()); +} + +void maybe_cast_cuda_mt( + int chunk_size, + at::Tensor overflow_flag, + std::vector> tensor_lists) // p_in, p_out +{ + //Constants + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + size_t tl_sz = tensor_lists.size(); + AT_ASSERTM(tl_sz == 2, "expected tensor lists of size 2"); + + DISPATCH_FLOAT_HALF_AND_BYTE(tensor_lists[0][0].scalar_type(), 0, "maybe_cast_cuda_mt_kernel", + DISPATCH_FLOAT_HALF_AND_BYTE(tensor_lists[1][0].scalar_type(), 1, "maybe_cast_cuda_mt_kernel", + multi_tensor_apply<2>( + BLOCK_SIZE, + chunk_size, + overflow_flag, + tensor_lists, + MaybeCastFunctor<2, scalar_t_0, scalar_t_1>()); )) + THCudaCheck(cudaGetLastError()); +} + +void fused_maybe_adam_undo_cuda( + at::Tensor & overflow_flag, + at::Tensor & p, + at::Tensor & m, + at::Tensor & v, + at::Tensor & g, + float lr, + float beta1, + float beta2, + float eps, + float grad_scale, + int step, + int mode, + int bias_correction, + float decay) +{ + //Get tensor size + int tsize = p.numel(); + //Determine #threads and #blocks + const int threadsPerBlock = 512; + const dim3 blocks((tsize+threadsPerBlock-1)/threadsPerBlock); + AT_ASSERTM(at::cuda::detail::canUse32BitIndexMath(p), "parameter tensor is too large to be indexed with int32"); + //Constants + float step_size = 0; + if (bias_correction == 1) { + const float bias_correction1 = 1 - std::pow(beta1, step); + const float bias_correction2 = 1 - std::pow(beta2, step); + step_size = lr * std::sqrt(bias_correction2)/bias_correction1; + } + else { + step_size = lr; + } + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + if (g.scalar_type() == at::ScalarType::Half) { + //all other values should be fp32 for half gradients + AT_ASSERTM(p.scalar_type() == at::ScalarType::Float, "expected parameter to be of float type"); + //dispatch is done on the gradient type + using namespace at; // prevents "toString is undefined" errors + DISPATCH_FLOAT_AND_HALF(g.scalar_type(), 0, "adam_cuda_kernel", + using accscalar_t = at::acc_type; + maybe_adam_undo_cuda_kernel<<>>( + overflow_flag.numel() ? overflow_flag.DATA_PTR() : NULL, + p.DATA_PTR(), + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } else { + using namespace at; + DISPATCH_DOUBLE_AND_FLOAT(g.scalar_type(), 0, "adam_cuda_kernel", + maybe_adam_undo_cuda_kernel<<>>( + overflow_flag.numel() ? overflow_flag.DATA_PTR() : NULL, + p.DATA_PTR(), + m.DATA_PTR(), + v.DATA_PTR(), + g.DATA_PTR(), + beta1, + beta2, + eps, + grad_scale, + step_size, + tsize, + (adamMode_t) mode, + decay); + ); + } + THCudaCheck(cudaGetLastError()); +} diff --git a/apex/apex/contrib/csrc/optimizers/fused_lamb_cuda.cpp b/apex/apex/contrib/csrc/optimizers/fused_lamb_cuda.cpp new file mode 100644 index 0000000000000000000000000000000000000000..98a24115ca691272213a227f9c55331dc4ffb354 --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/fused_lamb_cuda.cpp @@ -0,0 +1,21 @@ +#include + +void multi_tensor_lamb_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int bias_correction, + const float weight_decay, + const int grad_averaging, + const int mode, + const float global_grad_norm, + const float max_grad_norm); + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("lamb", &multi_tensor_lamb_cuda, "Computes and apply update for LAMB optimizer"); +} diff --git a/apex/apex/contrib/csrc/optimizers/fused_lamb_cuda_kernel.cu b/apex/apex/contrib/csrc/optimizers/fused_lamb_cuda_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..3bb93b0312d0c63c21ffdf92ea99e19a6352d2c5 --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/fused_lamb_cuda_kernel.cu @@ -0,0 +1,294 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +typedef enum{ + MOMENT_MODE_0 =0, // L2 regularization mode + MOMENT_MODE_1 =1 // Decoupled weight decay mode +} adamMode_t; + +std::tuple multi_tensor_l2norm_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::optional per_tensor_python); + +using MATH_T = float; + +template +struct LAMBStage1Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<4>& tl, + const float beta1, + const float beta2, + const float beta3, + const float beta1_correction, + const float beta2_correction, + const float epsilon, + adamMode_t mode, + const float decay, + const float global_grad_norm, + const float max_global_grad_norm) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + float clipped_global_grad_norm = global_grad_norm > max_global_grad_norm ? global_grad_norm / max_global_grad_norm : 1.0f; + + T* g = (T*)tl.addresses[0][tensor_loc]; + g += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + T* m = (T*)tl.addresses[2][tensor_loc]; + m += chunk_idx*chunk_size; + + T* v = (T*)tl.addresses[3][tensor_loc]; + v += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + // see note in multi_tensor_scale_kernel.cu + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; + MATH_T r_v[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_g[ii] = g[i]; + // special ?optimization? for lamb stage 1 + if (decay == 0) { + r_p[ii] = MATH_T(0); + } + else { + r_p[ii] = p[i]; + } + r_m[ii] = m[i]; + r_v[ii] = v[i]; + } else { + r_g[ii] = MATH_T(0); + r_p[ii] = MATH_T(0); + r_m[ii] = MATH_T(0); + r_v[ii] = MATH_T(0); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if (mode == MOMENT_MODE_0) { + MATH_T scaled_grad = r_g[ii] / clipped_global_grad_norm; + // L2 on scaled grad + scaled_grad = scaled_grad + decay*r_p[ii]; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = next_m_unbiased / denom; + } + else { + MATH_T scaled_grad = r_g[ii] / clipped_global_grad_norm; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = (next_m_unbiased/denom) + (decay*r_p[ii]); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + g[i] = r_p[ii]; + m[i] = r_m[ii]; + v[i] = r_v[ii]; + } + } + } + } +}; + +// Step 2 reads in 'update' value and per-tensor param_norm and update_norm. +// It computes new parameter value. +template +struct LAMBStage2Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<2>& tl, + const float* per_tensor_param_norm, + const float* per_tensor_update_norm, + const float learning_rate, + const float decay) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + MATH_T ratio = learning_rate; + // apply adaptive learning rate to parameters with non-zero weight decay + if (decay != 0.0) + { + float param_norm = per_tensor_param_norm[tensor_num]; + float update_norm = per_tensor_update_norm[tensor_num]; + ratio = (update_norm != 0.0f && param_norm != 0.0f) ? learning_rate * (param_norm / update_norm) : learning_rate; + } + + T* update = (T*)tl.addresses[0][tensor_loc]; + update += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_p[ILP]; + MATH_T r_update[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_p[ii] = p[i]; + r_update[ii] = update[i]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_p[ii] = r_p[ii] - (ratio * r_update[ii]); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + p[i] = r_p[ii]; + } + } + } + } +}; + + +void multi_tensor_lamb_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int bias_correction, + const float weight_decay, + const int grad_averaging, + const int mode, + const float global_grad_norm, + const float max_grad_norm) +{ + using namespace at; + // Master weight and 32bit momentum(potentially changing) is not handled by this + // So we assume every tensor are all in the same type + + // Handle bias correction mode + float bias_correction1 = 1.0f, bias_correction2 = 1.0f; + if (bias_correction == 1) { + bias_correction1 = 1 - std::pow(beta1, step); + bias_correction2 = 1 - std::pow(beta2, step); + } + + // Handle grad averaging mode + float beta3 = 1.0f; + if (grad_averaging == 1) beta3 = 1 - beta1; + + std::vector> grad_list(tensor_lists.begin(), tensor_lists.begin()+1); + std::vector> param_list(tensor_lists.begin()+1, tensor_lists.begin()+2); + + // Compute per tensor param norm + auto param_norm_tuple = multi_tensor_l2norm_cuda(chunk_size, noop_flag, param_list, true); + + // We now in-place modify grad to store update before compute its norm + // Generally this is not a issue since people modify grad in step() method all the time + // We can also grab list of empty tensor to avoid this, but I'd like to save space/cpu code + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "lamb_stage_1", + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + LAMBStage1Functor(), + beta1, + beta2, + beta3, // 1-beta1 or 1 depends on averaging mode + bias_correction1, + bias_correction2, + epsilon, + (adamMode_t) mode, + weight_decay, + global_grad_norm, + max_grad_norm); ) + + // Compute update norms + auto update_norm_tuple = multi_tensor_l2norm_cuda(chunk_size, noop_flag, grad_list, true); + + std::vector> grad_param_list(tensor_lists.begin(), tensor_lists.begin()+2); + + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "lamb_stage_2", + multi_tensor_apply<2>( + BLOCK_SIZE, + chunk_size, + noop_flag, + grad_param_list, + LAMBStage2Functor(), + std::get<1>(param_norm_tuple).DATA_PTR(), + std::get<1>(update_norm_tuple).DATA_PTR(), + lr, + weight_decay); ) + + AT_CUDA_CHECK(cudaGetLastError()); + +} diff --git a/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_adam.cpp b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_adam.cpp new file mode 100644 index 0000000000000000000000000000000000000000..7ae13d5149a5a17b9140544d4f2bfb2bb837a08d --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_adam.cpp @@ -0,0 +1,20 @@ +#include + +void multi_tensor_fused_adam_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_beta1, + at::Tensor per_tensor_beta2, + at::Tensor per_tensor_bias_correction, + at::Tensor per_tensor_eps, + at::Tensor per_tensor_weight_decay, + float lr, + float grad_scale, + int step, + int mode); + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("multi_tensor_fused_adam", &multi_tensor_fused_adam_cuda, + "Multi tensor Adam optimized CUDA implementation."); +} diff --git a/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_adam_kernel.cu b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_adam_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..17e642502b134438cd4fcd81c04c24f3aa75e2eb --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_adam_kernel.cu @@ -0,0 +1,229 @@ +#include +#include +#include +#include +#include +// Another possibility: +// #include + +#include +#include +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +typedef enum{ + ADAM_MODE_0 =0, // eps under square root + ADAM_MODE_1 =1 // eps outside square root +} adamMode_t; + +template +struct DistAdamFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata& tl, + const float* per_tensor_beta1, + const float* per_tensor_beta2, + const int* per_tensor_bias_correction, + const float* per_tensor_eps, + const float* per_tensor_weight_decay, + const float lr, + const float grad_scale, + const int step, + adamMode_t mode) + { + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + float b1 = per_tensor_beta1[tensor_num]; + float b2 = per_tensor_beta2[tensor_num]; + float eps = per_tensor_eps[tensor_num]; + float decay = per_tensor_weight_decay[tensor_num]; + + float beta1_correction = 1.0f, beta2_correction = 1.0f; + if (per_tensor_bias_correction[tensor_num] == 1) { + beta1_correction = 1 - std::pow(b1, step); + beta2_correction = 1 - std::pow(b2, step); + } + + T* p = (T *)tl.addresses[0][tensor_loc]; + p += chunk_idx*chunk_size; + T* m = (T *)tl.addresses[1][tensor_loc]; + m += chunk_idx*chunk_size; + T* v = (T *)tl.addresses[2][tensor_loc]; + v += chunk_idx*chunk_size; + GRAD_T* g = (GRAD_T *)tl.addresses[3][tensor_loc]; + g += chunk_idx*chunk_size; + GRAD_T* p_copy = NULL; + if (DEPTH == 5) { + p_copy = (GRAD_T *)tl.addresses[4][tensor_loc]; + p_copy += chunk_idx*chunk_size; + } + + n -= chunk_idx*chunk_size; + + T incoming_p[ILP]; + T incoming_m[ILP]; + T incoming_v[ILP]; + T incoming_g[ILP]; + + // to make things simple, we put aligned case in a different code path + if (n % ILP == 0 && + chunk_size % ILP == 0 && + is_aligned(p) && + is_aligned(m) && + is_aligned(v) && + is_aligned(g) && + is_aligned(p_copy)) { + for (int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) { + // load + GRAD_T tmp_g[ILP]; + load_store(incoming_p, p, 0, i_start); + load_store(incoming_m, m, 0, i_start); + load_store(incoming_v, v, 0, i_start); + load_store(tmp_g, g, 0, i_start); +#pragma unroll + for (int ii = 0; ii < ILP; ii++) { + incoming_g[ii] = static_cast(tmp_g[ii]); + T scaled_grad = incoming_g[ii]/grad_scale; + incoming_m[ii] = b1*incoming_m[ii] + (1-b1)*scaled_grad; + incoming_v[ii] = b2*incoming_v[ii] + (1-b2)*scaled_grad*scaled_grad; + T next_m_unbiased = incoming_m[ii] / beta1_correction; + T next_v_unbiased = incoming_v[ii] / beta2_correction; + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(next_v_unbiased + eps); + else // Mode 1 + denom = sqrtf(next_v_unbiased) + eps; + float update = (next_m_unbiased / denom) + (decay * incoming_p[ii]); + incoming_p[ii] = incoming_p[ii] - (lr * update); + if (DEPTH == 5) tmp_g[ii] = static_cast(incoming_p[ii]); + } + load_store(p, incoming_p, i_start, 0); + load_store(m, incoming_m, i_start, 0); + load_store(v, incoming_v, i_start, 0); + if (DEPTH == 5) load_store(p_copy, tmp_g, i_start, 0); + } + } else { + for (int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) { + +#pragma unroll + for (int ii = 0; ii < ILP; ii++) { + incoming_p[ii] = 0; + incoming_m[ii] = 0; + incoming_v[ii] = 0; + incoming_g[ii] = 0; + + int i = i_start + threadIdx.x + ii*blockDim.x; + if (i < n && i < chunk_size) { + incoming_p[ii] = p[i]; + incoming_m[ii] = m[i]; + incoming_v[ii] = v[i]; + incoming_g[ii] = static_cast(g[i]); + } + } + +#pragma unroll + for (int ii = 0; ii < ILP; ii++) { + int j = i_start + threadIdx.x + ii*blockDim.x; + + if (j < n && j < chunk_size) { + T scaled_grad = incoming_g[ii]/grad_scale; + m[j] = b1*incoming_m[ii] + (1-b1)*scaled_grad; + v[j] = b2*incoming_v[ii] + (1-b2)*scaled_grad*scaled_grad; + T next_m_unbiased = m[j] / beta1_correction; + T next_v_unbiased = v[j] / beta2_correction; + float denom; + if (mode == ADAM_MODE_0) + denom = sqrtf(next_v_unbiased + eps); + else // Mode 1 + denom = sqrtf(next_v_unbiased) + eps; + float update = (next_m_unbiased / denom) + (decay * incoming_p[ii]); + p[j] = incoming_p[ii] - (lr * update); + if (DEPTH == 5) p_copy[j] = (GRAD_T) p[j]; + } + } + } + } + } +}; + +void multi_tensor_fused_adam_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, // p, m, v, g, p_copy + at::Tensor per_tensor_beta1, + at::Tensor per_tensor_beta2, + at::Tensor per_tensor_bias_correction, + at::Tensor per_tensor_eps, + at::Tensor per_tensor_weight_decay, + float lr, + float grad_scale, + int step, + int mode) +{ + using namespace at; + + size_t tl_sz = tensor_lists.size(); + AT_ASSERTM(tl_sz == 4 || tl_sz == 5, "expected tensor lists of size 4 or 5"); + + if (tl_sz == 5) { + DISPATCH_FLOAT_AND_HALF(tensor_lists[3][0].scalar_type(), 0, "dist_adam_cuda_kernel", // g + using accscalar_t = at::acc_type; + multi_tensor_apply<5>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + DistAdamFunctor<5, accscalar_t, scalar_t_0>(), + per_tensor_beta1.DATA_PTR(), + per_tensor_beta2.DATA_PTR(), + per_tensor_bias_correction.DATA_PTR(), + per_tensor_eps.DATA_PTR(), + per_tensor_weight_decay.DATA_PTR(), + lr, + grad_scale, + step, + (adamMode_t) mode); + ); + } else { + DISPATCH_FLOAT_AND_HALF(tensor_lists[3][0].scalar_type(), 0, "dist_adam_cuda_kernel", // g + using accscalar_t = at::acc_type; + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + DistAdamFunctor<4, accscalar_t, scalar_t_0>(), + per_tensor_beta1.DATA_PTR(), + per_tensor_beta2.DATA_PTR(), + per_tensor_bias_correction.DATA_PTR(), + per_tensor_eps.DATA_PTR(), + per_tensor_weight_decay.DATA_PTR(), + lr, + grad_scale, + step, + (adamMode_t) mode); + ); + } + THCudaCheck(cudaGetLastError()); +} diff --git a/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb.cpp b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb.cpp new file mode 100644 index 0000000000000000000000000000000000000000..584b2a0e7552e5f079ee26ffa9574eec4d872fd4 --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb.cpp @@ -0,0 +1,36 @@ +#include + +void multi_tensor_lamb_compute_update_term_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_beta1, + at::Tensor per_tensor_beta2, + at::Tensor per_tensor_beta3, + at::Tensor per_tensor_bias_correction, + at::Tensor step, + at::Tensor per_tensor_epsilon, + const int mode, + at::Tensor per_tensor_decay, + at::Tensor global_scale, + at::Tensor global_grad_norm, + const float max_grad_norm); + +void multi_tensor_lamb_update_weights_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_param_norm, + at::Tensor per_tensor_update_norm, + at::Tensor update_norm_offset, + at::Tensor learning_rate, + at::Tensor per_tensor_decay, + at::Tensor global_grad_norm, + bool use_nvlamb); + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("multi_tensor_lamb_compute_update_term", &multi_tensor_lamb_compute_update_term_cuda, + "Computes update term for LAMB optimizer"); + m.def("multi_tensor_lamb_update_weights", &multi_tensor_lamb_update_weights_cuda, + "Applies update term for LAMB optimizer"); +} diff --git a/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb_kernel.cu b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..95ee009b2ba1ffe08aa288a80e69f6cf0acff316 --- /dev/null +++ b/apex/apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb_kernel.cu @@ -0,0 +1,506 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +template +__device__ void convert(const FROM_T vi, TO_T& vo) +{ + vo = static_cast(vi); +} + +template <> +__device__ void convert(const float vi, uint8_t& vo) +{ + union S + { + float as_float; + int as_int; + }; + S s; + s.as_float = vi; + s.as_int = s.as_int & 0xFF800000; + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_half = static_cast(vi + s.as_float / 8.0f); + vo = t.as_byte[1]; +} + +template <> +__device__ void convert(const uint8_t vi, float& vo) +{ + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_byte[0] = 0; + t.as_byte[1] = vi; + vo = static_cast(t.as_half); +} + +template <> +__device__ void convert(const at::Half vi, uint8_t& vo) +{ + union S + { + float as_float; + int as_int; + }; + S s; + s.as_float = static_cast(vi); + s.as_int = s.as_int & 0xFF800000; + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_half = static_cast(vi + s.as_float / 8.0f); + vo = t.as_byte[1]; +} + +template <> +__device__ void convert(const uint8_t vi, at::Half& vo) +{ + union T + { + at::Half as_half; + uint8_t as_byte[2]; + }; + T t; + t.as_byte[0] = 0; + t.as_byte[1] = vi; + vo = t.as_half; +} + +typedef enum{ + MOMENT_MODE_0 =0, // L2 regularization mode + MOMENT_MODE_1 =1 // Decoupled weight decay mode +} adamMode_t; + +template +struct DistOptLAMBStage1Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<5>& tl, + const MATH_T* per_tensor_beta1, + const MATH_T* per_tensor_beta2, + const MATH_T* per_tensor_beta3, + const int* per_tensor_bias_correction, + const int* step, + const MATH_T* per_tensor_epsilon, + adamMode_t mode, + const MATH_T* per_tensor_decay, + const MATH_T* global_scale, + const MATH_T* global_grad_norm, + const float max_grad_norm) + { + // I'd like this kernel to propagate infs/nans. + if (*noop_gmem == 1) + return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + float combined_scale = *global_scale; + if (max_grad_norm > 0) { + combined_scale = max_grad_norm / (*global_grad_norm / *global_scale + 1e-6); + combined_scale = *global_scale / std::min((float) 1.0, combined_scale); + } + + MATH_T beta1 = per_tensor_beta1[tensor_num]; + MATH_T beta2 = per_tensor_beta2[tensor_num]; + MATH_T beta3 = 1 - beta1; + MATH_T beta1_correction, beta2_correction; + if (per_tensor_bias_correction[tensor_num] == 1) { + beta1_correction = 1 - pow(beta1, *step); + beta2_correction = 1 - pow(beta2, *step); + } else { + beta1_correction = (MATH_T) 1.0; + beta2_correction = (MATH_T) 1.0; + } + MATH_T epsilon = per_tensor_epsilon[tensor_num]; + MATH_T decay = per_tensor_decay[tensor_num]; + + GRAD_T* g = (GRAD_T*)tl.addresses[0][tensor_loc]; + g += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + T* m = (T*)tl.addresses[2][tensor_loc]; + m += chunk_idx*chunk_size; + + T* v = (T*)tl.addresses[3][tensor_loc]; + v += chunk_idx*chunk_size; + + MATH_T* u = (MATH_T*)tl.addresses[4][tensor_loc]; + u += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; + MATH_T r_v[ILP]; + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && + chunk_size % ILP == 0 && + is_aligned(g) && + is_aligned(p) && + is_aligned(m) && + is_aligned(v)) + { + GRAD_T l_g[ILP]; + T l_p[ILP]; + T l_m[ILP]; + T l_v[ILP]; + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(l_g, g, 0, i_start); + if (decay != 0) + load_store(l_p, p, 0, i_start); + load_store(l_m, m, 0, i_start); + load_store(l_v, v, 0, i_start); + // unpack +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_g[ii] = l_g[ii]; + if (decay == 0) { + r_p[ii] = MATH_T(0); + } + else { + r_p[ii] = l_p[ii]; + } + r_m[ii] = l_m[ii]; + r_v[ii] = l_v[ii]; + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if (mode == MOMENT_MODE_0) { + MATH_T scaled_grad = r_g[ii] / combined_scale; + // L2 on scaled grad + scaled_grad = scaled_grad + decay*r_p[ii]; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = next_m_unbiased / denom; + } + else { + MATH_T scaled_grad = r_g[ii] / combined_scale; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = (next_m_unbiased/denom) + (decay*r_p[ii]); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + l_m[ii] = r_m[ii]; + l_v[ii] = r_v[ii]; + } + // store + load_store(u, r_p, i_start, 0); + load_store(m, l_m, i_start, 0); + load_store(v, l_v, i_start, 0); + } + } + else + { + // see note in multi_tensor_scale_kernel.cu + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; + MATH_T r_v[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_g[ii] = g[i]; + // special ?optimization? for lamb stage 1 + if (decay == 0) { + r_p[ii] = MATH_T(0); + } + else { + r_p[ii] = p[i]; + } + r_m[ii] = m[i]; + r_v[ii] = v[i]; + } else { + r_g[ii] = MATH_T(0); + r_p[ii] = MATH_T(0); + r_m[ii] = MATH_T(0); + r_v[ii] = MATH_T(0); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if (mode == MOMENT_MODE_0) { + MATH_T scaled_grad = r_g[ii] / combined_scale; + // L2 on scaled grad + scaled_grad = scaled_grad + decay*r_p[ii]; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = next_m_unbiased / denom; + } + else { + MATH_T scaled_grad = r_g[ii] / combined_scale; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = (next_m_unbiased/denom) + (decay*r_p[ii]); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + u[i] = r_p[ii]; + m[i] = r_m[ii]; + v[i] = r_v[ii]; + } + } + } + } + } +}; + +// Step 2 reads in 'update' value and per-tensor param_norm and update_norm. +// It computes new parameter value. +template +struct DistOptLAMBStage2Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<3>& tl, + const MATH_T* per_tensor_param_norm, + const MATH_T* per_tensor_update_norm, + const long* update_norm_offset, + const MATH_T* learning_rate, + const MATH_T* per_tensor_decay, + const MATH_T* global_grad_norm, + bool use_nvlamb) + { + // I'd like this kernel to propagate infs/nans. + if (*noop_gmem == 1) + return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + MATH_T decay = per_tensor_decay[tensor_num]; + + MATH_T ratio = *learning_rate; + // nvlamb: apply adaptive learning rate to all parameters + // otherwise, only apply to those with non-zero weight decay + if (use_nvlamb || (decay != (MATH_T) 0.0)) + { + MATH_T param_norm = per_tensor_param_norm[tensor_num]; + MATH_T update_norm = per_tensor_update_norm[update_norm_offset[tensor_num]]; + ratio = (update_norm != 0.0 && param_norm != 0.0) ? (*learning_rate) * (param_norm / update_norm) : (*learning_rate); + } + + MATH_T* update = (MATH_T*)tl.addresses[0][tensor_loc]; + update += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + GRAD_T* p_copy = (GRAD_T*)tl.addresses[2][tensor_loc]; + p_copy += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && + chunk_size % ILP == 0 && + is_aligned(p) && + is_aligned(update)) + { + T r_p[ILP]; + MATH_T r_update[ILP]; + GRAD_T r_p_copy[ILP]; + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(r_p, p, 0, i_start); + load_store(r_update, update, 0, i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_p[ii] = static_cast(r_p[ii]) - (ratio * r_update[ii]); + convert(r_p[ii], r_p_copy[ii]); + } + load_store(p, r_p, i_start, 0); + load_store(p_copy, r_p_copy, i_start, 0); + } + } + else + { + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_p[ILP]; + MATH_T r_update[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_p[ii] = p[i]; + r_update[ii] = update[i]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_p[ii] = r_p[ii] - (ratio * r_update[ii]); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + p[i] = r_p[ii]; + convert(r_p[ii], p_copy[i]); + } + } + } + } + } +}; + +void multi_tensor_lamb_compute_update_term_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_beta1, + at::Tensor per_tensor_beta2, + at::Tensor per_tensor_beta3, + at::Tensor per_tensor_bias_correction, + at::Tensor step, + at::Tensor per_tensor_epsilon, + const int mode, + at::Tensor per_tensor_decay, + at::Tensor global_scale, + at::Tensor global_grad_norm, + const float max_grad_norm) +{ + using namespace at; + + DISPATCH_FLOAT_AND_HALF(tensor_lists[1][0].scalar_type(), 0, "lamb_stage_1", + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 1, "lamb_stage_1", + DISPATCH_FLOAT_AND_HALF(tensor_lists[4][0].scalar_type(), 2, "lamb_stage_1", + multi_tensor_apply<5>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + DistOptLAMBStage1Functor(), + per_tensor_beta1.DATA_PTR(), + per_tensor_beta2.DATA_PTR(), + per_tensor_beta3.DATA_PTR(), + per_tensor_bias_correction.DATA_PTR(), + step.DATA_PTR(), + per_tensor_epsilon.DATA_PTR(), + (adamMode_t) mode, + per_tensor_decay.DATA_PTR(), + global_scale.DATA_PTR(), + global_grad_norm.DATA_PTR(), + max_grad_norm); ))) + + AT_CUDA_CHECK(cudaGetLastError()); +} + +void multi_tensor_lamb_update_weights_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_param_norm, + at::Tensor per_tensor_update_norm, + at::Tensor update_norm_offset, + at::Tensor learning_rate, + at::Tensor per_tensor_decay, + at::Tensor global_grad_norm, + bool use_nvlamb) +{ + using namespace at; + + DISPATCH_FLOAT_AND_HALF(tensor_lists[1][0].scalar_type(), 0, "lamb_stage_2", + DISPATCH_FLOAT_HALF_AND_BYTE(tensor_lists[2][0].scalar_type(), 1, "lamb_stage_2", + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 2, "lamb_stage_2", + multi_tensor_apply<3>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + DistOptLAMBStage2Functor(), + per_tensor_param_norm.DATA_PTR(), + per_tensor_update_norm.DATA_PTR(), + update_norm_offset.DATA_PTR(), + learning_rate.DATA_PTR(), + per_tensor_decay.DATA_PTR(), + global_grad_norm.DATA_PTR(), + use_nvlamb); ))) + + AT_CUDA_CHECK(cudaGetLastError()); +} diff --git a/apex/apex/contrib/csrc/transducer/transducer_joint.cpp b/apex/apex/contrib/csrc/transducer/transducer_joint.cpp new file mode 100755 index 0000000000000000000000000000000000000000..0c0029db663ccaa53acb782b1de69bc15428eb77 --- /dev/null +++ b/apex/apex/contrib/csrc/transducer/transducer_joint.cpp @@ -0,0 +1,84 @@ +#include +#include + +#define CHECK_CUDA(x) TORCH_CHECK(x.is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) TORCH_CHECK(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +torch::Tensor transducer_joint_cuda_forward( + torch::Tensor f, + torch::Tensor g, + torch::Tensor fLen, + torch::Tensor gLen, + torch::Tensor batchOffset, + int64_t packedBatch, + int opt, + bool packOutput, + int tileSize); + + +std::vector transducer_joint_cuda_backward( + torch::Tensor grad, + torch::Tensor fLen, + torch::Tensor gLen, + torch::Tensor batchOffset, + int maxFLen, + int maxGLen, + bool packOutput); + +torch::Tensor transducer_joint_forward( + torch::Tensor f, + torch::Tensor g, + torch::Tensor fLen, + torch::Tensor gLen, + torch::Tensor batchOffset, + int64_t packedBatch, + int opt, + bool packOutput, + int tileSize) { + CHECK_INPUT(f); + CHECK_INPUT(g); + CHECK_INPUT(fLen); + CHECK_INPUT(gLen); + if (packOutput) + CHECK_INPUT(batchOffset); + return transducer_joint_cuda_forward( + f, + g, + fLen, + gLen, + batchOffset, + packedBatch, + opt, + packOutput, + tileSize); +} + +std::vector transducer_joint_backward( + torch::Tensor grad, + torch::Tensor fLen, + torch::Tensor gLen, + torch::Tensor batchOffset, + int maxFLen, + int maxGLen, + bool packOutput) { + CHECK_INPUT(grad); + CHECK_INPUT(fLen); + CHECK_INPUT(gLen); + if (packOutput) + CHECK_INPUT(batchOffset); + return transducer_joint_cuda_backward( + grad, + fLen, + gLen, + batchOffset, + maxFLen, + maxGLen, + packOutput); +} + + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &transducer_joint_forward, "transducer joint forward (CUDA)"); + m.def("backward", &transducer_joint_backward, "transducer joint backward (CUDA)"); +} \ No newline at end of file diff --git a/apex/apex/contrib/csrc/transducer/transducer_joint_kernel.cu b/apex/apex/contrib/csrc/transducer/transducer_joint_kernel.cu new file mode 100755 index 0000000000000000000000000000000000000000..7cb55d55db3c9d113579c4a7cf6c30320570098d --- /dev/null +++ b/apex/apex/contrib/csrc/transducer/transducer_joint_kernel.cu @@ -0,0 +1,745 @@ +#include +#include +#include +#include +#include +#include +#include + +// Warp reduce kernels to reduce N groups of data into N numbers, where N = warpSize / width. +// width should be a power of 2 and should be less than warpSize. +template +__device__ __forceinline__ scalar_t warpReduce(scalar_t x, int width=C10_WARP_SIZE){ + for (unsigned offset = width/2; offset > 0; offset /= 2){ + x += __shfl_down_sync(0xffffffff, x, offset, width); + } + return x; +} + +inline int largestPowerOfTwo(int x){ + int y = 1; + while (y <= x) + y <<= 1; + return y >> 1; +} + +// Helper class to calculate pointer offset that can be shared by different flavors of kernels. +// For fwd, batch offset and stride are different for packing and non-packing mode. +struct OffsetCalFwd{ + __device__ __forceinline__ OffsetCalFwd( + int64_t batch, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t gLen, + int64_t hiddenSize, + bool packOutput) : + batch(batch), + batchOffset(batchOffset), + maxFLen(maxFLen), + maxGLen(maxGLen), + gLen(gLen), + hiddenSize(hiddenSize), + packOutput(packOutput) + {} + + int64_t batch; + const int64_t *batchOffset; + int64_t maxFLen; + int64_t maxGLen; + int64_t gLen; + int64_t hiddenSize; + bool packOutput; + + __device__ __forceinline__ int64_t getBatchOffset(){ + return packOutput ? ((batch==0) ? 0 : batchOffset[batch-1])*hiddenSize + : batch*maxFLen*maxGLen*hiddenSize; + } + + __device__ __forceinline__ int64_t getStrideF(){ + return packOutput ? gLen*hiddenSize : maxGLen*hiddenSize; + } + + +}; + +// Helper class to calculate pointer offset that can be shared by different flavors of kernels +// For bwd, batch offset and stride are different for packing and non-packing mode. +// The reducion is done for two input tensors. Therefore, generating two sets of offsets +// according to bwdFasterDim can lead to a unified implementation in the actual kernel. +struct OffsetCalBwd{ + __device__ __forceinline__ OffsetCalBwd( + int64_t batch, + const int64_t *batchOffset, + const int *fLen, + const int *gLen, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + bool packOutput, + bool bwdFasterDim) : + batch(batch), + batchOffset(batchOffset), + maxFLen(maxFLen), + maxGLen(maxGLen), + fLen(fLen), + gLen(gLen), + hiddenSize(hiddenSize), + packOutput(packOutput), + bwdFasterDim(bwdFasterDim) + {} + + int64_t batch; + const int64_t *batchOffset; + const int *fLen; + const int *gLen; + int64_t maxFLen; + int64_t maxGLen; + int64_t hiddenSize; + bool packOutput; + bool bwdFasterDim; // whether doing bwd on the faster moving dimension + + __device__ __forceinline__ int64_t getBatchOffset(){ + return packOutput ? ((batch==0) ? 0 : batchOffset[batch-1])*hiddenSize + : batch*maxFLen*maxGLen*hiddenSize; + } + + __device__ __forceinline__ int64_t getMaxXLen(){ + return bwdFasterDim ? maxGLen : maxFLen; + } + + __device__ __forceinline__ auto getMyXLen() -> decltype(gLen[batch]){ + return bwdFasterDim ? gLen[batch] : fLen[batch]; + } + + __device__ __forceinline__ auto getMyYLen() -> decltype(gLen[batch]){ + return bwdFasterDim ? fLen[batch] : gLen[batch]; + } + + __device__ __forceinline__ int64_t getStrideX(){ + return bwdFasterDim ? hiddenSize : ((packOutput ? gLen[batch] : maxGLen) * hiddenSize); + } + + __device__ __forceinline__ int64_t getStrideY(){ + return bwdFasterDim ? ((packOutput ? gLen[batch] : maxGLen) * hiddenSize) : hiddenSize; + } +}; + + +// Vanila transducer joint forward kernel +// Detail of this joint function can be found in: +// [1] Sequence Transduction with Recurrent Neural Networks. + +// f is a tensor of shape [batch, T, H] +// g is a tensor of shape [batch, U, H] +// the transducer joint does +// sum = f.unsqueeze(dim=2) + g.unsqueeze(dim=1) +// The resultant tensor is of shape [batch, T, U, H] +// Each thread block is working on one "batch" of data in the output tensor, [batch, t, u, :] + +// This joint function can optionally pack the output where the output tensor with a shape of +// [B, T, U, H] is packed into [B_packed, H]. +// Don't-care region (t > fLen) or (u > gLen) is removed. +// To enable packing, the starting offset for each batch need to be specified with batchOffset. +template +__global__ void transducer_joint_forward( + const scalar_t *f, + const scalar_t *g, + const int *fLen, + const int *gLen, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + bool packOutput, + scalar_t *sum) { + + + const int batch = blockIdx.z; + const int t = blockIdx.y; + const int u = blockIdx.x; + const auto myFLen = fLen[batch]; + const auto myGLen = gLen[batch]; + + OffsetCal offsetCal(batch, batchOffset, maxFLen, maxGLen, myGLen, hiddenSize, packOutput); + const auto myBatchOffset = offsetCal.getBatchOffset(); + const auto strideF = offsetCal.getStrideF(); + scalar_t const *myF = f + batch*maxFLen*hiddenSize + t*hiddenSize; + scalar_t const *myG = g + batch*maxGLen*hiddenSize + u*hiddenSize; + scalar_t *mySum = sum + myBatchOffset + t*strideF + u * hiddenSize; + + if (t < myFLen and u < myGLen){ + #pragma unroll + for (int h = threadIdx.x; h < hiddenSize; h += blockDim.x){ + if (h < hiddenSize){ + mySum[h] = myF[h] + myG[h]; + } + } + } + else if (packOutput == false and t < maxFLen and u < maxGLen){ + // Need to write finite data to don't-care region because we instantiate the result tensor + // with torch::empty for performance reasons. Even though it is don't-care region, the + // contents need to be finite, otherwise could lead to NaN in WGRAD. + // In packing mode, this write is no longer necessary as we remove the don't-care region + // from the output. + // Picking -1 (over 0) here for ease of testing. + #pragma unroll + for (int h = threadIdx.x; h < hiddenSize; h += blockDim.x){ + if (h < hiddenSize){ + mySum[h] = -1; + } + } + } +} + +// Tiled version of the joint forward kernel +// Detail of this joint function can be found in: +// [1] Sequence Transduction with Recurrent Neural Networks. + +// f is a tensor of shape [batch, T, H] +// g is a tensor of shape [batch, U, H] +// the transducer joint does +// sum = f.unsqueeze(dim=2) + g.unsqueeze(dim=1) +// The resultant tensor is of shape [batch, T, U, H] +// Each thread is working on a tile of the shape of tileF x tileG in the result tensor. +// The input for the tile is first loaded in the register and is reused tileG and tileF times. + +// This joint function can optionally pack the output where the output tensor with a shape of +// [B, T, U, H] is packed into [B_packed, H]. +// Don't-care region (t > fLen) or (u > gLen) is removed. +// To enable packing, the starting offset for each batch need to be specified with batchOffset. +template +__global__ void transducer_joint_tiled_forward( + const scalar_t *f, + const scalar_t *g, + const int *fLen, + const int *gLen, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + int64_t hiddenPerBlock, + bool packOutput, + scalar_t *sum) { + + + const int batch = blockIdx.z; + const int t = blockIdx.y * tileF; + const int hiddenBlock = (hiddenSize + hiddenPerBlock - 1) / hiddenPerBlock; + const int u = blockIdx.x / hiddenBlock * tileG; + const int hOffset = (blockIdx.x % hiddenBlock) * hiddenPerBlock; + const int h = threadIdx.x; + const auto myFLen = fLen[batch]; + const auto myGLen = gLen[batch]; + + OffsetCal offsetCal(batch, batchOffset, maxFLen, maxGLen, myGLen, hiddenSize, packOutput); + const auto myBatchOffset = offsetCal.getBatchOffset(); + const auto strideF = offsetCal.getStrideF(); + + scalar_t const *myF = f + batch*maxFLen*hiddenSize + t*hiddenSize + hOffset; + scalar_t const *myG = g + batch*maxGLen*hiddenSize + u*hiddenSize + hOffset; + scalar_t *mySum = sum + myBatchOffset + t*strideF + u*hiddenSize + hOffset; + + if (t < myFLen and u < myGLen and hOffset+h < hiddenSize){ + // register buffers for tiled input reuse + scalar_t fBuffer[tileF], gBuffer[tileG]; + for (int i = 0; i < tileF; ++i){ + if (t + i < myFLen) + fBuffer[i] = myF[i*hiddenSize + h]; + } + for (int j = 0; j < tileG; ++j){ + if (u + j < myGLen) + gBuffer[j] = myG[j*hiddenSize + h]; + } + #pragma unroll + for (int i = 0; i < tileF; ++i){ + if (t + i < myFLen){ + #pragma unroll + for (int j = 0; j < tileG; ++j){ + if (u + j < myGLen) + mySum[i*strideF + j*hiddenSize + h] = fBuffer[i] + gBuffer[j]; + else if (packOutput == false and u + j < maxGLen) + mySum[i*strideF + j*hiddenSize + h] = -1; + } + } + else if (packOutput == false and t + i < maxFLen){ + // Again need to write finite data to don't-care region + #pragma unroll + for (int j = 0; j < tileG; ++j){ + if (u + j < maxGLen) + mySum[i*strideF + j*hiddenSize + h] = -1; + } + } + } + } + else if (packOutput == false and t < maxFLen and u < maxGLen and hOffset+h < hiddenSize){ + // Only need to ensure the finity in normal mode + #pragma unroll + for (int i = 0; i < tileF; ++i){ + if (t + i < maxFLen){ + #pragma unroll + for (int j = 0; j < tileG; ++j){ + if (u + j < maxGLen) + mySum[i*strideF + j*hiddenSize + h] = -1; + } + } + } + } +} + +// Bwd operation (reduction) on one input tensor. Since the operation performed for the two input +// tensors are exactly the same, only one kernel is needed, and the different indexing offsets +// and strides are handled by OffsetCalBwd. + +// When packing is enabled in the fwd op, unpacking is needed to restore the gradients in a +// non-packed form. +template +__device__ void transducer_joint_single_backward( + const scalar_t *grad, + const int *fLen, + const int *gLen, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + bool packOutput, + bool bwdFasterDim, // whether bwd on the faster moving dimension (u) + scalar_t *inGrad, + int yBlockOffset=0) { + + + const int batch = blockIdx.z; + // For the second input tensor, this offset need to be subtracted because the first yBlockOffset + // sets of thread blocks are for the first input tensor. + const int x = blockIdx.y-yBlockOffset; + const int hOffset = blockIdx.x*C10_WARP_SIZE; + const int wid = threadIdx.y; + const int lid = threadIdx.x; + const int numWarp = blockDim.y; + extern __shared__ char smem8[]; + auto smem = reinterpret_cast(smem8); + + OffsetCal offsetCal(batch, batchOffset, fLen, gLen, maxFLen, maxGLen, hiddenSize, packOutput, + bwdFasterDim); + const auto maxXLen = offsetCal.getMaxXLen(); + const auto myXLen = offsetCal.getMyXLen(); + const auto myYLen = offsetCal.getMyYLen(); + scalar_t *myInGrad = inGrad + batch*maxXLen*hiddenSize + x*hiddenSize + hOffset; + + if (x < myXLen){ + + const auto myBatchOffset = offsetCal.getBatchOffset(); + const auto strideX = offsetCal.getStrideX(); + const auto strideY = offsetCal.getStrideY(); + scalar_t const *myGrad = grad + myBatchOffset + x*strideX + hOffset; + + // Each warp reduces numYPerWarp "y" first + acc_t warpSum = 0; + auto numYPerWarp = (myYLen+numWarp-1)/numWarp; + for (int warpY = 0; warpY < numYPerWarp; ++warpY){ + auto y = wid*numYPerWarp + warpY; + if (y < myYLen and (hOffset+lid) < hiddenSize) + warpSum += myGrad[y*strideY + lid]; + } + + // transpose partial sum in SMEM and reduce further using warpReduce + smem[lid*numWarp + wid] = warpSum; + __syncthreads(); + auto sum = smem[wid*C10_WARP_SIZE + lid]; + sum = warpReduce(sum, numWarp); + + // a a b b c c d d + // a a b b c c d d + // a a b b c c d d + // a a b b c c d d + // example of 4 warps (a, b, c, d) with 8 threads per warp + // Each warp need 8 / 4 = 2 threads to write the results. + if (hOffset+wid*C10_WARP_SIZE/numWarp+lid/numWarp < hiddenSize){ + if (lid % numWarp == 0){ + myInGrad[wid*C10_WARP_SIZE/numWarp + lid/numWarp] = sum; + } + } + } + else if (wid == 0 and hOffset + lid < hiddenSize){ + // Need to ensure the grad is zero for don't care region + myInGrad[lid] = 0; + } +} + +// Actual bwd (reduction) kernel get launched. +// Call transducer_joint_single_backward twice on two input tensors. +// The two bwd ops are launched together, the first op uses blockIdx.y < maxFLen, and the second op +// uses the rest. +template +__global__ void transducer_joint_combined_backward( + const scalar_t *grad, + const int *fLen, + const int *gLen, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + bool packOutput, + scalar_t *fGrad, + scalar_t *gGrad) { + if (blockIdx.y < maxFLen){ + transducer_joint_single_backward( + grad, + fLen, + gLen, + batchOffset, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + false, + fGrad); + } + else{ + transducer_joint_single_backward( + grad, + fLen, + gLen, + batchOffset, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + true, + gGrad, + maxFLen); + } +} + +// Vectorized version of transducer_joint_single_backward +// Doing exact same operation as transducer_joint_single_backward except the load and store are +// vectorized. +// When packing is enabled in the fwd op, unpacking is needed to restore the gradients in a +// non-packed form. +template +__device__ void transducer_joint_single_vec_backward( + const scalar_t *grad, + const int *fLen, + const int *gLen, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + bool packOutput, + bool bwdFasterDim, + scalar_t *inGrad, + int yBlockOffset=0){ + + const int batch = blockIdx.z; + const int x = blockIdx.y - yBlockOffset; + const int hOffset = blockIdx.x*C10_WARP_SIZE*V; + const int wid = threadIdx.y; + const int lid = threadIdx.x; + const int numWarp = blockDim.y; + + OffsetCal offsetCal(batch, batchOffset, fLen, gLen, maxFLen, maxGLen, hiddenSize, packOutput, + bwdFasterDim); + const auto maxXLen = offsetCal.getMaxXLen(); + const auto myXLen = offsetCal.getMyXLen(); + const auto myYLen = offsetCal.getMyYLen(); + scalar_t *myInGrad = inGrad + batch*maxXLen*hiddenSize + x*hiddenSize + hOffset; + extern __shared__ char smem8[]; + auto smem = reinterpret_cast(smem8); + + acc_t warpSum[V]; + scalar_t inBuffer[V]; + scalar_t outBuffer[V]; + auto myInGradVec = reinterpret_cast(myInGrad); + auto outBufferVec = reinterpret_cast(outBuffer); + + if (x < myXLen){ + const auto myBatchOffset = offsetCal.getBatchOffset(); + const auto strideX = offsetCal.getStrideX(); + const auto strideY = offsetCal.getStrideY(); + const scalar_t *myGrad = grad + myBatchOffset + x*strideX + hOffset; + + for (int i = 0; i < V; ++i) + warpSum[i] = 0; + + // Each warp reduces numYPerWarp "y" first + auto numYPerWarp = (myYLen+numWarp-1)/numWarp; + for (int warpY = 0; warpY < numYPerWarp; ++warpY){ + auto y = wid*numYPerWarp + warpY; + auto myGradVec = reinterpret_cast(myGrad + y*strideY); + auto inBufferVec = reinterpret_cast(inBuffer); + if (hOffset + lid*V < hiddenSize and y < myYLen){ + *inBufferVec = myGradVec[lid]; // vectorized load + #pragma unroll + for (int i = 0; i < V; ++i){ + warpSum[i] += inBuffer[i]; + } + } + } + + // transpose partial sum in SMEM and reduce further using warpReduce + for (int i = 0; i < V; ++i){ + smem[lid*numWarp + wid] = warpSum[i]; + __syncthreads(); + auto sum = smem[wid*C10_WARP_SIZE + lid]; + + if (hOffset+(wid*C10_WARP_SIZE/numWarp)*V < hiddenSize){ + sum = warpReduce(sum, numWarp); + if (lid % numWarp == 0){ + outBuffer[i] = sum; + } + } + __syncthreads(); + } + + // a a b b c c d d + // a a b b c c d d + // a a b b c c d d + // a a b b c c d d + // example of 4 warps (a, b, c, d) with 8 threads per warp + // Each warp need 8 / 4 = 2 threads to write the results. + if (lid % numWarp == 0 and hOffset+(wid*C10_WARP_SIZE/numWarp + lid/numWarp)*V < hiddenSize) + myInGradVec[wid*C10_WARP_SIZE/numWarp + lid/numWarp] = *outBufferVec; + } + else if (wid == 0 and hOffset + lid*V < hiddenSize){ + // Need to ensure the grad is zero for don't care region + myInGradVec[lid] = 0; + } +} + +// Vecotrized version of transducer_joint_combined_backward +// Call transducer_joint_single_vec_backward twice on two input tensors. +// The two bwd ops are launched together, the first op uses blockIdx.y < maxFLen, and the second op +// uses the rest. +template +__global__ void transducer_joint_combined_vec_backward( + const scalar_t *grad, + const int *fLen, + const int *gLen, + const int64_t *batchOffset, + int64_t maxFLen, + int64_t maxGLen, + int64_t hiddenSize, + bool packOutput, + scalar_t *fGrad, + scalar_t *gGrad) { + if (blockIdx.y < maxFLen){ + transducer_joint_single_vec_backward( + grad, + fLen, + gLen, + batchOffset, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + false, + fGrad); + } + else{ + transducer_joint_single_vec_backward( + grad, + fLen, + gLen, + batchOffset, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + true, + gGrad, + maxFLen); + } +} + + + + +torch::Tensor transducer_joint_cuda_forward( + torch::Tensor f, + torch::Tensor g, + torch::Tensor fLen, + torch::Tensor gLen, + torch::Tensor batchOffset, + int64_t packedBatch, + int opt, + bool packOutput, + int tileSize){ + + + auto tensorOpt = f.options(); + auto dtype = f.scalar_type(); + const auto batchSize = f.size(0); + const auto maxFLen = f.size(1); + const auto maxGLen = g.size(1); + const auto hiddenSize = f.size(2); + + int64_t *batchOffsetPtr = nullptr; + torch::Tensor sum; + if (!packOutput){ + sum = torch::empty({batchSize, maxFLen, maxGLen, hiddenSize}, tensorOpt); + batchOffsetPtr = nullptr; + } + else{ + sum = torch::empty({packedBatch, hiddenSize}, tensorOpt); + batchOffsetPtr = batchOffset.data_ptr(); + } + + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + TORCH_CHECK(opt == 0 or opt == 1, "Got an invalid optimization level ", opt); + // Simple heuristics + const int numThread = std::min(128, (static_cast(hiddenSize)+C10_WARP_SIZE-1) + / C10_WARP_SIZE * C10_WARP_SIZE); + AT_DISPATCH_FLOATING_TYPES_AND_HALF(dtype, "transducer_joint_forward", ([&] { + if (opt == 0){ + // vanilla kernel + const int threads = numThread; + const dim3 blocks(maxGLen, maxFLen, batchSize); + + transducer_joint_forward + <<>>( + f.data_ptr(), + g.data_ptr(), + fLen.data_ptr(), + gLen.data_ptr(), + batchOffsetPtr, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + sum.data_ptr()); + } + if (opt == 1){ + // tiled version. For simplicity, assume tileF == tileG, even though the kernel can + // support more general cases. + const int threads = numThread; + const int hiddenPerBlock = numThread; + const int hiddenBlock = (hiddenSize + hiddenPerBlock - 1) / hiddenPerBlock; + const dim3 blocks( (maxGLen+tileSize-1)/tileSize * hiddenBlock, + (maxFLen+tileSize-1)/tileSize, + batchSize); + + TORCH_CHECK(tileSize == 1 or tileSize == 2 or tileSize == 4, + "Expected tileSize to be in [1, 2, 4], but got ", tileSize); + switch (tileSize) { + #define LAUNCH_TRANSDUCER_JOINT_TILED_FORWARD(tile) case tile:\ + transducer_joint_tiled_forward\ + <<>>(\ + f.data_ptr(),\ + g.data_ptr(),\ + fLen.data_ptr(),\ + gLen.data_ptr(),\ + batchOffsetPtr,\ + maxFLen,\ + maxGLen,\ + hiddenSize,\ + hiddenPerBlock,\ + packOutput,\ + sum.data_ptr());\ + break; + LAUNCH_TRANSDUCER_JOINT_TILED_FORWARD(1); + LAUNCH_TRANSDUCER_JOINT_TILED_FORWARD(2); + LAUNCH_TRANSDUCER_JOINT_TILED_FORWARD(4); + } + + } + })); + THCudaCheck(cudaGetLastError()); + return sum; +} + +std::vector transducer_joint_cuda_backward( + torch::Tensor grad, + torch::Tensor fLen, + torch::Tensor gLen, + torch::Tensor batchOffset, + int maxFLen, + int maxGLen, + bool packOutput){ + + auto tensorOpt = grad.options(); + auto dtype = grad.scalar_type(); + const int batchSize = fLen.size(0); + const int hiddenSize = grad.size(-1); + + const auto deviceProperties = at::cuda::getCurrentDeviceProperties(); + const int maxNumWarp = deviceProperties->maxThreadsPerBlock / C10_WARP_SIZE; + + torch::Tensor fGrad = torch::empty({batchSize, maxFLen, hiddenSize}, tensorOpt); + torch::Tensor gGrad = torch::empty({batchSize, maxGLen, hiddenSize}, tensorOpt); + + int64_t *batchOffsetPtr = (!packOutput) ? nullptr : batchOffset.data_ptr(); + + // The number "y" I would like each thread to work on + const int workPerThread = 32; + // Since the bwd for f and g have the same thread block size, we need to use the max of the two. + int numWarp = largestPowerOfTwo((std::max(maxFLen, maxGLen) + workPerThread-1) / workPerThread); + // Would like to have at least 2 warps + numWarp = std::max(2, numWarp); + // cap on the maximum number of warps allowed + numWarp = std::min(maxNumWarp, numWarp); + + // Need smem for transposing the partial sum. The partial sum is in a matrix of the shape + // numWarp x warpSize + const int smemSize = numWarp * C10_WARP_SIZE; + const dim3 threads(C10_WARP_SIZE, numWarp, 1); + + AT_DISPATCH_FLOATING_TYPES_AND_HALF(dtype, "transducer_joint_cuda_backward_kernel", ([&] { + auto gradPtr = grad.data_ptr(); + auto fLenPtr = fLen.data_ptr(); + auto gLenPtr = gLen.data_ptr(); + auto fGradPtr = fGrad.data_ptr(); + auto gGradPtr = gGrad.data_ptr(); + + // resolve the acc_t type + using acc_t = at::acc_type; + using vec_t = uint64_t; + + constexpr int vectFactor = sizeof(vec_t) / sizeof(scalar_t); + constexpr int vecAlignment = std::alignment_of::value; + + // if all input and output tensors meet the alignment requirement + bool memAlign = (reinterpret_cast(gradPtr) % vecAlignment == 0) + and (reinterpret_cast(fGradPtr) % vecAlignment == 0) + and (reinterpret_cast(gGradPtr) % vecAlignment == 0); + + if (vectFactor > 1 and hiddenSize%vectFactor == 0 and memAlign){ + // If vectorization helps and the alignment requirement is met, use the vectorized + // kernel. For simplicity, hiddenSize needs to be a multiple vecFactor. + const dim3 blocks( (hiddenSize+C10_WARP_SIZE*vectFactor-1)/(C10_WARP_SIZE*vectFactor), + maxFLen+maxGLen, + batchSize); + transducer_joint_combined_vec_backward + + <<>>( + gradPtr, + fLenPtr, + gLenPtr, + batchOffsetPtr, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + fGradPtr, + gGradPtr); + } + else{ + const dim3 blocks((hiddenSize+C10_WARP_SIZE-1)/C10_WARP_SIZE, + maxFLen + maxGLen, batchSize); + transducer_joint_combined_backward + <<>>( + gradPtr, + fLenPtr, + gLenPtr, + batchOffsetPtr, + maxFLen, + maxGLen, + hiddenSize, + packOutput, + fGradPtr, + gGradPtr); + } + })); + + return {fGrad, gGrad}; +} diff --git a/apex/apex/contrib/csrc/transducer/transducer_loss.cpp b/apex/apex/contrib/csrc/transducer/transducer_loss.cpp new file mode 100644 index 0000000000000000000000000000000000000000..f63a67f1e0091dea6d5fc2dd608984dc54514297 --- /dev/null +++ b/apex/apex/contrib/csrc/transducer/transducer_loss.cpp @@ -0,0 +1,109 @@ +#include +#include + +#define CHECK_CUDA(x) TORCH_CHECK(x.is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) TORCH_CHECK(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector transducer_loss_cuda_forward( + torch::Tensor x, + torch::Tensor label, + torch::Tensor audLen, + torch::Tensor txtLen, + torch::Tensor batchOffset, + int maxFLen, + int blankIdx, + int opt, + bool packedInput); + +torch::Tensor transducer_loss_cuda_backward( + torch::Tensor x, + torch::Tensor lossGrad, + torch::Tensor alpha, + torch::Tensor beta, + torch::Tensor audLen, + torch::Tensor txtLen, + torch::Tensor label, + torch::Tensor batchOffset, + int maxFLen, + int blankIdx, + int opt, + bool fuseSoftmaxBackward, + bool packedInput); + + +std::vector transducer_loss_forward( + torch::Tensor x, + torch::Tensor label, + torch::Tensor fLen, + torch::Tensor yLen, + torch::Tensor batchOffset, + int maxFLen, + int blankIdx, + int opt, + bool packedInput + ) { + + CHECK_INPUT(x); + CHECK_INPUT(label); + CHECK_INPUT(fLen); + CHECK_INPUT(yLen); + if (packedInput) + CHECK_INPUT(batchOffset); + return transducer_loss_cuda_forward( + x, + label, + fLen, + yLen, + batchOffset, + maxFLen, + blankIdx, + opt, + packedInput); +} + +torch::Tensor transducer_loss_backward( + torch::Tensor x, + torch::Tensor lossGrad, + torch::Tensor alpha, + torch::Tensor beta, + torch::Tensor fLen, + torch::Tensor yLen, + torch::Tensor label, + torch::Tensor batchOffset, + int maxFLen, + int blankIdx, + int opt, + bool fuseSoftmaxBackward, + bool packedInput){ + + CHECK_INPUT(x); + CHECK_INPUT(label); + CHECK_INPUT(lossGrad); + CHECK_INPUT(alpha); + CHECK_INPUT(beta); + CHECK_INPUT(fLen); + CHECK_INPUT(yLen); + if (packedInput) + CHECK_INPUT(batchOffset); + + return transducer_loss_cuda_backward( + x, + lossGrad, + alpha, + beta, + fLen, + yLen, + label, + batchOffset, + maxFLen, + blankIdx, + opt, + fuseSoftmaxBackward, + packedInput); +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &transducer_loss_forward, "transducer loss forward (CUDA)"); + m.def("backward", &transducer_loss_backward, "transducer loss backward (CUDA)"); +} diff --git a/apex/apex/contrib/csrc/transducer/transducer_loss_kernel.cu b/apex/apex/contrib/csrc/transducer/transducer_loss_kernel.cu new file mode 100755 index 0000000000000000000000000000000000000000..694b2a330c7d9a053b3ab9b0583bda0aca91ed3c --- /dev/null +++ b/apex/apex/contrib/csrc/transducer/transducer_loss_kernel.cu @@ -0,0 +1,637 @@ +#include +#include +#include +#include +#include +#include +#include +#include + +template +__device__ __forceinline__ scalar_t logSumExp(scalar_t a, scalar_t b) { + // standard log-sum-exp trick is used here to provide better numerical stability + return (a >= b) ? a + std::log1p(exp(b-a)) : b + std::log1p(exp(a-b)); +} + +// Vanilla transducer loss function (i.e. forward-backward algorithm) +// Detail of this loss function can be found in: +// [1] Sequence Transduction with Recurrent Neural Networks. + +// Forward (alpha) and backward (beta) path are launched together. Input is assumed to be converted +// into log scale by the preceding log_softmax layer +// Diagonal wavefront advancing usually used in dynamic programming is leveraged here. +// alpha and beta are of acc_t type, as they are essentially accumulators. + +// This loss function supports packed input where a tensor of shape [B, T, U, H] is packed into +// [B_packed, H]. +// Don't-care region (t > audLen) or (u > txtLen) is removed. +// To support the packed input, the starting offsets for each batch need to be specified with +// batchOffset. +template +__global__ void transducer_loss_forward( + const scalar_t* x, + const int* label, + const int* audLen, + const int* txtLen, + const int64_t* batchOffset, + int64_t dictSize, // 64-bit indexing for data tensor + int64_t blankIdx, + int64_t maxFLen, + int64_t maxGLen, + bool packedInput, + acc_t* alpha, + acc_t* beta, + scalar_t* loss) { + + const int batch = blockIdx.y; + const int tid = threadIdx.x; + const auto myFLen = audLen[batch]; + // Note that start of the sentence is added as 1 here + const auto myGLen = txtLen[batch] + 1; + const auto myLabel = label + batch * (maxGLen-1); + const int64_t myBatchOffset = packedInput ? (batch == 0 ? 0 : batchOffset[batch-1]) + : batch * maxFLen * maxGLen; + const int64_t myStrideT = packedInput ? myGLen : maxGLen; + const scalar_t* myX = x + myBatchOffset * dictSize; + int u = tid; + + if (blockIdx.x == 0){ + // alpha path + acc_t* myAlpha = alpha + batch*maxFLen*maxGLen; + if (u == 0) + myAlpha[0] = 0; + __syncthreads(); + + for (int64_t step = 1; step < myFLen+myGLen-1; ++step){ + // Move along the diagonal wavefront to leverage available parallelism + for (u = tid; u < myGLen; u += blockDim.x){ + int64_t t = step - u; + if (t >= 0 and t < myFLen and u >= 0 and u < myGLen){ + // Eq(16) in [1] + if (u == 0){ + // alpha(t, u) = alpha(t-1, u) * null(t-1, u) + myAlpha[t*maxGLen + u] = myAlpha[(t-1)*maxGLen] + + myX[((t-1)*myStrideT) * dictSize + blankIdx]; + } + else if (t == 0){ + // alpha(t, u-1) = alpha(t, u-1) * y(t, u-1) + myAlpha[u] = myAlpha[u - 1] + myX[(u - 1) * dictSize + myLabel[u - 1]]; + } + else{ + // alpha(t, u) = alpha(t-1, u) * null(t-1, u) + alpha(t, u-1) * y(t, u-1) + acc_t current = myAlpha[(t-1)*maxGLen + u] + + myX[((t-1)*myStrideT + u) * dictSize + blankIdx]; + acc_t next = myAlpha[t*maxGLen + u - 1] + + myX[(t*myStrideT + u - 1) * dictSize + myLabel[u - 1]]; + myAlpha[t*maxGLen + u] = logSumExp(next, current); + } + } + } + __syncthreads(); + } + } + else if (blockIdx.x == 1){ + // beta path + acc_t* myBeta = beta + batch*maxFLen*maxGLen; + if (u == 0){ + myBeta[(myFLen-1)*maxGLen + myGLen - 1] = myX[((myFLen-1)*myStrideT + + myGLen - 1) * dictSize + blankIdx]; + } + __syncthreads(); + + for (int64_t step = myFLen+myGLen - 3; step >= 0; --step){ + for (u = tid; u < myGLen; u += blockDim.x){ + int64_t t = step - u; + if (t >= 0 and t < myFLen and u >=0 and u < myGLen){ + // Eq(18) in [1] + if (u == myGLen - 1){ + // beta(t, u) = beta(t+1, u) * null(t, u) + myBeta[t*maxGLen + u] = myBeta[(t+1)*maxGLen + u] + + myX[(t*myStrideT + u) * dictSize + blankIdx]; + } + else if (t == myFLen - 1){ + // beta(t, u) = beta(t, u+1) * y(t, u) + myBeta[t*maxGLen + u] = myBeta[t*maxGLen + u + 1] + + myX[(t*myStrideT + u) * dictSize + myLabel[u]]; + } + else{ + // beta(t, u) = beta(t+1, u)*null(t, u) + beta(t, u+1)*y(t, u) + acc_t current = myBeta[(t+1)*maxGLen + u] + + myX[(t*myStrideT + u) * dictSize + blankIdx]; + acc_t next = myBeta[t*maxGLen + u + 1] + + myX[(t*myStrideT + u) * dictSize + myLabel[u]]; + myBeta[t*maxGLen + u] = logSumExp(next, current); + } + } + } + __syncthreads(); + } + if (tid == 0) + loss[batch] = -myBeta[0]; + } + +} + +// transudcer loss function (i.e. forward-backward algorithm) with batch loading optimization. +// Compared to the vanilla version, there are two optimizations: +// 1. load x in batch through loop unrolling to reduce the latency. +// 2. Use registers and shared memory to hold alpha and beta values passed from one step the next. +// For simplicity, this kernel currently only supports U <= maxThread, which should be the common +// case. For cases where U > maxThread, the vanilla kernel is used as a fallback option. + +// Detail of this loss function can be found in: +// [1] Sequence Transduction with Recurrent Neural Networks. +// Forward (alpha) and backward (beta) path are launched together. Input is assumed to be converted +// into log scale by the preceding log_softmax layer +// Diagonal wavefront advancing usually used in dynamic programming is leveraged here. +// alpha and beta are of acc_t type, as they are essentially accumulators. + +// This loss function supports packed input where a tensor of shape [B, T, U, H] is packed into +// [B_packed, H]. +// Don't-care region (t > audLen) or (u > txtLen) is removed. +// To support the packed input, the starting offsets for each batch need to be specified with +// batchOffset. +template +__global__ void transducer_loss_batch_load_forward( + const scalar_t* x, + const int* label, + const int* audLen, + const int* txtLen, + const int64_t* batchOffset, + int64_t dictSize, + int64_t blankIdx, + int64_t maxFLen, + int64_t maxGLen, + bool packedInput, + acc_t* alpha, + acc_t* beta, + scalar_t* loss) { + + const int batch = blockIdx.y; + int u = threadIdx.x; + const auto myFLen = audLen[batch]; + const auto myGLen = txtLen[batch] + 1; + const int64_t myBatchOffset = packedInput ? (batch == 0 ? 0 : batchOffset[batch-1]) + : batch * maxFLen * maxGLen; + const int64_t myStrideT = packedInput ? myGLen : maxGLen; + const scalar_t* myX = x + myBatchOffset * dictSize; + scalar_t next[batchLdSize], current[batchLdSize]; + extern __shared__ char smem8[]; + auto smem = reinterpret_cast(smem8); + + if (blockIdx.x == 0){ + // alpha path + acc_t* myAlpha = alpha + batch*maxFLen*maxGLen; + // two SMEM regions for double buffering read and write data to avoid data race + acc_t * const sharedAlpha[2] = {smem, smem+maxGLen}; + + sharedAlpha[0][u] = 0; + __syncthreads(); + + if (u == 0) + myAlpha[0] = 0; + + auto myAlphaLabel = (u == 0) ? 0 : label[batch*(maxGLen-1) + u - 1]; + // register used to pass value to the next step for the same thread + acc_t prvStepAlpha = 0; + for (int64_t step = 1; step < myFLen+myGLen-1+batchLdSize; step += batchLdSize){ + // Move along the diagonal wavefront to leverage available parallelism + // Batch loading X through loop unrolling + #pragma unroll + for (int i = 0; i < batchLdSize; ++i){ + if (step+i= 0 and t < myFLen and u >= 0 and u < myGLen){ + if (u == 0){ + current[i] = myX[currentId]; + } + else if (t == 0){ + next[i] = myX[nextId]; + } + else{ + current[i] = myX[currentId]; + next[i] = myX[nextId]; + } + } + } + } + // main computing loop + for (int i = 0; i < batchLdSize; ++i){ + // swap the pointer for double buffering + auto sharedAlphaRd = sharedAlpha[(step+i-1)%2]; + auto sharedAlphaWr = sharedAlpha[(step+i)%2]; + if (step+i= 0 and t < myFLen and u >= 0 and u < myGLen){ + // Eq(16) in [1] + if (u == 0) + prvStepAlpha = prvStepAlpha+current[i]; + else if (t == 0) + prvStepAlpha = sharedAlphaRd[u-1]+next[i]; + else + prvStepAlpha = logSumExp(prvStepAlpha+current[i], sharedAlphaRd[u-1] + + next[i]); + sharedAlphaWr[u] = prvStepAlpha; + myAlpha[t*maxGLen + u] = prvStepAlpha; + } + } + __syncthreads(); + } + } + } + else if (blockIdx.x == 1){ + // beta path + acc_t* myBeta = beta + batch*maxFLen*maxGLen; + // two SMEM regions for double buffering read and write data to avoid data race + acc_t * const sharedBeta[2] = {smem, smem + maxGLen}; + sharedBeta[0][u] = myX[((myFLen-1)*myStrideT + myGLen - 1) * dictSize + blankIdx]; + __syncthreads(); + + auto myBetaLabel = (u == maxGLen - 1) ? 0 : label[batch*(maxGLen-1) + u]; + // register used to pass value to the next step for the same thread + acc_t prvStepBeta = myX[((myFLen-1)*myStrideT + myGLen - 1) * dictSize + blankIdx]; + if (u == 0) + myBeta[(myFLen-1)*maxGLen + myGLen - 1] = prvStepBeta; + + for (int64_t step = 1; step < myFLen+myGLen-1; step += batchLdSize){ + // Move along the diagonal wavefront to leverage available parallelism + // Batch loading X + #pragma unroll + for (int i = 0; i < batchLdSize; ++i){ + if (step+i= 0 and t < myFLen and u >= 0 and u < myGLen){ + if (u == myGLen - 1){ + current[i] = myX[currentId]; + } + else if (t == myFLen - 1){ + next[i] = myX[nextId]; + } + else{ + current[i] = myX[currentId]; + next[i] = myX[nextId]; + } + } + } + } + // main computing loop + for (int i = 0; i < batchLdSize; ++i){ + // swap the pointer for double buffering + auto sharedBetaRd = sharedBeta[(step+i-1)%2]; + auto sharedBetaWr = sharedBeta[(step+i)%2]; + if (step+i= 0 and t < myFLen and u >= 0 and u < myGLen){ + // Eq(18) in [1] + if (u == myGLen - 1) + prvStepBeta = prvStepBeta+current[i]; + else if (t == myFLen - 1) + prvStepBeta = sharedBetaRd[u+1]+next[i]; + else + prvStepBeta = logSumExp(prvStepBeta+current[i], sharedBetaRd[u+1] + + next[i]); + sharedBetaWr[u] = prvStepBeta; + myBeta[t*maxGLen + u] = prvStepBeta; + } + + } + __syncthreads(); + } + } + if (u == 0) + loss[batch] = -prvStepBeta; + } + +} + +// Vanilla transudcer loss backward operation. +// Detail of this loss function can be found in: +// [1] Sequence Transduction with Recurrent Neural Networks. +// For this backward kernel, bwd op for the preceding softmax is assumed to be handled elsewhere, +// hence only Eq(20) in [1] is implemented in this kernel. + +// Each thread block works on [batch, t, :, :] of data. Each thread works on a specific u at a time +// Since only gradients for the correct token and null token need to be updated, gradients at other +// locations are initialized to 0. + +// To support the packed input, the starting offsets for each batch need to be specified with +// batchOffset. +template +__global__ void transducer_loss_backward( + const scalar_t* x, + const scalar_t* lossGrad, + const int* audLen, + const int* txtLen, + const int* label, + const acc_t* alpha, + const acc_t* beta, + const int64_t* batchOffset, + int64_t dictSize, + int64_t blankIdx, + int64_t maxFLen, + int64_t maxGLen, + bool packedInput, + scalar_t* xGrad) { + + const int tid = threadIdx.x; + const int t = blockIdx.x; + const int batch = blockIdx.y; + const int64_t myFLen = audLen[batch]; + const int64_t myGLen = txtLen[batch] + 1; + const int64_t myBatchOffset = packedInput ? (batch == 0 ? 0 : batchOffset[batch-1]) + : batch * maxFLen * maxGLen; + const int64_t myStrideT = packedInput ? myGLen : maxGLen; + auto myX = x + (myBatchOffset + t*myStrideT)*dictSize; + auto myAlpha = alpha + batch*maxFLen*maxGLen; + auto myBeta = beta + batch*maxFLen*maxGLen; + auto myXGrad = xGrad + (myBatchOffset + t*myStrideT)*dictSize; + auto myLabel = label + batch*(maxGLen-1); + + int64_t u = tid; + while (t < myFLen and u < myGLen){ + // Do the update + // loss = -ln(Pr(y*|x)) + acc_t grad = std::log(lossGrad[batch]) + myAlpha[t*maxGLen + u] - myBeta[0]; + if (u != myGLen - 1) + myXGrad[u*dictSize + myLabel[u]] = -std::exp(grad + myBeta[t*maxGLen + u + 1] + + myX[u*dictSize + myLabel[u]]); + if (t == myFLen - 1 and u == myGLen - 1) + myXGrad[u*dictSize + blankIdx] = -std::exp(grad + myX[u*dictSize + blankIdx]); + else if (t != myFLen - 1) + myXGrad[u*dictSize + blankIdx] = -std::exp(grad + myBeta[(t+1)*maxGLen + u] + + myX[u*dictSize + blankIdx]); + + u += blockDim.x; + } +} + +// Fused transudcer loss backward operation. +// Detail of this loss function can be found in: +// [1] Sequence Transduction with Recurrent Neural Networks. +// The bwd op of the preceding softmax layer is fused in this kernel. +// Each thread block works on [batch, t, u, :] of data. Each thread works on a specific h at a time + +// To support the packed input, the starting offsets for each batch need to be specified with +// batchOffset. +template +__global__ void transducer_loss_fused_backward( + const scalar_t* x, + const scalar_t* lossGrad, + const int* audLen, + const int* txtLen, + const int* label, + const acc_t* alpha, + const acc_t* beta, + const int64_t* batchOffset, + int64_t dictSize, + int64_t blankIdx, + int64_t maxFLen, + int64_t maxGLen, + bool packedInput, + scalar_t* xGrad) { + + const int tid = threadIdx.x; + const int u = blockIdx.x; + const int t = blockIdx.y; + const int batch = blockIdx.z; + const int64_t myFLen = audLen[batch]; + const int64_t myGLen = txtLen[batch] + 1; + const int64_t myBatchOffset = packedInput ? (batch == 0 ? 0 : batchOffset[batch-1]) + : batch * maxFLen * maxGLen; + const int64_t myStrideT = packedInput ? myGLen : maxGLen; + + __shared__ acc_t commonFactor, myBetaTU; + auto myXGrad = xGrad + (myBatchOffset + t*myStrideT +u)*dictSize; + + if (t < myFLen and u < myGLen){ + auto myX = x + (myBatchOffset + t*myStrideT +u)*dictSize; + auto myAlpha = alpha + batch*maxFLen*maxGLen; + auto myBeta = beta + batch*maxFLen*maxGLen; + auto myLabel = label + batch*(maxGLen-1); + + // load and store shared variables in SMEM + if (tid == 0){ + commonFactor = std::log(lossGrad[batch]) + myAlpha[t*maxGLen + u] - myBeta[0]; + myBetaTU = myBeta[t*maxGLen + u]; + } + + __syncthreads(); + + for (int64_t h = tid; h < dictSize; h += blockDim.x){ + // Do the update + acc_t grad = commonFactor + myX[h]; // loss = -ln(Pr(y*|x)) + acc_t myGrad = std::exp(grad + myBetaTU); + if (u != myGLen - 1 and h == myLabel[u]){ + myGrad -= std::exp(grad + myBeta[t*maxGLen + u + 1]); + } + else if (h == blankIdx){ + if (t == myFLen - 1 and u == myGLen - 1) + myGrad -= std::exp(grad); + else if (t != myFLen - 1) + myGrad -= std::exp(grad + myBeta[(t+1)*maxGLen + u]); + } + myXGrad[h] = myGrad; + } + } + else if (!packedInput){ + // In non-pack mode, need to make sure the gradients for don't-care regions are zero. + for (int64_t h = tid; h < dictSize; h += blockDim.x){ + myXGrad[h] = 0; + } + } +} + + + +std::vector transducer_loss_cuda_forward( + torch::Tensor x, + torch::Tensor label, + torch::Tensor audLen, + torch::Tensor txtLen, + torch::Tensor batchOffset, + int maxFLen, + int blankIdx, + int opt, + bool packedInput){ + + auto scalarType = x.scalar_type(); + auto tensorOpt = x.options(); + const int batchSize = label.size(0); + const int maxGLen = label.size(1) + 1; + const int dictSize = x.size(-1); + + TORCH_CHECK(blankIdx >= 0 and blankIdx < dictSize, + "Expected blank index to be in the range of 0 to ", + dictSize-1, + ", but got ", + blankIdx); + TORCH_CHECK(opt == -1 or opt == 0 or opt == 1, + "Got an invalid optimization level ", + opt); + + // The data type of alpha and beta will be resolved at dispatch time, + // hence defined here and assigned later + torch::Tensor alpha; + torch::Tensor beta; + torch::Tensor loss = torch::empty({batchSize}, tensorOpt); + const auto deviceProperties = at::cuda::getCurrentDeviceProperties(); + const auto maxThreadPerBlock = deviceProperties->maxThreadsPerBlock; + const auto maxSmemPerBlock = deviceProperties->sharedMemPerBlock; + const auto batchOffsetPtr = packedInput ? batchOffset.data_ptr() : nullptr; + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + AT_DISPATCH_FLOATING_TYPES_AND_HALF(scalarType, "transducer_loss_cuda_forward", ([&] { + // resolve accumulation type + using acc_t = at::acc_type; + auto accType = c10::CppTypeToScalarType::value; + auto accTensorOpt = tensorOpt.dtype(accType); + alpha = torch::empty({batchSize, maxFLen, maxGLen}, accTensorOpt); + beta = torch::empty({batchSize, maxFLen, maxGLen}, accTensorOpt); + + // decide what kernel to launch based on the problem size + // if the required SMEM size or number threads exceeds the limit, fall back to the vanilla + // kernel. + const auto smemSize = 2*maxGLen*sizeof(acc_t); + const auto optFallBack = (maxGLen > maxThreadPerBlock or smemSize > maxSmemPerBlock) ? 0 + : (opt == -1) ? 1 : opt; + const int threads = std::min(maxThreadPerBlock, maxGLen); + const dim3 blocks(2, batchSize, 1); + + if (optFallBack == 0) + transducer_loss_forward<<>>( + x.data_ptr(), + label.data_ptr(), + audLen.data_ptr(), + txtLen.data_ptr(), + batchOffsetPtr, + dictSize, + blankIdx, + maxFLen, + maxGLen, + packedInput, + alpha.data_ptr(), + beta.data_ptr(), + loss.data_ptr()); + else if (optFallBack == 1) + transducer_loss_batch_load_forward + <<>>( + x.data_ptr(), + label.data_ptr(), + audLen.data_ptr(), + txtLen.data_ptr(), + batchOffsetPtr, + dictSize, + blankIdx, + maxFLen, + maxGLen, + packedInput, + alpha.data_ptr(), + beta.data_ptr(), + loss.data_ptr()); + + })); + THCudaCheck(cudaGetLastError()); + + return {alpha, beta, loss}; +} + + + + +torch::Tensor transducer_loss_cuda_backward( + torch::Tensor x, + torch::Tensor lossGrad, + torch::Tensor alpha, + torch::Tensor beta, + torch::Tensor audLen, + torch::Tensor txtLen, + torch::Tensor label, + torch::Tensor batchOffset, + int maxFLen, + int blankIdx, + int opt, + bool fuseSoftmaxBackward, + bool packedInput){ + + auto dtype = x.scalar_type(); + torch::Tensor xGrad; + const int batchSize = label.size(0); + const int maxGLen = label.size(1) + 1; + const int dictSize = x.size(-1); + const auto deviceProperties = at::cuda::getCurrentDeviceProperties(); + const int maxThreadPerBlock = deviceProperties->maxThreadsPerBlock; + const int warpSize = deviceProperties->warpSize; + const auto batchOffsetPtr = packedInput ? batchOffset.data_ptr() : nullptr; + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + + if (fuseSoftmaxBackward){ + // alloc empty tensors for performance, hence need to ensure zeros are writtern to + // don't-care region in the kernel. + xGrad = torch::empty_like(x); + + // Would like each thread to work on 4 hidden units + const int workPerThread = 4; + // Don't want to have more than 128 threads per thread block + const int maxThreadPerElmt = std::min(128, maxThreadPerBlock); + const int threads = std::min(maxThreadPerElmt, std::max(warpSize, + (dictSize+workPerThread-1)/workPerThread)); + const dim3 blocks(maxGLen, maxFLen, batchSize); + + AT_DISPATCH_FLOATING_TYPES_AND_HALF(dtype, "transducer_loss_cuda_backward", ([&] { + using acc_t = at::acc_type; + transducer_loss_fused_backward<<>>( + x.data_ptr(), + lossGrad.data_ptr(), + audLen.data_ptr(), + txtLen.data_ptr(), + label.data_ptr(), + alpha.data_ptr(), + beta.data_ptr(), + batchOffsetPtr, + dictSize, + blankIdx, + maxFLen, + maxGLen, + packedInput, + xGrad.data_ptr()); + + })); + } + else{ + // for non-fused kernel, the gradients need to be writtern are very sparse, hence initialize + // the tensor with all zeros. + xGrad = torch::zeros_like(x); + // don't launch more threads than needed. + const int threads = std::min(maxThreadPerBlock, maxGLen); + const dim3 blocks(maxFLen, batchSize); + AT_DISPATCH_FLOATING_TYPES_AND_HALF(dtype, "transducer_loss_cuda_backward", ([&] { + using acc_t = at::acc_type; + transducer_loss_backward<<>>( + x.data_ptr(), + lossGrad.data_ptr(), + audLen.data_ptr(), + txtLen.data_ptr(), + label.data_ptr(), + alpha.data_ptr(), + beta.data_ptr(), + batchOffsetPtr, + dictSize, + blankIdx, + maxFLen, + maxGLen, + packedInput, + xGrad.data_ptr()); + })); + } + THCudaCheck(cudaGetLastError()); + + return xGrad; +} diff --git a/apex/apex/contrib/csrc/xentropy/interface.cpp b/apex/apex/contrib/csrc/xentropy/interface.cpp new file mode 100644 index 0000000000000000000000000000000000000000..3a8c201ca9f25c6f41e24e702e4bb3029f62a365 --- /dev/null +++ b/apex/apex/contrib/csrc/xentropy/interface.cpp @@ -0,0 +1,52 @@ +#include + +// CUDA forward declarations + +std::vector softmax_xentropy_cuda( + const at::Tensor &input, + const at::Tensor &labels, + const float smoothing, + const bool half_to_float); + +at::Tensor softmax_xentropy_backward_cuda( + const at::Tensor &grad_loss, + const at::Tensor &logits, + const at::Tensor &max_log_sum_exp, + const at::Tensor &labels, + const float smoothing); + +// C++ interface + +#define CHECK_CUDA(x) AT_ASSERTM(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) AT_ASSERTM(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector softmax_xentropy_forward( + const at::Tensor &input, + const at::Tensor &labels, + const float smoothing, + const bool half_to_float) { + CHECK_CUDA(input); + CHECK_INPUT(labels); + + return softmax_xentropy_cuda(input, labels, smoothing, half_to_float); +} + +at::Tensor softmax_xentropy_backward( + const at::Tensor &grad_loss, + const at::Tensor &logits, + const at::Tensor &max_log_sum_exp, + const at::Tensor &labels, + const float smoothing) { + CHECK_CUDA(grad_loss); + CHECK_CUDA(logits); + CHECK_INPUT(max_log_sum_exp); + CHECK_INPUT(labels); + + return softmax_xentropy_backward_cuda(grad_loss, logits, max_log_sum_exp, labels, smoothing); +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &softmax_xentropy_forward, "Softmax cross entropy loss with label smoothing forward (CUDA)"); + m.def("backward", &softmax_xentropy_backward, "Softmax cross entropy loss with label smoothing backward (CUDA)"); +} diff --git a/apex/apex/contrib/csrc/xentropy/xentropy_kernel.cu b/apex/apex/contrib/csrc/xentropy/xentropy_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..0f42cf5955ed2a0923b899af0bb13fd87561134a --- /dev/null +++ b/apex/apex/contrib/csrc/xentropy/xentropy_kernel.cu @@ -0,0 +1,722 @@ +/** + * From PyTorch: + * + * Copyright (c) 2016- Facebook, Inc (Adam Paszke) + * Copyright (c) 2014- Facebook, Inc (Soumith Chintala) + * Copyright (c) 2011-2014 Idiap Research Institute (Ronan Collobert) + * Copyright (c) 2012-2014 Deepmind Technologies (Koray Kavukcuoglu) + * Copyright (c) 2011-2012 NEC Laboratories America (Koray Kavukcuoglu) + * Copyright (c) 2011-2013 NYU (Clement Farabet) + * Copyright (c) 2006-2010 NEC Laboratories America (Ronan Collobert, Leon Bottou, Iain Melvin, Jason Weston) + * Copyright (c) 2006 Idiap Research Institute (Samy Bengio) + * Copyright (c) 2001-2004 Idiap Research Institute (Ronan Collobert, Samy Bengio, Johnny Mariethoz) + * + * From Caffe2: + * + * Copyright (c) 2016-present, Facebook Inc. All rights reserved. + * + * All contributions by Facebook: + * Copyright (c) 2016 Facebook Inc. + * + * All contributions by Google: + * Copyright (c) 2015 Google Inc. + * All rights reserved. + * + * All contributions by Yangqing Jia: + * Copyright (c) 2015 Yangqing Jia + * All rights reserved. + * + * All contributions from Caffe: + * Copyright(c) 2013, 2014, 2015, the respective contributors + * All rights reserved. + * + * All other contributions: + * Copyright(c) 2015, 2016 the respective contributors + * All rights reserved. + * + * Caffe2 uses a copyright model similar to Caffe: each contributor holds + * copyright over their contributions to Caffe2. The project versioning records + * all such contribution and copyright details. If a contributor wants to further + * mark their specific copyright on a particular contribution, they should + * indicate their copyright solely in the commit message of the change when it is + * committed. + * + * All rights reserved. + * + * 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 names of Facebook, Deepmind Technologies, NYU, NEC Laboratories America + * and IDIAP Research Institute 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 OWNER 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. + */ +#include +#include + +#include +#include + +#include +#include +#include + +#include "type_shim.h" +#include "compat.h" + +#define ALIGN_BYTES 16 + +using Tensor = at::Tensor; +using TensorList = at::TensorList; +using ScalarType = at::ScalarType; +using at::acc_type; + +template +struct LogSoftMaxForwardEpilogue { + __device__ __forceinline__ LogSoftMaxForwardEpilogue(AccumT max_input, AccumT sum) + : logsum(max_input + std::log(sum)) {} + + __device__ __forceinline__ LogSoftMaxForwardEpilogue(AccumT max_log_sum_exp) + : logsum(max_log_sum_exp) {} + + __device__ __forceinline__ OutT operator()(T input) const { + return static_cast(input - logsum); + } + + const AccumT logsum; +}; + +template +struct LogSoftMaxBackwardEpilogue { + __device__ __forceinline__ LogSoftMaxBackwardEpilogue(AccumT sum) + : sum(sum) {} + + __device__ __forceinline__ T operator()(OutT gradOutput, OutT output) const { + return static_cast(gradOutput - std::exp(static_cast(output)) * sum); + } + + const AccumT sum; +}; + + + +const int max_threads = 1024; + +inline dim3 SoftMax_getBlockSize(int ILP, uint64_t dim_size) { + uint64_t block_size = 1; + uint64_t max_block_size = std::min(dim_size / ILP, static_cast(max_threads)); + while (block_size < (max_block_size/2)) block_size *= 2; + // Launch at least a single warp - the kernel assumes that. + block_size = std::max(block_size, static_cast(32)); + return dim3(block_size); +} + +template +struct Add { + __device__ __forceinline__ T operator()(T a, T b) const { + return a + b; + } +}; + +template +struct Max { + __device__ __forceinline__ T operator()(T a, T b) const { + return a < b ? b : a; + } +}; + + +//////////////////////////////////////////////////////////////////////////////// +// Regular kernel (fast when dim_size is large; requires inner_size == 1) +//////////////////////////////////////////////////////////////////////////////// + + +template +struct MaxFloat +{ + __device__ __forceinline__ AccumT operator()(AccumT max, T v) const { + return ::max(max, (AccumT)v); + } +}; + +template +struct AddFloat +{ + __device__ __forceinline__ AccumT operator()(AccumT sum, T v) const { + return sum + v; + } +}; + +template +struct SumExpFloat +{ + __device__ __forceinline__ SumExpFloat(AccumT v) + : max_k(v) {} + + __device__ __forceinline__ AccumT operator()(AccumT sum, T v) const { + return sum + std::exp(v - max_k); + } + + const AccumT max_k; +}; + +template class Reduction, typename AccumT> +__device__ __forceinline__ AccumT +blockReduce(AccumT* smem, AccumT val, + const Reduction& r, + AccumT defaultVal) +{ + // To avoid RaW races from chaining blockReduce calls together, we need a sync here + __syncthreads(); + + smem[threadIdx.x] = val; + + __syncthreads(); + + AccumT warpVal = defaultVal; + + // First warp will perform per-warp reductions for the remaining warps + uint32_t mask = (((uint64_t)1) << (blockDim.x / 32)) - 1; + if (threadIdx.x < 32) { + int lane = threadIdx.x % 32; + if (lane < blockDim.x / 32) { +#pragma unroll + for (int i = 0; i < 32; ++i) { + warpVal = r(warpVal, smem[lane * 32 + i]); + } + __syncwarp(mask); + smem[lane] = warpVal; + } + } + + __syncthreads(); + + // First thread will perform a reduction of the above per-warp reductions + AccumT blockVal = defaultVal; + + if (threadIdx.x == 0) { + for (int i = 0; i < blockDim.x / 32; ++i) { + blockVal = r(blockVal, smem[i]); + } + smem[0] = blockVal; + } + + // Sync and broadcast + __syncthreads(); + return smem[0]; +} + +template class Reduction1, template class Reduction2, typename AccumT> +__device__ __forceinline__ void +blockReduce(AccumT* smem, + AccumT* reducVal1, + AccumT val1, + const Reduction1& r1, + AccumT defaultVal1, + AccumT* reducVal2, + AccumT val2, + const Reduction2& r2, + AccumT defaultVal2) +{ + // To avoid RaW races from chaining blockReduce calls together, we need a sync here + __syncthreads(); + + smem[threadIdx.x] = val1; + smem[blockDim.x + threadIdx.x] = val2; + + __syncthreads(); + + AccumT warpVal1 = defaultVal1; + AccumT warpVal2 = defaultVal2; + + // First warp will perform per-warp reductions for the remaining warps + uint32_t mask = (((uint64_t)1) << (blockDim.x / 32)) - 1; + if (threadIdx.x < 32) { + int lane = threadIdx.x % 32; + if (lane < blockDim.x / 32) { +#pragma unroll + for (int i = 0; i < 32; ++i) { + warpVal1 = r1(warpVal1, smem[lane * 32 + i]); + warpVal2 = r2(warpVal2, smem[lane * 32 + i + blockDim.x]); + } + __syncwarp(mask); + smem[lane] = warpVal1; + smem[lane + blockDim.x] = warpVal2; + } + } + + __syncthreads(); + + // First thread will perform a reduction of the above per-warp reductions + AccumT blockVal1 = defaultVal1; + AccumT blockVal2 = defaultVal2; + + if (threadIdx.x == 0) { + for (int i = 0; i < blockDim.x / 32; ++i) { + blockVal1 = r1(blockVal1, smem[i]); + blockVal2 = r2(blockVal2, smem[i + blockDim.x]); + } + smem[0] = blockVal1; + smem[blockDim.x] = blockVal2; + } + + // Sync and broadcast + __syncthreads(); + *reducVal1 = smem[0]; + *reducVal2 = smem[blockDim.x]; + __syncthreads(); +} + +template class Reduction, int ILP, typename T, typename AccumT> +__device__ __forceinline__ AccumT +ilpReduce(int shift, + T* data, + int size, + const Reduction& r, + AccumT defaultVal) +{ + typedef typename std::aligned_storage::type LoadT; + AccumT threadVal = defaultVal; + int offset = threadIdx.x; + + // shift and do 1 + if(shift > 0){ + data -= shift; + size += shift; + if(threadIdx.x >= shift){ + threadVal = r(threadVal, data[offset]); + } + size -= blockDim.x; + data += blockDim.x; + } + int last = size % (ILP * blockDim.x); + + T v[ILP]; + LoadT* value = reinterpret_cast(&v); + + for (; offset * ILP < (size - last); offset += blockDim.x) { + *value = reinterpret_cast(data)[offset]; + + for (int j = 0; j < ILP; ++j) { + threadVal = r(threadVal, v[j]); + } + } + + offset = size - last + threadIdx.x; + // Epilogue + for (; offset < size; offset += blockDim.x) + threadVal = r(threadVal, data[offset]); + + return threadVal; +} + +template class Reduction1, template class Reduction2, int ILP, typename T, typename AccumT> +__device__ __forceinline__ void +ilpReduce(int shift, + T* data, + int size, + AccumT* reducVal1, + const Reduction1& r1, + AccumT defaultVal1, + AccumT* reducVal2, + const Reduction2& r2, + AccumT defaultVal2) +{ + typedef typename std::aligned_storage::type LoadT; + + AccumT threadVal1 = defaultVal1; + AccumT threadVal2 = defaultVal2; + int offset = threadIdx.x; + + // shift and do 1 + if(shift > 0){ + data -= shift; + size += shift; + if(threadIdx.x >= shift){ + threadVal1 = r1(threadVal1, data[offset]); + threadVal2 = r2(threadVal2, data[offset]); + } + size -= blockDim.x; + data += blockDim.x; + } + int last = size % (ILP * blockDim.x); + + T v[ILP]; + LoadT* value = reinterpret_cast(&v); + + for (; offset * ILP < (size - last); offset += blockDim.x) { + *value = reinterpret_cast(data)[offset]; + + for (int j = 0; j < ILP; ++j) { + threadVal1 = r1(threadVal1, v[j]); + threadVal2 = r2(threadVal2, v[j]); + } + } + + offset = size - last + threadIdx.x; + // Epilogue + for (; offset < size; offset += blockDim.x) { + threadVal1 = r1(threadVal1, data[offset]); + threadVal2 = r2(threadVal2, data[offset]); + } + + *reducVal1 = threadVal1; + *reducVal2 = threadVal2; +} + +template class Epilogue> +__global__ void +cunn_SoftMaxXEntropyForward( + accscalar_t *losses, + outscalar_t *max_log_sum_exp, + scalar_t *input, + int64_t *labels, + int64_t classes, + const float smoothing) +{ + extern __shared__ unsigned char smem[]; + auto sdata = reinterpret_cast(smem); + // forward pointers to batch[blockIdx.x] + // each block handles a sample in the mini-batch + input += blockIdx.x * classes; + //output += blockIdx.x * classes; + const int shift = ((uint64_t)input) % ALIGN_BYTES / sizeof(scalar_t); + + int64_t label = labels[blockIdx.x]; + + // find the max and sum + accscalar_t threadMax, threadSum, max_k, sum_k; + ilpReduce( + shift, input, classes, + &threadMax, MaxFloat(), + -at::numeric_limits::max(), + &threadSum, AddFloat(), + static_cast(0)); + + blockReduce( + sdata, + &max_k, threadMax, Max(), + -at::numeric_limits::max(), + &sum_k, threadSum, Add(), + static_cast(0)); + + accscalar_t threadExp = ilpReduce(shift, input, classes, SumExpFloat(max_k), static_cast(0)); + accscalar_t sumAll = blockReduce( + sdata, threadExp, Add(), static_cast(0)); + + Epilogue epilogue(max_k, sumAll); + + // calculate per element loss with label smoothing + // reserve max + log_sum_exp for bprop + if (threadIdx.x == 0) { + accscalar_t log_prob = epilogue(static_cast(input[label])); + losses[blockIdx.x] = (max_k + std::log(sumAll) - sum_k / classes) \ + * smoothing - log_prob * (1 - smoothing); + max_log_sum_exp[blockIdx.x] = max_k + std::log(sumAll); + } +} + +template +__device__ __forceinline__ void +apply(scalar_t *gradInput, + scalar_t *logits, + outscalar_t *max_log_sum_exp, + outscalar_t *gradOutput, + int64_t *labels, + const float smoothing, + int classes) +{ + accscalar_t smooth_positives = 1.0 - smoothing; + accscalar_t smooth_negatives = smoothing / classes; + accscalar_t tmpGradOutput = gradOutput[blockIdx.x]; + int64_t label = labels[blockIdx.x]; + accscalar_t coeff = max_log_sum_exp[blockIdx.x]; + + int offset = threadIdx.x; + int last = classes % (ILP * blockDim.x); + + for (; offset < classes - last; offset += blockDim.x * ILP) { + accscalar_t tmpLogits[ILP]; + +#pragma unroll + for (int j = 0; j < ILP; ++j) { + tmpLogits[j] = static_cast(logits[offset + j * blockDim.x]); + } + +#pragma unroll + for (int j = 0; j < ILP; ++j) + gradInput[offset + j * blockDim.x] = tmpGradOutput * ( + std::exp(tmpLogits[j] - coeff) - static_cast( + (offset + j * blockDim.x == label) ? 1 : 0) * + smooth_positives - smooth_negatives); + } + + for (; offset < classes; offset += blockDim.x) + gradInput[offset] = tmpGradOutput * (std::exp( + static_cast(logits[offset]) - coeff) - + static_cast((offset == label) ? 1 : 0) * + smooth_positives - smooth_negatives); +} + + +template +__device__ __forceinline__ void +aligned_apply(int shift, + scalar_t *gradInput, + scalar_t *logits, + outscalar_t *max_log_sum_exp, + outscalar_t *gradOutput, + int64_t *labels, + const float smoothing, + int classes) +{ + accscalar_t smooth_positives = 1.0 - smoothing; + accscalar_t smooth_negatives = smoothing / classes; + accscalar_t tmpGradOutput = gradOutput[blockIdx.x]; + int64_t label = labels[blockIdx.x]; + accscalar_t coeff = max_log_sum_exp[blockIdx.x]; + + int offset = threadIdx.x; + + // shift and do 1 + if(shift > 0){ + logits -= shift; + gradInput -= shift; + classes += shift; + if(threadIdx.x >= shift){ + gradInput[offset] = tmpGradOutput * (std::exp( + static_cast(logits[offset]) - coeff) - + static_cast(((offset - shift) == label) ? 1 : 0) * + smooth_positives - smooth_negatives); + } + classes -= blockDim.x; + gradInput += blockDim.x; + logits += blockDim.x; + shift -= blockDim.x; + } + + int last = classes % (ILP * blockDim.x); + + typedef typename std::aligned_storage::type LoadT; + // input + scalar_t v[ILP]; + LoadT* value = reinterpret_cast(&v); + // output + scalar_t r[ILP]; + LoadT* result = reinterpret_cast(&r); + + for (; offset * ILP < (classes - last); offset += blockDim.x) { + *value = reinterpret_cast(logits)[offset]; + +#pragma unroll + for (int j = 0; j < ILP; ++j) { + r[j] = tmpGradOutput * (std::exp( + static_cast(v[j]) - coeff) - + static_cast(((ILP * offset + j - shift) == label) ? 1 : 0) * + smooth_positives - smooth_negatives); + } + reinterpret_cast(gradInput)[offset] = *result; + } + + offset = classes - last + threadIdx.x; + for (; offset < classes; offset += blockDim.x) + gradInput[offset] = tmpGradOutput * (std::exp( + static_cast(logits[offset]) - coeff) - + static_cast(((offset - shift) == label) ? 1 : 0) * + smooth_positives - smooth_negatives); + +} + +template class Epilogue> +__global__ void +cunn_SoftMaxXEntropyBackward( + scalar_t *gradInput, + scalar_t *logits, + outscalar_t *max_log_sum_exp, + outscalar_t *gradOutput, + int64_t *labels, + const float smoothing, + int classes) +{ + gradInput += blockIdx.x * classes; + logits += blockIdx.x * classes; + + // Do vectorized load/store when input/output have same alignment + const int shift = ((uint64_t)logits) % ALIGN_BYTES / sizeof(scalar_t); + const int shift_ = ((uint64_t)gradInput) % ALIGN_BYTES / sizeof(scalar_t); + if (shift == shift_){ + aligned_apply(shift, gradInput, logits, max_log_sum_exp, gradOutput, labels, smoothing, classes); + } + else { + apply(gradInput, logits, max_log_sum_exp, gradOutput, labels, smoothing, classes); + } + +} + +template class Epilogue> +std::vector host_softmax_xentropy( + const Tensor & input_, + const Tensor & labels_, + const float smoothing, + const bool half_to_float){ + if (half_to_float) AT_ASSERTM(input_.type().scalarType() == ScalarType::Half,"conversion is supported for Half type only"); + AT_ASSERTM(labels_.type().scalarType() == ScalarType::Long,"Label type should be CUDA Long"); + + auto input = input_.contiguous(); + Tensor max_log_sum_exp = at::empty_like(labels_, half_to_float ? input.options().dtype(ScalarType::Float) : input.options()); + Tensor losses = at::empty_like(labels_, input_.options().dtype(ScalarType::Float)); + + static_assert(std::is_same, float>::value || + std::is_same, double>::value, + "accscalar_t for half should be float or double"); + AT_ASSERTM(input.dim() == 2, "Currently only 2 dim input supported"); + AT_ASSERTM(labels_.dim() == 1, "Labels should be 1 dimensional"); + AT_ASSERTM(input.size(0) == labels_.size(0), "Input and label should have same number of examples"); + AT_ASSERTM(input.numel() > 0, "Number of classes in input should not be 0"); + + const int64_t dim = 1; + int64_t outer_size = 1; + int64_t dim_size = input.size(dim); + int64_t inner_size = 1; + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + for (int64_t i = 0; i < dim; ++i) + outer_size *= input.size(i); + for (int64_t i = dim + 1; i < input.dim(); ++i) + inner_size *= input.size(i); + // This kernel spawns a block per each element in the batch. + // XXX: it assumes that inner_size == 1 + TORCH_CHECK(inner_size == 1, "Currently only inner size 1 supported"); + + dim3 grid(outer_size); + + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "host_softmax_xentropy", + using accscalar_t = at::acc_type; + const int ILP = sizeof(float4)/sizeof(scalar_t_0); + dim3 block = SoftMax_getBlockSize(ILP, dim_size); + if (!half_to_float) { + cunn_SoftMaxXEntropyForward + <<>>( + losses.DATA_PTR(), max_log_sum_exp.DATA_PTR(), + input.DATA_PTR(), labels_.DATA_PTR(), + dim_size, smoothing + ); + } else { + cunn_SoftMaxXEntropyForward + <<>>( + losses.DATA_PTR(), max_log_sum_exp.DATA_PTR(), + input.DATA_PTR(), labels_.DATA_PTR(), + dim_size, smoothing + ); + } + ); + + THCudaCheck(cudaGetLastError()); + + std::vector ret = {losses, max_log_sum_exp}; + return ret; +} + +template class Epilogue> +Tensor host_softmax_xentropy_backward( + const at::Tensor &grad_loss, + const at::Tensor &logits_, + const at::Tensor &max_log_sum_exp, + const at::Tensor &labels, + const float smoothing, + bool half_to_float) { + const int64_t dim = 1; + Tensor gI = at::empty_like(logits_); + if (grad_loss.numel() == 0) { + return gI; + } + + auto grad = grad_loss.contiguous(); + auto logits = logits_.contiguous(); + + static_assert(std::is_same, float>::value || + std::is_same, double>::value, + "accscalar_t for half should be float or double"); + if (grad.dim() == 0) grad = grad.view(1); + + AT_ASSERTM(logits_.dim() == 2, "Currently only 2 dim input supported"); + AT_ASSERTM(labels.dim() == 1, "Labels should be 1 dimensional"); + AT_ASSERTM(logits_.numel() > 0, "Number of classes in input should not be 0"); + AT_ASSERTM(logits_.size(0) == labels.size(0), "Input and label should have same number of examples"); + AT_ASSERTM(labels.size(0) == grad.size(0), "Label and loss should have same number of examples"); + + int64_t outer_size = 1; + int64_t dim_size = logits.size(dim); + int64_t inner_size = 1; + for (int64_t i = 0; i < dim; ++i) + outer_size *= logits.size(i); + for (int64_t i = dim + 1; i < logits.dim(); ++i) + inner_size *= logits.size(i); + // See descriptions of kernels above. + cudaStream_t stream = at::cuda::getCurrentCUDAStream(); + TORCH_CHECK(inner_size == 1, "Currently only inner size 1 supported"); + + dim3 grid(outer_size); + + DISPATCH_FLOAT_AND_HALF(gI.scalar_type(), 0, "host_softmax_xentropy_backward", + using accscalar_t = acc_type; + const int ILP = sizeof(float4)/sizeof(scalar_t_0); + dim3 block = SoftMax_getBlockSize(ILP, dim_size); + if (!half_to_float) { + cunn_SoftMaxXEntropyBackward + <<>>( + gI.DATA_PTR(), logits.DATA_PTR(), + max_log_sum_exp.DATA_PTR(), + grad.DATA_PTR(), labels.DATA_PTR(), + smoothing, dim_size + ); + } else { + cunn_SoftMaxXEntropyBackward + <<>>( + gI.DATA_PTR(), logits.DATA_PTR(), + max_log_sum_exp.DATA_PTR(), + grad.DATA_PTR(), labels.DATA_PTR(), + smoothing, dim_size + ); + } + ); + + THCudaCheck(cudaGetLastError()); + return gI; +} + +std::vector softmax_xentropy_cuda(const Tensor &input, const Tensor &labels, const float smoothing, const bool half_to_float){ + return host_softmax_xentropy(input, labels, smoothing, half_to_float); +} + +at::Tensor softmax_xentropy_backward_cuda( + const at::Tensor &grad_loss, + const at::Tensor &logits, + const at::Tensor &max_log_sum_exp, + const at::Tensor &labels, + const float smoothing) { + bool half_to_float = grad_loss.type().scalarType() != logits.type().scalarType(); + if (half_to_float) { + AT_ASSERTM((grad_loss.type().scalarType() == ScalarType::Float && logits.type().scalarType() == ScalarType::Half), "expected input and grad types to match, or input to be at::Half and grad to be at::Float"); + } + return host_softmax_xentropy_backward(grad_loss, logits, max_log_sum_exp, labels, smoothing, half_to_float); +} diff --git a/apex/apex/contrib/examples/multihead_attn/func_test_multihead_attn.py b/apex/apex/contrib/examples/multihead_attn/func_test_multihead_attn.py new file mode 100644 index 0000000000000000000000000000000000000000..10407b9973b91d78b06c68fda60b61bd2f3d6097 --- /dev/null +++ b/apex/apex/contrib/examples/multihead_attn/func_test_multihead_attn.py @@ -0,0 +1,108 @@ +import torch +import torch.nn.functional as F +import argparse + +from apex.contrib.multihead_attn import SelfMultiheadAttn +from apex.contrib.multihead_attn import EncdecMultiheadAttn + +parser = argparse.ArgumentParser(description='Multihead Attention Standalone Test') +parser.add_argument('--seq-length', default=64, type=int, help='Sequence Length of Input') +parser.add_argument('--num-seqs-start', default=5, type=int, help='Start Range of Number of Sequences') +parser.add_argument('--num-seqs-stop', default=80, type=int, help='Stop Range of Number of Sequences') +parser.add_argument('--num-seqs-inc', default=5, type=int, help='Range Increment of Number of Sequences') +parser.add_argument('--trials', default=20, type=int, help='Number of Trials to Execute') +parser.add_argument('--warmup-trials', default=5, type=int, help='Warmup Trials to discard') +parser.add_argument('--layers', default=18, type=int, help='Attention Layers to Execute to Gain CPU/GPU Time Overlap') +parser.add_argument('--seed-start', default=1, type=int, help='Attention Layers to Execute to Gain CPU/GPU Time Overlap') +parser.add_argument('--seed-end', default=100, type=int, help='Attention Layers to Execute to Gain CPU/GPU Time Overlap') +parser.add_argument('--hidden-dim', default=1024, type=int, help='Multihead Attention hidden dimension') +parser.add_argument('--heads', default=16, type=int, help='Number of Multihead Attention heads') +parser.add_argument('--encdec-attn', action='store_true', help='Use Encoder-Decoder Attention instead of Self Attention.') +parser.add_argument('--norm-add', action='store_true', help='Include Layer Norm and Dropout-Add in Multihead Attention block.') +parser.add_argument('--ref', action='store_true', help='Reference implementation in python pytorch.') +parser.add_argument('--native', action='store_true', help='torch.nn.MultitheadAttention Version.') +parser.add_argument('--fwd', action='store_true', help='Only execute Fwd Pass.') +parser.add_argument('--eval', action='store_true', help='Inference only, no backward pass.') + +args = parser.parse_args() +assert args.seq_length % 64 == 0, "Sequence Length should be a multiple of 64!" + +if not torch.cuda.is_available(): + raise NotImplementedError('Running on CPU is not supported') +torch.cuda.set_device(0) + +dropout_prob = 0.1 + +for seed in range(args.seed_start, args.seed_end+1) : + torch.manual_seed(seed) + if torch.cuda.is_available(): + torch.cuda.manual_seed_all(seed) + ref_layer = None + if args.encdec_attn : + ref_layer = EncdecMultiheadAttn(args.hidden_dim, args.heads, dropout=dropout_prob, bias=False, include_norm_add=args.norm_add, impl='default') + else : + ref_layer = SelfMultiheadAttn(args.hidden_dim, args.heads, dropout=dropout_prob, bias=False, include_norm_add=args.norm_add, impl='default') + ref_layer.cuda() + ref_layer.half() + ref_layer.reset_parameters() + + ref_inputs = torch.randn(args.seq_length, args.num_seqs_start, args.hidden_dim, dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + ref_inputs_kv = None + if args.encdec_attn : + ref_inputs_kv = torch.randn(args.seq_length, args.num_seqs_start, args.hidden_dim, dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + ref_grads = torch.randn_like(ref_inputs) + + ref_outputs,_ = ref_layer.forward(ref_inputs, + ref_inputs_kv, + ref_inputs_kv, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=(not args.eval)) + + ref_outputs.backward(ref_grads) + + torch.manual_seed(seed) + if torch.cuda.is_available(): + torch.cuda.manual_seed_all(seed) + tst_layer = None + if args.encdec_attn : + tst_layer = EncdecMultiheadAttn(args.hidden_dim, args.heads, dropout=dropout_prob, bias=False, include_norm_add=args.norm_add, impl='fast') + else: + tst_layer = SelfMultiheadAttn(args.hidden_dim, args.heads, dropout=dropout_prob, bias=False, include_norm_add=args.norm_add, impl='fast') + tst_layer.cuda() + tst_layer.half() + tst_layer.reset_parameters() + + tst_inputs = torch.randn(args.seq_length, args.num_seqs_start, args.hidden_dim, dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + tst_inputs_kv = None + if args.encdec_attn : + tst_inputs_kv = torch.randn(args.seq_length, args.num_seqs_start, args.hidden_dim, dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + assert torch.equal(ref_inputs,tst_inputs), "ERROR: Inputs are different!" + + tst_grads = torch.randn_like(tst_inputs) + + tst_outputs,_ = tst_layer.forward(tst_inputs, + tst_inputs_kv, + tst_inputs_kv, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=(not args.eval)) + + tst_outputs.backward(tst_grads) + + fwd_close = torch.equal(ref_outputs, tst_outputs) + bwd_close = torch.equal(ref_inputs.grad, tst_inputs.grad) + + diff_fwd = ref_outputs - tst_outputs + diff_cnt_fwd = diff_fwd.ne(0.0).sum() + diff_accum_fwd = diff_fwd.abs().sum() + + diff_bwd = ref_inputs.grad - tst_inputs.grad + diff_cnt_bwd = diff_bwd.ne(0.0).sum() + diff_accum_bwd = diff_bwd.abs().sum() + + print(">>> Seed: ", seed, fwd_close, diff_cnt_fwd.item(), diff_accum_fwd.item(), bwd_close, diff_cnt_bwd.item(), diff_accum_bwd.item()) diff --git a/apex/apex/contrib/examples/multihead_attn/perf_test_multihead_attn.py b/apex/apex/contrib/examples/multihead_attn/perf_test_multihead_attn.py new file mode 100644 index 0000000000000000000000000000000000000000..f81522ab372a5affd2f3e3150bd806495709610a --- /dev/null +++ b/apex/apex/contrib/examples/multihead_attn/perf_test_multihead_attn.py @@ -0,0 +1,115 @@ +import torch +import torch.nn.functional as F +import argparse + +from apex.contrib.multihead_attn import SelfMultiheadAttn +from apex.contrib.multihead_attn import EncdecMultiheadAttn + +parser = argparse.ArgumentParser(description='Multihead Attention Standalone Test') +parser.add_argument('--seq-length', default=64, type=int, help='Sequence Length of Input') +parser.add_argument('--num-seqs-start', default=10, type=int, help='Start Range of Number of Sequences') +parser.add_argument('--num-seqs-stop', default=120, type=int, help='Stop Range of Number of Sequences') +parser.add_argument('--num-seqs-inc', default=5, type=int, help='Range Increment of Number of Sequences') +parser.add_argument('--trials', default=20, type=int, help='Number of Trials to Execute') +parser.add_argument('--warmup-trials', default=5, type=int, help='Warmup Trials to discard') +parser.add_argument('--layers', default=18, type=int, help='Attention Layers to Execute to Gain CPU/GPU Time Overlap') +parser.add_argument('--hidden-dim', default=1024, type=int, help='Multihead Attention hidden dimension') +parser.add_argument('--heads', default=16, type=int, help='Number of Multihead Attention heads') +parser.add_argument('--encdec-attn', action='store_true', help='Use Encoder-Decoder Attention instead of Self Attention.') +parser.add_argument('--norm-add', action='store_true', help='Include Layer Norm and Dropout-Add in Multihead Attention block.') +parser.add_argument('--ref', action='store_true', help='Reference implementation in python pytorch.') +parser.add_argument('--native', action='store_true', help='torch.nn.MultitheadAttention Version.') +parser.add_argument('--fwd', action='store_true', help='Only execute Fwd Pass.') +parser.add_argument('--biases', action='store_true', help='Execute multihead attention with Linear Biases.') + +args = parser.parse_args() + +if not torch.cuda.is_available(): + raise NotImplementedError('Running on CPU is not supported') +torch.cuda.set_device(0) + +torch.manual_seed(111) +if torch.cuda.is_available(): + torch.cuda.manual_seed_all(111) + +attn_layers = [] +for idx in range(0, args.layers) : + if args.encdec_attn : + if args.ref : + attn_layers.append(EncdecMultiheadAttn(args.hidden_dim, args.heads, dropout=0.1, bias=args.biases, include_norm_add=False, impl='default')) + else : + attn_layers.append(EncdecMultiheadAttn(args.hidden_dim, args.heads, dropout=0.1, bias=args.biases, include_norm_add=args.norm_add, impl='fast')) + else : + if args.native : + attn_layers.append(torch.nn.MultiheadAttention(args.hidden_dim, args.heads, dropout=0.1, bias=args.biases)) + elif args.ref : + attn_layers.append(SelfMultiheadAttn(args.hidden_dim, args.heads, dropout=0.1, bias=args.biases, include_norm_add=args.norm_add, impl='default')) + else : + attn_layers.append(SelfMultiheadAttn(args.hidden_dim, args.heads, dropout=0.1, bias=args.biases, include_norm_add=args.norm_add, impl='fast')) + attn_layers[idx].cuda() + attn_layers[idx].half() + if not args.native : + attn_layers[idx].reset_parameters() + +start_evt_fwd = [] +start_evt_bwd = [] +stop_evt_bwd = [] +for recorded_trial in range(0, args.trials) : + start_evt_fwd.append(torch.cuda.Event(enable_timing=True)) + start_evt_bwd.append(torch.cuda.Event(enable_timing=True)) + stop_evt_bwd.append(torch.cuda.Event(enable_timing=True)) + +for sequences in range(args.num_seqs_start, args.num_seqs_stop + args.num_seqs_inc, args.num_seqs_inc) : + inputs = torch.randn(args.seq_length, sequences, args.hidden_dim, dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + grads = torch.randn_like(inputs) + + for trial in range(0, args.trials + args.warmup_trials) : + layer_inputs = inputs + evt_idx = trial - args.warmup_trials + + if evt_idx >= 0 : + start_evt_fwd[evt_idx].record() + + for lyr_idx in range(0, args.layers) : + if args.native : + outputs,_ = attn_layers[lyr_idx].forward(layer_inputs, + layer_inputs, + layer_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=None) + else : + outputs,_ = attn_layers[lyr_idx].forward(layer_inputs, + layer_inputs, + layer_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + layer_inputs = outputs + + if evt_idx >= 0 : + start_evt_bwd[evt_idx].record() + + if not args.fwd : + layer_inputs.backward(grads) + + if evt_idx >= 0 : + stop_evt_bwd[evt_idx].record() + + torch.cuda.synchronize() + elapsed_time_fwd = 0.0 + elapsed_time_bwd = 0.0 + for evt_idx in range(0, args.trials) : + elapsed_time_fwd += start_evt_fwd[evt_idx].elapsed_time(start_evt_bwd[evt_idx]) + elapsed_time_bwd += start_evt_bwd[evt_idx].elapsed_time(stop_evt_bwd[evt_idx]) + + print("[ {} Attn {} ]Total Tokens: {:4d} Sequences: {:3d} Sequence Length: {:3d} Fwd Time / Layer: {:.3f} ms Bwd Time / Layer: {:.3f} ms".format( + 'Encdec' if args.encdec_attn else 'Self', \ + 'Norm&Add' if args.norm_add else '', \ + sequences*args.seq_length, \ + sequences, \ + args.seq_length, \ + elapsed_time_fwd / ( args.trials * args.layers ), \ + elapsed_time_bwd / ( args.trials * args.layers ))) + diff --git a/apex/apex/contrib/fmha/__init__.py b/apex/apex/contrib/fmha/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..ec2e9c66c8f5b19bbee4028c73201c2f41f80854 --- /dev/null +++ b/apex/apex/contrib/fmha/__init__.py @@ -0,0 +1 @@ +from .fmha import FMHAFun diff --git a/apex/apex/contrib/fmha/fmha.py b/apex/apex/contrib/fmha/fmha.py new file mode 100644 index 0000000000000000000000000000000000000000..dd93aa2176eef92305d70a0bbe8c8acfb427d439 --- /dev/null +++ b/apex/apex/contrib/fmha/fmha.py @@ -0,0 +1,67 @@ +############################################################################### +# Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are met: +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# * 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. +# * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. +# +############################################################################### + + +import torch +import torch.nn.functional as F +import fmhalib as mha + +class FMHAFun(torch.autograd.Function): + @staticmethod + def forward(ctx, qkv, cu_seqlens, seqlens, p_dropout, max_s, is_training): + context, S_dmask = mha.fwd(qkv, cu_seqlens, seqlens, p_dropout, max_s, is_training, None) + ctx.save_for_backward(qkv, S_dmask) + ctx.cu_seqlens = cu_seqlens + ctx.seqlens = seqlens + ctx.p_dropout = p_dropout + ctx.max_s = max_s + return context + + @staticmethod + def backward(ctx, dout): + qkv, S_dmask = ctx.saved_tensors + dqkv, dp = mha.bwd(dout, qkv, S_dmask, ctx.cu_seqlens, ctx.seqlens, ctx.p_dropout, ctx.max_s) + + return dqkv, None, None, None, None, None, None + +class FMHA(torch.nn.Module): + + def __init__(self, config): + + super(FMHA, self).__init__() + + self.p_dropout = config.attention_probs_dropout_prob + self.h = config.num_attention_heads + self.hidden_size = config.hidden_size + self.d = self.hidden_size // self.h + assert self.d * self.h == self.hidden_size, "Invalid hidden size/num_heads" + + def forward(self, qkv, cu_seqlens, seqlens, max_s, is_training=True): + + ctx = FMHAFun.apply(qkv.view(-1, 3, self.h, self.d), cu_seqlens, seqlens, self.p_dropout, max_s, is_training) + + return ctx.view(-1, self.hidden_size) diff --git a/apex/apex/contrib/groupbn/__init__.py b/apex/apex/contrib/groupbn/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..2f85770668c06b0c4efb353fd2c38e5e58d55121 --- /dev/null +++ b/apex/apex/contrib/groupbn/__init__.py @@ -0,0 +1,9 @@ +try: + import torch + import bnp + from .batch_norm import BatchNorm2d_NHWC + del torch + del bnp + del batch_norm +except ImportError as err: + print("apex was installed without --bnp flag, contrib.groupbn is not available") diff --git a/apex/apex/contrib/groupbn/batch_norm.py b/apex/apex/contrib/groupbn/batch_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..17ef196b9951729954e124d48c05dde96a09cec5 --- /dev/null +++ b/apex/apex/contrib/groupbn/batch_norm.py @@ -0,0 +1,225 @@ +import torch +import numpy as np +from torch.nn.modules.batchnorm import _BatchNorm + +import bnp + +class bn_NHWC_impl(torch.autograd.Function): + @staticmethod + def forward(ctx, x, s, b, rm, riv, mini_m, mini_riv, ret_cta, mom, epsilon, fuse_relu, is_train, bn_group, my_data, pair_data, magic, pair_data2, pair_data3, fwd_occup, fwd_grid_x, bwd_occup, bwd_grid_x, multi_stream): + if is_train: + ctx.save_for_backward(x, s, b, rm, riv, mini_m, mini_riv) + ctx.epsilon = epsilon + ctx.momentum = mom + ctx.ret_cta = ret_cta + ctx.fuse_relu = fuse_relu + ctx.my_data = my_data + ctx.pair_data = pair_data + ctx.magic = magic + ctx.pair_data2 = pair_data2 + ctx.pair_data3 = pair_data3 + ctx.bn_group = bn_group + ctx.bwd_occup = bwd_occup + ctx.bwd_grid_x = bwd_grid_x + ctx.multi_stream = multi_stream + + res = bnp.bn_fwd_nhwc(x, s, b, rm, riv, mini_m, mini_riv, ret_cta, mom, epsilon, fuse_relu, my_data, pair_data, pair_data2, pair_data3, bn_group, magic, fwd_occup, fwd_grid_x, multi_stream) + return res + else: + return bnp.bn_fwd_eval_nhwc(x, s, b, rm, riv, ret_cta, bn_group, mom, epsilon, fuse_relu) + + @staticmethod + def backward(ctx, grad_y): + x, s, b, rm, riv, mini_m, mini_riv = ctx.saved_variables + epsilon = ctx.epsilon + mom = ctx.momentum + ret_cta = ctx.ret_cta + fuse_relu = ctx.fuse_relu + my_data = ctx.my_data + pair_data = ctx.pair_data + magic = ctx.magic + pair_data2 = ctx.pair_data2 + pair_data3 = ctx.pair_data3 + bn_group = ctx.bn_group + bwd_occup = ctx.bwd_occup + bwd_grid_x = ctx.bwd_grid_x + multi_stream = ctx.multi_stream + + dx, dscale, dbias = bnp.bn_bwd_nhwc(x, grad_y, s, b, rm, riv, mini_m, mini_riv, ret_cta, mom, epsilon, fuse_relu, my_data, pair_data, pair_data2, pair_data3, bn_group, magic, bwd_occup, bwd_grid_x, multi_stream) + + return dx, dscale, dbias, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None + + +class bn_addrelu_NHWC_impl(torch.autograd.Function): + @staticmethod + def forward(ctx, x, z, s, b, rm, riv, mini_m, mini_riv, grid_dim_y, ret_cta, mom, epsilon, is_train, bn_group, my_data, pair_data, magic, pair_data2, pair_data3, fwd_occup, fwd_grid_x, bwd_occup, bwd_grid_x, multi_stream): + if is_train: + bitmask = torch.cuda.IntTensor(((x.numel()+31)//32) * 2 * grid_dim_y) + ctx.save_for_backward(x, s, b, rm, riv, mini_m, mini_riv, bitmask) + ctx.epsilon = epsilon + ctx.momentum = mom + ctx.ret_cta = ret_cta + ctx.my_data = my_data + ctx.pair_data = pair_data + ctx.magic = magic + ctx.pair_data2 = pair_data2 + ctx.pair_data3 = pair_data3 + ctx.bn_group = bn_group + ctx.bwd_occup = bwd_occup + ctx.bwd_grid_x = bwd_grid_x + ctx.multi_stream = multi_stream + + res = bnp.bn_addrelu_fwd_nhwc(x, z, s, b, rm, riv, mini_m, mini_riv, bitmask, ret_cta, mom, epsilon, my_data, pair_data, pair_data2, pair_data3, bn_group, magic, fwd_occup, fwd_grid_x, multi_stream) + return res + else: + return bnp.bn_addrelu_fwd_eval_nhwc(x, z, s, b, rm, riv, ret_cta, bn_group, mom, epsilon) + + @staticmethod + def backward(ctx, grad_y): + x, s, b, rm, riv, mini_m, mini_riv, bitmask = ctx.saved_variables + epsilon = ctx.epsilon + mom = ctx.momentum + ret_cta = ctx.ret_cta + my_data = ctx.my_data + pair_data = ctx.pair_data + magic = ctx.magic + pair_data2 = ctx.pair_data2 + pair_data3 = ctx.pair_data3 + bn_group = ctx.bn_group + bwd_occup = ctx.bwd_occup + bwd_grid_x = ctx.bwd_grid_x + multi_stream = ctx.multi_stream + + dx, dz, dscale, dbias = bnp.bn_addrelu_bwd_nhwc(x, grad_y, s, b, rm, riv, mini_m, mini_riv, bitmask, ret_cta, mom, epsilon, my_data, pair_data, pair_data2, pair_data3, bn_group, magic, bwd_occup, bwd_grid_x, multi_stream) + + return dx, dz, dscale, dbias, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None + + + + + +class BatchNorm2d_NHWC(_BatchNorm): + # if using BatchNorm2d_NHWC simultaneously with multiple streams set multi_stream to True + def __init__(self, num_features, fuse_relu=False, bn_group=1, max_cta_per_sm=2, cta_launch_margin=12, multi_stream=False): + super(BatchNorm2d_NHWC, self).__init__(num_features) + + self.fuse_relu = fuse_relu + self.multi_stream = multi_stream + + self.minibatch_mean = torch.cuda.FloatTensor(num_features) + self.minibatch_riv = torch.cuda.FloatTensor(num_features) + + #defaut to distributed bn disabled + self.bn_group = bn_group + self.max_cta_per_sm = max_cta_per_sm #used only in training fwd and bwd + self.cta_launch_margin = cta_launch_margin #used only in training fwd and bwd + self.my_data = None + self.pair_data = None + self.pair_data2 = None + self.pair_data3 = None + self.local_rank = 0 + self.magic = torch.IntTensor([0]) + + #calculate cta per sm occupancies + assert(max_cta_per_sm>0) # won't be able to do much with 0 CTAs :) + self.fwd_occupancy = min(bnp.bn_fwd_nhwc_occupancy(), max_cta_per_sm) + self.bwd_occupancy = min(bnp.bn_bwd_nhwc_occupancy(), max_cta_per_sm) + self.addrelu_fwd_occupancy = min(bnp.bn_addrelu_fwd_nhwc_occupancy(), max_cta_per_sm) + self.addrelu_bwd_occupancy = min(bnp.bn_addrelu_bwd_nhwc_occupancy(), max_cta_per_sm) + + #calculate grid dimentions based on occupancy numbers + mp_count = torch.cuda.get_device_properties(None).multi_processor_count + self.fwd_grid_dim_x = max(mp_count*self.fwd_occupancy - cta_launch_margin , 1) + self.bwd_grid_dim_x = max(mp_count*self.bwd_occupancy - cta_launch_margin , 1) + self.addrelu_fwd_grid_dim_x = max(mp_count*self.addrelu_fwd_occupancy - cta_launch_margin , 1) + self.addrelu_bwd_grid_dim_x = max(mp_count*self.addrelu_bwd_occupancy - cta_launch_margin , 1) + self.grid_dim_y = (num_features + 63) // 64 + + # allocate scratch space used by implementation + # TODO: scratch space that is not supposed to be exposed at user code. We only need one time initialization, the + # same buffer could be reused in future iterations. Currently we exposed it here instead of requesting new + # buffer from cache allocator to avoid unnecessary initialization at future iterations. + self.ret_cta = torch.cuda.ByteTensor(8192).fill_(0) + + #FIXME: turn pair handles into an array + if bn_group>1: + local_rank = torch.distributed.get_rank() + world_size = torch.distributed.get_world_size() + assert(world_size >= bn_group) + assert(world_size % bn_group == 0) + + bn_sync_steps = 1 + if (bn_group==4): + bn_sync_steps = 2 + if (bn_group==8): + bn_sync_steps = 3 + + self.ipc_buffer = torch.cuda.ByteTensor(bnp.get_buffer_size(bn_sync_steps)) + self.my_data = bnp.get_data_ptr(self.ipc_buffer) + # we are walking on very thin ice here by utilizing internal `_share_cuda_()` + self.storage = self.ipc_buffer.storage() + self.share_cuda = self.storage._share_cuda_() + internal_cuda_mem = self.share_cuda + # internal_cuda_mem[1]: ipc_mem_handle + my_handle = torch.cuda.ByteTensor(np.frombuffer(internal_cuda_mem[1], dtype=np.uint8)) + # internal_cuda_mem[3]: offset + my_offset = torch.cuda.IntTensor([internal_cuda_mem[3]]) + + handles_all = torch.empty(world_size, my_handle.size(0), dtype=my_handle.dtype, device=my_handle.device) + handles_l = list(handles_all.unbind(0)) + torch.distributed.all_gather(handles_l, my_handle) + + offsets_all = torch.empty(world_size, my_offset.size(0), dtype=my_offset.dtype, device=my_offset.device) + offsets_l = list(offsets_all.unbind(0)) + torch.distributed.all_gather(offsets_l, my_offset) + + #whom do I actually care about? that would be local_rank XOR 1 + self.pair_handle = handles_l[local_rank ^ 1].cpu().contiguous() + pair_offset = offsets_l[local_rank ^ 1].cpu() + self.pair_data = bnp.get_remote_data_ptr(self.pair_handle, pair_offset) + + if bn_group>2: + self.pair_handle2 = handles_l[local_rank ^ 2].cpu().contiguous() + pair_offset2 = offsets_l[local_rank ^ 2].cpu() + self.pair_data2 = bnp.get_remote_data_ptr(self.pair_handle2, pair_offset2) + + if bn_group>4: + self.pair_handle3 = handles_l[local_rank ^ 4].cpu().contiguous() + pair_offset3 = offsets_l[local_rank ^ 4].cpu() + self.pair_data3 = bnp.get_remote_data_ptr(self.pair_handle3, pair_offset3) + + #FIXME: get magic value into C code and eliminate from here + self.magic = torch.IntTensor([2]) + self.local_rank = local_rank + + + def forward(self, x, z=None): + if z is not None: + assert(self.fuse_relu==True) + return bn_addrelu_NHWC_impl.apply(x, z, + self.weight, self.bias, + self.running_mean, self.running_var, + self.minibatch_mean, self.minibatch_riv, self.grid_dim_y, self.ret_cta, + self.momentum, + self.eps, self.training, self.bn_group, self.my_data, self.pair_data, (self.magic), self.pair_data2, self.pair_data3, + self.addrelu_fwd_occupancy, self.addrelu_fwd_grid_dim_x, + self.addrelu_bwd_occupancy, self.addrelu_bwd_grid_dim_x, + self.multi_stream) + else: + return bn_NHWC_impl.apply(x, + self.weight, self.bias, + self.running_mean, self.running_var, + self.minibatch_mean, self.minibatch_riv, self.ret_cta, + self.momentum, + self.eps, self.fuse_relu, self.training, self.bn_group, self.my_data, self.pair_data, (self.magic), self.pair_data2, self.pair_data3, + self.fwd_occupancy, self.fwd_grid_dim_x, + self.bwd_occupancy, self.bwd_grid_dim_x, + self.multi_stream) + + def __del__(self): + if self.bn_group>1: + bnp.close_remote_data(self.pair_handle) + if self.bn_group>2: + bnp.close_remote_data(self.pair_handle2) + if self.bn_group>4: + bnp.close_remote_data(self.pair_handle3) diff --git a/apex/apex/contrib/layer_norm/__init__.py b/apex/apex/contrib/layer_norm/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..4bbc4763aa367858766f3936b0b09a006b39f12c --- /dev/null +++ b/apex/apex/contrib/layer_norm/__init__.py @@ -0,0 +1 @@ +from .layer_norm import FastLayerNorm diff --git a/apex/apex/contrib/layer_norm/layer_norm.py b/apex/apex/contrib/layer_norm/layer_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..daced6742f6358f898345ca66339a82344688114 --- /dev/null +++ b/apex/apex/contrib/layer_norm/layer_norm.py @@ -0,0 +1,44 @@ +import torch +from torch.nn import init + +import fast_layer_norm + +class FastLayerNormFN(torch.autograd.Function): + @staticmethod + def forward(ctx, x, gamma, beta, epsilon): + x = x.contiguous() + gamma = gamma.contiguous() + beta = beta.contiguous() + hidden_size = gamma.numel() + xmat = x.view((-1, hidden_size)) + ymat, mu, rsigma = fast_layer_norm.ln_fwd(xmat, gamma, beta, epsilon) + ctx.save_for_backward(x, gamma, mu, rsigma) + return ymat.view(x.shape) + + @staticmethod + def backward(ctx, dy): + #assert dy.is_contiguous() + dy = dy.contiguous() # this happens! + x, gamma, mu, rsigma = ctx.saved_tensors + + hidden_size = gamma.numel() + xmat = x.view((-1, hidden_size)) + dymat = dy.view(xmat.shape) + dxmat, dgamma, dbeta = fast_layer_norm.ln_bwd(dymat, xmat, mu, rsigma, gamma) + dx = dxmat.view(x.shape) + return dx, dgamma, dbeta, None + +class FastLayerNorm(torch.nn.Module): + def __init__(self, hidden_size, eps=1e-5): + super(FastLayerNorm, self).__init__() + self.epsilon = eps + self.weight = torch.nn.Parameter(torch.Tensor(hidden_size)) + self.bias = torch.nn.Parameter(torch.Tensor(hidden_size)) + self.reset_parameters() + + def reset_parameters(self): + init.ones_(self.weight) + init.zeros_(self.bias) + + def forward(self, x): + return FastLayerNormFN.apply(x, self.weight, self.bias, self.epsilon) diff --git a/apex/apex/contrib/multihead_attn/MHA_bwd.png b/apex/apex/contrib/multihead_attn/MHA_bwd.png new file mode 100644 index 0000000000000000000000000000000000000000..bf10cfcdf7205162e52a65e2685af3a6db149020 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/MHA_bwd.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ec723249d9fdab4ac04f5babe519cb8fc429470f7c3f5a53eb807e429f371cec +size 86630 diff --git a/apex/apex/contrib/multihead_attn/MHA_fwd.png b/apex/apex/contrib/multihead_attn/MHA_fwd.png new file mode 100644 index 0000000000000000000000000000000000000000..a9145fbb809318dff36ee259941ecbdf212b6836 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/MHA_fwd.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f538ef97ecbb298e5ed0038e5a7c32a7b8c748d9801f3aa82add5ee75b01509f +size 84392 diff --git a/apex/apex/contrib/multihead_attn/README.md b/apex/apex/contrib/multihead_attn/README.md new file mode 100644 index 0000000000000000000000000000000000000000..bf0f3a07fb688cd994ce229069aafd52da04cde0 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/README.md @@ -0,0 +1,60 @@ +# Fast Multihead Attention + +This implementation has two main features : +* A C++ implementation to avoid the CPU overheads of Pytorch found with smaller batch sizes. +* The removal of all copies and transposes found in standard implementations of Multihead Attention. + +| | Python Version | C++ Version | +| :----------------------------------------- | :------------: | :---------: | +| Layer Norm and Residual Add Variant | X | X | +| Includes Linear Biases | X | | +| Reduces CPU Overheads | | X | +| Fuses masking with Softmax | | X | +| Removes Transposes and Copies | X | X | +| Includes Self and Encoder/Decoder Variants | X | X | + +## How to Instantiate + +`SelfMultiheadAttn(` _hidden dim_, _heads_, _dropout=prob_, _bias=bool_, _include_norm_add=bool_, _impl='fast'_ `)` +`EncdecMultiheadAttn(` _hidden dim_, _heads_, _dropout=prob_, _bias=bool_, _include_norm_add=bool_, _impl='fast'_ `)` + + `impl` has two options: + * `fast` uses C++ Version + * `default` uses Python Version + +## Instructions to build on Linux + +``` +$ git clone https://github.com/NVIDIA/apex +$ cd apex +$ pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" --global-option="--fast_multihead_attn" ./ +``` +## Try Performance Tests Yourself! +Perf test script is found here! +``` +cd contrib/examples/multihead_attn +``` +#### Fast Multihead Attention +``` +python perf_test_multihead_attn.py --ref +``` +#### Fast Multihead Attention with C++ Implementation +``` +python perf_test_multihead_attn.py +``` +#### Compare with `torch.nn.MultiheadAttn` +``` +python perf_test_multihead_attn.py --native +``` +#### Test your own range! +``` +python perf_test_multihead_attn.py --seq-length 64 --num-seqs-start 10 --num-seqs-stop 120 --num-seqs-inc 5 +``` + +## Performance Comparisons + +* Performance was measured with 64 token sequence lengths on an NVIDIA TitanV card. +* Time is measured across multiple layers to simulate an in model scenario. + +![Multihead Attention Forward](MHA_fwd.png) +![Multihead Attention Backward](MHA_bwd.png) diff --git a/apex/apex/contrib/multihead_attn/__init__.py b/apex/apex/contrib/multihead_attn/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..7de3edc234904d165465734c9da10ec4799072a7 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/__init__.py @@ -0,0 +1,3 @@ +from .self_multihead_attn import SelfMultiheadAttn +from .encdec_multihead_attn import EncdecMultiheadAttn +from .mask_softmax_dropout_func import fast_mask_softmax_dropout_func diff --git a/apex/apex/contrib/multihead_attn/encdec_multihead_attn.py b/apex/apex/contrib/multihead_attn/encdec_multihead_attn.py new file mode 100644 index 0000000000000000000000000000000000000000..f8355664a2d515c487052ba3661635893c5370ed --- /dev/null +++ b/apex/apex/contrib/multihead_attn/encdec_multihead_attn.py @@ -0,0 +1,141 @@ +import math + +import torch +from torch import nn +from torch.nn import Parameter +import torch.nn.functional as F + +from .encdec_multihead_attn_func import encdec_attn_func +from .fast_encdec_multihead_attn_func import fast_encdec_attn_func +from .fast_encdec_multihead_attn_norm_add_func import fast_encdec_attn_norm_add_func +from apex.normalization.fused_layer_norm import FusedLayerNorm + +if hasattr(torch._C, '_jit_set_profiling_executor') : + torch._C._jit_set_profiling_executor(False) +if hasattr(torch._C, '_jit_set_profiling_mode') : + torch._C._jit_set_profiling_mode(False) + +@torch.jit.script +def jit_dropout_add(x, residual, prob, is_training): + # type: (Tensor, Tensor, float, bool) -> Tensor + out = F.dropout(x, p=prob, training=True) + out = residual + out + return out + + +class EncdecMultiheadAttn(nn.Module): + """Multi-headed attention. + + See "Attention Is All You Need" for more details. + """ + def __init__(self, embed_dim, num_heads, dropout=0., bias=False, include_norm_add=False, impl='fast'): + super().__init__() + self.embed_dim = embed_dim + self.num_heads = num_heads + self.dropout = dropout + self.head_dim = embed_dim // num_heads + assert self.head_dim * num_heads == self.embed_dim, "embed_dim must be divisible by num_heads" + self.bias = bias + self.include_norm_add = include_norm_add + self.impl = impl + self.scaling = self.head_dim**-0.5 + + self.in_proj_weight_q = Parameter(torch.Tensor(embed_dim, embed_dim)) + self.in_proj_weight_kv = Parameter(torch.Tensor(2*embed_dim, embed_dim)) + self.out_proj_weight = Parameter(torch.Tensor(embed_dim, embed_dim)) + if self.bias: + assert impl != 'fast', "ERROR! The Fast implementation does not support biases!" + self.in_proj_bias_q = Parameter(torch.Tensor(embed_dim)) + self.in_proj_bias_kv = Parameter(torch.Tensor(2*embed_dim)) + self.out_proj_bias = Parameter(torch.Tensor(embed_dim)) + else: + self.register_parameter('in_proj_bias_q', None) + self.register_parameter('in_proj_bias_kv', None) + self.in_proj_bias_q = None + self.in_proj_bias_kv = None + self.out_proj_bias = None + if self.include_norm_add: + if impl == 'fast': + self.lyr_nrm_gamma_weights = Parameter(torch.Tensor(embed_dim)) + self.lyr_nrm_beta_weights = Parameter(torch.Tensor(embed_dim)) + self.lyr_nrm = None + else: + self.register_parameter('lyr_norm_gamma_weights', None) + self.register_parameter('lyr_norm_beta_weights', None) + self.lyr_nrm_gamma_weights = None + self.lyr_nrm_beta_weights = None + self.lyr_nrm = FusedLayerNorm(embed_dim) + self.reset_parameters() + + if self.include_norm_add: + if impl == 'fast' : self.attn_func = fast_encdec_attn_norm_add_func + elif impl == 'default' : self.attn_func = encdec_attn_func + else : assert False, "Unsupported impl: {} !".format(impl) + else: + if impl == 'fast' : self.attn_func = fast_encdec_attn_func + elif impl == 'default' : self.attn_func = encdec_attn_func + else : assert False, "Unsupported impl: {} !".format(impl) + + def reset_parameters(self): + nn.init.xavier_uniform_(self.in_proj_weight_q) + # in_proj_weight_kv has shape [2 * hidden, hidden] but it should be + # initialized like a [hidden, hidden] matrix. + # sqrt(6 / (hidden + hidden)) / sqrt(6 / (2 * hidden + hidden)) = sqrt(1.5) + # therefore xavier_uniform gain should be set to sqrt(1.5). + nn.init.xavier_uniform_(self.in_proj_weight_kv, gain=math.sqrt(1.5)) + nn.init.xavier_uniform_(self.out_proj_weight) + if self.bias: + nn.init.constant_(self.in_proj_bias_q, 0.) + nn.init.constant_(self.in_proj_bias_kv, 0.) + nn.init.constant_(self.out_proj_bias, 0.) + if self.include_norm_add: + if self.impl == 'fast' : + nn.init.ones_(self.lyr_nrm_gamma_weights) + nn.init.zeros_(self.lyr_nrm_beta_weights) + else: + self.lyr_nrm.reset_parameters() + + def forward(self, query, key, value, key_padding_mask=None, need_weights=False, attn_mask=None, is_training=True): + """Input shape: Time x Batch x Channel + + Self-attention can be implemented by passing in the same arguments for + query, key and value. Future timesteps can be masked with the + `mask_future_timesteps` argument. Padding elements can be excluded from + the key by passing a binary ByteTensor (`key_padding_mask`) with shape: + batch x src_len, where padding elements are indicated by 1s. + """ + + if key_padding_mask is not None: + assert (attn_mask is None), "ERROR attn_mask and key_padding_mask should not be both defined!" + mask = key_padding_mask + elif attn_mask is not None: + mask = attn_mask + else: + mask = None + + if self.include_norm_add: + if self.impl == 'fast': + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, query, key, + self.lyr_nrm_gamma_weights, self.lyr_nrm_beta_weights, + self.in_proj_weight_q, self.in_proj_weight_kv, self.out_proj_weight, mask, self.dropout) + else: + lyr_nrm_results = self.lyr_nrm(query) + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, self.scaling, lyr_nrm_results, key, + self.in_proj_weight_q, self.in_proj_weight_kv, self.out_proj_weight, + self.in_proj_bias_q, self.in_proj_bias_kv, self.out_proj_bias, + mask, self.dropout) + if is_training: + outputs = jit_dropout_add(outputs, query, self.dropout, is_training) + else: + outputs = outputs + query + else: + if self.impl == 'fast': + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, query, key, + self.in_proj_weight_q, self.in_proj_weight_kv, self.out_proj_weight, mask, self.dropout) + else: + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, self.scaling, query, key, + self.in_proj_weight_q, self.in_proj_weight_kv, self.out_proj_weight, + self.in_proj_bias_q, self.in_proj_bias_kv, self.out_proj_bias, + mask, self.dropout) + + return outputs,None diff --git a/apex/apex/contrib/multihead_attn/encdec_multihead_attn_func.py b/apex/apex/contrib/multihead_attn/encdec_multihead_attn_func.py new file mode 100644 index 0000000000000000000000000000000000000000..5c5d9a4f3da4559aa73030f3b43ef3f7c9f58e6e --- /dev/null +++ b/apex/apex/contrib/multihead_attn/encdec_multihead_attn_func.py @@ -0,0 +1,268 @@ +import torch +import torch.nn.functional as F + + +class EncdecAttnFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, use_time_mask, is_training, heads, scale, inputs_q, inputs_kv, + input_weights_q, input_weights_kv, output_weights, + input_biases_q, input_biases_kv, output_biases, + mask, dropout_prob): + use_biases_t = torch.tensor([input_biases_q is not None]) + heads_t = torch.tensor([heads]) + scale_t = torch.tensor([scale]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + head_dim = inputs_q.size(2) // heads + + # Input Linear GEMM Q + # input1: (activations) [seql_q, seqs, embed_dim(1024)] + # input2: (weights) [embed_dim (1024), embed_dim (1024)] (transpose [0,1]) + # output: [seql_q, seqs, embed_dim] + # GEMM: ( (seql_q*seqs) x embed_dim ) x ( embed_dim x embed_dim ) = (seql_q*seqs x embed_dim) + if use_biases_t[0]: + input_lin_q_results = torch.addmm(input_biases_q, + inputs_q.view(inputs_q.size(0) * inputs_q.size(1), inputs_q.size(2)), + input_weights_q.transpose(0,1), + beta=1., alpha=1.) + else: + input_lin_q_results = torch.mm(inputs_q.view(inputs_q.size(0) * inputs_q.size(1), inputs_q.size(2)), input_weights_q.transpose(0,1)) + input_lin_q_results = input_lin_q_results.view(inputs_q.size(0), inputs_q.size(1), input_weights_q.size(0)) + # Input Linear GEMM KV + # input1: (activations) [seql_k, seqs, embed_dim(1024)] + # input2: (weights) [embed_dim*2 (2048), embed_dim (1024)] (transpose [0,1]) + # output: [seql_k, seqs, embed_dim*2] + # GEMM: ( (seql_k*seqs) x embed_dim ) x ( embed_dim x embed_dim*2 ) = (seql_k*seqs x embed_dim*2) + if use_biases_t[0]: + input_lin_kv_results = torch.addmm(input_biases_kv, + inputs_kv.view(inputs_kv.size(0) * inputs_kv.size(1), inputs_kv.size(2)), + input_weights_kv.transpose(0,1), + beta=1., alpha=1.) + else: + input_lin_kv_results = torch.mm(inputs_kv.view(inputs_kv.size(0) * inputs_kv.size(1), inputs_kv.size(2)), input_weights_kv.transpose(0,1)) + input_lin_kv_results = input_lin_kv_results.view(inputs_kv.size(0), inputs_kv.size(1), input_weights_kv.size(0)) + + # Slice out k,v from one big Input Linear outuput (should only impact meta data, no copies!) + # Sequences and heads are combined to make the batch of the Batched GEMM + # input_lin_kv_results: [seql_k, seqs, heads(16), 2, head_dim(64)] + # input_lin_kv_results: [seql_k, batches=seqs*heads, 2, head_dim] + queries = input_lin_q_results.view(inputs_q.size(0), inputs_q.size(1)*heads, head_dim) + input_lin_kv_results = input_lin_kv_results.view(inputs_kv.size(0), inputs_kv.size(1)*heads, 2, head_dim) + keys = input_lin_kv_results[:,:,0,:] + values = input_lin_kv_results[:,:,1,:] + + # Matmul1 Batched GEMMs + # The output tensor is specified prior to the Batch GEMM because baddbmm requires its specification + # baddbmm is used to apply the scale parameter via the Batched GEMM's alpha parameter instead of + # a separate elementwise operation. + # Input1: (Queries) [seql_q, seqs*heads, head_dim] tranpose(0,1) + # Input2: (Keys) [seql_k, seqs*heads, head_dim] transpose(0,1) + # output: [seqs*heads, seql_q, seql_k] + # GEMM: Per batch: ( seql_q x head_dim ) x ( head_dim x seql_k ) = ( seql_q x seql_k ) + matmul1_results = torch.empty((queries.size(1),queries.size(0),keys.size(0)), dtype=queries.dtype, device=torch.device('cuda')) + matmul1_results = torch.baddbmm(matmul1_results, queries.transpose(0,1), keys.transpose(0,1).transpose(1,2), out=matmul1_results, beta=0.0, alpha=scale_t[0]) + + if mask is not None: + # Self Attention Time Mask + if use_time_mask: + assert (len(mask.size()) == 2), "Timing mask is not 2D!" + assert (mask.size(0) == mask.size(1)), "Sequence length should match!" + mask = mask.to(torch.bool) + matmul1_results = matmul1_results.masked_fill_(mask, float('-inf')) + # Key Padding Mask + else: + batches,seql_q,seql_k = matmul1_results.size() + seqs = int(batches / heads) + matmul1_results = matmul1_results.view(seqs, heads, seql_q, seql_k) + mask = mask.to(torch.bool) + matmul1_results = matmul1_results.masked_fill_(mask.unsqueeze(1).unsqueeze(2), float('-inf')) + matmul1_results = matmul1_results.view(seqs*heads, seql_q, seql_k) + + softmax_results = F.softmax(matmul1_results, dim=-1) + + # Dropout - is not executed for inference + if is_training: + dropout_results,dropout_mask = torch._fused_dropout(softmax_results, p=(1.-dropout_prob_t[0])) + else: + dropout_results = softmax_results + dropout_mask = null_tensor + + # Matmul2 Batched GEMMs + # The output tensor specification is needed here to specify the non-standard output. + # Given that pytorch cannot currently perform autograd with an output tensor specified, + # this requires a backward pass specified. + # Input1: from_softmax [seqs*heads, seql_q, seql_k] + # Input2: (values) [seql_v, seqs*heads, head_dim] transpose(0,1) + # Output: [seql_q, seqs*heads, head_dim] transpose(0,1) + # GEMM: Per batch: ( seql_q x seql_k ) x ( seql_k x head_dim ) = (seql_q x head_dim) + matmul2_results = torch.empty((dropout_results.size(1), dropout_results.size(0), values.size(2)), dtype=dropout_results.dtype, device=torch.device('cuda')).transpose(1,0) + matmul2_results = torch.bmm(dropout_results, values.transpose(0,1), out=matmul2_results) + matmul2_results = matmul2_results.transpose(0, 1).contiguous().view(inputs_q.size(0), inputs_q.size(1), inputs_q.size(2)) + + # Output Linear GEMM + # Input1: (activations) [seql_q, seqs, embed_dim=heads*head_dim] + # Input2: (weights) [ embed_dim, embed_dim ] transpose(0,1) + # Output: [ seql_q, seqs, embed_dim ] + # GEMM: ( seql_q*seqs x embed_dim ) x ( embed_dim x embed_dim ) = ( seql_q*seqs x embed_dim ) + if use_biases_t[0]: + outputs = torch.addmm(output_biases, + matmul2_results.view(inputs_q.size(0) * inputs_q.size(1), inputs_q.size(2)), + output_weights.transpose(0,1), + beta=1., alpha=1.) + else: + outputs = torch.mm(matmul2_results.view(inputs_q.size(0) * inputs_q.size(1), inputs_q.size(2)), output_weights.transpose(0,1)) + outputs = outputs.view(inputs_q.size(0), inputs_q.size(1), output_weights.size(0)) + + ctx.save_for_backward(use_biases_t, \ + heads_t, \ + scale_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + inputs_q, \ + inputs_kv, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t) + + return outputs.detach() + + @staticmethod + def backward(ctx, output_grads): + use_biases_t, \ + heads_t, \ + scale_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + inputs_q, \ + inputs_kv, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t = ctx.saved_tensors + + head_dim = inputs_q.size(2) // heads_t[0] + + # Slice out k,v from one big Input Linear outuput (should only impact meta data, no copies!) + # Sequences and heads are combined to make the batch of the Batched GEMM + # input_lin_kv_results: [seql_k, seqs, heads(16), 2, head_dim(64)] + # input_lin_kv_results: [seql_k, batches=seqs*heads, 2, head_dim] + queries = input_lin_q_results.view(inputs_q.size(0), inputs_q.size(1)*heads_t[0], head_dim) + input_lin_kv_results = input_lin_kv_results.view(inputs_kv.size(0), inputs_kv.size(1)*heads_t[0], 2, head_dim) + keys = input_lin_kv_results[:,:,0,:] + values = input_lin_kv_results[:,:,1,:] + + # Slice out k,v from one big set of gradients entering the input linear's bprop (should only impact meta data, no copies!) + # The gradients are identical in size to the Input Linear outputs. + # The tensor is declared before hand to properly slice out query, key, and value grads. + input_lin_kv_results_grads = torch.empty_like(input_lin_kv_results) + queries_grads = torch.empty_like(queries) + keys_grads = input_lin_kv_results_grads[:,:,0,:] + values_grads = input_lin_kv_results_grads[:,:,1,:] + + # Output Linear GEMM - DGRAD + # Input1: (data grads) [seql_q, seqs, embed_dim=heads*head_dim] + # Input2: (weights) [ embed_dim, embed_dim ] + # Output: [ seql_q, seqs, embed_dim ] + # GEMM: ( seql_q*seqs x embed_dim ) x ( embed_dim x embed_dim ) = ( seql_q*seqs x embed_dim ) + output_lin_grads = torch.mm(output_grads.view(output_grads.size(0) * output_grads.size(1), output_grads.size(2)), output_weights) + output_lin_grads = output_lin_grads.view(output_grads.size(0), output_grads.size(1), output_weights.size(1)) + # Output Linear GEMM - WGRAD + # Input1: (data grads) [seql_q*seqs, embed_dim=heads*head_dim] transpose(0,1) + # Input2: (activations) [seql_q*seqs, embed_dim ] + # Output: [ seql_q, seqs, embed_dim ] + # GEMM: ( embed_dim x seql_q*seqs ) x ( seql_q*seqs x embed_dim ) = ( embed_dim x embed_dim ) + output_weight_grads = torch.mm(output_grads.view(output_grads.size(0) * output_grads.size(1), output_grads.size(2)).transpose(0,1), + matmul2_results.view(matmul2_results.size(0) * matmul2_results.size(1), matmul2_results.size(2))) + output_lin_grads = output_lin_grads.view(output_grads.size(0), output_grads.size(1)*heads_t[0], head_dim).transpose(0,1) + + if use_biases_t[0]: + output_bias_grads = torch.sum(output_grads.view(output_grads.size(0) * output_grads.size(1), output_grads.size(2)), 0) + else: + output_bias_grads = None + + # Matmul2 - DGRAD1 + # Input1: (data grads) [seql_q, seqs*heads, head_dim] transpose(0,1) + # Input2: (activations) [seql_k, seqs*heads, head_dim] transpose(0,1).transpose(1,2) + # Output: [seqs*heads, seql_q, seql_k] + # GEMM: Per batch: ( seql_q x head_dim ) x ( head_dim x seql_k ) = ( seql_q x seql_k ) + matmul2_dgrad1 = torch.bmm(output_lin_grads, values.transpose(0,1).transpose(1,2)) + # Matmul2 - DGRAD2 + # Input1: (data grads) [seql_q, seqs*heads, head_dim] transpose(0,1) + # Input2: (activations) [seql_k, seqs*heads, head_dim] transpose(0,1).transpose(1,2) + # Output: [seqs*heads, seql_q, seql_k] + # GEMM: Per batch: ( seql_q x head_dim ) x ( head_dim x seql_k ) = ( seql_q x seql_k ) + values_grads = torch.bmm(dropout_results.transpose(1,2), output_lin_grads, out=values_grads.transpose(0,1)) + + # Mask and Scaling for Dropout (not a publically documented op) + dropout_grads = torch._masked_scale(matmul2_dgrad1, dropout_mask, 1.0/(1.0-dropout_prob_t[0])) + + # Softmax Grad (not a publically documented op) + softmax_grads = torch._softmax_backward_data(dropout_grads, softmax_results, -1, softmax_results) + + # Matmul1 - DGRAD1 + # Input1: (data grads) [seqs*heads, seql_q, seql_k] + # Input2: (activations) [seql_k, seqs*heads, head_dim] transpose(0,1) + # Output: [seqs*heads, seql_q, head_dim] transpose(0,1) + # GEMM: Per batch: ( seql_q x seql_k ) x ( seql_k x head_dim ) = ( seql_q x head_dim ) + queries_grads = torch.baddbmm(queries_grads.transpose(0,1), softmax_grads, keys.transpose(0,1), + out=queries_grads.transpose(0,1), beta=0.0, alpha=scale_t[0]) + # Matmul1 - DGRAD2 + # Input1: (data grads) [seqs*heads, seql_q, seql_k] transpose(1,2) + # Input2: (activations) [seql_q, seqs*heads, head_dim] transpose(0,1) + # Output: [seqs*heads, seql_k, head_dim] transpose(0,1) + # GEMM: Per batch: ( seql_k x seql_q ) x ( seql_q x head_dim ) = ( seql_k x head_dim ) + keys_grads = torch.baddbmm(keys_grads.transpose(0,1), softmax_grads.transpose(1,2), queries.transpose(0,1), + out=keys_grads.transpose(0,1), beta=0.0, alpha=scale_t[0]) + + # Input Q Linear GEMM - DGRAD + # input1: (data grads) [seql_q, seqs, embed_dim(1024)] + # input2: (weights) [embed_dim (1024), embed_dim (1024)] + # output: [seql_q, seqs, embed_dim] + # GEMM: ( (seql_q*seqs) x embed_dim ) x ( embed_dim x embed_dim ) = (seql_q*seqs x embed_dim) + queries_grads = queries_grads.transpose(0,1).view(inputs_q.size(0)*inputs_q.size(1), heads_t[0]*head_dim) + input_q_grads = torch.mm(queries_grads, input_weights_q) + input_q_grads = input_q_grads.view(inputs_q.size(0), inputs_q.size(1), inputs_q.size(2)) + # Input KV Linear GEMM - DGRAD + # input1: (data grads) [seql_k, seqs, 2*embed_dim(2048)] + # input2: (weights) [embed_dim*2 (2048), embed_dim (1024)] + # output: [seql_k, seqs, embed_dim] + # GEMM: ( (seql_k*seqs) x 2*embed_dim ) x ( 2*embed_dim x embed_dim ) = (seql_k*seqs x embed_dim) + input_lin_kv_results_grads = input_lin_kv_results_grads.view(inputs_kv.size(0)*inputs_kv.size(1), heads_t[0]*2*head_dim) + input_kv_grads = torch.mm(input_lin_kv_results_grads, input_weights_kv) + input_kv_grads = input_kv_grads.view(inputs_kv.size(0), inputs_kv.size(1), inputs_kv.size(2)) + # Input Q Linear GEMM - WGRAD + # input1: (data grads) [seql_q*seqs, embed_dim(1024)] + # input2: (activations) [seql_q*seqs, embed_dim(1024)] + # output: [embed_dim, embed_dim] + # GEMM: ( embed_dim x seql_q*seqs ) x ( seql_q*seqs x embed_dim ) = (embed_dim x embed_dim) + input_weight_q_grads = torch.mm(queries_grads.transpose(0,1), inputs_q.view(inputs_q.size(0)*inputs_q.size(1), inputs_q.size(2))) + # Input KV Linear GEMM - WGRAD + # input1: (data grads) [seql_k*seqs, 2*embed_dim(2048)] + # input2: (activations) [seql_k*seqs, embed_dim(1024)] + # output: [2*embed_dim, embed_dim] + # GEMM: ( 2*embed_dim x seql_k*seqs ) x ( seql_k*seqs x embed_dim ) = (2*embed_dim x embed_dim) + input_weight_kv_grads = torch.mm(input_lin_kv_results_grads.transpose(0,1), inputs_kv.view(inputs_kv.size(0)*inputs_kv.size(1), inputs_kv.size(2))) + + if use_biases_t[0]: + input_bias_grads_q = torch.sum(queries_grads, 0) + input_bias_grads_kv = torch.sum(input_lin_kv_results_grads, 0) + else: + input_bias_grads_q = None + input_bias_grads_kv = None + + return None, None, None, None, \ + input_q_grads, input_kv_grads, \ + input_weight_q_grads, input_weight_kv_grads, output_weight_grads, \ + input_bias_grads_q, input_bias_grads_kv, output_bias_grads, \ + None, None + +encdec_attn_func = EncdecAttnFunc.apply diff --git a/apex/apex/contrib/multihead_attn/fast_encdec_multihead_attn_func.py b/apex/apex/contrib/multihead_attn/fast_encdec_multihead_attn_func.py new file mode 100644 index 0000000000000000000000000000000000000000..d56837aacec845e1ce2f20efdfb6a2fcee655d17 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/fast_encdec_multihead_attn_func.py @@ -0,0 +1,88 @@ +import torch +import fast_encdec_multihead_attn + + +class FastEncdecAttnFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, use_time_mask, is_training, heads, inputs_q, inputs_kv, input_weights_q, input_weights_kv, output_weights, pad_mask, dropout_prob): + heads_t = torch.tensor([heads]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + use_mask = (pad_mask is not None) + + input_lin_q_results, \ + input_lin_kv_results, \ + softmax_results, \ + dropout_results, \ + dropout_mask, \ + matmul2_results, \ + outputs = \ + fast_encdec_multihead_attn.forward( \ + use_mask, \ + use_time_mask, \ + is_training, \ + heads, \ + inputs_q, \ + inputs_kv, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + + ctx.save_for_backward(heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + inputs_q, \ + inputs_kv, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t) + + return outputs.detach() + + @staticmethod + def backward(ctx, output_grads): + heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + inputs_q, \ + inputs_kv, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t = ctx.saved_tensors + + input_q_grads, \ + input_kv_grads, \ + input_weight_q_grads, \ + input_weight_kv_grads, \ + output_weight_grads = \ + fast_encdec_multihead_attn.backward( \ + heads_t[0], \ + output_grads, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + inputs_q, \ + inputs_kv, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t[0]) + + return None, None, None, input_q_grads, input_kv_grads, input_weight_q_grads, input_weight_kv_grads, output_weight_grads, None, None + +fast_encdec_attn_func = FastEncdecAttnFunc.apply diff --git a/apex/apex/contrib/multihead_attn/fast_encdec_multihead_attn_norm_add_func.py b/apex/apex/contrib/multihead_attn/fast_encdec_multihead_attn_norm_add_func.py new file mode 100644 index 0000000000000000000000000000000000000000..213102bf15a752db27b2586906651754a79a2762 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/fast_encdec_multihead_attn_norm_add_func.py @@ -0,0 +1,130 @@ +# Copyright (c) 2017-present, Facebook, Inc. +# All rights reserved. +# +# This source code is licensed under the license found in the LICENSE file in +# the root directory of this source tree. An additional grant of patent rights +# can be found in the PATENTS file in the same directory. + +import torch +import fast_encdec_multihead_attn_norm_add + + +class FastEncdecAttnNormAddFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, use_time_mask, is_training, heads, inputs_q, inputs_kv, lyr_nrm_gamma_weights, lyr_nrm_beta_weights, input_weights_q, input_weights_kv, output_weights, pad_mask, dropout_prob): + heads_t = torch.tensor([heads]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + use_mask = (pad_mask is not None) + + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + input_lin_q_results, \ + input_lin_kv_results, \ + softmax_results, \ + dropout_results, \ + dropout_mask, \ + matmul2_results, \ + dropout_add_mask, \ + outputs = \ + fast_encdec_multihead_attn_norm_add.forward( \ + use_mask, \ + use_time_mask, \ + is_training, \ + heads, \ + inputs_q, \ + inputs_kv, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + + ctx.save_for_backward(heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + inputs_q, \ + inputs_kv, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_add_mask, \ + dropout_prob_t) + + return outputs.detach() + + @staticmethod + def backward(ctx, output_grads): + heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + inputs_q, \ + inputs_kv, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_add_mask, \ + dropout_prob_t = ctx.saved_tensors + + input_q_grads, \ + input_kv_grads, \ + lyr_nrm_gamma_grads, \ + lyr_nrm_beta_grads, \ + input_weight_q_grads, \ + input_weight_kv_grads, \ + output_weight_grads = \ + fast_encdec_multihead_attn_norm_add.backward( \ + heads_t[0], \ + output_grads, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_q_results, \ + input_lin_kv_results, \ + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + inputs_q, \ + inputs_kv, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights_q, \ + input_weights_kv, \ + output_weights, \ + dropout_mask, \ + dropout_add_mask, \ + dropout_prob_t[0]) + + #import pdb; pdb.set_trace() + return None, None, None, \ + input_q_grads, \ + input_kv_grads, \ + lyr_nrm_gamma_grads, \ + lyr_nrm_beta_grads, \ + input_weight_q_grads, \ + input_weight_kv_grads, \ + output_weight_grads, \ + None, None + +fast_encdec_attn_norm_add_func = FastEncdecAttnNormAddFunc.apply diff --git a/apex/apex/contrib/multihead_attn/fast_self_multihead_attn_func.py b/apex/apex/contrib/multihead_attn/fast_self_multihead_attn_func.py new file mode 100644 index 0000000000000000000000000000000000000000..1c75f9ead1648ead60168227c7abced7a967b13c --- /dev/null +++ b/apex/apex/contrib/multihead_attn/fast_self_multihead_attn_func.py @@ -0,0 +1,196 @@ +import torch +import fast_self_multihead_attn +import fast_self_multihead_attn_bias +import fast_self_multihead_attn_bias_additive_mask + +class FastSelfAttnFunc(torch.autograd.Function) : + @staticmethod + def forward(ctx, use_time_mask, is_training, heads, inputs, input_weights, output_weights, input_biases, output_biases, pad_mask, mask_additive, dropout_prob): + use_biases_t = torch.tensor([input_biases is not None]) + heads_t = torch.tensor([heads]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + use_mask = (pad_mask is not None) + mask_additive_t= torch.tensor([mask_additive]) + + if use_biases_t[0]: + if not mask_additive: + input_lin_results, \ + softmax_results, \ + dropout_results, \ + dropout_mask, \ + matmul2_results, \ + outputs = \ + fast_self_multihead_attn_bias.forward( \ + use_mask, \ + use_time_mask, \ + is_training, \ + heads, \ + inputs, \ + input_weights, \ + output_weights, \ + input_biases, \ + output_biases, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + ctx.save_for_backward(use_biases_t, \ + heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + null_tensor, \ + null_tensor, \ + mask_additive_t, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t) + + else: + input_lin_results, \ + bmm1_results, \ + dropout_results, \ + dropout_mask, \ + matmul2_results, \ + outputs = \ + fast_self_multihead_attn_bias_additive_mask.forward( \ + use_mask, \ + use_time_mask, \ + is_training, \ + heads, \ + inputs, \ + input_weights, \ + output_weights, \ + input_biases, \ + output_biases, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + ctx.save_for_backward(use_biases_t, \ + heads_t, \ + matmul2_results, \ + dropout_results, \ + null_tensor, \ + bmm1_results, \ + pad_mask, \ + mask_additive_t, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t) + + + else: + input_lin_results, \ + softmax_results, \ + dropout_results, \ + dropout_mask, \ + matmul2_results, \ + outputs = \ + fast_self_multihead_attn.forward( \ + use_mask, \ + use_time_mask, \ + is_training, \ + heads, \ + inputs, \ + input_weights, \ + output_weights, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + ctx.save_for_backward(use_biases_t, \ + heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + null_tensor, \ + null_tensor, \ + mask_additive_t, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t) + return outputs.detach() + + @staticmethod + def backward(ctx, output_grads): + use_biases_t, \ + heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + bmm1_results, \ + pad_mask, \ + mask_additive_t, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t = ctx.saved_tensors + + if use_biases_t[0]: + if not mask_additive_t[0]: + input_grads, \ + input_weight_grads, \ + output_weight_grads, \ + input_bias_grads, \ + output_bias_grads = \ + fast_self_multihead_attn_bias.backward( \ + heads_t[0], \ + output_grads, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t[0]) + + else: + input_grads, \ + input_weight_grads, \ + output_weight_grads, \ + input_bias_grads, \ + output_bias_grads = \ + fast_self_multihead_attn_bias_additive_mask.backward( \ + heads_t[0], \ + output_grads, \ + matmul2_results, \ + dropout_results, \ + bmm1_results, \ + pad_mask, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t[0]) + + else: + input_bias_grads = None + output_bias_grads = None + input_grads, \ + input_weight_grads, \ + output_weight_grads = \ + fast_self_multihead_attn.backward( \ + heads_t[0], \ + output_grads, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t[0]) + return None, None, None, input_grads, input_weight_grads, output_weight_grads,input_bias_grads, output_bias_grads, None, None, None + +fast_self_attn_func = FastSelfAttnFunc.apply diff --git a/apex/apex/contrib/multihead_attn/fast_self_multihead_attn_norm_add_func.py b/apex/apex/contrib/multihead_attn/fast_self_multihead_attn_norm_add_func.py new file mode 100644 index 0000000000000000000000000000000000000000..9a37985cd953d544df9fe2fe62c0c3dc4d3cac11 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/fast_self_multihead_attn_norm_add_func.py @@ -0,0 +1,106 @@ +import torch +import fast_self_multihead_attn_norm_add + + +class FastSelfAttnNormAddFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, use_time_mask, is_training, heads, inputs, lyr_nrm_gamma_weights, lyr_nrm_beta_weights, input_weights, output_weights, pad_mask, dropout_prob): + heads_t = torch.tensor([heads]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + use_mask = (pad_mask is not None) + + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + input_lin_results, \ + softmax_results, \ + dropout_results, \ + dropout_mask, \ + matmul2_results, \ + dropout_add_mask, \ + outputs = \ + fast_self_multihead_attn_norm_add.forward( \ + use_mask, \ + use_time_mask, \ + is_training, \ + heads, \ + inputs, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights, \ + output_weights, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + + ctx.save_for_backward(heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + inputs, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_add_mask, \ + dropout_prob_t) + + return outputs.detach() + + @staticmethod + def backward(ctx, output_grads): + heads_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + inputs, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_add_mask, \ + dropout_prob_t = ctx.saved_tensors + + input_grads, \ + lyr_nrm_gamma_grads, \ + lyr_nrm_beta_grads, \ + input_weight_grads, \ + output_weight_grads = \ + fast_self_multihead_attn_norm_add.backward( \ + heads_t[0], \ + output_grads, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + lyr_nrm_results, \ + lyr_nrm_mean, \ + lyr_nrm_invvar, \ + inputs, \ + lyr_nrm_gamma_weights, \ + lyr_nrm_beta_weights, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_add_mask, \ + dropout_prob_t[0]) + + return None, None, None, \ + input_grads, \ + lyr_nrm_gamma_grads, \ + lyr_nrm_beta_grads, \ + input_weight_grads, \ + output_weight_grads, \ + None, None + +fast_self_attn_norm_add_func = FastSelfAttnNormAddFunc.apply diff --git a/apex/apex/contrib/multihead_attn/mask_softmax_dropout_func.py b/apex/apex/contrib/multihead_attn/mask_softmax_dropout_func.py new file mode 100644 index 0000000000000000000000000000000000000000..516e6d859dc7b67fc2bb3a16e63d2f0c23bf44e2 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/mask_softmax_dropout_func.py @@ -0,0 +1,81 @@ +import torch +import fast_mask_softmax_dropout +import fast_additive_mask_softmax_dropout + + +class MaskSoftmaxDropout(torch.autograd.Function) : + @staticmethod + def forward(ctx, is_training, heads, inputs, pad_mask, mask_additive, dropout_prob): + heads_t = torch.tensor([heads]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + use_mask = (pad_mask is not None) + use_mask_t = torch.tensor([use_mask]) + mask_additive_t = torch.tensor([mask_additive]) + + if mask_additive: + dropout_results, \ + dropout_mask, \ + softmax_results = \ + fast_additive_mask_softmax_dropout.forward( \ + use_mask, \ + is_training, \ + heads, \ + inputs, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + else: + dropout_results, \ + dropout_mask, \ + softmax_results = \ + fast_mask_softmax_dropout.forward( \ + use_mask, \ + is_training, \ + heads, \ + inputs, \ + pad_mask if use_mask else null_tensor, \ + dropout_prob) + + ctx.save_for_backward( + use_mask_t, \ + heads_t, \ + softmax_results, \ + dropout_mask, \ + pad_mask if use_mask else null_tensor, \ + mask_additive_t, \ + dropout_prob_t) + + return dropout_results.detach() + + @staticmethod + def backward(ctx, output_grads): + use_mask_t, \ + heads_t, \ + softmax_results, \ + dropout_mask, \ + pad_mask, \ + mask_additive_t, \ + dropout_prob_t = ctx.saved_tensors + + if mask_additive_t[0]: + input_grads = \ + fast_additive_mask_softmax_dropout.backward( \ + use_mask_t[0], \ + heads_t[0], \ + output_grads, \ + softmax_results, \ + dropout_mask, \ + dropout_prob_t[0]) + else: + input_grads = \ + fast_mask_softmax_dropout.backward( \ + use_mask_t[0], \ + heads_t[0], \ + output_grads, \ + softmax_results, \ + dropout_mask, \ + pad_mask, \ + dropout_prob_t[0]) + return None, None, input_grads, None, None, None + +fast_mask_softmax_dropout_func = MaskSoftmaxDropout.apply diff --git a/apex/apex/contrib/multihead_attn/self_multihead_attn.py b/apex/apex/contrib/multihead_attn/self_multihead_attn.py new file mode 100644 index 0000000000000000000000000000000000000000..6b9714be07e1075ecca49746518c220be8a9b4a9 --- /dev/null +++ b/apex/apex/contrib/multihead_attn/self_multihead_attn.py @@ -0,0 +1,178 @@ +import math + +import torch +from torch import nn +from torch.nn import Parameter +import torch.nn.functional as F + +from .self_multihead_attn_func import self_attn_func +from .fast_self_multihead_attn_func import fast_self_attn_func +from .fast_self_multihead_attn_norm_add_func import fast_self_attn_norm_add_func +from apex.normalization.fused_layer_norm import FusedLayerNorm + +if hasattr(torch._C, '_jit_set_profiling_executor') : + torch._C._jit_set_profiling_executor(False) +if hasattr(torch._C, '_jit_set_profiling_mode') : + torch._C._jit_set_profiling_mode(False) + +@torch.jit.script +def jit_dropout_add(x, residual, prob, is_training): + # type: (Tensor, Tensor, float, bool) -> Tensor + out = F.dropout(x, p=prob, training=True) + out = residual + out + return out + + +class SelfMultiheadAttn(nn.Module): + """Multi-headed attention. + + See "Attention Is All You Need" for more details. + """ + def __init__(self, embed_dim, num_heads, dropout=0., bias=False, include_norm_add=False, impl='fast', separate_qkv_params=False, mask_additive=False): + super().__init__() + self.embed_dim = embed_dim + self.num_heads = num_heads + self.dropout = dropout + self.head_dim = embed_dim // num_heads + assert self.head_dim * num_heads == self.embed_dim, "embed_dim must be divisible by num_heads" + self.bias = bias + self.include_norm_add = include_norm_add + self.impl = impl + self.scaling = self.head_dim**-0.5 + self.separate_qkv_params = separate_qkv_params + self.mask_additive = mask_additive + if mask_additive: + assert self.include_norm_add == False, "additive mask not supported with layer norm" + assert impl == 'default' or (impl == 'fast' and bias), "additive mask not supported for fast mode without bias" + if separate_qkv_params: + self.q_weight = Parameter(torch.Tensor(embed_dim, embed_dim)) + self.k_weight = Parameter(torch.Tensor(embed_dim, embed_dim)) + self.v_weight = Parameter(torch.Tensor(embed_dim, embed_dim)) + else: + self.in_proj_weight = Parameter(torch.Tensor(3*embed_dim, embed_dim)) + self.out_proj_weight = Parameter(torch.Tensor(embed_dim, embed_dim)) + if self.bias: + if separate_qkv_params: + self.q_bias = Parameter(torch.Tensor(embed_dim)) + self.k_bias = Parameter(torch.Tensor(embed_dim)) + self.v_bias = Parameter(torch.Tensor(embed_dim)) + else: + self.in_proj_bias = Parameter(torch.Tensor(3*embed_dim)) + self.out_proj_bias = Parameter(torch.Tensor(embed_dim)) + else: + if separate_qkv_params: + self.register_parameter('q_bias', None) + self.register_parameter('k_bias', None) + self.register_parameter('v_bias', None) + self.q_bias = None + self.k_bias = None + self.v_bias = None + else: + self.register_parameter('in_proj_bias', None) + self.in_proj_bias = None + self.register_parameter('out_proj_bias', None) + self.out_proj_bias = None + if self.include_norm_add: + if impl == 'fast': + self.lyr_nrm_gamma_weights = Parameter(torch.Tensor(embed_dim)) + self.lyr_nrm_beta_weights = Parameter(torch.Tensor(embed_dim)) + self.lyr_nrm = None + else: + self.register_parameter('lyr_norm_gamma_weights', None) + self.register_parameter('lyr_norm_beta_weights', None) + self.lyr_nrm_gamma_weights = None + self.lyr_nrm_beta_weights = None + self.lyr_nrm = FusedLayerNorm(embed_dim) + self.reset_parameters() + + if self.include_norm_add: + if impl == 'fast' : self.attn_func = fast_self_attn_norm_add_func + elif impl == 'default' : self.attn_func = self_attn_func + else : assert False, "Unsupported impl: {} !".format(impl) + else: + if impl == 'fast' : self.attn_func = fast_self_attn_func + elif impl == 'default' : self.attn_func = self_attn_func + else : assert False, "Unsupported impl: {} !".format(impl) + + def reset_parameters(self): + if self.separate_qkv_params: + nn.init.xavier_uniform_(self.q_weight) + nn.init.xavier_uniform_(self.k_weight) + nn.init.xavier_uniform_(self.v_weight) + else: + # in_proj_weight has shape [3 * hidden, hidden] but it should be + # initialized like a [hidden, hidden] matrix. + # sqrt(6 / (hidden + hidden)) / sqrt(6 / (3 * hidden + hidden)) = sqrt(2) + # therefore xavier_uniform gain should be set to sqrt(2). + nn.init.xavier_uniform_(self.in_proj_weight, gain=math.sqrt(2)) + nn.init.xavier_uniform_(self.out_proj_weight) + if self.bias: + if self.separate_qkv_params: + nn.init.constant_(self.q_bias, 0.) + nn.init.constant_(self.k_bias, 0.) + nn.init.constant_(self.v_bias, 0.) + else: + nn.init.constant_(self.in_proj_bias, 0.) + nn.init.constant_(self.out_proj_bias, 0.) + if self.include_norm_add: + if self.impl == 'fast': + nn.init.ones_(self.lyr_nrm_gamma_weights) + nn.init.zeros_(self.lyr_nrm_beta_weights) + else: + self.lyr_nrm.reset_parameters() + + def forward(self, query, key, value, key_padding_mask=None, need_weights=False, attn_mask=None, is_training=True): + """Input shape: Time x Batch x Channel + + Self-attention can be implemented by passing in the same arguments for + query, key and value. Future timesteps can be masked with the + `mask_future_timesteps` argument. Padding elements can be excluded from + the key by passing a binary ByteTensor (`key_padding_mask`) with shape: + batch x src_len, where padding elements are indicated by 1s. + """ + if self.separate_qkv_params: + input_weights = torch.cat([self.q_weight.view(self.num_heads,1,self.head_dim,self.embed_dim), self.k_weight.view(self.num_heads,1,self.head_dim,self.embed_dim), self.v_weight.view(self.num_heads,1,self.head_dim,self.embed_dim)], dim=1).reshape(3*self.embed_dim,self.embed_dim).contiguous() + else: + input_weights = self.in_proj_weight + if self.bias: + if self.separate_qkv_params: + input_bias = torch.cat([self.q_bias.view(self.num_heads,1,self.head_dim), self.k_bias.view(self.num_heads,1,self.head_dim), self.v_bias.view(self.num_heads,1,self.head_dim)],dim=1).reshape(3*self.embed_dim).contiguous() + else: + input_bias = self.in_proj_bias + else: + input_bias=None + if key_padding_mask is not None: + assert (attn_mask is None), "ERROR attn_mask and key_padding_mask should not be both defined!" + mask = key_padding_mask + elif attn_mask is not None: + assert self.mask_additive == False, "additive mask not supported for time mask" + mask = attn_mask + else: + mask = None + + if self.include_norm_add: + if self.impl == 'fast': + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, query, + self.lyr_nrm_gamma_weights, self.lyr_nrm_beta_weights, + input_weights, self.out_proj_weight, mask, self.dropout) + else: + lyr_nrm_results = self.lyr_nrm(query) + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, self.scaling, lyr_nrm_results, + input_weights, self.out_proj_weight, + input_bias, self.out_proj_bias, + mask, self.dropout) + if is_training: + outputs = jit_dropout_add(outputs, query, self.dropout, is_training) + else: + outputs = outputs + query + else: + if self.impl == 'fast': + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, query, + input_weights, self.out_proj_weight, input_bias, self.out_proj_bias, mask, self.mask_additive, self.dropout) + else: + outputs = self.attn_func(attn_mask is not None, is_training, self.num_heads, self.scaling, query, + input_weights, self.out_proj_weight, + input_bias, self.out_proj_bias, + mask, self.mask_additive, self.dropout) + + return outputs,None diff --git a/apex/apex/contrib/multihead_attn/self_multihead_attn_func.py b/apex/apex/contrib/multihead_attn/self_multihead_attn_func.py new file mode 100644 index 0000000000000000000000000000000000000000..522dd446af0b86e27d5005310bfc72f2099d262f --- /dev/null +++ b/apex/apex/contrib/multihead_attn/self_multihead_attn_func.py @@ -0,0 +1,235 @@ +import torch +import torch.nn.functional as F + +class SelfAttnFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, use_time_mask, is_training, heads, scale, inputs, + input_weights, output_weights, + input_biases, output_biases, + mask, is_additive_mask, dropout_prob): + use_biases_t = torch.tensor([input_biases is not None]) + heads_t = torch.tensor([heads]) + scale_t = torch.tensor([scale]) + dropout_prob_t = torch.tensor([dropout_prob]) + null_tensor = torch.tensor([]) + head_dim = inputs.size(2) // heads + + # Input Linear GEMM + # input1: (activations) [seql_q, seqs, embed_dim(1024)] + # input2: (weights) [embed_dim*3 (3072), embed_dim (1024)] (transpose [0,1]) + # output: [seql_q, seqs, embed_dim*3] + # GEMM: ( (seql_q*seqs) x embed_dim ) x ( embed_dim x embed_dim*3 ) = (seql_q*seqs x embed_dim*3) + if use_biases_t[0]: + input_lin_results = torch.addmm(input_biases, + inputs.view(inputs.size(0) * inputs.size(1), inputs.size(2)), + input_weights.transpose(0,1), + beta=1., alpha=1.) + else: + input_lin_results = torch.mm(inputs.view(inputs.size(0) * inputs.size(1), inputs.size(2)), input_weights.transpose(0,1)) + input_lin_results = input_lin_results.view(inputs.size(0), inputs.size(1), input_weights.size(0)) + + # Slice out q,k,v from one big Input Linear outuput (should only impact meta data, no copies!) + # Sequences and heads are combined to make the batch of the Batched GEMM + # input_lin_results: [seql_q, seqs, heads(16), 3, head_dim(64)] + # input_lin_results: [seql_q, batches=seqs*heads, 3, head_dim] + input_lin_results = input_lin_results.view(inputs.size(0), inputs.size(1)*heads, 3, head_dim) + queries = input_lin_results[:,:,0,:] + keys = input_lin_results[:,:,1,:] + values = input_lin_results[:,:,2,:] + + # Matmul1 Batched GEMMs + # The output tensor is specified prior to the Batch GEMM because baddbmm requires its specification + # baddbmm is used to apply the scale parameter via the Batched GEMM's alpha parameter instead of + # a separate elementwise operation. + # Input1: (Queries) [seql_q, seqs*heads, head_dim] tranpose(0,1) + # Input2: (Keys) [seql_k, seqs*heads, head_dim] transpose(0,1) + # output: [seqs*heads, seql_q, seql_k] + # GEMM: Per batch: ( seql_q x head_dim ) x ( head_dim x seql_k ) = ( seql_q x seql_k ) + matmul1_results = torch.empty((queries.size(1),queries.size(0),keys.size(0)), dtype=queries.dtype, device=torch.device('cuda')) + matmul1_results = torch.baddbmm(matmul1_results, queries.transpose(0,1), keys.transpose(0,1).transpose(1,2), out=matmul1_results, beta=0.0, alpha=scale_t[0]) + + if mask is not None: + # Self Attention Time Mask + if use_time_mask: + assert (len(mask.size()) == 2), "Timing mask is not 2D!" + assert (mask.size(0) == mask.size(1)), "Sequence length should match!" + mask = mask.to(torch.bool) + matmul1_results = matmul1_results.masked_fill_(mask, float('-inf')) + # Key Padding Mask + else: + batches,seql_q,seql_k = matmul1_results.size() + seqs = int(batches / heads) + matmul1_results = matmul1_results.view(seqs, heads, seql_q, seql_k) + if is_additive_mask: + matmul1_results = matmul1_results + mask.unsqueeze(1).unsqueeze(2) + else: + mask = mask.to(torch.bool) + matmul1_results = matmul1_results.masked_fill_(mask.unsqueeze(1).unsqueeze(2), float('-inf')) + matmul1_results = matmul1_results.view(seqs*heads, seql_q, seql_k) + + softmax_results = F.softmax(matmul1_results, dim=-1) + + # Dropout - is not executed for inference + if is_training: + dropout_results,dropout_mask = torch._fused_dropout(softmax_results, p=(1.-dropout_prob_t[0])) + else: + dropout_results = softmax_results + dropout_mask = null_tensor + + # Matmul2 Batched GEMMs + # The output tensor specification is needed here to specify the non-standard output. + # Given that pytorch cannot currently perform autograd with an output tensor specified, + # this requires a backward pass specified. + # Input1: from_softmax [seqs*heads, seql_q, seql_k] + # Input2: (values) [seql_v, seqs*heads, head_dim] transpose(0,1) + # Output: [seql_q, seqs*heads, head_dim] transpose(0,1) + # GEMM: Per batch: ( seql_q x seql_k ) x ( seql_k x head_dim ) = (seql_q x head_dim) + matmul2_results = torch.empty((dropout_results.size(1), dropout_results.size(0), values.size(2)), dtype=dropout_results.dtype, device=torch.device('cuda')).transpose(1,0) + matmul2_results = torch.bmm(dropout_results, values.transpose(0,1), out=matmul2_results) + matmul2_results = matmul2_results.transpose(0, 1).contiguous().view(inputs.size(0), inputs.size(1), inputs.size(2)) + + # Output Linear GEMM + # Input1: (activations) [seql_q, seqs, embed_dim=heads*head_dim] + # Input2: (weights) [ embed_dim, embed_dim ] transpose(0,1) + # Output: [ seql_q, seqs, embed_dim ] + # GEMM: ( seql_q*seqs x embed_dim ) x ( embed_dim x embed_dim ) = ( seql_q*seqs x embed_dim ) + if use_biases_t[0]: + outputs = torch.addmm(output_biases, + matmul2_results.view(inputs.size(0) * inputs.size(1), inputs.size(2)), + output_weights.transpose(0,1), + beta=1., alpha=1.) + else: + outputs = torch.mm(matmul2_results.view(inputs.size(0) * inputs.size(1), inputs.size(2)), output_weights.transpose(0,1)) + outputs = outputs.view(inputs.size(0), inputs.size(1), output_weights.size(0)) + + ctx.save_for_backward(use_biases_t, \ + heads_t, \ + scale_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t) + + return outputs.detach() + + @staticmethod + def backward(ctx, output_grads): + use_biases_t, \ + heads_t, \ + scale_t, \ + matmul2_results, \ + dropout_results, \ + softmax_results, \ + input_lin_results, \ + inputs, \ + input_weights, \ + output_weights, \ + dropout_mask, \ + dropout_prob_t = ctx.saved_tensors + + head_dim = inputs.size(2) // heads_t[0] + + # Slice out q,k,v from one big Input Linear outuput (should only impact meta data, no copies!) + # Sequences and heads are combined to make the batch of the Batched GEMM + # input_lin_results: [seql_q, seqs, heads(16), 3, head_dim(64)] + # input_lin_results: [seql_q, batches=seqs*heads, 3, head_dim] + input_lin_results = input_lin_results.view(inputs.size(0), inputs.size(1)*heads_t[0], 3, head_dim) + queries = input_lin_results[:,:,0,:] + keys = input_lin_results[:,:,1,:] + values = input_lin_results[:,:,2,:] + + # Slice out q,k,v from one big set of gradients entering the input linear's bprop (should only impact meta data, no copies!) + # The gradients are identical in size to the Input Linear outputs. + # The tensor is declared before hand to properly slice out query, key, and value grads. + input_lin_results_grads = torch.empty_like(input_lin_results) + queries_grads = input_lin_results_grads[:,:,0,:] + keys_grads = input_lin_results_grads[:,:,1,:] + values_grads = input_lin_results_grads[:,:,2,:] + + # Output Linear GEMM - DGRAD + # Input1: (data grads) [seql_q, seqs, embed_dim=heads*head_dim] + # Input2: (weights) [ embed_dim, embed_dim ] + # Output: [ seql_q, seqs, embed_dim ] + # GEMM: ( seql_q*seqs x embed_dim ) x ( embed_dim x embed_dim ) = ( seql_q*seqs x embed_dim ) + output_lin_grads = torch.mm(output_grads.view(output_grads.size(0) * output_grads.size(1), output_grads.size(2)), output_weights) + output_lin_grads = output_lin_grads.view(output_grads.size(0), output_grads.size(1), output_weights.size(1)) + # Output Linear GEMM - WGRAD + # Input1: (data grads) [seql_q*seqs, embed_dim=heads*head_dim] transpose(0,1) + # Input2: (activations) [seql_q*seqs, embed_dim ] + # Output: [ seql_q, seqs, embed_dim ] + # GEMM: ( embed_dim x seql_q*seqs ) x ( seql_q*seqs x embed_dim ) = ( embed_dim x embed_dim ) + output_weight_grads = torch.mm(output_grads.view(output_grads.size(0) * output_grads.size(1), output_grads.size(2)).transpose(0,1), + matmul2_results.view(matmul2_results.size(0) * matmul2_results.size(1), matmul2_results.size(2))) + output_lin_grads = output_lin_grads.view(inputs.size(0), inputs.size(1)*heads_t[0], head_dim).transpose(0,1) + + if use_biases_t[0]: + output_bias_grads = torch.sum(output_grads.view(output_grads.size(0) * output_grads.size(1), output_grads.size(2)), 0) + else: + output_bias_grads = None + + # Matmul2 - DGRAD1 + # Input1: (data grads) [seql_q, seqs*heads, head_dim] transpose(0,1) + # Input2: (activations) [seql_k, seqs*heads, head_dim] transpose(0,1).transpose(1,2) + # Output: [seqs*heads, seql_q, seql_k] + # GEMM: Per batch: ( seql_q x head_dim ) x ( head_dim x seql_k ) = ( seql_q x seql_k ) + matmul2_dgrad1 = torch.bmm(output_lin_grads, values.transpose(0,1).transpose(1,2)) + # Matmul2 - DGRAD2 + # Input1: (data grads) [seql_q, seqs*heads, head_dim] transpose(0,1) + # Input2: (activations) [seql_k, seqs*heads, head_dim] transpose(0,1).transpose(1,2) + # Output: [seqs*heads, seql_q, seql_k] + # GEMM: Per batch: ( seql_q x head_dim ) x ( head_dim x seql_k ) = ( seql_q x seql_k ) + values_grads = torch.bmm(dropout_results.transpose(1,2), output_lin_grads, out=values_grads.transpose(0,1)) + + # Mask and Scaling for Dropout (not a publically documented op) + dropout_grads = torch._masked_scale(matmul2_dgrad1, dropout_mask, 1.0/(1.0-dropout_prob_t[0])) + + # Softmax Grad (not a publically documented op) + softmax_grads = torch._softmax_backward_data(dropout_grads, softmax_results, -1, softmax_results) + + # Matmul1 - DGRAD1 + # Input1: (data grads) [seqs*heads, seql_q, seql_k] + # Input2: (activations) [seql_k, seqs*heads, head_dim] transpose(0,1) + # Output: [seqs*heads, seql_q, head_dim] transpose(0,1) + # GEMM: Per batch: ( seql_q x seql_k ) x ( seql_k x head_dim ) = ( seql_q x head_dim ) + queries_grads = torch.baddbmm(queries_grads.transpose(0,1), softmax_grads, keys.transpose(0,1), + out=queries_grads.transpose(0,1), beta=0.0, alpha=scale_t[0]) + # Matmul1 - DGRAD2 + # Input1: (data grads) [seqs*heads, seql_q, seql_k] transpose(1,2) + # Input2: (activations) [seql_q, seqs*heads, head_dim] transpose(0,1) + # Output: [seqs*heads, seql_k, head_dim] transpose(0,1) + # GEMM: Per batch: ( seql_k x seql_q ) x ( seql_q x head_dim ) = ( seql_k x head_dim ) + keys_grads = torch.baddbmm(keys_grads.transpose(0,1), softmax_grads.transpose(1,2), queries.transpose(0,1), + out=keys_grads.transpose(0,1), beta=0.0, alpha=scale_t[0]) + + # Input Linear GEMM - DGRAD + # input1: (data grads) [seql_q, seqs, 3*embed_dim(3072)] + # input2: (weights) [embed_dim*3 (3072), embed_dim (1024)] + # output: [seql_q, seqs, embed_dim] + # GEMM: ( (seql_q*seqs) x 3*embed_dim ) x ( 3*embed_dim x embed_dim ) = (seql_q*seqs x embed_dim) + input_lin_results_grads = input_lin_results_grads.view(inputs.size(0)*inputs.size(1), heads_t[0]*3*head_dim) + input_grads = torch.mm(input_lin_results_grads, input_weights) + input_grads = input_grads.view(inputs.size(0), inputs.size(1), inputs.size(2)) + # Input Linear GEMM - WGRAD + # input1: (data grads) [seql_q*seqs, 3*embed_dim(3072)] + # input2: (activations) [seql_q*seqs, embed_dim(1024)] + # output: [3*embed_dim, embed_dim] + # GEMM: ( 3*embed_dim x seql_q*seqs ) x ( seql_q*seqs x embed_dim ) = (3*embed_dim x embed_dim) + input_weight_grads = torch.mm(input_lin_results_grads.transpose(0,1), inputs.view(inputs.size(0)*inputs.size(1), inputs.size(2))) + + if use_biases_t[0]: + input_bias_grads = torch.sum(input_lin_results_grads, 0) + else: + input_bias_grads = None + + return None, None, None, None, \ + input_grads, \ + input_weight_grads, output_weight_grads, \ + input_bias_grads, output_bias_grads, \ + None, None + +self_attn_func = SelfAttnFunc.apply diff --git a/apex/apex/contrib/optimizers/__init__.py b/apex/apex/contrib/optimizers/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..1933b2fdb657f67938b517422b4b21e2c7ce67e6 --- /dev/null +++ b/apex/apex/contrib/optimizers/__init__.py @@ -0,0 +1,3 @@ +from .fp16_optimizer import FP16_Optimizer +from .fused_adam import FusedAdam +from .fused_lamb import FusedLAMB diff --git a/apex/apex/contrib/optimizers/distributed_fused_adam.py b/apex/apex/contrib/optimizers/distributed_fused_adam.py new file mode 100644 index 0000000000000000000000000000000000000000..d9aa9bce7bd867567d4edd9b9fd7a023f89aa258 --- /dev/null +++ b/apex/apex/contrib/optimizers/distributed_fused_adam.py @@ -0,0 +1,636 @@ +import math +import torch +import importlib +import amp_C +from apex.multi_tensor_apply import multi_tensor_applier + +import torch.distributed.distributed_c10d as c10d + +class DistributedFusedAdam(torch.optim.Optimizer): + + """Implements Adam algorithm. Currently GPU-only. Requires Apex to be installed via + ``python setup.py install --cuda_ext --cpp_ext``. + + It has been proposed in `Adam: A Method for Stochastic Optimization`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + eps_inside_sqrt (boolean, optional): in the 'update parameters' step, + adds eps to the bias-corrected second moment estimate before + evaluating square root instead of adding it to the square root of + second moment estimate as in the original paper. (default: False) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + (default: False) NOT SUPPORTED in FusedAdam! + overlap_reductions(boolean, optional): whether to overlap reductions + with bprop (default: True) + step_supports_amp_scaling(boolean, optional): whether to use customized + gradient unscaling logic (default: True) + num_process_groups (integer, optional): number of process groups in + the app (default: 1) + current_process_group (object, optional): the process group to work on + (default: None) + process_group_id (integer, optional): process group id (default: 0) + process_group_size (integer, optional): size of process group + (default: 0) + clip_grad_norm (boolean, optional): whether to handle gradient clipping + (default: True) + model_parallel (boolean, optional): whether model parallelism is used + (default: False) + + + .. _Adam\: A Method for Stochastic Optimization: + https://arxiv.org/abs/1412.6980 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, + lr=1e-3, bias_correction=True, betas=(0.9, 0.999), + eps=1e-8, eps_inside_sqrt=False, + weight_decay=0., max_grad_norm=0., + amsgrad=False, flat_mt=False, + overlap_reductions=True, + compute_L2_grad_norm=False, + dwu_group_size=0, dwu_num_blocks=4, dwu_num_chunks=4, + dwu_num_rs_pg=1, dwu_num_ar_pg=4, dwu_num_ag_pg=0, + predivide=True, e5m2_allgather=False, + do_not_flatten_model=False, + step_supports_amp_scaling=True, + num_process_groups=1, + current_process_group=None, + process_group_id=0, + process_group_size=0, + clip_grad_norm=True, + model_parallel=False): + global fused_adam_cuda, distributed_adam_cuda + fused_adam_cuda = importlib.import_module("fused_adam_cuda") + distributed_adam_cuda = importlib.import_module("distributed_adam_cuda") + self.multi_tensor_l2norm = amp_C.multi_tensor_l2norm + + if amsgrad: + raise RuntimeError('DistributedFusedAdam does not support the AMSGrad variant.') + + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + max_grad_norm=max_grad_norm) + super(DistributedFusedAdam, self).__init__(params, defaults) + + # Misc + self.eps_mode = 0 if eps_inside_sqrt else 1 + self._overflow_buf = torch.cuda.IntTensor([0]) + self._has_overflow = False + self._step_supports_amp_scaling = step_supports_amp_scaling + self._last_step = False + self._overlap_reductions = overlap_reductions + self._global_scale = None + self._num_blocks = dwu_num_blocks + self._num_chunks = dwu_num_chunks + self._predivide = predivide + self._e5m2_allgather = e5m2_allgather + self._do_not_flatten_model = do_not_flatten_model + self._compute_L2_grad_norm = compute_L2_grad_norm + self._L2_grad_norm = None + self._flat_mt = flat_mt + self._init_done = False + self._resume_from_checkpoint = False + self._step = 0 + + # Process group related + self._clip_grad_norm = clip_grad_norm + self._model_parallel = model_parallel + self._num_process_groups = num_process_groups + self._current_process_group = current_process_group if current_process_group is not None else c10d._get_default_group() + self._available_ranks = list(c10d._pg_group_ranks[self._current_process_group].keys()) + self._process_group_id = process_group_id + self._process_group_size = torch.cuda.device_count() if process_group_size <= 0 else process_group_size + self._world_size = self._process_group_size # world: the current process group + self._group_size = torch.cuda.device_count() if dwu_group_size <= 0 else dwu_group_size + self._num_groups = self._world_size // self._group_size + self._global_rank = torch.distributed.get_rank() + self._world_rank = self._global_rank // self._num_process_groups + self._group_rank = self._world_rank % self._group_size + #print("world_size:", self._world_size, ", group_size:", self._group_size, ", num_groups:", self._num_groups, ", global_rank:", self._global_rank, ", world_rank:", self._world_rank, ", group_rank:", self._group_rank) + self._num_rs_pg = dwu_num_rs_pg + self._num_ar_pg = dwu_num_ar_pg + self._num_ag_pg = dwu_num_ag_pg + + # Master weight, moment, gradient buffers + self._fp32_p, self._fp32_m, self._fp32_v, self._fp16_p, self._fp16_g = None, None, None, None, None + + def _first_step_init(self): + p_offset = 0 + p_i = 0 + self._model_params = [] + self._grads_info = [] + self._grad_accs = [] + self._group_properties = [] + for group in self.param_groups: + self._param_group = group + prev = None + beta1, beta2 = group['betas'] + bias_correction = 1 if group['bias_correction'] else 0 + eps = group['eps'] + weight_decay = group['weight_decay'] + for p in group['params']: + # broadcast from rank 0 of current process group + torch.distributed.broadcast(p, src=self._available_ranks[0], group=self._current_process_group) + if not p.requires_grad: + continue + self._model_params.append(p) + # Multiple param groups support: + # store one hyperparam item per parameter tensor + self._group_properties.append(( + beta1, + beta2, + bias_correction, + eps, + weight_decay + )) + p_grads_size = p.numel() + def wrapper(param, param_i, param_grads_size, param_offset): + param_tmp = param.expand_as(param) + grad_acc = param_tmp.grad_fn.next_functions[0][0] + def allreduce_hook(*unused): + self._do_overlapped_reduction(param_i, param_grads_size, param_offset, param) + grad_acc.register_hook(allreduce_hook) + self._grad_accs.append(grad_acc) + self._grads_info.append({"param_grads_size":p_grads_size, "param_offset":p_offset}) + wrapper(p, p_i, p_grads_size, p_offset) + p_offset += p_grads_size + # Only enforce 128b alignment (64 * fp16) for non-consecutive parameters + # RNN is one example of consecutive parameters: + # (weight_ih, weight_hh, bias_ih, bias_hh) + if prev is not None and (prev.data_ptr() + prev.numel() * prev.element_size() != p.data_ptr()): + p_offset = ((p_offset + 63) // 64) * 64 + prev = p + p_i += 1 + self._grads_generated = [False]*len(self._grads_info) + self._grads = [] + if self._overlap_reductions: + self._current_block = self._num_blocks + + self._net_total_param_size = p_offset + self._total_param_size = p_offset + dwu_min_page_size = 256 * self._num_blocks * self._num_chunks * self._group_size + self._total_param_size = ((self._total_param_size + dwu_min_page_size - 1) // dwu_min_page_size) * dwu_min_page_size + self._block_size = self._total_param_size // self._num_blocks + self._chunk_size = self._block_size // self._num_chunks + self._shard_size = self._chunk_size // self._group_size + #print("self._net_total_param_size=%d, self._total_param_size=%d, dwu_min_page_size=%d, self._block_size=%d, self._chunk_size=%d, self._shard_size=%d" % (self._net_total_param_size, self._total_param_size,dwu_min_page_size,self._block_size,self._chunk_size,self._shard_size)) + + self._low_param_i = [0]*self._num_blocks + for block_id in range(self._num_blocks-1,-1,-1): + p_i = len(self._grads_info)-1 + while p_i > 0 and self._grads_info[p_i]["param_offset"] > block_id*self._block_size: + p_i -= 1 + self._low_param_i[block_id] = p_i + #print(self._low_param_i) + + self._flat_grads = torch.zeros([self._total_param_size], dtype=torch.float16, device='cuda') + self._new_params = torch.zeros([self._total_param_size], dtype=torch.uint8 if self._e5m2_allgather else torch.float16, device='cuda') + self._mega_shard_size = self._num_blocks * self._num_chunks * self._shard_size + # initialize master weights, moments buffers if not loaded from checkpoint + if self._fp32_p is None: + self._fp32_p = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_m = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_v = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + # FIXME: Rethink fp16 label since it's either uint8 or fp16 + self._fp16_p = torch.zeros([self._mega_shard_size], dtype=torch.uint8 if self._e5m2_allgather else torch.float16, device='cuda') + self._fp16_g = torch.zeros([self._mega_shard_size], dtype=torch.float16, device='cuda') + + self._individual_flat_grads = [] + for p_i, (grads_info, p) in enumerate(zip(self._grads_info, self._model_params)): + self._individual_flat_grads.append(self._flat_grads[grads_info["param_offset"]:grads_info["param_offset"]+grads_info["param_grads_size"]].view_as(p)) + + def _flat_split(p): + def __blockify(p): + return [p[block_id*self._block_size:(block_id+1)*self._block_size] for block_id in range(self._num_blocks)] + def __chunkify(p): + return [p[chunk_id*self._chunk_size:(chunk_id+1)*self._chunk_size] for chunk_id in range(self._num_chunks)] + def __shardify(p): + return [p[shard_id*self._shard_size:(shard_id+1)*self._shard_size] for shard_id in range(self._group_size)] + list_of_blocks = __blockify(self._flat_grads) + list_of_list_of_chunks = [__chunkify(block) for block in list_of_blocks] + list_of_list_of_list_of_shards = [[__shardify(chunk) for chunk in chunks] for chunks in list_of_list_of_chunks] + return list_of_blocks, list_of_list_of_chunks, list_of_list_of_list_of_shards + self._flat_grads_blocks, self._flat_grads_chunks, self._flat_grads_shards = _flat_split(self._flat_grads) + def _full_packed_split(p): + def __shardify(p): + return [p[mega_shard*self._mega_shard_size:(mega_shard+1)*self._mega_shard_size] for mega_shard in range(self._group_size)] + def __blockify(p): + return [p[block_id*self._num_chunks*self._shard_size:(block_id+1)*self._num_chunks*self._shard_size] for block_id in range(self._num_blocks)] + def __chunkify(p): + return [p[chunk_id*self._shard_size:(chunk_id+1)*self._shard_size] for chunk_id in range(self._num_chunks)] + list_of_mega_shards = __shardify(p) + list_of_list_of_mega_blocks = [__blockify(mega_shard) for mega_shard in list_of_mega_shards] + list_of_list_of_list_of_mega_chunks = [[__chunkify(mega_block) for mega_block in mega_blocks] for mega_blocks in list_of_list_of_mega_blocks] + return list_of_mega_shards, list_of_list_of_mega_blocks, list_of_list_of_list_of_mega_chunks + self._new_params_mega_shards, self._new_params_mega_blocks, self._new_params_mega_chunks = _full_packed_split(self._new_params) + def _packed_split(p): + def __packed_blockify(p): + packed_block_size = self._num_chunks*self._shard_size + return [p[block_id*packed_block_size:(block_id+1)*packed_block_size] for block_id in range(self._num_blocks)] + def __packed_chunkify(p): + # in the packed format, each chunk contains one shard, so packed_chunk_size == self._shard_size + return [p[chunk_id*self._shard_size:(chunk_id+1)*self._shard_size] for chunk_id in range(self._num_chunks)] + list_of_blocks = __packed_blockify(p) + list_of_list_of_chunks = [__packed_chunkify(block) for block in list_of_blocks] + return list_of_blocks, list_of_list_of_chunks + self._fp32_p_blocks, self._fp32_p_chunks = _packed_split(self._fp32_p) + self._fp32_m_blocks, self._fp32_m_chunks = _packed_split(self._fp32_m) + self._fp32_v_blocks, self._fp32_v_chunks = _packed_split(self._fp32_v) + self._fp16_p_blocks, self._fp16_p_chunks = _packed_split(self._fp16_p) + self._fp16_g_blocks, self._fp16_g_chunks = _packed_split(self._fp16_g) + + # This paragraph does two things: + # 1) Copy model parameters into master buffer + # 2) Create tensor lists for unpacking new parameter tensor after all-gather + self._packed_flat_to_model_params = [] + self._contrib_tensor_list = [] + self._contrib_group_properties = [] + self._non_parallel_grads = [] + for shard_id in range(self._group_size): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + flat_shard_start = (((block_id * self._num_chunks + chunk_id) * self._group_size) + shard_id) * self._shard_size + flat_shard_end = flat_shard_start + self._shard_size + for (p, grads_info, group_props) in zip(self._model_params, self._grads_info, self._group_properties): + flat_grad_start = grads_info["param_offset"] + flat_grad_end = flat_grad_start + grads_info["param_grads_size"] + clipped_start = (lambda a,b: a if a > b else b)(flat_grad_start, flat_shard_start) + clipped_end = (lambda a,b: a if a < b else b)(flat_grad_end, flat_shard_end) + if clipped_start < clipped_end: + grad_offset = clipped_start - flat_grad_start + grad_length = clipped_end - clipped_start + shard_offset = clipped_start - flat_shard_start + model_param_fragment = p.view(-1)[grad_offset:grad_offset+grad_length] + new_param_packed_fragment = self._new_params_mega_chunks[shard_id][block_id][chunk_id][shard_offset:shard_offset+grad_length] + self._packed_flat_to_model_params.append( (new_param_packed_fragment, model_param_fragment) ) + if shard_id == self._group_rank: + # copy model parameters into master buffer + master_param_fragment = self._fp32_p_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_m_fragment = self._fp32_m_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_v_fragment = self._fp32_v_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_g_fragment = self._fp16_g_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_p_fragment = self._fp16_p_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + #print("model_param_fragment.size()=%s, new_param_packed_fragment.size()=%s, master_param_fragment.size()=%s" % (str(model_param_fragment.size()), str(new_param_packed_fragment.size()), str(master_param_fragment.size()))) + if not self._resume_from_checkpoint: + master_param_fragment.copy_(model_param_fragment) + self._contrib_group_properties.append(group_props) + self._contrib_tensor_list.append((master_param_fragment, opti_state_m_fragment, opti_state_v_fragment, opti_state_g_fragment, opti_state_p_fragment)) # p, m, v, g, p_copy + if self._model_parallel and hasattr(p, 'model_parallel') and not p.model_parallel: + self._non_parallel_grads.append(opti_state_g_fragment) + + p, m, v, g, p_copy = list(zip(*self._contrib_tensor_list)) + self._contrib_tensor_list = [p, m, v, g, p_copy] + + math_type = self._fp32_p.dtype + beta1, beta2, bias_correction, epsilon, decay = list(zip(*self._contrib_group_properties)) + self._contrib_beta1 = torch.tensor(beta1, dtype=math_type, device='cuda') + self._contrib_beta2 = torch.tensor(beta2, dtype=math_type, device='cuda') + self._contrib_bias_correction = torch.tensor(bias_correction, dtype=torch.int, device='cuda') + self._contrib_epsilon = torch.tensor(epsilon, dtype=math_type, device='cuda') + self._contrib_weight_decay = torch.tensor(decay, dtype=math_type, device='cuda') + + p_in, p_out = zip(*self._packed_flat_to_model_params) + self._packed_flat_to_model_params = [p_in, p_out] + + if self._num_groups > 1: + self._ar_pg = [] + for i in range(self._num_process_groups): + # gather global ranks of all members of the current process group + ranks = [i+k*self._num_process_groups for k in range(self._process_group_size)] + for j in range(self._group_size): + ar_idx = [j+k*self._group_size for k in range(self._num_groups)] + ar_rank = [ranks[k] for k in ar_idx] + #if self._global_rank in ar_rank: + # print("group for all reduce, ranks:", ar_rank) + for _ in range(self._num_ar_pg): + grp = torch.distributed.new_group(ranks=ar_rank) + if self._global_rank in ar_rank: + self._ar_pg.append(grp) + self._ar_st = [torch.cuda.Stream() for _ in range(self._num_ar_pg)] + for ar_pg in self._ar_pg: + torch.distributed.all_reduce(self._overflow_buf,group=ar_pg) + + self._rs_pg, rs_ranks = [],[] + for i in range(self._num_process_groups): + ranks = [i+k*self._num_process_groups for k in range(self._process_group_size)] + for j in range(self._num_groups): + rs_idx = [j*self._group_size+k for k in range(self._group_size)] + rs_rank = [ranks[k] for k in rs_idx] + #if self._global_rank in rs_rank: + # print("group for reduce scatter, ranks:", rs_rank) + for _ in range(self._num_rs_pg): + grp = torch.distributed.new_group(ranks=rs_rank) + if self._global_rank in rs_rank: + self._rs_pg.append(grp) + if self._compute_L2_grad_norm: + l2_grad_norm_pg = torch.distributed.new_group(ranks=rs_rank) + if self._global_rank in rs_rank: + self._l2_grad_norm_pg = l2_grad_norm_pg + torch.distributed.all_reduce(self._overflow_buf,group=self._l2_grad_norm_pg) + self._rs_st = [torch.cuda.Stream() for _ in range(self._num_rs_pg)] + for rs_pg in self._rs_pg: + torch.distributed.all_reduce(self._overflow_buf,group=rs_pg) + + if self._num_ag_pg == 0: + self._ag_pg = self._rs_pg + self._ag_st = self._rs_st + self._num_ag_pg = self._num_rs_pg + else: + self._ag_pg = [] + for i in range(self._num_process_groups): + ranks = [i+k*self._num_process_groups for k in range(self._process_group_size)] + for j in range(self._num_groups): + ag_rank = rs_ranks[j] + #if self._global_rank in ag_rank: + # print("group for all gather, ranks:", ag_rank) + for _ in range(self._num_ag_pg): + grp = torch.distributed.new_group(ranks=ag_rank) + if self._global_rank in ag_rank: + self._ag_pg.append(grp) + self._ag_st = [torch.cuda.Stream() for _ in range(self._num_ag_pg)] + for ag_pg in self._ag_pg: + torch.distributed.all_reduce(self._overflow_buf,group=ag_pg) + self._l2_grad_norm_st = torch.cuda.Stream() if self._compute_L2_grad_norm else None + self._completion_st = torch.cuda.Stream() + + self._reductions_works = [None]*self._num_blocks + self._allgather_works = [None]*self._num_blocks + + import inspect + assert ('no_copy' in inspect.getfullargspec(torch.distributed.reduce_scatter).args), "This version of c10d does not support no_copy option" + + def _init_everything(self): + if not self._init_done: + self._first_step_init() + self._init_done = True + + def set_last_step(self, last_step): + self._last_step = last_step + + def _get_flush_block(self): + flush_block = [] + if self._current_block > 0 and self._grads_generated[self._low_param_i[self._current_block-1]]: + num_grads = len(self._grads_generated) + contiguous_idx = num_grads + while contiguous_idx > 0 and self._grads_generated[contiguous_idx-1]: + contiguous_idx -= 1 + + if contiguous_idx < num_grads and self._grads_info[contiguous_idx]["param_offset"] <= (self._current_block-1)*self._block_size: + self._current_block -= 1 + start = self._current_block * self._block_size + end = (self._current_block+1) * self._block_size + flush_block = [start, end] + + return flush_block + + def _pipeline_block_reductions(self, block_id): + self._flatten_grad_mt(1.0/self._world_size if self._predivide else 1.0) + + # Reduction within each node + # Changes gradient format from [block * chunk * shard] to [shard * block * chunk] + # The output format is the same as the fp32 master parameters + works = [None]*self._num_chunks + for chunk_id in range(self._num_chunks): + glob_chunk_id = block_id * self._num_chunks + chunk_id + rs_stream = self._rs_st[glob_chunk_id%self._num_rs_pg] + rs_stream.wait_stream(torch.cuda.current_stream()) + with torch.cuda.stream(rs_stream): + works[chunk_id] = torch.distributed.reduce_scatter(self._fp16_g_chunks[block_id][chunk_id],self._flat_grads_shards[block_id][chunk_id],group=self._rs_pg[glob_chunk_id%self._num_rs_pg],async_op=True,no_copy=True) + + # Reduction across nodes for each rank + if self._num_groups > 1: + for chunk_id in range(self._num_chunks): + glob_chunk_id = block_id * self._num_chunks + chunk_id + ar_stream = self._ar_st[glob_chunk_id%self._num_ar_pg] + with torch.cuda.stream(ar_stream): + works[chunk_id].wait() + works[chunk_id] = torch.distributed.all_reduce(self._fp16_g_chunks[block_id][chunk_id],group=self._ar_pg[glob_chunk_id%self._num_ar_pg],async_op=True) + self._reductions_works[block_id] = works + + # Optionally compute L2 grad norm + if self._compute_L2_grad_norm and block_id == 0: + with torch.cuda.stream(self._l2_grad_norm_st): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + # Since the packed format is contiguous after reductions, only one norm is needed + l2_grad_norm_sq = torch.empty([1], device='cuda') + l2_grad_norm_sq = self._fp16_g.norm(dtype=torch.float32, p=2)**2 + torch.distributed.all_reduce(l2_grad_norm_sq, group=self._l2_grad_norm_pg) + # for model_parallel_rank=0, keep all gradients + # for the rest, subtract non_parallel gradients + if self._model_parallel and self._process_group_id: # non zero model_parallel_rank + non_parallel_grad_norm_sq = torch.zeros([1], device='cuda') + if len(self._non_parallel_grads): # non parallel grads exit + non_parallel_grad_norm_sq = multi_tensor_applier(self.multi_tensor_l2norm, + self._overflow_buf, + [self._non_parallel_grads], False)[0]**2 + torch.distributed.all_reduce(non_parallel_grad_norm_sq, group=self._l2_grad_norm_pg) + l2_grad_norm_sq = l2_grad_norm_sq - non_parallel_grad_norm_sq + self._L2_grad_norm = l2_grad_norm_sq.sqrt().item() + + def __launch_step_kernel(self): + # If self._clip_grad_norm is False, we assume gradient clipping already + # happened outside the optimizer and self._global_scale has already + # been set to the combined scale, i.e. it's no longer the current loss + # scale used by the loss scaler. + # For model parallelism cases in which we need to get global gradient + # norm via all-reduce outside the optimizer to do the clipping. + combined_scale = self._global_scale + if self._clip_grad_norm and self._param_group['max_grad_norm'] > 0 and math.isfinite(self.L2_grad_norm): + combined_scale = self._param_group['max_grad_norm'] / (self.L2_grad_norm / self._global_scale + 1e-6) + combined_scale = self._global_scale / min(1, combined_scale) + + self._step += 1 + multi_tensor_applier(distributed_adam_cuda.multi_tensor_fused_adam, + self._overflow_buf, + self._contrib_tensor_list, # p, m, v, g, p_copy + self._contrib_beta1, + self._contrib_beta2, + self._contrib_bias_correction, + self._contrib_epsilon, + self._contrib_weight_decay, + self._param_group['lr'], + combined_scale, + self._step, + self.eps_mode) + + def _pipeline_step(self): + # Call step kernel once per step + # Call all-gather once per step + with torch.cuda.stream(self._completion_st): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + self.__launch_step_kernel() + torch.distributed.all_gather(self._new_params_mega_shards, self._fp16_p, group=self._ag_pg[0], no_copy=True) + + def _flatten_grad_mt(self, scale): + if self._flat_mt and len(self._grads) > 0: + self._overflow_buf.zero_() + multi_tensor_applier( + amp_C.multi_tensor_scale, + self._overflow_buf, + list(zip(*self._grads)), + scale) + self._grads = [] + + def _do_overlapped_reduction(self, param_i, param_grads_size, param_offset, param): + # handle overlapped reductions + if self._flat_mt: + self._grads.append( (param.grad, self._individual_flat_grads[param_i]) ) + else: + torch.div(param.grad, self._world_size if self._predivide else 1.0, out=self._individual_flat_grads[param_i]) + self._grads_generated[param_i]=True + if not self._last_step: + if self._overlap_reductions: + flush_block = self._get_flush_block() + while flush_block: + block_id = flush_block[0] // self._block_size + self._pipeline_block_reductions(block_id) + flush_block = self._get_flush_block() + + def set_global_scale(self, global_scale): + """Set global scale. + """ + self._global_scale = global_scale + + @property + def global_scale(self): + return self._global_scale + + @property + def has_overflow(self): + """Check if overflows were detected by any call to step(...) method. + Clears the overflow flag. + """ + has_overflow = self._has_overflow + self._has_overflow = False + return has_overflow + + @property + def peek_overflow(self): + """Check if overflows were detected by any call to step(...) method. + Does not clear overflow flag. + """ + return self._has_overflow + + def strided_check_finite(self, output_params, stride=1, start=-1, end=-1, clear=True): + """Strided check for overflow. + You can get status by calling has_overflow. + """ + if start >= 0 and start < end: + out_p = output_params[start:end] + else: + out_p = output_params + fused_adam_cuda.strided_check_finite(self._overflow_buf, + out_p, + stride, + 1 if clear else 0) + self._has_overflow = False if self._overflow_buf.item() == 0 else True + return self._has_overflow + + @property + def L2_grad_norm(self): + if self._compute_L2_grad_norm: + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + return self._L2_grad_norm + else: + return None + + def complete_reductions(self): + """Complete reductions if full pipeline is not selected or overlap is not allowed. + """ + self._init_everything() + if self._last_step: + # zero out gradients that have not been completed yet + for param_i, grad_generated in enumerate(self._grads_generated): + if not grad_generated: + grad_info = self._grads_info[param_i] + param_offset = grad_info["param_offset"] + param_size = grad_info["param_grads_size"] + self._flat_grads[param_offset:param_offset+param_size].zero_() + self._grads_generated[param_i] = True + + if self._last_step or not self._overlap_reductions: + # nothing done so far, run full pipeline after reductions + for block_id in range(self._num_blocks-1,-1,-1): + self._pipeline_block_reductions(block_id) + + if self._compute_L2_grad_norm: + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + + self._current_block = self._num_blocks + self._grads_generated = [False]*len(self._grads_info) + + def step(self, closure=None): + loss = None + if closure is not None: + loss = closure() + + self._pipeline_step() + + with torch.cuda.stream(self._completion_st): + # Copy self._new_params to model params + multi_tensor_applier( + fused_adam_cuda.maybe_cast_mt, + self._overflow_buf, + self._packed_flat_to_model_params) + + torch.cuda.current_stream().wait_stream(self._completion_st) + + self._reductions_works = [None]*self._num_blocks + self._allgather_works = [None]*self._num_blocks + + return loss + + def state_dict(self): + """ + Returns a dict containing the current state of this :class:`DistributedFusedAdam` instance. + Example:: + checkpoint = {} + checkpoint['model'] = model.state_dict() + checkpoint['optimizer'] = optimizer.state_dict() + torch.save(checkpoint, "saved.pth") + """ + # save step, master weights and first/second moments + state_dict = {} + state_dict['step'] = self._step + state_dict['fp32_p'] = self._fp32_p + state_dict['fp32_m'] = self._fp32_m + state_dict['fp32_v'] = self._fp32_v + return state_dict + + def load_state_dict(self, state_dict): + """ + Loads a state_dict created by an earlier call to state_dict(). + If an DistributedFusedAdam instance was constructed from some ``init_optimizer``, + whose parameters in turn came from ``model``, it is expected that the user + will call ``model.load_state_dict()`` before + ``optimizer.load_state_dict()`` is called. + Example:: + model = torch.nn.Linear(D_in, D_out).cuda().half() + optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + optimizer = FP16_Optimizer(optimizer, static_loss_scale = 128.0) + ... + checkpoint = torch.load("saved.pth") + model.load_state_dict(checkpoint['model']) + optimizer.load_state_dict(checkpoint['optimizer']) + """ + # restore step, master weights and first/second moments + self._step = state_dict['step'] + self._fp32_p = state_dict['fp32_p'].to(device="cuda") + self._fp32_m = state_dict['fp32_m'].to(device="cuda") + self._fp32_v = state_dict['fp32_v'].to(device="cuda") + self._resume_from_checkpoint = True diff --git a/apex/apex/contrib/optimizers/distributed_fused_adam_v2.py b/apex/apex/contrib/optimizers/distributed_fused_adam_v2.py new file mode 100644 index 0000000000000000000000000000000000000000..80a810835f9d33a5812758a3837eb971894aff63 --- /dev/null +++ b/apex/apex/contrib/optimizers/distributed_fused_adam_v2.py @@ -0,0 +1,615 @@ +import math +import torch +import importlib +import amp_C +from apex.multi_tensor_apply import multi_tensor_applier + +class DistributedFusedAdamV2(torch.optim.Optimizer): + + """Implements Adam algorithm. Currently GPU-only. Requires Apex to be installed via + ``python setup.py install --cuda_ext --cpp_ext``. + + It has been proposed in `Adam: A Method for Stochastic Optimization`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + (default: False) NOT SUPPORTED in FusedAdam! + eps_inside_sqrt (boolean, optional): in the 'update parameters' step, + adds eps to the bias-corrected second moment estimate before + evaluating square root instead of adding it to the square root of + second moment estimate as in the original paper. (default: False) + use_mt (boolean, optional): use multi tensor apply for lower launch + latency. (default: False) + overlap_reductions(boolean, optional): whether to overlap reductions + with bprop (default: True) + num_prestats (integer, optional): number of fp64 stats that will be + reduced during first fp16 gradient reduction block. + + .. _Adam\: A Method for Stochastic Optimization: + https://arxiv.org/abs/1412.6980 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, + lr=1e-3, bias_correction = True, + betas=(0.9, 0.999), eps=1e-8, eps_inside_sqrt = False, + weight_decay=0., max_grad_norm=0., amsgrad=False, use_mt=False, + amp_scale_adjustment=1.0, overlap_reductions=True, full_pipeline=True, + compute_L2_grad_norm=False, distributed_weight_update=0, + dwu_group_size=0, dwu_num_blocks=4, dwu_num_rs_pg=1, dwu_num_ar_pg=4, + dwu_num_ag_pg=0, revert_method=1, flat_mt=False, + dwu_num_chunks=4, predivide=True, e5m2_allgather=False, + do_not_flatten_model=False): + global fused_adam_cuda + fused_adam_cuda = importlib.import_module("fused_adam_cuda") + + self._amp_scale_adjustment = amp_scale_adjustment + + if use_mt: + raise RuntimeError('DistributedFusedAdam does not support use_mt.') + if amsgrad: + raise RuntimeError('DistributedFusedAdam does not support the AMSGrad variant.') + + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + max_grad_norm=max_grad_norm) + super(DistributedFusedAdamV2, self).__init__(params, defaults) + self.eps_mode = 0 if eps_inside_sqrt else 1 + + self._overflow_buf = torch.cuda.IntTensor([0]) + self._has_overflow = False + + assert (len(self.param_groups) == 1), "More than one parameter group is not supported." + + # Way to revert a step + # 3 -> undo kernel + double buffer (debug, print norm of difference) + # 2 -> double buffer fp32 parameters + # 1 -> undo kernel + self._revert_method = revert_method + if self._revert_method > 1: + print("revert_method -> double buffer fp32 parameters, will consume more memory") + + self._last_step = False + self._overlap_reductions = overlap_reductions + self._global_scale = None + self._num_blocks = dwu_num_blocks + self._num_chunks = dwu_num_chunks + self._predivide = predivide + self._e5m2_allgather = e5m2_allgather + self._do_not_flatten_model = do_not_flatten_model + self._full_pipeline = full_pipeline + self._compute_L2_grad_norm = compute_L2_grad_norm + self._L2_grad_norm = None + self._group_size = torch.cuda.device_count() if dwu_group_size <= 0 else dwu_group_size + self._world_size = torch.distributed.get_world_size() + self._num_groups = self._world_size // self._group_size + self._rank_in_group = torch.distributed.get_rank() % self._group_size + + p_offset = 0 + p_i = 0 + self._param_state = None + self._model_params = [] + self._grads_info = [] + self._grad_accs = [] + for group in self.param_groups: + self._param_group = group + prev = None + for p in group['params']: + torch.distributed.broadcast(p,0) + if not p.requires_grad: + continue + self._model_params.append(p) + state = self.state[p] + if len(state) == 0: + state['step'] = 0 + if self._param_state is None: + self._param_state = state + p_grads_size = p.numel() + def wrapper(param, param_i, param_grads_size, param_offset): + param_tmp = param.expand_as(param) + grad_acc = param_tmp.grad_fn.next_functions[0][0] + def allreduce_hook(*unused): + self._do_overlapped_reduction(param_i, param_grads_size, param_offset, param) + grad_acc.register_hook(allreduce_hook) + self._grad_accs.append(grad_acc) + self._grads_info.append({"param_grads_size":p_grads_size, "param_offset":p_offset}) + wrapper(p, p_i, p_grads_size, p_offset) + p_offset += p_grads_size + # Only enforce 128b alignment (64 * fp16) for non-consecutive parameters + # RNN is one example of consecutive parameters: + # (weight_ih, weight_hh, bias_ih, bias_hh) + if prev is not None and (prev.data_ptr() + prev.numel() * prev.element_size() != p.data_ptr()): + p_offset = ((p_offset + 63) // 64) * 64 + prev = p + p_i += 1 + self._grads_generated = [False]*len(self._grads_info) + self._flat_mt = flat_mt + self._grads = [] + if self._overlap_reductions: + self._current_block = self._num_blocks + + self._net_total_param_size = p_offset + self._total_param_size = p_offset + dwu_min_page_size = 256 * self._num_blocks * self._num_chunks * self._group_size + self._total_param_size = ((self._total_param_size + dwu_min_page_size - 1) // dwu_min_page_size) * dwu_min_page_size + self._block_size = self._total_param_size // self._num_blocks + self._shard_size = self._block_size // self._group_size + self._chunk_size = self._shard_size // self._num_chunks + print("self._net_total_param_size=%d, self._total_param_size=%d, dwu_min_page_size=%d, self._block_size=%d, self._shard_size=%d, self._chunk_size=%d" % (self._net_total_param_size, self._total_param_size,dwu_min_page_size,self._block_size,self._shard_size,self._chunk_size)) + + self._low_param_i = [0]*self._num_blocks + for block_id in range(self._num_blocks-1,-1,-1): + p_i = len(self._grads_info)-1 + while p_i > 0 and self._grads_info[p_i]["param_offset"] > block_id*self._block_size: + p_i -= 1 + self._low_param_i[block_id] = p_i + print(self._low_param_i) + + self._flat_grads = torch.zeros([self._total_param_size], dtype=torch.float16, device='cuda') + self._new_params = torch.zeros([self._total_param_size], dtype=torch.uint8 if self._e5m2_allgather else torch.float16, device='cuda') + self._mega_shard_size = self._num_blocks * self._num_chunks * self._chunk_size + self._fp32_p = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_m = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_v = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + # FIXME: Rethink fp16 label since it's either uint8 or fp16 + self._fp16_p = torch.zeros([self._mega_shard_size], dtype=torch.uint8 if self._e5m2_allgather else torch.float16, device='cuda') + self._fp16_g = torch.zeros([self._mega_shard_size], dtype=torch.float16, device='cuda') + + self._individual_flat_grads = [] + for p_i, (grads_info, p) in enumerate(zip(self._grads_info, self._model_params)): + self._individual_flat_grads.append(self._flat_grads[grads_info["param_offset"]:grads_info["param_offset"]+grads_info["param_grads_size"]].view_as(p)) + + def _flat_split(p): + def __blockify(p): + return [p[block_id*self._block_size:(block_id+1)*self._block_size] for block_id in range(self._num_blocks)] + def __shardify(p): + return [p[shard_id*self._shard_size:(shard_id+1)*self._shard_size] for shard_id in range(self._group_size)] + def __chunkify(p): + return [p[chunk_id*self._chunk_size:(chunk_id+1)*self._chunk_size] for chunk_id in range(self._group_size)] + list_of_blocks = __blockify(self._flat_grads) + list_of_list_of_shards = [__shardify(block) for block in list_of_blocks] + list_of_list_of_list_of_chunks = [[__chunkify(shard) for shard in shards] for shards in list_of_list_of_shards] + return list_of_blocks, list_of_list_of_shards, list_of_list_of_list_of_chunks + self._flat_grads_blocks, self._flat_grads_shards, self._flat_grads_chunks = _flat_split(self._flat_grads) + def _full_packed_split(p): + def __shardify(p): + return [p[mega_shard*self._mega_shard_size:(mega_shard+1)*self._mega_shard_size] for mega_shard in range(self._group_size)] + def __blockify(p): + return [p[block_id*self._num_chunks*self._chunk_size:(block_id+1)*self._num_chunks*self._chunk_size] for block_id in range(self._num_blocks)] + def __chunkify(p): + return [p[chunk_id*self._chunk_size:(chunk_id+1)*self._chunk_size] for chunk_id in range(self._num_chunks)] + list_of_mega_shards = __shardify(p) + list_of_list_of_mega_blocks = [__blockify(mega_shard) for mega_shard in list_of_mega_shards] + list_of_list_of_list_of_mega_chunks = [[__chunkify(mega_block) for mega_block in mega_blocks] for mega_blocks in list_of_list_of_mega_blocks] + return list_of_mega_shards, list_of_list_of_mega_blocks, list_of_list_of_list_of_mega_chunks + self._new_params_mega_shards, self._new_params_mega_blocks, self._new_params_mega_chunks = _full_packed_split(self._new_params) + def _packed_split(p): + def __packed_blockify(p): + packed_block_size = self._num_chunks*self._chunk_size + return [p[block_id*packed_block_size:(block_id+1)*packed_block_size] for block_id in range(self._num_blocks)] + def __packed_chunkify(p): + return [p[chunk_id*self._chunk_size:(chunk_id+1)*self._chunk_size] for chunk_id in range(self._num_chunks)] + list_of_blocks = __packed_blockify(p) + list_of_list_of_chunks = [__packed_chunkify(block) for block in list_of_blocks] + return list_of_blocks, list_of_list_of_chunks + self._fp32_p_blocks, self._fp32_p_chunks = _packed_split(self._fp32_p) + self._fp32_m_blocks, self._fp32_m_chunks = _packed_split(self._fp32_m) + self._fp32_v_blocks, self._fp32_v_chunks = _packed_split(self._fp32_v) + self._fp16_p_blocks, self._fp16_p_chunks = _packed_split(self._fp16_p) + self._fp16_g_blocks, self._fp16_g_chunks = _packed_split(self._fp16_g) + + # current arrangement + # + # self._flat_grads + # self._flat_grads_blocks [x self._num_blocks, self._block_size] + # self._flat_grads_chunks [x self._num_chunks, self._chunk_size] + # self._flat_grads_shards [x self._group_size, self._shard_size] + # + # self._new_params + # self._new_params_mega_shards [x self._group_size, self._num_blocks*self._num_chunks*self._shard_size] + # self._new_params_mega_blocks [x self._num_blocks, self._num_chunks*self._shard_size] + # self._new_params_mega_chunks [x self._num_chunks, self._shard_size] + # + # self._fp32_p + # self._fp32_p_blocks [x self._num_blocks, self._num_chunks*self._shard_size] + # self._fp32_p_chunks [x self._num_chunks, self._shard_size] + # each chunk contains one shard + # same for self._fp32_m, self._fp32_v, self._fp16_p and self._fp16_g + # + # Usage: + # + # for chunk_id in range(self._num_chunks): + # works[chunk_id] = torch.distributed.reduce_scatter(self._flat_grads_chunks[block_id][chunk_id], self._fp16_g_chunks[block_id][chunk_id], ...) + # + # ---------------------------------------------------------------------------------------- + # + # new arrangement + # + # NB! New equations for self._shard_size and self._chunk_size + # + # self._flat_grads + # self._flat_grads_blocks [x self._num_blocks, self._block_size] + # self._flat_grads_shards [x self._group_size, self._shard_size] + # self._flat_grads_chunks [x self._num_chunks, self._chunk_size] + # + # self._new_params + # self._new_params_mega_shards [x self._group_size, self._num_blocks*self._num_chunks*self._chunk_size] + # self._new_params_mega_blocks [x self._num_blocks, self._num_chunks*self._chunk_size] + # self._new_params_mega_chunks [x self._num_chunks, self._chunk_size] + # + # self._fp32_p + # self._fp32_p_blocks [x self._num_blocks, self._num_chunks*self._chunk_size] + # self._fp32_p_chunks [x self._num_chunks, self._chunk_size] + # same for self._fp32_m, self._fp32_v, self._fp16_p and self._fp16_g + # + # Usage: + # + # work = torch.distributed.reduce_scatter(self._flat_grads_blocks[block_id], self._fp16_g[block_id], ...) + # for chunk_id in range(self._num_chunks): + # work.wait() + # works[chunk_id] = torch.distributed.all_reduce(self._fp16_g_chunks[block_id][chunk_id], ...) + # or + # work.wait() + # works[0] = torch.distributed.all_reduce(self._fp16_g_blocks[block_id], ...) + # + + # This paragraph does two things: + # 1) Copy model parameters into master buffer + # 2) Create tensor lists for unpacking new parameter tensor after all-gather + self._packed_flat_to_model_params = [] + for shard_id in range(self._group_size): + for block_id in range(self._num_blocks): + flat_shard_start = (block_id * self._group_size + shard_id) * self._shard_size + flat_shard_end = flat_shard_start + self._shard_size + for p, grads_info in zip(self._model_params, self._grads_info): + flat_grad_start = grads_info["param_offset"] + flat_grad_end = flat_grad_start + grads_info["param_grads_size"] + clipped_start = (lambda a,b: a if a > b else b)(flat_grad_start, flat_shard_start) + clipped_end = (lambda a,b: a if a < b else b)(flat_grad_end, flat_shard_end) + if clipped_start < clipped_end: + grad_offset = clipped_start - flat_grad_start + grad_length = clipped_end - clipped_start + shard_offset = clipped_start - flat_shard_start + model_param_fragment = p.view(-1)[grad_offset:grad_offset+grad_length] + new_param_packed_fragment = self._new_params_mega_blocks[shard_id][block_id][shard_offset:shard_offset+grad_length] + self._packed_flat_to_model_params.append( (new_param_packed_fragment, model_param_fragment) ) + if shard_id == self._rank_in_group: + # copy model parameters into master buffer + master_param_fragment = self._fp32_p_blocks[block_id][shard_offset:shard_offset+grad_length] + print("model_param_fragment.size()=%s, new_param_packed_fragment.size()=%s, master_param_fragment.size()=%s" % (str(model_param_fragment.size()), str(new_param_packed_fragment.size()), str(master_param_fragment.size()))) + master_param_fragment.copy_(model_param_fragment) + + p_in, p_out = zip(*self._packed_flat_to_model_params) + self._packed_flat_to_model_params = [p_in, p_out] + + self._distributed_weight_update = distributed_weight_update # Is this still needed? + self._num_rs_pg = dwu_num_rs_pg + self._num_ar_pg = dwu_num_ar_pg + self._num_ag_pg = dwu_num_ag_pg + if self._num_groups > 1: + self._ar_pg = [] + for dev_i in range(self._group_size): + ranks = [dev_i+j*self._group_size for j in range(self._num_groups)] + for i in range(self._num_ar_pg): + grp = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._ar_pg.append(grp) + self._ar_st = [torch.cuda.Stream() for _ in range(self._num_ar_pg)] + for ar_pg in self._ar_pg: + torch.distributed.all_reduce(self._overflow_buf,group=ar_pg) + rs_ranks = [] + for group_i in range(self._num_groups): + rs_ranks.append([group_i*self._group_size+j for j in range(self._group_size)]) + self._rs_pg = [] + for group_i in range(self._num_groups): + ranks = rs_ranks[group_i] + for i in range(self._num_rs_pg): + grp = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._rs_pg.append(grp) + if self._compute_L2_grad_norm and torch.distributed.get_rank() in ranks: + self._l2_grad_norm_pg = torch.distributed.new_group(ranks=ranks) + torch.distributed.all_reduce(self._overflow_buf,group=self._l2_grad_norm_pg) + self._rs_st = [torch.cuda.Stream() for _ in range(self._num_rs_pg)] + for rs_pg in self._rs_pg: + torch.distributed.all_reduce(self._overflow_buf,group=rs_pg) + if self._num_ag_pg == 0: + self._ag_pg = self._rs_pg + self._ag_st = self._rs_st + self._num_ag_pg = self._num_rs_pg + else: + self._ag_pg = [] + for group_i in range(self._num_groups): + ranks = rs_ranks[group_i] + for i in range(self._num_ag_pg): + grp = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._ag_pg.append(grp) + self._ag_st = [torch.cuda.Stream() for _ in range(self._num_ag_pg)] + for ag_pg in self._ag_pg: + torch.distributed.all_reduce(self._overflow_buf,group=ag_pg) + self._l2_grad_norm_st = torch.cuda.Stream() if self._compute_L2_grad_norm else None + self._completion_st = torch.cuda.Stream() + + self._reductions_works = [None]*self._num_blocks + self._allgather_works = [None]*self._num_blocks + + import inspect + assert ('no_copy' in inspect.getfullargspec(torch.distributed.reduce_scatter).args), "This version of c10d does not support no_copy option" + + + def set_last_step(self, last_step): + self._last_step = last_step + + def _get_flush_block(self): + flush_block = [] + if self._current_block > 0 and self._grads_generated[self._low_param_i[self._current_block-1]]: + num_grads = len(self._grads_generated) + contiguous_idx = num_grads + while contiguous_idx > 0 and self._grads_generated[contiguous_idx-1]: + contiguous_idx -= 1 + + if contiguous_idx < num_grads and self._grads_info[contiguous_idx]["param_offset"] <= (self._current_block-1)*self._block_size: + self._current_block -= 1 + start = self._current_block * self._block_size + end = (self._current_block+1) * self._block_size + flush_block = [start, end] + + return flush_block + + def _pipeline_block_reductions(self, block_id): + self._flatten_grad_mt(1.0/self._world_size if self._predivide else 1.0) + + # Reduction within each node + # Changes gradient format from [block * chunk * shard] to [shard * block * chunk] + # The output format is the same as the fp32 master parameters + works = [None]*self._num_chunks + rs_stream = self._rs_st[block_id%self._num_rs_pg] + rs_stream.wait_stream(torch.cuda.current_stream()) + with torch.cuda.stream(rs_stream): + rs_work = torch.distributed.reduce_scatter(self._fp16_g_blocks[block_id],self._flat_grads_shards[block_id],group=self._rs_pg[block_id%self._num_rs_pg],async_op=True,no_copy=True) + for chunk_id in range(self._num_chunks): + works[chunk_id] = rs_work + + # Reduction across nodes for each rank + if self._num_groups > 1: + for chunk_id in range(self._num_chunks): + glob_chunk_id = block_id * self._num_chunks + chunk_id + ar_stream = self._ar_st[glob_chunk_id%self._num_ar_pg] + with torch.cuda.stream(ar_stream): + rs_work.wait() + works[chunk_id] = torch.distributed.all_reduce(self._fp16_g_chunks[block_id][chunk_id],group=self._ar_pg[glob_chunk_id%self._num_ar_pg],async_op=True) + self._reductions_works[block_id] = works + + # Optionally compute L2 grad norm + if self._compute_L2_grad_norm and block_id == 0: + with torch.cuda.stream(self._l2_grad_norm_st): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + # Since the packed format is contiguous after reductions, only one norm is needed + l2_grad_norm_sq = torch.empty([1], device='cuda') + l2_grad_norm_sq = self._fp16_g.norm(dtype=torch.float32, p=2)**2 + torch.distributed.all_reduce(l2_grad_norm_sq, group=self._l2_grad_norm_pg) + self._L2_grad_norm = l2_grad_norm_sq.sqrt().item() + + def __launch_step_kernel(self, p, p_copy, m, v, g): + combined_scale = self._global_scale + if self._param_group['max_grad_norm'] > 0 and math.isfinite(self.L2_grad_norm): + combined_scale = self._param_group['max_grad_norm'] / (self.L2_grad_norm / self._global_scale + 1e-6) + combined_scale = self._global_scale / min(1, combined_scale) + bias_correction = 1 if self._param_group['bias_correction'] else 0 + beta1, beta2 = self._param_group['betas'] + fused_adam_cuda.reversible_adam( + p, p_copy, m, v, g, + self._param_group['lr'], + beta1, + beta2, + self._param_group['eps'], + combined_scale, + self._param_state['step']+1, + self.eps_mode, + bias_correction, + self._param_group['weight_decay']) + + def _pipeline_block_step(self, block_id): + # Call step kernel once per block + ag_stream = self._ag_st[block_id%self._num_ag_pg] + with torch.cuda.stream(ag_stream): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + self.__launch_step_kernel( + self._fp32_p_blocks[block_id], + self._fp16_p_blocks[block_id], + self._fp32_m_blocks[block_id], + self._fp32_v_blocks[block_id], + self._fp16_g_blocks[block_id]) + # Call all-gather once per step. + # FIXME: Determine which is faster, one all-gather per block or a single all-gather at end + if block_id == 0: + for other_ag_stream in self._ag_st: + self._completion_st.wait_stream(other_ag_stream) + with torch.cuda.stream(self._completion_st): + torch.distributed.all_gather(self._new_params_mega_shards, self._fp16_p, group=self._ag_pg[0], no_copy=True) + + def _pipeline_step(self): + # Call step kernel once per step + # Call all-gather once per step + with torch.cuda.stream(self._completion_st): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + self.__launch_step_kernel( + self._fp32_p, + self._fp16_p, + self._fp32_m, + self._fp32_v, + self._fp16_g) + torch.distributed.all_gather(self._new_params_mega_shards, self._fp16_p, group=self._ag_pg[0], no_copy=True) + + def _flatten_grad_mt(self, scale): + if self._flat_mt and len(self._grads) > 0: + self._overflow_buf.zero_() + multi_tensor_applier( + amp_C.multi_tensor_scale, + self._overflow_buf, + list(zip(*self._grads)), + scale) + self._grads = [] + + def _do_overlapped_reduction(self, param_i, param_grads_size, param_offset, param): + # handle overlapped reductions + if self._flat_mt: + self._grads.append( (param.grad, self._individual_flat_grads[param_i]) ) + else: + torch.div(param.grad, self._world_size if self._predivide else 1.0, out=self._individual_flat_grads[param_i]) + self._grads_generated[param_i]=True + if not self._last_step: + if self._overlap_reductions: + flush_block = self._get_flush_block() + while flush_block: + block_id = flush_block[0] // self._block_size + self._pipeline_block_reductions(block_id) + if self._full_pipeline: + self._pipeline_block_step(block_id) + flush_block = self._get_flush_block() + + def set_global_scale(self, global_scale): + """Set global scale. + """ + self._global_scale = global_scale + + @property + def global_scale(self): + return self._global_scale + + @property + def has_overflow(self): + """Check if overflows were detected by any call to step(...) method. + Clears the overflow flag. + """ + has_overflow = self._has_overflow + self._has_overflow = False + return has_overflow + + @property + def peek_overflow(self): + """Check if overflows were detected by any call to step(...) method. + Does not clear overflow flag. + """ + return self._has_overflow + + def strided_check_finite(self, output_params, stride=1, start=-1, end=-1, clear=True): + """Strided check for overflow. + You can get status by calling has_overflow. + """ + if start >= 0 and start < end: + out_p = output_params[start:end] + else: + out_p = output_params + fused_adam_cuda.strided_check_finite(self._overflow_buf, + out_p, + stride, + 1 if clear else 0) + self._has_overflow = False if self._overflow_buf.item() == 0 else True + return self._has_overflow + + @property + def L2_grad_norm(self): + if self._compute_L2_grad_norm: + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + return self._L2_grad_norm + else: + return None + + def complete_reductions(self): + """Complete reductions if full pipeline is not selected or overlap is not allowed. + """ + + if self._last_step: + # zero out gradients that have not been completed yet + for param_i, grad_generated in enumerate(self._grads_generated): + if not grad_generated: + grad_info = self._grads_info[param_i] + param_offset = grad_info["param_offset"] + param_size = grad_info["param_grads_size"] + self._flat_grads[param_offset:param_offset+param_size].zero_() + self._grads_generated[param_i] = True + + if self._last_step or not self._overlap_reductions: + # nothing done so far, run full pipeline after reductions + for block_id in range(self._num_blocks-1,-1,-1): + self._pipeline_block_reductions(block_id) + + if self._compute_L2_grad_norm: + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + + self._current_block = self._num_blocks + self._grads_generated = [False]*len(self._grads_info) + + def revert_step(self): + """Revert effect of previously calling partial_step. + """ + # Call undo kernel once per step + combined_scale = self._global_scale + if self._param_group['max_grad_norm'] > 0 and math.isfinite(self.L2_grad_norm): + combined_scale = self._param_group['max_grad_norm'] / (self.L2_grad_norm / self._global_scale + 1e-6) + combined_scale = self._global_scale / min(1, combined_scale) + bias_correction = 1 if self._param_group['bias_correction'] else 0 + beta1, beta2 = self._param_group['betas'] + fused_adam_cuda.maybe_adam_undo( + torch.empty([0]), + self._fp32_p, + self._fp32_m, + self._fp32_v, + self._fp16_g, + self._param_group['lr'], + beta1, + beta2, + self._param_group['eps'], + combined_scale, + self._param_state['step']+1, + self.eps_mode, + bias_correction, + self._param_group['weight_decay']) + + def step(self, closure=None, skip_overflow_check=False): + loss = None + if closure is not None: + loss = closure() + + if self._last_step or not self._overlap_reductions or not self._full_pipeline: + self._pipeline_step() + + with torch.cuda.stream(self._completion_st): + # Check for overflow + # Store state for loss scaler calculation + has_overflow = False if skip_overflow_check else self.strided_check_finite(self._new_params, stride=self._shard_size, start=0, end=self._net_total_param_size) + if has_overflow: + self.revert_step() + else: + # Copy self._new_params to model params + for p in self._model_params: self.state[p]['step'] += 1 + multi_tensor_applier( + fused_adam_cuda.maybe_cast_mt, + self._overflow_buf, + self._packed_flat_to_model_params) + + torch.cuda.current_stream().wait_stream(self._completion_st) + + self._reductions_works = [None]*self._num_blocks + self._allgather_works = [None]*self._num_blocks + + return loss + + diff --git a/apex/apex/contrib/optimizers/distributed_fused_adam_v3.py b/apex/apex/contrib/optimizers/distributed_fused_adam_v3.py new file mode 100644 index 0000000000000000000000000000000000000000..1b3760332094680977d46e3af20903e2b115662d --- /dev/null +++ b/apex/apex/contrib/optimizers/distributed_fused_adam_v3.py @@ -0,0 +1,325 @@ +import math +import torch +import importlib +import amp_C +from apex.multi_tensor_apply import multi_tensor_applier + +class DistributedFusedAdamV3(torch.optim.Optimizer): + + """Implements Adam algorithm. Currently GPU-only. Requires Apex to be installed via + ``python setup.py install --cuda_ext --cpp_ext``. + + It has been proposed in `Adam: A Method for Stochastic Optimization`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + (default: False) NOT SUPPORTED in FusedAdam! + eps_inside_sqrt (boolean, optional): in the 'update parameters' step, + adds eps to the bias-corrected second moment estimate before + evaluating square root instead of adding it to the square root of + second moment estimate as in the original paper. (default: False) + use_mt (boolean, optional): use multi tensor apply for lower launch + latency. (default: False) + overlap_reductions(boolean, optional): whether to overlap reductions + with bprop (default: True) + num_prestats (integer, optional): number of fp64 stats that will be + reduced during first fp16 gradient reduction block. + + .. _Adam\: A Method for Stochastic Optimization: + https://arxiv.org/abs/1412.6980 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, + lr=1e-3, bias_correction = True, + betas=(0.9, 0.999), eps=1e-8, eps_inside_sqrt = False, + weight_decay=0., max_grad_norm=0., amsgrad=False, use_mt=False, + amp_scale_adjustment=1.0, overlap_reductions=True, full_pipeline=True, + compute_L2_grad_norm=False, distributed_weight_update=0, + dwu_group_size=0, dwu_num_blocks=4, dwu_num_rs_pg=1, dwu_num_ar_pg=4, + dwu_num_ag_pg=0, revert_method=1, flat_mt=False, + dwu_num_chunks=4, predivide=True, e5m2_allgather=False, + do_not_flatten_model=False): + global fused_adam_cuda + fused_adam_cuda = importlib.import_module("fused_adam_cuda") + + self._amp_scale_adjustment = amp_scale_adjustment + + if use_mt: + raise RuntimeError('DistributedFusedAdam does not support use_mt.') + if amsgrad: + raise RuntimeError('DistributedFusedAdam does not support the AMSGrad variant.') + + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + max_grad_norm=max_grad_norm) + super(DistributedFusedAdamV3, self).__init__(params, defaults) + self.eps_mode = 0 if eps_inside_sqrt else 1 + + self._overflow_buf = torch.cuda.IntTensor([0]) + + assert (len(self.param_groups) == 1), "More than one parameter group is not supported." + + # Way to revert a step + # 3 -> undo kernel + double buffer (debug, print norm of difference) + # 2 -> double buffer fp32 parameters + # 1 -> undo kernel + self._revert_method = revert_method + if self._revert_method > 1: + print("revert_method -> double buffer fp32 parameters, will consume more memory") + + self._last_step = False + self._overlap_reductions = overlap_reductions + self._global_scale = None + self._num_blocks = dwu_num_blocks + self._predivide = predivide + self._e5m2_allgather = e5m2_allgather + self._do_not_flatten_model = do_not_flatten_model + self._full_pipeline = full_pipeline + self._L2_grad_norm = None + self._group_size = torch.cuda.device_count() if dwu_group_size <= 0 else dwu_group_size + self._world_size = torch.distributed.get_world_size() + self._num_groups = self._world_size // self._group_size + self._rank_in_group = torch.distributed.get_rank() % self._group_size + + p_offset = 0 + p_i = 0 + self._param_state = None + self._model_params = [] + self._grads_info = [] + self._grad_accs = [] + for group in self.param_groups: + self._param_group = group + prev = None + for p in group['params']: + torch.distributed.broadcast(p,0) + if not p.requires_grad: + continue + self._model_params.append(p) + state = self.state[p] + if len(state) == 0: + state['step'] = 0 + if self._param_state is None: + self._param_state = state + p_grads_size = p.numel() + def wrapper(param, param_i, param_grads_size, param_offset): + param_tmp = param.expand_as(param) + grad_acc = param_tmp.grad_fn.next_functions[0][0] + def allreduce_hook(*unused): + self._do_overlapped_reduction(param_i, param_grads_size, param_offset, param) + grad_acc.register_hook(allreduce_hook) + self._grad_accs.append(grad_acc) + self._grads_info.append({"param_grads_size":p_grads_size, "param_offset":p_offset}) + wrapper(p, p_i, p_grads_size, p_offset) + p_offset += p_grads_size + # Only enforce 128b alignment (64 * fp16) for non-consecutive parameters + # RNN is one example of consecutive parameters: + # (weight_ih, weight_hh, bias_ih, bias_hh) + if prev is not None and (prev.data_ptr() + prev.numel() * prev.element_size() != p.data_ptr()): + p_offset = ((p_offset + 63) // 64) * 64 + prev = p + p_i += 1 + self._grads_generated = [False]*len(self._grads_info) + self._flat_mt = flat_mt + self._grads = [] + self._current_block = self._num_blocks + + self._net_total_param_size = p_offset + self._total_param_size = p_offset + dwu_min_page_size = 256 * self._num_blocks * self._group_size + self._total_param_size = ((self._total_param_size + dwu_min_page_size - 1) // dwu_min_page_size) * dwu_min_page_size + self._block_size = self._total_param_size // self._num_blocks + self._shard_size = self._total_param_size // self._group_size + print("self._net_total_param_size=%d, self._total_param_size=%d, dwu_min_page_size=%d, self._block_size=%d, self._shard_size=%d" % (self._net_total_param_size, self._total_param_size,dwu_min_page_size,self._block_size,self._shard_size)) + + self._low_param_i = [0]*self._num_blocks + for block_id in range(self._num_blocks-1,-1,-1): + p_i = len(self._grads_info)-1 + while p_i > 0 and self._grads_info[p_i]["param_offset"] > block_id*self._block_size: + p_i -= 1 + self._low_param_i[block_id] = p_i + print(self._low_param_i) + + self._flat_grads = torch.zeros([self._total_param_size], dtype=torch.float16, device='cuda') + self._flat_params = torch.zeros_like(self._flat_grads) + + def _flat_split(flat): + def __flat_blockify(flat): + return [flat[block_id*self._block_size:(block_id+1)*self._block_size] for block_id in range(self._num_blocks)] + def __flat_shardify(flat): + return [flat[shard_id*self._shard_size:(shard_id+1)*self._shard_size] for shard_id in range(self._group_size)] + return __flat_blockify(flat), __flat_shardify(flat) + self._flat_grads_blocks, self._flat_grads_shards = _flat_split(self._flat_grads) + self._flat_params_blocks, self._flat_params_shards = _flat_split(self._flat_params) + + # master params + self._fp32_p = torch.zeros([self._shard_size], dtype=torch.float32, device='cuda') + self._fp32_m = torch.zeros([self._shard_size], dtype=torch.float32, device='cuda') + self._fp32_v = torch.zeros([self._shard_size], dtype=torch.float32, device='cuda') + + # copy model params to flat_params and set_ model params to flat_params. + self._individual_flat_grads = [] + with torch.no_grad(): + for p, grads_info in zip(self._model_params, self._grads_info): + start = grads_info["param_offset"] + end = start + grads_info["param_grads_size"] + flat_p = self._flat_params[start:end].view_as(p) + flat_p.copy_(p) + p.set_(flat_p) + flat_grad = self._flat_grads[start:end] + self._individual_flat_grads.append(flat_grad) + self._fp32_p.copy_(self._flat_params_shards[self._rank_in_group].float()) + + self._dwu_st = torch.cuda.Stream() + self._l2_grad_norm_st = torch.cuda.Stream() + for group_i in range(self._num_groups): + ranks = [group_i*self._group_size+local_rank for local_rank in range(self._group_size)] + pg = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._ag_pg = pg + torch.distributed.all_reduce(self._overflow_buf, group=self._ag_pg) + + import inspect + assert ('no_copy' in inspect.getfullargspec(torch.distributed.reduce_scatter).args), "This version of c10d does not support no_copy option" + + @property + def has_overflow(self): + return True if not self.L2_grad_norm is None and not math.isfinite(self.L2_grad_norm) else False + + def set_last_step(self, last_step): + self._last_step = last_step + + def _get_flush_block(self): + flush_block = [] + if self._current_block > 0 and self._grads_generated[self._low_param_i[self._current_block-1]]: + num_grads = len(self._grads_generated) + contiguous_idx = num_grads + while contiguous_idx > 0 and self._grads_generated[contiguous_idx-1]: + contiguous_idx -= 1 + + if contiguous_idx < num_grads and self._grads_info[contiguous_idx]["param_offset"] <= (self._current_block-1)*self._block_size: + self._current_block -= 1 + start = self._current_block * self._block_size + end = (self._current_block+1) * self._block_size + flush_block = [start, end] + + return flush_block + + def __launch_step_kernel(self, p, p_copy, m, v, g): + combined_scale = self._global_scale + if self._param_group['max_grad_norm'] > 0 and math.isfinite(self.L2_grad_norm): + combined_scale = self._param_group['max_grad_norm'] / (self.L2_grad_norm / self._global_scale + 1e-6) + combined_scale = self._global_scale / min(1, combined_scale) + bias_correction = 1 if self._param_group['bias_correction'] else 0 + beta1, beta2 = self._param_group['betas'] + fused_adam_cuda.reversible_adam( + p, p_copy, m, v, g, + self._param_group['lr'], + beta1, + beta2, + self._param_group['eps'], + combined_scale, + self._param_state['step']+1, + self.eps_mode, + bias_correction, + self._param_group['weight_decay']) + + def _flatten_grad_mt(self, scale): + if self._flat_mt and len(self._grads) > 0: + self._overflow_buf.zero_() + multi_tensor_applier( + amp_C.multi_tensor_scale, + self._overflow_buf, + list(zip(*self._grads)), + scale) + self._grads = [] + + def _do_overlapped_reduction(self, param_i, param_grads_size, param_offset, param): + # handle overlapped reductions + if self._flat_mt: + self._grads.append( (param.grad, self._individual_flat_grads[param_i]) ) + else: + torch.div(param.grad, self._world_size if self._predivide else 1.0, out=self._individual_flat_grads[param_i]) + self._grads_generated[param_i]=True + if not self._last_step and self._overlap_reductions: + flush_block = self._get_flush_block() + while flush_block: + block_id = flush_block[0] // self._block_size + self._dwu_st.wait_stream(torch.cuda.current_stream()) + with torch.cuda.stream(self._dwu_st): + self._flatten_grad_mt(1.0/self._world_size if self._predivide else 1.0) + torch.distributed.all_reduce(self._flat_grads_blocks[block_id]) + if block_id == 0: + self._l2_grad_norm_st.wait_stream(self._dwu_st) + with torch.cuda.stream(self._l2_grad_norm_st): + self._L2_grad_norm = self._flat_grads.norm(dtype=torch.float32, p=2).item() + flush_block = self._get_flush_block() + + def set_global_scale(self, global_scale): + """Set global scale. + """ + self._global_scale = global_scale + + @property + def global_scale(self): + return self._global_scale + + @property + def L2_grad_norm(self): + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + return self._L2_grad_norm + + def complete_reductions(self): + """Complete reductions if full pipeline is not selected or overlap is not allowed. + """ + + if self._last_step: + # zero out gradients that have not been completed yet + for param_i, flat_grad in enumerate(self._individual_flat_grads): + if not self._grads_generated[param_i]: + flat_grad.zero_() + self._grads_generated[param_i] = True + + if self._last_step or not self._overlap_reductions: + # nothing done so far, run full pipeline after reductions + self._dwu_st.wait_stream(torch.cuda.current_stream()) + with torch.cuda.stream(self._dwu_st): + self._flatten_grad_mt(1.0/self._world_size if self._predivide else 1.0) + torch.distributed.all_reduce(self._flat_grads) + self._l2_grad_norm_st.wait_stream(self._dwu_st) + with torch.cuda.stream(self._l2_grad_norm_st): + self._L2_grad_norm = self._flat_grads.norm(dtype=torch.float32, p=2).item() + + self._current_block = self._num_blocks + self._grads_generated = [False]*len(self._grads_info) + + def step(self, closure=None, skip_overflow_check=False): + loss = None + if closure is not None: + loss = closure() + + with torch.cuda.stream(self._dwu_st): + self.__launch_step_kernel( + self._fp32_p, + self._flat_params_shards[self._rank_in_group], + self._fp32_m, + self._fp32_v, + self._flat_grads_shards[self._rank_in_group]) + torch.distributed.all_gather(self._flat_params_shards, self._flat_params_shards[self._rank_in_group], group=self._ag_pg, no_copy=True) + for p in self._model_params: self.state[p]['step'] += 1 + + torch.cuda.current_stream().wait_stream(self._dwu_st) + + return loss + + diff --git a/apex/apex/contrib/optimizers/distributed_fused_lamb.py b/apex/apex/contrib/optimizers/distributed_fused_lamb.py new file mode 100644 index 0000000000000000000000000000000000000000..c06e5b733781a1952c81a1052abbfb90dd588039 --- /dev/null +++ b/apex/apex/contrib/optimizers/distributed_fused_lamb.py @@ -0,0 +1,722 @@ +import math +import torch +import importlib +import amp_C +from apex.multi_tensor_apply import multi_tensor_applier + +import torch.distributed.distributed_c10d as c10d + +class DistributedFusedLAMB(torch.optim.Optimizer): + + """Implements LAMB algorithm. + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./``. + + This version of fused LAMB implements 2 fusions. + + * Fusion of the LAMB update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.optimizers.FusedLAMB`'s usage is identical to any ordinary Pytorch optimizer:: + + opt = apex.optimizers.FusedLAMB(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedLAMB` may be used with or without Amp. If you wish to use :class:`FusedLAMB` with Amp, + you may choose any ``opt_level``:: + + opt = apex.optimizers.FusedLAMB(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + + In general, ``opt_level="O1"`` is recommended. + + LAMB was proposed in `Large Batch Optimization for Deep Learning: Training BERT in 76 minutes`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its norm. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + NOT SUPPORTED now! (default: False) + adam_w_mode (boolean, optional): Apply L2 regularization or weight decay + True for decoupled weight decay(also known as AdamW) (default: True) + grad_averaging (bool, optional): whether apply (1-beta2) to grad when + calculating running averages of gradient. (default: True) + set_grad_none (bool, optional): whether set grad to None when zero_grad() + method is called. (default: True) + max_grad_norm (float, optional): value used to clip global grad norm + (default: 1.0) + use_nvlamb (boolean, optional): Apply adaptive learning rate to 0.0 + weight decay parameter (default: False) + step_supports_amp_scaling(boolean, optional): whether to use customized + gradient unscaling logic (default: True) + + .. _Large Batch Optimization for Deep Learning - Training BERT in 76 minutes: + https://arxiv.org/abs/1904.00962 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + class AtomicCounter(object): + def __init__(self): + self.value = 0 + self.order = [] + import threading + self._lock = threading.Lock() + + def add(self, idx): + with self._lock: + self.value += 1 + self.order.append(idx) + + def __init__(self, params, + lr=1e-3, bias_correction = True, grad_averaging=True, + betas=(0.9, 0.999), eps=1e-8, + weight_decay=0., max_grad_norm=0., + adam_w_mode=True, use_nvlamb=False, + step_supports_amp_scaling=True, overlap_reductions=True, + dwu_group_size=0, dwu_num_blocks=4, dwu_num_chunks=4, + dwu_num_rs_pg=1, dwu_num_ar_pg=4, dwu_num_ag_pg=0, + e5m2_allgather=False, verbose=False): + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + grad_averaging=grad_averaging, + max_grad_norm=max_grad_norm) + + super(DistributedFusedLAMB, self).__init__(params, defaults) + + global fused_adam_cuda, distributed_lamb_cuda + fused_adam_cuda = importlib.import_module("fused_adam_cuda") + distributed_lamb_cuda = importlib.import_module("distributed_lamb_cuda") + + self._overflow_buf = torch.cuda.IntTensor([0]) + self._has_overflow = False + self.multi_tensor_lamb_compute_update_term = distributed_lamb_cuda.multi_tensor_lamb_compute_update_term + self.multi_tensor_lamb_update_weights = distributed_lamb_cuda.multi_tensor_lamb_update_weights + import amp_C + self.multi_tensor_l2norm = amp_C.multi_tensor_l2norm + + self._grad_averaging = grad_averaging + self._adam_w_mode = 1 if adam_w_mode else 0 + self._use_nvlamb = use_nvlamb + self._step_supports_amp_scaling = step_supports_amp_scaling + self._is_accumulation_step = False + self._last_step = False + self._overlap_reductions = overlap_reductions + self._global_scale = None + self._num_blocks = dwu_num_blocks + self._num_chunks = dwu_num_chunks + self._e5m2_allgather = e5m2_allgather + self._verbose = verbose + self._L2_grad_norm = None + + self._current_process_group = c10d._get_default_group() + self._available_ranks = list(c10d._pg_group_ranks[self._current_process_group].keys()) + self._group_size = torch.cuda.device_count() if dwu_group_size <= 0 else dwu_group_size + self._world_size = torch.distributed.get_world_size() + self._num_groups = self._world_size // self._group_size + self._rank_in_group = torch.distributed.get_rank() % self._group_size + + self._lr = torch.tensor(0.0, dtype=torch.float32, device='cuda') + + self._resume_from_checkpoint = False + self._step = torch.cuda.IntTensor([0]) + + # Master weight, moment, gradient buffers + self._fp32_p, self._fp32_m, self._fp32_v, self._fp16_p, self._fp16_g = None, None, None, None, None + + import inspect + assert ('no_copy' in inspect.getfullargspec(torch.distributed.reduce_scatter).args), "This version of c10d does not support no_copy option" + + self._num_rs_pg = dwu_num_rs_pg + self._num_ar_pg = dwu_num_ar_pg + self._num_ag_pg = dwu_num_ag_pg + if self._num_groups > 1: + self._ar_pg = [] + for dev_i in range(self._group_size): + ranks = [dev_i+j*self._group_size for j in range(self._num_groups)] + for i in range(self._num_ar_pg): + if self._verbose: + print(f"creating new group {i}: {ranks}") + grp = torch.distributed.new_group(ranks=ranks) + if grp != torch.distributed.GroupMember.NON_GROUP_MEMBER: + if self._verbose: + print(f"group {i}: init barrier (device: {torch.cuda.current_device()})") + torch.distributed.barrier(group=grp, device_ids=[torch.cuda.current_device()]) + if self._verbose: + print(f"created new group {i}") + + if torch.distributed.get_rank() in ranks: + self._ar_pg.append(grp) + self._ar_st = [torch.cuda.Stream() for _ in range(self._num_ar_pg)] + #for ar_pg in self._ar_pg: + # torch.distributed.all_reduce(self._overflow_buf,group=ar_pg) + rs_ranks = [] + for group_i in range(self._num_groups): + rs_ranks.append([group_i*self._group_size+j for j in range(self._group_size)]) + self._rs_pg = [] + for group_i in range(self._num_groups): + ranks = rs_ranks[group_i] + for i in range(self._num_rs_pg): + grp = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._rs_pg.append(grp) + l2_grad_norm_pg = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._l2_grad_norm_pg = l2_grad_norm_pg + #torch.distributed.all_reduce(self._overflow_buf,group=self._l2_grad_norm_pg) + self._rs_st = [torch.cuda.Stream() for _ in range(self._num_rs_pg)] + #for rs_pg in self._rs_pg: + # torch.distributed.all_reduce(self._overflow_buf,group=rs_pg) + if self._num_ag_pg == 0: + self._ag_pg = self._rs_pg + self._ag_st = self._rs_st + self._num_ag_pg = self._num_rs_pg + else: + self._ag_pg = [] + for group_i in range(self._num_groups): + ranks = rs_ranks[group_i] + for i in range(self._num_ag_pg): + grp = torch.distributed.new_group(ranks=ranks) + if torch.distributed.get_rank() in ranks: + self._ag_pg.append(grp) + self._ag_st = [torch.cuda.Stream() for _ in range(self._num_ag_pg)] + #for ag_pg in self._ag_pg: + # torch.distributed.all_reduce(self._overflow_buf,group=ag_pg) + self._l2_grad_norm_st = torch.cuda.Stream() + self._completion_st = torch.cuda.Stream() + self._step.record_stream(self._completion_st) + + self._reductions_works = [None]*self._num_blocks + self._allgather_works = [None]*self._num_blocks + + self._one = torch.cuda.IntTensor([1]) + + self._first_step = True + self._lazy_init_stage1_done, self._lazy_init_stage2_done = False, False + self._param_order = self.AtomicCounter() + + def _lazy_init_stage1(self): + if self._lazy_init_stage1_done: return + + p_offset = 0 + p_i = 0 + self._model_params = [] + self._grad_accs = [] + self._group_properties = [] + for group in self.param_groups: + prev = None + beta1, beta2 = group['betas'] + beta3 = 1.0 - beta1 if self._grad_averaging else 1.0 + bias_correction = 1 if group['bias_correction'] else 0 + eps = group['eps'] + weight_decay = group['weight_decay'] + for p in group['params']: + torch.distributed.broadcast(p, 0) + if not p.requires_grad: + continue + self._model_params.append(p) + self._group_properties.append(( + weight_decay, + bias_correction, + beta1, + beta2, + beta3, + eps + )) + p_grads_size = p.numel() + def wrapper(param, param_i): + param_tmp = param.expand_as(param) + grad_acc = param_tmp.grad_fn.next_functions[0][0] + def allreduce_hook(*unused): + if self._first_step: + # first time + self._param_order.add(param_i) + else: + idx = self._param_order.order.index(param_i) + self._do_overlapped_reduction(idx, param) + grad_acc.register_hook(allreduce_hook) + self._grad_accs.append(grad_acc) + wrapper(p, p_i) + p_offset += p_grads_size + # Only enforce 128b alignment (64 * fp16) for non-consecutive parameters + # RNN is one example of consecutive parameters: + # (weight_ih, weight_hh, bias_ih, bias_hh) + if prev is not None and (prev.data_ptr() + prev.numel() * prev.element_size() != p.data_ptr()): + p_offset = ((p_offset + 63) // 64) * 64 + prev = p + p_i += 1 + self._grads_generated = [False]*len(self._model_params) + self._grads_fp16, self._grads_fp32 = [], [] + if self._overlap_reductions: + self._current_block = self._num_blocks + + self._net_total_param_size = p_offset + self._total_param_size = p_offset + dwu_min_page_size = 256 * self._num_blocks * self._num_chunks * self._group_size + self._total_param_size = ((self._total_param_size + dwu_min_page_size - 1) // dwu_min_page_size) * dwu_min_page_size + self._block_size = self._total_param_size // self._num_blocks + self._chunk_size = self._block_size // self._num_chunks + self._shard_size = self._chunk_size // self._group_size + #print("self._net_total_param_size=%d, self._total_param_size=%d, dwu_min_page_size=%d, self._block_size=%d, self._chunk_size=%d, self._shard_size=%d" % (self._net_total_param_size, self._total_param_size,dwu_min_page_size,self._block_size,self._chunk_size,self._shard_size)) + + self._flat_grads = torch.zeros([self._total_param_size], dtype=torch.float16, device='cuda') + self._new_params = torch.zeros([self._total_param_size], dtype=torch.uint8 if self._e5m2_allgather else torch.float16, device='cuda') + self._mega_shard_size = self._num_blocks * self._num_chunks * self._shard_size + # initialize master weights, moments buffers if not loaded from checkpoint + if self._fp32_p is None: + self._fp32_p = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_m = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_v = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + self._fp32_u = torch.zeros([self._mega_shard_size], dtype=torch.float32, device='cuda') + # FIXME: Rethink fp16 label since it's either uint8 or fp16 + self._fp16_p = torch.zeros([self._mega_shard_size], dtype=torch.uint8 if self._e5m2_allgather else torch.float16, device='cuda') + self._fp16_g = torch.zeros([self._mega_shard_size], dtype=torch.float16, device='cuda') + + def _flat_split(p): + def __blockify(p): + return [p[block_id*self._block_size:(block_id+1)*self._block_size] for block_id in range(self._num_blocks)] + def __chunkify(p): + return [p[chunk_id*self._chunk_size:(chunk_id+1)*self._chunk_size] for chunk_id in range(self._num_chunks)] + def __shardify(p): + return [p[shard_id*self._shard_size:(shard_id+1)*self._shard_size] for shard_id in range(self._group_size)] + list_of_blocks = __blockify(self._flat_grads) + list_of_list_of_chunks = [__chunkify(block) for block in list_of_blocks] + list_of_list_of_list_of_shards = [[__shardify(chunk) for chunk in chunks] for chunks in list_of_list_of_chunks] + return list_of_blocks, list_of_list_of_chunks, list_of_list_of_list_of_shards + self._flat_grads_blocks, self._flat_grads_chunks, self._flat_grads_shards = _flat_split(self._flat_grads) + def _full_packed_split(p): + def __shardify(p): + return [p[mega_shard*self._mega_shard_size:(mega_shard+1)*self._mega_shard_size] for mega_shard in range(self._group_size)] + def __blockify(p): + return [p[block_id*self._num_chunks*self._shard_size:(block_id+1)*self._num_chunks*self._shard_size] for block_id in range(self._num_blocks)] + def __chunkify(p): + return [p[chunk_id*self._shard_size:(chunk_id+1)*self._shard_size] for chunk_id in range(self._num_chunks)] + list_of_mega_shards = __shardify(p) + list_of_list_of_mega_blocks = [__blockify(mega_shard) for mega_shard in list_of_mega_shards] + list_of_list_of_list_of_mega_chunks = [[__chunkify(mega_block) for mega_block in mega_blocks] for mega_blocks in list_of_list_of_mega_blocks] + return list_of_mega_shards, list_of_list_of_mega_blocks, list_of_list_of_list_of_mega_chunks + self._new_params_mega_shards, self._new_params_mega_blocks, self._new_params_mega_chunks = _full_packed_split(self._new_params) + def _packed_split(p): + def __packed_blockify(p): + packed_block_size = self._num_chunks*self._shard_size + return [p[block_id*packed_block_size:(block_id+1)*packed_block_size] for block_id in range(self._num_blocks)] + def __packed_chunkify(p): + # in the packed format, each chunk contains one shard, so packed_chunk_size == self._shard_size + return [p[chunk_id*self._shard_size:(chunk_id+1)*self._shard_size] for chunk_id in range(self._num_chunks)] + list_of_blocks = __packed_blockify(p) + list_of_list_of_chunks = [__packed_chunkify(block) for block in list_of_blocks] + return list_of_blocks, list_of_list_of_chunks + self._fp32_p_blocks, self._fp32_p_chunks = _packed_split(self._fp32_p) + self._fp32_m_blocks, self._fp32_m_chunks = _packed_split(self._fp32_m) + self._fp32_v_blocks, self._fp32_v_chunks = _packed_split(self._fp32_v) + self._fp32_u_blocks, self._fp32_u_chunks = _packed_split(self._fp32_u) + self._fp16_p_blocks, self._fp16_p_chunks = _packed_split(self._fp16_p) + self._fp16_g_blocks, self._fp16_g_chunks = _packed_split(self._fp16_g) + + self._lazy_init_stage1_done = True + + def _lazy_init_stage2(self): + if self._lazy_init_stage2_done: return + + self._param_order.order.reverse() + + # re-order model_params, grad_accs, group_properties lists + self._model_params = [self._model_params[i] for i in self._param_order.order] + self._grad_accs = [self._grad_accs[i] for i in self._param_order.order] + self._group_properties = [self._group_properties[i] for i in self._param_order.order] + + # re-collect grads info (size, offset) after ordering + prev = None + p_offset = 0 + self._grads_info = [] + self._individual_flat_grads = [] + for i, p in enumerate(self._model_params): + p_grads_size = p.numel() + self._grads_info.append({"param_grads_size":p_grads_size, "param_offset":p_offset}) + self._individual_flat_grads.append(self._flat_grads[p_offset:p_offset+p_grads_size].view_as(p)) + # for the first iteration + self._do_overlapped_reduction(i, p) + p_offset += p_grads_size + # Only enforce 128b alignment (64 * fp16) for non-consecutive parameters + # RNN is one example of consecutive parameters: + # (weight_ih, weight_hh, bias_ih, bias_hh) + if prev is not None and (prev.data_ptr() + prev.numel() * prev.element_size() != p.data_ptr()): + p_offset = ((p_offset + 63) // 64) * 64 + prev = p + + self._low_param_i = [0]*self._num_blocks + for block_id in range(self._num_blocks-1,-1,-1): + p_i = len(self._grads_info)-1 + while p_i > 0 and self._grads_info[p_i]["param_offset"] > block_id*self._block_size: + p_i -= 1 + self._low_param_i[block_id] = p_i + #print("self._low_param_i", self._low_param_i) + + # This paragraph does two things: + # 1) Copy model parameters into master buffer + # 2) Create tensor lists for unpacking new parameter tensor after all-gather + self._packed_flat_to_model_params_fp16 = [] + self._packed_flat_to_model_params_fp32 = [] + self._model_params_num = len(self._model_params) + self._contrib_tensor_list = [] + self._contrib_min_param_i, self._contrib_max_param_i = -1, -1 + self._contrib_update_frag_for_norm = [] + self._contrib_model_param_for_norm_fp16 = [] + self._contrib_model_param_for_norm_fp32 = [] + self._contrib_model_param_for_norm_is_fp16 = [] + self._model_param_is_contrib = [] + self._contrib_group_properties = [] + for shard_id in range(self._group_size): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + flat_shard_start = (((block_id * self._num_chunks + chunk_id) * self._group_size) + shard_id) * self._shard_size + flat_shard_end = flat_shard_start + self._shard_size + for param_i, (p, grads_info, group_props) in enumerate(zip(self._model_params, self._grads_info, self._group_properties)): + flat_grad_start = grads_info["param_offset"] + flat_grad_end = flat_grad_start + grads_info["param_grads_size"] + clipped_start = (lambda a,b: a if a > b else b)(flat_grad_start, flat_shard_start) + clipped_end = (lambda a,b: a if a < b else b)(flat_grad_end, flat_shard_end) + if clipped_start < clipped_end: + grad_offset = clipped_start - flat_grad_start + grad_length = clipped_end - clipped_start + shard_offset = clipped_start - flat_shard_start + model_param_fragment = p.view(-1)[grad_offset:grad_offset+grad_length] + new_param_packed_fragment = self._new_params_mega_chunks[shard_id][block_id][chunk_id][shard_offset:shard_offset+grad_length] + if model_param_fragment.dtype == torch.float16: + self._packed_flat_to_model_params_fp16.append( (new_param_packed_fragment, model_param_fragment) ) + else: + self._packed_flat_to_model_params_fp32.append( (new_param_packed_fragment, model_param_fragment) ) + if shard_id == self._rank_in_group: + self._model_param_is_contrib.append(param_i) + # copy model parameters into master buffer + master_param_fragment = self._fp32_p_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_m_fragment = self._fp32_m_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_v_fragment = self._fp32_v_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_u_fragment = self._fp32_u_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_g_fragment = self._fp16_g_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + opti_state_p_fragment = self._fp16_p_chunks[block_id][chunk_id][shard_offset:shard_offset+grad_length] + #print("model_param_fragment.size()=%s, new_param_packed_fragment.size()=%s, master_param_fragment.size()=%s" % (str(model_param_fragment.size()), str(new_param_packed_fragment.size()), str(master_param_fragment.size()))) + if not self._resume_from_checkpoint: + master_param_fragment.copy_(model_param_fragment) + self._contrib_group_properties.append(group_props) + self._contrib_tensor_list.append((master_param_fragment, opti_state_m_fragment, opti_state_v_fragment, opti_state_u_fragment, opti_state_g_fragment, opti_state_p_fragment)) # p, m, v, u, g, p_copy + self._contrib_update_frag_for_norm.append(opti_state_u_fragment) + if p.dtype == torch.float16: + self._contrib_model_param_for_norm_fp16.append(p) + else: + self._contrib_model_param_for_norm_fp32.append(p) + self._contrib_model_param_for_norm_is_fp16.append(True if p.dtype == torch.float16 else False) + if self._contrib_min_param_i < 0: self._contrib_min_param_i = param_i + self._contrib_max_param_i = param_i + self._contrib_model_param_for_norm_num = len(self._contrib_model_param_for_norm_is_fp16) + if len(self._contrib_model_param_for_norm_fp16) == 0: self._contrib_model_param_for_norm_fp16 = None + if len(self._contrib_model_param_for_norm_fp32) == 0: self._contrib_model_param_for_norm_fp32 = None + self._contrib_model_param_for_norm_is_fp32 = torch.tensor([not is_fp16 for is_fp16 in self._contrib_model_param_for_norm_is_fp16], dtype=torch.bool, device='cuda') + self._contrib_model_param_for_norm_is_fp16 = torch.tensor([is_fp16 for is_fp16 in self._contrib_model_param_for_norm_is_fp16], dtype=torch.bool, device='cuda') + self._offsets = torch.tensor(self._model_param_is_contrib, dtype=torch.int64, device='cuda') + + p, m, v, u, g, p_copy = list(zip(*self._contrib_tensor_list)) + self._contrib_compute_update_term_tensor_list = [g, p, m, v, u] + self._contrib_update_weights_tensor_list = [u, p, p_copy] + + math_type = self._fp32_u.dtype + decay, bias_correction, beta1, beta2, beta3, epsilon = list(zip(*self._contrib_group_properties)) + self._contrib_beta1 = torch.tensor(beta1, dtype=math_type, device='cuda') + self._contrib_beta2 = torch.tensor(beta2, dtype=math_type, device='cuda') + self._contrib_beta3 = torch.tensor(beta3, dtype=math_type, device='cuda') + self._contrib_bias_correction = torch.tensor(bias_correction, dtype=torch.int, device='cuda') + self._contrib_epsilon = torch.tensor(epsilon, dtype=math_type, device='cuda') + self._contrib_weight_decay = torch.tensor(decay, dtype=math_type, device='cuda') + + self._packed_flat_to_model_params_fp16 = list(zip(*self._packed_flat_to_model_params_fp16)) if len(self._packed_flat_to_model_params_fp16) > 0 else None + self._packed_flat_to_model_params_fp32 = list(zip(*self._packed_flat_to_model_params_fp32)) if len(self._packed_flat_to_model_params_fp32) > 0 else None + + self._lazy_init_stage2_done = True + + self.complete_reductions() + self._first_step = False + + def set_is_accumulation_step(self, is_accumulation_step): + self._is_accumulation_step = is_accumulation_step + + def set_last_step(self, last_step): + self._last_step = last_step + + def _get_flush_block(self): + flush_block = [] + if self._current_block > 0 and self._grads_generated[self._low_param_i[self._current_block-1]]: + num_grads = len(self._grads_generated) + contiguous_idx = num_grads + while contiguous_idx > 0 and self._grads_generated[contiguous_idx-1]: + contiguous_idx -= 1 + + if contiguous_idx < num_grads and self._grads_info[contiguous_idx]["param_offset"] <= (self._current_block-1)*self._block_size: + self._current_block -= 1 + start = self._current_block * self._block_size + end = (self._current_block+1) * self._block_size + flush_block = [start, end] + + return flush_block + + def _pipeline_block_reductions(self, block_id): + self._flatten_grad_mt(1.0/self._world_size) + + # Reduction within each node + # Changes gradient format from [block * chunk * shard] to [shard * block * chunk] + # The output format is the same as the fp32 master parameters + works = [None]*self._num_chunks + for chunk_id in range(self._num_chunks): + glob_chunk_id = block_id * self._num_chunks + chunk_id + rs_stream = self._rs_st[glob_chunk_id%self._num_rs_pg] + rs_stream.wait_stream(torch.cuda.current_stream()) + with torch.cuda.stream(rs_stream): + works[chunk_id] = torch.distributed.reduce_scatter(self._fp16_g_chunks[block_id][chunk_id],self._flat_grads_shards[block_id][chunk_id],group=self._rs_pg[glob_chunk_id%self._num_rs_pg],async_op=True,no_copy=True) + + # Reduction across nodes for each rank + if self._num_groups > 1: + for chunk_id in range(self._num_chunks): + glob_chunk_id = block_id * self._num_chunks + chunk_id + ar_stream = self._ar_st[glob_chunk_id%self._num_ar_pg] + with torch.cuda.stream(ar_stream): + works[chunk_id].wait() + works[chunk_id] = torch.distributed.all_reduce(self._fp16_g_chunks[block_id][chunk_id],group=self._ar_pg[glob_chunk_id%self._num_ar_pg],async_op=True) + self._reductions_works[block_id] = works + + # Compute L2 grad norm + if block_id == 0: + with torch.cuda.stream(self._l2_grad_norm_st): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + # Since the packed format is contiguous after reductions, only one norm is needed + l2_grad_norm_sq = torch.empty([1], device='cuda') + l2_grad_norm_sq = self._fp16_g.norm(dtype=torch.float32, p=2)**2 + torch.distributed.all_reduce(l2_grad_norm_sq, group=self._l2_grad_norm_pg) + self._L2_grad_norm = l2_grad_norm_sq.sqrt() + + def __compute_contrib_param_norm(self): + if self._contrib_model_param_for_norm_fp16 is not None and self._contrib_model_param_for_norm_fp32 is not None: + gnorm_fp16 = multi_tensor_applier(self.multi_tensor_l2norm, self._overflow_buf, [self._contrib_model_param_for_norm_fp16], True)[1] + gnorm_fp32 = multi_tensor_applier(self.multi_tensor_l2norm, self._overflow_buf, [self._contrib_model_param_for_norm_fp32], True)[1] + gnorm = torch.empty(size=[self._contrib_model_param_for_norm_num], dtype=torch.bool, device='cuda') + gnorm.masked_scatter_(self._contrib_model_param_for_norm_is_fp16, gnorm_fp16) + gnorm.masked_scatter_(self._contrib_model_param_for_norm_is_fp32, gnorm_fp32) + elif self._contrib_model_param_for_norm_fp16 is not None: + gnorm = multi_tensor_applier(self.multi_tensor_l2norm, self._overflow_buf, [self._contrib_model_param_for_norm_fp16], True)[1] + elif self._contrib_model_param_for_norm_fp32 is not None: + gnorm = multi_tensor_applier(self.multi_tensor_l2norm, self._overflow_buf, [self._contrib_model_param_for_norm_fp32], True)[1] + return gnorm + + def __compute_contrib_update_norm(self): + l2_norm = torch.zeros(size=[self._model_params_num], dtype=torch.float32, device='cuda') + local_contrib_l2_norm = multi_tensor_applier(self.multi_tensor_l2norm, self._overflow_buf, [self._contrib_update_frag_for_norm], True)[1] ** 2 + l2_norm.scatter_(dim=0, index=self._offsets, src=local_contrib_l2_norm) + torch.distributed.all_reduce(l2_norm, group=self._ag_pg[0]) + l2_norm = torch.sqrt(l2_norm) + return l2_norm + + def _pipeline_step(self): + global_scale = self.global_scale + max_grad_norm = self.defaults['max_grad_norm'] + global_grad_norm = self.L2_grad_norm + + # check global_grad_norm and fill overflow_buf + is_finite = (global_grad_norm + 1 > global_grad_norm).int() + self._overflow_buf = self._one * (is_finite ^ self._one) # toggle between 0 and 1 + + # increment step counter if no overflow + self._step += is_finite + self._completion_st.wait_stream(torch.cuda.current_stream()) + self._completion_st.wait_stream(self._l2_grad_norm_st) + + # Call step kernel once per step + # Call all-gather once per step + with torch.cuda.stream(self._completion_st): + for block_id in range(self._num_blocks): + for chunk_id in range(self._num_chunks): + self._reductions_works[block_id][chunk_id].wait() + param_norm = self.__compute_contrib_param_norm() + multi_tensor_applier(self.multi_tensor_lamb_compute_update_term, + self._overflow_buf, + self._contrib_compute_update_term_tensor_list, # g, p, m, v, u + self._contrib_beta1, + self._contrib_beta2, + self._contrib_beta3, + self._contrib_bias_correction, + self._step, + self._contrib_epsilon, + self._adam_w_mode, + self._contrib_weight_decay, + global_scale, + global_grad_norm, + max_grad_norm) + upd_norm = self.__compute_contrib_update_norm() + multi_tensor_applier(self.multi_tensor_lamb_update_weights, + self._overflow_buf, + self._contrib_update_weights_tensor_list, # u, p, p_copy + param_norm, + upd_norm, + self._offsets, + self._lr, + self._contrib_weight_decay, + global_grad_norm, + self._use_nvlamb) + torch.distributed.all_gather(self._new_params_mega_shards, self._fp16_p, group=self._ag_pg[0], no_copy=True) + + def _flatten_grad_mt(self, scale): + if len(self._grads_fp16) > 0: + self._overflow_buf.zero_() + multi_tensor_applier( + amp_C.multi_tensor_scale, + self._overflow_buf, + list(zip(*self._grads_fp16)), + scale) + self._grads_fp16 = [] + if len(self._grads_fp32) > 0: + self._overflow_buf.zero_() + multi_tensor_applier( + amp_C.multi_tensor_scale, + self._overflow_buf, + list(zip(*self._grads_fp32)), + scale) + self._grads_fp32 = [] + + def _do_overlapped_reduction(self, param_i, param): + if not self._is_accumulation_step: + # handle overlapped reductions + if param.dtype == torch.float16: + self._grads_fp16.append( (param.grad, self._individual_flat_grads[param_i]) ) + else: + self._grads_fp32.append( (param.grad, self._individual_flat_grads[param_i]) ) + self._grads_generated[param_i]=True + if not self._first_step and not self._last_step: + if self._overlap_reductions: + flush_block = self._get_flush_block() + while flush_block: + block_id = flush_block[0] // self._block_size + self._pipeline_block_reductions(block_id) + flush_block = self._get_flush_block() + + def set_global_scale(self, global_scale): + """Set global scale. + """ + self._global_scale = global_scale + + @property + def global_scale(self): + return self._global_scale + + @property + def L2_grad_norm(self): + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + return self._L2_grad_norm + + def complete_reductions(self): + """Complete reductions if full pipeline is not selected or overlap is not allowed. + """ + if self._last_step: + # zero out gradients that have not been completed yet + for param_i, grad_generated in enumerate(self._grads_generated): + if not grad_generated: + grad_info = self._grads_info[param_i] + param_offset = grad_info["param_offset"] + param_size = grad_info["param_grads_size"] + self._flat_grads[param_offset:param_offset+param_size].zero_() + self._grads_generated[param_i] = True + + if self._first_step or self._last_step or not self._overlap_reductions: + # nothing done so far, run full pipeline after reductions + for block_id in range(self._num_blocks-1,-1,-1): + self._pipeline_block_reductions(block_id) + + torch.cuda.current_stream().wait_stream(self._l2_grad_norm_st) + + self._current_block = self._num_blocks + self._grads_generated = [False]*len(self._grads_info) + + def step(self, closure=None, grad_scaler=None): + loss = None + if closure is not None: + loss = closure() + + self._pipeline_step() + + if grad_scaler is not None: + found_inf = self._overflow_buf.float() + optimizer_state = grad_scaler._per_optimizer_states[id(self)] + current_device = torch.device('cuda', torch.cuda.current_device()) + optimizer_state["found_inf_per_device"][current_device] = found_inf + + self._completion_st.wait_stream(torch.cuda.current_stream()) + + with torch.cuda.stream(self._completion_st): + # Copy self._new_params to model params + with torch.no_grad(): + if self._packed_flat_to_model_params_fp16 is not None: + multi_tensor_applier( + fused_adam_cuda.maybe_cast_mt, + self._overflow_buf, + self._packed_flat_to_model_params_fp16) + if self._packed_flat_to_model_params_fp32 is not None: + multi_tensor_applier( + fused_adam_cuda.maybe_cast_mt, + self._overflow_buf, + self._packed_flat_to_model_params_fp32) + + torch.cuda.current_stream().wait_stream(self._completion_st) + + self._reductions_works = [None]*self._num_blocks + self._allgather_works = [None]*self._num_blocks + + return loss + + def state_dict(self): + """ + Returns a dict containing the current state of this :class:`DistributedFusedAdam` instance. + Example:: + checkpoint = {} + checkpoint['model'] = model.state_dict() + checkpoint['optimizer'] = optimizer.state_dict() + torch.save(checkpoint, "saved.pth") + """ + # save step, master weights and first/second moments + state_dict = {} + state_dict['step'] = self._step + state_dict['fp32_p'] = self._fp32_p + state_dict['fp32_m'] = self._fp32_m + state_dict['fp32_v'] = self._fp32_v + return state_dict + + def load_state_dict(self, state_dict): + """ + Loads a state_dict created by an earlier call to state_dict(). + If an DistributedFusedAdam instance was constructed from some ``init_optimizer``, + whose parameters in turn came from ``model``, it is expected that the user + will call ``model.load_state_dict()`` before + ``optimizer.load_state_dict()`` is called. + Example:: + model = torch.nn.Linear(D_in, D_out).cuda().half() + optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + optimizer = FP16_Optimizer(optimizer, static_loss_scale = 128.0) + ... + checkpoint = torch.load("saved.pth") + model.load_state_dict(checkpoint['model']) + optimizer.load_state_dict(checkpoint['optimizer']) + """ + # restore step, master weights and first/second moments + self._step = state_dict['step'] + self._fp32_p = state_dict['fp32_p'].to(device="cuda") + self._fp32_m = state_dict['fp32_m'].to(device="cuda") + self._fp32_v = state_dict['fp32_v'].to(device="cuda") + self._resume_from_checkpoint = True diff --git a/apex/apex/contrib/optimizers/fp16_optimizer.py b/apex/apex/contrib/optimizers/fp16_optimizer.py new file mode 100755 index 0000000000000000000000000000000000000000..0cbb63b829a34c80d3115d9a8d8dee9d9bf0ace0 --- /dev/null +++ b/apex/apex/contrib/optimizers/fp16_optimizer.py @@ -0,0 +1,243 @@ +import torch +from apex.multi_tensor_apply import multi_tensor_applier + +class FP16_Optimizer(object): + """ + :class:`FP16_Optimizer` A cutdown version of apex.fp16_utils.FP16_Optimizer. + Designed only to wrap apex.contrib.optimizers.FusedAdam, FusedSGD. + Refer to apex.fp16_utils documents for more information. + Example:: + model = torch.nn.Linear(D_in, D_out).cuda().half() + optimizer = apex.contrib.optimizers.FusedSGD(model.parameters()) + optimizer = FP16_Optimizer(optimizer, static_loss_scale = 128.0) + ... + # loss.backward() becomes: + optimizer.backward(loss) + ... + Example with dynamic loss scaling:: + ... + optimizer = FP16_Optimizer(optimizer, dynamic_loss_scale=True) + # optional arg to control dynamic loss scaling behavior + # dynamic_loss_args={'scale_window' : 500}) + # Usually, dynamic_loss_args is not necessary. + """ + + def __init__(self, + init_optimizer, + static_loss_scale=1.0, + dynamic_loss_scale=False, + dynamic_loss_args=None, + verbose=True): + + print("\nThis fp16_optimizer is designed to only work with apex.contrib.optimizers.*") + print("To update, use updated optimizers with AMP.") + # The fused optimizer does all the work. We need this layer for two reason: + # 1. maintain same user API from apex.fp16_utils + # 2. keep common stuff here in case we need to add new fused optimizer later + + if not torch.cuda.is_available: + raise SystemError("Cannot use fp16 without CUDA.") + self.optimizer = init_optimizer + + self.fp16_groups = [] # model params + self.fp32_groups = [] # master weights + + # iterate over param_groups + for param_group in self.optimizer.param_groups: + fp16_group = [] + fp32_group = [] + for p in param_group['params']: + fp16_group.append(p) + fp32_group.append(p.clone().float().detach()) + self.fp16_groups.append(fp16_group) + self.fp32_groups.append(fp32_group) + param_group['params'] = fp32_group + + if multi_tensor_applier.available: + import amp_C + self.overflow_buf = torch.cuda.IntTensor([0]) + self.multi_tensor_l2norm=amp_C.multi_tensor_l2norm + else: + raise RuntimeError('FP16_Optimizer requires cuda extensions') + + # we may have a way of fusing dynamic scale. Do not support for now + if dynamic_loss_scale: + if dynamic_loss_args is not None: + raise SystemError("Do not support dynamic loss scale args for now.") + self.dynamic_loss_scale = True + self.cur_scale = 2**16 + self.cur_iter = 0 + self.last_overflow_iter = -1 + self.scale_factor = 2 + self.scale_window = 1000 + else: + self.dynamic_loss_scale = False + self.cur_iter = 0 + self.cur_scale = static_loss_scale + self.verbose = verbose + + def zero_grad(self, set_grads_to_None=True): + """ + Zero FP16 parameter grads. + """ + # FP32 grad should never exist. + # For speed, set model fp16 grad to None by default + for group in self.fp16_groups: + for p in group: + if set_grads_to_None: + p.grad = None + else: + if p.grad is not None: + p.grad.detach_() + p.grad.zero_() + + def step(self, closure=None): + """ + Not supporting closure. + """ + fp16_grads = [] + norm_groups = [] + skip = False + + for group in self.fp16_groups: + fp16_grad = [] + for i, p in enumerate(group): + fp16_grad.append(p.grad) + fp16_grads.append(fp16_grad) + + # nan check + self.overflow_buf.zero_() + for fp16_grad in fp16_grads: + if len(fp16_grad) > 0: + norm, norm_per_tensor = multi_tensor_applier(self.multi_tensor_l2norm, + self.overflow_buf, + [fp16_grad], True) + norm_groups.append(norm) + if self.overflow_buf.item() != 0: + skip = True + + if skip: + self._update_scale(skip) + return + + # norm is in fact norm*cur_scale + self.optimizer.step(grads=fp16_grads, + output_params=self.fp16_groups, + scale=self.cur_scale, + grad_norms=norm_groups) + + self._update_scale(False) + return + + def backward(self, loss): + """ + :attr:`backward` performs the following steps: + 1. fp32_loss = loss.float() + 2. scaled_loss = fp32_loss*loss_scale + 3. scaled_loss.backward(), which accumulates scaled gradients into the ``.grad`` attributes of the model's fp16 leaves + """ + scaled_loss = (loss.float()) * self.cur_scale + scaled_loss.backward() + + def _update_scale(self, skip): + if self.dynamic_loss_scale: + if skip: + if self.verbose: + print("\nGrad overflow on iteration", self.cur_iter) + print("Using dynamic loss scale of", self.cur_scale) + self.cur_scale = max(self.cur_scale/self.scale_factor, 1) + self.last_overflow_iter = self.cur_iter + else: + if (self.cur_iter - self.last_overflow_iter) % self.scale_window == 0: + self.cur_scale *= self.scale_factor + else: + if skip: + print("\nGrad overflow on iteration", self.cur_iter) + print("Using static loss scale of", self.cur_scale) + self.cur_iter +=1 + return + + # Promote state so it can be retrieved or set via "fp16_optimizer_instance.state" + def _get_state(self): + return self.optimizer.state + + def _set_state(self, value): + self.optimizer.state = value + + state = property(_get_state, _set_state) + + # Promote param_groups so it can be retrieved or set via "fp16_optimizer_instance.param_groups" + # (for example, to adjust the learning rate) + def _get_param_groups(self): + return self.optimizer.param_groups + + def _set_param_groups(self, value): + self.optimizer.param_groups = value + + param_groups = property(_get_param_groups, _set_param_groups) + + def state_dict(self): + """ + Returns a dict containing the current state of this :class:`FP16_Optimizer` instance. + This dict contains attributes of :class:`FP16_Optimizer`, as well as the state_dict + of the contained Pytorch optimizer. + Example:: + checkpoint = {} + checkpoint['model'] = model.state_dict() + checkpoint['optimizer'] = optimizer.state_dict() + torch.save(checkpoint, "saved.pth") + """ + state_dict = {} + state_dict['dynamic_loss_scale'] = self.dynamic_loss_scale + state_dict['cur_scale'] = self.cur_scale + state_dict['cur_iter'] = self.cur_iter + if state_dict['dynamic_loss_scale']: + state_dict['last_overflow_iter'] = self.last_overflow_iter + state_dict['scale_factor'] = self.scale_factor + state_dict['scale_window'] = self.scale_window + state_dict['optimizer_state_dict'] = self.optimizer.state_dict() + state_dict['fp32_groups'] = self.fp32_groups + return state_dict + + def load_state_dict(self, state_dict): + """ + Loads a state_dict created by an earlier call to state_dict(). + If ``fp16_optimizer_instance`` was constructed from some ``init_optimizer``, + whose parameters in turn came from ``model``, it is expected that the user + will call ``model.load_state_dict()`` before + ``fp16_optimizer_instance.load_state_dict()`` is called. + Example:: + model = torch.nn.Linear(D_in, D_out).cuda().half() + optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + optimizer = FP16_Optimizer(optimizer, static_loss_scale = 128.0) + ... + checkpoint = torch.load("saved.pth") + model.load_state_dict(checkpoint['model']) + optimizer.load_state_dict(checkpoint['optimizer']) + """ + # I think it should actually be ok to reload the optimizer before the model. + self.dynamic_loss_scale = state_dict['dynamic_loss_scale'] + self.cur_scale = state_dict['cur_scale'] + self.cur_iter = state_dict['cur_iter'] + if state_dict['dynamic_loss_scale']: + self.last_overflow_iter = state_dict['last_overflow_iter'] + self.scale_factor = state_dict['scale_factor'] + self.scale_window = state_dict['scale_window'] + self.optimizer.load_state_dict(state_dict['optimizer_state_dict']) + # At this point, the optimizer's references to the model's fp32 parameters are up to date. + # The optimizer's hyperparameters and internal buffers are also up to date. + # However, the fp32 master copies of the model's fp16 params stored by the optimizer are still + # out of date. There are two options. + # 1: Refresh the master params from the model's fp16 params. + # This requires less storage but incurs precision loss. + # 2: Save and restore the fp32 master copies separately. + # We choose option 2. + # + # Pytorch Optimizer.load_state_dict casts saved buffers (e.g. momentum) to the type and device + # of their associated parameters, because it's possible those buffers might not exist yet in + # the current optimizer instance. In our case, as long as the current FP16_Optimizer has been + # constructed in the same way as the one whose state_dict we are loading, the same master params + # are guaranteed to exist, so we can just copy_() from the saved master params. + for current, saved in zip(self.fp32_groups, state_dict['fp32_groups']): + for _current, _saved in zip(current, saved): + _current.data.copy_(_saved.data) diff --git a/apex/apex/contrib/optimizers/fused_adam.py b/apex/apex/contrib/optimizers/fused_adam.py new file mode 100644 index 0000000000000000000000000000000000000000..a823e7be6f8bd2e2748ea43820a29d5191a9ac9b --- /dev/null +++ b/apex/apex/contrib/optimizers/fused_adam.py @@ -0,0 +1,206 @@ +import types +import torch +import importlib +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedAdam(torch.optim.Optimizer): + + """Implements Adam algorithm. Currently GPU-only. Requires Apex to be installed via + ``python setup.py install --cuda_ext --cpp_ext``. + + It has been proposed in `Adam: A Method for Stochastic Optimization`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + (default: False) NOT SUPPORTED in FusedAdam! + eps_inside_sqrt (boolean, optional): in the 'update parameters' step, + adds eps to the bias-corrected second moment estimate before + evaluating square root instead of adding it to the square root of + second moment estimate as in the original paper. (default: False) + use_mt (boolean, optional): use multi tensor apply for lower launch + latency. (default: False) + + .. _Adam - A Method for Stochastic Optimization: + https://arxiv.org/abs/1412.6980 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, + lr=1e-3, bias_correction = True, + betas=(0.9, 0.999), eps=1e-8, eps_inside_sqrt = False, + weight_decay=0., max_grad_norm=0., amsgrad=False, use_mt=False, + amp_scale_adjustment=1.0): + global fused_adam_cuda + fused_adam_cuda = importlib.import_module("fused_adam_cuda") + + self._use_multi_tensor = False + if use_mt: + if not multi_tensor_applier.available: + print("Warning: multi_tensor_applier is unavailable") + else: + self._use_multi_tensor = True + self._overflow_buf = torch.cuda.IntTensor([0]) + + self._amp_scale_adjustment = amp_scale_adjustment + + if amsgrad: + raise RuntimeError('FusedAdam does not support the AMSGrad variant.') + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + max_grad_norm=max_grad_norm) + super(FusedAdam, self).__init__(params, defaults) + self.eps_mode = 0 if eps_inside_sqrt else 1 + + def step(self, closure=None, grads=None, output_params=None, scale=1., grad_norms=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + grads (list of tensors, optional): weight gradient to use for the + optimizer update. If gradients have type torch.half, parameters + are expected to be in type torch.float. (default: None) + output params (list of tensors, optional): A reduced precision copy + of the updated weights written out in addition to the regular + updated weights. Have to be of same type as gradients. (default: None) + scale (float, optional): factor to divide gradient tensor values + by before applying to weights. (default: 1) + """ + loss = None + if closure is not None: + loss = closure() + + if hasattr(self, "_amp_stash"): + grads = self._amp_stash.grads + output_params = self._amp_stash.output_params + scale = self._amp_stash.scale*self._amp_scale_adjustment + grad_norms = self._amp_stash.grad_norms + + if grads is None: + grads_group = [None]*len(self.param_groups) + # backward compatibility + # assuming a list/generator of parameter means single group + elif isinstance(grads, types.GeneratorType): + grads_group = [grads] + elif type(grads[0])!=list: + grads_group = [grads] + else: + grads_group = grads + + if output_params is None: + output_params_group = [None]*len(self.param_groups) + elif isinstance(output_params, types.GeneratorType): + output_params_group = [output_params] + elif type(output_params[0])!=list: + output_params_group = [output_params] + else: + output_params_group = output_params + + if grad_norms is None: + grad_norms = [None]*len(self.param_groups) + + for group, grads_this_group, output_params_this_group, grad_norm in zip(self.param_groups, grads_group, output_params_group, grad_norms): + if grads_this_group is None: + grads_this_group = [None]*len(group['params']) + if output_params_this_group is None: + output_params_this_group = [None]*len(group['params']) + + # compute combined scale factor for this group + combined_scale = scale + if group['max_grad_norm'] > 0: + # norm is in fact norm*scale + clip = ((grad_norm / scale) + 1e-6) / group['max_grad_norm'] + if clip > 1: + combined_scale = clip * scale + + bias_correction = 1 if group['bias_correction'] else 0 + + if self._use_multi_tensor: + if output_params: + tensorlists = [[],[],[],[],[]] + else: + tensorlists = [[],[],[],[]] + tensordevice = None + + for p, grad, output_param in zip(group['params'], grads_this_group, output_params_this_group): + #note: p.grad should not ever be set for correct operation of mixed precision optimizer that sometimes sends None gradients + if p.grad is None and grad is None: + continue + if grad is None: + grad = p.grad.data + if grad.is_sparse: + raise RuntimeError('FusedAdam does not support sparse gradients, please consider SparseAdam instead') + + state = self.state[p] + + # State initialization + if len(state) == 0: + state['step'] = 0 + # Exponential moving average of gradient values + state['exp_avg'] = torch.zeros_like(p.data) + # Exponential moving average of squared gradient values + state['exp_avg_sq'] = torch.zeros_like(p.data) + + exp_avg, exp_avg_sq = state['exp_avg'], state['exp_avg_sq'] + beta1, beta2 = group['betas'] + + state['step'] += 1 + + out_p = torch.tensor([], dtype = torch.float) if output_param is None else output_param + if self._use_multi_tensor: + pl = [p.data, exp_avg, exp_avg_sq, grad] + if output_param is not None: + pl.append(out_p) + + for tl, t in zip(tensorlists, pl): + tl.append(t) + + if tensordevice is None: + tensordevice = p.device + elif tensordevice != p.device: + raise RuntimeError('FusedAdam does not support use_mt with tensors on multiple device') + + else: + with torch.cuda.device(p.device): + fused_adam_cuda.adam(p.data, + out_p, + exp_avg, + exp_avg_sq, + grad, + group['lr'], + beta1, + beta2, + group['eps'], + combined_scale, + state['step'], + self.eps_mode, + bias_correction, + group['weight_decay']) + + if self._use_multi_tensor: + with torch.cuda.device(tensordevice): + multi_tensor_applier( + fused_adam_cuda.adam_mt, + self._overflow_buf, + tensorlists, + group['lr'], + beta1, + beta2, + group['eps'], + combined_scale, + state['step'], + self.eps_mode, + bias_correction, + group['weight_decay']) + + return loss diff --git a/apex/apex/contrib/optimizers/fused_lamb.py b/apex/apex/contrib/optimizers/fused_lamb.py new file mode 100644 index 0000000000000000000000000000000000000000..170cce4922ab7b0c3ff10ff511bd17ec84fbd9a7 --- /dev/null +++ b/apex/apex/contrib/optimizers/fused_lamb.py @@ -0,0 +1,208 @@ +import torch +import importlib +import math +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedLAMB(torch.optim.Optimizer): + + """Implements LAMB algorithm. + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" --global-option="--deprecated_fused_lamb" ./``. + + This version of fused LAMB implements 2 fusions. + + * Fusion of the LAMB update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.contrib.optimizers.FusedLAMB`'s usage is identical to any ordinary Pytorch optimizer:: + + opt = apex.contrib.optimizers.FusedLAMB(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedLAMB` may be used with or without Amp. If you wish to use :class:`FusedLAMB` with Amp, + you may choose any ``opt_level``:: + + opt = apex.optimizers.FusedLAMB(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + + In general, ``opt_level="O1"`` is recommended. + + LAMB was proposed in `Large Batch Optimization for Deep Learning: Training BERT in 76 minutes`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its norm. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + NOT SUPPORTED now! (default: False) + adam_w_mode (boolean, optional): Apply L2 regularization or weight decay + True for decoupled weight decay(also known as AdamW) (default: True) + grad_averaging (bool, optional): whether apply (1-beta2) to grad when + calculating running averages of gradient. (default: True) + set_grad_none (bool, optional): whether set grad to None when zero_grad() + method is called. (default: True) + max_grad_norm (float, optional): value used to clip global grad norm + (default: 1.0) + + .. _Large Batch Optimization for Deep Learning - Training BERT in 76 minutes: + https://arxiv.org/abs/1904.00962 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, lr=1e-3, bias_correction=True, + betas=(0.9, 0.999), eps=1e-6, weight_decay=0.01, + amsgrad=False, adam_w_mode=True, + grad_averaging=True, set_grad_none=True, + max_grad_norm=1.0): + if amsgrad: + raise RuntimeError('FusedLAMB does not support the AMSGrad variant.') + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + grad_averaging=grad_averaging, + max_grad_norm=max_grad_norm) + super(FusedLAMB, self).__init__(params, defaults) + if multi_tensor_applier.available: + import amp_C + self.multi_tensor_l2norm=amp_C.multi_tensor_l2norm + self._dummy_overflow_buf = torch.cuda.IntTensor([0]) + fused_lamb_cuda = importlib.import_module("fused_lamb_cuda") + self.multi_tensor_lamb = fused_lamb_cuda.lamb + else: + raise RuntimeError('apex.contrib.optimizers.FusedLAMB requires cuda extensions') + + self.adam_w_mode = 1 if adam_w_mode else 0 + self.set_grad_none = set_grad_none + + def zero_grad(self): + if self.set_grad_none: + for group in self.param_groups: + for p in group['params']: + p.grad = None + else: + super(FusedLAMB, self).zero_grad() + + def step(self, closure=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + # create separate grad lists for fp32 and fp16 params + g_all_32, g_all_16 = [], [] + for group in self.param_groups: + for p in group['params']: + if p.grad is None: + continue + if p.dtype == torch.float32: + g_all_32.append(p.grad.data) + elif p.dytpe == torch.float16: + g_all_16.append(p.grad.data) + else: + raise RuntimeError('FusedLAMB only support fp16 and fp32.') + + g_norm_32, g_norm_16 = 0.0, 0.0 + # compute grad norm for two lists + if len(g_all_32) > 0: + g_norm_32 = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [g_all_32], False)[0].item() + if len(g_all_16) > 0: + g_norm_16 = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [g_all_16], False)[0].item() + + # blend two grad norms to get global grad norm + global_grad_norm = math.sqrt(g_norm_32 * g_norm_32 + g_norm_16 * g_norm_16) + max_grad_norm = self.defaults['max_grad_norm'] + + for group in self.param_groups: + bias_correction = 1 if group['bias_correction'] else 0 + beta1, beta2 = group['betas'] + grad_averaging = 1 if group['grad_averaging'] else 0 + + # assume same step across group now to simplify things + # per parameter step can be easily support by making it tensor, or pass list into kernel + if 'step' in group: + group['step'] += 1 + else: + group['step'] = 1 + + # create lists for multi-tensor apply + g_16, p_16, m_16, v_16 = [], [], [], [] + g_32, p_32, m_32, v_32 = [], [], [], [] + + for p in group['params']: + if p.grad is None: + continue + if p.grad.data.is_sparse: + raise RuntimeError('FusedLAMB does not support sparse gradients, please consider SparseAdam instead') + + state = self.state[p] + # State initialization + if len(state) == 0: + # Exponential moving average of gradient values + state['exp_avg'] = torch.zeros_like(p.data) + # Exponential moving average of gradient values + state['exp_avg_sq'] = torch.zeros_like(p.data) + + if p.dtype == torch.float16: + g_16.append(p.grad.data) + p_16.append(p.data) + m_16.append(state['exp_avg']) + v_16.append(state['exp_avg_sq']) + elif p.dtype == torch.float32: + g_32.append(p.grad.data) + p_32.append(p.data) + m_32.append(state['exp_avg']) + v_32.append(state['exp_avg_sq']) + else: + raise RuntimeError('FusedLAMB only support fp16 and fp32.') + + if(len(g_16) > 0): + multi_tensor_applier(self.multi_tensor_lamb, + self._dummy_overflow_buf, + [g_16, p_16, m_16, v_16], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + bias_correction, + group['weight_decay'], + grad_averaging, + self.adam_w_mode, + global_grad_norm, + max_grad_norm) + if(len(g_32) > 0): + multi_tensor_applier(self.multi_tensor_lamb, + self._dummy_overflow_buf, + [g_32, p_32, m_32, v_32], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + bias_correction, + group['weight_decay'], + grad_averaging, + self.adam_w_mode, + global_grad_norm, + max_grad_norm) + + return loss diff --git a/apex/apex/contrib/optimizers/fused_sgd.py b/apex/apex/contrib/optimizers/fused_sgd.py new file mode 100644 index 0000000000000000000000000000000000000000..83587c6a636e86f45d1a0be0d2636029a2fd35c8 --- /dev/null +++ b/apex/apex/contrib/optimizers/fused_sgd.py @@ -0,0 +1,211 @@ +import types +import torch +from torch.optim.optimizer import Optimizer, required + +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedSGD(Optimizer): + r"""Implements stochastic gradient descent (optionally with momentum). + + This version of fused SGD implements 2 fusions. + * Fusion of the SGD update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.contrib.optimizers.FusedSGD` should be used without AMP. + + :class:`apex.contrib.optimizers.FusedSGD` only works in the case where all parameters require grad. + + Nesterov momentum is based on the formula from + `On the importance of initialization and momentum in deep learning`__. + + Args: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups + lr (float): learning rate + momentum (float, optional): momentum factor (default: 0) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + dampening (float, optional): dampening for momentum (default: 0) + nesterov (bool, optional): enables Nesterov momentum (default: False) + + Example: + model = ... + model.half() + optimizer = apex.contrib.optimizers.FusedSGD(model.parameters()) + # wrap with FP16_Optimizer + optimizer = FP16_Optimizer(optimizer, dynamic_loss_scale=True) + optimizer.zero_grad() + ... + optimizer.backward(loss) + optmizer.step() + + __ http://www.cs.toronto.edu/%7Ehinton/absps/momentum.pdf + + .. note:: + The implementation of SGD with Momentum/Nesterov subtly differs from + Sutskever et. al. and implementations in some other frameworks. + + Considering the specific case of Momentum, the update can be written as + + .. math:: + v = \rho * v + g \\ + p = p - lr * v + + where p, g, v and :math:`\rho` denote the parameters, gradient, + velocity, and momentum respectively. + + This is in contrast to Sutskever et. al. and + other frameworks which employ an update of the form + + .. math:: + v = \rho * v + lr * g \\ + p = p - v + + The Nesterov version is analogously modified. + """ + + def __init__(self, params, lr=required, momentum=0, dampening=0, + weight_decay=0, nesterov=False, + wd_after_momentum=False, + materialize_master_grads=True): + if lr is not required and lr < 0.0: + raise ValueError("Invalid learning rate: {}".format(lr)) + if momentum < 0.0: + raise ValueError("Invalid momentum value: {}".format(momentum)) + if weight_decay < 0.0: + raise ValueError("Invalid weight_decay value: {}".format(weight_decay)) + + defaults = dict(lr=lr, momentum=momentum, dampening=dampening, + weight_decay=weight_decay, nesterov=nesterov) + if nesterov and (momentum <= 0 or dampening != 0): + raise ValueError("Nesterov momentum requires a momentum and zero dampening") + super(FusedSGD, self).__init__(params, defaults) + + self.wd_after_momentum = wd_after_momentum + + if multi_tensor_applier.available: + import amp_C + # Skip buffer + self._dummy_overflow_buf = torch.cuda.IntTensor([0]) + self.multi_tensor_sgd = amp_C.multi_tensor_sgd + else: + raise RuntimeError('apex.contrib.optimizers.FusedSGD requires cuda extensions') + + def __setstate__(self, state): + super(FusedSGD, self).__setstate__(state) + for group in self.param_groups: + group.setdefault('nesterov', False) + + def get_momentums(self, params): + momentums = [] + first_run = True + for p in params: + param_state = self.state[p] + # torch.optim.SGD initializes momentum in the main loop, we have + # to do it here, and track whether or not we've done so, so that + # momentum application can be skipped in the main kernel. + if 'momentum_buffer' not in param_state: + first_run = True + buf = param_state['momentum_buffer'] = torch.zeros_like(p.data) + momentums.append(buf) + else: + first_run = False + momentums.append(param_state['momentum_buffer']) + return momentums, first_run + + def step(self, closure=None, grads=None, output_params=None, scale=1., grad_norms=None): + """Performs a single optimization step. + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + grads (list of tensors, optional): weight gradient to use for the + optimizer update. If gradients have type torch.half, parameters + are expected to be in type torch.float. (default: None) + output_params (list of tensors, optional): A reduced precision copy + of the updated weights written out in addition to the regular + updated weights. Have to be of same type as gradients. (default: None) + scale (float, optional): factor to divide gradient tensor values + by before applying to weights. (default: 1) + """ + if hasattr(self, "_amp_stash"): + raise RuntimeError('apex.contrib.optimizers.FusedSGD should not be used with AMP.') + + loss = None + if closure is not None: + loss = closure() + + if grads is None: + raise RuntimeError('apex.contrib.optimizers.FusedSGD must be wrapped \ + with apex.contrib.optimizers.FP16_Optimizer \ + which provides grads.') + # backward compatibility + # assuming a list/generator of parameter means single group + elif isinstance(grads, types.GeneratorType): + grads_group = [grads] + elif type(grads[0])!=list: + grads_group = [grads] + else: + grads_group = grads + + if output_params is None: + raise RuntimeError('apex.contrib.optimizers.FusedSGD must be wrapped \ + with apex.contrib.optimizers.FP16_Optimizer \ + which provides output_params.') + elif isinstance(output_params, types.GeneratorType): + output_params_group = [output_params] + elif type(output_params[0])!=list: + output_params_group = [output_params] + else: + output_params_group = output_params + + for group, grads_this_group, output_params_this_group in zip(self.param_groups, + grads_group, + output_params_group): + if grads_this_group is None or output_params_this_group is None: + raise RuntimeError('apex.contrib.optimizers.FusedSGD only works \ + when all parameters require grad.') + + weight_decay = group['weight_decay'] + momentum = group['momentum'] + dampening = group['dampening'] + nesterov = group['nesterov'] + lr = group['lr'] + + first_runs = [True, True] + + # output_params_this_group: original weights (either fp16 or fp32) + # group['params']: master weights (fp32) + + # grad_type, param_to_update_type, momentum_type, requires_fp16_model_copy + # fp32, fp32, fp32, No + fp32_grads = [g for (p, g) in zip(output_params_this_group, grads_this_group) if p.dtype == torch.float32] + fp32_params = [p2 for (p1, p2) in zip(output_params_this_group, group['params']) if p1.dtype == torch.float32] + fp32_momentums, first_runs[1] = self.get_momentums(fp32_params) + fp32_set = [fp32_grads, fp32_params, fp32_momentums] + + # fp16, fp32, fp32, Yes + fp16_grads = [g for (p, g) in zip(output_params_this_group, grads_this_group) if p.dtype == torch.float16] + fp32_from_fp16_params = [p2 for (p1, p2) in zip(output_params_this_group, group['params']) if p1.dtype == torch.float16] + fp32_from_fp16_momentums, first_runs[0] = self.get_momentums(fp32_from_fp16_params) + fp16_params = [p1 for (p1, p2) in zip(output_params_this_group, group['params']) if p1.dtype == torch.float16] + fp16_set = [fp16_grads, fp32_from_fp16_params, fp32_from_fp16_momentums, fp16_params] + + launch_sets = [fp16_set, fp32_set] + + for launch_set, first_run in zip(launch_sets, first_runs): + assert len(launch_set[0]) == len(launch_set[1]) + assert len(launch_set[0]) == len(launch_set[2]) + if len(launch_set[0]) > 0: + multi_tensor_applier( + self.multi_tensor_sgd, + self._dummy_overflow_buf, + launch_set, + weight_decay, + momentum, + dampening, + lr, + nesterov, + first_run, + self.wd_after_momentum, + 1.0/scale) + + return loss diff --git a/apex/apex/contrib/sparsity/README.md b/apex/apex/contrib/sparsity/README.md new file mode 100644 index 0000000000000000000000000000000000000000..2431dc68ef8d750338225698636f5c54c0226d24 --- /dev/null +++ b/apex/apex/contrib/sparsity/README.md @@ -0,0 +1,78 @@ +# Introduction to ASP + +This serves as a quick-start for ASP (Automatic SParsity), a tool that enables sparse training and inference for PyTorch models by adding 2 lines of Python. + +## Importing ASP +``` +from apex.contrib.sparsity import ASP +``` + +## Initializing ASP + +Apart from the import statement, it is sufficient to add just the following line of code before the training phase to augment the model and the optimizer for sparse training/inference: +``` +ASP.prune_trained_model(model, optimizer) +``` + +In the context of a typical PyTorch training loop, it might look like this: +``` +ASP.prune_trained_model(model, optimizer) + +x, y = DataLoader(args) +for epoch in range(epochs): + y_pred = model(x) + loss = loss_function(y_pred, y) + loss.backward() + optimizer.step() + +torch.save(...) +``` +The `prune_trained_model` step calculates the sparse mask and applies it to the weights. This is done once, i.e., sparse locations in the weights matrix remain fixed after this step. + +## Generate a Sparse Network + +The following approach serves as a guiding example on how to generate a pruned model that can use Sparse Tensor Cores in the NVIDIA Ampere Architecture. This approach generates a model for deployment, i.e. inference mode. + +``` +(1) Given a fully trained (dense) network, prune parameter values in a 2:4 sparse pattern. +(2) Fine-tune the pruned model with optimization method and hyper-parameters (learning-rate, schedule, number of epochs, etc.) exactly as those used to obtain the trained model. +(3) (If required) Quantize the model. +``` + +In code, below is a sketch on how to use ASP for this approach (steps 1 and 2 above). + +``` + +model = define_model(..., pretrained=True) # define model architecture and load parameter tensors with trained values (by reading a trained checkpoint) +criterion = ... # compare ground truth with model predition; use the same criterion as used to generate the dense trained model +optimizer = ... # optimize model parameters; use the same optimizer as used to generate the dense trained model +lr_scheduler = ... # learning rate scheduler; use the same schedule as used to generate the dense trained model + +from apex.contrib.sparsity import ASP +ASP.prune_trained_model(model, optimizer) #pruned a trained model + +x, y = DataLoader(args) +for epoch in range(epochs): # train the pruned model for the same number of epochs as used to generate the dense trained model + y_pred = model(x) + loss = criterion(y_pred, y) + lr_scheduler.step() + loss.backward() + optimizer.step() + +torch.save(...) # saves the pruned checkpoint with sparsity masks +``` + +## Non-Standard Usage + +If your goal is to easily perpare a network for accelerated inference, please follow the recipe above. However, ASP can also be used to perform experiments in advanced techniques like training with sparsity from initialization. For example, in order to recompute the sparse mask in between training steps, use the following method: + +``` +ASP.compute_sparse_masks() +``` + +A more thorough example can be found in `./test/toy_problem.py`. + + + + + diff --git a/apex/apex/contrib/sparsity/__init__.py b/apex/apex/contrib/sparsity/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..661fd4ae94b1c5039093f60748415977e73ac1ac --- /dev/null +++ b/apex/apex/contrib/sparsity/__init__.py @@ -0,0 +1,2 @@ +from .sparse_masklib import create_mask +from .asp import ASP diff --git a/apex/apex/contrib/sparsity/asp.py b/apex/apex/contrib/sparsity/asp.py new file mode 100644 index 0000000000000000000000000000000000000000..17b1f34853e38fc79559f5da0f64afe848790c01 --- /dev/null +++ b/apex/apex/contrib/sparsity/asp.py @@ -0,0 +1,217 @@ +import types +import torch +from .sparse_masklib import create_mask + +torchvision_imported=True +try: + import torchvision +except ImportError: + print("[ASP][Warning] torchvision cannot be imported.") + torchvision_imported=False + +def eligible_modules(model, whitelist_layer_types, allowed_layer_names, disallowed_layer_names): + eligible_modules_list = [] + for name, mod in model.named_modules(): + if isinstance(mod, whitelist_layer_types) and name not in disallowed_layer_names: + if allowed_layer_names is not None and name not in allowed_layer_names: + continue + eligible_modules_list.append((name, mod)) + return eligible_modules_list + +class ASP: + __model = None + __verbosity = 0 + __optimizer = None + __sparse_parameters = [] + __calculate_mask = None + + @classmethod + def init_model_for_pruning(cls, model, mask_calculator="m4n2_1d", + verbosity=3, + whitelist=[torch.nn.Linear, torch.nn.Conv1d, torch.nn.Conv2d, torch.nn.Conv3d], + allowed_layer_names=None, disallowed_layer_names=[], + allow_recompute_mask=False, custom_layer_dict={}): + """Call this method to modify your model to take advantage of sparse matrix multiplication. + Note that this call alone only augments the model with additional buffers needed for sparse MMA, + it does not enable use of sparse MMA. + + If you are starting with a fresh model: + + model = ... + ASP.init_model_for_pruning(model, mask_calculator, ...) + if (training) ASP.init_optimizer_for_pruning(optimizer) + ASP.compute_sparse_masks() // sparsity is off by default, call when youy want to enable it. + + If you are starting from a checkpoint: + + model = ... + ASP.init_model_for_pruning(model, mask_calculator, ...) + torch.load(...) + if (training) ASP.init_optimizer_for_pruning(optimizer) + + Arguments: + model The model + mask_calculator Either callable that computes mask given a tensor OR pattern string for sparse mask lib. + verbosity Integer controling verbosity level. + 0 -> Only errors. + 1 -> Errors and warnings. + 2 -> Errors, warnings and info. + 3 -> Errors, warnings, info and debug. + whitelist Module types approved for sparsity. + allowed_layer_names If not None, only layer names that appear in this list are considered for sparsity. + disallowed_layer_names If not [], only layer names that do not appear in this list are considered for sparsity. + allow_recompute_mask If True, stores pruned values so that dense weights can be restored. + Pruned weights are stored in CPU memory, hence this option does not increase GPU memory usage. + custom_layer_dict Dictionary of additional layer paremeters to sparsify. e.g. {CustomLinear: ['weight']} + + [Future] Support for allow_recompute_mask can be removed, it is not part of sparse inference recipe -- AKM. + """ + assert (cls.__model is None), "ASP has been initialized already." + cls.__model = model + cls.__verbosity = verbosity + + if isinstance(mask_calculator, str): + def create_mask_from_pattern(param): + return create_mask(param, mask_calculator).bool() + cls.__calculate_mask = create_mask_from_pattern + else: + cls.__calculate_mask = mask_calculator #user defined function + + # function to extract variables that will be sparsified. + # idea is that you will add one of these functions for each module type that can be sparsified. + if torchvision_imported: + print("[ASP] torchvision is imported, can work with the MaskRCNN/KeypointRCNN from torchvision.") + sparse_parameter_list = {torch.nn.Linear: ['weight'], torch.nn.Conv1d: ['weight'], torch.nn.Conv2d: ['weight'], torch.nn.Conv3d: ['weight'], torchvision.ops.misc.Conv2d: ['weight']} + else: + sparse_parameter_list = {torch.nn.Linear: ['weight'], torch.nn.Conv1d: ['weight'], torch.nn.Conv2d: ['weight'], torch.nn.Conv3d: ['weight']} + if custom_layer_dict: # Update default list to include user supplied custom (layer type : parameter tensor), make sure this tensor type is something ASP knows how to prune + sparse_parameter_list.update(custom_layer_dict) + whitelist += list(custom_layer_dict.keys()) + + for module_type in whitelist: + assert (module_type in sparse_parameter_list), "Module %s :: Don't know how to sparsify module." % module.dtype() + + # find all sparse modules, extract sparse parameters and decorate + def add_sparse_attributes(module_name, module): + sparse_parameters = sparse_parameter_list[type(module)] + for p_name, p in module.named_parameters(): + if p_name in sparse_parameters and p.requires_grad: + # check for NVIDIA's TC compatibility: we check along the horizontal direction + if p.dtype == torch.float32 and ((p.size()[0] % 8) != 0 or (p.size()[1] % 16) != 0): #User defines FP32 and APEX internally uses FP16 math + print("[ASP] Auto skipping pruning %s::%s of size=%s and type=%s for sparsity" % (module_name, p_name, str(p.size()), str(p.dtype))) + continue + if p.dtype == torch.float16 and ((p.size()[0] % 8) != 0 or (p.size()[1] % 16) != 0): #For Conv2d dim= K x CRS; we prune along C + print("[ASP] Auto skipping pruning %s::%s of size=%s and type=%s for sparsity" % (module_name, p_name, str(p.size()), str(p.dtype))) + continue + + if cls.__verbosity >= 3: + print("[ASP] Sparsifying %s::%s of size=%s and type=%s for sparsity" % (module_name, p_name, str(p.size()), str(p.dtype))) + + mask = torch.ones_like(p).bool() + buffname = p_name.split(".")[-1] # buffer names cannot contain "." + module.register_buffer('__%s_mma_mask' % buffname, mask) + if allow_recompute_mask: + pruned = torch.zeros_like(p).cpu() + module.register_buffer('__%s_mma_pruned_p' % buffname, pruned) + else: + pruned = None + cls.__sparse_parameters.append((module_name, module, p_name, p, mask, pruned)) + else: + if cls.__verbosity >= 3: + print("[ASP] Not sparsifying %s::%s of size=%s and type=%s" % (module_name, p_name, str(p.size()), str(p.dtype))) + + for name, sparse_module in eligible_modules(model, tuple(whitelist), allowed_layer_names, disallowed_layer_names): + add_sparse_attributes(name, sparse_module) + + @classmethod + def init_optimizer_for_pruning(cls, optimizer): + """Call this method to monkey patch optimizer step function so that masks can be applied to + gradients and weights during training. + You must call init_model_for_pruning(...) before calling init_optimizer_for_pruning(...) + """ + assert (cls.__optimizer is None), "ASP has initialized optimizer already." + assert (cls.__calculate_mask is not None), "Called ASP.init_optimizer_for_pruning before ASP.init_model_for_pruning." + + # store pointer to original optimizer step method + cls.__optimizer = optimizer + cls.__optimizer.__step = optimizer.step + + def __step(opt_self, *args, **kwargs): + # prune gradients before step method + with torch.no_grad(): + for module_name, module, p_name, p, mask, pruned in cls.__sparse_parameters: + if p.grad is not None: #thx pjudd + p.grad.mul_(mask) + # call original optimizer step method + rval = opt_self.__step(*args, **kwargs) + # prune parameters after step method + with torch.no_grad(): + for module_name, module, p_name, p, mask, pruned in cls.__sparse_parameters: + p.mul_(mask) + return rval + cls.__optimizer.step = types.MethodType(__step, cls.__optimizer) + + @classmethod + def compute_sparse_masks(cls): + """Call this method to enable sparsity. + If init(...) was called with allow_recompute_mask=False AND sparsity is disabled, pruned field can be None. + """ + with torch.no_grad(): + for module_name, module, p_name, p, mask, pruned in cls.__sparse_parameters: + if mask.sum() < mask.numel(): # when recalculating masks + # restore dense parameter if allow_recompute_mask is enabled + assert (pruned is not None), "Unable to restore dense parameter because allow_recompute_mask == False" + p.add_(pruned.cuda()) + + mask.set_(cls.__calculate_mask(p)) + + if pruned is not None: # stow away pruned weights to cpu + pruned.set_((p * (~mask)).cpu()) + + p.mul_(mask) # in-place multiplication, so pruned weights are 0-values, hence checkpoint will have 0s for pruned weights + if cls.__verbosity >= 2: + print("[ASP] Enabled %.2f%% sparsity for %s::%s of size=%s and type=%s" % (100.0*mask.sum()/mask.numel(), module_name, p_name, str(p.size()), str(p.dtype))) + + @classmethod + def restore_pruned_weights(cls): + """Call this method to disable sparsity and restore all weights. + This will only work if init(...) was called with allow_recompute=True. + """ + with torch.no_grad(): + for module_name, module, p_name, p, mask, pruned in cls.__sparse_parameters: + if mask.sum() < mask.numel(): + assert (pruned is not None), "Unable to restore dense parameter because allow_recompute_mask == False" + p.add_(pruned.cuda()) + mask.fill_(1) + pruned.zero_() + if cls.__verbosity >= 2: + print("[ASP] Disabled sparsity for %s::%s (dense weights restored)" % (module_name, p_name)) + + @classmethod + def is_sparsity_enabled(cls): + """Call this method to determine if sparsity is enabled in the model. + The typical use case is right after checkpoint has been loaded. + """ + total,sp100,sp50 = 0,0,0 + for module_name, module, p_name, p, mask, pruned in cls.__sparse_parameters: + total += 1 + mask_sum = mask.sum() + mask_numel = mask.numel() + if mask_sum == mask_numel: + sp100 += 1 + elif mask_sum*2 == mask_numel: + sp50 += 1 + + assert (total == sp100 or total == sp50), "Inconsistent model sparsity" + if total == sp100: + return False + elif total == sp50: + return True + + @classmethod + def prune_trained_model(cls, model, optimizer): + # add mask buffers to model (init_model_for_pruning), augment optimizer (init_optimizer_for_pruning) and compute masks (compute_sparse_masks) + cls.init_model_for_pruning(model, mask_calculator="m4n2_1d", verbosity=2, whitelist=[torch.nn.Linear, torch.nn.Conv2d], allow_recompute_mask=False) + cls.init_optimizer_for_pruning(optimizer) + cls.compute_sparse_masks() + diff --git a/apex/apex/contrib/sparsity/sparse_masklib.py b/apex/apex/contrib/sparsity/sparse_masklib.py new file mode 100644 index 0000000000000000000000000000000000000000..ed42d0456d79a2ff672aafabcb191e1bc3d0c73d --- /dev/null +++ b/apex/apex/contrib/sparsity/sparse_masklib.py @@ -0,0 +1,184 @@ +import sys +import torch +import numpy as np +import collections +from itertools import permutations + + +""" compute density (helper fn to compute % NNZs in a tensor) """ +def fill(x): + return float(x.nonzero().size(0))/torch.numel(x) + +""" reshape matrix into m-dimensional vectors: (h,w) -> (hw/m, m) """ +def reshape_1d(matrix, m): + # If not a nice multiple of m, fill with zeroes. + if matrix.shape[1] % m > 0: + mat = torch.cuda.FloatTensor(matrix.shape[0], matrix.shape[1] + (m-matrix.shape[1]%m)).fill_(0) + mat[:, :matrix.shape[1]] = matrix + shape = mat.shape + return mat.view(-1,m),shape + else: + return matrix.view(-1,m), matrix.shape + +""" return all possible m:n patterns in a 1d vector """ +valid_m4n2_1d_patterns = None +def compute_valid_1d_patterns(m,n): + # Early exit if patterns was already created. + global valid_m4n2_1d_patterns + + if m==4 and n==2 and valid_m4n2_1d_patterns is not None: return valid_m4n2_1d_patterns + patterns = torch.zeros(m) + patterns[:n] = 1 + valid_patterns = torch.Tensor(list(set(permutations(patterns.tolist())))) + if m == 4 and n == 2: valid_m4n2_1d_patterns = valid_patterns + return valid_patterns + +""" m:n 1d structured best """ +def mn_1d_best(matrix, m, n): + # Find all possible patterns. + patterns = compute_valid_1d_patterns(m,n).cuda() + + # Find the best m:n pattern (sum of non-masked weights). + mask = torch.cuda.IntTensor(matrix.shape).fill_(1).view(-1,m) + mat,shape = reshape_1d(matrix,m) + pmax = torch.argmax(torch.matmul(mat.abs(),patterns.t()), dim=1) + mask[:] = patterns[pmax[:]] + mask = mask.view(matrix.shape) + return mask + +def m4n2_1d(mat, density): + return mn_1d_best(mat, 4, 2) + +""" + Below 2d-masking related code is targeted more for training (from scratch). + 2d-pruning of a weight tensor is done to accelerate DGRAD step during backprop + phase of training algorithm. Acceleration comes from using SpMMA instructions in + Tensor Cores of NVIDIA Ampere GPU Architecture + (note: this code does not do the acceleration, GPU kernels are required for this). + 1d pruning of weight tensor helps speed up FPROP step by pruning in 2:4 pattern + along the horizontal (logical) direction. + During DGRAD step, weight tensor is transposed. 2d pruning functions below, mask + weight tensor such that their transposed versions are also 2:4 sparse along the + horizontal (logical) direction. Thus, with 2d pruning, weight tensors are + 2:4 sparse along row and column directions. + """ + +""" m:n 2d structured pruning: greedy method to select mask """ +def mn_2d_greedy(matrix, m, n): + # Convert to numpy + mat = matrix.cpu().detach().numpy() + mask = np.ones(mat.shape, dtype=int) + + rowCount = int(mat.shape[0]/m) * m + colCount = int(mat.shape[1]/m) * m + for rowStartIdx in range(0, rowCount, m): + rowEndIdx = rowStartIdx + m + for colStartIdx in range(0, colCount, m): + colEndIdx = colStartIdx + m + matrixSub = np.absolute(np.squeeze(mat[rowStartIdx:rowEndIdx, colStartIdx:colEndIdx])) + maskSub = np.squeeze(mask[rowStartIdx:rowEndIdx, colStartIdx:colEndIdx]) + maskSub.fill(0.0) + matrixVecView = matrixSub.reshape(-1) + maskVecView = maskSub.reshape(-1) + linearIdx = np.argsort(matrixVecView) + matrixIdx = [(int(x/m), x % m) for x in linearIdx] + rowCounter = collections.Counter() + colCounter = collections.Counter() + for currIdx in range(len(linearIdx) - 1, -1, -1): + currMatrixEntry = matrixIdx[currIdx] + if (rowCounter[currMatrixEntry[0]] == n) or (colCounter[currMatrixEntry[1]] == n): + continue + #end if + maskSub[currMatrixEntry[0], currMatrixEntry[1]] = 1.0 + rowCounter[currMatrixEntry[0]] += 1 + colCounter[currMatrixEntry[1]] += 1 + + return torch.tensor(mask.cuda()) + +def m4n2_2d_greedy(mat, density): + return mn_2d_greedy(mat, 4, 2) + +""" return all possible m:n patterns in a mxn block. """ +valid_m4n2_2d_patterns = None +def compute_valid_2d_patterns(m,n): + # Early exit if patterns was already created. + global valid_m4n2_2d_patterns + if valid_m4n2_2d_patterns is not None: return valid_m4n2_2d_patterns + + patterns = torch.zeros(m) + patterns[:n] = 1 + patterns = list(set(permutations(patterns.tolist()))) + patterns = patterns + patterns + patterns = torch.Tensor(list(set(permutations(patterns,m)))) + + valid = ((patterns.sum(dim=1) <= n).sum(dim=1) == m).nonzero().view(-1) + valid_patterns = torch.Tensor(valid.shape[0],m,m) + valid_patterns[:] = patterns[valid[:]] + + if m == 4 and n == 2: valid_m4n2_2d_patterns = valid_patterns + return valid_patterns + +""" m:n 2d structured pruning: exhaustive method to select best mask """ +def mn_2d_best(matrix, m, n): + # Find all possible patterns. + patterns = compute_valid_2d_patterns(m,n).cuda() + + # Find the best m:n pattern (sum of non-masked weights). + mask = torch.cuda.IntTensor(matrix.shape).fill_(1) + mat = reshape_2d(matrix,m,m).abs() + pmax = torch.argmax(torch.matmul(mat,patterns.view(patterns.shape[0],m*m).t()), dim=2) + + # Copy best m:n patterns into mask. + mat = mat.view(mat.shape[0]*mat.shape[1],-1) + pmax = pmax.view(pmax.shape[0]*pmax.shape[1]).unsqueeze(1).expand(-1,mat.shape[1]) + patterns = patterns.view(patterns.shape[0],patterns.shape[1]*patterns.shape[2]) + mat = torch.gather(patterns,0,pmax) + mat = reshape_2d_inv(mat.view(matrix.shape[0]//m,matrix.shape[1]//m,m,m)) + mask.copy_(mat.type(mask.type())) + return mask + +def m4n2_2d_best(mat, density): + return mn_2d_best(mat, 4, 2) + + +""" returns a sparse mask """ +def create_mask(tensor, pattern="m4n2_1d", density=0.5): + # Reshape tensor and mask. + shape = tensor.shape + ttype = tensor.type() + t = tensor.float().contiguous() + + # 1d-tensor + if len(shape) == 1: + t = t.view(1, shape[0]) + func = getattr(sys.modules[__name__], pattern, None) + mask = func(t, density) + return mask.view(shape).type(ttype) + # 2d-tensor (in, out) + elif len(shape) == 2: + t = t.view(shape[0], shape[1]) + func = getattr(sys.modules[__name__], pattern, None) + mask = func(t, density) + return mask.view(shape).type(ttype) + # 3d-tensor (batch, in, out) + elif len(shape) == 3: + t = t.view(shape[0]*shape[1], shape[2]) + func = getattr(sys.modules[__name__], pattern, None) + mask = func(t, density) + return mask.view(shape).type(ttype) + # 4d-tensor (in, out, h, w) + elif len(shape) == 4: + """ + # transformers (bmm) + t = t.view(shape[0]*shape[1]*shape[2], shape[3]) + func = getattr(sys.modules[__name__], pattern, None) + mask = func(t, density) + return mask.view(shape).type(ttype) + """ + # convs + t = t.permute(2,3,0,1).contiguous().view(shape[2]*shape[3]*shape[0], shape[1]) + func = getattr(sys.modules[__name__], pattern, None) + mask = func(t, density) + mask = mask.view(shape[2], shape[3], shape[0], shape[1]).permute(2,3,0,1).contiguous() + return mask.view(shape).type(ttype) + diff --git a/apex/apex/contrib/sparsity/test/checkpointing_test_part1.py b/apex/apex/contrib/sparsity/test/checkpointing_test_part1.py new file mode 100644 index 0000000000000000000000000000000000000000..67350fea2e8ad7d9c79188c76be861f6f005422f --- /dev/null +++ b/apex/apex/contrib/sparsity/test/checkpointing_test_part1.py @@ -0,0 +1,94 @@ +from collections import OrderedDict + +import torch +from apex.optimizers import FusedAdam +from apex.contrib.sparsity import ASP + +def build_model(args): + od = OrderedDict() + for i in range(args.num_layers): + if i == 0: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.input_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + elif i == args.num_layers-1: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.output_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.output_features]) + else: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + return torch.nn.Sequential(od) + +def train_step(args, model, optimizer, input_batch, target_batch, step): + predicted_target = model(input_batch) + loss = ((predicted_target-target_batch)**2).sum() + loss.backward() + optimizer.step() + optimizer.zero_grad() + step = step + 1 + #print("Step %d :: loss=%e" % (step, loss.item())) + return step + +def train_loop(args, model, optimizer, step, num_steps): + for i in range(num_steps): + input_batch = torch.randn([args.batch_size, args.input_features]).cuda() + target_batch = torch.randn([args.batch_size, args.output_features]).cuda() + step = train_step(args, model, optimizer, input_batch, target_batch, step) + return step + +def main(args): + # + # PART1 + # + + torch.manual_seed(args.seed) + + model = build_model(args).cuda() + one_ll = next(model.children()).weight + optimizer = FusedAdam(model.parameters()) + ASP.init_model_for_pruning(model, args.pattern, verbosity=args.verbosity, whitelist=args.whitelist, allow_recompute_mask=args.allow_recompute_mask) + ASP.init_optimizer_for_pruning(optimizer) + + step = 0 + + # train for a few steps with dense weights + print("DENSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_dense_steps) + + # simulate sparsity by inserting zeros into existing dense weights + ASP.enable_sparsity() + + # train for a few steps with sparse weights + print("SPARSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_sparse_steps) + + torch.save({ + 'step': step, + 'verbosity': args.verbosity, + 'seed2': args.seed2, + 'pattern': args.pattern, + 'whitelist': args.whitelist, + 'allow_recompute_mask': args.allow_recompute_mask, + 'model_state_dict': model.state_dict(), + 'optimizer_state_dict': optimizer.state_dict(), + }, args.checkpoint_path) + +if __name__ == '__main__': + class Args: + verbosity=3 + seed = 4873 + seed2 = 99875 + pattern = "m4n2_2d_best" + whitelist = [torch.nn.Linear] + allow_recompute_mask = True + batch_size = 32 + input_features = 8 + output_features = 8 + hidden_features = 32 + num_layers = 4 + num_dense_steps = 2000 + num_sparse_steps = 3000 + num_sparse_steps_2 = 1000 + checkpoint_path = "part1.chkp" + args = Args() + + main(args) diff --git a/apex/apex/contrib/sparsity/test/checkpointing_test_part2.py b/apex/apex/contrib/sparsity/test/checkpointing_test_part2.py new file mode 100644 index 0000000000000000000000000000000000000000..2ac24526f0999672c80fedf27162d3a9da5d7fc4 --- /dev/null +++ b/apex/apex/contrib/sparsity/test/checkpointing_test_part2.py @@ -0,0 +1,79 @@ +from collections import OrderedDict + +import torch +from apex.optimizers import FusedAdam +from apex.contrib.sparsity import ASP + +def build_model(args): + od = OrderedDict() + for i in range(args.num_layers): + if i == 0: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.input_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + elif i == args.num_layers-1: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.output_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.output_features]) + else: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + return torch.nn.Sequential(od) + +def train_step(args, model, optimizer, input_batch, target_batch, step): + predicted_target = model(input_batch) + loss = ((predicted_target-target_batch)**2).sum() + loss.backward() + optimizer.step() + optimizer.zero_grad() + step = step + 1 + #print("Step %d :: loss=%e" % (step, loss.item())) + return step + +def train_loop(args, model, optimizer, step, num_steps): + for i in range(num_steps): + input_batch = torch.randn([args.batch_size, args.input_features]).cuda() + target_batch = torch.randn([args.batch_size, args.output_features]).cuda() + step = train_step(args, model, optimizer, input_batch, target_batch, step) + return step + +def main(step, args, model_state_dict, optimizer_state_dict): + # + # PART2 + # + + model = build_model(args).cuda() + one_ll = next(model.children()).weight + optimizer = FusedAdam(model.parameters()) + ASP.init_model_for_pruning(model, args.pattern, verbosity=args.verbosity, whitelist=args.whitelist, allow_recompute_mask=args.allow_recompute_mask) + ASP.init_optimizer_for_pruning(optimizer) + + torch.manual_seed(args.seed2) + model.load_state_dict(model_state_dict) + optimizer.load_state_dict(optimizer_state_dict) + + print("Model sparsity is %s" % ("enabled" if ASP.sparsity_is_enabled() else "disabled")) + + # train for a few steps with sparse weights + print("SPARSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_sparse_steps_2) + +if __name__ == '__main__': + checkpoint = torch.load("part1.chkp") + class Args: + verbosity = checkpoint['verbosity'] + seed = 4873 + seed2 = checkpoint['seed2'] + pattern = checkpoint['pattern'] + whitelist = checkpoint['whitelist'] + allow_recompute_mask = checkpoint['allow_recompute_mask'] + batch_size = 32 + input_features = 8 + output_features = 8 + hidden_features = 32 + num_layers = 4 + num_dense_steps = 2000 + num_sparse_steps = 3000 + num_sparse_steps_2 = 1000 + checkpoint_path = "part1.chkp" + args = Args() + + main(checkpoint['step'], args, checkpoint['model_state_dict'], checkpoint['optimizer_state_dict']) diff --git a/apex/apex/contrib/sparsity/test/checkpointing_test_reference.py b/apex/apex/contrib/sparsity/test/checkpointing_test_reference.py new file mode 100644 index 0000000000000000000000000000000000000000..96e2b8cc0090548761b3607bdedb3e9a125f0535 --- /dev/null +++ b/apex/apex/contrib/sparsity/test/checkpointing_test_reference.py @@ -0,0 +1,96 @@ +from collections import OrderedDict + +import torch +from apex.optimizers import FusedAdam +from apex.contrib.sparsity import ASP + +# +# Reference run for checkpointing test (part1 + part2) +# + +def build_model(args): + od = OrderedDict() + for i in range(args.num_layers): + if i == 0: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.input_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + elif i == args.num_layers-1: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.output_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.output_features]) + else: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + return torch.nn.Sequential(od) + +def train_step(args, model, optimizer, input_batch, target_batch, step): + predicted_target = model(input_batch) + loss = ((predicted_target-target_batch)**2).sum() + loss.backward() + optimizer.step() + optimizer.zero_grad() + step = step + 1 + #print("Step %d :: loss=%e" % (step, loss.item())) + return step + +def train_loop(args, model, optimizer, step, num_steps): + for i in range(num_steps): + input_batch = torch.randn([args.batch_size, args.input_features]).cuda() + target_batch = torch.randn([args.batch_size, args.output_features]).cuda() + step = train_step(args, model, optimizer, input_batch, target_batch, step) + return step + +def main(args): + # + # PART1 + # + + torch.manual_seed(args.seed) + + model = build_model(args).cuda() + one_ll = next(model.children()).weight + optimizer = FusedAdam(model.parameters()) + ASP.init_model_for_pruning(model, args.pattern, whitelist=args.whitelist, allow_recompute_mask=args.allow_recompute_mask) + ASP.init_optimizer_for_pruning(optimizer) + + step = 0 + + # train for a few steps with dense weights + print("DENSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_dense_steps) + + # simulate sparsity by inserting zeros into existing dense weights + ASP.enable_sparsity() + + # train for a few steps with sparse weights + print("SPARSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_sparse_steps) + + # + # PART 2 + # + + torch.manual_seed(args.seed2) + + # train for a few steps with sparse weights + print("SPARSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_sparse_steps_2) + +if __name__ == '__main__': + class Args: + seed = 4873 + seed2 = 99875 + pattern = "m4n2_2d_best" + whitelist = [torch.nn.Linear] + allow_recompute_mask = True + batch_size = 32 + input_features = 8 + output_features = 8 + hidden_features = 32 + num_layers = 4 + num_dense_steps = 2000 + num_sparse_steps = 3000 + num_sparse_steps_2 = 1000 + checkpoint_path = "part1.chkp" + args = Args() + + main(args) diff --git a/apex/apex/contrib/sparsity/test/toy_problem.py b/apex/apex/contrib/sparsity/test/toy_problem.py new file mode 100644 index 0000000000000000000000000000000000000000..2145323ddcaa71ba6ec3c407b753d9f078a1cd46 --- /dev/null +++ b/apex/apex/contrib/sparsity/test/toy_problem.py @@ -0,0 +1,87 @@ +from collections import OrderedDict + +import torch +from apex.optimizers import FusedAdam +from apex.contrib.sparsity import ASP + +def build_model(args): + od = OrderedDict() + for i in range(args.num_layers): + if i == 0: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.input_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + elif i == args.num_layers-1: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.output_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.output_features]) + else: + od['linear_layer_%d' % (i+1)] = torch.nn.Linear(args.hidden_features, args.hidden_features) + od['layer_norm_%d' % (i+1)] = torch.nn.LayerNorm([args.batch_size, args.hidden_features]) + return torch.nn.Sequential(od) + +def train_step(args, model, optimizer, input_batch, target_batch, step): + predicted_target = model(input_batch) + loss = ((predicted_target-target_batch)**2).sum() + loss.backward() + optimizer.step() + optimizer.zero_grad() + step = step + 1 + #print("Step %d :: loss=%e" % (step, loss.item())) + return step + +def train_loop(args, model, optimizer, step, num_steps): + for i in range(num_steps): + input_batch = torch.randn([args.batch_size, args.input_features]).cuda() + target_batch = torch.randn([args.batch_size, args.output_features]).cuda() + step = train_step(args, model, optimizer, input_batch, target_batch, step) + return step + +def main(args): + model = build_model(args).cuda() + one_ll = next(model.children()).weight + optimizer = FusedAdam(model.parameters()) + # only prune linear layers, even though we also support conv1d, conv2d and conv3d + ASP.init_model_for_pruning(model, "m4n2_1d", whitelist=[torch.nn.Linear], allow_recompute_mask=True) + ASP.init_optimizer_for_pruning(optimizer) + + step = 0 + + # train for a few steps with dense weights + print("DENSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_dense_steps) + + # simulate sparsity by inserting zeros into existing dense weights + ASP.compute_sparse_masks() + + # train for a few steps with sparse weights + print("SPARSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_sparse_steps) + + # recompute sparse masks + ASP.compute_sparse_masks() + + # train for a few steps with sparse weights + print("SPARSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_sparse_steps_2) + + # turn off sparsity + print("SPARSE :: ",one_ll) + ASP.restore_pruned_weights() + + # train for a few steps with dense weights + print("DENSE :: ",one_ll) + step = train_loop(args, model, optimizer, step, args.num_dense_steps_2) + +if __name__ == '__main__': + class Args: + batch_size = 32 + input_features = 16 + output_features = 8 + hidden_features = 40 + num_layers = 4 + num_dense_steps = 2000 + num_sparse_steps = 3000 + num_sparse_steps_2 = 1000 + num_dense_steps_2 = 1500 + args = Args() + + main(args) diff --git a/apex/apex/contrib/test/fmha/test_fmha.py b/apex/apex/contrib/test/fmha/test_fmha.py new file mode 100644 index 0000000000000000000000000000000000000000..66bdab9c9cf96eb78cd74820a01a8d08c463d14d --- /dev/null +++ b/apex/apex/contrib/test/fmha/test_fmha.py @@ -0,0 +1,113 @@ +############################################################################### +# Copyright (c) 2011-2021, NVIDIA CORPORATION. All rights reserved. +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are met: +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# * 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. +# * Neither the name of the NVIDIA CORPORATION 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 NVIDIA CORPORATION 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. +# +############################################################################### + + +import sys +import torch +import numpy as np +import unittest +import math + +import fmhalib as mha + +def py_mha(qkv, amask, b, s, h, d): + qkv = qkv.view(b, s, h, 3, d) + q = qkv[:, :, :, 0, :].permute(0,2,1,3) + k = qkv[:, :, :, 1, :].permute(0,2,1,3) + v = qkv[:, :, :, 2, :].permute(0,2,1,3) + p = torch.matmul(q.float(), k.permute(0,1,3,2).float()) + p_masked = p / math.sqrt(d) + (1.0 - amask) * -10000.0 + s = torch.softmax(p_masked, -1).to(qkv.dtype) + ctx = torch.matmul(s, v) + ctx = ctx.permute(0,2,1,3).contiguous() + + ctx.retain_grad() + + return ctx + +class TestFMHA(unittest.TestCase): + + def run_test(self, s): + + torch.manual_seed(1234) + torch.cuda.manual_seed(1234) + + dtype = torch.float16 + device = torch.device('cuda') + + b = 32 + h = 16 + d = 64 + + slens = [s] * b + a = torch.tensor(np.array([0] + slens), dtype=torch.int32) + amask = torch.ones(b,h,s,s, dtype=dtype, device=device) + seqlens = torch.tensor(slens, dtype=torch.int32, device=device) + cu_seqlens = torch.cumsum(a, 0).to(dtype=torch.int32, device=device) + total = cu_seqlens[-1].item() + + qkv = torch.randn((b,s,h,3,d), device=device, dtype=dtype) + + qkv_vs = qkv.permute(0,1,3,2,4).contiguous().view(b*s, 3, h,d) + + qkv.requires_grad = True + + ctx, S_ = mha.fwd(qkv_vs, cu_seqlens, seqlens, 0.0, s, True, None) + ctx = ctx.view(b,s,h,d) + + ctx_ref = py_mha(qkv, amask, b,s,h,d) + self.assertTrue(torch.allclose(ctx_ref.float(), ctx.float(), atol=1e-3)) + + labels = torch.randn_like(ctx_ref) + diff = ctx_ref - labels + l = (diff * diff).sum() / b + l.backward() + + dw = ctx_ref.grad.permute(0,2,1,3) + + dw2 = dw.permute(0,2,1,3).clone().detach().contiguous() + + dqkv2, _ = mha.bwd(dw2, qkv_vs, S_, cu_seqlens, seqlens, 0.0, s) + + dqkv2 = dqkv2.permute(0,2,1,3).view(b,s, h,3,d) + + self.assertTrue(torch.allclose(qkv.grad.float(), dqkv2.float(), atol=1e-3)) + + def test_128(self): + self.run_test(128) + + def test_256(self): + self.run_test(256) + + def test_384(self): + self.run_test(384) + + def test_512(self): + self.run_test(512) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/layer_norm/test_fast_layer_norm.py b/apex/apex/contrib/test/layer_norm/test_fast_layer_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..08ce2db42b96dc6901ac0f4da5b9401c38e71957 --- /dev/null +++ b/apex/apex/contrib/test/layer_norm/test_fast_layer_norm.py @@ -0,0 +1,159 @@ +import torch +import unittest +import numpy as np + +import torch.nn.functional as F + +from apex.contrib.layer_norm import FastLayerNorm + +import fast_layer_norm as fln + + +class GPUTimer: + def __init__(self, stream): + self.start_ = torch.cuda.Event(enable_timing=True) + self.stop_ = torch.cuda.Event(enable_timing=True) + self.stream_ = stream + def start(self): + self.stream_.record_event(self.start_) + def stop(self): + self.stream_.record_event(self.stop_) + def sync(self): + self.stream_.synchronize() + def millis(self): + return self.start_.elapsed_time(self.stop_) + +def size_in_bytes(t): + return torch.numel(t) * t.element_size() +def abs_err(x, y): + xf = x.float() + yf = y.float() + return ((xf-yf).abs().sum() / yf.abs().sum()).item() + + + +class TestFastLayerNorm(unittest.TestCase): + + def setUp(self, seed=1234): + seed = 1234 + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + def test_ln_fp32(self): + self.run_test_layer_norm(torch.float32, atol=1e-5) + def test_ln_fp16(self): + self.run_test_layer_norm(torch.float16, atol=1e-2, rtol=1e-3) + + def run_test_layer_norm(self, dtype, atol, rtol=1e-5): + device = torch.device('cuda') + s = 512 + b = 32 + hidden_size = 1024 + epsilon = 1e-5 + + x = torch.randn((s,b,hidden_size), dtype=dtype, device=device) + beta = torch.randn(hidden_size, dtype=dtype, device=device) + gamma = torch.randn(hidden_size, dtype=dtype, device=device) + x.requires_grad = True + beta.requires_grad = True + gamma.requires_grad = True + + x2 = x.clone().detach() + beta2 = beta.clone().detach() + gamma2 = gamma.clone().detach() + x2.requires_grad = True + beta2.requires_grad = True + gamma2.requires_grad = True + + dummy_label = torch.randn_like(x) + + y = F.layer_norm(x, [hidden_size], gamma, beta, epsilon) + + diff = y-dummy_label + l = (diff * diff).sum() / b + l.backward() + + fln = FastLayerNorm(hidden_size).cuda() + fln.load_state_dict({'bias': beta2, 'weight':gamma2}) + if dtype == torch.float16: + fln = fln.half() + + y2 = fln(x2) + diff2 = (y2 - dummy_label) + l2 = (diff2 * diff2).sum() / b + + l2.backward() + + self.assertTrue(torch.allclose(y2, y, atol=atol, rtol=rtol)) + self.assertTrue(torch.allclose(x2.grad, x.grad, atol=atol,rtol=rtol)) + self.assertTrue(torch.allclose(fln.bias.grad, beta.grad, atol=atol, rtol=rtol)) + self.assertTrue(torch.allclose(fln.weight.grad, gamma.grad, atol=atol, rtol=rtol)) + + + + def test_performance(self): + print() + runs = 1000 + device = torch.device('cuda') + dtype =torch.float16 + s = 512 + b = 32 + hidden_size = 1024 + epsilon = 1e-5 + + x = torch.randn((s*b,hidden_size), dtype=dtype, device=device) + beta = torch.randn(hidden_size, dtype=dtype, device=device) + gamma = torch.randn(hidden_size, dtype=dtype, device=device) + dy = torch.randn_like(x) + + + stream = torch.cuda.Stream() + with torch.cuda.stream(stream): + + timer = GPUTimer(stream) + + #warmup + for r in range(runs): + y, mu, rsigma = fln.ln_fwd(x, gamma, beta, 1e-5) + + + timer.start() + for r in range(runs): + y, mu, rsigma = fln.ln_fwd(x, gamma, beta, 1e-5) + timer.stop() + timer.sync() + + total_bytes_fwd = (size_in_bytes(x) + + size_in_bytes(y) + + size_in_bytes(gamma) + + size_in_bytes(beta) + + size_in_bytes(mu) + + size_in_bytes(rsigma) + ) + + ms_fwd = timer.millis() / runs + print('[FWD] Time: {:.4f}ms Throughput: {:.4f} GB/sec'.format(ms_fwd, total_bytes_fwd * 1e-6 / ms_fwd )) + + + timer.start() + for r in range(runs): + dx, dgamma, dbeta = fln.ln_bwd(dy, x, mu, rsigma, gamma) + timer.stop() + timer.sync() + + total_bytes_bwd = (size_in_bytes(x) + + size_in_bytes(dx) + + size_in_bytes(dy) + + size_in_bytes(gamma) + + size_in_bytes(dgamma) + + size_in_bytes(dbeta) + + size_in_bytes(mu) + + size_in_bytes(rsigma) + ) + + + ms_bwd = timer.millis() / runs + print('[BWD] Time: {:.4f}ms Throughput: {:.4f} GB/sec'.format(ms_bwd, total_bytes_bwd * 1e-6 / ms_bwd )) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/multihead_attn/test_encdec_multihead_attn.py b/apex/apex/contrib/test/multihead_attn/test_encdec_multihead_attn.py new file mode 100644 index 0000000000000000000000000000000000000000..26c723824d71416100cc17f02f6df0a9139ce8ad --- /dev/null +++ b/apex/apex/contrib/test/multihead_attn/test_encdec_multihead_attn.py @@ -0,0 +1,136 @@ +import torch + +import unittest + +from apex.contrib.multihead_attn import EncdecMultiheadAttn + +class EncdecMultiheadAttnTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.seq_length = 80 + self.sequences = 10 + self.hidden_dim = 1024 + self.heads = 16 + self.dropout_prob = 0.0 + + self.ref_layer = EncdecMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=False, + impl='default') + self.ref_layer.cuda().half() + self.ref_layer.reset_parameters() + self.ref_inputs_q = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + self.ref_inputs_k = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + # Reset seed so parameters are identical + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.tst_layer = EncdecMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=False, + impl='fast') + self.tst_layer.cuda().half() + self.tst_layer.reset_parameters() + + self.tst_inputs_q = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + self.tst_inputs_k = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + def test_encdec_multihead_attn(self) : + grads = torch.randn_like(self.tst_inputs_q) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs_q, + self.ref_inputs_k, + self.ref_inputs_k, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs_q, + self.tst_inputs_k, + self.tst_inputs_k, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + self.ref_inputs_q.backward(grads) + self.tst_inputs_q.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs_q, self.tst_inputs_q, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.ref_inputs_k, self.tst_inputs_k, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs_q.grad, self.tst_inputs_q.grad, atol=1e-3, rtol=1e-3)) + + def test_encdec_multihead_attn_time_mask(self) : + grads = torch.randn_like(self.tst_inputs_q) + time_mask_byte = torch.triu(torch.ones(self.tst_inputs_q.size(0), self.tst_inputs_k.size(0), device=torch.device("cuda"), dtype=torch.uint8), 1) + time_mask_bool = time_mask_byte.to(torch.bool) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs_q, + self.ref_inputs_k, + self.ref_inputs_k, + key_padding_mask=None, + need_weights=False, + attn_mask=time_mask_bool, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs_q, + self.tst_inputs_k, + self.tst_inputs_k, + key_padding_mask=None, + need_weights=False, + attn_mask=time_mask_byte, + is_training=True) + + self.ref_inputs_q.backward(grads) + self.tst_inputs_q.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs_q, self.tst_inputs_q, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.ref_inputs_k, self.tst_inputs_k, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs_q.grad, self.tst_inputs_q.grad, atol=1e-3, rtol=1e-3)) + + def test_encdec_multihead_attn_pad_mask(self) : + grads = torch.randn_like(self.tst_inputs_q) + pad_mask_byte = torch.tril(torch.ones(self.tst_inputs_k.size(1), self.tst_inputs_k.size(0), device=torch.device("cuda"), dtype=torch.uint8), 1) + pad_mask_bool = pad_mask_byte.to(torch.bool) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs_q, + self.ref_inputs_k, + self.ref_inputs_k, + key_padding_mask=pad_mask_bool, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs_q, + self.tst_inputs_k, + self.tst_inputs_k, + key_padding_mask=pad_mask_byte, + need_weights=False, + attn_mask=None, + is_training=True) + + self.ref_inputs_q.backward(grads) + self.tst_inputs_q.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs_q, self.tst_inputs_q, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.ref_inputs_k, self.tst_inputs_k, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs_q.grad, self.tst_inputs_q.grad, atol=1e-3, rtol=1e-3)) + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/multihead_attn/test_encdec_multihead_attn_norm_add.py b/apex/apex/contrib/test/multihead_attn/test_encdec_multihead_attn_norm_add.py new file mode 100644 index 0000000000000000000000000000000000000000..1313339e9425cc27b15718dbe740e6e83b20cca1 --- /dev/null +++ b/apex/apex/contrib/test/multihead_attn/test_encdec_multihead_attn_norm_add.py @@ -0,0 +1,77 @@ +import torch + +import unittest + +from apex.contrib.multihead_attn import EncdecMultiheadAttn + +class EncdecMultiheadAttnNormAddTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.seq_length = 80 + self.sequences = 10 + self.hidden_dim = 1024 + self.heads = 16 + self.dropout_prob = 0.0 + + self.ref_layer = EncdecMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=True, + impl='default') + self.ref_layer.cuda().half() + self.ref_layer.reset_parameters() + self.ref_inputs_q = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + self.ref_inputs_k = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + # Reset seed so parameters are identical + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.tst_layer = EncdecMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=True, + impl='fast') + self.tst_layer.cuda().half() + self.tst_layer.reset_parameters() + + self.tst_inputs_q = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + self.tst_inputs_k = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + def test_encdec_multihead_attn_norm_add(self) : + grads = torch.randn_like(self.tst_inputs_q) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs_q, + self.ref_inputs_k, + self.ref_inputs_k, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs_q, + self.tst_inputs_k, + self.tst_inputs_k, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + self.ref_inputs_q.backward(grads) + self.tst_inputs_q.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs_q, self.tst_inputs_q, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.ref_inputs_k, self.tst_inputs_k, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs_q.grad, self.tst_inputs_q.grad, atol=1e-3, rtol=1e-3)) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/multihead_attn/test_fast_self_multihead_attn_bias.py b/apex/apex/contrib/test/multihead_attn/test_fast_self_multihead_attn_bias.py new file mode 100644 index 0000000000000000000000000000000000000000..b4bbf342b6e61df986fb7413a52fb0959d99f692 --- /dev/null +++ b/apex/apex/contrib/test/multihead_attn/test_fast_self_multihead_attn_bias.py @@ -0,0 +1,77 @@ +import torch + +import unittest + +from apex.contrib.multihead_attn import SelfMultiheadAttn + +class SelfMultiheadAttnTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.seq_length = 80 + self.sequences = 10 + self.hidden_dim = 1024 + self.heads = 16 + self.dropout_prob = 0.0 + + self.ref_layer = SelfMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=True, + include_norm_add=False, + separate_qkv_params=True, + mask_additive=True, + impl='default') + self.ref_layer.cuda().half() + self.ref_layer.reset_parameters() + self.ref_inputs = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + # Reset seed so parameters are identical + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.tst_layer = SelfMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=True, + include_norm_add=False, + separate_qkv_params=True, + mask_additive=True, + impl='fast') + self.tst_layer.cuda().half() + self.tst_layer.reset_parameters() + + self.tst_inputs = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + def test_self_multihead_attn_additive_mask(self) : + grads = torch.randn_like(self.tst_inputs) + mask = ((torch.randn(self.sequences, self.seq_length) > 0) * -10000.0).half().cuda() + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs, + self.ref_inputs, + self.ref_inputs, + key_padding_mask=mask, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs, + self.tst_inputs, + self.tst_inputs, + key_padding_mask=mask, + need_weights=False, + attn_mask=None, + is_training=True) + + + self.ref_inputs.backward(grads) + self.tst_inputs.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs, self.tst_inputs, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs.grad, self.tst_inputs.grad, atol=1e-3, rtol=1e-3)) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/multihead_attn/test_mha_fused_softmax.py b/apex/apex/contrib/test/multihead_attn/test_mha_fused_softmax.py new file mode 100644 index 0000000000000000000000000000000000000000..60d9541847123ea2f6342728e2d44b9b421f73e5 --- /dev/null +++ b/apex/apex/contrib/test/multihead_attn/test_mha_fused_softmax.py @@ -0,0 +1,42 @@ +import torch +import unittest +import torch.nn.functional as F +from apex.contrib.multihead_attn import fast_mask_softmax_dropout_func + +class FusedSoftmaxTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.seq_length = 80 + self.sequences = 10 + self.hidden_dim = 1024 + self.heads = 16 + self.dropout_prob = 0.0 + + self.mask = (torch.randn(self.sequences,self.seq_length)>0).cuda() + self.mask = self.mask.half()*-10000 + self.ref_inputs = torch.randn(self.heads * self.sequences, self.seq_length, self.seq_length, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + self.tst_inputs = self.ref_inputs.clone().detach().requires_grad_(True) + + def test_fused_softmax(self) : + grads = torch.randn_like(self.tst_inputs) + y_ref = self.ref_inputs.view(self.sequences, self.heads, self.seq_length, self.seq_length) + y_ref = y_ref + self.mask.unsqueeze(1).unsqueeze(2) + y_ref = y_ref.view(self.sequences*self.heads, self.seq_length, self.seq_length) + y_ref = F.softmax(y_ref, dim=-1) + y_ref = torch._fused_dropout(y_ref, 1.0) + + y_tst = fast_mask_softmax_dropout_func(True, self.heads, self.tst_inputs, self.mask, True, 0.0) + y_ref[0].backward(grads) + y_tst.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs, self.tst_inputs, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(y_ref[0], y_tst, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs.grad, self.tst_inputs.grad, atol=1e-3, rtol=1e-3)) + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/multihead_attn/test_self_multihead_attn.py b/apex/apex/contrib/test/multihead_attn/test_self_multihead_attn.py new file mode 100644 index 0000000000000000000000000000000000000000..7438e177edea9c32e47c03e9d7d7185bac4d92d6 --- /dev/null +++ b/apex/apex/contrib/test/multihead_attn/test_self_multihead_attn.py @@ -0,0 +1,130 @@ +import torch + +import unittest + +from apex.contrib.multihead_attn import SelfMultiheadAttn + +class SelfMultiheadAttnTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.seq_length = 80 + self.sequences = 10 + self.hidden_dim = 1024 + self.heads = 16 + self.dropout_prob = 0.0 + + self.ref_layer = SelfMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=False, + impl='default') + self.ref_layer.cuda().half() + self.ref_layer.reset_parameters() + self.ref_inputs = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + # Reset seed so parameters are identical + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.tst_layer = SelfMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=False, + impl='fast') + self.tst_layer.cuda().half() + self.tst_layer.reset_parameters() + + self.tst_inputs = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + def test_self_multihead_attn(self) : + grads = torch.randn_like(self.tst_inputs) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs, + self.ref_inputs, + self.ref_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs, + self.tst_inputs, + self.tst_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + self.ref_inputs.backward(grads) + self.tst_inputs.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs, self.tst_inputs, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs.grad, self.tst_inputs.grad, atol=1e-3, rtol=1e-3)) + + def test_self_multihead_attn_time_mask(self) : + grads = torch.randn_like(self.tst_inputs) + time_mask_byte= torch.triu(torch.ones(self.tst_inputs.size(0), self.tst_inputs.size(0), device=torch.device("cuda"), dtype=torch.uint8), 1) + time_mask_bool= time_mask_byte.to(torch.bool) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs, + self.ref_inputs, + self.ref_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=time_mask_bool, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs, + self.tst_inputs, + self.tst_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=time_mask_byte, + is_training=True) + + + self.ref_inputs.backward(grads) + self.tst_inputs.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs, self.tst_inputs, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs.grad, self.tst_inputs.grad, atol=1e-3, rtol=1e-3)) + + def test_self_multihead_attn_pad_mask(self) : + grads = torch.randn_like(self.tst_inputs) + pad_mask_byte = torch.tril(torch.ones(self.tst_inputs.size(1), self.tst_inputs.size(0), device=torch.device("cuda"), dtype=torch.uint8), 1) + pad_mask_bool = pad_mask_byte.to(torch.bool) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs, + self.ref_inputs, + self.ref_inputs, + key_padding_mask=pad_mask_bool, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs, + self.tst_inputs, + self.tst_inputs, + key_padding_mask=pad_mask_byte, + need_weights=False, + attn_mask=None, + is_training=True) + + + self.ref_inputs.backward(grads) + self.tst_inputs.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs, self.tst_inputs, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs.grad, self.tst_inputs.grad, atol=1e-3, rtol=1e-3)) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/multihead_attn/test_self_multihead_attn_norm_add.py b/apex/apex/contrib/test/multihead_attn/test_self_multihead_attn_norm_add.py new file mode 100644 index 0000000000000000000000000000000000000000..efbb7f200d34579a8585706849d1d00c195701fb --- /dev/null +++ b/apex/apex/contrib/test/multihead_attn/test_self_multihead_attn_norm_add.py @@ -0,0 +1,72 @@ +import torch + +import unittest + +from apex.contrib.multihead_attn import SelfMultiheadAttn + +class SelfMultiheadAttnNormAddTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.seq_length = 80 + self.sequences = 10 + self.hidden_dim = 1024 + self.heads = 16 + self.dropout_prob = 0.0 + + self.ref_layer = SelfMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=True, + impl='default') + self.ref_layer.cuda().half() + self.ref_layer.reset_parameters() + self.ref_inputs = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + # Reset seed so parameters are identical + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + self.tst_layer = SelfMultiheadAttn(self.hidden_dim, + self.heads, + dropout=self.dropout_prob, + bias=False, + include_norm_add=True, + impl='fast') + self.tst_layer.cuda().half() + self.tst_layer.reset_parameters() + + self.tst_inputs = torch.randn(self.seq_length, self.sequences, self.hidden_dim, + dtype=torch.float16, device=torch.device("cuda")).requires_grad_(True) + + def test_self_multihead_attn_norm_add(self) : + grads = torch.randn_like(self.tst_inputs) + + ref_outputs,_ = self.ref_layer.forward(self.ref_inputs, + self.ref_inputs, + self.ref_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + tst_outputs,_ = self.tst_layer.forward(self.tst_inputs, + self.tst_inputs, + self.tst_inputs, + key_padding_mask=None, + need_weights=False, + attn_mask=None, + is_training=True) + + self.ref_inputs.backward(grads) + self.tst_inputs.backward(grads) + + self.assertTrue(torch.allclose(self.ref_inputs, self.tst_inputs, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_outputs, tst_outputs, atol=1e-3, rtol=1e-3)) + self.assertTrue(torch.allclose(self.ref_inputs.grad, self.tst_inputs.grad, atol=1e-3, rtol=1e-3)) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/apex/contrib/test/test_label_smoothing.py b/apex/apex/contrib/test/test_label_smoothing.py new file mode 100644 index 0000000000000000000000000000000000000000..70e9f3d09911e366c732233a02ef806666135362 --- /dev/null +++ b/apex/apex/contrib/test/test_label_smoothing.py @@ -0,0 +1,128 @@ +import torch +from apex.contrib import xentropy as label_smoothing +import unittest + +import warnings +import random +import numpy as np +import time + +def label_smoothing_raw(x, target, padding_idx, smoothing): + logprobs = torch.nn.functional.log_softmax(x, dim=-1, dtype=torch.float32) + + non_pad_mask = (target != padding_idx) + nll_loss = -logprobs.gather(dim=-1, index=target.unsqueeze(1)) + nll_loss = nll_loss.squeeze(1)[non_pad_mask] + smooth_loss = -logprobs.mean(dim=-1)[non_pad_mask] + loss = (1.0 - smoothing) * nll_loss + smoothing * smooth_loss + return loss + +def label_smoothing_opt_1(x, target, padding_idx, smoothing): + logprobs = torch.nn.functional.log_softmax(x, dim=-1, dtype=torch.float32) + + pad_mask = (target == padding_idx) + ll_loss = logprobs.gather(dim=-1, index=target.unsqueeze(1)).squeeze(1) + smooth_loss = logprobs.mean(dim=-1) + loss = (smoothing - 1.0) * ll_loss - smoothing * smooth_loss + loss.masked_fill_(pad_mask, 0) + return loss + +class LabelSmoothingTest(unittest.TestCase): + def setUp(self, seed=1234): + random.seed(seed) + np.random.seed(seed) + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + # Set pytorch print precision + torch.set_printoptions(precision=10) + + def gen_test_inputs(self, N, T, H, smoothing, padding_idx): + logits = torch.randn((N*T, H), dtype=torch.half, device='cuda', + requires_grad=True) + labels = torch.randint(0, H, [N*T], device='cuda') + for i in random.sample(range(N*T), N*T//6): + labels[i] = padding_idx + half_to_float = (logits.dtype == torch.half) + + return logits, labels, half_to_float + + def print_max_diff_elem(self, ref, tst): + ref, tst = ref.flatten(), tst.flatten() + diff = (ref - tst).abs().max() + idx = (ref - tst).abs().argmax() + print("Max atol idx: {}, diff: {:.6f}, ref: {:.6f}, tst: {:.6f}".format( + idx, diff, ref[idx], tst[idx])) + + def test_label_smoothing_function(self): + # Set label smoothing configuration + smoothing, padding_idx = 0.1, 0 + N, T, H = 128, 74, 32320 + iters = 10 + loss_func = label_smoothing.SoftmaxCrossEntropyLoss.apply + + for i in range(iters): + logits, labels, half_to_float = self.gen_test_inputs( + N, T, H, smoothing, padding_idx) + + # Run original softmax cross entropy with label smoothing + logits.grad = None + losses = label_smoothing_raw(logits, labels, padding_idx, smoothing) + loss = losses.sum() + loss.backward() + + ref_loss = loss.clone().detach() + ref_grad = logits.grad.clone().detach() + + # Run optimized softmax cross entropy with label smoothing + logits.grad = None + losses = loss_func(logits, labels, smoothing, padding_idx, half_to_float) + loss = losses.sum() + loss.backward() + + val_loss = loss.clone().detach() + val_grad = logits.grad.clone().detach() + + # Validate + self.print_max_diff_elem(ref_grad, val_grad) + self.assertTrue(torch.allclose(ref_loss, val_loss, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(ref_grad, val_grad, atol=1e-5, rtol=1e-5)) + + def test_label_smoothing_perf(self): + # Set label smoothing configuration + smoothing, padding_idx = 0.1, 0 + N, T, H = 128, 74, 32320 + iters = 1000 + loss_func = label_smoothing.SoftmaxCrossEntropyLoss.apply + print() + + logits, labels, half_to_float = self.gen_test_inputs( + N, T, H, smoothing, padding_idx) + + # Run original softmax cross entropy with label smoothing + torch.cuda.synchronize() + ts = time.time() + for i in range(iters): + logits.grad = None + losses = label_smoothing_raw(logits, labels, padding_idx, smoothing) + loss = losses.sum() / N + loss.backward() + torch.cuda.synchronize() + print("Raw time {:.2f} s elapsed for {} iterations, norm {:.4f}".format( + time.time() - ts, iters, logits.grad.norm())) + + # Run optimized softmax cross entropy with label smoothing + torch.cuda.synchronize() + ts = time.time() + for i in range(iters): + logits.grad = None + losses = loss_func(logits, labels, smoothing, padding_idx, half_to_float) + loss = losses.sum() / N + loss.backward() + torch.cuda.synchronize() + print("Opt time {:.2f} s elapsed for {} iterations, norm {:.4f}".format( + time.time() - ts, iters, logits.grad.norm())) + +if __name__ == '__main__': + unittest.main() + diff --git a/apex/apex/contrib/test/transducer/test_transducer_joint.py b/apex/apex/contrib/test/transducer/test_transducer_joint.py new file mode 100755 index 0000000000000000000000000000000000000000..619a6f335f94d6f35e8d6c2f81164c5fdaf8039e --- /dev/null +++ b/apex/apex/contrib/test/transducer/test_transducer_joint.py @@ -0,0 +1,107 @@ +import torch +import unittest +from apex.contrib.transducer import TransducerJoint +import transducer_ref + +class TransducerJointTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + def gen_input(self, for_vector_kernel): + self.B = 4 + T_min = 51 + T_max = 101 + U_min = 12 + U_max = 25 + if for_vector_kernel: + H = 512 + else: + H = 509 + dtype = torch.float16 + device = "cuda" + + self.f_tst = torch.randn((self.B, T_max, H), dtype=dtype, requires_grad=True, device=device) + self.g_tst = torch.randn((self.B, U_max, H), dtype=dtype, requires_grad=True, device=device) + self.h_grad = torch.randn(self.B, T_max, U_max, H, dtype=dtype, device=device) + self.f_len = torch.randint(T_min, T_max+1, (self.B,), dtype=torch.int, device=device) + self.g_len = torch.randint(U_min, U_max+1, (self.B,), dtype=torch.int, device=device) + self.f_len[torch.randint(0, self.B, (1,)).item()] = T_max + self.g_len[torch.randint(0, self.B, (1,)).item()] = U_max + + # Make sure gradients from out-of-bound locations are zero. This should be guaranteed by + # the loss function + for b in range(self.B): + self.h_grad[b, self.f_len[b]:, :, :] = 0 + self.h_grad[b, :, self.g_len[b]:, :] = 0 + self.h_grad_packed = self._pack(self.h_grad, self.f_len, self.g_len) + + + def _pack(self, x, f_len, g_len): + B = x.size(0) + list_x = [] + for b in range(B): + list_x_row = [x[b, t, :g_len[b]] for t in range(f_len[b])] + x_row = torch.cat(list_x_row) + list_x.append(x_row) + x_packed = torch.cat(list_x).data.clone() + x_packed.requires_grad = True + batch_offset = torch.cumsum(f_len * g_len, dim=0) + return x_packed + + + def run_transducer_joint(self, for_vector_kernel, pack_output): + self.gen_input(for_vector_kernel=for_vector_kernel) + # Generate reference + f_ref = self.f_tst.data.clone() + g_ref = self.g_tst.data.clone() + f_ref.requires_grad = True + g_ref.requires_grad = True + + h_ref, f_grad_ref, g_grad_ref \ + = transducer_ref.transducer_joint_reference(f=f_ref, + g=g_ref, + h_grad=self.h_grad, + f_len=self.f_len, + g_len=self.g_len, + pack_output=pack_output) + + my_joint= TransducerJoint(pack_output=pack_output) + if not pack_output: + h_tst = my_joint( f=self.f_tst, + g=self.g_tst, + f_len=self.f_len, + g_len=self.g_len) + h_tst.backward(self.h_grad) + else: + batch_offset = torch.cumsum(self.f_len * self.g_len, dim=0) + h_tst = my_joint( f=self.f_tst, + g=self.g_tst, + f_len=self.f_len, + g_len=self.g_len, + batch_offset=batch_offset, + packed_batch=batch_offset[-1]) + h_tst.backward(self.h_grad_packed) + + f_grad_tst = self.f_tst.grad + g_grad_tst = self.g_tst.grad + + self.assertTrue(torch.allclose(h_ref, h_tst, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(f_grad_ref, f_grad_tst, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(g_grad_ref, g_grad_tst, atol=1e-4, rtol=1e-4)) + + def test_transducer_joint(self): + self.run_transducer_joint(for_vector_kernel=False, pack_output=False) + + def test_transducer_joint_vec(self): + self.run_transducer_joint(for_vector_kernel=True, pack_output=False) + + def test_transducer_joint_pack(self): + self.run_transducer_joint(for_vector_kernel=False, pack_output=True) + + def test_transducer_joint_vec_pack(self): + self.run_transducer_joint(for_vector_kernel=True, pack_output=True) + + +if __name__ == '__main__': + unittest.main() \ No newline at end of file diff --git a/apex/apex/contrib/test/transducer/test_transducer_loss.py b/apex/apex/contrib/test/transducer/test_transducer_loss.py new file mode 100755 index 0000000000000000000000000000000000000000..157bcca97fe669745340bbedda27c0863a2034bf --- /dev/null +++ b/apex/apex/contrib/test/transducer/test_transducer_loss.py @@ -0,0 +1,121 @@ +import torch +import unittest +from apex.contrib.transducer import TransducerLoss +import transducer_ref + +class TransducerLossTest(unittest.TestCase): + def setUp(self, seed=1234): + torch.manual_seed(seed) + torch.cuda.manual_seed_all(seed) + + def gen_input(self, scalar_t): + self.B = 5 + T_min = 23 + T_max = 51 + U_min = 12 + U_max = 25 + V = 16 + self.blank_idx = V - 1 + device = "cuda" + + self.x_tst = torch.randn((self.B, T_max, U_max, V), dtype=scalar_t, requires_grad=True, + device=device) + self.y = torch.randint(0, self.blank_idx, (self.B, U_max-1), dtype=torch.int, device=device) + self.f_len = torch.randint(T_min, T_max+1, (self.B,), dtype=torch.int, device=device) + self.y_len = torch.randint(U_min-1, U_max, (self.B,), dtype=torch.int, device=device) + self.f_len[torch.randint(0, self.B, (1,)).item()] = T_max + self.y_len[torch.randint(0, self.B, (1,)).item()] = U_max-1 + self.x_tst_packed, self.batch_offset = self._pack(self.x_tst) + # Generate reference + x_ref = self.x_tst.data.clone() + x_ref.requires_grad = True + loss_grad = torch.ones(x_ref.size(0), dtype=x_ref.dtype, device=x_ref.device)/x_ref.size(0) + _, _, self.grad_ref, self.loss_ref \ + = transducer_ref.transducer_loss_reference( x=x_ref, + label=self.y, + f_len=self.f_len, + y_len=self.y_len, + blank_idx=self.blank_idx, + loss_grad=loss_grad) + + def _pack(self, x): + list_x = [] + for b in range(self.B): + list_x_row = [x[b, t, : self.y_len[b]+1] for t in range(self.f_len[b])] + x_row = torch.cat(list_x_row) + list_x.append(x_row) + x_packed = torch.cat(list_x).data.clone() + x_packed.requires_grad = True + batch_offset = torch.cumsum(self.f_len * (self.y_len+1), dim=0) + return x_packed, batch_offset + + def _unpack(self, x): + x_unpacked = torch.zeros(self.B, self.f_len.max(), self.y_len.max()+1, x.size(-1), + dtype=x.dtype, device=x.device) + for b in range(self.B): + my_batch_offset = 0 if b == 0 else self.batch_offset[b-1] + my_f_len = self.f_len[b] + my_g_len = self.y_len[b] + 1 + for t in range(my_f_len): + for u in range(my_g_len): + x_unpacked[b, t, u] = x[my_batch_offset + t*my_g_len + u] + return x_unpacked + + def run_transducer_loss(self, scalar_t, fuse_softmax_backward, packed_input): + self.gen_input(scalar_t) + my_loss = TransducerLoss( fuse_softmax_backward=fuse_softmax_backward, + packed_input=packed_input) + if not packed_input: + loss_tst = my_loss( x=self.x_tst, + label=self.y, + f_len=self.f_len, + y_len=self.y_len, + blank_idx=self.blank_idx) + loss_tst.mean().backward() + grad_tst = self.x_tst.grad + else: + loss_tst = my_loss( x=self.x_tst_packed, + label=self.y, + f_len=self.f_len, + y_len=self.y_len, + blank_idx=self.blank_idx, + batch_offset=self.batch_offset, + max_f_len=max(self.f_len)) + loss_tst.mean().backward() + grad_tst_packed = self.x_tst_packed.grad + grad_tst = self._unpack(grad_tst_packed) + + return loss_tst, grad_tst + + def test_transducer_loss_fp32(self): + loss_tst, grad_tst = self.run_transducer_loss( scalar_t=torch.float32, + fuse_softmax_backward=False, + packed_input=False) + self.assertTrue(torch.allclose(self.loss_ref, loss_tst, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.grad_ref, grad_tst, atol=1e-5, rtol=1e-5)) + + def test_transducer_loss_fp16(self): + loss_tst, grad_tst = self.run_transducer_loss( scalar_t=torch.float16, + fuse_softmax_backward=False, + packed_input=False) + self.assertTrue(torch.allclose(self.loss_ref, loss_tst, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.grad_ref, grad_tst, atol=1e-4, rtol=1e-3)) + + def test_transducer_loss_fp16_backward_fusion(self): + loss_tst, grad_tst = self.run_transducer_loss( scalar_t=torch.float16, + fuse_softmax_backward=True, + packed_input=False) + self.assertTrue(torch.allclose(self.loss_ref, loss_tst, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.grad_ref, grad_tst, atol=1e-4, rtol=1e-3)) + + def test_transducer_loss_fp16_backward_fusion_packed(self): + loss_tst, grad_tst = self.run_transducer_loss( scalar_t=torch.float16, + fuse_softmax_backward=True, + packed_input=True) + self.assertTrue(torch.allclose(self.loss_ref, loss_tst, atol=1e-5, rtol=1e-5)) + self.assertTrue(torch.allclose(self.grad_ref, grad_tst, atol=1e-4, rtol=1e-3)) + + + +if __name__ == '__main__': + unittest.main() \ No newline at end of file diff --git a/apex/apex/contrib/test/transducer/transducer_ref.py b/apex/apex/contrib/test/transducer/transducer_ref.py new file mode 100755 index 0000000000000000000000000000000000000000..58232e2bc068cd475ac120b1f94cf44b68f899d6 --- /dev/null +++ b/apex/apex/contrib/test/transducer/transducer_ref.py @@ -0,0 +1,102 @@ +import torch +import numpy as np +import pdb + +def transducer_loss_reference(x, label, f_len, y_len, blank_idx, loss_grad): + def log_sum_exp(a, b): + if (a >= b): + return a + torch.log(1 + torch.exp(b-a)) + else: + return b + torch.log(1 + torch.exp(a-b)) + + def forward_alpha(x, label, f_len, y_len, blank_idx): + B, T, U, V = x.size() + acc_t = torch.float32 if x.dtype in [torch.float16, torch.float32] else x.dtype + alpha = torch.zeros((B, T, U), dtype=acc_t, device=x.device) + for b in range(B): + alpha[b, 0, 0] = 0 + for t in range(1, f_len[b]): + alpha[b, t, 0] = alpha[b, t-1, 0] + x[b, t-1, 0, blank_idx] + for u in range(1, y_len[b]+1): + alpha[b, 0, u] = alpha[b, 0, u-1] + x[b, 0, u-1, label[b, u-1]] + for t in range(1, f_len[b]): + for u in range(1, y_len[b]+1): + curr_ = alpha[b, t-1, u] + x[b, t-1, u, blank_idx] + next_ = alpha[b, t, u-1] + x[b, t, u-1, label[b, u-1]] + alpha[b, t, u] = log_sum_exp(curr_, next_) + return alpha + + def forward_beta(x, label, f_len, y_len, blank_idx): + B, T, U, V = x.shape + acc_t = torch.float32 if x.dtype in [torch.float16, torch.float32] else x.dtype + beta = torch.zeros((B, T, U), dtype=acc_t, device=x.device) + for b in range(B): + beta[b, f_len[b]-1, y_len[b]] = x[b, f_len[b]-1, y_len[b], blank_idx] + for t in range(f_len[b]-2, -1, -1): + beta[b, t, y_len[b]] = beta[b, t+1, y_len[b]] + x[b, t, y_len[b], blank_idx] + for u in range(y_len[b]-1, -1, -1): + beta[b, f_len[b]-1, u] = beta[b, f_len[b]-1, u+1] + x[b, f_len[b]-1, u, label[b, u]] + for t in range(f_len[b]-2, -1, -1): + for u in range(y_len[b]-1, -1, -1): + curr_ = beta[b, t+1, u] + x[b, t, u, blank_idx] + next_ = beta[b, t, u+1] + x[b, t, u, label[b, u]] + beta[b, t, u] = log_sum_exp(curr_, next_) + return beta + + def backward(x, label, f_len, y_len, alpha, beta, loss_grad, blank_idx): + grad = torch.zeros_like(x) + B, T, U, V = x.size() + for b in range(B): + common_factor = torch.log(loss_grad[b]) + alpha - beta[b, 0, 0] + # next + for u in range(y_len[b]): + grad[b, :f_len[b], u, label[b, u]] = -torch.exp(common_factor[b, :f_len[b], u] + + beta[b, :f_len[b], u+1] + + x[b, :f_len[b], u, label[b, u]]) + + # current + grad[b, :f_len[b]-1, :y_len[b]+1, blank_idx] \ + = -torch.exp(common_factor[b, :f_len[b]-1, :y_len[b]+1] + + beta[b, 1:f_len[b], :y_len[b]+1] + + x[b, :f_len[b]-1, :y_len[b]+1, blank_idx]) + + grad[b, f_len[b]-1, y_len[b], blank_idx] = -torch.exp(common_factor[b, f_len[b]-1, y_len[b]] + + x[b, f_len[b]-1, y_len[b], blank_idx]) + + return grad + + x_log = torch.nn.functional.log_softmax(x, dim=-1) + alpha = forward_alpha(x_log, label, f_len, y_len, blank_idx) + beta = forward_beta(x_log, label, f_len, y_len, blank_idx) + grad = backward(x_log, label, f_len, y_len, alpha, beta, + loss_grad, blank_idx) + x_log.backward(grad) + loss = -beta[:, 0, 0] + loss = loss.to(x.dtype) + return alpha, beta, x.grad, loss + + +def transducer_joint_reference(f, g, h_grad, f_len, g_len, pack_output): + B, T, H = f.size() + U = g.size(1) + f_expand = f.unsqueeze(dim=2) + g_expand = g.unsqueeze(dim=1) + h = f_expand + g_expand + h.backward(h_grad) + + if pack_output == False: + # intentionally set don't-care region to -1 to test if transducer joint + # write these regions to avoid NaN and inf + for b in range(B): + h[b, f_len[b]:] = -1 + h[b, :, g_len[b]:] = -1 + return h, f.grad, g.grad + + # packing + list_to_pack = [] + for b in range(B): + list_to_pack.append(h[b, :f_len[b], :g_len[b], :].reshape(-1, H)) + h_packed = torch.cat(list_to_pack) + return h_packed, f.grad, g.grad + + diff --git a/apex/apex/contrib/transducer/__init__.py b/apex/apex/contrib/transducer/__init__.py new file mode 100755 index 0000000000000000000000000000000000000000..bd5dbf603003e263967a0fcf91509b85f8127e50 --- /dev/null +++ b/apex/apex/contrib/transducer/__init__.py @@ -0,0 +1,2 @@ +from .transducer import TransducerJoint +from .transducer import TransducerLoss \ No newline at end of file diff --git a/apex/apex/contrib/transducer/transducer.py b/apex/apex/contrib/transducer/transducer.py new file mode 100755 index 0000000000000000000000000000000000000000..42990f964ea75589d7eb3d7892422ae291466fd4 --- /dev/null +++ b/apex/apex/contrib/transducer/transducer.py @@ -0,0 +1,161 @@ +import torch +import transducer_loss_cuda +import transducer_joint_cuda + +class TransducerJoint(torch.nn.Module): + """Transducer joint + Detail of this loss function can be found in: Sequence Transduction with Recurrent Neural + Networks + + Arguments: + pack_output (bool, optional): whether to pack the output in a compact form with don't-care + data being removed. (default: False) + opt (int, optional): pick the optimization level in [0, 1]. opt=1 picks a tiled algorithm. + (default: 1) + fwd_tile_size (int, optional): tile size used in forward operation. This argument will be + ignored if opt != 1. (default: 4) + """ + + def __init__(self, pack_output=False, opt=1, fwd_tile_size=4): + super(TransducerJoint, self).__init__() + self.pack_output = pack_output + self.opt = opt + self.fwd_tile_size = fwd_tile_size + self.dummy_batch_offset = torch.empty(0) + + + def forward(self, f, g, f_len, g_len, batch_offset=None, packed_batch=0): + """Forward operation of transducer joint + + Arguments: + f (tensor): transcription vector from encode block of shape (B, T, H). + g (tensor): prediction vector form predict block of shape (B, U, H). + f_len (tensor): length of transcription vector for each batch. + g_len (tensor): length of prediction vector minus 1 for each batch. + batch_offset (tensor, optional): tensor containing the offset of each batch + in the results. For example, batch offset can be obtained from: + batch_offset = torch.cumsum(f_len*g_len, dim=0) + This argument is required if pack_output == True, and is ignored if + pack_output == False. (default: None) + packed_batch (int, optional): the batch size after packing. This argument is + ignored if pack_output == False. (default: 0) + """ + my_batch_offset = batch_offset if self.pack_output else self.dummy_batch_offset + if self.pack_output and (batch_offset is None or packed_batch == 0): + raise Exception("Please specify batch_offset and packed_batch when packing is enabled") + return TransducerJointFunc.apply(f, g, f_len, g_len, self.pack_output, my_batch_offset, + packed_batch, self.opt, self.fwd_tile_size) + + +class TransducerLoss(torch.nn.Module): + """Transducer loss + Detail of this loss function can be found in: Sequence Transduction with Recurrent Neural + Networks + + Arguments: + fuse_softmax_backward (bool, optional) whether to fuse the backward of transducer loss with + softmax. (default: True) + opt (int, optional): pick the optimization level in [0, 1]. opt=1 picks a more optimized + algorithm. In some cases, opt=1 might fall back to opt=0. (default: 1) + packed_input (bool, optional): whether to pack the output in a compact form with don't-care + data being removed. (default: False) + """ + def __init__(self, fuse_softmax_backward=True, opt=1, packed_input=False): + super(TransducerLoss, self).__init__() + self.fuse_softmax_backward = fuse_softmax_backward + self.opt = opt + self.packed_input = packed_input + self.dummy_batch_offset = torch.empty(0) + + + def forward(self, x, label, f_len, y_len, blank_idx, batch_offset=None, max_f_len=None, + debug_list=None): + """Forward operation of transducer joint + + Arguments: + x (tensor): input tensor to the loss function with a shape of (B, T, U, H). + label (tensor): labels for the input data. + f_len (tensor): lengths of the inputs in the time dimension for each batch. + y_len (tensor): lengths of the labels for each batch. + blank_idx (int): index for the null symbol. + batch_offset (tensor, optional): tensor containing the offset of each batch + in the input. For example, batch offset can be obtained from: + batch_offset = torch.cumsum(f_len*(y_len+1), dim=0) + This argument is required if packed_input == True, and is ignored if + packed_input == False. (default: None) + max_f_len (int, optional): maximum length of the input in the time dimension. + For example, it can be obtained as + max_f_len = max(f_len) + This argument is required if packed_input == True, and is ignored if + packed_input == False. (default: None) + (default: None) + debug_list (list, optional): when an empty list is supplied, Alpha and Beta generated + in the forward operation will be attached to this list for debug purpose. + (default: None) + """ + if self.packed_input: + if batch_offset is None or max_f_len is None: + raise Exception("Please specify batch_offset and max_f_len when packing is \ + enabled") + my_batch_offset = batch_offset + my_max_f_len = max_f_len + else: + my_batch_offset = self.dummy_batch_offset + my_max_f_len = x.size(1) + return TransducerLossFunc.apply(x, label, f_len, y_len, my_batch_offset, my_max_f_len, + blank_idx, self.fuse_softmax_backward, debug_list, + self.opt, self.packed_input) + +class TransducerLossFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, x, label, f_len, y_len, batch_offset, max_f_len, blank_idx, + fuse_softmax_backward, debug_list, opt, packed_input): + if fuse_softmax_backward == False: + with torch.enable_grad(): + x = torch.nn.functional.log_softmax(x, dim=-1) + else: + x = torch.nn.functional.log_softmax(x, dim=-1) + alpha, beta, loss = transducer_loss_cuda.forward( x, label, f_len, y_len, batch_offset, + max_f_len, blank_idx, opt, packed_input) + if debug_list == []: + debug_list += [alpha, beta] + ctx.save_for_backward(x, alpha, beta, f_len, y_len, label, batch_offset) + ctx.blank_idx = blank_idx + ctx.fuse_softmax_backward = fuse_softmax_backward + ctx.opt = opt + ctx.packed_input = packed_input + ctx.max_f_len = max_f_len + return loss + + @staticmethod + def backward(ctx, loss_grad): + x, alpha, beta, f_len, y_len, label, batch_offset = ctx.saved_tensors + x_grad = transducer_loss_cuda.backward( x, loss_grad, alpha, beta, f_len, y_len, label, + batch_offset, ctx.max_f_len, ctx.blank_idx, ctx.opt, + ctx.fuse_softmax_backward, ctx.packed_input) + if ctx.fuse_softmax_backward == False: + x_grad = x.backward(x_grad) + return x_grad, None, None, None, None, None, None, None, None, None, None + +class TransducerJointFunc(torch.autograd.Function): + @staticmethod + def forward(ctx, f, g, f_len, g_len, pack_output, batch_offset, packed_batch, opt, + fwd_tile_size): + h = transducer_joint_cuda.forward(f, g, f_len, g_len, batch_offset, packed_batch, opt, + pack_output, fwd_tile_size) + ctx.save_for_backward(f_len, g_len, batch_offset) + ctx.pack_output = pack_output + ctx.max_f_len = f.size(1) + ctx.max_g_len = g.size(1) + return h + + @staticmethod + def backward(ctx, loss_grad): + f_len, g_len, batch_offset = ctx.saved_tensors + f_grad, g_grad = transducer_joint_cuda.backward(loss_grad, f_len, g_len, batch_offset, + ctx.max_f_len, ctx.max_g_len, + ctx.pack_output) + + return f_grad, g_grad, None, None, None, None, None, None, None, None, None, None + + diff --git a/apex/apex/contrib/xentropy/__init__.py b/apex/apex/contrib/xentropy/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..7dff6a27a513bd9a77acf5b6f353aa5a38f6d2f2 --- /dev/null +++ b/apex/apex/contrib/xentropy/__init__.py @@ -0,0 +1,9 @@ +try: + import torch + import xentropy_cuda + from .softmax_xentropy import SoftmaxCrossEntropyLoss + del torch + del xentropy_cuda + del softmax_xentropy +except ImportError as err: + print("apex was installed without --xentropy flag, contrib.xentropy is not available") diff --git a/apex/apex/contrib/xentropy/softmax_xentropy.py b/apex/apex/contrib/xentropy/softmax_xentropy.py new file mode 100644 index 0000000000000000000000000000000000000000..33fbf8b21646842a5da2a21beb66208817a9e85a --- /dev/null +++ b/apex/apex/contrib/xentropy/softmax_xentropy.py @@ -0,0 +1,28 @@ +import torch +import xentropy_cuda + +class SoftmaxCrossEntropyLoss(torch.autograd.Function): + @staticmethod + def forward(ctx, logits, labels, smoothing=0.0, padding_idx=0, half_to_float=False): + losses, max_log_sum_exp = xentropy_cuda.forward( + logits, labels, smoothing, half_to_float) + losses.masked_fill_(labels==padding_idx, 0) + + ctx.save_for_backward(logits, max_log_sum_exp, labels, + torch.FloatTensor([smoothing]), + torch.LongTensor([padding_idx])) + + return losses + + @staticmethod + def backward(ctx, grad_loss): + logits, max_log_sum_exp, labels, smoothing, padding_idx = ctx.saved_tensors + + if not grad_loss.is_contiguous(): + grad_loss = grad_loss.contiguous() + grad_loss.masked_fill_(labels==padding_idx.item(), 0) + grad_logits = xentropy_cuda.backward( + grad_loss.contiguous(), logits, max_log_sum_exp, + labels, smoothing.item()) + + return grad_logits, None, None, None, None diff --git a/apex/apex/fp16_utils/README.md b/apex/apex/fp16_utils/README.md new file mode 100644 index 0000000000000000000000000000000000000000..941de17947f8ea75de248f3a8e1445cef7a114b2 --- /dev/null +++ b/apex/apex/fp16_utils/README.md @@ -0,0 +1,16 @@ +fp16_optimizer.py contains `FP16_Optimizer`, a Python class designed to wrap an existing Pytorch optimizer and automatically enable master parameters and loss scaling in a manner transparent to the user. To use `FP16_Optimizer`, only two lines of one's Python model need to change. + +#### [FP16_Optimizer API documentation](https://nvidia.github.io/apex/fp16_utils.html#automatic-management-of-master-params-loss-scaling) + +#### [Simple examples with FP16_Optimizer](https://github.com/NVIDIA/apex/tree/master/examples/FP16_Optimizer_simple) + +#### [Imagenet with FP16_Optimizer](https://github.com/NVIDIA/apex/tree/master/examples/imagenet) + +#### [word_language_model with FP16_Optimizer](https://github.com/NVIDIA/apex/tree/master/examples/word_language_model) + + +fp16_util.py contains a number of utilities to manually manage master parameters and loss scaling, if the user chooses. + +#### [Manual management documentation](https://nvidia.github.io/apex/fp16_utils.html#manual-master-parameter-management) + +The [Imagenet with FP16_Optimizer](https://github.com/NVIDIA/apex/tree/master/examples/imagenet) and [word_language_model with FP16_Optimizer](https://github.com/NVIDIA/apex/tree/master/examples/word_language_model) directories also contain `main.py` files that demonstrate manual management of master parameters and static loss scaling. These examples illustrate what sort of operations `FP16_Optimizer` is performing automatically. diff --git a/apex/apex/fp16_utils/__init__.py b/apex/apex/fp16_utils/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..c7bb1f537efe1b580b1d556974a117e169e9b0c0 --- /dev/null +++ b/apex/apex/fp16_utils/__init__.py @@ -0,0 +1,16 @@ +from .fp16util import ( + BN_convert_float, + network_to_half, + prep_param_lists, + model_grads_to_master_grads, + master_params_to_model_params, + tofp16, + to_python_float, + clip_grad_norm, + convert_module, + convert_network, + FP16Model, +) + +from .fp16_optimizer import FP16_Optimizer +from .loss_scaler import LossScaler, DynamicLossScaler diff --git a/apex/apex/fp16_utils/fp16_optimizer.py b/apex/apex/fp16_utils/fp16_optimizer.py new file mode 100755 index 0000000000000000000000000000000000000000..7c0dd397f9c98d5e0e4a3e3a461f1f7f4d53cecd --- /dev/null +++ b/apex/apex/fp16_utils/fp16_optimizer.py @@ -0,0 +1,554 @@ +import torch +from torch import nn +from torch.autograd import Variable +from torch.nn.parameter import Parameter +from torch._utils import _flatten_dense_tensors, _unflatten_dense_tensors + +from ..amp._amp_state import _amp_state, maybe_print +from ..amp.scaler import LossScaler +from ..multi_tensor_apply import multi_tensor_applier +from .fp16util import model_grads_to_master_grads, master_params_to_model_params, clip_grad_norm + +# TODO: Update overflow check + downscale to use Carl's fused kernel. +class FP16_Optimizer(object): + def __init__(self, + init_optimizer, + static_loss_scale=1.0, + dynamic_loss_scale=False, + dynamic_loss_args=None, + verbose=True): + print("Warning: FP16_Optimizer is deprecated and dangerous, and will be deleted soon. " + "If it still works, you're probably getting lucky. " + "For mixed precision, use the documented API https://nvidia.github.io/apex/amp.html, with opt_level=O1.") + + if not torch.cuda.is_available: + raise SystemError("Cannot use fp16 without CUDA.") + + self.verbose = verbose + + self.optimizer = init_optimizer + # init_state_dict sets up an alternative way to cast per-param state tensors. + # Stashing here in case https://github.com/pytorch/pytorch/issues/7733 makes it necessary. + # init_state_dict = init_optimizer.state_dict() + + self.fp16_groups = [] + self.fp32_from_fp16_groups = [] + self.fp32_from_fp32_groups = [] + for i, param_group in enumerate(self.optimizer.param_groups): + self.maybe_print("FP16_Optimizer processing param group {}:".format(i)) + fp16_params_this_group = [] + fp32_params_this_group = [] + fp32_from_fp16_params_this_group = [] + for i, param in enumerate(param_group['params']): + if param.requires_grad: + if param.type() == 'torch.cuda.HalfTensor': + self.maybe_print("FP16_Optimizer received torch.cuda.HalfTensor with {}" + .format(param.size())) + fp16_params_this_group.append(param) + master_param = param.detach().clone().float() + master_param.requires_grad = True + param_group['params'][i] = master_param + fp32_from_fp16_params_this_group.append(master_param) + # Reset existing state dict key to the new master param. + # We still need to recast per-param state tensors, if any, to FP32. + if param in self.optimizer.state: + self.optimizer.state[master_param] = self.optimizer.state.pop(param) + elif param.type() == 'torch.cuda.FloatTensor': + self.maybe_print("FP16_Optimizer received torch.cuda.FloatTensor with {}" + .format(param.size())) + fp32_params_this_group.append(param) + param_group['params'][i] = param + else: + raise TypeError("Wrapped parameters must be either " + "torch.cuda.FloatTensor or torch.cuda.HalfTensor. " + "Received {}".format(param.type())) + + self.fp16_groups.append(fp16_params_this_group) + self.fp32_from_fp16_groups.append(fp32_from_fp16_params_this_group) + self.fp32_from_fp32_groups.append(fp32_params_this_group) + + self.all_fp16_params = [] + for group in self.fp16_groups: + self.all_fp16_params += group + + self.all_fp32_from_fp16_params = [] + for group in self.fp32_from_fp16_groups: + self.all_fp32_from_fp16_params += group + + self.all_fp32_from_fp32_params = [] + for group in self.fp32_from_fp32_groups: + self.all_fp32_from_fp32_params += group + + # Leverage state_dict() and load_state_dict() to recast preexisting per-param state tensors + self.optimizer.load_state_dict(self.optimizer.state_dict()) + # alternative way to cast per-param state tensors: + # self.optimizer.load_state_dict(init_state_dict) + + if dynamic_loss_scale: + self.dynamic_loss_scale = True + if dynamic_loss_args is not None: + self.loss_scaler = LossScaler("dynamic", **dynamic_loss_args) + else: + self.loss_scaler = LossScaler("dynamic") + else: + self.dynamic_loss_scale = False + self.loss_scaler = LossScaler(static_loss_scale) + + self.overflow = False + self.first_closure_call_this_step = True + + self.clip_grad_norm = clip_grad_norm + + # TODO: Centralize exposure and import error checking for the C backend. + if multi_tensor_applier.available: + import amp_C + self.multi_tensor_scale = amp_C.multi_tensor_scale + self._dummy_overflow_buf = torch.cuda.IntTensor([0]); + + # Having self.maybe_print distinct from _amp_state.maybe_print is another artifact + # of having to support FP16_Optimizer separately, for the time being. + def maybe_print(self, msg): + if self.verbose: + print(msg) + + def __getstate__(self): + raise RuntimeError("FP16_Optimizer should be serialized using state_dict().") + + def __setstate__(self, state): + raise RuntimeError("FP16_Optimizer should be deserialized using load_state_dict().") + + def zero_grad(self, set_grads_to_None=False): + """ + Zero fp32 and fp16 parameter grads. + """ + # In principle, only the .grad attributes of the model params need to be zeroed, + # because gradients are copied into the FP32 master params. However, we zero + # all gradients owned by the optimizer, just to be safe: + for group in self.optimizer.param_groups: + for p in group['params']: + if set_grads_to_None: + p.grad = None + else: + if p.grad is not None: + p.grad.detach_() + p.grad.zero_() + + # Zero fp16 gradients owned by the model: + for fp16_group in self.fp16_groups: + for param in fp16_group: + if set_grads_to_None: + param.grad = None + else: + if param.grad is not None: + param.grad.detach_() # as in torch.optim.optimizer.zero_grad() + param.grad.zero_() + + # Should not be used anymore. + # def _check_overflow(self): + # params = [] + # for group in self.fp16_groups: + # for param in group: + # params.append(param) + # for group in self.fp32_from_fp32_groups: + # for param in group: + # params.append(param) + # self.overflow = self.loss_scaler.has_overflow(params) + + # def _update_scale(self, has_overflow=False): + # self.loss_scaler.update_scale(has_overflow) + + def _master_params_to_model_params(self): + if multi_tensor_applier.available: + if len(self.all_fp16_params) > 0: + multi_tensor_applier( + self.multi_tensor_scale, + self._dummy_overflow_buf, + [self.all_fp32_from_fp16_params, self.all_fp16_params], + 1.0) + else: + for fp16_group, fp32_from_fp16_group in zip(self.fp16_groups, self.fp32_from_fp16_groups): + master_params_to_model_params(fp16_group, fp32_from_fp16_group) + + # To consider: Integrate distributed with this wrapper by registering a hook on each variable + # that does the overflow check, gradient copy + downscale, and fp32 allreduce in a different stream. + # def _model_grads_to_master_grads(self): + # for fp16_group, fp32_from_fp16_group in zip(self.fp16_groups, self.fp32_from_fp16_groups): + # model_grads_to_master_grads(fp16_group, fp32_from_fp16_group) + + # def _downscale_master(self): + # if self.loss_scale != 1.0: + # for group in self.optimizer.param_groups: + # for param in group['params']: + # if param.grad is not None: + # param.grad.data.mul_(1./self.loss_scale) + + def clip_master_grads(self, max_norm, norm_type=2): + """ + Clips fp32 master gradients via ``torch.nn.utils.clip_grad_norm``. + + Args: + max_norm (float or int): max norm of the gradients + norm_type (float or int): type of the used p-norm. Can be ``'inf'`` for + infinity norm. + + Returns: + Total norm of the current fp32 gradients (viewed as a single vector). + + .. warning:: + Returns -1 if the most recently computed fp16 gradients overflowed (that is, if ``self.overflow`` is ``True``). + """ + if not self.overflow: + fp32_params = [] + for param_group in self.optimizer.param_groups: + for param in param_group['params']: + fp32_params.append(param) + return self.clip_grad_norm(fp32_params, max_norm, norm_type) + else: + return -1 + + def state_dict(self): + """ + Returns a dict containing the current state of this :class:`FP16_Optimizer` instance. + This dict contains attributes of :class:`FP16_Optimizer`, as well as the state_dict + of the contained Pytorch optimizer. + Example:: + + checkpoint = {} + checkpoint['model'] = model.state_dict() + checkpoint['optimizer'] = optimizer.state_dict() + torch.save(checkpoint, "saved.pth") + """ + state_dict = {} + state_dict['loss_scaler'] = self.loss_scaler + state_dict['dynamic_loss_scale'] = self.dynamic_loss_scale + state_dict['overflow'] = self.overflow + state_dict['first_closure_call_this_step'] = self.first_closure_call_this_step + state_dict['optimizer_state_dict'] = self.optimizer.state_dict() + state_dict['fp32_from_fp16'] = self.fp32_from_fp16_groups + return state_dict + + def load_state_dict(self, state_dict): + """ + Loads a state_dict created by an earlier call to state_dict(). + If ``fp16_optimizer_instance`` was constructed from some ``init_optimizer``, + whose parameters in turn came from ``model``, it is expected that the user + will call ``model.load_state_dict()`` before + ``fp16_optimizer_instance.load_state_dict()`` is called. + + Example:: + + model = torch.nn.Linear(D_in, D_out).cuda().half() + optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + optimizer = FP16_Optimizer(optimizer, static_loss_scale = 128.0) + ... + checkpoint = torch.load("saved.pth") + model.load_state_dict(checkpoint['model']) + optimizer.load_state_dict(checkpoint['optimizer']) + """ + # I think it should actually be ok to reload the optimizer before the model. + self.loss_scaler = state_dict['loss_scaler'] + self.dynamic_loss_scale = state_dict['dynamic_loss_scale'] + self.overflow = state_dict['overflow'] + self.first_closure_call_this_step = state_dict['first_closure_call_this_step'] + self.optimizer.load_state_dict(state_dict['optimizer_state_dict']) + # At this point, the optimizer's references to the model's fp32 parameters are up to date. + # The optimizer's hyperparameters and internal buffers are also up to date. + # However, the fp32 master copies of the model's fp16 params stored by the optimizer are still + # out of date. There are two options. + # 1: Refresh the master params from the model's fp16 params. + # This requires less storage but incurs precision loss. + # 2: Save and restore the fp32 master copies separately. + # We choose option 2. + # + # Pytorch Optimizer.load_state_dict casts saved buffers (e.g. momentum) to the type and device + # of their associated parameters, because it's possible those buffers might not exist yet in + # the current optimizer instance. In our case, as long as the current FP16_Optimizer has been + # constructed in the same way as the one whose state_dict we are loading, the same master params + # are guaranteed to exist, so we can just copy_() from the saved master params. + for current_group, saved_group in zip(self.fp32_from_fp16_groups, state_dict['fp32_from_fp16']): + for current, saved in zip(current_group, saved_group): + current.data.copy_(saved.data) + + def step(self, closure=None): # could add clip option. + """ + If no closure is supplied, :attr:`step` should be called after + ``fp16_optimizer_obj.backward(loss)``. + :attr:`step` updates the fp32 master copy of parameters using the optimizer supplied to + :class:`FP16_Optimizer`'s constructor, then copies the updated fp32 params into the fp16 params + originally referenced by :class:`FP16_Optimizer`'s constructor, so the user may immediately run + another forward pass using their model. + + If a closure is supplied, :attr:`step` may be called without a prior call to + :attr:`backward(loss)`. + This control flow is identical to `ordinary Pytorch optimizer use`_ with closures. + However, the user should take care that any ``loss.backward()`` call within the closure + has been replaced by ``fp16_optimizer_obj.backward(loss)``. + + Args: + closure (optional): Closure that will be supplied to the underlying optimizer originally passed to :class:`FP16_Optimizer`'s constructor. closure should call :attr:`zero_grad()` on the :class:`FP16_Optimizer` object, compute the loss, call :attr:`backward(loss)`, and return the loss. + + Example with closure:: + + # optimizer is assumed to be an FP16_Optimizer object, previously constructed from an + # existing pytorch optimizer. + for input, target in dataset: + def closure(): + optimizer.zero_grad() + output = model(input) + loss = loss_fn(output, target) + # loss.backward() becomes: + optimizer.backward(loss) + return loss + optimizer.step(closure) + + .. warning:: + Currently, calling :attr:`step` with a closure is not compatible with dynamic loss scaling. + + .. _`ordinary Pytorch optimizer use`: + http://pytorch.org/docs/master/optim.html#optimizer-step-closure + """ + + scale = self.loss_scaler.loss_scale() + # To consider: Should this be in step(), or update_master_grads? It works either way, + # but I should make it consistent with the Amp control flow, which updates the scale + # during backward context manager exit. + # self._update_scale(self.overflow) + + if self.overflow: + # Using _amp_state.maybe_print instead of self.print here is intentional. + maybe_print("Gradient overflow. Skipping step, reducing " + + "loss scale to {}".format(self.loss_scaler.loss_scale())) + return + + if closure is not None: + retval = self._step_with_closure(closure) + else: + # torch.cuda.nvtx.range_push("pytorch optimizer step") + retval = self.optimizer.step() + # torch.cuda.nvtx.range_pop() + + self._master_params_to_model_params() + + return retval + + def _step_with_closure(self, closure): + def wrapped_closure(): + # helpful for debugging + # print("Calling wrapped_closure, first_closure_call_this_step = {}" + # .format(self.first_closure_call_this_step)) + if self.first_closure_call_this_step: + # We expect that the fp16 params are initially fresh on entering self.step(), + # so _master_params_to_model_params() is unnecessary the first time wrapped_closure() + # is called within self.optimizer.step(). + self.first_closure_call_this_step = False + else: + # If self.optimizer.step() internally calls wrapped_closure more than once, + # it may update the fp32 params after each call. However, self.optimizer + # doesn't know about the fp16 params at all. If the fp32 params get updated, + # we can't rely on self.optimizer to refresh the fp16 params. We need + # to handle that manually: + self._master_params_to_model_params() + # Our API expects the user to give us ownership of the backward() call by + # replacing all calls to loss.backward() with optimizer.backward(loss). + # This requirement holds whether or not the call to backward() is made within a closure. + # If the user is properly calling optimizer.backward(loss) within "closure," + # calling closure() here will give the fp32 master params fresh gradients + # for the optimizer to play with, so all wrapped_closure needs to do is call + # closure() and return the loss. + temp_loss = closure() + while(self.overflow): + scale = self.loss_scaler.loss_scale() + # self._update_scale(self.overflow) # now done at the end of backward + print("OVERFLOW within closure! Skipping step, reducing loss scale to {}".format( + self.loss_scaler.loss_scale())) + temp_loss = closure() + return temp_loss + + retval = self.optimizer.step(wrapped_closure) + + self.first_closure_call_this_step = True + + return retval + + def backward(self, loss, update_master_grads=True, retain_graph=False): + """ + :attr:`backward` performs the following conceptual steps: + + 1. fp32_loss = loss.float() (see first Note below) + 2. scaled_loss = fp32_loss*loss_scale + 3. scaled_loss.backward(), which accumulates scaled gradients into the ``.grad`` attributes of the model's leaves (which may be fp16, fp32, or a mixture, depending how your model was defined). + 4. fp16 grads are then copied to the master params' ``.grad`` attributes (see second Note), which are guaranteed to be fp32. + 5. Finally, master grads are divided by loss_scale. + + In this way, after :attr:`backward`, the master params have fresh gradients, + and :attr:`step` may be called. + + .. note:: + :attr:`backward` internally converts the loss to fp32 before applying the loss scale. + This provides some additional safety against overflow if the user has supplied an + fp16 loss value. + However, for maximum overflow safety, the user should + compute the loss criterion (MSE, cross entropy, etc) in fp32 before supplying it to + :attr:`backward`. + + .. warning:: + The gradients found in a model's leaves after the call to + :attr:`backward` should not be regarded as valid in general, + because it's possible + they have been scaled (and in the case of dynamic loss scaling, + the scale factor may change over time). + If the user wants to inspect gradients after a call to :attr:`backward`, + only the master gradients should be regarded as valid. These can be retrieved via + :attr:`inspect_master_grad_data()`. + + Args: + loss: The loss output by the user's model. loss may be either float or half (but see first Note above). + update_master_grads (bool, optional, default=True): Option to copy fp16 grads to fp32 grads on this call. By setting this to False, the user can delay the copy, which is useful to eliminate redundant fp16->fp32 grad copies if :attr:`backward` is being called on multiple losses in one iteration. If set to False, the user becomes responsible for calling :attr:`update_master_grads` before calling :attr:`step`. + retain_graph (bool, optional, default=False): Forwards the usual ``retain_graph=True`` option to the internal call to ``loss.backward``. If ``retain_graph`` is being used to accumulate gradient values from multiple backward passes before calling ``optimizer.step``, passing ``update_master_grads=False`` is also recommended (see Example below). + + Example:: + + # Ordinary operation: + optimizer.backward(loss) + + # Naive operation with multiple losses (technically valid, but less efficient): + # fp32 grads will be correct after the second call, but + # the first call incurs an unnecessary fp16->fp32 grad copy. + optimizer.backward(loss1) + optimizer.backward(loss2) + + # More efficient way to handle multiple losses: + # The fp16->fp32 grad copy is delayed until fp16 grads from all + # losses have been accumulated. + optimizer.backward(loss1, update_master_grads=False) + optimizer.backward(loss2, update_master_grads=False) + optimizer.update_master_grads() + """ + # To consider: try multiple backward passes using retain_grad=True to find + # a loss scale that works. After you find a loss scale that works, do a final dummy + # backward pass with retain_graph=False to tear down the graph. Doing this would avoid + # discarding the iteration, but probably wouldn't improve overall efficiency. + scaled_loss = loss.float()*self.loss_scaler.loss_scale() + scaled_loss.backward(retain_graph=retain_graph) + if update_master_grads: + self.update_master_grads() + + def update_master_grads(self): + # torch.cuda.nvtx.range_push("update_master_grads") + """ + Copy the ``.grad`` attribute from stored references to fp16 parameters to + the ``.grad`` attribute of the fp32 master parameters that are directly + updated by the optimizer. :attr:`update_master_grads` only needs to be called if + ``fp16_optimizer_obj.backward`` was called with ``update_master_grads=False``. + """ + # if self.dynamic_loss_scale: + # self._check_overflow() + # if self.overflow: return + # self._model_grads_to_master_grads() + # self._downscale_master() + # Use the one-shot multi-tensor apply kernel + self.loss_scaler.clear_overflow_state() + if len(self.all_fp16_params) > 0: + # print("Model grads before") + # print([param.grad.data for param in self.all_fp16_params]) + # I'm ONLY writing this as an incremental way to make some tests pass until + # I can refactor the tests as well. + # FP16_Optimizer should not be used by anyone. + model_grads = [] + master_grads = [] + for model_param, master_param in zip(self.all_fp16_params, + self.all_fp32_from_fp16_params): + if model_param.grad is not None: + model_grads.append(model_param.grad) + if master_param.grad is None: + master_param.grad = torch.empty_like(master_param) + master_grads.append(master_param.grad) + self.loss_scaler.unscale( + model_grads, + master_grads, + self.loss_scaler.loss_scale()) + # print("Master grads after") + # print([param.grad.data for param in self.all_fp32_from_fp16_params]) + if len(self.all_fp32_from_fp32_params) > 0: + model_grads = [] + master_grads = [] + for model_param, master_param in zip(self.all_fp32_from_fp32_params, + self.all_fp32_from_fp32_params): + if model_param.grad is not None: + model_grads.append(model_param.grad) + master_grads.append(master_param.grad) + # print("Model grads before") + # print([param.grad.data for param in self.all_fp32_from_fp32_params]) + self.loss_scaler.unscale( + model_grads, + master_grads, + self.loss_scaler.loss_scale()) + # print("Master grads after") + # print([param.grad.data for param in self.all_fp32_from_fp32_params]) + # quit() + self.overflow = self.loss_scaler.update_scale() + # torch.cuda.nvtx.range_pop() + + + def inspect_master_grad_data(self): + """ + When running with :class:`FP16_Optimizer`, + ``.grad`` attributes of a model's fp16 leaves should not be + regarded as truthful, because they might be scaled. + After a call to :attr:`fp16_optimizer_obj.backward(loss)`, if no overflow was encountered, + the fp32 master params' ``.grad`` + attributes will contain valid gradients properly divided by the loss scale. However, + because :class:`FP16_Optimizer` flattens some parameters, accessing them may be + nonintuitive. :attr:`inspect_master_grad_data` + allows those gradients to be viewed with shapes corresponding to their associated model leaves. + + Returns: + List of lists (one list for each parameter group). The list for each parameter group + is a list of the ``.grad.data`` attributes of the fp32 master params belonging to that group. + """ + if self.overflow: + print("Warning: calling FP16_Optimizer.inspect_master_grad_data while in an overflow state. " + "Gradients are currently invalid (may be inf, nan, or stale). Returning None.") + return None + else: + # The optimizer owns only references to master params. + master_grads_data = [] + for param_group in self.optimizer.param_groups: + master_grads_this_group = [] + for param in param_group['params']: + if param.grad is not None: + master_grads_this_group.append(param.grad.data) + else: + master_grads_this_group.append(None) + master_grads_data.append(master_grads_this_group) + return master_grads_data + + + # Promote loss scale so it can be retrieved or set via "fp16_optimizer_instance.loss_scale" + def _get_loss_scale(self): + return self.loss_scaler.loss_scale() + + def _set_loss_scale(self, value): + self.loss_scaler._loss_scale = value + + loss_scale = property(_get_loss_scale, _set_loss_scale) + + # Promote state so it can be retrieved or set via "fp16_optimizer_instance.state" + def _get_state(self): + return self.optimizer.state + + def _set_state(self, value): + self.optimizer.state = value + + state = property(_get_state, _set_state) + + # Promote param_groups so it can be retrieved or set via "fp16_optimizer_instance.param_groups" + # (for example, to adjust the learning rate) + def _get_param_groups(self): + return self.optimizer.param_groups + + def _set_param_groups(self, value): + self.optimizer.param_groups = value + + param_groups = property(_get_param_groups, _set_param_groups) + diff --git a/apex/apex/fp16_utils/fp16util.py b/apex/apex/fp16_utils/fp16util.py new file mode 100644 index 0000000000000000000000000000000000000000..dcdc3447a4cf70b7379de6c7fe4585175f94f0b8 --- /dev/null +++ b/apex/apex/fp16_utils/fp16util.py @@ -0,0 +1,187 @@ +import torch +import torch.nn as nn +from torch.autograd import Variable +from torch._utils import _flatten_dense_tensors, _unflatten_dense_tensors + + +class tofp16(nn.Module): + """ + Utility module that implements:: + + def forward(self, input): + return input.half() + """ + + def __init__(self): + super(tofp16, self).__init__() + + def forward(self, input): + return input.half() + + +def BN_convert_float(module): + """ + Utility function for network_to_half(). + + Retained for legacy purposes. + """ + if isinstance(module, torch.nn.modules.batchnorm._BatchNorm) and module.affine is True: + module.float() + for child in module.children(): + BN_convert_float(child) + return module + + +def network_to_half(network): + """ + Convert model to half precision in a batchnorm-safe way. + + Retained for legacy purposes. It is recommended to use FP16Model. + """ + return nn.Sequential(tofp16(), BN_convert_float(network.half())) + + +def convert_module(module, dtype): + """ + Converts a module's immediate parameters and buffers to dtype. + """ + for param in module.parameters(recurse=False): + if param is not None: + if param.data.dtype.is_floating_point: + param.data = param.data.to(dtype=dtype) + if param._grad is not None and param._grad.data.dtype.is_floating_point: + param._grad.data = param._grad.data.to(dtype=dtype) + + for buf in module.buffers(recurse=False): + if buf is not None and buf.data.dtype.is_floating_point: + buf.data = buf.data.to(dtype=dtype) + + +def convert_network(network, dtype): + """ + Converts a network's parameters and buffers to dtype. + """ + for module in network.modules(): + if isinstance(module, torch.nn.modules.batchnorm._BatchNorm) and module.affine is True: + continue + convert_module(module, dtype) + if isinstance(module, torch.nn.RNNBase) or isinstance(module, torch.nn.modules.rnn.RNNBase): + module.flatten_parameters() + return network + + +class FP16Model(nn.Module): + """ + Convert model to half precision in a batchnorm-safe way. + """ + + def __init__(self, network): + super(FP16Model, self).__init__() + self.network = convert_network(network, dtype=torch.half) + + def forward(self, *inputs): + inputs = tuple(t.half() for t in inputs) + return self.network(*inputs) + + +def backwards_debug_hook(grad): + raise RuntimeError("master_params recieved a gradient in the backward pass!") + +def prep_param_lists(model, flat_master=False): + """ + Creates a list of FP32 master parameters for a given model, as in + `Training Neural Networks with Mixed Precision: Real Examples`_. + + Args: + model (torch.nn.Module): Existing Pytorch model + flat_master (bool, optional, default=False): Flatten the master parameters into a single tensor, as a performance optimization. + Returns: + A tuple (``model_params``, ``master_params``). ``model_params`` is a list of the model's parameters for later use with :func:`model_grads_to_master_grads` and :func:`master_params_to_model_params`. ``master_params`` is a list of FP32 master gradients. If ``flat_master=True``, ``master_params`` will be a list with one element. + + Example:: + + model_params, master_params = prep_param_lists(model) + + .. warning:: + Currently, if ``flat_master=True``, all the model's parameters must be the same type. If the model has parameters of different types, use ``flat_master=False``, or use :class:`FP16_Optimizer`. + + .. _`Training Neural Networks with Mixed Precision: Real Examples`: + http://on-demand.gputechconf.com/gtc/2018/video/S81012/ + """ + model_params = [param for param in model.parameters() if param.requires_grad] + + if flat_master: + # Give the user some more useful error messages + try: + # flatten_dense_tensors returns a contiguous flat array. + # http://pytorch.org/docs/master/_modules/torch/_utils.html + master_params = _flatten_dense_tensors([param.data for param in model_params]).float() + except: + print("Error in prep_param_lists: model may contain a mixture of parameters " + "of different types. Use flat_master=False, or use F16_Optimizer.") + raise + master_params = torch.nn.Parameter(master_params) + master_params.requires_grad = True + # master_params.register_hook(backwards_debug_hook) + if master_params.grad is None: + master_params.grad = master_params.new(*master_params.size()) + return model_params, [master_params] + else: + master_params = [param.clone().float().detach() for param in model_params] + for param in master_params: + param.requires_grad = True + return model_params, master_params + + +def model_grads_to_master_grads(model_params, master_params, flat_master=False): + """ + Copy model gradients to master gradients. + + Args: + model_params: List of model parameters created by :func:`prep_param_lists`. + master_params: List of FP32 master parameters created by :func:`prep_param_lists`. If ``master_params`` was created with ``flat_master=True``, ``flat_master=True`` should also be supplied to :func:`model_grads_to_master_grads`. + """ + if flat_master: + # The flattening may incur one more deep copy than is necessary. + master_params[0].grad.data.copy_( + _flatten_dense_tensors([p.grad.data for p in model_params])) + else: + for model, master in zip(model_params, master_params): + if model.grad is not None: + if master.grad is None: + master.grad = Variable(master.data.new(*master.data.size())) + master.grad.data.copy_(model.grad.data) + else: + master.grad = None + + +def master_params_to_model_params(model_params, master_params, flat_master=False): + """ + Copy master parameters to model parameters. + + Args: + model_params: List of model parameters created by :func:`prep_param_lists`. + master_params: List of FP32 master parameters created by :func:`prep_param_lists`. If ``master_params`` was created with ``flat_master=True``, ``flat_master=True`` should also be supplied to :func:`master_params_to_model_params`. + """ + if flat_master: + for model, master in zip(model_params, + _unflatten_dense_tensors(master_params[0].data, model_params)): + model.data.copy_(master) + else: + for model, master in zip(model_params, master_params): + model.data.copy_(master.data) + +# Backward compatibility fixes + +def to_python_float(t): + if hasattr(t, 'item'): + return t.item() + else: + return t[0] + +TORCH_MAJOR = int(torch.__version__.split('.')[0]) +TORCH_MINOR = int(torch.__version__.split('.')[1]) +if TORCH_MAJOR == 0 and TORCH_MINOR <= 4: + clip_grad_norm = torch.nn.utils.clip_grad_norm +else: + clip_grad_norm = torch.nn.utils.clip_grad_norm_ diff --git a/apex/apex/fp16_utils/loss_scaler.py b/apex/apex/fp16_utils/loss_scaler.py new file mode 100644 index 0000000000000000000000000000000000000000..b9f32fe01fb1a52f2436d10dc353fcf68256eb0c --- /dev/null +++ b/apex/apex/fp16_utils/loss_scaler.py @@ -0,0 +1,186 @@ +import torch + +# item() is a recent addition, so this helps with backward compatibility. +def to_python_float(t): + if hasattr(t, 'item'): + return t.item() + else: + return t[0] + +class LossScaler: + """ + Class that manages a static loss scale. This class is intended to interact with + :class:`FP16_Optimizer`, and should not be directly manipulated by the user. + + Use of :class:`LossScaler` is enabled via the ``static_loss_scale`` argument to + :class:`FP16_Optimizer`'s constructor. + + Args: + scale (float, optional, default=1.0): The loss scale. + """ + + def __init__(self, scale=1): + self.cur_scale = scale + + # `params` is a list / generator of torch.Variable + def has_overflow(self, params): + return False + + # `x` is a torch.Tensor + def _has_inf_or_nan(x): + return False + + def update_scale(self, overflow): + pass + + @property + def loss_scale(self): + return self.cur_scale + + def scale_gradient(self, module, grad_in, grad_out): + return tuple(self.loss_scale * g for g in grad_in) + + def backward(self, loss, retain_graph=False): + scaled_loss = loss*self.loss_scale + scaled_loss.backward(retain_graph=retain_graph) + +class DynamicLossScaler: + """ + Class that manages dynamic loss scaling. It is recommended to use :class:`DynamicLossScaler` + indirectly, by supplying ``dynamic_loss_scale=True`` to the constructor of + :class:`FP16_Optimizer`. However, it's important to understand how :class:`DynamicLossScaler` + operates, because the default options can be changed using the + the ``dynamic_loss_args`` argument to :class:`FP16_Optimizer`'s constructor. + + Loss scaling is designed to combat the problem of underflowing gradients encountered at long + times when training fp16 networks. Dynamic loss scaling begins by attempting a very high loss + scale. Ironically, this may result in OVERflowing gradients. If overflowing gradients are + encountered, :class:`DynamicLossScaler` informs :class:`FP16_Optimizer` that an overflow has + occurred. + :class:`FP16_Optimizer` then skips the update step for this particular iteration/minibatch, + and :class:`DynamicLossScaler` adjusts the loss scale to a lower value. + If a certain number of iterations occur without overflowing gradients detected, + :class:`DynamicLossScaler` increases the loss scale once more. + In this way :class:`DynamicLossScaler` attempts to "ride the edge" of + always using the highest loss scale possible without incurring overflow. + + Args: + init_scale (float, optional, default=2**32): Initial loss scale attempted by :class:`DynamicLossScaler.` + scale_factor (float, optional, default=2.0): Factor used when adjusting the loss scale. If an overflow is encountered, the loss scale is readjusted to loss scale/``scale_factor``. If ``scale_window`` consecutive iterations take place without an overflow, the loss scale is readjusted to loss_scale*``scale_factor``. + scale_window (int, optional, default=1000): Number of consecutive iterations without an overflow to wait before increasing the loss scale. + """ + + def __init__(self, + init_scale=2**32, + scale_factor=2., + scale_window=1000): + self.cur_scale = init_scale + self.cur_iter = 0 + self.last_overflow_iter = -1 + self.scale_factor = scale_factor + self.scale_window = scale_window + + # `params` is a list / generator of torch.Variable + def has_overflow(self, params): + for p in params: + if p.grad is not None and DynamicLossScaler._has_inf_or_nan(p.grad.data): + return True + + return False + + # `x` is a torch.Tensor + def _has_inf_or_nan(x): + try: + # if x is half, the .float() incurs an additional deep copy, but it's necessary if + # Pytorch's .sum() creates a one-element tensor of the same type as x + # (which is true for some recent version of pytorch). + cpu_sum = float(x.float().sum()) + # More efficient version that can be used if .sum() returns a Python scalar + # cpu_sum = float(x.sum()) + except RuntimeError as instance: + # We want to check if inst is actually an overflow exception. + # RuntimeError could come from a different error. + # If so, we still want the exception to propagate. + if "value cannot be converted" not in instance.args[0]: + raise + return True + else: + if cpu_sum == float('inf') or cpu_sum == -float('inf') or cpu_sum != cpu_sum: + return True + return False + + # `overflow` is boolean indicating whether the gradient overflowed + def update_scale(self, overflow): + if overflow: + # self.cur_scale /= self.scale_factor + self.cur_scale = max(self.cur_scale/self.scale_factor, 1) + self.last_overflow_iter = self.cur_iter + else: + if (self.cur_iter - self.last_overflow_iter) % self.scale_window == 0: + self.cur_scale *= self.scale_factor + self.cur_iter += 1 + + @property + def loss_scale(self): + return self.cur_scale + + def scale_gradient(self, module, grad_in, grad_out): + return tuple(self.loss_scale * g for g in grad_in) + + def backward(self, loss, retain_graph=False): + scaled_loss = loss*self.loss_scale + scaled_loss.backward(retain_graph=retain_graph) + +############################################################## +# Example usage below here -- assuming it's in a separate file +############################################################## +""" +TO-DO separate out into an example. +if __name__ == "__main__": + import torch + from torch.autograd import Variable + from dynamic_loss_scaler import DynamicLossScaler + + # N is batch size; D_in is input dimension; + # H is hidden dimension; D_out is output dimension. + N, D_in, H, D_out = 64, 1000, 100, 10 + + # Create random Tensors to hold inputs and outputs, and wrap them in Variables. + x = Variable(torch.randn(N, D_in), requires_grad=False) + y = Variable(torch.randn(N, D_out), requires_grad=False) + + w1 = Variable(torch.randn(D_in, H), requires_grad=True) + w2 = Variable(torch.randn(H, D_out), requires_grad=True) + parameters = [w1, w2] + + learning_rate = 1e-6 + optimizer = torch.optim.SGD(parameters, lr=learning_rate) + loss_scaler = DynamicLossScaler() + + for t in range(500): + y_pred = x.mm(w1).clamp(min=0).mm(w2) + loss = (y_pred - y).pow(2).sum() * loss_scaler.loss_scale + print('Iter {} loss scale: {}'.format(t, loss_scaler.loss_scale)) + print('Iter {} scaled loss: {}'.format(t, loss.data[0])) + print('Iter {} unscaled loss: {}'.format(t, loss.data[0] / loss_scaler.loss_scale)) + + # Run backprop + optimizer.zero_grad() + loss.backward() + + # Check for overflow + has_overflow = DynamicLossScaler.has_overflow(parameters) + + # If no overflow, unscale grad and update as usual + if not has_overflow: + for param in parameters: + param.grad.data.mul_(1. / loss_scaler.loss_scale) + optimizer.step() + # Otherwise, don't do anything -- ie, skip iteration + else: + print('OVERFLOW!') + + # Update loss scale for next iteration + loss_scaler.update_scale(has_overflow) + +""" diff --git a/apex/apex/mlp/__init__.py b/apex/apex/mlp/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..f2f30f7d1367006c9f089cba52e0a9c23233475d --- /dev/null +++ b/apex/apex/mlp/__init__.py @@ -0,0 +1 @@ +from .mlp import * diff --git a/apex/apex/mlp/mlp.py b/apex/apex/mlp/mlp.py new file mode 100644 index 0000000000000000000000000000000000000000..bae38f3f890ef8c7dbfa4fa6af8eaa731e7411aa --- /dev/null +++ b/apex/apex/mlp/mlp.py @@ -0,0 +1,79 @@ +from copy import copy +import math +import torch +from torch import nn +import mlp_cuda +from .. import amp + +class MlpFunction(torch.autograd.Function): + @staticmethod + def forward(ctx, bias, activation, *args): + output = mlp_cuda.forward(bias, activation, args) + ctx.save_for_backward(*args) + ctx.outputs = output + ctx.bias = bias + ctx.activation = activation + return output[0] + + @staticmethod + def backward(ctx, grad_o): + grads = mlp_cuda.backward(ctx.bias, ctx.activation, grad_o, ctx.outputs, ctx.saved_tensors) + del ctx.outputs + return (None, None, *grads) + +mlp_function = amp.half_function(MlpFunction.apply) + +class MLP(torch.nn.Module): + """Launch MLP in C++ + + Args: + mlp_sizes (list of int): MLP sizes. Example: [1024,1024,1024] will create 2 MLP layers with shape 1024x1024 + bias (bool): Default True: + relu (bool): Default True + """ + def __init__(self, mlp_sizes, bias=True, activation='relu'): + super(MLP, self).__init__() + self.num_layers = len(mlp_sizes) - 1 + self.mlp_sizes = copy(mlp_sizes) + self.bias = 1 if bias else 0 + + if activation is 'none': + self.activation = 0 + elif activation is 'relu': + self.activation = 1 + elif activation is 'sigmoid': + self.activation = 2 + else: + raise TypeError("activation must be relu or none.") + + self.weights = [] + self.biases = [] + for i in range(self.num_layers): + w = torch.nn.Parameter(torch.empty(mlp_sizes[i+1], mlp_sizes[i])) + self.weights.append(w) + name = 'weight_{}'.format(i) + setattr(self, name, w) + if self.bias: + b = torch.nn.Parameter(torch.empty(mlp_sizes[i+1])) + self.biases.append(b) + name = 'bias_{}'.format(i) + setattr(self, name, b) + + self.reset_parameters() + + def reset_parameters(self): + for weight in self.weights: + dimsum = weight.size(0) + weight.size(1) + std = math.sqrt(2. / float(dimsum)) + nn.init.normal_(weight, 0., std) + if self.bias: + for bias in self.biases: + std = math.sqrt(1. / float(bias.size(0))) + nn.init.normal_(bias, 0., std) + + def forward(self, input): + return mlp_function(self.bias, self.activation, input, *self.weights, *self.biases) + + def extra_repr(self): + s = F"MLP sizes: {self.mlp_sizes}, Bias={self.bias}, activation={self.activation}" + return s diff --git a/apex/apex/multi_tensor_apply/__init__.py b/apex/apex/multi_tensor_apply/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..0a80e3c545276c30c9c6c7ab74739c11ff1deeb2 --- /dev/null +++ b/apex/apex/multi_tensor_apply/__init__.py @@ -0,0 +1,4 @@ +from .multi_tensor_apply import MultiTensorApply + +multi_tensor_applier = MultiTensorApply(2048*32) + diff --git a/apex/apex/multi_tensor_apply/multi_tensor_apply.py b/apex/apex/multi_tensor_apply/multi_tensor_apply.py new file mode 100644 index 0000000000000000000000000000000000000000..346c6e50fb31ea28e16bdb7ef8115da2324c3359 --- /dev/null +++ b/apex/apex/multi_tensor_apply/multi_tensor_apply.py @@ -0,0 +1,30 @@ +import torch + +class MultiTensorApply(object): + available = False + warned = False + + def __init__(self, chunk_size): + try: + import amp_C + MultiTensorApply.available = True + self.chunk_size = chunk_size + except ImportError as err: + MultiTensorApply.available = False + MultiTensorApply.import_err = err + + def check_avail(self): + if MultiTensorApply.available == False: + raise RuntimeError( + "Attempted to call MultiTensorApply method, but MultiTensorApply " + "is not available, possibly because Apex was installed without " + "--cpp_ext --cuda_ext. Original import error message:", + MultiTensorApply.import_err) + + def __call__(self, op, noop_flag_buffer, tensor_lists, *args): + self.check_avail() + + return op(self.chunk_size, + noop_flag_buffer, + tensor_lists, + *args) diff --git a/apex/apex/normalization/__init__.py b/apex/apex/normalization/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..b798883b3c24964c54def1caea0021b8ecf6ef32 --- /dev/null +++ b/apex/apex/normalization/__init__.py @@ -0,0 +1 @@ +from .fused_layer_norm import FusedLayerNorm diff --git a/apex/apex/normalization/fused_layer_norm.py b/apex/apex/normalization/fused_layer_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..c5b3b49ca24d683d0fbd4a720e7a8a0455314b85 --- /dev/null +++ b/apex/apex/normalization/fused_layer_norm.py @@ -0,0 +1,165 @@ +import math +import torch +import numbers +from torch.nn.parameter import Parameter +from torch.nn import init +from torch.nn import functional as F +import importlib + +global fused_layer_norm_cuda +fused_layer_norm_cuda = None + +class FusedLayerNormAffineFunction(torch.autograd.Function): + + @staticmethod + def forward(ctx, input, weight, bias, normalized_shape, eps): + global fused_layer_norm_cuda + if fused_layer_norm_cuda is None: + fused_layer_norm_cuda = importlib.import_module("fused_layer_norm_cuda") + ctx.normalized_shape = normalized_shape + ctx.eps = eps + input_ = input.contiguous() + weight_ = weight.contiguous() + bias_ = bias.contiguous() + output, mean, invvar = fused_layer_norm_cuda.forward_affine( + input_, ctx.normalized_shape, weight_, bias_, ctx.eps) + ctx.save_for_backward(input_, weight_, bias_, mean, invvar) + return output + + @staticmethod + def backward(ctx, grad_output): + input_, weight_, bias_, mean, invvar = ctx.saved_tensors + grad_input = grad_weight = grad_bias = None + grad_input, grad_weight, grad_bias = fused_layer_norm_cuda.backward_affine( + grad_output.contiguous(), mean, invvar, + input_, ctx.normalized_shape, + weight_, bias_, ctx.eps) + return grad_input, grad_weight, grad_bias, None, None + +class FusedLayerNormFunction(torch.autograd.Function): + + @staticmethod + def forward(ctx, input, normalized_shape, eps): + global fused_layer_norm_cuda + if fused_layer_norm_cuda is None: + fused_layer_norm_cuda = importlib.import_module("fused_layer_norm_cuda") + ctx.normalized_shape = normalized_shape + ctx.eps = eps + input_ = input.contiguous() + output, mean, invvar = fused_layer_norm_cuda.forward( + input_, ctx.normalized_shape, ctx.eps) + ctx.save_for_backward(input_, mean, invvar) + return output + + @staticmethod + def backward(ctx, grad_output): + input_, mean, invvar = ctx.saved_tensors + grad_input = None + grad_input = fused_layer_norm_cuda.backward( + grad_output.contiguous(), mean, invvar, + input_, ctx.normalized_shape, + ctx.eps) + return grad_input, None, None + +def fused_layer_norm_affine(input, normalized_shape, weight, bias, eps=1e-6): + return FusedLayerNormAffineFunction.apply(input, weight, bias, normalized_shape, eps) + +def fused_layer_norm(input, normalized_shape, eps=1e-6): + return FusedLayerNormFunction.apply(input, normalized_shape, eps) + +class FusedLayerNorm(torch.nn.Module): + r"""Applies Layer Normalization over a mini-batch of inputs as described in + the paper `Layer Normalization`_ . + + Currently only runs on cuda() tensors. + + .. math:: + y = \frac{x - \mathrm{E}[x]}{ \sqrt{\mathrm{Var}[x] + \epsilon}} * \gamma + \beta + + The mean and standard-deviation are calculated separately over the last + certain number dimensions which have to be of the shape specified by + :attr:`normalized_shape`. + :math:`\gamma` and :math:`\beta` are learnable affine transform parameters of + :attr:`normalized_shape` if :attr:`elementwise_affine` is ``True``. + + .. note:: + Unlike Batch Normalization and Instance Normalization, which applies + scalar scale and bias for each entire channel/plane with the + :attr:`affine` option, Layer Normalization applies per-element scale and + bias with :attr:`elementwise_affine`. + + This layer uses statistics computed from input data in both training and + evaluation modes. + + Args: + normalized_shape (int or list or torch.Size): input shape from an expected input + of size + + .. math:: + [* \times \text{normalized}\_\text{shape}[0] \times \text{normalized}\_\text{shape}[1] + \times \ldots \times \text{normalized}\_\text{shape}[-1]] + + If a single integer is used, it is treated as a singleton list, and this module will + normalize over the last dimension which is expected to be of that specific size. + eps: a value added to the denominator for numerical stability. Default: 1e-5 + elementwise_affine: a boolean value that when set to ``True``, this module + has learnable per-element affine parameters initialized to ones (for weights) + and zeros (for biases). Default: ``True``. + + Shape: + - Input: :math:`(N, *)` + - Output: :math:`(N, *)` (same shape as input) + + Examples:: + + >>> input = torch.randn(20, 5, 10, 10) + >>> # With Learnable Parameters + >>> m = apex.normalization.FusedLayerNorm(input.size()[1:]) + >>> # Without Learnable Parameters + >>> m = apex.normalization.FusedLayerNorm(input.size()[1:], elementwise_affine=False) + >>> # Normalize over last two dimensions + >>> m = apex.normalization.FusedLayerNorm([10, 10]) + >>> # Normalize over last dimension of size 10 + >>> m = apex.normalization.FusedLayerNorm(10) + >>> # Activating the module + >>> output = m(input) + + .. _`Layer Normalization`: https://arxiv.org/abs/1607.06450 + """ + def __init__(self, normalized_shape, eps=1e-5, elementwise_affine=True): + super(FusedLayerNorm, self).__init__() + + global fused_layer_norm_cuda + fused_layer_norm_cuda = importlib.import_module("fused_layer_norm_cuda") + + if isinstance(normalized_shape, numbers.Integral): + normalized_shape = (normalized_shape,) + self.normalized_shape = torch.Size(normalized_shape) + self.eps = eps + self.elementwise_affine = elementwise_affine + if self.elementwise_affine: + self.weight = Parameter(torch.Tensor(*normalized_shape)) + self.bias = Parameter(torch.Tensor(*normalized_shape)) + else: + self.register_parameter('weight', None) + self.register_parameter('bias', None) + self.reset_parameters() + + def reset_parameters(self): + if self.elementwise_affine: + init.ones_(self.weight) + init.zeros_(self.bias) + + def forward(self, input): + if not input.is_cuda: + return F.layer_norm( + input, self.normalized_shape, self.weight, self.bias, self.eps) + if self.elementwise_affine: + return FusedLayerNormAffineFunction.apply( + input, self.weight, self.bias, self.normalized_shape,self.eps) + else: + return FusedLayerNormFunction.apply(input, self.normalized_shape, self.eps) + + def extra_repr(self): + return '{normalized_shape}, eps={eps}, ' \ + 'elementwise_affine={elementwise_affine}'.format(**self.__dict__) diff --git a/apex/apex/optimizers/__init__.py b/apex/apex/optimizers/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..52e8e274d806f72e43460657fd61677386a140a7 --- /dev/null +++ b/apex/apex/optimizers/__init__.py @@ -0,0 +1,5 @@ +from .fused_sgd import FusedSGD +from .fused_adam import FusedAdam +from .fused_novograd import FusedNovoGrad +from .fused_lamb import FusedLAMB +from .fused_adagrad import FusedAdagrad \ No newline at end of file diff --git a/apex/apex/optimizers/fused_adagrad.py b/apex/apex/optimizers/fused_adagrad.py new file mode 100644 index 0000000000000000000000000000000000000000..d72a68c5d2bc8a3cf8ab018130e0aa7023e00fc8 --- /dev/null +++ b/apex/apex/optimizers/fused_adagrad.py @@ -0,0 +1,122 @@ +import torch +from apex.multi_tensor_apply import multi_tensor_applier + + +class FusedAdagrad(torch.optim.Optimizer): + """Implements Adagrad algorithm. + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./``. + + This version of fused Adagrad implements 2 fusions. + * Fusion of the Adagrad update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.optimizers.FusedAdagrad`'s usage is identical to any ordinary Pytorch optimizer:: + opt = apex.optimizers.FusedAdagrad(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedAdagrad` may be used with or without Amp. If you wish to use :class:`FusedAdagrad` with Amp, + you may choose any ``opt_level``:: + opt = apex.optimizers.FusedAdagrad(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + In general, ``opt_level="O1"`` is recommended. + + It has been proposed in `Adaptive Subgradient Methods for Online Learning + and Stochastic Optimization`_. + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups + lr (float, optional): learning rate (default: 1e-2) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + eps (float, optional): term added to the denominator to improve + numerical stability (default: 1e-10) + adagrad_w_mode (boolean, optional): Apply L2 regularization or weight decay + True for decoupled weight decay (also known as AdamW) (default: False) + + .. _Adaptive Subgradient Methods for Online Learning and Stochastic + Optimization: http://jmlr.org/papers/v12/duchi11a.html + """ + def __init__(self, params, lr=1e-2, eps=1e-10, + weight_decay=0., set_grad_none=True, adagrad_w_mode=False): + + defaults = dict(lr=lr, eps=eps, weight_decay=weight_decay) + super(FusedAdagrad, self).__init__(params, defaults) + self.adagrad_w_mode = 1 if adagrad_w_mode else 0 + self.set_grad_none = set_grad_none + + if multi_tensor_applier.available: + import amp_C + # Skip buffer + self._dummy_overflow_buf = torch.cuda.IntTensor([0]) + self.multi_tensor_adagrad = amp_C.multi_tensor_adagrad + else: + raise RuntimeError('apex.optimizers.FusedAdagrad requires cuda extensions') + + def zero_grad(self): + if self.set_grad_none: + for group in self.param_groups: + for p in group['params']: + p.grad = None + else: + super(FusedAdagrad, self).zero_grad() + + def step(self, closure=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + for group in self.param_groups: + # create lists for multi-tensor apply + g_16, p_16, h_16 = [], [], [] + g_32, p_32, h_32 = [], [], [] + + for p in group['params']: + if p.grad is None: + continue + if p.grad.data.is_sparse: + raise RuntimeError('FusedAdagrad does not support sparse gradients') + + state = self.state[p] + # State initialization + if len(state) == 0: + # Exponential moving average of gradient values + state['sum'] = torch.zeros_like(p.data) + if p.dtype == torch.float16: + g_16.append(p.grad.data) + p_16.append(p.data) + h_16.append(state['sum']) + elif p.dtype == torch.float32: + g_32.append(p.grad.data) + p_32.append(p.data) + h_32.append(state['sum']) + else: + raise RuntimeError('FusedAdagrad only support fp16 and fp32.') + + if(len(g_16) > 0): + multi_tensor_applier(self.multi_tensor_adagrad, + self._dummy_overflow_buf, + [g_16, p_16, h_16], + group['lr'], + group['eps'], + self.adagrad_w_mode, + group['weight_decay']) + if(len(g_32) > 0): + multi_tensor_applier(self.multi_tensor_adagrad, + self._dummy_overflow_buf, + [g_32, p_32, h_32], + group['lr'], + group['eps'], + self.adagrad_w_mode, + group['weight_decay']) + + return loss \ No newline at end of file diff --git a/apex/apex/optimizers/fused_adam.py b/apex/apex/optimizers/fused_adam.py new file mode 100644 index 0000000000000000000000000000000000000000..0fceeb59ccdf875e998187f2b092ade379046639 --- /dev/null +++ b/apex/apex/optimizers/fused_adam.py @@ -0,0 +1,172 @@ +import torch +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedAdam(torch.optim.Optimizer): + + """Implements Adam algorithm. + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./``. + + This version of fused Adam implements 2 fusions. + + * Fusion of the Adam update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.optimizers.FusedAdam` may be used as a drop-in replacement for ``torch.optim.Adam``:: + + opt = apex.optimizers.FusedAdam(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedAdam` may be used with or without Amp. If you wish to use :class:`FusedAdam` with Amp, + you may choose any ``opt_level``:: + + opt = apex.optimizers.FusedAdam(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + + In general, ``opt_level="O1"`` is recommended. + + + .. warning:: + A previous version of :class:`FusedAdam` allowed a number of additional arguments to ``step``. These additional arguments + are now deprecated and unnecessary. + + Adam was been proposed in `Adam: A Method for Stochastic Optimization`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + (default: False) NOT SUPPORTED in FusedAdam! + adam_w_mode (boolean, optional): Apply L2 regularization or weight decay + True for decoupled weight decay(also known as AdamW) (default: True) + set_grad_none (bool, optional): whether set grad to None when zero_grad() + method is called. (default: True) + + .. _Adam - A Method for Stochastic Optimization: + https://arxiv.org/abs/1412.6980 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, lr=1e-3, bias_correction=True, + betas=(0.9, 0.999), eps=1e-8, adam_w_mode=True, + weight_decay=0., amsgrad=False, set_grad_none=True): + + if amsgrad: + raise RuntimeError('FusedAdam does not support the AMSGrad variant.') + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay) + super(FusedAdam, self).__init__(params, defaults) + self.adam_w_mode = 1 if adam_w_mode else 0 + self.set_grad_none = set_grad_none + if multi_tensor_applier.available: + import amp_C + # Skip buffer + self._dummy_overflow_buf = torch.cuda.IntTensor([0]) + self.multi_tensor_adam = amp_C.multi_tensor_adam + else: + raise RuntimeError('apex.optimizers.FusedAdam requires cuda extensions') + + def zero_grad(self): + if self.set_grad_none: + for group in self.param_groups: + for p in group['params']: + p.grad = None + else: + super(FusedAdam, self).zero_grad() + + def step(self, closure=None, grads=None, output_params=None, scale=None, grad_norms=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + + The remaining arguments are deprecated, and are only retained (for the moment) for error-checking purposes. + """ + if any(p is not None for p in [grads, output_params, scale, grad_norms]): + raise RuntimeError('FusedAdam has been updated. Simply initialize it identically to torch.optim.Adam, and call step() with no arguments.') + loss = None + if closure is not None: + loss = closure() + + for group in self.param_groups: + bias_correction = 1 if group['bias_correction'] else 0 + beta1, beta2 = group['betas'] + + # assume same step across group now to simplify things + # per parameter step can be easily support by making it tensor, or pass list into kernel + if 'step' in group: + group['step'] += 1 + else: + group['step'] = 1 + + # create lists for multi-tensor apply + g_16, p_16, m_16, v_16 = [], [], [], [] + g_32, p_32, m_32, v_32 = [], [], [], [] + + for p in group['params']: + if p.grad is None: + continue + if p.grad.data.is_sparse: + raise RuntimeError('FusedAdam does not support sparse gradients, please consider SparseAdam instead') + + state = self.state[p] + # State initialization + if len(state) == 0: + # Exponential moving average of gradient values + state['exp_avg'] = torch.zeros_like(p.data) + # Exponential moving average of squared gradient values + state['exp_avg_sq'] = torch.zeros_like(p.data) + + if p.dtype == torch.float16: + g_16.append(p.grad.data) + p_16.append(p.data) + m_16.append(state['exp_avg']) + v_16.append(state['exp_avg_sq']) + elif p.dtype == torch.float32: + g_32.append(p.grad.data) + p_32.append(p.data) + m_32.append(state['exp_avg']) + v_32.append(state['exp_avg_sq']) + else: + raise RuntimeError('FusedAdam only support fp16 and fp32.') + + if(len(g_16) > 0): + multi_tensor_applier(self.multi_tensor_adam, + self._dummy_overflow_buf, + [g_16, p_16, m_16, v_16], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + self.adam_w_mode, + bias_correction, + group['weight_decay']) + if(len(g_32) > 0): + multi_tensor_applier(self.multi_tensor_adam, + self._dummy_overflow_buf, + [g_32, p_32, m_32, v_32], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + self.adam_w_mode, + bias_correction, + group['weight_decay']) + + + return loss diff --git a/apex/apex/optimizers/fused_lamb.py b/apex/apex/optimizers/fused_lamb.py new file mode 100644 index 0000000000000000000000000000000000000000..854525dcfb678983a70c8b673f01c9f29216853b --- /dev/null +++ b/apex/apex/optimizers/fused_lamb.py @@ -0,0 +1,215 @@ +import torch +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedLAMB(torch.optim.Optimizer): + + """Implements LAMB algorithm. + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./``. + + This version of fused LAMB implements 2 fusions. + + * Fusion of the LAMB update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.optimizers.FusedLAMB`'s usage is identical to any ordinary Pytorch optimizer:: + + opt = apex.optimizers.FusedLAMB(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedLAMB` may be used with or without Amp. If you wish to use :class:`FusedLAMB` with Amp, + you may choose any ``opt_level``:: + + opt = apex.optimizers.FusedLAMB(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + + In general, ``opt_level="O1"`` is recommended. + + LAMB was proposed in `Large Batch Optimization for Deep Learning: Training BERT in 76 minutes`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its norm. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + NOT SUPPORTED now! (default: False) + adam_w_mode (boolean, optional): Apply L2 regularization or weight decay + True for decoupled weight decay(also known as AdamW) (default: True) + grad_averaging (bool, optional): whether apply (1-beta2) to grad when + calculating running averages of gradient. (default: True) + set_grad_none (bool, optional): whether set grad to None when zero_grad() + method is called. (default: True) + max_grad_norm (float, optional): value used to clip global grad norm + (default: 1.0) + use_nvlamb (boolean, optional): Apply adaptive learning rate to 0.0 + weight decay parameter (default: False) + + .. _Large Batch Optimization for Deep Learning - Training BERT in 76 minutes: + https://arxiv.org/abs/1904.00962 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, lr=1e-3, bias_correction=True, + betas=(0.9, 0.999), eps=1e-6, weight_decay=0.01, + amsgrad=False, adam_w_mode=True, + grad_averaging=True, set_grad_none=True, + max_grad_norm=1.0, use_nvlamb=False): + if amsgrad: + raise RuntimeError('FusedLAMB does not support the AMSGrad variant.') + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + grad_averaging=grad_averaging, + max_grad_norm=max_grad_norm) + super(FusedLAMB, self).__init__(params, defaults) + if multi_tensor_applier.available: + import amp_C + self.multi_tensor_l2norm=amp_C.multi_tensor_l2norm + # Skip buffer + self._dummy_overflow_buf = torch.tensor([0], dtype=torch.int, device=self.param_groups[0]["params"][0].device) + self.multi_tensor_lamb = amp_C.multi_tensor_lamb + else: + raise RuntimeError('apex.optimizers.FusedLAMB requires cuda extensions') + + self.adam_w_mode = 1 if adam_w_mode else 0 + self.set_grad_none = set_grad_none + self.use_nvlamb = use_nvlamb + + def zero_grad(self): + if self.set_grad_none: + for group in self.param_groups: + for p in group['params']: + p.grad = None + else: + super(FusedLAMB, self).zero_grad() + + def step(self, closure=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + # create separate grad lists for fp32 and fp16 params + g_all_32, g_all_16 = [], [] + for group in self.param_groups: + for p in group['params']: + if p.grad is None: + continue + if p.dtype == torch.float32: + g_all_32.append(p.grad.data) + elif p.dtype == torch.float16: + g_all_16.append(p.grad.data) + else: + raise RuntimeError('FusedLAMB only support fp16 and fp32.') + + device = self.param_groups[0]["params"][0].device + g_norm_32, g_norm_16 = torch.zeros(1, device=device), torch.zeros(1, device=device) + # compute grad norm for two lists + if len(g_all_32) > 0: + g_norm_32 = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [g_all_32], False)[0] + if len(g_all_16) > 0: + g_norm_16 = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [g_all_16], False)[0] + + # blend two grad norms to get global grad norm + global_grad_norm = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [[g_norm_32, g_norm_16]], + False)[0] + max_grad_norm = self.defaults['max_grad_norm'] + + for group in self.param_groups: + bias_correction = 1 if group['bias_correction'] else 0 + beta1, beta2 = group['betas'] + grad_averaging = 1 if group['grad_averaging'] else 0 + + # assume same step across group now to simplify things + # per parameter step can be easily support by making it tensor, or pass list into kernel + if 'step' in group: + group['step'] += 1 + else: + group['step'] = 1 + + # create lists for multi-tensor apply + g_16, p_16, m_16, v_16 = [], [], [], [] + g_32, p_32, m_32, v_32 = [], [], [], [] + + for p in group['params']: + if p.grad is None: + continue + if p.grad.data.is_sparse: + raise RuntimeError('FusedLAMB does not support sparse gradients, please consider SparseAdam instead') + + state = self.state[p] + # State initialization + if len(state) == 0: + # Exponential moving average of gradient values + state['exp_avg'] = torch.zeros_like(p.data) + # Exponential moving average of gradient values + state['exp_avg_sq'] = torch.zeros_like(p.data) + + if p.dtype == torch.float16: + g_16.append(p.grad.data) + p_16.append(p.data) + m_16.append(state['exp_avg']) + v_16.append(state['exp_avg_sq']) + elif p.dtype == torch.float32: + g_32.append(p.grad.data) + p_32.append(p.data) + m_32.append(state['exp_avg']) + v_32.append(state['exp_avg_sq']) + else: + raise RuntimeError('FusedLAMB only support fp16 and fp32.') + + if(len(g_16) > 0): + multi_tensor_applier(self.multi_tensor_lamb, + self._dummy_overflow_buf, + [g_16, p_16, m_16, v_16], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + bias_correction, + group['weight_decay'], + grad_averaging, + self.adam_w_mode, + global_grad_norm, + max_grad_norm, + self.use_nvlamb) + if(len(g_32) > 0): + multi_tensor_applier(self.multi_tensor_lamb, + self._dummy_overflow_buf, + [g_32, p_32, m_32, v_32], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + bias_correction, + group['weight_decay'], + grad_averaging, + self.adam_w_mode, + global_grad_norm, + max_grad_norm, + self.use_nvlamb) + + return loss diff --git a/apex/apex/optimizers/fused_novograd.py b/apex/apex/optimizers/fused_novograd.py new file mode 100644 index 0000000000000000000000000000000000000000..2820ae36c2fbe0a7f8b8b8b663b8dbd4e7e80a3c --- /dev/null +++ b/apex/apex/optimizers/fused_novograd.py @@ -0,0 +1,214 @@ +import torch +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedNovoGrad(torch.optim.Optimizer): + + """Implements NovoGrad algorithm. + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./``. + + This version of fused NovoGrad implements 2 fusions. + + * Fusion of the NovoGrad update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.optimizers.FusedNovoGrad`'s usage is identical to any Pytorch optimizer:: + + opt = apex.optimizers.FusedNovoGrad(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedNovoGrad` may be used with or without Amp. If you wish to use :class:`FusedNovoGrad` with Amp, + you may choose any ``opt_level``:: + + opt = apex.optimizers.FusedNovoGrad(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + + In general, ``opt_level="O1"`` is recommended. + + It has been proposed in `Jasper: An End-to-End Convolutional Neural Acoustic Model`_. + More info: https://nvidia.github.io/OpenSeq2Seq/html/optimizers.html#novograd + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups. + lr (float, optional): learning rate. (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its norm. (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability. (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + NOT SUPPORTED now! (default: False) + reg_inside_moment (bool, optional): whether do regularization (norm and L2) + in momentum calculation. True for include, False for not include and + only do it on update term. (default: False) + grad_averaging (bool, optional): whether apply (1-beta1) to grad when + calculating running averages of gradient. (default: True) + norm_type (int, optional): which norm to calculate for each layer. + 2 for L2 norm, and 0 for infinite norm. These 2 are only supported + type now. (default: 2) + init_zero (bool, optional): whether init norm with 0 (start averaging on + 1st step) or first step norm (start averaging on 2nd step). True for + init with 0. (default: False) + set_grad_none (bool, optional): whether set grad to None when zero_grad() + method is called. (default: True) + + .. _Jasper - An End-to-End Convolutional Neural Acoustic Model: + https://arxiv.org/abs/1904.03288 + .. _On the Convergence of Adam and Beyond: + https://openreview.net/forum?id=ryQu7f-RZ + """ + + def __init__(self, params, lr=1e-3, bias_correction=True, + betas=(0.9, 0.999), eps=1e-8, weight_decay=0., + amsgrad=False, reg_inside_moment=False, + grad_averaging=True, norm_type=2, init_zero=False, + set_grad_none=True): + if amsgrad: + raise RuntimeError('FusedNovoGrad does not support the AMSGrad variant.') + defaults = dict(lr=lr, bias_correction=bias_correction, + betas=betas, eps=eps, weight_decay=weight_decay, + grad_averaging=grad_averaging, norm_type=norm_type, + init_zero=init_zero) + super(FusedNovoGrad, self).__init__(params, defaults) + if multi_tensor_applier.available: + import amp_C + # Skip buffer + + # Creating the overflow buffer on the same device as the params tensors. + self._dummy_overflow_buf = torch.tensor([0], dtype=torch.int, device=self.param_groups[0]["params"][0].device) + self.multi_tensor_novograd = amp_C.multi_tensor_novograd + else: + raise RuntimeError('apex.optimizers.FusedNovoGrad requires cuda extensions') + + self.moment_mode = 0 if reg_inside_moment else 1 + self.set_grad_none = set_grad_none + + def zero_grad(self): + if self.set_grad_none: + for group in self.param_groups: + for p in group['params']: + p.grad = None + else: + super(FusedNovoGrad, self).zero_grad() + + def load_state_dict(self, state_dict): + super(FusedNovoGrad, self).load_state_dict(state_dict) + # in case exp_avg_sq is not on the same device as params, move it there + for group in self.param_groups: + if len(group['params']) > 0: + group['exp_avg_sq'][0] = group['exp_avg_sq'][0].to(group['params'][0].device) + group['exp_avg_sq'][1] = group['exp_avg_sq'][1].to(group['params'][0].device) + + def step(self, closure=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + for group in self.param_groups: + bias_correction = 1 if group['bias_correction'] else 0 + beta1, beta2 = group['betas'] + grad_averaging = 1 if group['grad_averaging'] else 0 + + # assume same step across group now to simplify things + # per parameter step can be easily support by making it tensor, or pass list into kernel + if 'step' in group: + group['step'] += 1 + else: + group['step'] = 1 + + # create lists for multi-tensor apply + g_16, p_16, m_16 = [], [], [] + g_32, p_32, m_32 = [], [], [] + + for p in group['params']: + if p.grad is None: + continue + if p.grad.data.is_sparse: + raise RuntimeError('FusedNovoGrad does not support sparse gradients, please consider SparseAdam instead') + + state = self.state[p] + # State initialization + if len(state) == 0: + # Exponential moving average of gradient values + state['exp_avg'] = torch.zeros_like(p.data) + + if p.dtype == torch.float16: + g_16.append(p.grad.data) + p_16.append(p.data) + m_16.append(state['exp_avg']) + elif p.dtype == torch.float32: + g_32.append(p.grad.data) + p_32.append(p.data) + m_32.append(state['exp_avg']) + else: + raise RuntimeError('FusedNovoGrad only support fp16 and fp32.') + + # we store per weight norm as one tensor for one group/precision combination + # different from optim.Adam, we store norm here(not ^2) so we can unify calculation for norm types + if 'exp_avg_sq' not in group: + group['exp_avg_sq'] = [None, None] + if group['init_zero']: + # Creating the following parameters on the same device as the params tensors. + group['exp_avg_sq'][0] = torch.cuda.FloatTensor(len(g_16), device=self.param_groups[0]["params"][0].device).contiguous().fill_(0) + group['exp_avg_sq'][1] = torch.cuda.FloatTensor(len(g_32), device=self.param_groups[0]["params"][0].device).contiguous().fill_(0) + else: # init with first step norm, so first blend have no effect + if group['norm_type'] == 0: + v_16 = [torch.max(torch.abs(g.to(torch.float32))).item() for g in g_16] + v_32 = [torch.max(torch.abs(g)).item() for g in g_32] + elif group['norm_type'] == 2: + v_16 = [torch.sum(torch.pow(g.to(torch.float32), 2)).sqrt().item() for g in g_16] + v_32 = [torch.sum(torch.pow(g, 2)).sqrt().item() for g in g_32] + else: + raise RuntimeError('FusedNovoGrad only support l2/inf norm now.') + # Creating the following parameters on the same device as the params tensors. + group['exp_avg_sq'][0] = torch.cuda.FloatTensor(v_16, device=self.param_groups[0]["params"][0].device) + group['exp_avg_sq'][1] = torch.cuda.FloatTensor(v_32, device=self.param_groups[0]["params"][0].device) + else: + assert(len(g_16) == group['exp_avg_sq'][0].numel()) + assert(len(g_32) == group['exp_avg_sq'][1].numel()) + + if(len(g_16) > 0): + multi_tensor_applier(self.multi_tensor_novograd, + self._dummy_overflow_buf, + [g_16, p_16, m_16], + group['exp_avg_sq'][0], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + bias_correction, + group['weight_decay'], + grad_averaging, + self.moment_mode, + group['norm_type']) + if(len(g_32) > 0): + multi_tensor_applier(self.multi_tensor_novograd, + self._dummy_overflow_buf, + [g_32, p_32, m_32], + group['exp_avg_sq'][1], + group['lr'], + beta1, + beta2, + group['eps'], + group['step'], + bias_correction, + group['weight_decay'], + grad_averaging, + self.moment_mode, + group['norm_type']) + + + return loss diff --git a/apex/apex/optimizers/fused_sgd.py b/apex/apex/optimizers/fused_sgd.py new file mode 100644 index 0000000000000000000000000000000000000000..e7bdcb2b96b7d6835e0ff6b834b04b754af0b818 --- /dev/null +++ b/apex/apex/optimizers/fused_sgd.py @@ -0,0 +1,227 @@ +import torch +from torch.optim.optimizer import Optimizer, required + +from apex.multi_tensor_apply import multi_tensor_applier + +class FusedSGD(Optimizer): + r"""Implements stochastic gradient descent (optionally with momentum). + + Currently GPU-only. Requires Apex to be installed via + ``pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" ./``. + + This version of fused SGD implements 2 fusions. + + * Fusion of the SGD update's elementwise operations + * A multi-tensor apply launch that batches the elementwise updates applied to all the model's parameters into one or a few kernel launches. + + :class:`apex.optimizers.FusedSGD` may be used as a drop-in replacement for ``torch.optim.SGD``:: + + opt = apex.optimizers.FusedSGD(model.parameters(), lr = ....) + ... + opt.step() + + :class:`apex.optimizers.FusedSGD` may be used with or without Amp. If you wish to use :class:`FusedSGD` with Amp, + you may choose any ``opt_level``:: + + opt = apex.optimizers.FusedSGD(model.parameters(), lr = ....) + model, opt = amp.initialize(model, opt, opt_level="O0" or "O1 or "O2") + ... + opt.step() + + In general, ``opt_level="O1"`` is recommended. + + Nesterov momentum is based on the formula from + `On the importance of initialization and momentum in deep learning`__. + + Args: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups + lr (float): learning rate + momentum (float, optional): momentum factor (default: 0) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + dampening (float, optional): dampening for momentum (default: 0) + nesterov (bool, optional): enables Nesterov momentum (default: False) + + Example: + >>> optimizer = torch.optim.SGD(model.parameters(), lr=0.1, momentum=0.9) + >>> optimizer.zero_grad() + >>> loss_fn(model(input), target).backward() + >>> optimizer.step() + + __ http://www.cs.toronto.edu/%7Ehinton/absps/momentum.pdf + + .. note:: + The implementation of SGD with Momentum/Nesterov subtly differs from + Sutskever et. al. and implementations in some other frameworks. + + Considering the specific case of Momentum, the update can be written as + + .. math:: + v = \rho * v + g \\ + p = p - lr * v + + where p, g, v and :math:`\rho` denote the parameters, gradient, + velocity, and momentum respectively. + + This is in contrast to Sutskever et. al. and + other frameworks which employ an update of the form + + .. math:: + v = \rho * v + lr * g \\ + p = p - v + + The Nesterov version is analogously modified. + """ + + def __init__(self, params, lr=required, momentum=0, dampening=0, + weight_decay=0, nesterov=False, + wd_after_momentum=False, + materialize_master_grads=True, + set_grad_none=False): + if lr is not required and lr < 0.0: + raise ValueError("Invalid learning rate: {}".format(lr)) + if momentum < 0.0: + raise ValueError("Invalid momentum value: {}".format(momentum)) + if weight_decay < 0.0: + raise ValueError("Invalid weight_decay value: {}".format(weight_decay)) + + defaults = dict(lr=lr, momentum=momentum, dampening=dampening, + weight_decay=weight_decay, nesterov=nesterov) + if nesterov and (momentum <= 0 or dampening != 0): + raise ValueError("Nesterov momentum requires a momentum and zero dampening") + super(FusedSGD, self).__init__(params, defaults) + + self.wd_after_momentum = wd_after_momentum + self.materialize_master_grads = materialize_master_grads + self.most_recent_scale = 1.0 + self.scale_set_by_backward = False + self.set_grad_none = set_grad_none + + if multi_tensor_applier.available: + import amp_C + # Skip buffer + self._dummy_overflow_buf = torch.tensor([0], dtype=torch.int, device=self.param_groups[0]["params"][0].device) + self.multi_tensor_sgd = amp_C.multi_tensor_sgd + else: + raise RuntimeError('apex.optimizers.FusedSGD requires cuda extensions') + + def __setstate__(self, state): + super(FusedSGD, self).__setstate__(state) + for group in self.param_groups: + group.setdefault('nesterov', False) + + def zero_grad(self): + if self.set_grad_none: + for group in self.param_groups: + for p in group['params']: + p.grad = None + else: + super(FusedSGD, self).zero_grad() + + def get_momentums(self, params): + momentums = [] + first_run = True + for p in params: + param_state = self.state[p] + # torch.optim.SGD initializes momentum in the main loop, we have + # to do it here, and track whether or not we've done so, so that + # momentum application can be skipped in the main kernel. + if 'momentum_buffer' not in param_state: + first_run = True + buf = param_state['momentum_buffer'] = torch.zeros_like(p.data) + momentums.append(buf) + else: + first_run = False + momentums.append(param_state['momentum_buffer']) + return momentums, first_run + + def step(self, closure=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + explicit_master_params = (hasattr(self, "_amp_stash") and + hasattr(self._amp_stash, "fp32_from_fp16_groups")) + + for gid, group in enumerate(self.param_groups): + weight_decay = group['weight_decay'] + momentum = group['momentum'] + dampening = group['dampening'] + nesterov = group['nesterov'] + + + # For each group, there are 3 possible combinations we need to consider: + # grad_type, param_to_update_type, momentum_type, requires_fp16_model_copy + # 1. fp16, fp16, fp16, No + # 2. fp32, fp32, fp32, No + # 3. fp16, fp32, fp32, Yes + + first_runs = [True, True] + + # I think a bit of code divergence in exchange for naming clarity is worthwhile + if explicit_master_params: + stash = self._amp_stash + + fp32_params = [p for p in stash.fp32_from_fp32_groups[gid] if p.grad is not None] + fp32_grads = [p.grad for p in stash.fp32_from_fp32_groups[gid] if p.grad is not None] + fp32_momentums, first_runs[1] = self.get_momentums(fp32_params) + + if self.materialize_master_grads: + fp16_model_params = [p for i, p in enumerate( + stash.fp16_groups[gid]) if stash.fp32_from_fp16_groups[gid][i].grad is not None] + fp32_from_fp16_grads = [p.grad for p in stash.fp32_from_fp16_groups[gid] if p.grad is not None] + fp32_from_fp16_params = [p for p in stash.fp32_from_fp16_groups[gid] if p.grad is not None] + fp32_from_fp16_momentums, first_runs[0] = self.get_momentums(fp32_from_fp16_params) + + fp16_set = [fp32_from_fp16_grads, fp32_from_fp16_params, + fp32_from_fp16_momentums, fp16_model_params] + else: + fp16_model_params = [p for p in stash.fp16_groups[gid] if p.grad is not None] + fp16_model_grads = [p.grad for p in stash.fp16_groups[gid] if p.grad is not None] + fp32_from_fp16_params = [p for i, p in enumerate( + stash.fp32_from_fp16_groups[gid]) if stash.fp16_groups[gid][i].grad is not None] + fp32_from_fp16_momentums, first_runs[0] = self.get_momentums(fp32_from_fp16_params) + + fp16_set = [fp16_model_grads, fp32_from_fp16_params, + fp32_from_fp16_momentums, fp16_model_params] + + launch_sets= [fp16_set, [fp32_grads, fp32_params, fp32_momentums]] + else: + fp16_params = [p for p in group['params'] if (p.dtype == torch.float16 and p.grad is not None)] + fp16_grads = [p.grad for p in group['params'] if (p.dtype == torch.float16 and p.grad is not None)] + fp16_momentums, first_runs[0] = self.get_momentums(fp16_params) + + fp32_params = [p for p in group['params'] if (p.dtype == torch.float32 and p.grad is not None)] + fp32_grads = [p.grad for p in group['params'] if (p.dtype == torch.float32 and p.grad is not None)] + fp32_momentums, first_runs[1] = self.get_momentums(fp32_params) + + launch_sets = [[fp16_grads, fp16_params, fp16_momentums], + [fp32_grads, fp32_params, fp32_momentums]] + + for s, (launch_set, first_run) in enumerate(zip(launch_sets, first_runs)): + assert len(launch_set[0]) == len(launch_set[1]) + assert len(launch_set[0]) == len(launch_set[2]) + if len(launch_set[0]) > 0: + multi_tensor_applier( + self.multi_tensor_sgd, + self._dummy_overflow_buf, + launch_set, + weight_decay, + momentum, + dampening, + group['lr'], + nesterov, + first_run, + self.wd_after_momentum, + 1.0/self.most_recent_scale) + + self.most_recent_scale = 1.0 + self.scale_set_by_backward = False + + return loss diff --git a/apex/apex/parallel/LARC.py b/apex/apex/parallel/LARC.py new file mode 100644 index 0000000000000000000000000000000000000000..4a93fcd65baea14882472ed17384e33573ae6c9a --- /dev/null +++ b/apex/apex/parallel/LARC.py @@ -0,0 +1,107 @@ +import torch +from torch import nn +from torch.nn.parameter import Parameter + +class LARC(object): + """ + :class:`LARC` is a pytorch implementation of both the scaling and clipping variants of LARC, + in which the ratio between gradient and parameter magnitudes is used to calculate an adaptive + local learning rate for each individual parameter. The algorithm is designed to improve + convergence of large batch training. + + See https://arxiv.org/abs/1708.03888 for calculation of the local learning rate. + + In practice it modifies the gradients of parameters as a proxy for modifying the learning rate + of the parameters. This design allows it to be used as a wrapper around any torch.optim Optimizer. + + ``` + model = ... + optim = torch.optim.Adam(model.parameters(), lr=...) + optim = LARC(optim) + ``` + + It can even be used in conjunction with apex.fp16_utils.FP16_optimizer. + + ``` + model = ... + optim = torch.optim.Adam(model.parameters(), lr=...) + optim = LARC(optim) + optim = apex.fp16_utils.FP16_Optimizer(optim) + ``` + + Args: + optimizer: Pytorch optimizer to wrap and modify learning rate for. + trust_coefficient: Trust coefficient for calculating the lr. See https://arxiv.org/abs/1708.03888 + clip: Decides between clipping or scaling mode of LARC. If `clip=True` the learning rate is set to `min(optimizer_lr, local_lr)` for each parameter. If `clip=False` the learning rate is set to `local_lr*optimizer_lr`. + eps: epsilon kludge to help with numerical stability while calculating adaptive_lr + """ + + def __init__(self, optimizer, trust_coefficient=0.02, clip=True, eps=1e-8): + self.optim = optimizer + self.trust_coefficient = trust_coefficient + self.eps = eps + self.clip = clip + + def __getstate__(self): + return self.optim.__getstate__() + + def __setstate__(self, state): + self.optim.__setstate__(state) + + @property + def state(self): + return self.optim.state + + def __repr__(self): + return self.optim.__repr__() + + @property + def param_groups(self): + return self.optim.param_groups + + @param_groups.setter + def param_groups(self, value): + self.optim.param_groups = value + + def state_dict(self): + return self.optim.state_dict() + + def load_state_dict(self, state_dict): + self.optim.load_state_dict(state_dict) + + def zero_grad(self): + self.optim.zero_grad() + + def add_param_group(self, param_group): + self.optim.add_param_group( param_group) + + def step(self): + with torch.no_grad(): + weight_decays = [] + for group in self.optim.param_groups: + # absorb weight decay control from optimizer + weight_decay = group['weight_decay'] if 'weight_decay' in group else 0 + weight_decays.append(weight_decay) + group['weight_decay'] = 0 + for p in group['params']: + if p.grad is None: + continue + param_norm = torch.norm(p.data) + grad_norm = torch.norm(p.grad.data) + + if param_norm != 0 and grad_norm != 0: + # calculate adaptive lr + weight decay + adaptive_lr = self.trust_coefficient * (param_norm) / (grad_norm + param_norm * weight_decay + self.eps) + + # clip learning rate for LARC + if self.clip: + # calculation of adaptive_lr so that when multiplied by lr it equals `min(adaptive_lr, lr)` + adaptive_lr = min(adaptive_lr/group['lr'], 1) + + p.grad.data += weight_decay * p.data + p.grad.data *= adaptive_lr + + self.optim.step() + # return weight decay control to optimizer + for i, group in enumerate(self.optim.param_groups): + group['weight_decay'] = weight_decays[i] diff --git a/apex/apex/parallel/README.md b/apex/apex/parallel/README.md new file mode 100644 index 0000000000000000000000000000000000000000..e7910d82f3954969b8abe4e8120142f1c579a22f --- /dev/null +++ b/apex/apex/parallel/README.md @@ -0,0 +1,66 @@ +## Distributed Data Parallel + +distributed.py contains the source code for `apex.parallel.DistributedDataParallel`, a module wrapper that enables multi-process multi-GPU data parallel training optimized for NVIDIA's NCCL communication library. + +`apex.parallel.DistributedDataParallel` achieves high performance by overlapping communication with +computation in the backward pass and bucketing smaller transfers to reduce the total number of +transfers required. + +multiproc.py contains the source code for `apex.parallel.multiproc`, a launch utility that places one process on each of the node's available GPUs. + +#### [API Documentation](https://nvidia.github.io/apex/parallel.html) + +#### [Example/Walkthrough](https://github.com/NVIDIA/apex/tree/master/examples/distributed) + +#### [Imagenet example with Mixed Precision](https://github.com/NVIDIA/apex/tree/master/examples/imagenet) + +#### [Simple example with FP16_Optimizer](https://github.com/NVIDIA/apex/tree/master/examples/FP16_Optimizer_simple/distributed_apex) + +### Synchronized Batch Normalization + +`apex.parallel.SyncBatchNorm` has similar APIs as with `torch.nn.BatchNorm*N*d`. +It reduces stats on the first (channel) dimension of the Tensor and accepts +arbitrary spatial dimensions. + +#### Installation + +Apex provides two sync BN implementation: + +1. There is the Python-only implementation, which is the default implementation +when install with `python setup.py install`. +It uses PyTorch primitive operations and distributed communication package from +`torch.distributed`. + + - _Python-only implementation requires input tensor to be of same data type as +layer_ + +2. We also provide implementation with kernels through CUDA/C++ extension with +improved performance. We are experimenting with Welford and Kahan for reduction +hoping to get better accuracy. + To use the kernel implementation, user need to install Apex with CUDA extension +enabled `python setup.py install --cuda_ext`. + + - _Custom kernel implementation supports fp16 input with fp32 layer as cudnn. +This is required to run imagenet example in fp16._ + + - _Currently kernel implementation only supports GPU._ + +#### HowTo + +1. User could use `apex.parallel.SyncBatchNorm` by building their module with +the layer explicitly. + +``` +import apex +input_t = torch.randn(3, 5, 20).cuda() +sbn = apex.parallel.SyncBatchNorm(5).cuda() +output_t = sbn(input) +``` + +2. User could also take a constructed `torch.nn.Model` and replace all its `torch.nn.BatchNorm*N*d` modules with `apex.parallel.SyncBatchNorm` through utility function `apex.parallel.convert_syncbn_model`. + +``` +# model is an instance of torch.nn.Module +import apex +sync_bn_model = apex.parallel.convert_syncbn_model(model) +``` diff --git a/apex/apex/parallel/__init__.py b/apex/apex/parallel/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..3cd7ae56e89d411703f7fae3d568535a7b252128 --- /dev/null +++ b/apex/apex/parallel/__init__.py @@ -0,0 +1,95 @@ +import torch + +if hasattr(torch.distributed, 'ReduceOp'): + ReduceOp = torch.distributed.ReduceOp +elif hasattr(torch.distributed, 'reduce_op'): + ReduceOp = torch.distributed.reduce_op +else: + ReduceOp = torch.distributed.deprecated.reduce_op + +from .distributed import DistributedDataParallel, Reducer +# This is tricky because I'd like SyncBatchNorm to be exposed the same way +# for both the cuda-enabled and python-fallback versions, and I don't want +# to suppress the error information. +try: + import syncbn + from .optimized_sync_batchnorm import SyncBatchNorm +except ImportError as err: + from .sync_batchnorm import SyncBatchNorm + SyncBatchNorm.syncbn_import_error = err + +def convert_syncbn_model(module, process_group=None, channel_last=False): + ''' + Recursively traverse module and its children to replace all instances of + ``torch.nn.modules.batchnorm._BatchNorm`` with :class:`apex.parallel.SyncBatchNorm`. + + All ``torch.nn.BatchNorm*N*d`` wrap around + ``torch.nn.modules.batchnorm._BatchNorm``, so this function lets you easily switch + to use sync BN. + + Args: + module (torch.nn.Module): input module + + Example:: + + >>> # model is an instance of torch.nn.Module + >>> import apex + >>> sync_bn_model = apex.parallel.convert_syncbn_model(model) + ''' + mod = module + if isinstance(module, torch.nn.modules.instancenorm._InstanceNorm): + return module + if isinstance(module, torch.nn.modules.batchnorm._BatchNorm): + mod = SyncBatchNorm(module.num_features, module.eps, module.momentum, module.affine, module.track_running_stats, process_group, channel_last=channel_last) + mod.running_mean = module.running_mean + mod.running_var = module.running_var + mod.num_batches_tracked = module.num_batches_tracked + if module.affine: + mod.weight.data = module.weight.data.clone().detach() + mod.bias.data = module.bias.data.clone().detach() + for name, child in module.named_children(): + mod.add_module(name, convert_syncbn_model(child, + process_group=process_group, + channel_last=channel_last)) + # TODO(jie) should I delete model explicitly? + del module + return mod + +def create_syncbn_process_group(group_size): + ''' + Creates process groups to be used for syncbn of a give ``group_size`` and returns + process group that current GPU participates in. + + ``group_size`` must divide the total number of GPUs (world_size). + + ``group_size`` of 0 would be considered as =world_size. In this case ``None`` will be returned. + + ``group_size`` of 1 would be equivalent to using non-sync bn, but will still carry the overhead. + + Args: + group_size (int): number of GPU's to collaborate for sync bn + + Example:: + + >>> # model is an instance of torch.nn.Module + >>> import apex + >>> group = apex.parallel.create_syncbn_process_group(group_size) + ''' + + if group_size==0: + return None + + world_size = torch.distributed.get_world_size() + assert(world_size >= group_size) + assert(world_size % group_size == 0) + + group=None + for group_num in (range(world_size//group_size)): + group_ids = range(group_num*group_size, (group_num+1)*group_size) + cur_group = torch.distributed.new_group(ranks=group_ids) + if (torch.distributed.get_rank()//group_size == group_num): + group = cur_group + #can not drop out and return here, every process must go through creation of all subgroups + + assert(group is not None) + return group diff --git a/apex/apex/parallel/distributed.py b/apex/apex/parallel/distributed.py new file mode 100644 index 0000000000000000000000000000000000000000..5267c834a174c35e567ca78c6260c3c76cef4847 --- /dev/null +++ b/apex/apex/parallel/distributed.py @@ -0,0 +1,639 @@ +import torch +import torch.distributed as dist +from torch.nn.modules import Module +from torch.autograd import Variable +from collections import OrderedDict +from itertools import chain +import copy +import importlib +from ..multi_tensor_apply import multi_tensor_applier + +imported_flatten_impl = False + +def import_flatten_impl(): + global flatten_impl, unflatten_impl, imported_flatten_impl + try: + import apex_C + flatten_impl = apex_C.flatten + unflatten_impl = apex_C.unflatten + except ImportError: + print("Warning: apex was installed without --cpp_ext. Falling back to Python flatten and unflatten.") + flatten_impl = torch._utils._flatten_dense_tensors + unflatten_impl = torch._utils._unflatten_dense_tensors + imported_flatten_impl = True + +def flatten(bucket): + if not imported_flatten_impl: + import_flatten_impl() + return flatten_impl(bucket) + +def unflatten(coalesced, bucket): + if not imported_flatten_impl: + import_flatten_impl() + return unflatten_impl(coalesced, bucket) + +# apply_dist_call requires that tensors in 'bucket' are all the same type. +def apply_flat_dist_call(bucket, call, extra_args=None): + + coalesced = flatten(bucket) + + if extra_args is not None: + call(coalesced, *extra_args) + else: + call(coalesced) + + if call is dist.all_reduce: + coalesced /= dist.get_world_size() + + for buf, synced in zip(bucket, unflatten(coalesced, bucket)): + buf.copy_(synced) + +def split_half_float_double(tensors): + dtypes = ["torch.cuda.HalfTensor", "torch.cuda.FloatTensor", "torch.cuda.DoubleTensor"] + buckets = [] + for i, dtype in enumerate(dtypes): + bucket = [t for t in tensors if t.type() == dtype] + if bucket: + buckets.append(bucket) + return buckets + +def split_by_type(tensors): + buckets = OrderedDict() + for tensor in tensors: + tp = tensor.type() + if tp not in buckets: + buckets[tp] = [] + buckets[tp].append(tensor) + return buckets + +# flat_dist_call organizes 'tensors' by type. +def flat_dist_call(tensors, call, extra_args=None): + buckets = split_by_type(tensors) + + for tp in buckets: + bucket = buckets[tp] + apply_flat_dist_call(bucket, call, extra_args) + + +def extract_tensors(maybe_tensor, tensor_list): + if torch.is_tensor(maybe_tensor): + tensor_list.append(maybe_tensor) + else: + try: + for item in maybe_tensor: + extract_tensors(item, tensor_list) + except TypeError: + return + + +class Reducer(object): + """ + :class:`apex.parallel.Reducer` is a simple class that helps allreduce a module's parameters + across processes. :class:`Reducer` is intended to give the user additional control: + Unlike :class:`DistributedDataParallel`, :class:`Reducer` will not automatically allreduce + parameters during ``backward()``. + Instead, :class:`Reducer` waits for the user to call ``.reduce()`` manually. + This enables, for example, delaying the allreduce to be carried out every + several iterations instead of every single iteration. + + Like :class:`DistributedDataParallel`, :class:`Reducer` averages any tensors it allreduces + over the number of participating processes. + + :class:`Reducer` is designed to work with the upstream launch utility script + ``torch.distributed.launch`` with ``--nproc_per_node <= number of gpus per node``. + When used with this launcher, :class:`Reducer` assumes 1:1 mapping of processes to GPUs. + It also assumes that your script calls ``torch.cuda.set_device(args.rank)`` before creating the model. + + Args: + module_or_grads_list: Either a network definition (module) being run in multi-gpu/distributed mode, or an iterable of gradients to be reduced. If a module is passed in, the Reducer constructor will sync the parameters across processes (broadcasting from rank 0) to make sure they're all initialized with the same values. If a list of gradients (that came from some module) is passed in, the user is responsible for manually syncing that module's parameters at the beginning of training. + """ + + def __init__(self, module_or_grads_list): + if isinstance(module_or_grads_list, Module): + self.module = module_or_grads_list + flat_dist_call([param.data for param in self.module.parameters()], dist.broadcast, (0,) ) + + else: + self.module = None + self.grads = [] + extract_tensors(module_or_grads_list, self.grads) + + def reduce(self): + if self.module: + grads = [param.grad.data for param in self.module.parameters() if param.grad is not None] + flat_dist_call(grads, dist.all_reduce) + else: + flat_dist_call(self.grads, dist.all_reduce) + + +class DistributedDataParallel(Module): + """ + :class:`apex.parallel.DistributedDataParallel` is a module wrapper that enables + easy multiprocess distributed data parallel training, similar to ``torch.nn.parallel.DistributedDataParallel``. Parameters are broadcast across participating processes on initialization, and gradients are + allreduced and averaged over processes during ``backward()``. + + :class:`DistributedDataParallel` is optimized for use with NCCL. It achieves high performance by + overlapping communication with computation during ``backward()`` and bucketing smaller gradient + transfers to reduce the total number of transfers required. + + :class:`DistributedDataParallel` is designed to work with the upstream launch utility script + ``torch.distributed.launch`` with ``--nproc_per_node <= number of gpus per node``. + When used with this launcher, :class:`DistributedDataParallel` assumes 1:1 mapping of processes to GPUs. + It also assumes that your script calls ``torch.cuda.set_device(args.rank)`` before creating the model. + + https://github.com/NVIDIA/apex/tree/master/examples/simple/distributed shows detailed usage. + https://github.com/NVIDIA/apex/tree/master/examples/imagenet shows another example + that combines :class:`DistributedDataParallel` with mixed precision training. + + Args: + module: Network definition to be run in multi-gpu/distributed mode. + message_size (int, default=1e7): Minimum number of elements in a communication bucket. + delay_allreduce (bool, default=False): Delay all communication to the end of the backward pass. This disables overlapping communication with computation. + allreduce_trigger_params (list, optional, default=None): If supplied, should contain a list of parameters drawn from the model. Allreduces will be kicked off whenever one of these parameters receives its gradient (as opposed to when a bucket of size message_size is full). At the end of backward(), a cleanup allreduce to catch any remaining gradients will also be performed automatically. If allreduce_trigger_params is supplied, the message_size argument will be ignored. + allreduce_always_fp32 (bool, default=False): Convert any FP16 gradients to FP32 before allreducing. This can improve stability for widely scaled-out runs. + gradient_average (bool, default=True): Option to toggle whether or not DDP averages the allreduced gradients over processes. For proper scaling, the default value of True is recommended. + gradient_predivide_factor (float, default=1.0): Allows perfoming the average of gradients over processes partially before and partially after the allreduce. Before allreduce: ``grads.mul_(1.0/gradient_predivide_factor)``. After allreduce: ``grads.mul_(gradient_predivide_factor/world size)``. This can reduce the stress on the dynamic range of FP16 allreduces for widely scaled-out runs. + + .. warning:: + If ``gradient_average=False``, the pre-allreduce division (``grads.mul_(1.0/gradient_predivide_factor)``) will still be applied, but the post-allreduce gradient averaging (``grads.mul_(gradient_predivide_factor/world size)``) will be omitted. + + """ + + def __init__(self, + module, + message_size=10000000, + delay_allreduce=False, + shared_param=None, + allreduce_trigger_params=None, + retain_allreduce_buffers=False, + allreduce_always_fp32=False, + num_allreduce_streams=1, + allreduce_communicators=None, + gradient_average=True, + gradient_predivide_factor=1.0, + gradient_average_split_factor=None, + prof=False): + super(DistributedDataParallel, self).__init__() + + # Backward/forward compatibility around + # https://github.com/pytorch/pytorch/commit/540ef9b1fc5506369a48491af8a285a686689b36 and + # https://github.com/pytorch/pytorch/commit/044d00516ccd6572c0d6ab6d54587155b02a3b86 + if hasattr(dist, "get_backend"): + self._backend = dist.get_backend() + if hasattr(dist, "DistBackend"): + self.backend_enum_holder = dist.DistBackend + else: + self.backend_enum_holder = dist.Backend + else: + self._backend = dist._backend + self.backend_enum_holder = dist.dist_backend + + self.warn_on_half = True if self._backend == self.backend_enum_holder.GLOO else False + + self.prof = prof + + self.allreduce_different_streams = (num_allreduce_streams > 1) + self.num_allreduce_streams = num_allreduce_streams + self.allreduce_communicators = allreduce_communicators + if self.allreduce_communicators: + assert len(allreduce_communicators[0]) == num_allreduce_streams + assert len(allreduce_communicators[0]) == len(allreduce_communicators[1]) + assert self.allreduce_different_streams + + if self.allreduce_different_streams and delay_allreduce: + raise ValueError("self.allreduce_different_streams may only be used if delay_allreduce=False.") + + if shared_param is not None: + raise ValueError("shared_param is no longer supported as an option. It was misleadingly named from the start. It turns out overlapping communication with computation should work fine with shared parameters. If you still wish to delay communication to the end of the backward pass, use delay_allreduce=True|False instead.") + + self.world_size = float(dist.get_world_size()) + + self.retain_allreduce_buffers = retain_allreduce_buffers + self.allreduce_always_fp32 = allreduce_always_fp32 + self.gradient_average = gradient_average + self.gradient_predivide_factor = gradient_predivide_factor + + self.custom_allreduce_triggers = False + if allreduce_trigger_params is not None: + if delay_allreduce: + raise ValueError("Setting allreduce_trigger_params is only valid if delay_allreduce=False.") + self.custom_allreduce_triggers = True + self.allreduce_trigger_params = set([id(param) for param in allreduce_trigger_params]) + + self.delay_allreduce = delay_allreduce + self.message_size = message_size + + self.main_stream = torch.cuda.current_stream() + + self.bucket_streams = [] + self.bucket_events = [] + + self.module = module + + self._disable_allreduce = False + + if self._backend == self.backend_enum_holder.NCCL: + for param in self.module.parameters(): + assert param.is_cuda, "NCCL backend only supports model parameters to be on GPU." + + self.active_params = [] + + self.param_type_to_tmp_i = {"torch.cuda.HalfTensor" : 0, + "torch.cuda.FloatTensor" : 1, + "torch.cuda.DoubleTensor" : 2} + + if multi_tensor_applier.available: + # TODO: I really need to centralize the C++ backed imports + import amp_C + self.multi_tensor_scale = amp_C.multi_tensor_scale + self._overflow_buf = torch.cuda.IntTensor([0]) + + self.create_hooks() + + flat_dist_call([param.data for param in self.module.parameters()], dist.broadcast, (0,) ) + + + def __setstate__(self, state): + super(DistributedDataParallel, self).__setstate__(state) + if self.allreduce_different_streams and delay_allreduce: + raise ValueError("self.allreduce_different_streams may only be used if delay_allreduce=False.") + + if self.delay_allreduce: + self.needs_refresh = True + + self.bucket_streams = [] + self.bucket_events = [] + + + def __getstate__(self): + attrs = copy.copy(self.__dict__) + if self._backend != self.backend_enum_holder.NCCL: + del attrs['self.bucket_streams'] + del attrs['self.bucket_events'] + return attrs + + def enable_allreduce(self): + self._disable_allreduce = False + + def disable_allreduce(self): + self._disable_allreduce = True + + # Broadcast rank 0's bucket structure across all processes, and have all processes + # regenerate their bucket structures to match. + def sync_bucket_structure(self): + # Append leftover buckets + for tmp_bucket in self.tmp_buckets: + if len(tmp_bucket) > 0: + self.active_i_buckets.append(tmp_bucket) + + self.num_buckets = len(self.active_i_buckets) + self.bucket_sizes = [len(bucket) for bucket in self.active_i_buckets] + + info_tensor = torch.cuda.IntTensor([self.num_buckets] + + self.bucket_sizes + + list(chain(*self.active_i_buckets))) + + dist.broadcast(info_tensor, 0) + + info = [int(entry) for entry in info_tensor] + + self.num_buckets = info[0] + self.bucket_sizes = info[1:self.num_buckets + 1] + self.buckets = [[None for _ in range(self.bucket_sizes[i])] + for i in range(self.num_buckets)] + # Technically, active_i_buckets' work is done. But the information is still useful to + # keep around. Therefore, refresh active_i_buckets based on rank 0 as well. + self.active_i_buckets = [[None for _ in range(self.bucket_sizes[i])] + for i in range(self.num_buckets)] + + flattened_buckets = info[self.num_buckets + 1:] + flat_i = 0 + for bucket_idx in range(self.num_buckets): + for bucket_loc in range(self.bucket_sizes[bucket_idx]): + param_i = flattened_buckets[flat_i] + self.active_i_buckets[bucket_idx][bucket_loc] = param_i + self.param_id_to_bucket[id(self.active_params[param_i])] = (bucket_idx, bucket_loc) + flat_i += 1 + + + def create_hooks(self): + # Fallback hook that's only called at the end of backward. + # Used if you deliberately want to delay allreduces to the end, or to refresh the + # bucket structure that will be used to overlap communication with computation in later + # iterations. + def allreduce_params(): + # Bucket record refresh + if not self.delay_allreduce: + if self.needs_refresh: + self.sync_bucket_structure() + + self.needs_refresh = False + + self.allreduce_fallback() + + + def overlapping_backward_epilogue(): + for stream, event in zip(self.bucket_streams, self.bucket_events): + stream.record_event(event) + torch.cuda.current_stream().wait_event(event) + + # Sanity checks that all the buckets were kicked off + if self.next_bucket != self.num_buckets: + raise RuntimeError("In epilogue, next_bucket ({}) != num_buckets ({}). ".format( + self.next_bucket, self.num_buckets), + "This probably indicates some buckets were not allreduced.") + + for actual, expected in zip(self.buckets_ready_size, self.bucket_sizes): + if actual != expected: + raise RuntimeError("Some param buckets were not allreduced.") + + + self.grad_accs = [] + for param in self.module.parameters(): + if param.requires_grad: + def wrapper(param): + param_tmp = param.expand_as(param) + grad_acc = param_tmp.grad_fn.next_functions[0][0] + + def allreduce_hook(*unused): + if self.prof: + torch.cuda.nvtx.range_push("allreduce_hook") + + if not self._disable_allreduce: + if self.delay_allreduce or self.needs_refresh: + # TODO: How do we want to handle multiple backward passes between + # each forward, e.g., backward passes with retain_graph=True? + # needs_refresh and callback_queued are both vulnerable states. + if not self.delay_allreduce and self.needs_refresh: + # Use the backward pass to build the bucket structure on the fly. + active_i = self.param_id_to_active_i[id(param)] + + # Float, half, and double tensors are grouped into buckets separately. + current_type = self.param_type_to_tmp_i[param.type()] + + self.tmp_buckets[current_type].append(active_i) + + ship_tmp_bucket = False + if self.custom_allreduce_triggers: + if id(param) in self.allreduce_trigger_params: + ship_tmp_bucket = True + else: + self.tmp_numels[current_type] += param.numel() + if self.tmp_numels[current_type] >= self.message_size: + ship_tmp_bucket = True + + # To consider: If custom_allreduce_triggers are in use, ship all + # tmp_buckets, not just tmp_buckets[current_type]. + if ship_tmp_bucket: + self.active_i_buckets.append(self.tmp_buckets[current_type]) + self.tmp_buckets[current_type] = [] + self.tmp_numels[current_type] = 0 + + if not self.callback_queued: + Variable._execution_engine.queue_callback(allreduce_params) + self.callback_queued = True + else: + if not self.callback_queued: + Variable._execution_engine.queue_callback(overlapping_backward_epilogue) + self.callback_queued = True + + self.comm_ready_buckets(param) + + if self.prof: + torch.cuda.nvtx.range_pop() + + grad_acc.register_hook(allreduce_hook) + self.grad_accs.append(grad_acc) + + wrapper(param) + + + def _stream_this_bucket(self, bucket_idx): + if self.allreduce_different_streams: + return self.bucket_streams[bucket_idx%self.num_allreduce_streams] + else: + return self.bucket_streams[0] + + + def _event_this_bucket(self, bucket_idx): + if self.allreduce_different_streams: + return self.bucket_events[bucket_idx%self.num_allreduce_streams] + else: + return self.bucket_events[0] + + + def allreduce_bucket(self, bucket, bucket_idx, force_default_stream): + tensor = flatten(bucket) + + if force_default_stream: + bucket_stream = self.main_stream + else: + bucket_stream = self._stream_this_bucket(bucket_idx) + bucket_event = self._event_this_bucket(bucket_idx) + torch.cuda.current_stream().record_event(bucket_event) + bucket_stream.wait_event(bucket_event) + + with torch.cuda.stream(bucket_stream): + # self.main_stream.wait_stream(torch.cuda.current_stream()) + # torch.cuda.synchronize() + + tensor_to_allreduce = tensor + + if self.allreduce_always_fp32: + tensor_to_allreduce = tensor.float() + + if self.gradient_predivide_factor != 1.0: + tensor_to_allreduce.mul_(1./self.gradient_predivide_factor) + + if self.allreduce_different_streams and not force_default_stream: + dist.all_reduce(tensor_to_allreduce, group=self.bucket_pgs[bucket_idx%self.num_allreduce_streams]) + else: + dist.all_reduce(tensor_to_allreduce) + + if self.gradient_average: + tensor_to_allreduce.mul_(self.gradient_predivide_factor/self.world_size) + + if self.allreduce_always_fp32 and tensor is not tensor_to_allreduce: + tensor.copy_(tensor_to_allreduce) + + if not self.retain_allreduce_buffers: + if multi_tensor_applier.available: + multi_tensor_applier( + self.multi_tensor_scale, + self._overflow_buf, + [unflatten(tensor, bucket), bucket], + 1.0) + else: + for buf, synced in zip(bucket, unflatten(tensor, bucket)): + buf.copy_(synced) + + # I think we actually do need this here. After allreduce_bucket returns, tensor will + # eventually go out of scope and die, at which point it could otherwise be freed for + # further reuse by the main stream while the allreduce/div/unflatten are underway in bucket_stream. + tensor.record_stream(bucket_stream) + + return tensor + + + def allreduce_maybe_retain(self, bucket, bucket_idx, force_default_stream=False): + allreduced = self.allreduce_bucket(bucket, bucket_idx, force_default_stream) + if self.retain_allreduce_buffers: + if self.allreduce_buffers[bucket_idx] is not None: + raise RuntimeError("The backward pass is attempting to replace an already-filled " + "allreduce buffer. This is almost certainly an error.") + self.allreduce_buffers[bucket_idx] = allreduced + for view, grad in zip(unflatten(allreduced, bucket), bucket): + grad.data = view + # for buf, synced in zip(bucket, unflatten(allreduced, bucket)): + # buf.copy_(synced) + + + def allreduce_fallback(self): + for stream, event in zip(self.bucket_streams, self.bucket_events): + stream.record_event(event) + torch.cuda.current_stream().wait_event(event) + + if self.retain_allreduce_buffers: + grads = [param.grad for param in self.module.parameters() if param.grad is not None] + else: + grads = [param.grad.data for param in self.module.parameters() if param.grad is not None] + + split_buckets = split_half_float_double(grads) + + # If retain_allreduce_buffers is True and delay_allreduce is False, + # this will only be done during the first backward pass, ignored by the + # training script, and overwritten in the next forward pass. So it's harmless. + if self.retain_allreduce_buffers: + self.allreduce_buffers = [None for _ in range(len(split_buckets))] + + for i, bucket in enumerate(split_buckets): + allreduced = self.allreduce_maybe_retain(bucket, i, force_default_stream=True) + + + def comm_ready_buckets(self, param): + # Need to do this in every hook for compatibility with Ruberry's streaming backward PR. + # self.reduction_stream.wait_stream(torch.cuda.current_stream()) + if self.prof: + torch.cuda.nvtx.range_push("comm_ready_buckets") + + bucket_idx, bucket_loc = self.param_id_to_bucket[id(param)] + + if self.buckets[bucket_idx][bucket_loc] is not None: + raise RuntimeError("The backward pass is attempting to replace an already-filled " + "bucket slot. This is almost certainly an error.") + + if self.retain_allreduce_buffers: + self.buckets[bucket_idx][bucket_loc] = param.grad + else: + self.buckets[bucket_idx][bucket_loc] = param.grad.data + + self.buckets_ready_size[bucket_idx] += 1 + + if self.buckets_ready_size[bucket_idx] == self.bucket_sizes[bucket_idx]: + if bucket_idx == self.next_bucket: + self.allreduce_maybe_retain(self.buckets[bucket_idx], bucket_idx) + + self.next_bucket += 1 + + # Reversing upstream's logic here, because we constructed our buckets based on + # the order things were received during backward. + if len(self.ready_buckets_not_reduced) > 0: + sorted_todo = sorted(self.ready_buckets_not_reduced) + for i in sorted_todo: + # Nothing can be reduced now + if i > self.next_bucket: + break + elif i == self.next_bucket: + self.allreduce_maybe_retain(self.buckets[i], i) + self.ready_buckets_not_reduced.remove(i) + self.next_bucket += 1 + else: + raise ValueError("i should always be >= next_bucket") + else: + self.ready_buckets_not_reduced.add(bucket_idx) + + if self.prof: + torch.cuda.nvtx.range_pop() + + + def forward(self, *inputs, **kwargs): + result = self.module(*inputs, **kwargs) + + if self.prof: + torch.cuda.nvtx.range_push("forward pass DDP logic") + + if not self._disable_allreduce: + if not self.delay_allreduce: + param_list = [param for param in self.module.parameters() if param.requires_grad] + + # Conditions under which to refresh self.record + # Forward has the authority to set needs_refresh to True, but only allreduce_params + # in backward has the authority to set needs_refresh to False. + # Parentheses are not necessary for correct order of operations, but make the intent clearer. + if ((not self.active_params) or + (len(param_list) != len(self.active_params)) or + any([param1 is not param2 for param1, param2 in zip(param_list, self.active_params)])): + self.needs_refresh = True + + if self.needs_refresh: + self.active_i_buckets = [] + self.buckets = [] + self.tmp_buckets = [[], [], []] # [running half, float, double buckets] + self.tmp_numels = [0, 0, 0] + self.bucket_sizes = [] + self.param_id_to_active_i = {id(param) : i for i, param in enumerate(param_list)} + self.param_id_to_bucket = {} + self.bucket_pgs = [] + self.bucket_streams = [] + self.bucket_events = [] + else: + # self.buckets = [[None for _ in range(self.bucket_sizes[i])] + # for i in range(self.num_buckets)] + if not self.buckets: + self.buckets = [[None for _ in range(self.bucket_sizes[i])] + for i in range(self.num_buckets)] + else: + assert len(self.buckets) == self.num_buckets, "len(buckets) = {}, expected {}".format( + len(self.buckets), self.num_buckets) + for b, bucket in enumerate(self.buckets): + assert len(bucket) == self.bucket_sizes[b], "len(buckets[{}]) = {}, expected {})".format( + b, len(buckets[b]), self.bucket_sizes[b]) + for i in range(len(bucket)): + bucket[i] = None + + if self.allreduce_communicators: + self.bucket_pgs = self.allreduce_communicators[0] + self.bucket_streams = self.allreduce_communicators[1] + self.bucket_events = [torch.cuda.Event(enable_timing=False, + blocking=False) for _ in range(self.num_allreduce_streams)] + else: + if self.allreduce_different_streams: + if not self.bucket_pgs: + self.bucket_pgs = [dist.new_group() for _ in range(self.num_allreduce_streams)] + for i, bg in enumerate(self.bucket_pgs): + print("rank {} created group {} with backend {}".format( + dist.get_rank(), i, dist.get_backend(bg))) + if self.allreduce_different_streams: + if not self.bucket_streams: + self.bucket_streams = [torch.cuda.Stream() for _ in range(self.num_allreduce_streams)] + self.bucket_events = [torch.cuda.Event(enable_timing=False, + blocking=False) for _ in range(self.num_allreduce_streams)] + else: + if not self.bucket_streams: + self.bucket_streams = [torch.cuda.Stream()] + self.bucket_events = [torch.cuda.Event(enable_timing=False, blocking=False)] + + self.buckets_ready_size = [0 for i in range(self.num_buckets)] + if(self.retain_allreduce_buffers): + self.allreduce_buffers = [None for _ in range(self.num_buckets)] + self.next_bucket = 0 + self.ready_buckets_not_reduced = set() + + self.active_params = param_list + + self.callback_queued = False + + if self.prof: + torch.cuda.nvtx.range_pop() + + return result diff --git a/apex/apex/parallel/multiproc.py b/apex/apex/parallel/multiproc.py new file mode 100644 index 0000000000000000000000000000000000000000..ff743df20b992e5a1ea95de5dd5b62785800247d --- /dev/null +++ b/apex/apex/parallel/multiproc.py @@ -0,0 +1,35 @@ +import torch +import sys +import subprocess + +def docstring_hack(): + """ + Multiproc file which will launch a set of processes locally for multi-gpu + usage: python -m apex.parallel.multiproc main.py ... + """ + pass + +argslist = list(sys.argv)[1:] +world_size = torch.cuda.device_count() + +if '--world-size' in argslist: + world_size = int(argslist[argslist.index('--world-size')+1]) +else: + argslist.append('--world-size') + argslist.append(str(world_size)) + +workers = [] + +for i in range(world_size): + if '--rank' in argslist: + argslist[argslist.index('--rank')+1] = str(i) + else: + argslist.append('--rank') + argslist.append(str(i)) + stdout = None if i == 0 else open("GPU_"+str(i)+".log", "w") + print(argslist) + p = subprocess.Popen([str(sys.executable)]+argslist, stdout=stdout) + workers.append(p) + +for p in workers: + p.wait() diff --git a/apex/apex/parallel/optimized_sync_batchnorm.py b/apex/apex/parallel/optimized_sync_batchnorm.py new file mode 100644 index 0000000000000000000000000000000000000000..65cf5eabf6990e41eff9749f8ed6a56307acdae7 --- /dev/null +++ b/apex/apex/parallel/optimized_sync_batchnorm.py @@ -0,0 +1,85 @@ +import torch +from torch.nn.modules.batchnorm import _BatchNorm +from torch.nn import functional as F + +import syncbn +from .optimized_sync_batchnorm_kernel import SyncBatchnormFunction + + +class SyncBatchNorm(_BatchNorm): + """ + synchronized batch normalization module extented from `torch.nn.BatchNormNd` + with the added stats reduction across multiple processes. + :class:`apex.parallel.SyncBatchNorm` is designed to work with + `DistributedDataParallel`. + + When running in training mode, the layer reduces stats across all processes + to increase the effective batchsize for normalization layer. This is useful + in applications where batch size is small on a given process that would + diminish converged accuracy of the model. The model uses collective + communication package from `torch.distributed`. + + When running in evaluation mode, the layer falls back to + `torch.nn.functional.batch_norm` + + Args: + num_features: :math:`C` from an expected input of size + :math:`(N, C, L)` or :math:`L` from input of size :math:`(N, L)` + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Can be set to ``None`` for cumulative moving average + (i.e. simple average). Default: 0.1 + affine: a boolean value that when set to ``True``, this module has + learnable affine parameters. Default: ``True`` + track_running_stats: a boolean value that when set to ``True``, this + module tracks the running mean and variance, and when set to ``False``, + this module does not track such statistics and always uses batch + statistics in both training and eval modes. Default: ``True`` + process_group: pass in a process group within which the stats of the + mini-batch is being synchronized. ``None`` for using default process + group + channel_last: a boolean value that when set to ``True``, this module + take the last dimension of the input tensor to be the channel + dimension. Default: False + + Examples:: + >>> # channel first tensor + >>> sbn = apex.parallel.SyncBatchNorm(100).cuda() + >>> inp = torch.randn(10, 100, 14, 14).cuda() + >>> out = sbn(inp) + >>> inp = torch.randn(3, 100, 20).cuda() + >>> out = sbn(inp) + >>> # channel last tensor + >>> sbn = apex.parallel.SyncBatchNorm(100, channel_last=True).cuda() + >>> inp = torch.randn(10, 14, 14, 100).cuda() + """ + + def __init__(self, num_features, eps=1e-5, momentum=0.1, affine=True, track_running_stats=True, process_group=None, channel_last=False, fuse_relu=False): + super(SyncBatchNorm, self).__init__(num_features, eps=eps, momentum=momentum, affine=affine, track_running_stats=track_running_stats) + self.process_group = process_group + self.channel_last = channel_last + self.fuse_relu = fuse_relu + + def _specify_process_group(self, process_group): + self.process_group = process_group + + def _specify_channel_last(self, channel_last): + self.channel_last = channel_last + + def forward(self, input, z = None): + # if input.dim() == 2, we switch to channel_last for efficient memory accessing + channel_last = self.channel_last if input.dim() != 2 else True + + if not self.training and self.track_running_stats and not channel_last and not self.fuse_relu and z == None: + # fall back to pytorch implementation for inference + return F.batch_norm(input, self.running_mean, self.running_var, self.weight, self.bias, False, 0.0, self.eps) + else: + exponential_average_factor = 0.0 + if self.training and self.track_running_stats: + self.num_batches_tracked += 1 + if self.momentum is None: + exponential_average_factor = 1.0 / float(self.num_batches_tracked) + else: + exponential_average_factor = self.momentum + return SyncBatchnormFunction.apply(input, z, self.weight, self.bias, self.running_mean, self.running_var, self.eps, self.training or not self.track_running_stats, exponential_average_factor, self.process_group, channel_last, self.fuse_relu) diff --git a/apex/apex/parallel/optimized_sync_batchnorm_kernel.py b/apex/apex/parallel/optimized_sync_batchnorm_kernel.py new file mode 100644 index 0000000000000000000000000000000000000000..61684714969f0e61ce7a8b308eba76164de0458c --- /dev/null +++ b/apex/apex/parallel/optimized_sync_batchnorm_kernel.py @@ -0,0 +1,119 @@ +import torch +from torch.autograd.function import Function + +import syncbn +from apex.parallel import ReduceOp + +class SyncBatchnormFunction(Function): + + @staticmethod + def forward(ctx, input, z, weight, bias, running_mean, running_variance, eps, track_running_stats = True, momentum = 1.0, process_group = None, channel_last = False, fuse_relu = False): + input = input.contiguous() + world_size = 0 + + mean = None + var_biased = None + inv_std = None + var = None + out = None + count = None + if track_running_stats: + if channel_last: + count = int(input.numel()/input.size(-1)) + mean, var_biased = syncbn.welford_mean_var_c_last(input) + num_channels = input.size(-1) + else: + count = int(input.numel()/input.size(1)) + mean, var_biased = syncbn.welford_mean_var(input) + num_channels = input.size(1) + + if torch.distributed.is_initialized(): + if not process_group: + process_group = torch.distributed.group.WORLD + device = mean.device + world_size = torch.distributed.get_world_size(process_group) + + count_t = torch.empty(1, dtype=mean.dtype, device=mean.device).fill_(count) + combined = torch.cat([mean.view(-1), var_biased.view(-1), count_t], dim=0) + combined_list = [torch.empty_like(combined) for k in range(world_size)] + torch.distributed.all_gather(combined_list, combined, process_group) + combined = torch.stack(combined_list, dim=0) + mean_all, invstd_all, count_all = torch.split(combined, num_channels, dim=1) + count_all = count_all.view(-1) + mean, var, inv_std = syncbn.welford_parallel(mean_all, invstd_all, count_all.to(torch.int32), eps) + else: + device = mean.device + count_all = torch.cuda.IntTensor([count], device=device) + inv_std = 1.0 / torch.sqrt(var_biased + eps) + var = var_biased * (count) / (count-1) + + if count == 1 and world_size < 2: + raise ValueError('Expected more than 1 value per channel when training, got input size{}'.format(input.size())) + + r_m_inc = mean if running_mean.dtype != torch.float16 else mean.half() + r_v_inc = var if running_variance.dtype != torch.float16 else var.half() + running_mean.data = running_mean.data * (1-momentum) + momentum*r_m_inc + running_variance.data = running_variance.data * (1-momentum) + momentum*r_v_inc + else: + mean = running_mean.data + inv_std = 1.0 / torch.sqrt(running_variance.data + eps) + + ctx.save_for_backward(input, weight, mean, inv_std, z, bias, count_all.to(torch.int32)) + ctx.process_group = process_group + ctx.channel_last = channel_last + ctx.world_size = world_size + ctx.fuse_relu = fuse_relu + + if channel_last: + out = syncbn.batchnorm_forward_c_last(input, z, mean, inv_std, weight, bias, fuse_relu) + else: + out = syncbn.batchnorm_forward(input, mean, inv_std, weight, bias) + + return out + + @staticmethod + def backward(ctx, grad_output): + grad_output = grad_output.contiguous() + # mini batch mean & var are calculated by forward path. + # mu = 1./N*np.sum(h, axis = 0) + # var = 1./N*np.sum((h-mu)**2, axis = 0) + saved_input, weight, mean, inv_std, z, bias, count = ctx.saved_tensors + process_group = ctx.process_group + channel_last = ctx.channel_last + world_size = ctx.world_size + fuse_relu = ctx.fuse_relu + grad_input = grad_z = grad_weight = grad_bias = None + + if fuse_relu: + grad_output = syncbn.relu_bw_c_last(grad_output, saved_input, z, mean, inv_std, weight, bias) + if isinstance(z, torch.Tensor) and ctx.needs_input_grad[1]: + grad_z = grad_output.clone() + + # TODO: update kernel to not pre_divide by item_num + if channel_last: + sum_dy, sum_dy_xmu, grad_weight, grad_bias = syncbn.reduce_bn_c_last(grad_output, saved_input, mean, inv_std, weight) + else: + sum_dy, sum_dy_xmu, grad_weight, grad_bias = syncbn.reduce_bn(grad_output, saved_input, mean, inv_std, weight) + + # calculate grad_input + if ctx.needs_input_grad[0]: + + if torch.distributed.is_initialized(): + num_channels = sum_dy.shape[0] + combined = torch.cat([sum_dy, sum_dy_xmu], dim=0) + torch.distributed.all_reduce( + combined, torch.distributed.ReduceOp.SUM, process_group, async_op=False) + sum_dy, sum_dy_xmu = torch.split(combined, num_channels) + + if channel_last: + grad_input = syncbn.batchnorm_backward_c_last(grad_output, saved_input, mean, inv_std, weight, sum_dy, sum_dy_xmu, count) + else: + grad_input = syncbn.batchnorm_backward(grad_output, saved_input, mean, inv_std, weight, sum_dy, sum_dy_xmu, count) + + if weight is None or not ctx.needs_input_grad[2]: + grad_weight = None + + if weight is None or not ctx.needs_input_grad[3]: + grad_bias = None + + return grad_input, grad_z, grad_weight, grad_bias, None, None, None, None, None, None, None, None diff --git a/apex/apex/parallel/sync_batchnorm.py b/apex/apex/parallel/sync_batchnorm.py new file mode 100644 index 0000000000000000000000000000000000000000..1fcfe4356a99d3f3dfa406cf94e4f9ea3d47d367 --- /dev/null +++ b/apex/apex/parallel/sync_batchnorm.py @@ -0,0 +1,134 @@ +import torch +from torch.nn.modules.batchnorm import _BatchNorm +from torch.nn import functional as F + +from .sync_batchnorm_kernel import SyncBatchnormFunction +from apex.parallel import ReduceOp + + +class SyncBatchNorm(_BatchNorm): + """ + synchronized batch normalization module extented from ``torch.nn.BatchNormNd`` + with the added stats reduction across multiple processes. + :class:`apex.parallel.SyncBatchNorm` is designed to work with + ``DistributedDataParallel``. + + When running in training mode, the layer reduces stats across all processes + to increase the effective batchsize for normalization layer. This is useful + in applications where batch size is small on a given process that would + diminish converged accuracy of the model. The model uses collective + communication package from ``torch.distributed``. + + When running in evaluation mode, the layer falls back to + ``torch.nn.functional.batch_norm``. + + Args: + num_features: :math:`C` from an expected input of size + :math:`(N, C, L)` or :math:`L` from input of size :math:`(N, L)` + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Can be set to ``None`` for cumulative moving average + (i.e. simple average). Default: 0.1 + affine: a boolean value that when set to ``True``, this module has + learnable affine parameters. Default: ``True`` + track_running_stats: a boolean value that when set to ``True``, this + module tracks the running mean and variance, and when set to ``False``, + this module does not track such statistics and always uses batch + statistics in both training and eval modes. Default: ``True`` + + Example:: + + >>> sbn = apex.parallel.SyncBatchNorm(100).cuda() + >>> inp = torch.randn(10, 100, 14, 14).cuda() + >>> out = sbn(inp) + >>> inp = torch.randn(3, 100, 20).cuda() + >>> out = sbn(inp) + """ + + warned = False + + def __init__(self, num_features, eps=1e-5, momentum=0.1, affine=True, track_running_stats=True, process_group=None, channel_last=False): + if channel_last == True: + raise AttributeError("channel_last is not supported by primitive SyncBatchNorm implementation. Try install apex with `--cuda_ext` if channel_last is desired.") + + if not SyncBatchNorm.warned: + if hasattr(self, "syncbn_import_error"): + print("Warning: using Python fallback for SyncBatchNorm, possibly because apex was installed without --cuda_ext. The exception raised when attempting to import the cuda backend was: ", self.syncbn_import_error) + else: + print("Warning: using Python fallback for SyncBatchNorm") + SyncBatchNorm.warned = True + + super(SyncBatchNorm, self).__init__(num_features, eps=eps, momentum=momentum, affine=affine, track_running_stats=track_running_stats) + self.process_group = process_group + + def _specify_process_group(self, process_group): + self.process_group = process_group + + def forward(self, input): + torch.cuda.nvtx.range_push("sync_bn_fw_with_mean_var") + mean = None + var = None + cast = None + out = None + + # casting to handle mismatch input type to layer type + if self.running_mean is not None: + if self.running_mean.dtype != input.dtype: + input = input.to(self.running_mean.dtype) + cast = input.dtype + elif self.weight is not None: + if self.weight.dtype != input.dtype: + input = input.to(self.weight.dtype) + cast = input.dtype + + if not self.training and self.track_running_stats: + # fall back to pytorch implementation for inference + torch.cuda.nvtx.range_pop() + out = F.batch_norm(input, self.running_mean, self.running_var, self.weight, self.bias, False, 0.0, self.eps) + else: + process_group = self.process_group + world_size = 1 + if not self.process_group: + process_group = torch.distributed.group.WORLD + self.num_batches_tracked += 1 + with torch.no_grad(): + channel_first_input = input.transpose(0, 1).contiguous() + squashed_input_tensor_view = channel_first_input.view( + channel_first_input.size(0), -1) + # total number of data points for each variance entry. Used to calculate unbiased variance estimate + m = None + local_m = float(squashed_input_tensor_view.size()[1]) + local_mean = torch.mean(squashed_input_tensor_view, 1) + local_sqr_mean = torch.pow( + squashed_input_tensor_view, 2).mean(1) + if torch.distributed.is_initialized(): + world_size = torch.distributed.get_world_size(process_group) + torch.distributed.all_reduce( + local_mean, ReduceOp.SUM, process_group) + mean = local_mean / world_size + torch.distributed.all_reduce( + local_sqr_mean, ReduceOp.SUM, process_group) + sqr_mean = local_sqr_mean / world_size + m = local_m * world_size + else: + m = local_m + mean = local_mean + sqr_mean = local_sqr_mean + # var(x) = E (( x - mean_x ) ** 2) + # = 1 / N * sum ( x - mean_x ) ** 2 + # = 1 / N * sum (x**2) - mean_x**2 + var = sqr_mean - mean.pow(2) + + if self.running_mean is not None: + self.running_mean = self.momentum * mean + \ + (1 - self.momentum) * self.running_mean + if self.running_var is not None: + # as noted by the paper, we used unbiased variance estimate of the mini-batch + # Var[x] = m / (m-1) * Eb (sample_variance) + self.running_var = m / \ + (m-1) * self.momentum * var + \ + (1 - self.momentum) * self.running_var + torch.cuda.nvtx.range_pop() + out = SyncBatchnormFunction.apply(input, self.weight, self.bias, mean, var, self.eps, process_group, world_size) + return out.to(cast) diff --git a/apex/apex/parallel/sync_batchnorm_kernel.py b/apex/apex/parallel/sync_batchnorm_kernel.py new file mode 100644 index 0000000000000000000000000000000000000000..e407a63da3020cd154708f270d9bf890158413a5 --- /dev/null +++ b/apex/apex/parallel/sync_batchnorm_kernel.py @@ -0,0 +1,87 @@ +import torch +from torch.autograd.function import Function + +from apex.parallel import ReduceOp + + +class SyncBatchnormFunction(Function): + + @staticmethod + def forward(ctx, input, weight, bias, running_mean, running_variance, eps, process_group, world_size): + torch.cuda.nvtx.range_push("sync_BN_fw") + # transpose it to channel last to support broadcasting for input with different rank + c_last_input = input.transpose(1, -1).contiguous().clone() + + ctx.save_for_backward(c_last_input, weight, bias, + running_mean, running_variance) + ctx.eps = eps + ctx.process_group = process_group + ctx.world_size = world_size + + c_last_input = (c_last_input - running_mean) / \ + torch.sqrt(running_variance + eps) + + if weight is not None: + c_last_input = c_last_input * weight + if bias is not None: + c_last_input = c_last_input + bias + + torch.cuda.nvtx.range_pop() + return c_last_input.transpose(1, -1).contiguous().clone() + + @staticmethod + def backward(ctx, grad_output): + torch.cuda.nvtx.range_push("sync_BN_bw") + # mini batch mean & var are calculated by forward path. + # mu = 1./N*np.sum(h, axis = 0) + # var = 1./N*np.sum((h-mu)**2, axis = 0) + c_last_input, weight, bias, running_mean, running_variance = ctx.saved_tensors + + eps = ctx.eps + process_group = ctx.process_group + world_size = ctx.world_size + grad_input = grad_weight = grad_bias = None + num_features = running_mean.size()[0] + + # transpose it to channel last to support broadcasting for input with different rank + torch.cuda.nvtx.range_push("carilli field") + c_last_grad = grad_output.transpose(1, -1).contiguous() + # squash non-channel dimension so we can easily calculate mean + c_grad = c_last_grad.view(-1, num_features).contiguous() + torch.cuda.nvtx.range_pop() + + # calculate grad_input + if ctx.needs_input_grad[0]: + # dh = gamma * (var + eps)**(-1. / 2.) * (dy - np.mean(dy, axis=0) + # - (h - mu) * (var + eps)**(-1.0) * np.mean(dy * (h - mu), axis=0)) + mean_dy = c_grad.mean(0) + mean_dy_xmu = (c_last_grad * (c_last_input - + running_mean)).view(-1, num_features).mean(0) + if torch.distributed.is_initialized(): + torch.distributed.all_reduce( + mean_dy, ReduceOp.SUM, process_group) + mean_dy = mean_dy / world_size + torch.distributed.all_reduce( + mean_dy_xmu, ReduceOp.SUM, process_group) + mean_dy_xmu = mean_dy_xmu / world_size + c_last_grad_input = (c_last_grad - mean_dy - (c_last_input - running_mean) / ( + running_variance + eps) * mean_dy_xmu) / torch.sqrt(running_variance + eps) + if weight is not None: + c_last_grad_input.mul_(weight) + grad_input = c_last_grad_input.transpose(1, -1).contiguous() + + # calculate grad_weight + grad_weight = None + if weight is not None and ctx.needs_input_grad[1]: + # dgamma = np.sum((h - mu) * (var + eps)**(-1. / 2.) * dy, axis=0) + grad_weight = ((c_last_input - running_mean) / torch.sqrt( + running_variance + eps) * c_last_grad).view(-1, num_features).sum(0) + + # calculate grad_bias + grad_bias = None + if bias is not None and ctx.needs_input_grad[2]: + # dbeta = np.sum(dy, axis=0) + grad_bias = c_grad.sum(0) + + torch.cuda.nvtx.range_pop() + return grad_input, grad_weight, grad_bias, None, None, None, None, None diff --git a/apex/apex/pyprof/FAQs.md b/apex/apex/pyprof/FAQs.md new file mode 100644 index 0000000000000000000000000000000000000000..27a0e97c56f29274c08d16fe7b57dec5e136a127 --- /dev/null +++ b/apex/apex/pyprof/FAQs.md @@ -0,0 +1,21 @@ +1. How do I intercept the Adam optimizer in APEX ? + + ```python + from apex import pyprof + import fused_adam_cuda + pyprof.nvtx.wrap(fused_adam_cuda, 'adam') + ``` + +2. If you are using JIT and/or AMP, the correct initialization sequence is + 1. Let any JIT to finish. + 2. Initlialize pyprof `pyprof.nvtx.init()`. + 3. Initialize AMP. + +3. How do I profile with `torch.distributed.launch` ? + + ```python + nvprof -f -o net%p.sql \ + --profile-from-start off \ + --profile-child-processes \ + python -m torch.distributed.launch net.py + ``` diff --git a/apex/apex/pyprof/README.md b/apex/apex/pyprof/README.md new file mode 100644 index 0000000000000000000000000000000000000000..ca10c46415e16b834d6dcda803bc02c593e1afc5 --- /dev/null +++ b/apex/apex/pyprof/README.md @@ -0,0 +1,252 @@ +## PyProf - PyTorch Profiling tool + +### What does this tool do? + +Analyzing the performance of deep neural networks is hard. Getting kernels out of [NvProf]([https://developer.nvidia.com/nvidia-visual-profiler](https://developer.nvidia.com/nvidia-visual-profiler)) or [NSight Compute]([https://developer.nvidia.com/nsight-compute](https://developer.nvidia.com/nsight-compute)) provides some generic kernel name and its execution time, but not detailed information regarding the following: + + - Which layer launched it: e.g. the association of `ComputeOffsetsKernel` with a concrete PyTorch layer or API is not obvious. + - What the tensor dimensions and precision were: without knowing the tensor dimensions and precision, it's impossible to reason about whether the actual (silicon) kernel time is close to maximum performance of such a kernel on the GPU. Knowing the tensor dimensions and precision, we can figure out the FLOPs and bandwidth required by a layer, and then determine how close to maximum performance the kernel is for that operation. + - Forward-backward correlation: currently it's very hard to determine what the forward pass step was that resulted in the particular weight and data gradients (wgrad, dgrad), which makes it difficult to determine the tensor dimensions required by these backprop steps to assess their performance. + - Did the kernel use [Tensor Cores]([https://www.youtube.com/watch?v=yyR0ZoCeBO8](https://www.youtube.com/watch?v=yyR0ZoCeBO8))? + - Which line in the user's code resulted in launching this particular kernel (program trace)? + +PyProf addresses all of the issues above by: + + 1. Instrumenting PyTorch operations to capture the tensor dimensions and precision using [NVTX](https://devblogs.nvidia.com/cuda-pro-tip-generate-custom-application-profile-timelines-nvtx). This information is recorded at profile capture time, e.g. using [NvProf](https://developer.nvidia.com/nvidia-visual-profiler). + 2. Querying the record produced by the profiler to correlate the kernel name and duration with PyTorch API/layer name, tensor dimensions, tensor precision, as well as calculating FLOPs and bandwidth for common operations. In addition, extra information from the profile is added for use by CUDA professionals, such as CUDA launch parameters (block/grid dimensions). + +Regarding FLOP and bandwidth implementations, these are usually quite straightforward. For example, for matrices AMxK and BKxN, the FLOP count for a matrix multiplication is 2 * M * N * K, and bandwidth is M * K + N * K + M * N. Note that these numbers are based on the algorithm, not the actual performance of the specific kernel. For more details, see NVIDIA's [Deep Learning Performance Guide](https://docs.nvidia.com/deeplearning/sdk/dl-performance-guide/index.html). + +Armed with such information, the user can determine various issues to help them tune the network. For instance, according to the [Tensor Core Performance Guide]([https://docs.nvidia.com/deeplearning/sdk/dl-performance-guide/index.html](https://docs.nvidia.com/deeplearning/sdk/dl-performance-guide/index.html)), the M, N and K dimensions that result in Tensor Core usage need to be divisible by 8. In fact, PyProf comes with a flag that lets the user obtain information regarding whether Tensor Cores were used by the kernel. Other useful information might include knowing that a particular kernel did not exploit much thread parallelism, as determined by the grid/block dimensions. Since many PyTorch kernels are open-source (or even custom written by the user, as in [CUDA Extensions]([https://pytorch.org/tutorials/advanced/cpp_extension.html](https://pytorch.org/tutorials/advanced/cpp_extension.html))), this provides the user with information that helps root cause performance issues and prioritize optimization work. + + +### How to get started? + +1. Add the following lines to your PyTorch network: + + ```python + import torch.cuda.profiler as profiler + from apex import pyprof + pyprof.nvtx.init() + ``` + + Run the training/inference loop with the [PyTorch's NVTX context manager](https://pytorch.org/docs/stable/_modules/torch/autograd/profiler.html#emit_nvtx) + `with torch.autograd.profiler.emit_nvtx()`. Optionally, you can + use `profiler.start()` and `profiler.stop()` to pick an iteration + (say after warm-up) for which you would like to capture data. + Here's an example: + + ```python + iters = 500 + iter_to_capture = 100 + + # Define network, loss function, optimizer etc. + + # PyTorch NVTX context manager + with torch.autograd.profiler.emit_nvtx(): + + for iter in range(iters): + + if iter == iter_to_capture: + profiler.start() + + output = net(images) + loss = criterion(output, labels) + loss.backward() + optimizer.step() + + if iter == iter_to_capture: + profiler.stop() + ``` + +2. Run NVprof to generate a SQL (NVVP) file. This file can be opened with NVVP, as usual. + ```sh + # If you used profiler.start() and profiler.stop() in net.py + nvprof -f -o net.sql --profile-from-start off -- python net.py + + # Profile everything + nvprof -f -o net.sql -- python net.py + ``` + +**Note:** if you're experiencing issues with hardware counters and you get a message such as `**_ERR_NVGPUCTRPERM The user running does not have permission to access NVIDIA GPU Performance Counters on the target device_**`, please follow the steps described in [Hardware Counters](#hardware-counters). + +3. Run parser on the SQL file. The output is an ASCII file. Each line +is a python dictionary which contains information about the kernel name, +duration, parameters etc. This file can be used as input to other custom +scripts as well. + + ```sh + python -m apex.pyprof.parse net.sql > net.dict + ``` + +4. Run the profiler. The input is the python dictionary created above. The tool can produce a CSV output, a columnated output (similar to `column -t` for terminal readability) and a space separated output (for post processing by AWK for instance). The tool produces 20 columns of information for every GPU kernel but you can select a subset of columns using the `-c` flag. Note that a few columns might have the value "na" implying either its a work in progress or the tool was unable to extract that information. Assuming the directory is `prof`, here are a few examples of how to use `prof.py`. + + ```sh + # Print usage and help. Lists all available output columns. + python -m apex.pyprof.prof -h + + # Columnated output of width 150 with some default columns. + python -m apex.pyprof.prof -w 150 net.dict + + # CSV output. + python -m apex.pyprof.prof --csv net.dict + + # Space seperated output. + python -m apex.pyprof.prof net.dict + + # Columnated output of width 130 with columns index,direction,kernel name,parameters,silicon time. + python -m apex.pyprof.prof -w 130 -c idx,dir,kernel,params,sil net.dict + + # CSV output with columns index,direction,kernel name,parameters,silicon time. + python -m apex.pyprof.prof --csv -c idx,dir,kernel,params,sil net.dict + + # Space separated output with columns index,direction,kernel name,parameters,silicon time. + python -m apex.pyprof.prof -c idx,dir,kernel,params,sil net.dict + + # Input redirection. + python -m apex.pyprof.prof < net.dict + ``` + +5. Profile-guided optimization + +If kernels that do matrix multiplication/GEMM or convolution use half precision (fp16) data but do not use Tensor Cores (the TC column in the profile analysis output doesn't show a "1"), one can follow some basic steps to increase the likelihood that a Tensor Core-compatible kernel will be chosen. For example, for GEMMs, M, N and K should be divisible by 8, and for convolutions, the number of input and output channels shuold be divisible by 8. For more information, see detailed Tensor Core guides such as: +- Blog Post: [Tips for Optimizing GPU Performance Using Tensor Cores](https://devblogs.nvidia.com/optimizing-gpu-performance-tensor-cores/) +- GTC Talk: [Tensor Core Deep Learning Performance Guide](https://developer.download.nvidia.com/video/gputechconf/gtc/2019/presentation/s9926-tensor-core-performance-the-ultimate-guide.pdf) + +For both Tensor Core and non-Tensor Core Deep Learning performance optimization tips, see NVIDIA's [Deep Learning Performance Guide](https://docs.nvidia.com/deeplearning/sdk/dl-performance-guide/index.html). + +### TODOs +1. The support for conv transpose is currently missing. +2. PyProf currently works only with NvProf, but Nsight Compute support will be added in the future. + +### Example + +1. Run `nvprof` on the LeNet model in `examples/lenet.py`. This will output a SQL file called `net.sql`. + +```sh +nvprof -f -o net.sql --profile-from-start off -- python examples/lenet.py +``` + +**Note**: DO NOT add --analysis-metrics since that will change which table nvprof writes the kernels to (`CUPTI_ACTIVITY_KIND_KERNEL` instead of the usual `CUPTI_ACTIVITY_KIND_CONCURRENT_KERNEL`). Support for running with metrics may be added in the future. + +If you don't care about a full correlation analysis and you'd just like to view the timeline with detailed NVTX annotations, you can do so, e.g. in the NVIDIA Visual Profiler (NVVP). For example, you can call `nvvp net.sql` to view the annotated timeline. + +2. Run the `parse.py` script on `net.sql` to extract kernel and runtime information and +save it as `net.dict`. + +```sh +python -m apex.pyprof.parse net.sql > net.dict +``` + +This will produce a text file, which can be parsed by any external tool, but it can also be directly read one line at a time by Python by calling `eval` on the line being read. + +**Note: you do not need to process this output manually.** Here the output is just shown as an example of modularity - you can process the raw data yourself, or let the next step enrich the information further and dump a CSV. + +The output of this step will look as follows. Note that the dictionary has a lot more keys than the ones shown in the example. + +``` +>>> with open('torchvision.resnet50.adam.64.dict') as f: +... for line in f: +... d = eval(line) +... print(d['kShortName'], d['op'], d['kDuration'], d['block'], d['grid'], d['device'], d['stream'], d['trace']) +... +nchwToNhwc3To4Kernel ['conv2d'] 376324 (256, 1, 1) (1568, 1, 64) 0 7 ['imagenet.py:137', 'imagenet.py:129', '/opt/conda/lib/python3.6/site-packages/torchvision/models/resnet.py:195'] +generic4Channel_kernel ['conv2d'] 10720 (512, 1, 1) (19, 1, 1) 0 7 ['imagenet.py:137', 'imagenet.py:129', '/opt/conda/lib/python3.6/site-packages/torchvision/models/resnet.py:195'] +first_layer_fwd_kernel ['conv2d'] 411204 (128, 1, 1) (2, 7, 64) 0 7 ['imagenet.py:137', 'imagenet.py:129', '/opt/conda/lib/python3.6/site-packages/torchvision/models/resnet.py:195'] +nhwcToNchwKernel ['conv2d'] 342371 (256, 1, 1) (392, 2, 64) 0 7 ['imagenet.py:137', 'imagenet.py:129', '/opt/conda/lib/python3.6/site-packages/torchvision/models/resnet.py:195'] +elementwise_kernel ['__iadd__'] 2816 (128, 1, 1) (1, 1, 1) 0 7 ['imagenet.py:137', 'imagenet.py:129', '/opt/conda/lib/python3.6/site-packages/torchvision/models/resnet.py:196'] +batch_norm_collect_statistics_kernel ['batch_norm', 'batch_norm'] 929513 (512, 1, 1) (64, 1, 1) 0 7 ['imagenet.py:137', 'imagenet.py:129', '/opt/conda/lib/python3.6/site-packages/torchvision/models/resnet.py:196'] +``` + +3. Run the `prof.py` script on `net.dict` to summarize the results into a CSV file, or to display the pretty-printed results on the screen. This step processes the raw output from step 2 to generate a nice output, but it also adds a lot of extra useful information inferred from the previous step, such as: +- FLOPs +- bandwidth (bytes in and out of GPU DRAM) +- tensor core usage + +```sh +python -m apex.pyprof.prof --csv net.dict > results.csv +``` + +You can choose which columns you'd like to display. Here's a list from calling `python -m apex.pyprof.prof -h`: + +``` + idx: Index + seq: PyTorch Sequence Id + altseq: PyTorch Alternate Sequence Id + tid: Thread Id + layer: User annotated NVTX string (can be nested) + trace: Function Call Trace + dir: Direction + sub: Sub Sequence Id + mod: Module + op: Operation + kernel: Kernel Name + params: Parameters + sil: Silicon Time (in ns) + tc: Tensor Core Usage + device: GPU Device Id + stream: Stream Id + grid: Grid Dimensions + block: Block Dimensions + flops: Floating point ops (FMA = 2 FLOPs) + bytes: Number of bytes in and out of DRAM +``` + +Let's have a look at the pretty-printed output: +``` +python -m apex.pyprof.prof -w 100 -c kernel,op,sil,tc,flops,bytes,device,stream,block,grid torchvision.resnet50.adam.64.dict + +Kernel Op Sil(ns) TC FLOPs Bytes Dev Str Block Grid +elementwise_kernel relu 381028 - 51380224 205520896 0 7 512,1,1 100352,1,1 +volta_fp16_s884cudn conv2d 160002 1 1644167168 51388416 0 7 256,1,1 784,1,1 +elementwise_kernel relu 96545 - 12845056 51380224 0 7 512,1,1 25088,1,1 +volta_fp16_s884cudn conv2d 346083 1 6576668672 128483328 0 7 256,1,1 784,2,1 +``` + +Not using the pretty-print width (`-w`) option and adding `--csv` results in a CSV output instead: + +``` +python -m apex.pyprof.prof --csv -c kernel,mod,op,dir,sil,tc,flops,bytes,device,stream,block,grid torchvision.resnet50.adam.64.dict + +"Kernel","Module","Op","Direction","Sil(ns)","TC","FLOPs","Bytes","Device","Stream","Block","Grid" +"nchwToNhwc3To4Kernel","torch.nn.functional","conv2d","fprop","376324","-","0","0","0","7","256,1,1","1568,1,64" +"generic4Channel_kernel","torch.nn.functional","conv2d","fprop","10720","-","0","0","0","7","512,1,1","19,1,1" +"first_layer_fwd_kernel","torch.nn.functional","conv2d","fprop","411204","-","0","0","0","7","128,1,1","2,7,64" +"nhwcToNchwKernel","torch.nn.functional","conv2d","fprop","342371","-","0","0","0","7","256,1,1","392,2,64" +"elementwise_kernel","Tensor","__iadd__","fprop","2816","-","1.0","8","0","7","128,1,1","1,1,1" +"batch_norm_collect_statistics_kernel","torch.nn.functional","batch_norm","fprop","929513","-","411041792","411041792","0","7","512,1,1","64,1,1" +"batch_norm_transform_input_kernel","torch.nn.functional","batch_norm","fprop","377539","-","411041792","411041792","0","7","512,1,1","64,64,1" +"elementwise_kernel","torch.nn.functional","relu","fprop","381028","-","51380224","205520896","0","7","512,1,1","100352,1,1" +"MaxPoolForward","torch.nn.functional","max_pool2d","fprop","406531","-","0","0","0","7","256,1,1","50176,1,1" +"cudnn::gemm::computeOffsetsKernel","torch.nn.functional","conv2d","fprop","2464","-","0","0","0","7","128,1,1","25,1,1" +``` + +### Hardware Counters + +Profiling GPU workloads may require access to [hardware performance counters]([https://en.wikipedia.org/wiki/Hardware_performance_counter](https://en.wikipedia.org/wiki/Hardware_performance_counter)). Due to a [fix](https://nvidia.custhelp.com/app/answers/detail/a_id/4738) in recent NVIDIA drivers addressing [CVE‑2018‑6260](https://nvd.nist.gov/vuln/detail/CVE-2018-6260), the hardware counters are disabled by default, and require elevated privileges to be enabled again. If you're using a recent driver, you may see the following message when trying to run nvprof: + +```**_ERR_NVGPUCTRPERM The user running does not have permission to access NVIDIA GPU Performance Counters on the target device._**``` + +For details, see [here](https://developer.nvidia.com/nvidia-development-tools-solutions-ERR_NVGPUCTRPERM-permission-issue-performance-counters). + +_Permanent solution_ + +Follow the steps [here]([https://developer.nvidia.com/nvidia-development-tools-solutions-ERR_NVGPUCTRPERM-permission-issue-performance-counters](https://developer.nvidia.com/nvidia-development-tools-solutions-ERR_NVGPUCTRPERM-permission-issue-performance-counters)). The current steps for Linux are: +``` +sudo systemctl isolate multi-user +sudo modprobe -r nvidia_uvm nvidia_drm nvidia_modeset nvidia-vgpu-vfio nvidia +sudo modprobe nvidia NVreg_RestrictProfilingToAdminUsers=0 +sudo systemctl isolate graphical +``` +The above steps should result in a permanent change. + +_Temporary solution_ + +When running on bare metal, you can run nvprof with `sudo`. + +If you're running in a Docker image, you can temporarily elevate your privileges with one of the following (oldest to newest syntax): +
+nvidia-docker run --privileged
+docker run --runtime nvidia --privileged
+docker run --gpus all --privileged
+
diff --git a/apex/apex/pyprof/__init__.py b/apex/apex/pyprof/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..3c36146fd77fd51373fc23ee4517a44311742e8d --- /dev/null +++ b/apex/apex/pyprof/__init__.py @@ -0,0 +1,3 @@ +import warnings + +from . import nvtx, prof diff --git a/apex/apex/pyprof/examples/.gitignore b/apex/apex/pyprof/examples/.gitignore new file mode 100644 index 0000000000000000000000000000000000000000..b6e239e2ee543532bda9e5d70f37535b948fad53 --- /dev/null +++ b/apex/apex/pyprof/examples/.gitignore @@ -0,0 +1,4 @@ +__pycache__ +*.sql +*.dict +*.csv diff --git a/apex/apex/pyprof/examples/apex/README.md b/apex/apex/pyprof/examples/apex/README.md new file mode 100644 index 0000000000000000000000000000000000000000..6af798d3431502c0d578a38cdb0e81948113f617 --- /dev/null +++ b/apex/apex/pyprof/examples/apex/README.md @@ -0,0 +1 @@ +This directory has examples of how to use `pyprof` with APEX extensions e.g. `fused_adam_cuda` and `fused_layer_norm_cuda`. diff --git a/apex/apex/pyprof/examples/apex/fused_adam.py b/apex/apex/pyprof/examples/apex/fused_adam.py new file mode 100644 index 0000000000000000000000000000000000000000..0da8b3f1ce27fd467ff5bd061b18748f48f1d881 --- /dev/null +++ b/apex/apex/pyprof/examples/apex/fused_adam.py @@ -0,0 +1,20 @@ +import torch +import fused_adam_cuda +from apex.optimizers import FusedAdam, FP16_Optimizer +from apex import pyprof + +pyprof.nvtx.init() +pyprof.nvtx.wrap(fused_adam_cuda, 'adam') + +model = torch.nn.Linear(10, 20).cuda().half() +criterion = torch.nn.CrossEntropyLoss().cuda() +optimizer = FusedAdam(model.parameters()) +optimizer = FP16_Optimizer(optimizer) + +x = torch.ones(32, 10).cuda().half() +target = torch.empty(32, dtype=torch.long).random_(20).cuda() +y = model(x) +loss = criterion(y, target) +optimizer.zero_grad() +loss.backward() +optimizer.step() diff --git a/apex/apex/pyprof/examples/apex/fused_layer_norm.py b/apex/apex/pyprof/examples/apex/fused_layer_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..2c924e4722ff89dfaca5412f35c8096c79e85eb9 --- /dev/null +++ b/apex/apex/pyprof/examples/apex/fused_layer_norm.py @@ -0,0 +1,28 @@ +import torch +import fused_layer_norm_cuda +from apex.normalization import FusedLayerNorm +from apex import pyprof + +pyprof.nvtx.init() +pyprof.nvtx.wrap(fused_layer_norm_cuda, 'forward') +pyprof.nvtx.wrap(fused_layer_norm_cuda, 'backward') +pyprof.nvtx.wrap(fused_layer_norm_cuda, 'forward_affine') +pyprof.nvtx.wrap(fused_layer_norm_cuda, 'backward_affine') + +input = torch.randn(20, 5, 10, 10).cuda() + +# With Learnable Parameters +m = FusedLayerNorm(input.size()[1:]).cuda() +output = m(input) + +# Without Learnable Parameters +m = FusedLayerNorm(input.size()[1:], elementwise_affine=False).cuda() +output = m(input) + +# Normalize over last two dimensions +m = FusedLayerNorm([10, 10]).cuda() +output = m(input) + +# Normalize over last dimension of size 10 +m = FusedLayerNorm(10).cuda() +output = m(input) diff --git a/apex/apex/pyprof/examples/apex/test.sh b/apex/apex/pyprof/examples/apex/test.sh new file mode 100755 index 0000000000000000000000000000000000000000..dc02f388d5e29f42a1b81b34897f04cba236ff3a --- /dev/null +++ b/apex/apex/pyprof/examples/apex/test.sh @@ -0,0 +1,30 @@ +#!/bin/bash + +set -e + +SCRIPT=`realpath $0` +SCRIPTPATH=`dirname $SCRIPT` +PYPROF="$SCRIPTPATH/../.." + +parse="python $PYPROF/parse/parse.py" +prof="python $PYPROF/prof/prof.py" + +for f in *.py +do + base=`basename $f .py` + sql=$base.sql + dict=$base.dict + + #NVprof + echo "nvprof -fo $sql python $f" + nvprof -fo $sql python $f + + #Parse + echo $parse $sql + $parse $sql > $dict + + #Prof + echo $prof $dict + $prof -w 130 $dict + \rm $sql $dict +done diff --git a/apex/apex/pyprof/examples/custom_func_module/README.md b/apex/apex/pyprof/examples/custom_func_module/README.md new file mode 100644 index 0000000000000000000000000000000000000000..695b02b3b8c2c1e88ce9cb65c62b98f7f89edafa --- /dev/null +++ b/apex/apex/pyprof/examples/custom_func_module/README.md @@ -0,0 +1 @@ +This directory has examples which show how to intercept (monkey patch) custom functions and modules with `pyprof`. No changes are required in `pyprof/parse`, however, users can add support for bytes and flops calculation for custom functions and modules in `pyprof/prof` by extending the `OperatorLayerBase` class. diff --git a/apex/apex/pyprof/examples/custom_func_module/custom_function.py b/apex/apex/pyprof/examples/custom_func_module/custom_function.py new file mode 100644 index 0000000000000000000000000000000000000000..535df2fc24a1a311e809e5de55291afd9cb106c4 --- /dev/null +++ b/apex/apex/pyprof/examples/custom_func_module/custom_function.py @@ -0,0 +1,33 @@ +#!/usr/bin/env python3 + +import torch +import torch.cuda.profiler as profiler +from apex import pyprof +#Initialize pyprof +pyprof.nvtx.init() + +class Foo(torch.autograd.Function): + @staticmethod + def forward(ctx, in1, in2): + out = in1 + in2 #This could be a custom C/C++ function. + return out + + @staticmethod + def backward(ctx, grad): + in1_grad = grad #This could be a custom C/C++ function. + in2_grad = grad #This could be a custom C/C++ function. + return in1_grad, in2_grad + +#Hook the forward and backward functions to pyprof +pyprof.nvtx.wrap(Foo, 'forward') +pyprof.nvtx.wrap(Foo, 'backward') + +foo = Foo.apply + +x = torch.ones(4,4).cuda() +y = torch.ones(4,4).cuda() + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + z = foo(x,y) + profiler.stop() diff --git a/apex/apex/pyprof/examples/custom_func_module/custom_module.py b/apex/apex/pyprof/examples/custom_func_module/custom_module.py new file mode 100644 index 0000000000000000000000000000000000000000..c03f5cf3d256edae89592c9d864bdb61245bb293 --- /dev/null +++ b/apex/apex/pyprof/examples/custom_func_module/custom_module.py @@ -0,0 +1,27 @@ +#!/usr/bin/env python3 + +import torch +import torch.cuda.profiler as profiler +from apex import pyprof +pyprof.nvtx.init() + +class Foo(torch.nn.Module): + def __init__(self, size): + super(Foo, self).__init__() + self.n = torch.nn.Parameter(torch.ones(size)) + self.m = torch.nn.Parameter(torch.ones(size)) + + def forward(self, input): + return self.n*input + self.m + +#Hook the forward function to pyprof +pyprof.nvtx.wrap(Foo, 'forward') + +foo = Foo(4) +foo.cuda() +x = torch.ones(4).cuda() + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + z = foo(x) + profiler.stop() diff --git a/apex/apex/pyprof/examples/custom_func_module/test.sh b/apex/apex/pyprof/examples/custom_func_module/test.sh new file mode 100755 index 0000000000000000000000000000000000000000..dc02f388d5e29f42a1b81b34897f04cba236ff3a --- /dev/null +++ b/apex/apex/pyprof/examples/custom_func_module/test.sh @@ -0,0 +1,30 @@ +#!/bin/bash + +set -e + +SCRIPT=`realpath $0` +SCRIPTPATH=`dirname $SCRIPT` +PYPROF="$SCRIPTPATH/../.." + +parse="python $PYPROF/parse/parse.py" +prof="python $PYPROF/prof/prof.py" + +for f in *.py +do + base=`basename $f .py` + sql=$base.sql + dict=$base.dict + + #NVprof + echo "nvprof -fo $sql python $f" + nvprof -fo $sql python $f + + #Parse + echo $parse $sql + $parse $sql > $dict + + #Prof + echo $prof $dict + $prof -w 130 $dict + \rm $sql $dict +done diff --git a/apex/apex/pyprof/examples/imagenet/imagenet.py b/apex/apex/pyprof/examples/imagenet/imagenet.py new file mode 100644 index 0000000000000000000000000000000000000000..79cd4ecf979d4e588db6a7348fda2a260c7a3b76 --- /dev/null +++ b/apex/apex/pyprof/examples/imagenet/imagenet.py @@ -0,0 +1,135 @@ +#!/usr/bin/env python3 + +""" +Example to run pyprof with imagenet models. +""" + +import sys +import torch +import torch.nn as nn +import torchvision.models as models +import torch.cuda.profiler as profiler +import argparse + +from apex import pyprof +from apex.optimizers import FusedAdam + +def parseArgs(): + parser = argparse.ArgumentParser(prog=sys.argv[0], description="Run popular imagenet models.") + + parser.add_argument("-m", + type=str, + default="resnet50", + choices=["alexnet", "densenet121", "densenet161", "densenet169", "densenet201", "googlenet", "mnasnet0_5", "mnasnet0_75", "mnasnet1_0", "mnasnet1_3", "mobilenet_v2", "resnet18", "resnet34", "resnet50", "resnet101", "resnet152", "resnext50_32x4d", "resnext101_32x8d", "wide_resnet50_2", "wide_resnet101_2", "shufflenet_v2_x0_5", "shufflenet_v2_x1_0", "shufflenet_v2_x1_5", "shufflenet_v2_x2_0", "squeezenet1_0", "squeezenet1_1", "vgg11", "vgg11_bn", "vgg13", "vgg13_bn", "vgg16", "vgg16_bn", "vgg19", "vgg19_bn", "inception_v3"], + help="Model.") + + parser.add_argument("-b", + type=int, + default=32, + help="Batch size.") + + parser.add_argument("-o", + type=str, + default="adam", + choices=["adam", "sgd"], + help="Optimizer.") + + args = parser.parse_args() + return args + +d = { + "alexnet": {'H': 224, 'W': 224, 'opts': {}}, + + "densenet121": {'H': 224, 'W': 224, 'opts': {}}, + "densenet161": {'H': 224, 'W': 224, 'opts': {}}, + "densenet169": {'H': 224, 'W': 224, 'opts': {}}, + "densenet201": {'H': 224, 'W': 224, 'opts': {}}, + + "googlenet": {'H': 224, 'W': 224, 'opts': {'aux_logits': False}}, + + "mnasnet0_5": {'H': 224, 'W': 224, 'opts': {}}, + "mnasnet0_75": {'H': 224, 'W': 224, 'opts': {}}, + "mnasnet1_0": {'H': 224, 'W': 224, 'opts': {}}, + "mnasnet1_3": {'H': 224, 'W': 224, 'opts': {}}, + + "mobilenet_v2": {'H': 224, 'W': 224, 'opts': {}}, + + "resnet18": {'H': 224, 'W': 224, 'opts': {}}, + "resnet34": {'H': 224, 'W': 224, 'opts': {}}, + "resnet50": {'H': 224, 'W': 224, 'opts': {}}, + "resnet101": {'H': 224, 'W': 224, 'opts': {}}, + "resnet152": {'H': 224, 'W': 224, 'opts': {}}, + + "resnext50_32x4d": {'H': 224, 'W': 224, 'opts': {}}, + "resnext101_32x8d": {'H': 224, 'W': 224, 'opts': {}}, + + "wide_resnet50_2": {'H': 224, 'W': 224, 'opts': {}}, + "wide_resnet101_2": {'H': 224, 'W': 224, 'opts': {}}, + + "shufflenet_v2_x0_5": {'H': 224, 'W': 224, 'opts': {}}, + "shufflenet_v2_x1_0": {'H': 224, 'W': 224, 'opts': {}}, + "shufflenet_v2_x1_5": {'H': 224, 'W': 224, 'opts': {}}, + "shufflenet_v2_x2_0": {'H': 224, 'W': 224, 'opts': {}}, + + "squeezenet1_0": {'H': 224, 'W': 224, 'opts': {}}, + "squeezenet1_1": {'H': 224, 'W': 224, 'opts': {}}, + + "vgg11": {'H': 224, 'W': 224, 'opts': {}}, + "vgg11_bn": {'H': 224, 'W': 224, 'opts': {}}, + "vgg13": {'H': 224, 'W': 224, 'opts': {}}, + "vgg13_bn": {'H': 224, 'W': 224, 'opts': {}}, + "vgg16": {'H': 224, 'W': 224, 'opts': {}}, + "vgg16_bn": {'H': 224, 'W': 224, 'opts': {}}, + "vgg19": {'H': 224, 'W': 224, 'opts': {}}, + "vgg19_bn": {'H': 224, 'W': 224, 'opts': {}}, + + "inception_v3": {'H': 299, 'W': 299, 'opts': {'aux_logits': False}}, + } + +def main(): + args = parseArgs() + + pyprof.nvtx.init() +# pyprof.nvtx.wrap(fused_adam_cuda, 'adam') + + N = args.b + C = 3 + H = d[args.m]['H'] + W = d[args.m]['W'] + opts = d[args.m]['opts'] + classes = 1000 + + net = getattr(models, args.m) + net = net(**opts).cuda().half() + net.train() + + x = torch.rand(N, C, H, W).cuda().half() + target = torch.empty(N, dtype=torch.long).random_(classes).cuda() + + criterion = nn.CrossEntropyLoss().cuda() + if (args.o == "sgd"): + optimizer = torch.optim.SGD(net.parameters(), lr = 0.01, momentum=0.9) + elif (args.o == "adam"): + optimizer = FusedAdam(net.parameters()) + else: + assert False + + #Warm up without profiler + for i in range(2): + output = net(x) + loss = criterion(output, target) + optimizer.zero_grad() + loss.backward() + optimizer.step() + + with torch.autograd.profiler.emit_nvtx(): + profiler.start() + output = net(x) + loss = criterion(output, target) + optimizer.zero_grad() + loss.backward() + optimizer.step() + profiler.stop() + +if __name__ == "__main__": + main() diff --git a/apex/apex/pyprof/examples/imagenet/test.sh b/apex/apex/pyprof/examples/imagenet/test.sh new file mode 100755 index 0000000000000000000000000000000000000000..0c44c05bb89bdcca9824ea716f33d15f7b725b02 --- /dev/null +++ b/apex/apex/pyprof/examples/imagenet/test.sh @@ -0,0 +1,36 @@ +#!/bin/bash + +set -e + +SCRIPT=`realpath $0` +SCRIPTPATH=`dirname $SCRIPT` +PYPROF="$SCRIPTPATH/../.." + +parse="python -m apex.pyprof.parse" +prof="python -m apex.pyprof.prof" + +for net in "resnet50" +do + for optim in adam sgd + do + for batch in 32 64 + do + base="torchvision".$net.$optim.$batch + sql=$base.sql + dict=$base.dict + + #NVprof + echo "nvprof -fo $sql --profile-from-start off python imagenet.py -m ${net} -o $optim -b $batch" + nvprof -fo $sql --profile-from-start off python imagenet.py -m ${net} -o $optim -b $batch + + #Parse + echo $parse $sql + $parse $sql > $dict + + #Prof + echo $prof $dict + $prof -w 130 $dict +# \rm $sql $dict + done + done +done diff --git a/apex/apex/pyprof/examples/jit/README.md b/apex/apex/pyprof/examples/jit/README.md new file mode 100644 index 0000000000000000000000000000000000000000..101980f007df66de1e5d526cbf7c3d1658eaab9f --- /dev/null +++ b/apex/apex/pyprof/examples/jit/README.md @@ -0,0 +1,14 @@ +*As of this writing, these examples do not work +because of changes being proposed in PyTorch.* + +There are two ways to use PyTorch JIT + - Scripting + - Tracing + +In addition, we can JIT a + - Stand alone function + - Class / class method + +This directory has an example for each of the 4 cases. +Intercepting (monkey patching) JITted code has a few extra steps, +which are explained through comments. diff --git a/apex/apex/pyprof/examples/jit/jit_script_function.py b/apex/apex/pyprof/examples/jit/jit_script_function.py new file mode 100644 index 0000000000000000000000000000000000000000..0b692c8105847fcf64adf2c389399a642f646a70 --- /dev/null +++ b/apex/apex/pyprof/examples/jit/jit_script_function.py @@ -0,0 +1,30 @@ +#!/usr/bin/env python3 + +import torch +import torch.cuda.profiler as profiler +from apex import pyprof + +#The following creates an object "foo" of type ScriptModule +#The new object has a function called "forward" + +@torch.jit.script +def foo(x, y): + return torch.sigmoid(x) + y + +#Initialize pyprof after the JIT step +pyprof.nvtx.init() + +#Assign a name to the object "foo" +foo.__name__ = "foo" + +#Hook up the forward function to pyprof +pyprof.nvtx.wrap(foo, 'forward') + +x = torch.zeros(4,4).cuda() +y = torch.ones(4,4).cuda() + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + z = foo(x, y) + profiler.stop() + print(z) diff --git a/apex/apex/pyprof/examples/jit/jit_script_method.py b/apex/apex/pyprof/examples/jit/jit_script_method.py new file mode 100644 index 0000000000000000000000000000000000000000..79189c837e1ee8eb6096e9b607bca74ca395df05 --- /dev/null +++ b/apex/apex/pyprof/examples/jit/jit_script_method.py @@ -0,0 +1,31 @@ +#!/usr/bin/env python3 + +import torch +import torch.cuda.profiler as profiler +from apex import pyprof + +class Foo(torch.jit.ScriptModule): + def __init__(self, size): + super(Foo, self).__init__() + self.n = torch.nn.Parameter(torch.ones(size)) + self.m = torch.nn.Parameter(torch.ones(size)) + + @torch.jit.script_method + def forward(self, input): + return self.n*input + self.m + +#Initialize pyprof after the JIT step +pyprof.nvtx.init() + +#Hook up the forward function to pyprof +pyprof.nvtx.wrap(Foo, 'forward') + +foo = Foo(4) +foo.cuda() +x = torch.ones(4).cuda() + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + z = foo(x) + profiler.stop() + print(z) diff --git a/apex/apex/pyprof/examples/jit/jit_trace_function.py b/apex/apex/pyprof/examples/jit/jit_trace_function.py new file mode 100644 index 0000000000000000000000000000000000000000..06a781888ffaaef42e58f7b75303744917618a5d --- /dev/null +++ b/apex/apex/pyprof/examples/jit/jit_trace_function.py @@ -0,0 +1,30 @@ +#!/usr/bin/env python3 + +import torch +import torch.cuda.profiler as profiler +from apex import pyprof + +def foo(x, y): + return torch.sigmoid(x) + y + +x = torch.zeros(4,4).cuda() +y = torch.ones(4,4).cuda() + +#JIT the function using tracing +#This returns an object of type ScriptModule with a forward method. +traced_foo = torch.jit.trace(foo, (x,y)) + +#Initialize pyprof after the JIT step +pyprof.nvtx.init() + +#Assign a name to the object "traced_foo" +traced_foo.__dict__['__name__'] = "foo" + +#Hook up the forward function to pyprof +pyprof.nvtx.wrap(traced_foo, 'forward') + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + z = traced_foo(x, y) + profiler.stop() + print(z) diff --git a/apex/apex/pyprof/examples/jit/jit_trace_method.py b/apex/apex/pyprof/examples/jit/jit_trace_method.py new file mode 100644 index 0000000000000000000000000000000000000000..8a0d3fcecc76259b9b14bc956ad46802fb1f45a7 --- /dev/null +++ b/apex/apex/pyprof/examples/jit/jit_trace_method.py @@ -0,0 +1,36 @@ +#!/usr/bin/env python3 + +import torch +import torch.cuda.profiler as profiler +from apex import pyprof + +class Foo(torch.nn.Module): + def __init__(self, size): + super(Foo, self).__init__() + self.n = torch.nn.Parameter(torch.ones(size)) + self.m = torch.nn.Parameter(torch.ones(size)) + + def forward(self, input): + return self.n*input + self.m + +foo = Foo(4) +foo.cuda() +x = torch.ones(4).cuda() + +#JIT the class using tracing +traced_foo = torch.jit.trace(foo, x) + +#Initialize pyprof after the JIT step +pyprof.nvtx.init() + +#Assign a name to the object "traced_foo" +traced_foo.__dict__['__name__'] = "foo" + +#Hook up the forward function to pyprof +pyprof.nvtx.wrap(traced_foo, 'forward') + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + z = traced_foo(x) + profiler.stop() + print(z) diff --git a/apex/apex/pyprof/examples/jit/test.sh b/apex/apex/pyprof/examples/jit/test.sh new file mode 100755 index 0000000000000000000000000000000000000000..dc02f388d5e29f42a1b81b34897f04cba236ff3a --- /dev/null +++ b/apex/apex/pyprof/examples/jit/test.sh @@ -0,0 +1,30 @@ +#!/bin/bash + +set -e + +SCRIPT=`realpath $0` +SCRIPTPATH=`dirname $SCRIPT` +PYPROF="$SCRIPTPATH/../.." + +parse="python $PYPROF/parse/parse.py" +prof="python $PYPROF/prof/prof.py" + +for f in *.py +do + base=`basename $f .py` + sql=$base.sql + dict=$base.dict + + #NVprof + echo "nvprof -fo $sql python $f" + nvprof -fo $sql python $f + + #Parse + echo $parse $sql + $parse $sql > $dict + + #Prof + echo $prof $dict + $prof -w 130 $dict + \rm $sql $dict +done diff --git a/apex/apex/pyprof/examples/lenet.py b/apex/apex/pyprof/examples/lenet.py new file mode 100755 index 0000000000000000000000000000000000000000..9e22477eaf4077c75649d6a834dac99f0161d39f --- /dev/null +++ b/apex/apex/pyprof/examples/lenet.py @@ -0,0 +1,65 @@ +#!/usr/bin/env python3 + +import torch +import torch.nn as nn +import torch.nn.functional as F +import torch.cuda.profiler as profiler +import torch.optim as optim + +from apex import pyprof +pyprof.nvtx.init() + +class LeNet5(nn.Module): + def __init__(self): + super(LeNet5, self).__init__() + # 1 input image channel, 6 output channels, 5x5 square convolution + # kernel + self.conv1 = nn.Conv2d(1, 6, 5) + self.conv2 = nn.Conv2d(6, 16, 5) + # an affine operation: y = Wx + b + self.fc1 = nn.Linear(16 * 5 * 5, 120) + self.fc2 = nn.Linear(120, 84) + self.fc3 = nn.Linear(84, 10) + + def forward(self, x): + # Max pooling over a (2, 2) window + x = F.max_pool2d(F.relu(self.conv1(x)), (2, 2)) + # If the size is a square you can only specify a single number + x = F.max_pool2d(F.relu(self.conv2(x)), 2) + x = x.view(-1, self.num_flat_features(x)) + x = F.relu(self.fc1(x)) + x = F.relu(self.fc2(x)) + x = self.fc3(x) + return x + + def num_flat_features(self, x): + size = x.size()[1:] # all dimensions except the batch dimension + num_features = 1 + for s in size: + num_features *= s + return num_features + +with torch.autograd.profiler.emit_nvtx(): + + net = LeNet5().cuda() + + input = torch.randn(1, 1, 32, 32).cuda() + out = net(input) + + target = torch.randn(10) # a dummy target, for example + target = target.view(1, -1).cuda() # make it the same shape as output + criterion = nn.MSELoss() + + # create your optimizer + optimizer = optim.SGD(net.parameters(), lr=0.01) + + # in your training loop: + optimizer.zero_grad() # zero the gradient buffers + + profiler.start() + output = net(input) + loss = criterion(output, target) + loss.backward() + optimizer.step() # Does the update + profiler.stop() + diff --git a/apex/apex/pyprof/examples/operators.py b/apex/apex/pyprof/examples/operators.py new file mode 100755 index 0000000000000000000000000000000000000000..a033c2ef4754c9787a28ab761ee00ec5cc78d3f5 --- /dev/null +++ b/apex/apex/pyprof/examples/operators.py @@ -0,0 +1,145 @@ +#!/usr/bin/env python3 + +""" +This file checks all Python operators. +""" + +import sys +import torch +import torch.cuda.profiler as profiler +import operator +import inspect + +#Import and initialize pyprof +from apex import pyprof +pyprof.nvtx.init() + +X = 1024 +Y = 1024 + +fa = torch.rand(X, Y).cuda() +fb = torch.rand(X, Y).cuda() +fc = torch.rand(X, Y).cuda() + +ia = torch.randint(0, 100, (X, Y)).cuda() +ib = torch.randint(0, 100, (X, Y)).cuda() + +sa = torch.ones(1,1).cuda() +sb = torch.ones(1,1).cuda() + +ba = fa.byte() + +unaryOps = ["abs", "__abs__", "neg", "__neg__",] +invertOps = ["inv", "invert", "__inv__", "__invert__",] #imlemented only for byte tensors +#pos, __pos__ is not implemented for tensors + +binaryOps = [] +binaryOps += [ "lt", "__lt__", "le", "__le__", "eq", "__eq__", "ne", "__ne__", "ge", "__ge__", "gt", "__gt__" ] +binaryOps += [ "add", "__add__", "sub", "__sub__", "mul", "__mul__", "floordiv", "__floordiv__", "truediv", "__truediv__", "pow", "__pow__", "mod", "__mod__"] +binaryOps += [ "and_", "__and__", "or_", "__or__", "xor", "__xor__", "lshift", "__lshift__", "rshift", "__rshift__"] + +inplaceOps = [] +inplaceOps += ["iadd", "__iadd__", "isub", "__isub__", "imul", "__imul__", "ifloordiv", "__ifloordiv__", "itruediv", "__itruediv__", "imod", "__imod__",] +#ipow, __ipow__ is not implemented in pytorch +inplaceOps += [ "iand", "__iand__", "ior", "__ior__", "ixor", "__ixor__", "ilshift", "__ilshift__", "irshift", "__irshift__",] + +matmulOps = [ "matmul", "__matmul__" ] +inplacematmulOps = [ "imatmul", "__imatmul__" ] + +reverseIntBinaryOps = ["__radd__", "__rsub__", "__rmul__", "__rfloordiv__", "__rpow__",] +reverseFloatBinaryOps = ["__radd__", "__rsub__", "__rmul__", "__rdiv__", "__rtruediv__", "__rfloordiv__", "__rpow__",] + +''' +TODO +.concat(a, b) +.__concat__(a, b) +.contains(a, b) +.__contains__(a, b) +.countOf(a, b) +.delitem(a, b) +.__delitem__(a, b) +.getitem(a, b) +.__getitem__(a, b) +.indexOf(a, b) +.setitem(a, b, c) +.__setitem__(a, b, c) +.length_hint(obj, default=0) +.iconcat(a, b) +.__iconcat__(a, b) +.index(a) +.__index__(a) +''' + +#Context manager +with torch.autograd.profiler.emit_nvtx(): + + #Start profiler + profiler.start() + + for op in unaryOps: + assert hasattr(operator, op) + f = getattr(operator, op) + assert inspect.isbuiltin(f) + c = f(ia) + + for op in invertOps: + assert hasattr(operator, op) + f = getattr(operator, op) + assert inspect.isbuiltin(f) + c = f(ba) + + for op in binaryOps: + assert hasattr(operator, op) + f = getattr(operator, op) + assert inspect.isbuiltin(f) + c = f(ia, ib) + c = f(ia, 2) + + for op in inplaceOps: + assert hasattr(operator, op) + f = getattr(operator, op) + assert inspect.isbuiltin(f) + ia = f(ia, ib) + ia = f(ia, 2) + + for op in matmulOps: + assert hasattr(operator, op) + f = getattr(operator, op) + assert inspect.isbuiltin(f) + c = f(fa, fb) + + for op in inplacematmulOps: + assert hasattr(operator, op) + f = getattr(operator, op) + assert inspect.isbuiltin(f) + fa = f(fa, fb) + + for op in reverseIntBinaryOps: + assert hasattr(torch.Tensor, op) + f = getattr(torch.Tensor, op) + ia = f(ia, ib) + + for op in reverseFloatBinaryOps: + assert hasattr(torch.Tensor, op) + f = getattr(torch.Tensor, op) + fa = f(fa, fb) + + ''' + #c = fa[3] + #c = fa[3][3] + #c = torch.min(fa, 3) + c = torch.sum(fa) + c = torch.max(fa) + c = -fa + #fc[2][2] = fa[2][2] + + c = a_scalar and b_scalar + c = a_scalar or b_scalar + c = not a_scalar + + c = a is b + c = a is not b + ''' + + #Stop profiler + profiler.stop() diff --git a/apex/apex/pyprof/examples/simple.py b/apex/apex/pyprof/examples/simple.py new file mode 100755 index 0000000000000000000000000000000000000000..dbe9c615fa1a0e5ee390644f8ae48c830342d8ae --- /dev/null +++ b/apex/apex/pyprof/examples/simple.py @@ -0,0 +1,38 @@ +#!/usr/bin/env python3 + +""" +This simple file provides an example of how to + - import the pyprof library and initialize it + - use the emit_nvtx context manager + - start and stop the profiler + +Only kernels within profiler.start and profiler.stop calls are profiled. +To profile +$ nvprof -f -o simple.sql --profile-from-start off ./simple.py +""" + +import sys +import torch +import torch.cuda.profiler as profiler + +#Import and initialize pyprof +from apex import pyprof +pyprof.nvtx.init() + +a = torch.randn(5, 5).cuda() +b = torch.randn(5, 5).cuda() + +#Context manager +with torch.autograd.profiler.emit_nvtx(): + + #Start profiler + profiler.start() + + c = a + b + c = torch.mul(a,b) + c = torch.matmul(a,b) + c = torch.argmax(a, dim=1) + c = torch.nn.functional.pad(a, (1,1)) + + #Stop profiler + profiler.stop() diff --git a/apex/apex/pyprof/examples/user_annotation/README.md b/apex/apex/pyprof/examples/user_annotation/README.md new file mode 100644 index 0000000000000000000000000000000000000000..30523615a3f48521b26b6c6127ac9e33c2126fc6 --- /dev/null +++ b/apex/apex/pyprof/examples/user_annotation/README.md @@ -0,0 +1,21 @@ +Nvidia NVTX range markers (https://docs.nvidia.com/gameworks/content/gameworkslibrary/nvtx/nvidia_tools_extension_library_nvtx.htm) +are a useful tool to capture and observe events and code ranges etc. +Using PyTorch APIs e.g, `torch.cuda.nvtx.range_push("xxx")` and `torch.cuda.nvtx.range_pop()` users can easily add their own NVTX range markers. These markers can then be observed in the Nvidia Visual Profiler (NVVP). + +While inserting NVTX markers (strings), if the users follow a specific string pattern `"layer:your_string_here"` e.g. `"layer:conv1"` or `"layer:encoder_layer_3_self_attention`, then `pyprof` will display the strings `conv1` and `encoder_layer_3_self_attention` next to the associated kernels in the output of `prof.py` when used with the `-c layer` option. + +NVTX range markers can be nested and if users follow the above string pattern, the output of `prof.py` will show all the markers associated with a kernel. + +The file `resnet.py` (a simplified version of the torchvision model) shows an example of how users can add (nested) NVTX markers with information which can greatly aid in understanding and analysis of networks. + +Note that the pattern `"layer:your_string_here"` was chosen to aid information extraction by `pyprof`. The tool will work seamlessly even if there are other markers or no markers at all. + +### To run + +```sh +nvprof -fo resnet.sql --profile-from-start off python resnet.py +parse.py resnet.sql > resnet.dict +prof.py --csv -c idx,layer,dir,mod,op,kernel,params,sil resnet.dict +``` + +The file `resnet.sql` can also be opened with NVVP as usual. diff --git a/apex/apex/pyprof/examples/user_annotation/resnet.py b/apex/apex/pyprof/examples/user_annotation/resnet.py new file mode 100644 index 0000000000000000000000000000000000000000..ec351aa974d55be6b023b988d520a61baecee9ac --- /dev/null +++ b/apex/apex/pyprof/examples/user_annotation/resnet.py @@ -0,0 +1,215 @@ +#!/usr/bin/env python3 + +""" +An example showing use of nested NVTX markers. +""" + +import torch +import torch.nn as nn + +import torch.cuda.profiler as profiler +import torch.cuda.nvtx as nvtx +from apex import pyprof +pyprof.nvtx.init() + +def conv3x3(in_planes, out_planes, stride=1, groups=1, dilation=1): + """3x3 convolution with padding""" + return nn.Conv2d(in_planes, out_planes, kernel_size=3, stride=stride, + padding=dilation, groups=groups, bias=False, dilation=dilation) + +def conv1x1(in_planes, out_planes, stride=1): + """1x1 convolution""" + return nn.Conv2d(in_planes, out_planes, kernel_size=1, stride=stride, bias=False) + +class Bottleneck(nn.Module): + expansion = 4 + count = 1 + + def __init__(self, inplanes, planes, stride=1, downsample=None, groups=1, + base_width=64, dilation=1, norm_layer=None): + super(Bottleneck, self).__init__() + if norm_layer is None: + norm_layer = nn.BatchNorm2d + width = int(planes * (base_width / 64.)) * groups + # Both self.conv2 and self.downsample layers downsample the input when stride != 1 + self.conv1 = conv1x1(inplanes, width) + self.bn1 = norm_layer(width) + self.conv2 = conv3x3(width, width, stride, groups, dilation) + self.bn2 = norm_layer(width) + self.conv3 = conv1x1(width, planes * self.expansion) + self.bn3 = norm_layer(planes * self.expansion) + self.relu = nn.ReLU(inplace=True) + self.downsample = downsample + self.stride = stride + + self.id = Bottleneck.count + Bottleneck.count += 1 + + def forward(self, x): + identity = x + + nvtx.range_push("layer:Bottleneck_{}".format(self.id)) + + nvtx.range_push("layer:Conv1") + out = self.conv1(x) + nvtx.range_pop() + + nvtx.range_push("layer:BN1") + out = self.bn1(out) + nvtx.range_pop() + + nvtx.range_push("layer:ReLU") + out = self.relu(out) + nvtx.range_pop() + + nvtx.range_push("layer:Conv2") + out = self.conv2(out) + nvtx.range_pop() + + nvtx.range_push("layer:BN2") + out = self.bn2(out) + nvtx.range_pop() + + nvtx.range_push("layer:ReLU") + out = self.relu(out) + nvtx.range_pop() + + nvtx.range_push("layer:Conv3") + out = self.conv3(out) + nvtx.range_pop() + + nvtx.range_push("layer:BN3") + out = self.bn3(out) + nvtx.range_pop() + + if self.downsample is not None: + nvtx.range_push("layer:Downsample") + identity = self.downsample(x) + nvtx.range_pop() + + nvtx.range_push("layer:Residual") + out += identity + nvtx.range_pop() + + nvtx.range_push("layer:ReLU") + out = self.relu(out) + nvtx.range_pop() + + nvtx.range_pop() + + return out + +class ResNet(nn.Module): + + def __init__(self, block, layers, num_classes=1000, + groups=1, width_per_group=64, norm_layer=None): + super(ResNet, self).__init__() + if norm_layer is None: + norm_layer = nn.BatchNorm2d + self._norm_layer = norm_layer + + self.inplanes = 64 + self.dilation = 1 + + self.groups = groups + self.base_width = width_per_group + self.conv1 = nn.Conv2d(3, self.inplanes, kernel_size=7, stride=2, padding=3, bias=False) + self.bn1 = norm_layer(self.inplanes) + self.relu = nn.ReLU(inplace=True) + self.maxpool = nn.MaxPool2d(kernel_size=3, stride=2, padding=1) + self.layer1 = self._make_layer(block, 64, layers[0]) + self.layer2 = self._make_layer(block, 128, layers[1], stride=2) + self.layer3 = self._make_layer(block, 256, layers[2], stride=2) + self.layer4 = self._make_layer(block, 512, layers[3], stride=2) + self.avgpool = nn.AdaptiveAvgPool2d((1, 1)) + self.fc = nn.Linear(512 * block.expansion, num_classes) + + for m in self.modules(): + if isinstance(m, nn.Conv2d): + nn.init.kaiming_normal_(m.weight, mode='fan_out', nonlinearity='relu') + elif isinstance(m, (nn.BatchNorm2d, nn.GroupNorm)): + nn.init.constant_(m.weight, 1) + nn.init.constant_(m.bias, 0) + + def _make_layer(self, block, planes, blocks, stride=1, dilate=False): + norm_layer = self._norm_layer + downsample = None + previous_dilation = self.dilation + if dilate: + self.dilation *= stride + stride = 1 + if stride != 1 or self.inplanes != planes * block.expansion: + downsample = nn.Sequential( + conv1x1(self.inplanes, planes * block.expansion, stride), + norm_layer(planes * block.expansion), + ) + + layers = [] + layers.append(block(self.inplanes, planes, stride, downsample, self.groups, + self.base_width, previous_dilation, norm_layer)) + self.inplanes = planes * block.expansion + for _ in range(1, blocks): + layers.append(block(self.inplanes, planes, groups=self.groups, + base_width=self.base_width, dilation=self.dilation, + norm_layer=norm_layer)) + + return nn.Sequential(*layers) + + def forward(self, x): + + nvtx.range_push("layer:conv1_x") + x = self.conv1(x) + x = self.bn1(x) + x = self.relu(x) + x = self.maxpool(x) + nvtx.range_pop() + + nvtx.range_push("layer:conv2_x") + x = self.layer1(x) + nvtx.range_pop() + + nvtx.range_push("layer:conv3_x") + x = self.layer2(x) + nvtx.range_pop() + + nvtx.range_push("layer:conv4_x") + x = self.layer3(x) + nvtx.range_pop() + + nvtx.range_push("layer:conv5_x") + x = self.layer4(x) + nvtx.range_pop() + + x = self.avgpool(x) + x = torch.flatten(x, 1) + + nvtx.range_push("layer:FC") + x = self.fc(x) + nvtx.range_pop() + + return x + + +def resnet50(): + return ResNet(Bottleneck, [3, 4, 6, 3]) + +#Create model +net = resnet50().cuda().half() +net.train() + +#Create optimizer +criterion = nn.CrossEntropyLoss().cuda() +optimizer = torch.optim.SGD(net.parameters(), lr = 0.01, momentum=0.9) + +#Create synthetic input and label +x = torch.rand(32, 3, 224, 224).cuda().half() +target = torch.empty(32, dtype=torch.long).random_(1000).cuda() + +with torch.autograd.profiler.emit_nvtx(): + profiler.start() + output = net(x) + loss = criterion(output, target) + optimizer.zero_grad() + loss.backward() + optimizer.step() + profiler.stop() diff --git a/apex/apex/pyprof/examples/user_annotation/test.sh b/apex/apex/pyprof/examples/user_annotation/test.sh new file mode 100755 index 0000000000000000000000000000000000000000..89b8eb0c842a23df23de431e8486a8158b53f9be --- /dev/null +++ b/apex/apex/pyprof/examples/user_annotation/test.sh @@ -0,0 +1,31 @@ +#!/bin/bash + +set -e + +SCRIPT=`realpath $0` +SCRIPTPATH=`dirname $SCRIPT` +PYPROF="$SCRIPTPATH/../.." + +parse="python $PYPROF/parse/parse.py" +prof="python $PYPROF/prof/prof.py" + +for f in *.py +do + base=`basename $f .py` + sql=$base.sql + dict=$base.dict + + #NVprof + echo "nvprof -fo --profile-from-start off $sql python $f" + nvprof -fo $sql --profile-from-start off python $f + + #Parse + echo $parse $sql + $parse $sql > $dict + + #Prof + echo $prof $dict + #$prof -w 130 $dict + $prof --csv -c idx,layer,dir,mod,op,kernel,params,sil $dict + \rm $sql $dict +done diff --git a/apex/apex/pyprof/nvtx/__init__.py b/apex/apex/pyprof/nvtx/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..774b4c24fad8028570e14ac45c2a2c31d7ec6121 --- /dev/null +++ b/apex/apex/pyprof/nvtx/__init__.py @@ -0,0 +1,2 @@ +from .nvmarker import init +from .nvmarker import add_wrapper as wrap diff --git a/apex/apex/pyprof/nvtx/nvmarker.py b/apex/apex/pyprof/nvtx/nvmarker.py new file mode 100644 index 0000000000000000000000000000000000000000..c4d99e3bb9ec78286b2e7a8d424ab6be734011ac --- /dev/null +++ b/apex/apex/pyprof/nvtx/nvmarker.py @@ -0,0 +1,222 @@ +""" +This file intercepts (monkey patches) the following functions and adds NVTX markers. + torch.* + torch.Tensor.* + torch.nn.functional.* + torch.nn.*.forward + +The NVTX markers (one or more) contain the following information + call trace (a list of file_name:line_number) + extra_repr() from torch.nn modules + module/class name + function name + inputs (args and kwargs) + scalar: name, type and value + tensor: name, shape and datatype + numpy: name, shape and datatype + list/tuple: a sequence of scalars or tensors or numpy arrays +""" + +import torch +import torch.cuda.nvtx as nvtx +import numpy +import inspect as ins +import traceback +import math + +def isfunc(mod, f): + assert hasattr(mod, f) + attr = getattr(mod, f) + + #Ignore functions like _add + if (len(f) >= 2): + if f[0] == "_" and f[1] != "_": + return False + + #Ignore functions from this list + ignore = ['__all__', '__array__', '__array_priority__', '__array_wrap__', '__bool__', '__builtins__', '__cached__', '__class__', '__deepcopy__', '__delattr__', '__delitem__', '__dict__', '__dir__', '__doc__', '__file__', '__format__', '__getattribute__', '__getitem__', '__hash__', '__index__', '__init__', '__init_subclass__', '__iter__', '__len__', '__loader__', '__module__', '__name__', '__new__', '__nonzero__', '__package__', '__path__', '__reduce__', '__reduce_ex__', '__repr__', '__reversed__', '__setattr__', '__setitem__', '__setstate__', '__sizeof__', '__spec__', '__str__', '__subclasshook__', '__version__', '__weakref__'] + + #Add functions to this list if they cause recursion + ignore += ['size', 'tolist', 'dim', 'is_storage', 'item'] + if f in ignore: + return False + + return ins.ismethod(attr) or ins.isfunction(attr) or ins.ismethoddescriptor(attr) or ins.isbuiltin(attr) + +def traceMarker(stack): + d = {} + cadena = [] + for i in range(len(stack)-1): + fi = stack[i] + t = "{}:{}".format(fi.filename, fi.lineno) + cadena.append(t) + d['traceMarker'] = cadena + return str(d) + +def modMarker(mod, fn_name, args): + """ + Returns the stringified extra_repr() of a module. + """ + assert(fn_name == 'forward') + assert(len(args) > 0) + d = {} + d['mod'] = mod.__name__ + d['strRepr'] = args[0].extra_repr() + return str(d) + +def add_wrapper(mod, fn_name): + assert isfunc(mod, fn_name) + + # Get a pointer to the original function + func = getattr(mod, fn_name) + + # Check if the mod has a string representation + # and is not a Script or Traced module (used by JIT) + s = hasattr(mod, "extra_repr") and (type(mod) is not torch.jit.ScriptModule) and (type(mod) is not torch.jit.TopLevelTracedModule) + + def wrapper_func(*args, **kwargs): + + # Extract the stacktrace + stack = traceback.extract_stack() + + # Push trace marker + nvtx.range_push(traceMarker(stack)) + + # Push module marker + if s: + m = modMarker(mod, fn_name, args) + nvtx.range_push(m) + + # Create and push argument marker + cadena = argMarker(mod, fn_name, args, kwargs) + nvtx.range_push(cadena) + + # Call the original function + result = func(*args, **kwargs) + + # Pop argumet marker + nvtx.range_pop() + + # Pop module marker + if s: + nvtx.range_pop() + + # Pop trace marker + nvtx.range_pop() + + return result + setattr(mod, fn_name, wrapper_func) + +def argMarker(mod, op, args, kwargs): + #For this function args is a tuple and kwargs is a dict + + def tensor(arg, name=""): + a = {} + a['name'] = name + a['type'] = "tensor" + a['shape'] = tuple(arg.size()) + a['dtype'] = str(arg.dtype).split(".")[-1] + cadena['args'].append(a) + + def ndarray(arg, name=""): + a = {} + a['name'] = name + a['type'] = "ndarray" + a['shape'] = arg.shape + a['dtype'] = str(arg.dtype).split(".")[-1] + cadena['args'].append(a) + + def seq(arg, name=""): + assert issequence(arg) + a = {} + a['name'] = name + if isinstance(arg, list): + a['type'] = "list" + a['value'] = arg + else: + a['type'] = "tuple" + # The arg could be torch.Size, which is a subclass of tuple + # Therefore, explicitly convert to tuple + a['value'] = tuple(arg) + + cadena['args'].append(a) + + def scalar(arg, name=""): + a = {} + a['name'] = name + a['type'] = type(arg).__name__ + #handle the case when the argument is +/- inf or nan + if arg == float('inf'): + a['value'] = "inf" + elif arg == float('-inf'): + a['value'] = "-inf" + elif isinstance(arg, float) and math.isnan(arg): + a['value'] = "nan" + else: + a['value'] = arg + cadena['args'].append(a) + + def isscalar(arg): + return (type(arg) is int) or (type(arg) is float) or (type(arg) is bool) or (arg is None) or (type(arg) is str) + + def issequence(arg): + return isinstance(arg, list) or isinstance(arg, tuple) + + def foo(args, name): + #args should be an iterable sequence e.g. list or tuple + for arg in args: + if isinstance(arg, torch.Tensor): + if arg.dim() == 0: + scalar(arg.item(), name) + else: + tensor(arg, name) + elif isinstance(arg, numpy.ndarray): + ndarray(arg, name) + elif (isscalar(arg)): + scalar(arg, name) + elif issequence(arg): + if (len(arg) == 0) or isscalar(arg[0]): #An empty sequence or a sequence of scalars + seq(arg, name) + else: # A sequence of tensors or numpy arrays + foo(arg, name) + ''' + else: + print("The following arg is none of Tensor, numpy array, scalar but a %s" % (str(type(arg)))) + print("Mod: %s" % str(mod.__name__)) + print("Op: %s" % str(op)) + print(dir(arg)) + ''' + + cadena = {} + cadena['mod'] = mod.__name__ + cadena['op'] = op + cadena['args'] = [] + + foo(args, "") + for k,v in kwargs.items(): + foo((v,), k) + + return str(cadena) + +def patchClass(cls): + for f in dir(cls): + if isfunc(cls, f): + add_wrapper(cls, f) + +def init(): + string = "\n\nPyprof has been moved to its own dedicated repository and will " + \ + "soon be removed from Apex. Please visit\n" + \ + "https://github.com/NVIDIA/PyProf\n" + \ + "for the latest version.\n\n" + # print regardless of warning state + print(string) + + print("Initializing NVTX monkey patches") + for cls in [torch, torch.Tensor, torch.nn.functional,]: + patchClass(cls) + + for cls in [torch.nn.RNN, torch.nn.RNNCell, torch.nn.LSTM, torch.nn.LSTMCell, torch.nn.GRU, torch.nn.GRUCell]: + if isfunc(cls, 'forward'): + add_wrapper(cls, 'forward') + + print("Done with NVTX monkey patching") diff --git a/apex/apex/pyprof/parse/__init__.py b/apex/apex/pyprof/parse/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/apex/pyprof/parse/__main__.py b/apex/apex/pyprof/parse/__main__.py new file mode 100644 index 0000000000000000000000000000000000000000..fa1291992343aa61b051d7297399d971637af6e1 --- /dev/null +++ b/apex/apex/pyprof/parse/__main__.py @@ -0,0 +1,10 @@ +import warnings + +try: + from .parse import main +except ImportError as e: + warnings.warn("Did you make sure to install PyProf dependencies by using the --pyprof flag during Apex installation?)") + raise e + +if __name__ == '__main__': + main() diff --git a/apex/apex/pyprof/parse/db.py b/apex/apex/pyprof/parse/db.py new file mode 100644 index 0000000000000000000000000000000000000000..55c5dc57147d4d71e8a607a8c521541d4101e0dc --- /dev/null +++ b/apex/apex/pyprof/parse/db.py @@ -0,0 +1,61 @@ +import sys, sqlite3 + +class DB(object): + """ + This class provides functions for DB operations + with exception handling. + """ + + def __init__(self, dbFile): + try: + conn = sqlite3.connect(dbFile) + conn.row_factory = sqlite3.Row + c = conn.cursor() + except: + print("Error opening {}".format(dbFile)) + sys.exit(1) + + self.conn = conn + self.c = c + + def select(self, cmd): + try: + self.c.execute(cmd) + #rows = self.c.fetchall() + rows = [dict(row) for row in self.c.fetchall()] + except sqlite3.Error as e: + print(e) + sys.exit(1) + except: + print("Uncaught error in SQLite access while executing {}".format(cmd)) + sys.exit(1) + + #print(rows) + return rows + + def insert(self, cmd, data): + try: + self.c.execute(cmd, data) + except sqlite3.Error as e: + print(e) + sys.exit(1) + except: + print("Uncaught error in SQLite access while executing {}".format(cmd)) + sys.exit(1) + + def execute(self, cmd): + try: + self.c.execute(cmd) + except sqlite3.Error as e: + print(e) + sys.exit(1) + except: + print("Uncaught error in SQLite access while executing {}".format(cmd)) + sys.exit(1) + + def commit(self): + self.conn.commit() + + def close(self): + self.c.close() + self.conn.close() diff --git a/apex/apex/pyprof/parse/kernel.py b/apex/apex/pyprof/parse/kernel.py new file mode 100644 index 0000000000000000000000000000000000000000..5a66e290d2bd59588d39cc6333dd4fe94880ad09 --- /dev/null +++ b/apex/apex/pyprof/parse/kernel.py @@ -0,0 +1,210 @@ +import cxxfilt, struct, binascii + +#Helper functions + +def demangle(name): + """ + Demangle a C++ string + """ + return cxxfilt.demangle(name) + +def encode_object_id(pid, tid): + """ + Given process id (pid) and thread id (tid), return the object id. + object id = pid (little endian 4 bytes) + tid (little endian 8 bytes) + """ + objId = struct.pack(' start, "This assertion can fail for very large profiles. It usually fails when start = end = 0." + self.kStartTime = start + self.kEndTime = end + self.kDuration = end - start + assert (start > Kernel.profStart) + self.device = int(info['deviceId']) + self.stream = int(info['streamId']) + self.grid = (info['gridX'], info['gridY'], info['gridZ']) + self.block = (info['blockX'], info['blockY'], info['blockZ']) + self.timeOffset = Kernel.profStart + + def setKernelName(self, name): + cadena = demangle(name) + self.kLongName = cadena + self.kShortName = getShortName(cadena) + + def setRunTimeInfo(self, info): + start, end, pid, tid = info + self.rStartTime = start + self.rEndTime = end + self.rDuration = end - start + self.pid = pid + self.tid = tid + self.objId = encode_object_id(pid, tid) + + def setMarkerInfo(self, info): + self.layerMarkers, self.traceMarkers, self.reprMarkers, self.pyprofMarkers, self.seqMarkers, self.otherMarkers, self.altMarkers, self.seqId, self.altSeqId, self.layer = info + self.subSeqId = 0 + + def setDirection(self): + """ + Set direction (fprop, bprop) based on PyTorch sequence markers. + It is a heuristic and not a foolproof method. + """ + if any("Backward, seq = " in x for x in self.seqMarkers) or \ + any("backward, seq = " in x for x in self.seqMarkers) or \ + any("Backward0, seq = " in x for x in self.seqMarkers): + self.dir = "bprop" + else: + self.dir = "fprop" + + def setOp(self): + """ + Detect and set the class/module (mod) and operation (op) + of the kernel e.g. torch.nn.functional / linear, torch / sigmoid. + The lookup sequence we use is + NVTX markers inserted by pyprof + NVTX markers inserted by PyTorch in bprop + NVTX markers inserted by PyTorch in fprop + It is a heuristic and not a foolproof method. + """ + + def sanitize(name): + name = name.replace("torch","") \ + .replace("autograd","") \ + .replace("_backward","") \ + .replace("::","") \ + .replace("jit","") \ + .replace("(anonymous namespace)","") + head, sep, tail = name.partition("Backward") + return head + + #Check pyprof markers + for m in self.pyprofMarkers: + assert ("mod" in m) and ("op" in m) and ("args" in m) + t = eval(m) + self.op.append(t['op']) + self.mod.append(t['mod']) + + if len(self.op): + return + + #Check bprop kernel markers + for m in self.seqMarkers: + if ("backward, seq = " in m) or ("Backward, seq = " in m): + op = m.split(",")[0] + op = sanitize(op) + self.op.append(op) + self.mod.append('na') + + if len(self.op): + return + + #Check markers with "seq = " + for m in self.seqMarkers: + if ", seq = " in m: + op = m.split(",")[0] + self.op.append(op) + self.mod.append('na') + + if len(self.op): + return + + #If nothing else + if len(self.otherMarkers): + self.op.append(self.otherMarkers[0]) + self.mod.append('na') + + def print(self): + """ + Print kernel information. This is used by prof.py. + """ + + a = lambda: None + a.kShortName = self.kShortName + a.kDuration = self.kDuration + #a.layerMarkers = self.layerMarkers + a.layer = self.layer + a.trace = self.traceMarkers + a.reprMarkers = self.reprMarkers + a.marker = self.pyprofMarkers + a.seqMarker = self.seqMarkers + + a.seqId = self.seqId + a.subSeqId = self.subSeqId + a.altSeqId = self.altSeqId + + a.dir = self.dir + a.mod = self.mod + a.op = self.op + + a.tid = self.tid + a.device = self.device + a.stream = self.stream + a.grid = self.grid + a.block = self.block + a.kLongName = self.kLongName + + print(a.__dict__) diff --git a/apex/apex/pyprof/parse/nvvp.py b/apex/apex/pyprof/parse/nvvp.py new file mode 100644 index 0000000000000000000000000000000000000000..7167a892d6ec876f8d6f0705cdd7a735c6200c65 --- /dev/null +++ b/apex/apex/pyprof/parse/nvvp.py @@ -0,0 +1,282 @@ +import sys + +class NVVP(object): + """ + This class gets kernel information from the SQL (nvvp) database. + """ + + driverT = "CUPTI_ACTIVITY_KIND_DRIVER" + runtimeT = "CUPTI_ACTIVITY_KIND_RUNTIME" + kernelT = "CUPTI_ACTIVITY_KIND_CONCURRENT_KERNEL" + markerT = "CUPTI_ACTIVITY_KIND_MARKER" + stringT = "StringTable" + + def __init__(self, db): + self.db = db + self.markerId = 0 + + def getProfileStart(self): + """ + Get the profile start time + """ + profStart = sys.maxsize + for table in [self.driverT, self.runtimeT, self.kernelT, self.markerT]: + colname = "timestamp" if table is self.markerT else "start" + cmd = "select {} from {} ORDER BY {} ASC LIMIT 1".format(colname, table, colname) + result = self.db.select(cmd) + assert(len(result) <= 1) + if (len(result) == 1): + assert(colname in result[0]) + t = result[0][colname] + if (t < profStart): + profStart = t + assert(profStart < sys.maxsize) + return profStart + + def getString(self, id_): + """ + Get the string associated with an id. + """ + cmd = "select value from {} where _id_ = {}".format(self.stringT, id_) + result = self.db.select(cmd) + assert (len(result) == 1) + return result[0]['value'] + + def createMarkerTable(self): + """ + Create a temporary table and index it to speed up repeated SQL quesries. + The table is an INNER JOIN of CUPTI_ACTIVITY_KIND_MARKER with itself. + """ + cmd = 'CREATE TEMPORARY TABLE marker AS SELECT \ + a._id_ as id, \ + a.timestamp AS startTime, \ + b.timestamp AS endTime, \ + HEX(a.objectId) AS objectId, \ + a.name AS name \ + FROM {} AS a INNER JOIN {} AS b ON \ + a.id = b.id and \ + a.flags = 2 and b.flags = 4'.format(self.markerT, self.markerT) + self.db.execute(cmd) + + self.db.execute('CREATE INDEX start_index ON marker (startTime)') + self.db.execute('CREATE INDEX end_index ON marker (endTime)') + self.db.execute('CREATE INDEX id_index ON marker (id)') + + def getCPUInfo(self, corrId): + """ + Given the correlation id, get CPU start, end, thread id, process id. + The information can be in the runtime table or the driver table. + """ + + #First look in the runtime table + cmd = "select start,end,processId,threadId from {} where correlationId={}".format(self.runtimeT, corrId); + result = self.db.select(cmd) + assert (len(result) <= 1) + + if (len(result) == 0): + #Look in the driver table + cmd = "select start,end,processId,threadId from {} where correlationId={}".format(self.driverT, corrId); + result = self.db.select(cmd) + + assert (len(result) == 1) + info = result[0] + start = info['start'] + end = info['end'] + pid = info['processId'] + tid = info['threadId'] + tid = tid & 0xffffffff #convert to unsigned + assert (end > start) + return [start, end, pid, tid] + + def getKernelInfo(self): + """ + Get GPU kernel info + """ + cmd = "select name,correlationId,start,end,deviceId,streamId,gridX,gridY,gridZ,blockX,blockY,blockZ from {}".format(self.kernelT) + result = self.db.select(cmd) + return result + + def getMarkerInfo(self, objId, startTime, endTime): + """ + This function first finds all NVTX markers encapsulating + a runtime / driver kernel launch. + It then splits the markers into many lists. + layerMarkers : User added NVTX markers + traceMarkers : Call trace markers (inserted by pyprof) + reprMarkers : Markers containing the extra_repr() of a module (inserted by pyprof) + pyprofMarkers: Markers containing args and kwargs (tensor shape, datatype etc.) + seqMarkers : Markers containing PyTorch internal sequence markers (inserted by PyTorch) + altSeqMarkers: Markers inserted by PyTorch between two kernel launches. Needs better explanation. + otherMarkers : Markers not in either of the above categories. + + We extract seqId from the seq and altSeq markers. The seqId is used in bprop. + We also extract information from the layerMarkers. + """ + + layerMarkers = [] + traceMarkers = [] + reprMarkers = [] + pyprofMarkers = [] + seqMarkers = [] + otherMarkers = [] + altSeqMarkers = [] + bprop = False + + #Helper functions + + def delete(objId, sTime): + """ + Delete rows from the temporary SQL table which are no longer required. + This speeds up future queries. + """ + margin = 0 + cmd = 'DELETE FROM marker WHERE objectId = "{}" AND endTime < {}'.format(objId, sTime - margin) + #cmd = 'DELETE FROM marker WHERE endTime < {}'.format(sTime - margin) + self.db.execute(cmd) + + def getLayerName(mlist): + """ + Get layer names from layer marker list. + """ + layers = [] + assert(type(mlist) == list) + for m in mlist: + assert("layer:" in m) + l = m.split(":")[1] + layers.append(l) + return layers + + def getSeqId(mlist): + """ + Get sequence ids from seq / alt seq marker list. + """ + ids = [] + assert(type(mlist) == list) + for m in mlist: + assert(", seq = " in m) + seq = int(m.split("=")[1]) + ids.append(seq) + + #Remove duplicates + ids = list(set(ids)) + ids.sort() + return ids + + def seqcompare(elem): + """ + Sorting function for sequence markers + """ + assert (", seq = " in elem) + #sort by sequence id and then the string + l = elem.split(" = ") + return l[1] + l[0] + + def prune(mlist): + """ + Remove markers with the same seqId and if the strings are similar. + This function works on a sorted sequence. + """ + assert (type(mlist) == list) + assert (len(mlist)) + a = mlist[0:1] + for i in range(1,len(mlist)): + m = mlist[i] + pm = mlist[i-1] + name,seq = m.split(",") + pname,pseq = pm.split(",") + similar = (name in pname) or (pname in name) + if (seq == pseq) and similar: + continue + else: + a.append(m) + return a + + def filterTrace(mlist): + """ + Filter trace markers to remove certain file names. + """ + assert (type(mlist) == list) + if len(mlist) == 0: + return mlist + mlist = mlist[-1] #The last stack trace will be a super set. + mlist = eval(mlist) + mlist = mlist['traceMarker'] + assert (type(mlist) == list) + mlist = list(filter(lambda x : "/torch/nn/modules/" not in x, mlist)) + mlist = list(filter(lambda x : "/torch/nn/functional.py" not in x, mlist)) + mlist = list(filter(lambda x : "/torch/tensor.py" not in x, mlist)) + mlist = list(filter(lambda x : "/torch/autograd/__init__.py" not in x, mlist)) + mlist = list(filter(lambda x : "/torch/_jit_internal.py" not in x, mlist)) + mlist = list(filter(lambda x : "/pyprof/nvtx/nvmarker.py" not in x, mlist)) + mlist = list(filter(lambda x : "/apex/optimizers/" not in x, mlist)) + mlist = list(filter(lambda x : "/torch/_utils.py" not in x, mlist)) + mlist = list(filter(lambda x : "/torch/optim/" not in x, mlist)) + return mlist + + #Find all encapsulating markers + cmd = 'SELECT id,name from marker where \ + objectId = "{}" and \ + startTime < {} and \ + endTime > {} \ + ORDER BY startTime ASC'.format(objId, startTime, endTime) + result = self.db.select(cmd) + + #Bin markers into different lists + for r in result: + m = self.getString(r['name']) + + #Hack: If its a known gradient checkpointing marker, ignore it. + if m.find("CheckpointFunctionBackward") >= 0: + continue + + if ("_backward, seq =" in m) or ("Backward, seq =" in m) or ("Backward0, seq =" in m): + bprop = True + + if ("mod" in m) and ("op" in m) and ("args" in m) and ("type" in m): + pyprofMarkers.append(m) + elif ("layer:" in m): + layerMarkers.append(m) + elif ("traceMarker" in m): + traceMarkers.append(m) + elif ("strRepr" in m): + reprMarkers.append(m) + elif (", seq = " in m): + seqMarkers.append(m) + else: + otherMarkers.append(m) + + #Remove duplicates, sort and prune seqMarkers + if (len(seqMarkers)): + seqMarkers = list(set(seqMarkers)) + seqMarkers.sort(key=seqcompare) + seqMarkers = prune(seqMarkers) + + #Remove duplicates from otherMarkers + otherMarkers = list(set(otherMarkers)) + + #Get markers with seq id (inserted by PyTorch) from the previous kernel to the present kernel + #Only for fprop kernels + if (len(result) and not bprop): + loId = self.markerId + hiId = result[-1]['id'] + self.markerId = hiId + + #Get markers between loId and hiId + cmd = 'SELECT id,name from marker where objectId = "{}" and id > {} and id < {} ORDER BY startTime ASC'.format(objId, loId, hiId) + result1 = self.db.select(cmd) + + for r in result1: + m = self.getString(r['name']) + #Get only markers with seq id + if (", seq=" in m): + altSeqMarkers.append(m) + + #Remove duplicates, sort and prune altSeqMarkers + if (len(altSeqMarkers)): + altSeqMarkers = list(set(altSeqMarkers)) + altSeqMarkers.sort(key=seqcompare) + altSeqMarkers = prune(altSeqMarkers) + + delete(objId, startTime) + + return layerMarkers, filterTrace(traceMarkers), reprMarkers, pyprofMarkers, seqMarkers, otherMarkers, altSeqMarkers, getSeqId(seqMarkers), getSeqId(altSeqMarkers), getLayerName(layerMarkers) diff --git a/apex/apex/pyprof/parse/parse.py b/apex/apex/pyprof/parse/parse.py new file mode 100755 index 0000000000000000000000000000000000000000..c119fe5e0997b2040f37214476085910bca91257 --- /dev/null +++ b/apex/apex/pyprof/parse/parse.py @@ -0,0 +1,122 @@ +#!/usr/bin/env python3 + +""" +Parse the SQL db and print a dictionary for every kernel. +""" + +import sys +import argparse +from tqdm import tqdm + +from .db import DB +from .kernel import Kernel +from .nvvp import NVVP + +def parseArgs(): + parser = argparse.ArgumentParser(prog=sys.argv[0], description="Parse SQL (nvvp) db.") + parser.add_argument("file", + type=str, + default=None, + help="SQL db (nvvp) file.") + + args = parser.parse_args() + return args + +def main(): + args = parseArgs() + + db = DB(args.file) + nvvp = NVVP(db) + + kInfo = nvvp.getKernelInfo() + if len(kInfo) == 0: + print("Found 0 kernels. Exiting.", file=sys.stderr) + db.close() + sys.exit(0) + else: + print("Found {} kernels. Getting info for each kernel.".format(len(kInfo)), file=sys.stderr) + + nvvp.createMarkerTable() + + prevSeqId = -1 + prevSubSeqId = -1 + prevOp = "na" + + Kernel.profStart = nvvp.getProfileStart() + + for i in tqdm(range(len(kInfo)), ascii=True): + info = kInfo[i] + k = Kernel() + + #Set kernel info + k.setKernelInfo(info) + + #Get, set kernel name + name = nvvp.getString(k.kNameId) + k.setKernelName(name) + + #Get runtime info + info = nvvp.getCPUInfo(k.corrId) + k.setRunTimeInfo(info) + + #Get and set marker and seqid info + info = nvvp.getMarkerInfo(k.objId, k.rStartTime, k.rEndTime) + k.setMarkerInfo(info) + + #If the seqId contains both 0 and non zero integers, remove 0. + if any(seq != 0 for seq in k.seqId) and (0 in k.seqId): + k.seqId.remove(0) + + #Set direction (it uses seq id) + k.setDirection() + + #Set op + k.setOp() + + #The following code is based on heuristics. + #TODO: Refactor. + #Assign subSeqId, adjust seqId and altSeqId + #seqId can be 0. + #A kernel can have multiple seqIds both in fprop and bprop. + #In bprop, seqIds might not decrease monotonically. I have observed a few blips. + if len(k.seqId): + assert (k.dir in ["fprop", "bprop"]) + if (k.dir == "fprop"): + #Check if there is a sequence id larger than the previous + inc = (k.seqId[-1] > prevSeqId) + if inc: + currSeqId = [x for x in k.seqId if x > prevSeqId][0] + else: + currSeqId = prevSeqId + else: + currSeqId = k.seqId[0] + + #if ((currSeqId == prevSeqId) and (k.op == prevOp)): + if ((currSeqId == prevSeqId) and (k.op == prevOp)) or ((k.op[0] == "forward") and (k.op == prevOp) and (k.mod[0] in ["LSTMCell", "GRUCell", "RNNCell"])): + #The second condition is to trap cases when pytorch does not use cudnn for a LSTMCell. + k.subSeqId = prevSubSeqId + 1 + + prevSeqId = currSeqId + prevSubSeqId = k.subSeqId + prevOp = k.op + + #Keep currSeqId in k.seqId, move everything else to k.altSeqId + for s in k.seqId: + if s != currSeqId: + k.seqId.remove(s) + k.altSeqId.append(s) + + for s in k.altSeqId: + if s == currSeqId: + k.altSeqId.remove(s) + + k.altSeqId = list(set(k.altSeqId)) + if (len(k.altSeqId)): + (k.altSeqId).sort() + + k.print() + + db.close() + +if __name__ == '__main__': + main() diff --git a/apex/apex/pyprof/prof/__init__.py b/apex/apex/pyprof/prof/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..cedb1ad415083557e1d9757cf01c356fdc8d97cf --- /dev/null +++ b/apex/apex/pyprof/prof/__init__.py @@ -0,0 +1 @@ +from . import data, prof diff --git a/apex/apex/pyprof/prof/__main__.py b/apex/apex/pyprof/prof/__main__.py new file mode 100644 index 0000000000000000000000000000000000000000..a114f7c9487b04c2a062aeaba727053c47e822c6 --- /dev/null +++ b/apex/apex/pyprof/prof/__main__.py @@ -0,0 +1,10 @@ +import warnings + +try: + from .prof import main +except ImportError as e: + warnings.warn("Did you make sure to install PyProf dependencies by using the --pyprof flag during Apex installation?") + raise e + +if __name__ == '__main__': + main() diff --git a/apex/apex/pyprof/prof/activation.py b/apex/apex/pyprof/prof/activation.py new file mode 100644 index 0000000000000000000000000000000000000000..e2443b0930b492249767f8b67ae5891c88900ca2 --- /dev/null +++ b/apex/apex/pyprof/prof/activation.py @@ -0,0 +1,65 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Activation(OperatorLayerBase): + """ + This class handles the various activation functions. + """ + + ops = ["celu", "elu", "elu_", "hardshrink", "hardtanh", "hardtanh_", "leaky_relu", "leaky_relu_", "logsigmoid", "prelu", "relu", "relu_", "relu6", "rrelu", "rrelu_", "selu", "sigmoid", "softplus", "softshrink", "softsign", "tanh", "tanhshrink", "threshold", "threshold_"] + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod in ["torch.nn.functional", "torch", "Tensor"]) + + #Filter out named parameters + args = list(filter(lambda x : x['name'] == '', args)) + + assert (len(args) >= 1) + arg = args[0] + assert (arg['type'] == "tensor") + + self.i = arg + self.dir = d.dir + + def params(self): + p = OrderedDict([('T', self.i['shape']),('type', self.i['dtype'])]) + return p + + def flops(self): + direction = self.dir + tensor = self.i['shape'] + t = self.i['dtype'] + + # TODO: revise + elems = Utility.numElems(tensor) + return elems + + def bytes(self): + direction = self.dir + tensor = self.i['shape'] + t = self.i['dtype'] + + elems = Utility.numElems(tensor) + elems = elems * (2 if direction == "fprop" else 3) + + return elems * Utility.typeToBytes(t) + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/base.py b/apex/apex/pyprof/prof/base.py new file mode 100644 index 0000000000000000000000000000000000000000..adfc4ce8a65c854b4795c003e9c6a4fc9cac03cb --- /dev/null +++ b/apex/apex/pyprof/prof/base.py @@ -0,0 +1,47 @@ +from abc import ABC, abstractmethod + +class OperatorLayerBase(ABC): + """ + Base class for all layers and operators. + Every derived class should have the following functions. + """ + + @abstractmethod + def tc(self): + """ + Tensor core usage by the kernel. + Return "1" (yes), "0" (no, but possible), "-" (not applicable) + """ + pass + + @abstractmethod + def params(self): + """ + Kernel parameters to be printed. + """ + pass + + @abstractmethod + def flops(self): + """ + Note that 1 FMA = 2 flops. + """ + pass + + @abstractmethod + def bytes(self): + pass + + @abstractmethod + def mod(self): + """ + Name of the module/class e.g. torch.nn.functional. + """ + pass + + @abstractmethod + def op(self): + """ + Name of the operator e.g. sigmoid. + """ + pass diff --git a/apex/apex/pyprof/prof/blas.py b/apex/apex/pyprof/prof/blas.py new file mode 100644 index 0000000000000000000000000000000000000000..706205c7b87a98f3733c19edce1f42e082a80624 --- /dev/null +++ b/apex/apex/pyprof/prof/blas.py @@ -0,0 +1,340 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase +import numpy as np + +TC_GEMMS = ["884gemm", "1688gemm"] + +class Addmm(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod in ["torch", "Tensor",]) + assert (op in ["addmm", "addmm_",]) + + #Get alpha and beta + alpha = 1 + beta = 1 + if any(x['name'] == 'alpha' for x in args): + alpha = list(filter(lambda x : x['name'] == "alpha", args))[0] + alpha = alpha['value'] + + if any(x['name'] == 'beta' for x in args): + beta = list(filter(lambda x : x['name'] == "beta", args))[0] + beta = beta['value'] + + self.alpha = alpha + self.beta = beta + + #Filter out named parameters + args = list(filter(lambda x : x['name'] == '', args)) + + assert (len(args) == 3) + C,A,B = args + m,k1 = A['shape'] + k2,n = B['shape'] + assert (k1 == k2) + t1 = A['dtype'] + t2 = B['dtype'] + t3 = C['dtype'] + assert(t1 == t2 == t3) + + self.A = A + self.B = B + self.C = C + + self.m = m + self.n = n + self.k = k1 + self.type = t1 + self.name = d.name + + return + + def tc(self): + for s in TC_GEMMS: + if s in self.name: + return 1 + return 0 + + def bytes(self): + m, n, k = self.m, self.n, self.k + return Utility.typeToBytes(self.type) * (m*n + m*k + n*k) + + def flops(self): + return self.m * self.n * self.k * 2 + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def params(self): + p = OrderedDict([('M',self.n),('N',self.m),('K',self.k),('type',self.type)]) + return p + +class Bmm(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch") and (op == "bmm") + + #Filter out named params (kwargs) + args = list(filter(lambda x : x['name'] == "", args)) + + assert (len(args) == 2) + A,B = args + b1,m,k1 = A['shape'] + b2,k2,n = B['shape'] + assert (b1 == b2) + assert (k1 == k2) + t1 = A['dtype'] + t2 = B['dtype'] + assert(t1 == t2) + + self.A = A + self.B = B + self.b = b1 + self.m = m + self.n = n + self.k = k1 + self.type = t1 + self.name = d.name + + def tc(self): + for s in TC_GEMMS: + if s in self.name: + return 1 + return 0 + + def params(self): + #p = OrderedDict([('A', A['shape']), ('B', B['shape']), ('type', t1)]) + p = OrderedDict([('B',self.b), ('M',self.n),('N',self.m),('K',self.k),('type',self.type)]) + return p + + def flops(self): + return self.b * self.m * self.n * self.k * 2 + + def bytes(self): + b, m, n, k = self.b, self.m, self.n, self.k + return Utility.typeToBytes(self.type) * b * (m*n + m*k + n*k) + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + +class Matmul(OperatorLayerBase): + + NON_GEMM = ["kernelPointwiseApply2", "reduce_1Block_kernel", "elementwise_kernel"] + NON_TC = NON_GEMM + ["dot_kernel"] + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + self.name = d.name + self.sub = d.sub + + assert ((mod == "torch") and (op == "matmul")) or ((mod == "Tensor") and (op == "__matmul__")) + assert (len(args) == 2) + + assert any([x in d.name for x in Matmul.NON_TC + ["gemm", "gemv"]]) + + A,B = args + t1 = A['dtype'] + t2 = B['dtype'] + assert(t1 == t2) + + A = A['shape'] + B = B['shape'] + + self.A = A + self.B = B + self.type = t1 + + # batch, MNK + if (len(A) == 1) and (len(B) == 1): + #dot product + assert (A[0] == B[0]) + self.b = (1,) + self.m = 1 + self.n = 1 + self.k = A[0] + + elif (len(A) == 2) and (len(B) == 2): + #gemm + m,k1 = A + k2,n = B + assert(k1 == k2) + self.b = (1,) + self.m = m + self.n = n + self.k = k1 + + elif (len(A) == 1) and (len(B) == 2): + #vector matrix + k1 = A[0] + k2,n = B + assert(k1 == k2) + + self.b = (1,) + self.m = 1 + self.n = n + self.k = k1 + + elif (len(A) == 2) and (len(B) == 1): + #gemv + m,k1 = A + k2 = B[0] + assert (k1 == k2) + + self.b = (1,) + self.m = m + self.n = 1 + self.k = k1 + + elif (len(A) == 1) and (len(B) > 2): + assert (A[0] == B[-2]) + + self.b = B[0:-2] + self.m = 1 + self.n = B[-1] + self.k = B[-2] + + elif (len(B) == 1) and (len(A) > 2): + assert (B[0] == A[-1]) + + self.b = A[0:-2] + self.m = A[-2] + self.n = 1 + self.k = A[-1] + + else: + assert (len(A) >= 2) + assert (len(B) >= 2) + assert (A[-1] == B[-2]) + self.m = A[-2] + self.n = B[-1] + self.k = A[-1] + + aa = np.empty(A[0:-2]) + bb = np.empty(B[0:-2]) + self.b = np.broadcast(aa, bb).shape + + def params(self): + return OrderedDict([('A', self.A), ('B', self.B), ('type', self.type)]) + + def tc(self): + if self.name in Matmul.NON_TC: + return "-" + else: + for s in TC_GEMMS: + if s in self.name: + return 1 + return 0 + + def bytes(self): + # TODO: check bytes for non-GEMM cases + if self.name in Matmul.NON_GEMM: + return 2 * Utility.typeToBytes(self.type) * Utility.numElems(self.A) #could be B as well + else: + m, n, k = self.m, self.n, self.k + return Utility.typeToBytes(self.type) * (m*n + m*k + n*k) + + def flops(self): + # TODO: calculate actual FLOPs. At least we're not saying it's GEMM FLOPs for now. + if self.name in Matmul.NON_GEMM: + return 0 + else: + return Utility.numElems(self.b) * self.m * self.n * self.k * 2 + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + +class Mm(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch") and (op == "mm") + assert (len(args) == 2) + + A,B = args + m,k1 = A['shape'] + k2,n = B['shape'] + assert (k1 == k2) + t1 = A['dtype'] + t2 = B['dtype'] + assert(t1 == t2) + + self.A = A + self.B = B + self.m = m + self.n = n + self.k = k1 + self.type = t1 + self.name = d.name + + return + + def params(self): + p = OrderedDict([('M',self.n),('N',self.m),('K',self.k),('type',self.type)]) + return p + + def tc(self): + for s in TC_GEMMS: + if s in self.name: + return 1 + return 0 + + def bytes(self): + m, n, k = self.m, self.n, self.k + return Utility.typeToBytes(self.type) * (m*n + m*k + n*k) + + def flops(self): + return self.m * self.n * self.k * 2 + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/conv.py b/apex/apex/pyprof/prof/conv.py new file mode 100644 index 0000000000000000000000000000000000000000..df388df133c1d3690e8d846c95b54f2d72b359d4 --- /dev/null +++ b/apex/apex/pyprof/prof/conv.py @@ -0,0 +1,236 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Conv(OperatorLayerBase): + + """ + # N = batch size + # C,H,W = input channels, height, width + # K,P,Q = output channels, height, width + # R,S = filter height, width + # g = groups + """ + + #todo: refine winograd and FFT + convAuxList = ["nchwToNhwc", "nhwcToNchw", "OffsetsKernel",] + winoAuxList = ["generateWinogradTilesKernel", "winogradWgradData", "winogradWgradOutput", "winogradWgradDelta"] + fftAuxList = ["compute_gemm_pointers", "flip_filter", "fft2d_r2c_", "fft2d_c2r_", "fft1d_r2c", "fft1d_c2r"] + miscAuxList = ["scaleTensor_kernel",] + + convList = ["_s884cudnn_", "_s1688cudnn_", "_scudnn_", "2d_grouped_direct_kernel", "cudnn::detail::implicit_convolve_sgemm", "cudnn::detail::dgrad2d_alg1_1", "cudnn::detail::wgrad_alg0_engine", "cudnn::detail::dgrad_engine", "dgrad_1x1_stride_2x2", "spatialDepthwiseConvolutionUpdateOutput"] + winoList = ["winograd3x3Kernel", "_sgemm_"] + fftList = ["fermiPlusCgemmLDS128_batched", "_gcgemm_",] + miscList = [] + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + self.dir = d.dir + self.name = d.name + self.sub = d.sub + + assert (mod == "torch.nn.functional") + assert (op in ["conv1d", "conv2d"]) + length = len(args) + assert (length >= 2) and (length <= 7) + i,w = args[0], args[1] + assert (i['type'] == "tensor") + assert (w['type'] == "tensor") + + #ignore bias + + if (length >= 4) and (args[3]['name'] == ""): + s = args[3] + elif any(x['name'] == 'stride' for x in args): + s = list(filter(lambda x : x['name'] == 'stride', args))[0] + else: + s = {'name': 'stride', 'type': 'int', 'value': 1} + + if (length >= 5) and (args[4]['name'] == ""): + p = args[4] + elif any(x['name'] == 'padding' for x in args): + p = list(filter(lambda x : x['name'] == 'padding', args))[0] + else: + p = {'name': 'padding', 'type': 'int', 'value': 0} + + if (length >= 6) and (args[5]['name'] == ""): + d = args[5] + elif any(x['name'] == 'dilation' for x in args): + d = list(filter(lambda x : x['name'] == 'dilation', args))[0] + else: + d = {'name': 'dilation', 'type': 'int', 'value': 1} + + if (length == 7) and (args[6]['name'] == ""): + g = args[6] + elif any(x['name'] == 'groups' for x in args): + g = list(filter(lambda x : x['name'] == 'groups', args))[0] + else: + g = {'name': 'groups', 'type': 'int', 'value': 1} + + if op == "conv1d": + assert (len(i['shape']) == 3) + assert (len(w['shape']) == 3) + assert (i['dtype'] == w['dtype']) + N, C1, W = i['shape'] + K, C2, S = w['shape'] + assert (C1 == C2) + p = p['value'] if Utility.isscalar(p['type']) else p['value'][0] + s = s['value'] if Utility.isscalar(s['type']) else s['value'][0] + d = d['value'] if Utility.isscalar(d['type']) else d['value'][0] + g = g['value'] + assert (g == 1) + H = 1 + R = 1 + + P = 1 + (H - (((R-1))+1)) + Q = 1 + (W + 2*p - (((S-1)*d)+1))/s + P = int(P) + Q = int(Q) + if (H == 1): + assert (P == 1) + if (W == 1): + assert (Q == 1) + + self.N = N + self.C = C1 + self.H = H + self.W = W + self.K = K + self.P = P + self.Q = Q + self.R = R + self.S = S + self.ph = 0 + self.pw = p + self.U = 1 + self.V = s + self.dh = 1 + self.dw = d + self.g = g + self.type = i['dtype'] + + elif op == "conv2d": + assert (len(i['shape']) == 4) + assert (len(w['shape']) == 4) + assert (i['dtype'] == w['dtype']) + N, C1, H, W = i['shape'] + K, C2, R, S = w['shape'] + + if Utility.isscalar(p['type']): + ph = pw = p['value'] + else: + assert (p['type'] == "tuple") + ph, pw = p['value'] + + if Utility.isscalar(s['type']): + sh = sw = s['value'] + else: + assert (s['type'] == "tuple") + sh, sw = s['value'] + + if Utility.isscalar(d['type']): + dh = dw = d['value'] + else: + assert (d['type'] == "tuple") + dh, dw = d['value'] + + g = g['value'] + assert (g >= 1) + assert (C1 == C2*g) + + P = 1 + (H + 2*ph - (((R-1)*dh)+1))/sh + Q = 1 + (W + 2*pw - (((S-1)*dw)+1))/sw + P = int(P) + Q = int(Q) + if (H == 1): + assert (P == 1) + if (W == 1): + assert (Q == 1) + + self.N = N + self.C = C1 + self.H = H + self.W = W + self.K = K + self.P = P + self.Q = Q + self.R = R + self.S = S + self.ph = ph + self.pw = pw + self.U = sh + self.V = sw + self.dh = dh + self.dw = dw + self.g = g + self.type = i['dtype'] + + else: + assert False + + def params(self): + p = OrderedDict([('N',self.N), ('C',self.C), ('H',self.H), ('W',self.W), ('K',self.K), ('P',self.P), ('Q',self.Q), ('R',self.R), ('S',self.S), ('ph',self.ph), ('pw',self.pw), ('U',self.U), ('V',self.V), ('dh',self.dh), ('dw',self.dw), ('g',self.g), ('type',self.type)]) + return p + + def conv_bytes_flops(self, N, C, H, W, K, P, Q, R, S, g, t): + f = 2*N*K*P*Q*C*R*S/g #for fprop + elems = N*C*H*W + K*C*R*S/g + N*K*P*Q + b = elems * Utility.typeToBytes(t) + return b,f + + def bytes_flops(self): + N,C,H,W,K,P,Q,R,S,ph,pw,U,V,dh,dw,g,t = self.params().values() + + if any(x in self.name for x in Conv.convAuxList+Conv.winoAuxList+Conv.fftAuxList+Conv.miscAuxList): + bytes, flops = [0, 0] + + elif any(x in self.name for x in Conv.convList+Conv.winoList+Conv.fftList+Conv.miscList): + if g == 1: + bytes, flops = self.conv_bytes_flops(N,C,H,W,K,P,Q,R,S,g,t) + else: + if "2d_grouped_direct_kernel" in self.name: #only 1 kernel is called + bytes, flops = self.conv_bytes_flops(N,C,H,W,K,P,Q,R,S,g,t) + elif "spatialDepthwiseConvolutionUpdateOutput" in self.name: #one kernel for separable conv + bytes, flops = self.conv_bytes_flops(N,C,H,W,K,P,Q,R,S,g,t) + else: #a kernel per group is called + bytes, flops = self.conv_bytes_flops(N,C/g,H,W,K/g,P,Q,R,S,1,t) + + elif ("calc_bias_diff" in self.name): #bias gradient + elems = N*K*P*Q + flops = elems + bytes = 2 * elems * Utility.typeToBytes(t) + #params = OrderedDict([('N',N), ('K',K), ('P',P), ('Q',Q), ('type', t)]) + + else: + bytes, flops = [0, 0] + + return bytes, flops + + def bytes(self): + b,_ = self.bytes_flops() + return b + + def flops(self): + _,f = self.bytes_flops() + return f + + def tc(self): + for s in ["884cudnn", "1688cudnn"]: + if s in self.name: + return 1 + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/convert.py b/apex/apex/pyprof/prof/convert.py new file mode 100644 index 0000000000000000000000000000000000000000..0d6735a819f64070f08084d244d8f0c3834853c8 --- /dev/null +++ b/apex/apex/pyprof/prof/convert.py @@ -0,0 +1,62 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Convert(OperatorLayerBase): + """ + Class to handle convert operations. + """ + ops = ["byte", "char", "double", "float", "half", "int", "long", "short", "to"] + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op in Convert.ops) + assert (len(args) == 1) + + #The argument could be a tensor or scalar + t = args[0] + if t['type'] == "tensor": + shape = t['shape'] + stype = t['dtype'] + else: + shape = (1,) + stype = t['type'] + if self.op_ == "to": + op = stype + + self.shape = shape + self.stype = stype + self.dtype = op + + def params(self): + p = OrderedDict([('T', self.shape), ('stype', self.stype), ('dtype', self.dtype)]) + return p + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def tc(self): + return "-" + + def elems(self): + return Utility.numElems(self.shape) + + def flops(self): + return 0 + + def bytes(self): + b = self.elems() * (Utility.typeToBytes(self.stype) + Utility.typeToBytes(self.dtype)) + return b diff --git a/apex/apex/pyprof/prof/data.py b/apex/apex/pyprof/prof/data.py new file mode 100644 index 0000000000000000000000000000000000000000..dcd323dea6db8cd7253527f2a6984cd38d0160fd --- /dev/null +++ b/apex/apex/pyprof/prof/data.py @@ -0,0 +1,54 @@ +from .utility import Utility + +class Data(object): + """ + Class to store all the data for every kernel e.g. name, bytes, flops, device, stream etc. + """ + def __init__(self, kernel): + #Available from NVprof + self.tid = kernel['tid'] + self.device = kernel['device'] + self.stream = kernel['stream'] + self.grid = str(kernel['grid']).replace(" ","").replace("(","").replace(")","") + self.block = str(kernel['block']).replace(" ","").replace("(","").replace(")","") + self.name = kernel['kShortName'].replace(" ","_") + self.lName = kernel['kLongName'] + self.sil = kernel['kDuration'] #units ns + + self.index = None + + #Markers + self.argMarker = kernel['marker'] + self.modMarker = kernel['reprMarkers'] + self.seqMarker = kernel['seqMarker'] + + self.layer = kernel['layer'] + self.trace = kernel['trace'] + + self.seqId = kernel['seqId'] + self.altSeqId = kernel['altSeqId'] + + self.dir = kernel['dir'] + self.sub = kernel['subSeqId'] + + self.mod = "na" + self.op = "na" + self.params = {"na":"na"} + self.tc = "na" + self.flops = 0 + self.bytes = 0 + + def setParams(self, params): + #Remove space from params + qaz = "" + for key,value in params.items(): + if "type" not in key: + qaz += "{}={},".format(key,value) + else: + if type(value) is str: + qaz += "{},".format(Utility.typeToString(value)) + else: + qaz += "{}".format(value) + + self.params = qaz.replace(" ", "") + diff --git a/apex/apex/pyprof/prof/dropout.py b/apex/apex/pyprof/prof/dropout.py new file mode 100644 index 0000000000000000000000000000000000000000..47b352bbf1eb1d1432b5894e1c438bbbb34bb4a2 --- /dev/null +++ b/apex/apex/pyprof/prof/dropout.py @@ -0,0 +1,50 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Dropout(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch.nn.functional") + assert (op == "dropout") + #assert (len(args) == 1) + + self.shape = args[0]['shape'] + self.type = args[0]['dtype'] + self.dir = d.dir + + return + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def tc(self): + return "-" + + def elems(self): + return Utility.numElems(self.shape) + + def bytes(self): + #Ignoring the cost of writing and reading the mask + return Utility.typeToBytes(self.type) * self.elems() * 2 + + def flops(self): + # Note: This is approximate and depends on the RNG + return 5*self.elems() diff --git a/apex/apex/pyprof/prof/embedding.py b/apex/apex/pyprof/prof/embedding.py new file mode 100644 index 0000000000000000000000000000000000000000..32a1c35eaa5b121a40a2539c7cf7376991e2a8ca --- /dev/null +++ b/apex/apex/pyprof/prof/embedding.py @@ -0,0 +1,71 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Embedding(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch.nn.functional") + assert (op == "embedding") + + self.ishape = args[0]['shape'] + self.itype = args[0]['dtype'] + + self.eshape = args[1]['shape'] + self.etype = args[1]['dtype'] + + assert (len(self.eshape) == 2) + + self.dir = d.dir + self.sub = d.sub + return + + def params(self): + p = OrderedDict([('I', self.ishape), ('itype', self.itype), ('E', self.eshape), ('etype', self.etype)]) + return p + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def tc(self): + return "-" + + def bytes(self): + ishape = self.ishape + itype = self.itype + eshape = self.eshape + etype = self.etype + + ielems = Utility.numElems(ishape) + + b = 0 + if self.dir == "fprop": + #indices + b += ielems * Utility.typeToBytes(itype) + #read and write the embedding matrix + b += ielems * eshape[1] * 2 * Utility.typeToBytes(etype) + else: + #3 times the size of the incoming gradient + b = ielems * eshape[1] * 3 * Utility.typeToBytes(etype) + + if self.sub > 0: + b = 0 + + return b + + def flops(self): + # Note: not implemented yet + return 0 diff --git a/apex/apex/pyprof/prof/index_slice_join_mutate.py b/apex/apex/pyprof/prof/index_slice_join_mutate.py new file mode 100644 index 0000000000000000000000000000000000000000..1ecbe60d731fce06d05ef01ecd65445b07768363 --- /dev/null +++ b/apex/apex/pyprof/prof/index_slice_join_mutate.py @@ -0,0 +1,419 @@ +from collections import OrderedDict +from .utility import Utility +import numpy as np +from .base import OperatorLayerBase + +class Cat(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch") + assert (op == "cat") + assert (len(args) >= 2) + + t = args[0]['dtype'] + shapes = [] + + for arg in args: + if arg['type'] == "tensor": + assert (arg['dtype'] == t) + shapes.append(arg['shape']) + + self.type = t + self.shapes = shapes + + def params(self): + p = OrderedDict([('T', self.shapes), ('type', self.type)]) + return p + + def flops(self): + return 0 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + b = 0 + for s in self.shapes: + b += Utility.numElems(s) + return 2 * b * Utility.typeToBytes(self.type) + +class Reshape(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op == "reshape") + + #Temporarily commenting three lines + #assert (len(args) == 2) + #t,s = args + #assert s['type'] == "tuple" + + t = args[0] + assert t['type'] == "tensor" + self.type = t['dtype'] + self.shape = t['shape'] + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def flops(self): + return 0 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + return 0 + +class Gather(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") or (mod == "torch") + assert (op == "gather") + + #Filter out the "out" parameter + args = list(filter(lambda x : x['name'] != 'out', args)) + assert (len(args) == 3) + + #Get input + if (args[0]['name'] == ""): + arg = args[0] + else: + arg = list(filter(lambda x : x['name'] == "input", args))[0] + + assert (arg['type'] == "tensor") + + self.shape = arg['shape'] + self.type = arg['dtype'] + + def params(self): + p = OrderedDict([('T', self.shape),('type', self.type)]) + return p + + def flops(self): + return 0 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + return 2 * Utility.numElems(self.shape) * Utility.typeToBytes(self.type) + +class MaskedScatter(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op == "masked_scatter_") + assert (len(args) == 3) + + dst, mask, src = args + assert (dst['type'] == mask['type'] == src['type'] == "tensor") + assert (mask['dtype'] == "uint8") + assert (dst['dtype'] == src['dtype']) + assert (dst['shape'] == mask['shape']) + + self.shape = dst['shape'] + self.type = dst['dtype'] + self.seqId = d.seqId + + def params(self): + p = OrderedDict([('T', self.shape),('type', self.type)]) + return p + + def flops(self): + return 0 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + elems = Utility.numElems(self.shape) + + #src and dst + b = 2 * elems * Utility.typeToBytes(self.type) + + #mask (uint8) + b += elems + + if (self.seqId > 0): + b = 0 + return b + +class Nonzero(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod in ["torch", "Tensor"]) + assert (op == "nonzero") + assert (len(args) == 1) + + arg = args[0] + self.shape = arg['shape'] + self.type = arg['dtype'] + self.seqId = d.seqId + + def params(self): + p = OrderedDict([('T', self.shape),('type', self.type)]) + return p + + def flops(self): + return 0 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + elems = Utility.numElems(self.shape) + dim = len(self.shape) + + #input tensor + b = elems * Utility.typeToBytes(self.type) + + #in the worst case, the output is a (elems x dim) tensor of type "long" + b += elems * dim * Utility.typeToBytes("int64") + + if self.seqId > 0: + return 0 + else: + return b + +class IndexSelect(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") or (mod == "torch") + assert (op == "index_select") + + #Filter out the "out" parameter + args = list(filter(lambda x : x['name'] != 'out', args)) + assert (len(args) == 3) + + #Get input, dim and index + if (args[0]['name'] == ""): + t = args[0] + else: + t = list(filter(lambda x : x['name'] == "input", args))[0] + + if (args[1]['name'] == ""): + d = args[1] + else: + d = list(filter(lambda x : x['name'] == "dim", args))[0] + + if (args[2]['name'] == ""): + i = args[2] + else: + i = list(filter(lambda x : x['name'] == "index", args))[0] + + assert (t['type'] == i['type'] == "tensor") + assert (d['type'] == "int") + assert (i['dtype'] == "int64") + assert (len(i['shape']) == 1) + + shape = t['shape'] + dim = d['value'] + indices = i['shape'][0] + assert (dim < len(shape)) + + self.shape = shape + self.dim = dim + self.indices = indices + self.type = t['dtype'] + + def params(self): + p = OrderedDict([('T', self.shape),('D', self.dim),('I', self.indices),('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def flops(self): + return 0 + + def bytes(self): + #determine the shape of the output tensor + shape = list(self.shape) + shape[self.dim] = self.indices + + b = 0 + + #time to read the input and write the output + elems = Utility.numElems(shape) + b += 2 * elems * Utility.typeToBytes(self.type) + + #time to read the indices + b += self.indices * Utility.typeToBytes("int64") + + return b + +class MaskedSelect(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + self.sub = d.sub + + assert (mod == "Tensor") or (mod == "torch") + assert (op == "masked_select") + + #Filter out the "out" parameter + args = list(filter(lambda x : x['name'] != 'out', args)) + assert (len(args) == 2) + + #Get input and mask + if (args[0]['name'] == ""): + t = args[0] + else: + t = list(filter(lambda x : x['name'] == "input", args))[0] + + if (args[1]['name'] == ""): + m = args[1] + else: + m = list(filter(lambda x : x['name'] == "mask", args))[0] + + assert (m['dtype'] == "uint8") + + tensor = t['shape'] + mask = m['shape'] + + #check for broadcast condition + if (tensor != mask): + array1 = np.empty(list(tensor)) + array2 = np.empty(list(mask)) + try: + out = np.broadcast(array1, array2).shape + except: + assert False + + self.tshape = tensor + self.mshape = mask + self.type = t['dtype'] + + def params(self): + p = OrderedDict([('T', self.tshape),('M', self.mshape),('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + tensor = self.tshape + mask = self.mshape + t = self.type + + #in the worst case, #output elements = #input elements + b = 2 * Utility.numElems(tensor) * Utility.typeToBytes(t) + + #mask tensor (assuming uint8) + b += Utility.numElems(mask) + return b + + def flops(self): + return 0 diff --git a/apex/apex/pyprof/prof/linear.py b/apex/apex/pyprof/prof/linear.py new file mode 100644 index 0000000000000000000000000000000000000000..7c9e13cbef7ab3f53fac8e478c3d9e4e27a2ca79 --- /dev/null +++ b/apex/apex/pyprof/prof/linear.py @@ -0,0 +1,188 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Linear(OperatorLayerBase): + + ''' + Notes: + If the bias occurs before the GEMM, then its 1 write (bias expansion). + If the bias occurs after, then its 1 read and 1 write. + bias in bprop is a reduction and hence is 1 read. + ''' + + gemmKernels = ["gemm", "gemv", "dot_kernel", "splitKreduce_kernel", "reduce_1Block_kernel"] + biasKernels = ["kernelReduceContigDim", "kernelReduceNoncontigDim_shared", "elementwise_kernel", "reduce_kernel"] + + def setXWBMNK(self, args): + x = None + w = None + b = None + if (len(args) == 2): + x,w = args + elif (len(args) == 3): + x,w,b = args + assert (x['type'] == w['type'] == "tensor") + if (b['type'] == "tensor"): + assert(len(b['shape']) == 1) + elif (b['type'] == "NoneType"): + assert b['value'] is None + b = None + else: + assert False + else: + assert False + + assert(len(w['shape']) == 2) + k1 = x['shape'][-1] + n,k2 = w['shape'] + assert(k1 == k2) + if b is not None: + assert(b['shape'][0] == n) + t1 = x['dtype'] + t2 = w['dtype'] + assert(t1 == t2) + + # X, W, B + self.x = x['shape'] + self.w = w['shape'] + self.b = b['shape'] if b is not None else None + self.type = t1 + + # M, N, K + #n = Utility.numElems(x[0:-1]) + n = self.x[0:-1] + k = self.x[-1] + m,k1 = self.w + assert (k == k1) + + self.m = m + self.n = n + self.k = k + + def tc(self): + if self.op() == "linear": + return 1 if "884gemm" in self.name else 0 + else: + return "-" + + def __init__(self, d): + self.name = d.name + self.dir = d.dir + self.sub = d.sub + + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + assert (mod == "torch.nn.functional") + assert (op == "linear") + + self.setXWBMNK(args) + + if any(x in d.name for x in Linear.gemmKernels): + self.op_ = "linear" + else: + assert (d.name in Linear.biasKernels) + self.op_ = "bias" + + ''' + elif (("kernelPointwiseApply2" in d.name) or ("kernelReduceContigDim" in d.name) or ("kernelReduceNoncontigDim_shared" in d.name)): + #bias expansion was before the gemm + self.op_ = "bias" + + elif ("elementwise_kernel" in d.name): + #Bias addition happens later with a broadcast tensor + self.op_ = "bias" + assert (len(d.argMarker) == 2) + marker = eval(d.argMarker[1]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + assert (mod == "Tensor") + assert (op == "__iadd__") + assert (len(args) == 2) + mn = args[0]['shape'] + b = args[1]['shape'] + assert (len(b) == 1) + + assert (mn == (self.n + (self.m,))) + assert (b == self.b) + + else: + assert False + ''' + + def params(self): + #p = OrderedDict([('X', self.x), ('W', self.w), ('B', self.b), ('type', self.type)]) + + m, n, k, x, w, t = self.m, self.n, self.k, self.x, self.w, self.type + if len(n) == 1: + n = n[0] + + if self.op_ == "linear": + if self.dir == "fprop": + p = OrderedDict([('M', m), ('N', n), ('K', k), ('type', t)]) + elif self.dir == "bprop": + if self.sub == 0: #dgrad (most likely) + p = OrderedDict([('M', k), ('N', n), ('K', m), ('type', t)]) + elif self.sub == 1: #wgrad (most likely) + p = OrderedDict([('M', k), ('N', m), ('K', n), ('type', t)]) + else: + #This happens when there are additional kernels for reduction + p = OrderedDict([('X', x), ('W', w), ('type', t)]) + else: + assert False + + elif self.op_ == "bias": + p = OrderedDict([('M', m), ('N', n), ('type', t)]) + else: + assert False + return p + + def op(self): + return self.op_ + + def bytesFlops(self): + + m = self.m + n = Utility.numElems(self.n) + k = self.k + + if self.op_ == "linear": + if self.dir == "fprop": + f = m * n * k * 2 + b = m*n + m*k + n*k * Utility.typeToBytes(self.type) + elif self.dir == "bprop": + if self.sub == 0: #dgrad (most likely) + f = m * n * k * 2 + b = m*n + m*k + n*k * Utility.typeToBytes(self.type) + elif self.sub == 1: #wgrad (most likely) + f = m * n * k * 2 + b = m*n + m*k + n*k * Utility.typeToBytes(self.type) + else: + #This happens when there are additional kernels for reduction + f = 0 + b = 0 + else: + assert False + + elif self.op_ == "bias": + f = m * n + b = 2 * m * n * Utility.typeToBytes(self.type) + else: + assert False + return b,f + + def bytes(self): + b, f = self.bytesFlops() + return b + + def flops(self): + b, f = self.bytesFlops() + return f + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/loss.py b/apex/apex/pyprof/prof/loss.py new file mode 100644 index 0000000000000000000000000000000000000000..3fe8a5501aa6fd2657a189f274b324f42d8e190d --- /dev/null +++ b/apex/apex/pyprof/prof/loss.py @@ -0,0 +1,84 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +#TODO: Add support for additional loss functions. + +class MSELoss(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch.nn.functional") + assert (op == "mse_loss") + assert (len(args) == 3) + + #Get input, target and reduction + if (args[0]['name'] == ""): + x = args[0] + else: + x = list(filter(lambda x : x['name'] == "input", args))[0] + + if (args[1]['name'] == ""): + y = args[1] + else: + y = list(filter(lambda x : x['name'] == "target", args))[0] + + if (args[2]['name'] == ""): + r = args[2] + else: + r = list(filter(lambda x : x['name'] == "reduction", args))[0] + + assert (x['type'] == y['type'] == "tensor") + assert (x['shape'] == y['shape']) + assert (x['dtype'] == y['dtype']) + assert (r['type'] == "str") + assert (r['value'] in ["none", "mean", "sum"]) + + self.shape = x['shape'] + self.type = x['dtype'] + self.red = r['value'] + self.dir = d.dir + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type), ('red', self.red)]) + return p + + def elems(self): + red = self.red + e = Utility.numElems(self.shape) + + if self.dir == "fprop": + if red == "none": + e *= 3 + else: + e *= 2 + else: + if red == "none": + e *= 4 + else: + e *= 3 + return e + + def bytes(self): + return self.elems() * Utility.typeToBytes(self.type) + + def flops(self): + return self.elems() * 2 + 1 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/misc.py b/apex/apex/pyprof/prof/misc.py new file mode 100644 index 0000000000000000000000000000000000000000..e1c247d462e8d75ed8db9ffb6b07042e668ec058 --- /dev/null +++ b/apex/apex/pyprof/prof/misc.py @@ -0,0 +1,219 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Foo(OperatorLayerBase): + """ + An object of Foo is instantiated when we detect an unsupported operator. + """ + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + shapes = [] + types = [] + + for arg in args: + if arg['type'] == "tensor": + shapes.append(arg['shape']) + types.append(arg['dtype']) + + self.shape = shapes + self.type = types + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def flops(self): + return 0 + + def bytes(self): + return 0 + +class Copy(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op == "copy_") + assert (len(args) == 2) + + dst, src = args + assert (src['type'] == dst['type']) + assert (src['shape'] == dst['shape']) + + self.shape = src['shape'] + self.stype = src['dtype'] + self.dtype = dst['dtype'] + + def params(self): + #The data type might be different + p = OrderedDict([('T', self.shape), ('stype', self.stype), ('dtype', self.dtype)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def flops(self): + return 0 + + def elems(self): + return Utility.numElems(self.shape) + + def bytes(self): + return self.elems() * (Utility.typeToBytes(self.stype) + Utility.typeToBytes(self.dtype)) + +class Clone(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op == "clone") + assert (len(args) == 1) + t = args[0] + self.shape = t['shape'] + self.type = t['dtype'] + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def flops(self): + return 0 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def elems(self): + return Utility.numElems(self.shape) + + def bytes(self): + return 2 * self.elems() * Utility.typeToBytes(self.type) + +class Contiguous(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op == "contiguous") + assert (len(args) == 1) + t = args[0] + self.shape = t['shape'] + self.type = t['dtype'] + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def flops(self): + return 0 + + def bytes(self): + return 2 * Utility.numElems(self.shape) * Utility.typeToBytes(self.type) + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + +class Any(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "Tensor") + assert (op == "any") + assert (len(args) == 1) #could be 2 as well, the second argument is a bool + t = args[0] + + self.shape = t['shape'] + self.type = t['dtype'] + self.sub = d.sub + return + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def tc(self): + return "-" + + def flops(self): + return 0 + + def bytes(self): + return Utility.numElems(self.shape) * Utility.typeToBytes(self.type) diff --git a/apex/apex/pyprof/prof/normalization.py b/apex/apex/pyprof/prof/normalization.py new file mode 100644 index 0000000000000000000000000000000000000000..c9c5ae0b177b330539c19c68f6d6d414de4a5c57 --- /dev/null +++ b/apex/apex/pyprof/prof/normalization.py @@ -0,0 +1,54 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class BatchNorm(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (op == "batch_norm") + assert (len(args) == 8) + i = args[0] + assert (i['type'] == "tensor") + + self.shape = i['shape'] + self.type = i['dtype'] + self.dir = d.dir + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def elems(self): + return Utility.numElems(self.shape) + + def flops(self): + # Variance algo-dependent, but this is a reasonable value. + return self.elems() * 8 + + def bytes(self): + e = self.elems() + if self.dir == "fprop": + e *= 4 + else: + e *= 5 + + return e * Utility.typeToBytes(self.type) diff --git a/apex/apex/pyprof/prof/optim.py b/apex/apex/pyprof/prof/optim.py new file mode 100644 index 0000000000000000000000000000000000000000..f2c32759b4fbd2cf5c9bd62c3f3ab7bcbca8907e --- /dev/null +++ b/apex/apex/pyprof/prof/optim.py @@ -0,0 +1,65 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +#TODO: Add support for other optimizers. + +class Adam(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert(op == "adam") + assert (len(args) == 12) or (len(args) == 14) + w, hw, m, v, g = args[0:5] + assert (w['shape'] == m['shape'] == v['shape'] == g['shape']) + assert (hw['shape'] == w['shape']) or (hw['shape'] == (0,)) #hw could be null + assert (w['type'] == m['type'] == v['type'] == g['type'] == hw['type'] == "tensor") + assert (w['dtype'] == m['dtype'] == v['dtype'] == "float32") + + self.w = w + self.g = g + + def params(self): + p = OrderedDict([('T',self.w['shape']), ('wtype',self.w['dtype']), ('gtype',self.g['dtype'])]) + return p + + def flops(self): + return 0 + + def bytes(self): + wshape = self.w['shape'] + wtype = self.w['dtype'] + gtype = self.g['dtype'] + b = 0 + + elems = Utility.numElems(wshape) + + #Get time to stream read/write w, m, v + b += 6 * elems * Utility.typeToBytes(wtype) + + #Get time to read "g" + b += elems * Utility.typeToBytes(gtype) + + if wtype != gtype: #mixed precision + #Get time to write "hw + b += elems * Utility.typeToBytes(gtype) + + return b + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/output.py b/apex/apex/pyprof/prof/output.py new file mode 100644 index 0000000000000000000000000000000000000000..832514cf24b5ac8fb71bbba8f416295f4f44fc52 --- /dev/null +++ b/apex/apex/pyprof/prof/output.py @@ -0,0 +1,149 @@ +import errno, os, sys + +class Output(): + """ + This class handles printing of a columed output and a CSV. + """ + + # The table below is organized as + # user_option: [output_header, attribute_in_Data_class, type, min_width_in_columed_output] + table = { + "idx": ["Idx", "index", int, 7], + "seq": ["SeqId", "seqId", str, 7], + "altseq": ["AltSeqId", "altSeqId", str, 7], + "tid": ["TId", "tid", int, 12], + "layer": ["Layer", "layer", str, 10], + "trace": ["Trace", "trace", str, 25], + "dir": ["Direction", "dir", str, 5], + "sub": ["Sub", "sub", int, 3], + "mod": ["Module", "mod", str, 15], + "op": ["Op", "op", str, 15], + "kernel": ["Kernel", "name", str, 0], + "params": ["Params", "params", str, 0], + "sil": ["Sil(ns)", "sil", int, 10], + "tc": ["TC", "tc", str, 2], + "device": ["Device", "device", int, 3], + "stream": ["Stream", "stream", int, 3], + "grid": ["Grid", "grid", str, 12], + "block": ["Block", "block", str, 12], + "flops": ["FLOPs", "flops", int, 12], + "bytes": ["Bytes", "bytes", int, 12] + } + + def __init__(self, args): + self.cols = args.c + self.csv = args.csv + self.col = True if (args.w > 0) else False + self.width = args.w + + w = 0 + for col in self.cols: + assert col in Output.table.keys() + w += Output.table[col][3] + + if ((self.col) and (w > self.width)): + print("Minimum width required to print {} = {}. Exiting.".format(",".join(self.cols), w)) + sys.exit(1) + + remainder = self.width - w + + if ("kernel" in self.cols) and ("params" in self.cols): + Output.table["kernel"][3] = int(remainder/2) + Output.table["params"][3] = int(remainder/2) + elif ("kernel" in self.cols): + Output.table["kernel"][3] = remainder + elif ("params" in self.cols): + Output.table["params"][3] = remainder + + #header format + cadena = "" + for col in self.cols: + _,_,t,w = Output.table[col] + cadena += "%-{}.{}s ".format(w,w) + + self.hFormat = cadena + + #data format + cadena = "" + for col in self.cols: + _,_,t,w = Output.table[col] + if (t == str): + cadena += "%-{}.{}s ".format(w,w) + elif (t == int): + cadena += "%{}d ".format(w) + + self.dFormat = cadena + + def foo(self, cadena, pformat): + if self.csv: + cadena = ",".join(map(lambda x : '"' + str(x) + '"', cadena)) + elif self.col: + cadena = pformat % cadena + else: + cadena = " ".join(map(str,cadena)) + + try: + print(cadena) + except IOError as e: + #gracefully handle pipes + if e.errno == errno.EPIPE: + # Python flushes standard streams on exit; redirect remaining output + # to devnull to avoid another BrokenPipeError at shutdown + + devnull = os.open(os.devnull, os.O_WRONLY) + os.dup2(devnull, sys.stdout.fileno()) + sys.exit(0) + else: + sys.exit(-1) + + def header(self): + cadena = () + for col in self.cols: + h = Output.table[col][0] + cadena = cadena + (h,) + + self.foo(cadena, self.hFormat) + + def data(self, a): + if a.dir == "": + direc = "na" + else: + direc = a.dir + + if a.op == "": + op = "na" + else: + op = a.op + + if a.mod == "": + mod = "na" + else: + mod = a.mod + + cadena = () + for col in self.cols: + attr = Output.table[col][1] + val = getattr(a, attr) + + if col == "layer": + assert(type(val) == list) + val = ":".join(val) + val = "-" if val == "" else val + + if col == "trace": + assert(type(val) == list) + if self.col and len(val): + val = val[-1] + val = val.split("/")[-1] + else: + val = ",".join(val) + val = "-" if val == "" else val + + if col in ["seq", "altseq"]: + assert(type(val) == list) + val = ",".join(map(str,val)) + val = "-" if val == "" else val + + cadena = cadena + (val,) + + self.foo(cadena, self.dFormat) diff --git a/apex/apex/pyprof/prof/pointwise.py b/apex/apex/pyprof/prof/pointwise.py new file mode 100644 index 0000000000000000000000000000000000000000..3c9afc52a7d27940a1ca3d0cafa19fa2d06e7283 --- /dev/null +++ b/apex/apex/pyprof/prof/pointwise.py @@ -0,0 +1,166 @@ +import numpy as np +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Pointwise(OperatorLayerBase): + + ops = [] + ops += ["__abs__", "__neg__", "__invert__"] + ops += ["__add__", "__sub__", "__mul__", "__floordiv__", "__truediv__", "__pow__", "__mod__"] + ops += ["__radd__", "__rsub__", "__rmul__", "__rdiv__", "__rtruediv__", "__rfloordiv__", "__rpow__"] + ops += ["__iadd__", "__isub__", "__imul__", "__itruediv__",] + ops += ["__lt__", "__gt__", "__ge__", "__le__", "__eq__", "__ne__",] + ops += ["lt", "lt_", "gt", "gt_", "ge", "ge_", "le", "le_", "eq", "eq_", "ne", "ne_",] + ops += ["__and__", "__or__", "__xor__", "__lshift__", "__rshift__"] + ops += ["__iand__", "__ior__", "__ixor__", "__ilshift__", "__irshift__"] + ops += ["abs", "abs_", "neg", "neg_"] + ops += ["add", "add_", "div", "div_", "mul", "mul_", "reciprocal", "reciprocal_", "remainder", "remainder_", "sub", "sub_",] + ops += ["addcdiv", "addcdiv_", "addcmul", "addcmul_"] + ops += ["exp", "exp_", "exp1m", "exp1m_", "log", "log_", "log10", "log10_", "log1p", "log1p_", "log2", "log2_", "pow", "pow_", "rsqrt", "rsqrt_", "sqrt", "sqrt_",] + ops += ["ceil", "ceil_", "clamp", "clamp_", "floor", "floor_", "fmod", "fmod_", "frac", "frac_", "round", "round_", "sign", "sign_", "trunc", "trunc_"] + ops += ["acos", "acos_", "asin", "asin_", "atan", "atan_", "atan2", "atan2_", "cos", "cos_", "cosh", "cosh_", "sin", "sin_", "sinh", "sinh_", "tan", "tan_", "sigmoid", "sigmoid_", "tanh", "tanh_"] + ops += ["digamma", "erf", "erf_", "erfc", "erfc_", "erfinv", "erfinv_", "lerp", "lerp_", "mvlgamma",] + + @staticmethod + def foo(d): + return d['name'],d['type'],d['shape'],d['dtype'] + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + self.dir = d.dir + assert (d.dir in ["fprop", "bprop"]) + assert (op in Pointwise.ops) + + #Filter out all named parameters (kwargs). + #This might require revisiting in future. + args = list(filter(lambda x : x['name'] == "", args)) + + #Filter out non tensors + args = list(filter(lambda x : x['type'] == "tensor", args)) + + if (len(args) == 0): + self.shape = [(1,)] + self.type = "float32" #FIX + + elif (len(args) == 1): + in0 = args[0] + _,t0,s0,dt0 = Pointwise.foo(in0) + assert (t0 == "tensor") + self.shape = [s0,] + self.type = dt0 + + elif (len(args) == 2): + in0,in1 = args + _,t0,s0,dt0 = Pointwise.foo(in0) + _,t1,s1,dt1 = Pointwise.foo(in1) + assert (t0 == t1 == "tensor") + assert (dt0 == dt1) + self.shape = [s0,s1] + self.type = dt0 + + elif (len(args) == 3): + in0,in1,in2 = args + _,t0,s0,dt0 = Pointwise.foo(in0) + _,t1,s1,dt1 = Pointwise.foo(in1) + _,t2,s2,dt2 = Pointwise.foo(in2) + assert (t0 == t1 == t2 == "tensor") + assert (dt0 == dt1 == dt2) + self.shape = [s0,s1,s2] + self.type = dt0 + else: + assert False + return + + def params(self): + p = OrderedDict([('T',self.shape), ('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def elems(self): + tensor = self.shape + t = self.type + + if (len(tensor) == 1): + elems = 2 * Utility.numElems(tensor[0]) + elif (len(tensor) == 2): + if (tensor[0] == tensor[1]): # same shape + elems = Utility.numElems(tensor[0]) + if self.dir == "fprop": + elems *= 3 + else: + if (self.op_ in ["add", "__add__", "sub", "__sub__", "__isub__"]): + elems *= 2 + elif (self.op_ in ["__mul__", "__rmul__", "div", "__truediv__"]): + elems *= 3 + else: + assert False + else: #check for broadcast conditions + array1 = np.empty(list(tensor[0])) + array2 = np.empty(list(tensor[1])) + try: + out = np.broadcast(array1, array2).shape + except: + assert False + + elems = Utility.numElems(tensor[0]) + elems += Utility.numElems(tensor[1]) + elems += Utility.numElems(out) + #TODO bprop + elif (len(tensor) == 3): + if (tensor[0] == tensor[1] == tensor[2]): #same shape + elems = Utility.numElems(tensor[0]) + elems *= 4 + else: + assert False + else: + assert False + + return elems + + def bytes(self): + return self.elems() * Utility.typeToBytes(self.type) + + def flops(self): + # Note: some cases may still be missing. + + f = 0 + if self.op_ in ["__abs__", "__neg__", "__add__", "__sub__", "__mul__", + "__radd__", "__rmul__", "__iadd__", "__isub__", "__imul__", "__itruediv__", + "abs", "abs_", "neg", "neg_", "add", "add_", "div", "div_", "mul", "mul_", + "sub", "sub_", "exp", "exp_", "sign", "sign_", "trunc", "trunc_", + "sin", "sin_", "cos", "cos_", "sinh", "sinh_", "cosh", "cosh_", + "sqrt", "sqrt_", "rsqrt", "rsqrt_", "__lt__", "__gt__", "__ge__", "__le__", + "__eq__", "__ne__", "lt", "lt_", "gt", "gt_", "ge", "ge_", "le", "le_", + "eq", "eq_", "ne", "ne_", "ceil", "ceil_", "clamp", "clamp_", "floor", "floor_", + "round", "sign", "sign_", "trunc", "trunc_"]: + # We're counting only one operand, not two (2 operands, 1 op) + f = self.elems() / 2 + elif self.op_ in ["fmod", "fmod_"]: + f = self.elems() + elif self.op_ in ["tanh", "tanh_", "sigmoid", "sigmoid_", "log", "log_", "log2", + "log2_", "log10", "log10_"]: + f = self.elems() * 2 + elif self.op_ in ["asin", "asin_", "acos", "acos_", "atan", "atan_"]: + # no intrinsic, hence slow execution + # surprisingly, asin/acos and atan were all the same (via nvprof measurement) + f = self.elems() * 10 + + return f diff --git a/apex/apex/pyprof/prof/pooling.py b/apex/apex/pyprof/prof/pooling.py new file mode 100644 index 0000000000000000000000000000000000000000..3f342b4d4d1f6701b55c061a4789ca835478d55b --- /dev/null +++ b/apex/apex/pyprof/prof/pooling.py @@ -0,0 +1,59 @@ +from .collections import OrderedDict +from .utility import Utility + +# Work in progress. + +#poolFuncs = ["max_pool2d_with_indices_forward", "max_pool2d_with_indices"] +class MaxPool2d(object): + + def parse(marker): + + def convert2Tuple(arg): + assert (arg['type'] in ["int", "tuple"]) + if arg['type'] == "int": + return (arg['value'], arg['value']) + else: + return arg['value'] + + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + assert (mod == "torch.nn.functional") + assert (op == "max_pool2d") + assert (len(args) >= 2) + + #input + assert (args[0]['name'] == "") + inp = args[0] + assert (inp['type'] == "tensor") + i = inp['shape'] + t = inp['dtype'] + assert (len(i) == 4) #nchw tensor + + #kernel + if (args[1]['name'] == ""): + k = args[1] + else: + k = list(filter(lambda x : x['name'] == "kernel_size", args))[0] + k = convert2Tuple(k) + + #stride + s = k #default value + if ((len(args) >= 3) and args[2] == ""): + s = args[2] + s = convert2Tuple(s) + elif any(x['name'] == "stride" for x in args): + s = list(filter(lambda x : x['name'] == "stride", args))[0] + s = convert2Tuple(s) + + #padding + p = (0,0) + if ((len(args) >= 4) and args[3] == ""): + p = args[3] + p = convert2Tuple(p) + elif any(x['name'] == "padding" for x in args): + p = list(filter(lambda x : x['name'] == "padding", args))[0] + p = convert2Tuple(p) + + params = OrderedDict([('T', i), ('K', k), ('s',s), ('p',p), ('type', t)]) + return params diff --git a/apex/apex/pyprof/prof/prof.py b/apex/apex/pyprof/prof/prof.py new file mode 100755 index 0000000000000000000000000000000000000000..a3467e6f3fda58fba63fc9affa1d417e6e825e10 --- /dev/null +++ b/apex/apex/pyprof/prof/prof.py @@ -0,0 +1,256 @@ +#!/usr/bin/env python3 + +""" +This script reads the output (Python dictionary) created by parse.py. +For every kernel (line) in the input it determines + module / class name e.g. torch.nn.functional + operator name e.g. linear + kernel parameters e.g. GEMM M, N, K, datatype + bytes + flops + tensor core usage + direction (fprop, bprop) + and other things. Please see the tool usage. +""" + +from .usage import parseArgs +from .output import Output +from .utility import Utility +from .pointwise import Pointwise +from .convert import Convert +from .blas import * +from .embedding import Embedding +from .reduction import * +from .dropout import Dropout +from .softmax import * +#from pooling import * # work in progress +from .linear import Linear +from .optim import Adam +from .misc import * +from .conv import Conv +from .activation import Activation +from .index_slice_join_mutate import Cat, Reshape, MaskedScatter, Gather, Nonzero, IndexSelect, MaskedSelect +from .recurrentCell import RNNCell +from .normalization import BatchNorm +from .randomSample import RandPerm +from .loss import MSELoss +from .data import Data + +def findFpropKernel(seq): + #Find the last fprop kernel with the same seqId + #First look at seqId and then at altSeqId + for idx in reversed(range(len(kernels))): + k = kernels[idx] + if (seq in k['seqId']) and (k['dir'] == "fprop"): + return idx + + for idx in reversed(range(len(kernels))): + k = kernels[idx] + if (seq in k['altSeqId']) and (k['dir'] == "fprop"): + return idx + + return -1 + #print("Error: seqId {} not found.".format(seq), file=sys.stderr) + #assert False + +def foo(mod, op, d): + if (op[0] == "linear"): + xx = Linear(d) + + # rnncell, lstmcell, grucell + elif (mod[0] in["LSTMCell", "GRUCell"]) and (op[0] == "forward"): + xx = RNNCell(d) + + elif op[0] in ["conv1d", "conv2d",]: + xx = Conv(d) + + elif (op[0] in Pointwise.ops): + xx = Pointwise(d) + + elif (op[0] in Convert.ops): + xx = Convert(d) + + elif op[0] in ["__matmul__", "matmul"]: + xx = Matmul(d) + + elif op[0] == "embedding": + xx = Embedding(d) + + #reduction + elif op[0] == "sum": + xx = Sum(d) + + elif op[0] == "mean": + xx = Mean(d) + + elif op[0] == "norm": + xx = Norm(d) + + elif op[0] == "dropout": + xx = Dropout(d) + + #Index, Slice, Join, Mutate + elif (op[0] == "cat"): + xx = Cat(d) + + elif (op[0] == "reshape"): + xx = Reshape(d) + + elif (op[0] == "masked_scatter_"): + xx = MaskedScatter(d) + + elif (op[0] == "gather"): + xx = Gather(d) + + elif (op[0] == "nonzero"): + xx = Nonzero(d) + + elif (op[0] == "index_select"): + xx = IndexSelect(d) + + elif (op[0] == "masked_select"): + xx = MaskedSelect(d) + + #blas + elif op[0] in ["addmm", "addmm_"]: + xx = Addmm(d) + + elif op[0] == "mm": + xx = Mm(d) + + elif op[0] == "bmm": + xx = Bmm(d) + + #softmax + elif op[0] == "softmax": + xx = Softmax(d) + + elif op[0] == "log_softmax": + xx = LogSoftmax(d) + + #loss + elif op[0] == "mse_loss": + xx = MSELoss(d) + + #optimizers + elif op[0] == "adam": + xx = Adam(d) + + #normalization + elif op[0] == "batch_norm": + xx = BatchNorm(d) + + #random + elif op[0] == "randperm": + xx = RandPerm(d) + + #misc + elif op[0] == "copy_": + xx = Copy(d) + + elif op[0] == "clone": + xx = Clone(d) + + elif op[0] == "contiguous": + xx = Contiguous(d) + + elif op[0] == "any": + xx = Any(d) + + elif (op[0] in Activation.ops): + xx = Activation(d) + + elif op[0] == "to": + xx = Convert(d) + + else: + xx = Foo(d) + + return xx + +def main(): + #Read cmd line arguments + cmdArgs = parseArgs() + + output = Output(cmdArgs) + output.header() + + idx = -1 + #Read in all the kernel info + for line in cmdArgs.file: + idx += 1 + kernel = eval(line) + assert(kernel) + kernels.append(kernel) + + k = kernel + d = Data(k) + + mod = k['mod'] + op = k['op'] + + flops = 0 + params = {"na":"na"} + tc = "na" + bytes = 0 + + if (d.dir == "bprop"): + d.seqMarker = k['seqMarker'] + seq = k['seqId'] + if len(seq) > 1: + pass + seq = k['seqId'][:1] + assert (len(seq) == 1), seq + #assert (seq[0] != 0) + assert (len(d.seqMarker) > 0) + #If there is no useful marker associated, use the + #sequence number to find the kernel from fprop + if len(d.argMarker) == 0: + index = findFpropKernel(seq[0]) + if index >= 0: + d.argMarker = kernels[index]['marker'] + d.modMarker = kernels[index]['reprMarkers'] + mod = kernels[index]['mod'] + op = kernels[index]['op'] + + d.layer = kernels[index]['layer'] + d.trace = kernels[index]['trace'] + + # Check if marker has our annotations + if len(d.argMarker) and Utility.hasNVTX(d.argMarker[0]): + + xx = foo(mod, op, d) + + bytes = xx.bytes() + flops = xx.flops() + op = xx.op() + params = xx.params() + tc = xx.tc() + + if type(op) is list: + if len(op): + op = op[0] + else: + op = "" + + if type(mod) is list: + if len(mod): + mod = mod[0] + else: + mod = "" + + d.index = idx+1 + + # The following 8 come from operator class functions. + d.setParams(params) + d.tc = tc + d.flops = flops + d.bytes = bytes + d.mod = mod + d.op = op + + output.data(d) + +kernels = [] +if __name__ == '__main__': + main() diff --git a/apex/apex/pyprof/prof/randomSample.py b/apex/apex/pyprof/prof/randomSample.py new file mode 100644 index 0000000000000000000000000000000000000000..f7521bf348f36ad2dac39b22df35eacb6d2d381b --- /dev/null +++ b/apex/apex/pyprof/prof/randomSample.py @@ -0,0 +1,43 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class RandPerm(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch") + assert (op == "randperm") + assert (len(args) == 1) + n = args[0] + assert n['type'] == "int" + self.n = n['value'] + + def params(self): + p = OrderedDict([('N', self.n)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + return self.n * Utility.typeToBytes("int64") + + def flops(self): + # Depends on RNG but this is probably a reasonable assumption. + return self.n * 3 diff --git a/apex/apex/pyprof/prof/recurrentCell.py b/apex/apex/pyprof/prof/recurrentCell.py new file mode 100644 index 0000000000000000000000000000000000000000..945a7b158caf267274bd171060f7e37ebbf5792e --- /dev/null +++ b/apex/apex/pyprof/prof/recurrentCell.py @@ -0,0 +1,207 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +def hasTileSize(name): + if ("sgemm" in name) or ("884gemm" in name) or ("hgemm" in name): + return True + else: + return False + +def ctaTile(name): + name = name.split("_") + name = list(filter(lambda x : "x" in x, name)) + name = list(filter(lambda x : "slice" not in x, name)) + assert(len(name) == 1) + name = name[0].split("x") + assert(len(name) == 2) + name = list(map(int, name)) + return name[0], name[1] + +class RNNCell(OperatorLayerBase): + """ + This class supports RNNCell, LSTMCell and GRUCell. + """ + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + self.name = d.name + self.dir = d.dir + self.sub = d.sub + self.grid = d.grid + + assert (op == "forward") + assert (mod in ["LSTMCell", "GRUCell", "RNNCell"]) + assert (len(args) in [2,3]) + + x,h = args[0],args[1] + b1,ii = x['shape'] + b2,hh = h['shape'] + assert b1 == b2 + assert x['dtype'] == h['dtype'] + t = x['dtype'] + + self.cell = mod + self.inp = ii + self.hid = hh + self.b = b1 + self.type = t + + self.multiple = 1 + if self.cell == "LSTMCell": + self.multiple = 4 + elif self.cell == "GRUCell": + self.multiple = 3 + + self.gemm = None + self.m = None + self.n = None + self.k = None + self.elems = 0 + + self.bar() + + def params(self): + if self.gemm is None: + p = OrderedDict([('cell', self.cell), ('X', self.inp), ('H', self.hid), ('B', self.b), ('type', self.type)]) + else: + assert self.m is not None + assert self.n is not None + assert self.k is not None + p = OrderedDict([('gemm', self.gemm), ('M', self.m), ('N', self.n), ('K', self.k), ('type', self.type)]) + return p + + def tc(self): + if "gemm" in self.name: + return 1 if "884gemm" in self.name else 0 + else: + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def bytes(self): + if self.gemm is not None: + m, n, k, t = self.m, self.n, self.k, self.type + b = (m*k + k*n + m*n) * Utility.typeToBytes(t) + elif self.elems != 0: + b = self.elems * Utility.typeToBytes(self.type) + else: + b = 0 + return b + + def flops(self): + if self.gemm is not None: + m, n, k = self.m, self.n, self.k + f = 2*m*n*k + elif self.elems != 0: + f = 0 #TODO + else: + f = 0 + return f + + def bar(self): + cell = self.cell + X = self.inp + H = self.hid + B = self.b + t = self.type + subseqId = self.sub + direc = self.dir + name = self.name + grid = self.grid + multiple = self.multiple + + if direc == "fprop": + subseqId = subseqId % 3 + if subseqId == 0: #layer gemm + self.gemm = "layer" + self.m = multiple*H + self.n = B + self.k = X + elif subseqId == 1: #recurrent gemm + self.gemm = "recur" + self.m = multiple*H + self.n = B + self.k = H + else: + layerGemmElems = multiple*H*B + recurGemmElems = multiple*H*B + cElems = H*B + hElems = H*B + totElems = layerGemmElems + recurGemmElems + 2*cElems + hElems + self.elems = totElems + + else: + if ("gemm" in name) and hasTileSize(name): #gemm + #Get cta tile size + tileX, tileY = ctaTile(name) + #Get grid dimensions + grid = grid.split(",") + gridX,gridY,gridZ = map(lambda x : int(x), grid) + + gemmM = tileX * gridX + gemmN = tileY * gridY + + if name[-3:] == "_nn": # dgrad + if (gemmM == H): # recurrent dgrad + #Ideally gemmN = B, but we have a limited set of tile sizes. + gemmN = B + gemmK = multiple*H + + self.gemm = "recur" + self.m = gemmM + self.n = gemmN + self.k = gemmK + + elif (gemmM == X): # layer dgrad + #assert(gemmN % B == 0) + gemmK = multiple*H + + self.gemm = "layer" + self.m = gemmM + self.n = gemmN + self.k = gemmK + + else: + pass + + elif name[-3:] == "_nt": #wgrad + if (gemmM == H): #recurrent wgrad + assert (gemmN == multiple*H) + gemmK = B + + self.gemm = "recur" + self.m = gemmM + self.n = gemmN + self.k = gemmK + + elif (gemmM == X): #layer wgrad + assert (gemmN == multiple*H) + gemmK = B + + self.gemm = "layer" + self.m = gemmM + self.n = gemmN + self.k = gemmK + + else: + pass + else: + pass + else: + pass + + return diff --git a/apex/apex/pyprof/prof/reduction.py b/apex/apex/pyprof/prof/reduction.py new file mode 100644 index 0000000000000000000000000000000000000000..af2703523525a16b8d27e6d627ce610a2a24d000 --- /dev/null +++ b/apex/apex/pyprof/prof/reduction.py @@ -0,0 +1,150 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Mean(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod in ["torch", "Tensor"]) + assert (op == "mean") + + #Filter out named parameters + args = list(filter(lambda x : x['name'] == '', args)) + + assert (len(args) <= 2) + i = args[0] + + self.shape = i['shape'] + self.type = i['dtype'] + self.dir = d.dir + self.sub = d.sub + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def elems(self): + return Utility.numElems(self.shape) + + def bytes(self): + if self.sub == 0: + return self.elems() * Utility.typeToBytes(self.type) + else: + return 0 + + def flops(self): + if self.sub == 0: + return self.elems() + 1 + else: + return 0 + +class Sum(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod in ["torch", "Tensor"]) + assert (op == "sum") + assert (len(args) >= 1) + + #Get input + if (args[0]['name'] == ""): + i = args[0] + else: + i = list(filter(lambda x : x['name'] == "input", args))[0] + + self.shape = i['shape'] + self.type = i['dtype'] + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def elems(self): + return Utility.numElems(self.shape) + + def flops(self): + # Note: This is incorrect, need to calculate actual flops (say via nvprof) + return self.elems() + + def bytes(self): + return self.elems() * Utility.typeToBytes(self.type) + +class Norm(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod in ["torch", "Tensor"]) + assert (op == "norm") + #assert (len(args) == 1) + i = args[0] + self.shape = i['shape'] + self.type = i['dtype'] + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def elems(self): + return Utility.numElems(self.shape) + + def bytes(self): + return self.elems() * Utility.typeToBytes(self.type) + + def flops(self): + # square and add plus sqrt + return 2 * self.elems() + 1 + + def tc(self): + return "-" + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ diff --git a/apex/apex/pyprof/prof/softmax.py b/apex/apex/pyprof/prof/softmax.py new file mode 100644 index 0000000000000000000000000000000000000000..4271a8d9497b5ada64108c710341bba504b2037b --- /dev/null +++ b/apex/apex/pyprof/prof/softmax.py @@ -0,0 +1,115 @@ +from collections import OrderedDict +from .utility import Utility +from .base import OperatorLayerBase + +class Softmax(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch.nn.functional") + assert (op == "softmax") + + #Filter out named parameters + args = list(filter(lambda x : x['name'] == '', args)) + + assert (len(args) <= 2) + self.shape = args[0]['shape'] + self.type = args[0]['dtype'] + self.dir = d.dir + + return + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def tc(self): + return "-" + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def elems(self): + return Utility.numElems(self.shape) + + def flops(self): + # Note: exp, sum-reduce, divide + #flops = elems * 3 + return 0 + + def bytes(self): + b = self.elems() * Utility.typeToBytes(self.type) + b *= 3 if self.dir == "fprop" else 5 #verify + return b + +class LogSoftmax(OperatorLayerBase): + + def __init__(self, d): + marker = eval(d.argMarker[0]) + mod = marker['mod'] + op = marker['op'] + args = marker['args'] + + self.marker = marker + self.mod_ = mod + self.op_ = op + self.args = args + + assert (mod == "torch.nn.functional") + assert (op == "log_softmax") + + #Filter out named parameters + args = list(filter(lambda x : x['name'] == '', args)) + + assert (len(args) <= 2) + + #Get input + if (args[0]['name'] == ""): + i = args[0] + else: + i = list(filter(lambda x : x['name'] == "input", args))[0] + + t = i['dtype'] + + self.shape = i['shape'] + self.type = i['dtype'] + self.dir = d.dir + return + + def op(self): + return self.op_ + + def mod(self): + return self.mod_ + + def tc(self): + return "-" + + def params(self): + p = OrderedDict([('T', self.shape), ('type', self.type)]) + return p + + def elems(self): + return Utility.numElems(self.shape) + + def flops(self): + # Note: exp, sum-reduce, divide, log + #flops = elems * 4 + return 0 + + def bytes(self): + b = self.elems() * Utility.typeToBytes(self.type) + b *= 3 if self.dir == "fprop" else 5 #verify + return b diff --git a/apex/apex/pyprof/prof/usage.py b/apex/apex/pyprof/prof/usage.py new file mode 100644 index 0000000000000000000000000000000000000000..3a299d56502af39f28286990b3d0881946edaa22 --- /dev/null +++ b/apex/apex/pyprof/prof/usage.py @@ -0,0 +1,73 @@ +import sys +import argparse + +def parseArgs(): + """ + Print usage and parse arguments. + """ + + def check_cols(value): + valid = ["idx", "seq", "altseq", "tid", "layer", "trace", "dir", "sub", "mod", "op", "kernel", "params", "sil", "tc", "device", "stream", "grid", "block", "flops", "bytes"] + cols = value.split(",") + for col in cols: + if col not in valid: + raise argparse.ArgumentTypeError("{} is not a valid column name. Valid column names are {}.".format(col, ",".join(valid))) + return cols + + def openFile(f): + try: + d = open(f, "r") + return d + except IOError: + print("Error opening file {}. Exiting.".format(f), file=sys.stderr) + sys.exit(1) + + parser = argparse.ArgumentParser(prog=sys.argv[0], description="PyTorch Profiler", formatter_class=argparse.RawTextHelpFormatter) + parser.add_argument("file", + nargs='?', + type=str, + default=None, + help="Output of parse.py (Python dictionary).") + + parser.add_argument("-c", + type=check_cols, + default="idx,dir,sub,mod,op,kernel,params,sil", + help='''Comma seperated names of columns to print. +idx: Index +seq: PyTorch Sequence Id +altseq: PyTorch Alternate Sequence Id +tid: Thread Id +layer: User annotated NVTX string (can be nested) +trace: Function Call Trace +dir: Direction +sub: Sub Sequence Id +mod: Module +op: Operattion +kernel: Kernel Name +params: Parameters +sil: Silicon Time (in ns) +tc: Tensor Core Usage +device: GPU Device Id +stream: Stream Id +grid: Grid Dimensions +block: Block Dimensions +flops: Floating point ops (FMA = 2 FLOPs) +bytes: Number of bytes in and out of DRAM +e.g. -c idx,kernel,sil''') + + group = parser.add_mutually_exclusive_group() + group.add_argument("--csv", + action="store_true", + default=False, + help="Print a CSV output.") + group.add_argument("-w", + type=int, + default=0, + help="Width of columnated output.") + + args = parser.parse_args() + if args.file is None: + args.file = sys.stdin + else: + args.file = openFile(args.file) + return args diff --git a/apex/apex/pyprof/prof/utility.py b/apex/apex/pyprof/prof/utility.py new file mode 100644 index 0000000000000000000000000000000000000000..d2bede357bdefee493df53ae20f467445147cbd7 --- /dev/null +++ b/apex/apex/pyprof/prof/utility.py @@ -0,0 +1,60 @@ +from functools import reduce + +class Utility(object): + + @staticmethod + def numElems(shape): + assert (type(shape) == tuple) + return reduce(lambda x,y: x*y, shape, 1) + + @staticmethod + def typeToBytes(t): + if (t in ["uint8", "int8", "byte", "char", "bool"]): + return 1 + elif (t in ["float16", "half", "int16", "short"]): + return 2 + elif (t in ["float32", "float", "int32", "int"]): + return 4 + elif (t in ["int64", "long", "float64", "double"]): + return 8 + assert False + + @staticmethod + def typeToString(t): + if (t in ["uint8", "byte", "char",]): + return "uint8" + elif (t in ["int8",]): + return "int8" + elif (t in ["int16", "short",]): + return "int16" + elif (t in ["float16", "half"]): + return "fp16" + elif (t in ["float32", "float"]): + return "fp32" + elif (t in ["int32", "int",]): + return "int32" + elif (t in ["int64", "long"]): + return "int64" + elif (t in ["float64", "double",]): + return "fp64" + elif (t in ["bool",]): + return "bool" + assert False + + @staticmethod + def hasNVTX(marker): + if type(marker) is str: + try: + marker = eval(marker) + except: + return False + + if type(marker) is dict: + keys = marker.keys() + return ("mod" in keys) and ("op" in keys) and ("args" in keys) + else: + return False + + @staticmethod + def isscalar(t): + return (t in ["float", "int"]) diff --git a/apex/apex/reparameterization/README.md b/apex/apex/reparameterization/README.md new file mode 100644 index 0000000000000000000000000000000000000000..9e86fd8fc1eecb066b10814fea5967acbb67fe7b --- /dev/null +++ b/apex/apex/reparameterization/README.md @@ -0,0 +1 @@ +Under construction... diff --git a/apex/apex/reparameterization/__init__.py b/apex/apex/reparameterization/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..6f339ae198c4e0d73cc79dc6e9176f6315383e2a --- /dev/null +++ b/apex/apex/reparameterization/__init__.py @@ -0,0 +1,127 @@ +from .weight_norm import WeightNorm +from .reparameterization import Reparameterization + +def apply_weight_norm(module, name='', dim=0, hook_child=True): + r""" + Applies weight normalization to a parameter in the given module. + If no parameter is provided, applies weight normalization to all + parameters in model (except 1-d vectors and scalars). + + .. math:: + \mathbf{w} = g \dfrac{\mathbf{v}}{\|\mathbf{v}\|} + + Weight normalization is a reparameterization that decouples the magnitude + of a weight tensor from its direction. This replaces the parameter specified + by `name` (e.g. "weight") with two parameters: one specifying the magnitude + (e.g. "weight_g") and one specifying the direction (e.g. "weight_v"). + Weight normalization is implemented via a hook that recomputes the weight + tensor from the magnitude and direction before every :meth:`~Module.forward` + call. + + By default, with `dim=0`, the norm is computed independently per output + channel/plane. To compute a norm over the entire weight tensor, use + `dim=None`. + + See https://arxiv.org/abs/1602.07868 + + Args: + module (nn.Module): containing module + name (str, optional): name of weight parameter + dim (int, optional): dimension over which to compute the norm + hook_child (boolean, optional): adds reparameterization hook to direct parent of the + parameters. If False, it's added to `module` instead. Default: True + + Returns: + The original module with the weight norm hook + + Example:: + + >>> m = apply_weight_norm(nn.Linear(20, 40), name='weight') + Linear (20 -> 40) + >>> m.weight_g.size() + torch.Size([40, 1]) + >>> m.weight_v.size() + torch.Size([40, 20]) + + """ + return apply_reparameterization(module, reparameterization=WeightNorm, hook_child=hook_child, + name=name, dim=dim) + +def remove_weight_norm(module, name='', remove_all=False): + """ + Removes the weight normalization reparameterization of a parameter from a module. + If no parameter is supplied then all weight norm parameterizations are removed. + Args: + module (nn.Module): containing module + name (str, optional): name of weight parameter + Example: + >>> m = apply_weight_norm(nn.Linear(20, 40)) + >>> remove_weight_norm(m) + """ + return remove_reparameterization(module, reparameterization=WeightNorm, + name=name, remove_all=remove_all) + +def apply_reparameterization(module, reparameterization=None, name='', dim=0, hook_child=True): + """ + Applies a given weight reparameterization (such as weight normalization) to + a parameter in the given module. If no parameter is given, applies the reparameterization + to all parameters in model (except 1-d vectors and scalars). + + Args: + module (nn.Module): containing module + reparameterization (Reparameterization): reparamaterization class to apply + name (str, optional): name of weight parameter + dim (int, optional): dimension over which to perform reparameterization op + hook_child (boolean, optional): adds reparameterization hook to direct parent of the + parameters. If False, it's added to `module` instead. Default: True + + Returns: + The original module with the reparameterization hook + + Example:: + + >>> m = apply_reparameterization(nn.Linear(20, 40), WeightNorm) + Linear (20 -> 40) + + """ + assert reparameterization is not None + if name != '': + Reparameterization.apply(module, name, dim, reparameterization, hook_child) + else: + names = list(module.state_dict().keys()) + for name in names: + apply_reparameterization(module, reparameterization, name, dim, hook_child) + return module + +def remove_reparameterization(module, reparameterization=Reparameterization, + name='', remove_all=False): + """ + Removes the given reparameterization of a parameter from a module. + If no parameter is supplied then all reparameterizations are removed. + Args: + module (nn.Module): containing module + reparameterization (Reparameterization): reparamaterization class to apply + name (str, optional): name of weight parameter + remove_all (bool, optional): if True, remove all reparamaterizations of given type. Default: False + Example: + >>> m = apply_reparameterization(nn.Linear(20, 40),WeightNorm) + >>> remove_reparameterization(m) + """ + if name != '' or remove_all: + to_remove = [] + for k, hook in module._forward_pre_hooks.items(): + if isinstance(hook, reparameterization) and (hook.name == name or remove_all): + hook.remove(module) + to_remove.append(k) + if len(to_remove) > 0: + for k in to_remove: + del module._forward_pre_hooks[k] + return module + if not remove_all: + raise ValueError("reparameterization of '{}' not found in {}" + .format(name, module)) + else: + modules = [module]+[x for x in module.modules()] + for m in modules: + remove_reparameterization(m, reparameterization=reparameterization, remove_all=True) + return module diff --git a/apex/apex/reparameterization/reparameterization.py b/apex/apex/reparameterization/reparameterization.py new file mode 100644 index 0000000000000000000000000000000000000000..5f70f857a56949a27a1b6642d89dd41e75147f17 --- /dev/null +++ b/apex/apex/reparameterization/reparameterization.py @@ -0,0 +1,151 @@ +import torch +from torch.nn.parameter import Parameter +import sys +class Reparameterization(object): + """ + Class interface for performing weight reparameterizations + Arguments: + name (str): name of weight parameter + dim (int): dimension over which to compute the norm + module (nn.Module): parent module to which param `name` is registered to + retain_forward (bool, optional): if False deletes weight on call to + module.backward. Used to avoid memory leaks with DataParallel Default: True + Attributes: + reparameterization_names (list, str): contains names of all parameters + needed to compute reparameterization. + backward_hook_key (int): torch.utils.hooks.RemovableHandle.id for hook used in module backward pass. + """ + + def __init__(self, name, dim, module, retain_forward=True): + self.name = name + self.dim = dim + self.evaluated = False + self.retain_forward = retain_forward + self.reparameterization_names = [] + self.backward_hook_key = None + self.module = module + + def compute_weight(self, module=None, name=None): + """ + Computes reparameterized weight value to assign value to module attribute + with name `name`. + See WeightNorm class for example. + Arguments: + module (nn.Module): module with weight we'd like to reparameterize + Returns: + w (Tensor): Tensor object containing value of reparameterized weight + """ + raise NotImplementedError + + def reparameterize(self, name, weight, dim): + """ + Creates Parameters to be used for reparameterization and creates names that + for attributes for the module these Parameters will correspond to. + The parameters will be registered according to the names provided. + See WeightNorm class for example. + Arguments: + module (nn.Module): module with weight we'd like to reparameterize + name (str, optional): name of weight parameter + dim (int, optional): dimension over which to compute parameterization + Returns: + names (list, str): names of Parameters to be used for reparameterization + params (list, Parameter): Parameters to be used for reparameterization + """ + raise NotImplementedError + + @staticmethod + def apply(module, name, dim, reparameterization=None, hook_child=True): + """ + Applies reparametrization to module's `name` parameter and modifies instance attributes as appropriate. + `hook_child` adds reparameterization hook to direct parent of the parameters. If False, it's added to `module` instead. + """ + if reparameterization is None: + reparameterization = Reparameterization + module2use, name2use = Reparameterization.get_module_and_name(module, name) + # does not work on sparse + if name2use is None or isinstance(module2use, (torch.nn.Embedding, torch.nn.EmbeddingBag)): + return + + if hook_child: + fn = reparameterization(name2use, dim, module2use) + else: + fn = reparameterization(name, dim, module) + + weight = getattr(module2use, name2use) + if weight.dim() <= 1: + return + + # remove weight from parameter list + del module2use._parameters[name2use] + + # add parameters of reparameterization of parameter to module + names, params = fn.reparameterize(name2use, weight, dim) + for n, p in zip(names, params): + module2use.register_parameter(n, p) + + # add parameters to reparameterization so they can be removed later + fn.reparameterization_names = names + + setattr(module2use, name2use, None) + + hook_module = module2use + if not hook_child: + hook_module = module + # recompute weight before every forward() + hook_module.register_forward_pre_hook(fn) + + # remove weight during backward + handle = hook_module.register_backward_hook(fn.backward_hook) + # get hook key so we can delete it later + fn.backward_hook_key = handle.id + + return fn + + @staticmethod + def get_module_and_name(module, name): + """ + recursively fetches (possible) child module and name of weight to be reparameterized + """ + name2use = None + module2use = None + names = name.split('.') + if len(names) == 1 and names[0] != '': + name2use = names[0] + module2use = module + elif len(names) > 1: + module2use = module + name2use = names[0] + for i in range(len(names)-1): + module2use = getattr(module2use, name2use) + name2use = names[i+1] + return module2use, name2use + + def get_params(self, module): + """gets params of reparameterization based on known attribute names""" + return [getattr(module, n) for n in self.reparameterization_names] + + def remove(self, module): + """removes reparameterization and backward hook (does not remove forward hook)""" + module2use, name2use = Reparameterization.get_module_and_name(module, self.name) + for p in self.get_params(module2use): + p.requires_grad = False + weight = self.compute_weight(module2use, name2use) + delattr(module2use, name2use) + for n in self.reparameterization_names: + del module2use._parameters[n] + module2use.register_parameter(name2use, Parameter(weight.data)) + del module._backward_hooks[self.backward_hook_key] + + def __call__(self, module, inputs): + """callable hook for forward pass""" + module2use, name2use = Reparameterization.get_module_and_name(module, self.name) + _w = getattr(module2use, name2use) + if not self.evaluated or _w is None: + setattr(module2use, name2use, self.compute_weight(module2use, name2use)) + self.evaluated = True + + def backward_hook(self, module, grad_input, grad_output): + """callable hook for backward pass""" + module2use, name2use = Reparameterization.get_module_and_name(module, self.name) + wn = getattr(module2use, name2use) + self.evaluated = False diff --git a/apex/apex/reparameterization/weight_norm.py b/apex/apex/reparameterization/weight_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..2ddb81cd794d6261c94fefa97ca57beb7c646008 --- /dev/null +++ b/apex/apex/reparameterization/weight_norm.py @@ -0,0 +1,78 @@ +import torch +from torch.nn.parameter import Parameter +from ..fp16_utils import Fused_Weight_Norm +import time + +from .reparameterization import Reparameterization + +def _norm(p, dim): + """Computes the norm over all dimensions except dim""" + if dim is None: + return p.norm() + elif dim == 0: + output_size = (p.size(0),) + (1,) * (p.dim() - 1) + return p.contiguous().view(p.size(0), -1).norm(dim=1).view(*output_size) + elif dim == p.dim() - 1: + output_size = (1,) * (p.dim() - 1) + (p.size(-1),) + return p.contiguous().view(-1, p.size(-1)).norm(dim=0).view(*output_size) + return _norm(p.transpose(0, dim), 0).transpose(0, dim) + +HALF_TYPES = (torch.cuda.HalfTensor, torch.HalfTensor) + +class WeightNorm(Reparameterization): + r""" + Weight normalization is a reparameterization that decouples the magnitude + of a weight tensor from its direction. This replaces the parameter specified + by `name` (e.g. "weight") with two parameters: one specifying the magnitude + (e.g. "weight_g") and one specifying the direction (e.g. "weight_v"). + Weight normalization is implemented via a hook that recomputes the weight + tensor from the magnitude and direction before every :meth:`~Module.forward` + call. + + .. math:: + \mathbf{w} = g \dfrac{\mathbf{v}}{\|\mathbf{v}\|} + + By default, with `dim=0`, the norm is computed independently per output + channel/plane. To compute a norm over the entire weight tensor, use + `dim=None`. + """ + def compute_weight(self, module=None, name=None): + """ + Computes weight normalized weight value to assign value to module attribute + with name `name`. + Arguments: + module (nn.Module): module with weight we'd like to reparameterize + Returns: + w (Tensor): Tensor object containing value of reparameterized weight + """ + if module is None: + module = self.module + if name is None: + name = self.name + module, name = Reparameterization.get_module_and_name(module, name) + g = getattr(module, name + '_g') + v = getattr(module, name + '_v') + + fused_weight_norm = Fused_Weight_Norm.apply + v = v.contiguous() + w = fused_weight_norm(v, g, self.dim) + + return w + + def reparameterize(self, name, weight, dim): + """ + Creates Parameters v and gto be used for weight normalization + and creates names that for attributes for the module these Parameters + will correspond to. The parameters will be registered according to the names + provided. + Arguments: + module (nn.Module): module with weight we'd like to reparameterize + name (str, optional): name of weight parameter + dim (int, optional): dimension over which to compute parameterization + Returns: + names (list, str): names of Parameters to be used for reparameterization + params (list, Parameter): Parameters to be used for reparameterization + """ + names = [name + '_g', name + '_v'] + params = [Parameter(_norm(weight, dim).data), Parameter(weight.data)] + return names, params diff --git a/apex/csrc/amp_C_frontend.cpp b/apex/csrc/amp_C_frontend.cpp new file mode 100644 index 0000000000000000000000000000000000000000..8f3270bb3387675da6b916bd91772e2910635c58 --- /dev/null +++ b/apex/csrc/amp_C_frontend.cpp @@ -0,0 +1,136 @@ +#include + +void multi_tensor_scale_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + float scale); + +void multi_tensor_sgd_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + float wd, + float momentum, + float dampening, + float lr, + bool nesterov, + bool first_run, + bool wd_after_momentum, + float scale); + +void multi_tensor_axpby_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + float a, + float b, + int arg_to_check); + +std::tuple multi_tensor_l2norm_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::optional per_tensor_python); + +void multi_tensor_lamb_stage1_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_decay, + const int step, + const float beta1, + const float beta2, + const float epsilon, + at::Tensor global_grad_norm, + const float max_global_grad_norm); + +void multi_tensor_lamb_stage2_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_param_norm, + at::Tensor per_tensor_update_norm, + const float lr, + const float weight_decay, + at::optional use_nvlamb_python); + +void multi_tensor_adam_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int mode, + const int bias_correction, + const float weight_decay); + + +void multi_tensor_adagrad_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float epsilon, + const int mode, + const float weight_decay); + + +void multi_tensor_novograd_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor grad_norms, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int bias_correction, + const float weight_decay, + const int grad_averaging, + const int mode, + const int norm_type); + +void multi_tensor_lamb_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int bias_correction, + const float weight_decay, + const int grad_averaging, + const int mode, + at::Tensor global_grad_norm, + const float max_grad_norm, + at::optional use_nvlamb_python); + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("multi_tensor_scale", &multi_tensor_scale_cuda, + "Fused overflow check + scale for a list of contiguous tensors"); + m.def("multi_tensor_sgd", &multi_tensor_sgd_cuda, + "Fused SGD optimizer for list of contiguous tensors"); + m.def("multi_tensor_axpby", &multi_tensor_axpby_cuda, + "out = a*x + b*y for a list of contiguous tensors"); + m.def("multi_tensor_l2norm", &multi_tensor_l2norm_cuda, + "Computes L2 norm for a list of contiguous tensors"); + m.def("multi_tensor_lamb_stage1_cuda", &multi_tensor_lamb_stage1_cuda, + "Computes update part of LAMB optimizer"); + m.def("multi_tensor_lamb_stage2_cuda", &multi_tensor_lamb_stage2_cuda, + "Completes application of gradient to parameters for LAMB optimizer"); + m.def("multi_tensor_adam", &multi_tensor_adam_cuda, + "Compute and apply gradient update to parameters for Adam optimizer"); + m.def("multi_tensor_adagrad", &multi_tensor_adagrad_cuda, + "Compute and apply gradient update to parameters for Adam optimizer"); + m.def("multi_tensor_novograd", &multi_tensor_novograd_cuda, + "Compute and apply gradient update to parameters for Adam optimizer"); + m.def("multi_tensor_lamb", &multi_tensor_lamb_cuda, + "Computes and apply update for LAMB optimizer"); +} diff --git a/apex/csrc/compat.h b/apex/csrc/compat.h new file mode 100644 index 0000000000000000000000000000000000000000..acafb056b2bf123c4e87f33bfd80e4bf4965ca42 --- /dev/null +++ b/apex/csrc/compat.h @@ -0,0 +1,9 @@ +#ifndef TORCH_CHECK +#define TORCH_CHECK AT_CHECK +#endif + +#ifdef VERSION_GE_1_3 +#define DATA_PTR data_ptr +#else +#define DATA_PTR data +#endif diff --git a/apex/csrc/flatten_unflatten.cpp b/apex/csrc/flatten_unflatten.cpp new file mode 100644 index 0000000000000000000000000000000000000000..d49ce759f1fa805d9335aca6577b2460d773a1e7 --- /dev/null +++ b/apex/csrc/flatten_unflatten.cpp @@ -0,0 +1,18 @@ +#include +#include +// https://github.com/pytorch/pytorch/blob/master/torch/csrc/utils/tensor_flatten.h + +at::Tensor flatten(std::vector tensors) +{ + return torch::utils::flatten_dense_tensors(tensors); +} + +std::vector unflatten(at::Tensor flat, std::vector tensors) +{ + return torch::utils::unflatten_dense_tensors(flat, tensors); +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("flatten", &flatten, "Flatten dense tensors"); + m.def("unflatten", &unflatten, "Unflatten dense tensors"); +} diff --git a/apex/csrc/layer_norm_cuda.cpp b/apex/csrc/layer_norm_cuda.cpp new file mode 100644 index 0000000000000000000000000000000000000000..7b24042b8f42a8f9db1cd41a268baa28ad6b4944 --- /dev/null +++ b/apex/csrc/layer_norm_cuda.cpp @@ -0,0 +1,241 @@ +#include +#include +#include +#include "compat.h" + +namespace { +void compute_n1_n2( + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + int& n1, + int& n2) +{ + int idiff = input.ndimension() - normalized_shape.size(); + n2 = 1; + for (int i = 0; i < (int)normalized_shape.size(); ++i) { + assert( input.sizes()[i+idiff] == normalized_shape[i] ); + n2 *= normalized_shape[i]; + } + n1 = 1; + for (int i = 0; i < idiff; ++i) { + n1 *= input.sizes()[i]; + } +} + +void check_args( + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor gamma, + at::Tensor beta + ) +{ + TORCH_CHECK(!gamma.defined() || gamma.sizes().equals(normalized_shape)); + TORCH_CHECK(!beta.defined() || beta.sizes().equals(normalized_shape)); +} + +void check_args( + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + int& n1, + int& n2 + ) +{ + int64_t normalized_ndim = normalized_shape.size(); + + if (normalized_ndim < 1) { + std::stringstream ss; + ss << "Expected normalized_shape to be at least 1-dimensional, i.e., " + << "containing at least one element, but got normalized_shape=" + << normalized_shape; + throw std::runtime_error(ss.str()); + } + + auto input_shape = input.sizes(); + auto input_ndim = input.dim(); + + if (input_ndim < normalized_ndim || + !input_shape.slice(input_ndim - normalized_ndim).equals(normalized_shape)) { + std::stringstream ss; + ss << "Given normalized_shape=" << normalized_shape + << ", expected input with shape [*"; + for (auto size : normalized_shape) { + ss << ", " << size; + } + ss << "], but got input of size" << input_shape; + throw std::runtime_error(ss.str()); + } + + compute_n1_n2(input,normalized_shape,n1,n2); +} + + +void check_args( + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor gamma, + at::Tensor beta, + int& n1, + int& n2 + ) +{ + check_args(input,normalized_shape,n1,n2); + check_args(normalized_shape,gamma,beta); +} +} + +void cuda_layer_norm( + at::Tensor* output, + at::Tensor* mean, + at::Tensor* invvar, + at::Tensor* input, + int n1, + int n2, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor* gamma, + at::Tensor* beta, + double epsilon); + +#define CHECK_CUDA(x) TORCH_CHECK(x.type().is_cuda(), #x " must be a CUDA tensor") +#define CHECK_CONTIGUOUS(x) TORCH_CHECK(x.is_contiguous(), #x " must be contiguous") +#define CHECK_INPUT(x) CHECK_CUDA(x); CHECK_CONTIGUOUS(x) + +std::vector layer_norm( + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + double epsilon) { + CHECK_INPUT(input); + int n1,n2; + check_args(input,normalized_shape,n1,n2); + at::Tensor output = at::empty_like(input); + at::Tensor mean = at::empty({n1}, input.options().dtype(input.scalar_type()==at::ScalarType::Half ? at::ScalarType::Float : input.scalar_type())); + at::Tensor invvar = at::empty_like(mean); + cuda_layer_norm(&output,&mean,&invvar,&input,n1,n2, + normalized_shape,NULL,NULL,epsilon); + return {output, mean, invvar}; +} +std::vector layer_norm_affine( + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor gamma, + at::Tensor beta, + double epsilon) { + CHECK_INPUT(input); + CHECK_INPUT(gamma); + CHECK_INPUT(beta); + int n1,n2; + check_args(input,normalized_shape,gamma,beta,n1,n2); + at::Tensor output = at::empty_like(input); + at::Tensor mean = at::empty({n1}, input.options().dtype(input.scalar_type()==at::ScalarType::Half ? at::ScalarType::Float : input.scalar_type())); + at::Tensor invvar = at::empty_like(mean); + cuda_layer_norm(&output,&mean,&invvar,&input,n1,n2, + normalized_shape,&gamma,&beta,epsilon); + return {output, mean, invvar}; +} + +void cuda_layer_norm_gradient( + at::Tensor* dout, + at::Tensor* mean, + at::Tensor* invvar, + at::Tensor* input, + int n1, + int n2, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor* gamma, + at::Tensor* beta, + double epsilon, + at::Tensor* grad_input, + at::Tensor* grad_gamma, + at::Tensor* grad_beta + ); + +at::Tensor layer_norm_gradient( + at::Tensor dout, + at::Tensor mean, + at::Tensor invvar, + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + double epsilon) { + CHECK_INPUT(dout); + CHECK_INPUT(mean); + CHECK_INPUT(invvar); + CHECK_INPUT(input); + int n1,n2; + check_args(input,normalized_shape,n1,n2); + at::Tensor grad_input = at::empty_like(input); + cuda_layer_norm_gradient(&dout,&mean,&invvar,&input,n1,n2, + normalized_shape,NULL,NULL,epsilon, + &grad_input,NULL,NULL); + return grad_input; +} +std::vector layer_norm_gradient_affine( + at::Tensor dout, + at::Tensor mean, + at::Tensor invvar, + at::Tensor input, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor gamma, + at::Tensor beta, + double epsilon) { + CHECK_INPUT(dout); + CHECK_INPUT(mean); + CHECK_INPUT(invvar); + CHECK_INPUT(input); + CHECK_INPUT(gamma); + CHECK_INPUT(beta); + int n1,n2; + check_args(input,normalized_shape,gamma,beta,n1,n2); + at::Tensor grad_input = at::empty_like(input); + at::Tensor grad_gamma = at::empty_like(gamma); + at::Tensor grad_beta = at::empty_like(beta); + cuda_layer_norm_gradient(&dout,&mean,&invvar,&input,n1,n2, + normalized_shape,&gamma,&beta,epsilon, + &grad_input,&grad_gamma,&grad_beta); + return {grad_input, grad_gamma, grad_beta}; +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward_affine", &layer_norm_affine, "LayerNorm forward (CUDA)"); + m.def("forward", &layer_norm, "LayerNorm forward (CUDA)"); + m.def("backward_affine", &layer_norm_gradient_affine, "LayerNorm backward (CUDA)"); + m.def("backward", &layer_norm_gradient, "LayerNorm backward (CUDA)"); +} + diff --git a/apex/csrc/layer_norm_cuda_kernel.cu b/apex/csrc/layer_norm_cuda_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..c68c014b44832597a7765d11163d69fc2d33fe0a --- /dev/null +++ b/apex/csrc/layer_norm_cuda_kernel.cu @@ -0,0 +1,807 @@ +#include "ATen/ATen.h" +#include "ATen/AccumulateType.h" +#include "ATen/cuda/CUDAContext.h" +#include + +#include +#include + +#include "type_shim.h" + +template __device__ +void cuWelfordOnlineSum( + const U curr, + U& mu, + U& sigma2, + U& count) +{ + count = count + U(1); + U delta = curr - mu; + U lmean = mu + delta / count; + mu = lmean; + U delta2 = curr - lmean; + sigma2 = sigma2 + delta * delta2; +} + +template __device__ +void cuChanOnlineSum( + const U muB, + const U sigma2B, + const U countB, + U& mu, + U& sigma2, + U& count) +{ + U delta = muB - mu; + U nA = count; + U nB = countB; + count = count + countB; + U nX = count; + if (nX > U(0)) { + nA = nA / nX; + nB = nB / nX; + mu = nA*mu + nB*muB; + sigma2 = sigma2 + sigma2B + delta * delta * nA * nB * nX; + } else { + mu = U(0); + sigma2 = U(0); + } +} + +template __device__ +void cuWelfordMuSigma2( + const T* __restrict__ vals, + const int n1, + const int n2, + const int i1, + U& mu, + U& sigma2, + U* buf) +{ + // Assumptions: + // 1) blockDim.x == warpSize + // 2) Tensor is contiguous + // 3) 2*blockDim.y*sizeof(U)+blockDim.y*sizeof(int) shared memory available. + // + // compute variance and mean over n2 + U count = U(0); + mu= U(0); + sigma2 = U(0); + if (i1 < n1) { + // one warp normalizes one n1 index, + // synchronization is implicit + // initialize with standard Welford algorithm + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + const T* lvals = vals + i1*n2; + int l = 4*thrx; + for (; l+3 < n2; l+=4*numx) { + for (int k = 0; k < 4; ++k) { + U curr = static_cast(lvals[l+k]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + } + for (; l < n2; ++l) { + U curr = static_cast(lvals[l]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + // intra-warp reductions + for (int l = 0; l <= 4; ++l) { + int srcLaneB = (threadIdx.x+(1<(muB,sigma2B,countB,mu,sigma2,count); + } + // threadIdx.x == 0 has correct values for each warp + // inter-warp reductions + if (blockDim.y > 1) { + U* ubuf = (U*)buf; + U* ibuf = (U*)(ubuf + blockDim.y); + for (int offset = blockDim.y/2; offset > 0; offset /= 2) { + // upper half of warps write to shared + if (threadIdx.x == 0 && threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int wrt_y = threadIdx.y - offset; + ubuf[2*wrt_y] = mu; + ubuf[2*wrt_y+1] = sigma2; + ibuf[wrt_y] = count; + } + __syncthreads(); + // lower half merges + if (threadIdx.x == 0 && threadIdx.y < offset) { + U muB = ubuf[2*threadIdx.y]; + U sigma2B = ubuf[2*threadIdx.y+1]; + U countB = ibuf[threadIdx.y]; + cuChanOnlineSum(muB,sigma2B,countB,mu,sigma2,count); + } + __syncthreads(); + } + // threadIdx.x = 0 && threadIdx.y == 0 only thread that has correct values + if (threadIdx.x == 0 && threadIdx.y == 0) { + ubuf[0] = mu; + ubuf[1] = sigma2; + } + __syncthreads(); + mu = ubuf[0]; + sigma2 = ubuf[1]/U(n2); + // don't care about final value of count, we know count == n2 + } else { + mu = WARP_SHFL(mu, 0); + sigma2 = WARP_SHFL(sigma2/U(n2), 0); + } + } +} + +template<> __device__ +void cuWelfordMuSigma2( + const at::Half* __restrict__ vals, + const int n1, + const int n2, + const int i1, + float& mu, + float& sigma2, + float* buf) +{ + // Assumptions: + // 1) blockDim.x == warpSize + // 2) Tensor is contiguous + // 3) 2*blockDim.y*sizeof(U)+blockDim.y*sizeof(int) shared memory available. + // + // compute variance and mean over n2 + float count = 0.0f; + mu= float(0); + sigma2 = float(0); + if (i1 < n1) { + // one warp normalizes one n1 index, + // synchronization is implicit + // initialize with standard Welford algorithm + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + const at::Half* lvals = vals + i1*n2; + int l = 8*thrx; + if ((((size_t)lvals)&3) != 0) { + // 16 bit alignment + // first thread consumes first point + if (thrx == 0) { + float curr = static_cast(lvals[0]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + ++l; + } + // at this point, lvals[l] are 32 bit aligned for all threads. + for (; l+7 < n2; l+=8*numx) { + for (int k = 0; k < 8; k+=2) { + float2 curr = __half22float2(*((__half2*)(lvals+l+k))); + cuWelfordOnlineSum(curr.x,mu,sigma2,count); + cuWelfordOnlineSum(curr.y,mu,sigma2,count); + } + } + for (; l < n2; ++l) { + float curr = static_cast(lvals[l]); + cuWelfordOnlineSum(curr,mu,sigma2,count); + } + // intra-warp reductions + for (int l = 0; l <= 4; ++l) { + int srcLaneB = (threadIdx.x+(1< 1) { + float* ubuf = (float*)buf; + float* ibuf = (float*)(ubuf + blockDim.y); + for (int offset = blockDim.y/2; offset > 0; offset /= 2) { + // upper half of warps write to shared + if (threadIdx.x == 0 && threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int wrt_y = threadIdx.y - offset; + ubuf[2*wrt_y] = mu; + ubuf[2*wrt_y+1] = sigma2; + ibuf[wrt_y] = count; + } + __syncthreads(); + // lower half merges + if (threadIdx.x == 0 && threadIdx.y < offset) { + float muB = ubuf[2*threadIdx.y]; + float sigma2B = ubuf[2*threadIdx.y+1]; + float countB = ibuf[threadIdx.y]; + cuChanOnlineSum(muB,sigma2B,countB,mu,sigma2,count); + } + __syncthreads(); + } + // threadIdx.x = 0 && threadIdx.y == 0 only thread that has correct values + if (threadIdx.x == 0 && threadIdx.y == 0) { + ubuf[0] = mu; + ubuf[1] = sigma2; + } + __syncthreads(); + mu = ubuf[0]; + sigma2 = ubuf[1]/float(n2); + // don't care about final value of count, we know count == n2 + } else { + mu = WARP_SHFL(mu, 0); + sigma2 = WARP_SHFL(sigma2/float(n2), 0); + } + } +} + +template U rsqrt(U v) { + return U(1) / sqrt(v); +} +template<> float rsqrt(float v) { + return rsqrtf(v); +} +template<> double rsqrt(double v) { + return rsqrt(v); +} + +namespace { +// This is the un-specialized struct. Note that we prevent instantiation of this +// struct by putting an undefined symbol in the function body so it won't compile. +// template +// struct SharedMemory +// { +// // Ensure that we won't compile any un-specialized types +// __device__ T *getPointer() +// { +// extern __device__ void error(void); +// error(); +// return NULL; +// } +// }; +// https://github.com/NVIDIA/apex/issues/246 +template +struct SharedMemory; + +template <> +struct SharedMemory +{ + __device__ float *getPointer() + { + extern __shared__ float s_float[]; + return s_float; + } +}; + +template <> +struct SharedMemory +{ + __device__ double *getPointer() + { + extern __shared__ double s_double[]; + return s_double; + } +}; +} + +template __global__ +void cuApplyLayerNorm( + T* __restrict__ output_vals, + U* __restrict__ mean, + U* __restrict__ invvar, + const T* __restrict__ vals, + const int n1, + const int n2, + const U epsilon, + const T* __restrict__ gamma, + const T* __restrict__ beta + ) +{ + // Assumptions: + // 1) blockDim.x == warpSize + // 2) Tensors are contiguous + // + for (auto i1=blockIdx.y; i1 < n1; i1 += gridDim.y) { + SharedMemory shared; + U* buf = shared.getPointer(); + U mu,sigma2; + cuWelfordMuSigma2(vals,n1,n2,i1,mu,sigma2,buf); + const T* lvals = vals + i1*n2; + T* ovals = output_vals + i1*n2; + U c_invvar = rsqrt(sigma2 + epsilon); + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + if (gamma != NULL && beta != NULL) { + for (int i = thrx; i < n2; i+=numx) { + U curr = static_cast(lvals[i]); + ovals[i] = gamma[i] * static_cast(c_invvar * (curr - mu)) + beta[i]; + } + } else { + for (int i = thrx; i < n2; i+=numx) { + U curr = static_cast(lvals[i]); + ovals[i] = static_cast(c_invvar * (curr - mu)); + } + } + if (threadIdx.x == 0 && threadIdx.y == 0) { + mean[i1] = mu; + invvar[i1] = c_invvar; + } + } +} + +template __device__ +void cuLoadWriteStridedInputs( + const int i1_block, + const int thr_load_row_off, + const int thr_load_col_off, + const int i2_off, + const int row_stride, + U* warp_buf1, + U* warp_buf2, + const T* input, + const T* dout, + const int i1_end, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar + ) +{ + int i1 = i1_block+thr_load_row_off; + if (i1 < i1_end) { + U curr_mean = mean[i1]; + U curr_invvar = invvar[i1]; + for (int k = 0; k < blockDim.y; ++k) { + int i2 = i2_off + k; + int load_idx = i1*n2+i2; + int write_idx = thr_load_row_off*row_stride+thr_load_col_off+k; + if (i2(input[load_idx]); + U curr_dout = static_cast(dout[load_idx]); + warp_buf1[write_idx] = curr_dout; + warp_buf2[write_idx] = curr_dout * (curr_input - curr_mean) * curr_invvar; + } else { + warp_buf1[write_idx] = U(0); + warp_buf2[write_idx] = U(0); + } + } + } else { + for (int k = 0; k < blockDim.y; ++k) { + int write_idx = thr_load_row_off*row_stride+thr_load_col_off+k; + warp_buf1[write_idx] = U(0); + warp_buf2[write_idx] = U(0); + } + } +} + +template __device__ +void cuLoadAddStridedInputs( + const int i1_block, + const int thr_load_row_off, + const int thr_load_col_off, + const int i2_off, + const int row_stride, + U* warp_buf1, + U* warp_buf2, + const T* input, + const T* dout, + const int i1_end, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar + ) +{ + int i1 = i1_block+thr_load_row_off; + if (i1 < i1_end) { + U curr_mean = mean[i1]; + U curr_invvar = invvar[i1]; + for (int k = 0; k < blockDim.y; ++k) { + int i2 = i2_off + k; + int load_idx = i1*n2+i2; + int write_idx = thr_load_row_off*row_stride+thr_load_col_off+k; + if (i2(input[load_idx]); + U curr_dout = static_cast(dout[load_idx]); + warp_buf1[write_idx] += curr_dout; + warp_buf2[write_idx] += curr_dout * (curr_input - curr_mean) * curr_invvar; + } + } + } +} + +template __global__ +void cuComputePartGradGammaBeta( + const T* __restrict__ dout, + const T* __restrict__ input, + const int n1, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar, + U epsilon, + U* part_grad_gamma, + U* part_grad_beta) +{ + const int numsegs_n1 = (n1+blockDim.y*blockDim.y-1) / (blockDim.y*blockDim.y); + const int segs_per_block = (numsegs_n1 + gridDim.y - 1) / gridDim.y; + const int i1_beg = blockIdx.y * segs_per_block * blockDim.y*blockDim.y; + const int i1_beg_plus_one = (blockIdx.y+1) * segs_per_block * blockDim.y*blockDim.y; + const int i1_end = i1_beg_plus_one < n1 ? i1_beg_plus_one : n1; + const int row_stride = blockDim.x+1; + const int thr_load_col_off = (threadIdx.x*blockDim.y)&(blockDim.x-1); + const int thr_load_row_off = (threadIdx.x*blockDim.y)/blockDim.x + threadIdx.y*blockDim.y; + const int i2_off = blockIdx.x * blockDim.x + thr_load_col_off; + SharedMemory shared; + U* buf = shared.getPointer(); // buf has at least blockDim.x * blockDim.y * blockDim.y + (blockDim.y - 1)*(blockDim.x/blockDim.y) elements + U* warp_buf1 = (U*)buf; + U* warp_buf2 = warp_buf1 + blockDim.y * blockDim.y * row_stride; + // compute partial sums from strided inputs + // do this to increase number of loads in flight + cuLoadWriteStridedInputs(i1_beg,thr_load_row_off,thr_load_col_off,i2_off,row_stride,warp_buf1,warp_buf2,input,dout,i1_end,n2,mean,invvar); + for (int i1_block = i1_beg+blockDim.y*blockDim.y; i1_block < i1_end; i1_block+=blockDim.y*blockDim.y) { + cuLoadAddStridedInputs(i1_block,thr_load_row_off,thr_load_col_off,i2_off,row_stride,warp_buf1,warp_buf2,input,dout,i1_end,n2,mean,invvar); + } + __syncthreads(); + // inter-warp reductions + // sum within each warp + U acc1 = U(0); + U acc2 = U(0); + for (int k = 0; k < blockDim.y; ++k) { + int row1 = threadIdx.y + k*blockDim.y; + int idx1 = row1*row_stride + threadIdx.x; + acc1 += warp_buf1[idx1]; + acc2 += warp_buf2[idx1]; + } + warp_buf1[threadIdx.y*row_stride+threadIdx.x] = acc1; + warp_buf2[threadIdx.y*row_stride+threadIdx.x] = acc2; + __syncthreads(); + // sum all warps + for (int offset = blockDim.y/2; offset > 1; offset /= 2) { + if (threadIdx.y < offset) { + int row1 = threadIdx.y; + int row2 = threadIdx.y + offset; + int idx1 = row1*row_stride + threadIdx.x; + int idx2 = row2*row_stride + threadIdx.x; + warp_buf1[idx1] += warp_buf1[idx2]; + warp_buf2[idx1] += warp_buf2[idx2]; + } + __syncthreads(); + } + int i2 = blockIdx.x * blockDim.x + threadIdx.x; + if (threadIdx.y == 0 && i2 < n2) { + int row1 = threadIdx.y; + int row2 = threadIdx.y + 1; + int idx1 = row1*row_stride + threadIdx.x; + int idx2 = row2*row_stride + threadIdx.x; + part_grad_beta[blockIdx.y*n2+i2] = warp_buf1[idx1] + warp_buf1[idx2]; + part_grad_gamma[blockIdx.y*n2+i2] = warp_buf2[idx1] + warp_buf2[idx2]; + } +} + +template __global__ +void cuComputeGradGammaBeta( + const U* part_grad_gamma, + const U* part_grad_beta, + const int part_size, + const int n1, + const int n2, + T* grad_gamma, + T* grad_beta) +{ + // sum partial gradients for gamma and beta + SharedMemory shared; + U* buf = shared.getPointer(); + int i2 = blockIdx.x * blockDim.x + threadIdx.x; + if (i2 < n2) { + // each warp does sequential reductions until reduced part_size is num_warps + int num_warp_reductions = part_size / blockDim.y; + U sum_gamma = U(0); + U sum_beta = U(0); + const U* part_grad_gamma_ptr = part_grad_gamma + threadIdx.y * num_warp_reductions * n2 + i2; + const U* part_grad_beta_ptr = part_grad_beta + threadIdx.y * num_warp_reductions * n2 + i2; + for (int warp_offset = 0; warp_offset < num_warp_reductions; ++warp_offset) { + sum_gamma += part_grad_gamma_ptr[warp_offset*n2]; + sum_beta += part_grad_beta_ptr[warp_offset*n2]; + } + // inter-warp reductions + const int nbsize3 = blockDim.x * blockDim.y / 2; + for (int offset = blockDim.y/2; offset >= 1; offset /= 2) { + // top half write to shared memory + if (threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int write_idx = (threadIdx.y - offset) * blockDim.x + threadIdx.x; + buf[write_idx] = sum_gamma; + buf[write_idx+nbsize3] = sum_beta; + } + __syncthreads(); + // bottom half sums + if (threadIdx.y < offset) { + const int read_idx = threadIdx.y * blockDim.x + threadIdx.x; + sum_gamma += buf[read_idx]; + sum_beta += buf[read_idx+nbsize3]; + } + __syncthreads(); + } + // write out fully summed gradients + if (threadIdx.y == 0) { + grad_gamma[i2] = sum_gamma; + grad_beta[i2] = sum_beta; + } + } +} + +template __global__ +void cuComputeGradInput( + const T* __restrict__ dout, + const T* __restrict__ input, + const int n1, + const int n2, + const U* __restrict__ mean, + const U* __restrict__ invvar, + U epsilon, + const T* gamma, + T* grad_input) +{ + for (auto i1=blockIdx.y; i1 < n1; i1 += gridDim.y) { + U sum_loss1 = U(0); + U sum_loss2 = U(0); + const U c_mean = mean[i1]; + const U c_invvar = invvar[i1]; + const T* k_input = input + i1*n2; + const T* k_dout = dout + i1*n2; + const int numx = blockDim.x * blockDim.y; + const int thrx = threadIdx.x + threadIdx.y * blockDim.x; + if (gamma != NULL) { + int l = 4*thrx; + for (; l+3 < n2; l+=4*numx) { + for (int k = 0; k < 4; ++k) { + const U c_h = static_cast(k_input[l+k]); + const U c_loss = static_cast(k_dout[l+k]); + sum_loss1 += c_loss * gamma[l+k]; + sum_loss2 += c_loss * gamma[l+k] * (c_h - c_mean) * c_invvar; + } + } + for (; l < n2; ++l) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + sum_loss1 += c_loss * gamma[l]; + sum_loss2 += c_loss * gamma[l] * (c_h - c_mean) * c_invvar; + } + } else { + int l = 4*thrx; + for (; l+3 < n2; l+=4*numx) { + for (int k = 0; k < 4; ++k) { + const U c_h = static_cast(k_input[l+k]); + const U c_loss = static_cast(k_dout[l+k]); + sum_loss1 += c_loss; + sum_loss2 += c_loss * (c_h - c_mean) * c_invvar; + } + } + for (; l < n2; ++l) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + sum_loss1 += c_loss; + sum_loss2 += c_loss * (c_h - c_mean) * c_invvar; + } + } + // intra-warp reductions + for (int mask = blockDim.x/2; mask > 0; mask /= 2) { + sum_loss1 += WARP_SHFL_XOR(sum_loss1, mask); + sum_loss2 += WARP_SHFL_XOR(sum_loss2, mask); + } + // inter-warp reductions + if (blockDim.y > 1) { + SharedMemory shared; + U* buf = shared.getPointer(); + for (int offset = blockDim.y/2; offset > 0; offset /= 2) { + // upper half of warps write to shared + if (threadIdx.y >= offset && threadIdx.y < 2*offset) { + const int wrt_i = (threadIdx.y - offset) * blockDim.x + threadIdx.x; + buf[2*wrt_i] = sum_loss1; + buf[2*wrt_i+1] = sum_loss2; + } + __syncthreads(); + // lower half merges + if (threadIdx.y < offset) { + const int read_i = threadIdx.y * blockDim.x + threadIdx.x; + sum_loss1 += buf[2*read_i]; + sum_loss2 += buf[2*read_i+1]; + } + __syncthreads(); + } + if (threadIdx.y == 0) { + buf[2*threadIdx.x] = sum_loss1; + buf[2*threadIdx.x+1] = sum_loss2; + } + __syncthreads(); + if (threadIdx.y !=0) { + sum_loss1 = buf[2*threadIdx.x]; + sum_loss2 = buf[2*threadIdx.x+1]; + } + } + // all threads now have the two sums over l + U fH = (U)n2; + U term1 = (U(1) / fH) * c_invvar; + T* k_grad_input = grad_input + i1*n2; + if (gamma != NULL) { + for (int l = thrx; l < n2; l+=numx) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + U f_grad_input = fH * c_loss * gamma[l]; + f_grad_input -= sum_loss1; + f_grad_input -= (c_h - c_mean) * c_invvar * sum_loss2; + f_grad_input *= term1; + k_grad_input[l] = static_cast(f_grad_input); + } + } else { + for (int l = thrx; l < n2; l+=numx) { + const U c_h = static_cast(k_input[l]); + const U c_loss = static_cast(k_dout[l]); + U f_grad_input = fH * c_loss; + f_grad_input -= sum_loss1; + f_grad_input -= (c_h - c_mean) * c_invvar * sum_loss2; + f_grad_input *= term1; + k_grad_input[l] = static_cast(f_grad_input); + } + } + } +} + +template +void HostApplyLayerNorm( + T* output, + U* mean, + U* invvar, + const T* input, + int n1, + int n2, + double epsilon, + const T* gamma, + const T* beta + ) +{ + auto stream = at::cuda::getCurrentCUDAStream().stream(); + const dim3 threads(32,4,1); + const uint64_t maxGridY = at::cuda::getCurrentDeviceProperties()->maxGridSize[1]; + const dim3 blocks(1, std::min((uint64_t)n1, maxGridY), 1); + int nshared = + threads.y > 1 ? + threads.y*sizeof(U)+(threads.y/2)*sizeof(U) : + 0; + cuApplyLayerNorm<<>>( + output, + mean, + invvar, + input, + n1,n2, + U(epsilon), + gamma,beta); +} + +void cuda_layer_norm( + at::Tensor* output, + at::Tensor* mean, + at::Tensor* invvar, + at::Tensor* input, + int n1, + int n2, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor* gamma, + at::Tensor* beta, + double epsilon) +{ + using namespace at; + DISPATCH_DOUBLE_FLOAT_AND_HALF(input->scalar_type(), 0, "layer_norm_cuda_kernel", + using accscalar_t = at::acc_type; + HostApplyLayerNorm( + output->DATA_PTR(), + mean->DATA_PTR(), + invvar->DATA_PTR(), + input->DATA_PTR(), + n1,n2, + epsilon, + gamma != NULL ? gamma->DATA_PTR() : NULL, + beta != NULL ? beta->DATA_PTR() : NULL); + ) +} + +template +void HostLayerNormGradient( + const T* dout, + const U* mean, + const U* invvar, + at::Tensor* input, + int n1, + int n2, + const T* gamma, + const T* beta, + double epsilon, + T* grad_input, + T* grad_gamma, + T* grad_beta + ) +{ + auto stream = at::cuda::getCurrentCUDAStream().stream(); + + if (gamma != NULL && beta != NULL) { + // compute grad_gamma(j) and grad_beta(j) + const int part_size = 16; + const dim3 threads2(32,4,1); + const dim3 blocks2((n2+threads2.x-1)/threads2.x,part_size,1); + const int nshared2_a = 2 * sizeof(U) * threads2.y * threads2.y * (threads2.x + 1); + const int nshared2_b = threads2.x * threads2.y * sizeof(U); + const int nshared2 = nshared2_a > nshared2_b ? nshared2_a : nshared2_b; + at::Tensor part_grad_gamma = at::empty({part_size,n2}, input->options().dtype(input->scalar_type()==at::ScalarType::Half ? at::ScalarType::Float : input->scalar_type())); + at::Tensor part_grad_beta = at::empty_like(part_grad_gamma); + cuComputePartGradGammaBeta<<>>( + dout, + input->DATA_PTR(), + n1,n2, + mean, + invvar, + U(epsilon), + part_grad_gamma.DATA_PTR(), + part_grad_beta.DATA_PTR()); + + const dim3 threads3(32,8,1); + const dim3 blocks3((n2+threads2.x-1)/threads2.x,1,1); + const int nshared3 = threads3.x * threads3.y * sizeof(U); + cuComputeGradGammaBeta<<>>( + part_grad_gamma.DATA_PTR(), + part_grad_beta.DATA_PTR(), + part_size, + n1,n2, + grad_gamma, + grad_beta); + } + + // compute grad_input + const uint64_t maxGridY = at::cuda::getCurrentDeviceProperties()->maxGridSize[1]; + const dim3 blocks1(1, std::min((uint64_t)n1, maxGridY), 1); + const dim3 threads1(32,4,1); + int nshared = + threads1.y > 1 ? + threads1.y*threads1.x*sizeof(U) : + 0; + cuComputeGradInput<<>>( + dout, + input->DATA_PTR(), + n1,n2, + mean, + invvar, + U(epsilon), + gamma, + grad_input); +} + +void cuda_layer_norm_gradient( + at::Tensor* dout, + at::Tensor* mean, + at::Tensor* invvar, + at::Tensor* input, + int n1, + int n2, + #ifdef VERSION_GE_1_1 + at::IntArrayRef normalized_shape, + #else + at::IntList normalized_shape, + #endif + at::Tensor* gamma, + at::Tensor* beta, + double epsilon, + at::Tensor* grad_input, + at::Tensor* grad_gamma, + at::Tensor* grad_beta) +{ + using namespace at; + DISPATCH_FLOAT_AND_HALF(input->scalar_type(), 0, "cuComputeGradInput", + using accscalar_t = at::acc_type; + HostLayerNormGradient( + dout->DATA_PTR(), + mean->DATA_PTR(), + invvar->DATA_PTR(), + input, + n1,n2, + // TMJ pass NULL argument for gamma, beta, grad_gamma and grad_beta + // if gamma Tensor is NULL on input. + gamma != NULL ? gamma->DATA_PTR() : NULL, + gamma != NULL ? beta->DATA_PTR() : NULL, + epsilon, + grad_input->DATA_PTR(), + gamma != NULL ? grad_gamma->DATA_PTR() : NULL, + gamma != NULL ? grad_beta->DATA_PTR() : NULL); + ) +} diff --git a/apex/csrc/mlp.cpp b/apex/csrc/mlp.cpp new file mode 100644 index 0000000000000000000000000000000000000000..68cf174c2297f27dc6764daa08d5a6d97e637234 --- /dev/null +++ b/apex/csrc/mlp.cpp @@ -0,0 +1,166 @@ +#include +#include +#include + +#include + +size_t get_mlp_reserved_space(int64_t batch_size, int num_layers, const int* output_features); + +template +size_t get_mlp_bp_workspace_in_bytes(int batch_size, int num_layers, const int* output_features); + +template +int mlp_fp( + T* X, + int input_features, + int batch_size, + T** WPtr, + int num_layers, + int* output_features, + T** BPtr, + T* Y, + T* reserved_space, + int use_bias, + int activation, + void* lt_workspace); + +template +int mlp_bp( + T* X, + T* Y, + int input_features, + int batch_size, + T** WPtr, + int num_layers, + int* output_features, + T* dY, + T* reserved_space, + T* work_space, + T* dX, + T** dwPtr, + T** dbPtr, + bool requires_grad, + int use_bias, + int activation); + +std::vector mlp_forward(int use_bias, int activation, std::vector inputs) { + + auto num_layers = inputs.size() - 1; + if (use_bias) { + // inputs contains (input, weights, biases) + num_layers /= 2; + } + auto batch_size = inputs[0].size(0); + auto input_features = inputs[0].size(1); + + std::vector output_features; + for (int i = 0; i < num_layers; i++) { + output_features.push_back(inputs[i + 1].size(0)); + } + + auto reserved_size = get_mlp_reserved_space(batch_size, num_layers, output_features.data()); + + // create output/workspace tensor + auto out = at::empty({batch_size, output_features.back()}, inputs[0].type()); + auto reserved_space = at::empty({reserved_size}, inputs[0].type()); + // allocate fixed 4MB workspace for cublaslt for now, and this gets at least 4 MB + auto lt_workspace = at::empty({1 << 22}, inputs[0].type()); + + AT_DISPATCH_FLOATING_TYPES_AND_HALF(inputs[0].type(), "mlp_forward", [&] { + std::vector w_ptr; + std::vector b_ptr; + for (int i = 0; i < num_layers; i++) { + w_ptr.push_back(inputs[i + 1].data_ptr()); + if (use_bias) { + b_ptr.push_back(inputs[i + 1 + num_layers].data_ptr()); + } + } + auto result = mlp_fp( + inputs[0].data_ptr(), + input_features, + batch_size, + w_ptr.data(), + num_layers, + output_features.data(), + b_ptr.data(), + out.data_ptr(), + reserved_space.data_ptr(), + use_bias, + activation, + (void*) (lt_workspace.data_ptr())); + }); + + return {out, reserved_space}; +} + +std::vector mlp_backward( + int use_bias, + int activation, + at::Tensor grad_o, + std::vector fprop_outputs, + std::vector inputs) { + + auto num_layers = inputs.size() - 1; + if (use_bias) { + // inputs contains (input, weights, biases) + num_layers /= 2; + } + + auto batch_size = inputs[0].size(0); + auto input_features = inputs[0].size(1); + + bool requires_grad = inputs[0].requires_grad(); + + std::vector output_features; + for (int i = 0; i < num_layers; i++) { + output_features.push_back(inputs[i + 1].size(0)); + } + // create outputs, length of inputs + std::vector outputs; + for (int i = 0; i < inputs.size(); i++) { + outputs.push_back(at::empty(inputs[i].sizes(), inputs[i].type())); // clone for testing now + } + + AT_DISPATCH_FLOATING_TYPES_AND_HALF(inputs[0].type(), "mlp_backward", [&] { + std::vector w_ptr; + for (int i = 0; i < num_layers; i++) { + w_ptr.push_back(inputs[i + 1].data_ptr()); + } + std::vector outputs_ptr; + for (int i = 0; i < inputs.size(); i++) { + outputs_ptr.push_back(outputs[i].data_ptr()); + } + + auto work_size = + get_mlp_bp_workspace_in_bytes(batch_size, num_layers, output_features.data()); + + // auto work_space = at::empty({work_size*4}, at::kByte); + auto work_space = at::empty({work_size / sizeof(scalar_t)}, inputs[0].type()); + + auto result = mlp_bp( + inputs[0].data_ptr(), + fprop_outputs[0].data_ptr(), + input_features, + batch_size, + w_ptr.data(), + num_layers, + output_features.data(), + grad_o.contiguous().data_ptr(), + fprop_outputs[1].data_ptr(), + work_space.data_ptr(), + outputs_ptr[0], + outputs_ptr.data() + 1, + outputs_ptr.data() + 1 + num_layers, + requires_grad, + use_bias, + activation); + }); + + return outputs; +} + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("forward", &mlp_forward, "MLP forward"); + m.def("backward", &mlp_backward, "MLP backward"); +} + diff --git a/apex/csrc/mlp_cuda.cu b/apex/csrc/mlp_cuda.cu new file mode 100644 index 0000000000000000000000000000000000000000..848934c071d07dab00a11c94fab2ed50300dfe34 --- /dev/null +++ b/apex/csrc/mlp_cuda.cu @@ -0,0 +1,1675 @@ +#include +#include +#include +#include +#include +#include +#include + +/* Includes, cuda */ +#include +#include + +// includes cublaslt +#include + +// constants for fused bias+relu kernel +#define BIAS_RELU_FW_NTHREADS 128 // forward number of thread per block +#define BIAS_RELU_BW_NTHREADS_X 32 // backward number of thread in feature dim +#define BIAS_RELU_BW_NTHREADS_Y 16 // backward number of thread in batch dim +#define BIAS_RELU_RED_PER_THREAD 16 // backward minimal reduction length per thread + +// move to a header later on +#define ILP 4 +template +__host__ __device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} +template +__device__ __forceinline__ void load_store(T* dst, volatile T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} +template +__device__ __forceinline__ void load_store(volatile T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +// Keep ReLU in float only. When using half, cast to float before calling. +__device__ __inline__ float relu(float a) { + float retf = max(a, 0.f); + return (retf); +} + +// Keep Sigmoid in float only. When using half, cast to float before calling. +__device__ __inline__ float sigmoid(float a) { + float retf = 1.f / (1.f + expf(-a)); + return (retf); +} + +// FP64 Wrapper around cublas GEMMEx +cublasStatus_t mlp_gemm( + cublasHandle_t handle, + cublasOperation_t transa, + cublasOperation_t transb, + int m, + int n, + int k, + float* alpha, + const double* A, + int lda, + const double* B, + int ldb, + const float* beta, + double* C, + int ldc) { + return cublasGemmEx( + handle, + transa, + transb, + m, + n, + k, + alpha, + A, + CUDA_R_64F, + lda, + B, + CUDA_R_64F, + ldb, + beta, + C, + CUDA_R_64F, + ldc, + CUDA_R_64F, + CUBLAS_GEMM_DEFAULT); +} + +// FP32 Wrapper around cublas GEMMEx +cublasStatus_t mlp_gemm( + cublasHandle_t handle, + cublasOperation_t transa, + cublasOperation_t transb, + int m, + int n, + int k, + float* alpha, + const float* A, + int lda, + const float* B, + int ldb, + const float* beta, + float* C, + int ldc) { + return cublasGemmEx( + handle, + transa, + transb, + m, + n, + k, + alpha, + A, + CUDA_R_32F, + lda, + B, + CUDA_R_32F, + ldb, + beta, + C, + CUDA_R_32F, + ldc, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT); +} + +// FP16 Tensor core wrapper around cublas GEMMEx +cublasStatus_t mlp_gemm( + cublasHandle_t handle, + cublasOperation_t transa, + cublasOperation_t transb, + int m, + int n, + int k, + float* alpha, + const at::Half* A, + int lda, + const at::Half* B, + int ldb, + float* beta, + at::Half* C, + int ldc) { + return cublasGemmEx( + handle, + transa, + transb, + m, + n, + k, + alpha, + A, + CUDA_R_16F, + lda, + B, + CUDA_R_16F, + ldb, + beta, + C, + CUDA_R_16F, + ldc, + CUDA_R_32F, + CUBLAS_GEMM_DEFAULT_TENSOR_OP); +} + +int mlp_gemm_lt( + cublasLtHandle_t ltHandle, + cublasOperation_t transa, + cublasOperation_t transb, + int m, + int n, + int k, + float *alpha, /* host pointer */ + const at::Half* A, + int lda, + const at::Half* B, + int ldb, + float *beta, /* host pointer */ + at::Half* C, + int ldc, + void *workspace, + size_t workspaceSize, + cudaStream_t stream, + bool use_bias, + bool use_relu, + const void* bias) { + cublasStatus_t status = CUBLAS_STATUS_SUCCESS; + + cublasLtMatmulDescOpaque_t operationDesc = {}; + cublasLtMatrixLayoutOpaque_t Adesc = {}, Bdesc = {}, Cdesc = {}; + cublasLtMatmulPreferenceOpaque_t preference = {}; + + int returnedResults = 0; + cublasLtMatmulHeuristicResult_t heuristicResult = {}; + cublasLtEpilogue_t epilogue = CUBLASLT_EPILOGUE_DEFAULT; + + // Create operation descriptor; see cublasLtMatmulDescAttributes_t + // for details about defaults; here we just set the transforms for + // A and B. + status = cublasLtMatmulDescInit(&operationDesc, CUBLAS_COMPUTE_32F, CUDA_R_32F); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_TRANSA, &transa, sizeof(transa)); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_TRANSB, &transb, sizeof(transa)); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + if (use_bias) { + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_BIAS_POINTER, &bias, sizeof(bias)); + if (status != CUBLAS_STATUS_SUCCESS) { + goto CLEANUP; + } + if (use_relu) { + epilogue = CUBLASLT_EPILOGUE_RELU_BIAS; + } else { + epilogue = CUBLASLT_EPILOGUE_BIAS; + } + } else { + if (use_relu) { + epilogue = CUBLASLT_EPILOGUE_RELU; + } + } + + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_EPILOGUE, &epilogue, sizeof(epilogue)); + if (status != CUBLAS_STATUS_SUCCESS) { + goto CLEANUP; + } + + // Create matrix descriptors. Not setting any extra attributes. + status = cublasLtMatrixLayoutInit( + &Adesc, CUDA_R_16F, transa == CUBLAS_OP_N ? m : k, transa == CUBLAS_OP_N ? k : m, lda); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatrixLayoutInit( + &Bdesc, CUDA_R_16F, transb == CUBLAS_OP_N ? k : n, transb == CUBLAS_OP_N ? n : k, ldb); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatrixLayoutInit(&Cdesc, CUDA_R_16F, m, n, ldc); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + // Create preference handle; In general, extra attributes can be + // used here to disable tensor ops or to make sure algo selected + // will work with badly aligned A, B, C. However, for simplicity + // here we assume A,B,C are always well aligned (e.g., directly + // come from cudaMalloc) + status = cublasLtMatmulPreferenceInit(&preference); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatmulPreferenceSetAttribute( + &preference, CUBLASLT_MATMUL_PREF_MAX_WORKSPACE_BYTES, &workspaceSize, sizeof(workspaceSize)); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + // We just need the best available heuristic to try and run matmul. + // There is no guarantee that this will work. For example, if A is + // badly aligned, you can request more (e.g. 32) algos and try to + // run them one by one until something works. + status = cublasLtMatmulAlgoGetHeuristic( + ltHandle, &operationDesc, &Adesc, &Bdesc, &Cdesc, &Cdesc, &preference, 1, &heuristicResult, &returnedResults); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + if (returnedResults == 0) { + status = CUBLAS_STATUS_NOT_SUPPORTED; + goto CLEANUP; + } + status = cublasLtMatmul(ltHandle, + &operationDesc, + alpha, + A, + &Adesc, + B, + &Bdesc, + beta, + C, + &Cdesc, + C, + &Cdesc, + &heuristicResult.algo, + workspace, + workspaceSize, + stream); + +CLEANUP: + // Descriptors are no longer needed as all GPU work was already + // enqueued. + return status == CUBLAS_STATUS_SUCCESS ? 0 : 1; +} + +int mlp_gemm_lt( + cublasLtHandle_t ltHandle, + cublasOperation_t transa, + cublasOperation_t transb, + int m, + int n, + int k, + float *alpha, /* host pointer */ + const double* A, + int lda, + const double* B, + int ldb, + float *beta, /* host pointer */ + double* C, + int ldc, + void *workspace, + size_t workspaceSize, + cudaStream_t stream, + bool use_bias, + bool use_relu, + const void* bias) { + return 1; +} + +int mlp_gemm_lt( + cublasLtHandle_t ltHandle, + cublasOperation_t transa, + cublasOperation_t transb, + int m, + int n, + int k, + float *alpha, /* host pointer */ + const float *A, + int lda, + const float *B, + int ldb, + float *beta, /* host pointer */ + float *C, + int ldc, + void *workspace, + size_t workspaceSize, + cudaStream_t stream, + bool use_bias, + bool use_relu, + const void* bias) { + cublasStatus_t status = CUBLAS_STATUS_SUCCESS; + + cublasLtMatmulDescOpaque_t operationDesc = {}; + cublasLtMatrixLayoutOpaque_t Adesc = {}, Bdesc = {}, Cdesc = {}; + cublasLtMatmulPreferenceOpaque_t preference = {}; + + int returnedResults = 0; + cublasLtMatmulHeuristicResult_t heuristicResult = {}; + cublasLtEpilogue_t epilogue = CUBLASLT_EPILOGUE_DEFAULT; + + // Create operation descriptor; see cublasLtMatmulDescAttributes_t + // for details about defaults; here we just set the transforms for + // A and B. + status = cublasLtMatmulDescInit(&operationDesc, CUBLAS_COMPUTE_32F, CUDA_R_32F); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_TRANSA, &transa, sizeof(transa)); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_TRANSB, &transb, sizeof(transa)); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + if (use_bias) { + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_BIAS_POINTER, &bias, sizeof(bias)); + if (status != CUBLAS_STATUS_SUCCESS) { + goto CLEANUP; + } + if (use_relu) { + epilogue = CUBLASLT_EPILOGUE_RELU_BIAS; + } else { + epilogue = CUBLASLT_EPILOGUE_BIAS; + } + } else { + if (use_relu) { + epilogue = CUBLASLT_EPILOGUE_RELU; + } + } + + status = cublasLtMatmulDescSetAttribute(&operationDesc, CUBLASLT_MATMUL_DESC_EPILOGUE, &epilogue, sizeof(epilogue)); + if (status != CUBLAS_STATUS_SUCCESS) { + goto CLEANUP; + } + + // Create matrix descriptors. Not setting any extra attributes. + status = cublasLtMatrixLayoutInit( + &Adesc, CUDA_R_32F, transa == CUBLAS_OP_N ? m : k, transa == CUBLAS_OP_N ? k : m, lda); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatrixLayoutInit( + &Bdesc, CUDA_R_32F, transb == CUBLAS_OP_N ? k : n, transb == CUBLAS_OP_N ? n : k, ldb); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatrixLayoutInit(&Cdesc, CUDA_R_32F, m, n, ldc); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + // Create preference handle; In general, extra attributes can be + // used here to disable tensor ops or to make sure algo selected + // will work with badly aligned A, B, C. However, for simplicity + // here we assume A,B,C are always well aligned (e.g., directly + // come from cudaMalloc) + status = cublasLtMatmulPreferenceInit(&preference); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + status = cublasLtMatmulPreferenceSetAttribute( + &preference, CUBLASLT_MATMUL_PREF_MAX_WORKSPACE_BYTES, &workspaceSize, sizeof(workspaceSize)); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + // We just need the best available heuristic to try and run matmul. + // There is no guarantee that this will work. For example, if A is + // badly aligned, you can request more (e.g. 32) algos and try to + // run them one by one until something works. + status = cublasLtMatmulAlgoGetHeuristic( + ltHandle, &operationDesc, &Adesc, &Bdesc, &Cdesc, &Cdesc, &preference, 1, &heuristicResult, &returnedResults); + if (status != CUBLAS_STATUS_SUCCESS) goto CLEANUP; + + if (returnedResults == 0) { + status = CUBLAS_STATUS_NOT_SUPPORTED; + goto CLEANUP; + } + + status = cublasLtMatmul(ltHandle, + &operationDesc, + alpha, + A, + &Adesc, + B, + &Bdesc, + beta, + C, + &Cdesc, + C, + &Cdesc, + &heuristicResult.algo, + workspace, + workspaceSize, + stream); + +CLEANUP: + // Descriptors are no longer needed as all GPU work was already + // enqueued. + return status == CUBLAS_STATUS_SUCCESS ? 0 : 1; +} + + +// Bias ADD. Assume input X is [features x batch size], column major. +// Bias is one 'features' long vector, with implicit broadcast. +template +__global__ void biasAdd_fprop(T *X, T *b, uint batch_size, uint features) { + T r_x[ILP]; + T r_b[ILP]; + if(is_aligned(X) && is_aligned(b) && features % ILP ==0) { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid*ILP < features * batch_size; tid += blockDim.x * gridDim.x) { + int row = tid % (features / ILP); + load_store(r_x, X, 0 , tid); + load_store(r_b, b, 0 , row); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + float bias_sum = static_cast(r_x[ii]) + static_cast(r_b[ii]); + r_x[ii] = bias_sum; + } + load_store(X, r_x, tid , 0); + } + } else { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid < features * batch_size; tid += ILP * blockDim.x * gridDim.x) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + int row = tid % features; + r_x[ii] = X[idx]; + r_b[ii] = b[row]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + float bias_sum = static_cast(r_x[ii]) + static_cast(r_b[ii]); + r_x[ii] = bias_sum; + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + X[idx] = r_x[ii]; + } + } + } + } +} + +// Bias ADD + ReLU. Assume input X is [features x batch size], column major. +// Activation support fuesed ReLU. Safe to call in-place. +template +__global__ void biasAddRelu_fprop(T *X, T *b, uint batch_size, uint features) { + T r_x[ILP]; + T r_b[ILP]; + if(is_aligned(X) && is_aligned(b) && features % ILP ==0) { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid*ILP < features * batch_size; tid += blockDim.x * gridDim.x) { + int row = tid % (features / ILP); + load_store(r_x, X, 0 , tid); + load_store(r_b, b, 0 , row); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + float bias_sum = static_cast(r_x[ii]) + static_cast(r_b[ii]); + r_x[ii] = relu(bias_sum); + } + load_store(X, r_x, tid , 0); + } + } else { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid < features * batch_size; tid += ILP * blockDim.x * gridDim.x) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + int row = tid % features; + r_x[ii] = X[idx]; + r_b[ii] = b[row]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + float bias_sum = static_cast(r_x[ii]) + static_cast(r_b[ii]); + r_x[ii] = relu(bias_sum); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + X[idx] = r_x[ii]; + } + } + } + } +} + +// ReLU. Assume input X is [features x batch size], column major. +// Safe to call in-place. +template +__global__ void Relu_fprop(T *X, uint batch_size, uint features) { + T r_x[ILP]; + if(is_aligned(X) && features % ILP ==0) { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid*ILP < features * batch_size; tid += blockDim.x * gridDim.x) { + load_store(r_x, X, 0 , tid); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + r_x[ii] = relu(static_cast(r_x[ii])); + } + load_store(X, r_x, tid , 0); + } + } else { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid < features * batch_size; tid += ILP * blockDim.x * gridDim.x) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + r_x[ii] = X[idx]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + r_x[ii] = relu(static_cast(r_x[ii])); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + X[idx] = r_x[ii]; + } + } + } + } +} + +// Sigmoid. Assume input X is [features x batch size], column major. +// Safe to call in-place. +template +__global__ void Sigmoid_fprop(T *X, uint batch_size, uint features) { + T r_x[ILP]; + if(is_aligned(X) && features % ILP ==0) { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid*ILP < features * batch_size; tid += blockDim.x * gridDim.x) { + load_store(r_x, X, 0 , tid); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + r_x[ii] = sigmoid(static_cast(r_x[ii])); + } + load_store(X, r_x, tid , 0); + } + } else { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid < features * batch_size; tid += ILP * blockDim.x * gridDim.x) { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + r_x[ii] = X[idx]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + r_x[ii] = sigmoid(static_cast(r_x[ii])); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) { + int idx = tid + ii * blockDim.x * gridDim.x; + if(idx < features * batch_size) { + X[idx] = r_x[ii]; + } + } + } + } +} + +// ReLU. Assume input X is [features x batch size], column major. +// Safe to call in-place. +template +__global__ void Relu_bprop(T *dY, T *Y, uint batch_size, uint features, T *dX) { + T r_dy[ILP]; + T r_y[ILP]; + if(is_aligned(dY) && + is_aligned(Y) && + is_aligned(dX) && + features % ILP ==0) { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid*ILP < features * batch_size; tid += blockDim.x * gridDim.x) { + load_store(r_dy, dY, 0 , tid); + load_store(r_y, Y, 0 , tid); +#pragma unroll + for(int ii=0;ii +__global__ void Sigmoid_bprop(T *dY, T *Y, uint batch_size, uint features, T *dX) { + T r_dy[ILP]; + T r_y[ILP]; + if(is_aligned(dY) && + is_aligned(Y) && + is_aligned(dX) && + features % ILP ==0) { + int tid = blockIdx.x * blockDim.x + threadIdx.x; + for (; tid*ILP < features * batch_size; tid += blockDim.x * gridDim.x) { + load_store(r_dy, dY, 0 , tid); + load_store(r_y, Y, 0 , tid); +#pragma unroll + for(int ii=0;iimultiProcessorCount; + // can switch to occupancy calculation. use 4 below now for sm_70 + int max_blocks_y = (num_SMs * 4+(*grid_x)-1) / (*grid_x); + // block_y should be from minimal work per thread + int nRedSplits = (batch_size + block_y - 1) / block_y; + // increase number of elem per thread redcution to not launch more than enough + // kernel adjust work, so here we just launch max block + *grid_y = std::min(nRedSplits, max_blocks_y); + return; +} + +// Addition done deterministically via a 2-pass approach. Each CTA writes out partial +// sum, and the last CTA in grid Y dimension accumulates partials serially and writes to result. +template +__global__ void biasAdd_bprop( + T* dY, + int features, + int batch_size, + volatile float* intermediate, + int* semaphores, + T* db) { + // The feature that this thread is responsible for + int f = blockIdx.x * blockDim.x + threadIdx.x; + + // Compute the span this thread is responsible for + // For this block + int b_chunkSize = (batch_size + gridDim.y - 1) / gridDim.y; + int b_nStart = blockIdx.y * b_chunkSize; + int b_nSpan = min(batch_size, b_nStart + b_chunkSize) - b_nStart; + // For this thread + int chunkSize = (b_chunkSize + blockDim.y - 1) / blockDim.y; + int nStart = threadIdx.y * chunkSize + b_nStart; + int nSpan = min(b_nStart + b_nSpan, nStart + chunkSize) - nStart; + + volatile float* out = intermediate + blockIdx.y * features; + + // Flag to trigger last reduction. + __shared__ bool isLastBlock; + // we know block size for now + __shared__ float smem[BIAS_RELU_BW_NTHREADS_X*BIAS_RELU_BW_NTHREADS_Y]; + + // Accumulate db in FP32 always + float db_local = 0; + if (f < features) { + int nidx = 0; + // Handle non-multiple of UNROLL_FACTOR residue + for (; nidx < nSpan % UNROLL_FACTOR; nidx++) { + int64_t row, col, flat_idx; + row = f; + col = nStart + nidx; + flat_idx = col * features + row; + db_local += (float)dY[flat_idx]; + } + + // Handle meat of work + for (; (nidx + UNROLL_FACTOR - 1) < nSpan; nidx += UNROLL_FACTOR) { + int64_t row, col, flat_idx; + row = f; + col = nStart + nidx; + flat_idx = col * features + row; +#pragma unroll 4 + for (int u = 0; u < UNROLL_FACTOR; u++) { + db_local += (float)dY[flat_idx]; + flat_idx += features; + } + } + + // naive block reduction on y-dim + int linear_idx = threadIdx.y * blockDim.x + threadIdx.x; + smem[linear_idx] = db_local; + } + __syncthreads(); + if (f < features) { + if(threadIdx.y == 0) { + for(int yidx = 1; yidx < blockDim.y; yidx++){ + db_local += smem[yidx * blockDim.x + threadIdx.x]; + } + + // block result is in db_local now for all threadIdx.y == 0 + // Write out partial result + out[f] = db_local; + } + } + __threadfence(); + __syncthreads(); + + // Increment semaphore and check if this is the last CTA in the grid_y dimension. + // Only thread (0,0) calls this + if (threadIdx.x == 0 && threadIdx.y == 0 && f < features) { + unsigned int sum_idx; + sum_idx = atomicAdd(&(semaphores[blockIdx.x]), 1); + isLastBlock = (sum_idx == (gridDim.y - 1)); + } + __syncthreads(); + + db_local = 0; + // No block reduction for now, only thread (*,0) do grid reduction + if (isLastBlock && f < features) { + if(threadIdx.y == 0) { + for (int n = 0; n < gridDim.y; n++) { + int row, col; + row = f; + col = n; + db_local += (float)(intermediate[col * features + row]); + } + db[f] = (T)db_local; + } + } +} + +// Addition done deterministically via a 2-pass approach. Each CTA writes out partial +// sum, and the last CTA in grid Y dimension accumulates partials serially and writes to result. +template +__global__ void biasAddRelu_bprop( + T* Y, + T* dY, + int features, + int batch_size, + T* dX, + volatile float* intermediate, + int* semaphores, + T* db) { + // The feature that this thread is responsible for + int f = blockIdx.x * blockDim.x + threadIdx.x; + + // Compute the span this thread is responsible for + // For this block + int b_chunkSize = (batch_size + gridDim.y - 1) / gridDim.y; + int b_nStart = blockIdx.y * b_chunkSize; + int b_nSpan = min(batch_size, b_nStart + b_chunkSize) - b_nStart; + // For this thread + int chunkSize = (b_chunkSize + blockDim.y - 1) / blockDim.y; + int nStart = threadIdx.y * chunkSize + b_nStart; + int nSpan = min(b_nStart + b_nSpan, nStart + chunkSize) - nStart; + + volatile float* out = intermediate + blockIdx.y * features; + + // Flag to trigger last reduction. + __shared__ bool isLastBlock; + // we know block size for now + __shared__ float smem[BIAS_RELU_BW_NTHREADS_X*BIAS_RELU_BW_NTHREADS_Y]; + + // Accumulate db in FP32 always + float db_local = 0; + if (f < features) { + int nidx = 0; + // Handle non-multiple of UNROLL_FACTOR residue + for (; nidx < nSpan % UNROLL_FACTOR; nidx++) { + int row, col, flat_idx; + row = f; + col = nStart + nidx; + flat_idx = col * features + row; + T y_val = Y[flat_idx]; + T dy_val = dY[flat_idx]; + T dx_val; + if ((float)y_val > 0.f) + dx_val = dy_val; + else + dx_val = 0; + dX[flat_idx] = dx_val; + db_local += (float)dx_val; + } + + // Handle meat of work + for (; (nidx + UNROLL_FACTOR - 1) < nSpan; nidx += UNROLL_FACTOR) { + int row, col, flat_idx; + row = f; + col = nStart + nidx; + flat_idx = col * features + row; +#pragma unroll 4 + for (int u = 0; u < UNROLL_FACTOR; u++) { + T y_val = Y[flat_idx]; + T dy_val = dY[flat_idx]; + T dx_val; + if ((float)y_val > 0.f) + dx_val = dy_val; + else + dx_val = 0; + dX[flat_idx] = dx_val; + db_local += (float)dx_val; + flat_idx += features; + } + } + + // naive block reduction on y-dim + int linear_idx = threadIdx.y * blockDim.x + threadIdx.x; + smem[linear_idx] = db_local; + } + __syncthreads(); + if (f < features) { + if(threadIdx.y == 0) { + for(int yidx = 1; yidx < blockDim.y; yidx++){ + db_local += smem[yidx * blockDim.x + threadIdx.x]; + } + + // block result is in db_local now for all threadIdx.y == 0 + // Write out partial result + out[f] = db_local; + } + } + __threadfence(); + __syncthreads(); + + // Increment semaphore and check if this is the last CTA in the grid_y dimension. + // Only thread (0,0) calls this + if (threadIdx.x == 0 && threadIdx.y == 0 && f < features) { + unsigned int sum_idx; + sum_idx = atomicAdd(&(semaphores[blockIdx.x]), 1); + isLastBlock = (sum_idx == (gridDim.y - 1)); + } + __syncthreads(); + + db_local = 0; + // No block reduction for now, only thread (*,0) do grid reduction + if (isLastBlock && f < features) { + if(threadIdx.y == 0) { + for (int n = 0; n < gridDim.y; n++) { + int row, col; + row = f; + col = n; + db_local += (float)(intermediate[col * features + row]); + } + db[f] = (T)db_local; + } + } +} + +// Addition done deterministically via a 2-pass approach. Each CTA writes out partial +// sum, and the last CTA in grid Y dimension accumulates partials serially and writes to result. +template +__global__ void biasAddRelu_bprop_aligned( + T* Y, + T* dY, + int features, + int batch_size, + T* dX, + volatile float* intermediate, + int* semaphores, + T* db) { + // The feature that this thread is responsible for + int f = blockIdx.x * blockDim.x + threadIdx.x; + + // Compute the span this thread is responsible for + // For this block + int b_chunkSize = (batch_size + gridDim.y - 1) / gridDim.y; + int b_nStart = blockIdx.y * b_chunkSize; + int b_nSpan = min(batch_size, b_nStart + b_chunkSize) - b_nStart; + // For this thread + int chunkSize = (b_chunkSize + blockDim.y - 1) / blockDim.y; + int nStart = threadIdx.y * chunkSize + b_nStart; + int nSpan = min(b_nStart + b_nSpan, nStart + chunkSize) - nStart; + + volatile float* out = intermediate + blockIdx.y * features; + + // Flag to trigger last reduction. + __shared__ bool isLastBlock; + + // Accumulate db in FP32 always + float db_local[ILP]; + T r_y[ILP]; + T r_dy[ILP]; +#pragma unroll + for(int ii=0;ii +size_t get_mlp_bp_workspace_in_bytes(int batch_size, int num_layers, const int* output_features) { + size_t work_space = 0; + + // Store each intermediate dY explicitly. Need 2 dYs per MLP layer (one for o/p + // of biasReLU_bp and one for o/p of dgrad GEMM). + work_space += 2 * get_all_activations_size(batch_size, num_layers, output_features) * sizeof(T); + work_space += + get_reduction_scratch_space(batch_size, num_layers, output_features) * sizeof(float); + work_space += get_semaphores_size(num_layers, output_features) * sizeof(int); + + return work_space; +} + +// Returns pointers to each segment of the workspace +template +void partition_mlp_bp_workspace( + int batch_size, + int num_layers, + const int* output_features, + void* work_space, + T** dy_gemms, + T** dx_gemms, + float** db_scratch, + int** semaphores) { + /* + Workspace is partitioned as + DY_GEMMs : DX_GEMMs : DB_SCRATCH : SEMAPHORES + */ + // Start address where dy_gemm tensors are stored + *dy_gemms = reinterpret_cast(work_space); + // Start address where dx_gemm tensors are stored + *dx_gemms = *dy_gemms + get_all_activations_size(batch_size, num_layers, output_features); + // Start address where db intermediate tensors are stored + *db_scratch = reinterpret_cast( + *dx_gemms + get_all_activations_size(batch_size, num_layers, output_features)); + // Start address of semaphores + *semaphores = reinterpret_cast( + *db_scratch + get_reduction_scratch_space(batch_size, num_layers, output_features)); + + return; +} + +// Does a simple MLP fprop (GEMM+bias+ReLU). +// Can handle num_layers number of layers, each with its own shape. Output of layer i is assumed +// to be input of layer i+1. output_features, WPtr and BPtr are arrays of length num_layers, and +// must be in the same order i.e. WPtr[i] and BPtr[i] are respectively the weight and bias of layer +// 'i'. +template +int mlp_fp( + T* X, + int input_features, + int batch_size, + T** WPtr, + int num_layers, + int* output_features, + T** BPtr, + T* Y, + T* reserved_space, + int use_bias, + int activation, + void* lt_workspace) { + T *weight, *input, *output, *bias; + T *reserved_space_x, *reserved_space_y; + reserved_space_x = NULL; + reserved_space_y = reserved_space; + + // Get cublas handle from Pytorch + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + // Get the stream from cublas handle to reuse for biasReLU kernel. + cudaStream_t stream; + cublasGetStream(handle, &stream); + + for (int layer = 0; layer < num_layers; layer++) { + weight = WPtr[layer]; + input = (layer == 0) ? X : reserved_space_x; + output = (layer == num_layers - 1) ? Y : reserved_space_y; + if (use_bias) { + bias = BPtr[layer]; + } + int ifeat = (layer == 0) ? input_features : output_features[layer - 1]; + int ofeat = output_features[layer]; + + float one = 1.f; + float zero = 0.f; + + // try with cublaslt first for supported case with valid handle + int cublaslt_status = 1; + if(activation < 1){ + cublaslt_status = mlp_gemm_lt( + //ltHandle, + (cublasLtHandle_t)handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + ofeat, + batch_size, + ifeat, + &one, + weight, + ifeat, + input, + ifeat, + &zero, + output, + ofeat, + lt_workspace, + 1 << 22, + stream, + use_bias == 1, + activation == 1, + bias); + } + + // if cublaslt failed or not executed, fallback to cublas + if (cublaslt_status != 0) { + cublasStatus_t cublas_status; + // Call GEMM: fprop is Y = W'X + cublas_status = mlp_gemm( + handle, + CUBLAS_OP_T, + CUBLAS_OP_N, + ofeat, + batch_size, + ifeat, + &one, + weight, + ifeat, + input, + ifeat, + &zero, + output, + ofeat); + + if (cublas_status != CUBLAS_STATUS_SUCCESS) { + printf("GEMM fprop failed with %d\n", cublas_status); + return 1; + } + + const uint &input_size = ofeat; + int num_blocks = 0; + int num_SMs = at::cuda::getCurrentDeviceProperties()->multiProcessorCount; + // Call biasReLU + if(use_bias == 1) { + if (activation == 0) { // no activation + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, biasAdd_fprop, BIAS_RELU_FW_NTHREADS, 0); + biasAdd_fprop<<>>(output, bias, batch_size, input_size); + } else if (activation == 1) { // relu + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, biasAddRelu_fprop, BIAS_RELU_FW_NTHREADS, 0); + biasAddRelu_fprop<<>>(output, bias, batch_size, input_size); + } else if (activation == 2) { // sigmoid + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, biasAdd_fprop, BIAS_RELU_FW_NTHREADS, 0); + biasAdd_fprop<<>>(output, bias, batch_size, input_size); + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, Sigmoid_fprop, BIAS_RELU_FW_NTHREADS, 0); + Sigmoid_fprop<<>>(output, batch_size, input_size); + } + } else { + // don't need to do anything in case of no activation and no bias + if (activation == 1) { // relu + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, Relu_fprop, BIAS_RELU_FW_NTHREADS, 0); + Relu_fprop<<>>(output, batch_size, input_size); + } else if (activation == 2) { // sigmoid + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, Sigmoid_fprop, BIAS_RELU_FW_NTHREADS, 0); + Sigmoid_fprop<<>>(output, batch_size, input_size); + } + } + } + // Set current output as next layer input + reserved_space_x = reserved_space_y; + // Set next layer output + reserved_space_y += ofeat * batch_size; + } + + return 0; +} + +// Does a simple MLP bprop (GEMM+bias+ReLU). +// Needs reserved space to come back exactly as it was populated in fprop. +// Does dgrad and wgrad sequentially. +template +int mlp_bp( + T* X, + T* Y, + int input_features, + int batch_size, + T** WPtr, + int num_layers, + int* output_features, + T* dY, + T* reserved_space, + T* work_space, + T* dX, + T** dwPtr, + T** dbPtr, + bool requires_grad, + int use_bias, + int activation) { + T* weight; + T *dweight, *dx, *dy, *dbias; + T *x, *y; + + // Where the dx of the biasReLU (== dy of gemm) is stored. Can be thrown away + // after bp call. + T* dy_gemm_base; + // Where the dx after GEMM is stored. + T* dx_gemm_base; + // Where partial reduction results are stored. + float* db_scratch; + // Semaphores for reduction. + int* semaphores; + + partition_mlp_bp_workspace( + batch_size, + num_layers, + output_features, + work_space, + &dy_gemm_base, + &dx_gemm_base, + &db_scratch, + &semaphores); + + size_t semaphore_size = get_semaphores_size(num_layers, output_features) * sizeof(int); + + // Get cublas handle from Pytorch + cublasHandle_t handle = at::cuda::getCurrentCUDABlasHandle(); + // Get the stream from cublas handle to reuse for biasReLU kernel. + cudaStream_t stream; + cublasGetStream(handle, &stream); + + int* y_offsets = (int*)malloc(num_layers * sizeof(int)); + get_y_offsets(batch_size, num_layers, output_features, y_offsets); + + for (int layer = num_layers - 1; layer >= 0; layer--) { + weight = WPtr[layer]; + dweight = dwPtr[layer]; + + // x is read from reserved space + x = (layer == 0) ? X : reserved_space + y_offsets[layer - 1]; + // dx is written in workspace for all but layer==0 + dx = (layer == 0) ? dX : dx_gemm_base + y_offsets[layer - 1]; + + // y is read from reserved space + y = (layer == num_layers - 1) ? Y : reserved_space + y_offsets[layer]; + // dx from layer+1 + dy = (layer == num_layers - 1) ? dY : dx_gemm_base + y_offsets[layer]; + // dy_gemm is written to and read immediately + T* dy_gemm = dy_gemm_base + y_offsets[layer]; + + dbias = dbPtr[layer]; + int xfeat = (layer == 0) ? input_features : output_features[layer - 1]; + int yfeat = output_features[layer]; + + float one = 1.f; + float zero = 0.f; + + if (use_bias == 1) { + if (activation == 0) { // no acitvation + // bgrad + dim3 block(BIAS_RELU_BW_NTHREADS_X, BIAS_RELU_BW_NTHREADS_Y); + int grid_x, grid_y; + cudaMemsetAsync(semaphores, 0, semaphore_size, stream); + + int block_x = BIAS_RELU_BW_NTHREADS_X; + int block_y = BIAS_RELU_RED_PER_THREAD * BIAS_RELU_BW_NTHREADS_Y; + get_biasAddRelu_bprop_grid_size(yfeat, batch_size, block_x, block_y, &grid_x, &grid_y); + dim3 grid(grid_x, grid_y); + biasAdd_bprop<<>>( + dy, yfeat, batch_size, db_scratch, semaphores, dbias); + // bypass dgrad through reset pointer + dy_gemm = dy; + } else if (activation == 1) { // relu + dim3 block(BIAS_RELU_BW_NTHREADS_X, BIAS_RELU_BW_NTHREADS_Y); + int grid_x, grid_y; + cudaMemsetAsync(semaphores, 0, semaphore_size, stream); + + if(yfeat % (ILP * BIAS_RELU_BW_NTHREADS_X) == 0 && + is_aligned(y) && + is_aligned(dy) && + is_aligned(dy_gemm) && + is_aligned(dbias)){ + int block_x = ILP * BIAS_RELU_BW_NTHREADS_X; + int block_y = BIAS_RELU_RED_PER_THREAD * BIAS_RELU_BW_NTHREADS_Y; + get_biasAddRelu_bprop_grid_size(yfeat, batch_size, block_x, block_y, &grid_x, &grid_y); + dim3 grid(grid_x, grid_y); + biasAddRelu_bprop_aligned<<>>( + y, dy, yfeat, batch_size, dy_gemm, db_scratch, semaphores, dbias); + } else { + int block_x = BIAS_RELU_BW_NTHREADS_X; + int block_y = BIAS_RELU_RED_PER_THREAD * BIAS_RELU_BW_NTHREADS_Y; + get_biasAddRelu_bprop_grid_size(yfeat, batch_size, block_x, block_y, &grid_x, &grid_y); + dim3 grid(grid_x, grid_y); + biasAddRelu_bprop<<>>( + y, dy, yfeat, batch_size, dy_gemm, db_scratch, semaphores, dbias); + } + } else if (activation == 2) { // sigmoid + // activation backward + int num_blocks = 0; + int num_SMs = at::cuda::getCurrentDeviceProperties()->multiProcessorCount; + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, Sigmoid_bprop, BIAS_RELU_FW_NTHREADS, 0); + Sigmoid_bprop<<>>(dy, y, batch_size, yfeat, dy_gemm); + + // bgrad, from dy_gemm + dim3 block(BIAS_RELU_BW_NTHREADS_X, BIAS_RELU_BW_NTHREADS_Y); + int grid_x, grid_y; + cudaMemsetAsync(semaphores, 0, semaphore_size, stream); + + int block_x = BIAS_RELU_BW_NTHREADS_X; + int block_y = BIAS_RELU_RED_PER_THREAD * BIAS_RELU_BW_NTHREADS_Y; + get_biasAddRelu_bprop_grid_size(yfeat, batch_size, block_x, block_y, &grid_x, &grid_y); + dim3 grid(grid_x, grid_y); + biasAdd_bprop<<>>( + dy_gemm, yfeat, batch_size, db_scratch, semaphores, dbias); + } + } else { // no bias below + if (activation == 0) { + // bypass dgrad through reset pointer + dy_gemm = dy; + } else if (activation == 1) { // relu + int num_blocks = 0; + int num_SMs = at::cuda::getCurrentDeviceProperties()->multiProcessorCount; + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, Relu_bprop, BIAS_RELU_FW_NTHREADS, 0); + Relu_bprop<<>>(dy, y, batch_size, yfeat, dy_gemm); + } else if (activation == 2) { // sigmoid + int num_blocks = 0; + int num_SMs = at::cuda::getCurrentDeviceProperties()->multiProcessorCount; + cudaOccupancyMaxActiveBlocksPerMultiprocessor(&num_blocks, Sigmoid_bprop, BIAS_RELU_FW_NTHREADS, 0); + Sigmoid_bprop<<>>(dy, y, batch_size, yfeat, dy_gemm); + } + } + + cublasStatus_t cublas_status; + // Call GEMM dgrad + if (layer > 0 || requires_grad == 1) { + cublas_status = mlp_gemm( + handle, + CUBLAS_OP_N, + CUBLAS_OP_N, + xfeat, + batch_size, + yfeat, + &one, + weight, + xfeat, + dy_gemm, + yfeat, + &zero, + dx, + xfeat); + + if (cublas_status != CUBLAS_STATUS_SUCCESS) { + printf("GEMM dgrad failed with %d\n", cublas_status); + return 1; + } + } + + // Call GEMM wgrad + cublas_status = mlp_gemm( + handle, + CUBLAS_OP_N, + CUBLAS_OP_T, + xfeat, + yfeat, + batch_size, + &one, + x, + xfeat, + dy_gemm, + yfeat, + &zero, + dweight, + xfeat); + + if (cublas_status != CUBLAS_STATUS_SUCCESS) { + printf("GEMM wgrad failed with %d\n", cublas_status); + return 1; + } + } + + return 0; +} + +// Instantiate for floating point types +template int mlp_fp( + float* X, + int input_features, + int batch_size, + float** WPtr, + int num_layers, + int* output_features, + float** BPtr, + float* Y, + float* reserved_space, + int use_bias, + int activation, + void* lt_workspace); + +template int mlp_bp( + float* X, + float* Y, + int input_features, + int batch_size, + float** WPtr, + int num_layers, + int* output_features, + float* dY, + float* reserved_space, + float* work_space, + float* dX, + float** dwPtr, + float** dbPtr, + bool requires_grad, + int use_bias, + int activation); + +template int mlp_fp( + at::Half* X, + int input_features, + int batch_size, + at::Half** WPtr, + int num_layers, + int* output_features, + at::Half** BPtr, + at::Half* Y, + at::Half* reserved_space, + int use_bias, + int activation, + void* lt_workspace); + +template int mlp_bp( + at::Half* X, + at::Half* Y, + int input_features, + int batch_size, + at::Half** WPtr, + int num_layers, + int* output_features, + at::Half* dY, + at::Half* reserved_space, + at::Half* work_space, + at::Half* dX, + at::Half** dwPtr, + at::Half** dbPtr, + bool requires_grad, + int use_bias, + int activation); + +template int mlp_fp( + double* X, + int input_features, + int batch_size, + double** WPtr, + int num_layers, + int* output_features, + double** BPtr, + double* Y, + double* reserved_space, + int use_bias, + int activation, + void* lt_workspace); + +template int mlp_bp( + double* X, + double* Y, + int input_features, + int batch_size, + double** WPtr, + int num_layers, + int* output_features, + double* dY, + double* reserved_space, + double* work_space, + double* dX, + double** dwPtr, + double** dbPtr, + bool requires_grad, + int use_bias, + int activation); + +template size_t get_mlp_bp_workspace_in_bytes( + int batch_size, + int num_layers, + const int* output_features); +template size_t get_mlp_bp_workspace_in_bytes( + int batch_size, + int num_layers, + const int* output_features); +template size_t get_mlp_bp_workspace_in_bytes( + int batch_size, + int num_layers, + const int* output_features); + diff --git a/apex/csrc/multi_tensor_adagrad.cu b/apex/csrc/multi_tensor_adagrad.cu new file mode 100644 index 0000000000000000000000000000000000000000..699681bce370c0fc77d6ea1e2881776f481557ed --- /dev/null +++ b/apex/csrc/multi_tensor_adagrad.cu @@ -0,0 +1,100 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "multi_tensor_apply.cuh" +#include "type_shim.h" + +#define BLOCK_SIZE 1024 +#define ILP 4 + +typedef enum { + ADAGRAD_MODE_0 = 0, // L2 regularization mode. + ADAGRAD_MODE_1 = 1, // AdamW-style weight decay. + +} adagradMode_t; + +using MATH_T = float; + +template struct AdagradFunctor { + __device__ __forceinline__ void + operator()(int chunk_size, volatile int *noop_gmem, TensorListMetadata<3> &tl, + const float epsilon, const float lr, adagradMode_t mode, + const float weight_decay) { + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + T *g = (T *)tl.addresses[0][tensor_loc]; + g += chunk_idx * chunk_size; + + T *p = (T *)tl.addresses[1][tensor_loc]; + p += chunk_idx * chunk_size; + + T *h = (T *)tl.addresses[2][tensor_loc]; + h += chunk_idx * chunk_size; + + n -= chunk_idx * chunk_size; + + // see note in multi_tensor_scale_kernel.cu + for (int i_start = 0; i_start < n && i_start < chunk_size; + i_start += blockDim.x * ILP) { + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_h[ILP]; +#pragma unroll + for (int ii = 0; ii < ILP; ii++) { + int i = i_start + threadIdx.x + ii * blockDim.x; + if (i < n && i < chunk_size) { + r_g[ii] = g[i]; + r_p[ii] = p[i]; + r_h[ii] = h[i]; + } else { + r_g[ii] = MATH_T(0); + r_p[ii] = MATH_T(0); + r_h[ii] = MATH_T(0); + } + } +#pragma unroll + for (int ii = 0; ii < ILP; ii++) { + if (mode == ADAGRAD_MODE_0) { // L2 + r_g[ii] = r_g[ii] + weight_decay * r_p[ii]; + r_h[ii] = r_h[ii] + r_g[ii] * r_g[ii]; + r_p[ii] = r_p[ii] - lr * (r_g[ii] / (sqrtf(r_h[ii]) + epsilon)); + } else { // AdamW-style + r_h[ii] = r_h[ii] + r_g[ii] * r_g[ii]; + r_p[ii] = r_p[ii] - lr * (r_g[ii] / (sqrtf(r_h[ii]) + epsilon) + weight_decay * r_p[ii]); + } + } +#pragma unroll + for (int ii = 0; ii < ILP; ii++) { + int i = i_start + threadIdx.x + ii * blockDim.x; + if (i < n && i < chunk_size) { + p[i] = r_p[ii]; + h[i] = r_h[ii]; + } + } + } + } +}; + +void multi_tensor_adagrad_cuda( + int chunk_size, at::Tensor noop_flag, + std::vector> tensor_lists, const float lr, + const float epsilon, const int mode, const float weight_decay) { + using namespace at; + + // Assume single type across p,g,h now + DISPATCH_DOUBLE_FLOAT_AND_HALF( + tensor_lists[0][0].scalar_type(), 0, "adagrad", + multi_tensor_apply<3>(BLOCK_SIZE, chunk_size, noop_flag, tensor_lists, + AdagradFunctor(), epsilon, lr, + (adagradMode_t)mode, weight_decay);) + + AT_CUDA_CHECK(cudaGetLastError()); +} diff --git a/apex/csrc/multi_tensor_adam.cu b/apex/csrc/multi_tensor_adam.cu new file mode 100644 index 0000000000000000000000000000000000000000..dacbfc15fa24cce7b950e4d8ca72245ab322cead --- /dev/null +++ b/apex/csrc/multi_tensor_adam.cu @@ -0,0 +1,171 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +typedef enum{ + ADAM_MODE_0 =0, // L2 regularization mode + ADAM_MODE_1 =1 // Decoupled weight decay mode(AdamW) +} adamMode_t; + +using MATH_T = float; + +template +struct AdamFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<4>& tl, + const float beta1, + const float beta2, + const float beta1_correction, + const float beta2_correction, + const float epsilon, + const float lr, + adamMode_t mode, + const float decay) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + + // potentially use to pass in list of scalar + // int tensor_num = tl.start_tensor_this_launch + tensor_loc; + + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + T* g = (T*)tl.addresses[0][tensor_loc]; + g += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + T* m = (T*)tl.addresses[2][tensor_loc]; + m += chunk_idx*chunk_size; + + T* v = (T*)tl.addresses[3][tensor_loc]; + v += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + // see note in multi_tensor_scale_kernel.cu + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; + MATH_T r_v[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_g[ii] = g[i]; + r_p[ii] = p[i]; + r_m[ii] = m[i]; + r_v[ii] = v[i]; + } else { + r_g[ii] = MATH_T(0); + r_p[ii] = MATH_T(0); + r_m[ii] = MATH_T(0); + r_v[ii] = MATH_T(0); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if(mode == ADAM_MODE_0) { // L2 + r_g[ii] = r_g[ii] + (decay * r_p[ii]); + r_m[ii] = beta1 * r_m[ii] + (1-beta1) * r_g[ii]; + r_v[ii] = beta2 * r_v[ii] + (1-beta2) * r_g[ii] * r_g[ii]; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + MATH_T update = next_m_unbiased / denom; + r_p[ii] = r_p[ii] - (lr * update); + } + else { // weight decay + r_m[ii] = beta1 * r_m[ii] + (1-beta1) * r_g[ii]; + r_v[ii] = beta2 * r_v[ii] + (1-beta2) * r_g[ii] * r_g[ii]; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + MATH_T update = (next_m_unbiased / denom) + (decay * r_p[ii]); + r_p[ii] = r_p[ii] - (lr * update); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + p[i] = r_p[ii]; + m[i] = r_m[ii]; + v[i] = r_v[ii]; + } + } + } + } +}; + +void multi_tensor_adam_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int mode, + const int bias_correction, + const float weight_decay) +{ + using namespace at; + + // Handle bias correction mode + float bias_correction1 = 1.0f, bias_correction2 = 1.0f; + if (bias_correction == 1) { + bias_correction1 = 1 - std::pow(beta1, step); + bias_correction2 = 1 - std::pow(beta2, step); + } + + // Assume single type across p,g,m1,m2 now + DISPATCH_DOUBLE_FLOAT_AND_HALF( + tensor_lists[0][0].scalar_type(), 0, "adam", + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + AdamFunctor(), + beta1, + beta2, + bias_correction1, + bias_correction2, + epsilon, + lr, + (adamMode_t) mode, + weight_decay); ) + + AT_CUDA_CHECK(cudaGetLastError()); + +} diff --git a/apex/csrc/multi_tensor_apply.cuh b/apex/csrc/multi_tensor_apply.cuh new file mode 100644 index 0000000000000000000000000000000000000000..d06c222fd34e5d72bb08a89e4db32d8a5dc18605 --- /dev/null +++ b/apex/csrc/multi_tensor_apply.cuh @@ -0,0 +1,133 @@ +#include +#include +#include +#include +#include +#include "compat.h" + +#include + +// #include + +// This header is the one-stop shop for all your multi-tensor apply needs. + + +// TODO: Kernel arg size limit may be <4KB for some other cards (ie Jetson) +constexpr int depth_to_max_tensors[5] = {110, 64, 48, 36, 30}; +constexpr int depth_to_max_blocks[5] = {320, 320, 320, 320, 320}; + +template struct TensorListMetadata +{ + void* addresses[n][depth_to_max_tensors[n-1]]; + int sizes[depth_to_max_tensors[n-1]]; + unsigned char block_to_tensor[depth_to_max_blocks[n-1]]; + int block_to_chunk[depth_to_max_blocks[n-1]]; // I fear this needs to be a full int. + int start_tensor_this_launch; +}; + + +template +__global__ void multi_tensor_apply_kernel( + int chunk_size, + volatile int* noop_flag, + T tl, + U callable, + ArgTypes... args) +{ + // Hand the chunk information to the user-supplied functor to process however it likes. + callable(chunk_size, noop_flag, tl, args...); +} + +template +void multi_tensor_apply( + int block_size, + int chunk_size, + const at::Tensor& noop_flag, + const std::vector>& tensor_lists, + T callable, + ArgTypes... args) +{ + TORCH_CHECK(tensor_lists.size() == depth, "tensor_lists.size() != depth"); + int len0 = tensor_lists[0].size(); + TORCH_CHECK(len0 > 0, "tensor_lists[0].size() is not > 0"); + auto ref_device = tensor_lists[0][0].device(); + TORCH_CHECK(ref_device.type() == at::kCUDA, "expected input to be on cuda"); + for (int l = 0; l < tensor_lists.size(); l++) // No range-based for because I need indices + { + TORCH_CHECK(tensor_lists[l].size() == len0, "Size mismatch among tensor lists"); + for(int t = 0; t < tensor_lists[l].size(); t++) + { + // TODO: Print which tensor fails. + bool contiguous_memory = tensor_lists[l][t].is_contiguous(); +#ifdef VERSION_GE_1_5 + contiguous_memory = (contiguous_memory || tensor_lists[l][t].is_contiguous(at::MemoryFormat::ChannelsLast)); +#endif + TORCH_CHECK(contiguous_memory, "A tensor was not contiguous."); + TORCH_CHECK(tensor_lists[l][t].device() == ref_device, "A tensor was not on the same device as the first tensor"); + TORCH_CHECK(tensor_lists[l][t].numel() == tensor_lists[0][t].numel(), "Size mismatch"); + } + } + + int ntensors = tensor_lists[0].size(); + + TensorListMetadata tl; + + const at::cuda::OptionalCUDAGuard device_guard(device_of(tensor_lists[0][0])); + auto stream = at::cuda::getCurrentCUDAStream(); + + tl.start_tensor_this_launch = 0; + int loc_block_info = 0; + int loc_tensor_info = 0; + for(int t = 0; t < ntensors; t++) + { + tl.sizes[loc_tensor_info] = tensor_lists[0][t].numel(); + for(int d = 0; d < depth; d++) + tl.addresses[d][loc_tensor_info] = tensor_lists[d][t].data_ptr(); + loc_tensor_info++; + + int chunks_this_tensor = (tensor_lists[0][t].numel() + chunk_size - 1)/chunk_size; + + for(int chunk = 0; chunk < chunks_this_tensor; chunk++) + { + // std::cout << chunks_this_tensor << std::endl; + tl.block_to_tensor[loc_block_info] = loc_tensor_info - 1; + tl.block_to_chunk[loc_block_info] = chunk; + loc_block_info++; + + bool tensors_full = (loc_tensor_info == depth_to_max_tensors[depth-1] && + chunk == chunks_this_tensor - 1); + bool blocks_full = (loc_block_info == depth_to_max_blocks[depth-1]); + bool last_chunk = (t == ntensors - 1 && chunk == chunks_this_tensor - 1); + if(tensors_full || blocks_full || last_chunk) + { + // using accscalar_t = acc_type; + multi_tensor_apply_kernel<<>>( + chunk_size, + noop_flag.DATA_PTR(), + tl, + callable, + args...); + + AT_CUDA_CHECK(cudaGetLastError()); + + // Reset. The control flow possibilities here make my brain hurt. + loc_block_info = 0; + if(chunk == chunks_this_tensor - 1) + { + // std::cout << "Hit case 1 " << cond1 << " " << cond2 << " " << cond3 << std::endl; + loc_tensor_info = 0; + tl.start_tensor_this_launch = t + 1; + } + else + { + // std::cout << "Hit case 2 " << cond1 << " " << cond2 << " " << cond3 << std::endl; + tl.sizes[0] = tl.sizes[loc_tensor_info-1]; + for(int d = 0; d < depth; d++) + tl.addresses[d][0] = tl.addresses[d][loc_tensor_info-1]; + loc_tensor_info = 1; + tl.start_tensor_this_launch = t; + } + } + } + } +} diff --git a/apex/csrc/multi_tensor_axpby_kernel.cu b/apex/csrc/multi_tensor_axpby_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..021df27d705eeaa644170445516a43ce325b2560 --- /dev/null +++ b/apex/csrc/multi_tensor_axpby_kernel.cu @@ -0,0 +1,157 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +template +struct AxpbyFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<3>& tl, + float a, + float b, + int arg_to_check) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + x_t* x = (x_t*)tl.addresses[0][tensor_loc]; + x += chunk_idx*chunk_size; + + y_t* y = (y_t*)tl.addresses[1][tensor_loc]; + y += chunk_idx*chunk_size; + + out_t* out = (out_t*)tl.addresses[2][tensor_loc]; + out += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + bool finite = true; + x_t r_x[ILP]; + y_t r_y[ILP]; + out_t r_out[ILP]; + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && chunk_size % ILP == 0 && is_aligned(x) && is_aligned(y) && is_aligned(out)) + { + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(r_x, x, 0 , i_start); + load_store(r_y, y, 0 , i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_out[ii] = a*static_cast(r_x[ii]) + b*static_cast(r_y[ii]); + if(arg_to_check == -1) + finite = finite && (isfinite(r_x[ii]) && isfinite(r_y[ii])); + if(arg_to_check == 0) + finite = finite && isfinite(r_x[ii]); + if(arg_to_check == 1) + finite = finite && isfinite(r_y[ii]); + } + // store + load_store(out, r_out, i_start , 0); + } + } + else + { + // Non-divergent exit condition for __syncthreads, not necessary here + for(int i_start = 0; i_start < n && i_start < chunk_size; i_start += blockDim.x*ILP) + { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_x[ii] = 0; + r_y[ii] = 0; + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_x[ii] = x[i]; + r_y[ii] = y[i]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_out[ii] = a*static_cast(r_x[ii]) + b*static_cast(r_y[ii]); + if(arg_to_check == -1) + finite = finite && (isfinite(r_x[ii]) && isfinite(r_y[ii])); + if(arg_to_check == 0) + finite = finite && isfinite(r_x[ii]); + if(arg_to_check == 1) + finite = finite && isfinite(r_y[ii]); + } + // see note in multi_tensor_scale_kernel.cu +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + out[i] = r_out[ii]; + } + } + } + if(!finite) + *noop_gmem = 1; // Blindly fire off a write. These will race but that's ok. + } +}; + +void multi_tensor_axpby_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + float a, + float b, + int arg_to_check) +{ + using namespace at; + // The output (downscaled) type is always float. + // If build times suffer, think about where to put this dispatch, + // and what logic should be moved out of multi_tensor_apply. + + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "multi_tensor_axpby_cuda", + DISPATCH_FLOAT_AND_HALF(tensor_lists[1][0].scalar_type(), 1, "multi_tensor_axpby_cuda", + DISPATCH_FLOAT_AND_HALF(tensor_lists[2][0].scalar_type(), 2, "multi_tensor_axpby_cuda", + multi_tensor_apply<3>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + AxpbyFunctor(), + a, + b, + arg_to_check); ))) + + AT_CUDA_CHECK(cudaGetLastError()); + + // AT_CUDA_CHECK(cudaDeviceSynchronize()); +} diff --git a/apex/csrc/multi_tensor_l2norm_kernel.cu b/apex/csrc/multi_tensor_l2norm_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..2bf615e949ff130f4718edb12c1a3aac510cd514 --- /dev/null +++ b/apex/csrc/multi_tensor_l2norm_kernel.cu @@ -0,0 +1,448 @@ +#include +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +template +struct L2NormFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<1>& tl, + float* output, + float* output_per_tensor, + bool per_tensor, + int max_chunks_per_tensor) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + x_t* x = (x_t*)tl.addresses[0][tensor_loc]; + x += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + __shared__ float s_vals[512]; + + float vals[ILP]; // = {0}; // this probably works too but I want to be sure... + x_t r_x[ILP]; + for(int i = 0; i < ILP; i++) + { + vals[i] = 0.f; + r_x[i] = 0; + } + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && chunk_size % ILP == 0 && is_aligned(x)) + { + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(r_x, x, 0 , i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + float next = static_cast(r_x[ii]); + vals[ii] += next*next; + } + } + } + else + { + for(int i_start = 0; i_start < n && i_start < chunk_size; i_start += blockDim.x*ILP) + { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + float next = static_cast(x[i]); + vals[ii] += next*next; + } + } + } + } + + float val = 0.f; + for(int i = 0; i < ILP; i++) + val += vals[i]; + + float final = reduce_block_into_lanes(s_vals, val); + + if(threadIdx.x == 0) + { + if(!isfinite(final)) + *noop_gmem = 1; // Blindly fire off a write. These will race but that's ok. + output[blockIdx.x] += final; + if(per_tensor) + output_per_tensor[(tl.start_tensor_this_launch + tensor_loc)*max_chunks_per_tensor + chunk_idx] = final; + } + } +}; + +// Probably better to template, but since we are not likely to support other norm +template +struct MaxNormFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<1>& tl, + float* output, + float* output_per_tensor, + bool per_tensor, + int max_chunks_per_tensor) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + x_t* x = (x_t*)tl.addresses[0][tensor_loc]; + x += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + __shared__ float s_vals[512]; + + float vals[ILP]; // = {0}; // this probably works too but I want to be sure... + x_t r_x[ILP]; + for(int i = 0; i < ILP; i++) + { + vals[i] = 0.f; + r_x[i] = 0; + } + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && chunk_size % ILP == 0 && is_aligned(x)) + { + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(r_x, x, 0 , i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + float next = static_cast(r_x[ii]); + vals[ii] = fmaxf(fabsf(vals[ii]), fabsf(next)); + } + } + } + else + { + for(int i_start = 0; i_start < n && i_start < chunk_size; i_start += blockDim.x*ILP) + { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + float next = static_cast(x[i]); + vals[ii] = fmaxf(fabsf(vals[ii]), fabsf(next)); + } + } + } + } + + float val = 0.f; + for(int i = 0; i < ILP; i++) + val = fmaxf(fabsf(val), fabsf(vals[i])); + + float final = reduce_block_into_lanes_max_op(s_vals, val); + + if(threadIdx.x == 0) + { + if(!isfinite(final)) + *noop_gmem = 1; // Blindly fire off a write. These will race but that's ok. + output[blockIdx.x] = fmaxf(fabsf(output[blockIdx.x]), fabsf(final)); + if(per_tensor) + output_per_tensor[(tl.start_tensor_this_launch + tensor_loc)*max_chunks_per_tensor + chunk_idx] = final; + } + } +}; + + +__global__ void cleanup( + float* output, + float* output_per_tensor, + float* ret, + float* ret_per_tensor, + bool per_tensor, + int max_chunks_per_tensor) +{ + __shared__ float vals[512]; + + if(blockIdx.x == 0) + { + float val = 0; + if(threadIdx.x < 320) + val = output[threadIdx.x]; + + float final = reduce_block_into_lanes(vals, val); + + if(threadIdx.x == 0) + *ret = sqrt(final); + } + + if(per_tensor) + { + float* output_this_tensor = output_per_tensor + blockIdx.x*max_chunks_per_tensor; + + float val = 0; + for(int i = threadIdx.x; i < max_chunks_per_tensor; i += blockDim.x) + val += output_this_tensor[i]; + + float final = reduce_block_into_lanes(vals, val); + + if(threadIdx.x == 0) + ret_per_tensor[blockIdx.x] = sqrt(final); + } +} + +__global__ void cleanup_v2( + float* output, + float* output_per_tensor, + float* ret, + float* ret_per_tensor, + bool per_tensor, + int max_chunks_per_tensor, + int norm_type, + float alpha, + float beta) +{ + __shared__ float vals[512]; + + if(blockIdx.x == 0) + { + float val = 0; + if(threadIdx.x < 320) + val = output[threadIdx.x]; + + if (norm_type == 0) { + float final = reduce_block_into_lanes_max_op(vals, val); + if(threadIdx.x == 0) + *ret = alpha * (*ret) + beta * final; + } + else { + float final = reduce_block_into_lanes(vals, val); + if(threadIdx.x == 0) + *ret = sqrt(alpha * (*ret) * (*ret) + beta * final); + } + } + + if(per_tensor) + { + float* output_this_tensor = output_per_tensor + blockIdx.x*max_chunks_per_tensor; + + if (norm_type == 0) { + float val = 0; + for(int i = threadIdx.x; i < max_chunks_per_tensor; i += blockDim.x) + val = fmaxf(fabsf(val), fabsf(output_this_tensor[i])); + + float final = reduce_block_into_lanes_max_op(vals, val); + + if(threadIdx.x == 0) + ret_per_tensor[blockIdx.x] = alpha * ret_per_tensor[blockIdx.x] + beta * final; + } + else { + float val = 0; + for(int i = threadIdx.x; i < max_chunks_per_tensor; i += blockDim.x) + val += output_this_tensor[i]; + + float final = reduce_block_into_lanes(vals, val); + + if(threadIdx.x == 0) + ret_per_tensor[blockIdx.x] = sqrt(alpha * ret_per_tensor[blockIdx.x] * ret_per_tensor[blockIdx.x] + beta * final); + } + } +} + +std::tuple multi_tensor_l2norm_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::optional per_tensor_python) +{ + bool per_tensor = per_tensor_python.has_value() ? per_tensor_python.value() : false; + + auto float_options = tensor_lists[0][0].options().dtype(at::kFloat); + auto output = at::zeros({320}, float_options); + + at::Tensor output_per_tensor; + at::Tensor ret_per_tensor; + + int ntensors = tensor_lists[0].size(); + int max_chunks_per_tensor = -1; + + if(per_tensor) + { + for(int t = 0; t < ntensors; t++) + { + int max_chunks_this_tensor = (tensor_lists[0][t].numel() + chunk_size - 1)/chunk_size; + if(max_chunks_this_tensor > max_chunks_per_tensor) + max_chunks_per_tensor = max_chunks_this_tensor; + } + output_per_tensor = at::zeros({ntensors*max_chunks_per_tensor}, float_options); + ret_per_tensor = at::empty({ntensors}, float_options); + } + else + { + ret_per_tensor = at::empty({0}, float_options); + } + + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "multi_tensor_l2norm_cuda", + multi_tensor_apply<1>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + L2NormFunctor(), + output.DATA_PTR(), + per_tensor ? output_per_tensor.DATA_PTR() : nullptr, + per_tensor, + max_chunks_per_tensor);) + + AT_CUDA_CHECK(cudaGetLastError()); + // AT_CUDA_CHECK(cudaDeviceSynchronize()); + + // This involves one more small kernel launches, but will be negligible end to end. + // I could get rid of these by hacking the functor + multi tensor harness with persistence + // logic, but keeping it simple for now + auto ret = at::empty({1}, output.options()); + const at::cuda::OptionalCUDAGuard device_guard(device_of(output)); + auto stream = at::cuda::getCurrentCUDAStream(); + cleanup<<>>( + output.DATA_PTR(), + per_tensor ? output_per_tensor.DATA_PTR() : nullptr, + ret.DATA_PTR(), + per_tensor ? ret_per_tensor.DATA_PTR() : nullptr, + per_tensor, + max_chunks_per_tensor); + + return std::tuple(ret, ret_per_tensor); +} + + +// Compute and update grad norm +// Here use a per tensor norm, and blend new norm(n) and old norm(gn) by +// L-2: gn = sqrt(a * gn^2 + b * n^2) +// L-inf: gn = a * gn + b * n +void multi_tensor_norm_out_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor out, + const float alpha, + const float beta, + const int norm_type) +{ + auto float_options = tensor_lists[0][0].options().dtype(at::kFloat); + TORCH_CHECK(tensor_lists[0][0].device() == noop_flag.device(), "noop flag should be on the same device as tensors"); + // we don't need global thus uses empty here + auto output = at::empty({320}, float_options); + + at::Tensor output_per_tensor; + at::Tensor ret_per_tensor; + + int ntensors = tensor_lists[0].size(); + int max_chunks_per_tensor = -1; + + for(int t = 0; t < ntensors; t++) + { + int max_chunks_this_tensor = (tensor_lists[0][t].numel() + chunk_size - 1)/chunk_size; + if(max_chunks_this_tensor > max_chunks_per_tensor) + max_chunks_per_tensor = max_chunks_this_tensor; + } + + // Although it is single write then read, still need to be zero + // Since tailing element also participate cleanup + output_per_tensor = at::zeros({ntensors*max_chunks_per_tensor}, float_options); + + if (norm_type == 0) { + DISPATCH_FLOAT_AND_HALF( + tensor_lists[0][0].scalar_type(), 0, "multi_tensor_maxnorm_cuda", + multi_tensor_apply<1>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + MaxNormFunctor(), + output.DATA_PTR(), + output_per_tensor.DATA_PTR(), + true, + max_chunks_per_tensor);) + } + else { + DISPATCH_FLOAT_AND_HALF( + tensor_lists[0][0].scalar_type(), 0, "multi_tensor_l2norm_cuda", + multi_tensor_apply<1>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + L2NormFunctor(), + output.DATA_PTR(), + output_per_tensor.DATA_PTR(), + true, + max_chunks_per_tensor);) + } + AT_CUDA_CHECK(cudaGetLastError()); + + // AT_CUDA_CHECK(cudaDeviceSynchronize()); + + // This involves one more small kernel launches, but will be negligible end to end. + // I could get rid of these by hacking the functor + multi tensor harness with persistence + // logic, but keeping it simple for now + auto ret = at::empty({1}, output.options()); + + // Adding the following device guard since it happens sometimes that the + // tensors are on one device and the cuda stream is on another device which + // results in ILLEGAL MEM ACCESS error. + const at::cuda::OptionalCUDAGuard device_guard(device_of(output)); + auto stream = at::cuda::getCurrentCUDAStream(); + cleanup_v2<<>>( + output.DATA_PTR(), + output_per_tensor.DATA_PTR(), + ret.DATA_PTR(), + out.DATA_PTR(), + true, + max_chunks_per_tensor, + norm_type, + alpha, + beta); + + return ; +} diff --git a/apex/csrc/multi_tensor_lamb.cu b/apex/csrc/multi_tensor_lamb.cu new file mode 100644 index 0000000000000000000000000000000000000000..3137fcd215e4056e3d2013486e1f23cf3a662f79 --- /dev/null +++ b/apex/csrc/multi_tensor_lamb.cu @@ -0,0 +1,413 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +typedef enum{ + MOMENT_MODE_0 =0, // L2 regularization mode + MOMENT_MODE_1 =1 // Decoupled weight decay mode +} adamMode_t; + +std::tuple multi_tensor_l2norm_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::optional per_tensor_python); + +using MATH_T = float; + +template +struct LAMBStage1Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<4>& tl, + const float beta1, + const float beta2, + const float beta3, + const float beta1_correction, + const float beta2_correction, + const float epsilon, + adamMode_t mode, + const float decay, + const float* global_grad_norm, + const float max_global_grad_norm) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + float clipped_global_grad_norm = (*global_grad_norm) > max_global_grad_norm ? (*global_grad_norm) / max_global_grad_norm : 1.0f; + + T* g = (T*)tl.addresses[0][tensor_loc]; + g += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + T* m = (T*)tl.addresses[2][tensor_loc]; + m += chunk_idx*chunk_size; + + T* v = (T*)tl.addresses[3][tensor_loc]; + v += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; + MATH_T r_v[ILP]; + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && + chunk_size % ILP == 0 && + is_aligned(g) && + is_aligned(p) && + is_aligned(m) && + is_aligned(v)) + { + T l_g[ILP]; + T l_p[ILP]; + T l_m[ILP]; + T l_v[ILP]; + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(l_g, g, 0, i_start); + if (decay != 0) + load_store(l_p, p, 0, i_start); + load_store(l_m, m, 0, i_start); + load_store(l_v, v, 0, i_start); + // unpack +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_g[ii] = l_g[ii]; + if (decay == 0) { + r_p[ii] = MATH_T(0); + } + else { + r_p[ii] = l_p[ii]; + } + r_m[ii] = l_m[ii]; + r_v[ii] = l_v[ii]; + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if (mode == MOMENT_MODE_0) { + MATH_T scaled_grad = r_g[ii] / clipped_global_grad_norm; + // L2 on scaled grad + scaled_grad = scaled_grad + decay*r_p[ii]; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = next_m_unbiased / denom; + } + else { + MATH_T scaled_grad = r_g[ii] / clipped_global_grad_norm; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = (next_m_unbiased/denom) + (decay*r_p[ii]); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + l_p[ii] = r_p[ii]; + l_m[ii] = r_m[ii]; + l_v[ii] = r_v[ii]; + } + // store + load_store(g, l_p, i_start, 0); + load_store(m, l_m, i_start, 0); + load_store(v, l_v, i_start, 0); + } + } + else + { + // see note in multi_tensor_scale_kernel.cu + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; + MATH_T r_v[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_g[ii] = g[i]; + // special ?optimization? for lamb stage 1 + if (decay == 0) { + r_p[ii] = MATH_T(0); + } + else { + r_p[ii] = p[i]; + } + r_m[ii] = m[i]; + r_v[ii] = v[i]; + } else { + r_g[ii] = MATH_T(0); + r_p[ii] = MATH_T(0); + r_m[ii] = MATH_T(0); + r_v[ii] = MATH_T(0); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if (mode == MOMENT_MODE_0) { + MATH_T scaled_grad = r_g[ii] / clipped_global_grad_norm; + // L2 on scaled grad + scaled_grad = scaled_grad + decay*r_p[ii]; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = next_m_unbiased / denom; + } + else { + MATH_T scaled_grad = r_g[ii] / clipped_global_grad_norm; + r_m[ii] = r_m[ii] * beta1 + beta3 * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = r_v[ii] / beta2_correction; + MATH_T denom = sqrtf(next_v_unbiased) + epsilon; + r_p[ii] = (next_m_unbiased/denom) + (decay*r_p[ii]); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + g[i] = r_p[ii]; + m[i] = r_m[ii]; + v[i] = r_v[ii]; + } + } + } + } + } +}; + +// Step 2 reads in 'update' value and per-tensor param_norm and update_norm. +// It computes new parameter value. +template +struct LAMBStage2Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<2>& tl, + const float* per_tensor_param_norm, + const float* per_tensor_update_norm, + const float learning_rate, + const float decay, + bool use_nvlamb) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + MATH_T ratio = learning_rate; + // nvlamb: apply adaptive learning rate to all parameters + // otherwise, only apply to those with non-zero weight decay + if (use_nvlamb || (decay != 0.0)) + { + float param_norm = per_tensor_param_norm[tensor_num]; + float update_norm = per_tensor_update_norm[tensor_num]; + ratio = (update_norm != 0.0f && param_norm != 0.0f) ? learning_rate * (param_norm / update_norm) : learning_rate; + } + + T* update = (T*)tl.addresses[0][tensor_loc]; + update += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && + chunk_size % ILP == 0 && + is_aligned(p) && + is_aligned(update)) + { + T r_p[ILP]; + T r_update[ILP]; + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(r_p, p, 0, i_start); + load_store(r_update, update, 0, i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_p[ii] = static_cast(r_p[ii]) - (ratio * static_cast(r_update[ii])); + } + load_store(p, r_p, i_start, 0); + } + } + else + { + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_p[ILP]; + MATH_T r_update[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_p[ii] = p[i]; + r_update[ii] = update[i]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_p[ii] = r_p[ii] - (ratio * r_update[ii]); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + p[i] = r_p[ii]; + } + } + } + } + } +}; + + +void multi_tensor_lamb_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int bias_correction, + const float weight_decay, + const int grad_averaging, + const int mode, + at::Tensor global_grad_norm, + const float max_grad_norm, + at::optional use_nvlamb_python) +{ + using namespace at; + // Master weight and 32bit momentum(potentially changing) is not handled by this + // So we assume every tensor are all in the same type + + bool use_nvlamb = use_nvlamb_python.has_value() ? use_nvlamb_python.value() : false; + + // Handle bias correction mode + float bias_correction1 = 1.0f, bias_correction2 = 1.0f; + if (bias_correction == 1) { + bias_correction1 = 1 - std::pow(beta1, step); + bias_correction2 = 1 - std::pow(beta2, step); + } + + // Handle grad averaging mode + float beta3 = 1.0f; + if (grad_averaging == 1) beta3 = 1 - beta1; + + std::vector> grad_list(tensor_lists.begin(), tensor_lists.begin()+1); + std::vector> param_list(tensor_lists.begin()+1, tensor_lists.begin()+2); + + // Compute per tensor param norm + auto param_norm_tuple = multi_tensor_l2norm_cuda(chunk_size, noop_flag, param_list, true); + + // We now in-place modify grad to store update before compute its norm + // Generally this is not a issue since people modify grad in step() method all the time + // We can also grab list of empty tensor to avoid this, but I'd like to save space/cpu code + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "lamb_stage_1", + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + LAMBStage1Functor(), + beta1, + beta2, + beta3, // 1-beta1 or 1 depends on averaging mode + bias_correction1, + bias_correction2, + epsilon, + (adamMode_t) mode, + weight_decay, + global_grad_norm.DATA_PTR(), + max_grad_norm); ) + + // Compute update norms + auto update_norm_tuple = multi_tensor_l2norm_cuda(chunk_size, noop_flag, grad_list, true); + + std::vector> grad_param_list(tensor_lists.begin(), tensor_lists.begin()+2); + + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "lamb_stage_2", + multi_tensor_apply<2>( + BLOCK_SIZE, + chunk_size, + noop_flag, + grad_param_list, + LAMBStage2Functor(), + std::get<1>(param_norm_tuple).DATA_PTR(), + std::get<1>(update_norm_tuple).DATA_PTR(), + lr, + weight_decay, + use_nvlamb); ) + + AT_CUDA_CHECK(cudaGetLastError()); + +} diff --git a/apex/csrc/multi_tensor_lamb_stage_1.cu b/apex/csrc/multi_tensor_lamb_stage_1.cu new file mode 100644 index 0000000000000000000000000000000000000000..6ad7649bc5a4e3bfe4f5e8ae9ad6b22853707ca1 --- /dev/null +++ b/apex/csrc/multi_tensor_lamb_stage_1.cu @@ -0,0 +1,151 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +// Step 1 computes the 'update' value of regular Adam optimizer. +template +struct LAMBStage1Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<5>& tl, + const float* per_tensor_decay, + const float beta1, + const float beta2, + const float beta1_correction, + const float beta2_correction, + const float epsilon, + const float clipped_global_grad_norm) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + float decay = per_tensor_decay[tensor_num]; + + GRAD_T* g = (GRAD_T*)tl.addresses[0][tensor_loc]; + g += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + T* m = (T*)tl.addresses[2][tensor_loc]; + m += chunk_idx*chunk_size; + + T* v = (T*)tl.addresses[3][tensor_loc]; + v += chunk_idx*chunk_size; + + UPD_T* update = (UPD_T*)tl.addresses[4][tensor_loc]; + update += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + // see note in multi_tensor_scale_kernel.cu + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + GRAD_T r_g[ILP]; + T r_p[ILP]; + T r_m[ILP]; + T r_v[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_g[ii] = g[i]; + r_p[ii] = p[i]; + r_m[ii] = m[i]; + r_v[ii] = v[i]; + } else { + r_g[ii] = GRAD_T(0); + r_p[ii] = T(0); + r_m[ii] = T(0); + r_v[ii] = T(0); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + T scaled_grad = r_g[ii] / clipped_global_grad_norm; + r_m[ii] = r_m[ii] * beta1 + (1-beta1) * scaled_grad; + r_v[ii] = r_v[ii] * beta2 + (1-beta2) * scaled_grad * scaled_grad; + T next_m_unbiased = r_m[ii] / beta1_correction; + T next_v_unbiased = r_v[ii] / beta2_correction; + T denom = std::sqrt(next_v_unbiased) + epsilon; + r_p[ii] = (next_m_unbiased/denom) + (decay*r_p[ii]); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + update[i] = (UPD_T)r_p[ii]; + m[i] = r_m[ii]; + v[i] = r_v[ii]; + } + } + } + } +}; + +void multi_tensor_lamb_stage1_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_decay, + const int step, + const float beta1, + const float beta2, + const float epsilon, + at::Tensor global_grad_norm, + const float max_global_grad_norm) +{ + using namespace at; + + const float* g_grad_norm = global_grad_norm.DATA_PTR(); + float clipped_global_grad_norm = *(g_grad_norm) > max_global_grad_norm ? *(g_grad_norm) / max_global_grad_norm : 1.0f; + float next_step = float(step+1); + float beta1_correction = 1.0f - std::pow(beta1, next_step); + float beta2_correction = 1.0f - std::pow(beta2, next_step); + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "lamb_stage_1", + DISPATCH_FLOAT_AND_HALF(tensor_lists[1][0].scalar_type(), 1, "lamb_stage_1", + DISPATCH_FLOAT_AND_HALF(tensor_lists[4][0].scalar_type(), 2, "lamb_stage_1", + multi_tensor_apply<5>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + LAMBStage1Functor(), + per_tensor_decay.DATA_PTR(), + beta1, + beta2, + beta1_correction, + beta2_correction, + epsilon, + clipped_global_grad_norm); ))) + + AT_CUDA_CHECK(cudaGetLastError()); + + // AT_CUDA_CHECK(cudaDeviceSynchronize()); +} diff --git a/apex/csrc/multi_tensor_lamb_stage_2.cu b/apex/csrc/multi_tensor_lamb_stage_2.cu new file mode 100644 index 0000000000000000000000000000000000000000..90970666c73b1740661083bb8afe986c90a968b9 --- /dev/null +++ b/apex/csrc/multi_tensor_lamb_stage_2.cu @@ -0,0 +1,125 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +using MATH_T = float; + +// Step 2 reads in 'update' value and per-tensor param_norm and update_norm. +// It computes new parameter value. +template +struct LAMBStage2Functor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<2>& tl, + const float* per_tensor_param_norm, + const float* per_tensor_update_norm, + const float learning_rate, + const float decay, + bool use_nvlamb) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + MATH_T ratio = learning_rate; + // nvlamb: apply adaptive learning rate to all parameters + // otherwise, only apply to those with non-zero weight decay + if (use_nvlamb || (decay != 0.0)) + { + float param_norm = per_tensor_param_norm[tensor_num]; + float update_norm = per_tensor_update_norm[tensor_num]; + ratio = (update_norm != 0.0f && param_norm != 0.0f) ? learning_rate * (param_norm / update_norm) : learning_rate; + } + + T* p = (T*)tl.addresses[0][tensor_loc]; + p += chunk_idx*chunk_size; + + UPD_T* update = (UPD_T*)tl.addresses[1][tensor_loc]; + update += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + T r_p[ILP]; + UPD_T r_update[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_p[ii] = p[i]; + r_update[ii] = update[i]; + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_p[ii] = r_p[ii] - (ratio*(T)r_update[ii]); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + p[i] = r_p[ii]; + } + } + } + } +}; + +void multi_tensor_lamb_stage2_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor per_tensor_param_norm, + at::Tensor per_tensor_update_norm, + const float lr, + const float weight_decay, + at::optional use_nvlamb_python) +{ + bool use_nvlamb = use_nvlamb_python.has_value() ? use_nvlamb_python.value() : false; + + using namespace at; + + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "lamb_stage_2", + DISPATCH_FLOAT_AND_HALF(tensor_lists[1][0].scalar_type(), 1, "lamb_stage_2", + multi_tensor_apply<2>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + LAMBStage2Functor(), + per_tensor_param_norm.DATA_PTR(), + per_tensor_update_norm.DATA_PTR(), + lr, + weight_decay, + use_nvlamb); )) + + AT_CUDA_CHECK(cudaGetLastError()); + + // AT_CUDA_CHECK(cudaDeviceSynchronize()); +} diff --git a/apex/csrc/multi_tensor_novograd.cu b/apex/csrc/multi_tensor_novograd.cu new file mode 100644 index 0000000000000000000000000000000000000000..2decc06b8c1a56103364a2648d152c9fad08ac22 --- /dev/null +++ b/apex/csrc/multi_tensor_novograd.cu @@ -0,0 +1,188 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +typedef enum{ + MOMENT_MODE_0 =0, // Novograd paper mode, momentum caculation with denom then decay inside + MOMENT_MODE_1 =1 // Decoupled weight decay mode +} momentMode_t; + +void multi_tensor_norm_out_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor out, + const float alpha, + const float beta, + const int norm_type); + +using MATH_T = float; + +template +struct NovoGradFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<3>& tl, + const float beta1, + const float beta2, + const float beta3, + const float beta1_correction, + const float beta2_correction, + const float epsilon, + const float lr, + momentMode_t m_mode, + const float decay, + const float* per_tensor_grad_norm) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int tensor_num = tl.start_tensor_this_launch + tensor_loc; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + float grad_norm = per_tensor_grad_norm[tensor_num]; + + T* g = (T*)tl.addresses[0][tensor_loc]; + g += chunk_idx*chunk_size; + + T* p = (T*)tl.addresses[1][tensor_loc]; + p += chunk_idx*chunk_size; + + T* m = (T*)tl.addresses[2][tensor_loc]; + m += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + // see note in multi_tensor_scale_kernel.cu + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + MATH_T r_g[ILP]; + MATH_T r_p[ILP]; + MATH_T r_m[ILP]; +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + r_g[ii] = g[i]; + r_p[ii] = p[i]; + r_m[ii] = m[i]; + } else { + r_g[ii] = MATH_T(0); + r_p[ii] = MATH_T(0); + r_m[ii] = MATH_T(0); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + if (m_mode == MOMENT_MODE_0) { + MATH_T next_v_unbiased = grad_norm / beta2_correction; + MATH_T denom = next_v_unbiased + epsilon; + r_g[ii] = (r_g[ii] / denom) + (decay * r_p[ii]); + r_m[ii] = beta1 * r_m[ii] + beta3 * r_g[ii]; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + r_p[ii] = r_p[ii] - (lr * next_m_unbiased); + } + else { + r_m[ii] = beta1 * r_m[ii] + beta3 * r_g[ii]; + MATH_T next_m_unbiased = r_m[ii] / beta1_correction; + MATH_T next_v_unbiased = grad_norm / beta2_correction; + MATH_T denom = next_v_unbiased + epsilon; + MATH_T update = (next_m_unbiased / denom) + (decay * r_p[ii]); + r_p[ii] = r_p[ii] - (lr * update); + } + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + p[i] = r_p[ii]; + m[i] = r_m[ii]; + } + } + } + } +}; + +void multi_tensor_novograd_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + at::Tensor grad_norms, + const float lr, + const float beta1, + const float beta2, + const float epsilon, + const int step, + const int bias_correction, + const float weight_decay, + const int grad_averaging, + const int moment_mode, + const int norm_type) +{ + using namespace at; + + // Handle bias correction mode + float bias_correction1 = 1.0f, bias_correction2 = 1.0f; + if (bias_correction == 1) { + bias_correction1 = 1 - std::pow(beta1, step); + bias_correction2 = std::sqrt(1 - std::pow(beta2, step)); + } + + // Handle grad averaging mode + float beta3 = 1; + if (grad_averaging == 1) beta3 = 1 - beta1; + + std::vector> grad_list(tensor_lists.begin(), tensor_lists.begin()+1); + + // Compute and update grad norm + // Here use a per tensor norm, and blend new norm(n) and old norm(gn) by + // L-2: gn = sqrt(a * gn^2 + b * n^2) + // L-inf: gn = a * gn + b * n + multi_tensor_norm_out_cuda(chunk_size, noop_flag, grad_list, grad_norms, beta2, (1.0f - beta2), norm_type); + + // Assume single type across p,g,m1,m2 now + DISPATCH_DOUBLE_FLOAT_AND_HALF( + tensor_lists[0][0].scalar_type(), 0, "novograd", + multi_tensor_apply<3>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + NovoGradFunctor(), + beta1, + beta2, + beta3, // 1-beta1 or 1 depends on averaging mode + bias_correction1, + bias_correction2, + epsilon, + lr, + (momentMode_t) moment_mode, + weight_decay, + grad_norms.DATA_PTR()); ) + + AT_CUDA_CHECK(cudaGetLastError()); + +} diff --git a/apex/csrc/multi_tensor_scale_kernel.cu b/apex/csrc/multi_tensor_scale_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..629ee94207b5419de740ed78719913b29ac6d7e9 --- /dev/null +++ b/apex/csrc/multi_tensor_scale_kernel.cu @@ -0,0 +1,136 @@ +#include +#include +#include +#include +// Another possibility: +// #include + +#include +// Stringstream is a big hammer, but I want to rely on operator<< for dtype. +#include + +#include "type_shim.h" +#include "multi_tensor_apply.cuh" + +#define BLOCK_SIZE 512 +#define ILP 4 + +template +__device__ __forceinline__ bool is_aligned(T* p){ + return ((uint64_t)p) % (ILP*sizeof(T)) == 0; +} + +template +__device__ __forceinline__ void load_store(T* dst, T* src, int dst_offset, int src_offset){ + typedef typename std::aligned_storage::type LT; + ((LT*)dst)[dst_offset] = ((LT*)src)[src_offset]; +} + +template +struct ScaleFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata<2>& tl, + float scale) + { + // I'd like this kernel to propagate infs/nans. + // if(*noop_gmem == 1) + // return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + in_t* in = (in_t*)tl.addresses[0][tensor_loc]; + in += chunk_idx*chunk_size; + + out_t* out = (out_t*)tl.addresses[1][tensor_loc]; + out += chunk_idx*chunk_size; + + n -= chunk_idx*chunk_size; + + bool finite = true; + in_t r_in[ILP]; + out_t r_out[ILP]; + + // to make things simple, we put aligned case in a different code path + if(n % ILP == 0 && chunk_size % ILP == 0 && is_aligned(in) && is_aligned(out)) + { + for(int i_start = threadIdx.x; i_start*ILP < n && i_start*ILP < chunk_size; i_start += blockDim.x) + { + // load + load_store(r_in, in, 0 , i_start); +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_out[ii] = static_cast(r_in[ii]) * scale; + finite = finite && isfinite(r_in[ii]); + } + // store + load_store(out, r_out, i_start, 0); + } + } + else + { + // Non-divergent exit condition for __syncthreads, not necessary here + for(int i_start = 0; i_start < n && i_start < chunk_size; i_start += blockDim.x*ILP) + { +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_in[ii] = 0; + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + r_in[ii] = in[i]; + } + // note for clarification to future michael: + // From a pure memory dependency perspective, there's likely no point unrolling + // the write loop, since writes just fire off once their LDGs arrive. + // Put another way, the STGs are dependent on the LDGs, but not on each other. + // There is still compute ILP benefit from unrolling the loop though. +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + r_out[ii] = static_cast(r_in[ii]) * scale; + finite = finite && isfinite(r_in[ii]); + } +#pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + out[i] = r_out[ii]; + } + } + } + if(!finite) + *noop_gmem = 1; // Blindly fire off a write. These will race but that's ok. + } +}; + +void multi_tensor_scale_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + float scale) +{ + using namespace at; + // The output (downscaled) type is always float. + // If build times suffer, think about where to put this dispatch, + // and what logic should be moved out of multi_tensor_apply. + + DISPATCH_FLOAT_AND_HALF(tensor_lists[0][0].scalar_type(), 0, "multi_tensor_scale_cuda", + DISPATCH_FLOAT_AND_HALF(tensor_lists[1][0].scalar_type(), 1, "multi_tensor_scale_cuda", + multi_tensor_apply<2>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + ScaleFunctor(), + scale); )) + AT_CUDA_CHECK(cudaGetLastError()); + + // AT_CUDA_CHECK(cudaDeviceSynchronize()); +} diff --git a/apex/csrc/multi_tensor_sgd_kernel.cu b/apex/csrc/multi_tensor_sgd_kernel.cu new file mode 100644 index 0000000000000000000000000000000000000000..42a7406be6b3c71c1af9ea566030de2eaa309d97 --- /dev/null +++ b/apex/csrc/multi_tensor_sgd_kernel.cu @@ -0,0 +1,280 @@ +#include +#include +#include +#include +#include "multi_tensor_apply.cuh" +#include "compat.h" + +#include +#include + +#define BLOCK_SIZE 512 +#define ILP 4 + +/** + * Perform fused SGD on multiple buffers + * N: number of tensors + * tl[0] : gradients + * tl[1] : weights + * tl[2] : momentum buffers + * tl[3] : fp16 weights (if appropriate) + * wd : weight_decay (scalar) + * momentum : momentum (scalar) + * dampening : momentum dampening (scalar) + * lr : learning rate (scalar) + * nesterov : enable nesterov (bool) + * first run : necessary for proper momentum handling & init + * wd_after_momentum : apply weight decay _after_ momentum instead of before + **/ +template +struct SGDFunctor +{ + __device__ __forceinline__ void operator()( + int chunk_size, + volatile int* noop_gmem, + TensorListMetadata& tl, + float wd, + float momentum, + float dampening, + float lr, + bool nesterov, + bool first_run, + bool wd_after_momentum, + float scale) + { + // Early exit if we don't need to do anything + if (*noop_gmem) return; + + int tensor_loc = tl.block_to_tensor[blockIdx.x]; + int chunk_idx = tl.block_to_chunk[blockIdx.x]; + int n = tl.sizes[tensor_loc]; + + T_grad* grad_in = (T_grad*)tl.addresses[0][tensor_loc]; + grad_in += chunk_idx*chunk_size; + + T_weight* weight_in = (T_weight*)tl.addresses[1][tensor_loc]; + weight_in += chunk_idx*chunk_size; + + T_weight* mom_in = (T_weight*)tl.addresses[2][tensor_loc]; + mom_in += chunk_idx*chunk_size; + + at::Half *model_weights_out = nullptr; + if(N == 4) + { + model_weights_out = (at::Half*)tl.addresses[3][tensor_loc]; + model_weights_out += chunk_idx*chunk_size; + } + + n -= chunk_idx*chunk_size; + + // Non-divergent exit condition for the __syncthreads + float incoming_grads[ILP]; + float incoming_weights[ILP]; + float incoming_moms[ILP]; + for(int i_start = 0; + i_start < n && i_start < chunk_size; + i_start += blockDim.x*ILP) + { + #pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + incoming_grads[ii] = 0; + incoming_weights[ii] = 0; + incoming_moms[ii] = 0; + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + incoming_grads[ii] = static_cast(grad_in[i])*scale; + incoming_weights[ii] = static_cast(weight_in[i]); + incoming_moms[ii] = static_cast(mom_in[i]); + } + } + + // note for clarification to future michael: + // From a pure memory dependency perspective, there's likely no point unrolling + // the write loop, since writes just fire off once their LDGs arrive. + // Put another way, the STGs are dependent on the LDGs, but not on each other. + // There is still compute ILP benefit from unrolling the loop though. + #pragma unroll + for(int ii = 0; ii < ILP; ii++) + { + int i = i_start + threadIdx.x + ii*blockDim.x; + if(i < n && i < chunk_size) + { + // apply weight decay before momentum if necessary + if(wd != 0.f && !wd_after_momentum) + incoming_grads[ii] += wd * incoming_weights[ii]; + + if(momentum != 0.f) + { + if(!first_run) + incoming_moms[ii] = incoming_moms[ii] * momentum + (1.f - dampening) * incoming_grads[ii]; + else // initialize momentums to current incoming grads + incoming_moms[ii] = incoming_grads[ii]; + + if(nesterov) + incoming_grads[ii] += momentum * incoming_moms[ii]; + else + incoming_grads[ii] = incoming_moms[ii]; + } + + // Apply WD after momentum if desired + if(wd != 0.f && wd_after_momentum) + incoming_grads[ii] += wd * incoming_weights[ii]; + + // adjust the weight and write out + weight_in[i] += (-lr * incoming_grads[ii]); + + // if necessary, write out an fp16 copy of the weights + if(N == 4) + model_weights_out[i] = static_cast(weight_in[i]); + + // also write out the new momentum + if(momentum != 0.f) + mom_in[i] = incoming_moms[ii]; + } + } + } + } +}; + +void multi_tensor_sgd_cuda( + int chunk_size, + at::Tensor noop_flag, + std::vector> tensor_lists, + float wd, + float momentum, + float dampening, + float lr, + bool nesterov, + bool first_run, + bool wd_after_momentum, + float scale) +{ + auto num_tensors = tensor_lists.size(); + auto grad_type = tensor_lists[0][0].scalar_type(); + auto weight_type = tensor_lists[1][0].scalar_type(); + + if(num_tensors == 4) + for(int i = 0; i < tensor_lists[3].size(); i++) + TORCH_CHECK(tensor_lists[3][i].scalar_type() == at::ScalarType::Half, + "Additional output tensors should always be fp16."); + + TORCH_CHECK(noop_flag.device() == tensor_lists[0][0].device(), "expected noop flag to be on the same device as tensors"); + + // We have 3 possibilities to handle here, in terms of + // grad_type, param_type, momentum_type, requires_fp16_copy + // 1. fp16, fp16, fp16, No + // 2. fp32, fp32, fp32, No + // 3. fp16, fp32, fp32, Yes + // 4. fp32, fp32, fp32, Yes // this is the materialize_master_grads=True case + // It's easier to hardcode these possibilities than to use + // switches etc. to handle the cross-product of cases where + // we don't want the majority of them. + + // Case 1. fp16, fp16, fp16, No + if(grad_type == at::ScalarType::Half && + weight_type == at::ScalarType::Half && + num_tensors == 3) + { + multi_tensor_apply<3>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + SGDFunctor<3, at::Half, at::Half>(), + wd, + momentum, + dampening, + lr, + nesterov, + first_run, + wd_after_momentum, + scale); + } + // Case 2. fp16, fp32, fp32, No + // else if (grad_type == at::ScalarType::Half && + // weight_type == at::ScalarType::Float && + // num_tensors == 3) { + // multi_tensor_apply<3>( + // BLOCK_SIZE, + // chunk_size, + // noop_flag, + // tensor_lists, + // SGDFunctor<3, at::Half, float>(), + // wd, + // momentum, + // dampening, + // lr, + // nesterov, + // first_run, + // wd_after_momentum); + // } + // Case 2. fp32, fp32, fp32, No + else if(grad_type == at::ScalarType::Float && + weight_type == at::ScalarType::Float && + num_tensors == 3) + { + multi_tensor_apply<3>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + SGDFunctor<3, float, float>(), + wd, + momentum, + dampening, + lr, + nesterov, + first_run, + wd_after_momentum, + scale); + } + // Case 3. fp16, fp32, fp32, Yes + else if(grad_type == at::ScalarType::Half && + weight_type == at::ScalarType::Float && + num_tensors == 4) + { + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + SGDFunctor<4, at::Half, float>(), + wd, + momentum, + dampening, + lr, + nesterov, + first_run, + wd_after_momentum, + scale); + } + // Case 4. fp32, fp32, fp32, Yes + else if(grad_type == at::ScalarType::Float && + weight_type == at::ScalarType::Float && + num_tensors == 4) + { + multi_tensor_apply<4>( + BLOCK_SIZE, + chunk_size, + noop_flag, + tensor_lists, + SGDFunctor<4, float, float>(), + wd, + momentum, + dampening, + lr, + nesterov, + first_run, + wd_after_momentum, + scale); + } + else + { + AT_ERROR("multi_tensor_sgd only supports some combinations of gradient & weight types. Given: ", + "gradient: ", grad_type, ", weight: ", weight_type, ", num_lists: ", num_tensors); + } + + AT_CUDA_CHECK(cudaGetLastError()); +} diff --git a/apex/csrc/syncbn.cpp b/apex/csrc/syncbn.cpp new file mode 100644 index 0000000000000000000000000000000000000000..578a6e653b84749945db301f61cb6666a17d75af --- /dev/null +++ b/apex/csrc/syncbn.cpp @@ -0,0 +1,109 @@ +#include +#include + +#include + +// returns {mean,biased_var} +// implemented using welford +std::vector welford_mean_var_CUDA(const at::Tensor input); + +// reduces array of mean/var across processes +// returns global {mean,inv_std,biased_var} +// implemented using welford +std::vector welford_parallel_CUDA(const at::Tensor mean_feature_nodes, + const at::Tensor var_biased_feature_nodes, + const at::Tensor numel, + const float eps); + +// elementwise BN operation, returns output +// input/weight/shift should have identical data type; +// mean/inv_std have promoted data type (dtype==fp16?fp32:dtype) +at::Tensor batchnorm_forward_CUDA(const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::optional shift); + +// backward BN operation, returns {sum_dy, sum_dy_xmu, grad_weight, grad_bias} +// grad_output/input should have identical data type; +// mean/inv_std have promoted data type (dtype==fp16?fp32:dtype) +// implemented using kahan summation +std::vector reduce_bn_CUDA(const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight); + +// elementwise backward BN operation, returns grad_input +// grad_output/input/weight precision could be fp16/fp32; +// mean/inv_std/sum_dy/sum_dy_xmu precision is fp32 +at::Tensor batchnorm_backward_CUDA(const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::Tensor sum_dy, + const at::Tensor sum_dy_xmu, + const at::Tensor count); + +// returns {mean, biased_var} +// implemented using welford +// expect data to be in n+c format (channel last) and applies CUDNN_BATCHNORM_SPATIAL +std::vector welford_mean_var_c_last_CUDA(const at::Tensor input); + +// elementwise BN operation, returns output +// input/weight/shift should have identical data type; +// mean/inv_std have promoted data type (dtype==fp16?fp32:dtype) +// expect data to be in n+c format (channel last) and applies CUDNN_BATCHNORM_SPATIAL +at::Tensor batchnorm_forward_c_last_CUDA(const at::Tensor input, + const at::optional z, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::optional shift, + const bool fuse_relu); + +// backward BN operation, returns {sum_dy, sum_dy_xmu, grad_weight, grad_bias} +// grad_output/input should have identical data type; +// mean/inv_std have promoted data type (dtype==fp16?fp32:dtype) +// expect data to be in n+c format (channel last) and applies CUDNN_BATCHNORM_SPATIAL +std::vector reduce_bn_c_last_CUDA(const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight); + +// elementwise backward BN operation, returns grad_input +// grad_output/input/weight precision could be fp16/fp32; +// mean/inv_std/sum_dy/sum_dy_xmu precision is fp32 +// expect data to be in n+c format (channel last) and applies CUDNN_BATCHNORM_SPATIAL +at::Tensor batchnorm_backward_c_last_CUDA(const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::Tensor sum_dy, + const at::Tensor sum_dy_xmu, + const at::Tensor count); + +at::Tensor relu_backward_c_last_CUDA(const at::Tensor grad_output, + const at::Tensor input, + const at::optional z, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::optional shift); + + +PYBIND11_MODULE(TORCH_EXTENSION_NAME, m) { + m.def("welford_mean_var", &welford_mean_var_CUDA, "welford mean variance"); + m.def("welford_parallel", &welford_parallel_CUDA, "welford parallel reduce mean variance"); + m.def("batchnorm_forward", &batchnorm_forward_CUDA, "batchnorm forward"); + m.def("reduce_bn", &reduce_bn_CUDA, "batchnorm backward reduce grad sum and bias/weight grad"); + m.def("batchnorm_backward", &batchnorm_backward_CUDA, "batchnorm backward dgrad"); + m.def("welford_mean_var_c_last", &welford_mean_var_c_last_CUDA, "welford mean variance nhwc"); + m.def("batchnorm_forward_c_last", &batchnorm_forward_c_last_CUDA, "batchnorm forward nhwc"); + m.def("reduce_bn_c_last", &reduce_bn_c_last_CUDA, "batchnorm backwards reduce grad sum and bias/weight grad nhwc"); + m.def("batchnorm_backward_c_last", &batchnorm_backward_c_last_CUDA, "batchnorm backward dgrad nhwc"); + m.def("relu_bw_c_last", &relu_backward_c_last_CUDA, "relu_bw_c_last"); +} diff --git a/apex/csrc/type_shim.h b/apex/csrc/type_shim.h new file mode 100644 index 0000000000000000000000000000000000000000..fc2bb03b99fd22b6dcf558baf84c5c46173744f3 --- /dev/null +++ b/apex/csrc/type_shim.h @@ -0,0 +1,207 @@ +#include +#include "compat.h" + +// Forward/backward compatiblity hack around +// https://github.com/pytorch/pytorch/commit/3aeb78079bcd68282fe9117088e138b77318e288 +// pending more future-proof guidance from upstream. +// struct TypeShim +// { +// const at::Type& payload; +// TypeShim(const at::Type& type) : payload(type) {} +// // Enable trivial conversion to a const at::Type& for pre-3aeb78 +// operator const at::Type&(){ return payload; }; +// // Enable dispatch switch statements to take *this directly for post-3aeb78 +// //operator at::ScalarType(){ return payload.; }; +// }; + +#define DISPATCH_FLOAT_AND_HALF(TYPE, LEVEL, NAME, ...) \ + switch(TYPE) \ + { \ + case at::ScalarType::Float: \ + { \ + using scalar_t_##LEVEL = float; \ + __VA_ARGS__; \ + break; \ + } \ + case at::ScalarType::Half: \ + { \ + using scalar_t_##LEVEL = at::Half; \ + __VA_ARGS__; \ + break; \ + } \ + default: \ + AT_ERROR(#NAME, " not implemented for '", toString(TYPE), "'"); \ + } + + +#define DISPATCH_FLOAT_HALF_AND_BYTE(TYPE, LEVEL, NAME, ...) \ + switch(TYPE) \ + { \ + case at::ScalarType::Float: \ + { \ + using scalar_t_##LEVEL = float; \ + __VA_ARGS__; \ + break; \ + } \ + case at::ScalarType::Half: \ + { \ + using scalar_t_##LEVEL = at::Half; \ + __VA_ARGS__; \ + break; \ + } \ + case at::ScalarType::Byte: \ + { \ + using scalar_t_##LEVEL = uint8_t; \ + __VA_ARGS__; \ + break; \ + } \ + default: \ + AT_ERROR(#NAME, " not implemented for '", toString(TYPE), "'"); \ + } + + +#define DISPATCH_DOUBLE_FLOAT_AND_HALF(TYPE, LEVEL, NAME, ...) \ + switch(TYPE) \ + { \ + case at::ScalarType::Double: \ + { \ + using scalar_t_##LEVEL = double; \ + __VA_ARGS__; \ + break; \ + } \ + case at::ScalarType::Float: \ + { \ + using scalar_t_##LEVEL = float; \ + __VA_ARGS__; \ + break; \ + } \ + case at::ScalarType::Half: \ + { \ + using scalar_t_##LEVEL = at::Half; \ + __VA_ARGS__; \ + break; \ + } \ + default: \ + AT_ERROR(#NAME, " not implemented for '", toString(TYPE), "'"); \ + } + + + #define DISPATCH_DOUBLE_AND_FLOAT(TYPE, LEVEL, NAME, ...) \ + switch(TYPE) \ + { \ + case at::ScalarType::Double: \ + { \ + using scalar_t_##LEVEL = double; \ + __VA_ARGS__; \ + break; \ + } \ + case at::ScalarType::Float: \ + { \ + using scalar_t_##LEVEL = float; \ + __VA_ARGS__; \ + break; \ + } \ + default: \ + AT_ERROR(#NAME, " not implemented for '", toString(TYPE), "'"); \ + } + + +template +__device__ __forceinline__ T reduce_block_into_lanes + (T *x, + T val, + int lanes=1, + bool share_result=false) // lanes is intended to be <= 32. +{ + int tid = threadIdx.x + threadIdx.y*blockDim.x; + int blockSize = blockDim.x*blockDim.y; // blockSize is intended to be a multiple of 32. + + if(blockSize >= 64) + { + x[tid] = val; + __syncthreads(); + } + + #pragma unroll + for(int i = (blockSize >> 1); i >= 64; i >>= 1) + { + if(tid < i) + x[tid] = x[tid] + x[tid+i]; + __syncthreads(); + } + + T final; + + if(tid < 32) + { + if(blockSize >= 64) + final = x[tid] + x[tid+32]; + else + final = val; + // __SYNCWARP(); + + #pragma unroll + for(int i = 16; i >= lanes; i >>= 1) + final = final + __shfl_down_sync(0xffffffff, final, i); + } + + if(share_result) + { + if(tid < lanes) + x[tid] = final; // EpilogueOp + // Make sure the smem result is visible to all warps. + __syncthreads(); + } + + return final; +} + +template +__device__ __forceinline__ T reduce_block_into_lanes_max_op + (T *x, + T val, + int lanes=1, + bool share_result=false) // lanes is intended to be <= 32. +{ + int tid = threadIdx.x + threadIdx.y*blockDim.x; + int blockSize = blockDim.x*blockDim.y; // blockSize is intended to be a multiple of 32. + + if(blockSize >= 64) + { + x[tid] = val; + __syncthreads(); + } + + #pragma unroll + for(int i = (blockSize >> 1); i >= 64; i >>= 1) + { + if(tid < i) + x[tid] = fmaxf(fabsf(x[tid]), fabsf(x[tid+i])); + __syncthreads(); + } + + T final; + + if(tid < 32) + { + if(blockSize >= 64) + final = fmaxf(fabsf(x[tid]), fabsf(x[tid+32])); + else + final = val; + // __SYNCWARP(); + + #pragma unroll + for(int i = 16; i >= lanes; i >>= 1) + final = fmaxf(fabsf(final), fabsf(__shfl_down_sync(0xffffffff, final, i))); + } + + if(share_result) + { + if(tid < lanes) + x[tid] = final; // EpilogueOp + // Make sure the smem result is visible to all warps. + __syncthreads(); + } + + return final; +} diff --git a/apex/csrc/welford.cu b/apex/csrc/welford.cu new file mode 100644 index 0000000000000000000000000000000000000000..374a3845baf8b36e0a4a7f3edbbd6160d00a5f66 --- /dev/null +++ b/apex/csrc/welford.cu @@ -0,0 +1,1510 @@ +#include +#include +#include +#include + +#include +#include + +#include + +#include "type_shim.h" +#include "compat.h" + + +__device__ __forceinline__ int lastpow2(int n) +{ + int out = 1 << (31 - __clz(n)); + if(n == out) + out >>= 1; + return out; +} + +__host__ __forceinline__ int h_next_pow2(unsigned int n) { + n--; + n |= (n >> 1); + n |= (n >> 2); + n |= (n >> 4); + n |= (n >> 8); + n |= (n >> 16); + return ++n; +} + +__host__ __forceinline__ int h_last_pow2(unsigned int n) { + n |= (n >> 1); + n |= (n >> 2); + n |= (n >> 4); + n |= (n >> 8); + n |= (n >> 16); + return n - (n >> 1); +} + + +#define WARP_SIZE 32 + +template +__device__ __forceinline__ T warp_reduce_sum(T val) +{ + #pragma unroll + for(int i = WARP_SIZE/2; i > 0; i >>= 1) + val = val + __shfl_down_sync(0xffffffff, val, i); + return val; +} + +template +__device__ __forceinline__ T reduce_block(T *x, T val) +{ + int tid = threadIdx.y*blockDim.x + threadIdx.x; + int blockSize = blockDim.x * blockDim.y; + + if (blockSize > 32) { + val = warp_reduce_sum(val); + if (tid % WARP_SIZE == 0) + x[tid/WARP_SIZE] = val; + + __syncthreads(); + + val = (tid < blockSize / WARP_SIZE? x[tid%WARP_SIZE] : T(0)); + } + + if(tid/WARP_SIZE==0) val = warp_reduce_sum(val); + + return val; +} + +#define ELEMENTS_PER_ITER 4 // enables concurrency within each thread to hide latency +#define ELEMENTS_PER_THREAD 16 +#define OPTIMAL_TILE_W 32 +#define MAX_H_BLOCK 128 +#define MAX_BLOCK_SIZE 512 + +__host__ int div_ru(int x, int y) { + return h_last_pow2(1 + (x-1)/y); +} + +__host__ void flexible_launch_configs( + const int reduction, + const int stride, + dim3 &block, + dim3 &grid, + const bool coop_flag = false) { + int block_x = std::min(h_last_pow2(stride), OPTIMAL_TILE_W); + int block_y = std::min(h_last_pow2(div_ru(reduction , ELEMENTS_PER_THREAD)), + MAX_BLOCK_SIZE / block_x); + if (block_x * block_y != MAX_BLOCK_SIZE) { + block_x = std::min(h_last_pow2(stride), MAX_BLOCK_SIZE / block_y); + } + + int grid_x = div_ru(stride, block_x); + int grid_y = std::min(div_ru(reduction, block_y * ELEMENTS_PER_THREAD), MAX_H_BLOCK); + if (coop_flag) { + // it's not worth having a grid reduction if the reduction dimension is not big enough + grid_y = grid_y < 8 ? 1 : grid_y; + } + + block.x = block_x; + block.y = block_y; + block.z = 1; + grid.x = grid_x; + grid.y = grid_y; + grid.z = 1; +} + +template +__device__ __forceinline__ void welford_merge_element(C& count, + T& mean, + T& m2n, + const C& num_new, + const T& mean_new, + const T& m2n_new) { + T factor = T(1.0) / max(1, (count + num_new)); + T delta0 = mean - mean_new; + mean = (mean_new * num_new + mean * count) * factor; + m2n += m2n_new + delta0 * delta0 * num_new * count * factor; + count += num_new; +} + +template +__device__ __forceinline__ void warp_reduce_mean_m2n(T &mean, T &m2n, int &num) +{ + #pragma unroll + for(int i = WARP_SIZE/2; i > 0; i >>= 1) { + auto num_new = __shfl_down_sync(0xffffffff, num, i); + auto mean_new = __shfl_down_sync(0xffffffff, mean, i); + auto m2n_new = __shfl_down_sync(0xffffffff, m2n, i); + welford_merge_element(num, mean, m2n, num_new, mean_new, m2n_new); + } +} + +template +__device__ void welford_reduce_mean_m2n( + T* __restrict__ x, + int* __restrict__ count, + T &mean, + T &m2n, + int &num, + int block_size, + int thread_id) +{ + int lane = thread_id % WARP_SIZE; + int wid = thread_id / WARP_SIZE; + + if (block_size > 32) { + warp_reduce_mean_m2n(mean, m2n, num); + if (lane == 0) { + x[wid*2] = mean; + x[wid*2+1] = m2n; + count[wid] = num; + } + __syncthreads(); + + if (wid == 0) { + mean = (thread_id < block_size / WARP_SIZE)? x[lane*2] : T(0); + m2n = (thread_id < block_size / WARP_SIZE)? x[lane*2+1] : T(0); + num = (thread_id < block_size / WARP_SIZE)? count[lane] : int(0); + } + } + + if (wid==0) warp_reduce_mean_m2n(mean, m2n, num); + + return; +} + +// return spatial size for NC+ Tensors +__host__ int get_tensor_spatial_size(const at::Tensor& input) +{ + auto space_size = input.size(2); + for (int i = 3; i < input.ndimension(); i++) { + space_size *= input.size(i); + } + return space_size; +} + +// promote accumulation scalar type. promote half to float. +__host__ at::ScalarType promote_scalartype(const at::Tensor& input) +{ + return input.scalar_type() == at::ScalarType::Half ? + at::ScalarType::Float : input.scalar_type(); +} + +// return single element size, optional accumulation type promotion. +__host__ size_t get_element_data_size(const at::Tensor& input, bool accumulation = false) +{ + auto scalar_type = accumulation ? promote_scalartype(input) : input.scalar_type(); + return at::elementSize(scalar_type); +} + +template +__device__ __forceinline__ void welford_merge_block_vertical(C& count, + T& mean, + T& m2n, + C* shmem_count, + T* shmem_mean, + T* shmem_m2n) { + // write to shared memory + auto address_base = threadIdx.x + threadIdx.y * blockDim.x; + shmem_mean[address_base] = mean; + shmem_m2n[address_base] = m2n; + shmem_count[address_base] = count; + +#pragma unroll + for (int offset = blockDim.y/2; offset > 0; offset >>= 1) { + __syncthreads(); + if (threadIdx.y < offset && threadIdx.y + offset < blockDim.y) { + auto address = address_base + offset * blockDim.x; + // read shared memory back to register for reduction + auto num_new = shmem_count[address]; + auto mean_new = shmem_mean[address]; + auto m2n_new = shmem_m2n[address]; + + welford_merge_element(count, mean, m2n, num_new, mean_new, m2n_new); + + // last write is not necessary + shmem_mean[address_base] = mean; + shmem_m2n[address_base] = m2n; + shmem_count[address_base] = count; + } + } +} + +template +__device__ __forceinline__ void merge_block_vertical(T& sum_dy, + T& sum_dy_xmu, + T* shmem_sum_dy, + T* shmem_sum_dy_xmu) { + // write to shared memory + auto address_base = threadIdx.x + threadIdx.y * blockDim.x; + shmem_sum_dy[address_base] = sum_dy; + shmem_sum_dy_xmu[address_base] = sum_dy_xmu; + +#pragma unroll + for (int offset = blockDim.y/2; offset > 0; offset >>= 1) { + __syncthreads(); + if (threadIdx.y < offset && threadIdx.y + offset < blockDim.y) { + auto address = address_base + offset * blockDim.x; + + sum_dy += shmem_sum_dy[address]; + sum_dy_xmu += shmem_sum_dy_xmu[address]; + + // last write is not necessary + shmem_sum_dy[address_base] = sum_dy; + shmem_sum_dy_xmu[address_base] = sum_dy_xmu; + } + } +} + + +// welford kernel calculating mean/biased_variance/unbiased_variance +template +__global__ void welford_kernel( + const scalar_t* __restrict__ input, + outscalar_t* __restrict__ out_mean, + outscalar_t* __restrict__ out_var_biased, + const int bs, + const int fs, + const int ss) { + int block_size = blockDim.x * blockDim.y; + int count = 0; + accscalar_t x_mean = accscalar_t(0); + accscalar_t m_2_n = accscalar_t(0); + + int thread_id = threadIdx.y*blockDim.x + threadIdx.x; + + for (int batch_id = threadIdx.y; batch_id < bs; batch_id += blockDim.y) { + int input_base = blockIdx.x*ss + batch_id*ss*fs; + // sequential welford + for (int offset = threadIdx.x; offset < ss ; offset += blockDim.x) { + count++; + auto x_n = static_cast(input[offset+input_base]); + auto d = x_n - x_mean; + x_mean += d / count; + m_2_n += d * (x_n - x_mean); + } + } + + static __shared__ int s_mem[160]; + accscalar_t* s_mem_ac = (accscalar_t*) &s_mem[32]; + + welford_reduce_mean_m2n(s_mem_ac, s_mem, x_mean, m_2_n, count, block_size, thread_id); + + if (thread_id == 0) { + out_mean[blockIdx.x] = static_cast(x_mean); + out_var_biased[blockIdx.x] = static_cast(m_2_n/count); + } +} + +// elementwise BN kernel +template +__global__ void batchnorm_forward_kernel( + const scalar_t* __restrict__ input, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + const layerscalar_t* __restrict__ weight, + const layerscalar_t* __restrict__ shift, + scalar_t* __restrict__ out, + const int ss, + const int bs) { + auto m_c = mean[blockIdx.x]; + auto inv_std_c = inv_std[blockIdx.x]; + auto w_c = weight == NULL ? accscalar_t(1.0) : static_cast(weight[blockIdx.x]); + auto s_c = shift == NULL ? accscalar_t(0.0) : static_cast(shift[blockIdx.x]); + + for (int batch_offset = blockIdx.y*blockDim.y + threadIdx.y; batch_offset < bs; batch_offset += gridDim.y*blockDim.y) { + int address_base = blockIdx.x*ss + batch_offset*gridDim.x*ss; + for (int offset = threadIdx.x + blockIdx.z*blockDim.x; offset < ss ; offset+= gridDim.z*blockDim.x) { + out[address_base+offset] = static_cast(w_c * (static_cast(input[address_base+offset]) - m_c ) * inv_std_c + s_c); + } + } +} + +// Backward BN kernel, calculates grad_bias, grad_weight as well as intermediate +// results to calculating grad_input. +// Breaking the grad_input to two step to support sync BN, which requires all +// reduce of the intermediate results across processes. +template +__global__ void reduce_bn_kernel( + const scalar_t* __restrict__ input, + const scalar_t* __restrict__ grad_output, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + accscalar_t* __restrict__ sum_dy_o, + accscalar_t* __restrict__ sum_dy_xmu_o, + layerscalar_t* __restrict__ grad_weight, + layerscalar_t* __restrict__ grad_bias, + const int bs, + const int fs, + const int ss) { + static __shared__ int s_mem[64]; + //int total_item_num = bs * ss; + + int thread_id = threadIdx.y*blockDim.x + threadIdx.x; + + auto r_mean = mean[blockIdx.x]; + auto factor = inv_std[blockIdx.x]; + + // Kahan sum + accscalar_t sum_dy = 0.0; + accscalar_t sum_dy_xmu = 0.0; + accscalar_t sum_dy_c = 0.0; + accscalar_t sum_dy_xmu_c = 0.0; + for (int batch_id = threadIdx.y; batch_id < bs; batch_id += blockDim.y) { + int input_base = blockIdx.x*ss + batch_id*ss*fs; + for (int offset = threadIdx.x; offset < ss ; offset += blockDim.x) { + auto e_grad = static_cast(grad_output[offset+input_base]); + auto e_input = static_cast(input[offset+input_base]); + // calculating sum_dy + auto sum_dy_y = e_grad - sum_dy_c; + auto sum_dy_t = sum_dy + sum_dy_y; + sum_dy_c = (sum_dy_t - sum_dy) - sum_dy_y; + sum_dy = sum_dy_t; + + // calculating sum_dy_xmu + auto sum_dy_xmu_y = e_grad * (e_input - r_mean) - sum_dy_xmu_c; + auto sum_dy_xmu_t = sum_dy_xmu + sum_dy_xmu_y; + sum_dy_xmu_c = (sum_dy_xmu_t - sum_dy_xmu) - sum_dy_xmu_y; + sum_dy_xmu = sum_dy_xmu_t; + } + } + + sum_dy = reduce_block((accscalar_t*)s_mem, sum_dy); + __syncthreads(); + sum_dy_xmu = reduce_block((accscalar_t*)s_mem, sum_dy_xmu); + + if (thread_id == 0) { + if (grad_bias != NULL) { + grad_bias[blockIdx.x] = static_cast(sum_dy); + } + if (grad_weight != NULL) { + grad_weight[blockIdx.x] = static_cast(sum_dy_xmu * factor); + } + //mean_dy[blockIdx.x] = sum_dy / total_item_num; + //mean_dy_xmu[blockIdx.x] = sum_dy_xmu / total_item_num; + sum_dy_o[blockIdx.x] = sum_dy; + sum_dy_xmu_o[blockIdx.x] = sum_dy_xmu; + } +} + +// elementwise backward BN kernel +template +__global__ void batchnorm_backward_kernel( + const scalar_t* __restrict__ grad_output, + const scalar_t* __restrict__ input, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + const layerscalar_t* __restrict__ weight, + const accscalar_t* __restrict__ sum_dy, + const accscalar_t* __restrict__ sum_dy_xmu, + const int* __restrict__ numel, + scalar_t* __restrict__ grad_input, + const int64_t world_size, + const int ss, + const int bs) { + int64_t div = 0; + for (int i = 0; i < world_size; i++) { + div += numel[i]; + } + auto m_c = static_cast(mean[blockIdx.x]); + //auto m_dy_c = static_cast(mean_dy[blockIdx.x]); + auto m_dy_c = static_cast(sum_dy[blockIdx.x]) / div; + auto factor_1_c = inv_std[blockIdx.x]; + auto factor_2_c = (weight == NULL ? accscalar_t(1.0) : static_cast(weight[blockIdx.x])) * factor_1_c; + //factor_1_c = factor_1_c * factor_1_c * mean_dy_xmu[blockIdx.x]; + factor_1_c = factor_1_c * factor_1_c * sum_dy_xmu[blockIdx.x] / div; + + for (int batch_offset = blockIdx.y*blockDim.y+threadIdx.y; batch_offset < bs; batch_offset += gridDim.y*blockDim.y) { + int address_base = blockIdx.x*ss + batch_offset*gridDim.x*ss; + for (int offset = threadIdx.x + blockIdx.z*blockDim.x; offset < ss ; offset+= gridDim.z*blockDim.x) { + grad_input[address_base+offset] = (static_cast(grad_output[address_base+offset]) - m_dy_c - (static_cast(input[address_base+offset]) - m_c) * factor_1_c) * factor_2_c; + } + } +} + +// welford kernel for c last tensor calculating mean/biased_variance/unbiased_variance +template + +__global__ void +welford_kernel_c_last( + const scalar_t* __restrict__ input, + outscalar_t* __restrict__ out_mean, + outscalar_t* __restrict__ out_var_biased, + volatile accscalar_t* staging_data, + int* semaphores, + const int reduction_size, + const int stride) { + // hide latency with concurrency + accscalar_t x_mean[PARALLEL_LOADS]; + accscalar_t m_2_n[PARALLEL_LOADS]; + int count[PARALLEL_LOADS]; + +#pragma unroll + for (int i = 0; i < PARALLEL_LOADS; i++) { + x_mean[i] = accscalar_t(0); + m_2_n[i] = accscalar_t(0); + count[i] = accscalar_t(0); + } + // tensor dimension (m,c) + + // loop along m dimension + int inner_loop_stride = blockDim.y * gridDim.y; + + // offset along m dimension + int m_offset = blockIdx.y * blockDim.y + threadIdx.y; + int c_offset = blockIdx.x * blockDim.x + threadIdx.x; + + int loop_count = 1 + (reduction_size - 1) / (inner_loop_stride * PARALLEL_LOADS); + int address_base = m_offset * stride + c_offset; + int address_increment = inner_loop_stride * stride; + + for (int i = 0; i < loop_count; i++) { + accscalar_t x_math[PARALLEL_LOADS]; + accscalar_t x_count_inv[PARALLEL_LOADS]; + accscalar_t is_valid[PARALLEL_LOADS]; + + // load multiple data in +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + if (c_offset < stride && m_offset < reduction_size) { + x_math[j] = input[address_base]; + count[j]++; + x_count_inv[j] = accscalar_t(1) / count[j]; + is_valid[j] = accscalar_t(1); + } else { + x_math[j] = accscalar_t(0); + x_count_inv[j] = accscalar_t(0); + is_valid[j] = accscalar_t(0); + } + m_offset += inner_loop_stride; + address_base += address_increment; + } + + // calculate mean/m2n with welford +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + accscalar_t delta0 = x_math[j] - x_mean[j]; + x_mean[j] += delta0 * x_count_inv[j]; + accscalar_t delta1 = x_math[j] - x_mean[j]; + m_2_n[j] += delta0 * delta1 * is_valid[j]; + } + } + + // thread reduction to accumulate mean/m_2_n/count between PARALLEL_LOADS +#pragma unroll + for (int j = 1; j < PARALLEL_LOADS; j++) { + welford_merge_element(count[0], x_mean[0], m_2_n[0], count[j], x_mean[j], m_2_n[j]); + } + + // release x_mean / m_2_n + auto mean_th = x_mean[0]; + auto m2_th = m_2_n[0]; + auto count_th = count[0]; + + // block-wise reduction with shared memory (since reduction cannot be done within a warp) + static __shared__ accscalar_t shmem_mean[MAX_BLOCK_SIZE]; + static __shared__ accscalar_t shmem_m2n[MAX_BLOCK_SIZE]; + static __shared__ int shmem_count[MAX_BLOCK_SIZE]; + + welford_merge_block_vertical(count_th, mean_th, m2_th, shmem_count, shmem_mean, shmem_m2n); + + // grid reduction if needed (coop launch used at the first place) + if (gridDim.y > 1) { + volatile accscalar_t* staging_mean = staging_data; + volatile accscalar_t* staging_m2n = &staging_data[stride*gridDim.y]; + volatile int* staging_count = reinterpret_cast(&staging_m2n[stride*gridDim.y]); + + address_base = c_offset + blockIdx.y * stride; + // write data to staging_data; + if (threadIdx.y == 0 && c_offset < stride) { + staging_mean[address_base] = mean_th; + staging_m2n[address_base] = m2_th; + staging_count[address_base] = count_th; + } + + __threadfence(); + __syncthreads(); // ensuring writes to staging_ is visible to all blocks + + __shared__ bool is_last_block_done; + // mark block done + if (threadIdx.x == 0 && threadIdx.y == 0) { + int old = atomicAdd(&semaphores[blockIdx.x], 1); + is_last_block_done = (old == (gridDim.y-1)); + } + + __syncthreads(); + + // check that all data is now available in global memory + if (is_last_block_done) { + count_th = 0; + mean_th = accscalar_t(0.0); + m2_th = accscalar_t(0.0); + + for (int y = threadIdx.y; y < gridDim.y; y += blockDim.y) { + address_base = c_offset + y * stride; + int num_new = c_offset < stride ? staging_count[address_base] : 0; + accscalar_t mean_new = c_offset < stride ? staging_mean[address_base] : accscalar_t(0.0); + accscalar_t m2n_new = c_offset < stride ? staging_m2n[address_base] : accscalar_t(0.0); + + welford_merge_element(count_th, mean_th, m2_th, num_new, mean_new, m2n_new); + } + + welford_merge_block_vertical(count_th, mean_th, m2_th, shmem_count, shmem_mean, shmem_m2n); + if (threadIdx.y == 0 && c_offset < stride) { + out_mean[c_offset] = static_cast(mean_th); + out_var_biased[c_offset] = static_cast(m2_th / count_th); + } + } + } else { + if (blockIdx.y == 0 && threadIdx.y == 0 && c_offset < stride) { + out_mean[c_offset] = static_cast(mean_th); + out_var_biased[c_offset] = static_cast(m2_th / count_th); + } + } +} + +// parallel welford kernel to further reduce mean / biased_var +// into mean / unbiased_var / inv_std across multiple processes. +template +__global__ void welford_kernel_parallel( + const scalar_t* __restrict__ mean, + const scalar_t* __restrict__ var_biased, + const int* __restrict__ numel, + scalar_t* __restrict__ out_mean, + scalar_t* __restrict__ out_var, + scalar_t* __restrict__ inv_std, + const int world_size, + const int feature_size, + const float eps) { + + for (int i = blockIdx.x * blockDim.x + threadIdx.x; i < feature_size; i += gridDim.x * blockDim.x) { + // load data; + int address = i; + scalar_t x_mean = 0; + scalar_t m_2_n = 0; + int count = 0; + for (int j = 0; j < world_size; j++) { + welford_merge_element(count, x_mean, m_2_n, numel[j], mean[address], var_biased[address]*numel[j]); + address += feature_size; + } + out_mean[i] = x_mean; + out_var[i] = m_2_n/ (count - 1); + inv_std[i] = scalar_t(1) / sqrt(m_2_n/count + eps); + } +} + +// elementwise BN kernel +template < + typename scalar_t, + typename accscalar_t, + typename layerscalar_t, + int PARALLEL_LOADS> +__global__ void batchnorm_forward_c_last_kernel( + const scalar_t* __restrict__ input, + const scalar_t* __restrict__ z, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + const layerscalar_t* __restrict__ weight, + const layerscalar_t* __restrict__ shift, + scalar_t* __restrict__ out, + const int reduction_size, + const int stride, + const bool fuse_relu) { + // tensor dimension (m,c) + // loop along m dimension + int inner_loop_stride = blockDim.y * gridDim.y; + + // offset along m dimension + int m_offset = blockIdx.y * blockDim.y + threadIdx.y; + int c_offset = blockIdx.x * blockDim.x + threadIdx.x; + + auto m_c = mean[c_offset]; + auto inv_std_c = static_cast(inv_std[c_offset]); + auto w_c = weight == NULL ? accscalar_t(1.0) : static_cast(weight[c_offset]); + auto s_c = shift == NULL ? accscalar_t(0.0) : static_cast(shift[c_offset]); + + int loop_count = 1 + (reduction_size - 1) / (inner_loop_stride * PARALLEL_LOADS); + int address_base = m_offset * stride + c_offset; + int address_increment = inner_loop_stride * stride; + + for (int i = 0; i < loop_count; i++) { +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + if (c_offset < stride && m_offset < reduction_size) { + auto tmp = w_c * (static_cast(input[address_base]) - m_c ) * inv_std_c + s_c; + if (z != NULL) { + tmp += z[address_base]; + } + out[address_base] = (fuse_relu && tmp <= accscalar_t(0.0) ? scalar_t(0.0) : static_cast(tmp)); + } + m_offset += inner_loop_stride; + address_base += address_increment; + } + } +} + +// elementwise BN kernel +template < + typename scalar_t, + typename accscalar_t, + typename layerscalar_t, + int PARALLEL_LOADS> +__global__ void relu_backward_c_last_kernel( + const scalar_t* __restrict__ grad_output, + const scalar_t* __restrict__ input, + const scalar_t* __restrict__ z, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + const layerscalar_t* __restrict__ weight, + const layerscalar_t* __restrict__ shift, + scalar_t* __restrict__ out, + const int reduction_size, + const int stride) { + // tensor dimension (m,c) + // loop along m dimension + int inner_loop_stride = blockDim.y * gridDim.y; + + // offset along m dimension + int m_offset = blockIdx.y * blockDim.y + threadIdx.y; + int c_offset = blockIdx.x * blockDim.x + threadIdx.x; + + auto m_c = mean[c_offset]; + auto inv_std_c = static_cast(inv_std[c_offset]); + auto w_c = weight == NULL ? accscalar_t(1.0) : static_cast(weight[c_offset]); + auto s_c = shift == NULL ? accscalar_t(0.0) : static_cast(shift[c_offset]); + + int loop_count = 1 + (reduction_size - 1) / (inner_loop_stride * PARALLEL_LOADS); + int address_base = m_offset * stride + c_offset; + int address_increment = inner_loop_stride * stride; + + for (int i = 0; i < loop_count; i++) { +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + if (c_offset < stride && m_offset < reduction_size) { + auto tmp = w_c * (static_cast(input[address_base]) - m_c ) * inv_std_c + s_c; + if (z != NULL) { + tmp += z[address_base]; + } + out[address_base] = (tmp <= accscalar_t(0.0) ? scalar_t(0.0) : grad_output[address_base]); + } + m_offset += inner_loop_stride; + address_base += address_increment; + } + } +} + +// batchnorm backward kernel for c last tensor +template + +__global__ void reduce_bn_c_last_kernel( + const scalar_t* __restrict__ input, + const scalar_t* __restrict__ grad_output, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + accscalar_t* __restrict__ sum_dy_o, + accscalar_t* __restrict__ sum_dy_xmu_o, + layerscalar_t* __restrict__ grad_weight, + layerscalar_t* __restrict__ grad_bias, + volatile accscalar_t* staging_data, + int* semaphores, + const int reduction_size, + const int stride) { + + // hide latency with concurrency + accscalar_t sum_dy[PARALLEL_LOADS]; + accscalar_t sum_dy_xmu[PARALLEL_LOADS]; + +#pragma unroll + for (int i = 0; i < PARALLEL_LOADS; i++) { + sum_dy[i] = accscalar_t(0); + sum_dy_xmu[i] = accscalar_t(0); + } + // tensor dimension (m,c) + + // loop along m dimension + int inner_loop_stride = blockDim.y * gridDim.y; + + // offset along m dimension + int m_offset = blockIdx.y * blockDim.y + threadIdx.y; + int c_offset = blockIdx.x * blockDim.x + threadIdx.x; + + int loop_count = 1 + (reduction_size - 1) / (inner_loop_stride * PARALLEL_LOADS); + int address_base = m_offset * stride + c_offset; + int address_increment = inner_loop_stride * stride; + + auto r_mean = mean[c_offset]; + auto factor = inv_std[c_offset]; + + for (int i = 0; i < loop_count; i++) { + accscalar_t x_input[PARALLEL_LOADS]; + accscalar_t x_grad_output[PARALLEL_LOADS]; + + // load multiple data in +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + if (c_offset < stride && m_offset < reduction_size) { + x_input[j] = input[address_base]; + x_grad_output[j] = grad_output[address_base]; + } else { + x_input[j] = accscalar_t(0); + x_grad_output[j] = accscalar_t(0); + } + m_offset += inner_loop_stride; + address_base += address_increment; + } + + // calculate sum_dy / sum_dy_xmu +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + sum_dy[j] += x_grad_output[j]; + sum_dy_xmu[j] += x_grad_output[j] * (x_input[j] - r_mean); + } + } + + // thread reduction to accumulate sum_dy / sum_dy_xmu between PARALLEL_LOADS +#pragma unroll + for (int j = 1; j < PARALLEL_LOADS; j++) { + sum_dy[0] += sum_dy[j]; + sum_dy_xmu[0] += sum_dy_xmu[j]; + } + + // release array of registers + auto sum_dy_th = sum_dy[0]; + auto sum_dy_xmu_th = sum_dy_xmu[0]; + + // block-wise reduction with shared memory (since reduction cannot be done within a warp) + static __shared__ accscalar_t shmem_sum_dy[MAX_BLOCK_SIZE]; + static __shared__ accscalar_t shmem_sum_dy_xmu[MAX_BLOCK_SIZE]; + + merge_block_vertical(sum_dy_th, sum_dy_xmu_th, shmem_sum_dy, shmem_sum_dy_xmu); + + // grid reduction if needed (coop launch used at the first place) + if (gridDim.y > 1) { + volatile accscalar_t* staging_sum_dy = staging_data; + volatile accscalar_t* staging_sum_dy_xmu = &staging_data[stride*gridDim.y]; + + address_base = c_offset + blockIdx.y * stride; + // write data to staging_data; + if (threadIdx.y == 0 && c_offset < stride) { + staging_sum_dy[address_base] = sum_dy_th; + staging_sum_dy_xmu[address_base] = sum_dy_xmu_th; + } + + __threadfence(); + __syncthreads(); // ensuring writes to staging_ is visible to all blocks + + __shared__ bool is_last_block_done; + // mark block done + if (threadIdx.x == 0 && threadIdx.y == 0) { + int old = atomicAdd(&semaphores[blockIdx.x], 1); + is_last_block_done = (old == (gridDim.y-1)); + } + + __syncthreads(); + + // check that all data is now available in global memory + if (is_last_block_done) { + sum_dy_th = accscalar_t(0.0); + sum_dy_xmu_th = accscalar_t(0.0); + + for (int y = threadIdx.y; y < gridDim.y; y += blockDim.y) { + address_base = c_offset + y * stride; + sum_dy_th += (c_offset < stride ? staging_sum_dy[address_base] : accscalar_t(0.0)); + sum_dy_xmu_th += (c_offset < stride ? staging_sum_dy_xmu[address_base] : accscalar_t(0.0)); + } + + merge_block_vertical(sum_dy_th, sum_dy_xmu_th, shmem_sum_dy, shmem_sum_dy_xmu); + if (threadIdx.y == 0 && c_offset < stride) { + if (grad_bias != NULL) { + grad_bias[c_offset] = static_cast(sum_dy_th); + } + if (grad_weight != NULL) { + grad_weight[c_offset] = static_cast(sum_dy_xmu_th * factor); + } + //mean_dy[c_offset] = sum_dy_th / reduction_size; + //mean_dy_xmu[c_offset] = sum_dy_xmu_th / reduction_size; + sum_dy_o[c_offset] = sum_dy_th; + sum_dy_xmu_o[c_offset] = sum_dy_xmu_th; + } + } + } else { + if (blockIdx.y == 0 && threadIdx.y == 0 && c_offset < stride) { + if (grad_bias != NULL) { + grad_bias[c_offset] = static_cast(sum_dy_th); + } + if (grad_weight != NULL) { + grad_weight[c_offset] = static_cast(sum_dy_xmu_th * factor); + } + //mean_dy[c_offset] = sum_dy_th / reduction_size; + //mean_dy_xmu[c_offset] = sum_dy_xmu_th / reduction_size; + sum_dy_o[c_offset] = sum_dy_th; + sum_dy_xmu_o[c_offset] = sum_dy_xmu_th; + } + } +} + +// elementwise BN kernel +template < + typename scalar_t, + typename accscalar_t, + typename layerscalar_t, + int PARALLEL_LOADS> +__global__ void batchnorm_backward_c_last_kernel( + const scalar_t* __restrict__ grad_output, + const scalar_t* __restrict__ input, + const accscalar_t* __restrict__ mean, + const accscalar_t* __restrict__ inv_std, + const layerscalar_t* __restrict__ weight, + const accscalar_t* __restrict__ sum_dy, + const accscalar_t* __restrict__ sum_dy_xmu, + const int* __restrict__ numel, + scalar_t* __restrict__ grad_input, + const int64_t world_size, + const int reduction_size, + const int stride) { + int64_t div = 0; + for (int i = 0; i < world_size; i++) { + div += numel[i]; + } + // tensor dimension (m,c) + // loop along m dimension + int inner_loop_stride = blockDim.y * gridDim.y; + + // offset along m dimension + int m_offset = blockIdx.y * blockDim.y + threadIdx.y; + int c_offset = blockIdx.x * blockDim.x + threadIdx.x; + + auto m_c = mean[c_offset]; + auto m_dy_c = sum_dy[c_offset] / div; + auto factor_1_c = inv_std[c_offset]; + auto factor_2_c = (weight == NULL? accscalar_t(1.0) : static_cast(weight[c_offset])) * factor_1_c; + factor_1_c = factor_1_c * factor_1_c * sum_dy_xmu[c_offset] / div; + + int loop_count = 1 + (reduction_size - 1) / (inner_loop_stride * PARALLEL_LOADS); + int address_base = m_offset * stride + c_offset; + int address_increment = inner_loop_stride * stride; + + for (int i = 0; i < loop_count; i++) { +#pragma unroll + for (int j = 0; j < PARALLEL_LOADS; j++) { + if (c_offset < stride && m_offset < reduction_size) { + grad_input[address_base] = static_cast( + (static_cast(grad_output[address_base]) - m_dy_c - + (static_cast(input[address_base]) - m_c) * factor_1_c) + * factor_2_c); + } + m_offset += inner_loop_stride; + address_base += address_increment; + } + } +} + +std::vector welford_mean_var_CUDA(const at::Tensor input) { + const auto batch_size = input.size(0); + const auto feature_size = input.size(1); + + auto space_size = get_tensor_spatial_size(input); + auto scalar_type = promote_scalartype(input); + + at::Tensor out_var_biased = at::empty({feature_size}, input.options().dtype(scalar_type)); + at::Tensor out_mean = at::empty({feature_size}, input.options().dtype(scalar_type)); + + int block_y = min(h_last_pow2(batch_size), int(MAX_BLOCK_SIZE / 32)); + int block_x = max(1, min(MAX_BLOCK_SIZE / block_y, h_last_pow2(space_size))); + const dim3 block(block_x, block_y); + const dim3 grid(feature_size); + + auto stream = at::cuda::getCurrentCUDAStream(); + + { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "welford_mean_var_kernel", + using accscalar_t = at::acc_type; + welford_kernel<<>>( + input.DATA_PTR(), + out_mean.DATA_PTR(), + out_var_biased.DATA_PTR(), + batch_size, + feature_size, + space_size); + ); + } + + return {out_mean, out_var_biased}; +} + +at::Tensor batchnorm_forward_CUDA( + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::optional shift) { + const auto batch_size = input.size(0); + const auto feature_size = input.size(1); + at::Tensor out = at::empty_like(input); + + auto space_size = get_tensor_spatial_size(input); + + int block_x = max(32, min(MAX_BLOCK_SIZE, h_last_pow2(space_size)/4)); + int block_y = max(1, min(MAX_BLOCK_SIZE/block_x, h_last_pow2(batch_size)/4)); + const dim3 block(block_x, block_y); + int grid_z = max(1, min(65535, h_last_pow2(space_size)/4/block_x)); + int batch_group_size = max(1, min(65535, h_last_pow2(batch_size)/block_y)); + const dim3 grid(feature_size, batch_group_size, grid_z); + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() && + weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + batchnorm_forward_kernel<<>>( + input.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + shift.has_value() ? shift.value().DATA_PTR() : NULL, + out.DATA_PTR(), + space_size, + batch_size); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + batchnorm_forward_kernel<<>>( + input.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + shift.has_value() ? shift.value().DATA_PTR() : NULL, + out.DATA_PTR(), + space_size, + batch_size); + ); + } + return out; +} + +std::vector reduce_bn_CUDA( + const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight) +{ + const auto batch_size = input.size(0); + const auto feature_size = input.size(1); + + auto scalar_type = promote_scalartype(input); + + at::Tensor sum_dy = at::empty({feature_size}, mean.options()); + at::Tensor sum_dy_xmu = at::empty({feature_size}, mean.options()); + + at::Tensor grad_weight; + at::Tensor grad_bias; + if (weight.has_value()) { + grad_weight = at::empty({feature_size}, weight.value().options()); + grad_bias = at::empty({feature_size}, weight.value().options()); + } else { + grad_weight = at::empty({0}, mean.options()); + grad_bias = at::empty({0}, mean.options()); + } + + auto space_size = get_tensor_spatial_size(input); + + int block_y = min(h_last_pow2(batch_size), int(MAX_BLOCK_SIZE/ 32)); + int block_x = max(1, min(MAX_BLOCK_SIZE/ block_y, h_last_pow2(space_size))); + const dim3 block(block_x, block_y); + const dim3 grid(feature_size); + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() && + weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_backward_reduce", + using accscalar_t = at::acc_type; + reduce_bn_kernel<<>>( + input.DATA_PTR(), + grad_output.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + sum_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + weight.has_value() ? grad_weight.DATA_PTR() : NULL, + weight.has_value() ? grad_bias.DATA_PTR() : NULL, + batch_size, + feature_size, + space_size); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_backward_reduce", + using accscalar_t = at::acc_type; + reduce_bn_kernel<<>>( + input.DATA_PTR(), + grad_output.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + sum_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + weight.has_value() ? grad_weight.DATA_PTR() : NULL, + weight.has_value() ? grad_bias.DATA_PTR() : NULL, + batch_size, + feature_size, + space_size); + ); + } + + return {sum_dy, sum_dy_xmu, grad_weight, grad_bias}; +} + +at::Tensor batchnorm_backward_CUDA( + const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::Tensor sum_dy, + const at::Tensor sum_dy_xmu, + const at::Tensor count) { + const auto batch_size = input.size(0); + const auto feature_size = input.size(1); + + at::Tensor grad_input = at::empty_like(input); + + auto space_size = get_tensor_spatial_size(input); + + int block_x = max(32, min(MAX_BLOCK_SIZE, h_last_pow2(space_size)/4)); + int block_y = max(1, min(MAX_BLOCK_SIZE/block_x, h_last_pow2(batch_size)/4)); + const dim3 block(block_x, block_y); + int grid_z = max(1, min(65535, h_last_pow2(space_size)/4/block_x)); + int batch_group_size = max(1, min(65535, h_last_pow2(batch_size)/block_y)); + const dim3 grid(feature_size, batch_group_size, grid_z); + + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() && + weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_backward", + using accscalar_t = at::acc_type; + batchnorm_backward_kernel<<>>( + grad_output.DATA_PTR(), + input.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + sum_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + count.DATA_PTR(), + grad_input.DATA_PTR(), + count.numel(), + space_size, + batch_size); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_backward", + using accscalar_t = at::acc_type; + batchnorm_backward_kernel<<>>( + grad_output.DATA_PTR(), + input.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + sum_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + count.DATA_PTR(), + grad_input.DATA_PTR(), + count.numel(), + space_size, + batch_size); + ); + } + + return grad_input; +} + +std::vector welford_parallel_CUDA(const at::Tensor mean_feature_nodes, + const at::Tensor var_biased, + const at::Tensor numel, + const float eps) { + const auto world_size = mean_feature_nodes.size(0); + const auto feature_size = mean_feature_nodes.size(1); + + at::Tensor out_var = at::empty({feature_size}, var_biased.options()); + at::Tensor inv_std = at::empty_like(out_var); + at::Tensor out_mean = at::empty_like(out_var); + + at::Tensor mean_feature_nodes_ = mean_feature_nodes.contiguous(); + at::Tensor var_biased_ = var_biased.contiguous(); + at::Tensor numel_ = numel.contiguous(); + + // TODO(jie): tile this for memory coalescing! + const int block = std::min(h_last_pow2(feature_size), MAX_BLOCK_SIZE); + const int grid = std::max(1, feature_size / block); + + auto stream = at::cuda::getCurrentCUDAStream(); + + { + using namespace at; + DISPATCH_FLOAT_AND_HALF(mean_feature_nodes.scalar_type(), 0, "welford_parallel_kernel", + welford_kernel_parallel<<>>( + mean_feature_nodes_.DATA_PTR(), + var_biased_.DATA_PTR(), + numel_.DATA_PTR(), + out_mean.DATA_PTR(), + out_var.DATA_PTR(), + inv_std.DATA_PTR(), + world_size, + feature_size, + eps); + ); + } + + return {out_mean, out_var, inv_std}; +} + +std::vector welford_mean_var_c_last_CUDA(const at::Tensor input) { + const auto stride = input.size(input.ndimension()-1); + const auto reduction_size = input.numel() / stride; + + auto scalar_type = promote_scalartype(input); + auto option = input.options().dtype(scalar_type); + + at::Tensor out_var_biased = at::empty({stride}, option); + at::Tensor out_mean = at::empty({stride}, option); + + dim3 block; + dim3 grid; + flexible_launch_configs(reduction_size, stride, block, grid, true); + + at::Tensor staging_data; + at::Tensor semaphores; + if (grid.y > 1) { + staging_data = at::empty({4*stride*grid.y}, option); + semaphores = at::zeros({grid.x}, input.options().dtype(at::kInt)); + } + + auto stream = at::cuda::getCurrentCUDAStream(); + + { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "welford_mean_var_c_last", + using accscalar_t = at::acc_type; + accscalar_t* staging_data_ptr = grid.y > 1 ? staging_data.DATA_PTR() : nullptr; + int* semaphores_ptr = grid.y > 1 ? semaphores.DATA_PTR() : nullptr; + welford_kernel_c_last + <<>>( + input.DATA_PTR(), + out_mean.DATA_PTR(), + out_var_biased.DATA_PTR(), + staging_data_ptr, + semaphores_ptr, + reduction_size, + stride); + ); + } + + return {out_mean, out_var_biased}; +} + +at::Tensor batchnorm_forward_c_last_CUDA( + const at::Tensor input, + const at::optional z, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::optional shift, + const bool fuse_relu) { + const auto stride = input.size(input.ndimension()-1); + const auto reduction_size = input.numel() / stride; + + at::Tensor out = at::empty_like(input); + + dim3 block; + dim3 grid; + flexible_launch_configs(reduction_size, stride, block, grid); + + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() && weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + batchnorm_forward_c_last_kernel + <<>>( + input.DATA_PTR(), + z.has_value() ? z.value().DATA_PTR() : NULL, + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + shift.has_value() ? shift.value().DATA_PTR(): NULL, + out.DATA_PTR(), + reduction_size, + stride, + fuse_relu); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + batchnorm_forward_c_last_kernel + <<>>( + input.DATA_PTR(), + z.has_value() ? z.value().DATA_PTR() : NULL, + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + shift.has_value() ? shift.value().DATA_PTR(): NULL, + out.DATA_PTR(), + reduction_size, + stride, + fuse_relu); + ); + } + return out; +} + +std::vector reduce_bn_c_last_CUDA( + const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight) { + const auto stride = input.size(input.ndimension()-1); + const auto reduction_size = input.numel() / stride; + + at::Tensor sumn_dy = at::empty({stride}, mean.options()); + at::Tensor sum_dy_xmu = at::empty({stride}, mean.options()); + + at::Tensor grad_weight; + at::Tensor grad_bias; + if (weight.has_value()) { + grad_weight = at::empty({stride}, weight.value().options()); + grad_bias = at::empty({stride}, weight.value().options()); + } else { + // because I cannot return an uninitialized at::Tensor + grad_weight = at::empty({0}, mean.options()); + grad_bias = at::empty({0}, mean.options()); + } + + dim3 block; + dim3 grid; + flexible_launch_configs(reduction_size, stride, block, grid, true); + + at::Tensor staging_data; + at::Tensor semaphores; + if (grid.y > 1) { + staging_data = at::empty({2*stride*grid.y}, mean.options()); + semaphores = at::zeros({grid.x}, input.options().dtype(at::kInt)); + } + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() + && weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_backward_reduce", + using accscalar_t = at::acc_type; + accscalar_t* staging_data_ptr = grid.y > 1 ? staging_data.DATA_PTR() : nullptr; + int* semaphores_ptr = grid.y > 1 ? semaphores.DATA_PTR() : nullptr; + reduce_bn_c_last_kernel + <<>>( + input.DATA_PTR(), + grad_output.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + sumn_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + weight.has_value() ? grad_weight.DATA_PTR() : NULL, + weight.has_value() ?grad_bias.DATA_PTR() : NULL, + staging_data_ptr, + semaphores_ptr, + reduction_size, + stride); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_backward_reduce", + using accscalar_t = at::acc_type; + accscalar_t* staging_data_ptr = grid.y > 1 ? staging_data.DATA_PTR() : nullptr; + int* semaphores_ptr = grid.y > 1 ? semaphores.DATA_PTR() : nullptr; + reduce_bn_c_last_kernel + <<>>( + input.DATA_PTR(), + grad_output.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + sumn_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + weight.has_value() ? grad_weight.DATA_PTR() : NULL, + weight.has_value() ?grad_bias.DATA_PTR() : NULL, + staging_data_ptr, + semaphores_ptr, + reduction_size, + stride); + ); + } + + return {sumn_dy, sum_dy_xmu, grad_weight, grad_bias}; +} + +at::Tensor batchnorm_backward_c_last_CUDA( + const at::Tensor grad_output, + const at::Tensor input, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::Tensor sum_dy, + const at::Tensor sum_dy_xmu, + const at::Tensor count) { + const auto stride = input.size(input.ndimension()-1); + const auto reduction_size = input.numel() / stride; + + at::Tensor grad_input = at::empty_like(input); + + dim3 block; + dim3 grid; + flexible_launch_configs(reduction_size, stride, block, grid); + + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() && weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + batchnorm_backward_c_last_kernel + <<>>( + grad_output.DATA_PTR(), + input.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + sum_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + count.DATA_PTR(), + grad_input.DATA_PTR(), + count.numel(), + reduction_size, + stride); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + batchnorm_backward_c_last_kernel + <<>>( + grad_output.DATA_PTR(), + input.DATA_PTR(), + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + sum_dy.DATA_PTR(), + sum_dy_xmu.DATA_PTR(), + count.DATA_PTR(), + grad_input.DATA_PTR(), + count.numel(), + reduction_size, + stride); + ); + } + + return grad_input; +} + +at::Tensor relu_backward_c_last_CUDA( + const at::Tensor grad_output, + const at::Tensor input, + const at::optional z, + const at::Tensor mean, + const at::Tensor inv_std, + const at::optional weight, + const at::optional shift) { + + const auto stride = input.size(input.ndimension()-1); + const auto reduction_size = input.numel() / stride; + + at::Tensor out = at::empty_like(input); + + dim3 block; + dim3 grid; + flexible_launch_configs(reduction_size, stride, block, grid); + + auto stream = at::cuda::getCurrentCUDAStream(); + + if (input.scalar_type() == at::ScalarType::Half + && weight.has_value() && weight.value().scalar_type() == at::ScalarType::Float) { + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + relu_backward_c_last_kernel + <<>>( + grad_output.DATA_PTR(), + input.DATA_PTR(), + z.has_value() ? z.value().DATA_PTR() : NULL, + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + shift.has_value() ? shift.value().DATA_PTR(): NULL, + out.DATA_PTR(), + reduction_size, + stride); + ); + } else { + if (weight.has_value()) { + TORCH_CHECK(input.scalar_type() == weight.value().scalar_type(), + "input.scalar_type() is not supported with weight.scalar_type()"); + } + using namespace at; + DISPATCH_FLOAT_AND_HALF(input.scalar_type(), 0, "batchnorm_forward", + using accscalar_t = at::acc_type; + relu_backward_c_last_kernel + <<>>( + grad_output.DATA_PTR(), + input.DATA_PTR(), + z.has_value() ? z.value().DATA_PTR() : NULL, + mean.DATA_PTR(), + inv_std.DATA_PTR(), + weight.has_value() ? weight.value().DATA_PTR() : NULL, + shift.has_value() ? shift.value().DATA_PTR(): NULL, + out.DATA_PTR(), + reduction_size, + stride); + ); + } + return out; +} diff --git a/apex/docs/Makefile b/apex/docs/Makefile new file mode 100644 index 0000000000000000000000000000000000000000..86cc24948dc35ad46b0b574003f71e234a30325a --- /dev/null +++ b/apex/docs/Makefile @@ -0,0 +1,32 @@ +# Minimal makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +SPHINXPROJ = NVIDIAAPEX +SOURCEDIR = source +BUILDDIR = build + +# Put it first so that "make" without argument is like "make help". +help: + @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + +gh-pages: + git checkout gh-pages + rm -rf build + rm -rf source + git checkout master -- . + make html + rm -rf ../_modules ../_sources ../_static + mv -fv build/html/* ../ + rm -rf build + git add -A + git commit -m "Generated gh-pages for `git log master -1 --pretty=short --abbrev-commit`" && git push origin gh-pages ; git checkout master + +.PHONY: help Makefile + +# Catch-all target: route all unknown targets to Sphinx using the new +# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). +%: Makefile + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/apex/docs/source/_static/css/pytorch_theme.css b/apex/docs/source/_static/css/pytorch_theme.css new file mode 100644 index 0000000000000000000000000000000000000000..45e984c905662d6d8497e78c46dbfbc7b1b100c5 --- /dev/null +++ b/apex/docs/source/_static/css/pytorch_theme.css @@ -0,0 +1,118 @@ +body { + font-family: "Lato","proxima-nova","Helvetica Neue",Arial,sans-serif; +} + +/* Default header fonts are ugly */ +h1, h2, .rst-content .toctree-wrapper p.caption, h3, h4, h5, h6, legend, p.caption { + font-family: "Lato","proxima-nova","Helvetica Neue",Arial,sans-serif; +} + +/* Use white for docs background */ +.wy-side-nav-search { + background-color: #fff; +} + +.wy-nav-content-wrap, .wy-menu li.current > a { + background-color: #fff; +} + +@media screen and (min-width: 1400px) { + .wy-nav-content-wrap { + background-color: rgba(0, 0, 0, 0.0470588); + } + + .wy-nav-content { + background-color: #fff; + } +} + +/* Fixes for mobile */ +.wy-nav-top { + background-color: #fff; + background-image: url('../img/apex.jpg'); + background-repeat: no-repeat; + background-position: center; + padding: 0; + margin: 0.4045em 0.809em; + color: #333; +} + +.wy-nav-top > a { + display: none; +} + +@media screen and (max-width: 768px) { + .wy-side-nav-search>a img.logo { + height: 60px; + } +} + +/* This is needed to ensure that logo above search scales properly */ +.wy-side-nav-search a { + display: block; +} + +/* This ensures that multiple constructors will remain in separate lines. */ +.rst-content dl:not(.docutils) dt { + display: table; +} + +/* Use our red for literals (it's very similar to the original color) */ +.rst-content tt.literal, .rst-content tt.literal, .rst-content code.literal { + color: #F05732; +} + +.rst-content tt.xref, a .rst-content tt, .rst-content tt.xref, +.rst-content code.xref, a .rst-content tt, a .rst-content code { + color: #404040; +} + +/* Change link colors (except for the menu) */ + +a { + color: #F05732; +} + +a:hover { + color: #F05732; +} + + +a:visited { + color: #D44D2C; +} + +.wy-menu a { + color: #b3b3b3; +} + +.wy-menu a:hover { + color: #b3b3b3; +} + +/* Default footer text is quite big */ +footer { + font-size: 80%; +} + +footer .rst-footer-buttons { + font-size: 125%; /* revert footer settings - 1/80% = 125% */ +} + +footer p { + font-size: 100%; +} + +/* For hidden headers that appear in TOC tree */ +/* see http://stackoverflow.com/a/32363545/3343043 */ +.rst-content .hidden-section { + display: none; +} + +nav .hidden-section { + display: inherit; +} + +.wy-side-nav-search>div.version { + color: #000; +} diff --git a/apex/docs/source/_static/img/nv-pytorch2.png b/apex/docs/source/_static/img/nv-pytorch2.png new file mode 100644 index 0000000000000000000000000000000000000000..ec271659989d396649c0f2bc1e84871c875d43db --- /dev/null +++ b/apex/docs/source/_static/img/nv-pytorch2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ce4da328a1dc0a1e675a94c96663a4993e5a2b393e50c124c540fd4d0032c2ae +size 6502 diff --git a/apex/docs/source/_templates/layout.html b/apex/docs/source/_templates/layout.html new file mode 100644 index 0000000000000000000000000000000000000000..63dfed9c94218f6fa646724a1842f44772213050 --- /dev/null +++ b/apex/docs/source/_templates/layout.html @@ -0,0 +1,51 @@ +{% extends "!layout.html" %} + {% block sidebartitle %} {{ super() }} + + + {% endblock %} + + {% block footer %} {{ super() }} + + + {% endblock %} diff --git a/apex/docs/source/advanced.rst b/apex/docs/source/advanced.rst new file mode 100644 index 0000000000000000000000000000000000000000..d6623e626138c94d6f8c0af207a4a2f96b67f793 --- /dev/null +++ b/apex/docs/source/advanced.rst @@ -0,0 +1,219 @@ +.. role:: hidden + :class: hidden-section + +Advanced Amp Usage +=================================== + +GANs +---- + +GANs are an interesting synthesis of several topics below. A `comprehensive example`_ +is under construction. + +.. _`comprehensive example`: + https://github.com/NVIDIA/apex/tree/master/examples/dcgan + +Gradient clipping +----------------- +Amp calls the params owned directly by the optimizer's ``param_groups`` the "master params." + +These master params may be fully or partially distinct from ``model.parameters()``. +For example, with `opt_level="O2"`_, ``amp.initialize`` casts most model params to FP16, +creates an FP32 master param outside the model for each newly-FP16 model param, +and updates the optimizer's ``param_groups`` to point to these FP32 params. + +The master params owned by the optimizer's ``param_groups`` may also fully coincide with the +model params, which is typically true for ``opt_level``\s ``O0``, ``O1``, and ``O3``. + +In all cases, correct practice is to clip the gradients of the params that are guaranteed to be +owned **by the optimizer's** ``param_groups``, instead of those retrieved via ``model.parameters()``. + +Also, if Amp uses loss scaling, gradients must be clipped after they have been unscaled +(which occurs during exit from the ``amp.scale_loss`` context manager). + +The following pattern should be correct for any ``opt_level``:: + + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + # Gradients are unscaled during context manager exit. + # Now it's safe to clip. Replace + # torch.nn.utils.clip_grad_norm_(model.parameters(), max_norm) + # with + torch.nn.utils.clip_grad_norm_(amp.master_params(optimizer), max_norm) + # or + torch.nn.utils.clip_grad_value_(amp.master_params(optimizer), max_) + +Note the use of the utility function ``amp.master_params(optimizer)``, +which returns a generator-expression that iterates over the +params in the optimizer's ``param_groups``. + +Also note that ``clip_grad_norm_(amp.master_params(optimizer), max_norm)`` is invoked +*instead of*, not *in addition to*, ``clip_grad_norm_(model.parameters(), max_norm)``. + +.. _`opt_level="O2"`: + https://nvidia.github.io/apex/amp.html#o2-fast-mixed-precision + +Custom/user-defined autograd functions +-------------------------------------- + +The old Amp API for `registering user functions`_ is still considered correct. Functions must +be registered before calling ``amp.initialize``. + +.. _`registering user functions`: + https://github.com/NVIDIA/apex/tree/master/apex/amp#annotating-user-functions + +Forcing particular layers/functions to a desired type +----------------------------------------------------- + +I'm still working on a generalizable exposure for this that won't require user-side code divergence +across different ``opt-level``\ s. + +Multiple models/optimizers/losses +--------------------------------- + +Initialization with multiple models/optimizers +********************************************** + +``amp.initialize``'s optimizer argument may be a single optimizer or a list of optimizers, +as long as the output you accept has the same type. +Similarly, the ``model`` argument may be a single model or a list of models, as long as the accepted +output matches. The following calls are all legal:: + + model, optim = amp.initialize(model, optim,...) + model, [optim0, optim1] = amp.initialize(model, [optim0, optim1],...) + [model0, model1], optim = amp.initialize([model0, model1], optim,...) + [model0, model1], [optim0, optim1] = amp.initialize([model0, model1], [optim0, optim1],...) + +Backward passes with multiple optimizers +**************************************** + +Whenever you invoke a backward pass, the ``amp.scale_loss`` context manager must receive +**all the optimizers that own any params for which the current backward pass is creating gradients.** +This is true even if each optimizer owns only some, but not all, of the params that are about to +receive gradients. + +If, for a given backward pass, there's only one optimizer whose params are about to receive gradients, +you may pass that optimizer directly to ``amp.scale_loss``. Otherwise, you must pass the +list of optimizers whose params are about to receive gradients. Example with 3 losses and 2 optimizers:: + + # loss0 accumulates gradients only into params owned by optim0: + with amp.scale_loss(loss0, optim0) as scaled_loss: + scaled_loss.backward() + + # loss1 accumulates gradients only into params owned by optim1: + with amp.scale_loss(loss1, optim1) as scaled_loss: + scaled_loss.backward() + + # loss2 accumulates gradients into some params owned by optim0 + # and some params owned by optim1 + with amp.scale_loss(loss2, [optim0, optim1]) as scaled_loss: + scaled_loss.backward() + +Optionally have Amp use a different loss scaler per-loss +******************************************************** + +By default, Amp maintains a single global loss scaler that will be used for all backward passes +(all invocations of ``with amp.scale_loss(...)``). No additional arguments to ``amp.initialize`` +or ``amp.scale_loss`` are required to use the global loss scaler. The code snippets above with +multiple optimizers/backward passes use the single global loss scaler under the hood, +and they should "just work." + +However, you can optionally tell Amp to maintain a loss scaler per-loss, which gives Amp increased +numerical flexibility. This is accomplished by supplying the ``num_losses`` argument to +``amp.initialize`` (which tells Amp how many backward passes you plan to invoke, and therefore +how many loss scalers Amp should create), then supplying the ``loss_id`` argument to each of your +backward passes (which tells Amp the loss scaler to use for this particular backward pass):: + + model, [optim0, optim1] = amp.initialize(model, [optim0, optim1], ..., num_losses=3) + + with amp.scale_loss(loss0, optim0, loss_id=0) as scaled_loss: + scaled_loss.backward() + + with amp.scale_loss(loss1, optim1, loss_id=1) as scaled_loss: + scaled_loss.backward() + + with amp.scale_loss(loss2, [optim0, optim1], loss_id=2) as scaled_loss: + scaled_loss.backward() + +``num_losses`` and ``loss_id``\ s should be specified purely based on the set of +losses/backward passes. The use of multiple optimizers, or association of single or +multiple optimizers with each backward pass, is unrelated. + +Gradient accumulation across iterations +--------------------------------------- + +The following should "just work," and properly accommodate multiple models/optimizers/losses, as well as +gradient clipping via the `instructions above`_:: + + # If your intent is to simulate a larger batch size using gradient accumulation, + # you can divide the loss by the number of accumulation iterations (so that gradients + # will be averaged over that many iterations): + loss = loss/iters_to_accumulate + + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + + # Every iters_to_accumulate iterations, call step() and reset gradients: + if iter%iters_to_accumulate == 0: + # Gradient clipping if desired: + # torch.nn.utils.clip_grad_norm_(amp.master_params(optimizer), max_norm) + optimizer.step() + optimizer.zero_grad() + +As a minor performance optimization, you can pass ``delay_unscale=True`` +to ``amp.scale_loss`` until you're ready to ``step()``. You should only attempt ``delay_unscale=True`` +if you're sure you know what you're doing, because the interaction with gradient clipping and +multiple models/optimizers/losses can become tricky.:: + + if iter%iters_to_accumulate == 0: + # Every iters_to_accumulate iterations, unscale and step + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + optimizer.zero_grad() + else: + # Otherwise, accumulate gradients, don't unscale or step. + with amp.scale_loss(loss, optimizer, delay_unscale=True) as scaled_loss: + scaled_loss.backward() + +.. _`instructions above`: + https://nvidia.github.io/apex/advanced.html#gradient-clipping + +Custom data batch types +----------------------- + +The intention of Amp is that you never need to cast your input data manually, regardless of +``opt_level``. Amp accomplishes this by patching any models' ``forward`` methods to cast +incoming data appropriately for the ``opt_level``. But to cast incoming data, +Amp needs to know how. The patched ``forward`` will recognize and cast floating-point Tensors +(non-floating-point Tensors like IntTensors are not touched) and +Python containers of floating-point Tensors. However, if you wrap your Tensors in a custom class, +the casting logic doesn't know how to drill +through the tough custom shell to access and cast the juicy Tensor meat within. You need to tell +Amp how to cast your custom batch class, by assigning it a ``to`` method that accepts a ``torch.dtype`` +(e.g., ``torch.float16`` or ``torch.float32``) and returns an instance of the custom batch cast to +``dtype``. The patched ``forward`` checks for the presence of your ``to`` method, and will +invoke it with the correct type for the ``opt_level``. + +Example:: + + class CustomData(object): + def __init__(self): + self.tensor = torch.cuda.FloatTensor([1,2,3]) + + def to(self, dtype): + self.tensor = self.tensor.to(dtype) + return self + +.. warning:: + + Amp also forwards numpy ndarrays without casting them. If you send input data as a raw, unwrapped + ndarray, then later use it to create a Tensor within your ``model.forward``, this Tensor's type will + not depend on the ``opt_level``, and may or may not be correct. Users are encouraged to pass + castable data inputs (Tensors, collections of Tensors, or custom classes with a ``to`` method) + wherever possible. + +.. note:: + + Amp does not call ``.cuda()`` on any Tensors for you. Amp assumes that your original script + is already set up to move Tensors from the host to the device as needed. diff --git a/apex/docs/source/amp.rst b/apex/docs/source/amp.rst new file mode 100644 index 0000000000000000000000000000000000000000..4bc140518fc7ca25ff756d19c6c1a79335bfb0d0 --- /dev/null +++ b/apex/docs/source/amp.rst @@ -0,0 +1,288 @@ +.. role:: hidden + :class: hidden-section + +apex.amp +=================================== + +This page documents the updated API for Amp (Automatic Mixed Precision), +a tool to enable Tensor Core-accelerated training in only 3 lines of Python. + +A `runnable, comprehensive Imagenet example`_ demonstrating good practices can be found +on the Github page. + +GANs are a tricky case that many people have requested. A `comprehensive DCGAN example`_ +is under construction. + +If you already implemented Amp based on the instructions below, but it isn't behaving as expected, +please review `Advanced Amp Usage`_ to see if any topics match your use case. If that doesn't help, +`file an issue`_. + +.. _`file an issue`: + https://github.com/NVIDIA/apex/issues + +``opt_level``\ s and Properties +------------------------------- + +Amp allows users to easily experiment with different pure and mixed precision modes. +Commonly-used default modes are chosen by +selecting an "optimization level" or ``opt_level``; each ``opt_level`` establishes a set of +properties that govern Amp's implementation of pure or mixed precision training. +Finer-grained control of how a given ``opt_level`` behaves can be achieved by passing values for +particular properties directly to ``amp.initialize``. These manually specified values +override the defaults established by the ``opt_level``. + +Example:: + + # Declare model and optimizer as usual, with default (FP32) precision + model = torch.nn.Linear(D_in, D_out).cuda() + optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + + # Allow Amp to perform casts as required by the opt_level + model, optimizer = amp.initialize(model, optimizer, opt_level="O1") + ... + # loss.backward() becomes: + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + ... + +Users **should not** manually cast their model or data to ``.half()``, regardless of what ``opt_level`` +or properties are chosen. Amp intends that users start with an existing default (FP32) script, +add the three lines corresponding to the Amp API, and begin training with mixed precision. +Amp can also be disabled, in which case the original script will behave exactly as it used to. +In this way, there's no risk adhering to the Amp API, and a lot of potential performance benefit. + +.. note:: + Because it's never necessary to manually cast your model (aside from the call ``amp.initialize``) + or input data, a script that adheres to the new API + can switch between different ``opt-level``\ s without having to make any other changes. + +.. _`runnable, comprehensive Imagenet example`: + https://github.com/NVIDIA/apex/tree/master/examples/imagenet + +.. _`comprehensive DCGAN example`: + https://github.com/NVIDIA/apex/tree/master/examples/dcgan + +.. _`Advanced Amp Usage`: + https://nvidia.github.io/apex/advanced.html + +Properties +********** + +Currently, the under-the-hood properties that govern pure or mixed precision training are the following: + +- ``cast_model_type``: Casts your model's parameters and buffers to the desired type. +- ``patch_torch_functions``: Patch all Torch functions and Tensor methods to perform Tensor Core-friendly ops like GEMMs and convolutions in FP16, and any ops that benefit from FP32 precision in FP32. +- ``keep_batchnorm_fp32``: To enhance precision and enable cudnn batchnorm (which improves performance), it's often beneficial to keep batchnorm weights in FP32 even if the rest of the model is FP16. +- ``master_weights``: Maintain FP32 master weights to accompany any FP16 model weights. FP32 master weights are stepped by the optimizer to enhance precision and capture small gradients. +- ``loss_scale``: If ``loss_scale`` is a float value, use this value as the static (fixed) loss scale. If ``loss_scale`` is the string ``"dynamic"``, adaptively adjust the loss scale over time. Dynamic loss scale adjustments are performed by Amp automatically. + +Again, you often don't need to specify these properties by hand. Instead, select an ``opt_level``, +which will set them up for you. After selecting an ``opt_level``, you can optionally pass property +kwargs as manual overrides. + +If you attempt to override a property that does not make sense for the selected ``opt_level``, +Amp will raise an error with an explanation. For example, selecting ``opt_level="O1"`` combined with +the override ``master_weights=True`` does not make sense. ``O1`` inserts casts +around Torch functions rather than model weights. Data, activations, and weights are recast +out-of-place on the fly as they flow through patched functions. Therefore, the model weights themselves +can (and should) remain FP32, and there is no need to maintain separate FP32 master weights. + +``opt_level``\ s +**************** + +Recognized ``opt_level``\ s are ``"O0"``, ``"O1"``, ``"O2"``, and ``"O3"``. + +``O0`` and ``O3`` are not true mixed precision, but they are useful for establishing accuracy and +speed baselines, respectively. + +``O1`` and ``O2`` are different implementations of mixed precision. Try both, and see +what gives the best speedup and accuracy for your model. + +``O0``: FP32 training +^^^^^^^^^^^^^^^^^^^^^^ +Your incoming model should be FP32 already, so this is likely a no-op. +``O0`` can be useful to establish an accuracy baseline. + +| Default properties set by ``O0``: +| ``cast_model_type=torch.float32`` +| ``patch_torch_functions=False`` +| ``keep_batchnorm_fp32=None`` (effectively, "not applicable," everything is FP32) +| ``master_weights=False`` +| ``loss_scale=1.0`` +| +| + +``O1``: Mixed Precision (recommended for typical use) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Patch all Torch functions and Tensor methods to cast their inputs according to a whitelist-blacklist +model. Whitelist ops (for example, Tensor Core-friendly ops like GEMMs and convolutions) are performed +in FP16. Blacklist ops that benefit from FP32 precision (for example, softmax) +are performed in FP32. ``O1`` also uses dynamic loss scaling, unless overridden. + +| Default properties set by ``O1``: +| ``cast_model_type=None`` (not applicable) +| ``patch_torch_functions=True`` +| ``keep_batchnorm_fp32=None`` (again, not applicable, all model weights remain FP32) +| ``master_weights=None`` (not applicable, model weights remain FP32) +| ``loss_scale="dynamic"`` +| +| + +``O2``: "Almost FP16" Mixed Precision +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +``O2`` casts the model weights to FP16, +patches the model's ``forward`` method to cast input +data to FP16, keeps batchnorms in FP32, maintains FP32 master weights, +updates the optimizer's ``param_groups`` so that the ``optimizer.step()`` +acts directly on the FP32 weights (followed by FP32 master weight->FP16 model weight +copies if necessary), +and implements dynamic loss scaling (unless overridden). +Unlike ``O1``, ``O2`` does not patch Torch functions or Tensor methods. + +| Default properties set by ``O2``: +| ``cast_model_type=torch.float16`` +| ``patch_torch_functions=False`` +| ``keep_batchnorm_fp32=True`` +| ``master_weights=True`` +| ``loss_scale="dynamic"`` +| +| + +``O3``: FP16 training +^^^^^^^^^^^^^^^^^^^^^^ +``O3`` may not achieve the stability of the true mixed precision options ``O1`` and ``O2``. +However, it can be useful to establish a speed baseline for your model, against which +the performance of ``O1`` and ``O2`` can be compared. If your model uses batch normalization, +to establish "speed of light" you can try ``O3`` with the additional property override +``keep_batchnorm_fp32=True`` (which enables cudnn batchnorm, as stated earlier). + +| Default properties set by ``O3``: +| ``cast_model_type=torch.float16`` +| ``patch_torch_functions=False`` +| ``keep_batchnorm_fp32=False`` +| ``master_weights=False`` +| ``loss_scale=1.0`` +| +| + +Unified API +----------- + +.. automodule:: apex.amp +.. currentmodule:: apex.amp + +.. autofunction:: initialize + +.. autofunction:: scale_loss + +.. autofunction:: master_params + +Checkpointing +------------- + +To properly save and load your amp training, we introduce the ``amp.state_dict()``, which contains all ``loss_scaler``\ s and their corresponding unskipped steps, as well as ``amp.load_state_dict()`` to restore these attributes. + +In order to get bitwise accuracy, we recommend the following workflow:: + + # Initialization + opt_level = 'O1' + model, optimizer = amp.initialize(model, optimizer, opt_level=opt_level) + + # Train your model + ... + + # Save checkpoint + checkpoint = { + 'model': model.state_dict(), + 'optimizer': optimizer.state_dict(), + 'amp': amp.state_dict() + } + torch.save(checkpoint, 'amp_checkpoint.pt') + ... + + # Restore + model = ... + optimizer = ... + checkpoint = torch.load('amp_checkpoint.pt') + + model, optimizer = amp.initialize(model, optimizer, opt_level=opt_level) + model.load_state_dict(checkpoint['model']) + optimizer.load_state_dict(checkpoint['optimizer']) + amp.load_state_dict(checkpoint['amp']) + + # Continue training + ... + +Note that we recommend restoring the model using the same ``opt_level``. Also note that we recommend calling the ``load_state_dict`` methods after ``amp.initialize``. + +Advanced use cases +------------------ + +The unified Amp API supports gradient accumulation across iterations, +multiple backward passes per iteration, multiple models/optimizers, +custom/user-defined autograd functions, and custom data batch classes. Gradient clipping and GANs also +require special treatment, but this treatment does not need to change +for different ``opt_level``\ s. Further details can be found here: + +.. toctree:: + :maxdepth: 1 + + advanced + +Transition guide for old API users +---------------------------------- + +We strongly encourage moving to the new Amp API, because it's more versatile, easier to use, and future proof. The original :class:`FP16_Optimizer` and the old "Amp" API are deprecated, and subject to removal at at any time. + +For users of the old "Amp" API +****************************** + +In the new API, ``opt-level O1`` performs the same patching of the Torch namespace as the old thing +called "Amp." +However, the new API allows static or dynamic loss scaling, while the old API only allowed dynamic loss scaling. + +In the new API, the old call to ``amp_handle = amp.init()``, and the returned ``amp_handle``, are no +longer exposed or necessary. The new ``amp.initialize()`` does the duty of ``amp.init()`` (and more). +Therefore, any existing calls to ``amp_handle = amp.init()`` should be deleted. + +The functions formerly exposed through ``amp_handle`` are now free +functions accessible through the ``amp`` module. + +The backward context manager must be changed accordingly:: + + # old API + with amp_handle.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + -> + # new API + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + +For now, the deprecated "Amp" API documentation can still be found on the Github README: https://github.com/NVIDIA/apex/tree/master/apex/amp. The old API calls that `annotate user functions`_ to run +with a particular precision are still honored by the new API. + +.. _`annotate user functions`: + https://github.com/NVIDIA/apex/tree/master/apex/amp#annotating-user-functions + + +For users of the old FP16_Optimizer +*********************************** + +``opt-level O2`` is equivalent to :class:`FP16_Optimizer` with ``dynamic_loss_scale=True``. +Once again, the backward pass must be changed to the unified version:: + + optimizer.backward(loss) + -> + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + +One annoying aspect of FP16_Optimizer was that the user had to manually convert their model to half +(either by calling ``.half()`` on it, or using a function or module wrapper from +``apex.fp16_utils``), and also manually call ``.half()`` on input data. **Neither of these are +necessary in the new API. No matter what --opt-level +you choose, you can and should simply build your model and pass input data in the default FP32 format.** +The new Amp API will perform the right conversions during +``model, optimizer = amp.initialize(model, optimizer, opt_level=....)`` based on the ``--opt-level`` +and any overridden flags. Floating point input data may be FP32 or FP16, but you may as well just +let it be FP16, because the ``model`` returned by ``amp.initialize`` will have its ``forward`` +method patched to cast the input data appropriately. diff --git a/apex/docs/source/conf.py b/apex/docs/source/conf.py new file mode 100644 index 0000000000000000000000000000000000000000..4477a28e1352c362d8cd66e25409f803c60a8069 --- /dev/null +++ b/apex/docs/source/conf.py @@ -0,0 +1,248 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +# +# PyTorch documentation build configuration file, created by +# sphinx-quickstart on Fri Dec 23 13:31:47 2016. +# +# This file is execfile()d with the current directory set to its +# containing dir. +# +# Note that not all possible configuration values are present in this +# autogenerated file. +# +# All configuration values have a default; values that are commented out +# serve to show the default. + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +# +import os +import sys +sys.path.insert(0, os.path.abspath('.')) +# sys.path.insert(0, os.path.abspath('../../apex/parallel/')) +import apex +# import multiproc +import sphinx_rtd_theme + + +# -- General configuration ------------------------------------------------ + +# If your documentation needs a minimal Sphinx version, state it here. +# +# needs_sphinx = '1.0' + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = [ + 'sphinx.ext.autodoc', + 'sphinx.ext.autosummary', + 'sphinx.ext.doctest', + 'sphinx.ext.intersphinx', + 'sphinx.ext.todo', + 'sphinx.ext.coverage', + 'sphinx.ext.mathjax', + 'sphinx.ext.napoleon', + 'sphinx.ext.viewcode', + 'sphinx.ext.extlinks', +] + +napoleon_use_ivar = True + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# The suffix(es) of source filenames. +# You can specify multiple suffix as a list of string: +# +# source_suffix = ['.rst', '.md'] +source_suffix = '.rst' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +project = 'Apex' +copyright = '2018' +author = 'Christian Sarofeen, Natalia Gimelshein, Michael Carilli, Raul Puri' + +# The version info for the project you're documenting, acts as replacement for +# |version| and |release|, also used in various other places throughout the +# built documents. +# +# The short X.Y version. +# TODO: change to [:2] at v1.0 +# version = 'master (' + torch.__version__ + ' )' +version = '0.1' +# The full version, including alpha/beta/rc tags. +# TODO: verify this works as expected +release = '0.1.0' + +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +# +# This is also used if you do content translation via gettext catalogs. +# Usually you set "language" from the command line for these cases. +language = None + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +# This pattern also affects html_static_path and html_extra_path +exclude_patterns = [] + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'sphinx' + +# If true, `todo` and `todoList` produce output, else they produce nothing. +todo_include_todos = True + + +# -- Options for HTML output ------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +# +html_theme = 'sphinx_rtd_theme' +html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] + +# Theme options are theme-specific and customize the look and feel of a theme +# further. For a list of options available for each theme, see the +# documentation. +# +html_theme_options = { + 'collapse_navigation': False, + 'display_version': True, + 'logo_only': True, +} + +# html_logo = '_static/img/nv-pytorch2.png' + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] + +# html_style_path = 'css/pytorch_theme.css' +html_context = { + 'css_files': [ + 'https://fonts.googleapis.com/css?family=Lato', + '_static/css/pytorch_theme.css' + ], +} + + +# -- Options for HTMLHelp output --------------------------------------------- + +# Output file base name for HTML help builder. +htmlhelp_basename = 'PyTorchdoc' + + +# -- Options for LaTeX output ------------------------------------------------ + +latex_elements = { + # The paper size ('letterpaper' or 'a4paper'). + # + # 'papersize': 'letterpaper', + + # The font size ('10pt', '11pt' or '12pt'). + # + # 'pointsize': '10pt', + + # Additional stuff for the LaTeX preamble. + # + # 'preamble': '', + + # Latex figure (float) alignment + # + # 'figure_align': 'htbp', +} + +# Grouping the document tree into LaTeX files. List of tuples +# (source start file, target name, title, +# author, documentclass [howto, manual, or own class]). +latex_documents = [ + (master_doc, 'apex.tex', 'Apex Documentation', + 'Torch Contributors', 'manual'), +] + + +# -- Options for manual page output ------------------------------------------ + +# One entry per manual page. List of tuples +# (source start file, name, description, authors, manual section). +man_pages = [ + (master_doc, 'Apex', 'Apex Documentation', + [author], 1) +] + + +# -- Options for Texinfo output ---------------------------------------------- + +# Grouping the document tree into Texinfo files. List of tuples +# (source start file, target name, title, author, +# dir menu entry, description, category) +texinfo_documents = [ + (master_doc, 'Apex', 'Apex Documentation', + author, 'Apex', 'One line description of project.', + 'Miscellaneous'), +] + + +# Example configuration for intersphinx: refer to the Python standard library. +intersphinx_mapping = { + 'python': ('https://docs.python.org/', None), + 'numpy': ('http://docs.scipy.org/doc/numpy/', None), +} + +# -- A patch that prevents Sphinx from cross-referencing ivar tags ------- +# See http://stackoverflow.com/a/41184353/3343043 + +from docutils import nodes +from sphinx.util.docfields import TypedField +from sphinx import addnodes + + +def patched_make_field(self, types, domain, items, **kw): + # `kw` catches `env=None` needed for newer sphinx while maintaining + # backwards compatibility when passed along further down! + + # type: (List, unicode, Tuple) -> nodes.field + def handle_item(fieldarg, content): + par = nodes.paragraph() + par += addnodes.literal_strong('', fieldarg) # Patch: this line added + # par.extend(self.make_xrefs(self.rolename, domain, fieldarg, + # addnodes.literal_strong)) + if fieldarg in types: + par += nodes.Text(' (') + # NOTE: using .pop() here to prevent a single type node to be + # inserted twice into the doctree, which leads to + # inconsistencies later when references are resolved + fieldtype = types.pop(fieldarg) + if len(fieldtype) == 1 and isinstance(fieldtype[0], nodes.Text): + typename = u''.join(n.astext() for n in fieldtype) + typename = typename.replace('int', 'python:int') + typename = typename.replace('long', 'python:long') + typename = typename.replace('float', 'python:float') + typename = typename.replace('type', 'python:type') + par.extend(self.make_xrefs(self.typerolename, domain, typename, + addnodes.literal_emphasis, **kw)) + else: + par += fieldtype + par += nodes.Text(')') + par += nodes.Text(' -- ') + par += content + return par + + fieldname = nodes.field_name('', self.label) + if len(items) == 1 and self.can_collapse: + fieldarg, content = items[0] + bodynode = handle_item(fieldarg, content) + else: + bodynode = self.list_type() + for fieldarg, content in items: + bodynode += nodes.list_item('', handle_item(fieldarg, content)) + fieldbody = nodes.field_body('', bodynode) + return nodes.field('', fieldname, fieldbody) + +TypedField.make_field = patched_make_field diff --git a/apex/docs/source/fp16_utils.rst b/apex/docs/source/fp16_utils.rst new file mode 100644 index 0000000000000000000000000000000000000000..b6b3da5f8db9f20b65e2f0f000dde7c59df4af04 --- /dev/null +++ b/apex/docs/source/fp16_utils.rst @@ -0,0 +1,59 @@ +.. role:: hidden + :class: hidden-section + +apex.fp16_utils +=================================== + +This submodule contains utilities designed to streamline the mixed precision training recipe +presented by NVIDIA `on Parallel Forall`_ and in GTC 2018 Sessions +`Training Neural Networks with Mixed Precision: Theory and Practice`_ and +`Training Neural Networks with Mixed Precision: Real Examples`_. +For Pytorch users, Real Examples in particular is recommended. + +Full runnable Python scripts demonstrating ``apex.fp16_utils`` +can be found on the Github page: + +| `Simple FP16_Optimizer demos`_ +| +| `Distributed Mixed Precision Training with imagenet`_ +| +| `Mixed Precision Training with word_language_model`_ +| +| + +.. _`on Parallel Forall`: + https://devblogs.nvidia.com/mixed-precision-training-deep-neural-networks/ +.. _`Training Neural Networks with Mixed Precision: Theory and Practice`: + http://on-demand.gputechconf.com/gtc/2018/video/S8923/ +.. _`Training Neural Networks with Mixed Precision: Real Examples`: + http://on-demand.gputechconf.com/gtc/2018/video/S81012/ +.. _`Simple FP16_Optimizer demos`: + https://github.com/NVIDIA/apex/tree/master/examples/FP16_Optimizer_simple +.. _`Distributed Mixed Precision Training with imagenet`: + https://github.com/NVIDIA/apex/tree/master/examples/imagenet +.. _`Mixed Precision Training with word_language_model`: + https://github.com/NVIDIA/apex/tree/master/examples/word_language_model + +.. automodule:: apex.fp16_utils +.. currentmodule:: apex.fp16_utils + +Automatic management of master params + loss scaling +---------------------------------------------------- + +.. autoclass:: FP16_Optimizer + :members: + +.. autoclass:: LossScaler + :members: + +.. autoclass:: DynamicLossScaler + :members: + +Manual master parameter management +---------------------------------- + +.. autofunction:: prep_param_lists + +.. autofunction:: master_params_to_model_params + +.. autofunction:: model_grads_to_master_grads diff --git a/apex/docs/source/index.rst b/apex/docs/source/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..0ec8f8c644b1f227f2cd2263ad70c1932cca3155 --- /dev/null +++ b/apex/docs/source/index.rst @@ -0,0 +1,54 @@ +.. PyTorch documentation master file, created by + sphinx-quickstart on Fri Dec 23 13:31:47 2016. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +:github_url: https://github.com/nvidia/apex + +Apex (A PyTorch Extension) +=================================== + +This site contains the API documentation for Apex (https://github.com/nvidia/apex), +a Pytorch extension with NVIDIA-maintained utilities to streamline mixed precision and distributed training. Some of the code here will be included in upstream Pytorch eventually. The intention of Apex is to make up-to-date utilities available to users as quickly as possible. + +Installation instructions can be found here: https://github.com/NVIDIA/apex#quick-start. + +Some other useful material, including GTC 2019 and Pytorch DevCon 2019 Slides, can be found here: https://github.com/mcarilli/mixed_precision_references. + +.. toctree:: + :maxdepth: 1 + :caption: AMP: Automatic Mixed Precision + + amp + +.. toctree:: + :maxdepth: 1 + :caption: Distributed Training + + parallel + +.. toctree:: + :maxdepth: 1 + :caption: Fused Optimizers + + optimizers + +.. toctree:: + :maxdepth: 1 + :caption: Fused Layer Norm + + layernorm + +.. .. toctree:: + :maxdepth: 1 + :caption: Deprecated mixed precision API + fp16_util + +.. reparameterization +.. RNN + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` diff --git a/apex/docs/source/layernorm.rst b/apex/docs/source/layernorm.rst new file mode 100644 index 0000000000000000000000000000000000000000..36dcb845b16ca943de1f214496e953e26c2f934c --- /dev/null +++ b/apex/docs/source/layernorm.rst @@ -0,0 +1,14 @@ +.. role:: hidden + :class: hidden-section + +apex.normalization.fused_layer_norm +=================================== + +.. automodule:: apex.normalization +.. currentmodule:: apex.normalization + +.. FusedAdam + ---------- + +.. autoclass:: FusedLayerNorm + :members: diff --git a/apex/docs/source/optimizers.rst b/apex/docs/source/optimizers.rst new file mode 100644 index 0000000000000000000000000000000000000000..407f077053ac6120f2c2476d5b98371b1b7a6d03 --- /dev/null +++ b/apex/docs/source/optimizers.rst @@ -0,0 +1,23 @@ +.. role:: hidden + :class: hidden-section + +apex.optimizers +=================================== + +.. automodule:: apex.optimizers +.. currentmodule:: apex.optimizers + +.. FusedAdam + ---------- + +.. autoclass:: FusedAdam + :members: + +.. autoclass:: FusedLAMB + :members: + +.. autoclass:: FusedNovoGrad + :members: + +.. autoclass:: FusedSGD + :members: diff --git a/apex/docs/source/parallel.rst b/apex/docs/source/parallel.rst new file mode 100644 index 0000000000000000000000000000000000000000..73759eeb90a0d21367fa961495f852ea0c752ab4 --- /dev/null +++ b/apex/docs/source/parallel.rst @@ -0,0 +1,25 @@ +.. role:: hidden + :class: hidden-section + +apex.parallel +=================================== + +.. automodule:: apex.parallel +.. currentmodule:: apex.parallel + +.. DistributedDataParallel + ---------- + +.. autoclass:: DistributedDataParallel + :members: + +.. autoclass:: Reducer + :members: + +.. autoclass:: SyncBatchNorm + :members: + +Utility functions +---------------------------------- + +.. autofunction:: convert_syncbn_model diff --git a/apex/examples/README.md b/apex/examples/README.md new file mode 100644 index 0000000000000000000000000000000000000000..6cb9231813ee4cd36cc6e94ab238dcd2b3ea77ed --- /dev/null +++ b/apex/examples/README.md @@ -0,0 +1,4 @@ +This directory contains examples illustrating Apex mixed precision and distributed tools. + +**Note for users of the pre-unification API**: +`deprecated_api` contains examples illustrating the old (pre-unified) APIs. These APIs will be removed soon, and users are strongly encouraged to switch. The separate mixed precision tools called `Amp` and `FP16_Optimizer` in the old API are exposed via different flags/optimization levels in the new API. diff --git a/apex/examples/dcgan/README.md b/apex/examples/dcgan/README.md new file mode 100644 index 0000000000000000000000000000000000000000..9fc896cb5bfa313afa9fa3f2a6e4e0b5a5195d17 --- /dev/null +++ b/apex/examples/dcgan/README.md @@ -0,0 +1,41 @@ +# Mixed Precision DCGAN Training in PyTorch + +`main_amp.py` is based on [https://github.com/pytorch/examples/tree/master/dcgan](https://github.com/pytorch/examples/tree/master/dcgan). +It implements Automatic Mixed Precision (Amp) training of the DCGAN example for different datasets. Command-line flags forwarded to `amp.initialize` are used to easily manipulate and switch between various pure and mixed precision "optimization levels" or `opt_level`s. For a detailed explanation of `opt_level`s, see the [updated API guide](https://nvidia.github.io/apex/amp.html). + +We introduce these changes to the PyTorch DCGAN example as described in the [Multiple models/optimizers/losses](https://nvidia.github.io/apex/advanced.html#multiple-models-optimizers-losses) section of the documentation:: +``` +# Added after models and optimizers construction +[netD, netG], [optimizerD, optimizerG] = amp.initialize( + [netD, netG], [optimizerD, optimizerG], opt_level=opt.opt_level, num_losses=3) +... +# loss.backward() changed to: +with amp.scale_loss(errD_real, optimizerD, loss_id=0) as errD_real_scaled: + errD_real_scaled.backward() +... +with amp.scale_loss(errD_fake, optimizerD, loss_id=1) as errD_fake_scaled: + errD_fake_scaled.backward() +... +with amp.scale_loss(errG, optimizerG, loss_id=2) as errG_scaled: + errG_scaled.backward() +``` + +Note that we use different `loss_scalers` for each computed loss. +Using a separate loss scaler per loss is [optional, not required](https://nvidia.github.io/apex/advanced.html#optionally-have-amp-use-a-different-loss-scaler-per-loss). + +To improve the numerical stability, we swapped `nn.Sigmoid() + nn.BCELoss()` to `nn.BCEWithLogitsLoss()`. + +With the new Amp API **you never need to explicitly convert your model, or the input data, to half().** + +"Pure FP32" training: +``` +$ python main_amp.py --opt_level O0 +``` +Recommended mixed precision training: +``` +$ python main_amp.py --opt_level O1 +``` + +Have a look at the original [DCGAN example](https://github.com/pytorch/examples/tree/master/dcgan) for more information about the used arguments. + +To enable mixed precision training, we introduce the `--opt_level` argument. diff --git a/apex/examples/dcgan/main_amp.py b/apex/examples/dcgan/main_amp.py new file mode 100644 index 0000000000000000000000000000000000000000..be1a2894fd3336c398b6f72472072ba4fb0848fa --- /dev/null +++ b/apex/examples/dcgan/main_amp.py @@ -0,0 +1,274 @@ +from __future__ import print_function +import argparse +import os +import random +import torch +import torch.nn as nn +import torch.nn.parallel +import torch.backends.cudnn as cudnn +import torch.optim as optim +import torch.utils.data +import torchvision.datasets as dset +import torchvision.transforms as transforms +import torchvision.utils as vutils + +try: + from apex import amp +except ImportError: + raise ImportError("Please install apex from https://www.github.com/nvidia/apex to run this example.") + + +parser = argparse.ArgumentParser() +parser.add_argument('--dataset', default='cifar10', help='cifar10 | lsun | mnist |imagenet | folder | lfw | fake') +parser.add_argument('--dataroot', default='./', help='path to dataset') +parser.add_argument('--workers', type=int, help='number of data loading workers', default=2) +parser.add_argument('--batchSize', type=int, default=64, help='input batch size') +parser.add_argument('--imageSize', type=int, default=64, help='the height / width of the input image to network') +parser.add_argument('--nz', type=int, default=100, help='size of the latent z vector') +parser.add_argument('--ngf', type=int, default=64) +parser.add_argument('--ndf', type=int, default=64) +parser.add_argument('--niter', type=int, default=25, help='number of epochs to train for') +parser.add_argument('--lr', type=float, default=0.0002, help='learning rate, default=0.0002') +parser.add_argument('--beta1', type=float, default=0.5, help='beta1 for adam. default=0.5') +parser.add_argument('--ngpu', type=int, default=1, help='number of GPUs to use') +parser.add_argument('--netG', default='', help="path to netG (to continue training)") +parser.add_argument('--netD', default='', help="path to netD (to continue training)") +parser.add_argument('--outf', default='.', help='folder to output images and model checkpoints') +parser.add_argument('--manualSeed', type=int, help='manual seed') +parser.add_argument('--classes', default='bedroom', help='comma separated list of classes for the lsun data set') +parser.add_argument('--opt_level', default='O1', help='amp opt_level, default="O1"') + +opt = parser.parse_args() +print(opt) + + +try: + os.makedirs(opt.outf) +except OSError: + pass + +if opt.manualSeed is None: + opt.manualSeed = 2809 +print("Random Seed: ", opt.manualSeed) +random.seed(opt.manualSeed) +torch.manual_seed(opt.manualSeed) + +cudnn.benchmark = True + + +if opt.dataset in ['imagenet', 'folder', 'lfw']: + # folder dataset + dataset = dset.ImageFolder(root=opt.dataroot, + transform=transforms.Compose([ + transforms.Resize(opt.imageSize), + transforms.CenterCrop(opt.imageSize), + transforms.ToTensor(), + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)), + ])) + nc=3 +elif opt.dataset == 'lsun': + classes = [ c + '_train' for c in opt.classes.split(',')] + dataset = dset.LSUN(root=opt.dataroot, classes=classes, + transform=transforms.Compose([ + transforms.Resize(opt.imageSize), + transforms.CenterCrop(opt.imageSize), + transforms.ToTensor(), + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)), + ])) + nc=3 +elif opt.dataset == 'cifar10': + dataset = dset.CIFAR10(root=opt.dataroot, download=True, + transform=transforms.Compose([ + transforms.Resize(opt.imageSize), + transforms.ToTensor(), + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)), + ])) + nc=3 + +elif opt.dataset == 'mnist': + dataset = dset.MNIST(root=opt.dataroot, download=True, + transform=transforms.Compose([ + transforms.Resize(opt.imageSize), + transforms.ToTensor(), + transforms.Normalize((0.5,), (0.5,)), + ])) + nc=1 + +elif opt.dataset == 'fake': + dataset = dset.FakeData(image_size=(3, opt.imageSize, opt.imageSize), + transform=transforms.ToTensor()) + nc=3 + +assert dataset +dataloader = torch.utils.data.DataLoader(dataset, batch_size=opt.batchSize, + shuffle=True, num_workers=int(opt.workers)) + +device = torch.device("cuda:0") +ngpu = int(opt.ngpu) +nz = int(opt.nz) +ngf = int(opt.ngf) +ndf = int(opt.ndf) + + +# custom weights initialization called on netG and netD +def weights_init(m): + classname = m.__class__.__name__ + if classname.find('Conv') != -1: + m.weight.data.normal_(0.0, 0.02) + elif classname.find('BatchNorm') != -1: + m.weight.data.normal_(1.0, 0.02) + m.bias.data.fill_(0) + + +class Generator(nn.Module): + def __init__(self, ngpu): + super(Generator, self).__init__() + self.ngpu = ngpu + self.main = nn.Sequential( + # input is Z, going into a convolution + nn.ConvTranspose2d( nz, ngf * 8, 4, 1, 0, bias=False), + nn.BatchNorm2d(ngf * 8), + nn.ReLU(True), + # state size. (ngf*8) x 4 x 4 + nn.ConvTranspose2d(ngf * 8, ngf * 4, 4, 2, 1, bias=False), + nn.BatchNorm2d(ngf * 4), + nn.ReLU(True), + # state size. (ngf*4) x 8 x 8 + nn.ConvTranspose2d(ngf * 4, ngf * 2, 4, 2, 1, bias=False), + nn.BatchNorm2d(ngf * 2), + nn.ReLU(True), + # state size. (ngf*2) x 16 x 16 + nn.ConvTranspose2d(ngf * 2, ngf, 4, 2, 1, bias=False), + nn.BatchNorm2d(ngf), + nn.ReLU(True), + # state size. (ngf) x 32 x 32 + nn.ConvTranspose2d( ngf, nc, 4, 2, 1, bias=False), + nn.Tanh() + # state size. (nc) x 64 x 64 + ) + + def forward(self, input): + if input.is_cuda and self.ngpu > 1: + output = nn.parallel.data_parallel(self.main, input, range(self.ngpu)) + else: + output = self.main(input) + return output + + +netG = Generator(ngpu).to(device) +netG.apply(weights_init) +if opt.netG != '': + netG.load_state_dict(torch.load(opt.netG)) +print(netG) + + +class Discriminator(nn.Module): + def __init__(self, ngpu): + super(Discriminator, self).__init__() + self.ngpu = ngpu + self.main = nn.Sequential( + # input is (nc) x 64 x 64 + nn.Conv2d(nc, ndf, 4, 2, 1, bias=False), + nn.LeakyReLU(0.2, inplace=True), + # state size. (ndf) x 32 x 32 + nn.Conv2d(ndf, ndf * 2, 4, 2, 1, bias=False), + nn.BatchNorm2d(ndf * 2), + nn.LeakyReLU(0.2, inplace=True), + # state size. (ndf*2) x 16 x 16 + nn.Conv2d(ndf * 2, ndf * 4, 4, 2, 1, bias=False), + nn.BatchNorm2d(ndf * 4), + nn.LeakyReLU(0.2, inplace=True), + # state size. (ndf*4) x 8 x 8 + nn.Conv2d(ndf * 4, ndf * 8, 4, 2, 1, bias=False), + nn.BatchNorm2d(ndf * 8), + nn.LeakyReLU(0.2, inplace=True), + # state size. (ndf*8) x 4 x 4 + nn.Conv2d(ndf * 8, 1, 4, 1, 0, bias=False), + ) + + def forward(self, input): + if input.is_cuda and self.ngpu > 1: + output = nn.parallel.data_parallel(self.main, input, range(self.ngpu)) + else: + output = self.main(input) + + return output.view(-1, 1).squeeze(1) + + +netD = Discriminator(ngpu).to(device) +netD.apply(weights_init) +if opt.netD != '': + netD.load_state_dict(torch.load(opt.netD)) +print(netD) + +criterion = nn.BCEWithLogitsLoss() + +fixed_noise = torch.randn(opt.batchSize, nz, 1, 1, device=device) +real_label = 1 +fake_label = 0 + +# setup optimizer +optimizerD = optim.Adam(netD.parameters(), lr=opt.lr, betas=(opt.beta1, 0.999)) +optimizerG = optim.Adam(netG.parameters(), lr=opt.lr, betas=(opt.beta1, 0.999)) + +[netD, netG], [optimizerD, optimizerG] = amp.initialize( + [netD, netG], [optimizerD, optimizerG], opt_level=opt.opt_level, num_losses=3) + +for epoch in range(opt.niter): + for i, data in enumerate(dataloader, 0): + ############################ + # (1) Update D network: maximize log(D(x)) + log(1 - D(G(z))) + ########################### + # train with real + netD.zero_grad() + real_cpu = data[0].to(device) + batch_size = real_cpu.size(0) + label = torch.full((batch_size,), real_label, device=device) + + output = netD(real_cpu) + errD_real = criterion(output, label) + with amp.scale_loss(errD_real, optimizerD, loss_id=0) as errD_real_scaled: + errD_real_scaled.backward() + D_x = output.mean().item() + + # train with fake + noise = torch.randn(batch_size, nz, 1, 1, device=device) + fake = netG(noise) + label.fill_(fake_label) + output = netD(fake.detach()) + errD_fake = criterion(output, label) + with amp.scale_loss(errD_fake, optimizerD, loss_id=1) as errD_fake_scaled: + errD_fake_scaled.backward() + D_G_z1 = output.mean().item() + errD = errD_real + errD_fake + optimizerD.step() + + ############################ + # (2) Update G network: maximize log(D(G(z))) + ########################### + netG.zero_grad() + label.fill_(real_label) # fake labels are real for generator cost + output = netD(fake) + errG = criterion(output, label) + with amp.scale_loss(errG, optimizerG, loss_id=2) as errG_scaled: + errG_scaled.backward() + D_G_z2 = output.mean().item() + optimizerG.step() + + print('[%d/%d][%d/%d] Loss_D: %.4f Loss_G: %.4f D(x): %.4f D(G(z)): %.4f / %.4f' + % (epoch, opt.niter, i, len(dataloader), + errD.item(), errG.item(), D_x, D_G_z1, D_G_z2)) + if i % 100 == 0: + vutils.save_image(real_cpu, + '%s/real_samples.png' % opt.outf, + normalize=True) + fake = netG(fixed_noise) + vutils.save_image(fake.detach(), + '%s/amp_fake_samples_epoch_%03d.png' % (opt.outf, epoch), + normalize=True) + + # do checkpointing + torch.save(netG.state_dict(), '%s/netG_epoch_%d.pth' % (opt.outf, epoch)) + torch.save(netD.state_dict(), '%s/netD_epoch_%d.pth' % (opt.outf, epoch)) + + diff --git a/apex/examples/docker/Dockerfile b/apex/examples/docker/Dockerfile new file mode 100644 index 0000000000000000000000000000000000000000..47fd422cdd4424cfe4ab45060171743b94b75928 --- /dev/null +++ b/apex/examples/docker/Dockerfile @@ -0,0 +1,16 @@ +# Base image must at least have pytorch and CUDA installed. +ARG BASE_IMAGE=nvcr.io/nvidia/pytorch:19.07-py3 +FROM $BASE_IMAGE +ARG BASE_IMAGE +RUN echo "Installing Apex on top of ${BASE_IMAGE}" +# make sure we don't overwrite some existing directory called "apex" +WORKDIR /tmp/unique_for_apex +# uninstall Apex if present, twice to make absolutely sure :) +RUN pip uninstall -y apex || : +RUN pip uninstall -y apex || : +# SHA is something the user can touch to force recreation of this Docker layer, +# and therefore force cloning of the latest version of Apex +RUN SHA=ToUcHMe git clone https://github.com/NVIDIA/apex.git +WORKDIR /tmp/unique_for_apex/apex +RUN pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" . +WORKDIR /workspace diff --git a/apex/examples/docker/README.md b/apex/examples/docker/README.md new file mode 100644 index 0000000000000000000000000000000000000000..3969af61a6a800480e3c326b90ab5c5595b03d61 --- /dev/null +++ b/apex/examples/docker/README.md @@ -0,0 +1,40 @@ +## Option 1: Create a new container with Apex + +**Dockerfile** installs the latest Apex on top of an existing image. Run +``` +docker build -t new_image_with_apex . +``` +By default, **Dockerfile** uses NVIDIA's Pytorch container as the base image, +which requires an NVIDIA GPU Cloud (NGC) account. If you don't have an NGC account, you can sign up for free by following the instructions [here](https://docs.nvidia.com/ngc/ngc-getting-started-guide/index.html#generating-api-key). + +Alternatively, you can supply your own base image via the `BASE_IMAGE` build-arg. +`BASE_IMAGE` must have Pytorch and Cuda installed. For example, any +`-devel` image for Pytorch 1.0 and later from the +[official Pytorch Dockerhub](https://hub.docker.com/r/pytorch/pytorch) may be used: +``` +docker build --build-arg BASE_IMAGE=1.3-cuda10.1-cudnn7-devel -t new_image_with_apex . +``` + +If you want to rebuild your image, and force the latest Apex to be cloned and installed, make any small change to the `SHA` variable in **Dockerfile**. + +**Warning:** +Currently, the non-`-devel` images on Pytorch Dockerhub do not contain the Cuda compiler `nvcc`. Therefore, +images whose name does not contain `-devel` are not eligible candidates for `BASE_IMAGE`. + +### Running your Apex container + +Like any Cuda-enabled Pytorch container, a container with Apex should be run via [nvidia-docker](https://github.com/NVIDIA/nvidia-docker), for example: +``` +docker run --runtime=nvidia -it --rm --ipc=host new_image_with_apex +``` + +## Option 2: Install Apex in a running container + +Instead of building a new container, it is also a viable option to `git clone https://github.com/NVIDIA/apex.git` on bare metal, mount the Apex repo into your container at launch by running, for example, +``` +docker run --runtime=nvidia -it --rm --ipc=host -v /bare/metal/apex:/apex/in/container +``` +then go to /apex/in/container within the running container and +``` +pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" . +``` diff --git a/apex/examples/imagenet/README.md b/apex/examples/imagenet/README.md new file mode 100644 index 0000000000000000000000000000000000000000..257d4a78d2a1d388361b1ad866de074c4037ac9d --- /dev/null +++ b/apex/examples/imagenet/README.md @@ -0,0 +1,183 @@ +# Mixed Precision ImageNet Training in PyTorch + +`main_amp.py` is based on [https://github.com/pytorch/examples/tree/master/imagenet](https://github.com/pytorch/examples/tree/master/imagenet). +It implements Automatic Mixed Precision (Amp) training of popular model architectures, such as ResNet, AlexNet, and VGG, on the ImageNet dataset. Command-line flags forwarded to `amp.initialize` are used to easily manipulate and switch between various pure and mixed precision "optimization levels" or `opt_level`s. For a detailed explanation of `opt_level`s, see the [updated API guide](https://nvidia.github.io/apex/amp.html). + +Three lines enable Amp: +``` +# Added after model and optimizer construction +model, optimizer = amp.initialize(model, optimizer, flags...) +... +# loss.backward() changed to: +with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() +``` + +With the new Amp API **you never need to explicitly convert your model, or the input data, to half().** + +## Requirements + +- Download the ImageNet dataset and move validation images to labeled subfolders + - The following script may be helpful: https://raw.githubusercontent.com/soumith/imagenetloader.torch/master/valprep.sh + +## Training + +To train a model, create softlinks to the Imagenet dataset, then run `main.py` with the desired model architecture, as shown in `Example commands` below. + +The default learning rate schedule is set for ResNet50. `main_amp.py` script rescales the learning rate according to the global batch size (number of distributed processes \* per-process minibatch size). + +## Example commands + +**Note:** batch size `--b 224` assumes your GPUs have >=16GB of onboard memory. You may be able to increase this to 256, but that's cutting it close, so it may out-of-memory for different Pytorch versions. + +**Note:** All of the following use 4 dataloader subprocesses (`--workers 4`) to reduce potential +CPU data loading bottlenecks. + +**Note:** `--opt-level` `O1` and `O2` both use dynamic loss scaling by default unless manually overridden. +`--opt-level` `O0` and `O3` (the "pure" training modes) do not use loss scaling by default. +`O0` and `O3` can be told to use loss scaling via manual overrides, but using loss scaling with `O0` +(pure FP32 training) does not really make sense, and will trigger a warning. + +Softlink training and validation datasets into the current directory: +``` +$ ln -sf /data/imagenet/train-jpeg/ train +$ ln -sf /data/imagenet/val-jpeg/ val +``` + +### Summary + +Amp allows easy experimentation with various pure and mixed precision options. +``` +$ python main_amp.py -a resnet50 --b 128 --workers 4 --opt-level O0 ./ +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O3 ./ +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O3 --keep-batchnorm-fp32 True ./ +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O1 ./ +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O1 --loss-scale 128.0 ./ +$ python -m torch.distributed.launch --nproc_per_node=2 main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O1 ./ +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O2 ./ +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O2 --loss-scale 128.0 ./ +$ python -m torch.distributed.launch --nproc_per_node=2 main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O2 ./ +``` +Options are explained below. Again, the [updated API guide](https://nvidia.github.io/apex/amp.html) provides more detail. + +#### `--opt-level O0` (FP32 training) and `O3` (FP16 training) + +"Pure FP32" training: +``` +$ python main_amp.py -a resnet50 --b 128 --workers 4 --opt-level O0 ./ +``` +"Pure FP16" training: +``` +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O3 ./ +``` +FP16 training with FP32 batchnorm: +``` +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O3 --keep-batchnorm-fp32 True ./ +``` +Keeping the batchnorms in FP32 improves stability and allows Pytorch +to use cudnn batchnorms, which significantly increases speed in Resnet50. + +The `O3` options might not converge, because they are not true mixed precision. +However, they can be useful to establish "speed of light" performance for +your model, which provides a baseline for comparison with `O1` and `O2`. +For Resnet50 in particular, `--opt-level O3 --keep-batchnorm-fp32 True` establishes +the "speed of light." (Without `--keep-batchnorm-fp32`, it's slower, because it does +not use cudnn batchnorm.) + +#### `--opt-level O1` (Official Mixed Precision recipe, recommended for typical use) + +`O1` patches Torch functions to cast inputs according to a whitelist-blacklist model. +FP16-friendly (Tensor Core) ops like gemms and convolutions run in FP16, while ops +that benefit from FP32, like batchnorm and softmax, run in FP32. +Also, dynamic loss scaling is used by default. +``` +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O1 ./ +``` +`O1` overridden to use static loss scaling: +``` +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O1 --loss-scale 128.0 +``` +Distributed training with 2 processes (1 GPU per process, see **Distributed training** below +for more detail) +``` +$ python -m torch.distributed.launch --nproc_per_node=2 main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O1 ./ +``` +For best performance, set `--nproc_per_node` equal to the total number of GPUs on the node +to use all available resources. + +#### `--opt-level O2` ("Almost FP16" mixed precision. More dangerous than O1.) + +`O2` exists mainly to support some internal use cases. Please prefer `O1`. + +`O2` casts the model to FP16, keeps batchnorms in FP32, +maintains master weights in FP32, and implements +dynamic loss scaling by default. (Unlike --opt-level O1, --opt-level O2 +does not patch Torch functions.) +``` +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O2 ./ +``` +"Fast mixed precision" overridden to use static loss scaling: +``` +$ python main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O2 --loss-scale 128.0 ./ +``` +Distributed training with 2 processes (1 GPU per process) +``` +$ python -m torch.distributed.launch --nproc_per_node=2 main_amp.py -a resnet50 --b 224 --workers 4 --opt-level O2 ./ +``` + +## Distributed training + +`main_amp.py` optionally uses `apex.parallel.DistributedDataParallel` (DDP) for multiprocess training with one GPU per process. +``` +model = apex.parallel.DistributedDataParallel(model) +``` +is a drop-in replacement for +``` +model = torch.nn.parallel.DistributedDataParallel(model, + device_ids=[arg.local_rank], + output_device=arg.local_rank) +``` +(because Torch DDP permits multiple GPUs per process, with Torch DDP you are required to +manually specify the device to run on and the output device. +With Apex DDP, it uses only the current device by default). + +The choice of DDP wrapper (Torch or Apex) is orthogonal to the use of Amp and other Apex tools. It is safe to use `apex.amp` with either `torch.nn.parallel.DistributedDataParallel` or `apex.parallel.DistributedDataParallel`. In the future, I may add some features that permit optional tighter integration between `Amp` and `apex.parallel.DistributedDataParallel` for marginal performance benefits, but currently, there's no compelling reason to use Apex DDP versus Torch DDP for most models. + +To use DDP with `apex.amp`, the only gotcha is that +``` +model, optimizer = amp.initialize(model, optimizer, flags...) +``` +must precede +``` +model = DDP(model) +``` +If DDP wrapping occurs before `amp.initialize`, `amp.initialize` will raise an error. + +With both Apex DDP and Torch DDP, you must also call `torch.cuda.set_device(args.local_rank)` within +each process prior to initializing your model or any other tensors. +More information can be found in the docs for the +Pytorch multiprocess launcher module [torch.distributed.launch](https://pytorch.org/docs/stable/distributed.html#launch-utility). + +`main_amp.py` is written to interact with +[torch.distributed.launch](https://pytorch.org/docs/master/distributed.html#launch-utility), +which spawns multiprocess jobs using the following syntax: +``` +python -m torch.distributed.launch --nproc_per_node=NUM_GPUS main_amp.py args... +``` +`NUM_GPUS` should be less than or equal to the number of visible GPU devices on the node. The use of `torch.distributed.launch` is unrelated to the choice of DDP wrapper. It is safe to use either apex DDP or torch DDP with `torch.distributed.launch`. + +Optionally, one can run imagenet with synchronized batch normalization across processes by adding +`--sync_bn` to the `args...` + +## Deterministic training (for debugging purposes) + +Running with the `--deterministic` flag should produce bitwise identical outputs run-to-run, +regardless of what other options are used (see [Pytorch docs on reproducibility](https://pytorch.org/docs/stable/notes/randomness.html)). +Since `--deterministic` disables `torch.backends.cudnn.benchmark`, `--deterministic` may +cause a modest performance decrease. + +## Profiling + +If you're curious how the network actually looks on the CPU and GPU timelines (for example, how good is the overall utilization? +Is the prefetcher really overlapping data transfers?) try profiling `main_amp.py`. +[Detailed instructions can be found here](https://gist.github.com/mcarilli/213a4e698e4a0ae2234ddee56f4f3f95). diff --git a/apex/examples/imagenet/main_amp.py b/apex/examples/imagenet/main_amp.py new file mode 100644 index 0000000000000000000000000000000000000000..6ad86bbddcb9649b8648067c2903652196ae454a --- /dev/null +++ b/apex/examples/imagenet/main_amp.py @@ -0,0 +1,543 @@ +import argparse +import os +import shutil +import time + +import torch +import torch.nn as nn +import torch.nn.parallel +import torch.backends.cudnn as cudnn +import torch.distributed as dist +import torch.optim +import torch.utils.data +import torch.utils.data.distributed +import torchvision.transforms as transforms +import torchvision.datasets as datasets +import torchvision.models as models + +import numpy as np + +try: + from apex.parallel import DistributedDataParallel as DDP + from apex.fp16_utils import * + from apex import amp, optimizers + from apex.multi_tensor_apply import multi_tensor_applier +except ImportError: + raise ImportError("Please install apex from https://www.github.com/nvidia/apex to run this example.") + +def fast_collate(batch, memory_format): + + imgs = [img[0] for img in batch] + targets = torch.tensor([target[1] for target in batch], dtype=torch.int64) + w = imgs[0].size[0] + h = imgs[0].size[1] + tensor = torch.zeros( (len(imgs), 3, h, w), dtype=torch.uint8).contiguous(memory_format=memory_format) + for i, img in enumerate(imgs): + nump_array = np.asarray(img, dtype=np.uint8) + if(nump_array.ndim < 3): + nump_array = np.expand_dims(nump_array, axis=-1) + nump_array = np.rollaxis(nump_array, 2) + tensor[i] += torch.from_numpy(nump_array) + return tensor, targets + + +def parse(): + model_names = sorted(name for name in models.__dict__ + if name.islower() and not name.startswith("__") + and callable(models.__dict__[name])) + + parser = argparse.ArgumentParser(description='PyTorch ImageNet Training') + parser.add_argument('data', metavar='DIR', + help='path to dataset') + parser.add_argument('--arch', '-a', metavar='ARCH', default='resnet18', + choices=model_names, + help='model architecture: ' + + ' | '.join(model_names) + + ' (default: resnet18)') + parser.add_argument('-j', '--workers', default=4, type=int, metavar='N', + help='number of data loading workers (default: 4)') + parser.add_argument('--epochs', default=90, type=int, metavar='N', + help='number of total epochs to run') + parser.add_argument('--start-epoch', default=0, type=int, metavar='N', + help='manual epoch number (useful on restarts)') + parser.add_argument('-b', '--batch-size', default=256, type=int, + metavar='N', help='mini-batch size per process (default: 256)') + parser.add_argument('--lr', '--learning-rate', default=0.1, type=float, + metavar='LR', help='Initial learning rate. Will be scaled by /256: args.lr = args.lr*float(args.batch_size*args.world_size)/256. A warmup schedule will also be applied over the first 5 epochs.') + parser.add_argument('--momentum', default=0.9, type=float, metavar='M', + help='momentum') + parser.add_argument('--weight-decay', '--wd', default=1e-4, type=float, + metavar='W', help='weight decay (default: 1e-4)') + parser.add_argument('--print-freq', '-p', default=10, type=int, + metavar='N', help='print frequency (default: 10)') + parser.add_argument('--resume', default='', type=str, metavar='PATH', + help='path to latest checkpoint (default: none)') + parser.add_argument('-e', '--evaluate', dest='evaluate', action='store_true', + help='evaluate model on validation set') + parser.add_argument('--pretrained', dest='pretrained', action='store_true', + help='use pre-trained model') + + parser.add_argument('--prof', default=-1, type=int, + help='Only run 10 iterations for profiling.') + parser.add_argument('--deterministic', action='store_true') + + parser.add_argument("--local_rank", default=0, type=int) + parser.add_argument('--sync_bn', action='store_true', + help='enabling apex sync BN.') + + parser.add_argument('--opt-level', type=str) + parser.add_argument('--keep-batchnorm-fp32', type=str, default=None) + parser.add_argument('--loss-scale', type=str, default=None) + parser.add_argument('--channels-last', type=bool, default=False) + args = parser.parse_args() + return args + +def main(): + global best_prec1, args + + args = parse() + print("opt_level = {}".format(args.opt_level)) + print("keep_batchnorm_fp32 = {}".format(args.keep_batchnorm_fp32), type(args.keep_batchnorm_fp32)) + print("loss_scale = {}".format(args.loss_scale), type(args.loss_scale)) + + print("\nCUDNN VERSION: {}\n".format(torch.backends.cudnn.version())) + + cudnn.benchmark = True + best_prec1 = 0 + if args.deterministic: + cudnn.benchmark = False + cudnn.deterministic = True + torch.manual_seed(args.local_rank) + torch.set_printoptions(precision=10) + + args.distributed = False + if 'WORLD_SIZE' in os.environ: + args.distributed = int(os.environ['WORLD_SIZE']) > 1 + + args.gpu = 0 + args.world_size = 1 + + if args.distributed: + args.gpu = args.local_rank + torch.cuda.set_device(args.gpu) + torch.distributed.init_process_group(backend='nccl', + init_method='env://') + args.world_size = torch.distributed.get_world_size() + + assert torch.backends.cudnn.enabled, "Amp requires cudnn backend to be enabled." + + if args.channels_last: + memory_format = torch.channels_last + else: + memory_format = torch.contiguous_format + + # create model + if args.pretrained: + print("=> using pre-trained model '{}'".format(args.arch)) + model = models.__dict__[args.arch](pretrained=True) + else: + print("=> creating model '{}'".format(args.arch)) + model = models.__dict__[args.arch]() + + if args.sync_bn: + import apex + print("using apex synced BN") + model = apex.parallel.convert_syncbn_model(model) + + model = model.cuda().to(memory_format=memory_format) + + # Scale learning rate based on global batch size + args.lr = args.lr*float(args.batch_size*args.world_size)/256. + optimizer = torch.optim.SGD(model.parameters(), args.lr, + momentum=args.momentum, + weight_decay=args.weight_decay) + + # Initialize Amp. Amp accepts either values or strings for the optional override arguments, + # for convenient interoperation with argparse. + model, optimizer = amp.initialize(model, optimizer, + opt_level=args.opt_level, + keep_batchnorm_fp32=args.keep_batchnorm_fp32, + loss_scale=args.loss_scale + ) + + # For distributed training, wrap the model with apex.parallel.DistributedDataParallel. + # This must be done AFTER the call to amp.initialize. If model = DDP(model) is called + # before model, ... = amp.initialize(model, ...), the call to amp.initialize may alter + # the types of model's parameters in a way that disrupts or destroys DDP's allreduce hooks. + if args.distributed: + # By default, apex.parallel.DistributedDataParallel overlaps communication with + # computation in the backward pass. + # model = DDP(model) + # delay_allreduce delays all communication to the end of the backward pass. + model = DDP(model, delay_allreduce=True) + + # define loss function (criterion) and optimizer + criterion = nn.CrossEntropyLoss().cuda() + + # Optionally resume from a checkpoint + if args.resume: + # Use a local scope to avoid dangling references + def resume(): + if os.path.isfile(args.resume): + print("=> loading checkpoint '{}'".format(args.resume)) + checkpoint = torch.load(args.resume, map_location = lambda storage, loc: storage.cuda(args.gpu)) + args.start_epoch = checkpoint['epoch'] + global best_prec1 + best_prec1 = checkpoint['best_prec1'] + model.load_state_dict(checkpoint['state_dict']) + optimizer.load_state_dict(checkpoint['optimizer']) + print("=> loaded checkpoint '{}' (epoch {})" + .format(args.resume, checkpoint['epoch'])) + else: + print("=> no checkpoint found at '{}'".format(args.resume)) + resume() + + # Data loading code + traindir = os.path.join(args.data, 'train') + valdir = os.path.join(args.data, 'val') + + if(args.arch == "inception_v3"): + raise RuntimeError("Currently, inception_v3 is not supported by this example.") + # crop_size = 299 + # val_size = 320 # I chose this value arbitrarily, we can adjust. + else: + crop_size = 224 + val_size = 256 + + train_dataset = datasets.ImageFolder( + traindir, + transforms.Compose([ + transforms.RandomResizedCrop(crop_size), + transforms.RandomHorizontalFlip(), + # transforms.ToTensor(), Too slow + # normalize, + ])) + val_dataset = datasets.ImageFolder(valdir, transforms.Compose([ + transforms.Resize(val_size), + transforms.CenterCrop(crop_size), + ])) + + train_sampler = None + val_sampler = None + if args.distributed: + train_sampler = torch.utils.data.distributed.DistributedSampler(train_dataset) + val_sampler = torch.utils.data.distributed.DistributedSampler(val_dataset) + + collate_fn = lambda b: fast_collate(b, memory_format) + + train_loader = torch.utils.data.DataLoader( + train_dataset, batch_size=args.batch_size, shuffle=(train_sampler is None), + num_workers=args.workers, pin_memory=True, sampler=train_sampler, collate_fn=collate_fn) + + val_loader = torch.utils.data.DataLoader( + val_dataset, + batch_size=args.batch_size, shuffle=False, + num_workers=args.workers, pin_memory=True, + sampler=val_sampler, + collate_fn=collate_fn) + + if args.evaluate: + validate(val_loader, model, criterion) + return + + for epoch in range(args.start_epoch, args.epochs): + if args.distributed: + train_sampler.set_epoch(epoch) + + # train for one epoch + train(train_loader, model, criterion, optimizer, epoch) + + # evaluate on validation set + prec1 = validate(val_loader, model, criterion) + + # remember best prec@1 and save checkpoint + if args.local_rank == 0: + is_best = prec1 > best_prec1 + best_prec1 = max(prec1, best_prec1) + save_checkpoint({ + 'epoch': epoch + 1, + 'arch': args.arch, + 'state_dict': model.state_dict(), + 'best_prec1': best_prec1, + 'optimizer' : optimizer.state_dict(), + }, is_best) + +class data_prefetcher(): + def __init__(self, loader): + self.loader = iter(loader) + self.stream = torch.cuda.Stream() + self.mean = torch.tensor([0.485 * 255, 0.456 * 255, 0.406 * 255]).cuda().view(1,3,1,1) + self.std = torch.tensor([0.229 * 255, 0.224 * 255, 0.225 * 255]).cuda().view(1,3,1,1) + # With Amp, it isn't necessary to manually convert data to half. + # if args.fp16: + # self.mean = self.mean.half() + # self.std = self.std.half() + self.preload() + + def preload(self): + try: + self.next_input, self.next_target = next(self.loader) + except StopIteration: + self.next_input = None + self.next_target = None + return + # if record_stream() doesn't work, another option is to make sure device inputs are created + # on the main stream. + # self.next_input_gpu = torch.empty_like(self.next_input, device='cuda') + # self.next_target_gpu = torch.empty_like(self.next_target, device='cuda') + # Need to make sure the memory allocated for next_* is not still in use by the main stream + # at the time we start copying to next_*: + # self.stream.wait_stream(torch.cuda.current_stream()) + with torch.cuda.stream(self.stream): + self.next_input = self.next_input.cuda(non_blocking=True) + self.next_target = self.next_target.cuda(non_blocking=True) + # more code for the alternative if record_stream() doesn't work: + # copy_ will record the use of the pinned source tensor in this side stream. + # self.next_input_gpu.copy_(self.next_input, non_blocking=True) + # self.next_target_gpu.copy_(self.next_target, non_blocking=True) + # self.next_input = self.next_input_gpu + # self.next_target = self.next_target_gpu + + # With Amp, it isn't necessary to manually convert data to half. + # if args.fp16: + # self.next_input = self.next_input.half() + # else: + self.next_input = self.next_input.float() + self.next_input = self.next_input.sub_(self.mean).div_(self.std) + + def next(self): + torch.cuda.current_stream().wait_stream(self.stream) + input = self.next_input + target = self.next_target + if input is not None: + input.record_stream(torch.cuda.current_stream()) + if target is not None: + target.record_stream(torch.cuda.current_stream()) + self.preload() + return input, target + + +def train(train_loader, model, criterion, optimizer, epoch): + batch_time = AverageMeter() + losses = AverageMeter() + top1 = AverageMeter() + top5 = AverageMeter() + + # switch to train mode + model.train() + end = time.time() + + prefetcher = data_prefetcher(train_loader) + input, target = prefetcher.next() + i = 0 + while input is not None: + i += 1 + if args.prof >= 0 and i == args.prof: + print("Profiling begun at iteration {}".format(i)) + torch.cuda.cudart().cudaProfilerStart() + + if args.prof >= 0: torch.cuda.nvtx.range_push("Body of iteration {}".format(i)) + + adjust_learning_rate(optimizer, epoch, i, len(train_loader)) + + # compute output + if args.prof >= 0: torch.cuda.nvtx.range_push("forward") + output = model(input) + if args.prof >= 0: torch.cuda.nvtx.range_pop() + loss = criterion(output, target) + + # compute gradient and do SGD step + optimizer.zero_grad() + + if args.prof >= 0: torch.cuda.nvtx.range_push("backward") + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + if args.prof >= 0: torch.cuda.nvtx.range_pop() + + # for param in model.parameters(): + # print(param.data.double().sum().item(), param.grad.data.double().sum().item()) + + if args.prof >= 0: torch.cuda.nvtx.range_push("optimizer.step()") + optimizer.step() + if args.prof >= 0: torch.cuda.nvtx.range_pop() + + if i%args.print_freq == 0: + # Every print_freq iterations, check the loss, accuracy, and speed. + # For best performance, it doesn't make sense to print these metrics every + # iteration, since they incur an allreduce and some host<->device syncs. + + # Measure accuracy + prec1, prec5 = accuracy(output.data, target, topk=(1, 5)) + + # Average loss and accuracy across processes for logging + if args.distributed: + reduced_loss = reduce_tensor(loss.data) + prec1 = reduce_tensor(prec1) + prec5 = reduce_tensor(prec5) + else: + reduced_loss = loss.data + + # to_python_float incurs a host<->device sync + losses.update(to_python_float(reduced_loss), input.size(0)) + top1.update(to_python_float(prec1), input.size(0)) + top5.update(to_python_float(prec5), input.size(0)) + + torch.cuda.synchronize() + batch_time.update((time.time() - end)/args.print_freq) + end = time.time() + + if args.local_rank == 0: + print('Epoch: [{0}][{1}/{2}]\t' + 'Time {batch_time.val:.3f} ({batch_time.avg:.3f})\t' + 'Speed {3:.3f} ({4:.3f})\t' + 'Loss {loss.val:.10f} ({loss.avg:.4f})\t' + 'Prec@1 {top1.val:.3f} ({top1.avg:.3f})\t' + 'Prec@5 {top5.val:.3f} ({top5.avg:.3f})'.format( + epoch, i, len(train_loader), + args.world_size*args.batch_size/batch_time.val, + args.world_size*args.batch_size/batch_time.avg, + batch_time=batch_time, + loss=losses, top1=top1, top5=top5)) + if args.prof >= 0: torch.cuda.nvtx.range_push("prefetcher.next()") + input, target = prefetcher.next() + if args.prof >= 0: torch.cuda.nvtx.range_pop() + + # Pop range "Body of iteration {}".format(i) + if args.prof >= 0: torch.cuda.nvtx.range_pop() + + if args.prof >= 0 and i == args.prof + 10: + print("Profiling ended at iteration {}".format(i)) + torch.cuda.cudart().cudaProfilerStop() + quit() + + +def validate(val_loader, model, criterion): + batch_time = AverageMeter() + losses = AverageMeter() + top1 = AverageMeter() + top5 = AverageMeter() + + # switch to evaluate mode + model.eval() + + end = time.time() + + prefetcher = data_prefetcher(val_loader) + input, target = prefetcher.next() + i = 0 + while input is not None: + i += 1 + + # compute output + with torch.no_grad(): + output = model(input) + loss = criterion(output, target) + + # measure accuracy and record loss + prec1, prec5 = accuracy(output.data, target, topk=(1, 5)) + + if args.distributed: + reduced_loss = reduce_tensor(loss.data) + prec1 = reduce_tensor(prec1) + prec5 = reduce_tensor(prec5) + else: + reduced_loss = loss.data + + losses.update(to_python_float(reduced_loss), input.size(0)) + top1.update(to_python_float(prec1), input.size(0)) + top5.update(to_python_float(prec5), input.size(0)) + + # measure elapsed time + batch_time.update(time.time() - end) + end = time.time() + + # TODO: Change timings to mirror train(). + if args.local_rank == 0 and i % args.print_freq == 0: + print('Test: [{0}/{1}]\t' + 'Time {batch_time.val:.3f} ({batch_time.avg:.3f})\t' + 'Speed {2:.3f} ({3:.3f})\t' + 'Loss {loss.val:.4f} ({loss.avg:.4f})\t' + 'Prec@1 {top1.val:.3f} ({top1.avg:.3f})\t' + 'Prec@5 {top5.val:.3f} ({top5.avg:.3f})'.format( + i, len(val_loader), + args.world_size * args.batch_size / batch_time.val, + args.world_size * args.batch_size / batch_time.avg, + batch_time=batch_time, loss=losses, + top1=top1, top5=top5)) + + input, target = prefetcher.next() + + print(' * Prec@1 {top1.avg:.3f} Prec@5 {top5.avg:.3f}' + .format(top1=top1, top5=top5)) + + return top1.avg + + +def save_checkpoint(state, is_best, filename='checkpoint.pth.tar'): + torch.save(state, filename) + if is_best: + shutil.copyfile(filename, 'model_best.pth.tar') + + +class AverageMeter(object): + """Computes and stores the average and current value""" + def __init__(self): + self.reset() + + def reset(self): + self.val = 0 + self.avg = 0 + self.sum = 0 + self.count = 0 + + def update(self, val, n=1): + self.val = val + self.sum += val * n + self.count += n + self.avg = self.sum / self.count + + +def adjust_learning_rate(optimizer, epoch, step, len_epoch): + """LR schedule that should yield 76% converged accuracy with batch size 256""" + factor = epoch // 30 + + if epoch >= 80: + factor = factor + 1 + + lr = args.lr*(0.1**factor) + + """Warmup""" + if epoch < 5: + lr = lr*float(1 + step + epoch*len_epoch)/(5.*len_epoch) + + # if(args.local_rank == 0): + # print("epoch = {}, step = {}, lr = {}".format(epoch, step, lr)) + + for param_group in optimizer.param_groups: + param_group['lr'] = lr + + +def accuracy(output, target, topk=(1,)): + """Computes the precision@k for the specified values of k""" + maxk = max(topk) + batch_size = target.size(0) + + _, pred = output.topk(maxk, 1, True, True) + pred = pred.t() + correct = pred.eq(target.view(1, -1).expand_as(pred)) + + res = [] + for k in topk: + correct_k = correct[:k].reshape(-1).float().sum(0, keepdim=True) + res.append(correct_k.mul_(100.0 / batch_size)) + return res + + +def reduce_tensor(tensor): + rt = tensor.clone() + dist.all_reduce(rt, op=dist.reduce_op.SUM) + rt /= args.world_size + return rt + +if __name__ == '__main__': + main() diff --git a/apex/examples/simple/distributed/README.md b/apex/examples/simple/distributed/README.md new file mode 100644 index 0000000000000000000000000000000000000000..0d939cbbf67234835b1c9afdc84ae42357fee34e --- /dev/null +++ b/apex/examples/simple/distributed/README.md @@ -0,0 +1,13 @@ +**distributed_data_parallel.py** and **run.sh** show an example using Amp with +[apex.parallel.DistributedDataParallel](https://nvidia.github.io/apex/parallel.html) or +[torch.nn.parallel.DistributedDataParallel](https://pytorch.org/docs/stable/nn.html#distributeddataparallel) +and the Pytorch multiprocess launcher script, +[torch.distributed.launch](https://pytorch.org/docs/master/distributed.html#launch-utility). +The use of `Amp` with DistributedDataParallel does not need to change from ordinary +single-process use. The only gotcha is that wrapping your model with `DistributedDataParallel` must +come after the call to `amp.initialize`. Test via +```bash +bash run.sh +``` + +**This is intended purely as an instructional example, not a performance showcase.** diff --git a/apex/examples/simple/distributed/distributed_data_parallel.py b/apex/examples/simple/distributed/distributed_data_parallel.py new file mode 100644 index 0000000000000000000000000000000000000000..b364405df89b7568efb59e640b40e557d402b277 --- /dev/null +++ b/apex/examples/simple/distributed/distributed_data_parallel.py @@ -0,0 +1,65 @@ +import torch +import argparse +import os +from apex import amp +# FOR DISTRIBUTED: (can also use torch.nn.parallel.DistributedDataParallel instead) +from apex.parallel import DistributedDataParallel + +parser = argparse.ArgumentParser() +# FOR DISTRIBUTED: Parse for the local_rank argument, which will be supplied +# automatically by torch.distributed.launch. +parser.add_argument("--local_rank", default=0, type=int) +args = parser.parse_args() + +# FOR DISTRIBUTED: If we are running under torch.distributed.launch, +# the 'WORLD_SIZE' environment variable will also be set automatically. +args.distributed = False +if 'WORLD_SIZE' in os.environ: + args.distributed = int(os.environ['WORLD_SIZE']) > 1 + +if args.distributed: + # FOR DISTRIBUTED: Set the device according to local_rank. + torch.cuda.set_device(args.local_rank) + + # FOR DISTRIBUTED: Initialize the backend. torch.distributed.launch will provide + # environment variables, and requires that you use init_method=`env://`. + torch.distributed.init_process_group(backend='nccl', + init_method='env://') + +torch.backends.cudnn.benchmark = True + +N, D_in, D_out = 64, 1024, 16 + +# Each process receives its own batch of "fake input data" and "fake target data." +# The "training loop" in each process just uses this fake batch over and over. +# https://github.com/NVIDIA/apex/tree/master/examples/imagenet provides a more realistic +# example of distributed data sampling for both training and validation. +x = torch.randn(N, D_in, device='cuda') +y = torch.randn(N, D_out, device='cuda') + +model = torch.nn.Linear(D_in, D_out).cuda() +optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + +model, optimizer = amp.initialize(model, optimizer, opt_level="O1") + +if args.distributed: + # FOR DISTRIBUTED: After amp.initialize, wrap the model with + # apex.parallel.DistributedDataParallel. + model = DistributedDataParallel(model) + # torch.nn.parallel.DistributedDataParallel is also fine, with some added args: + # model = torch.nn.parallel.DistributedDataParallel(model, + # device_ids=[args.local_rank], + # output_device=args.local_rank) + +loss_fn = torch.nn.MSELoss() + +for t in range(500): + optimizer.zero_grad() + y_pred = model(x) + loss = loss_fn(y_pred, y) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + +if args.local_rank == 0: + print("final loss = ", loss) diff --git a/apex/examples/simple/distributed/run.sh b/apex/examples/simple/distributed/run.sh new file mode 100644 index 0000000000000000000000000000000000000000..7a2d85f0a464bb880c9aaad5ae0ab32fddb11635 --- /dev/null +++ b/apex/examples/simple/distributed/run.sh @@ -0,0 +1,2 @@ +#!/bin/bash +python -m torch.distributed.launch --nproc_per_node=2 distributed_data_parallel.py diff --git a/apex/requirements.txt b/apex/requirements.txt new file mode 100644 index 0000000000000000000000000000000000000000..f417ef5c5d7edd725f207f880182598aacc5d83c --- /dev/null +++ b/apex/requirements.txt @@ -0,0 +1,5 @@ +cxxfilt>=0.2.0 +tqdm>=4.28.1 +numpy>=1.15.3 +PyYAML>=5.1 +pytest>=3.5.1 diff --git a/apex/requirements_dev.txt b/apex/requirements_dev.txt new file mode 100644 index 0000000000000000000000000000000000000000..e1086e0e63911c24e67d4ea9ea90e0ee3426e466 --- /dev/null +++ b/apex/requirements_dev.txt @@ -0,0 +1,3 @@ +-r requirements.txt +flake8>=3.7.9 +Sphinx>=3.0.3 \ No newline at end of file diff --git a/apex/setup.py b/apex/setup.py new file mode 100644 index 0000000000000000000000000000000000000000..e9cf39b373d794140ccb9dee8efed25358a52294 --- /dev/null +++ b/apex/setup.py @@ -0,0 +1,556 @@ +import torch +from torch.utils import cpp_extension +from setuptools import setup, find_packages +import subprocess + +import sys +import warnings +import os + +# ninja build does not work unless include_dirs are abs path +this_dir = os.path.dirname(os.path.abspath(__file__)) + +def get_cuda_bare_metal_version(cuda_dir): + raw_output = subprocess.check_output([cuda_dir + "/bin/nvcc", "-V"], universal_newlines=True) + output = raw_output.split() + release_idx = output.index("release") + 1 + release = output[release_idx].split(".") + bare_metal_major = release[0] + bare_metal_minor = release[1][0] + + return raw_output, bare_metal_major, bare_metal_minor + +if not torch.cuda.is_available(): + # https://github.com/NVIDIA/apex/issues/486 + # Extension builds after https://github.com/pytorch/pytorch/pull/23408 attempt to query torch.cuda.get_device_capability(), + # which will fail if you are compiling in an environment without visible GPUs (e.g. during an nvidia-docker build command). + print('\nWarning: Torch did not find available GPUs on this system.\n', + 'If your intention is to cross-compile, this is not an error.\n' + 'By default, Apex will cross-compile for Pascal (compute capabilities 6.0, 6.1, 6.2),\n' + 'Volta (compute capability 7.0), Turing (compute capability 7.5),\n' + 'and, if the CUDA version is >= 11.0, Ampere (compute capability 8.0).\n' + 'If you wish to cross-compile for a single specific architecture,\n' + 'export TORCH_CUDA_ARCH_LIST="compute capability" before running setup.py.\n') + if os.environ.get("TORCH_CUDA_ARCH_LIST", None) is None: + _, bare_metal_major, _ = get_cuda_bare_metal_version(cpp_extension.CUDA_HOME) + if int(bare_metal_major) == 11: + os.environ["TORCH_CUDA_ARCH_LIST"] = "6.0;6.1;6.2;7.0;7.5;8.0" + else: + os.environ["TORCH_CUDA_ARCH_LIST"] = "6.0;6.1;6.2;7.0;7.5" + +print("\n\ntorch.__version__ = {}\n\n".format(torch.__version__)) +TORCH_MAJOR = int(torch.__version__.split('.')[0]) +TORCH_MINOR = int(torch.__version__.split('.')[1]) + +if TORCH_MAJOR == 0 and TORCH_MINOR < 4: + raise RuntimeError("Apex requires Pytorch 0.4 or newer.\n" + + "The latest stable release can be obtained from https://pytorch.org/") + +cmdclass = {} +ext_modules = [] + +extras = {} +if "--pyprof" in sys.argv: + string = "\n\nPyprof has been moved to its own dedicated repository and will " + \ + "soon be removed from Apex. Please visit\n" + \ + "https://github.com/NVIDIA/PyProf\n" + \ + "for the latest version." + warnings.warn(string, DeprecationWarning) + with open('requirements.txt') as f: + required_packages = f.read().splitlines() + extras['pyprof'] = required_packages + try: + sys.argv.remove("--pyprof") + except: + pass +else: + warnings.warn("Option --pyprof not specified. Not installing PyProf dependencies!") + +if "--cpp_ext" in sys.argv or "--cuda_ext" in sys.argv: + if TORCH_MAJOR == 0: + raise RuntimeError("--cpp_ext requires Pytorch 1.0 or later, " + "found torch.__version__ = {}".format(torch.__version__)) + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + +if "--cpp_ext" in sys.argv: + from torch.utils.cpp_extension import CppExtension + sys.argv.remove("--cpp_ext") + ext_modules.append( + CppExtension('apex_C', + ['csrc/flatten_unflatten.cpp',])) + +def get_cuda_bare_metal_version(cuda_dir): + raw_output = subprocess.check_output([cuda_dir + "/bin/nvcc", "-V"], universal_newlines=True) + output = raw_output.split() + release_idx = output.index("release") + 1 + release = output[release_idx].split(".") + bare_metal_major = release[0] + bare_metal_minor = release[1][0] + + return raw_output, bare_metal_major, bare_metal_minor + +def check_cuda_torch_binary_vs_bare_metal(cuda_dir): + raw_output, bare_metal_major, bare_metal_minor = get_cuda_bare_metal_version(cuda_dir) + torch_binary_major = torch.version.cuda.split(".")[0] + torch_binary_minor = torch.version.cuda.split(".")[1] + + print("\nCompiling cuda extensions with") + print(raw_output + "from " + cuda_dir + "/bin\n") + + if (bare_metal_major != torch_binary_major) or (bare_metal_minor != torch_binary_minor): + raise RuntimeError("Cuda extensions are being compiled with a version of Cuda that does " + + "not match the version used to compile Pytorch binaries. " + + "Pytorch binaries were compiled with Cuda {}.\n".format(torch.version.cuda) + + "In some cases, a minor-version mismatch will not cause later errors: " + + "https://github.com/NVIDIA/apex/pull/323#discussion_r287021798. " + "You can try commenting out this check (at your own risk).") + + +# Set up macros for forward/backward compatibility hack around +# https://github.com/pytorch/pytorch/commit/4404762d7dd955383acee92e6f06b48144a0742e +# and +# https://github.com/NVIDIA/apex/issues/456 +# https://github.com/pytorch/pytorch/commit/eb7b39e02f7d75c26d8a795ea8c7fd911334da7e#diff-4632522f237f1e4e728cb824300403ac +version_ge_1_1 = [] +if (TORCH_MAJOR > 1) or (TORCH_MAJOR == 1 and TORCH_MINOR > 0): + version_ge_1_1 = ['-DVERSION_GE_1_1'] +version_ge_1_3 = [] +if (TORCH_MAJOR > 1) or (TORCH_MAJOR == 1 and TORCH_MINOR > 2): + version_ge_1_3 = ['-DVERSION_GE_1_3'] +version_ge_1_5 = [] +if (TORCH_MAJOR > 1) or (TORCH_MAJOR == 1 and TORCH_MINOR > 4): + version_ge_1_5 = ['-DVERSION_GE_1_5'] +version_dependent_macros = version_ge_1_1 + version_ge_1_3 + version_ge_1_5 + +if "--distributed_adam" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--distributed_adam") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--distributed_adam was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='distributed_adam_cuda', + sources=['apex/contrib/csrc/optimizers/multi_tensor_distopt_adam.cpp', + 'apex/contrib/csrc/optimizers/multi_tensor_distopt_adam_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros, + 'nvcc':['-O3', + '--use_fast_math'] + version_dependent_macros})) + +if "--distributed_lamb" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--distributed_lamb") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--distributed_lamb was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='distributed_lamb_cuda', + sources=['apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb.cpp', + 'apex/contrib/csrc/optimizers/multi_tensor_distopt_lamb_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros, + 'nvcc':['-O3', + '--use_fast_math'] + version_dependent_macros})) + +if "--cuda_ext" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--cuda_ext") + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--cuda_ext was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + check_cuda_torch_binary_vs_bare_metal(torch.utils.cpp_extension.CUDA_HOME) + + ext_modules.append( + CUDAExtension(name='amp_C', + sources=['csrc/amp_C_frontend.cpp', + 'csrc/multi_tensor_sgd_kernel.cu', + 'csrc/multi_tensor_scale_kernel.cu', + 'csrc/multi_tensor_axpby_kernel.cu', + 'csrc/multi_tensor_l2norm_kernel.cu', + 'csrc/multi_tensor_lamb_stage_1.cu', + 'csrc/multi_tensor_lamb_stage_2.cu', + 'csrc/multi_tensor_adam.cu', + 'csrc/multi_tensor_adagrad.cu', + 'csrc/multi_tensor_novograd.cu', + 'csrc/multi_tensor_lamb.cu'], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-lineinfo', + '-O3', + # '--resource-usage', + '--use_fast_math'] + version_dependent_macros})) + ext_modules.append( + CUDAExtension(name='syncbn', + sources=['csrc/syncbn.cpp', + 'csrc/welford.cu'], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-O3'] + version_dependent_macros})) + + ext_modules.append( + CUDAExtension(name='fused_layer_norm_cuda', + sources=['csrc/layer_norm_cuda.cpp', + 'csrc/layer_norm_cuda_kernel.cu'], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-maxrregcount=50', + '-O3', + '--use_fast_math'] + version_dependent_macros})) + + ext_modules.append( + CUDAExtension(name='mlp_cuda', + sources=['csrc/mlp.cpp', + 'csrc/mlp_cuda.cu'], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-O3'] + version_dependent_macros})) + +if "--bnp" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--bnp") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--bnp was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='bnp', + sources=['apex/contrib/csrc/groupbn/batch_norm.cu', + 'apex/contrib/csrc/groupbn/ipc.cu', + 'apex/contrib/csrc/groupbn/interface.cpp', + 'apex/contrib/csrc/groupbn/batch_norm_add_relu.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': [] + version_dependent_macros, + 'nvcc':['-DCUDA_HAS_FP16=1', + '-D__CUDA_NO_HALF_OPERATORS__', + '-D__CUDA_NO_HALF_CONVERSIONS__', + '-D__CUDA_NO_HALF2_OPERATORS__'] + version_dependent_macros})) + +if "--xentropy" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--xentropy") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--xentropy was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='xentropy_cuda', + sources=['apex/contrib/csrc/xentropy/interface.cpp', + 'apex/contrib/csrc/xentropy/xentropy_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-O3'] + version_dependent_macros})) + +if "--deprecated_fused_adam" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--deprecated_fused_adam") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--deprecated_fused_adam was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='fused_adam_cuda', + sources=['apex/contrib/csrc/optimizers/fused_adam_cuda.cpp', + 'apex/contrib/csrc/optimizers/fused_adam_cuda_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros, + 'nvcc':['-O3', + '--use_fast_math'] + version_dependent_macros})) + +if "--deprecated_fused_lamb" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--deprecated_fused_lamb") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--deprecated_fused_lamb was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='fused_lamb_cuda', + sources=['apex/contrib/csrc/optimizers/fused_lamb_cuda.cpp', + 'apex/contrib/csrc/optimizers/fused_lamb_cuda_kernel.cu', + 'csrc/multi_tensor_l2norm_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros, + 'nvcc':['-O3', + '--use_fast_math'] + version_dependent_macros})) + +# Check, if ATen/CUDAGenerator.h is found, otherwise use the new ATen/CUDAGeneratorImpl.h, due to breaking change in https://github.com/pytorch/pytorch/pull/36026 +generator_flag = [] +torch_dir = torch.__path__[0] +if os.path.exists(os.path.join(torch_dir, 'include', 'ATen', 'CUDAGenerator.h')): + generator_flag = ['-DOLD_GENERATOR'] + +if "--fast_layer_norm" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--fast_layer_norm") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension.with_options(use_ninja=False) + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--fast_layer_norm was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + # Check, if CUDA11 is installed for compute capability 8.0 + cc_flag = [] + _, bare_metal_major, _ = get_cuda_bare_metal_version(cpp_extension.CUDA_HOME) + if int(bare_metal_major) >= 11: + cc_flag.append('-gencode') + cc_flag.append('arch=compute_80,code=sm_80') + + ext_modules.append( + CUDAExtension(name='fast_layer_norm', + sources=['apex/contrib/csrc/layer_norm/ln_api.cpp', + 'apex/contrib/csrc/layer_norm/ln_fwd_cuda_kernel.cu', + 'apex/contrib/csrc/layer_norm/ln_bwd_semi_cuda_kernel.cu', + ], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '-I./apex/contrib/csrc/layer_norm/', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) +if "--fmha" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--fmha") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension.with_options(use_ninja=False) + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--fmha was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + # Check, if CUDA11 is installed for compute capability 8.0 + cc_flag = [] + _, bare_metal_major, _ = get_cuda_bare_metal_version(cpp_extension.CUDA_HOME) + if int(bare_metal_major) < 11: + raise RuntimeError("--fmha only supported on SM80") + + ext_modules.append( + CUDAExtension(name='fmhalib', + sources=[ + 'apex/contrib/csrc/fmha/fmha_api.cpp', + 'apex/contrib/csrc/fmha/src/fmha_fprop_fp16_128_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_fprop_fp16_256_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_fprop_fp16_384_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_fprop_fp16_512_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_128_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_256_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_384_64_kernel.sm80.cu', + 'apex/contrib/csrc/fmha/src/fmha_dgrad_fp16_512_64_kernel.sm80.cu', + ], + extra_compile_args={'cxx': ['-O3', + '-I./apex/contrib/csrc/fmha/src', + ] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_80,code=sm_80', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '-I./apex/contrib/csrc/', + '-I./apex/contrib/csrc/fmha/src', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + + +if "--fast_multihead_attn" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--fast_multihead_attn") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension.with_options(use_ninja=False) + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--fast_multihead_attn was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + # Check, if CUDA11 is installed for compute capability 8.0 + cc_flag = [] + _, bare_metal_major, _ = get_cuda_bare_metal_version(cpp_extension.CUDA_HOME) + if int(bare_metal_major) >= 11: + cc_flag.append('-gencode') + cc_flag.append('arch=compute_80,code=sm_80') + + subprocess.run(["git", "submodule", "update", "--init", "apex/contrib/csrc/multihead_attn/cutlass"]) + ext_modules.append( + CUDAExtension(name='fast_additive_mask_softmax_dropout', + sources=['apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout.cpp', + 'apex/contrib/csrc/multihead_attn/additive_masked_softmax_dropout_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_mask_softmax_dropout', + sources=['apex/contrib/csrc/multihead_attn/masked_softmax_dropout.cpp', + 'apex/contrib/csrc/multihead_attn/masked_softmax_dropout_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_self_multihead_attn_bias_additive_mask', + sources=['apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask.cpp', + 'apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_additive_mask_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_self_multihead_attn_bias', + sources=['apex/contrib/csrc/multihead_attn/self_multihead_attn_bias.cpp', + 'apex/contrib/csrc/multihead_attn/self_multihead_attn_bias_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_self_multihead_attn', + sources=['apex/contrib/csrc/multihead_attn/self_multihead_attn.cpp', + 'apex/contrib/csrc/multihead_attn/self_multihead_attn_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_self_multihead_attn_norm_add', + sources=['apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add.cpp', + 'apex/contrib/csrc/multihead_attn/self_multihead_attn_norm_add_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_encdec_multihead_attn', + sources=['apex/contrib/csrc/multihead_attn/encdec_multihead_attn.cpp', + 'apex/contrib/csrc/multihead_attn/encdec_multihead_attn_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + ext_modules.append( + CUDAExtension(name='fast_encdec_multihead_attn_norm_add', + sources=['apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add.cpp', + 'apex/contrib/csrc/multihead_attn/encdec_multihead_attn_norm_add_cuda.cu'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag, + 'nvcc':['-O3', + '-gencode', 'arch=compute_70,code=sm_70', + '-I./apex/contrib/csrc/multihead_attn/cutlass/', + '-U__CUDA_NO_HALF_OPERATORS__', + '-U__CUDA_NO_HALF_CONVERSIONS__', + '--expt-relaxed-constexpr', + '--expt-extended-lambda', + '--use_fast_math'] + version_dependent_macros + generator_flag + cc_flag})) + +if "--transducer" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--transducer") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension.with_options(use_ninja=False) + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--transducer was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + ext_modules.append( + CUDAExtension(name='transducer_joint_cuda', + sources=['apex/contrib/csrc/transducer/transducer_joint.cpp', + 'apex/contrib/csrc/transducer/transducer_joint_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-O3'] + version_dependent_macros})) + ext_modules.append( + CUDAExtension(name='transducer_loss_cuda', + sources=['apex/contrib/csrc/transducer/transducer_loss.cpp', + 'apex/contrib/csrc/transducer/transducer_loss_kernel.cu'], + include_dirs=[os.path.join(this_dir, 'csrc')], + extra_compile_args={'cxx': ['-O3'] + version_dependent_macros, + 'nvcc':['-O3'] + version_dependent_macros})) + +if "--fast_bottleneck" in sys.argv: + from torch.utils.cpp_extension import CUDAExtension + sys.argv.remove("--fast_bottleneck") + + from torch.utils.cpp_extension import BuildExtension + cmdclass['build_ext'] = BuildExtension.with_options(use_ninja=False) + + if torch.utils.cpp_extension.CUDA_HOME is None: + raise RuntimeError("--fast_bottleneck was requested, but nvcc was not found. Are you sure your environment has nvcc available? If you're installing within a container from https://hub.docker.com/r/pytorch/pytorch, only images whose names contain 'devel' will provide nvcc.") + else: + subprocess.run(["git", "submodule", "update", "--init", "apex/contrib/csrc/cudnn-frontend/"]) + ext_modules.append( + CUDAExtension(name='fast_bottleneck', + sources=['apex/contrib/csrc/bottleneck/bottleneck.cpp'], + include_dirs=['apex/contrib/csrc/cudnn-frontend/include'], + extra_compile_args={'cxx': ['-O3',] + version_dependent_macros + generator_flag})) + +setup( + name='apex', + version='0.1', + packages=find_packages(exclude=('build', + 'csrc', + 'include', + 'tests', + 'dist', + 'docs', + 'tests', + 'examples', + 'apex.egg-info',)), + description='PyTorch Extensions written by NVIDIA', + ext_modules=ext_modules, + cmdclass=cmdclass, + extras_require=extras, +) diff --git a/apex/tests/L0/run_amp/__init__.py b/apex/tests/L0/run_amp/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/tests/L0/run_amp/test_add_param_group.py b/apex/tests/L0/run_amp/test_add_param_group.py new file mode 100644 index 0000000000000000000000000000000000000000..d3e90c4330eff32c529f2293af34324691ef6674 --- /dev/null +++ b/apex/tests/L0/run_amp/test_add_param_group.py @@ -0,0 +1,148 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +from apex.amp import _amp_state +import torch +from torch import nn +import torch.nn.functional as F +from torch.nn import Parameter + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +class MyModel(torch.nn.Module): + def __init__(self, unique): + super(MyModel, self).__init__() + self.weight0 = Parameter(unique + + torch.arange(2, device='cuda', dtype=torch.float32)) + self.weight1 = Parameter(1. + unique + torch.arange(2, device='cuda', dtype=torch.float16)) + + @staticmethod + def ops(input, weight0, weight1): + return ((input*(weight0.float()))*(weight1.float())).sum() + + def forward(self, input): + return self.ops(input, self.weight0, self.weight1) + + +# Abandon all hope, ye who enter here. + + +class TestAddParamGroup(unittest.TestCase): + def setUp(self): + self.x = torch.ones((2), device='cuda', dtype=torch.float32) + common_init(self) + + def tearDown(self): + pass + + def zero_grad(self, models, optimizer, how_to_zero): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + elif how_to_zero == "optimizer": + optimizer.zero_grad() + + def test_add_param_group(self): + for opt_level in ("O0", "O1", "O2", "O3"): + for zero_before_add in (True, False): + for try_accumulation in (True, False): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + + optimizer.zero_grad() + loss = model0(self.x) + loss.backward() + optimizer.step() + + if zero_before_add: + optimizer.zero_grad() + optimizer.add_param_group({'params' : model1.parameters(), 'lr' : 0.5}) + if not zero_before_add: + optimizer.zero_grad() + + loss = model0(self.x) + model1(self.x) + loss.backward(retain_graph=try_accumulation) + if try_accumulation: + loss.backward() + optimizer.step() + + # Once more to make sure the new params pick up momemtums properly + optimizer.zero_grad() + loss = model0(self.x) + model1(self.x) + loss.backward(retain_graph=try_accumulation) + if try_accumulation: + loss.backward() + optimizer.step() + + reference_params = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + for how_to_zero in "none", "model", "optimizer": + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1], optimizer = amp.initialize([model0, model1], + optimizer, + opt_level=opt_level, + verbosity=0, + cast_model_type=False) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + + self.zero_grad([model0, model1], optimizer, how_to_zero) + loss = model0(self.x) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + + if zero_before_add: + self.zero_grad([model0, model1], optimizer, how_to_zero) + optimizer.add_param_group({'params' : model1.parameters(), 'lr' : 0.5}) + if not zero_before_add: + self.zero_grad([model0, model1], optimizer, how_to_zero) + + loss = model0(self.x) + model1(self.x) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward(retain_graph=try_accumulation) + if try_accumulation: + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + + # Once more to make sure the new params pick up momentums properly + self.zero_grad([model0, model1], optimizer, how_to_zero) + loss = model0(self.x) + model1(self.x) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward(retain_graph=try_accumulation) + if try_accumulation: + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + + final_params = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + for reference, final in zip(reference_params, final_params): + self.assertTrue(torch.allclose(reference.to(final.dtype), final), + "opt_level = {}, how_to_zero = {}, zero_before_add = {}".format( + opt_level, how_to_zero, zero_before_add)) + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_basic_casts.py b/apex/tests/L0/run_amp/test_basic_casts.py new file mode 100644 index 0000000000000000000000000000000000000000..5d4d81d1a4c09ce202c2105ce5905ef8946a423f --- /dev/null +++ b/apex/tests/L0/run_amp/test_basic_casts.py @@ -0,0 +1,143 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +import torch +from torch import nn +import torch.nn.functional as F + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +def run_layer_test(test_case, fns, expected, input_shape, test_backward=True): + for fn, typ in it.product(fns, expected.keys()): + x = torch.randn(input_shape, dtype=typ).requires_grad_() + y = fn(x) + test_case.assertEqual(y.type(), expected[typ]) + if test_backward: + y.float().sum().backward() + test_case.assertEqual(x.grad.type(), MATCH_INPUT[typ]) + +class TestBasicCasts(unittest.TestCase): + def setUp(self): + self.handle = amp.init(enabled=True) + common_init(self) + + def tearDown(self): + self.handle._deactivate() + + def test_linear_is_half(self): + m = nn.Linear(self.h, self.h) + f = ft.partial(F.linear, weight=m.weight, bias=m.bias) + run_layer_test(self, [m, f], ALWAYS_HALF, (self.b, self.h)) + + def test_conv2d_is_half(self): + m = nn.Conv2d(self.c, self.c, self.k) + f = ft.partial(F.conv2d, weight=m.weight, bias=m.bias) + run_layer_test(self, [m, f], ALWAYS_HALF, (self.b, self.c, self.h, self.h)) + + def test_softmax_is_float(self): + m = nn.Softmax(dim=1) + f = ft.partial(F.softmax, dim=1) + run_layer_test(self, [m, f], ALWAYS_FLOAT, (self.b, self.h)) + + def test_group_norm_is_float(self): + m = nn.GroupNorm(num_groups=4, num_channels=self.c) + run_layer_test(self, [m], ALWAYS_FLOAT, (self.b, self.c, self.h, self.h)) + + def test_mse_loss_is_float(self): + shape = (self.b, self.h) + target = torch.randn(shape) + mod = nn.MSELoss() + m = lambda x: mod(x, target) + f = ft.partial(F.mse_loss, target=target) + run_layer_test(self, [m], ALWAYS_FLOAT, shape) + + def test_relu_is_match(self): + run_layer_test(self, [nn.ReLU(), F.relu], MATCH_INPUT, (self.b, self.h)) + + def test_batch_norm_is_match(self): + m = nn.BatchNorm2d(num_features=self.c) + f = ft.partial(F.batch_norm, running_mean=m.running_mean, running_var=m.running_var, + weight=m.weight, bias=m.bias, training=True) + run_layer_test(self, [m], MATCH_INPUT, (self.b, self.c, self.h, self.h)) + + # Test forward-only for BN inference + m.eval() + f = ft.partial(F.batch_norm, running_mean=m.running_mean, running_var=m.running_var, + weight=m.weight, bias=m.bias, training=False) + run_layer_test(self, [m, f], MATCH_INPUT, (self.b, self.c, self.h, self.h), + test_backward=False) + +class TestBannedMethods(unittest.TestCase): + def setUp(self): + self.handle = amp.init(enabled=True) + common_init(self) + + def tearDown(self): + self.handle._deactivate() + + def bce_common(self, assertion): + shape = (self.b, self.h) + target = torch.rand(shape) + mod = nn.BCELoss() + m = lambda x: mod(x, target) + f = ft.partial(F.binary_cross_entropy, target=target) + for fn in [m, f]: + x = torch.rand(shape, dtype=torch.half) + assertion(fn, x) + + def test_bce_raises_by_default(self): + assertion = lambda fn, x: self.assertRaises(NotImplementedError, fn, x) + self.bce_common(assertion) + + def test_bce_is_float_with_allow_banned(self): + self.handle._deactivate() + self.handle = amp.init(enabled=True, allow_banned=True) + assertion = lambda fn, x: self.assertEqual(fn(x).type(), FLOAT) + self.bce_common(assertion) + +class TestTensorCasts(unittest.TestCase): + def setUp(self): + self.handle = amp.init(enabled=True) + common_init(self) + + def tearDown(self): + self.handle._deactivate() + + def test_matmul_method_is_half(self): + other = torch.randn(self.h, self.h) + lhs = lambda x: x.matmul(other) + rhs = lambda x: other.matmul(x) + run_layer_test(self, [lhs, rhs], ALWAYS_HALF, (self.h, self.h)) + + def test_matmul_op_is_half(self): + other = torch.randn(self.h, self.h) + lhs = lambda x: x @ other + rhs = lambda x: other @ x + run_layer_test(self, [lhs, rhs], ALWAYS_HALF, (self.h, self.h)) + + def test_pow_method_is_float(self): + fn = lambda x: x.pow(2.) + run_layer_test(self, [fn], ALWAYS_FLOAT, (self.b, self.h)) + + def test_pow_op_is_float(self): + fn = lambda x: x ** 2. + run_layer_test(self, [fn], ALWAYS_FLOAT, (self.b, self.h)) + + def test_cpu_is_float(self): + fn = lambda x: x.cpu() + always_cpu_float = {torch.float: 'torch.FloatTensor', + torch.half: 'torch.FloatTensor'} + run_layer_test(self, [fn], always_cpu_float, (self.b, self.h)) + + def test_sum_is_float(self): + fn = lambda x: x.sum() + run_layer_test(self, [fn], ALWAYS_FLOAT, (self.b, self.h)) + + # TODO: maybe more tests on disabled casting? + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_cache.py b/apex/tests/L0/run_amp/test_cache.py new file mode 100644 index 0000000000000000000000000000000000000000..b58d2665f7418992ca25e6da2b113a61c47ff9fb --- /dev/null +++ b/apex/tests/L0/run_amp/test_cache.py @@ -0,0 +1,137 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +from apex.amp import _amp_state +import torch +from torch import nn +import torch.nn.functional as F + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +def get_reference_grad(i, w, ops): + # Creating new tensors ensures, among other things, that the new tensors are not in the cache. + # In fact, they are guaranteed not to use the cache because they are not torch.nn.Parameters. + fp32_i = i.detach().clone().float() + fp32_w = w.detach().clone().float().requires_grad_() + loss = ops(fp32_i, fp32_w) + loss.backward() + return fp32_w.grad + +class WhitelistModule(torch.nn.Module): + def __init__(self, dtype): + super(WhitelistModule, self).__init__() + self.weight = torch.nn.Parameter(torch.arange(8*8, device='cuda', dtype=dtype).view(8,8)) + + @staticmethod + def ops(input, weight): + return (input.mm(weight)).mm(weight).sum() + + def forward(self, input): + return self.ops(input, self.weight) + + +class BlacklistModule(torch.nn.Module): + def __init__(self, dtype): + super(BlacklistModule, self).__init__() + self.weight = torch.nn.Parameter(torch.arange(2*8, device='cuda', dtype=dtype).view(2,8)) + + @staticmethod + def ops(input, weight): + return (input + torch.pow(weight, 2) + torch.pow(weight, 2)).sum() + + def forward(self, input): + return self.ops(input, self.weight) + + +class PromoteModule(torch.nn.Module): + def __init__(self, dtype): + super(PromoteModule, self).__init__() + self.weight = torch.nn.Parameter(torch.arange(2*8, device='cuda', dtype=dtype).view(2,8)) + + @staticmethod + def ops(input, weight): + return ((input*weight)*weight).sum() + + def forward(self, input): + return self.ops(input, self.weight) + +class TestCache(unittest.TestCase): + def setUp(self): + self.x = torch.ones((2, 8), device='cuda', dtype=torch.float32) + common_init(self) + + def tearDown(self): + pass + + def train_eval_train_test(self, module, t): + model = module(t).cuda() + optimizer = torch.optim.SGD(model.parameters(), lr=1.0) + + _amp_state.allow_incoming_model_not_fp32 = True + model, optimizer = amp.initialize(model, optimizer, opt_level="O1", verbosity=0) + _amp_state.allow_incoming_model_not_fp32 = False + + def training_step(): + for param in model.parameters(): + param.grad = None + + loss = model(self.x).sum() + _amp_state.loss_scalers[0]._loss_scale = 4.0 + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + + self.assertEqual(len([p.grad for p in model.parameters() if p.grad is not None]), 1) + self.assertEqual(model.weight.grad.type(), model.weight.type()) + + reference_grad = get_reference_grad(self.x, model.weight, model.ops) + + # Currently there's no difference in the allclose calls, so no need for branching, + # but I'm keeping this in case we want different tolerances for fp16 and fp32 checks. + if model.weight.grad.type() == "torch.cuda.HalfTensor": + self.assertTrue(torch.allclose(model.weight.grad.float(), reference_grad)) + elif model.weight.grad.type() == "torch.cuda.FloatTensor": + self.assertTrue(torch.allclose(model.weight.grad.float(), reference_grad)) + else: + raise RuntimeError("model.weight.grad.type = {}".format(model.weight.grad.type())) + + model.weight.data -= 1. + + # Simulates first epoch + training_step() + + # Simulates eval + with torch.no_grad(): + loss = model(self.x).sum() + + # Simulates resuming training after eval + training_step() + + _amp_state.handle._deactivate() + + # I could easily have these as a set of for loops in a single test, + # instead of going for granularity. + def test_whitelist_module_fp16_weight(self): + self.train_eval_train_test(WhitelistModule, torch.float16) + + def test_whitelist_module_fp32_weight(self): + self.train_eval_train_test(WhitelistModule, torch.float32) + + def test_blacklist_module_fp16_weight(self): + self.train_eval_train_test(BlacklistModule, torch.float16) + + def test_blacklist_module_fp32_weight(self): + self.train_eval_train_test(BlacklistModule, torch.float32) + + def test_promote_module_fp16_weight(self): + self.train_eval_train_test(PromoteModule, torch.float16) + + def test_promote_module_fp32_weight(self): + self.train_eval_train_test(PromoteModule, torch.float32) + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_checkpointing.py b/apex/tests/L0/run_amp/test_checkpointing.py new file mode 100644 index 0000000000000000000000000000000000000000..921985cd7d790e6d226a797b0c92258a33c65c78 --- /dev/null +++ b/apex/tests/L0/run_amp/test_checkpointing.py @@ -0,0 +1,267 @@ +import unittest + +import torch +import torch.nn as nn +import torch.nn.functional as F +import torch.optim as optim + +from apex import amp + + +from utils import common_init, FLOAT + + +class MyModel(torch.nn.Module): + def __init__(self): + super(MyModel, self).__init__() + self.conv1 = nn.Conv2d(3, 6, 3, 1, 1) + self.bn1 = nn.BatchNorm2d(6) + self.param = nn.Parameter(torch.randn(1)) + + def forward(self, x): + x = x * self.param + x = F.relu(self.conv1(x)) + x = self.bn1(x) + return x + + +class TestCheckpointing(unittest.TestCase): + def setUp(self): + self.initial_lr = 1e-3 + self.test_opt_levels = ("O0", "O1", "O2", "O3") + + def seed(self): + torch.manual_seed(2809) + torch.backends.cudnn.benchmark = False + torch.backends.cudnn.deterministic = True + + def check_state_dict_fp32(self, state_dict): + for key in state_dict: + if 'num_batches_tracked' in key: + continue + param = state_dict[key] + self.assertEqual(param.type(), FLOAT, + 'Parameter in state_dict not FLOAT') + + def train_step(self, model, optimizer, data, loss_ids): + optimizer.zero_grad() + + output = model(data) + + # Call backward for num_losses-1 + for idx in loss_ids: + loss = output.mean() + with amp.scale_loss(loss, optimizer, loss_id=idx) as scaled_loss: + scaled_loss.backward(retain_graph=True) + + optimizer.step() + return output + + def compare_models(self, modelA, modelB, test_setup=''): + state_dictA = modelA.state_dict() + state_dictB = modelB.state_dict() + self.assertEqual(len(state_dictA), len(state_dictB), + 'state_dicts have different lengths' + test_setup) + for key in state_dictA: + paramA = state_dictA[key] + paramB = state_dictB[key] + self.assertTrue((paramA==paramB).all(), + msg='Parameters in state_dices not equal.' + + 'key: {}\nparam: {}\nrestored: {}\ndiff: {} for {}'.format( + key, paramA, paramB, paramA - paramB, test_setup)) + + def test_restoring(self): + nb_epochs = 10 + nb_epochs_restore = nb_epochs // 2 + for opt_level in self.test_opt_levels: + for res_opt_level in self.test_opt_levels: + for amp_before_load in [True, False]: + for num_losses in range(1, 3): + test_setup = ('#' * 75 + '\n' + \ + f'opt_level {opt_level}\n' + \ + f'restore_opt_level {res_opt_level}\n' + \ + f'amp_before_load {amp_before_load}\n' + \ + f'num_losses {num_losses}\n') + + self.seed() + + # Create reference model + model = MyModel().to('cuda') + + optimizer = optim.SGD(model.parameters(), + lr=self.initial_lr) + + # Initialize with num_losses*2 for the original model and the restored one + model, optimizer = amp.initialize( + model, optimizer, opt_level=opt_level, + num_losses=num_losses*2, verbosity=0) + + # Compare training behavior for same restore option + # We cannot really generalize it, since a saved model in O0 + # would introduce a skipped step in O1, which will raise an error + if opt_level == res_opt_level: + # train for nb_epochs and restore after nb_epochs_restore + for epoch in range(nb_epochs): + + x = torch.randn(16, 3, 24, 24, device='cuda') + output = self.train_step( + model, optimizer, x, range(num_losses)) + # Initialize model one step before comparing. + # Otherwise the batchnorm layers will be updated + # additionally in restore_model + if epoch == (nb_epochs_restore - 1): + # Load model and optimizer + checkpoint = { + 'model': model.state_dict(), + 'optimizer': optimizer.state_dict(), + 'amp': amp.state_dict() + } + # Check state_dict for FP32 tensors + self.check_state_dict_fp32(checkpoint['model']) + + # Restore model + restore_model = MyModel().to('cuda') + restore_optimizer = optim.SGD( + restore_model.parameters(), + lr=self.initial_lr) + + if amp_before_load: + restore_model, restore_optimizer = amp.initialize( + restore_model, + restore_optimizer, + opt_level=res_opt_level, + num_losses=num_losses*2, + verbosity=0) + + restore_model.load_state_dict(checkpoint['model']) + restore_optimizer.load_state_dict(checkpoint['optimizer']) + # FIXME: We cannot test the amp.state_dict in the same script + # amp.load_state_dict(checkpoint['amp']) + + if not amp_before_load: + restore_model, restore_optimizer = amp.initialize( + restore_model, + restore_optimizer, + opt_level=res_opt_level, + num_losses=num_losses*2, + verbosity=0) + + elif epoch >= nb_epochs_restore: + restore_output = self.train_step( + restore_model, + restore_optimizer, + x, + range(num_losses, num_losses*2)) + self.assertTrue( + torch.allclose(output.float(), restore_output.float()), + 'Output of reference and restored models differ for ' + test_setup) + self.compare_models(model, restore_model, test_setup) + # if opt_level != res_opt_level + else: + # skip tests for different opt_levels + continue + + def test_loss_scale_decrease(self): + num_losses = 3 + nb_decrease_loss_scales = [0, 1, 2] + for opt_level in self.test_opt_levels: + #print('#' * 75 + f'\n opt_level {opt_level}\n') + # Create new tmp copy for this run + nb_decrease_loss_scales_tmp = list(nb_decrease_loss_scales) + + model = MyModel().to('cuda') + + optimizer = optim.SGD(model.parameters(), + lr=self.initial_lr) + + model, optimizer = amp.initialize( + model, optimizer, opt_level=opt_level, num_losses=num_losses, + verbosity=0) + + if amp._amp_state.opt_properties.loss_scale != 'dynamic': + #print('Static loss scale set. Skipping opt_level.') + continue + + # force to skip some updates to decrease the loss_scale + initial_loss_scales = [] + for idx in range(num_losses): + initial_loss_scales.append( + amp._amp_state.loss_scalers[idx].loss_scale()) + + for _ in range(len(nb_decrease_loss_scales)): + x = torch.randn(16, 3, 24, 24, device='cuda') + for idx in range(num_losses): + while nb_decrease_loss_scales_tmp[idx] > 0: + optimizer.zero_grad() + output = model(x * 2**17) + loss = output.mean() + + with amp.scale_loss(loss, optimizer, loss_id=idx) as scaled_loss: + scaled_loss.backward(retain_graph=True) + optimizer.step() + nb_decrease_loss_scales_tmp[idx] -= 1 + + # Check loss scales afterwards + updated_loss_scales = [] + for idx in range(num_losses): + updated_loss_scales.append( + amp._amp_state.loss_scalers[idx].loss_scale()) + for factor, update_ls, init_ls in zip(nb_decrease_loss_scales, + updated_loss_scales, + initial_loss_scales): + self.assertEqual(update_ls, init_ls / 2**factor) + + # Check state dict + amp_state_dict = amp.state_dict() + for scaler_idx, factor, init_ls in zip(amp_state_dict, + nb_decrease_loss_scales, + initial_loss_scales): + scaler = amp_state_dict[scaler_idx] + self.assertEqual(scaler['loss_scale'], init_ls / 2**factor) + unskipped_target = 0 + self.assertEqual(scaler['unskipped'], unskipped_target) + + def test_state_dict(self): + for opt_level in self.test_opt_levels: + # Skip O3 + if opt_level == 'O3': + continue + + model = MyModel().to('cuda') + optimizer = optim.Adam(model.parameters(), lr=1e-3) + model, optimizer = amp.initialize( + model, optimizer, opt_level=opt_level, verbosity=0) + + # Export state_dict and check for Half + state_dict = model.state_dict() + for key in state_dict: + self.assertFalse('Half' in state_dict[key].type()) + + # Check, if model is still trainable + # Create dummy data + data = torch.randn(10, 3, 4, 4, device='cuda') + target = torch.randn(10, 6, 4, 4, device='cuda') + + # Get initnial loss + optimizer.zero_grad() + output = model(data) + loss = F.mse_loss(output, target) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + last_loss = loss.item() + + # train for some epochs + for epoch in range(10): + optimizer.zero_grad() + output = model(data) + loss = F.mse_loss(output, target) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + self.assertTrue(loss.item() < last_loss) + last_loss = loss.item() + +if __name__=='__main__': + unittest.main() + diff --git a/apex/tests/L0/run_amp/test_fused_sgd.py b/apex/tests/L0/run_amp/test_fused_sgd.py new file mode 100644 index 0000000000000000000000000000000000000000..7f592128d5192b43b3176788010343a6a10863c5 --- /dev/null +++ b/apex/tests/L0/run_amp/test_fused_sgd.py @@ -0,0 +1,794 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +from apex.amp import _amp_state +import torch +from torch import nn +import torch.nn.functional as F +from torch.nn import Parameter + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + + +try: + import amp_C + disabled = False + from apex.optimizers import FusedSGD as FusedSGD +except ImportError as err: + print("amp_C fused kernels unavailable, disabling TestMultiTensorApply. ImportError was ", err) + disabled = True + + +class MyModel(torch.nn.Module): + def __init__(self, unique): + super(MyModel, self).__init__() + self.weight0 = Parameter(unique + + torch.arange(2, device='cuda', dtype=torch.float32)) + self.weight1 = Parameter(1. + unique + torch.arange(2, device='cuda', dtype=torch.float16)) + + @staticmethod + def ops(input, weight0, weight1): + return ((input*(weight0.float()))*(weight1.float())).sum() + + def forward(self, input): + return self.ops(input, self.weight0, self.weight1) + +# Abandon all hope, ye who enter here. + +# This is hands down the ugliest code I have ever written, but it succeeds in testing +# multiple models/optimizers/losses fairly thoroughly. Many of the different test cases +# require slightly divergent code in a way that seems near-impossible to genericize into a simple +# cross product or nested loops. + +class TestMultipleModelsOptimizersLosses(unittest.TestCase): + def setUp(self): + self.x = torch.ones((2), device='cuda', dtype=torch.float32) + common_init(self) + + def tearDown(self): + pass + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_2models2losses1optimizer(self): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.125) + + reference_grads = [] + for i in range(2): + optimizer.zero_grad() + loss0 = model0(self.x) + loss1 = model1(self.x) + loss0.backward() + loss1.backward() + + reference_grads.append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + optimizer.step() + + final_params = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + for materialize_master_grads in (False, True): + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (False, True): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + else: + iters = 2 + + model0 = MyModel(1) + model1 = MyModel(2) + + models = [model0, model1] + + optimizer = FusedSGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.125, + materialize_master_grads=materialize_master_grads) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1], optimizer = amp.initialize( + [model0, model1], + optimizer, + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer.zero_grad() + + loss0 = model0(self.x) + loss1 = model1(self.x) + + with amp.scale_loss(loss0, optimizer, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if inject_inf_loc == "fp32": + model0.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model0.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, optimizer, loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if inject_inf_loc == "fp32": + model1.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model1.weight1.grad[0] = float('inf') + + if i != inject_inf: + master_params = amp.master_params(optimizer) + for param, reference_grad in zip(master_params, reference_grads[unskipped]): + if opt_level == "O2" and not materialize_master_grads: + continue + else: + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float()), + "opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} use_multiple_loss_scalers {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, use_multiple_loss_scalers)) + unskipped += 1 + optimizer.step() + + model_params = [p for p in model0.parameters()] + [p for p in model1.parameters()] + for model, master, reference in zip( + model_params, + amp.master_params(optimizer), + final_params): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_3models2losses1optimizer(self): + + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}, + {'params' : model2.parameters(), 'lr' : 0.125}], + momentum=0.125) + + reference_grads = [] + for i in range(2): + optimizer.zero_grad() + loss0 = model0(self.x) + model2(self.x) + loss1 = model1(self.x) + model2(self.x) + loss0.backward() + loss1.backward() + + reference_grads.append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()] + + [param.grad.data.clone() for param in model2.parameters()]) + + optimizer.step() + + + final_params = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + \ + [param.data.clone() for param in model2.parameters()] + + for materialize_master_grads in (False, True): + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (False, True): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + if which_backward == 0: + which_models = (0, 2) + elif which_backward == 1: + which_models = (1, 2) + else: + iters = 2 + which_models = (None,) + + for which_model in which_models: + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + models = [model0, model1, model2] + + optimizer = FusedSGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}, + {'params' : model2.parameters(), 'lr' : 0.125}], + momentum=0.125, + materialize_master_grads=materialize_master_grads) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1, model2], optimizer = amp.initialize( + [model0, model1, model2], + optimizer, + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer.zero_grad() + + loss0 = model0(self.x) + model2(self.x) + loss1 = model1(self.x) + model2(self.x) + + with amp.scale_loss(loss0, optimizer, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if which_model == 0: + inj_model = model0 + elif which_model == 2: + inj_model = model2 + else: + raise RuntimeError(which_model + " invalid for loss 0") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, optimizer, loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if which_model == 1: + inj_model = model1 + elif which_model == 2: + inj_model = model2 + else: + raise RuntimeError(which_model + " invalid for loss 1 ") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + + if i != inject_inf: + master_params = amp.master_params(optimizer) + for param, reference_grad in zip(master_params, reference_grads[unskipped]): + if opt_level == "O2" and not materialize_master_grads: + continue + else: + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float()), + "opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} which_model {} use_multiple_loss_scalers {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, which_model, use_multiple_loss_scalers)) + unskipped += 1 + + optimizer.step() + + model_params = [p for p in model0.parameters()] + \ + [p for p in model1.parameters()] + \ + [p for p in model2.parameters()] + for model, master, reference in zip( + model_params, + amp.master_params(optimizer), + final_params): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_2models2losses2optimizers(self): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + optimizer1 = torch.optim.SGD([{'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.25) + + # Don't do it like this: reference_grads = [[]]*5 + # because then it creates a list of 5 references to the same "[]" and appending + # to any of them effectively makes you append to all of them, which multiplies + # the resulting size of reference_grads by 5x and needless to say makes the test fail. + reference_grads = [[], [], [], [], []] + final_params = [None, None, None, None, None] + for i in range(2): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + loss1 = model1(self.x) + loss0.backward() + loss1.backward() + + reference_grads[0].append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + optimizer0.step() + optimizer1.step() + + final_params[0] = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + def what_got_skipped(which_iter, which_backward): + if which_iter == 0 and which_backward == 0: + return 1 + if which_iter == 0 and which_backward == 1: + return 2 + if which_iter == 1 and which_backward == 0: + return 3 + if which_iter == 1 and which_backward == 1: + return 4 + return 0 + + for which_iter in (0,1): + for which_backward in (0,1): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + optimizer1 = torch.optim.SGD([{'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.25) + + for i in range(3): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + loss1 = model1(self.x) + loss0.backward() + loss1.backward() + + if i != which_iter: + reference_grads[what_got_skipped(which_iter, which_backward)].append( + [param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + if i == which_iter: + if which_backward == 0: + optimizer1.step() + else: + optimizer0.step() + else: + optimizer0.step() + optimizer1.step() + + final_params[what_got_skipped(which_iter, which_backward)] = \ + [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + for materialize_master_grads in (False, True): + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (False, True): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + else: + iters = 2 + + model0 = MyModel(1) + model1 = MyModel(2) + + models = [model0, model1] + + optimizer0 = FusedSGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125, materialize_master_grads=materialize_master_grads) + optimizer1 = FusedSGD([{'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.25, materialize_master_grads=materialize_master_grads) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1], [optimizer0, optimizer1] = amp.initialize( + [model0, model1], + [optimizer0, optimizer1], + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer0.zero_grad() + optimizer1.zero_grad() + + loss0 = model0(self.x) + loss1 = model1(self.x) + + with amp.scale_loss(loss0, optimizer0, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if inject_inf_loc == "fp32": + model0.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model0.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, optimizer1, loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if inject_inf_loc == "fp32": + model1.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model1.weight1.grad[0] = float('inf') + + # print("opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} use_multiple_loss_scalers {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, use_multiple_loss_scalers)) + + if i != inject_inf: + master_params = list(amp.master_params(optimizer0)) + \ + list(amp.master_params(optimizer1)) + for param, reference_grad in zip(master_params, + reference_grads[what_got_skipped(inject_inf, which_backward)][unskipped]): + if opt_level == "O2" and not materialize_master_grads: + continue + else: + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float())) + unskipped += 1 + + optimizer0.step() + optimizer1.step() + + model_params = [p for p in model0.parameters()] + [p for p in model1.parameters()] + master_params = [p for p in amp.master_params(optimizer0)] + \ + [p for p in amp.master_params(optimizer1)] + for model, master, reference in zip( + model_params, + master_params, + final_params[what_got_skipped(inject_inf, which_backward)]): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_3models2losses2optimizers(self): + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 1.0}], + momentum=0.5) + optimizer1 = torch.optim.SGD([{'params' : model2.parameters(), 'lr' : 0.5}], + momentum=0.25) + + # Again, can't do this: reference_grads = [[]]*9 + reference_grads = [[], [], [], [], [], [], [], [], []] + final_params = [None, None, None, None, None, None, None, None, None] + for i in range(2): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + model1(self.x) + loss1 = model2(self.x) + model1(self.x) + loss0.backward() + loss1.backward() + + reference_grads[0].append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + optimizer0.step() + optimizer1.step() + + final_params[0] = \ + [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + \ + [param.data.clone() for param in model2.parameters()] + + def what_got_skipped(which_iter, which_backward, which_model): + if which_iter == 0: + if which_backward == 0: + if which_model == 0: + return 1 + if which_model == 1: + return 2 + if which_backward == 1: + if which_model == 2: + return 3 + if which_model == 1: + return 4 + if which_iter == 1: + if which_backward == 0: + if which_model == 0: + return 5 + if which_model == 1: + return 6 + if which_backward == 1: + if which_model == 2: + return 7 + if which_model == 1: + return 8 + return 0 + + for which_iter in (0,1): + for which_backward in (0,1): + if which_backward == 0: + which_models = (0,1) + if which_backward == 1: + which_models = (2,1) + for which_model in which_models: + + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 1.0}], + momentum=0.5) + optimizer1 = torch.optim.SGD([{'params' : model2.parameters(), 'lr' : 0.5}], + momentum=0.25) + + for i in range(3): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + model1(self.x) + loss1 = model2(self.x) + model1(self.x) + loss0.backward() + loss1.backward() + + if i != which_iter: + reference_grads[what_got_skipped(which_iter, + which_backward, which_model)].append( + [param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + if i == which_iter: + if which_backward == 0: + # if which_model == 0: + optimizer1.step() + # if which_model == 1: + # optimizer1.step() + if which_backward == 1: + # if which_model == 2: + # optimizer0.step() + # if which_model == 1: + continue + else: + optimizer0.step() + optimizer1.step() + + final_params[what_got_skipped(which_iter, which_backward, which_model)] = \ + [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + \ + [param.data.clone() for param in model2.parameters()] + + for materialize_master_grads in (False, True): + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (False, True): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + if which_backward == 0: + which_models = (0, 1) + elif which_backward == 1: + which_models = (2, 1) + else: + iters = 2 + which_models = (None,) + + for which_model in which_models: + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + models = [model0, model1, model2] + + optimizer0 = FusedSGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 1.0}], + momentum=0.5, materialize_master_grads=materialize_master_grads) + optimizer1 = FusedSGD([{'params' : model2.parameters(), 'lr' : 0.5}], + momentum=0.25, materialize_master_grads=materialize_master_grads) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1, model2], [optimizer0, optimizer1] = amp.initialize( + [model0, model1, model2], + [optimizer0, optimizer1], + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer0.zero_grad() + optimizer1.zero_grad() + + loss0 = model0(self.x) + model1(self.x) + loss1 = model2(self.x) + model1(self.x) + + with amp.scale_loss(loss0, optimizer0, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if which_model == 0: + inj_model = model0 + elif which_model == 1: + inj_model = model1 + else: + raise RuntimeError(which_model + " invalid for loss 0") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, [optimizer0, optimizer1], loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if which_model == 2: + inj_model = model2 + elif which_model == 1: + inj_model = model1 + else: + raise RuntimeError(which_model + " invalid for loss 1 ") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + + if i != inject_inf: + master_params = list(amp.master_params(optimizer0)) + \ + list(amp.master_params(optimizer1)) + for param, reference_grad in zip(master_params, + reference_grads[what_got_skipped(inject_inf, + which_backward, which_model)][unskipped]): + if opt_level == "O2" and not materialize_master_grads: + continue + else: + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float())) + unskipped += 1 + + optimizer0.step() + optimizer1.step() + + model_params = [p for p in model0.parameters()] + \ + [p for p in model1.parameters()] + \ + [p for p in model2.parameters()] + master_params = [p for p in amp.master_params(optimizer0)] + \ + [p for p in amp.master_params(optimizer1)] + + # print("opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} use_multiple_loss_scalers {} which_model {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, use_multiple_loss_scalers, which_model)) + + for model, master, reference in zip( + model_params, + master_params, + final_params[what_got_skipped(inject_inf, which_backward, which_model)]): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_larc.py b/apex/tests/L0/run_amp/test_larc.py new file mode 100644 index 0000000000000000000000000000000000000000..f4f3e838f6a51be799b037c0df4c8fcade8075a3 --- /dev/null +++ b/apex/tests/L0/run_amp/test_larc.py @@ -0,0 +1,53 @@ +import unittest + +import torch +from torch import nn +from torch.nn import Parameter + +from apex import amp +from apex.parallel.LARC import LARC +from utils import common_init + + +class MyModel(torch.nn.Module): + def __init__(self, unique): + super(MyModel, self).__init__() + self.weight0 = Parameter( + unique + torch.arange(2, device="cuda", dtype=torch.float32) + ) + + def forward(self, input): + return (input * self.weight0).sum() + + +class TestLARC(unittest.TestCase): + def setUp(self): + self.x = torch.ones((2), device="cuda", dtype=torch.float32) + common_init(self) + + def tearDown(self): + pass + + def test_larc_mixed_precision(self): + for opt_level in ["O0", "O1", "O2", "O3"]: + model = MyModel(1) + + optimizer = LARC( + torch.optim.SGD( + [{"params": model.parameters(), "lr": 0.25}], momentum=0.125 + ) + ) + + model, optimizer = amp.initialize( + model, optimizer, opt_level=opt_level, verbosity=0 + ) + + optimizer.zero_grad() + loss = model(self.x) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + + +if __name__ == "__main__": + unittest.main() diff --git a/apex/tests/L0/run_amp/test_multi_tensor_axpby.py b/apex/tests/L0/run_amp/test_multi_tensor_axpby.py new file mode 100644 index 0000000000000000000000000000000000000000..0b439bb8d9770d58b2276a0790d5c305f3c6334d --- /dev/null +++ b/apex/tests/L0/run_amp/test_multi_tensor_axpby.py @@ -0,0 +1,180 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +import torch +from torch import nn +import torch.nn.functional as F +from math import floor + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +try: + import amp_C + from amp_C import multi_tensor_axpby + from apex.multi_tensor_apply import MultiTensorApply + disabled = False +except ImportError as err: + print("amp_C fused kernels unavailable, disabling TestMultiTensorApply. ImportError was ", err) + disabled = True + +TORCH_MAJOR = int(torch.__version__.split('.')[0]) +TORCH_MINOR = int(torch.__version__.split('.')[1]) +try_nhwc = (TORCH_MAJOR > 1) or (TORCH_MAJOR == 1 and TORCH_MINOR > 4) + + +class TestMultiTensorAxpby(unittest.TestCase): + + def setUp(self): + common_init(self) + + self.a = 2.0 + self.b = 8.0 + self.xval = 4.0 + self.yval = 16.0 + self.overflow_buf = torch.cuda.IntTensor(1).zero_() + self.ref = torch.full((1,), 136.0, device="cuda", dtype=torch.float32) + + def tearDown(self): + pass + + # The tensor creation here is written for convenience, not speed. + def axpby(self, sizea, sizeb, applier, repeat_tensors, + x_type, y_type, out_type, inplace=False, nhwc=False): + self.overflow_buf.zero_() + sizea = sizea if isinstance(sizea, tuple) else (sizea,) + sizeb = sizeb if isinstance(sizeb, tuple) else (sizeb,) + t1 = torch.full(sizea, 1.0, device="cuda", dtype=torch.float32) + t2 = torch.full(sizeb, 1.0, device="cuda", dtype=torch.float32) + + def to_fmt(t, tp): + if nhwc: + return t.clone().to(tp, memory_format=torch.channels_last) + else: + return t.clone().to(tp) + + y_list = [] + for i in range(repeat_tensors): + y_list += [to_fmt(t1, y_type)*self.yval, to_fmt(t2, y_type)*self.yval] + + x_list = [to_fmt(x, x_type)*(self.xval/self.yval) for x in y_list] + + if inplace: + out_list = y_list + else: + out_list = [to_fmt(out, out_type)*3.0 for out in y_list] + + applier(multi_tensor_axpby, self.overflow_buf, [x_list, y_list, out_list], self.a, self.b, -1) + + self.assertTrue(all([torch.allclose(out, self.ref.to(out_type)) for out in out_list]), + msg="{} {} {} {} {} {} {}".format(sizea, sizeb, repeat_tensors, + x_type, y_type, out_type, inplace)) + self.assertTrue(self.overflow_buf.item() == 0, + msg="{} {} {} {} {} {} {}".format(sizea, sizeb, repeat_tensors, + x_type, y_type, out_type, inplace)) + + # def find_inf(self, sizea, sizeb, applier, repeat_tensors, in_type, out_type, t, ind, val, inplace=False): + # self.overflow_buf.zero_() + # a = torch.cuda.FloatTensor(sizea).fill_(self.scale) + # b = torch.cuda.FloatTensor(sizeb).fill_(self.scale) + + # out_list = [] + # for i in range(repeat_tensors): + # out_list += [a.clone().to(out_type), b.clone().to(out_type)] + + # if inplace: + # in_list = out_list + # else: + # in_list = [out.clone().to(in_type) for out in out_list] + + # applier(multi_tensor_scale, self.overflow_buf, [in_list, out_list], 1./self.scale) + + # self.overflow_buf.zero_() + # in_list[t][ind] = val + # applier(multi_tensor_scale, self.overflow_buf, [in_list, out_list], 1./self.scale) + # self.assertTrue(self.overflow_buf.item()) + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_fuzz(self): + input_size_pairs = ( + (7777*77, 555*555), + (777, 555), + (555, 2048*32+1), + (2048*32+1, 555), + (555, 2048*32), + (2048*32, 555), + (33333, 555), + (555, 33333)) + appliers = ( + MultiTensorApply(2048*32), + MultiTensorApply(333), + MultiTensorApply(33333)) + repeat_tensors = ( + 1, + 55) + + for sizea, sizeb in input_size_pairs: + for applier in appliers: + for repeat in repeat_tensors: + for x_type in (torch.float32, torch.float16): + for y_type in (torch.float32, torch.float16): + for out_type in (torch.float32, torch.float16): + for inplace in (True, False): + if inplace is True and (y_type is not out_type): + continue + else: + self.axpby(sizea, sizeb, applier, repeat, + x_type, y_type, out_type, inplace=inplace) + # self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + # 0, 0, float('nan'), inplace=inplace) + # self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + # 2*repeat-1, sizeb-1, float('inf'), inplace=inplace) + # self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + # 2*(repeat//2), sizea//2, float('inf'), inplace=inplace) + + @unittest.skipIf(disabled, "amp_C is unavailable") + @unittest.skipIf(not try_nhwc, "torch version is 1.4 or earlier, may not support nhwc") + def test_fuzz_nhwc(self): + input_size_pairs = ( + ((7, 77, 7, 77), (5, 55, 5, 55)), + ((1, 1, 777, 1), (1, 1, 555, 1)), + ((5, 47, 5, 55), (1, 1, 1, 2048*32 + 1)), + ((1, 1, 1, 2048*32 + 1), (55, 47, 5, 55)), + ((555, 1, 1, 1), (32, 8, 32, 8)), + ((32, 8, 32, 8), (55, 47, 5, 55)), + ((1, 1, 33333, 1), (55, 47, 55, 5)), + ((55, 47, 55, 5), (1, 1, 33333, 1))) + appliers = ( + MultiTensorApply(2048*32), + MultiTensorApply(333), + MultiTensorApply(33333)) + repeat_tensors = ( + 1, + 55) + + for sizea, sizeb in input_size_pairs: + for applier in appliers: + for repeat in repeat_tensors: + for x_type in (torch.float32, torch.float16): + for y_type in (torch.float32, torch.float16): + for out_type in (torch.float32, torch.float16): + for inplace in (True, False): + if inplace is True and (y_type is not out_type): + continue + else: + self.axpby(sizea, sizeb, applier, repeat, + x_type, y_type, out_type, inplace=inplace, nhwc=True) + # self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + # 0, 0, float('nan'), inplace=inplace) + # self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + # 2*repeat-1, sizeb-1, float('inf'), inplace=inplace) + # self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + # 2*(repeat//2), sizea//2, float('inf'), inplace=inplace) + + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_multi_tensor_l2norm.py b/apex/tests/L0/run_amp/test_multi_tensor_l2norm.py new file mode 100644 index 0000000000000000000000000000000000000000..ed3cbd1956c99b68a0a873f5c8dcc4bb27d55e7f --- /dev/null +++ b/apex/tests/L0/run_amp/test_multi_tensor_l2norm.py @@ -0,0 +1,87 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +import torch +from torch import nn +import torch.nn.functional as F + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +try: + import amp_C + from amp_C import multi_tensor_l2norm + from apex.multi_tensor_apply import MultiTensorApply + disabled = False +except ImportError as err: + print("amp_C fused kernels unavailable, disabling TestMultiTensorApply. ImportError was ", err) + disabled = True + + +class TestMultiTensorL2Norm(unittest.TestCase): + + def setUp(self): + common_init(self) + self.val = 4.0 + self.overflow_buf = torch.cuda.IntTensor(1).zero_() + + def tearDown(self): + pass + + # The tensor creation here is written for convenience, not speed. + def l2norm(self, sizea, sizeb, applier, repeat_tensors, in_type, per_tensor): + self.overflow_buf.zero_() + a = torch.cuda.FloatTensor(sizea).fill_(self.val) + b = torch.cuda.FloatTensor(sizeb).fill_(self.val) + + in_list = [] + for i in range(repeat_tensors): + in_list += [a.clone().to(in_type), b.clone().to(in_type)] + + if per_tensor: + norm, norm_per_tensor = applier(multi_tensor_l2norm, self.overflow_buf, [in_list], True) + normab = torch.cat((a.norm().view(1), b.norm().view(1))) + norm_per_tensor = norm_per_tensor.view(-1, 2) + else: + norm, _ = applier(multi_tensor_l2norm, self.overflow_buf, [in_list], True) + + reference = torch.cuda.FloatTensor((sizea + sizeb)*repeat_tensors).fill_(self.val).norm() + + self.assertTrue(torch.allclose(norm, reference)) + if per_tensor: + self.assertTrue(torch.allclose(norm_per_tensor, normab)) + self.assertTrue(self.overflow_buf.item() == 0) + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_fuzz(self): + input_size_pairs = ( + (7777*77, 555*555), + (777, 555), + (555, 2048*32+1), + (2048*32+1, 555), + (555, 2048*32), + (2048*32, 555), + (33333, 555), + (555, 33333)) + appliers = ( + MultiTensorApply(2048*32), + MultiTensorApply(333), + MultiTensorApply(33333)) + repeat_tensors = ( + 1, + 55) + + for sizea, sizeb in input_size_pairs: + for applier in appliers: + for repeat in repeat_tensors: + for in_type in (torch.float32, torch.float16): + for per_tensor in (False, True): + self.l2norm(sizea, sizeb, applier, repeat, in_type, per_tensor) + + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_multi_tensor_scale.py b/apex/tests/L0/run_amp/test_multi_tensor_scale.py new file mode 100644 index 0000000000000000000000000000000000000000..22da2490c6c40b67bf6d4ff7f18f1b1b640d266b --- /dev/null +++ b/apex/tests/L0/run_amp/test_multi_tensor_scale.py @@ -0,0 +1,126 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +import torch +from torch import nn +import torch.nn.functional as F + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +try: + import amp_C + from amp_C import multi_tensor_scale + from apex.multi_tensor_apply import MultiTensorApply + disabled = False +except ImportError as err: + print("amp_C fused kernels unavailable, disabling TestMultiTensorApply. ImportError was ", err) + disabled = True + + +class TestMultiTensorScale(unittest.TestCase): + + def setUp(self): + common_init(self) + self.scale = 4.0 + self.overflow_buf = torch.cuda.IntTensor(1).zero_() + self.ref = torch.cuda.FloatTensor([1.0]) + + def tearDown(self): + pass + + # The tensor creation here is written for convenience, not speed. + def downscale(self, sizea, sizeb, applier, repeat_tensors, in_type, out_type, inplace=False): + self.overflow_buf.zero_() + a = torch.cuda.FloatTensor(sizea).fill_(self.scale) + b = torch.cuda.FloatTensor(sizeb).fill_(self.scale) + + out_list = [] + for i in range(repeat_tensors): + out_list += [a.clone().to(out_type), b.clone().to(out_type)] + + if inplace: + in_list = out_list + else: + in_list = [out.clone().to(in_type) for out in out_list] + + applier(multi_tensor_scale, self.overflow_buf, [in_list, out_list], 1./self.scale) + + self.assertTrue(all([torch.allclose(out, self.ref.to(out_type)) for out in out_list])) + self.assertTrue(self.overflow_buf.item() == 0) + + def find_inf(self, sizea, sizeb, applier, repeat_tensors, in_type, out_type, t, ind, val, inplace=False): + self.overflow_buf.zero_() + a = torch.cuda.FloatTensor(sizea).fill_(self.scale) + b = torch.cuda.FloatTensor(sizeb).fill_(self.scale) + + out_list = [] + for i in range(repeat_tensors): + out_list += [a.clone().to(out_type), b.clone().to(out_type)] + + if inplace: + in_list = out_list + else: + in_list = [out.clone().to(in_type) for out in out_list] + + applier(multi_tensor_scale, self.overflow_buf, [in_list, out_list], 1./self.scale) + + self.overflow_buf.zero_() + in_list[t][ind] = val + applier(multi_tensor_scale, self.overflow_buf, [in_list, out_list], 1./self.scale) + self.assertTrue(self.overflow_buf.item()) + + # Currently, the fused kernel gives a hard error if you attempt to downscale + # into fp16 output, which imo is the desired behavior. Maybe someday we + # will learn otherwise. + # @unittest.skipIf(disabled, "amp_C is unavailable") + # def test_fp16_to_fp16(self): + # self.downscale(self.fp16, self.fp16, self.fp16_ref) + # + # @unittest.skipIf(disabled, "amp_C is unavailable") + # def test_fp32_to_fp16(self): + # self.downscale(self.fp32, self.fp16, self.fp16_ref) + + @unittest.skipIf(disabled, "amp_C is unavailable") + def test_fuzz(self): + input_size_pairs = ( + (7777*77, 555*555), + (777, 555), + (555, 2048*32+1), + (2048*32+1, 555), + (555, 2048*32), + (2048*32, 555), + (33333, 555), + (555, 33333)) + appliers = ( + MultiTensorApply(2048*32), + MultiTensorApply(333), + MultiTensorApply(33333)) + repeat_tensors = ( + 1, + 55) + + for sizea, sizeb in input_size_pairs: + for applier in appliers: + for repeat in repeat_tensors: + for in_type in (torch.float32, torch.float16): + for out_type in (torch.float32, torch.float16): + for inplace in (True, False): + if inplace is True and (out_type is not in_type): + continue + else: + self.downscale(sizea, sizeb, applier, repeat, in_type, out_type, inplace=inplace) + self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + 0, 0, float('nan'), inplace=inplace) + self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + 2*repeat-1, sizeb-1, float('inf'), inplace=inplace) + self.find_inf(sizea, sizeb, applier, repeat, in_type, out_type, + 2*(repeat//2), sizea//2, float('inf'), inplace=inplace) + + + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_multiple_models_optimizers_losses.py b/apex/tests/L0/run_amp/test_multiple_models_optimizers_losses.py new file mode 100644 index 0000000000000000000000000000000000000000..068c845375f5f909abced39ec84f4f92e1c2a6fc --- /dev/null +++ b/apex/tests/L0/run_amp/test_multiple_models_optimizers_losses.py @@ -0,0 +1,762 @@ +import unittest + +import functools as ft +import itertools as it + +from apex import amp +from apex.amp import _amp_state +import torch +from torch import nn +import torch.nn.functional as F +from torch.nn import Parameter + +from utils import common_init, HALF, FLOAT,\ + ALWAYS_HALF, ALWAYS_FLOAT, MATCH_INPUT + +class MyModel(torch.nn.Module): + def __init__(self, unique): + super(MyModel, self).__init__() + self.weight0 = Parameter(unique + + torch.arange(2, device='cuda', dtype=torch.float32)) + self.weight1 = Parameter(1. + unique + torch.arange(2, device='cuda', dtype=torch.float16)) + + @staticmethod + def ops(input, weight0, weight1): + return ((input*(weight0.float()))*(weight1.float())).sum() + + def forward(self, input): + return self.ops(input, self.weight0, self.weight1) + +# Abandon all hope, ye who enter here. + +# This is hands down the ugliest code I have ever written, but it succeeds in testing +# multiple models/optimizers/losses fairly thoroughly. Many of the different test cases +# require slightly divergent code in a way that seems near-impossible to genericize into a simple +# cross product or nested loops. + +class TestMultipleModelsOptimizersLosses(unittest.TestCase): + def setUp(self): + self.x = torch.ones((2), device='cuda', dtype=torch.float32) + common_init(self) + + def tearDown(self): + pass + + def test_2models2losses1optimizer(self): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.125) + + reference_grads = [] + for i in range(2): + optimizer.zero_grad() + loss0 = model0(self.x) + loss1 = model1(self.x) + loss0.backward() + loss1.backward() + + reference_grads.append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + optimizer.step() + + final_params = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (True, False): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + else: + iters = 2 + + model0 = MyModel(1) + model1 = MyModel(2) + + models = [model0, model1] + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.125) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1], optimizer = amp.initialize( + [model0, model1], + optimizer, + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer.zero_grad() + + loss0 = model0(self.x) + loss1 = model1(self.x) + + with amp.scale_loss(loss0, optimizer, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if inject_inf_loc == "fp32": + model0.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model0.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, optimizer, loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if inject_inf_loc == "fp32": + model1.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model1.weight1.grad[0] = float('inf') + + if i != inject_inf: + for param, reference_grad in zip(amp.master_params(optimizer), + reference_grads[unskipped]): + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float())) + unskipped += 1 + optimizer.step() + + model_params = [p for p in model0.parameters()] + [p for p in model1.parameters()] + for model, master, reference in zip( + model_params, + amp.master_params(optimizer), + final_params): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + + def test_3models2losses1optimizer(self): + + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}, + {'params' : model2.parameters(), 'lr' : 0.125}], + momentum=0.125) + + reference_grads = [] + for i in range(2): + optimizer.zero_grad() + loss0 = model0(self.x) + model2(self.x) + loss1 = model1(self.x) + model2(self.x) + loss0.backward() + loss1.backward() + + reference_grads.append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()] + + [param.grad.data.clone() for param in model2.parameters()]) + + optimizer.step() + + + final_params = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + \ + [param.data.clone() for param in model2.parameters()] + + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (True, False): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + if which_backward == 0: + which_models = (0, 2) + elif which_backward == 1: + which_models = (1, 2) + else: + iters = 2 + which_models = (None,) + + for which_model in which_models: + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + models = [model0, model1, model2] + + optimizer = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 0.5}, + {'params' : model2.parameters(), 'lr' : 0.125}], + momentum=0.125) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1, model2], optimizer = amp.initialize( + [model0, model1, model2], + optimizer, + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer.zero_grad() + + # print("opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} which_model {} use_multiple_loss_scalers {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, which_model, use_multiple_loss_scalers)) + + loss0 = model0(self.x) + model2(self.x) + loss1 = model1(self.x) + model2(self.x) + + with amp.scale_loss(loss0, optimizer, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if which_model == 0: + inj_model = model0 + elif which_model == 2: + inj_model = model2 + else: + raise RuntimeError(which_model + " invalid for loss 0") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, optimizer, loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if which_model == 1: + inj_model = model1 + elif which_model == 2: + inj_model = model2 + else: + raise RuntimeError(which_model + " invalid for loss 1 ") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + + if i != inject_inf: + for param, reference_grad in zip(amp.master_params(optimizer), + reference_grads[unskipped]): + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float())) + unskipped += 1 + + optimizer.step() + + model_params = [p for p in model0.parameters()] + \ + [p for p in model1.parameters()] + \ + [p for p in model2.parameters()] + for model, master, reference in zip( + model_params, + amp.master_params(optimizer), + final_params): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + + def test_2models2losses2optimizers(self): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + optimizer1 = torch.optim.SGD([{'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.25) + + # Don't do it like this: reference_grads = [[]]*5 + # because then it creates a list of 5 references to the same "[]" and appending + # to any of them effectively makes you append to all of them, which multiplies + # the resulting size of reference_grads by 5x and needless to say makes the test fail. + reference_grads = [[], [], [], [], []] + final_params = [None, None, None, None, None] + for i in range(2): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + loss1 = model1(self.x) + loss0.backward() + loss1.backward() + + reference_grads[0].append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + optimizer0.step() + optimizer1.step() + + final_params[0] = [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + def what_got_skipped(which_iter, which_backward): + if which_iter == 0 and which_backward == 0: + return 1 + if which_iter == 0 and which_backward == 1: + return 2 + if which_iter == 1 and which_backward == 0: + return 3 + if which_iter == 1 and which_backward == 1: + return 4 + return 0 + + for which_iter in (0,1): + for which_backward in (0,1): + model0 = MyModel(1) + model1 = MyModel(2) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + optimizer1 = torch.optim.SGD([{'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.25) + + for i in range(3): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + loss1 = model1(self.x) + loss0.backward() + loss1.backward() + + if i != which_iter: + reference_grads[what_got_skipped(which_iter, which_backward)].append( + [param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + if i == which_iter: + if which_backward == 0: + optimizer1.step() + else: + optimizer0.step() + else: + optimizer0.step() + optimizer1.step() + + final_params[what_got_skipped(which_iter, which_backward)] = \ + [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (True, False): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + else: + iters = 2 + + model0 = MyModel(1) + model1 = MyModel(2) + + models = [model0, model1] + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}], + momentum=0.125) + optimizer1 = torch.optim.SGD([{'params' : model1.parameters(), 'lr' : 0.5}], + momentum=0.25) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1], [optimizer0, optimizer1] = amp.initialize( + [model0, model1], + [optimizer0, optimizer1], + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer0.zero_grad() + optimizer1.zero_grad() + + loss0 = model0(self.x) + loss1 = model1(self.x) + + with amp.scale_loss(loss0, optimizer0, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if inject_inf_loc == "fp32": + model0.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model0.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, optimizer1, loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if inject_inf_loc == "fp32": + model1.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + model1.weight1.grad[0] = float('inf') + + # print("opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} use_multiple_loss_scalers {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, use_multiple_loss_scalers)) + + if i != inject_inf: + master_params = list(amp.master_params(optimizer0)) + \ + list(amp.master_params(optimizer1)) + for param, reference_grad in zip(master_params, + reference_grads[what_got_skipped(inject_inf, which_backward)][unskipped]): + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float())) + unskipped += 1 + + optimizer0.step() + optimizer1.step() + + model_params = [p for p in model0.parameters()] + [p for p in model1.parameters()] + master_params = [p for p in amp.master_params(optimizer0)] + \ + [p for p in amp.master_params(optimizer1)] + for model, master, reference in zip( + model_params, + master_params, + final_params[what_got_skipped(inject_inf, which_backward)]): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + + def test_3models2losses2optimizers(self): + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 1.0}], + momentum=0.5) + optimizer1 = torch.optim.SGD([{'params' : model2.parameters(), 'lr' : 0.5}], + momentum=0.25) + + # Again, can't do this: reference_grads = [[]]*9 + reference_grads = [[], [], [], [], [], [], [], [], []] + final_params = [None, None, None, None, None, None, None, None, None] + for i in range(2): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + model1(self.x) + loss1 = model2(self.x) + model1(self.x) + loss0.backward() + loss1.backward() + + reference_grads[0].append([param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + optimizer0.step() + optimizer1.step() + + final_params[0] = \ + [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + \ + [param.data.clone() for param in model2.parameters()] + + def what_got_skipped(which_iter, which_backward, which_model): + if which_iter == 0: + if which_backward == 0: + if which_model == 0: + return 1 + if which_model == 1: + return 2 + if which_backward == 1: + if which_model == 2: + return 3 + if which_model == 1: + return 4 + if which_iter == 1: + if which_backward == 0: + if which_model == 0: + return 5 + if which_model == 1: + return 6 + if which_backward == 1: + if which_model == 2: + return 7 + if which_model == 1: + return 8 + return 0 + + for which_iter in (0,1): + for which_backward in (0,1): + if which_backward == 0: + which_models = (0,1) + if which_backward == 1: + which_models = (2,1) + for which_model in which_models: + + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 1.0}], + momentum=0.5) + optimizer1 = torch.optim.SGD([{'params' : model2.parameters(), 'lr' : 0.5}], + momentum=0.25) + + for i in range(3): + optimizer0.zero_grad() + optimizer1.zero_grad() + loss0 = model0(self.x) + model1(self.x) + loss1 = model2(self.x) + model1(self.x) + loss0.backward() + loss1.backward() + + if i != which_iter: + reference_grads[what_got_skipped(which_iter, + which_backward, which_model)].append( + [param.grad.data.clone() for param in model0.parameters()] + + [param.grad.data.clone() for param in model1.parameters()]) + + if i == which_iter: + if which_backward == 0: + # if which_model == 0: + optimizer1.step() + # if which_model == 1: + # optimizer1.step() + if which_backward == 1: + # if which_model == 2: + # optimizer0.step() + # if which_model == 1: + continue + else: + optimizer0.step() + optimizer1.step() + + final_params[what_got_skipped(which_iter, which_backward, which_model)] = \ + [param.data.clone() for param in model0.parameters()] + \ + [param.data.clone() for param in model1.parameters()] + \ + [param.data.clone() for param in model2.parameters()] + + for opt_level in ("O0", "O1", "O2", "O3"): + for how_to_zero in ("none", "model", "optimizer"): + for use_multiple_loss_scalers in (True, False): + if opt_level == "O1" or opt_level == "O2": + inject_inf_iters = (-1, 0, 1) + else: + inject_inf_iters = (-1,) + + for inject_inf in inject_inf_iters: + if inject_inf >= 0: + inject_inf_locs = ("fp16", "fp32") + which_backwards = (0, 1) + else: + inject_inf_locs = ("fdsa",) + which_backwards = (None,) + + for inject_inf_loc in inject_inf_locs: + for which_backward in which_backwards: + if use_multiple_loss_scalers: + num_losses = 2 + loss_ids = [0, 1] + else: + num_losses = 1 + loss_ids = [0, 0] + + if inject_inf >= 0: + iters = 3 + if which_backward == 0: + which_models = (0, 1) + elif which_backward == 1: + which_models = (2, 1) + else: + iters = 2 + which_models = (None,) + + for which_model in which_models: + model0 = MyModel(1) + model1 = MyModel(2) + model2 = MyModel(3) + + models = [model0, model1, model2] + + optimizer0 = torch.optim.SGD([{'params' : model0.parameters(), 'lr' : 0.25}, + {'params' : model1.parameters(), 'lr' : 1.0}], + momentum=0.5) + optimizer1 = torch.optim.SGD([{'params' : model2.parameters(), 'lr' : 0.5}], + momentum=0.25) + + _amp_state.allow_incoming_model_not_fp32 = True + [model0, model1, model2], [optimizer0, optimizer1] = amp.initialize( + [model0, model1, model2], + [optimizer0, optimizer1], + opt_level=opt_level, + verbosity=0, + cast_model_type=False, + num_losses=num_losses) + _amp_state.allow_incoming_model_not_fp32 = False + + _amp_state.loss_scalers[0]._loss_scale = 4.0 + if use_multiple_loss_scalers: + _amp_state.loss_scalers[1]._loss_scale = 16.0 + + unskipped = 0 + for i in range(iters): + if how_to_zero == "none": + for model in models: + for param in model.parameters(): + param.grad = None + elif how_to_zero == "model": + for model in models: + model.zero_grad() + else: + optimizer0.zero_grad() + optimizer1.zero_grad() + + loss0 = model0(self.x) + model1(self.x) + loss1 = model2(self.x) + model1(self.x) + + with amp.scale_loss(loss0, optimizer0, loss_id=loss_ids[0]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 0: + if which_model == 0: + inj_model = model0 + elif which_model == 1: + inj_model = model1 + else: + raise RuntimeError(which_model + " invalid for loss 0") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + with amp.scale_loss(loss1, [optimizer0, optimizer1], loss_id=loss_ids[1]) as scaled_loss: + scaled_loss.backward() + if i == inject_inf and which_backward == 1: + if which_model == 2: + inj_model = model2 + elif which_model == 1: + inj_model = model1 + else: + raise RuntimeError(which_model + " invalid for loss 1 ") + if inject_inf_loc == "fp32": + inj_model.weight0.grad[0] = float('inf') + elif inject_inf_loc == "fp16": + inj_model.weight1.grad[0] = float('inf') + + if i != inject_inf: + master_params = list(amp.master_params(optimizer0)) + \ + list(amp.master_params(optimizer1)) + for param, reference_grad in zip(master_params, + reference_grads[what_got_skipped(inject_inf, + which_backward, which_model)][unskipped]): + self.assertTrue(torch.allclose(param.grad.float(), reference_grad.float())) + unskipped += 1 + + optimizer0.step() + optimizer1.step() + + model_params = [p for p in model0.parameters()] + \ + [p for p in model1.parameters()] + \ + [p for p in model2.parameters()] + master_params = [p for p in amp.master_params(optimizer0)] + \ + [p for p in amp.master_params(optimizer1)] + + # print("opt_level {} i {} inject_inf {} which_backward {} inject_inf_loc {} use_multiple_loss_scalers {} which_model {}".format(opt_level, i, inject_inf, which_backward, inject_inf_loc, use_multiple_loss_scalers, which_model)) + + for model, master, reference in zip( + model_params, + master_params, + final_params[what_got_skipped(inject_inf, which_backward, which_model)]): + self.assertTrue(torch.allclose(model, reference)) + self.assertTrue(torch.allclose(model, master.to(model.dtype))) + + if opt_level == "O1": + _amp_state.handle._deactivate() + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_promotion.py b/apex/tests/L0/run_amp/test_promotion.py new file mode 100644 index 0000000000000000000000000000000000000000..f5ef30c1273a2910aa3b6e7467fa8e4fbd96dbc5 --- /dev/null +++ b/apex/tests/L0/run_amp/test_promotion.py @@ -0,0 +1,75 @@ +import unittest + +import itertools as it + +from apex import amp +import torch +from torch import nn +import torch.nn.functional as F + +from utils import common_init, HALF, FLOAT, DTYPES + +class TestPromotion(unittest.TestCase): + def setUp(self): + self.handle = amp.init(enabled=True) + common_init(self) + + def tearDown(self): + self.handle._deactivate() + + def run_binary_promote_test(self, fns, input_shape, x_inplace=False): + type_pairs = it.product(DTYPES, DTYPES) + for fn, (xtype, ytype) in it.product(fns, type_pairs): + x = torch.randn(input_shape, dtype=xtype).requires_grad_() + x_leaf = x + if x_inplace: + # We need a non-leaf to call in place on + x = x.clone() + y = torch.randn(input_shape, dtype=ytype) + out = fn(x, y) + if x_inplace: + # In place: always match xtype + self.assertEqual(out.type(), x.type()) + else: + # Out of place: match widest type + if xtype == torch.float or ytype == torch.float: + self.assertEqual(out.type(), FLOAT) + else: + self.assertEqual(out.type(), HALF) + out.float().sum().backward() + self.assertEqual(x_leaf.grad.dtype, xtype) + + def test_atan2_matches_widest(self): + fns = [lambda x, y : torch.atan2(x, y), + lambda x, y : x.atan2(y)] + self.run_binary_promote_test(fns, (self.b,)) + + def test_mul_matches_widest(self): + fns = [lambda x, y : torch.mul(x, y), + lambda x, y: x.mul(y)] + self.run_binary_promote_test(fns, (self.b,)) + + def test_cat_matches_widest(self): + shape = self.b + ys = [torch.randn(shape, dtype=torch.half) for _ in range(5)] + x_float = torch.randn(shape) + out = torch.cat(ys + [x_float]) + self.assertEqual(out.type(), FLOAT) + x_half = torch.randn(shape, dtype=torch.half) + out = torch.cat(ys + [x_half]) + self.assertEqual(out.type(), HALF) + + def test_inplace_exp_is_error_for_half(self): + xs = torch.randn(self.b) + xs.exp_() + self.assertEqual(xs.type(), FLOAT) + xs = torch.randn(self.b, dtype=torch.half) + with self.assertRaises(NotImplementedError): + xs.exp_() + + def test_inplace_add_matches_self(self): + fn = lambda x, y: x.add_(y) + self.run_binary_promote_test([fn], (self.b,), x_inplace=True) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/test_rnn.py b/apex/tests/L0/run_amp/test_rnn.py new file mode 100644 index 0000000000000000000000000000000000000000..c49a5f00345ea131b017580754b8c9b224c591c8 --- /dev/null +++ b/apex/tests/L0/run_amp/test_rnn.py @@ -0,0 +1,116 @@ +import unittest + +from apex import amp +import random +import torch +from torch import nn + +from utils import common_init, HALF + +class TestRnnCells(unittest.TestCase): + def setUp(self): + self.handle = amp.init(enabled=True) + common_init(self) + + def tearDown(self): + self.handle._deactivate() + + def run_cell_test(self, cell, state_tuple=False): + shape = (self.b, self.h) + for typ in [torch.float, torch.half]: + xs = [torch.randn(shape, dtype=typ).requires_grad_() + for _ in range(self.t)] + hidden_fn = lambda: torch.zeros(shape, dtype=typ) + if state_tuple: + hidden = (hidden_fn(), hidden_fn()) + else: + hidden = hidden_fn() + outputs = [] + for i in range(self.t): + hidden = cell(xs[i], hidden) + if state_tuple: + output = hidden[0] + else: + output = hidden + outputs.append(output) + for y in outputs: + self.assertEqual(y.type(), HALF) + outputs[-1].float().sum().backward() + for i, x in enumerate(xs): + self.assertEqual(x.grad.dtype, x.dtype) + + def test_rnn_cell_is_half(self): + cell = nn.RNNCell(self.h, self.h) + self.run_cell_test(cell) + + def test_gru_cell_is_half(self): + cell = nn.GRUCell(self.h, self.h) + self.run_cell_test(cell) + + def test_lstm_cell_is_half(self): + cell = nn.LSTMCell(self.h, self.h) + self.run_cell_test(cell, state_tuple=True) + +class TestRnns(unittest.TestCase): + def setUp(self): + self.handle = amp.init(enabled=True) + common_init(self) + + def tearDown(self): + self.handle._deactivate() + + def run_rnn_test(self, rnn, layers, bidir, state_tuple=False): + for typ in [torch.float, torch.half]: + x = torch.randn((self.t, self.b, self.h), dtype=typ).requires_grad_() + hidden_fn = lambda: torch.zeros((layers + (layers * bidir), + self.b, self.h), dtype=typ) + if state_tuple: + hidden = (hidden_fn(), hidden_fn()) + else: + hidden = hidden_fn() + output, _ = rnn(x, hidden) + self.assertEqual(output.type(), HALF) + output[-1, :, :].float().sum().backward() + self.assertEqual(x.grad.dtype, x.dtype) + + def test_rnn_is_half(self): + configs = [(1, False), (2, False), (2, True)] + for layers, bidir in configs: + rnn = nn.RNN(input_size=self.h, hidden_size=self.h, num_layers=layers, + nonlinearity='relu', bidirectional=bidir) + self.run_rnn_test(rnn, layers, bidir) + + def test_gru_is_half(self): + configs = [(1, False), (2, False), (2, True)] + for layers, bidir in configs: + rnn = nn.GRU(input_size=self.h, hidden_size=self.h, num_layers=layers, + bidirectional=bidir) + self.run_rnn_test(rnn, layers, bidir) + + def test_lstm_is_half(self): + configs = [(1, False), (2, False), (2, True)] + for layers, bidir in configs: + rnn = nn.LSTM(input_size=self.h, hidden_size=self.h, num_layers=layers, + bidirectional=bidir) + self.run_rnn_test(rnn, layers, bidir, state_tuple=True) + + def test_rnn_packed_sequence(self): + num_layers = 2 + rnn = nn.RNN(input_size=self.h, hidden_size=self.h, num_layers=num_layers) + for typ in [torch.float, torch.half]: + x = torch.randn((self.t, self.b, self.h), dtype=typ).requires_grad_() + lens = sorted([random.randint(self.t // 2, self.t) for _ in range(self.b)], + reverse=True) + # `pack_padded_sequence` breaks if default tensor type is non-CPU + torch.set_default_tensor_type(torch.FloatTensor) + lens = torch.tensor(lens, dtype=torch.int64, device=torch.device('cpu')) + packed_seq = nn.utils.rnn.pack_padded_sequence(x, lens) + torch.set_default_tensor_type(torch.cuda.FloatTensor) + hidden = torch.zeros((num_layers, self.b, self.h), dtype=typ) + output, _ = rnn(packed_seq, hidden) + self.assertEqual(output.data.type(), HALF) + output.data.float().sum().backward() + self.assertEqual(x.grad.dtype, x.dtype) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_amp/utils.py b/apex/tests/L0/run_amp/utils.py new file mode 100644 index 0000000000000000000000000000000000000000..7aa20c36918f28967ade3d94921a565327c366fe --- /dev/null +++ b/apex/tests/L0/run_amp/utils.py @@ -0,0 +1,21 @@ +import torch + +HALF = 'torch.cuda.HalfTensor' +FLOAT = 'torch.cuda.FloatTensor' + +DTYPES = [torch.half, torch.float] + +ALWAYS_HALF = {torch.float: HALF, + torch.half: HALF} +ALWAYS_FLOAT = {torch.float: FLOAT, + torch.half: FLOAT} +MATCH_INPUT = {torch.float: FLOAT, + torch.half: HALF} + +def common_init(test_case): + test_case.h = 64 + test_case.b = 16 + test_case.c = 16 + test_case.k = 3 + test_case.t = 10 + torch.set_default_tensor_type(torch.cuda.FloatTensor) diff --git a/apex/tests/L0/run_fp16util/__init__.py b/apex/tests/L0/run_fp16util/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/tests/L0/run_fp16util/test_fp16util.py b/apex/tests/L0/run_fp16util/test_fp16util.py new file mode 100644 index 0000000000000000000000000000000000000000..eecddbc01d7e5b72e93f1cdba6ad037c0c2aae54 --- /dev/null +++ b/apex/tests/L0/run_fp16util/test_fp16util.py @@ -0,0 +1,75 @@ +import unittest + +import torch +import torch.nn as nn + +from apex.fp16_utils import FP16Model + + +class DummyBlock(nn.Module): + def __init__(self): + super(DummyBlock, self).__init__() + + self.conv = nn.Conv2d(10, 10, 2) + self.bn = nn.BatchNorm2d(10, affine=True) + + def forward(self, x): + return self.conv(self.bn(x)) + + +class DummyNet(nn.Module): + def __init__(self): + super(DummyNet, self).__init__() + + self.conv1 = nn.Conv2d(3, 10, 2) + self.bn1 = nn.BatchNorm2d(10, affine=False) + self.db1 = DummyBlock() + self.db2 = DummyBlock() + + def forward(self, x): + out = x + out = self.conv1(out) + out = self.bn1(out) + out = self.db1(out) + out = self.db2(out) + return out + + +class DummyNetWrapper(nn.Module): + def __init__(self): + super(DummyNetWrapper, self).__init__() + + self.bn = nn.BatchNorm2d(3, affine=True) + self.dn = DummyNet() + + def forward(self, x): + return self.dn(self.bn(x)) + + +class TestFP16Model(unittest.TestCase): + def setUp(self): + self.N = 64 + self.C_in = 3 + self.H_in = 16 + self.W_in = 32 + self.in_tensor = torch.randn((self.N, self.C_in, self.H_in, self.W_in)).cuda() + self.orig_model = DummyNetWrapper().cuda() + self.fp16_model = FP16Model(self.orig_model) + + def test_params_and_buffers(self): + exempted_modules = [ + self.fp16_model.network.bn, + self.fp16_model.network.dn.db1.bn, + self.fp16_model.network.dn.db2.bn, + ] + for m in self.fp16_model.modules(): + expected_dtype = torch.float if (m in exempted_modules) else torch.half + for p in m.parameters(recurse=False): + assert p.dtype == expected_dtype + for b in m.buffers(recurse=False): + assert b.dtype in (expected_dtype, torch.int64) + + def test_output_is_half(self): + out_tensor = self.fp16_model(self.in_tensor) + assert out_tensor.dtype == torch.half + diff --git a/apex/tests/L0/run_fused_layer_norm/test_fused_layer_norm.py b/apex/tests/L0/run_fused_layer_norm/test_fused_layer_norm.py new file mode 100644 index 0000000000000000000000000000000000000000..9103eb80fc488181ea719f79a20e39c6caed8965 --- /dev/null +++ b/apex/tests/L0/run_fused_layer_norm/test_fused_layer_norm.py @@ -0,0 +1,42 @@ +import unittest +import os +import random + +import torch +import apex +from torch.autograd import Variable + + +class TestFusedLayerNorm(unittest.TestCase): + def setUp(self): + # bias and weight are set to 0 and 1 respectively, so no need to copy parameters from cpu module to the gpu one + self.module_cpu_ = apex.normalization.FusedLayerNorm(normalized_shape=[32, 16], elementwise_affine=False).cpu() + self.module_cuda_ = apex.normalization.FusedLayerNorm(normalized_shape=[32, 16], elementwise_affine=False).cuda() + + def _test_same_output(self, batch_size): + torch.cuda.manual_seed(42) + self.input_ = torch.randn((batch_size, *self.module_cpu_.normalized_shape), device="cpu").requires_grad_(True) + self.input_cuda_ = self.input_.cuda().detach().requires_grad_(True) + out_cpu_ = self.module_cpu_(self.input_) + gO = torch.rand_like(out_cpu_) + out_cpu_.backward(gO) + out_cuda_ = self.module_cuda_(self.input_cuda_) + gO = gO.cuda() + out_cuda_.backward(gO) + assert out_cpu_.is_cuda == False + assert out_cuda_.is_cuda == True + torch.testing.assert_allclose(out_cpu_, out_cuda_.cpu()) + torch.testing.assert_allclose(self.input_.grad, self.input_cuda_.grad.cpu()) + + def test_layer_norm(self): + self._test_same_output(16) + + def test_large_batch(self): + self._test_same_output(65536) + + +class TestFusedLayerNormElemWise(TestFusedLayerNorm): + def setUp(self): + self.module_cpu_ = apex.normalization.FusedLayerNorm(normalized_shape=[32, 16], elementwise_affine=True).cpu() + self.module_cuda_ = apex.normalization.FusedLayerNorm(normalized_shape=[32, 16], elementwise_affine=True).cuda() + diff --git a/apex/tests/L0/run_mlp/test_mlp.py b/apex/tests/L0/run_mlp/test_mlp.py new file mode 100644 index 0000000000000000000000000000000000000000..9ccda566dddd05c760d8a6437c57b8050f2b96f9 --- /dev/null +++ b/apex/tests/L0/run_mlp/test_mlp.py @@ -0,0 +1,218 @@ +"""Tests for c++ MLP""" +import unittest +from time import time +import numpy as np + +import torch +from torch import nn + +from apex.mlp import MLP + +batch_size = 1024 +mlp_sizes = [480, 1024, 1024, 512, 256, 1] +num_iters = 10 + +class TestMLP(unittest.TestCase): + + def test_creation(self): + MLP(mlp_sizes) + + def test_numeric(self): + mlp = MLP(mlp_sizes).cuda() + + mlp_layers = [] + for i in range(mlp.num_layers): + linear = nn.Linear(mlp_sizes[i], mlp_sizes[i + 1]) + mlp.weights[i].data.copy_(linear.weight) + mlp.biases[i].data.copy_(linear.bias) + mlp_layers.append(linear) + mlp_layers.append(nn.ReLU(inplace=True)) + + ref_mlp = nn.Sequential(*mlp_layers).cuda() + + test_input = torch.empty(batch_size, mlp_sizes[0], device="cuda").uniform_(-1., 1.).requires_grad_() + ref_input = test_input.clone().detach().requires_grad_() + mlp_out = mlp(test_input) + ref_out = ref_mlp(ref_input) + np.testing.assert_allclose( + mlp_out.detach().cpu().numpy(), + ref_out.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + # Use mean value as scalar loss. Multiply 10 to make it big enough not zero out + mlp_out.mean().mul(10.).backward() + ref_out.mean().mul(10.).backward() + np.testing.assert_allclose( + test_input.grad.detach().cpu().numpy(), + ref_input.grad.detach().cpu().numpy(), + atol=0, rtol=1e-5) + np.testing.assert_allclose( + mlp.biases[0].grad.detach().cpu().numpy(), + ref_mlp[0].bias.grad.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + def test_no_bias(self): + for use_activation in ['none', 'relu', 'sigmoid']: + mlp = MLP(mlp_sizes, bias=False, activation=use_activation).cuda() + + mlp_layers = [] + for i in range(mlp.num_layers): + linear = nn.Linear(mlp_sizes[i], mlp_sizes[i + 1], bias=False) + mlp.weights[i].data.copy_(linear.weight) + mlp_layers.append(linear) + if use_activation == 'relu': + mlp_layers.append(nn.ReLU(inplace=True)) + if use_activation == 'sigmoid': + mlp_layers.append(nn.Sigmoid()) + + ref_mlp = nn.Sequential(*mlp_layers).cuda() + + test_input = torch.empty(batch_size, mlp_sizes[0], device="cuda").uniform_(-1., 1.).requires_grad_() + ref_input = test_input.clone().detach().requires_grad_() + mlp_out = mlp(test_input) + ref_out = ref_mlp(ref_input) + np.testing.assert_allclose( + mlp_out.detach().cpu().numpy(), + ref_out.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + # Use mean value as scalar loss. Multiply 10 to make it big enough not zero out + mlp_out.mean().mul(10.).backward() + ref_out.mean().mul(10.).backward() + np.testing.assert_allclose( + test_input.grad.detach().cpu().numpy(), + ref_input.grad.detach().cpu().numpy(), + atol=0, rtol=100) + np.testing.assert_allclose( + mlp.weights[0].grad.detach().cpu().numpy(), + ref_mlp[0].weight.grad.detach().cpu().numpy(), + atol=1e-7, rtol=100) + + def test_with_bias(self): + for use_activation in ['none', 'relu', 'sigmoid']: + mlp = MLP(mlp_sizes, bias=True, activation=use_activation).cuda() + + mlp_layers = [] + for i in range(mlp.num_layers): + linear = nn.Linear(mlp_sizes[i], mlp_sizes[i + 1], bias=True) + mlp.weights[i].data.copy_(linear.weight) + mlp.biases[i].data.copy_(linear.bias) + mlp_layers.append(linear) + if use_activation == 'relu': + mlp_layers.append(nn.ReLU(inplace=True)) + if use_activation == 'sigmoid': + mlp_layers.append(nn.Sigmoid()) + + ref_mlp = nn.Sequential(*mlp_layers).cuda() + + test_input = torch.empty(batch_size, mlp_sizes[0], device="cuda").uniform_(-1., 1.).requires_grad_() + ref_input = test_input.clone().detach().requires_grad_() + mlp_out = mlp(test_input) + ref_out = ref_mlp(ref_input) + np.testing.assert_allclose( + mlp_out.detach().cpu().numpy(), + ref_out.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + # Use mean value as scalar loss. Multiply 10 to make it big enough not zero out + mlp_out.mean().mul(10.).backward() + ref_out.mean().mul(10.).backward() + np.testing.assert_allclose( + test_input.grad.detach().cpu().numpy(), + ref_input.grad.detach().cpu().numpy(), + atol=0, rtol=1) + np.testing.assert_allclose( + mlp.weights[0].grad.detach().cpu().numpy(), + ref_mlp[0].weight.grad.detach().cpu().numpy(), + atol=1e-7, rtol=1) + np.testing.assert_allclose( + mlp.biases[0].grad.detach().cpu().numpy(), + ref_mlp[0].bias.grad.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + def test_no_grad(self): + mlp = MLP(mlp_sizes).cuda() + + mlp_layers = [] + for i in range(mlp.num_layers): + linear = nn.Linear(mlp_sizes[i], mlp_sizes[i + 1]) + mlp.weights[i].data.copy_(linear.weight) + mlp.biases[i].data.copy_(linear.bias) + mlp_layers.append(linear) + mlp_layers.append(nn.ReLU(inplace=True)) + + ref_mlp = nn.Sequential(*mlp_layers).cuda() + + test_input = torch.empty(batch_size, mlp_sizes[0], device="cuda").uniform_(-1., 1.) + ref_input = test_input.clone().detach() + mlp_out = mlp(test_input) + ref_out = ref_mlp(ref_input) + np.testing.assert_allclose( + mlp_out.detach().cpu().numpy(), + ref_out.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + # Use mean value as scalar loss. Multiply 10 to make it big enough not zero out + mlp_out.mean().mul(10.).backward() + ref_out.mean().mul(10.).backward() + np.testing.assert_allclose( + mlp.weights[0].grad.detach().cpu().numpy(), + ref_mlp[0].weight.grad.detach().cpu().numpy(), + atol=1e-7, rtol=1e-5) + + + def test_performance_half(self): + mlp = MLP(mlp_sizes).cuda().half() + + mlp_layers = [] + for i in range(mlp.num_layers): + linear = nn.Linear(mlp_sizes[i], mlp_sizes[i + 1]) + mlp.weights[i].data.copy_(linear.weight) + mlp.biases[i].data.copy_(linear.bias) + mlp_layers.append(linear) + mlp_layers.append(nn.ReLU(inplace=True)) + + ref_mlp = nn.Sequential(*mlp_layers).cuda().half() + + test_input = torch.empty( + batch_size, mlp_sizes[0], device="cuda", dtype=torch.half).fill_(10.).requires_grad_() + ref_input = torch.empty( + batch_size, mlp_sizes[0], device="cuda", dtype=torch.half).fill_(10.).requires_grad_() + + # Warm up GPU + for _ in range(100): + ref_out = ref_mlp(ref_input) + ref_loss = ref_out.mean() + ref_mlp.zero_grad() + ref_loss.backward() + mlp_out = mlp(test_input) + test_loss = mlp_out.mean() + mlp.zero_grad() + test_loss.backward() + + torch.cuda.profiler.start() + torch.cuda.synchronize() + start_time = time() + for _ in range(num_iters): + ref_out = ref_mlp(ref_input) + ref_loss = ref_out.mean() + ref_mlp.zero_grad() + ref_loss.backward() + torch.cuda.synchronize() + stop_time = time() + print(F"\nPytorch MLP time {(stop_time - start_time) * 1000. / num_iters:.4f} ms") + + torch.cuda.synchronize() + start_time = time() + for _ in range(num_iters): + mlp_out = mlp(test_input) + test_loss = mlp_out.mean() + mlp.zero_grad() + test_loss.backward() + torch.cuda.synchronize() + stop_time = time() + print(F"C++ MLP time {(stop_time - start_time) * 1000. / num_iters:.4f} ms") + torch.cuda.profiler.stop() + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_optimizers/__init__.py b/apex/tests/L0/run_optimizers/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/tests/L0/run_optimizers/test_dist_adam.py b/apex/tests/L0/run_optimizers/test_dist_adam.py new file mode 100644 index 0000000000000000000000000000000000000000..c44180d3fc08e4a3e6db41abc6fff05269bab39f --- /dev/null +++ b/apex/tests/L0/run_optimizers/test_dist_adam.py @@ -0,0 +1,183 @@ +import argparse +import random +import sys + +import torch +from torch.nn.parallel import DistributedDataParallel as DDP + +from apex import amp +from apex.optimizers import FusedAdam +from apex.contrib.optimizers.distributed_fused_adam import DistributedFusedAdam + + +class TestModel(torch.nn.Module): + def __init__(self, args): + super(TestModel, self).__init__() + + self.linear = torch.nn.Sequential(*[torch.nn.Linear(args.dim, args.dim, bias=args.bias) for _ in range(args.layers)]) + + def forward(self, x): + return self.linear(x) + +def setup(args): + ## Model + ref_model = TestModel(args).cuda() + dist_model = TestModel(args).cuda() + + # Same weights + with torch.no_grad(): + for dp, rp in zip(dist_model.parameters(), ref_model.parameters()): + dp.data.copy_(rp.data) + + dist_model = dist_model.half() + + + ## Optimizer + # same hyperparameters + ref_opt_args = { 'lr': 1e-3, 'eps': 1e-6, 'weight_decay': 0.01 } + ref_opt = FusedAdam(ref_model.parameters(), **ref_opt_args) + + dist_opt_args = ref_opt_args.copy() + dist_opt_args.update( {'overlap_reductions' : False} ) + dist_opt_args.update( {'process_group_size' : args.n_gpu} ) + dist_opt_args.update( {'dwu_group_size' : args.dwu_group_size} ) + dist_opt_args.update( {'dwu_num_blocks' : 1} ) + dist_opt_args.update( {'dwu_num_chunks' : 1} ) + dist_opt = DistributedFusedAdam(dist_model.parameters(), **dist_opt_args) + dist_opt.set_global_scale(1.) + + ## amp-init + amp_args = { 'loss_scale' : 'dynamic' , 'opt_level' : 'O2'} + ref_model, ref_opt = amp.initialize(ref_model, ref_opt, **amp_args) + + + ## DDP + ref_model = DDP(ref_model, device_ids=[args.rank]) + with torch.no_grad(): + for dp in dist_model.parameters(): + torch.distributed.broadcast(dp.data, src=0) + for rp in ref_model.parameters(): + torch.distributed.broadcast(rp.data, src=0) + torch.cuda.synchronize() + torch.distributed.barrier() + if get_rank() == 0: + print(f'dist opt with {args.n_gpu} GPUs') + + return ref_model, ref_opt, dist_model, dist_opt + +def parse_args(): + parser = argparse.ArgumentParser() + + parser.add_argument('--local_rank', type=int, default=-1) + parser.add_argument('--steps', type=int, default=20) + parser.add_argument('--batch', type=int, default=32) + parser.add_argument('--dim', type=int, default=4) + parser.add_argument('--layers', type=int, default=2) + parser.add_argument('--bias', action='store_true') + parser.add_argument('--atol', type=float, default=1e-3) + parser.add_argument('--rtol', type=float, default=1) + parser.add_argument('--dwu_group_size', type=float, default=1) + + args = parser.parse_args() + + return args + +def setup_env(args): + torch.cuda.set_device(args.local_rank) + torch.distributed.init_process_group(backend='nccl', init_method='env://') + args.rank = torch.distributed.get_rank() + args.n_gpu = torch.distributed.get_world_size() + + seed = 42 + get_rank() + + random.seed(seed) + torch.manual_seed(seed) + + return args + +def get_rank(): + return torch.distributed.get_rank() + +def main(): + args = parse_args() + args = setup_env(args) + tol_args = { 'atol' : args.atol, 'rtol' : args.rtol } + + torch.set_printoptions(precision=16) + + ref_model, ref_opt, dist_model, dist_opt = setup(args) + + # lazy_init not called yet, initialize stash + stash = ref_opt._amp_stash + stash.all_fp16_params, stash.all_fp32_from_fp16_params = [], [] + + # make sure everything from _first_step_init_ is ready before training + # e.g. registering allreduce_hook + # so that gradients are copied/reduced when necessary + dist_opt._init_everything() + + for i in range(args.steps): + x_ref = torch.randn(args.batch, args.dim, dtype=torch.half).cuda().requires_grad_(True) + x_dist = x_ref.clone().detach().requires_grad_(True) + + if get_rank() == 0: + print(f'[{i}] Checking input') + #print("x_ref:", x_ref.flatten()[:10]) + #print("x_dist:", x_dist.flatten()[:10]) + assert(torch.allclose(x_ref, x_dist, **tol_args)) + + y_ref = ref_model(x_ref).half() + y_dist = dist_model(x_dist) + + if get_rank() == 0: + print(f'[{i}] Checking output') + #print("y_ref:", y_ref.flatten()[:10]) + #print("y_dist:", y_dist.flatten()[:10]) + assert(torch.allclose(y_ref, y_dist, **tol_args)) + + dy = torch.randn_like(y_ref) + + y_ref.backward(dy) + y_dist.backward(dy) + + if get_rank() == 0: + print(f'[{i}] Checking gradients') + torch.distributed.barrier() + torch.cuda.synchronize() + assert(torch.allclose(x_ref.grad, x_dist.grad, **tol_args)) + + # gradient all-reduce within distributed optimizer + dist_opt.complete_reductions() + + if get_rank() == 0: + print(f'[{i}] Stepping') + ref_opt.step() + dist_opt.step() + + torch.cuda.synchronize() + torch.distributed.barrier() + print('Checking new weights') + if get_rank() == 0: + print("ref param:", ref_model.module.linear[0].weight) + print("dist param:", dist_model.linear[0].weight) + + for i, (rp, dp) in enumerate(zip(ref_model.parameters(), dist_model.parameters())): + if not torch.allclose(rp, dp, **tol_args): + if get_rank() == 0: + print(f'Rank: {get_rank()}, Param: {i}') + print(f'ref: {rp.sum().item()}, dist: {dp.sum().item()}') + print(rp) + print(dp) + + print(torch.abs(rp-dp) > tol_args['atol']) + sys.exit(0) + + # zero grads + for rp, dp in zip(ref_model.parameters(), dist_model.parameters()): + rp.grad = None + dp.grad = None + + +if __name__ == "__main__": + main() + diff --git a/apex/tests/L0/run_optimizers/test_fused_novograd.py b/apex/tests/L0/run_optimizers/test_fused_novograd.py new file mode 100755 index 0000000000000000000000000000000000000000..fa94e7102915c62c27f41b094d3489031b5cee53 --- /dev/null +++ b/apex/tests/L0/run_optimizers/test_fused_novograd.py @@ -0,0 +1,170 @@ +import torch +from torch.optim import Optimizer +import math +import apex +import unittest + +from test_fused_optimizer import TestFusedOptimizer +from itertools import product + +class Novograd(Optimizer): + """ + Implements Novograd algorithm. + + Args: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups + lr (float, optional): learning rate (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square (default: (0.95, 0)) + eps (float, optional): term added to the denominator to improve + numerical stability (default: 1e-8) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0) + grad_averaging: gradient averaging + amsgrad (boolean, optional): whether to use the AMSGrad variant of this + algorithm from the paper `On the Convergence of Adam and Beyond`_ + (default: False) + """ + + def __init__(self, params, lr=1e-3, betas=(0.95, 0), eps=1e-8, + weight_decay=0, grad_averaging=False, amsgrad=False): + if not 0.0 <= lr: + raise ValueError("Invalid learning rate: {}".format(lr)) + if not 0.0 <= eps: + raise ValueError("Invalid epsilon value: {}".format(eps)) + if not 0.0 <= betas[0] < 1.0: + raise ValueError("Invalid beta parameter at index 0: {}".format(betas[0])) + if not 0.0 <= betas[1] < 1.0: + raise ValueError("Invalid beta parameter at index 1: {}".format(betas[1])) + defaults = dict(lr=lr, betas=betas, eps=eps, + weight_decay=weight_decay, + grad_averaging=grad_averaging, + amsgrad=amsgrad) + + super(Novograd, self).__init__(params, defaults) + + def __setstate__(self, state): + super(Novograd, self).__setstate__(state) + for group in self.param_groups: + group.setdefault('amsgrad', False) + + def step(self, closure=None): + """Performs a single optimization step. + + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + for group in self.param_groups: + for p in group['params']: + if p.grad is None: + continue + grad = p.grad.data + if grad.is_sparse: + raise RuntimeError('Sparse gradients are not supported.') + amsgrad = group['amsgrad'] + + state = self.state[p] + + # State initialization + if len(state) == 0: + state['step'] = 0 + # Exponential moving average of gradient values + state['exp_avg'] = torch.zeros_like(p.data) + # Exponential moving average of squared gradient values + state['exp_avg_sq'] = torch.zeros([]).to(state['exp_avg'].device) + if amsgrad: + # Maintains max of all exp. moving avg. of sq. grad. values + state['max_exp_avg_sq'] = torch.zeros([]).to(state['exp_avg'].device) + + exp_avg, exp_avg_sq = state['exp_avg'], state['exp_avg_sq'] + if amsgrad: + max_exp_avg_sq = state['max_exp_avg_sq'] + beta1, beta2 = group['betas'] + + state['step'] += 1 + + norm = torch.sum(torch.pow(grad, 2)) + + if exp_avg_sq == 0: + exp_avg_sq.copy_(norm) + else: + exp_avg_sq.mul_(beta2).add_(norm, alpha=1 - beta2) + + if amsgrad: + # Maintains the maximum of all 2nd moment running avg. till now + torch.max(max_exp_avg_sq, exp_avg_sq, out=max_exp_avg_sq) + # Use the max. for normalizing running avg. of gradient + denom = max_exp_avg_sq.sqrt().add_(group['eps']) + else: + denom = exp_avg_sq.sqrt().add_(group['eps']) + + grad.div_(denom) + if group['weight_decay'] != 0: + grad.add_(p.data, alpha=group['weight_decay']) + if group['grad_averaging']: + grad.mul_(1 - beta1) + exp_avg.mul_(beta1).add_(grad) + + p.data.add_(exp_avg, alpha=-group['lr']) + + return loss + + +class TestFusedNovoGrad(TestFusedOptimizer): + + def __init__(self, *args, **kwargs): + super(TestFusedNovoGrad, self).__init__(*args, **kwargs) + + # The options for NovoGrad and FusedNovoGrad are very specific if they + # are expected to behave the same. + self.options = {'lr':1e-3, 'betas':(0.95, 0), 'eps':1e-8, + 'weight_decay':0, 'grad_averaging':False, 'amsgrad':False} + + self.tst_options = {'lr':1e-3, 'betas':(0.95, 0), 'eps':1e-8, + 'weight_decay':0, 'grad_averaging':False, 'amsgrad':False, + 'bias_correction':False, 'reg_inside_moment':True, + 'norm_type':2, 'init_zero':False, 'set_grad_none':True} + + self.ref_optim = Novograd + self.fused_optim = apex.optimizers.FusedNovoGrad + + def test_float(self): + self.gen_single_type_test(param_type=torch.float) + + def test_half(self): + self.gen_single_type_test(param_type=torch.float16) + + @unittest.skipIf(torch.cuda.device_count()<2, "more than 1 GPU required") + def test_multi_device(self): + devices = ("cuda:1", "cuda:0") + for current_dev, tensor_dev in product(devices, devices): + with torch.cuda.device(current_dev): + torch.cuda.synchronize() + self.gen_single_type_test(param_type=torch.float, device=tensor_dev) + + + def test_multi_params(self): + sizes = [[4096, 1024], [4096], [4096, 2048], [32320, 1024], [1]] + + tensors = [] + for size in sizes: + tensors.append(torch.rand(size, dtype=torch.float, device="cuda")) + ref_param, tst_param, ref_optim, tst_optim = self.gen_param_optim( + tensors, self.options, self.tst_options + ) + + for _ in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_optimizers/test_fused_optimizer.py b/apex/tests/L0/run_optimizers/test_fused_optimizer.py new file mode 100644 index 0000000000000000000000000000000000000000..05ed85abc909fd65879d548c263b436ad628bdce --- /dev/null +++ b/apex/tests/L0/run_optimizers/test_fused_optimizer.py @@ -0,0 +1,284 @@ +import unittest +import os +import random + +import math +import torch +import apex +from itertools import product +from torch.optim import Optimizer + +class TestFusedOptimizer(unittest.TestCase): + def setUp(self, max_abs_diff=1e-3, max_rel_diff=1, iters=7): + self.max_abs_diff = max_abs_diff + self.max_rel_diff = max_rel_diff + self.iters = iters + torch.cuda.manual_seed(9876) + + def tearDown(self): + pass + + def gen_param_optim(self, tensors, options, tst_options=None): + + # Adding this to make backward compatible with existing tests. Just in + # case "tst_options" are not provided, it gets a copy of options + # which contains the parameters for the reference optimizer + if tst_options == None: + tst_options = options + + ref_param = [] + tst_param = [] + for tensor in tensors: + ref_param.append(torch.nn.Parameter(tensor.clone())) + tst_param.append(torch.nn.Parameter(tensor.clone())) + + ref_optim = self.ref_optim(ref_param, **options) + tst_optim = self.fused_optim(tst_param, **tst_options) + + return (ref_param, tst_param, ref_optim, tst_optim) + + def gen_grad(self, ref_param, tst_param): + for p_ref, p_tst in zip(ref_param, tst_param): + p_ref.grad = torch.rand_like(p_ref) + p_tst.grad = p_ref.grad + + def gen_mixed_grad(self, ref_param, tst_param, scale=1.0): + half_grads = [] + for p_ref, p_tst in zip(ref_param, tst_param): + half_grads.append(torch.rand_like(p_ref).half()) + p_ref.grad = half_grads[-1].float() / scale + return half_grads + + def get_max_diff(self, ref_param, tst_param): + max_abs_diff = max_rel_diff = 0 + for p_ref, p_tst in zip(ref_param, tst_param): + max_abs_diff_p = (p_ref - p_tst).abs().max().item() + max_rel_diff_p = ((p_ref - p_tst) / p_ref).abs().max().item() + + if max_abs_diff_p > max_abs_diff: max_abs_diff = max_abs_diff_p + if max_rel_diff_p > max_rel_diff: max_rel_diff = max_rel_diff_p + + return max_abs_diff, max_rel_diff + + def gen_single_type_test(self, param_type=torch.float, device='cuda'): + nelem = 278011 + + # Some ref and test optimizers may require different set of options. + # This is a quick workaround to add that functionality while making + # minimum changes in existing code. + # If there is no "tst_options" field provided, safe to initialize + # the test optimizer with the parameters of reference optimizer. + if not hasattr(self, 'tst_options'): + self.tst_options = self.options + + tensor = torch.rand(nelem, dtype=param_type, device=device) + + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim([tensor], self.options, self.tst_options) + + for i in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + +class TestFusedAdam(TestFusedOptimizer): + + def __init__(self, *args, **kwargs): + super(TestFusedAdam, self).__init__(*args, **kwargs) + self.options = {'lr':5e-4, 'betas':(0.9, 0.999), 'eps':1e-08, + 'weight_decay': 0, 'amsgrad': False} + self.ref_optim = torch.optim.Adam + self.fused_optim = apex.optimizers.FusedAdam + + def test_float(self): + self.gen_single_type_test(param_type=torch.float) + + def test_half(self): + self.gen_single_type_test(param_type=torch.float16) + + @unittest.skipIf(torch.cuda.device_count()<2, "more than 1 GPU required") + def test_multi_device(self): + devices = ("cuda:0", "cuda:1") + for current_dev, tensor_dev in product(devices, devices): + with torch.cuda.device(current_dev): + self.gen_single_type_test(param_type=torch.float, device=tensor_dev) + + @unittest.skip('Disable until 8/1/2019 adam/adamw upstream picked') + def test_multi_params(self): + sizes = [[4096, 1024], [4096], [4096, 2048], [32320, 1024], [1]] + + tensors = [] + for size in sizes: + tensors.append(torch.rand(size, dtype=torch.float, device='cuda')) + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim(tensors, self.options) + + for i in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + @unittest.skip('No longer support fuse scaling') + def test_scale(self): + nelem = 278011 + tensor = torch.rand(nelem, dtype=torch.float, device='cuda') + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim([tensor], self.options) + + for i in range(self.iters): + scale = random.random() * 1000 + half_grads = self.gen_mixed_grad(ref_param, tst_param, scale) + ref_optim.step() + tst_optim.step(grads=half_grads, scale=scale) + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + @unittest.skip('No longer support output fp16 param') + def test_fp16_output(self): + nelem = 278011 + + tensor = torch.rand(nelem, dtype=torch.float, device='cuda') + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim([tensor], self.options) + + fp16_param = torch.nn.Parameter(tensor.clone().half()) + + for i in range(self.iters): + half_grads = self.gen_mixed_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step(grads=half_grads, output_params=[fp16_param]) + + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + max_abs_diff, max_rel_diff = self.get_max_diff(tst_param, \ + [fp16_param.float()]) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + def test_adam_option(self): + nelem = 1 + adam_option = {'lr':0.01, 'betas':(0.6, 0.9), 'eps':3e-06, + 'weight_decay':0, 'amsgrad':False} + + tensor = torch.rand(nelem, dtype=torch.float, device='cuda') + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim([tensor], adam_option) + + for i in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + +class TestFusedAdagrad(TestFusedOptimizer): + def __init__(self, *args, **kwargs): + super(TestFusedAdagrad, self).__init__(*args, **kwargs) + self.options = {"lr": 5e-4, "eps": 1e-08, "weight_decay": 1.0e-5} + self.ref_optim = torch.optim.Adagrad + self.fused_optim = apex.optimizers.FusedAdagrad + + def test_float(self): + self.gen_single_type_test(param_type=torch.float) + + @unittest.skip("PyTorch optimizer is not numerically correct for fp16") + def test_half(self): + self.gen_single_type_test(param_type=torch.float16) + + @unittest.skipIf(torch.cuda.device_count()<2, "more than 1 GPU required") + def test_multi_device(self): + devices = ("cuda:0", "cuda:1") + for current_dev, tensor_dev in product(devices, devices): + with torch.cuda.device(current_dev): + self.gen_single_type_test(param_type=torch.float, device=tensor_dev) + + + def test_multi_params(self): + sizes = [[4096, 1024], [4096], [4096, 2048], [32320, 1024], [1]] + adagrad_option = {"lr": 5e-4, "eps": 1e-08, "weight_decay": 0} + + tensors = [] + for size in sizes: + tensors.append(torch.rand(size, dtype=torch.float, device="cuda")) + ref_param, tst_param, ref_optim, tst_optim = self.gen_param_optim( + tensors, adagrad_option + ) + + for _ in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + @unittest.skipIf(torch.cuda.device_count()<2, "more than 1 GPU required") + def test_multi_params_different_devices_throws(self): + sizes = [[4096, 1024], [4096], [4096, 2048], [32320, 1024], [1]] + adagrad_option = {"lr": 5e-4, "eps": 1e-08, "weight_decay": 0} + + tensors = [] + for i, size in enumerate(sizes): + tensors.append(torch.rand(size, dtype=torch.float, device="cuda:"+str(i % 2))) + ref_param, tst_param, ref_optim, tst_optim = self.gen_param_optim( + tensors, adagrad_option + ) + self.gen_grad(ref_param, tst_param) + with self.assertRaisesRegex(RuntimeError, "not on the same device"): + tst_optim.step() + + def test_adagrad_option(self): + nelem = 1 + adagrad_option = {"lr": 0.01, "eps": 3e-06, "weight_decay": 0} + + tensor = torch.rand(nelem, dtype=torch.float, device="cuda") + ref_param, tst_param, ref_optim, tst_optim = self.gen_param_optim( + [tensor], adagrad_option + ) + + for _ in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + +class TestFusedSGD(TestFusedOptimizer): + def __init__(self, *args, **kwargs): + super(TestFusedSGD, self).__init__(*args, **kwargs) + self.options = {"lr": .25, "momentum": .125} + self.ref_optim = torch.optim.SGD + self.fused_optim = apex.optimizers.FusedSGD + + def test_float(self): + self.gen_single_type_test(param_type=torch.float) + + def test_half(self): + self.gen_single_type_test(param_type=torch.float16) + + @unittest.skipIf(torch.cuda.device_count()<2, "more than 1 GPU required") + def test_multi_device(self): + devices = ("cuda:0", "cuda:1") + for current_dev, tensor_dev in product(devices, devices): + with torch.cuda.device(current_dev): + self.gen_single_type_test(param_type=torch.float, device=tensor_dev) + +if __name__ == '__main__': + unittest.main() diff --git a/apex/tests/L0/run_optimizers/test_lamb.py b/apex/tests/L0/run_optimizers/test_lamb.py new file mode 100644 index 0000000000000000000000000000000000000000..e7186c1b0b2b64da7415adc4575f3c29fcf30367 --- /dev/null +++ b/apex/tests/L0/run_optimizers/test_lamb.py @@ -0,0 +1,270 @@ +import unittest +import os + +import torch +from torch.optim import Optimizer +import apex +from apex.multi_tensor_apply import multi_tensor_applier +from itertools import product + +class RefLAMB(Optimizer): + r"""Implements Lamb algorithm. + + It has been proposed in `Large Batch Optimization for Deep Learning: Training BERT in 76 minutes`_. + + Arguments: + params (iterable): iterable of parameters to optimize or dicts defining + parameter groups + lr (float, optional): learning rate (default: 1e-3) + betas (Tuple[float, float], optional): coefficients used for computing + running averages of gradient and its square (default: (0.9, 0.999)) + eps (float, optional): term added to the denominator to improve + numerical stability (default: 1e-6) + weight_decay (float, optional): weight decay (L2 penalty) (default: 0.01) + + .. _Large Batch Optimization for Deep Learning: Training BERT in 76 minutes: + https://arxiv.org/abs/1904.00962 + """ + + def __init__(self, params, lr=1e-3, betas=(0.9, 0.999), eps=1e-6, weight_decay=0.01): + if not 0.0 <= lr: + raise ValueError("Invalid learning rate: {}".format(lr)) + if not 0.0 <= eps: + raise ValueError("Invalid epsilon value: {}".format(eps)) + if not 0.0 <= betas[0] < 1.0: + raise ValueError("Invalid beta parameter at index 0: {}".format(betas[0])) + if not 0.0 <= betas[1] < 1.0: + raise ValueError("Invalid beta parameter at index 1: {}".format(betas[1])) + defaults = dict(lr=lr, betas=betas, eps=eps, weight_decay=weight_decay) + super(RefLAMB, self).__init__(params, defaults) + if multi_tensor_applier.available: + import amp_C + self.multi_tensor_l2norm=amp_C.multi_tensor_l2norm + # Skip buffer + self._dummy_overflow_buf = torch.tensor([0], dtype=torch.int, device=self.param_groups[0]["params"][0].device) + self.multi_tensor_lamb = amp_C.multi_tensor_lamb + else: + raise RuntimeError('apex.optimizers.FusedLAMB requires cuda extensions') + + def step(self, closure=None): + """Performs a single optimization step. + Arguments: + closure (callable, optional): A closure that reevaluates the model + and returns the loss. + """ + loss = None + if closure is not None: + loss = closure() + + # create separate grad lists for fp32 and fp16 params + g_all_32, g_all_16 = [], [] + for group in self.param_groups: + for p in group['params']: + if p.grad is None: + continue + if p.dtype == torch.float32: + g_all_32.append(p.grad.data) + elif p.dtype == torch.float16: + g_all_16.append(p.grad.data) + else: + raise RuntimeError('FusedLAMB only support fp16 and fp32.') + + device = self.param_groups[0]["params"][0].device + g_norm_32, g_norm_16 = torch.zeros(1, device=device), torch.zeros(1, device=device) + # compute grad norm for two lists + if len(g_all_32) > 0: + g_norm_32 = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [g_all_32], False)[0] + if len(g_all_16) > 0: + g_norm_16 = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [g_all_16], False)[0] + + # blend two grad norms to get global grad norm + global_grad_norm = multi_tensor_applier(self.multi_tensor_l2norm, + self._dummy_overflow_buf, + [[g_norm_32, g_norm_16]], + False)[0] + + max_grad_norm = 1.0 + clipped_ratio = max_grad_norm / max(global_grad_norm, max_grad_norm) + + for group in self.param_groups: + for p in group['params']: + if p.grad is None: + continue + p.grad.data *= clipped_ratio + grad = p.grad.data + if grad.is_sparse: + raise RuntimeError('Lamb does not support sparse gradients, consider SparseAdam instad.') + + state = self.state[p] + + # State initialization + if len(state) == 0: + state['step'] = 0 + # Exponential moving average of gradient values + state['m'] = torch.zeros_like(p.data) + # Exponential moving average of squared gradient values + state['v'] = torch.zeros_like(p.data) + + m_t, v_t = state['m'], state['v'] + beta1, beta2 = group['betas'] + + state['step'] += 1 + + # m_t = beta1 * m + (1 - beta1) * g_t + m_t.mul_(beta1).add_(grad, alpha=1-beta1) + # v_t = beta2 * v + (1 - beta2) * (g_t * g_t) + v_t.mul_(beta2).addcmul_(grad, grad, value=1-beta2) + + # Debiasing + m_t_hat = m_t / (1.0 - beta1 ** state['step']) + v_t_hat = v_t / (1.0 - beta2 ** state['step']) + + update = m_t_hat / v_t_hat.sqrt().add(group['eps']) + + if group['weight_decay'] != 0: + update.add_(p.data, alpha=group['weight_decay']) + + trust_ratio = 1.0 + w_norm = p.data.pow(2).sum().sqrt() + g_norm = update.pow(2).sum().sqrt() + if w_norm > 0 and g_norm > 0: + trust_ratio = w_norm / g_norm + + state['w_norm'] = w_norm + state['g_norm'] = g_norm + state['trust_ratio'] = trust_ratio + + step_size = group['lr'] + + p.data.add_(update, alpha=-step_size*trust_ratio) + + return loss + + +class TestFusedLAMB(unittest.TestCase): + def setUp(self, max_abs_diff=1e-3, max_rel_diff=1, iters=7): + self.max_abs_diff = max_abs_diff + self.max_rel_diff = max_rel_diff + self.iters = iters + torch.cuda.manual_seed(9876) + + def tearDown(self): + pass + + def gen_param_optim(self, tensors, lamb_option): + ref_param = [] + tst_param = [] + for tensor in tensors: + ref_param.append(torch.nn.Parameter(tensor.clone())) + tst_param.append(torch.nn.Parameter(tensor.clone())) + + ref_optim = RefLAMB(ref_param, **lamb_option) + tst_optim = apex.optimizers.FusedLAMB(tst_param, use_nvlamb=True, **lamb_option) + + return (ref_param, tst_param, ref_optim, tst_optim) + + def gen_grad(self, ref_param, tst_param): + for p_ref, p_tst in zip(ref_param, tst_param): + p_ref.grad = torch.rand_like(p_ref) + p_tst.grad = p_ref.grad + + def gen_mixed_grad(self, ref_param, tst_param, scale=1.0): + half_grads = [] + for p_ref, _ in zip(ref_param, tst_param): + half_grads.append(torch.rand_like(p_ref).half()) + p_ref.grad = half_grads[-1].float() / scale + return half_grads + + def get_max_diff(self, ref_param, tst_param): + max_abs_diff = max_rel_diff = 0 + for p_ref, p_tst in zip(ref_param, tst_param): + max_abs_diff_p = (p_ref - p_tst).abs().max().item() + max_rel_diff_p = ((p_ref - p_tst) / p_ref).abs().max().item() + + if max_abs_diff_p > max_abs_diff: max_abs_diff = max_abs_diff_p + if max_rel_diff_p > max_rel_diff: max_rel_diff = max_rel_diff_p + + return max_abs_diff, max_rel_diff + + def gen_single_type_test(self, param_type=torch.float, device="cuda"): + nelem = 278011 + tensor = torch.rand(nelem, dtype=param_type, device=device) + weight_decay = [0, 0.01] + + for wd in weight_decay: + lamb_option = {'lr':5e-4, 'betas':(0.9, 0.999), 'eps':1e-08, 'weight_decay':wd} + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim([tensor], lamb_option) + + for i in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + torch.cuda.synchronize() + tst_optim.step() + torch.cuda.synchronize() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + def test_float(self): + self.gen_single_type_test(param_type=torch.float) + + @unittest.skip("PyTorch optimizer is not numerically correct for fp16") + def test_half(self): + self.gen_single_type_test(param_type=torch.float16) + + @unittest.skipIf(torch.cuda.device_count()<2, "more than 1 GPU required") + def test_multi_device(self): + devices = ("cuda:0", "cuda:1") + for current_dev, tensor_dev in product(devices, devices): + with torch.cuda.device(current_dev): + self.gen_single_type_test(param_type=torch.float, device=tensor_dev) + + def test_multi_params(self): + sizes = [[4096, 1024], [4096], [4096, 2048], [32320, 1024], [1]] + weight_decay = [0, 0.01] + + for wd in weight_decay: + lamb_option = {'lr':5e-4, 'betas':(0.9, 0.999), 'eps':1e-08, 'weight_decay':wd} + tensors = [] + for size in sizes: + tensors.append(torch.rand(size, dtype=torch.float, device='cuda')) + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim(tensors, lamb_option) + + for i in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + def test_lamb_option(self): + nelem = 1 + tensor = torch.rand(nelem, dtype=torch.float, device='cuda') + weight_decay = [0, 0.01] + + for wd in weight_decay: + lamb_option = {'lr':0.01, 'betas':(0.6, 0.9), 'eps':3e-06, 'weight_decay':wd} + ref_param, tst_param, ref_optim, tst_optim = \ + self.gen_param_optim([tensor], lamb_option) + + for i in range(self.iters): + self.gen_grad(ref_param, tst_param) + ref_optim.step() + tst_optim.step() + max_abs_diff, max_rel_diff = self.get_max_diff(ref_param, tst_param) + + self.assertLessEqual(max_abs_diff, self.max_abs_diff) + self.assertLessEqual(max_rel_diff, self.max_rel_diff) + + +if __name__ == '__main__': + script_path = os.path.dirname(os.path.realpath(__file__)) + unittest.main() diff --git a/apex/tests/L0/run_pyprof_data/__init__.py b/apex/tests/L0/run_pyprof_data/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/apex/tests/L0/run_pyprof_data/test_pyprof_data.py b/apex/tests/L0/run_pyprof_data/test_pyprof_data.py new file mode 100644 index 0000000000000000000000000000000000000000..266212a76422866ccb375bb94d60240617decda4 --- /dev/null +++ b/apex/tests/L0/run_pyprof_data/test_pyprof_data.py @@ -0,0 +1,43 @@ +import inspect +import unittest + +from apex.pyprof.prof.data import Data +from apex.pyprof.prof.prof import foo + + +class TestPyProfData(unittest.TestCase): + + def __init__(self, testName): + super().__init__(testName) + + def setUp(self): + pass + + def tearDown(self): + pass + + def test_data(self): + kernels = [ + {'kShortName': 'elementwise_kernel', 'kDuration': 2848, 'layer': [], 'trace': [], 'reprMarkers': [], 'marker': ["{'mod': 'Tensor', 'op': 'float', 'args': [{'name': '', 'type': 'tensor', 'shape': (18, 104, 160), 'dtype': 'bool'}]}"], 'seqMarker': ['to, seq = 60471'], 'seqId': [60471], 'subSeqId': 0, 'altSeqId': [], 'dir': 'fprop', 'mod': ['Tensor'], 'op': ['float'], 'tid': 1431533376, 'device': 0, 'stream': 7, 'grid': (585, 1, 1), 'block': (512, 1, 1), 'kLongName': 'void at::native::elementwise_kernel<512, 1, void at::native::gpu_kernel_impl(at::TensorIterator&)::{lambda(bool)#1}>(at::TensorIterator&, void at::native::copy_kernel_impl(at::TensorIterator&)::{lambda(bool)#1} const&)::{lambda(int)#1}>(int, void at::native::gpu_kernel_impl(at::TensorIterator&)::{lambda(bool)#1}>(at::TensorIterator&, void at::native::copy_kernel_impl(at::TensorIterator&)::{lambda(bool)#1} const&)::{lambda(int)#1})'}, + {'kShortName': 'elementwise_kernel', 'kDuration': 201182, 'layer': [], 'trace': [], 'reprMarkers': [], 'marker': ["{'mod': 'Tensor', 'op': 'clone', 'args': [{'name': '', 'type': 'tensor', 'shape': (18, 4, 416, 640), 'dtype': 'float32'}]}"], 'seqMarker': ['clone, seq = 60161'], 'seqId': [60161], 'subSeqId': 0, 'altSeqId': [], 'dir': 'fprop', 'mod': ['Tensor'], 'op': ['clone'], 'tid': 1431533376, 'device': 0, 'stream': 7, 'grid': (37440, 1, 1), 'block': (128, 1, 1), 'kLongName': 'void at::native::elementwise_kernel<128, 4, void at::native::gpu_kernel_impl(at::TensorIterator&)::{lambda(float)#1}>(at::TensorIterator&, void at::native::copy_kernel_impl(at::TensorIterator&)::{lambda(float)#1} const&)::{lambda(int)#2}>(int, void at::native::gpu_kernel_impl(at::TensorIterator&)::{lambda(float)#1}>(at::TensorIterator&, void at::native::copy_kernel_impl(at::TensorIterator&)::{lambda(float)#1} const&)::{lambda(int)#2})'}, + ] + + for k in kernels: + d = Data(k) + mod = k['mod'] + op = k['op'] + xx = foo(mod, op, d) + d.setParams(xx.params()) + + +def run_tests(test_name): + dummy = TestPyProfData(test_name) + test_cases = list(filter(lambda x: 'test_' in x, map(lambda x: x[0], inspect.getmembers(dummy, predicate=inspect.ismethod)))) + print(f'Running tests for {test_name}') + suite = unittest.TestSuite() + for test_case in test_cases: + suite.addTest(TestPyProfData(test_case)) + unittest.TextTestRunner().run(suite) + +if __name__ == '__main__': + run_tests('test_data') diff --git a/apex/tests/L0/run_pyprof_nvtx/__init__.py b/apex/tests/L0/run_pyprof_nvtx/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..7cd4c1062add9304a997a2969d246451a1a7958e --- /dev/null +++ b/apex/tests/L0/run_pyprof_nvtx/__init__.py @@ -0,0 +1 @@ +import test_pyprof_nvtx.TestPyProfNvtx as TestPyProfNvtx diff --git a/apex/tests/L0/run_pyprof_nvtx/test_pyprof_nvtx.py b/apex/tests/L0/run_pyprof_nvtx/test_pyprof_nvtx.py new file mode 100644 index 0000000000000000000000000000000000000000..6f2c8d1e26a8dfb3822195cd6dbff26f23f19e47 --- /dev/null +++ b/apex/tests/L0/run_pyprof_nvtx/test_pyprof_nvtx.py @@ -0,0 +1,526 @@ +import inspect +import os +import torch +import torch.nn.functional as F +import unittest + +from apex import pyprof +pyprof.nvtx.init() + +# TODO: add tests for: +# F.bilinear, F.l1_loss, F.multilabel_soft_margin_loss, F.multi_margin_loss + +class TestPyProfNvtx(unittest.TestCase): + + def __init__(self, testName, dtype=torch.float16): + super().__init__(testName) + self.dtype = dtype + + def setUp(self): + pass + + def tearDown(self): + pass + + def test_conv1d(self): + # Data and weight tensors + tensor1d_in_conv = torch.randn(32, 3, 224, device='cuda', dtype=self.dtype) + tensor1d_in_conv_grouped = torch.randn(32, 6, 224, device='cuda', dtype=self.dtype) + conv1d_filter = torch.randn(16, 3, 3, device='cuda', dtype=self.dtype) + conv1d_bias = torch.ones(16, device='cuda', dtype=self.dtype) + # Vanilla conv1d + conv1d_out_vanilla = F.conv1d(tensor1d_in_conv, conv1d_filter) + # conv1d with bias + conv1d_out_with_bias = F.conv1d(tensor1d_in_conv, conv1d_filter, bias=conv1d_bias) + # conv1d - stride > 1 + conv1d_out_strided = F.conv1d(tensor1d_in_conv, conv1d_filter, stride=2) + # conv1d - dilation > 1 + conv1d_out_dilated = F.conv1d(tensor1d_in_conv, conv1d_filter, dilation=2) + # conv1d - groups > 1 + conv1d_out_grouped = F.conv1d(tensor1d_in_conv_grouped, conv1d_filter, groups=2) + # conv1d - padding with zeros + conv1d_out_padding_zeros = F.conv1d(tensor1d_in_conv, conv1d_filter, padding=6) + + def test_conv2d(self): + # Data and weight tensors + tensor2d_in_conv = torch.randn(32, 3, 224, 224, device='cuda', dtype=self.dtype) + tensor2d_in_conv_grouped = torch.randn(32, 6, 224, 224, device='cuda', dtype=self.dtype) + conv2d_filter = torch.randn(16, 3, 3, 3, device='cuda', dtype=self.dtype) + conv2d_bias = torch.ones(16, device='cuda', dtype=self.dtype) + # Vanilla conv2d + conv2d_out_vanilla = F.conv2d(tensor2d_in_conv, conv2d_filter) + # conv2d with bias + conv2d_with_bias = F.conv2d(tensor2d_in_conv, conv2d_filter, bias=conv2d_bias) + # conv2d - stride > 1 + conv2d_out_strided = F.conv2d(tensor2d_in_conv, conv2d_filter, stride=2) + # conv2d - dilation > 1 + conv2d_out_dilated = F.conv2d(tensor2d_in_conv, conv2d_filter, dilation=2) + # conv2d - groups > 1 + conv2d_out_grouped = F.conv2d(tensor2d_in_conv_grouped, conv2d_filter, groups=2) + # conv2d - padding with zeros + conv2d_out_padding_zeros = F.conv2d(tensor2d_in_conv, conv2d_filter, padding=6) + + + def test_conv3d(self): + # Data and weight tensors + tensor3d_in_conv = torch.randn(32, 3, 16, 224, 224, device='cuda', dtype=self.dtype) + tensor3d_in_conv_grouped = torch.randn(32, 6, 16, 224, 224, device='cuda', dtype=self.dtype) + conv3d_filter = torch.randn(16, 3, 3, 3, 3, device='cuda', dtype=self.dtype) + conv3d_bias = torch.ones(16, device='cuda', dtype=self.dtype) + # Vanilla conv3d + conv3d_out_vanilla = F.conv3d(tensor3d_in_conv, conv3d_filter) + # conv3d - stride > 1 + conv3d_out_strided = F.conv3d(tensor3d_in_conv, conv3d_filter, stride=2) + # conv3d - dilation > 1 + conv3d_out_dilated = F.conv3d(tensor3d_in_conv, conv3d_filter, dilation=2) + # conv3d - groups > 1 + conv3d_out_grouped = F.conv3d(tensor3d_in_conv_grouped, conv3d_filter, groups=2) + # conv3d - padding with zeros + conv3d_out_padding_zeros = F.conv3d(tensor3d_in_conv, conv3d_filter, padding=6) + + def test_conv_transpose1d(self): + # Data and weight tensors + conv_transpose1d_tensor = torch.randn(64, 16, 64, device='cuda', dtype=self.dtype) + conv_transpose1d_filter = torch.randn(16, 32, 3, device='cuda', dtype=self.dtype) + conv_transpose1d_bias = torch.randn(32, device='cuda', dtype=self.dtype) + # Conv transpose runs + conv_transpose1d_out = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter) + conv_transpose1d_out_biased = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter, bias=conv_transpose1d_bias) + conv_transpose1d_out_strided = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter, stride=2) + conv_transpose1d_out_padded = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter, padding=3) + conv_transpose1d_out2_padded = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter, output_padding=2, dilation=3) + conv_transpose1d_out_grouped = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter, groups=2) + conv_transpose1d_out_dilated = F.conv_transpose1d(conv_transpose1d_tensor, conv_transpose1d_filter, dilation=2) + + + def test_conv_transpose2d(self): + # Data and weight tensors + conv_transpose2d_tensor = torch.randn(64, 8, 5, 5, device='cuda', dtype=self.dtype) + conv_transpose2d_filter = torch.randn(8, 16, 3, 3, device='cuda', dtype=self.dtype) + conv_transpose2d_bias = torch.randn(16, device='cuda', dtype=self.dtype) + # Conv transpose runs + conv_transpose2d_out = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter) + conv_transpose2d_out_biased = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter, bias=conv_transpose2d_bias) + conv_transpose2d_out_strided = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter, stride=2) + conv_transpose2d_out_padded = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter, padding=3) + conv_transpose2d_out2_padded = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter, output_padding=2, dilation=3) + conv_transpose2d_out_grouped = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter, groups=2) + conv_transpose2d_out_dilated = F.conv_transpose2d(conv_transpose2d_tensor, conv_transpose2d_filter, dilation=2) + + def test_conv_transpose3d(self): + # Data and weight tensors + conv_transpose3d_tensor = torch.randn(20, 16, 50, 10, 20, device='cuda', dtype=self.dtype) + conv_transpose3d_filter = torch.randn(16, 33, 3, 3, 3, device='cuda', dtype=self.dtype) + conv_transpose3d_bias = torch.randn(33, device='cuda', dtype=self.dtype) + # Conv transpose runs + conv_transpose3d_out = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter) + conv_transpose3d_out_biased = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter, bias=conv_transpose3d_bias) + conv_transpose3d_out_strided = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter, stride=2) + conv_transpose3d_out_padded = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter, padding=3) + conv_transpose3d_out2_padded = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter, output_padding=2, dilation=3) + conv_transpose3d_out_grouped = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter, groups=2) + conv_transpose3d_out_dilated = F.conv_transpose3d(conv_transpose3d_tensor, conv_transpose3d_filter, dilation=2) + + def test_unfold(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + kernel_size = (4, 5) + inp_unf_dilated = F.unfold(inp, kernel_size, dilation=2) + inp_unf_padded = F.unfold(inp, kernel_size, padding=2) + inp_unf_strided = F.unfold(inp, kernel_size, stride=2) + + def test_fold(self): + inp = torch.randn(3, 20, 20, device='cuda', dtype=self.dtype) + inp_folded = F.fold(inp, (4, 5), (1, 1)) + + def test_avg_pool1d(self): + inp = torch.randn(1, 1, 28, device='cuda', dtype=self.dtype) + out = F.avg_pool1d(inp, kernel_size=5, stride=2, padding=2, ceil_mode=True, count_include_pad=False) + + def test_avg_pool2d(self): + inp = torch.randn(1, 3, 224, 224, device='cuda', dtype=self.dtype) + out = F.avg_pool2d(inp, kernel_size=5, stride=2, padding=2, ceil_mode=True, count_include_pad=False) + + def test_avg_pool3d(self): + inp = torch.randn(1, 3, 16, 224, 224, device='cuda', dtype=self.dtype) + out = F.avg_pool3d(inp, kernel_size=5, stride=2, padding=2, ceil_mode=True, count_include_pad=False) + + def test_adaptive_avg_pool1d(self): + inp = torch.randn(1, 1, 28, device='cuda', dtype=self.dtype) + out = F.adaptive_avg_pool1d(inp, output_size=5) + + def test_adaptive_avg_pool2d(self): + inp = torch.randn(1, 16, 32, 32, device='cuda', dtype=self.dtype) + out = F.adaptive_avg_pool2d(inp, output_size=5) + + def test_adaptive_avg_pool3d(self): + inp = torch.randn(1, 16, 16, 32, 32, device='cuda', dtype=self.dtype) + out = F.adaptive_avg_pool3d(inp, output_size=5) + + def test_max_pool1d(self): + inp = torch.randn(1, 16, 32, device='cuda', dtype=self.dtype) + out = F.max_pool1d(inp, kernel_size=5, stride=2, padding=2, return_indices=True, ceil_mode=True) + + def test_max_pool2d(self): + inp = torch.randn(1, 16, 32, 32, device='cuda', dtype=self.dtype) + out = F.max_pool2d(inp, kernel_size=5, stride=2, padding=2, return_indices=True, ceil_mode=True) + + def test_max_pool3d(self): + inp = torch.randn(1, 16, 16, 32, 32, device='cuda', dtype=self.dtype) + out = F.max_pool3d(inp, kernel_size=5, stride=2, padding=2, return_indices=True, ceil_mode=True) + + def test_adaptive_max_pool1d(self): + inp = torch.randn(1, 16, 28, device='cuda', dtype=self.dtype) + out = F.adaptive_max_pool1d(inp, output_size=5, return_indices=True) + + def test_adaptive_max_pool2d(self): + inp = torch.randn(1, 16, 32, 32, device='cuda', dtype=self.dtype) + out = F.adaptive_max_pool2d(inp, output_size=5, return_indices=True) + + def test_adaptive_max_pool3d(self): + inp = torch.randn(1, 16, 16, 32, 32, device='cuda', dtype=self.dtype) + out = F.adaptive_max_pool3d(inp, output_size=5, return_indices=True) + + def test_max_unpool1d(self): + inp = torch.randn(1, 16, 32, device='cuda', dtype=self.dtype) + output, indices = F.max_pool1d(inp, kernel_size=5, stride=2, padding=2, return_indices=True, ceil_mode=True) + output = F.max_unpool1d(output, indices, kernel_size=2, stride=2, padding=2) + + def test_max_unpool2d(self): + inp = torch.randn(1, 16, 32, 32, device='cuda', dtype=self.dtype) + output, indices = F.max_pool2d(inp, kernel_size=5, stride=2, padding=2, return_indices=True, ceil_mode=True) + output = F.max_unpool2d(output, indices, kernel_size=2, stride=2, padding=2) + + def test_max_unpool3d(self): + inp = torch.randn(1, 16, 8, 32, 32, device='cuda', dtype=self.dtype) + output, indices = F.max_pool3d(inp, kernel_size=5, stride=2, padding=2, return_indices=True, ceil_mode=True) + output = F.max_unpool3d(output, indices, kernel_size=2, stride=2, padding=2) + + def test_lp_pool1d(self): + inp = torch.randn(1, 32, 64, device='cuda', dtype=self.dtype) + output = F.lp_pool1d(inp, 2, 3, stride=2, ceil_mode=True) + + def test_lp_pool2d(self): + #torch.nn.LPPool2d(norm_type, kernel_size, stride=None, ceil_mode=False) + inp = torch.randn(1, 32, 64, 64, device='cuda', dtype=self.dtype) + output = F.lp_pool2d(inp, 2, 3, stride=2, ceil_mode=True) + + def test_threshold(self): + inp = torch.randn(1, 8, 32, 32, device='cuda', dtype=self.dtype) + output = F.threshold(inp, 6, 6, inplace=False) + + def test_threshold_(self): + inp = torch.randn(1, 8, 32, 32, device='cuda', dtype=self.dtype) + output = F.threshold_(inp, 6, 6) + + def test_relu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.relu(inp, inplace=False) + + def test_relu_(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.relu_(inp) + + def test_hardtanh(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.hardtanh(inp, min_val=-1., max_val=1., inplace=False) + + def test_hardtanh_(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.hardtanh_(inp, min_val=-1., max_val=1.) + + def test_relu6(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.relu6(inp, inplace=False) + + def test_elu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.elu(inp, alpha=1.0, inplace=False) + + def test_elu_(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.elu_(inp, alpha=1.0) + + def test_selu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.selu(inp) + + def test_celu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.celu(inp, alpha=1.0, inplace=False) + + def test_leaky_relu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.leaky_relu(inp, negative_slope=0.01, inplace=False) + + def test_leaky_relu_(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.leaky_relu_(inp, negative_slope=0.01) + + def test_prelu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + weight = torch.randn(1, device='cuda', dtype=self.dtype) + output = F.prelu(inp, weight) + + def test_rrelu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.rrelu(inp, lower=1./8, upper=1./3, training=False, inplace=False) + + def test_rrelu_(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.rrelu(inp, lower=1./8, upper=1./3, training=False) + + def test_glu(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.glu(inp, dim=-1) + + def test_logsigmoid(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.logsigmoid(inp) + + def test_hardshrink(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.hardshrink(inp, lambd=0.5) + + def test_tanhshrink(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.tanhshrink(inp) + + def test_softsign(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.softsign(inp) + + def test_softplus(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.softplus(inp, beta=1, threshold=20) + + def test_softmin(self): + inp = torch.randn(16, 1024, device='cuda', dtype=self.dtype) + output = F.softmin(inp, dim=1, _stacklevel=3, dtype=self.dtype) + + def test_softmax(self): + inp = torch.randn(16, 1024, device='cuda', dtype=self.dtype) + output = F.softmax(inp, dim=1, _stacklevel=3, dtype=self.dtype) + + def test_softshrink(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.softshrink(inp, lambd=0.5) + + def test_gumbel_softmax(self): + inp = torch.randn(16, 1024, device='cuda', dtype=self.dtype) + output = F.gumbel_softmax(inp, tau=1, hard=False, eps=1e-10, dim=-1) + + def test_log_softmax(self): + inp = torch.randn(16, 1024, device='cuda', dtype=self.dtype) + output = F.log_softmax(inp, dim=-1, _stacklevel=3) + + def test_tanh(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = torch.tanh(inp) + + def test_sigmoid(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = torch.sigmoid(inp) + + def test_batch_norm(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + # running_mean, running_var + running_mean = torch.randn(3, device='cuda', dtype=self.dtype) + running_var = torch.randn(3, device='cuda', dtype=self.dtype) + output = F.batch_norm(inp, running_mean, running_var, weight=None, bias=None, training=False, momentum=0.1, eps=1e-05) + + def test_instance_norm(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + running_mean = torch.randn(3, device='cuda', dtype=self.dtype) + running_var = torch.randn(3, device='cuda', dtype=self.dtype) + output = F.instance_norm(inp, running_mean=running_mean, running_var=running_var, weight=None, bias=None, use_input_stats=True, momentum=0.1, eps=1e-05) + + def test_layer_norm(self): + inp = torch.randn(1, 3, 32, 32, device='cuda', dtype=self.dtype) + output = F.layer_norm(inp, inp.size()[1:], weight=None, bias=None, eps=1e-05) + + def test_local_response_norm(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = F.local_response_norm(inp, 2, alpha=0.0001, beta=0.75, k=1.0) + + def test_normalize(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = F.normalize(inp, p=2, dim=1, eps=1e-12, out=None) + + def test_linear(self): + inp = torch.randn(32, 64, 128, device='cuda', dtype=self.dtype) + weight = torch.randn(256, 128, device='cuda', dtype=self.dtype) + output = F.linear(inp, weight, bias=None) + + def test_dropout(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = F.dropout(inp, p=0.5, training=True, inplace=False) + + def test_alpha_dropout(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = F.alpha_dropout(inp, p=0.5, training=True, inplace=False) + + def test_dropout2d(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = F.dropout2d(inp, p=0.5, training=True, inplace=False) + + def test_dropout3d(self): + inp = torch.randn(16, 8, 32, 64, 64, device='cuda', dtype=self.dtype) + output = F.dropout3d(inp, p=0.5, training=True, inplace=False) + + def test_embedding(self): + pre_embed_dim = 1024 + post_embed_dim = 32 + inp = torch.randint(0, pre_embed_dim, (128, 16), device='cuda') + weight = torch.randn(pre_embed_dim, post_embed_dim, device='cuda', dtype=self.dtype) + output = F.embedding(inp, weight, padding_idx=None, max_norm=None, norm_type=2.0, scale_grad_by_freq=False, sparse=False) + + def test_embedding_bag(self): + pre_embed_dim = 1024 + post_embed_dim = 32 + inp = torch.randint(0, pre_embed_dim, (128, 16), device='cuda') + weight = torch.randn(pre_embed_dim, post_embed_dim, device='cuda', dtype=self.dtype) + output = F.embedding_bag(inp, weight, offsets=None, max_norm=None, norm_type=2, + scale_grad_by_freq=False, mode='mean', sparse=False) + + def test_one_hot(self): + num_classes = 10 + inp = torch.randint(0, num_classes, (128, 16), device='cuda') + output = F.one_hot(inp, num_classes=10) + + def test_pairwise_distance(self): + inp1 = torch.randn(1024, 128, device='cuda', dtype=self.dtype) + inp2 = torch.randn(1024, 128, device='cuda', dtype=self.dtype) + output = F.pairwise_distance(inp1, inp2, p=2.0, eps=1e-06, keepdim=False) + + def test_cosine_similarity(self): + inp1 = torch.randn(1024, 128, device='cuda', dtype=self.dtype) + inp2 = torch.randn(1024, 128, device='cuda', dtype=self.dtype) + output = F.cosine_similarity(inp1, inp2, dim=1, eps=1e-8) + + def test_pdist(self): + # pdist is not implemented for fp16 + inp = torch.randn(128, 128, device='cuda', dtype=torch.float32) + output = F.pdist(inp, p=2) + + def test_binary_cross_entropy(self): + # binary_cross_entropy is not implemented for fp16 + inp = torch.randn(32, 128, device='cuda', dtype=torch.float32, requires_grad=True) + target = torch.randn(32, 128, device='cuda', dtype=torch.float32, requires_grad=False) + output = F.binary_cross_entropy(torch.sigmoid(inp), target) + + def test_binary_cross_entropy_with_logits(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.empty_like(inp).random_(2) + output = F.binary_cross_entropy_with_logits(inp, target) + + def test_poisson_nll_loss(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=False) + output = F.poisson_nll_loss(inp, target, log_input=True, full=False, + size_average=None, eps=1e-08, reduce=None, reduction='mean') + + def test_cosine_embedding_loss(self): + inp1 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + inp2 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randn(32, device='cuda', dtype=self.dtype, requires_grad=False) + output = F.cosine_embedding_loss(inp1, inp2, target, margin=0, + size_average=None, reduce=None, reduction='mean') + + def test_cross_entropy(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randint(0, 100, (32,), device='cuda', dtype=torch.long, requires_grad=False) + output = F.cross_entropy(inp, target, weight=None, size_average=None, + ignore_index=-100, reduce=None, reduction='mean') + + def test_ctc_loss(self): + # force fp32 because _th_normal_ (used by next line is not supported for fp16) + log_probs = torch.randn(50, 16, 20, device='cuda', dtype=torch.float32).log_softmax(2).detach().requires_grad_() + targets = torch.randint(1, 20, (16, 30), device='cuda', dtype=torch.long) + input_lengths = torch.full((16,), 50, dtype=torch.long) + target_lengths = torch.randint(10, 30, (16,), dtype=torch.long) + loss = F.ctc_loss(log_probs, targets, input_lengths, target_lengths) + + def test_hinge_embedding_loss(self): + inp = torch.randn(128, 32, device='cuda', dtype=self.dtype) + target = torch.randint(0, 1, (32,), device='cuda') - 1 + output = F.hinge_embedding_loss(inp, target, margin=1.0, size_average=None, reduce=None, reduction='mean') + + def test_kl_div(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + output = F.kl_div(inp, target, size_average=None, reduce=None, reduction='batchmean') + + def test_mse_loss(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + output = F.mse_loss(inp, target, size_average=None, reduce=None, reduction='mean') + + def test_margin_ranking_loss(self): + inp1 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + inp2 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = (torch.randint(0, 1, (128,), device='cuda') - 1).type_as(inp1) + output = F.margin_ranking_loss(inp1, inp2, target, margin=0, size_average=None, reduce=None, reduction='mean') + + def test_multilabel_margin_loss(self): + inp = torch.randn(1024, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randint(0, 10, (1024,), dtype=torch.long, device='cuda') + output = F.multilabel_margin_loss(inp, target, size_average=None, reduce=None, reduction='mean') + + def test_nll_loss(self): + inp = torch.randn(64, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randint(0, 10, (64,), device='cuda', dtype=torch.long) + output = F.nll_loss(inp, target, weight=None, size_average=None, ignore_index=-100, reduce=None, reduction='mean') + + def test_smooth_l1_loss(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=False) + output = F.smooth_l1_loss(inp, target, size_average=None, reduce=None, reduction='mean') + + def test_soft_margin_loss(self): + inp = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + target = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=False) + output = F.soft_margin_loss(inp, target, size_average=None, reduce=None, reduction='mean') + + def test_triplet_margin_loss(self): + inp1 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + inp2 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + inp3 = torch.randn(32, 128, device='cuda', dtype=self.dtype, requires_grad=True) + output = F.triplet_margin_loss(inp1, inp2, inp3, margin=1.0, p=2, + eps=1e-06, swap=False, size_average=None, reduce=None, reduction='mean') + + def test_pixel_shuffle(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = torch.nn.functional.pixel_shuffle(inp, 2) + + def test_pad(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + pad = (3, 3) + output = F.pad(inp, pad, mode='constant', value=0) + + def test_interpolate(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + output = F.interpolate(inp, size=None, scale_factor=2, mode='nearest', align_corners=None) + + def test_grid_sample(self): + inp = torch.randn(16, 8, 64, 64, device='cuda', dtype=self.dtype) + grid = torch.randn(16, 32, 32, 2, device='cuda', dtype=self.dtype) + output = F.grid_sample(inp, grid, mode='bilinear', padding_mode='zeros') + + def test_affine_grid(self): + theta = torch.randn(32, 2, 3, device='cuda', dtype=self.dtype) + size = (32, 8, 32, 32) + output = F.affine_grid(theta, size) + + +def run_tests(precision): + dummy = TestPyProfNvtx('test_affine_grid', None) + test_cases = list(filter(lambda x: 'test_' in x, map(lambda x: x[0], inspect.getmembers(dummy, predicate=inspect.ismethod)))) + print("Running tests for {}".format(precision)) + suite = unittest.TestSuite() + for test_case in test_cases: + suite.addTest(TestPyProfNvtx(test_case, precision)) + unittest.TextTestRunner().run(suite) + +if __name__ == '__main__': + run_tests(torch.float32) + run_tests(torch.float16) diff --git a/apex/tests/L0/run_test.py b/apex/tests/L0/run_test.py new file mode 100644 index 0000000000000000000000000000000000000000..8a4135d5f0e80f882368cb4f56c5b3ae4445666d --- /dev/null +++ b/apex/tests/L0/run_test.py @@ -0,0 +1,20 @@ +import unittest +import sys + +test_dirs = ["run_amp", "run_fp16util", "run_optimizers", "run_fused_layer_norm", "run_pyprof_nvtx", "run_pyprof_data", "run_mlp"] + +runner = unittest.TextTestRunner(verbosity=2) + +errcode = 0 + +for test_dir in test_dirs: + suite = unittest.TestLoader().discover(test_dir) + + print("\nExecuting tests from " + test_dir) + + result = runner.run(suite) + + if not result.wasSuccessful(): + errcode = 1 + +sys.exit(errcode) diff --git a/apex/tests/L1/common/compare.py b/apex/tests/L1/common/compare.py new file mode 100644 index 0000000000000000000000000000000000000000..74374d412da530a8ae578deb3efe9e1e5407cb89 --- /dev/null +++ b/apex/tests/L1/common/compare.py @@ -0,0 +1,64 @@ +import argparse +import torch + +parser = argparse.ArgumentParser(description='Compare') +parser.add_argument('--opt-level', type=str) +parser.add_argument('--keep-batchnorm-fp32', type=str, default=None) +parser.add_argument('--loss-scale', type=str, default=None) +parser.add_argument('--fused-adam', action='store_true') +parser.add_argument('--use_baseline', action='store_true') +args = parser.parse_args() + +base_file = str(args.opt_level) + "_" +\ + str(args.loss_scale) + "_" +\ + str(args.keep_batchnorm_fp32) + "_" +\ + str(args.fused_adam) + +file_e = "True_" + base_file +file_p = "False_" + base_file +if args.use_baseline: + file_b = "baselines/True_" + base_file + +dict_e = torch.load(file_e) +dict_p = torch.load(file_p) +if args.use_baseline: + dict_b = torch.load(file_b) + +torch.set_printoptions(precision=10) + +print(file_e) +print(file_p) +if args.use_baseline: + print(file_b) + +# ugly duplication here... +if not args.use_baseline: + for n, (i_e, i_p) in enumerate(zip(dict_e["Iteration"], dict_p["Iteration"])): + assert i_e == i_p, "i_e = {}, i_p = {}".format(i_e, i_p) + + loss_e = dict_e["Loss"][n] + loss_p = dict_p["Loss"][n] + assert loss_e == loss_p, "Iteration {}, loss_e = {}, loss_p = {}".format(i_e, loss_e, loss_p) + print("{:4} {:15.10f} {:15.10f} {:15.10f} {:15.10f}".format( + i_e, + loss_e, + loss_p, + dict_e["Speed"][n], + dict_p["Speed"][n])) +else: + for n, (i_e, i_p) in enumerate(zip(dict_e["Iteration"], dict_p["Iteration"])): + assert i_e == i_p, "i_e = {}, i_p = {}".format(i_e, i_p) + + loss_e = dict_e["Loss"][n] + loss_p = dict_p["Loss"][n] + loss_b = dict_b["Loss"][n] + assert loss_e == loss_p, "Iteration {}, loss_e = {}, loss_p = {}".format(i_e, loss_e, loss_p) + assert loss_e == loss_b, "Iteration {}, loss_e = {}, loss_b = {}".format(i_e, loss_e, loss_b) + print("{:4} {:15.10f} {:15.10f} {:15.10f} {:15.10f} {:15.10f} {:15.10f}".format( + i_e, + loss_b, + loss_e, + loss_p, + dict_b["Speed"][n], + dict_e["Speed"][n], + dict_p["Speed"][n])) diff --git a/apex/tests/L1/common/main_amp.py b/apex/tests/L1/common/main_amp.py new file mode 100644 index 0000000000000000000000000000000000000000..106a0f637803fdbef042e1d60aaab33bbb1b7595 --- /dev/null +++ b/apex/tests/L1/common/main_amp.py @@ -0,0 +1,526 @@ +import argparse +import os +import shutil +import time + +import torch +import torch.nn as nn +import torch.nn.parallel +import torch.backends.cudnn as cudnn +import torch.distributed as dist +import torch.optim +import torch.utils.data +import torch.utils.data.distributed +import torchvision.transforms as transforms +import torchvision.datasets as datasets +import torchvision.models as models + +import numpy as np + +try: + from apex.parallel import DistributedDataParallel as DDP + from apex.fp16_utils import * + from apex import amp, optimizers + from apex.multi_tensor_apply import multi_tensor_applier +except ImportError: + raise ImportError("Please install apex from https://www.github.com/nvidia/apex to run this example.") + +model_names = sorted(name for name in models.__dict__ + if name.islower() and not name.startswith("__") + and callable(models.__dict__[name])) + +parser = argparse.ArgumentParser(description='PyTorch ImageNet Training') +parser.add_argument('data', metavar='DIR', + help='path to dataset') +parser.add_argument('--arch', '-a', metavar='ARCH', default='resnet18', + choices=model_names, + help='model architecture: ' + + ' | '.join(model_names) + + ' (default: resnet18)') +parser.add_argument('-j', '--workers', default=4, type=int, metavar='N', + help='number of data loading workers (default: 4)') +parser.add_argument('--epochs', default=90, type=int, metavar='N', + help='number of total epochs to run') +parser.add_argument('--start-epoch', default=0, type=int, metavar='N', + help='manual epoch number (useful on restarts)') +parser.add_argument('-b', '--batch-size', default=256, type=int, + metavar='N', help='mini-batch size per process (default: 256)') +parser.add_argument('--lr', '--learning-rate', default=0.1, type=float, + metavar='LR', help='Initial learning rate. Will be scaled by /256: args.lr = args.lr*float(args.batch_size*args.world_size)/256. A warmup schedule will also be applied over the first 5 epochs.') +parser.add_argument('--momentum', default=0.9, type=float, metavar='M', + help='momentum') +parser.add_argument('--weight-decay', '--wd', default=1e-4, type=float, + metavar='W', help='weight decay (default: 1e-4)') +parser.add_argument('--print-freq', '-p', default=10, type=int, + metavar='N', help='print frequency (default: 10)') +parser.add_argument('--resume', default='', type=str, metavar='PATH', + help='path to latest checkpoint (default: none)') +parser.add_argument('-e', '--evaluate', dest='evaluate', action='store_true', + help='evaluate model on validation set') +parser.add_argument('--pretrained', dest='pretrained', action='store_true', + help='use pre-trained model') + +parser.add_argument('--prof', dest='prof', action='store_true', + help='Only run 10 iterations for profiling.') +parser.add_argument('--deterministic', action='store_true') + +parser.add_argument("--local_rank", default=0, type=int) +parser.add_argument('--sync_bn', action='store_true', + help='enabling apex sync BN.') + +parser.add_argument('--has-ext', action='store_true') +parser.add_argument('--opt-level', type=str) +parser.add_argument('--keep-batchnorm-fp32', type=str, default=None) +parser.add_argument('--loss-scale', type=str, default=None) +parser.add_argument('--fused-adam', action='store_true') + +parser.add_argument('--prints-to-process', type=int, default=10) + +cudnn.benchmark = True + +def fast_collate(batch): + imgs = [img[0] for img in batch] + targets = torch.tensor([target[1] for target in batch], dtype=torch.int64) + w = imgs[0].size[0] + h = imgs[0].size[1] + tensor = torch.zeros( (len(imgs), 3, h, w), dtype=torch.uint8 ) + for i, img in enumerate(imgs): + nump_array = np.asarray(img, dtype=np.uint8) + if(nump_array.ndim < 3): + nump_array = np.expand_dims(nump_array, axis=-1) + nump_array = np.rollaxis(nump_array, 2) + + tensor[i] += torch.from_numpy(nump_array) + + return tensor, targets + +best_prec1 = 0 +args = parser.parse_args() + +# Let multi_tensor_applier be the canary in the coalmine +# that verifies if the backend is what we think it is +assert multi_tensor_applier.available == args.has_ext + +print("opt_level = {}".format(args.opt_level)) +print("keep_batchnorm_fp32 = {}".format(args.keep_batchnorm_fp32), type(args.keep_batchnorm_fp32)) +print("loss_scale = {}".format(args.loss_scale), type(args.loss_scale)) + + +print("\nCUDNN VERSION: {}\n".format(torch.backends.cudnn.version())) + +if args.deterministic: + cudnn.benchmark = False + cudnn.deterministic = True + torch.manual_seed(args.local_rank) + torch.set_printoptions(precision=10) + +def main(): + global best_prec1, args + + args.distributed = False + if 'WORLD_SIZE' in os.environ: + args.distributed = int(os.environ['WORLD_SIZE']) > 1 + + args.gpu = 0 + args.world_size = 1 + + if args.distributed: + args.gpu = args.local_rank % torch.cuda.device_count() + torch.cuda.set_device(args.gpu) + torch.distributed.init_process_group(backend='nccl', + init_method='env://') + args.world_size = torch.distributed.get_world_size() + + assert torch.backends.cudnn.enabled, "Amp requires cudnn backend to be enabled." + + # create model + if args.pretrained: + print("=> using pre-trained model '{}'".format(args.arch)) + model = models.__dict__[args.arch](pretrained=True) + else: + print("=> creating model '{}'".format(args.arch)) + model = models.__dict__[args.arch]() + + if args.sync_bn: + import apex + print("using apex synced BN") + model = apex.parallel.convert_syncbn_model(model) + + model = model.cuda() + + # Scale learning rate based on global batch size + args.lr = args.lr*float(args.batch_size*args.world_size)/256. + if args.fused_adam: + optimizer = optimizers.FusedAdam(model.parameters()) + else: + optimizer = torch.optim.SGD(model.parameters(), args.lr, + momentum=args.momentum, + weight_decay=args.weight_decay) + + model, optimizer = amp.initialize( + model, optimizer, + # enabled=False, + opt_level=args.opt_level, + keep_batchnorm_fp32=args.keep_batchnorm_fp32, + loss_scale=args.loss_scale + ) + + if args.distributed: + # By default, apex.parallel.DistributedDataParallel overlaps communication with + # computation in the backward pass. + # model = DDP(model) + # delay_allreduce delays all communication to the end of the backward pass. + model = DDP(model, delay_allreduce=True) + + # define loss function (criterion) and optimizer + criterion = nn.CrossEntropyLoss().cuda() + + # Optionally resume from a checkpoint + if args.resume: + # Use a local scope to avoid dangling references + def resume(): + if os.path.isfile(args.resume): + print("=> loading checkpoint '{}'".format(args.resume)) + checkpoint = torch.load(args.resume, map_location = lambda storage, loc: storage.cuda(args.gpu)) + args.start_epoch = checkpoint['epoch'] + best_prec1 = checkpoint['best_prec1'] + model.load_state_dict(checkpoint['state_dict']) + optimizer.load_state_dict(checkpoint['optimizer']) + print("=> loaded checkpoint '{}' (epoch {})" + .format(args.resume, checkpoint['epoch'])) + else: + print("=> no checkpoint found at '{}'".format(args.resume)) + resume() + + # Data loading code + traindir = os.path.join(args.data, 'train') + valdir = os.path.join(args.data, 'val') + + if(args.arch == "inception_v3"): + crop_size = 299 + val_size = 320 # I chose this value arbitrarily, we can adjust. + else: + crop_size = 224 + val_size = 256 + + train_dataset = datasets.ImageFolder( + traindir, + transforms.Compose([ + transforms.RandomResizedCrop(crop_size), + transforms.RandomHorizontalFlip(), + # transforms.ToTensor(), Too slow + # normalize, + ])) + val_dataset = datasets.ImageFolder(valdir, transforms.Compose([ + transforms.Resize(val_size), + transforms.CenterCrop(crop_size), + ])) + + train_sampler = None + val_sampler = None + if args.distributed: + train_sampler = torch.utils.data.distributed.DistributedSampler(train_dataset) + val_sampler = torch.utils.data.distributed.DistributedSampler(val_dataset) + + train_loader = torch.utils.data.DataLoader( + train_dataset, batch_size=args.batch_size, shuffle=(train_sampler is None), + num_workers=args.workers, pin_memory=True, sampler=train_sampler, collate_fn=fast_collate) + + val_loader = torch.utils.data.DataLoader( + val_dataset, + batch_size=args.batch_size, shuffle=False, + num_workers=args.workers, pin_memory=True, + sampler=val_sampler, + collate_fn=fast_collate) + + if args.evaluate: + validate(val_loader, model, criterion) + return + + for epoch in range(args.start_epoch, args.epochs): + if args.distributed: + train_sampler.set_epoch(epoch) + + # train for one epoch + train(train_loader, model, criterion, optimizer, epoch) + if args.prof: + break + # evaluate on validation set + prec1 = validate(val_loader, model, criterion) + + # remember best prec@1 and save checkpoint + if args.local_rank == 0: + is_best = prec1 > best_prec1 + best_prec1 = max(prec1, best_prec1) + save_checkpoint({ + 'epoch': epoch + 1, + 'arch': args.arch, + 'state_dict': model.state_dict(), + 'best_prec1': best_prec1, + 'optimizer' : optimizer.state_dict(), + }, is_best) + +class data_prefetcher(): + def __init__(self, loader): + self.loader = iter(loader) + self.stream = torch.cuda.Stream() + self.mean = torch.tensor([0.485 * 255, 0.456 * 255, 0.406 * 255]).cuda().view(1,3,1,1) + self.std = torch.tensor([0.229 * 255, 0.224 * 255, 0.225 * 255]).cuda().view(1,3,1,1) + # With Amp, it isn't necessary to manually convert data to half. + # if args.fp16: + # self.mean = self.mean.half() + # self.std = self.std.half() + self.preload() + + def preload(self): + try: + self.next_input, self.next_target = next(self.loader) + except StopIteration: + self.next_input = None + self.next_target = None + return + with torch.cuda.stream(self.stream): + self.next_input = self.next_input.cuda(non_blocking=True) + self.next_target = self.next_target.cuda(non_blocking=True) + # With Amp, it isn't necessary to manually convert data to half. + # if args.fp16: + # self.next_input = self.next_input.half() + # else: + self.next_input = self.next_input.float() + self.next_input = self.next_input.sub_(self.mean).div_(self.std) + + def next(self): + torch.cuda.current_stream().wait_stream(self.stream) + input = self.next_input + target = self.next_target + self.preload() + return input, target + + +def train(train_loader, model, criterion, optimizer, epoch): + batch_time = AverageMeter() + data_time = AverageMeter() + losses = AverageMeter() + top1 = AverageMeter() + top5 = AverageMeter() + + # switch to train mode + model.train() + end = time.time() + + run_info_dict = {"Iteration" : [], + "Loss" : [], + "Speed" : []} + + prefetcher = data_prefetcher(train_loader) + input, target = prefetcher.next() + i = -1 + while input is not None: + i += 1 + + # No learning rate warmup for this test, to expose bitwise inaccuracies more quickly + # adjust_learning_rate(optimizer, epoch, i, len(train_loader)) + + if args.prof: + if i > 10: + break + # measure data loading time + data_time.update(time.time() - end) + + # compute output + output = model(input) + loss = criterion(output, target) + + # measure accuracy and record loss + prec1, prec5 = accuracy(output.data, target, topk=(1, 5)) + + if args.distributed: + reduced_loss = reduce_tensor(loss.data) + prec1 = reduce_tensor(prec1) + prec5 = reduce_tensor(prec5) + else: + reduced_loss = loss.data + + losses.update(to_python_float(reduced_loss), input.size(0)) + top1.update(to_python_float(prec1), input.size(0)) + top5.update(to_python_float(prec5), input.size(0)) + + # compute gradient and do SGD step + optimizer.zero_grad() + + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + + # for param in model.parameters(): + # print(param.data.double().sum().item(), param.grad.data.double().sum().item()) + + # torch.cuda.synchronize() + torch.cuda.nvtx.range_push("step") + optimizer.step() + torch.cuda.nvtx.range_pop() + + torch.cuda.synchronize() + # measure elapsed time + batch_time.update(time.time() - end) + + end = time.time() + + # If you decide to refactor this test, like examples/imagenet, to sample the loss every + # print_freq iterations, make sure to move this prefetching below the accuracy calculation. + input, target = prefetcher.next() + + if i % args.print_freq == 0 and i > 1: + if args.local_rank == 0: + print('Epoch: [{0}][{1}/{2}]\t' + 'Time {batch_time.val:.3f} ({batch_time.avg:.3f})\t' + 'Speed {3:.3f} ({4:.3f})\t' + 'Data {data_time.val:.3f} ({data_time.avg:.3f})\t' + 'Loss {loss.val:.10f} ({loss.avg:.4f})\t' + 'Prec@1 {top1.val:.3f} ({top1.avg:.3f})\t' + 'Prec@5 {top5.val:.3f} ({top5.avg:.3f})'.format( + epoch, i, len(train_loader), + args.world_size * args.batch_size / batch_time.val, + args.world_size * args.batch_size / batch_time.avg, + batch_time=batch_time, + data_time=data_time, loss=losses, top1=top1, top5=top5)) + run_info_dict["Iteration"].append(i) + run_info_dict["Loss"].append(losses.val) + run_info_dict["Speed"].append(args.world_size * args.batch_size / batch_time.val) + if len(run_info_dict["Loss"]) == args.prints_to_process: + if args.local_rank == 0: + torch.save(run_info_dict, + str(args.has_ext) + "_" + str(args.opt_level) + "_" + + str(args.loss_scale) + "_" + str(args.keep_batchnorm_fp32) + "_" + + str(args.fused_adam)) + quit() + + +def validate(val_loader, model, criterion): + batch_time = AverageMeter() + losses = AverageMeter() + top1 = AverageMeter() + top5 = AverageMeter() + + # switch to evaluate mode + model.eval() + + end = time.time() + + prefetcher = data_prefetcher(val_loader) + input, target = prefetcher.next() + i = -1 + while input is not None: + i += 1 + + # compute output + with torch.no_grad(): + output = model(input) + loss = criterion(output, target) + + # measure accuracy and record loss + prec1, prec5 = accuracy(output.data, target, topk=(1, 5)) + + if args.distributed: + reduced_loss = reduce_tensor(loss.data) + prec1 = reduce_tensor(prec1) + prec5 = reduce_tensor(prec5) + else: + reduced_loss = loss.data + + losses.update(to_python_float(reduced_loss), input.size(0)) + top1.update(to_python_float(prec1), input.size(0)) + top5.update(to_python_float(prec5), input.size(0)) + + # measure elapsed time + batch_time.update(time.time() - end) + end = time.time() + + if args.local_rank == 0 and i % args.print_freq == 0: + print('Test: [{0}/{1}]\t' + 'Time {batch_time.val:.3f} ({batch_time.avg:.3f})\t' + 'Speed {2:.3f} ({3:.3f})\t' + 'Loss {loss.val:.4f} ({loss.avg:.4f})\t' + 'Prec@1 {top1.val:.3f} ({top1.avg:.3f})\t' + 'Prec@5 {top5.val:.3f} ({top5.avg:.3f})'.format( + i, len(val_loader), + args.world_size * args.batch_size / batch_time.val, + args.world_size * args.batch_size / batch_time.avg, + batch_time=batch_time, loss=losses, + top1=top1, top5=top5)) + + input, target = prefetcher.next() + + print(' * Prec@1 {top1.avg:.3f} Prec@5 {top5.avg:.3f}' + .format(top1=top1, top5=top5)) + + return top1.avg + + +def save_checkpoint(state, is_best, filename='checkpoint.pth.tar'): + torch.save(state, filename) + if is_best: + shutil.copyfile(filename, 'model_best.pth.tar') + + +class AverageMeter(object): + """Computes and stores the average and current value""" + def __init__(self): + self.reset() + + def reset(self): + self.val = 0 + self.avg = 0 + self.sum = 0 + self.count = 0 + + def update(self, val, n=1): + self.val = val + self.sum += val * n + self.count += n + self.avg = self.sum / self.count + + +def adjust_learning_rate(optimizer, epoch, step, len_epoch): + """LR schedule that should yield 76% converged accuracy with batch size 256""" + factor = epoch // 30 + + if epoch >= 80: + factor = factor + 1 + + lr = args.lr*(0.1**factor) + + """Warmup""" + if epoch < 5: + lr = lr*float(1 + step + epoch*len_epoch)/(5.*len_epoch) + + # if(args.local_rank == 0): + # print("epoch = {}, step = {}, lr = {}".format(epoch, step, lr)) + + for param_group in optimizer.param_groups: + param_group['lr'] = lr + + +def accuracy(output, target, topk=(1,)): + """Computes the precision@k for the specified values of k""" + maxk = max(topk) + batch_size = target.size(0) + + _, pred = output.topk(maxk, 1, True, True) + pred = pred.t() + correct = pred.eq(target.view(1, -1).expand_as(pred)) + + res = [] + for k in topk: + correct_k = correct[:k].view(-1).float().sum(0, keepdim=True) + res.append(correct_k.mul_(100.0 / batch_size)) + return res + + +def reduce_tensor(tensor): + rt = tensor.clone() + dist.all_reduce(rt, op=dist.reduce_op.SUM) + rt /= args.world_size + return rt + +if __name__ == '__main__': + main() diff --git a/apex/tests/L1/common/run_test.sh b/apex/tests/L1/common/run_test.sh new file mode 100644 index 0000000000000000000000000000000000000000..f4ae06c80ee32e9dbabee3614a98081865e56816 --- /dev/null +++ b/apex/tests/L1/common/run_test.sh @@ -0,0 +1,144 @@ +#!/bin/bash + +print_banner() { + printf "\n\n\n\e[30m\e[42m$1\e[0m\n\n\n\n" +} + +print_banner "Distributed status: $1" + +echo $2 +DATADIR=$2 + +if [ -n "$3" ] +then + USE_BASELINE="" +else + USE_BASELINE="--use_baseline" +fi + +if [ "$1" == "single_gpu" ] +then + BASE_CMD="python main_amp.py -a resnet50 --b 128 --workers 4 --deterministic --prints-to-process 5" +fi + +if [ "$1" == "distributed" ] +then + BASE_CMD="python -m torch.distributed.launch --nproc_per_node=2 main_amp.py -a resnet50 --b 128 --workers 4 --deterministic --prints-to-process 5" +fi + +ADAM_ARGS="--opt-level O2 --keep-batchnorm-fp32 False --fused-adam" + +keep_batchnorms=( +"" +"--keep-batchnorm-fp32 True" +"--keep-batchnorm-fp32 False" +) + +loss_scales=( +"" +"--loss-scale 1.0" +"--loss-scale 128.0" +"--loss-scale dynamic" +) + +opt_levels=( +"O0" +"O1" +"O2" +"O3" +) + +rm True* +rm False* + +set -e + +print_banner "Installing Apex with --cuda_ext and --cpp_ext" + +pushd ../../.. +pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" . +popd + +for opt_level in "${opt_levels[@]}" +do + for loss_scale in "${loss_scales[@]}" + do + for keep_batchnorm in "${keep_batchnorms[@]}" + do + if [ "$opt_level" == "O1" ] && [ -n "${keep_batchnorm}" ] + then + print_banner "Skipping ${opt_level} ${loss_scale} ${keep_batchnorm}" + continue + fi + print_banner "${BASE_CMD} --opt-level ${opt_level} ${loss_scale} ${keep_batchnorm} --has-ext $DATADIR" + set -x + ${BASE_CMD} --opt-level ${opt_level} ${loss_scale} ${keep_batchnorm} --has-ext $DATADIR + set +x + done + done +done + +# Handle FusedAdam separately due to limited support. +# FusedAdam will not be tested for bitwise accuracy against the Python implementation. +# The L0 tests already do so. These tests are here to ensure that it actually runs, +# and get an idea of performance. +for loss_scale in "${loss_scales[@]}" +do + print_banner "${BASE_CMD} ${ADAM_ARGS} ${loss_scale} --has-ext $DATADIR" + set -x + ${BASE_CMD} ${ADAM_ARGS} ${loss_scale} --has-ext $DATADIR + set +x +done + +print_banner "Reinstalling apex without extensions" + +pushd ../../.. +pip install -v --no-cache-dir . +popd + +for opt_level in "${opt_levels[@]}" +do + for loss_scale in "${loss_scales[@]}" + do + for keep_batchnorm in "${keep_batchnorms[@]}" + do + if [ "$opt_level" == "O1" ] && [ -n "${keep_batchnorm}" ] + then + print_banner "Skipping ${opt_level} ${loss_scale} ${keep_batchnorm}" + continue + fi + print_banner "${BASE_CMD} --opt-level ${opt_level} ${loss_scale} ${keep_batchnorm} $DATADIR" + set -x + ${BASE_CMD} --opt-level ${opt_level} ${loss_scale} ${keep_batchnorm} $DATADIR + set +x + done + done +done + +print_banner "Checking for bitwise accuracy between Python-only and cpp/cuda extension installs" + +for opt_level in "${opt_levels[@]}" +do + for loss_scale in "${loss_scales[@]}" + do + for keep_batchnorm in "${keep_batchnorms[@]}" + do + echo "" + if [ "$opt_level" == "O1" ] && [ -n "${keep_batchnorm}" ] + then + echo "Skipping ${opt_level} ${loss_scale} ${keep_batchnorm}" + continue + fi + echo "${BASE_CMD} --opt-level ${opt_level} ${loss_scale} ${keep_batchnorm} [--has-ext] $DATADIR" + set -x + python compare.py --opt-level ${opt_level} ${loss_scale} ${keep_batchnorm} --use_baseline + set +x + done + done +done + +print_banner "Reinstalling Apex with --cuda_ext and --cpp_ext" + +pushd ../../.. +pip install -v --no-cache-dir --global-option="--cpp_ext" --global-option="--cuda_ext" . +popd diff --git a/apex/tests/L1/cross_product/run.sh b/apex/tests/L1/cross_product/run.sh new file mode 100644 index 0000000000000000000000000000000000000000..7ccf9ec4386de32c07e3d5ea02a386f1ccbe2ebc --- /dev/null +++ b/apex/tests/L1/cross_product/run.sh @@ -0,0 +1,6 @@ +#!/bin/bash + +# DATADIR="/home/mcarilli/Desktop/pt18data/apex_stale/examples/imagenet/bare_metal_train_val/" +# DATADIR="/opt/home/apex/examples/imagenet/" +cp ../common/* . +bash run_test.sh single_gpu $1 diff --git a/apex/tests/L1/cross_product_distributed/run.sh b/apex/tests/L1/cross_product_distributed/run.sh new file mode 100644 index 0000000000000000000000000000000000000000..917ec11e83227a4083a4dd572c5ab3f1a6a3cca7 --- /dev/null +++ b/apex/tests/L1/cross_product_distributed/run.sh @@ -0,0 +1,4 @@ +#!/bin/bash + +cp ../common/* . +bash run_test.sh distributed $1 diff --git a/apex/tests/distributed/DDP/ddp_race_condition_test.py b/apex/tests/distributed/DDP/ddp_race_condition_test.py new file mode 100644 index 0000000000000000000000000000000000000000..761a33595cbe27fd22d37734703a41496d9b1a2a --- /dev/null +++ b/apex/tests/distributed/DDP/ddp_race_condition_test.py @@ -0,0 +1,69 @@ +import torch +import torch.distributed as dist +from torch.nn import Parameter +from torch.nn import Module +from apex.parallel import DistributedDataParallel as DDP +import argparse +import os + + +parser = argparse.ArgumentParser(description='allreduce hook example') +parser.add_argument("--local_rank", default=0, type=int) +args = parser.parse_args() + +args.distributed = False +if 'WORLD_SIZE' in os.environ: + args.distributed = int(os.environ['WORLD_SIZE']) > 1 + +if args.distributed: + args.gpu = args.local_rank % torch.cuda.device_count() + torch.cuda.set_device(args.gpu) + torch.distributed.init_process_group(backend='nccl', + init_method='env://') + args.world_size = torch.distributed.get_world_size() + +torch.set_printoptions(precision=10) +torch.manual_seed(args.local_rank) + +class Model(Module): + def __init__(self): + super(Model, self).__init__() + self.a = Parameter(torch.cuda.FloatTensor(4096*4096).fill_(1.0)) + self.b = Parameter(torch.cuda.FloatTensor(4096*4096).fill_(2.0)) + def forward(self, input): + return (input*self.a)*self.b + +model = Model() +# model = DDP(model, message_size=1, gradient_predivide_factor=8.0) +# model = DDP(model, delay_allreduce=True) +# model = DDP(model, message_size=1, allreduce_trigger_params=[model.b]) +model = DDP(model, message_size=1, allreduce_trigger_params=[model.b], num_allreduce_streams=3) + +x = torch.cuda.FloatTensor(4096*4096) + +passed = True +torch.cuda.cudart().cudaProfilerStart() +for i in range(10): + x.fill_(i + args.local_rank) # fill x with new values every iteration for sanity + model.zero_grad() + out = model(x) + loss = out.sum() + # torch.cuda.nvtx.range_push("backward") + loss.backward() + # torch.cuda.nvtx.range_pop() + + # torch.cuda.nvtx.range_push("synchronize() + info") + # torch.cuda.synchronize() + print("i = {}".format(i)) + def info(name, param, val): + expected = val*4096*4096*(2.*i+1)/2. + actual = param.grad.data.sum().item() + print(name+": grad.data_ptr() = {}, expected sum {}, got {}".format( + param.grad.data_ptr(), expected, actual)) + return (expected == actual) + if not info("model.a", model.module.a, 2.): passed = False + if not info("model.b", model.module.b, 1.): passed = False + # torch.cuda.nvtx.range_pop() +torch.cuda.cudart().cudaProfilerStop() + +print("passed = ", passed) diff --git a/apex/tests/distributed/DDP/run_race_test.sh b/apex/tests/distributed/DDP/run_race_test.sh new file mode 100644 index 0000000000000000000000000000000000000000..2c2bd266cceba96f5884dde6d5f0bac256f4de02 --- /dev/null +++ b/apex/tests/distributed/DDP/run_race_test.sh @@ -0,0 +1,3 @@ +#!/bin/bash + +CUDA_VISIBLE_DEVICES=0,1 python -m torch.distributed.launch --nproc_per_node=2 ddp_race_condition_test.py diff --git a/apex/tests/distributed/amp_master_params/amp_master_params.py b/apex/tests/distributed/amp_master_params/amp_master_params.py new file mode 100644 index 0000000000000000000000000000000000000000..4af5092f757a9f5bddf0470d9834a7935ebdafdb --- /dev/null +++ b/apex/tests/distributed/amp_master_params/amp_master_params.py @@ -0,0 +1,70 @@ +import torch +import argparse +import os +from apex import amp +# FOR DISTRIBUTED: (can also use torch.nn.parallel.DistributedDataParallel instead) +from apex.parallel import DistributedDataParallel + +parser = argparse.ArgumentParser() +# FOR DISTRIBUTED: Parse for the local_rank argument, which will be supplied +# automatically by torch.distributed.launch. +parser.add_argument("--local_rank", default=0, type=int) +args = parser.parse_args() + +# FOR DISTRIBUTED: If we are running under torch.distributed.launch, +# the 'WORLD_SIZE' environment variable will also be set automatically. +args.distributed = False +if 'WORLD_SIZE' in os.environ: + args.distributed = int(os.environ['WORLD_SIZE']) > 1 + +if args.distributed: + # FOR DISTRIBUTED: Set the device according to local_rank. + torch.cuda.set_device(args.local_rank) + + # FOR DISTRIBUTED: Initialize the backend. torch.distributed.launch will provide + # environment variables, and requires that you use init_method=`env://`. + torch.distributed.init_process_group(backend='nccl', + init_method='env://') + + torch.manual_seed(torch.distributed.get_rank()) + +torch.backends.cudnn.benchmark = True + +N, D_in, D_out = 64, 1024, 16 + +# Each process receives its own batch of "fake input data" and "fake target data." +# The "training loop" in each process just uses this fake batch over and over. +# https://github.com/NVIDIA/apex/tree/master/examples/imagenet provides a more realistic +# example of distributed data sampling for both training and validation. +x = torch.randn(N, D_in, device='cuda') +y = torch.randn(N, D_out, device='cuda') + +model = torch.nn.Linear(D_in, D_out).cuda() +optimizer = torch.optim.SGD(model.parameters(), lr=1e-3) + +model, optimizer = amp.initialize(model, optimizer, opt_level="O2") + +if args.distributed: + # FOR DISTRIBUTED: After amp.initialize, wrap the model with + # apex.parallel.DistributedDataParallel. + model = DistributedDataParallel(model) + # torch.nn.parallel.DistributedDataParallel is also fine, with some added args: + # model = torch.nn.parallel.DistributedDataParallel(model, + # device_ids=[args.local_rank], + # output_device=args.local_rank) + +loss_fn = torch.nn.MSELoss() + +for t in range(500): + optimizer.zero_grad() + y_pred = model(x) + loss = loss_fn(y_pred, y) + with amp.scale_loss(loss, optimizer) as scaled_loss: + scaled_loss.backward() + optimizer.step() + +if args.local_rank == 0: + print("final loss = ", loss) + +torch.save(list(model.parameters()), "rank{}model.pth".format(torch.distributed.get_rank())) +torch.save(list(amp.master_params(optimizer)), "rank{}master.pth".format(torch.distributed.get_rank())) diff --git a/apex/tests/distributed/amp_master_params/compare.py b/apex/tests/distributed/amp_master_params/compare.py new file mode 100644 index 0000000000000000000000000000000000000000..e5cbf20c1db56cb96c29775d6a974bb5fd4fffc9 --- /dev/null +++ b/apex/tests/distributed/amp_master_params/compare.py @@ -0,0 +1,28 @@ +import torch + +model_params_rank0 = torch.load("rank0model.pth", + map_location = lambda storage, loc: storage.cuda(0)) +model_params_rank1 = torch.load("rank1model.pth", + map_location = lambda storage, loc: storage.cuda(0)) +master_params_rank0 = torch.load("rank0master.pth", + map_location = lambda storage, loc: storage.cuda(0)) +master_params_rank1 = torch.load("rank1master.pth", + map_location = lambda storage, loc: storage.cuda(0)) + +for model_rank0, model_rank1, master_rank0, master_rank1 in zip( + model_params_rank0, + model_params_rank1, + master_params_rank0, + master_params_rank1): + assert torch.allclose(model_rank0, model_rank1), "Model param mismatch" + assert torch.allclose(master_rank0, master_rank1), "Master param mismatch" + # Some debugging/investigation assistance code: + # maxval, maxind = torch.max(((torch.abs(model_rank0).float())/torch.abs(master_rank0)).view(-1), 0) + # offending_val_half = model_rank0.view(-1)[maxind.item()] + # offending_val_float = master_rank0.view(-1)[maxind.item()] + # print(maxval.item(), maxind.item(), offending_val_half.item(), offending_val_float.item(), + # offending_val_float.half().item()) + # rtol needs to be > 2^-11 because of denormals... + assert torch.allclose(model_rank0, master_rank0.half(), rtol=.005), "Model-master mismatch" + +print("OK: Model and master params match across ranks.") diff --git a/apex/tests/distributed/amp_master_params/run.sh b/apex/tests/distributed/amp_master_params/run.sh new file mode 100644 index 0000000000000000000000000000000000000000..8599dbbbc9b7c97a8b4898658dbf3c453b8263cc --- /dev/null +++ b/apex/tests/distributed/amp_master_params/run.sh @@ -0,0 +1,4 @@ +#!/bin/bash +python -m torch.distributed.launch --nproc_per_node=2 amp_master_params.py + +python compare.py diff --git a/apex/tests/distributed/synced_batchnorm/python_single_gpu_unit_test.py b/apex/tests/distributed/synced_batchnorm/python_single_gpu_unit_test.py new file mode 100644 index 0000000000000000000000000000000000000000..80c26825ba5a4be690484886224d1cfffb79172e --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/python_single_gpu_unit_test.py @@ -0,0 +1,111 @@ +import torch +import numpy as np +import apex + +def compare(desc, inp1, inp2, error): + a = inp1.clone().detach().cpu().numpy() + b = inp2.clone().detach().cpu().numpy() + close = np.allclose(a,b, error, error) + if not close: + print(desc, close) + z = a - b + index = (np.abs(z) >= error + error * np.abs(b)).nonzero() + print("dif : ", z[index]) + print("inp1 : ", a[index]) + print("inp2 : ", b[index]) + return close + +feature_size = 10 +space_size = 16 +batch_size = 5 + + +error = 1e-5 + +np.random.seed(1) +dtype = np.float32 +inp = (np.random.randn(batch_size, feature_size, space_size, space_size)).astype(dtype) +grad = (np.random.randn(batch_size, feature_size, space_size, space_size)).astype(dtype) +weight = (np.random.randn(feature_size)).astype(dtype) +bias = (np.random.randn(feature_size)).astype(dtype) + +type_tensor = torch.cuda.FloatTensor +ref_tensor = torch.cuda.DoubleTensor + +inp_t = type_tensor(inp) +weight_t = type_tensor(weight) +bias_t = type_tensor(bias) + +inp_r = ref_tensor(inp.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +inp2_r = ref_tensor(inp) +weight_r = ref_tensor(weight).view(-1, 1, 1) +bias_r = ref_tensor(bias).view(-1, 1, 1) + +grad_output_t = type_tensor(grad) + +m = inp_r.mean(1) +b_v = inp_r.var(1, unbiased=False) +unb_v = inp_r.var(1, unbiased=True) + +eps = 1e-5 + +bn = torch.nn.BatchNorm2d(feature_size).cuda() +bn.momentum = 1.0 +bn.weight.data = weight_t.clone() +bn.bias.data = bias_t.clone() +inp_bn = inp_t.clone().requires_grad_() +grad_bn = grad_output_t.clone().detach() +out_bn = bn(inp_bn) +out_bn.backward(grad_bn) + +from apex.parallel.sync_batchnorm import SyncBatchNorm + +sbn = SyncBatchNorm(feature_size).cuda() +sbn.momentum = 1.0 +sbn.weight.data = weight_t.clone() +sbn.bias.data = bias_t.clone() +inp_sbn = inp_t.clone().requires_grad_() +grad_sbn = grad_output_t.clone().detach() +out_sbn = sbn(inp_sbn) +out_sbn.backward(grad_sbn) + +sbn_result = True +sbn_result_c_last = True +bn_result = True + +out_r = weight_r * (inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) + bias_r + +compare("comparing bn output: ", out_bn, out_r, error) + +grad_output_t = type_tensor(grad) + +grad_output_r = ref_tensor(grad.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +grad_output2_r = ref_tensor(grad) + +grad_bias_r = grad_output_r.sum(1) +grad_weight_r = ((inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).sum(1) + +mean_dy_r = grad_output_r.mean(1) +mean_dy_xmu_r = ((inp2_r - m.view(-1, 1, 1)) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).mean(1) + +grad_input_r = (grad_output2_r - mean_dy_r.view(-1, 1, 1) - (inp2_r - m.view(-1, 1, 1)) / (b_v.view(-1,1,1) + eps) * mean_dy_xmu_r.view(-1, 1, 1) ) * torch.rsqrt(b_v.view(-1,1,1) + eps) * weight_r.view(-1,1,1) + +compare("comparing bn input grad: ", inp_bn.grad, grad_input_r, error) +sbn_result = compare("comparing sbn input grad: ", inp_sbn.grad, grad_input_r, error) and sbn_result + +compare("comparing bn/sbn output: ", out_bn, out_sbn, error) +sbn_result = compare("comparing running_mean: ", bn.running_mean.data, sbn.running_mean.data, error) and sbn_result +sbn_result = compare("comparing running_variance: ", bn.running_var.data, sbn.running_var.data, error) and sbn_result +compare("comparing grad_input: ", inp_bn.grad, inp_sbn.grad, error) +compare("comparing grad_bias: ", bn.bias.grad, sbn.bias.grad, error) +compare("comparing grad_bias bn to ref: ", bn.bias.grad, grad_bias_r, error) +sbn_result = compare("comparing grad_bias sbn to ref: ", sbn.bias.grad, grad_bias_r, error) and sbn_result +compare("comparing grad_weight: ", bn.weight.grad, sbn.weight.grad, error) +compare("comparing grad_weight bn to ref: ", bn.weight.grad, grad_weight_r, error) +sbn_result = compare("comparing grad_weight sbn to ref: ", sbn.weight.grad, grad_weight_r, error) and sbn_result + +if sbn_result: + print("====SBN single gpu passed tests") +else: + print("*SBN single gpu failed*") + diff --git a/apex/tests/distributed/synced_batchnorm/single_gpu_unit_test.py b/apex/tests/distributed/synced_batchnorm/single_gpu_unit_test.py new file mode 100644 index 0000000000000000000000000000000000000000..6fcbd0d14733a59ba646e422423065c5970f0b55 --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/single_gpu_unit_test.py @@ -0,0 +1,159 @@ +import torch +import numpy as np +import apex +if True: + print("using setup tools") + import syncbn +else: + print("using jit") + from torch.utils.cpp_extension import load + syncbn = load(name='syncbn', sources=['../../csrc/syncbn.cpp', '../../csrc/welford.cu']) + +def compare(desc, inp1, inp2, error): + a = inp1.clone().detach().cpu().numpy() + b = inp2.clone().detach().cpu().numpy() + close = np.allclose(a,b, error, error) + if not close: + print(desc, close) + z = a - b + index = (np.abs(z) >= error + error * np.abs(b)).nonzero() + print("dif : ", z[index]) + print("inp1 : ", a[index]) + print("inp2 : ", b[index]) + return close + +feature_size = 10 +space_size = 16 +batch_size = 5 + + +error = 1e-5 + +np.random.seed(1) +dtype = np.float32 +inp = (np.random.randn(batch_size, feature_size, space_size, space_size)).astype(dtype) +grad = (np.random.randn(batch_size, feature_size, space_size, space_size)).astype(dtype) +weight = (np.random.randn(feature_size)).astype(dtype) +bias = (np.random.randn(feature_size)).astype(dtype) +count = torch.cuda.IntTensor([batch_size*space_size**2]) + +type_tensor = torch.cuda.FloatTensor +ref_tensor = torch.cuda.DoubleTensor + +inp_t = type_tensor(inp) +weight_t = type_tensor(weight) +bias_t = type_tensor(bias) + +inp_r = ref_tensor(inp.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +inp2_r = ref_tensor(inp) +weight_r = ref_tensor(weight).view(-1, 1, 1) +bias_r = ref_tensor(bias).view(-1, 1, 1) + +grad_output_t = type_tensor(grad) + +m = inp_r.mean(1) +b_v = inp_r.var(1, unbiased=False) +unb_v = inp_r.var(1, unbiased=True) + +eps = 1e-5 + +#mean, var, var_biased = syncbn.welford_mean_var(inp_t) +mean, var_biased = syncbn.welford_mean_var(inp_t) +inv_std = 1.0 / torch.sqrt(var_biased + eps) + +bn = torch.nn.BatchNorm2d(feature_size).cuda() +bn.momentum = 1.0 +bn.weight.data = weight_t.clone() +bn.bias.data = bias_t.clone() +inp_bn = inp_t.clone().requires_grad_() +grad_bn = grad_output_t.clone().detach() +out_bn = bn(inp_bn) +out_bn.backward(grad_bn) + +sbn = apex.parallel.SyncBatchNorm(feature_size).cuda() +sbn.momentum = 1.0 +sbn.weight.data = weight_t.clone() +sbn.bias.data = bias_t.clone() +inp_sbn = inp_t.clone().requires_grad_() +grad_sbn = grad_output_t.clone().detach() +out_sbn = sbn(inp_sbn) +out_sbn.backward(grad_sbn) + +sbn_c_last = apex.parallel.SyncBatchNorm(feature_size, channel_last=True).cuda() +sbn_c_last.momentum = 1.0 +sbn_c_last.weight.data = weight_t.clone() +sbn_c_last.bias.data = bias_t.clone() +inp_sbn_c_last = inp_t.clone().transpose(-1, 1).contiguous().requires_grad_() +grad_sbn_c_last = grad_output_t.clone().transpose(-1, 1).contiguous().detach() +out_sbn_c_last = sbn_c_last(inp_sbn_c_last) +out_sbn_c_last.backward(grad_sbn_c_last) + +sbn_result = True +sbn_result_c_last = True +bn_result = True + +sbn_result = compare("comparing mean: ", mean, m, error) and sbn_result +#sbn_result = compare("comparing variance: ", var, unb_v, error) and sbn_result +sbn_result = compare("comparing biased variance: ", var_biased, b_v, error) and sbn_result + + +out = syncbn.batchnorm_forward(inp_t, mean, inv_std, weight_t, bias_t) +out_r = weight_r * (inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) + bias_r + +sbn_result = compare("comparing output: ", out, out_r, error) and sbn_result +compare("comparing bn output: ", out_bn, out_r, error) + +grad_output_t = type_tensor(grad) + +grad_output_r = ref_tensor(grad.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +grad_output2_r = ref_tensor(grad) + +grad_bias_r = grad_output_r.sum(1) +grad_weight_r = ((inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).sum(1) + +sum_dy_r = grad_output_r.sum(1) +mean_dy_r = grad_output_r.mean(1) +sum_dy_xmu_r = ((inp2_r - m.view(-1, 1, 1)) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).sum(1) +mean_dy_xmu_r = ((inp2_r - m.view(-1, 1, 1)) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).mean(1) + +grad_input_r = (grad_output2_r - mean_dy_r.view(-1, 1, 1) - (inp2_r - m.view(-1, 1, 1)) / (b_v.view(-1,1,1) + eps) * mean_dy_xmu_r.view(-1, 1, 1) ) * torch.rsqrt(b_v.view(-1,1,1) + eps) * weight_r.view(-1,1,1) + +sum_dy, sum_dy_xmu, grad_weight, grad_bias = syncbn.reduce_bn(grad_output_t, inp_t, mean, inv_std, weight_t) +grad_input = syncbn.batchnorm_backward(grad_output_t, inp_t, mean, inv_std, weight_t, sum_dy, sum_dy_xmu, count) +sbn_result = compare("comparing bias grad: ", grad_bias, grad_bias_r, error) and sbn_result +sbn_result = compare("comparing weight grad: ", grad_weight, grad_weight_r, error) and sbn_result +sbn_result = compare("comparing sum_dy grad: ", sum_dy, sum_dy_r, error) and sbn_result +sbn_result = compare("comparing sum_dy_xmu grad: ", sum_dy_xmu, sum_dy_xmu_r, error) and sbn_result +sbn_result = compare("comparing input grad: ", grad_input, grad_input_r, error) and sbn_result +compare("comparing bn input grad: ", inp_bn.grad, grad_input_r, error) +sbn_result = compare("comparing sbn input grad: ", inp_sbn.grad, grad_input_r, error) and sbn_result + +compare("comparing bn/sbn output: ", out_bn, out_sbn, error) +sbn_result = compare("comparing running_mean: ", bn.running_mean.data, sbn.running_mean.data, error) and sbn_result +sbn_result = compare("comparing running_variance: ", bn.running_var.data, sbn.running_var.data, error) and sbn_result +compare("comparing grad_input: ", inp_bn.grad, inp_sbn.grad, error) +compare("comparing grad_bias: ", bn.bias.grad, sbn.bias.grad, error) +compare("comparing grad_bias bn to ref: ", bn.bias.grad, grad_bias_r, error) +sbn_result = compare("comparing grad_bias sbn to ref: ", sbn.bias.grad, grad_bias_r, error) and sbn_result +compare("comparing grad_weight: ", bn.weight.grad, sbn.weight.grad, error) +compare("comparing grad_weight bn to ref: ", bn.weight.grad, grad_weight_r, error) +sbn_result = compare("comparing grad_weight sbn to ref: ", sbn.weight.grad, grad_weight_r, error) and sbn_result + +compare("comparing channel last bn/sbn output: ", out_bn, out_sbn_c_last.transpose(-1, 1).contiguous(), error) +sbn_result_c_last = compare("comparing channel last running_mean: ", bn.running_mean.data, sbn_c_last.running_mean.data, error) and sbn_result_c_last +sbn_result_c_last = compare("comparing channel last running_variance: ", bn.running_var.data, sbn_c_last.running_var.data, error) and sbn_result_c_last +compare("comparing channel last grad_input: ", inp_bn.grad, inp_sbn_c_last.grad.transpose(-1, 1).contiguous(), error) +compare("comparing channel last grad_bias: ", bn.bias.grad, sbn_c_last.bias.grad, error) +sbn_result_c_last = compare("comparing channel last grad_bias sbn to ref: ", sbn_c_last.bias.grad, grad_bias_r, error) and sbn_result_c_last +compare("comparing channel last grad_weight: ", bn.weight.grad, sbn_c_last.weight.grad, error) +sbn_result_c_last = compare("comparing channel last grad_weight sbn to ref: ", sbn_c_last.weight.grad, grad_weight_r, error) and sbn_result_c_last + +if sbn_result: + print("====SBN single gpu passed tests") +else: + print("*SBN single gpu failed*") + +if sbn_result_c_last: + print("====SBN channel last single gpu passed tests") +else: + print("*SBN channel last single gpu failed*") diff --git a/apex/tests/distributed/synced_batchnorm/test_batchnorm1d.py b/apex/tests/distributed/synced_batchnorm/test_batchnorm1d.py new file mode 100644 index 0000000000000000000000000000000000000000..f35ac47397cfe2164cbc5c9d74b2497d9191b138 --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/test_batchnorm1d.py @@ -0,0 +1,18 @@ +import torch +import apex + +model = apex.parallel.SyncBatchNorm(4).cuda() +model.weight.data.uniform_() +model.bias.data.uniform_() +data = torch.rand((8,4)).cuda() + +model_ref = torch.nn.BatchNorm1d(4).cuda() +model_ref.load_state_dict(model.state_dict()) +data_ref = data.clone() + +output = model(data) +output_ref = model_ref(data_ref) + +assert(output.allclose(output_ref)) +assert(model.running_mean.allclose(model_ref.running_mean)) +assert(model.running_var.allclose(model_ref.running_var)) diff --git a/apex/tests/distributed/synced_batchnorm/test_groups.py b/apex/tests/distributed/synced_batchnorm/test_groups.py new file mode 100644 index 0000000000000000000000000000000000000000..d028cc397f738c6ce37c285b46bcf25c1e29d25b --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/test_groups.py @@ -0,0 +1,185 @@ +import torch +import numpy as np +import apex +import syncbn +import os +import argparse +import torch.optim as optim + +def compare(desc, inp1, inp2, error): + a = inp1.clone().detach().cpu().numpy() + b = inp2.clone().detach().cpu().numpy() + close = np.allclose(a,b, error, error) + if not close: + print(desc, close) + z = a - b + index = (np.abs(z) >= error + error * np.abs(b)).nonzero() + print("dif : ", z[index]) + print("inp1 : ", a[index]) + print("inp2 : ", b[index]) + return close + +feature_size = 10 +space_size = 40 +batch_size = 32 + + +from apex.parallel import DistributedDataParallel as DDP +parser = argparse.ArgumentParser() +parser.add_argument("--local_rank", default=0, type=int) +parser.add_argument("--fp16", action='store_true', default=False) +parser.add_argument("--fp64", action='store_true', default=False) +parser.add_argument("--group_size", default=0, type=int) +args = parser.parse_args() + +try: + args.world_size = int(os.environ['WORLD_SIZE']) +except: + print("This is a multi-gpu test. To run it please use 'python -m torch.distributed.launch --nproc_per_node= test_groups.py '") + exit(1) + +torch.cuda.set_device(args.local_rank) +torch.distributed.init_process_group(backend='nccl', init_method='env://') + +start = (args.local_rank%args.group_size) * batch_size//args.group_size +finish = (args.local_rank%args.group_size + 1) * batch_size//args.group_size + +error = 1e-5 +dtype = np.float32 +if args.fp16: + error = 1e-3 + dtype = np.float16 +elif args.fp64: + error = 1e-8 + dtype = np.float64 + + +np.random.seed(18 + args.local_rank//args.group_size) + +inp = np.random.randn(batch_size, feature_size, space_size, space_size).astype(dtype) +grad = np.random.randn(batch_size, feature_size, space_size, space_size).astype(dtype) +weight = np.random.randn(feature_size).astype(dtype) +bias = np.random.randn(feature_size).astype(dtype) + + +type_tensor = torch.cuda.FloatTensor +if args.fp16: + type_tensor = torch.cuda.HalfTensor +if args.fp64: + type_tensor = torch.cuda.DoubleTensor + +ref_tensor = torch.cuda.DoubleTensor + +inp_t = type_tensor(inp) +weight_t = type_tensor(weight) +bias_t = type_tensor(bias) + +inp_r = ref_tensor(inp.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +inp2_r = ref_tensor(inp) +weight_r = ref_tensor(weight).view(-1, 1, 1) +bias_r = ref_tensor(bias).view(-1, 1, 1) + +grad_output_t = type_tensor(grad) + +m = inp_r.mean(1) +b_v = inp_r.var(1, unbiased=False) +unb_v = inp_r.var(1, unbiased=True) + +eps = 1e-5 + +mean, var_biased = syncbn.welford_mean_var(inp_t) +inv_std = 1.0 / torch.sqrt(var_biased + eps) + +bn = torch.nn.BatchNorm2d(feature_size).cuda() +bn.momentum = 1.0 +bn.weight.data = weight_t.clone() +bn.bias.data = bias_t.clone() +if args.fp16: + bn.half() +if args.fp64: + bn.double() +bn = DDP(bn) +inp_bn = inp_t.clone().requires_grad_() +grad_bn = grad_output_t.clone().detach() +out_bn = bn(inp_bn) +out_bn.backward(grad_bn) +# compensating the averaging over processes done by DDP +# in order to produce mathematically equivalent result +# https://github.com/NVIDIA/apex/issues/134#issuecomment-458307368 +for param in bn.parameters(): + param.grad = param.grad / args.group_size +bn_opt = optim.SGD(bn.parameters(), lr=1.0) + +sbn = apex.parallel.SyncBatchNorm(feature_size, process_group=apex.parallel.create_syncbn_process_group(args.group_size)).cuda() +sbn.momentum = 1.0 +sbn.weight.data = weight_t.clone() +sbn.bias.data = bias_t.clone() +if args.fp16: + sbn.half() +if args.fp64: + sbn.double() +sbn = DDP(sbn) +sbn_opt = optim.SGD(sbn.parameters(), lr=1.0) +inp_sbn = inp_t.clone().requires_grad_() +grad_sbn = grad_output_t.clone().detach() +out_sbn = sbn(inp_sbn[start:finish]) +out_sbn.backward(grad_sbn[start:finish]) + +sbn_result = True +bn_result = True + +if args.local_rank == 0: + sbn_result = compare("comparing mean: ", mean, m, error) and sbn_result + sbn_result = compare("comparing biased variance: ", var_biased, b_v, error) and sbn_result + +out = syncbn.batchnorm_forward(inp_t, mean, inv_std, weight_t, bias_t) +out_r = weight_r * (inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) + bias_r + +if args.local_rank == 0: + sbn_result = compare("comparing output: ", out, out_r, error) and sbn_result + compare("comparing bn output: ", out_bn, out_r, error) + +grad_output_t = type_tensor(grad) + +grad_output_r = ref_tensor(grad.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +grad_output2_r = ref_tensor(grad) + +grad_bias_r = grad_output_r.sum(1) +grad_weight_r = ((inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).sum(1) + +mean_dy_r = grad_output_r.mean(1) +mean_dy_xmu_r = ((inp2_r - m.view(-1, 1, 1)) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).mean(1) + +grad_input_r = (grad_output2_r - mean_dy_r.view(-1, 1, 1) - (inp2_r - m.view(-1, 1, 1)) / (b_v.view(-1,1,1) + eps) * mean_dy_xmu_r.view(-1, 1, 1) ) * torch.rsqrt(b_v.view(-1,1,1) + eps) * weight_r.view(-1,1,1) + +mean_dy, mean_dy_xmu, grad_weight, grad_bias = syncbn.reduce_bn(grad_output_t, inp_t, mean, inv_std, weight_t) +grad_input = syncbn.batchnorm_backward(grad_output_t, inp_t, mean, inv_std, weight_t, mean_dy, mean_dy_xmu) + +if args.local_rank == 0: + sbn_result = compare("comparing bias grad: ", grad_bias, grad_bias_r, error) and sbn_result + sbn_result = compare("comparing weight grad: ", grad_weight, grad_weight_r, error) and sbn_result + sbn_result = compare("comparing mean_dy grad: ", mean_dy, mean_dy_r, error) and sbn_result + sbn_result = compare("comparing mean_dy_xmu grad: ", mean_dy_xmu, mean_dy_xmu_r, error) and sbn_result + sbn_result = compare("comparing input grad: ", grad_input, grad_input_r, error) and sbn_result + compare("comparing bn input grad: ", inp_bn.grad, grad_input_r, error) + +if args.local_rank == 0: + sbn_result = compare("comparing running_mean: ", bn.module.running_mean.data, sbn.module.running_mean.data, error) and sbn_result + sbn_result = compare("comparing running_variance: ", bn.module.running_var.data, sbn.module.running_var.data, error) and sbn_result + +# execute by both +compare("comparing layers output: ", out_bn[start:finish], out_sbn, error) and sbn_result +compare("comparing layers grad_input: ", inp_bn.grad[start:finish], inp_sbn.grad[start:finish], error) and sbn_result + +bn_opt.step() +sbn_opt.step() + +if args.local_rank == 0: + compare("comparing bn vs sbn bias: ", bn.module.bias, sbn.module.bias, error) + compare("comparing bn vs sbn weight: ", bn.module.weight, sbn.module.weight, error) + + +if sbn_result: + print("====SBN group test passed") +else: + print("*SBN group test failed*") diff --git a/apex/tests/distributed/synced_batchnorm/two_gpu_test_different_batch_size.py b/apex/tests/distributed/synced_batchnorm/two_gpu_test_different_batch_size.py new file mode 100755 index 0000000000000000000000000000000000000000..a9e8cb641ab8241b7bc0784ed581bd6a7a6e0f44 --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/two_gpu_test_different_batch_size.py @@ -0,0 +1,158 @@ +import torch +import torch.nn as nn +from torch.nn.parallel import DistributedDataParallel as DDP +from apex.parallel import SyncBatchNorm as ApexSyncBatchNorm + +import argparse +import os +import numpy as np + +var_batch = 16 + +def compare(desc, inp1, inp2, error= 1e-5): + a = inp1.clone().detach().cpu().numpy() + b = inp2.clone().detach().cpu().numpy() + close = np.allclose(a,b, error, error) + if not close: + print(desc, close) + z = a - b + index = (np.abs(z) >= error + error * np.abs(b)).nonzero() + print("dif : ", z[index]) + print("inp1 : ", a[index]) + print("inp2 : ", b[index]) + return close + +parser = argparse.ArgumentParser() +parser.add_argument('--local_rank', type=int, default=0) +parser.add_argument('--apex', action='store_true') +args = parser.parse_args() + + +torch.manual_seed(2809) +# Setup DDP +torch.cuda.set_device(args.local_rank) +device = torch.device('cuda:{}'.format(args.local_rank)) + +torch.distributed.init_process_group( + 'nccl', + init_method='env://', + rank=args.local_rank, +) + +# Setup model +if args.apex: + model = nn.Sequential( + nn.Conv2d(3, 6, 3, 1, 1), + ApexSyncBatchNorm(6) + ) +else: + model = nn.Sequential( + nn.Conv2d(3, 6, 3, 1, 1), + nn.SyncBatchNorm(6) + ) + +# Setup reference model +model_reference = nn.Sequential( + nn.Conv2d(3, 6, 3, 1, 1), + nn.BatchNorm2d(6) +) + +with torch.no_grad(): + model_reference[0].weight.copy_(model[0].weight) + model_reference[0].bias.copy_(model[0].bias) +model_reference.to(device) + +model = model.to(device) +model = DDP(model, device_ids=[args.local_rank], output_device=args.local_rank) + +global_batch_size = var_batch + 8 +# Create random data +if args.local_rank == 0: + data = torch.randn(var_batch, 3, 8, 8, device=device, dtype=torch.float) * 50.0 + grad = torch.randint(0, 10, (var_batch, 6, 8, 8), device=device, dtype=torch.float) / 10.0 +else: + data = torch.randn(8, 3, 8, 8, device=device) + grad = torch.randint(0, 10, (8, 6, 8, 8), device=device, dtype=torch.float) / 10.0 + +data.requires_grad_() +data.retain_grad = True + +weighted_gradient = True + +# DDP forward/backward +output = model(data) + +if weighted_gradient: + output.backward(grad * 2 / global_batch_size) +else: + output.backward(grad / output.size(0)) + +d_list = [torch.randn(8, 3, 8, 8, device=device) for i in range(int(os.environ['WORLD_SIZE']))] +y_list = [torch.randn(8, 6, 8, 8, device=device) for i in range(int(os.environ['WORLD_SIZE']))] +dgrad_list = [torch.randn(8, 3, 8, 8, device=device) for i in range(int(os.environ['WORLD_SIZE']))] +grad_list = [torch.randn(8, 6, 8, 8, device=device) for i in range(int(os.environ['WORLD_SIZE']))] +if args.local_rank == 0: + # placeholder, these random data will later be discarded. + torch.distributed.all_gather(d_list, torch.randn(8, 3, 8, 8, device=device)) + torch.distributed.all_gather(y_list, torch.randn(8, 6, 8, 8, device=device)) + torch.distributed.all_gather(dgrad_list, torch.randn(8, 3, 8, 8, device=device)) + torch.distributed.all_gather(grad_list, torch.randn(8, 6, 8, 8, device=device)) +else: + torch.distributed.all_gather(d_list, data) + torch.distributed.all_gather(y_list, output) + torch.distributed.all_gather(dgrad_list, data.grad) + torch.distributed.all_gather(grad_list, grad) + +torch.distributed.barrier() + +if args.local_rank == 0: + ref_tensor = d_list[1:] + ref_tensor.insert(0, data) + assert(ref_tensor[0].equal(data)) + ref_tensor = torch.cat(ref_tensor, 0) + ref_tensor = ref_tensor.detach() + ref_tensor.requires_grad_() + ref_tensor.retain_grad() + + # Reference forward/backward + output_reference = model_reference(ref_tensor) + grad_tensor = grad_list[1:] + grad_tensor.insert(0, grad) + assert(grad_tensor[0].equal(grad)) + grad_tensor = torch.cat(grad_tensor, 0) + if weighted_gradient: + output_reference.backward(grad_tensor / output_reference.size(0)) + else: + output_reference.backward(grad_tensor / output_reference.size(0)) + + dgrad_tensor = dgrad_list[1:] + dgrad_tensor.insert(0, data.grad) + dgrad_tensor = torch.cat(dgrad_tensor, 0) + # check output + output_tensor = y_list[1:] + output_tensor.insert(0, output) + output_tensor = torch.cat(output_tensor, 0) + passed = True + passed = passed and compare("check output", + output_tensor, + output_reference) + # check stats + passed = passed and compare("check running mean failed", + model_reference[1].running_mean, + model.module[1].running_mean) + passed = passed and compare("check running var failed", + model_reference[1].running_var, + model.module[1].running_var) + passed = passed and compare("bn wgrad check failed!", + model_reference[1].weight.grad, + model.module[1].weight.grad, 1e-6) + passed = passed and compare("conv wgrad check failed!", + model_reference[0].weight.grad, + model.module[0].weight.grad) + # can't really compare dgrad directly, as we need to scale it to account for + # DDP + # passed = passed and compare("dgrad check failed!", ref_tensor.grad, dgrad_tensor) + if passed: + print("====SBN two gpu with different batches test passed") + else: + assert("*failed two gpu with different batches tests*") diff --git a/apex/tests/distributed/synced_batchnorm/two_gpu_unit_test.py b/apex/tests/distributed/synced_batchnorm/two_gpu_unit_test.py new file mode 100644 index 0000000000000000000000000000000000000000..ea89e7ae1a8720a8f1bc77e2f7d4e2ec917d421c --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/two_gpu_unit_test.py @@ -0,0 +1,180 @@ +import torch +import numpy as np +import apex +import syncbn +import os +import argparse +import torch.optim as optim + +def compare(desc, inp1, inp2, error): + a = inp1.clone().detach().cpu().numpy() + b = inp2.clone().detach().cpu().numpy() + close = np.allclose(a,b, error, error) + if not close: + print(desc, close) + z = a - b + index = (np.abs(z) >= error + error * np.abs(b)).nonzero() + print("dif : ", z[index]) + print("inp1 : ", a[index]) + print("inp2 : ", b[index]) + return close + +feature_size = 10 +space_size = 40 +batch_size = 32 + + +from apex.parallel import DistributedDataParallel as DDP +parser = argparse.ArgumentParser() +parser.add_argument("--local_rank", default=0, type=int) +parser.add_argument("--fp16", action='store_true', default=False) +parser.add_argument("--fp64", action='store_true', default=False) +args = parser.parse_args() +args.world_size = int(os.environ['WORLD_SIZE']) +torch.cuda.set_device(args.local_rank) +torch.distributed.init_process_group(backend='nccl', init_method='env://') +start = args.local_rank * batch_size//args.world_size +finish = (args.local_rank + 1) * batch_size//args.world_size + +error = 1e-5 +dtype = np.float32 +if args.fp16: + error = 1e-3 + dtype = np.float16 +elif args.fp64: + error = 1e-8 + dtype = np.float64 + +np.random.seed(18) +inp = np.random.randn(batch_size, feature_size, space_size, space_size).astype(dtype) +grad = np.random.randn(batch_size, feature_size, space_size, space_size).astype(dtype) +weight = np.random.randn(feature_size).astype(dtype) +bias = np.random.randn(feature_size).astype(dtype) + + +type_tensor = torch.cuda.FloatTensor +if args.fp16: + type_tensor = torch.cuda.HalfTensor +if args.fp64: + type_tensor = torch.cuda.DoubleTensor + +ref_tensor = torch.cuda.DoubleTensor + +inp_t = type_tensor(inp) +weight_t = type_tensor(weight) +bias_t = type_tensor(bias) + +inp_r = ref_tensor(inp.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +inp2_r = ref_tensor(inp) +weight_r = ref_tensor(weight).view(-1, 1, 1) +bias_r = ref_tensor(bias).view(-1, 1, 1) + +grad_output_t = type_tensor(grad) + +m = inp_r.mean(1) +b_v = inp_r.var(1, unbiased=False) +unb_v = inp_r.var(1, unbiased=True) + +eps = 1e-5 + +mean, var_biased = syncbn.welford_mean_var(inp_t) +inv_std = 1.0 / torch.sqrt(var_biased + eps) + +bn = torch.nn.BatchNorm2d(feature_size).cuda() +bn.momentum = 1.0 +bn.weight.data = weight_t.clone() +bn.bias.data = bias_t.clone() +if args.fp16: + bn.half() +if args.fp64: + bn.double() +inp_bn = inp_t.clone().requires_grad_() +grad_bn = grad_output_t.clone().detach() +out_bn = bn(inp_bn) +out_bn.backward(grad_bn) +# compensating the averaging over processes done by DDP +# in order to produce mathematically equivalent result +# https://github.com/NVIDIA/apex/issues/134#issuecomment-458307368 +for param in bn.parameters(): + param.grad = param.grad / args.world_size +bn_opt = optim.SGD(bn.parameters(), lr=1.0) + +sbn = apex.parallel.SyncBatchNorm(feature_size).cuda() +sbn.momentum = 1.0 +sbn.weight.data = weight_t.clone() +sbn.bias.data = bias_t.clone() +if args.fp16: + sbn.half() +if args.fp64: + sbn.double() +sbn = DDP(sbn) +sbn_opt = optim.SGD(sbn.parameters(), lr=1.0) +inp_sbn = inp_t.clone().requires_grad_() +grad_sbn = grad_output_t.clone().detach() +out_sbn = sbn(inp_sbn[start:finish]) +out_sbn.backward(grad_sbn[start:finish]) + +count = [ space_size**2 * ( (i+1) * batch_size // args.world_size - i * batch_size // args.world_size ) for i in range(0, args.world_size)] +count = torch.cuda.IntTensor(count) + +print("--- count : " , count) + +sbn_result = True +bn_result = True + +if args.local_rank == 0: + sbn_result = compare("comparing mean: ", mean, m, error) and sbn_result + sbn_result = compare("comparing biased variance: ", var_biased, b_v, error) and sbn_result + +out = syncbn.batchnorm_forward(inp_t, mean, inv_std, weight_t, bias_t) +out_r = weight_r * (inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) + bias_r + +if args.local_rank == 0: + sbn_result = compare("comparing output: ", out, out_r, error) and sbn_result + compare("comparing bn output: ", out_bn, out_r, error) + +grad_output_t = type_tensor(grad) + +grad_output_r = ref_tensor(grad.transpose(1, 0, 2, 3).reshape(feature_size, -1)) +grad_output2_r = ref_tensor(grad) + +grad_bias_r = grad_output_r.sum(1) +grad_weight_r = ((inp2_r - m.view(-1, 1, 1)) * torch.rsqrt(b_v.view(-1,1,1) + eps) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).sum(1) + +sum_dy_r = grad_output_r.sum(1) +mean_dy_r = grad_output_r.mean(1) +mean_dy_xmu_r = ((inp2_r - m.view(-1, 1, 1)) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).mean(1) +sum_dy_xmu_r = ((inp2_r - m.view(-1, 1, 1)) * grad_output2_r).transpose(1,0).contiguous().view(feature_size, -1).sum(1) + +grad_input_r = (grad_output2_r - mean_dy_r.view(-1, 1, 1) - (inp2_r - m.view(-1, 1, 1)) / (b_v.view(-1,1,1) + eps) * mean_dy_xmu_r.view(-1, 1, 1) ) * torch.rsqrt(b_v.view(-1,1,1) + eps) * weight_r.view(-1,1,1) + +sum_dy, sum_dy_xmu, grad_weight, grad_bias = syncbn.reduce_bn(grad_output_t, inp_t, mean, inv_std, weight_t) +grad_input = syncbn.batchnorm_backward(grad_output_t, inp_t, mean, inv_std, weight_t, sum_dy, sum_dy_xmu, count) +if args.local_rank == 0: + sbn_result = compare("comparing bias grad: ", grad_bias, grad_bias_r, error) and sbn_result + sbn_result = compare("comparing weight grad: ", grad_weight, grad_weight_r, error) and sbn_result + sbn_result = compare("comparing sum_dy grad: ", sum_dy, sum_dy_r, error) and sbn_result + sbn_result = compare("comparing sum_dy_xmu grad: ", sum_dy_xmu, sum_dy_xmu_r, error) and sbn_result + sbn_result = compare("comparing input grad: ", grad_input, grad_input_r, error) and sbn_result + compare("comparing bn input grad: ", inp_bn.grad, grad_input_r, error) + +if args.local_rank == 0: + sbn_result = compare("comparing running_mean: ", bn.running_mean.data, sbn.module.running_mean.data, error) and sbn_result + sbn_result = compare("comparing running_variance: ", bn.running_var.data, sbn.module.running_var.data, error) and sbn_result + +# execute by both +compare("comparing layers output: ", out_bn[start:finish], out_sbn, error) and sbn_result +compare("comparing layers grad_input: ", inp_bn.grad[start:finish], inp_sbn.grad[start:finish], error) and sbn_result + +bn_opt.step() +sbn_opt.step() + +if args.local_rank == 0: + compare("comparing bn vs sbn bias: ", bn.bias, sbn.module.bias, error) + compare("comparing bn vs sbn weight: ", bn.weight, sbn.module.weight, error) + + +if sbn_result: + print("====SBN two gpu passed tests") +else: + print("*SBN two gpu failed*") diff --git a/apex/tests/distributed/synced_batchnorm/unit_test.sh b/apex/tests/distributed/synced_batchnorm/unit_test.sh new file mode 100755 index 0000000000000000000000000000000000000000..2165f5ec06925a1c5ccd9b17bf1a02fd1e5864b2 --- /dev/null +++ b/apex/tests/distributed/synced_batchnorm/unit_test.sh @@ -0,0 +1,8 @@ +python python_single_gpu_unit_test.py +python single_gpu_unit_test.py +python test_batchnorm1d.py +python -m torch.distributed.launch --nproc_per_node=2 two_gpu_unit_test.py +python -m torch.distributed.launch --nproc_per_node=2 two_gpu_unit_test.py --fp16 +python -m torch.distributed.launch --nproc_per_node=2 two_gpu_test_different_batch_size.py --apex +#beware, you need a system with at least 4 gpus to test group_size im.shape[1]: + height = S + width = int(float(im.shape[1]) / im.shape[0] * S) + scale = float(S) / im.shape[0] + else: + width = S + height = int(float(im.shape[0]) / im.shape[1] * S) + scale = float(S) / im.shape[1] + resized_im = cv2.resize(im, (width, height)) + det_im = np.zeros((S, S, 3), dtype=np.uint8) + det_im[:resized_im.shape[0], :resized_im.shape[1], :] = resized_im + return det_im, scale + + +def transform(data, center, output_size, scale, rotation): + scale_ratio = scale + rot = float(rotation) * np.pi / 180.0 + #translation = (output_size/2-center[0]*scale_ratio, output_size/2-center[1]*scale_ratio) + t1 = trans.SimilarityTransform(scale=scale_ratio) + cx = center[0] * scale_ratio + cy = center[1] * scale_ratio + t2 = trans.SimilarityTransform(translation=(-1 * cx, -1 * cy)) + t3 = trans.SimilarityTransform(rotation=rot) + t4 = trans.SimilarityTransform(translation=(output_size / 2, + output_size / 2)) + t = t1 + t2 + t3 + t4 + M = t.params[0:2] + cropped = cv2.warpAffine(data, + M, (output_size, output_size), + borderValue=0.0) + return cropped, M + + +def trans_points2d_batch(pts, M): + new_pts = np.zeros(shape=pts.shape, dtype=np.float32) + for j in range(pts.shape[0]): + for i in range(pts.shape[1]): + pt = pts[j][i] + new_pt = np.array([pt[0], pt[1], 1.], dtype=np.float32) + new_pt = np.dot(M[j], new_pt) + new_pts[j][i] = new_pt[0:2] + return new_pts + + +def trans_points2d(pts, M): + new_pts = np.zeros(shape=pts.shape, dtype=np.float32) + for i in range(pts.shape[0]): + pt = pts[i] + new_pt = np.array([pt[0], pt[1], 1.], dtype=np.float32) + new_pt = np.dot(M, new_pt) + #print('new_pt', new_pt.shape, new_pt) + new_pts[i] = new_pt[0:2] + + return new_pts + + +def trans_points3d(pts, M): + scale = np.sqrt(M[0][0] * M[0][0] + M[0][1] * M[0][1]) + #print(scale) + new_pts = np.zeros(shape=pts.shape, dtype=np.float32) + for i in range(pts.shape[0]): + pt = pts[i] + new_pt = np.array([pt[0], pt[1], 1.], dtype=np.float32) + new_pt = np.dot(M, new_pt) + #print('new_pt', new_pt.shape, new_pt) + new_pts[i][0:2] = new_pt[0:2] + new_pts[i][2] = pts[i][2] * scale + + return new_pts + + +def trans_points(pts, M): + if pts.shape[1] == 2: + return trans_points2d(pts, M) + else: + return trans_points3d(pts, M) + + +class Handler: + def __init__(self, prefix, epoch, im_size=192, det_size=224, ctx_id=0, root='./insightface_func/models'): + print('loading', prefix, epoch) + if ctx_id >= 0: + ctx = mx.gpu(ctx_id) + else: + ctx = mx.cpu() + image_size = (im_size, im_size) +# self.detector = insightface.model_zoo.get_model( +# 'retinaface_mnet025_v2') #can replace with your own face detector + self.detector = Face_detect_crop(name='antelope', root=root) + self.detector.prepare(ctx_id=ctx_id, det_thresh=0.6, det_size=(640,640)) + #self.detector = insightface.model_zoo.get_model('retinaface_r50_v1') + #self.detector.prepare(ctx_id=ctx_id) + self.det_size = det_size + sym, arg_params, aux_params = mx.model.load_checkpoint(prefix, epoch) + all_layers = sym.get_internals() + sym = all_layers['fc1_output'] + self.image_size = image_size + model = mx.mod.Module(symbol=sym, context=ctx, label_names=None) + model.bind(for_training=False, + data_shapes=[('data', (1, 3, image_size[0], image_size[1])) + ]) + model.set_params(arg_params, aux_params) + self.model = model + self.image_size = image_size + + + def get_without_detection_batch(self, img, M, IM): + rimg = kornia.warp_affine(img, M.repeat(img.shape[0],1,1), (192, 192), padding_mode='zeros') + rimg = kornia.bgr_to_rgb(rimg) + + data = mx.nd.array(rimg) + db = mx.io.DataBatch(data=(data, )) + self.model.forward(db, is_train=False) + pred = self.model.get_outputs()[-1].asnumpy() + pred = pred.reshape((pred.shape[0], -1, 2)) + pred[:, :, 0:2] += 1 + pred[:, :, 0:2] *= (self.image_size[0] // 2) + + pred = trans_points2d_batch(pred, IM.repeat(img.shape[0],1,1).numpy()) + + return pred + + + def get_without_detection_without_transform(self, img): + input_blob = np.zeros((1, 3) + self.image_size, dtype=np.float32) + rimg = cv2.warpAffine(img, M, self.image_size, borderValue=0.0) + rimg = cv2.cvtColor(rimg, cv2.COLOR_BGR2RGB) + rimg = np.transpose(rimg, (2, 0, 1)) #3*112*112, RGB + + input_blob[0] = rimg + data = mx.nd.array(input_blob) + db = mx.io.DataBatch(data=(data, )) + self.model.forward(db, is_train=False) + pred = self.model.get_outputs()[-1].asnumpy()[0] + pred = pred.reshape((-1, 2)) + pred[:, 0:2] += 1 + pred[:, 0:2] *= (self.image_size[0] // 2) + pred = trans_points2d(pred, IM) + + return pred + + + def get_without_detection(self, img): + bbox = [0, 0, img.shape[0], img.shape[1]] + input_blob = np.zeros((1, 3) + self.image_size, dtype=np.float32) + + w, h = (bbox[2] - bbox[0]), (bbox[3] - bbox[1]) + center = (bbox[2] + bbox[0]) / 2, (bbox[3] + bbox[1]) / 2 + rotate = 0 + _scale = self.image_size[0] * 2 / 3.0 / max(w, h) + + rimg, M = transform(img, center, self.image_size[0], _scale, + rotate) + rimg = cv2.cvtColor(rimg, cv2.COLOR_BGR2RGB) + rimg = np.transpose(rimg, (2, 0, 1)) #3*112*112, RGB + + input_blob[0] = rimg + data = mx.nd.array(input_blob) + db = mx.io.DataBatch(data=(data, )) + self.model.forward(db, is_train=False) + pred = self.model.get_outputs()[-1].asnumpy()[0] + if pred.shape[0] >= 3000: + pred = pred.reshape((-1, 3)) + else: + pred = pred.reshape((-1, 2)) + pred[:, 0:2] += 1 + pred[:, 0:2] *= (self.image_size[0] // 2) + if pred.shape[1] == 3: + pred[:, 2] *= (self.image_size[0] // 2) + + IM = cv2.invertAffineTransform(M) + pred = trans_points(pred, IM) + + return pred + + + def get(self, img, get_all=False): + out = [] + det_im, det_scale = square_crop(img, self.det_size) + bboxes, _ = self.detector.detect(det_im) + if bboxes.shape[0] == 0: + return out + bboxes /= det_scale + if not get_all: + areas = [] + for i in range(bboxes.shape[0]): + x = bboxes[i] + area = (x[2] - x[0]) * (x[3] - x[1]) + areas.append(area) + m = np.argsort(areas)[-1] + bboxes = bboxes[m:m + 1] + for i in range(bboxes.shape[0]): + bbox = bboxes[i] + input_blob = np.zeros((1, 3) + self.image_size, dtype=np.float32) + w, h = (bbox[2] - bbox[0]), (bbox[3] - bbox[1]) + center = (bbox[2] + bbox[0]) / 2, (bbox[3] + bbox[1]) / 2 + rotate = 0 + _scale = self.image_size[0] * 2 / 3.0 / max(w, h) + rimg, M = transform(img, center, self.image_size[0], _scale, + rotate) + rimg = cv2.cvtColor(rimg, cv2.COLOR_BGR2RGB) + rimg = np.transpose(rimg, (2, 0, 1)) #3*112*112, RGB + input_blob[0] = rimg + data = mx.nd.array(input_blob) + db = mx.io.DataBatch(data=(data, )) + self.model.forward(db, is_train=False) + pred = self.model.get_outputs()[-1].asnumpy()[0] + if pred.shape[0] >= 3000: + pred = pred.reshape((-1, 3)) + else: + pred = pred.reshape((-1, 2)) + pred[:, 0:2] += 1 + pred[:, 0:2] *= (self.image_size[0] // 2) + if pred.shape[1] == 3: + pred[:, 2] *= (self.image_size[0] // 2) + + IM = cv2.invertAffineTransform(M) + pred = trans_points(pred, IM) + out.append(pred) + return out diff --git a/coordinate_reg/model/2d106det-0000.params b/coordinate_reg/model/2d106det-0000.params new file mode 100644 index 0000000000000000000000000000000000000000..e3be9b7a7b8ed4e9eb94de8a44c380bfa276fd22 --- /dev/null +++ b/coordinate_reg/model/2d106det-0000.params @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:44ae884f998a825a2f06ab074a265a319b6dee96f4d0af552e49b3ca778360d3 +size 5022546 diff --git a/coordinate_reg/model/2d106det-symbol.json b/coordinate_reg/model/2d106det-symbol.json new file mode 100644 index 0000000000000000000000000000000000000000..b00d4f58fd867e386d27c02e1c7abea5c11c2d61 --- /dev/null +++ b/coordinate_reg/model/2d106det-symbol.json @@ -0,0 +1,2637 @@ +{ + "nodes": [ + { + "op": "null", + "name": "data", + "inputs": [] + }, + { + "op": "_minus_scalar", + "name": "_minusscalar0", + "attrs": {"scalar": "127.5"}, + "inputs": [[0, 0, 0]] + }, + { + "op": "_mul_scalar", + "name": "_mulscalar0", + "attrs": {"scalar": "0.0078125"}, + "inputs": [[1, 0, 0]] + }, + { + "op": "null", + "name": "conv_1_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_1_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[2, 0, 0], [3, 0, 0]] + }, + { + "op": "null", + "name": "conv_1_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_1_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_1_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_1_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_1_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[4, 0, 0], [5, 0, 0], [6, 0, 0], [7, 0, 1], [8, 0, 1]] + }, + { + "op": "null", + "name": "conv_1_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_1_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[9, 0, 0], [10, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "16", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_2_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "16", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[11, 0, 0], [12, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_2_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[13, 0, 0], [14, 0, 0], [15, 0, 0], [16, 0, 1], [17, 0, 1]] + }, + { + "op": "null", + "name": "conv_2_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_2_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[18, 0, 0], [19, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "32", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_2_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "32", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[20, 0, 0], [21, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_2_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[22, 0, 0], [23, 0, 0], [24, 0, 0], [25, 0, 1], [26, 0, 1]] + }, + { + "op": "null", + "name": "conv_2_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_2_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[27, 0, 0], [28, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "32", + "num_group": "32", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_3_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "32", + "num_group": "32", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[29, 0, 0], [30, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_3_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[31, 0, 0], [32, 0, 0], [33, 0, 0], [34, 0, 1], [35, 0, 1]] + }, + { + "op": "null", + "name": "conv_3_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_3_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[36, 0, 0], [37, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_3_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[38, 0, 0], [39, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_3_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[40, 0, 0], [41, 0, 0], [42, 0, 0], [43, 0, 1], [44, 0, 1]] + }, + { + "op": "null", + "name": "conv_3_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_3_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[45, 0, 0], [46, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_4_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[47, 0, 0], [48, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_4_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[49, 0, 0], [50, 0, 0], [51, 0, 0], [52, 0, 1], [53, 0, 1]] + }, + { + "op": "null", + "name": "conv_4_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_4_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[54, 0, 0], [55, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_4_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[56, 0, 0], [57, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_4_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[58, 0, 0], [59, 0, 0], [60, 0, 0], [61, 0, 1], [62, 0, 1]] + }, + { + "op": "null", + "name": "conv_4_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_4_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[63, 0, 0], [64, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_5_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[65, 0, 0], [66, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_5_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[67, 0, 0], [68, 0, 0], [69, 0, 0], [70, 0, 1], [71, 0, 1]] + }, + { + "op": "null", + "name": "conv_5_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_5_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[72, 0, 0], [73, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_5_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[74, 0, 0], [75, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_5_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[76, 0, 0], [77, 0, 0], [78, 0, 0], [79, 0, 1], [80, 0, 1]] + }, + { + "op": "null", + "name": "conv_5_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_5_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[81, 0, 0], [82, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_6_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[83, 0, 0], [84, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_6_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[85, 0, 0], [86, 0, 0], [87, 0, 0], [88, 0, 1], [89, 0, 1]] + }, + { + "op": "null", + "name": "conv_6_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_6_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[90, 0, 0], [91, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_6_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[92, 0, 0], [93, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_6_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[94, 0, 0], [95, 0, 0], [96, 0, 0], [97, 0, 1], [98, 0, 1]] + }, + { + "op": "null", + "name": "conv_6_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_6_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[99, 0, 0], [100, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_7_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[101, 0, 0], [102, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_7_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[103, 0, 0], [104, 0, 0], [105, 0, 0], [106, 0, 1], [107, 0, 1]] + }, + { + "op": "null", + "name": "conv_7_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_7_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[108, 0, 0], [109, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_7_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[110, 0, 0], [111, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_7_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[112, 0, 0], [113, 0, 0], [114, 0, 0], [115, 0, 1], [116, 0, 1]] + }, + { + "op": "null", + "name": "conv_7_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_7_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[117, 0, 0], [118, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_8_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[119, 0, 0], [120, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_8_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[121, 0, 0], [122, 0, 0], [123, 0, 0], [124, 0, 1], [125, 0, 1]] + }, + { + "op": "null", + "name": "conv_8_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_8_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[126, 0, 0], [127, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_8_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[128, 0, 0], [129, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_8_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[130, 0, 0], [131, 0, 0], [132, 0, 0], [133, 0, 1], [134, 0, 1]] + }, + { + "op": "null", + "name": "conv_8_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_8_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[135, 0, 0], [136, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_9_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[137, 0, 0], [138, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_9_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[139, 0, 0], [140, 0, 0], [141, 0, 0], [142, 0, 1], [143, 0, 1]] + }, + { + "op": "null", + "name": "conv_9_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_9_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[144, 0, 0], [145, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_9_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[146, 0, 0], [147, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_9_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[148, 0, 0], [149, 0, 0], [150, 0, 0], [151, 0, 1], [152, 0, 1]] + }, + { + "op": "null", + "name": "conv_9_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_9_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[153, 0, 0], [154, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_10_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[155, 0, 0], [156, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_10_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[157, 0, 0], [158, 0, 0], [159, 0, 0], [160, 0, 1], [161, 0, 1]] + }, + { + "op": "null", + "name": "conv_10_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_10_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[162, 0, 0], [163, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_10_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[164, 0, 0], [165, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_10_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[166, 0, 0], [167, 0, 0], [168, 0, 0], [169, 0, 1], [170, 0, 1]] + }, + { + "op": "null", + "name": "conv_10_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_10_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[171, 0, 0], [172, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_11_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[173, 0, 0], [174, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_11_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[175, 0, 0], [176, 0, 0], [177, 0, 0], [178, 0, 1], [179, 0, 1]] + }, + { + "op": "null", + "name": "conv_11_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_11_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[180, 0, 0], [181, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_11_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[182, 0, 0], [183, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_11_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[184, 0, 0], [185, 0, 0], [186, 0, 0], [187, 0, 1], [188, 0, 1]] + }, + { + "op": "null", + "name": "conv_11_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_11_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[189, 0, 0], [190, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_12_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[191, 0, 0], [192, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_12_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[193, 0, 0], [194, 0, 0], [195, 0, 0], [196, 0, 1], [197, 0, 1]] + }, + { + "op": "null", + "name": "conv_12_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_12_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[198, 0, 0], [199, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_12_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[200, 0, 0], [201, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_12_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[202, 0, 0], [203, 0, 0], [204, 0, 0], [205, 0, 1], [206, 0, 1]] + }, + { + "op": "null", + "name": "conv_12_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_12_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[207, 0, 0], [208, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_13_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[209, 0, 0], [210, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_13_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[211, 0, 0], [212, 0, 0], [213, 0, 0], [214, 0, 1], [215, 0, 1]] + }, + { + "op": "null", + "name": "conv_13_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_13_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[216, 0, 0], [217, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_13_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[218, 0, 0], [219, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_13_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[220, 0, 0], [221, 0, 0], [222, 0, 0], [223, 0, 1], [224, 0, 1]] + }, + { + "op": "null", + "name": "conv_13_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_13_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[225, 0, 0], [226, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "512", + "num_group": "512", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_14_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "512", + "num_group": "512", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[227, 0, 0], [228, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_14_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[229, 0, 0], [230, 0, 0], [231, 0, 0], [232, 0, 1], [233, 0, 1]] + }, + { + "op": "null", + "name": "conv_14_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_14_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[234, 0, 0], [235, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_14_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[236, 0, 0], [237, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_14_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[238, 0, 0], [239, 0, 0], [240, 0, 0], [241, 0, 1], [242, 0, 1]] + }, + { + "op": "null", + "name": "conv_14_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_14_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[243, 0, 0], [244, 0, 0]] + }, + { + "op": "null", + "name": "conv_15_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_15_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[245, 0, 0], [246, 0, 0]] + }, + { + "op": "null", + "name": "conv_15_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_15_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_15_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_15_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_15_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[247, 0, 0], [248, 0, 0], [249, 0, 0], [250, 0, 1], [251, 0, 1]] + }, + { + "op": "null", + "name": "conv_15_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_15_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[252, 0, 0], [253, 0, 0]] + }, + { + "op": "Flatten", + "name": "flatten0", + "inputs": [[254, 0, 0]] + }, + { + "op": "null", + "name": "fc1_weight", + "attrs": {"__init__": "[\"normal\", {\"sigma\": 0.0001}]"}, + "inputs": [] + }, + { + "op": "null", + "name": "fc1_bias", + "attrs": {"num_hidden": "212"}, + "inputs": [] + }, + { + "op": "FullyConnected", + "name": "fc1", + "attrs": {"num_hidden": "212"}, + "inputs": [[255, 0, 0], [256, 0, 0], [257, 0, 0]] + } + ], + "arg_nodes": [ + 0, + 3, + 5, + 6, + 7, + 8, + 10, + 12, + 14, + 15, + 16, + 17, + 19, + 21, + 23, + 24, + 25, + 26, + 28, + 30, + 32, + 33, + 34, + 35, + 37, + 39, + 41, + 42, + 43, + 44, + 46, + 48, + 50, + 51, + 52, + 53, + 55, + 57, + 59, + 60, + 61, + 62, + 64, + 66, + 68, + 69, + 70, + 71, + 73, + 75, + 77, + 78, + 79, + 80, + 82, + 84, + 86, + 87, + 88, + 89, + 91, + 93, + 95, + 96, + 97, + 98, + 100, + 102, + 104, + 105, + 106, + 107, + 109, + 111, + 113, + 114, + 115, + 116, + 118, + 120, + 122, + 123, + 124, + 125, + 127, + 129, + 131, + 132, + 133, + 134, + 136, + 138, + 140, + 141, + 142, + 143, + 145, + 147, + 149, + 150, + 151, + 152, + 154, + 156, + 158, + 159, + 160, + 161, + 163, + 165, + 167, + 168, + 169, + 170, + 172, + 174, + 176, + 177, + 178, + 179, + 181, + 183, + 185, + 186, + 187, + 188, + 190, + 192, + 194, + 195, + 196, + 197, + 199, + 201, + 203, + 204, + 205, + 206, + 208, + 210, + 212, + 213, + 214, + 215, + 217, + 219, + 221, + 222, + 223, + 224, + 226, + 228, + 230, + 231, + 232, + 233, + 235, + 237, + 239, + 240, + 241, + 242, + 244, + 246, + 248, + 249, + 250, + 251, + 253, + 256, + 257 + ], + "node_row_ptr": [ + 0, + 1, + 2, + 3, + 4, + 5, + 6, + 7, + 8, + 9, + 12, + 13, + 14, + 15, + 16, + 17, + 18, + 19, + 20, + 23, + 24, + 25, + 26, + 27, + 28, + 29, + 30, + 31, + 34, + 35, + 36, + 37, + 38, + 39, + 40, + 41, + 42, + 45, + 46, + 47, + 48, + 49, + 50, + 51, + 52, + 53, + 56, + 57, + 58, + 59, + 60, + 61, + 62, + 63, + 64, + 67, + 68, + 69, + 70, + 71, + 72, + 73, + 74, + 75, + 78, + 79, + 80, + 81, + 82, + 83, + 84, + 85, + 86, + 89, + 90, + 91, + 92, + 93, + 94, + 95, + 96, + 97, + 100, + 101, + 102, + 103, + 104, + 105, + 106, + 107, + 108, + 111, + 112, + 113, + 114, + 115, + 116, + 117, + 118, + 119, + 122, + 123, + 124, + 125, + 126, + 127, + 128, + 129, + 130, + 133, + 134, + 135, + 136, + 137, + 138, + 139, + 140, + 141, + 144, + 145, + 146, + 147, + 148, + 149, + 150, + 151, + 152, + 155, + 156, + 157, + 158, + 159, + 160, + 161, + 162, + 163, + 166, + 167, + 168, + 169, + 170, + 171, + 172, + 173, + 174, + 177, + 178, + 179, + 180, + 181, + 182, + 183, + 184, + 185, + 188, + 189, + 190, + 191, + 192, + 193, + 194, + 195, + 196, + 199, + 200, + 201, + 202, + 203, + 204, + 205, + 206, + 207, + 210, + 211, + 212, + 213, + 214, + 215, + 216, + 217, + 218, + 221, + 222, + 223, + 224, + 225, + 226, + 227, + 228, + 229, + 232, + 233, + 234, + 235, + 236, + 237, + 238, + 239, + 240, + 243, + 244, + 245, + 246, + 247, + 248, + 249, + 250, + 251, + 254, + 255, + 256, + 257, + 258, + 259, + 260, + 261, + 262, + 265, + 266, + 267, + 268, + 269, + 270, + 271, + 272, + 273, + 276, + 277, + 278, + 279, + 280, + 281, + 282, + 283, + 284, + 287, + 288, + 289, + 290, + 291, + 292, + 293, + 294, + 295, + 298, + 299, + 300, + 301, + 302, + 303, + 304, + 305, + 306, + 309, + 310, + 311, + 312, + 313, + 314, + 315 + ], + "heads": [[258, 0, 0]], + "attrs": {"mxnet_version": ["int", 10500]} +} \ No newline at end of file diff --git a/coordinate_reg/model/2d106det.zip b/coordinate_reg/model/2d106det.zip new file mode 100644 index 0000000000000000000000000000000000000000..647f01217b0ad7885ab1775a65bdbbe8dcf5fe96 --- /dev/null +++ b/coordinate_reg/model/2d106det.zip @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:04caf79c2f0643ccc8e9940854fe7f3be1aa0afaecd25821a7a28f1414b933a3 +size 4647032 diff --git a/coordinate_reg/model/2d106det/2d106det-0000.params b/coordinate_reg/model/2d106det/2d106det-0000.params new file mode 100644 index 0000000000000000000000000000000000000000..e3be9b7a7b8ed4e9eb94de8a44c380bfa276fd22 --- /dev/null +++ b/coordinate_reg/model/2d106det/2d106det-0000.params @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:44ae884f998a825a2f06ab074a265a319b6dee96f4d0af552e49b3ca778360d3 +size 5022546 diff --git a/coordinate_reg/model/2d106det/2d106det-symbol.json b/coordinate_reg/model/2d106det/2d106det-symbol.json new file mode 100644 index 0000000000000000000000000000000000000000..b00d4f58fd867e386d27c02e1c7abea5c11c2d61 --- /dev/null +++ b/coordinate_reg/model/2d106det/2d106det-symbol.json @@ -0,0 +1,2637 @@ +{ + "nodes": [ + { + "op": "null", + "name": "data", + "inputs": [] + }, + { + "op": "_minus_scalar", + "name": "_minusscalar0", + "attrs": {"scalar": "127.5"}, + "inputs": [[0, 0, 0]] + }, + { + "op": "_mul_scalar", + "name": "_mulscalar0", + "attrs": {"scalar": "0.0078125"}, + "inputs": [[1, 0, 0]] + }, + { + "op": "null", + "name": "conv_1_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_1_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[2, 0, 0], [3, 0, 0]] + }, + { + "op": "null", + "name": "conv_1_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_1_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_1_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_1_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_1_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[4, 0, 0], [5, 0, 0], [6, 0, 0], [7, 0, 1], [8, 0, 1]] + }, + { + "op": "null", + "name": "conv_1_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_1_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[9, 0, 0], [10, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "16", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_2_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "16", + "num_group": "16", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[11, 0, 0], [12, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_2_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[13, 0, 0], [14, 0, 0], [15, 0, 0], [16, 0, 1], [17, 0, 1]] + }, + { + "op": "null", + "name": "conv_2_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_2_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[18, 0, 0], [19, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "32", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_2_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "32", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[20, 0, 0], [21, 0, 0]] + }, + { + "op": "null", + "name": "conv_2_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_2_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_2_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[22, 0, 0], [23, 0, 0], [24, 0, 0], [25, 0, 1], [26, 0, 1]] + }, + { + "op": "null", + "name": "conv_2_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_2_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[27, 0, 0], [28, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "32", + "num_group": "32", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_3_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "32", + "num_group": "32", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[29, 0, 0], [30, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_3_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[31, 0, 0], [32, 0, 0], [33, 0, 0], [34, 0, 1], [35, 0, 1]] + }, + { + "op": "null", + "name": "conv_3_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_3_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[36, 0, 0], [37, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_3_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[38, 0, 0], [39, 0, 0]] + }, + { + "op": "null", + "name": "conv_3_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_3_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_3_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[40, 0, 0], [41, 0, 0], [42, 0, 0], [43, 0, 1], [44, 0, 1]] + }, + { + "op": "null", + "name": "conv_3_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_3_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[45, 0, 0], [46, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_4_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[47, 0, 0], [48, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_4_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[49, 0, 0], [50, 0, 0], [51, 0, 0], [52, 0, 1], [53, 0, 1]] + }, + { + "op": "null", + "name": "conv_4_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_4_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[54, 0, 0], [55, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_4_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[56, 0, 0], [57, 0, 0]] + }, + { + "op": "null", + "name": "conv_4_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_4_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_4_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[58, 0, 0], [59, 0, 0], [60, 0, 0], [61, 0, 1], [62, 0, 1]] + }, + { + "op": "null", + "name": "conv_4_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_4_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[63, 0, 0], [64, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_5_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "64", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[65, 0, 0], [66, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_5_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[67, 0, 0], [68, 0, 0], [69, 0, 0], [70, 0, 1], [71, 0, 1]] + }, + { + "op": "null", + "name": "conv_5_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_5_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[72, 0, 0], [73, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_5_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[74, 0, 0], [75, 0, 0]] + }, + { + "op": "null", + "name": "conv_5_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_5_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_5_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[76, 0, 0], [77, 0, 0], [78, 0, 0], [79, 0, 1], [80, 0, 1]] + }, + { + "op": "null", + "name": "conv_5_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_5_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[81, 0, 0], [82, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_6_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[83, 0, 0], [84, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_6_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[85, 0, 0], [86, 0, 0], [87, 0, 0], [88, 0, 1], [89, 0, 1]] + }, + { + "op": "null", + "name": "conv_6_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_6_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[90, 0, 0], [91, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_6_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "128", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[92, 0, 0], [93, 0, 0]] + }, + { + "op": "null", + "name": "conv_6_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_6_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_6_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[94, 0, 0], [95, 0, 0], [96, 0, 0], [97, 0, 1], [98, 0, 1]] + }, + { + "op": "null", + "name": "conv_6_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_6_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[99, 0, 0], [100, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_7_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "128", + "num_group": "128", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[101, 0, 0], [102, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_7_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[103, 0, 0], [104, 0, 0], [105, 0, 0], [106, 0, 1], [107, 0, 1]] + }, + { + "op": "null", + "name": "conv_7_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_7_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[108, 0, 0], [109, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_7_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[110, 0, 0], [111, 0, 0]] + }, + { + "op": "null", + "name": "conv_7_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_7_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_7_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[112, 0, 0], [113, 0, 0], [114, 0, 0], [115, 0, 1], [116, 0, 1]] + }, + { + "op": "null", + "name": "conv_7_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_7_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[117, 0, 0], [118, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_8_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[119, 0, 0], [120, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_8_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[121, 0, 0], [122, 0, 0], [123, 0, 0], [124, 0, 1], [125, 0, 1]] + }, + { + "op": "null", + "name": "conv_8_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_8_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[126, 0, 0], [127, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_8_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[128, 0, 0], [129, 0, 0]] + }, + { + "op": "null", + "name": "conv_8_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_8_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_8_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[130, 0, 0], [131, 0, 0], [132, 0, 0], [133, 0, 1], [134, 0, 1]] + }, + { + "op": "null", + "name": "conv_8_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_8_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[135, 0, 0], [136, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_9_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[137, 0, 0], [138, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_9_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[139, 0, 0], [140, 0, 0], [141, 0, 0], [142, 0, 1], [143, 0, 1]] + }, + { + "op": "null", + "name": "conv_9_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_9_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[144, 0, 0], [145, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_9_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[146, 0, 0], [147, 0, 0]] + }, + { + "op": "null", + "name": "conv_9_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_9_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_9_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[148, 0, 0], [149, 0, 0], [150, 0, 0], [151, 0, 1], [152, 0, 1]] + }, + { + "op": "null", + "name": "conv_9_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_9_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[153, 0, 0], [154, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_10_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[155, 0, 0], [156, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_10_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[157, 0, 0], [158, 0, 0], [159, 0, 0], [160, 0, 1], [161, 0, 1]] + }, + { + "op": "null", + "name": "conv_10_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_10_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[162, 0, 0], [163, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_10_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[164, 0, 0], [165, 0, 0]] + }, + { + "op": "null", + "name": "conv_10_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_10_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_10_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[166, 0, 0], [167, 0, 0], [168, 0, 0], [169, 0, 1], [170, 0, 1]] + }, + { + "op": "null", + "name": "conv_10_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_10_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[171, 0, 0], [172, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_11_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[173, 0, 0], [174, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_11_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[175, 0, 0], [176, 0, 0], [177, 0, 0], [178, 0, 1], [179, 0, 1]] + }, + { + "op": "null", + "name": "conv_11_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_11_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[180, 0, 0], [181, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_11_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[182, 0, 0], [183, 0, 0]] + }, + { + "op": "null", + "name": "conv_11_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_11_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_11_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[184, 0, 0], [185, 0, 0], [186, 0, 0], [187, 0, 1], [188, 0, 1]] + }, + { + "op": "null", + "name": "conv_11_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_11_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[189, 0, 0], [190, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_12_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[191, 0, 0], [192, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_12_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[193, 0, 0], [194, 0, 0], [195, 0, 0], [196, 0, 1], [197, 0, 1]] + }, + { + "op": "null", + "name": "conv_12_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_12_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[198, 0, 0], [199, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_12_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "256", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[200, 0, 0], [201, 0, 0]] + }, + { + "op": "null", + "name": "conv_12_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_12_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_12_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[202, 0, 0], [203, 0, 0], [204, 0, 0], [205, 0, 1], [206, 0, 1]] + }, + { + "op": "null", + "name": "conv_12_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_12_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[207, 0, 0], [208, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_13_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "256", + "num_group": "256", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[209, 0, 0], [210, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_13_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[211, 0, 0], [212, 0, 0], [213, 0, 0], [214, 0, 1], [215, 0, 1]] + }, + { + "op": "null", + "name": "conv_13_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_13_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[216, 0, 0], [217, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_13_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[218, 0, 0], [219, 0, 0]] + }, + { + "op": "null", + "name": "conv_13_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_13_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_13_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[220, 0, 0], [221, 0, 0], [222, 0, 0], [223, 0, 1], [224, 0, 1]] + }, + { + "op": "null", + "name": "conv_13_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_13_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[225, 0, 0], [226, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_dw_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "512", + "num_group": "512", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_14_dw_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "512", + "num_group": "512", + "pad": "(1, 1)", + "stride": "(1, 1)" + }, + "inputs": [[227, 0, 0], [228, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_dw_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_14_dw_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[229, 0, 0], [230, 0, 0], [231, 0, 0], [232, 0, 1], [233, 0, 1]] + }, + { + "op": "null", + "name": "conv_14_dw_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_14_dw_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[234, 0, 0], [235, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_conv2d_weight", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_14_conv2d", + "attrs": { + "kernel": "(1, 1)", + "no_bias": "True", + "num_filter": "512", + "num_group": "1", + "pad": "(0, 0)", + "stride": "(1, 1)" + }, + "inputs": [[236, 0, 0], [237, 0, 0]] + }, + { + "op": "null", + "name": "conv_14_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_14_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_14_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[238, 0, 0], [239, 0, 0], [240, 0, 0], [241, 0, 1], [242, 0, 1]] + }, + { + "op": "null", + "name": "conv_14_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_14_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[243, 0, 0], [244, 0, 0]] + }, + { + "op": "null", + "name": "conv_15_conv2d_weight", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [] + }, + { + "op": "Convolution", + "name": "conv_15_conv2d", + "attrs": { + "kernel": "(3, 3)", + "no_bias": "True", + "num_filter": "64", + "num_group": "1", + "pad": "(1, 1)", + "stride": "(2, 2)" + }, + "inputs": [[245, 0, 0], [246, 0, 0]] + }, + { + "op": "null", + "name": "conv_15_batchnorm_gamma", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_15_batchnorm_beta", + "attrs": {"fix_gamma": "True"}, + "inputs": [] + }, + { + "op": "null", + "name": "conv_15_batchnorm_moving_mean", + "attrs": { + "__init__": "[\"zero\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "null", + "name": "conv_15_batchnorm_moving_var", + "attrs": { + "__init__": "[\"one\", {}]", + "fix_gamma": "True" + }, + "inputs": [] + }, + { + "op": "BatchNorm", + "name": "conv_15_batchnorm", + "attrs": {"fix_gamma": "True"}, + "inputs": [[247, 0, 0], [248, 0, 0], [249, 0, 0], [250, 0, 1], [251, 0, 1]] + }, + { + "op": "null", + "name": "conv_15_relu_gamma", + "attrs": { + "__init__": "[\"Constant\", {\"value\": 0.25}]", + "act_type": "prelu" + }, + "inputs": [] + }, + { + "op": "LeakyReLU", + "name": "conv_15_relu", + "attrs": {"act_type": "prelu"}, + "inputs": [[252, 0, 0], [253, 0, 0]] + }, + { + "op": "Flatten", + "name": "flatten0", + "inputs": [[254, 0, 0]] + }, + { + "op": "null", + "name": "fc1_weight", + "attrs": {"__init__": "[\"normal\", {\"sigma\": 0.0001}]"}, + "inputs": [] + }, + { + "op": "null", + "name": "fc1_bias", + "attrs": {"num_hidden": "212"}, + "inputs": [] + }, + { + "op": "FullyConnected", + "name": "fc1", + "attrs": {"num_hidden": "212"}, + "inputs": [[255, 0, 0], [256, 0, 0], [257, 0, 0]] + } + ], + "arg_nodes": [ + 0, + 3, + 5, + 6, + 7, + 8, + 10, + 12, + 14, + 15, + 16, + 17, + 19, + 21, + 23, + 24, + 25, + 26, + 28, + 30, + 32, + 33, + 34, + 35, + 37, + 39, + 41, + 42, + 43, + 44, + 46, + 48, + 50, + 51, + 52, + 53, + 55, + 57, + 59, + 60, + 61, + 62, + 64, + 66, + 68, + 69, + 70, + 71, + 73, + 75, + 77, + 78, + 79, + 80, + 82, + 84, + 86, + 87, + 88, + 89, + 91, + 93, + 95, + 96, + 97, + 98, + 100, + 102, + 104, + 105, + 106, + 107, + 109, + 111, + 113, + 114, + 115, + 116, + 118, + 120, + 122, + 123, + 124, + 125, + 127, + 129, + 131, + 132, + 133, + 134, + 136, + 138, + 140, + 141, + 142, + 143, + 145, + 147, + 149, + 150, + 151, + 152, + 154, + 156, + 158, + 159, + 160, + 161, + 163, + 165, + 167, + 168, + 169, + 170, + 172, + 174, + 176, + 177, + 178, + 179, + 181, + 183, + 185, + 186, + 187, + 188, + 190, + 192, + 194, + 195, + 196, + 197, + 199, + 201, + 203, + 204, + 205, + 206, + 208, + 210, + 212, + 213, + 214, + 215, + 217, + 219, + 221, + 222, + 223, + 224, + 226, + 228, + 230, + 231, + 232, + 233, + 235, + 237, + 239, + 240, + 241, + 242, + 244, + 246, + 248, + 249, + 250, + 251, + 253, + 256, + 257 + ], + "node_row_ptr": [ + 0, + 1, + 2, + 3, + 4, + 5, + 6, + 7, + 8, + 9, + 12, + 13, + 14, + 15, + 16, + 17, + 18, + 19, + 20, + 23, + 24, + 25, + 26, + 27, + 28, + 29, + 30, + 31, + 34, + 35, + 36, + 37, + 38, + 39, + 40, + 41, + 42, + 45, + 46, + 47, + 48, + 49, + 50, + 51, + 52, + 53, + 56, + 57, + 58, + 59, + 60, + 61, + 62, + 63, + 64, + 67, + 68, + 69, + 70, + 71, + 72, + 73, + 74, + 75, + 78, + 79, + 80, + 81, + 82, + 83, + 84, + 85, + 86, + 89, + 90, + 91, + 92, + 93, + 94, + 95, + 96, + 97, + 100, + 101, + 102, + 103, + 104, + 105, + 106, + 107, + 108, + 111, + 112, + 113, + 114, + 115, + 116, + 117, + 118, + 119, + 122, + 123, + 124, + 125, + 126, + 127, + 128, + 129, + 130, + 133, + 134, + 135, + 136, + 137, + 138, + 139, + 140, + 141, + 144, + 145, + 146, + 147, + 148, + 149, + 150, + 151, + 152, + 155, + 156, + 157, + 158, + 159, + 160, + 161, + 162, + 163, + 166, + 167, + 168, + 169, + 170, + 171, + 172, + 173, + 174, + 177, + 178, + 179, + 180, + 181, + 182, + 183, + 184, + 185, + 188, + 189, + 190, + 191, + 192, + 193, + 194, + 195, + 196, + 199, + 200, + 201, + 202, + 203, + 204, + 205, + 206, + 207, + 210, + 211, + 212, + 213, + 214, + 215, + 216, + 217, + 218, + 221, + 222, + 223, + 224, + 225, + 226, + 227, + 228, + 229, + 232, + 233, + 234, + 235, + 236, + 237, + 238, + 239, + 240, + 243, + 244, + 245, + 246, + 247, + 248, + 249, + 250, + 251, + 254, + 255, + 256, + 257, + 258, + 259, + 260, + 261, + 262, + 265, + 266, + 267, + 268, + 269, + 270, + 271, + 272, + 273, + 276, + 277, + 278, + 279, + 280, + 281, + 282, + 283, + 284, + 287, + 288, + 289, + 290, + 291, + 292, + 293, + 294, + 295, + 298, + 299, + 300, + 301, + 302, + 303, + 304, + 305, + 306, + 309, + 310, + 311, + 312, + 313, + 314, + 315 + ], + "heads": [[258, 0, 0]], + "attrs": {"mxnet_version": ["int", 10500]} +} \ No newline at end of file diff --git a/coordinate_reg/model/SCRFD/model_25GF.pth b/coordinate_reg/model/SCRFD/model_25GF.pth new file mode 100644 index 0000000000000000000000000000000000000000..41a4f98d5e44125dce51a2c53f68524af4cee43d --- /dev/null +++ b/coordinate_reg/model/SCRFD/model_25GF.pth @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:fbe1d35ac6e0859307067bc3ccd44973b536b451437d23547fc460a05d00993f +size 2781443 diff --git a/download_models.sh b/download_models.sh new file mode 100644 index 0000000000000000000000000000000000000000..7acadf3af40815c8ba8abb9b7d81b85d10266f31 --- /dev/null +++ b/download_models.sh @@ -0,0 +1,24 @@ +# load arcface +wget -P ./arcface_model https://github.com/sberbank-ai/sber-swap/releases/download/arcface/backbone.pth +wget -P ./arcface_model https://github.com/sberbank-ai/sber-swap/releases/download/arcface/iresnet.py + +# load landmarks detector +wget -P ./insightface_func/models/antelope https://github.com/sberbank-ai/sber-swap/releases/download/antelope/glintr100.onnx +wget -P ./insightface_func/models/antelope https://github.com/sberbank-ai/sber-swap/releases/download/antelope/scrfd_10g_bnkps.onnx + +# load G and D models with 1, 2, 3 blocks +# model with 2 blocks is main +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/sber-swap-v2.0/G_unet_2blocks.pth +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/sber-swap-v2.0/D_unet_2blocks.pth + +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/sber-swap-v2.0/G_unet_1block.pth +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/sber-swap-v2.0/D_unet_1block.pth + +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/sber-swap-v2.0/G_unet_3blocks.pth +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/sber-swap-v2.0/D_unet_3blocks.pth + +# load model for eyes loss +wget -P ./AdaptiveWingLoss/AWL_detector https://github.com/sberbank-ai/sber-swap/releases/download/awl_detector/WFLW_4HG.pth + +# load super res model +wget -P ./weights https://github.com/sberbank-ai/sber-swap/releases/download/super-res/10_net_G.pth diff --git a/examples/images/beckham.jpg b/examples/images/beckham.jpg new file mode 100644 index 0000000000000000000000000000000000000000..277fdad2f84355447d6f43c89b483f122f215580 --- /dev/null +++ b/examples/images/beckham.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:47c972be5d105da79143b53db9ccdfba07caab4f3689030c6812f2a440f468b6 +size 66877 diff --git a/examples/images/elon_musk.jpg b/examples/images/elon_musk.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ef29406bcb56aa820290ab542942974b033d48a4 --- /dev/null +++ b/examples/images/elon_musk.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a40c0ffe3f2e8ecd3f92aad1b9c969019619d251fec85abd92be6d93d8752bf4 +size 171941 diff --git a/examples/images/example1.png b/examples/images/example1.png new file mode 100644 index 0000000000000000000000000000000000000000..2476de58e1b09b993de4f38ba9508174f21119f5 --- /dev/null +++ b/examples/images/example1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e5d835fe6417c70e714626cc9d56583d5ccae994d661d9d632d2a636b57c0bcd +size 1512200 diff --git a/examples/images/example2.png b/examples/images/example2.png new file mode 100644 index 0000000000000000000000000000000000000000..ad8df8a0b0f0377a8ec2f78d3da6529134f0cfac --- /dev/null +++ b/examples/images/example2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:119aaadc3396461e2efa15b6ccc45436bf38e2fae4eb0d9b94755d5b5201a0a1 +size 5691224 diff --git a/examples/images/mark.jpg b/examples/images/mark.jpg new file mode 100644 index 0000000000000000000000000000000000000000..a495a08f86ebe58936e85cc455f69a468143f3fd --- /dev/null +++ b/examples/images/mark.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0ec811d1216e4804e57ad932cd133158bb7f605b72aa25dfe1dd3863b60cfb72 +size 32541 diff --git a/examples/images/murakami.jpg b/examples/images/murakami.jpg new file mode 100644 index 0000000000000000000000000000000000000000..aa6e35e279a3015cb08f75295301a991ac7b78e1 --- /dev/null +++ b/examples/images/murakami.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8c3931aadd235868bfd24d454c97ee3ed1a4e3f1bae2f1aca3147c10108d5dc5 +size 86316 diff --git a/examples/images/tgt1.png b/examples/images/tgt1.png new file mode 100644 index 0000000000000000000000000000000000000000..0db5a1318b0ca2818b742dbe47db7457fd2d87b9 --- /dev/null +++ b/examples/images/tgt1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:cac3cc76b2ff4d0d1c3d4a3c54462b946e1bc9b9a531cd0230ed9113145c7e94 +size 796695 diff --git a/examples/images/tgt2.png b/examples/images/tgt2.png new file mode 100644 index 0000000000000000000000000000000000000000..d3b688063162768fc9102ca795ad677f2684a891 --- /dev/null +++ b/examples/images/tgt2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2096299e87f0b9a5ca545b81ee5d11c90dbe7158582d7565590bf89075a0fa7e +size 948700 diff --git a/examples/images/training/source1.png b/examples/images/training/source1.png new file mode 100644 index 0000000000000000000000000000000000000000..34b9c1ba12660cae44f2967605dc4c1d478ee03e --- /dev/null +++ b/examples/images/training/source1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b6b8af7969ef66714718cf27ebbb79a48c1192135641f64d8ef6c209eec866e5 +size 78441 diff --git a/examples/images/training/source2.png b/examples/images/training/source2.png new file mode 100644 index 0000000000000000000000000000000000000000..1a82232b1c1b62865e97c10182f1732fcd81e6aa --- /dev/null +++ b/examples/images/training/source2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0748a516db407943ae665bbec639e79739cf0cc50a26e5b39f2071814eceafd7 +size 83455 diff --git a/examples/images/training/source3.png b/examples/images/training/source3.png new file mode 100644 index 0000000000000000000000000000000000000000..f07be8ce2b4bd142496ba9a7a3b1c377bd121296 --- /dev/null +++ b/examples/images/training/source3.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a27ceba47e1251ef5022a54b2b54dedc800b1d9bc9099e9e030cc086a7466b43 +size 67110 diff --git a/examples/images/training/source4.png b/examples/images/training/source4.png new file mode 100644 index 0000000000000000000000000000000000000000..29549ae06787ec468dc12038a6bbc440fdc2154e --- /dev/null +++ b/examples/images/training/source4.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9c5ff111cbce7d87345012efeb788b23bc2799f2949f4940a20d951e67eb66a3 +size 83738 diff --git a/examples/images/training/source5.png b/examples/images/training/source5.png new file mode 100644 index 0000000000000000000000000000000000000000..ee5f366072cd4fc12da935dcf4a1cd4b5381bd18 --- /dev/null +++ b/examples/images/training/source5.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:df217df9e85166aa719c3d0f1f81a7c3089ed7566a5a187c27d99c252d74d2e8 +size 97509 diff --git a/examples/images/training/source6.png b/examples/images/training/source6.png new file mode 100644 index 0000000000000000000000000000000000000000..635dfa73d5e0d7610508852cf923d0db42ae21ee --- /dev/null +++ b/examples/images/training/source6.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4d8b3c16a1ad79248dd916593b2aadf3a6d207ed229635d3d427efde9267ba5b +size 80339 diff --git a/examples/images/training/target1.png b/examples/images/training/target1.png new file mode 100644 index 0000000000000000000000000000000000000000..abe9dd4e92b325f40f8f5a21c085e0bbb6ac1052 --- /dev/null +++ b/examples/images/training/target1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:edd5a7ba561e0db042ad69374e83a23ebedf473999394ffb00a1b87fbbaa9767 +size 97650 diff --git a/examples/images/training/target2.png b/examples/images/training/target2.png new file mode 100644 index 0000000000000000000000000000000000000000..ee4e999535d4612690e93f2ecd78cf95be2d4e73 --- /dev/null +++ b/examples/images/training/target2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5291291f3c03a5bbd34c689a645b1a256154012f069f08377771d50ece058908 +size 109425 diff --git a/examples/images/training/target3.png b/examples/images/training/target3.png new file mode 100644 index 0000000000000000000000000000000000000000..f2fd0ee17ea5651edf716b72d1f37e038415bb96 --- /dev/null +++ b/examples/images/training/target3.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ea8ed2a9a34b0c57530eea78f9881175fa02b88340ac452e68ea8fc9ce1be32e +size 102175 diff --git a/examples/images/training/target4.png b/examples/images/training/target4.png new file mode 100644 index 0000000000000000000000000000000000000000..46807d7ef0d1d2fe441c4f28a5cf1a95515de7a6 --- /dev/null +++ b/examples/images/training/target4.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:735e715838e0680bf4b9130017b58a6ac9ccd0ff772e37de407b656dec276aa7 +size 110715 diff --git a/examples/images/training/target5.png b/examples/images/training/target5.png new file mode 100644 index 0000000000000000000000000000000000000000..c5b46eed3b7c4fb5f3062456ceee8aad72c0c385 --- /dev/null +++ b/examples/images/training/target5.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ced78fdaa7e58080ac65465e9d661a0f9f813489acb764e6ff5ac5b939e2f35c +size 105743 diff --git a/examples/images/training/target6.png b/examples/images/training/target6.png new file mode 100644 index 0000000000000000000000000000000000000000..393a8b8ee6a2b4b8c6b10fb90e2090deda2367aa --- /dev/null +++ b/examples/images/training/target6.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:10c3b080101513de3fd0ce458d13ab4789df6c244bcab4d95e01709657641e03 +size 91447 diff --git a/examples/results/result.mp4 b/examples/results/result.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..111f9bdf1782ecef474a8ae2a722dd5258e9a831 --- /dev/null +++ b/examples/results/result.mp4 @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1fa20b1ef39c1dd5bc0d1cf99fa883bf286bbf4b558a62e947ab6814956f77b6 +size 6503571 diff --git a/examples/results/result.png b/examples/results/result.png new file mode 100644 index 0000000000000000000000000000000000000000..10a985db6dacd2ad8e28e82d5e409202d9a01b4c --- /dev/null +++ b/examples/results/result.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:29d32ad8b0a5b158afad58ae4dddb1d3fbba7769d776d24f3c778625447d05f5 +size 828623 diff --git a/examples/results/result_multi.mp4 b/examples/results/result_multi.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..45474dbf64e00df8946b331635cad905324446ad --- /dev/null +++ b/examples/results/result_multi.mp4 @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:bc9d13b47617ad80d0bc4e48ce9962ab9ef7b290f2f5f48b7c6defa4a109bedf +size 6918587 diff --git a/examples/videos/dance.mp4 b/examples/videos/dance.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..b489e034b15c191158606176b8758bd566bd366e --- /dev/null +++ b/examples/videos/dance.mp4 @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4742009e5436e899852db37fa64505e1e0bed93462223fd9c64628174af8e286 +size 943010 diff --git a/examples/videos/dirtydancing.mp4 b/examples/videos/dirtydancing.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..aeae3d8eb5b02fb4128738884a2eb59ba3aaa10e --- /dev/null +++ b/examples/videos/dirtydancing.mp4 @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9e89ef90e90e597a781b9bff228744f2e99c3385803d07806a180624db6e096e +size 3439021 diff --git a/examples/videos/elon.webp b/examples/videos/elon.webp new file mode 100644 index 0000000000000000000000000000000000000000..689ed7437fd17dd5f285646bec19a3af6b1acc4c --- /dev/null +++ b/examples/videos/elon.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1669c3932dc8c248cd0e3030cb551d52b9895622d350ed9467b295de7b9b860c +size 1014424 diff --git a/examples/videos/khabenskii.webp b/examples/videos/khabenskii.webp new file mode 100644 index 0000000000000000000000000000000000000000..74f8ed06acd90b04be57d05a584a748ced46a483 --- /dev/null +++ b/examples/videos/khabenskii.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:fd31c50601367fd6ceb0d157d989edf82bdd7f1046f9e1d60102c1687dded09f +size 1013266 diff --git a/examples/videos/mark.webp b/examples/videos/mark.webp new file mode 100644 index 0000000000000000000000000000000000000000..cb2bf1fa38b70c4f0c8255dbbf12f0bf282247c4 --- /dev/null +++ b/examples/videos/mark.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:46dfcda239f1cc244b6d311b547405c239c9ec21570fa479033f791c4fd092b3 +size 1011872 diff --git a/examples/videos/nggyup.mp4 b/examples/videos/nggyup.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..0448b447b6b336a1ec13995f2ccc9818bd77e2aa --- /dev/null +++ b/examples/videos/nggyup.mp4 @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:aefce9287559017e375eab01f69a1944be7c58ff476dc98e03d8e3d1bf85b952 +size 2374098 diff --git a/examples/videos/orig.webp b/examples/videos/orig.webp new file mode 100644 index 0000000000000000000000000000000000000000..3ff67bd3381813eadc7af4aacc72574a144a9fac --- /dev/null +++ b/examples/videos/orig.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7817a82623e8182595196554e5b9781a2d156396a9445f9178a6efc06d24fc7e +size 1098240 diff --git a/examples/videos/random_gif.gif b/examples/videos/random_gif.gif new file mode 100644 index 0000000000000000000000000000000000000000..5cb944283298a1a402633140febfebcd8be09c3a --- /dev/null +++ b/examples/videos/random_gif.gif @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5e8a8203a8c1190234b675d16a1e004a51a15aa8ddb34b89473f96292a3189dc +size 1403700 diff --git a/inference.py b/inference.py new file mode 100644 index 0000000000000000000000000000000000000000..c3a824c1e9895998cdae56baa93061fe6a499215 --- /dev/null +++ b/inference.py @@ -0,0 +1,153 @@ +import sys +import argparse +import cv2 +import torch +import time +import os + +from utils.inference.image_processing import crop_face, get_final_image +from utils.inference.video_processing import read_video, get_target, get_final_video, add_audio_from_another_video, face_enhancement +from utils.inference.core import model_inference + +from network.AEI_Net import AEI_Net +from coordinate_reg.image_infer import Handler +from insightface_func.face_detect_crop_multi import Face_detect_crop +from arcface_model.iresnet import iresnet100 +from models.pix2pix_model import Pix2PixModel +from models.config_sr import TestOptions + + +def init_models(args): + # model for face cropping + app = Face_detect_crop(name='antelope', root='./insightface_func/models') + app.prepare(ctx_id= 0, det_thresh=0.6, det_size=(640,640)) + + # main model for generation + G = AEI_Net(args.backbone, num_blocks=args.num_blocks, c_id=512) + G.eval() + G.load_state_dict(torch.load(args.G_path, map_location=torch.device('cpu'))) + G = G.cuda() + G = G.half() + + # arcface model to get face embedding + netArc = iresnet100(fp16=False) + netArc.load_state_dict(torch.load('arcface_model/backbone.pth')) + netArc=netArc.cuda() + netArc.eval() + + # model to get face landmarks + handler = Handler('./coordinate_reg/model/2d106det', 0, ctx_id=0, det_size=640) + + # model to make superres of face, set use_sr=True if you want to use super resolution or use_sr=False if you don't + if args.use_sr: + os.environ['CUDA_VISIBLE_DEVICES'] = '0' + torch.backends.cudnn.benchmark = True + opt = TestOptions() + #opt.which_epoch ='10_7' + model = Pix2PixModel(opt) + model.netG.train() + else: + model = None + + return app, G, netArc, handler, model + + +def main(args): + app, G, netArc, handler, model = init_models(args) + + # get crops from source images + print('List of source paths: ',args.source_paths) + source = [] + try: + for source_path in args.source_paths: + img = cv2.imread(source_path) + img = crop_face(img, app, args.crop_size)[0] + source.append(img[:, :, ::-1]) + except TypeError: + print("Bad source images!") + exit() + + # get full frames from video + if not args.image_to_image: + full_frames, fps = read_video(args.target_video) + else: + target_full = cv2.imread(args.target_image) + full_frames = [target_full] + + # get target faces that are used for swap + set_target = True + print('List of target paths: ', args.target_faces_paths) + if not args.target_faces_paths: + target = get_target(full_frames, app, args.crop_size) + set_target = False + else: + target = [] + try: + for target_faces_path in args.target_faces_paths: + img = cv2.imread(target_faces_path) + img = crop_face(img, app, args.crop_size)[0] + target.append(img) + except TypeError: + print("Bad target images!") + exit() + + start = time.time() + final_frames_list, crop_frames_list, full_frames, tfm_array_list = model_inference(full_frames, + source, + target, + netArc, + G, + app, + set_target, + similarity_th=args.similarity_th, + crop_size=args.crop_size, + BS=args.batch_size) + if args.use_sr: + final_frames_list = face_enhancement(final_frames_list, model) + + if not args.image_to_image: + get_final_video(final_frames_list, + crop_frames_list, + full_frames, + tfm_array_list, + args.out_video_name, + fps, + handler) + + add_audio_from_another_video(args.target_video, args.out_video_name, "audio") + print(f"Video saved with path {args.out_video_name}") + else: + result = get_final_image(final_frames_list, crop_frames_list, full_frames[0], tfm_array_list, handler) + cv2.imwrite(args.out_image_name, result) + print(f'Swapped Image saved with path {args.out_image_name}') + + print('Total time: ', time.time()-start) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + + # Generator params + parser.add_argument('--G_path', default='weights/G_unet_2blocks.pth', type=str, help='Path to weights for G') + parser.add_argument('--backbone', default='unet', const='unet', nargs='?', choices=['unet', 'linknet', 'resnet'], help='Backbone for attribute encoder') + parser.add_argument('--num_blocks', default=2, type=int, help='Numbers of AddBlocks at AddResblock') + + parser.add_argument('--batch_size', default=40, type=int) + parser.add_argument('--crop_size', default=224, type=int, help="Don't change this") + parser.add_argument('--use_sr', default=False, type=bool, help='True for super resolution on swap images') + parser.add_argument('--similarity_th', default=0.15, type=float, help='Threshold for selecting a face similar to the target') + + parser.add_argument('--source_paths', default=['examples/images/mark.jpg', 'examples/images/elon_musk.jpg'], nargs='+') + parser.add_argument('--target_faces_paths', default=[], nargs='+', help="It's necessary to set the face/faces in the video to which the source face/faces is swapped. You can skip this parametr, and then any face is selected in the target video for swap.") + + # parameters for image to video + parser.add_argument('--target_video', default='examples/videos/nggyup.mp4', type=str, help="It's necessary for image to video swap") + parser.add_argument('--out_video_name', default='examples/results/result.mp4', type=str, help="It's necessary for image to video swap") + + # parameters for image to image + parser.add_argument('--image_to_image', default=False, type=bool, help='True for image to image swap, False for swap on video') + parser.add_argument('--target_image', default='examples/images/beckham.jpg', type=str, help="It's necessary for image to image swap") + parser.add_argument('--out_image_name', default='examples/results/result.png', type=str,help="It's necessary for image to image swap") + + args = parser.parse_args() + main(args) \ No newline at end of file diff --git a/insightface_func/__init__.py b/insightface_func/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/insightface_func/face_detect_crop_multi.py b/insightface_func/face_detect_crop_multi.py new file mode 100644 index 0000000000000000000000000000000000000000..7b5f5a0ba5ed1c885e077afa7c6c81aa63fc578a --- /dev/null +++ b/insightface_func/face_detect_crop_multi.py @@ -0,0 +1,93 @@ +from __future__ import division +import collections +import numpy as np +import glob +import os +import os.path as osp +import cv2 +from insightface.model_zoo import model_zoo +from insightface.utils import face_align + +__all__ = ['Face_detect_crop', 'Face'] + +Face = collections.namedtuple('Face', [ + 'bbox', 'kps', 'det_score', 'embedding', 'gender', 'age', + 'embedding_norm', 'normed_embedding', + 'landmark' +]) + +Face.__new__.__defaults__ = (None, ) * len(Face._fields) + + +class Face_detect_crop: + def __init__(self, name, root='~/.insightface_func/models'): + self.models = {} + root = os.path.expanduser(root) + onnx_files = glob.glob(osp.join(root, name, '*.onnx')) + onnx_files = sorted(onnx_files) + for onnx_file in onnx_files: + if onnx_file.find('_selfgen_')>0: + #print('ignore:', onnx_file) + continue + model = model_zoo.get_model(onnx_file) + if model.taskname not in self.models: + print('find model:', onnx_file, model.taskname) + self.models[model.taskname] = model + else: + print('duplicated model task type, ignore:', onnx_file, model.taskname) + del model + assert 'detection' in self.models + self.det_model = self.models['detection'] + + + def prepare(self, ctx_id, det_thresh=0.5, det_size=(640, 640)): + self.det_thresh = det_thresh + assert det_size is not None + print('set det-size:', det_size) + self.det_size = det_size + for taskname, model in self.models.items(): + if taskname=='detection': + model.prepare(ctx_id, input_size=det_size) + else: + model.prepare(ctx_id) + + def get(self, img, crop_size, max_num=0): + bboxes, kpss = self.det_model.detect(img, + threshold=self.det_thresh, + max_num=max_num, + metric='default') + if bboxes.shape[0] == 0: + return None + ret = [] + # for i in range(bboxes.shape[0]): + # bbox = bboxes[i, 0:4] + # det_score = bboxes[i, 4] + # kps = None + # if kpss is not None: + # kps = kpss[i] + # M, _ = face_align.estimate_norm(kps, crop_size, mode ='None') + # align_img = cv2.warpAffine(img, M, (crop_size, crop_size), borderValue=0.0) + # align_img_list = [] + # M_list = [] + kps_list = [] + for i in range(bboxes.shape[0]): + kps = None + if kpss is not None: + kps = kpss[i] + # M, _ = face_align.estimate_norm(kps, crop_size, mode ='None') + # align_img = cv2.warpAffine(img, M, (crop_size, crop_size), borderValue=0.0) + # align_img_list.append(align_img) + # M_list.append(M) + kps_list.append(kps) + + # det_score = bboxes[..., 4] + + # best_index = np.argmax(det_score) + + # kps = None + # if kpss is not None: + # kps = kpss[best_index] + # M, _ = face_align.estimate_norm(kps, crop_size, mode ='None') + # align_img = cv2.warpAffine(img, M, (crop_size, crop_size), borderValue=0.0) + + return kps_list diff --git a/insightface_func/face_detect_crop_single.py b/insightface_func/face_detect_crop_single.py new file mode 100644 index 0000000000000000000000000000000000000000..590818613b27980f00c138cd88f0d19ea540ca64 --- /dev/null +++ b/insightface_func/face_detect_crop_single.py @@ -0,0 +1,88 @@ +from __future__ import division +import collections +import numpy as np +import glob +import os +import os.path as osp +import cv2 +from insightface.model_zoo import model_zoo +from insightface.utils import face_align + +__all__ = ['Face_detect_crop', 'Face'] + +Face = collections.namedtuple('Face', [ + 'bbox', 'kps', 'det_score', 'embedding', 'gender', 'age', + 'embedding_norm', 'normed_embedding', + 'landmark' +]) + +Face.__new__.__defaults__ = (None, ) * len(Face._fields) + + +class Face_detect_crop: + def __init__(self, name, root='~/.insightface_func/models'): + self.models = {} + root = os.path.expanduser(root) + onnx_files = glob.glob(osp.join(root, name, '*.onnx')) + onnx_files = sorted(onnx_files) + for onnx_file in onnx_files: + if onnx_file.find('_selfgen_')>0: + #print('ignore:', onnx_file) + continue + model = model_zoo.get_model(onnx_file) + if model.taskname not in self.models: + print('find model:', onnx_file, model.taskname) + self.models[model.taskname] = model + else: + print('duplicated model task type, ignore:', onnx_file, model.taskname) + del model + assert 'detection' in self.models + self.det_model = self.models['detection'] + + + def prepare(self, ctx_id, det_thresh=0.5, det_size=(640, 640)): + self.det_thresh = det_thresh + assert det_size is not None + print('set det-size:', det_size) + self.det_size = det_size + for taskname, model in self.models.items(): + if taskname=='detection': + model.prepare(ctx_id, input_size=det_size) + else: + model.prepare(ctx_id) + + def get(self, img, crop_size, max_num=0): + bboxes, kpss = self.det_model.detect(img, + threshold=self.det_thresh, + max_num=max_num, + metric='default') + if bboxes.shape[0] == 0: + return None + # ret = [] + # for i in range(bboxes.shape[0]): + # bbox = bboxes[i, 0:4] + # det_score = bboxes[i, 4] + # kps = None + # if kpss is not None: + # kps = kpss[i] + # M, _ = face_align.estimate_norm(kps, crop_size, mode ='None') + # align_img = cv2.warpAffine(img, M, (crop_size, crop_size), borderValue=0.0) + # for i in range(bboxes.shape[0]): + # kps = None + # if kpss is not None: + # kps = kpss[i] + # M, _ = face_align.estimate_norm(kps, crop_size, mode ='None') + # align_img = cv2.warpAffine(img, M, (crop_size, crop_size), borderValue=0.0) + + det_score = bboxes[..., 4] + + # select the face with the hightest detection score + best_index = np.argmax(det_score) + + kps = None + if kpss is not None: + kps = kpss[best_index] + M, _ = face_align.estimate_norm(kps, crop_size, mode ='None') + align_img = cv2.warpAffine(img, M, (crop_size, crop_size), borderValue=0.0) + + return [align_img], [M] diff --git a/models/__init__.py b/models/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..8177c38442dea0e8e7e47de05a5e14bb17c8aac6 --- /dev/null +++ b/models/__init__.py @@ -0,0 +1,4 @@ +from .models import ArcMarginModel +from .models import ResNet +from .models import IRBlock +from .models import SEBlock \ No newline at end of file diff --git a/models/config.py b/models/config.py new file mode 100644 index 0000000000000000000000000000000000000000..be79e03b1962d5320b318af9bd54ed7d6148e6c5 --- /dev/null +++ b/models/config.py @@ -0,0 +1,28 @@ +import os + +import torch + +device = torch.device('cuda' if torch.cuda.is_available() else 'cpu') # sets device for model and PyTorch tensors + +# Model parameters +image_w = 112 +image_h = 112 +channel = 3 +emb_size = 512 + +# Training parameters +num_workers = 1 # for data-loading; right now, only 1 works with h5py +grad_clip = 5. # clip gradients at an absolute value of +print_freq = 100 # print training/validation stats every __ batches +checkpoint = None # path to checkpoint, None if none + +# Data parameters +num_classes = 93431 +num_samples = 5179510 +DATA_DIR = 'data' +# faces_ms1m_folder = 'data/faces_ms1m_112x112' +faces_ms1m_folder = 'data/ms1m-retinaface-t1' +path_imgidx = os.path.join(faces_ms1m_folder, 'train.idx') +path_imgrec = os.path.join(faces_ms1m_folder, 'train.rec') +IMG_DIR = 'data/images' +pickle_file = 'data/faces_ms1m_112x112.pickle' diff --git a/models/config_sr.py b/models/config_sr.py new file mode 100644 index 0000000000000000000000000000000000000000..5fa471fe2fdc04981c75b3087d035095e73189f2 --- /dev/null +++ b/models/config_sr.py @@ -0,0 +1,29 @@ +import sys + +class TestOptions(object): + name = 'weights' + results_dir = './results/' + gpu_ids = [0] + crop_size = 256 + dataset_mode = 'test' + which_epoch = '10' + + aspect_ratio = 1.0 + checkpoints_dir = '' + + init_type = 'xavier' + init_variance = 0.02 + isTrain = False + is_test = True + semantic_nc = 3 + + model = 'pix2pix' + netG = 'lipspade' + nef = 16 + ngf = 48 + + norm_G = 'spectralspadesyncbatch3x3' + num_upsampling_layers = 'normal' + phase = 'test' + use_vae = False + z_dim = 256 diff --git a/models/models.py b/models/models.py new file mode 100644 index 0000000000000000000000000000000000000000..91194972e10021535820cb5f25319a0830e9507e --- /dev/null +++ b/models/models.py @@ -0,0 +1,181 @@ +import math +import torch +import torch.nn.functional as F +from torch import nn +from torch.nn import Parameter +from .config import device, num_classes + + +def create_model(opt): + if opt.model == 'pix2pixHD': + #from .pix2pixHD_model import Pix2PixHDModel, InferenceModel + from .fs_model import fsModel + model = fsModel() + else: + from .ui_model import UIModel + model = UIModel() + + model.initialize(opt) + if opt.verbose: + print("model [%s] was created" % (model.name())) + + if opt.isTrain and len(opt.gpu_ids) and not opt.fp16: + model = torch.nn.DataParallel(model, device_ids=opt.gpu_ids) + + return model + + + +class SEBlock(nn.Module): + def __init__(self, channel, reduction=16): + super(SEBlock, self).__init__() + self.avg_pool = nn.AdaptiveAvgPool2d(1) + self.fc = nn.Sequential( + nn.Linear(channel, channel // reduction), + nn.PReLU(), + nn.Linear(channel // reduction, channel), + nn.Sigmoid() + ) + + def forward(self, x): + b, c, _, _ = x.size() + y = self.avg_pool(x).view(b, c) + y = self.fc(y).view(b, c, 1, 1) + return x * y + + +class IRBlock(nn.Module): + expansion = 1 + + def __init__(self, inplanes, planes, stride=1, downsample=None, use_se=True): + super(IRBlock, self).__init__() + self.bn0 = nn.BatchNorm2d(inplanes) + self.conv1 = conv3x3(inplanes, inplanes) + self.bn1 = nn.BatchNorm2d(inplanes) + self.prelu = nn.PReLU() + self.conv2 = conv3x3(inplanes, planes, stride) + self.bn2 = nn.BatchNorm2d(planes) + self.downsample = downsample + self.stride = stride + self.use_se = use_se + if self.use_se: + self.se = SEBlock(planes) + + def forward(self, x): + residual = x + out = self.bn0(x) + out = self.conv1(out) + out = self.bn1(out) + out = self.prelu(out) + + out = self.conv2(out) + out = self.bn2(out) + if self.use_se: + out = self.se(out) + + if self.downsample is not None: + residual = self.downsample(x) + + out += residual + out = self.prelu(out) + + return out + + +class ResNet(nn.Module): + + def __init__(self, block, layers, use_se=True): + self.inplanes = 64 + self.use_se = use_se + super(ResNet, self).__init__() + self.conv1 = nn.Conv2d(3, 64, kernel_size=3, stride=1, bias=False) + self.bn1 = nn.BatchNorm2d(64) + self.prelu = nn.PReLU() + self.maxpool = nn.MaxPool2d(kernel_size=2, stride=2) + self.layer1 = self._make_layer(block, 64, layers[0]) + self.layer2 = self._make_layer(block, 128, layers[1], stride=2) + self.layer3 = self._make_layer(block, 256, layers[2], stride=2) + self.layer4 = self._make_layer(block, 512, layers[3], stride=2) + self.bn2 = nn.BatchNorm2d(512) + self.dropout = nn.Dropout() + self.fc = nn.Linear(512 * 7 * 7, 512) + self.bn3 = nn.BatchNorm1d(512) + + for m in self.modules(): + if isinstance(m, nn.Conv2d): + nn.init.xavier_normal_(m.weight) + elif isinstance(m, nn.BatchNorm2d) or isinstance(m, nn.BatchNorm1d): + nn.init.constant_(m.weight, 1) + nn.init.constant_(m.bias, 0) + elif isinstance(m, nn.Linear): + nn.init.xavier_normal_(m.weight) + nn.init.constant_(m.bias, 0) + + def _make_layer(self, block, planes, blocks, stride=1): + downsample = None + if stride != 1 or self.inplanes != planes * block.expansion: + downsample = nn.Sequential( + nn.Conv2d(self.inplanes, planes * block.expansion, + kernel_size=1, stride=stride, bias=False), + nn.BatchNorm2d(planes * block.expansion), + ) + + layers = [] + layers.append(block(self.inplanes, planes, stride, downsample, use_se=self.use_se)) + self.inplanes = planes + for i in range(1, blocks): + layers.append(block(self.inplanes, planes, use_se=self.use_se)) + + return nn.Sequential(*layers) + + def forward(self, x): + x = self.conv1(x) + x = self.bn1(x) + x = self.prelu(x) + x = self.maxpool(x) + + x = self.layer1(x) + x = self.layer2(x) + x = self.layer3(x) + x = self.layer4(x) + + x = self.bn2(x) + x = self.dropout(x) + x = x.view(x.size(0), -1) + x = self.fc(x) + x = self.bn3(x) + + return x + + +class ArcMarginModel(nn.Module): + def __init__(self, args): + super(ArcMarginModel, self).__init__() + + self.weight = Parameter(torch.FloatTensor(num_classes, args.emb_size)) + nn.init.xavier_uniform_(self.weight) + + self.easy_margin = args.easy_margin + self.m = args.margin_m + self.s = args.margin_s + + self.cos_m = math.cos(self.m) + self.sin_m = math.sin(self.m) + self.th = math.cos(math.pi - self.m) + self.mm = math.sin(math.pi - self.m) * self.m + + def forward(self, input, label): + x = F.normalize(input) + W = F.normalize(self.weight) + cosine = F.linear(x, W) + sine = torch.sqrt(1.0 - torch.pow(cosine, 2)) + phi = cosine * self.cos_m - sine * self.sin_m # cos(theta + m) + if self.easy_margin: + phi = torch.where(cosine > 0, phi, cosine) + else: + phi = torch.where(cosine > self.th, phi, cosine - self.mm) + one_hot = torch.zeros(cosine.size(), device=device) + one_hot.scatter_(1, label.view(-1, 1).long(), 1) + output = (one_hot * phi) + ((1.0 - one_hot) * cosine) + output *= self.s + return output diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/__init__.py b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..a10989fbef38485841fdbd1af72f53062a7b556d --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/__init__.py @@ -0,0 +1,13 @@ +# -*- coding: utf-8 -*- +# File : __init__.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +from .batchnorm import SynchronizedBatchNorm1d, SynchronizedBatchNorm2d, SynchronizedBatchNorm3d +from .batchnorm import patch_sync_batchnorm, convert_model +from .replicate import DataParallelWithCallback, patch_replication_callback diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/batchnorm.py b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/batchnorm.py new file mode 100644 index 0000000000000000000000000000000000000000..24c0950707d07102d06b5fdf64c74a347ec3186c --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/batchnorm.py @@ -0,0 +1,394 @@ +# -*- coding: utf-8 -*- +# File : batchnorm.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import collections +import contextlib + +import torch +import torch.nn.functional as F + +from torch.nn.modules.batchnorm import _BatchNorm + +try: + from torch.nn.parallel._functions import ReduceAddCoalesced, Broadcast +except ImportError: + ReduceAddCoalesced = Broadcast = None + +try: + from jactorch.parallel.comm import SyncMaster + from jactorch.parallel.data_parallel import JacDataParallel as DataParallelWithCallback +except ImportError: + from .comm import SyncMaster + from .replicate import DataParallelWithCallback + +__all__ = [ + 'SynchronizedBatchNorm1d', 'SynchronizedBatchNorm2d', 'SynchronizedBatchNorm3d', + 'patch_sync_batchnorm', 'convert_model' +] + + +def _sum_ft(tensor): + """sum over the first and last dimention""" + return tensor.sum(dim=0).sum(dim=-1) + + +def _unsqueeze_ft(tensor): + """add new dimensions at the front and the tail""" + return tensor.unsqueeze(0).unsqueeze(-1) + + +_ChildMessage = collections.namedtuple('_ChildMessage', ['sum', 'ssum', 'sum_size']) +_MasterMessage = collections.namedtuple('_MasterMessage', ['sum', 'inv_std']) + + +class _SynchronizedBatchNorm(_BatchNorm): + def __init__(self, num_features, eps=1e-5, momentum=0.1, affine=True): + assert ReduceAddCoalesced is not None, 'Can not use Synchronized Batch Normalization without CUDA support.' + + super(_SynchronizedBatchNorm, self).__init__(num_features, eps=eps, momentum=momentum, affine=affine) + + self._sync_master = SyncMaster(self._data_parallel_master) + + self._is_parallel = False + self._parallel_id = None + self._slave_pipe = None + + def forward(self, input): + # If it is not parallel computation or is in evaluation mode, use PyTorch's implementation. + if not (self._is_parallel and self.training): + return F.batch_norm( + input, self.running_mean, self.running_var, self.weight, self.bias, + self.training, self.momentum, self.eps) + + # Resize the input to (B, C, -1). + input_shape = input.size() + input = input.view(input.size(0), self.num_features, -1) + + # Compute the sum and square-sum. + sum_size = input.size(0) * input.size(2) + input_sum = _sum_ft(input) + input_ssum = _sum_ft(input ** 2) + + # Reduce-and-broadcast the statistics. + if self._parallel_id == 0: + mean, inv_std = self._sync_master.run_master(_ChildMessage(input_sum, input_ssum, sum_size)) + else: + mean, inv_std = self._slave_pipe.run_slave(_ChildMessage(input_sum, input_ssum, sum_size)) + + # Compute the output. + if self.affine: + # MJY:: Fuse the multiplication for speed. + output = (input - _unsqueeze_ft(mean)) * _unsqueeze_ft(inv_std * self.weight) + _unsqueeze_ft(self.bias) + else: + output = (input - _unsqueeze_ft(mean)) * _unsqueeze_ft(inv_std) + + # Reshape it. + return output.view(input_shape) + + def __data_parallel_replicate__(self, ctx, copy_id): + self._is_parallel = True + self._parallel_id = copy_id + + # parallel_id == 0 means master device. + if self._parallel_id == 0: + ctx.sync_master = self._sync_master + else: + self._slave_pipe = ctx.sync_master.register_slave(copy_id) + + def _data_parallel_master(self, intermediates): + """Reduce the sum and square-sum, compute the statistics, and broadcast it.""" + + # Always using same "device order" makes the ReduceAdd operation faster. + # Thanks to:: Tete Xiao (http://tetexiao.com/) + intermediates = sorted(intermediates, key=lambda i: i[1].sum.get_device()) + + to_reduce = [i[1][:2] for i in intermediates] + to_reduce = [j for i in to_reduce for j in i] # flatten + target_gpus = [i[1].sum.get_device() for i in intermediates] + + sum_size = sum([i[1].sum_size for i in intermediates]) + sum_, ssum = ReduceAddCoalesced.apply(target_gpus[0], 2, *to_reduce) + mean, inv_std = self._compute_mean_std(sum_, ssum, sum_size) + + broadcasted = Broadcast.apply(target_gpus, mean, inv_std) + + outputs = [] + for i, rec in enumerate(intermediates): + outputs.append((rec[0], _MasterMessage(*broadcasted[i*2:i*2+2]))) + + return outputs + + def _compute_mean_std(self, sum_, ssum, size): + """Compute the mean and standard-deviation with sum and square-sum. This method + also maintains the moving average on the master device.""" + assert size > 1, 'BatchNorm computes unbiased standard-deviation, which requires size > 1.' + mean = sum_ / size + sumvar = ssum - sum_ * mean + unbias_var = sumvar / (size - 1) + bias_var = sumvar / size + + if hasattr(torch, 'no_grad'): + with torch.no_grad(): + self.running_mean = (1 - self.momentum) * self.running_mean + self.momentum * mean.data + self.running_var = (1 - self.momentum) * self.running_var + self.momentum * unbias_var.data + else: + self.running_mean = (1 - self.momentum) * self.running_mean + self.momentum * mean.data + self.running_var = (1 - self.momentum) * self.running_var + self.momentum * unbias_var.data + + return mean, bias_var.clamp(self.eps) ** -0.5 + + +class SynchronizedBatchNorm1d(_SynchronizedBatchNorm): + r"""Applies Synchronized Batch Normalization over a 2d or 3d input that is seen as a + mini-batch. + + .. math:: + + y = \frac{x - mean[x]}{ \sqrt{Var[x] + \epsilon}} * gamma + beta + + This module differs from the built-in PyTorch BatchNorm1d as the mean and + standard-deviation are reduced across all devices during training. + + For example, when one uses `nn.DataParallel` to wrap the network during + training, PyTorch's implementation normalize the tensor on each device using + the statistics only on that device, which accelerated the computation and + is also easy to implement, but the statistics might be inaccurate. + Instead, in this synchronized version, the statistics will be computed + over all training samples distributed on multiple devices. + + Note that, for one-GPU or CPU-only case, this module behaves exactly same + as the built-in PyTorch implementation. + + The mean and standard-deviation are calculated per-dimension over + the mini-batches and gamma and beta are learnable parameter vectors + of size C (where C is the input size). + + During training, this layer keeps a running estimate of its computed mean + and variance. The running sum is kept with a default momentum of 0.1. + + During evaluation, this running mean/variance is used for normalization. + + Because the BatchNorm is done over the `C` dimension, computing statistics + on `(N, L)` slices, it's common terminology to call this Temporal BatchNorm + + Args: + num_features: num_features from an expected input of size + `batch_size x num_features [x width]` + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Default: 0.1 + affine: a boolean value that when set to ``True``, gives the layer learnable + affine parameters. Default: ``True`` + + Shape:: + - Input: :math:`(N, C)` or :math:`(N, C, L)` + - Output: :math:`(N, C)` or :math:`(N, C, L)` (same shape as input) + + Examples: + >>> # With Learnable Parameters + >>> m = SynchronizedBatchNorm1d(100) + >>> # Without Learnable Parameters + >>> m = SynchronizedBatchNorm1d(100, affine=False) + >>> input = torch.autograd.Variable(torch.randn(20, 100)) + >>> output = m(input) + """ + + def _check_input_dim(self, input): + if input.dim() != 2 and input.dim() != 3: + raise ValueError('expected 2D or 3D input (got {}D input)' + .format(input.dim())) + super(SynchronizedBatchNorm1d, self)._check_input_dim(input) + + +class SynchronizedBatchNorm2d(_SynchronizedBatchNorm): + r"""Applies Batch Normalization over a 4d input that is seen as a mini-batch + of 3d inputs + + .. math:: + + y = \frac{x - mean[x]}{ \sqrt{Var[x] + \epsilon}} * gamma + beta + + This module differs from the built-in PyTorch BatchNorm2d as the mean and + standard-deviation are reduced across all devices during training. + + For example, when one uses `nn.DataParallel` to wrap the network during + training, PyTorch's implementation normalize the tensor on each device using + the statistics only on that device, which accelerated the computation and + is also easy to implement, but the statistics might be inaccurate. + Instead, in this synchronized version, the statistics will be computed + over all training samples distributed on multiple devices. + + Note that, for one-GPU or CPU-only case, this module behaves exactly same + as the built-in PyTorch implementation. + + The mean and standard-deviation are calculated per-dimension over + the mini-batches and gamma and beta are learnable parameter vectors + of size C (where C is the input size). + + During training, this layer keeps a running estimate of its computed mean + and variance. The running sum is kept with a default momentum of 0.1. + + During evaluation, this running mean/variance is used for normalization. + + Because the BatchNorm is done over the `C` dimension, computing statistics + on `(N, H, W)` slices, it's common terminology to call this Spatial BatchNorm + + Args: + num_features: num_features from an expected input of + size batch_size x num_features x height x width + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Default: 0.1 + affine: a boolean value that when set to ``True``, gives the layer learnable + affine parameters. Default: ``True`` + + Shape:: + - Input: :math:`(N, C, H, W)` + - Output: :math:`(N, C, H, W)` (same shape as input) + + Examples: + >>> # With Learnable Parameters + >>> m = SynchronizedBatchNorm2d(100) + >>> # Without Learnable Parameters + >>> m = SynchronizedBatchNorm2d(100, affine=False) + >>> input = torch.autograd.Variable(torch.randn(20, 100, 35, 45)) + >>> output = m(input) + """ + + def _check_input_dim(self, input): + if input.dim() != 4: + raise ValueError('expected 4D input (got {}D input)' + .format(input.dim())) + super(SynchronizedBatchNorm2d, self)._check_input_dim(input) + + +class SynchronizedBatchNorm3d(_SynchronizedBatchNorm): + r"""Applies Batch Normalization over a 5d input that is seen as a mini-batch + of 4d inputs + + .. math:: + + y = \frac{x - mean[x]}{ \sqrt{Var[x] + \epsilon}} * gamma + beta + + This module differs from the built-in PyTorch BatchNorm3d as the mean and + standard-deviation are reduced across all devices during training. + + For example, when one uses `nn.DataParallel` to wrap the network during + training, PyTorch's implementation normalize the tensor on each device using + the statistics only on that device, which accelerated the computation and + is also easy to implement, but the statistics might be inaccurate. + Instead, in this synchronized version, the statistics will be computed + over all training samples distributed on multiple devices. + + Note that, for one-GPU or CPU-only case, this module behaves exactly same + as the built-in PyTorch implementation. + + The mean and standard-deviation are calculated per-dimension over + the mini-batches and gamma and beta are learnable parameter vectors + of size C (where C is the input size). + + During training, this layer keeps a running estimate of its computed mean + and variance. The running sum is kept with a default momentum of 0.1. + + During evaluation, this running mean/variance is used for normalization. + + Because the BatchNorm is done over the `C` dimension, computing statistics + on `(N, D, H, W)` slices, it's common terminology to call this Volumetric BatchNorm + or Spatio-temporal BatchNorm + + Args: + num_features: num_features from an expected input of + size batch_size x num_features x depth x height x width + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Default: 0.1 + affine: a boolean value that when set to ``True``, gives the layer learnable + affine parameters. Default: ``True`` + + Shape:: + - Input: :math:`(N, C, D, H, W)` + - Output: :math:`(N, C, D, H, W)` (same shape as input) + + Examples: + >>> # With Learnable Parameters + >>> m = SynchronizedBatchNorm3d(100) + >>> # Without Learnable Parameters + >>> m = SynchronizedBatchNorm3d(100, affine=False) + >>> input = torch.autograd.Variable(torch.randn(20, 100, 35, 45, 10)) + >>> output = m(input) + """ + + def _check_input_dim(self, input): + if input.dim() != 5: + raise ValueError('expected 5D input (got {}D input)' + .format(input.dim())) + super(SynchronizedBatchNorm3d, self)._check_input_dim(input) + + +@contextlib.contextmanager +def patch_sync_batchnorm(): + import torch.nn as nn + + backup = nn.BatchNorm1d, nn.BatchNorm2d, nn.BatchNorm3d + + nn.BatchNorm1d = SynchronizedBatchNorm1d + nn.BatchNorm2d = SynchronizedBatchNorm2d + nn.BatchNorm3d = SynchronizedBatchNorm3d + + yield + + nn.BatchNorm1d, nn.BatchNorm2d, nn.BatchNorm3d = backup + + +def convert_model(module): + """Traverse the input module and its child recursively + and replace all instance of torch.nn.modules.batchnorm.BatchNorm*N*d + to SynchronizedBatchNorm*N*d + + Args: + module: the input module needs to be convert to SyncBN model + + Examples: + >>> import torch.nn as nn + >>> import torchvision + >>> # m is a standard pytorch model + >>> m = torchvision.models.resnet18(True) + >>> m = nn.DataParallel(m) + >>> # after convert, m is using SyncBN + >>> m = convert_model(m) + """ + if isinstance(module, torch.nn.DataParallel): + mod = module.module + mod = convert_model(mod) + mod = DataParallelWithCallback(mod) + return mod + + mod = module + for pth_module, sync_module in zip([torch.nn.modules.batchnorm.BatchNorm1d, + torch.nn.modules.batchnorm.BatchNorm2d, + torch.nn.modules.batchnorm.BatchNorm3d], + [SynchronizedBatchNorm1d, + SynchronizedBatchNorm2d, + SynchronizedBatchNorm3d]): + if isinstance(module, pth_module): + mod = sync_module(module.num_features, module.eps, module.momentum, module.affine) + mod.running_mean = module.running_mean + mod.running_var = module.running_var + if module.affine: + mod.weight.data = module.weight.data.clone().detach() + mod.bias.data = module.bias.data.clone().detach() + + for name, child in module.named_children(): + mod.add_module(name, convert_model(child)) + + return mod diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/batchnorm_reimpl.py b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/batchnorm_reimpl.py new file mode 100644 index 0000000000000000000000000000000000000000..18145c3353e13d482c492ae46df91a537669fca0 --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/batchnorm_reimpl.py @@ -0,0 +1,74 @@ +#! /usr/bin/env python3 +# -*- coding: utf-8 -*- +# File : batchnorm_reimpl.py +# Author : acgtyrant +# Date : 11/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import torch +import torch.nn as nn +import torch.nn.init as init + +__all__ = ['BatchNorm2dReimpl'] + + +class BatchNorm2dReimpl(nn.Module): + """ + A re-implementation of batch normalization, used for testing the numerical + stability. + + Author: acgtyrant + See also: + https://github.com/vacancy/Synchronized-BatchNorm-PyTorch/issues/14 + """ + def __init__(self, num_features, eps=1e-5, momentum=0.1): + super().__init__() + + self.num_features = num_features + self.eps = eps + self.momentum = momentum + self.weight = nn.Parameter(torch.empty(num_features)) + self.bias = nn.Parameter(torch.empty(num_features)) + self.register_buffer('running_mean', torch.zeros(num_features)) + self.register_buffer('running_var', torch.ones(num_features)) + self.reset_parameters() + + def reset_running_stats(self): + self.running_mean.zero_() + self.running_var.fill_(1) + + def reset_parameters(self): + self.reset_running_stats() + init.uniform_(self.weight) + init.zeros_(self.bias) + + def forward(self, input_): + batchsize, channels, height, width = input_.size() + numel = batchsize * height * width + input_ = input_.permute(1, 0, 2, 3).contiguous().view(channels, numel) + sum_ = input_.sum(1) + sum_of_square = input_.pow(2).sum(1) + mean = sum_ / numel + sumvar = sum_of_square - sum_ * mean + + self.running_mean = ( + (1 - self.momentum) * self.running_mean + + self.momentum * mean.detach() + ) + unbias_var = sumvar / (numel - 1) + self.running_var = ( + (1 - self.momentum) * self.running_var + + self.momentum * unbias_var.detach() + ) + + bias_var = sumvar / numel + inv_std = 1 / (bias_var + self.eps).pow(0.5) + output = ( + (input_ - mean.unsqueeze(1)) * inv_std.unsqueeze(1) * + self.weight.unsqueeze(1) + self.bias.unsqueeze(1)) + + return output.view(channels, batchsize, height, width).permute(1, 0, 2, 3).contiguous() + diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/comm.py b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/comm.py new file mode 100644 index 0000000000000000000000000000000000000000..922f8c4a3adaa9b32fdcaef09583be03b0d7eb2b --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/comm.py @@ -0,0 +1,137 @@ +# -*- coding: utf-8 -*- +# File : comm.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import queue +import collections +import threading + +__all__ = ['FutureResult', 'SlavePipe', 'SyncMaster'] + + +class FutureResult(object): + """A thread-safe future implementation. Used only as one-to-one pipe.""" + + def __init__(self): + self._result = None + self._lock = threading.Lock() + self._cond = threading.Condition(self._lock) + + def put(self, result): + with self._lock: + assert self._result is None, 'Previous result has\'t been fetched.' + self._result = result + self._cond.notify() + + def get(self): + with self._lock: + if self._result is None: + self._cond.wait() + + res = self._result + self._result = None + return res + + +_MasterRegistry = collections.namedtuple('MasterRegistry', ['result']) +_SlavePipeBase = collections.namedtuple('_SlavePipeBase', ['identifier', 'queue', 'result']) + + +class SlavePipe(_SlavePipeBase): + """Pipe for master-slave communication.""" + + def run_slave(self, msg): + self.queue.put((self.identifier, msg)) + ret = self.result.get() + self.queue.put(True) + return ret + + +class SyncMaster(object): + """An abstract `SyncMaster` object. + + - During the replication, as the data parallel will trigger an callback of each module, all slave devices should + call `register(id)` and obtain an `SlavePipe` to communicate with the master. + - During the forward pass, master device invokes `run_master`, all messages from slave devices will be collected, + and passed to a registered callback. + - After receiving the messages, the master device should gather the information and determine to message passed + back to each slave devices. + """ + + def __init__(self, master_callback): + """ + + Args: + master_callback: a callback to be invoked after having collected messages from slave devices. + """ + self._master_callback = master_callback + self._queue = queue.Queue() + self._registry = collections.OrderedDict() + self._activated = False + + def __getstate__(self): + return {'master_callback': self._master_callback} + + def __setstate__(self, state): + self.__init__(state['master_callback']) + + def register_slave(self, identifier): + """ + Register an slave device. + + Args: + identifier: an identifier, usually is the device id. + + Returns: a `SlavePipe` object which can be used to communicate with the master device. + + """ + if self._activated: + assert self._queue.empty(), 'Queue is not clean before next initialization.' + self._activated = False + self._registry.clear() + future = FutureResult() + self._registry[identifier] = _MasterRegistry(future) + return SlavePipe(identifier, self._queue, future) + + def run_master(self, master_msg): + """ + Main entry for the master device in each forward pass. + The messages were first collected from each devices (including the master device), and then + an callback will be invoked to compute the message to be sent back to each devices + (including the master device). + + Args: + master_msg: the message that the master want to send to itself. This will be placed as the first + message when calling `master_callback`. For detailed usage, see `_SynchronizedBatchNorm` for an example. + + Returns: the message to be sent back to the master device. + + """ + self._activated = True + + intermediates = [(0, master_msg)] + for i in range(self.nr_slaves): + intermediates.append(self._queue.get()) + + results = self._master_callback(intermediates) + assert results[0][0] == 0, 'The first result should belongs to the master.' + + for i, res in results: + if i == 0: + continue + self._registry[i].result.put(res) + + for i in range(self.nr_slaves): + assert self._queue.get() is True + + return results[0][1] + + @property + def nr_slaves(self): + return len(self._registry) diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/replicate.py b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/replicate.py new file mode 100644 index 0000000000000000000000000000000000000000..b71c7b8ed51a1d6c55b1f753bdd8d90bad79bd06 --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/replicate.py @@ -0,0 +1,94 @@ +# -*- coding: utf-8 -*- +# File : replicate.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import functools + +from torch.nn.parallel.data_parallel import DataParallel + +__all__ = [ + 'CallbackContext', + 'execute_replication_callbacks', + 'DataParallelWithCallback', + 'patch_replication_callback' +] + + +class CallbackContext(object): + pass + + +def execute_replication_callbacks(modules): + """ + Execute an replication callback `__data_parallel_replicate__` on each module created by original replication. + + The callback will be invoked with arguments `__data_parallel_replicate__(ctx, copy_id)` + + Note that, as all modules are isomorphism, we assign each sub-module with a context + (shared among multiple copies of this module on different devices). + Through this context, different copies can share some information. + + We guarantee that the callback on the master copy (the first copy) will be called ahead of calling the callback + of any slave copies. + """ + master_copy = modules[0] + nr_modules = len(list(master_copy.modules())) + ctxs = [CallbackContext() for _ in range(nr_modules)] + + for i, module in enumerate(modules): + for j, m in enumerate(module.modules()): + if hasattr(m, '__data_parallel_replicate__'): + m.__data_parallel_replicate__(ctxs[j], i) + + +class DataParallelWithCallback(DataParallel): + """ + Data Parallel with a replication callback. + + An replication callback `__data_parallel_replicate__` of each module will be invoked after being created by + original `replicate` function. + The callback will be invoked with arguments `__data_parallel_replicate__(ctx, copy_id)` + + Examples: + > sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + > sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + # sync_bn.__data_parallel_replicate__ will be invoked. + """ + + def replicate(self, module, device_ids): + modules = super(DataParallelWithCallback, self).replicate(module, device_ids) + execute_replication_callbacks(modules) + return modules + + +def patch_replication_callback(data_parallel): + """ + Monkey-patch an existing `DataParallel` object. Add the replication callback. + Useful when you have customized `DataParallel` implementation. + + Examples: + > sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + > sync_bn = DataParallel(sync_bn, device_ids=[0, 1]) + > patch_replication_callback(sync_bn) + # this is equivalent to + > sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + > sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + """ + + assert isinstance(data_parallel, DataParallel) + + old_replicate = data_parallel.replicate + + @functools.wraps(old_replicate) + def new_replicate(module, device_ids): + modules = old_replicate(module, device_ids) + execute_replication_callbacks(modules) + return modules + + data_parallel.replicate = new_replicate diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/unittest.py b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/unittest.py new file mode 100644 index 0000000000000000000000000000000000000000..bed56f1caa929ac3e9a57c583f8d3e42624f58be --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/sync_batchnorm/unittest.py @@ -0,0 +1,29 @@ +# -*- coding: utf-8 -*- +# File : unittest.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import unittest +import torch + + +class TorchTestCase(unittest.TestCase): + def assertTensorClose(self, x, y): + adiff = float((x - y).abs().max()) + if (y == 0).all(): + rdiff = 'NaN' + else: + rdiff = float((adiff / y).abs().max()) + + message = ( + 'Tensor close check failed\n' + 'adiff={}\n' + 'rdiff={}\n' + ).format(adiff, rdiff) + self.assertTrue(torch.allclose(x, y), message) + diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_numeric_batchnorm.py b/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_numeric_batchnorm.py new file mode 100644 index 0000000000000000000000000000000000000000..63661389782806ea2182c049448df5d05fc6d2f1 --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_numeric_batchnorm.py @@ -0,0 +1,56 @@ +# -*- coding: utf-8 -*- +# File : test_numeric_batchnorm.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. + +import unittest + +import torch +import torch.nn as nn +from torch.autograd import Variable + +from sync_batchnorm.unittest import TorchTestCase + + +def handy_var(a, unbias=True): + n = a.size(0) + asum = a.sum(dim=0) + as_sum = (a ** 2).sum(dim=0) # a square sum + sumvar = as_sum - asum * asum / n + if unbias: + return sumvar / (n - 1) + else: + return sumvar / n + + +class NumericTestCase(TorchTestCase): + def testNumericBatchNorm(self): + a = torch.rand(16, 10) + bn = nn.BatchNorm1d(10, momentum=1, eps=1e-5, affine=False) + bn.train() + + a_var1 = Variable(a, requires_grad=True) + b_var1 = bn(a_var1) + loss1 = b_var1.sum() + loss1.backward() + + a_var2 = Variable(a, requires_grad=True) + a_mean2 = a_var2.mean(dim=0, keepdim=True) + a_std2 = torch.sqrt(handy_var(a_var2, unbias=False).clamp(min=1e-5)) + # a_std2 = torch.sqrt(a_var2.var(dim=0, keepdim=True, unbiased=False) + 1e-5) + b_var2 = (a_var2 - a_mean2) / a_std2 + loss2 = b_var2.sum() + loss2.backward() + + self.assertTensorClose(bn.running_mean, a.mean(dim=0)) + self.assertTensorClose(bn.running_var, handy_var(a)) + self.assertTensorClose(a_var1.data, a_var2.data) + self.assertTensorClose(b_var1.data, b_var2.data) + self.assertTensorClose(a_var1.grad, a_var2.grad) + + +if __name__ == '__main__': + unittest.main() diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_numeric_batchnorm_v2.py b/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_numeric_batchnorm_v2.py new file mode 100644 index 0000000000000000000000000000000000000000..5e4538ae3c50b4c457a9fa19bf22b5b1a7b666ee --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_numeric_batchnorm_v2.py @@ -0,0 +1,62 @@ +#! /usr/bin/env python3 +# -*- coding: utf-8 -*- +# File : test_numeric_batchnorm_v2.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 11/01/2018 +# +# Distributed under terms of the MIT license. + +""" +Test the numerical implementation of batch normalization. + +Author: acgtyrant. +See also: https://github.com/vacancy/Synchronized-BatchNorm-PyTorch/issues/14 +""" + +import unittest + +import torch +import torch.nn as nn +import torch.optim as optim + +from sync_batchnorm.unittest import TorchTestCase +from sync_batchnorm.batchnorm_reimpl import BatchNorm2dReimpl + + +class NumericTestCasev2(TorchTestCase): + def testNumericBatchNorm(self): + CHANNELS = 16 + batchnorm1 = nn.BatchNorm2d(CHANNELS, momentum=1) + optimizer1 = optim.SGD(batchnorm1.parameters(), lr=0.01) + + batchnorm2 = BatchNorm2dReimpl(CHANNELS, momentum=1) + batchnorm2.weight.data.copy_(batchnorm1.weight.data) + batchnorm2.bias.data.copy_(batchnorm1.bias.data) + optimizer2 = optim.SGD(batchnorm2.parameters(), lr=0.01) + + for _ in range(100): + input_ = torch.rand(16, CHANNELS, 16, 16) + + input1 = input_.clone().requires_grad_(True) + output1 = batchnorm1(input1) + output1.sum().backward() + optimizer1.step() + + input2 = input_.clone().requires_grad_(True) + output2 = batchnorm2(input2) + output2.sum().backward() + optimizer2.step() + + self.assertTensorClose(input1, input2) + self.assertTensorClose(output1, output2) + self.assertTensorClose(input1.grad, input2.grad) + self.assertTensorClose(batchnorm1.weight.grad, batchnorm2.weight.grad) + self.assertTensorClose(batchnorm1.bias.grad, batchnorm2.bias.grad) + self.assertTensorClose(batchnorm1.running_mean, batchnorm2.running_mean) + self.assertTensorClose(batchnorm2.running_mean, batchnorm2.running_mean) + + +if __name__ == '__main__': + unittest.main() + diff --git a/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_sync_batchnorm.py b/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_sync_batchnorm.py new file mode 100644 index 0000000000000000000000000000000000000000..45bb3c8cfd36d8f668e6fde756b17587eab72082 --- /dev/null +++ b/models/networks/Synchronized-BatchNorm-PyTorch/tests/test_sync_batchnorm.py @@ -0,0 +1,111 @@ +# -*- coding: utf-8 -*- +# File : test_sync_batchnorm.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. + +import unittest + +import torch +import torch.nn as nn +from torch.autograd import Variable + +from sync_batchnorm import SynchronizedBatchNorm1d, SynchronizedBatchNorm2d, DataParallelWithCallback +from sync_batchnorm.unittest import TorchTestCase + + +def handy_var(a, unbias=True): + n = a.size(0) + asum = a.sum(dim=0) + as_sum = (a ** 2).sum(dim=0) # a square sum + sumvar = as_sum - asum * asum / n + if unbias: + return sumvar / (n - 1) + else: + return sumvar / n + + +def _find_bn(module): + for m in module.modules(): + if isinstance(m, (nn.BatchNorm1d, nn.BatchNorm2d, SynchronizedBatchNorm1d, SynchronizedBatchNorm2d)): + return m + + +class SyncTestCase(TorchTestCase): + def _syncParameters(self, bn1, bn2): + bn1.reset_parameters() + bn2.reset_parameters() + if bn1.affine and bn2.affine: + bn2.weight.data.copy_(bn1.weight.data) + bn2.bias.data.copy_(bn1.bias.data) + + def _checkBatchNormResult(self, bn1, bn2, input, is_train, cuda=False): + """Check the forward and backward for the customized batch normalization.""" + bn1.train(mode=is_train) + bn2.train(mode=is_train) + + if cuda: + input = input.cuda() + + self._syncParameters(_find_bn(bn1), _find_bn(bn2)) + + input1 = Variable(input, requires_grad=True) + output1 = bn1(input1) + output1.sum().backward() + input2 = Variable(input, requires_grad=True) + output2 = bn2(input2) + output2.sum().backward() + + self.assertTensorClose(input1.data, input2.data) + self.assertTensorClose(output1.data, output2.data) + self.assertTensorClose(input1.grad, input2.grad) + self.assertTensorClose(_find_bn(bn1).running_mean, _find_bn(bn2).running_mean) + self.assertTensorClose(_find_bn(bn1).running_var, _find_bn(bn2).running_var) + + def testSyncBatchNormNormalTrain(self): + bn = nn.BatchNorm1d(10) + sync_bn = SynchronizedBatchNorm1d(10) + + self._checkBatchNormResult(bn, sync_bn, torch.rand(16, 10), True) + + def testSyncBatchNormNormalEval(self): + bn = nn.BatchNorm1d(10) + sync_bn = SynchronizedBatchNorm1d(10) + + self._checkBatchNormResult(bn, sync_bn, torch.rand(16, 10), False) + + def testSyncBatchNormSyncTrain(self): + bn = nn.BatchNorm1d(10, eps=1e-5, affine=False) + sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + + bn.cuda() + sync_bn.cuda() + + self._checkBatchNormResult(bn, sync_bn, torch.rand(16, 10), True, cuda=True) + + def testSyncBatchNormSyncEval(self): + bn = nn.BatchNorm1d(10, eps=1e-5, affine=False) + sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + + bn.cuda() + sync_bn.cuda() + + self._checkBatchNormResult(bn, sync_bn, torch.rand(16, 10), False, cuda=True) + + def testSyncBatchNorm2DSyncTrain(self): + bn = nn.BatchNorm2d(10) + sync_bn = SynchronizedBatchNorm2d(10) + sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + + bn.cuda() + sync_bn.cuda() + + self._checkBatchNormResult(bn, sync_bn, torch.rand(16, 10, 16, 16), True, cuda=True) + + +if __name__ == '__main__': + unittest.main() diff --git a/models/networks/__init__.py b/models/networks/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..4526971a61633e9bc8cab79a807e9e208ce7e353 --- /dev/null +++ b/models/networks/__init__.py @@ -0,0 +1,63 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch +from models.networks.base_network import BaseNetwork +from models.networks.loss import * +from models.networks.discriminator import * +from models.networks.generator import * +from models.networks.encoder import * +import utils.inference.util as util + + +def find_network_using_name(target_network_name, filename): + target_class_name = target_network_name + filename + module_name = 'models.networks.' + filename + network = util.find_class_in_module(target_class_name, module_name) + + assert issubclass(network, BaseNetwork), \ + "Class %s should be a subclass of BaseNetwork" % network + + return network + + +def modify_commandline_options(parser, is_train): + opt, _ = parser.parse_known_args() + + netG_cls = find_network_using_name(opt.netG, 'generator') + parser = netG_cls.modify_commandline_options(parser, is_train) + if is_train: + netD_cls = find_network_using_name(opt.netD, 'discriminator') + parser = netD_cls.modify_commandline_options(parser, is_train) + netE_cls = find_network_using_name('conv', 'encoder') + parser = netE_cls.modify_commandline_options(parser, is_train) + + return parser + + +def create_network(cls, opt): + net = cls(opt) + net.print_network() + if len(opt.gpu_ids) > 0: + assert(torch.cuda.is_available()) + net.cuda() + net.init_weights(opt.init_type, opt.init_variance) + return net + + +def define_G(opt): + netG_cls = find_network_using_name(opt.netG, 'generator') + return create_network(netG_cls, opt) + + +def define_D(opt): + netD_cls = find_network_using_name(opt.netD, 'discriminator') + return create_network(netD_cls, opt) + + +def define_E(opt): + # there exists only one encoder type + netE_cls = find_network_using_name('conv', 'encoder') + return create_network(netE_cls, opt) diff --git a/models/networks/architecture.py b/models/networks/architecture.py new file mode 100644 index 0000000000000000000000000000000000000000..2fb93b43e15d2356c6b7f5e38a6cd0726eb3417e --- /dev/null +++ b/models/networks/architecture.py @@ -0,0 +1,125 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch +import torch.nn as nn +import torch.nn.functional as F +import torchvision +import torch.nn.utils.spectral_norm as spectral_norm +from models.networks.normalization import SPADE + + +# ResNet block that uses SPADE. +# It differs from the ResNet block of pix2pixHD in that +# it takes in the segmentation map as input, learns the skip connection if necessary, +# and applies normalization first and then convolution. +# This architecture seemed like a standard architecture for unconditional or +# class-conditional GAN architecture using residual block. +# The code was inspired from https://github.com/LMescheder/GAN_stability. +class SPADEResnetBlock(nn.Module): + def __init__(self, fin, fout, opt, semantic_nc=None): + super().__init__() + # Attributes + self.learned_shortcut = (fin != fout) + fmiddle = min(fin, fout) + if semantic_nc is None: + semantic_nc = opt.semantic_nc + + # create conv layers + self.conv_0 = nn.Conv2d(fin, fmiddle, kernel_size=3, padding=1) + self.conv_1 = nn.Conv2d(fmiddle, fout, kernel_size=3, padding=1) + if self.learned_shortcut: + self.conv_s = nn.Conv2d(fin, fout, kernel_size=1, bias=False) + + # apply spectral norm if specified + if 'spectral' in opt.norm_G: + self.conv_0 = spectral_norm(self.conv_0) + self.conv_1 = spectral_norm(self.conv_1) + if self.learned_shortcut: + self.conv_s = spectral_norm(self.conv_s) + + # define normalization layers + spade_config_str = opt.norm_G.replace('spectral', '') + self.norm_0 = SPADE(spade_config_str, fin, semantic_nc) + self.norm_1 = SPADE(spade_config_str, fmiddle, semantic_nc) + if self.learned_shortcut: + self.norm_s = SPADE(spade_config_str, fin, semantic_nc) + + # note the resnet block with SPADE also takes in |seg|, + # the semantic segmentation map as input + def forward(self, x, seg): + x_s = self.shortcut(x, seg) + + dx = self.conv_0(self.actvn(self.norm_0(x, seg))) + dx = self.conv_1(self.actvn(self.norm_1(dx, seg))) + + out = x_s + dx + + return out + + def shortcut(self, x, seg): + if self.learned_shortcut: + x_s = self.conv_s(self.norm_s(x, seg)) + else: + x_s = x + return x_s + + def actvn(self, x): + return F.leaky_relu(x, 2e-1) + + +# ResNet block used in pix2pixHD +# We keep the same architecture as pix2pixHD. +class ResnetBlock(nn.Module): + def __init__(self, dim, norm_layer, activation=nn.ReLU(False), kernel_size=3): + super().__init__() + + pw = (kernel_size - 1) // 2 + self.conv_block = nn.Sequential( + nn.ReflectionPad2d(pw), + norm_layer(nn.Conv2d(dim, dim, kernel_size=kernel_size)), + activation, + nn.ReflectionPad2d(pw), + norm_layer(nn.Conv2d(dim, dim, kernel_size=kernel_size)) + ) + + def forward(self, x): + y = self.conv_block(x) + out = x + y + return out + + +# VGG architecter, used for the perceptual loss using a pretrained VGG network +class VGG19(torch.nn.Module): + def __init__(self, requires_grad=False): + super().__init__() + vgg_pretrained_features = torchvision.models.vgg19(pretrained=True).features + self.slice1 = torch.nn.Sequential() + self.slice2 = torch.nn.Sequential() + self.slice3 = torch.nn.Sequential() + self.slice4 = torch.nn.Sequential() + self.slice5 = torch.nn.Sequential() + for x in range(2): + self.slice1.add_module(str(x), vgg_pretrained_features[x]) + for x in range(2, 7): + self.slice2.add_module(str(x), vgg_pretrained_features[x]) + for x in range(7, 12): + self.slice3.add_module(str(x), vgg_pretrained_features[x]) + for x in range(12, 21): + self.slice4.add_module(str(x), vgg_pretrained_features[x]) + for x in range(21, 30): + self.slice5.add_module(str(x), vgg_pretrained_features[x]) + if not requires_grad: + for param in self.parameters(): + param.requires_grad = False + + def forward(self, X): + h_relu1 = self.slice1(X) + h_relu2 = self.slice2(h_relu1) + h_relu3 = self.slice3(h_relu2) + h_relu4 = self.slice4(h_relu3) + h_relu5 = self.slice5(h_relu4) + out = [h_relu1, h_relu2, h_relu3, h_relu4, h_relu5] + return out diff --git a/models/networks/base_network.py b/models/networks/base_network.py new file mode 100644 index 0000000000000000000000000000000000000000..f79189f3c4c9b0032ea5e8ec28c8915a9112a754 --- /dev/null +++ b/models/networks/base_network.py @@ -0,0 +1,59 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch.nn as nn +from torch.nn import init + + +class BaseNetwork(nn.Module): + def __init__(self): + super(BaseNetwork, self).__init__() + + @staticmethod + def modify_commandline_options(parser, is_train): + return parser + + def print_network(self): + if isinstance(self, list): + self = self[0] + num_params = 0 + for param in self.parameters(): + num_params += param.numel() + print('Network [%s] was created. Total number of parameters: %.1f million. ' + 'To see the architecture, do print(network).' + % (type(self).__name__, num_params / 1000000)) + + def init_weights(self, init_type='normal', gain=0.02): + def init_func(m): + classname = m.__class__.__name__ + if classname.find('BatchNorm2d') != -1: + if hasattr(m, 'weight') and m.weight is not None: + init.normal_(m.weight.data, 1.0, gain) + if hasattr(m, 'bias') and m.bias is not None: + init.constant_(m.bias.data, 0.0) + elif hasattr(m, 'weight') and (classname.find('Conv') != -1 or classname.find('Linear') != -1): + if init_type == 'normal': + init.normal_(m.weight.data, 0.0, gain) + elif init_type == 'xavier': + init.xavier_normal_(m.weight.data, gain=gain) + elif init_type == 'xavier_uniform': + init.xavier_uniform_(m.weight.data, gain=1.0) + elif init_type == 'kaiming': + init.kaiming_normal_(m.weight.data, a=0, mode='fan_in') + elif init_type == 'orthogonal': + init.orthogonal_(m.weight.data, gain=gain) + elif init_type == 'none': # uses pytorch's default init method + m.reset_parameters() + else: + raise NotImplementedError('initialization method [%s] is not implemented' % init_type) + if hasattr(m, 'bias') and m.bias is not None: + init.constant_(m.bias.data, 0.0) + + self.apply(init_func) + + # propagate to children + for m in self.children(): + if hasattr(m, 'init_weights'): + m.init_weights(init_type, gain) diff --git a/models/networks/discriminator.py b/models/networks/discriminator.py new file mode 100644 index 0000000000000000000000000000000000000000..793c144d0c13bd7a64a60ae2652323136f00de90 --- /dev/null +++ b/models/networks/discriminator.py @@ -0,0 +1,232 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch.nn as nn +import numpy as np +import torch, math +import torch.nn.functional as F +from models.networks.base_network import BaseNetwork +from models.networks.normalization import get_nonspade_norm_layer +import utils.inference.util as util + + +class MultiscaleDiscriminator(BaseNetwork): + @staticmethod + def modify_commandline_options(parser, is_train): + parser.add_argument('--netD_subarch', type=str, default='n_layer', + help='architecture of each discriminator') + parser.add_argument('--num_D', type=int, default=2, + help='number of discriminators to be used in multiscale') + opt, _ = parser.parse_known_args() + + # define properties of each discriminator of the multiscale discriminator + subnetD = util.find_class_in_module(opt.netD_subarch + 'discriminator', + 'models.networks.discriminator') + subnetD.modify_commandline_options(parser, is_train) + + return parser + + def __init__(self, opt): + super().__init__() + self.opt = opt + + for i in range(opt.num_D): + subnetD = self.create_single_discriminator(opt) + self.add_module('discriminator_%d' % i, subnetD) + + def create_single_discriminator(self, opt): + subarch = opt.netD_subarch + if subarch == 'n_layer': + netD = NLayerDiscriminator(opt) + else: + raise ValueError('unrecognized discriminator subarchitecture %s' % subarch) + return netD + + def downsample(self, input): + return F.avg_pool2d(input, kernel_size=3, + stride=2, padding=[1, 1], + count_include_pad=False) + + # Returns list of lists of discriminator outputs. + # The final result is of size opt.num_D x opt.n_layers_D + def forward(self, input): + result = [] + get_intermediate_features = not self.opt.no_ganFeat_loss + for name, D in self.named_children(): + out = D(input) + if not get_intermediate_features: + out = [out] + result.append(out) + input = self.downsample(input) + + return result + + +# Defines the PatchGAN discriminator with the specified arguments. +class NLayerDiscriminator(BaseNetwork): + @staticmethod + def modify_commandline_options(parser, is_train): + parser.add_argument('--n_layers_D', type=int, default=4, + help='# layers in each discriminator') + return parser + + def __init__(self, opt): + super().__init__() + self.opt = opt + + kw = 4 + padw = int(np.ceil((kw - 1.0) / 2)) + nf = opt.ndf + input_nc = self.compute_D_input_nc(opt) + + norm_layer = get_nonspade_norm_layer(opt, opt.norm_D) + sequence = [[nn.Conv2d(input_nc, nf, kernel_size=kw, stride=2, padding=padw), + nn.LeakyReLU(0.2, False)]] + + for n in range(1, opt.n_layers_D): + nf_prev = nf + nf = min(nf * 2, 512) + stride = 1 if n == opt.n_layers_D - 1 else 2 + sequence += [[norm_layer(nn.Conv2d(nf_prev, nf, kernel_size=kw, + stride=stride, padding=padw)), + nn.LeakyReLU(0.2, False) + ]] + + sequence += [[nn.Conv2d(nf, 1, kernel_size=kw, stride=1, padding=padw)]] + + # We divide the layers into groups to extract intermediate layer outputs + for n in range(len(sequence)): + self.add_module('model' + str(n), nn.Sequential(*sequence[n])) + + def compute_D_input_nc(self, opt): + input_nc = opt.label_nc + opt.output_nc + if opt.contain_dontcare_label: + input_nc += 1 + if not opt.no_instance: + input_nc += 1 + return input_nc + + def forward(self, input): + results = [input] + for submodel in self.children(): + intermediate_output = submodel(results[-1]) + results.append(intermediate_output) + + get_intermediate_features = not self.opt.no_ganFeat_loss + if get_intermediate_features: + return results[1:] + else: + return results[-1] + + +class ScaledLeakyReLU(nn.Module): + def __init__(self, negative_slope=0.2): + super().__init__() + + self.negative_slope = negative_slope + + def forward(self, input): + out = F.leaky_relu(input, negative_slope=self.negative_slope) + + return out * math.sqrt(2) + + +def make_kernel(k): + k = torch.tensor(k, dtype=torch.float32) + + if k.ndim == 1: + k = k[None, :] * k[:, None] + + k /= k.sum() + + return k + + +class Blur(nn.Module): + def __init__(self, kernel, pad, upsample_factor=1): + super().__init__() + + kernel = make_kernel(kernel) + + if upsample_factor > 1: + kernel = kernel * (upsample_factor ** 2) + + self.register_buffer('kernel', kernel) + + self.pad = pad + + def forward(self, input): + out = upfirdn2d(input, self.kernel, pad=self.pad) + + return out + + +class EqualConv2d(nn.Module): + def __init__( + self, in_channel, out_channel, kernel_size, stride=1, padding=0, bias=True + ): + super().__init__() + + self.weight = nn.Parameter( + torch.randn(out_channel, in_channel, kernel_size, kernel_size) + ) + self.scale = 1 / math.sqrt(in_channel * kernel_size ** 2) + + self.stride = stride + self.padding = padding + + if bias: + self.bias = nn.Parameter(torch.zeros(out_channel)) + + else: + self.bias = None + + def forward(self, input): + out = F.conv2d( + input, + self.weight * self.scale, + bias=self.bias, + stride=self.stride, + padding=self.padding, + ) + + return out + + +class ConvLayer(nn.Sequential): + def __init__(self, in_channel, out_channel, kernel_size, + downsample=False, blur_kernel=[1, 3, 3, 1], + bias=True, activate=True): + layers = [] + + if downsample: + factor = 2 + p = (len(blur_kernel) - factor) + (kernel_size - 1) + pad0 = (p + 1) // 2 + pad1 = p // 2 + + layers.append(Blur(blur_kernel, pad=(pad0, pad1))) + + stride = 2 + self.padding = 0 + + else: + stride = 1 + self.padding = kernel_size // 2 + + layers.append( + EqualConv2d(in_channel, out_channel, kernel_size, + padding=self.padding, stride=stride, bias=bias and not activate) + ) + + if activate: + if bias: + layers.append(FusedLeakyReLU(out_channel)) + else: + layers.append(ScaledLeakyReLU(0.2)) + + super().__init__(*layers) + + diff --git a/models/networks/encoder.py b/models/networks/encoder.py new file mode 100644 index 0000000000000000000000000000000000000000..c6705929f9fa77bd009bb429a8e1266a3f94084f --- /dev/null +++ b/models/networks/encoder.py @@ -0,0 +1,55 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch.nn as nn +import numpy as np +import torch.nn.functional as F +from models.networks.base_network import BaseNetwork +from models.networks.normalization import get_nonspade_norm_layer + + +class ConvEncoder(BaseNetwork): + """ Same architecture as the image discriminator """ + + def __init__(self, opt): + super().__init__() + + kw = 3 + pw = int(np.ceil((kw - 1.0) / 2)) + ndf = opt.ngf + norm_layer = get_nonspade_norm_layer(opt, opt.norm_E) + self.layer1 = norm_layer(nn.Conv2d(3, ndf, kw, stride=2, padding=pw)) + self.layer2 = norm_layer(nn.Conv2d(ndf * 1, ndf * 2, kw, stride=2, padding=pw)) + self.layer3 = norm_layer(nn.Conv2d(ndf * 2, ndf * 4, kw, stride=2, padding=pw)) + self.layer4 = norm_layer(nn.Conv2d(ndf * 4, ndf * 8, kw, stride=2, padding=pw)) + self.layer5 = norm_layer(nn.Conv2d(ndf * 8, ndf * 8, kw, stride=2, padding=pw)) + if opt.crop_size >= 256: + self.layer6 = norm_layer(nn.Conv2d(ndf * 8, ndf * 8, kw, stride=2, padding=pw)) + + self.so = s0 = 4 + self.fc_mu = nn.Linear(ndf * 8 * s0 * s0, 256) + self.fc_var = nn.Linear(ndf * 8 * s0 * s0, 256) + + self.actvn = nn.LeakyReLU(0.2, False) + self.opt = opt + + def forward(self, x): + if x.size(2) != 256 or x.size(3) != 256: + x = F.interpolate(x, size=(256, 256), mode='bilinear') + + x = self.layer1(x) + x = self.layer2(self.actvn(x)) + x = self.layer3(self.actvn(x)) + x = self.layer4(self.actvn(x)) + x = self.layer5(self.actvn(x)) + if self.opt.crop_size >= 256: + x = self.layer6(self.actvn(x)) + x = self.actvn(x) + + x = x.view(x.size(0), -1) + mu = self.fc_mu(x) + logvar = self.fc_var(x) + + return mu, logvar diff --git a/models/networks/generator.py b/models/networks/generator.py new file mode 100644 index 0000000000000000000000000000000000000000..210c5e2a9bcb58067da5b70abff501980707473a --- /dev/null +++ b/models/networks/generator.py @@ -0,0 +1,764 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch +import torch.nn as nn +import torch.nn.functional as F +from models.networks.base_network import BaseNetwork +from models.networks.normalization import get_nonspade_norm_layer +from models.networks.architecture import ResnetBlock as ResnetBlock +from models.networks.architecture import SPADEResnetBlock as SPADEResnetBlock +import os +#import data # only run from basic level! +import copy # deepcopy + +class SPADEGenerator(BaseNetwork): + @staticmethod + def modify_commandline_options(parser, is_train): + parser.set_defaults(norm_G='spectralspadesyncbatch3x3') + parser.add_argument('--num_upsampling_layers', + choices=('normal', 'more', 'most'), default='normal', + help="If 'more', adds upsampling layer between the two middle resnet blocks. If 'most', also add one more upsampling + resnet layer at the end of the generator") + + return parser + + def __init__(self, opt): + super().__init__() + self.opt = opt + nf = opt.ngf + + self.sw, self.sh, self.scale_ratio = self.compute_latent_vector_size(opt) + + if opt.use_vae: + # In case of VAE, we will sample from random z vector + self.fc = nn.Linear(opt.z_dim, 16 * nf * self.sw * self.sh) + else: + # Otherwise, we make the network deterministic by starting with + # downsampled segmentation map instead of random z + self.fc = nn.Conv2d(self.opt.semantic_nc, 16 * nf, 3, padding=1) + + self.head_0 = SPADEResnetBlock(16 * nf, 16 * nf, opt) + + self.G_middle_0 = SPADEResnetBlock(16 * nf, 16 * nf, opt) + self.G_middle_1 = SPADEResnetBlock(16 * nf, 16 * nf, opt) + + # 20200211 test 4x with only 3 stage + + self.ups = nn.ModuleList([ + SPADEResnetBlock(16 * nf, 8 * nf, opt), + SPADEResnetBlock(8 * nf, 4 * nf, opt), + SPADEResnetBlock(4 * nf, 2 * nf, opt), + SPADEResnetBlock(2 * nf, 1 * nf, opt) # here + ]) + + self.to_rgbs = nn.ModuleList([ + nn.Conv2d(8 * nf, 3, 3, padding=1), + nn.Conv2d(4 * nf, 3, 3, padding=1), + nn.Conv2d(2 * nf, 3, 3, padding=1), + nn.Conv2d(1 * nf, 3, 3, padding=1) # here + ]) + + self.up = nn.Upsample(scale_factor=2) + + # 20200309 interface for flexible encoder design + # and mid-level loss control! + # For basic network, it's just a 16x downsampling + def encode(self, input): + h, w = input.size()[-2:] + sh, sw = h//2**self.scale_ratio, w//2**self.scale_ratio + x = F.interpolate(input, size=(sh, sw)) + return self.fc(x) # 20200310: Merge fc into encoder + + def compute_latent_vector_size(self, opt): + if opt.num_upsampling_layers == 'normal': + num_up_layers = 5 + elif opt.num_upsampling_layers == 'more': + num_up_layers = 6 + elif opt.num_upsampling_layers == 'most': + num_up_layers = 7 + else: + raise ValueError('opt.num_upsampling_layers [%s] not recognized' % + opt.num_upsampling_layers) + + # 20200211 Yang Lingbo with respect to phase + scale_ratio = num_up_layers + #scale_ratio = 4 #here + sw = opt.crop_size // (2**num_up_layers) + sh = round(sw / opt.aspect_ratio) + + return sw, sh, scale_ratio + + def forward(self, input, seg=None): + ''' + 20200307: Dangerous Change + Add separable forward to allow different + input and segmentation maps... + + To return to original, simply add + seg = input at begining, and disable the seg parameter. + + 20200308: A more elegant solution: + @ Allow forward to take default parameters. + @ Allow customizable input encoding + + 20200310: Merge fc into encode, since encoder directly outputs processed feature map. + + [TODO] @ Allow customizable segmap encoding? + ''' + + if seg is None: + seg = input # Interesting change... + + # For basic generator, 16x downsampling. + # 20200310: Merge fc into encoder + x = self.encode(input) + #print(x.shape, input.shape, seg.shape) + + x = self.head_0(x, seg) + + x = self.up(x) + x = self.G_middle_0(x, seg) + x = self.G_middle_1(x, seg) + + if self.opt.is_test: + phase = len(self.to_rgbs) + else: + phase = self.opt.train_phase+1 + + for i in range(phase): + x = self.up(x) + x = self.ups[i](x, seg) + + x = self.to_rgbs[phase-1](F.leaky_relu(x, 2e-1)) + x = torch.tanh(x) + + return x + + def mixed_guidance_forward(self, input, seg=None, n=0, mode='progressive'): + ''' + mixed_forward: input and seg are different images + For the first n levels (including encoder) + we use input, for the rest we use seg. + + If mode = 'progressive', the output's like: AAABBB + If mode = 'one_plug', the output's like: AAABAA + If mode = 'one_ablate', the output's like: BBBABB + ''' + + if seg is None: + return self.forward(input) + + if self.opt.is_test: + phase = len(self.to_rgbs) + else: + phase = self.opt.train_phase+1 + + if mode == 'progressive': + n = max(min(n, 4 + phase), 0) + guide_list = [input] * n + [seg] * (4+phase-n) + elif mode == 'one_plug': + n = max(min(n, 4 + phase-1), 0) + guide_list = [seg] * (4+phase) + guide_list[n] = input + elif mode == 'one_ablate': + if n > 3+phase: + return self.forward(input) + guide_list = [input] * (4+phase) + guide_list[n] = seg + + x = self.encode(guide_list[0]) + x = self.head_0(x, guide_list[1]) + + x = self.up(x) + x = self.G_middle_0(x, guide_list[2]) + x = self.G_middle_1(x, guide_list[3]) + + for i in range(phase): + x = self.up(x) + x = self.ups[i](x, guide_list[4+i]) + + x = self.to_rgbs[phase-1](F.leaky_relu(x, 2e-1)) + x = torch.tanh(x) + + return x + +class HiFaceGANGenerator(SPADEGenerator): + def __init__(self, opt): + super().__init__(opt) + self.opt = opt + nf = opt.ngf + + self.sw, self.sh, self.scale_ratio = self.compute_latent_vector_size(opt) + + if opt.use_vae: + # In case of VAE, we will sample from random z vector + self.fc = nn.Linear(opt.z_dim, 16 * nf * self.sw * self.sh) + else: + # Otherwise, we make the network deterministic by starting with + # downsampled segmentation map instead of random z + self.fc = nn.Conv2d(self.opt.semantic_nc, 16 * nf, 3, padding=1) + + self.head_0 = SPADEResnetBlock(16 * nf, 16 * nf, opt, 16 * nf) + + self.G_middle_0 = SPADEResnetBlock(16 * nf, 16 * nf, opt, 16 * nf) + self.G_middle_1 = SPADEResnetBlock(16 * nf, 16 * nf, opt, 16 * nf) + + # 20200211 test 4x with only 3 stage + + self.ups = nn.ModuleList([ + SPADEResnetBlock(16 * nf, 8 * nf, opt, 8 * nf), + SPADEResnetBlock(8 * nf, 4 * nf, opt, 4 * nf), + SPADEResnetBlock(4 * nf, 2 * nf, opt, 2 * nf), + SPADEResnetBlock(2 * nf, 1 * nf, opt, 1 * nf) # here + ]) + + self.to_rgbs = nn.ModuleList([ + nn.Conv2d(8 * nf, 3, 3, padding=1), + nn.Conv2d(4 * nf, 3, 3, padding=1), + nn.Conv2d(2 * nf, 3, 3, padding=1), + nn.Conv2d(1 * nf, 3, 3, padding=1) # here + ]) + + self.up = nn.Upsample(scale_factor=2) + self.encoder = ContentAdaptiveSuppresor(opt, self.sw, self.sh, self.scale_ratio) + + def nested_encode(self, x): + return self.encoder(x) + + def forward(self, input): + xs = self.nested_encode(input) + x = self.encode(input) + ''' + print([_x.shape for _x in xs]) + print(x.shape) + print(self.head_0) + ''' + x = self.head_0(x, xs[0]) + + x = self.up(x) + x = self.G_middle_0(x, xs[1]) + x = self.G_middle_1(x, xs[1]) + + if self.opt.is_test: + phase = len(self.to_rgbs) + else: + phase = self.opt.train_phase+1 + + for i in range(phase): + x = self.up(x) + x = self.ups[i](x, xs[i+2]) + + x = self.to_rgbs[phase-1](F.leaky_relu(x, 2e-1)) + x = torch.tanh(x) + + return x + + +class ContentAdaptiveSuppresor(BaseNetwork): + def __init__(self, opt, sw, sh, n_2xdown, + norm_layer=nn.InstanceNorm2d): + super().__init__() + self.sw = sw + self.sh = sh + self.max_ratio = 16 + self.n_2xdown = n_2xdown + + # norm_layer = get_nonspade_norm_layer(opt, opt.norm_E) + + # 20200310: Several Convolution (stride 1) + LIP blocks, 4 fold + ngf = opt.ngf + kw = 3 + pw = (kw - 1) // 2 + + self.head = nn.Sequential( + nn.Conv2d(opt.semantic_nc, ngf, kw, stride=1, padding=pw, bias=False), + norm_layer(ngf), + nn.ReLU(), + ) + cur_ratio = 1 + for i in range(n_2xdown): + next_ratio = min(cur_ratio*2, self.max_ratio) + model = [ + SimplifiedLIP(ngf*cur_ratio), + nn.Conv2d(ngf*cur_ratio, ngf*next_ratio, kw, stride=1, padding=pw), + norm_layer(ngf*next_ratio), + ] + cur_ratio = next_ratio + if i < n_2xdown - 1: + model += [nn.ReLU(inplace=True)] + setattr(self, 'encoder_%d' % i, nn.Sequential(*model)) + + def forward(self, x): + # 20200628: Note the features are arranged from small to large + x = [self.head(x)] + for i in range(self.n_2xdown): + net = getattr(self, 'encoder_%d' % i) + x = [net(x[0])] + x + return x + + +######################################### +# Below are deprecated codes +# +# 20200309: LIP for local importance pooling +# 20200311: Self-supervised mask encoder +# Author: lingbo.ylb +# Quick trial, to be reformated later. +# 20200324: Nah forget about it... +######################################### + + +def lip2d(x, logit, kernel=3, stride=2, padding=1): + weight = logit.exp() + return F.avg_pool2d(x*weight, kernel, stride, padding) / F.avg_pool2d(weight, kernel, stride, padding) + + +class SoftGate(nn.Module): + COEFF = 12.0 + + def __init__(self): + super(SoftGate, self).__init__() + + def forward(self, x): + return torch.sigmoid(x).mul(self.COEFF) + +class SimplifiedLIP(nn.Module): + def __init__(self, channels): + super(SimplifiedLIP, self).__init__() + + rp = channels + + self.logit = nn.Sequential( + nn.Conv2d(channels, channels, 3, padding=1, bias=False), + nn.InstanceNorm2d(channels, affine=True), + SoftGate() + ) + ''' + OrderedDict(( + ('conv', nn.Conv2d(channels, channels, 3, padding=1, bias=False)), + ('bn', nn.InstanceNorm2d(channels, affine=True)), + ('gate', SoftGate()), + )) + ''' + + def init_layer(self): + self.logit[0].weight.data.fill_(0.0) + + def forward(self, x): + frac = lip2d(x, self.logit(x)) + return frac + +class LIPEncoder(BaseNetwork): + def __init__(self, opt, sw, sh, n_2xdown, + norm_layer=nn.InstanceNorm2d): + super().__init__() + self.sw = sw + self.sh = sh + self.max_ratio = 16 + + # norm_layer = get_nonspade_norm_layer(opt, opt.norm_E) + + # 20200310: Several Convolution (stride 1) + LIP blocks, 4 fold + ngf = opt.ngf + kw = 3 + pw = (kw - 1) // 2 + + model = [ + nn.Conv2d(opt.semantic_nc, ngf, kw, stride=1, padding=pw, bias=False), + norm_layer(ngf), + nn.ReLU(), + ] + cur_ratio = 1 + for i in range(n_2xdown): + next_ratio = min(cur_ratio*2, self.max_ratio) + model += [ + SimplifiedLIP(ngf*cur_ratio), + nn.Conv2d(ngf*cur_ratio, ngf*next_ratio, kw, stride=1, padding=pw), + norm_layer(ngf*next_ratio), + ] + cur_ratio = next_ratio + if i < n_2xdown - 1: + model += [nn.ReLU(inplace=True)] + + self.model = nn.Sequential(*model) + + def forward(self, x): + return self.model(x) + +class LIPSPADEGenerator(SPADEGenerator): + ''' + 20200309: SPADEGenerator with a learnable feature encoder + Encoder design: Local Importance-based Pooling (Ziteng Gao et.al.,ICCV 2019) + ''' + def __init__(self, opt): + super().__init__(opt) + self.lip_encoder = LIPEncoder(opt, self.sw, self.sh, self.scale_ratio) + + def encode(self, x): + return self.lip_encoder(x) + + +class NoiseClassPredictor(nn.Module): + ''' + Input: nc*sw*sw tensor, either from clean or corrupted images + Output: n-dim tensor indicating the loss type (or intensity?) + ''' + def __init__(self, opt, sw, nc, outdim): + super().__init__() + nbottleneck = 256 + middim = 256 + # Compact info + conv = [ + nn.Conv2d(nc, nbottleneck, 1, stride=1), + nn.InstanceNorm2d(nbottleneck), + nn.LeakyReLU(0.2, inplace=True), + ] + # sw should be probably 16, downsample to 4 and convert to 1 + while sw > 4: + sw = sw // 2 + conv += [ + nn.Conv2d(nbottleneck, nbottleneck, 3, stride=2, padding=1), + nn.InstanceNorm2d(nbottleneck), + nn.LeakyReLU(0.2, inplace=True), + ] + + + self.conv = nn.Sequential(*conv) + + indim = sw * sw * nbottleneck + self.fc = nn.Sequential( + nn.Linear(indim, middim), + nn.BatchNorm1d(middim), + nn.LeakyReLU(0.2, inplace=True), + nn.Linear(middim, outdim), + # nn.Sigmoid(), + ) + + def forward(self, x): + x = self.conv(x) + x = x.view(x.shape[0],-1) + return self.fc(x) + + +class NoiseIntensityPredictor(nn.Module): + ''' + Input: nc*sw*sw tensor, either from clean or corrupted images + Output: 1-dim tensor indicating the loss intensity + ''' + def __init__(self, opt, sw, nc, outdim): + super().__init__() + nbottleneck = 256 + middim = 256 + # Compact info + conv = [ + nn.Conv2d(nc, nbottleneck, 1, stride=1), + nn.BatchNorm2d(nbottleneck), + nn.LeakyReLU(0.2, inplace=True), + ] + # sw should be probably 16, downsample to 4 and convert to 1 + while sw > 4: + sw = sw // 2 + conv += [ + nn.Conv2d(nbottleneck, nbottleneck, 3, stride=2, padding=1), + nn.BatchNorm2d(nbottleneck), + nn.LeakyReLU(0.2, inplace=True), + ] + + + self.conv = nn.Sequential(*conv) + + indim = sw * sw * nbottleneck + self.fc = nn.Sequential( + nn.Linear(indim, middim), + nn.BatchNorm1d(middim), + #nn.Dropout(0.5), + nn.LeakyReLU(0.2, inplace=True), + nn.Linear(middim, outdim), + #nn.Dropout(0.5), + # nn.Sigmoid(), + ) + + def forward(self, x): + x = self.conv(x) + x = x.view(x.shape[0],-1) + x = self.fc(x) + return x.squeeze() + + +class SubAddGenerator(SPADEGenerator): + ''' + 20200311: + This generator contains a complete set + of self-supervised training scheme + that requires a separate dataloader. + + The self-supervised pre-training is + implemented as a clean interface. + SubAddGenerator::train_E(self, dataloader, epochs) + + For the upperlevel Pix2Pix_Model, + two things to be done: + A) Run the pretrain script + B) Save encoder and adjust learning rate. + + ----------------------------------------- + 20200312: + Pre-test problem: The discriminator is hard to test real vs fake + Also, using residual of feature maps ain't work... + + Cause: The feature map is too close to be properly separated. + + Try to test on one single reduction: arbitrary ratio of downsampling + try to estimate the reduction ratio? + ''' + def __init__(self, opt): + super().__init__(opt) + self.encoder = LIPEncoder(opt, self.sw, self.sh, self.scale_ratio) + + self.dis_nc = self.opt.ngf * min(16, 2**self.scale_ratio) + # intensity is a scalar + self.discriminator = NoiseIntensityPredictor(opt, self.sw, self.dis_nc, 1) + if opt.isTrain: + self.attach_dataloader(opt) + self.noise_dim = opt.noise_dim + + self.l1_loss = nn.L1Loss() + self.gan_loss = nn.MSELoss() + + #self.discriminator = NoiseClassPredictor(opt, self.sw, self.dis_nc, + # self.noise_dim + 1) # add a new label for clean images + + #self.gan_loss = nn.CrossEntropyLoss() + + beta1, beta2 = opt.beta1, opt.beta2 + if opt.no_TTUR: + G_lr, D_lr = opt.lr, opt.lr + else: + G_lr, D_lr = opt.lr / 2, opt.lr * 2 + + self.optimizer_E = torch.optim.Adam( + self.encoder.parameters(), lr=G_lr, betas=(beta1, beta2) + ) + self.optimizer_D = torch.optim.Adam( + self.discriminator.parameters(), lr=D_lr/2, betas=(beta1, beta2) + ) + + def _create_auxiliary_opt(self, opt): + ''' + Create auxiliary options + change necessary params + --- dataroot + --- dataset_mode + ''' + aux_opt = copy.deepcopy(opt) # just for safety + aux_opt.dataroot = opt.dataroot_assist + aux_opt.dataset_mode = 'assist' + aux_opt.batchSize = 4 + aux_opt.nThreads = 4 + return aux_opt + + def attach_dataloader(self, opt): + aux_opt = self._create_auxiliary_opt(opt) + self.loader = data.create_dataloader(aux_opt) + + def encode(self, x): + return self.encoder(x) + + def process_input(self, data): + self.clean = data['clean'].cuda() + self.noisy = data['noisy'].cuda() + # for BCELoss, class label is just int. + self.noise_label = data['label'].cuda() + # label design... + # clean label should be 0 or [1,0,0...0]? + # for BCELoss, class label is just 0. + #self.clean_label = torch.zeros_like(self.noise_label) + self.clean_label = torch.ones_like(self.noise_label) + + def update_E(self): + bundle_in = torch.cat((self.clean, self.noisy), dim=0) + bundle_out = self.encode(bundle_in) + nb = bundle_in.shape[0] // 2 + F_real, F_fake = bundle_out[:nb], bundle_out[nb:] + + pred_fake = self.discriminator(F_fake) + loss_l1 = self.l1_loss(F_fake, F_real) + loss_gan = self.gan_loss(pred_fake, self.clean_label) + loss_sum = loss_l1 * 10 + loss_gan + + self.optimizer_E.zero_grad() + loss_sum.backward() + self.optimizer_E.step() + + self.loss_l1 = loss_l1.item() + self.loss_gan_E = loss_gan.item() + self.loss_sum = loss_sum.item() + + def update_D(self): + + with torch.no_grad(): + bundle_in = torch.cat((self.clean, self.noisy), dim=0) + bundle_out = self.encode(bundle_in) + nb = bundle_in.shape[0] // 2 + #F_real, #F_fake = bundle_out[:nb], bundle_out[nb:] + F_fake = bundle_out[nb:] / (bundle_out[:nb] + 1e-6) + F_real = torch.ones_like(F_fake, requires_grad=False) + + pred_real = self.discriminator(F_real) + loss_real = self.gan_loss(pred_real, self.clean_label) + pred_fake = self.discriminator(F_fake.detach()) + loss_fake = self.gan_loss(pred_fake, self.noise_label) + loss_sum = (loss_real + loss_fake * self.opt.noise_dim) / 2 + + self.optimizer_D.zero_grad() + loss_sum.backward() + self.optimizer_D.step() + + self.loss_gan_D_real = loss_real.item() + self.loss_gan_D_fake = loss_fake.item() + + def debug_D(self): + with torch.no_grad(): + bundle_in = torch.cat((self.clean, self.noisy), dim=0) + bundle_out = self.encode(bundle_in) + nb = bundle_in.shape[0] // 2 + F_real, F_fake = bundle_out[:nb], bundle_out[nb:] + F_res = F_fake - F_real # try to predict the residual, it's easier + #F_real = torch.zeros_like(F_real) # real res == 0 + + + pred_real = self.discriminator(F_real)#.argmax(dim=1) + pred_fake = self.discriminator(F_res.detach())#.argmax(dim=1) + print(pred_real, pred_fake) + real_acc = (pred_real == 0).sum().item() / pred_real.shape[0] + fake_acc = (pred_fake == self.noise_label).sum().item() / pred_fake.shape[0] + print(real_acc, fake_acc) + + def log(self, epoch, i): + logstring = ' Epoch [%d] iter [%d]: ' % (epoch, i) + logstring += 'l1: %.4f ' % self.loss_l1 + logstring += 'gen: %.4f ' % self.loss_gan_E + logstring += 'E_sum: %.4f ' % self.loss_sum + logstring += 'dis_real: %.4f ' % self.loss_gan_D_real + logstring += 'dis_fake: %.4f' % self.loss_gan_D_fake + print(logstring) + + def train_E(self, epochs): + pretrained_ckpt_dir = os.path.join( + self.opt.checkpoints_dir, self.opt.name, + 'pretrained_net_E_%d.pth' % epochs + ) + print(pretrained_ckpt_dir) + + print('======= Stage I: Subtraction =======') + if os.path.isfile(pretrained_ckpt_dir): + state_dict_E = torch.load(pretrained_ckpt_dir) + self.encoder.load_state_dict(state_dict_E) + print('======= Load cached checkpoints %s' % pretrained_ckpt_dir) + else: + print('======= total epochs: %d ' % epochs) + for epoch in range(1,epochs+1): + for i, data in enumerate(self.loader): + self.process_input(data) + + self.update_E() + self.update_D() + + if i % 10 == 0: + self.log(epoch, i) # output losses and thing. + + print('Epoch [%d] finished' % epoch) + # just save the latest. + torch.save(self.encoder.state_dict(), os.path.join( + self.opt.checkpoints_dir, self.opt.name, 'pretrained_net_E_%d.pth' % epoch + )) + +class ContrasiveGenerator(SPADEGenerator): + def __init__(self, opt): + super().__init__(opt) + self.encoder = LIPEncoder(opt, self.sw, self.sh, self.scale_ratio) + + if opt.isTrain: + self.attach_dataloader(opt) + self.noise_dim = opt.noise_dim + + self.l1_loss = nn.L1Loss() + + beta1, beta2 = opt.beta1, opt.beta2 + self.optimizer_E = torch.optim.Adam( + self.encoder.parameters(), lr=opt.lr, betas=(beta1, beta2) + ) + + def _create_auxiliary_opt(self, opt): + ''' + Create auxiliary options + change necessary params + --- dataroot + --- dataset_mode + ''' + aux_opt = copy.deepcopy(opt) # just for safety + aux_opt.dataroot = opt.dataroot_assist + aux_opt.dataset_mode = 'assist' + aux_opt.batchSize = 8 + aux_opt.nThreads = 4 + return aux_opt + + def attach_dataloader(self, opt): + aux_opt = self._create_auxiliary_opt(opt) + self.loader = data.create_dataloader(aux_opt) + + def encode(self, x): + return self.encoder(x) + + def process_input(self, data): + self.clean = data['clean'].cuda() + self.noisy = data['noisy'].cuda() + + def update_E(self): + bundle_in = torch.cat((self.clean, self.noisy), dim=0) + bundle_out = self.encode(bundle_in) + nb = bundle_in.shape[0] // 2 + F_real, F_fake = bundle_out[:nb], bundle_out[nb:] + loss_l1 = self.l1_loss(F_fake, F_real) + + self.optimizer_E.zero_grad() + loss_l1.backward() + self.optimizer_E.step() + + self.loss_l1 = loss_l1.item() + + def log(self, epoch, i): + logstring = ' Epoch [%d] iter [%d]: ' % (epoch, i) + logstring += 'l1: %.4f ' % self.loss_l1 + print(logstring) + + def train_E(self, epochs): + pretrained_ckpt_dir = os.path.join( + self.opt.checkpoints_dir, self.opt.name, + 'pretrained_net_E_%d.pth' % epochs + ) + print(pretrained_ckpt_dir) + + print('======= Stage I: Subtraction =======') + if os.path.isfile(pretrained_ckpt_dir): + state_dict_E = torch.load(pretrained_ckpt_dir) + self.encoder.load_state_dict(state_dict_E) + print('======= Load cached checkpoints %s' % pretrained_ckpt_dir) + else: + print('======= total epochs: %d ' % epochs) + for epoch in range(1,epochs+1): + for i, data in enumerate(self.loader): + self.process_input(data) + self.update_E() + + if i % 10 == 0: + self.log(epoch, i) # output losses and thing. + + print('Epoch [%d] finished' % epoch) + # just save the latest. + torch.save(self.encoder.state_dict(), os.path.join( + self.opt.checkpoints_dir, self.opt.name, 'pretrained_net_E_%d.pth' % epoch + )) + diff --git a/models/networks/loss.py b/models/networks/loss.py new file mode 100644 index 0000000000000000000000000000000000000000..8403f14fa1960fa48d2fe158fa1c6bccd279514e --- /dev/null +++ b/models/networks/loss.py @@ -0,0 +1,122 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch +import torch.nn as nn +import torch.nn.functional as F +from models.networks.architecture import VGG19 + + +# Defines the GAN loss which uses either LSGAN or the regular GAN. +# When LSGAN is used, it is basically same as MSELoss, +# but it abstracts away the need to create the target label tensor +# that has the same size as the input +class GANLoss(nn.Module): + def __init__(self, gan_mode, target_real_label=1.0, target_fake_label=0.0, + tensor=torch.FloatTensor, opt=None): + super(GANLoss, self).__init__() + self.real_label = target_real_label + self.fake_label = target_fake_label + self.real_label_tensor = None + self.fake_label_tensor = None + self.zero_tensor = None + self.Tensor = tensor + self.gan_mode = gan_mode + self.opt = opt + if gan_mode == 'ls': + pass + elif gan_mode == 'original': + pass + elif gan_mode == 'w': + pass + elif gan_mode == 'hinge': + pass + else: + raise ValueError('Unexpected gan_mode {}'.format(gan_mode)) + + def get_target_tensor(self, input, target_is_real): + if target_is_real: + if self.real_label_tensor is None: + self.real_label_tensor = self.Tensor(1).fill_(self.real_label) + self.real_label_tensor.requires_grad_(False) + return self.real_label_tensor.expand_as(input) + else: + if self.fake_label_tensor is None: + self.fake_label_tensor = self.Tensor(1).fill_(self.fake_label) + self.fake_label_tensor.requires_grad_(False) + return self.fake_label_tensor.expand_as(input) + + def get_zero_tensor(self, input): + if self.zero_tensor is None: + self.zero_tensor = self.Tensor(1).fill_(0) + self.zero_tensor.requires_grad_(False) + return self.zero_tensor.expand_as(input) + + def loss(self, input, target_is_real, for_discriminator=True): + if self.gan_mode == 'original': # cross entropy loss + target_tensor = self.get_target_tensor(input, target_is_real) + loss = F.binary_cross_entropy_with_logits(input, target_tensor) + return loss + elif self.gan_mode == 'ls': + target_tensor = self.get_target_tensor(input, target_is_real) + return F.mse_loss(input, target_tensor) + elif self.gan_mode == 'hinge': + if for_discriminator: + if target_is_real: + minval = torch.min(input - 1, self.get_zero_tensor(input)) + loss = -torch.mean(minval) + else: + minval = torch.min(-input - 1, self.get_zero_tensor(input)) + loss = -torch.mean(minval) + else: + assert target_is_real, "The generator's hinge loss must be aiming for real" + loss = -torch.mean(input) + return loss + else: + # wgan + if target_is_real: + return -input.mean() + else: + return input.mean() + + def __call__(self, input, target_is_real, for_discriminator=True): + # computing loss is a bit complicated because |input| may not be + # a tensor, but list of tensors in case of multiscale discriminator + if isinstance(input, list): + loss = 0 + for pred_i in input: + if isinstance(pred_i, list): + pred_i = pred_i[-1] + loss_tensor = self.loss(pred_i, target_is_real, for_discriminator) + bs = 1 if len(loss_tensor.size()) == 0 else loss_tensor.size(0) + new_loss = torch.mean(loss_tensor.view(bs, -1), dim=1) + loss += new_loss + return loss / len(input) + else: + return self.loss(input, target_is_real, for_discriminator) + + +# Perceptual loss that uses a pretrained VGG network +class VGGLoss(nn.Module): + def __init__(self, gpu_ids): + super(VGGLoss, self).__init__() + self.vgg = VGG19().cuda() if len(gpu_ids)>0 else VGG19() + self.criterion = nn.L1Loss() + self.weights = [1.0 / 32, 1.0 / 16, 1.0 / 8, 1.0 / 4, 1.0] + + def forward(self, x, y): + if x.shape[-2:]!=y.shape[-2:]: + y = torch.nn.functional.interpolate(y, tuple(x.shape[-2:])) + x_vgg, y_vgg = self.vgg(x), self.vgg(y) + loss = 0 + for i in range(len(x_vgg)): + loss += self.weights[i] * self.criterion(x_vgg[i], y_vgg[i].detach()) + return loss + + +# KL Divergence loss used in VAE with an image encoder +class KLDLoss(nn.Module): + def forward(self, mu, logvar): + return -0.5 * torch.sum(1 + logvar - mu.pow(2) - logvar.exp()) diff --git a/models/networks/normalization.py b/models/networks/normalization.py new file mode 100644 index 0000000000000000000000000000000000000000..755e029388eb6e0af6f9aa285c6436b0a379736f --- /dev/null +++ b/models/networks/normalization.py @@ -0,0 +1,107 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import re +import torch +import torch.nn as nn +import torch.nn.functional as F +from models.networks.sync_batchnorm import SynchronizedBatchNorm2d +import torch.nn.utils.spectral_norm as spectral_norm + + +def get_nonspade_norm_layer(opt, norm_type='instance'): + # helper function to get # output channels of the previous layer + def get_out_channel(layer): + if hasattr(layer, 'out_channels'): + return getattr(layer, 'out_channels') + return layer.weight.size(0) + + # this function will be returned + def add_norm_layer(layer): + nonlocal norm_type + if norm_type.startswith('spectral'): + layer = spectral_norm(layer) + subnorm_type = norm_type[len('spectral'):] + + if subnorm_type == 'none' or len(subnorm_type) == 0: + return layer + + # remove bias in the previous layer, which is meaningless + # since it has no effect after normalization + if getattr(layer, 'bias', None) is not None: + delattr(layer, 'bias') + layer.register_parameter('bias', None) + + if subnorm_type == 'batch': + norm_layer = nn.BatchNorm2d(get_out_channel(layer), affine=True) + elif subnorm_type == 'sync_batch': + norm_layer = SynchronizedBatchNorm2d(get_out_channel(layer), affine=True) + elif subnorm_type == 'instance': + norm_layer = nn.InstanceNorm2d(get_out_channel(layer), affine=False) + else: + raise ValueError('normalization layer %s is not recognized' % subnorm_type) + + return nn.Sequential(layer, norm_layer) + + return add_norm_layer + + +class InstanceNorm2d(nn.Module): + def __init__(self, epsilon=1e-8, **kwargs): + super().__init__(**kwargs) + self.epsilon = epsilon + + def forward(self, x): + #x = x - torch.mean(x, (2, 3), True) + tmp = torch.mul(x, x) # or x ** 2 + tmp = torch.rsqrt(torch.mean(tmp, (2, 3), True) + self.epsilon) + return x * tmp + + +class SPADE(nn.Module): + def __init__(self, config_text, norm_nc, label_nc): + super().__init__() + + assert config_text.startswith('spade') + parsed = re.search('spade(\D+)(\d)x\d', config_text) + param_free_norm_type = str(parsed.group(1)) + ks = int(parsed.group(2)) + + if param_free_norm_type == 'instance': + self.param_free_norm = InstanceNorm2d(norm_nc) + elif param_free_norm_type == 'syncbatch': + self.param_free_norm = SynchronizedBatchNorm2d(norm_nc, affine=False) + elif param_free_norm_type == 'batch': + self.param_free_norm = nn.BatchNorm2d(norm_nc, affine=False) + else: + raise ValueError('%s is not a recognized param-free norm type in SPADE' + % param_free_norm_type) + + # The dimension of the intermediate embedding space. Yes, hardcoded. + nhidden = 128 if norm_nc>128 else norm_nc + + pw = ks // 2 + self.mlp_shared = nn.Sequential( + nn.Conv2d(label_nc, nhidden, kernel_size=ks, padding=pw), + nn.ReLU() + ) + self.mlp_gamma = nn.Conv2d(nhidden, norm_nc, kernel_size=ks, padding=pw, bias=False) + self.mlp_beta = nn.Conv2d(nhidden, norm_nc, kernel_size=ks, padding=pw, bias=False) + + def forward(self, x, segmap): + + # Part 1. generate parameter-free normalized activations + normalized = self.param_free_norm(x) + + # Part 2. produce scaling and bias conditioned on semantic map + segmap = F.interpolate(segmap, size=x.size()[2:], mode='nearest') + actv = self.mlp_shared(segmap) + gamma = self.mlp_gamma(actv) + beta = self.mlp_beta(actv) + + # apply scale and bias + out = normalized * gamma + beta + + return out diff --git a/models/networks/sync_batchnorm/__init__.py b/models/networks/sync_batchnorm/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..a10989fbef38485841fdbd1af72f53062a7b556d --- /dev/null +++ b/models/networks/sync_batchnorm/__init__.py @@ -0,0 +1,13 @@ +# -*- coding: utf-8 -*- +# File : __init__.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +from .batchnorm import SynchronizedBatchNorm1d, SynchronizedBatchNorm2d, SynchronizedBatchNorm3d +from .batchnorm import patch_sync_batchnorm, convert_model +from .replicate import DataParallelWithCallback, patch_replication_callback diff --git a/models/networks/sync_batchnorm/batchnorm.py b/models/networks/sync_batchnorm/batchnorm.py new file mode 100644 index 0000000000000000000000000000000000000000..24c0950707d07102d06b5fdf64c74a347ec3186c --- /dev/null +++ b/models/networks/sync_batchnorm/batchnorm.py @@ -0,0 +1,394 @@ +# -*- coding: utf-8 -*- +# File : batchnorm.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import collections +import contextlib + +import torch +import torch.nn.functional as F + +from torch.nn.modules.batchnorm import _BatchNorm + +try: + from torch.nn.parallel._functions import ReduceAddCoalesced, Broadcast +except ImportError: + ReduceAddCoalesced = Broadcast = None + +try: + from jactorch.parallel.comm import SyncMaster + from jactorch.parallel.data_parallel import JacDataParallel as DataParallelWithCallback +except ImportError: + from .comm import SyncMaster + from .replicate import DataParallelWithCallback + +__all__ = [ + 'SynchronizedBatchNorm1d', 'SynchronizedBatchNorm2d', 'SynchronizedBatchNorm3d', + 'patch_sync_batchnorm', 'convert_model' +] + + +def _sum_ft(tensor): + """sum over the first and last dimention""" + return tensor.sum(dim=0).sum(dim=-1) + + +def _unsqueeze_ft(tensor): + """add new dimensions at the front and the tail""" + return tensor.unsqueeze(0).unsqueeze(-1) + + +_ChildMessage = collections.namedtuple('_ChildMessage', ['sum', 'ssum', 'sum_size']) +_MasterMessage = collections.namedtuple('_MasterMessage', ['sum', 'inv_std']) + + +class _SynchronizedBatchNorm(_BatchNorm): + def __init__(self, num_features, eps=1e-5, momentum=0.1, affine=True): + assert ReduceAddCoalesced is not None, 'Can not use Synchronized Batch Normalization without CUDA support.' + + super(_SynchronizedBatchNorm, self).__init__(num_features, eps=eps, momentum=momentum, affine=affine) + + self._sync_master = SyncMaster(self._data_parallel_master) + + self._is_parallel = False + self._parallel_id = None + self._slave_pipe = None + + def forward(self, input): + # If it is not parallel computation or is in evaluation mode, use PyTorch's implementation. + if not (self._is_parallel and self.training): + return F.batch_norm( + input, self.running_mean, self.running_var, self.weight, self.bias, + self.training, self.momentum, self.eps) + + # Resize the input to (B, C, -1). + input_shape = input.size() + input = input.view(input.size(0), self.num_features, -1) + + # Compute the sum and square-sum. + sum_size = input.size(0) * input.size(2) + input_sum = _sum_ft(input) + input_ssum = _sum_ft(input ** 2) + + # Reduce-and-broadcast the statistics. + if self._parallel_id == 0: + mean, inv_std = self._sync_master.run_master(_ChildMessage(input_sum, input_ssum, sum_size)) + else: + mean, inv_std = self._slave_pipe.run_slave(_ChildMessage(input_sum, input_ssum, sum_size)) + + # Compute the output. + if self.affine: + # MJY:: Fuse the multiplication for speed. + output = (input - _unsqueeze_ft(mean)) * _unsqueeze_ft(inv_std * self.weight) + _unsqueeze_ft(self.bias) + else: + output = (input - _unsqueeze_ft(mean)) * _unsqueeze_ft(inv_std) + + # Reshape it. + return output.view(input_shape) + + def __data_parallel_replicate__(self, ctx, copy_id): + self._is_parallel = True + self._parallel_id = copy_id + + # parallel_id == 0 means master device. + if self._parallel_id == 0: + ctx.sync_master = self._sync_master + else: + self._slave_pipe = ctx.sync_master.register_slave(copy_id) + + def _data_parallel_master(self, intermediates): + """Reduce the sum and square-sum, compute the statistics, and broadcast it.""" + + # Always using same "device order" makes the ReduceAdd operation faster. + # Thanks to:: Tete Xiao (http://tetexiao.com/) + intermediates = sorted(intermediates, key=lambda i: i[1].sum.get_device()) + + to_reduce = [i[1][:2] for i in intermediates] + to_reduce = [j for i in to_reduce for j in i] # flatten + target_gpus = [i[1].sum.get_device() for i in intermediates] + + sum_size = sum([i[1].sum_size for i in intermediates]) + sum_, ssum = ReduceAddCoalesced.apply(target_gpus[0], 2, *to_reduce) + mean, inv_std = self._compute_mean_std(sum_, ssum, sum_size) + + broadcasted = Broadcast.apply(target_gpus, mean, inv_std) + + outputs = [] + for i, rec in enumerate(intermediates): + outputs.append((rec[0], _MasterMessage(*broadcasted[i*2:i*2+2]))) + + return outputs + + def _compute_mean_std(self, sum_, ssum, size): + """Compute the mean and standard-deviation with sum and square-sum. This method + also maintains the moving average on the master device.""" + assert size > 1, 'BatchNorm computes unbiased standard-deviation, which requires size > 1.' + mean = sum_ / size + sumvar = ssum - sum_ * mean + unbias_var = sumvar / (size - 1) + bias_var = sumvar / size + + if hasattr(torch, 'no_grad'): + with torch.no_grad(): + self.running_mean = (1 - self.momentum) * self.running_mean + self.momentum * mean.data + self.running_var = (1 - self.momentum) * self.running_var + self.momentum * unbias_var.data + else: + self.running_mean = (1 - self.momentum) * self.running_mean + self.momentum * mean.data + self.running_var = (1 - self.momentum) * self.running_var + self.momentum * unbias_var.data + + return mean, bias_var.clamp(self.eps) ** -0.5 + + +class SynchronizedBatchNorm1d(_SynchronizedBatchNorm): + r"""Applies Synchronized Batch Normalization over a 2d or 3d input that is seen as a + mini-batch. + + .. math:: + + y = \frac{x - mean[x]}{ \sqrt{Var[x] + \epsilon}} * gamma + beta + + This module differs from the built-in PyTorch BatchNorm1d as the mean and + standard-deviation are reduced across all devices during training. + + For example, when one uses `nn.DataParallel` to wrap the network during + training, PyTorch's implementation normalize the tensor on each device using + the statistics only on that device, which accelerated the computation and + is also easy to implement, but the statistics might be inaccurate. + Instead, in this synchronized version, the statistics will be computed + over all training samples distributed on multiple devices. + + Note that, for one-GPU or CPU-only case, this module behaves exactly same + as the built-in PyTorch implementation. + + The mean and standard-deviation are calculated per-dimension over + the mini-batches and gamma and beta are learnable parameter vectors + of size C (where C is the input size). + + During training, this layer keeps a running estimate of its computed mean + and variance. The running sum is kept with a default momentum of 0.1. + + During evaluation, this running mean/variance is used for normalization. + + Because the BatchNorm is done over the `C` dimension, computing statistics + on `(N, L)` slices, it's common terminology to call this Temporal BatchNorm + + Args: + num_features: num_features from an expected input of size + `batch_size x num_features [x width]` + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Default: 0.1 + affine: a boolean value that when set to ``True``, gives the layer learnable + affine parameters. Default: ``True`` + + Shape:: + - Input: :math:`(N, C)` or :math:`(N, C, L)` + - Output: :math:`(N, C)` or :math:`(N, C, L)` (same shape as input) + + Examples: + >>> # With Learnable Parameters + >>> m = SynchronizedBatchNorm1d(100) + >>> # Without Learnable Parameters + >>> m = SynchronizedBatchNorm1d(100, affine=False) + >>> input = torch.autograd.Variable(torch.randn(20, 100)) + >>> output = m(input) + """ + + def _check_input_dim(self, input): + if input.dim() != 2 and input.dim() != 3: + raise ValueError('expected 2D or 3D input (got {}D input)' + .format(input.dim())) + super(SynchronizedBatchNorm1d, self)._check_input_dim(input) + + +class SynchronizedBatchNorm2d(_SynchronizedBatchNorm): + r"""Applies Batch Normalization over a 4d input that is seen as a mini-batch + of 3d inputs + + .. math:: + + y = \frac{x - mean[x]}{ \sqrt{Var[x] + \epsilon}} * gamma + beta + + This module differs from the built-in PyTorch BatchNorm2d as the mean and + standard-deviation are reduced across all devices during training. + + For example, when one uses `nn.DataParallel` to wrap the network during + training, PyTorch's implementation normalize the tensor on each device using + the statistics only on that device, which accelerated the computation and + is also easy to implement, but the statistics might be inaccurate. + Instead, in this synchronized version, the statistics will be computed + over all training samples distributed on multiple devices. + + Note that, for one-GPU or CPU-only case, this module behaves exactly same + as the built-in PyTorch implementation. + + The mean and standard-deviation are calculated per-dimension over + the mini-batches and gamma and beta are learnable parameter vectors + of size C (where C is the input size). + + During training, this layer keeps a running estimate of its computed mean + and variance. The running sum is kept with a default momentum of 0.1. + + During evaluation, this running mean/variance is used for normalization. + + Because the BatchNorm is done over the `C` dimension, computing statistics + on `(N, H, W)` slices, it's common terminology to call this Spatial BatchNorm + + Args: + num_features: num_features from an expected input of + size batch_size x num_features x height x width + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Default: 0.1 + affine: a boolean value that when set to ``True``, gives the layer learnable + affine parameters. Default: ``True`` + + Shape:: + - Input: :math:`(N, C, H, W)` + - Output: :math:`(N, C, H, W)` (same shape as input) + + Examples: + >>> # With Learnable Parameters + >>> m = SynchronizedBatchNorm2d(100) + >>> # Without Learnable Parameters + >>> m = SynchronizedBatchNorm2d(100, affine=False) + >>> input = torch.autograd.Variable(torch.randn(20, 100, 35, 45)) + >>> output = m(input) + """ + + def _check_input_dim(self, input): + if input.dim() != 4: + raise ValueError('expected 4D input (got {}D input)' + .format(input.dim())) + super(SynchronizedBatchNorm2d, self)._check_input_dim(input) + + +class SynchronizedBatchNorm3d(_SynchronizedBatchNorm): + r"""Applies Batch Normalization over a 5d input that is seen as a mini-batch + of 4d inputs + + .. math:: + + y = \frac{x - mean[x]}{ \sqrt{Var[x] + \epsilon}} * gamma + beta + + This module differs from the built-in PyTorch BatchNorm3d as the mean and + standard-deviation are reduced across all devices during training. + + For example, when one uses `nn.DataParallel` to wrap the network during + training, PyTorch's implementation normalize the tensor on each device using + the statistics only on that device, which accelerated the computation and + is also easy to implement, but the statistics might be inaccurate. + Instead, in this synchronized version, the statistics will be computed + over all training samples distributed on multiple devices. + + Note that, for one-GPU or CPU-only case, this module behaves exactly same + as the built-in PyTorch implementation. + + The mean and standard-deviation are calculated per-dimension over + the mini-batches and gamma and beta are learnable parameter vectors + of size C (where C is the input size). + + During training, this layer keeps a running estimate of its computed mean + and variance. The running sum is kept with a default momentum of 0.1. + + During evaluation, this running mean/variance is used for normalization. + + Because the BatchNorm is done over the `C` dimension, computing statistics + on `(N, D, H, W)` slices, it's common terminology to call this Volumetric BatchNorm + or Spatio-temporal BatchNorm + + Args: + num_features: num_features from an expected input of + size batch_size x num_features x depth x height x width + eps: a value added to the denominator for numerical stability. + Default: 1e-5 + momentum: the value used for the running_mean and running_var + computation. Default: 0.1 + affine: a boolean value that when set to ``True``, gives the layer learnable + affine parameters. Default: ``True`` + + Shape:: + - Input: :math:`(N, C, D, H, W)` + - Output: :math:`(N, C, D, H, W)` (same shape as input) + + Examples: + >>> # With Learnable Parameters + >>> m = SynchronizedBatchNorm3d(100) + >>> # Without Learnable Parameters + >>> m = SynchronizedBatchNorm3d(100, affine=False) + >>> input = torch.autograd.Variable(torch.randn(20, 100, 35, 45, 10)) + >>> output = m(input) + """ + + def _check_input_dim(self, input): + if input.dim() != 5: + raise ValueError('expected 5D input (got {}D input)' + .format(input.dim())) + super(SynchronizedBatchNorm3d, self)._check_input_dim(input) + + +@contextlib.contextmanager +def patch_sync_batchnorm(): + import torch.nn as nn + + backup = nn.BatchNorm1d, nn.BatchNorm2d, nn.BatchNorm3d + + nn.BatchNorm1d = SynchronizedBatchNorm1d + nn.BatchNorm2d = SynchronizedBatchNorm2d + nn.BatchNorm3d = SynchronizedBatchNorm3d + + yield + + nn.BatchNorm1d, nn.BatchNorm2d, nn.BatchNorm3d = backup + + +def convert_model(module): + """Traverse the input module and its child recursively + and replace all instance of torch.nn.modules.batchnorm.BatchNorm*N*d + to SynchronizedBatchNorm*N*d + + Args: + module: the input module needs to be convert to SyncBN model + + Examples: + >>> import torch.nn as nn + >>> import torchvision + >>> # m is a standard pytorch model + >>> m = torchvision.models.resnet18(True) + >>> m = nn.DataParallel(m) + >>> # after convert, m is using SyncBN + >>> m = convert_model(m) + """ + if isinstance(module, torch.nn.DataParallel): + mod = module.module + mod = convert_model(mod) + mod = DataParallelWithCallback(mod) + return mod + + mod = module + for pth_module, sync_module in zip([torch.nn.modules.batchnorm.BatchNorm1d, + torch.nn.modules.batchnorm.BatchNorm2d, + torch.nn.modules.batchnorm.BatchNorm3d], + [SynchronizedBatchNorm1d, + SynchronizedBatchNorm2d, + SynchronizedBatchNorm3d]): + if isinstance(module, pth_module): + mod = sync_module(module.num_features, module.eps, module.momentum, module.affine) + mod.running_mean = module.running_mean + mod.running_var = module.running_var + if module.affine: + mod.weight.data = module.weight.data.clone().detach() + mod.bias.data = module.bias.data.clone().detach() + + for name, child in module.named_children(): + mod.add_module(name, convert_model(child)) + + return mod diff --git a/models/networks/sync_batchnorm/batchnorm_reimpl.py b/models/networks/sync_batchnorm/batchnorm_reimpl.py new file mode 100644 index 0000000000000000000000000000000000000000..18145c3353e13d482c492ae46df91a537669fca0 --- /dev/null +++ b/models/networks/sync_batchnorm/batchnorm_reimpl.py @@ -0,0 +1,74 @@ +#! /usr/bin/env python3 +# -*- coding: utf-8 -*- +# File : batchnorm_reimpl.py +# Author : acgtyrant +# Date : 11/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import torch +import torch.nn as nn +import torch.nn.init as init + +__all__ = ['BatchNorm2dReimpl'] + + +class BatchNorm2dReimpl(nn.Module): + """ + A re-implementation of batch normalization, used for testing the numerical + stability. + + Author: acgtyrant + See also: + https://github.com/vacancy/Synchronized-BatchNorm-PyTorch/issues/14 + """ + def __init__(self, num_features, eps=1e-5, momentum=0.1): + super().__init__() + + self.num_features = num_features + self.eps = eps + self.momentum = momentum + self.weight = nn.Parameter(torch.empty(num_features)) + self.bias = nn.Parameter(torch.empty(num_features)) + self.register_buffer('running_mean', torch.zeros(num_features)) + self.register_buffer('running_var', torch.ones(num_features)) + self.reset_parameters() + + def reset_running_stats(self): + self.running_mean.zero_() + self.running_var.fill_(1) + + def reset_parameters(self): + self.reset_running_stats() + init.uniform_(self.weight) + init.zeros_(self.bias) + + def forward(self, input_): + batchsize, channels, height, width = input_.size() + numel = batchsize * height * width + input_ = input_.permute(1, 0, 2, 3).contiguous().view(channels, numel) + sum_ = input_.sum(1) + sum_of_square = input_.pow(2).sum(1) + mean = sum_ / numel + sumvar = sum_of_square - sum_ * mean + + self.running_mean = ( + (1 - self.momentum) * self.running_mean + + self.momentum * mean.detach() + ) + unbias_var = sumvar / (numel - 1) + self.running_var = ( + (1 - self.momentum) * self.running_var + + self.momentum * unbias_var.detach() + ) + + bias_var = sumvar / numel + inv_std = 1 / (bias_var + self.eps).pow(0.5) + output = ( + (input_ - mean.unsqueeze(1)) * inv_std.unsqueeze(1) * + self.weight.unsqueeze(1) + self.bias.unsqueeze(1)) + + return output.view(channels, batchsize, height, width).permute(1, 0, 2, 3).contiguous() + diff --git a/models/networks/sync_batchnorm/comm.py b/models/networks/sync_batchnorm/comm.py new file mode 100644 index 0000000000000000000000000000000000000000..922f8c4a3adaa9b32fdcaef09583be03b0d7eb2b --- /dev/null +++ b/models/networks/sync_batchnorm/comm.py @@ -0,0 +1,137 @@ +# -*- coding: utf-8 -*- +# File : comm.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import queue +import collections +import threading + +__all__ = ['FutureResult', 'SlavePipe', 'SyncMaster'] + + +class FutureResult(object): + """A thread-safe future implementation. Used only as one-to-one pipe.""" + + def __init__(self): + self._result = None + self._lock = threading.Lock() + self._cond = threading.Condition(self._lock) + + def put(self, result): + with self._lock: + assert self._result is None, 'Previous result has\'t been fetched.' + self._result = result + self._cond.notify() + + def get(self): + with self._lock: + if self._result is None: + self._cond.wait() + + res = self._result + self._result = None + return res + + +_MasterRegistry = collections.namedtuple('MasterRegistry', ['result']) +_SlavePipeBase = collections.namedtuple('_SlavePipeBase', ['identifier', 'queue', 'result']) + + +class SlavePipe(_SlavePipeBase): + """Pipe for master-slave communication.""" + + def run_slave(self, msg): + self.queue.put((self.identifier, msg)) + ret = self.result.get() + self.queue.put(True) + return ret + + +class SyncMaster(object): + """An abstract `SyncMaster` object. + + - During the replication, as the data parallel will trigger an callback of each module, all slave devices should + call `register(id)` and obtain an `SlavePipe` to communicate with the master. + - During the forward pass, master device invokes `run_master`, all messages from slave devices will be collected, + and passed to a registered callback. + - After receiving the messages, the master device should gather the information and determine to message passed + back to each slave devices. + """ + + def __init__(self, master_callback): + """ + + Args: + master_callback: a callback to be invoked after having collected messages from slave devices. + """ + self._master_callback = master_callback + self._queue = queue.Queue() + self._registry = collections.OrderedDict() + self._activated = False + + def __getstate__(self): + return {'master_callback': self._master_callback} + + def __setstate__(self, state): + self.__init__(state['master_callback']) + + def register_slave(self, identifier): + """ + Register an slave device. + + Args: + identifier: an identifier, usually is the device id. + + Returns: a `SlavePipe` object which can be used to communicate with the master device. + + """ + if self._activated: + assert self._queue.empty(), 'Queue is not clean before next initialization.' + self._activated = False + self._registry.clear() + future = FutureResult() + self._registry[identifier] = _MasterRegistry(future) + return SlavePipe(identifier, self._queue, future) + + def run_master(self, master_msg): + """ + Main entry for the master device in each forward pass. + The messages were first collected from each devices (including the master device), and then + an callback will be invoked to compute the message to be sent back to each devices + (including the master device). + + Args: + master_msg: the message that the master want to send to itself. This will be placed as the first + message when calling `master_callback`. For detailed usage, see `_SynchronizedBatchNorm` for an example. + + Returns: the message to be sent back to the master device. + + """ + self._activated = True + + intermediates = [(0, master_msg)] + for i in range(self.nr_slaves): + intermediates.append(self._queue.get()) + + results = self._master_callback(intermediates) + assert results[0][0] == 0, 'The first result should belongs to the master.' + + for i, res in results: + if i == 0: + continue + self._registry[i].result.put(res) + + for i in range(self.nr_slaves): + assert self._queue.get() is True + + return results[0][1] + + @property + def nr_slaves(self): + return len(self._registry) diff --git a/models/networks/sync_batchnorm/replicate.py b/models/networks/sync_batchnorm/replicate.py new file mode 100644 index 0000000000000000000000000000000000000000..b71c7b8ed51a1d6c55b1f753bdd8d90bad79bd06 --- /dev/null +++ b/models/networks/sync_batchnorm/replicate.py @@ -0,0 +1,94 @@ +# -*- coding: utf-8 -*- +# File : replicate.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import functools + +from torch.nn.parallel.data_parallel import DataParallel + +__all__ = [ + 'CallbackContext', + 'execute_replication_callbacks', + 'DataParallelWithCallback', + 'patch_replication_callback' +] + + +class CallbackContext(object): + pass + + +def execute_replication_callbacks(modules): + """ + Execute an replication callback `__data_parallel_replicate__` on each module created by original replication. + + The callback will be invoked with arguments `__data_parallel_replicate__(ctx, copy_id)` + + Note that, as all modules are isomorphism, we assign each sub-module with a context + (shared among multiple copies of this module on different devices). + Through this context, different copies can share some information. + + We guarantee that the callback on the master copy (the first copy) will be called ahead of calling the callback + of any slave copies. + """ + master_copy = modules[0] + nr_modules = len(list(master_copy.modules())) + ctxs = [CallbackContext() for _ in range(nr_modules)] + + for i, module in enumerate(modules): + for j, m in enumerate(module.modules()): + if hasattr(m, '__data_parallel_replicate__'): + m.__data_parallel_replicate__(ctxs[j], i) + + +class DataParallelWithCallback(DataParallel): + """ + Data Parallel with a replication callback. + + An replication callback `__data_parallel_replicate__` of each module will be invoked after being created by + original `replicate` function. + The callback will be invoked with arguments `__data_parallel_replicate__(ctx, copy_id)` + + Examples: + > sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + > sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + # sync_bn.__data_parallel_replicate__ will be invoked. + """ + + def replicate(self, module, device_ids): + modules = super(DataParallelWithCallback, self).replicate(module, device_ids) + execute_replication_callbacks(modules) + return modules + + +def patch_replication_callback(data_parallel): + """ + Monkey-patch an existing `DataParallel` object. Add the replication callback. + Useful when you have customized `DataParallel` implementation. + + Examples: + > sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + > sync_bn = DataParallel(sync_bn, device_ids=[0, 1]) + > patch_replication_callback(sync_bn) + # this is equivalent to + > sync_bn = SynchronizedBatchNorm1d(10, eps=1e-5, affine=False) + > sync_bn = DataParallelWithCallback(sync_bn, device_ids=[0, 1]) + """ + + assert isinstance(data_parallel, DataParallel) + + old_replicate = data_parallel.replicate + + @functools.wraps(old_replicate) + def new_replicate(module, device_ids): + modules = old_replicate(module, device_ids) + execute_replication_callbacks(modules) + return modules + + data_parallel.replicate = new_replicate diff --git a/models/networks/sync_batchnorm/unittest.py b/models/networks/sync_batchnorm/unittest.py new file mode 100644 index 0000000000000000000000000000000000000000..bed56f1caa929ac3e9a57c583f8d3e42624f58be --- /dev/null +++ b/models/networks/sync_batchnorm/unittest.py @@ -0,0 +1,29 @@ +# -*- coding: utf-8 -*- +# File : unittest.py +# Author : Jiayuan Mao +# Email : maojiayuan@gmail.com +# Date : 27/01/2018 +# +# This file is part of Synchronized-BatchNorm-PyTorch. +# https://github.com/vacancy/Synchronized-BatchNorm-PyTorch +# Distributed under MIT License. + +import unittest +import torch + + +class TorchTestCase(unittest.TestCase): + def assertTensorClose(self, x, y): + adiff = float((x - y).abs().max()) + if (y == 0).all(): + rdiff = 'NaN' + else: + rdiff = float((adiff / y).abs().max()) + + message = ( + 'Tensor close check failed\n' + 'adiff={}\n' + 'rdiff={}\n' + ).format(adiff, rdiff) + self.assertTrue(torch.allclose(x, y), message) + diff --git a/models/pix2pix_model.py b/models/pix2pix_model.py new file mode 100644 index 0000000000000000000000000000000000000000..4776a3ba417df38cd96a74bf33b92054627243b9 --- /dev/null +++ b/models/pix2pix_model.py @@ -0,0 +1,232 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import torch +import models.networks as networks +import utils.inference.util as util +import random + + +class Pix2PixModel(torch.nn.Module): + @staticmethod + def modify_commandline_options(parser, is_train): + networks.modify_commandline_options(parser, is_train) + return parser + + def __init__(self, opt): + super().__init__() + self.opt = opt + self.FloatTensor = torch.cuda.FloatTensor if self.use_gpu() \ + else torch.FloatTensor + self.ByteTensor = torch.cuda.ByteTensor if self.use_gpu() \ + else torch.ByteTensor + + self.netG, self.netD, self.netE = self.initialize_networks(opt) + + # set loss functions + if opt.isTrain: + self.criterionGAN = networks.GANLoss( + opt.gan_mode, tensor=self.FloatTensor, opt=self.opt) + self.criterionFeat = torch.nn.L1Loss() + if not opt.no_vgg_loss: + self.criterionVGG = networks.VGGLoss(self.opt.gpu_ids) + if opt.use_vae: + self.KLDLoss = networks.KLDLoss() + + # Entry point for all calls involving forward pass + # of deep networks. We used this approach since DataParallel module + # can't parallelize custom functions, we branch to different + # routines based on |mode|. + def forward(self, data, mode): + input_semantics, real_image = self.preprocess_input(data) + # input_semantics, real_image = data['label'], data['image'] + + if mode == 'generator': + g_loss, generated = self.compute_generator_loss(input_semantics, real_image) + return g_loss, generated + elif mode == 'discriminator': + d_loss = self.compute_discriminator_loss( + input_semantics, real_image) + return d_loss + elif mode == 'inference': + with torch.no_grad(): + fake_image = self.generate_fake(input_semantics) + return fake_image + elif mode == 'inference2': + with torch.no_grad(): + fake_image = self.netG(input_semantics) + return fake_image + else: + raise ValueError("|mode| is invalid") + + def preprocess_input(self, data): + if self.use_gpu(): + data['label'] = data['label'].cuda() + data['image'] = data['image'].cuda() + + return data['label'], data['image'] + + def compute_generator_loss(self, input_semantics, real_image): + G_losses = {} + + fake_image = self.generate_fake(input_semantics) + + pred_fake, pred_real = self.discriminate(input_semantics, fake_image, real_image) + + G_losses['GAN'] = self.criterionGAN(pred_fake, True, + for_discriminator=False) + + if not self.opt.no_ganFeat_loss: + num_D = len(pred_fake) + GAN_Feat_loss = self.FloatTensor(1).fill_(0) + for i in range(num_D): # for each discriminator + # last output is the final prediction, so we exclude it + num_intermediate_outputs = len(pred_fake[i]) - 1 + for j in range(num_intermediate_outputs): # for each layer output + unweighted_loss = self.criterionFeat(pred_fake[i][j], pred_real[i][j].detach()) + GAN_Feat_loss += unweighted_loss * self.opt.lambda_feat / num_D + G_losses['GAN_Feat'] = GAN_Feat_loss + + h ,w = fake_image.shape[-2:] + if not self.opt.no_vgg_loss and min(w,h)>=64: + G_losses['VGG'] = self.criterionVGG(fake_image, real_image) \ + * self.opt.lambda_vgg + + return G_losses, fake_image + + def compute_discriminator_loss(self, input_semantics, real_image): + D_losses = {} + with torch.no_grad(): + fake_image = self.generate_fake(input_semantics) + fake_image = fake_image.detach() + fake_image.requires_grad_() + + pred_fake, pred_real = self.discriminate( + input_semantics, fake_image, real_image) + + D_losses['D_Fake'] = self.criterionGAN(pred_fake, False, + for_discriminator=True) + D_losses['D_real'] = self.criterionGAN(pred_real, True, + for_discriminator=True) + + return D_losses + + def generate_fake(self, input_semantics): + # input_semantics = torch.nn.functional.interpolate(input_semantics, size=(h//4, w//4), + # mode='nearest')#[:, :, ::4, ::4] + + fake_image = self.netG(input_semantics) + + return fake_image + + def discriminate(self, input_semantics, fake_image, real_image): + h, w = fake_image.shape[-2:] + if fake_image.shape[-2:]!=input_semantics.shape[-2:]: + semantics = torch.nn.functional.interpolate(input_semantics, (h, w)) + real = torch.nn.functional.interpolate(real_image, (h, w)) + fake_concat = torch.cat([semantics, fake_image], dim=1) + real_concat = torch.cat([semantics, real], dim=1) + else: + fake_concat = torch.cat([input_semantics, fake_image], dim=1) + real_concat = torch.cat([input_semantics, real_image], dim=1) + # fake_concat = fake_image + # real_concat = real_image + + # In Batch Normalization, the fake and real images are + # recommended to be in the same batch to avoid disparate + # statistics in fake and real images. + # So both fake and real images are fed to D all at once. + fake_and_real = torch.cat([fake_concat, real_concat], dim=0) + + discriminator_out = self.netD(fake_and_real) + + pred_fake, pred_real = self.divide_pred(discriminator_out) + + return pred_fake, pred_real + + def encode_z(self, real_image): + mu, logvar = self.netE(real_image) + z = self.reparameterize(mu, logvar) + return z, mu, logvar + + def create_optimizers(self, opt): + G_params = list(self.netG.parameters()) + if opt.use_vae: + G_params += list(self.netE.parameters()) + if opt.isTrain: + D_params = list(self.netD.parameters()) + + beta1, beta2 = opt.beta1, opt.beta2 + if opt.no_TTUR: + G_lr, D_lr = opt.lr, opt.lr + else: + G_lr, D_lr = opt.lr / 2, opt.lr * 2 + + optimizer_G = torch.optim.Adam(G_params, lr=G_lr, betas=(beta1, beta2)) + optimizer_D = torch.optim.Adam(D_params, lr=D_lr, betas=(beta1, beta2)) + + return optimizer_G, optimizer_D + + def save(self, epoch): + util.save_network(self.netG, 'G', epoch, self.opt) + util.save_network(self.netD, 'D', epoch, self.opt) + if self.opt.use_vae: + util.save_network(self.netE, 'E', epoch, self.opt) + + ############################################################################ + # Private helper methods + ############################################################################ + + def initialize_networks(self, opt): + netG = networks.define_G(opt) + netD = networks.define_D(opt) if opt.isTrain else None + netE = networks.define_E(opt) if opt.use_vae else None + + if not opt.isTrain or opt.continue_train: + netG = util.load_network(netG, 'G', opt.which_epoch, opt) + if opt.isTrain: + netD = util.load_network(netD, 'D', opt.which_epoch, opt) + if opt.use_vae: + netE = util.load_network(netE, 'E', opt.which_epoch, opt) + + return netG, netD, netE + + # preprocess the input, such as moving the tensors to GPUs and + # transforming the label map to one-hot encoding + # |data|: dictionary of the input data + + + + # Take the prediction of fake and real images from the combined batch + def divide_pred(self, pred): + # the prediction contains the intermediate outputs of multiscale GAN, + # so it's usually a list + if type(pred) == list: + fake = [] + real = [] + for p in pred: + fake.append([tensor[:tensor.size(0) // 2] for tensor in p]) + real.append([tensor[tensor.size(0) // 2:] for tensor in p]) + else: + fake = pred[:pred.size(0) // 2] + real = pred[pred.size(0) // 2:] + + return fake, real + + def get_edges(self, t): + edge = self.ByteTensor(t.size()).zero_() + edge[:, :, :, 1:] = edge[:, :, :, 1:] | (t[:, :, :, 1:] != t[:, :, :, :-1]) + edge[:, :, :, :-1] = edge[:, :, :, :-1] | (t[:, :, :, 1:] != t[:, :, :, :-1]) + edge[:, :, 1:, :] = edge[:, :, 1:, :] | (t[:, :, 1:, :] != t[:, :, :-1, :]) + edge[:, :, :-1, :] = edge[:, :, :-1, :] | (t[:, :, 1:, :] != t[:, :, :-1, :]) + return edge.float() + + def reparameterize(self, mu, logvar): + std = torch.exp(0.5 * logvar) + eps = torch.randn_like(std) + return eps.mul(std) + mu + + def use_gpu(self): + return len(self.opt.gpu_ids) > 0 diff --git a/network/AADLayer.py b/network/AADLayer.py new file mode 100644 index 0000000000000000000000000000000000000000..a6afb62706b499aa78cbcd96532811f479311bde --- /dev/null +++ b/network/AADLayer.py @@ -0,0 +1,83 @@ +import torch +import torch.nn as nn + + +class AADLayer(nn.Module): + def __init__(self, c_x, attr_c, c_id): + super(AADLayer, self).__init__() + self.attr_c = attr_c + self.c_id = c_id + self.c_x = c_x + + self.conv1 = nn.Conv2d(attr_c, c_x, kernel_size=1, stride=1, padding=0, bias=True) + self.conv2 = nn.Conv2d(attr_c, c_x, kernel_size=1, stride=1, padding=0, bias=True) + self.fc1 = nn.Linear(c_id, c_x) + self.fc2 = nn.Linear(c_id, c_x) + self.norm = nn.InstanceNorm2d(c_x, affine=False) + + self.conv_h = nn.Conv2d(c_x, 1, kernel_size=1, stride=1, padding=0, bias=True) + + def forward(self, h_in, z_attr, z_id): + # h_in cxnxn + # zid 256x1x1 + # zattr cxnxn + h = self.norm(h_in) + gamma_attr = self.conv1(z_attr) + beta_attr = self.conv2(z_attr) + + gamma_id = self.fc1(z_id) + beta_id = self.fc2(z_id) + A = gamma_attr * h + beta_attr + gamma_id = gamma_id.reshape(h.shape[0], self.c_x, 1, 1).expand_as(h) + beta_id = beta_id.reshape(h.shape[0], self.c_x, 1, 1).expand_as(h) + I = gamma_id * h + beta_id + + M = torch.sigmoid(self.conv_h(h)) + + out = (torch.ones_like(M).to(M.device) - M) * A + M * I + return out + + +class AddBlocksSequential(nn.Sequential): + def forward(self, *inputs): + h, z_attr, z_id = inputs + for i, module in enumerate(self._modules.values()): + if i%3 == 0 and i > 0: + inputs = (inputs, z_attr, z_id) + if type(inputs) == tuple: + inputs = module(*inputs) + else: + inputs = module(inputs) + return inputs + + +class AAD_ResBlk(nn.Module): + def __init__(self, cin, cout, c_attr, c_id, num_blocks): + super(AAD_ResBlk, self).__init__() + self.cin = cin + self.cout = cout + + add_blocks = [] + for i in range(num_blocks): + out = cin if i < (num_blocks-1) else cout + add_blocks.extend([AADLayer(cin, c_attr, c_id), + nn.ReLU(inplace=True), + nn.Conv2d(cin, out, kernel_size=3, stride=1, padding=1, bias=False) + ]) + self.add_blocks = AddBlocksSequential(*add_blocks) + + if cin != cout: + last_add_block = [AADLayer(cin, c_attr, c_id), + nn.ReLU(inplace=True), + nn.Conv2d(cin, cout, kernel_size=3, stride=1, padding=1, bias=False)] + self.last_add_block = AddBlocksSequential(*last_add_block) + + + def forward(self, h, z_attr, z_id): + x = self.add_blocks(h, z_attr, z_id) + if self.cin != self.cout: + h = self.last_add_block(h, z_attr, z_id) + x = x + h + return x + + diff --git a/network/AEI_Net.py b/network/AEI_Net.py new file mode 100644 index 0000000000000000000000000000000000000000..62d7d7e3982986cfaf2725dc92dcb4b62cf18371 --- /dev/null +++ b/network/AEI_Net.py @@ -0,0 +1,154 @@ +import torch +import torch.nn as nn +import torch.nn.functional as F +from .AADLayer import * +from network.resnet import MLAttrEncoderResnet + + +def weight_init(m): + if isinstance(m, nn.Linear): + m.weight.data.normal_(0, 0.001) + m.bias.data.zero_() + if isinstance(m, nn.Conv2d): + nn.init.xavier_normal_(m.weight.data) + + if isinstance(m, nn.ConvTranspose2d): + nn.init.xavier_normal_(m.weight.data) + + +def conv4x4(in_c, out_c, norm=nn.BatchNorm2d): + return nn.Sequential( + nn.Conv2d(in_channels=in_c, out_channels=out_c, kernel_size=4, stride=2, padding=1, bias=False), + norm(out_c), + nn.LeakyReLU(0.1, inplace=True) + ) + + +class deconv4x4(nn.Module): + def __init__(self, in_c, out_c, norm=nn.BatchNorm2d): + super(deconv4x4, self).__init__() + self.deconv = nn.ConvTranspose2d(in_channels=in_c, out_channels=out_c, kernel_size=4, stride=2, padding=1, bias=False) + self.bn = norm(out_c) + self.lrelu = nn.LeakyReLU(0.1, inplace=True) + + def forward(self, input, skip, backbone): + x = self.deconv(input) + x = self.bn(x) + x = self.lrelu(x) + if backbone == 'linknet': + return x+skip + else: + return torch.cat((x, skip), dim=1) + + +class MLAttrEncoder(nn.Module): + def __init__(self, backbone): + super(MLAttrEncoder, self).__init__() + self.backbone = backbone + self.conv1 = conv4x4(3, 32) + self.conv2 = conv4x4(32, 64) + self.conv3 = conv4x4(64, 128) + self.conv4 = conv4x4(128, 256) + self.conv5 = conv4x4(256, 512) + self.conv6 = conv4x4(512, 1024) + self.conv7 = conv4x4(1024, 1024) + + if backbone == 'unet': + self.deconv1 = deconv4x4(1024, 1024) + self.deconv2 = deconv4x4(2048, 512) + self.deconv3 = deconv4x4(1024, 256) + self.deconv4 = deconv4x4(512, 128) + self.deconv5 = deconv4x4(256, 64) + self.deconv6 = deconv4x4(128, 32) + elif backbone == 'linknet': + self.deconv1 = deconv4x4(1024, 1024) + self.deconv2 = deconv4x4(1024, 512) + self.deconv3 = deconv4x4(512, 256) + self.deconv4 = deconv4x4(256, 128) + self.deconv5 = deconv4x4(128, 64) + self.deconv6 = deconv4x4(64, 32) + self.apply(weight_init) + + def forward(self, Xt): + feat1 = self.conv1(Xt) + # 32x128x128 + feat2 = self.conv2(feat1) + # 64x64x64 + feat3 = self.conv3(feat2) + # 128x32x32 + feat4 = self.conv4(feat3) + # 256x16xx16 + feat5 = self.conv5(feat4) + # 512x8x8 + feat6 = self.conv6(feat5) + # 1024x4x4 + z_attr1 = self.conv7(feat6) + # 1024x2x2 + + z_attr2 = self.deconv1(z_attr1, feat6, self.backbone) + z_attr3 = self.deconv2(z_attr2, feat5, self.backbone) + z_attr4 = self.deconv3(z_attr3, feat4, self.backbone) + z_attr5 = self.deconv4(z_attr4, feat3, self.backbone) + z_attr6 = self.deconv5(z_attr5, feat2, self.backbone) + z_attr7 = self.deconv6(z_attr6, feat1, self.backbone) + z_attr8 = F.interpolate(z_attr7, scale_factor=2, mode='bilinear', align_corners=True) + return z_attr1, z_attr2, z_attr3, z_attr4, z_attr5, z_attr6, z_attr7, z_attr8 + + +class AADGenerator(nn.Module): + def __init__(self, backbone, c_id=256, num_blocks=2): + super(AADGenerator, self).__init__() + self.up1 = nn.ConvTranspose2d(c_id, 1024, kernel_size=2, stride=1, padding=0) + self.AADBlk1 = AAD_ResBlk(1024, 1024, 1024, c_id, num_blocks) + if backbone == 'linknet': + self.AADBlk2 = AAD_ResBlk(1024, 1024, 1024, c_id, num_blocks) + self.AADBlk3 = AAD_ResBlk(1024, 1024, 512, c_id, num_blocks) + self.AADBlk4 = AAD_ResBlk(1024, 512, 256, c_id, num_blocks) + self.AADBlk5 = AAD_ResBlk(512, 256, 128, c_id, num_blocks) + self.AADBlk6 = AAD_ResBlk(256, 128, 64, c_id, num_blocks) + self.AADBlk7 = AAD_ResBlk(128, 64, 32, c_id, num_blocks) + self.AADBlk8 = AAD_ResBlk(64, 3, 32, c_id, num_blocks) + else: + self.AADBlk2 = AAD_ResBlk(1024, 1024, 2048, c_id, num_blocks) + self.AADBlk3 = AAD_ResBlk(1024, 1024, 1024, c_id, num_blocks) + self.AADBlk4 = AAD_ResBlk(1024, 512, 512, c_id, num_blocks) + self.AADBlk5 = AAD_ResBlk(512, 256, 256, c_id, num_blocks) + self.AADBlk6 = AAD_ResBlk(256, 128, 128, c_id, num_blocks) + self.AADBlk7 = AAD_ResBlk(128, 64, 64, c_id, num_blocks) + self.AADBlk8 = AAD_ResBlk(64, 3, 64, c_id, num_blocks) + + self.apply(weight_init) + + def forward(self, z_attr, z_id): + m = self.up1(z_id.reshape(z_id.shape[0], -1, 1, 1)) + m2 = F.interpolate(self.AADBlk1(m, z_attr[0], z_id), scale_factor=2, mode='bilinear', align_corners=True) + m3 = F.interpolate(self.AADBlk2(m2, z_attr[1], z_id), scale_factor=2, mode='bilinear', align_corners=True) + m4 = F.interpolate(self.AADBlk3(m3, z_attr[2], z_id), scale_factor=2, mode='bilinear', align_corners=True) + m5 = F.interpolate(self.AADBlk4(m4, z_attr[3], z_id), scale_factor=2, mode='bilinear', align_corners=True) + m6 = F.interpolate(self.AADBlk5(m5, z_attr[4], z_id), scale_factor=2, mode='bilinear', align_corners=True) + m7 = F.interpolate(self.AADBlk6(m6, z_attr[5], z_id), scale_factor=2, mode='bilinear', align_corners=True) + m8 = F.interpolate(self.AADBlk7(m7, z_attr[6], z_id), scale_factor=2, mode='bilinear', align_corners=True) + y = self.AADBlk8(m8, z_attr[7], z_id) + return torch.tanh(y) + + + +class AEI_Net(nn.Module): + def __init__(self, backbone, num_blocks=2, c_id=256): + super(AEI_Net, self).__init__() + if backbone in ['unet', 'linknet']: + self.encoder = MLAttrEncoder(backbone) + elif backbone == 'resnet': + self.encoder = MLAttrEncoderResnet() + self.generator = AADGenerator(backbone, c_id, num_blocks) + + def forward(self, Xt, z_id): + attr = self.encoder(Xt) + Y = self.generator(attr, z_id) + return Y, attr + + def get_attr(self, X): + return self.encoder(X) + + + diff --git a/network/MultiscaleDiscriminator.py b/network/MultiscaleDiscriminator.py new file mode 100644 index 0000000000000000000000000000000000000000..bdac8f058898f0d8211a246adaf5393f1720c175 --- /dev/null +++ b/network/MultiscaleDiscriminator.py @@ -0,0 +1,97 @@ +import torch.nn as nn +import numpy as np + + +class NLayerDiscriminator(nn.Module): + def __init__(self, input_nc, ndf=64, n_layers=3, norm_layer=nn.BatchNorm2d, use_sigmoid=False, getIntermFeat=False): + super(NLayerDiscriminator, self).__init__() + self.getIntermFeat = getIntermFeat + self.n_layers = n_layers + + kw = 4 + padw = int(np.ceil((kw-1.0)/2)) + sequence = [[nn.Conv2d(input_nc, ndf, kernel_size=kw, stride=2, padding=padw), nn.LeakyReLU(0.2, True)]] + + nf = ndf + for n in range(1, n_layers): + nf_prev = nf + nf = min(nf * 2, 512) + sequence += [[ + nn.Conv2d(nf_prev, nf, kernel_size=kw, stride=2, padding=padw), + norm_layer(nf), nn.LeakyReLU(0.2, True) + ]] + + nf_prev = nf + nf = min(nf * 2, 512) + sequence += [[ + nn.Conv2d(nf_prev, nf, kernel_size=kw, stride=1, padding=padw), + norm_layer(nf), + nn.LeakyReLU(0.2, True) + ]] + + sequence += [[nn.Conv2d(nf, 1, kernel_size=kw, stride=1, padding=padw)]] + + if use_sigmoid: + sequence += [[nn.Sigmoid()]] + + if getIntermFeat: + for n in range(len(sequence)): + setattr(self, 'model'+str(n), nn.Sequential(*sequence[n])) + else: + sequence_stream = [] + for n in range(len(sequence)): + sequence_stream += sequence[n] + self.model = nn.Sequential(*sequence_stream) + + def forward(self, input): + if self.getIntermFeat: + res = [input] + for n in range(self.n_layers+2): + model = getattr(self, 'model'+str(n)) + res.append(model(res[-1])) + return res[1:] + else: + return self.model(input) + + +class MultiscaleDiscriminator(nn.Module): + def __init__(self, input_nc, ndf=64, n_layers=3, norm_layer=nn.BatchNorm2d, + use_sigmoid=False, num_D=3, getIntermFeat=False): + super(MultiscaleDiscriminator, self).__init__() + self.num_D = num_D + self.n_layers = n_layers + self.getIntermFeat = getIntermFeat + + for i in range(num_D): + netD = NLayerDiscriminator(input_nc, ndf, n_layers, norm_layer, use_sigmoid, getIntermFeat) + if getIntermFeat: + for j in range(n_layers + 2): + setattr(self, 'scale' + str(i) + '_layer' + str(j), getattr(netD, 'model' + str(j))) + else: + setattr(self, 'layer' + str(i), netD.model) + + self.downsample = nn.AvgPool2d(3, stride=2, padding=[1, 1], count_include_pad=False) + + def singleD_forward(self, model, input): + if self.getIntermFeat: + result = [input] + for i in range(len(model)): + result.append(model[i](result[-1])) + return result[1:] + else: + return [model(input)] + + def forward(self, input): + num_D = self.num_D + result = [] + input_downsampled = input + for i in range(num_D): + if self.getIntermFeat: + model = [getattr(self, 'scale' + str(num_D - 1 - i) + '_layer' + str(j)) for j in + range(self.n_layers + 2)] + else: + model = getattr(self, 'layer' + str(num_D - 1 - i)) + result.append(self.singleD_forward(model, input_downsampled)) + if i != (num_D - 1): + input_downsampled = self.downsample(input_downsampled) + return result diff --git a/network/__init__.py b/network/__init__.py new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/network/resnet.py b/network/resnet.py new file mode 100644 index 0000000000000000000000000000000000000000..7bbf7d0b16035b7ccb9b6b02418d2d78ada49d45 --- /dev/null +++ b/network/resnet.py @@ -0,0 +1,149 @@ +import torch.nn as nn +import math + + +def conv3x3(in_planes, out_planes, stride=1): + """3x3 convolution with padding""" + return nn.Conv2d(in_planes, out_planes, kernel_size=3, stride=stride, + padding=1, bias=False) + + +class BasicBlock(nn.Module): + expansion = 1 + + def __init__(self, inplanes, planes, stride=1, downsample=None): + super(BasicBlock, self).__init__() + self.conv1 = conv3x3(inplanes, planes, stride) + self.bn1 = nn.BatchNorm2d(planes) + self.relu = nn.ReLU(inplace=True) + self.conv2 = conv3x3(planes, planes) + self.bn2 = nn.BatchNorm2d(planes) + self.downsample = downsample + self.stride = stride + + def forward(self, x): + residual = x + + out = self.conv1(x) + out = self.bn1(out) + out = self.relu(out) + + out = self.conv2(out) + out = self.bn2(out) + + if self.downsample is not None: + residual = self.downsample(x) + + out += residual + out = self.relu(out) + + return out + + +class Bottleneck(nn.Module): + expansion = 4 + + def __init__(self, inplanes, planes, stride=1, downsample=None): + super(Bottleneck, self).__init__() + self.conv1 = nn.Conv2d(inplanes, planes, kernel_size=1, stride=stride, bias=False) + self.bn1 = nn.BatchNorm2d(planes) + self.conv2 = nn.Conv2d(planes, planes, kernel_size=3, stride=1, padding=1, bias=False) + self.bn2 = nn.BatchNorm2d(planes) + self.conv3 = nn.Conv2d(planes, planes * 4, kernel_size=1, bias=False) + self.bn3 = nn.BatchNorm2d(planes * 4) + self.relu = nn.ReLU(inplace=True) + self.downsample = downsample + self.stride = stride + + def forward(self, x): + residual = x + + out = self.conv1(x) + out = self.bn1(out) + out = self.relu(out) + + out = self.conv2(out) + out = self.bn2(out) + out = self.relu(out) + + out = self.conv3(out) + out = self.bn3(out) + + if self.downsample is not None: + residual = self.downsample(x) + + out += residual + out = self.relu(out) + + return out + + +class ResNet(nn.Module): + + def __init__(self, block, layers, num_classes=1000, include_top=True): + self.inplanes = 64 + super(ResNet, self).__init__() + self.include_top = include_top + + self.conv0 = nn.Conv2d(3, 64, kernel_size=7, stride=1, padding=3, bias=False) + self.bn0 = nn.BatchNorm2d(64) + self.relu0 = nn.ReLU(inplace=True) + + self.conv1 = nn.Conv2d(64, 64, kernel_size=7, stride=2, padding=3, bias=False) + self.bn1 = nn.BatchNorm2d(64) + self.relu = nn.ReLU(inplace=True) + + self.layer1 = self._make_layer(block, 32, layers[0], stride=2) + self.layer2 = self._make_layer(block, 64, layers[1], stride=2) + self.layer3 = self._make_layer(block, 128, layers[2], stride=2) + self.layer4 = self._make_layer(block, 256, layers[3], stride=2) + self.layer5 = self._make_layer(block, 512, layers[4], stride=2) + self.layer6 = self._make_layer(block, 256, layers[5], stride=2) + + for m in self.modules(): + if isinstance(m, nn.Conv2d): + n = m.kernel_size[0] * m.kernel_size[1] * m.out_channels + m.weight.data.normal_(0, math.sqrt(2. / n)) + elif isinstance(m, nn.BatchNorm2d): + m.weight.data.fill_(1) + m.bias.data.zero_() + + def _make_layer(self, block, planes, blocks, stride=1): + downsample = None + if stride != 1 or self.inplanes != planes * block.expansion: + downsample = nn.Sequential( + nn.Conv2d(self.inplanes, planes * block.expansion, + kernel_size=1, stride=stride, bias=False), + nn.BatchNorm2d(planes * block.expansion), + ) + + layers = [] + layers.append(block(self.inplanes, planes, stride, downsample)) + self.inplanes = planes * block.expansion + for i in range(1, blocks): + layers.append(block(self.inplanes, planes)) + + return nn.Sequential(*layers) + + def forward(self, x): + x0 = self.conv0(x) + x0 = self.bn0(x0) + x0 = self.relu0(x0) + + x1 = self.conv1(x0) + x1 = self.bn1(x1) + x1 = self.relu(x1) + + x2 = self.layer1(x1) + x3 = self.layer2(x2) + x4 = self.layer3(x3) + x5 = self.layer4(x4) + x6 = self.layer5(x5) + x7 = self.layer6(x6) + + return x7, x6, x5, x4, x3, x2, x1, x0 + + +def MLAttrEncoderResnet(**kwargs): + model = ResNet(Bottleneck, [2, 2, 2, 2, 2, 2], **kwargs) + return model \ No newline at end of file diff --git a/preprocess_vgg.py b/preprocess_vgg.py new file mode 100644 index 0000000000000000000000000000000000000000..5c74cf4347659df4ffc87a31a17c8e5138eb39f4 --- /dev/null +++ b/preprocess_vgg.py @@ -0,0 +1,39 @@ +import os +import sys +import cv2 +import argparse +from insightface_func.face_detect_crop_single import Face_detect_crop +from pathlib import Path +from tqdm import tqdm + +def main(args): + app = Face_detect_crop(name='antelope', root='./insightface_func/models') + app.prepare(ctx_id= 0, det_thresh=0.6, det_size=(640,640)) + crop_size = 224 + + dirs = os.listdir(args.path_to_dataset) + for i in tqdm(range(len(dirs))): + d = os.path.join(args.path_to_dataset, dirs[i]) + dir_to_save = os.path.join(args.save_path, dirs[i]) + Path(dir_to_save).mkdir(parents=True, exist_ok=True) + + image_names = os.listdir(d) + for image_name in image_names: + try: + image_path = os.path.join(d, image_name) + image = cv2.imread(image_path) + cropped_image, _ = app.get(image, crop_size) + cv2.imwrite(os.path.join(dir_to_save, image_name), cropped_image[0]) + except: + pass + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + + parser.add_argument('--path_to_dataset', default='./VggFace2/VGG-Face2/data/preprocess_train', type=str) + parser.add_argument('--save_path', default='./VggFace2-crop', type=str) + + args = parser.parse_args() + + main(args) diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000000000000000000000000000000000000..d256a974a8add63c78083b4f3609498adb16559b --- /dev/null +++ b/requirements.txt @@ -0,0 +1,15 @@ +numpy +-f https://download.pytorch.org/whl/torch_stable.html +torch==1.6.0+cu101 +-f https://download.pytorch.org/whl/torch_stable.html +torchvision==0.7.0+cu101 +opencv-python +onnx==1.9.0 +onnxruntime-gpu==1.4.0 +mxnet-cu101mkl +scikit-image +insightface==0.2.1 +requests==2.25.1 +kornia==0.5.4 +dill +wandb \ No newline at end of file diff --git a/train.py b/train.py new file mode 100644 index 0000000000000000000000000000000000000000..84c1f7e5b97fa10734249d5e62d5e1bad3c1e351 --- /dev/null +++ b/train.py @@ -0,0 +1,335 @@ +print("started imports") + +import sys +import argparse +import time +import cv2 +import wandb +from PIL import Image +import os + +from torch.utils.data import DataLoader +import torch.optim as optim +import torch.nn.functional as F +import torch +import torchvision.transforms as transforms +import torch.optim.lr_scheduler as scheduler + +# custom imports +sys.path.append('./apex/') + +from apex import amp +from network.AEI_Net import * +from network.MultiscaleDiscriminator import * +from utils.training.Dataset import FaceEmbedVGG2, FaceEmbed +from utils.training.image_processing import make_image_list, get_faceswap +from utils.training.losses import hinge_loss, compute_discriminator_loss, compute_generator_losses +from utils.training.detector import detect_landmarks, paint_eyes +from AdaptiveWingLoss.core import models +from arcface_model.iresnet import iresnet100 + +print("finished imports") + + +def train_one_epoch(G: 'generator model', + D: 'discriminator model', + opt_G: "generator opt", + opt_D: "discriminator opt", + scheduler_G: "scheduler G opt", + scheduler_D: "scheduler D opt", + netArc: 'ArcFace model', + model_ft: 'Landmark Detector', + args: 'Args Namespace', + dataloader: torch.utils.data.DataLoader, + device: 'torch device', + epoch:int, + loss_adv_accumulated:int): + + for iteration, data in enumerate(dataloader): + start_time = time.time() + + Xs_orig, Xs, Xt, same_person = data + + Xs_orig = Xs_orig.to(device) + Xs = Xs.to(device) + Xt = Xt.to(device) + same_person = same_person.to(device) + + # get the identity embeddings of Xs + with torch.no_grad(): + embed = netArc(F.interpolate(Xs_orig, [112, 112], mode='bilinear', align_corners=False)) + + diff_person = torch.ones_like(same_person) + + if args.diff_eq_same: + same_person = diff_person + + # generator training + opt_G.zero_grad() + + Y, Xt_attr = G(Xt, embed) + Di = D(Y) + ZY = netArc(F.interpolate(Y, [112, 112], mode='bilinear', align_corners=False)) + + if args.eye_detector_loss: + Xt_eyes, Xt_heatmap_left, Xt_heatmap_right = detect_landmarks(Xt, model_ft) + Y_eyes, Y_heatmap_left, Y_heatmap_right = detect_landmarks(Y, model_ft) + eye_heatmaps = [Xt_heatmap_left, Xt_heatmap_right, Y_heatmap_left, Y_heatmap_right] + else: + eye_heatmaps = None + + lossG, loss_adv_accumulated, L_adv, L_attr, L_id, L_rec, L_l2_eyes = compute_generator_losses(G, Y, Xt, Xt_attr, Di, + embed, ZY, eye_heatmaps,loss_adv_accumulated, + diff_person, same_person, args) + + with amp.scale_loss(lossG, opt_G) as scaled_loss: + scaled_loss.backward() + opt_G.step() + if args.scheduler: + scheduler_G.step() + + # discriminator training + opt_D.zero_grad() + lossD = compute_discriminator_loss(D, Y, Xs, diff_person) + with amp.scale_loss(lossD, opt_D) as scaled_loss: + scaled_loss.backward() + + if (not args.discr_force) or (loss_adv_accumulated < 4.): + opt_D.step() + if args.scheduler: + scheduler_D.step() + + + batch_time = time.time() - start_time + + if iteration % args.show_step == 0: + images = [Xs, Xt, Y] + if args.eye_detector_loss: + Xt_eyes_img = paint_eyes(Xt, Xt_eyes) + Yt_eyes_img = paint_eyes(Y, Y_eyes) + images.extend([Xt_eyes_img, Yt_eyes_img]) + image = make_image_list(images) + if args.use_wandb: + wandb.log({"gen_images":wandb.Image(image, caption=f"{epoch:03}" + '_' + f"{iteration:06}")}) + else: + cv2.imwrite('./images/generated_image.jpg', image[:,:,::-1]) + + if iteration % 10 == 0: + print(f'epoch: {epoch} {iteration} / {len(dataloader)}') + print(f'lossD: {lossD.item()} lossG: {lossG.item()} batch_time: {batch_time}s') + print(f'L_adv: {L_adv.item()} L_id: {L_id.item()} L_attr: {L_attr.item()} L_rec: {L_rec.item()}') + if args.eye_detector_loss: + print(f'L_l2_eyes: {L_l2_eyes.item()}') + print(f'loss_adv_accumulated: {loss_adv_accumulated}') + if args.scheduler: + print(f'scheduler_G lr: {scheduler_G.get_last_lr()} scheduler_D lr: {scheduler_D.get_last_lr()}') + + if args.use_wandb: + if args.eye_detector_loss: + wandb.log({"loss_eyes": L_l2_eyes.item()}, commit=False) + wandb.log({"loss_id": L_id.item(), + "lossD": lossD.item(), + "lossG": lossG.item(), + "loss_adv": L_adv.item(), + "loss_attr": L_attr.item(), + "loss_rec": L_rec.item()}) + + if iteration % 5000 == 0: + torch.save(G.state_dict(), f'./saved_models_{args.run_name}/G_latest.pth') + torch.save(D.state_dict(), f'./saved_models_{args.run_name}/D_latest.pth') + + torch.save(G.state_dict(), f'./current_models_{args.run_name}/G_' + str(epoch)+ '_' + f"{iteration:06}" + '.pth') + torch.save(D.state_dict(), f'./current_models_{args.run_name}/D_' + str(epoch)+ '_' + f"{iteration:06}" + '.pth') + + if (iteration % 250 == 0) and (args.use_wandb): + ### Посмотрим как выглядит свап на трех конкретных фотках, чтобы проследить динамику + G.eval() + + res1 = get_faceswap('examples/images/training//source1.png', 'examples/images/training//target1.png', G, netArc, device) + res2 = get_faceswap('examples/images/training//source2.png', 'examples/images/training//target2.png', G, netArc, device) + res3 = get_faceswap('examples/images/training//source3.png', 'examples/images/training//target3.png', G, netArc, device) + + res4 = get_faceswap('examples/images/training//source4.png', 'examples/images/training//target4.png', G, netArc, device) + res5 = get_faceswap('examples/images/training//source5.png', 'examples/images/training//target5.png', G, netArc, device) + res6 = get_faceswap('examples/images/training//source6.png', 'examples/images/training//target6.png', G, netArc, device) + + output1 = np.concatenate((res1, res2, res3), axis=0) + output2 = np.concatenate((res4, res5, res6), axis=0) + + output = np.concatenate((output1, output2), axis=1) + + wandb.log({"our_images":wandb.Image(output, caption=f"{epoch:03}" + '_' + f"{iteration:06}")}) + + G.train() + + +def train(args, device): + # training params + batch_size = args.batch_size + max_epoch = args.max_epoch + + # initializing main models + G = AEI_Net(args.backbone, num_blocks=args.num_blocks, c_id=512).to(device) + D = MultiscaleDiscriminator(input_nc=3, n_layers=5, norm_layer=torch.nn.InstanceNorm2d).to(device) + G.train() + D.train() + + # initializing model for identity extraction + netArc = iresnet100(fp16=False) + netArc.load_state_dict(torch.load('arcface_model/backbone.pth')) + netArc=netArc.cuda() + netArc.eval() + + if args.eye_detector_loss: + model_ft = models.FAN(4, "False", "False", 98) + checkpoint = torch.load('./AdaptiveWingLoss/AWL_detector/WFLW_4HG.pth') + if 'state_dict' not in checkpoint: + model_ft.load_state_dict(checkpoint) + else: + pretrained_weights = checkpoint['state_dict'] + model_weights = model_ft.state_dict() + pretrained_weights = {k: v for k, v in pretrained_weights.items() \ + if k in model_weights} + model_weights.update(pretrained_weights) + model_ft.load_state_dict(model_weights) + model_ft = model_ft.to(device) + model_ft.eval() + else: + model_ft=None + + opt_G = optim.Adam(G.parameters(), lr=args.lr_G, betas=(0, 0.999), weight_decay=1e-4) + opt_D = optim.Adam(D.parameters(), lr=args.lr_D, betas=(0, 0.999), weight_decay=1e-4) + + G, opt_G = amp.initialize(G, opt_G, opt_level=args.optim_level) + D, opt_D = amp.initialize(D, opt_D, opt_level=args.optim_level) + + if args.scheduler: + scheduler_G = scheduler.StepLR(opt_G, step_size=args.scheduler_step, gamma=args.scheduler_gamma) + scheduler_D = scheduler.StepLR(opt_D, step_size=args.scheduler_step, gamma=args.scheduler_gamma) + else: + scheduler_G = None + scheduler_D = None + + if args.pretrained: + try: + G.load_state_dict(torch.load(args.G_path, map_location=torch.device('cpu')), strict=False) + D.load_state_dict(torch.load(args.D_path, map_location=torch.device('cpu')), strict=False) + print("Loaded pretrained weights for G and D") + except FileNotFoundError as e: + print("Not found pretrained weights. Continue without any pretrained weights.") + + if args.vgg: + dataset = FaceEmbedVGG2(args.dataset_path, same_prob=args.same_person, same_identity=args.same_identity) + else: + dataset = FaceEmbed([args.dataset_path], same_prob=args.same_person) + + dataloader = DataLoader(dataset, batch_size=batch_size, shuffle=True, num_workers=8, drop_last=True) + + # Будем считать аккумулированный adv loss, чтобы обучать дискриминатор только когда он ниже порога, если discr_force=True + loss_adv_accumulated = 20. + + for epoch in range(0, max_epoch): + train_one_epoch(G, + D, + opt_G, + opt_D, + scheduler_G, + scheduler_D, + netArc, + model_ft, + args, + dataloader, + device, + epoch, + loss_adv_accumulated) + +def main(args): + device = torch.device('cuda' if torch.cuda.is_available() else 'cpu') + if not torch.cuda.is_available(): + print('cuda is not available. using cpu. check if it\'s ok') + + print("Starting traing") + train(args, device=device) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + + # dataset params + parser.add_argument('--dataset_path', default='/VggFace2-crop/', help='Path to the dataset. If not VGG2 dataset is used, param --vgg should be set False') + parser.add_argument('--G_path', default='./saved_models/G.pth', help='Path to pretrained weights for G. Only used if pretrained=True') + parser.add_argument('--D_path', default='./saved_models/D.pth', help='Path to pretrained weights for D. Only used if pretrained=True') + parser.add_argument('--vgg', default=True, type=bool, help='When using VGG2 dataset (or any other dataset with several photos for one identity)') + # weights for loss + parser.add_argument('--weight_adv', default=1, type=float, help='Adversarial Loss weight') + parser.add_argument('--weight_attr', default=10, type=float, help='Attributes weight') + parser.add_argument('--weight_id', default=20, type=float, help='Identity Loss weight') + parser.add_argument('--weight_rec', default=10, type=float, help='Reconstruction Loss weight') + parser.add_argument('--weight_eyes', default=0., type=float, help='Eyes Loss weight') + # training params you may want to change + + parser.add_argument('--backbone', default='unet', const='unet', nargs='?', choices=['unet', 'linknet', 'resnet'], help='Backbone for attribute encoder') + parser.add_argument('--num_blocks', default=2, type=int, help='Numbers of AddBlocks at AddResblock') + parser.add_argument('--same_person', default=0.2, type=float, help='Probability of using same person identity during training') + parser.add_argument('--same_identity', default=True, type=bool, help='Using simswap approach, when source_id = target_id. Only possible with vgg=True') + parser.add_argument('--diff_eq_same', default=False, type=bool, help='Don\'t use info about where is defferent identities') + parser.add_argument('--pretrained', default=True, type=bool, help='If using the pretrained weights for training or not') + parser.add_argument('--discr_force', default=False, type=bool, help='If True Discriminator would not train when adversarial loss is high') + parser.add_argument('--scheduler', default=False, type=bool, help='If True decreasing LR is used for learning of generator and discriminator') + parser.add_argument('--scheduler_step', default=5000, type=int) + parser.add_argument('--scheduler_gamma', default=0.2, type=float, help='It is value, which shows how many times to decrease LR') + parser.add_argument('--eye_detector_loss', default=False, type=bool, help='If True eye loss with using AdaptiveWingLoss detector is applied to generator') + # info about this run + parser.add_argument('--use_wandb', default=False, type=bool, help='Use wandb to track your experiments or not') + parser.add_argument('--run_name', required=True, type=str, help='Name of this run. Used to create folders where to save the weights.') + parser.add_argument('--wandb_project', default='your-project-name', type=str) + parser.add_argument('--wandb_entity', default='your-login', type=str) + # training params you probably don't want to change + parser.add_argument('--batch_size', default=16, type=int) + parser.add_argument('--lr_G', default=4e-4, type=float) + parser.add_argument('--lr_D', default=4e-4, type=float) + parser.add_argument('--max_epoch', default=2000, type=int) + parser.add_argument('--show_step', default=500, type=int) + parser.add_argument('--save_epoch', default=1, type=int) + parser.add_argument('--optim_level', default='O2', type=str) + + args = parser.parse_args() + + if args.vgg==False and args.same_identity==True: + raise ValueError("Sorry, you can't use some other dataset than VGG2 Faces with param same_identity=True") + + if args.use_wandb==True: + wandb.init(project=args.wandb_project, entity=args.wandb_entity, settings=wandb.Settings(start_method='fork')) + + config = wandb.config + config.dataset_path = args.dataset_path + config.weight_adv = args.weight_adv + config.weight_attr = args.weight_attr + config.weight_id = args.weight_id + config.weight_rec = args.weight_rec + config.weight_eyes = args.weight_eyes + config.same_person = args.same_person + config.Vgg2Face = args.vgg + config.same_identity = args.same_identity + config.diff_eq_same = args.diff_eq_same + config.discr_force = args.discr_force + config.scheduler = args.scheduler + config.scheduler_step = args.scheduler_step + config.scheduler_gamma = args.scheduler_gamma + config.eye_detector_loss = args.eye_detector_loss + config.pretrained = args.pretrained + config.run_name = args.run_name + config.G_path = args.G_path + config.D_path = args.D_path + config.batch_size = args.batch_size + config.lr_G = args.lr_G + config.lr_D = args.lr_D + elif not os.path.exists('./images'): + os.mkdir('./images') + + # Создаем папки, чтобы было куда сохранять последние веса моделей, а также веса с каждой эпохи + if not os.path.exists(f'./saved_models_{args.run_name}'): + os.mkdir(f'./saved_models_{args.run_name}') + os.mkdir(f'./current_models_{args.run_name}') + + main(args) diff --git a/utils/inference/core.py b/utils/inference/core.py new file mode 100644 index 0000000000000000000000000000000000000000..e5303a9c1dd0c574cfa505531a7cfcc4b622f573 --- /dev/null +++ b/utils/inference/core.py @@ -0,0 +1,90 @@ +from typing import List, Tuple, Callable, Any + +import torch +import torch.nn.functional as F +import numpy as np +from tqdm import tqdm + +from .faceshifter_run import faceshifter_batch +from .image_processing import crop_face, normalize_and_torch, normalize_and_torch_batch +from .video_processing import read_video, crop_frames_and_get_transforms, resize_frames + + +def transform_target_to_torch(resized_frs: np.ndarray, half=True) -> torch.tensor: + """ + Transform target, so it could be used by model + """ + target_batch_rs = torch.from_numpy(resized_frs.copy()).cuda() + target_batch_rs = target_batch_rs[:, :, :, [2,1,0]]/255. + + if half: + target_batch_rs = target_batch_rs.half() + + target_batch_rs = (target_batch_rs - 0.5)/0.5 # normalize + target_batch_rs = target_batch_rs.permute(0, 3, 1, 2) + + return target_batch_rs + + +def model_inference(full_frames: List[np.ndarray], + source: List, + target: List, + netArc: Callable, + G: Callable, + app: Callable, + set_target: bool, + similarity_th=0.15, + crop_size=224, + BS=60, + half=True) -> Tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]: + """ + Using original frames get faceswaped frames and transofrmations + """ + # Get Arcface embeddings of target image + target_norm = normalize_and_torch_batch(np.array(target)) + target_embeds = netArc(F.interpolate(target_norm, scale_factor=0.5, mode='bilinear', align_corners=True)) + + # Get the cropped faces from original frames and transformations to get those crops + crop_frames_list, tfm_array_list = crop_frames_and_get_transforms(full_frames, target_embeds, app, netArc, crop_size, set_target, similarity_th=similarity_th) + + # Normalize source images and transform to torch and get Arcface embeddings + source_embeds = [] + for source_curr in source: + source_curr = normalize_and_torch(source_curr) + source_embeds.append(netArc(F.interpolate(source_curr, scale_factor=0.5, mode='bilinear', align_corners=True))) + + final_frames_list = [] + for idx, (crop_frames, tfm_array, source_embed) in enumerate(zip(crop_frames_list, tfm_array_list, source_embeds)): + # Resize croped frames and get vector which shows on which frames there were faces + resized_frs, present = resize_frames(crop_frames) + resized_frs = np.array(resized_frs) + + # transform embeds of Xs and target frames to use by model + target_batch_rs = transform_target_to_torch(resized_frs, half=half) + + if half: + source_embed = source_embed.half() + + # run model + size = target_batch_rs.shape[0] + model_output = [] + + for i in tqdm(range(0, size, BS)): + Y_st = faceshifter_batch(source_embed, target_batch_rs[i:i+BS], G) + model_output.append(Y_st) + torch.cuda.empty_cache() + model_output = np.concatenate(model_output) + + # create list of final frames with transformed faces + final_frames = [] + idx_fs = 0 + + for pres in tqdm(present): + if pres == 1: + final_frames.append(model_output[idx_fs]) + idx_fs += 1 + else: + final_frames.append([]) + final_frames_list.append(final_frames) + + return final_frames_list, crop_frames_list, full_frames, tfm_array_list \ No newline at end of file diff --git a/utils/inference/faceshifter_run.py b/utils/inference/faceshifter_run.py new file mode 100644 index 0000000000000000000000000000000000000000..a8df7604fc716f3283f9c51e1ec5acd8bcda9630 --- /dev/null +++ b/utils/inference/faceshifter_run.py @@ -0,0 +1,23 @@ +import torch +import numpy as np + + +def faceshifter_batch(source_emb: torch.tensor, + target: torch.tensor, + G: torch.nn.Module) -> np.ndarray: + """ + Apply faceshifter model for batch of target images + """ + + bs = target.shape[0] + assert target.ndim == 4, "target should have 4 dimentions -- B x C x H x W" + + if bs > 1: + source_emb = torch.cat([source_emb]*bs) + + with torch.no_grad(): + Y_st, _ = G(target, source_emb) + Y_st = (Y_st.permute(0, 2, 3, 1)*0.5 + 0.5)*255 + Y_st = Y_st[:, :, :, [2,1,0]].type(torch.uint8) + Y_st = Y_st.cpu().detach().numpy() + return Y_st \ No newline at end of file diff --git a/utils/inference/image_processing.py b/utils/inference/image_processing.py new file mode 100644 index 0000000000000000000000000000000000000000..53ae645acb0c50b525f3aa0e6fe34f363f36ec77 --- /dev/null +++ b/utils/inference/image_processing.py @@ -0,0 +1,92 @@ +import base64 +from io import BytesIO +from typing import Callable, List + +import numpy as np +import torch +import cv2 +from .masks import face_mask_static +from matplotlib import pyplot as plt +from insightface.utils import face_align + + +def crop_face(image_full: np.ndarray, app: Callable, crop_size: int) -> np.ndarray: + """ + Crop face from image and resize + """ + kps = app.get(image_full, crop_size) + M, _ = face_align.estimate_norm(kps[0], crop_size, mode ='None') + align_img = cv2.warpAffine(image_full, M, (crop_size, crop_size), borderValue=0.0) + return [align_img] + + +def normalize_and_torch(image: np.ndarray) -> torch.tensor: + """ + Normalize image and transform to torch + """ + image = torch.tensor(image.copy(), dtype=torch.float32).cuda() + if image.max() > 1.: + image = image/255. + + image = image.permute(2, 0, 1).unsqueeze(0) + image = (image - 0.5) / 0.5 + + return image + + +def normalize_and_torch_batch(frames: np.ndarray) -> torch.tensor: + """ + Normalize batch images and transform to torch + """ + batch_frames = torch.from_numpy(frames.copy()).cuda() + if batch_frames.max() > 1.: + batch_frames = batch_frames/255. + + batch_frames = batch_frames.permute(0, 3, 1, 2) + batch_frames = (batch_frames - 0.5)/0.5 + + return batch_frames + + +def get_final_image(final_frames: List[np.ndarray], + crop_frames: List[np.ndarray], + full_frame: np.ndarray, + tfm_arrays: List[np.ndarray], + handler) -> None: + """ + Create final video from frames + """ + final = full_frame.copy() + params = [None for i in range(len(final_frames))] + + for i in range(len(final_frames)): + frame = cv2.resize(final_frames[i][0], (224, 224)) + + landmarks = handler.get_without_detection_without_transform(frame) + landmarks_tgt = handler.get_without_detection_without_transform(crop_frames[i][0]) + + mask, _ = face_mask_static(crop_frames[i][0], landmarks, landmarks_tgt, params[i]) + mat_rev = cv2.invertAffineTransform(tfm_arrays[i][0]) + + swap_t = cv2.warpAffine(frame, mat_rev, (full_frame.shape[1], full_frame.shape[0]), borderMode=cv2.BORDER_REPLICATE) + mask_t = cv2.warpAffine(mask, mat_rev, (full_frame.shape[1], full_frame.shape[0])) + mask_t = np.expand_dims(mask_t, 2) + + final = mask_t*swap_t + (1-mask_t)*final + final = np.array(final, dtype='uint8') + return final + + +def show_images(images: List[np.ndarray], + titles=None, + figsize=(20, 5), + fontsize=15): + if titles: + assert len(titles) == len(images), "Amount of images should be the same as the amount of titles" + + fig, axes = plt.subplots(1, len(images), figsize=figsize) + for idx, (ax, image) in enumerate(zip(axes, images)): + ax.imshow(image[:, :, ::-1]) + if titles: + ax.set_title(titles[idx], fontsize=fontsize) + ax.axis("off") diff --git a/utils/inference/masks.py b/utils/inference/masks.py new file mode 100644 index 0000000000000000000000000000000000000000..734e24423c311886c00913b3fde741b6f6afef6d --- /dev/null +++ b/utils/inference/masks.py @@ -0,0 +1,108 @@ +import numpy as np +import cv2 + + +def expand_eyebrows(lmrks, eyebrows_expand_mod=1.0): + + lmrks = np.array( lmrks.copy(), dtype=np.int32 ) + + # Top of the eye arrays + bot_l = lmrks[[35, 41, 40, 42, 39]] + bot_r = lmrks[[89, 95, 94, 96, 93]] + + # Eyebrow arrays + top_l = lmrks[[43, 48, 49, 51, 50]] + top_r = lmrks[[102, 103, 104, 105, 101]] + + # Adjust eyebrow arrays + lmrks[[43, 48, 49, 51, 50]] = top_l + eyebrows_expand_mod * 0.5 * (top_l - bot_l) + lmrks[[102, 103, 104, 105, 101]] = top_r + eyebrows_expand_mod * 0.5 * (top_r - bot_r) + return lmrks + + +def get_mask(image: np.ndarray, landmarks: np.ndarray) -> np.ndarray: + """ + Get face mask of image size using given landmarks of person + """ + + img_gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY) + mask = np.zeros_like(img_gray) + + points = np.array(landmarks, np.int32) + convexhull = cv2.convexHull(points) + cv2.fillConvexPoly(mask, convexhull, 255) + + return mask + + +def face_mask_static(image: np.ndarray, landmarks: np.ndarray, landmarks_tgt: np.ndarray, params = None) -> np.ndarray: + """ + Get the final mask, using landmarks and applying blur + """ + if params is None: + + left = np.sum((landmarks[1][0]-landmarks_tgt[1][0], landmarks[2][0]-landmarks_tgt[2][0], landmarks[13][0]-landmarks_tgt[13][0])) + right = np.sum((landmarks_tgt[17][0]-landmarks[17][0], landmarks_tgt[18][0]-landmarks[18][0], landmarks_tgt[29][0]-landmarks[29][0])) + + offset = max(left, right) + + if offset > 6: + erode = 15 + sigmaX = 15 + sigmaY = 10 + elif offset > 3: + erode = 10 + sigmaX = 10 + sigmaY = 8 + elif offset < -3: + erode = -5 + sigmaX = 5 + sigmaY = 10 + else: + erode = 5 + sigmaX = 5 + sigmaY = 5 + + else: + erode = params[0] + sigmaX = params[1] + sigmaY = params[2] + + if erode == 15: + eyebrows_expand_mod=2.7 + elif erode == -5: + eyebrows_expand_mod=0.5 + else: + eyebrows_expand_mod=2.0 + landmarks = expand_eyebrows(landmarks, eyebrows_expand_mod=eyebrows_expand_mod) + + mask = get_mask(image, landmarks) + mask = erode_and_blur(mask, erode, sigmaX, sigmaY, True) + + if params is None: + return mask/255, [erode, sigmaX, sigmaY] + + return mask/255 + + +def erode_and_blur(mask_input, erode, sigmaX, sigmaY, fade_to_border = True): + mask = np.copy(mask_input) + + if erode > 0: + kernel = np.ones((erode, erode), 'uint8') + mask = cv2.erode(mask, kernel, iterations=1) + + else: + kernel = np.ones((-erode, -erode), 'uint8') + mask = cv2.dilate(mask, kernel, iterations=1) + + if fade_to_border: + clip_size = sigmaY * 2 + mask[:clip_size,:] = 0 + mask[-clip_size:,:] = 0 + mask[:,:clip_size] = 0 + mask[:,-clip_size:] = 0 + + mask = cv2.GaussianBlur(mask, (0, 0), sigmaX = sigmaX, sigmaY = sigmaY) + + return mask diff --git a/utils/inference/util.py b/utils/inference/util.py new file mode 100644 index 0000000000000000000000000000000000000000..fc13de8fba22e3643da5bec1645c68e70ac2280a --- /dev/null +++ b/utils/inference/util.py @@ -0,0 +1,279 @@ +""" +Copyright (C) 2019 NVIDIA Corporation. All rights reserved. +Licensed under the CC BY-NC-SA 4.0 license (https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). +""" + +import re +import importlib +import torch +from argparse import Namespace +import numpy as np +from PIL import Image +import os +import argparse +import dill as pickle +#import util.coco + + +def save_obj(obj, name): + with open(name, 'wb') as f: + pickle.dump(obj, f, pickle.HIGHEST_PROTOCOL) + + +def load_obj(name): + with open(name, 'rb') as f: + return pickle.load(f) + +# returns a configuration for creating a generator +# |default_opt| should be the opt of the current experiment +# |**kwargs|: if any configuration should be overriden, it can be specified here + + +def copyconf(default_opt, **kwargs): + conf = argparse.Namespace(**vars(default_opt)) + for key in kwargs: + print(key, kwargs[key]) + setattr(conf, key, kwargs[key]) + return conf + + +def tile_images(imgs, picturesPerRow=4): + """ Code borrowed from + https://stackoverflow.com/questions/26521365/cleanly-tile-numpy-array-of-images-stored-in-a-flattened-1d-format/26521997 + """ + + # Padding + if imgs.shape[0] % picturesPerRow == 0: + rowPadding = 0 + else: + rowPadding = picturesPerRow - imgs.shape[0] % picturesPerRow + if rowPadding > 0: + imgs = np.concatenate([imgs, np.zeros((rowPadding, *imgs.shape[1:]), dtype=imgs.dtype)], axis=0) + + # Tiling Loop (The conditionals are not necessary anymore) + tiled = [] + for i in range(0, imgs.shape[0], picturesPerRow): + tiled.append(np.concatenate([imgs[j] for j in range(i, i + picturesPerRow)], axis=1)) + + tiled = np.concatenate(tiled, axis=0) + return tiled + + +# Converts a Tensor into a Numpy array +# |imtype|: the desired type of the converted numpy array +def tensor2im(image_tensor, imtype=np.uint8, normalize=True, tile=False): + if isinstance(image_tensor, list): + image_numpy = [] + for i in range(len(image_tensor)): + image_numpy.append(tensor2im(image_tensor[i], imtype, normalize)) + return image_numpy + + if image_tensor.dim() == 4: + # transform each image in the batch + images_np = [] + for b in range(image_tensor.size(0)): + one_image = image_tensor[b] + one_image_np = tensor2im(one_image) + images_np.append(one_image_np.reshape(1, *one_image_np.shape)) + images_np = np.concatenate(images_np, axis=0) + if tile: + images_tiled = tile_images(images_np) + return images_tiled + else: + return images_np + + if image_tensor.dim() == 2: + image_tensor = image_tensor.unsqueeze(0) + image_numpy = image_tensor.detach().cpu().float().numpy() + if normalize: + #image_numpy = (np.transpose(image_numpy, (1, 2, 0)) + 1) / 2.0 * 255.0 + image_numpy = np.transpose(image_numpy, (1, 2, 0)) * 255.0 + else: + image_numpy = np.transpose(image_numpy, (1, 2, 0)) * 255.0 + image_numpy = np.clip(image_numpy, 0, 255) + if image_numpy.shape[2] == 1: + image_numpy = image_numpy[:, :, 0] + return image_numpy.astype(imtype) + + +# Converts a one-hot tensor into a colorful label map +def tensor2label(label_tensor, n_label, imtype=np.uint8, tile=False): + if label_tensor.dim() == 4: + # transform each image in the batch + images_np = [] + for b in range(label_tensor.size(0)): + one_image = label_tensor[b] + one_image_np = tensor2label(one_image, n_label, imtype) + images_np.append(one_image_np.reshape(1, *one_image_np.shape)) + images_np = np.concatenate(images_np, axis=0) + if tile: + images_tiled = tile_images(images_np) + return images_tiled + else: + images_np = images_np[0] + return images_np + + if label_tensor.dim() == 1: + return np.zeros((64, 64, 3), dtype=np.uint8) + if n_label == 0: + return tensor2im(label_tensor, imtype) + label_tensor = label_tensor.cpu().float() + if label_tensor.size()[0] > 1: + label_tensor = label_tensor.max(0, keepdim=True)[1] + label_tensor = Colorize(n_label)(label_tensor) + label_numpy = np.transpose(label_tensor.numpy(), (1, 2, 0)) + result = label_numpy.astype(imtype) + return result + + +def save_image(image_numpy, image_path, create_dir=False): + if create_dir: + os.makedirs(os.path.dirname(image_path), exist_ok=True) + if len(image_numpy.shape) == 2: + image_numpy = np.expand_dims(image_numpy, axis=2) + if image_numpy.shape[2] == 1: + image_numpy = np.repeat(image_numpy, 3, 2) + image_pil = Image.fromarray(image_numpy) + + # save to png + image_pil.save(image_path.replace('.jpg', '.png')) + + +def mkdirs(paths): + if isinstance(paths, list) and not isinstance(paths, str): + for path in paths: + mkdir(path) + else: + mkdir(paths) + + +def mkdir(path): + if not os.path.exists(path): + os.makedirs(path) + + +def atoi(text): + return int(text) if text.isdigit() else text + + +def natural_keys(text): + ''' + alist.sort(key=natural_keys) sorts in human order + http://nedbatchelder.com/blog/200712/human_sorting.html + (See Toothy's implementation in the comments) + ''' + return [atoi(c) for c in re.split('(\d+)', text)] + + +def natural_sort(items): + items.sort(key=natural_keys) + + +def str2bool(v): + if v.lower() in ('yes', 'true', 't', 'y', '1'): + return True + elif v.lower() in ('no', 'false', 'f', 'n', '0'): + return False + else: + raise argparse.ArgumentTypeError('Boolean value expected.') + + +def find_class_in_module(target_cls_name, module): + target_cls_name = target_cls_name.replace('_', '').lower() + clslib = importlib.import_module(module) + cls = None + for name, clsobj in clslib.__dict__.items(): + if name.lower() == target_cls_name: + cls = clsobj + + if cls is None: + print("In %s, there should be a class whose name matches %s in lowercase without underscore(_)" % (module, target_cls_name)) + exit(0) + + return cls + + +def save_network(net, label, epoch, opt): + save_filename = '%s_net_%s.pth' % (epoch, label) + save_path = os.path.join(opt.checkpoints_dir, opt.name, save_filename) + torch.save(net.cpu().state_dict(), save_path) + if len(opt.gpu_ids) and torch.cuda.is_available(): + net.cuda() + + +def load_network(net, label, epoch, opt): + save_filename = '%s_net_%s.pth' % (epoch, label) + save_dir = os.path.join(opt.checkpoints_dir, opt.name) + save_path = os.path.join(save_dir, save_filename) + weights = torch.load(save_path) + net.load_state_dict(weights) + print('Load checkpoint from path: ', save_path) + return net + + +############################################################################### +# Code from +# https://github.com/ycszen/pytorch-seg/blob/master/transform.py +# Modified so it complies with the Citscape label map colors +############################################################################### +def uint82bin(n, count=8): + """returns the binary of integer n, count refers to amount of bits""" + return ''.join([str((n >> y) & 1) for y in range(count - 1, -1, -1)]) + + +def labelcolormap(N): + if N == 35: # cityscape + cmap = np.array([(0, 0, 0), (0, 0, 0), (0, 0, 0), (0, 0, 0), (0, 0, 0), (111, 74, 0), (81, 0, 81), + (128, 64, 128), (244, 35, 232), (250, 170, 160), (230, 150, 140), (70, 70, 70), (102, 102, 156), (190, 153, 153), + (180, 165, 180), (150, 100, 100), (150, 120, 90), (153, 153, 153), (153, 153, 153), (250, 170, 30), (220, 220, 0), + (107, 142, 35), (152, 251, 152), (70, 130, 180), (220, 20, 60), (255, 0, 0), (0, 0, 142), (0, 0, 70), + (0, 60, 100), (0, 0, 90), (0, 0, 110), (0, 80, 100), (0, 0, 230), (119, 11, 32), (0, 0, 142)], + dtype=np.uint8) + else: + cmap = np.zeros((N, 3), dtype=np.uint8) + for i in range(N): + r, g, b = 0, 0, 0 + id = i + 1 # let's give 0 a color + for j in range(7): + str_id = uint82bin(id) + r = r ^ (np.uint8(str_id[-1]) << (7 - j)) + g = g ^ (np.uint8(str_id[-2]) << (7 - j)) + b = b ^ (np.uint8(str_id[-3]) << (7 - j)) + id = id >> 3 + cmap[i, 0] = r + cmap[i, 1] = g + cmap[i, 2] = b + + if N == 182: # COCO + important_colors = { + 'sea': (54, 62, 167), + 'sky-other': (95, 219, 255), + 'tree': (140, 104, 47), + 'clouds': (170, 170, 170), + 'grass': (29, 195, 49) + } + for i in range(N): + name = util.coco.id2label(i) + if name in important_colors: + color = important_colors[name] + cmap[i] = np.array(list(color)) + + return cmap + + +class Colorize(object): + def __init__(self, n=35): + self.cmap = labelcolormap(n) + self.cmap = torch.from_numpy(self.cmap[:n]) + + def __call__(self, gray_image): + size = gray_image.size() + color_image = torch.ByteTensor(3, size[1], size[2]).fill_(0) + + for label in range(0, len(self.cmap)): + mask = (label == gray_image[0]).cpu() + color_image[0][mask] = self.cmap[label][0] + color_image[1][mask] = self.cmap[label][1] + color_image[2][mask] = self.cmap[label][2] + + return color_image diff --git a/utils/inference/video_processing.py b/utils/inference/video_processing.py new file mode 100644 index 0000000000000000000000000000000000000000..29681c03bfd6c7d735980e32b24d24fa1042f32b --- /dev/null +++ b/utils/inference/video_processing.py @@ -0,0 +1,285 @@ +import cv2 +import numpy as np +import os +from PIL import Image +from typing import List, Tuple, Callable, Any +from tqdm import tqdm +import traceback +from insightface.utils import face_align +from scipy.spatial import distance + +from .masks import face_mask_static +from .image_processing import normalize_and_torch, normalize_and_torch_batch, crop_face + +import torch +import torch.nn.functional as F +from torch.utils.data import DataLoader, Dataset +import torchvision.transforms as transforms +import kornia + + +def add_audio_from_another_video(video_with_sound: str, + video_without_sound: str, + audio_name: str, + fast_cpu=True, + gpu=False) -> None: + + if not os.path.exists('./examples/audio/'): + os.makedirs('./examples/audio/') + fast_cmd = "-c:v libx264 -preset ultrafast -crf 18" if fast_cpu else "" + gpu_cmd = "-c:v h264_nvenc" if gpu else "" + os.system(f"ffmpeg -v -8 -i {video_with_sound} -vn -vcodec h264_nvenc ./examples/audio/{audio_name}.m4a") + os.system(f"ffmpeg -v -8 -i {video_without_sound} -i ./examples/audio/{audio_name}.m4a {fast_cmd} {gpu_cmd}{video_without_sound[:-4]}_audio.mp4 -y") + os.system(f"rm -rf ./examples/audio/{audio_name}.m4a") + os.system(f"mv {video_without_sound[:-4]}_audio.mp4 {video_without_sound}") + + +def read_video(path_to_video: str) -> Tuple[List[np.ndarray], float]: + """ + Read video by frames using its path + """ + + # load video + cap = cv2.VideoCapture(path_to_video) + + width_original, height_original = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH)), int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT)) # + fps, frames = cap.get(cv2.CAP_PROP_FPS), cap.get(cv2.CAP_PROP_FRAME_COUNT) + + full_frames = [] + i = 0 # current frame + + while(cap.isOpened()): + if i == frames: + break + + ret, frame = cap.read() + + i += 1 + if ret==True: + full_frames.append(frame) + p = i * 100 / frames + else: + break + + cap.release() + + return full_frames, fps + + +def get_target(full_frames: List[np.ndarray], + app: Callable, + crop_size: int): + i = 0 + target = None + while target is None: + if i < len(full_frames): + try: + target = [crop_face(full_frames[i], app, crop_size)[0]] + except TypeError: + i += 1 + else: + print("Video doesn't contain face!") + break + return target + + +def smooth_landmarks(kps_arr, n = 2): + kps_arr_smooth_final = [] + for ka in kps_arr: + kps_arr_s = [[ka[0]]] + for i in range(1, len(ka)): + if (len(ka[i])==0) or (len(ka[i-1])==0): + kps_arr_s.append([ka[i]]) + elif (distance.euclidean(ka[i][0], ka[i-1][0]) > 5) or (distance.euclidean(ka[i][2], ka[i-1][2]) > 5): + kps_arr_s.append([ka[i]]) + else: + kps_arr_s[-1].append(ka[i]) + + kps_arr_smooth = [] + + for a in kps_arr_s: + a_smooth = [] + for i in range(len(a)): + q = min(i-0, len(a)-i-1, n) + a_smooth.append(np.mean( np.array(a[i-q:i+1+q]), axis=0 ) ) + + kps_arr_smooth += a_smooth + kps_arr_smooth_final.append(kps_arr_smooth) + return kps_arr_smooth_final + + +def crop_frames_and_get_transforms(full_frames: List[np.ndarray], + target_embeds: List, + app: Callable, + netArc: Callable, + crop_size: int, + set_target: bool, + similarity_th: float) -> Tuple[List[Any], List[Any]]: + """ + Crop faces from frames and get respective tranforms + """ + + crop_frames = [ [] for _ in range(target_embeds.shape[0]) ] + tfm_array = [ [] for _ in range(target_embeds.shape[0]) ] + kps_array = [ [] for _ in range(target_embeds.shape[0]) ] + + target_embeds = F.normalize(target_embeds) + for frame in tqdm(full_frames): + try: + kps = app.get(frame, crop_size) + if len(kps) > 1 or set_target: + faces = [] + for p in kps: + M, _ = face_align.estimate_norm(p, crop_size, mode ='None') + align_img = cv2.warpAffine(frame, M, (crop_size, crop_size), borderValue=0.0) + faces.append(align_img) + + face_norm = normalize_and_torch_batch(np.array(faces)) + face_norm = F.interpolate(face_norm, scale_factor=0.5, mode='bilinear', align_corners=True) + face_embeds = netArc(face_norm) + face_embeds = F.normalize(face_embeds) + + similarity = face_embeds@target_embeds.T + best_idxs = similarity.argmax(0).detach().cpu().numpy() + for idx, best_idx in enumerate(best_idxs): + if similarity[best_idx][idx] > similarity_th: + kps_array[idx].append(kps[best_idx]) + else: + kps_array[idx].append([]) + + else: + kps_array[0].append(kps[0]) + + except TypeError: + for q in range (len(target_embeds)): + kps_array[0].append([]) + + smooth_kps = smooth_landmarks(kps_array, n = 2) + + for i, frame in tqdm(enumerate(full_frames)): + for q in range (len(target_embeds)): + try: + M, _ = face_align.estimate_norm(smooth_kps[q][i], crop_size, mode ='None') + align_img = cv2.warpAffine(frame, M, (crop_size, crop_size), borderValue=0.0) + crop_frames[q].append(align_img) + tfm_array[q].append(M) + except: + crop_frames[q].append([]) + tfm_array[q].append([]) + + torch.cuda.empty_cache() + return crop_frames, tfm_array + + +def resize_frames(crop_frames: List[np.ndarray], new_size=(256, 256)) -> Tuple[List[np.ndarray], np.ndarray]: + """ + Resize frames to new size + """ + + resized_frs = [] + present = np.ones(len(crop_frames)) + + for i, crop_fr in tqdm(enumerate(crop_frames)): + try: + resized_frs.append(cv2.resize(crop_fr, new_size)) + except: + present[i] = 0 + + return resized_frs, present + + +def get_final_video(final_frames: List[np.ndarray], + crop_frames: List[np.ndarray], + full_frames: List[np.ndarray], + tfm_array: List[np.ndarray], + OUT_VIDEO_NAME: str, + fps: float, + handler) -> None: + """ + Create final video from frames + """ + + out = cv2.VideoWriter(f"{OUT_VIDEO_NAME}", cv2.VideoWriter_fourcc(*'mp4v'), fps, (full_frames[0].shape[1], full_frames[0].shape[0])) + size = (full_frames[0].shape[0], full_frames[0].shape[1]) + params = [None for i in range(len(crop_frames))] + result_frames = full_frames.copy() + + for i in tqdm(range(len(full_frames))): + if i == len(full_frames): + break + for j in range(len(crop_frames)): + try: + swap = cv2.resize(final_frames[j][i], (224, 224)) + + if len(crop_frames[j][i]) == 0: + params[j] = None + continue + + landmarks = handler.get_without_detection_without_transform(swap) + if params[j] == None: + landmarks_tgt = handler.get_without_detection_without_transform(crop_frames[j][i]) + mask, params[j] = face_mask_static(swap, landmarks, landmarks_tgt, params[j]) + else: + mask = face_mask_static(swap, landmarks, landmarks_tgt, params[j]) + + swap = torch.from_numpy(swap).cuda().permute(2,0,1).unsqueeze(0).type(torch.float32) + mask = torch.from_numpy(mask).cuda().unsqueeze(0).unsqueeze(0).type(torch.float32) + full_frame = torch.from_numpy(result_frames[i]).cuda().permute(2,0,1).unsqueeze(0) + mat = torch.from_numpy(tfm_array[j][i]).cuda().unsqueeze(0).type(torch.float32) + + mat_rev = kornia.invert_affine_transform(mat) + swap_t = kornia.warp_affine(swap, mat_rev, size) + mask_t = kornia.warp_affine(mask, mat_rev, size) + final = (mask_t*swap_t + (1-mask_t)*full_frame).type(torch.uint8).squeeze().permute(1,2,0).cpu().detach().numpy() + + result_frames[i] = final + torch.cuda.empty_cache() + + except Exception as e: + pass + + out.write(result_frames[i]) + + out.release() + + +class Frames(Dataset): + def __init__(self, frames_list): + self.frames_list = frames_list + + self.transforms = transforms.Compose([ + transforms.ToTensor() + ]) + + def __getitem__(self, idx): + frame = Image.fromarray(self.frames_list[idx][:,:,::-1]) + + return self.transforms(frame) + + def __len__(self): + return len(self.frames_list) + + +def face_enhancement(final_frames: List[np.ndarray], model) -> List[np.ndarray]: + enhanced_frames_all = [] + for i in range(len(final_frames)): + enhanced_frames = final_frames[i].copy() + face_idx = [i for i, x in enumerate(final_frames[i]) if not isinstance(x, list)] + face_frames = [x for i, x in enumerate(final_frames[i]) if not isinstance(x, list)] + ff_i = 0 + + dataset = Frames(face_frames) + dataloader = DataLoader(dataset, batch_size=20, shuffle=False, num_workers=1, drop_last=False) + + for iteration, data in tqdm(enumerate(dataloader)): + frames = data + data = {'image': frames, 'label': frames} + generated = model(data, mode='inference2') + generated = torch.clamp(generated*255, 0, 255) + generated = (generated).type(torch.uint8).permute(0,2,3,1).cpu().detach().numpy() + for generated_frame in generated: + enhanced_frames[face_idx[ff_i]] = generated_frame[:,:,::-1] + ff_i+=1 + enhanced_frames_all.append(enhanced_frames) + + return enhanced_frames_all diff --git a/utils/training/Dataset.py b/utils/training/Dataset.py new file mode 100644 index 0000000000000000000000000000000000000000..ec49590e1bb7a18e6f413084c44dd0e2741a10fd --- /dev/null +++ b/utils/training/Dataset.py @@ -0,0 +1,131 @@ +from torch.utils.data import TensorDataset +import torchvision.transforms as transforms +from PIL import Image +import glob +import pickle +import random +import os +import cv2 +import tqdm +import sys +sys.path.append('..') +# from utils.cap_aug import CAP_AUG + + +class FaceEmbed(TensorDataset): + def __init__(self, data_path_list, same_prob=0.8): + datasets = [] + # embeds = [] + self.N = [] + self.same_prob = same_prob + for data_path in data_path_list: + image_list = glob.glob(f'{data_path}/*.*g') + datasets.append(image_list) + self.N.append(len(image_list)) + # with open(f'{data_path}/embed.pkl', 'rb') as f: + # embed = pickle.load(f) + # embeds.append(embed) + self.datasets = datasets + # self.embeds = embeds + self.transforms_arcface = transforms.Compose([ + transforms.ColorJitter(0.2, 0.2, 0.2, 0.01), + transforms.Resize((224, 224)), + transforms.ToTensor(), + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)) + ]) + + self.transforms_base = transforms.Compose([ + transforms.ColorJitter(0.2, 0.2, 0.2, 0.01), + transforms.Resize((256, 256)), + transforms.ToTensor(), + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)) + ]) + + def __getitem__(self, item): + idx = 0 + while item >= self.N[idx]: + item -= self.N[idx] + idx += 1 + + image_path = self.datasets[idx][item] + # name = os.path.split(image_path)[1] + # embed = self.embeds[idx][name] + Xs = cv2.imread(image_path)[:, :, ::-1] + Xs = Image.fromarray(Xs) + + if random.random() > self.same_prob: + image_path = random.choice(self.datasets[random.randint(0, len(self.datasets)-1)]) + Xt = cv2.imread(image_path)[:, :, ::-1] + Xt = Image.fromarray(Xt) + same_person = 0 + else: + Xt = Xs.copy() + same_person = 1 + + return self.transforms_arcface(Xs), self.transforms_base(Xs), self.transforms_base(Xt), same_person + + def __len__(self): + return sum(self.N) + + +class FaceEmbedVGG2(TensorDataset): + def __init__(self, data_path, same_prob=0.8, same_identity=False): + + self.same_prob = same_prob + self.same_identity = same_identity + + self.images_list = glob.glob(f'{data_path}/*/*.*g') + self.folders_list = glob.glob(f'{data_path}/*') + + self.folder2imgs = {} + + for folder in tqdm.tqdm(self.folders_list): + folder_imgs = glob.glob(f'{folder}/*') + self.folder2imgs[folder] = folder_imgs + + self.N = len(self.images_list) + + self.transforms_arcface = transforms.Compose([ + transforms.ColorJitter(0.2, 0.2, 0.2, 0.01), + transforms.Resize((224, 224)), + transforms.ToTensor(), + # transforms.Normalize((0.485, 0.456, 0.406), (0.229, 0.224, 0.225)) + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)) + ]) + + self.transforms_base = transforms.Compose([ + transforms.ColorJitter(0.2, 0.2, 0.2, 0.01), + transforms.Resize((256, 256)), + transforms.ToTensor(), + # transforms.Normalize((0.485, 0.456, 0.406), (0.229, 0.224, 0.225)) + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)) + ]) + + def __getitem__(self, item): + + image_path = self.images_list[item] + + Xs = cv2.imread(image_path)[:, :, ::-1] + Xs = Image.fromarray(Xs) + + if self.same_identity: + folder_name = '/'.join(image_path.split('/')[:-1]) + + if random.random() > self.same_prob: + image_path = random.choice(self.images_list) + Xt = cv2.imread(image_path)[:, :, ::-1] + Xt = Image.fromarray(Xt) + same_person = 0 + else: + if self.same_identity: + image_path = random.choice(self.folder2imgs[folder_name]) + Xt = cv2.imread(image_path)[:, :, ::-1] + Xt = Image.fromarray(Xt) + else: + Xt = Xs.copy() + same_person = 1 + + return self.transforms_arcface(Xs), self.transforms_base(Xs), self.transforms_base(Xt), same_person + + def __len__(self): + return self.N \ No newline at end of file diff --git a/utils/training/detector.py b/utils/training/detector.py new file mode 100644 index 0000000000000000000000000000000000000000..89536a6092c125bb2eaaafe084255e414fc9d28d --- /dev/null +++ b/utils/training/detector.py @@ -0,0 +1,44 @@ +import torch +import numpy as np +import cv2 +from PIL import Image +import torchvision.transforms as transforms +from AdaptiveWingLoss.utils.utils import get_preds_fromhm +from .image_processing import torch2image + + +transforms_base = transforms.Compose([ + transforms.ColorJitter(0.2, 0.2, 0.2, 0.01), + transforms.Resize((256, 256)), + transforms.ToTensor(), + transforms.Normalize((0.5, 0.5, 0.5), (0.5, 0.5, 0.5)) + ]) + + +def detect_landmarks(inputs, model_ft): + mean = torch.tensor([0.5, 0.5, 0.5]).unsqueeze(1).unsqueeze(2).to(inputs.device) + std = torch.tensor([0.5, 0.5, 0.5]).unsqueeze(1).unsqueeze(2).to(inputs.device) + inputs = (std * inputs) + mean + + outputs, boundary_channels = model_ft(inputs) + pred_heatmap = outputs[-1][:, :-1, :, :].cpu() + pred_landmarks, _ = get_preds_fromhm(pred_heatmap) + landmarks = pred_landmarks*4.0 + eyes = torch.cat((landmarks[:,96,:], landmarks[:,97,:]), 1) + return eyes, pred_heatmap[:,96,:,:], pred_heatmap[:,97,:,:] + + +def paint_eyes(images, eyes): + list_eyes = [] + for i in range(len(images)): + mask = torch2image(images[i]) + mask = cv2.cvtColor(mask, cv2.COLOR_BGR2RGB) + + cv2.circle(mask, (int(eyes[i][0]),int(eyes[i][1])), radius=3, color=(0,255,255), thickness=-1) + cv2.circle(mask, (int(eyes[i][2]),int(eyes[i][3])), radius=3, color=(0,255,255), thickness=-1) + + mask = mask[:, :, ::-1] + mask = transforms_base(Image.fromarray(mask)) + list_eyes.append(mask) + tensor_eyes = torch.stack(list_eyes) + return tensor_eyes \ No newline at end of file diff --git a/utils/training/image_processing.py b/utils/training/image_processing.py new file mode 100644 index 0000000000000000000000000000000000000000..a87ca03bb92675df2ea00c936e368334ba9f7597 --- /dev/null +++ b/utils/training/image_processing.py @@ -0,0 +1,86 @@ +import cv2 +import numpy as np +from PIL import Image + +import torch +import torchvision.transforms as transforms +import torch.nn.functional as F + + +transformer_Arcface = transforms.Compose([ + transforms.ToTensor(), + transforms.Normalize([0.5, 0.5, 0.5], [0.5, 0.5, 0.5]) + ]) + + +def torch2image(torch_image: torch.tensor) -> np.ndarray: + batch = False + + if torch_image.dim() == 4: + torch_image = torch_image[:8] + batch = True + + device = torch_image.device + # mean = torch.tensor([0.485, 0.456, 0.406]).unsqueeze(1).unsqueeze(2) + # std = torch.tensor([0.229, 0.224, 0.225]).unsqueeze(1).unsqueeze(2) + mean = torch.tensor([0.5, 0.5, 0.5]).unsqueeze(1).unsqueeze(2).to(device) + std = torch.tensor([0.5, 0.5, 0.5]).unsqueeze(1).unsqueeze(2).to(device) + + denorm_image = (std * torch_image) + mean + + if batch: + denorm_image = denorm_image.permute(0, 2, 3, 1) + else: + denorm_image = denorm_image.permute(1, 2, 0) + + np_image = denorm_image.detach().cpu().numpy() + np_image = np.clip(np_image*255., 0, 255).astype(np.uint8) + + if batch: + return np.concatenate(np_image, axis=1) + else: + return np_image + + +def make_image_list(images) -> np.ndarray: + np_images = [] + + for torch_image in images: + np_img = torch2image(torch_image) + np_images.append(np_img) + + return np.concatenate(np_images, axis=0) + + +def read_torch_image(path: str) -> torch.tensor: + + image = cv2.imread(path) + image = cv2.resize(image, (256, 256)) + image = Image.fromarray(image[:, :, ::-1]) + image = transformer_Arcface(image) + image = image.view(-1, image.shape[0], image.shape[1], image.shape[2]) + + return image + + +def get_faceswap(source_path: str, target_path: str, + G: 'generator model', netArc: 'arcface model', + device: 'torch device') -> np.array: + source = read_torch_image(source_path) + source = source.to(device) + + embeds = netArc(F.interpolate(source, [112, 112], mode='bilinear', align_corners=False)) + # embeds = F.normalize(embeds, p=2, dim=1) + + target = read_torch_image(target_path) + target = target.cuda() + + with torch.no_grad(): + Yt, _ = G(target, embeds) + Yt = torch2image(Yt) + + source = torch2image(source) + target = torch2image(target) + + return np.concatenate((cv2.resize(source, (256, 256)), target, Yt), axis=1) + \ No newline at end of file diff --git a/utils/training/losses.py b/utils/training/losses.py new file mode 100644 index 0000000000000000000000000000000000000000..12d004918519b5feb8779272bcef517a113c8a60 --- /dev/null +++ b/utils/training/losses.py @@ -0,0 +1,68 @@ +import torch + +l1_loss = torch.nn.L1Loss() +l2_loss = torch.nn.MSELoss() + + +def hinge_loss(X, positive=True): + if positive: + return torch.relu(1-X) + else: + return torch.relu(X+1) + + +def compute_generator_losses(G, Y, Xt, Xt_attr, Di, embed, ZY, eye_heatmaps, loss_adv_accumulated, + diff_person, same_person, args): + # adversarial loss + L_adv = 0. + for di in Di: + L_adv += hinge_loss(di[0], True).mean(dim=[1, 2, 3]) + L_adv = torch.sum(L_adv * diff_person) / (diff_person.sum() + 1e-4) + + # id loss + L_id =(1 - torch.cosine_similarity(embed, ZY, dim=1)).mean() + + # attr loss + if args.optim_level == "O2" or args.optim_level == "O3": + Y_attr = G.get_attr(Y.type(torch.half)) + else: + Y_attr = G.get_attr(Y) + + L_attr = 0 + for i in range(len(Xt_attr)): + L_attr += torch.mean(torch.pow(Xt_attr[i] - Y_attr[i], 2).reshape(args.batch_size, -1), dim=1).mean() + L_attr /= 2.0 + + # reconstruction loss + L_rec = torch.sum(0.5 * torch.mean(torch.pow(Y - Xt, 2).reshape(args.batch_size, -1), dim=1) * same_person) / (same_person.sum() + 1e-6) + + # l2 eyes loss + if args.eye_detector_loss: + Xt_heatmap_left, Xt_heatmap_right, Y_heatmap_left, Y_heatmap_right = eye_heatmaps + L_l2_eyes = l2_loss(Xt_heatmap_left, Y_heatmap_left) + l2_loss(Xt_heatmap_right, Y_heatmap_right) + else: + L_l2_eyes = 0 + + # final loss of generator + lossG = args.weight_adv*L_adv + args.weight_attr*L_attr + args.weight_id*L_id + args.weight_rec*L_rec + args.weight_eyes*L_l2_eyes + loss_adv_accumulated = loss_adv_accumulated*0.98 + L_adv.item()*0.02 + + return lossG, loss_adv_accumulated, L_adv, L_attr, L_id, L_rec, L_l2_eyes + + +def compute_discriminator_loss(D, Y, Xs, diff_person): + # fake part + fake_D = D(Y.detach()) + loss_fake = 0 + for di in fake_D: + loss_fake += torch.sum(hinge_loss(di[0], False).mean(dim=[1, 2, 3]) * diff_person) / (diff_person.sum() + 1e-4) + + # ground truth part + true_D = D(Xs) + loss_true = 0 + for di in true_D: + loss_true += torch.sum(hinge_loss(di[0], True).mean(dim=[1, 2, 3]) * diff_person) / (diff_person.sum() + 1e-4) + + lossD = 0.5*(loss_true.mean() + loss_fake.mean()) + + return lossD \ No newline at end of file