在本节教程中,我们将介绍创建自定义数据格式的基本步骤:
如果你的算法不需要任何定制的数据格式,你可以使用datasets目录中这些现成的数据格式。但是要使用这些现有的数据格式,你必须将你的数据集转换为现有的数据格式。
假设你的数据集的注释文件格式是:
000001.jpg 0
000002.jpg 1
要编写一个新的数据格式,你需要实现:
- 子类
DataSource
:继承自父类BaseDataSource
——负责加载注释文件和读取图像。 - 子类
Dataset
:继承自父类BaseDataset
——负责对图像进行转换和打包。
假设你基于父类DataSource
创建的子类名为 NewDataSource
, 你可以在mmselfsup/datasets/data_sources
目录下创建一个文件,文件名为 new_data_source.py
,并在这个文件中实现 NewDataSource
创建。
import mmcv
import numpy as np
from ..builder import DATASOURCES
from .base import BaseDataSource
@DATASOURCES.register_module()
class NewDataSource(BaseDataSource):
def load_annotations(self):
assert isinstance(self.ann_file, str)
data_infos = []
# writing your code here.
return data_infos
然后, 在 mmselfsup/dataset/data_sources/__init__.py
中添加NewDataSource
。
from .base import BaseDataSource
...
from .new_data_source import NewDataSource
__all__ = [
'BaseDataSource', ..., 'NewDataSource'
]
假设你基于父类 Dataset
创建的子类名为 NewDataset
,你可以在mmselfsup/datasets
目录下创建一个文件,文件名为new_dataset.py
,并在这个文件中实现 NewDataset
创建。
# Copyright (c) OpenMMLab. All rights reserved.
import torch
from mmcv.utils import build_from_cfg
from torchvision.transforms import Compose
from .base import BaseDataset
from .builder import DATASETS, PIPELINES, build_datasource
from .utils import to_numpy
@DATASETS.register_module()
class NewDataset(BaseDataset):
def __init__(self, data_source, num_views, pipelines, prefetch=False):
# writing your code here
def __getitem__(self, idx):
# writing your code here
return dict(img=img)
def evaluate(self, results, logger=None):
return NotImplemented
然后,在 mmselfsup/dataset/__init__.py
中添加 NewDataset
。
from .base import BaseDataset
...
from .new_dataset import NewDataset
__all__ = [
'BaseDataset', ..., 'NewDataset'
]
为了使用 NewDataset
,你可以修改配置如下:
train=dict(
type='NewDataset',
data_source=dict(
type='NewDataSource',
),
num_views=[2],
pipelines=[train_pipeline],
prefetch=prefetch,
))