mask2json

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 59 Open GitHub ↗

a small tool for image augmentation, including mask files to json/xml files , image augmentation(flip,rotation,noise,...) and so on

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Visit [simple-tools-for-machine-learning](https://github.com/guchengxi1994/simple-tools-for-machine-learning) for a newer tool, which written in `python3.8`,`skimage`,`numpy` and without `opencv-python`. This repo will not be upgraded any more.

<h1 align="center">
  <img src="convertmask/UI/statics/look.png"><br/>convertmask
</h1>

# Issues and advices wanted.

[![Build Status](https://travis-ci.org/guchengxi1994/mask2json.svg?branch=master)](https://app.travis-ci.com/guchengxi1994/mask2json.svg?branch=master)

# Introduction

A small tool for image augmentation, including mask files to json/xml files , image augmentation(flip,rotation,noise,...) and so on

## HOW TO USE.

### Installation.

Try:

pip install -r requestments.txt

IF ERROR, try:

pip install -r requirements.txt --ignore-installed

### Use.

Under this version, these tools are provided.

#### 1.[augmentation](./static/docs/augment.md)

#### 2.[img2xml](./static/docs/img2xml.md)

#### 3.[json2mask](./static/docs/json2mask.md)

#### 4.[json2xml](./static/docs/json2xml.md)

#### 5.[longImgSplit](./static/docs/longImgSplit.md)

#### 6.[xml2json](./static/docs/xml2json.md)

#### 7.[xml2mask](./static/docs/xml2mask.md)

#### 8.[xml2yolo](./static/docs/xml2yolo.md)

#### 9.[yolo2xml](./static/docs/yolo2xml.md)

#### 10.[mask2json](./static/docs/mask2json.md)

# CHANGE LOGS

## 2021.10.31

### 1.bump to 0.6.0

### 2. UI update

## 2021.1.14

### 1.update spliting yolo-like dataset into train and val datasets AUTOMATICLY.See [testYoloLike.py](./test_scripts/test_yololike_generate.py). The test dataset can be found in ./test/ , 68 txts totally.

![split-yolo](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/splitYolo.gif)

## 2020.11.25

### 1. negative sample AUTOMATICLY randomly generate. I am not sure if it is helpful to my face detection cnn.

![img-negative](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/negative.png)

### 2. rewrite [mosaic.py](./convertmask/utils/auglib/optional/mosaic.py)(without resize the origin images). See [here](./test_scripts/test_mosiac.py).

![img-mosiac](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/mosiac2.png)

## 2020.11.16

### 1.support converting widerface annotations to xmls. see [here](./test_scripts/test_convert_widerface.py)

## 2020.11.10

### 1. object-oriented rewrite augumentation optional module. See [here](./convertmask/utils/auglib/options_operator_without_label.py). Test script can be found [here](./test_scripts/test_optional_operation.py)

## 2020.10.25

### 1. bump to 0.5.3

### 2. code structure change

### 3. mosiac(yolov4) augumentation supported(auto labeled for labelImg,for labelme will be updated as fast as i can). Script can be found [here](./test_scripts/test_mosiac.py)

![img-mosiac](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/mosiac.png)

## 2020.10.24

### 1.image crop supported.(single and multiple crops,rectangle and polygon support. See [here](./convertmask/utils/auglib/optional/crop.py))

![img-crop](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/testCrop.jpg)

### 2.image resize supported (auto labeled). See [here](./convertmask/utils/auglib/optional/resize.py) and the test script is [here](./test_scripts/test_resize.py)

![img-resize](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/resize1.png)

## 2020.10.23

### 1.image distortion supported.

![img-distort](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/multi_objs_distort.jpg)

see [here](./convertmask/utils/auglib/optional/distort.py) or [test-script](./test_scripts/test_local_wrap.py) for details.

## 2020.10.13

### 1.image augumentation support convert yolo txts to xmls(pascal). See [here](./test_scripts/test_yolo2xml.py)

### 2.speed up by using multiprocess

## 2020.10.12

### 1.image augumentation support generating several annotation/images with single image/annotation(json,xml). See [here](./test_scripts/test_multi_augment.py)

## 2020.9.24

### 1.inspired by [LabelImgTool](https://github.com/lzx1413/LabelImgTool), convert xmls to jsons is useful. Also ,i forked this repo and add some pyqt5/py3 support,see [here](https://github.com/guchengxi1994/LabelImgTool).

examples:

script [here](./test_scripts/test_xml2json.py)

![xml2json](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/xml2json.gif)

## 2020.8.24

### 1.support convert xml files to yolo files. see [here](./test_scripts/test_xml2yolo.py)

examples:

![xml2yolo](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/xml2yolo.gif)

## 2020.8.19

### 1. image translation supported.

![img-translation](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/translation.png)

combination of every augmentation method.

![img-combination](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/combine.png)

### 2. besides, a simple way convert json file(labelme) to xml file(labelImg) is provided. see [here](./test_scripts/test_json2xml.py)

![json2xml](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/json2xml.png)

## 2020.8.17

### 1. bug fix.

### 2. support image augmentation methods: noise,flip,rotation. try [test_imgAug.py](./test_scripts/test_imgAug.py) !

here are some examples:

### flip

![img-flip-h](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/flip_h.png)

![img-flip-v](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/flip_v.png)

![img-flip-v-h](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/flip_v_h.png)

### noise

![img-noise](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/noise.png)

### rotation

![img-rotation](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/rotation.png)

## 2020.8.14

### 1. add image augmentation  (image flip) test. see [test_imgAug.py](./test_scripts/test_imgAug.py) !

## 2020.7.14

### 1.bugfix , test multi objects to xml files, pretty xmls

eg:

![mask2xml](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/auto_mask2xml.png)

## 2020.7.13

### 1. convert multi objects to xml files supported (untested)

## 2020.7.10

### 1. a lot of things to do ,such as many warnings related to labelme.

## 2020.6.12

### 1.support multiple objects mask to json

try [test.py](./test_scripts/test.py) !

#### 1.1 multiple objects in different classes

manually_labeled image

![manually_labeled_multi_objs](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/manually_labeled_multi_objs.png)

auto_labeled image

![auto_labeled_multi_objs](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/auto_labeled_multi_objs.png)

#### 1.2 multiple objects in same classes

manually_labeled image

![manually_labeled_multi_objs_samelabel](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/manually_labeled_multi_objs_samelabel.png)

auto_labeled image

![auto_labeled_labeled_multi_objs_samelabel](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/auto_labeled_labeled_multi_objs_samelabel.png)

# what to do next

## 1. ~~support multiple files image augmentation~~ (2020.8.21)

## 2. ~~support image augmentation without a label/json file~~  (2020.8.21)

## 3. ~~support image augmentation with a labeled file (just support json file right now)~~ (2020.9)

## 4. image augmentation supports custom parameters (auto augmented right now)

## 5. do something more interesting

## 6. ~~re-write main [script](./convertmask/main_v_0_3_any.py)~~ (2020.10)

## 7. ~~ solve PyYmal installation error(currently write a [script](./convertmask/utils/methods/yamlUtils.py) by myself. maybe failure in the end.)~~

## 8. ~~image augmentation zoooom~~ (2020.10.14)

## 9. yolo txts split train/val dataset automaticly.

# OTHERS

1. [issue:json2mask has no output](https://github.com/guchengxi1994/mask2json/issues/3)

![json2mask](https://raw.githubusercontent.com/guchengxi1994/mask2json/master/backup/json2mask.gif)

if you test the [json2mask.py](./test_scripts/json2mask.py) script, you should change the path first and make sure the file is valid(maybe i have deleted :) )

Also, this script is just a reverse of mask2json, for a more COOOOOL method, see [here](./convertmask/utils/json2mask/convert.py) , try convert.processor

#  SHORTCOMING

1.~~objects connected to each other is not supported yet.~~

this may happen if you labelling multiple-object-images with only 2 labels .Or some objects are of the same type and are connected to each other(eg. a bunch of grapes,it is hard to split one to the other).

2.Image Binarization [issue](https://github.com/guchengxi1994/mask2json/issues/14)

mask2json

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README