zi2zi: Master Chinese Calligraphy with Conditional Adversarial Networks
Introduction
Learning eastern asian language typefaces with GAN. zi2zi(字到字, meaning from character to character) is an application and extension of the recent popular pix2pix model to Chinese characters.
Details could be found in this blog post.
Network Structure
Original Model
The network structure is based off pix2pix with the addition of category embedding and two other losses, category loss and constant loss, from AC-GAN and DTN respectively.
Updated Model with Label Shuffling
After sufficient training, d_loss will drop to near zero, and the model's performance plateaued. Label Shuffling mitigate this problem by presenting new challenges to the model.
Specifically, within a given minibatch, for the same set of source characters, we generate two sets of target characters: one with correct embedding labels, the other with the shuffled labels. The shuffled set likely will not have the corresponding target images to compute L1_Loss, but can be used as a good source for all other losses, forcing the model to further generalize beyond the limited set of provided examples. Empirically, label shuffling improves the model's generalization on unseen data with better details, and decrease the required number of characters.
You can enable label shuffling by setting flip_labels=1 option in train.py script. It is recommended that you enable this after d_loss flatlines around zero, for further tuning.
Gallery
Compare with Ground Truth
Brush Writing Fonts
Cursive Script (Requested by SNS audience)
Mingchao Style (宋体/明朝体)
Korean
Interpolation
Animation
How to Use
Step Zero
Download tons of fonts as you please
Requirement
- Python 2.7
- CUDA
- cudnn
- Tensorflow >= 1.0.1
- Pillow(PIL)
- numpy >= 1.12.1
- scipy >= 0.18.1
- imageio
Preprocess
To avoid IO bottleneck, preprocessing is necessary to pickle your data into binary and persist in memory during training.
First run the below command to get the font images:
python font2img.py --src_font=src.ttf
--dst_font=tgt.otf
--charset=CN
--sample_count=1000
--sample_dir=dir
--label=0
--filter=1
--shuffle=1
Four default charsets are offered: CN, CN_T(traditional), JP, KR. You can also point it to a one line file, it will generate the images of the characters in it. Note, filter option is highly recommended, it will pre sample some characters and filter all the images that have the same hash, usually indicating that character is missing. label indicating index in the category embeddings that this font associated with, default to 0.
After obtaining all images, run package.py to pickle the images and their corresponding labels into binary format:
python package.py --dir=image_directories
--save_dir=binary_save_directory
--split_ratio=[0,1]
After running this, you will find two objects train.obj and val.obj under the save_dir for training and validation, respectively.
Experiment Layout
experiment/
└── data
├── train.obj
└── val.obj
Create a experiment directory under the root of the project, and a data directory within it to place the two binaries. Assuming a directory layout enforce bettet data isolation, especially if you have multiple experiments running.
Train
To start training run the following command
python train.py --experiment_dir=experiment
--experiment_id=0
--batch_size=16
--lr=0.001
--epoch=40
--sample_steps=50
--schedule=20
--L1_penalty=100
--Lconst_penalty=15
schedule here means in between how many epochs, the learning rate will decay by half. The train command will create sample,logs,checkpoint directory under experiment_dir if non-existed, where you can check and manage the progress of your training.
Infer and Interpolate
After training is done, run the below command to infer test data:
python infer.py --model_dir=checkpoint_dir/
--batch_size=16
--source_obj=binary_obj_path
--embedding_ids=label[s] of the font, separate by comma
--save_dir=save_dir/
Also you can do interpolation with this command:
python infer.py --model_dir= checkpoint_dir/
--batch_size=10
--source_obj=obj_path
--embedding_ids=label[s] of the font, separate by comma
--save_dir=frames/
--output_gif=gif_path
--interpolate=1
--steps=10
--uroboros=1
It will run through all the pairs of fonts specified in embedding_ids and interpolate the number of steps as specified.
Pretrained Model
Pretained model can be downloaded here which is trained with 27 fonts, only generator is saved to reduce the model size. You can use encoder in the this pretrained model to accelerate the training process.
Acknowledgements
Code derived and rehashed from:
- pix2pix-tensorflow by yenchenlin
- Domain Transfer Network by yunjey
- ac-gan by buriburisuri
- dc-gan by carpedm20
- origianl pix2pix torch code by phillipi
License
Apache 2.0
left is pcgreat/zi2zi right is kaonashi-tyc/zi2zi
And you can see some tensor is not exist in the pcgreat/zi2zi checkpoint
I was wondering if someone can tell me and fix it
![package.py: error: argument --split_ratio: invalid float value: '[0,1]'](https://avatars.githubusercontent.com/u/79965?v=4)
137 Nov 9, 2022
1 Feb 13, 2022
72 Dec 31, 2022
150 Dec 6, 2022
4 Aug 28, 2022
7 Dec 27, 2022
4 Sep 18, 2022
191 Dec 31, 2022
64 Dec 22, 2022
29 Nov 19, 2022
444 Dec 30, 2022
81 Sep 3, 2022
1.7k Jan 8, 2023
86 Nov 16, 2022
181 Dec 27, 2022
165 Jan 3, 2023
248 Nov 21, 2022
57 Dec 29, 2022