Anzhcs_YOLOs

Description

YOLOs in this repo are trained with datasets that i have annotated myself, or with the help of my friends(They will be appropriately mentioned in those cases). YOLOs on open datasets will have their own pages.

Known Adetailer Issues

Ultralytics 8.3.217 updates mask handling, which breaks function in main Adetailer repo. Install Ultralytics==8.3.216 or lower. Alternatively - use forks that fix this. - Fixed in main repo.

My Adetailer fork

I've added some features to make Adetailer more usable and less manual - https://github.com/Anzhc/aadetailer-reforge

Want to request a model?

Im open to commissions, hit me up in Discord - anzhc

Table of Contents

• Face segmentation
  • Universal
  • Real Face, gendered
• Eyes segmentation
• Head+Hair segmentation
• Breasts
  • Breasts Segmentation
  • Breast size detection/classification
• Drone detection
• Anime Art Scoring
• Support

P.S. All model names in tables have download links attached :3

Available Models

Face segmentation:

Universal:

Series of models aiming at detecting and segmenting face accurately. Trained on closed dataset i annotated myself.

UPDATE: v3 model has a bit different face target compared to v2, so stats of v2 models suffer compared to v3 in newer benchmark, especially in mask, while box is +- same. Dataset for v3 and above is going to be targeting inclusion of eyebrows and full eyelashes, for better adetailer experience without large dillution parameter.

Also starting from v3, im moving to yolo11 models, as they seem to be direct upgrade over v8. v12 did not show significant improvement while requiring 50% more time to train, even with installed Flash Attention, so it's unlikely i will switch to it anytime soon.

UPDATE: V4 - Addition of high complexity data (over 100 instances per image), more simple realistic and AI-generated faces.

Benchmark was performed in 640px. V2 was condensed to single model, as their differences are marginal.
Benchmark results were recomputed on new val based on V4 dataset(images previously in val remained in val, so no contamination for previous versions), stats updated accordingly.

Real Face, gendered:

Trained only on real photos for the most part, so will perform poorly with illustrations, but is gendered, and can be used for male/female detection stack.

Benchmark was performed in 640px.

Eyes segmentation:

Was trained for the purpose of inpainting eyes with Adetailer extension, and specializes on detecting anime eyes, particularly - sclera area, without adding eyelashes and outer eye area to detection. Current benchmark is likely inaccurate (but it is all i have), due to data being re-scrambled multi times (dataset expansion for future versions).

Head+Hair segmentation:

An old model (one of my first). Detects head + hair. Can be useful in likeness inpaint pipelines that need to be automated.

Breasts:

Breasts segmentation:

Model for segmenting breasts. Was trained on anime images only, therefore has very weak realistic performance, but still is possible.

Breast size detection and classification:

Model for Detecting and classifying breast size. Can be used for tagging and moderating content. Utilizes custom scale, combining default Booru sizes with quite freeform upper range of scale from rule34, simplifying and standartizing it.

Size range is established relative to body proportion, instead of relative to scene, to not be confused in cases of gigantism and be disentangled from scene.
And of course it's subjective, since i was the only one annotating data.

mAPs are not displayed in table, because i think we need more complex stats for this model.

Accurate ratio - correct predictions, exactly matching val.
+1, -1, +-1 ratio - expanded range of acceptable predictions, by +,- and +-1 class. I suggest using this stat as main accuracy, because +-1 range is likely an acceptable margin of error.
At annotation, usual rate of error of original data according to this size scale was in range of +-2 to +-3 in some cases, so +-1 should be quite good.
Miscalss ratio - Correct detection, but classification goes beyond +-1 error.
Miss ratio - Not seen by model, completely missed.
False-Positive ratio - Detection of something that isn't there.
In case of this model i suspect that FPR is also including confusion rate. In some cases multiple detection will be made for single instance, and only 1 will be accepted.
That can be counted as false-positive, while it will be covered in +-1 acc. Actual FPR should be lower than reported, as tested manually.
GT Instances - amount of instances of data per class in dataset.

With that established,
v8 provides pretty decent quality detection and classification, except for extremes of class 11+, and class 0(flat chest), well, since it's not too simple to detect what's not there.
Class 2(medium) is one of the most confusing in this case, and has lowest accuracy. From charts, it's mostly mistaken with class 1.
Rest of classes with reasonable amount of data perform quite well, and achieve high 70s to mid 80s for normal sizes, and up to high 90s for bigger size range.
Misclassification is quite rare, and im happy with model performance in that regard. Average rate of misclassification is just ~3%.
Missing predictions is unfortunately over 10%, but data is highly skewed with classes 0-2, which are hard to detect.
FPR for v8 is very reasonable, assuming confused detections(of 2 classes at once) are counted as FPR. Size range is smooth, and lots of cases where both classes could be applied.

Last class(unmeasurable) is used for classifying outliers that are hard to measure in currently visible area(e.g. mostly out of frame), but model will try to reasonably predict obstructed and partially visible instances.

All ratios are calculated relative to their respective GT instance count.

I will continue to use this benchmark approach for future detection models.

Drone detection

Model for segmenting and detecting drones. What a wild swing after entry for breast model, huh. I don't really know, just had an idea, made it work, here we are.

I would highly advice against using it in anything serious.

Starting from v03. Consider it as v1, since v03 is my internal iteration.

HIGHLY SENSITIVE TO DRONE MODELS - will have hard time detecting certain types, especially close-up. Performs poorly on cluttered background.

Anime Art Scoring

A classification model trained to assign a percentile group based on human preference, instead of trying to directly assign a "quality" label.
Dataset was composed of about 100k images aged from 1 to 2 years on Danbooru (newer and older images were not used). That limits data to images that were sufficiently viewed and rated, while not being overly exposed due to age, nor underexposed.
Scores were used and split into percentile groups, each 10%.

Main interest in making this one was to find out if there is a significant discoverable correlation between scores and image quality.
Here are my custom charts:

(top100 is second class due to alphabetical sorting, but for margin acceptance chart it was re-sorted)

From this chart, considering there are 10 classes in total, i found weak-to-modest correlation between scores and upper half of chart, negative correlation with middle-low part, weak for low, and moderate for lowest.

What does that mean?

It means that there is meaningful correlation between scoring of people relative to features of art in question, but there is no meaningful correlation between art that is scoring neutrally.
Negative scoring (top80-100) has moderate correlation, which suggests that there are some uniform negative features we can infere.
Top60 class is very interesting, because it presents no correlation between provided images, even in top-3 accuracy(it performs at near-random selection in that case(10%)).
That suggests that there is no feature correlation between art being not noticed, at least not the one YOLO was able to find.

We can reasonably predict art that will end up in top of the chart by human score, but we are not able to predict middle-of-the line art, which would constitute majority of art in real case.
We can predict low quality based on human preference reasonably well, but far from ideal.

Margin acceptance charts - A top-1 accuracy, but with margin of class acceptance(1, 2 and 3(starts with -1, then adds +1 and then -2 class)(it/s not +-1-3 as naming suggests))
This allows us to see how well are classes correlate. If we see significant increase relative to first chart, that means that second best prediction was selected as top-1.
We can also see extended correlation trend across classes. We once again can see that middle classes have very low correlation and accuracy, suggesting no meaningful features.
That kinda suggests to me that there is no reason for art that ended up in middle of dataset to be there, and it would end up higher or lower in perfect world.

Top10-40 correlates very well, and that can be used for human preference detection. Funny note on that: bigger the breasts - better the score.
And i wholeheartedly support that notion.
NSFW art in general will have higher preference score, well, what an unexpected outcome, amirite? Dataset was composed ~50/50% from Danbooru/Safebooru(safebooru.donmai.us), so it's not due to overrepresentation of NSFW.
That is also why you should not use scores for quality tagging, but if you are looking for a thing to maintain high compatibility with current anime models - be my guest.
Correlation between bottom scores(that you'd use for low quality/worst quality) is weaker, so be conservative with that.

Bigger model and data will likely see more correlation, but from quick test of just running larger variation did not lead me to better performance.

Additionally, i will provide a script for tagging your datasets with that, if you want - Simple Utility Scripts repo

Support

If you want to support me, feel free to donate on ko-fi:
https://ko-fi.com/anzhc

Or send me some BTC:
bc1qpc5kmxrpqp6x8ykdu6976s4rvsz0utk22h80j9

/--UNDER CONSTRUCTION--/