Advanced Annotation Editor User Guide

🎯 Core Features

This is a complete image annotation tool that supports:

✨ Main Features

1. Visual Image Display - Display images on Canvas
2. Mouse Drawing Annotation Boxes - Drag mouse to create rectangular annotations
3. Auto Calibration - Automatically add missing images from folders
4. ID Consistency - Automatically maintain image and annotation ID order
5. Category Management - Support multiple annotation categories
6. Batch Processing - Traverse all images missing annotations

🚀 Quick Start

1. Launch Program

Double-click Launch Advanced Annotation Editor.bat or run:

python annotation_editor_advanced.py

2. Load Data

1. Click "📁 Open Annotation File" to select annotations.json
2. The program will automatically detect the image folder, or manually select the image folder
3. The program automatically loads all images and adds missing items

3. Annotation Workflow

Method 1: Manual Sequential Annotation

1. Use navigation buttons (◀️ ▶️) or click left list to select images
2. Select annotation category on the right
3. Drag mouse on image to draw annotation box
4. Annotations are automatically saved to list
5. Continue to next image

Method 2: Auto Calibration Mode ⭐ Recommended

1. Click toolbar "🔄 Show Missing" or right "⚡ Auto Calibrate All"
2. Program automatically filters all images missing annotations
3. Annotate each image in order
4. Click "Next" to continue
5. After all completed, click "💾 Save"

📋 Detailed Operation Instructions

Image Navigation

• ⏮️ First: Jump to first image
• ◀️ Previous: Previous image
• ▶️ Next: Next image
• ⏭️ Last: Jump to last image

Image Zoom

• ➕ Zoom In: Zoom in image display
• ➖ Zoom Out: Zoom out image display
• 🔍 Fit: Auto fit to window size
• 1:1: Display actual size

Annotation Operations

Add Annotation

1. Click "➕ Add Annotation" to enter annotation mode
2. Press and hold left mouse button on image and drag
3. Release mouse to complete annotation box drawing
4. Right-click to cancel current drawing

Edit Annotation

1. Select annotation in "Current Image Annotations" list on right
2. Click "Edit" button to modify
3. Or click "Delete" button to remove

Category Management

1. Select category in "Annotation Categories" area
2. Click "➕ Add Category" to create new category
3. Newly drawn annotations will use currently selected category

Filtering and Search

Left Image List Filtering

• All: Display all images
• Annotated: Only show annotated images
• Missing: Only show images needing annotation ⭐
• Search Box: Search by filename

Quick Operations

⚡ Auto Calibrate All

• Automatically filter images missing annotations
• Guide you to complete annotations one by one
• Ensure all images have annotations

📊 Statistics

Display:

• Total images
• Annotated/unannotated image counts
• Category annotation count statistics

✓ Validate Data

Check:

• Duplicate IDs
• Invalid reference relationships
• Data integrity

💡 Best Practices

Complete Annotation Flow (Recommended)

1. Launch program
   ↓
2. Open annotation file (annotations.json)
   ↓
3. Select image folder (萎缩性胃炎/)
   → Program automatically adds missing images and reassigns continuous IDs
   ↓
4. Click "⚡ Auto Calibrate All"
   ↓
5. Draw annotation boxes for each missing annotation image
   - Drag mouse to draw rectangle
   - Can draw multiple annotation boxes per image
   ↓
6. Click "Next" to continue
   ↓
7. After all completed, click "📊 Statistics" to confirm
   ↓
8. Click "✓ Validate Data" to check
   ↓
9. Click "💾 Save" to save all changes

Correct Existing Annotations

1. Filter to "Annotated" in left list
2. Click image needing correction
3. Select annotation to modify in right annotation list
4. Click "Delete" to remove incorrect annotation
5. Redraw correct annotation box
6. Save changes

🎨 Interface Layout

┌─────────────────────────────────────────────────────────┐
│ Toolbar: File|Navigation|Annotation|Save                │
├──────────┬──────────────────────────┬───────────────────┤
│          │                          │                   │
│  Image   │   Image Display Area     │   Annotation      │
│  List    │   (Zoomable/Drawable)    │   Management      │
│          │                          │   - Category Sel  │
│  - Search│   Tools: Zoom Controls   │   - Current List  │
│  - Filter│                          │   - Edit/Delete   │
│          │                          │   - Quick Ops     │
│          │                          │                   │
└──────────┴──────────────────────────┴───────────────────┘
│ Status Bar: Current Status | File Info                  │
└─────────────────────────────────────────────────────────┘

🔑 Keyboard Shortcuts (Future Addition)

• Ctrl+S: Save
• ← / →: Previous/Next image
• Delete: Delete selected annotation
• Esc: Cancel drawing

⚠️ Important Notes

1. Auto Backup: Program automatically adds missing images to annotation file, recommend backing up original file
2. ID Management: Program automatically maintains ID continuity and consistency
3. Save Reminder: Prompt to save if unsaved changes when closing
4. Annotation Format: Annotation boxes use COCO format [x, y, width, height]

📊 Data Format

Annotation File Structure (COCO Format)

{
  "images": [
    {
      "id": 1,
      "file_name": "14215.jpg",
      "width": 576,
      "height": 498
    }
  ],
  "annotations": [
    {
      "id": 1,
      "image_id": 1,
      "category_id": 1,
      "bbox": [100, 50, 200, 150],
      "area": 30000,
      "iscrowd": 0,
      "segmentation": []
    }
  ],
  "categories": [
    {
      "id": 1,
      "name": "lesion_area",
      "supercategory": ""
    }
  ]
}

🔧 Troubleshooting

Q: Images not displaying?

A: Check image folder path is correct, ensure image formats are supported (.jpg, .png, etc.)

Q: Cannot draw annotation boxes?

A: Ensure "➕ Add Annotation" button is clicked and a category is currently selected

Q: Save failed?

A: Check file not occupied by other programs, has write permissions

Q: IDs not continuous?

A: After loading annotation file, program automatically sorts by filename and reassigns continuous IDs

🆚 Comparison with Basic Version

Feature	Basic Version (annotation_corrector_gui.py)	Advanced Version (annotation_editor_advanced.py)
View List	✓	✓
Add/Delete Images	✓	✓ (Auto)
Display Images	✗	✓
Draw Annotation Boxes	✗	✓
Annotation Management	✗	✓
Category Management	✗	✓
Batch Annotation	✗	✓
Image Zoom	✗	✓

💻 System Requirements

• Python 3.6+
• Pillow (PIL): pip install pillow
• tkinter (Usually included with Python)

📝 Usage Scenarios

Scenario 1: New Annotation Project

Suitable for creating annotations from scratch for a batch of images

Scenario 2: Supplement Missing Annotations ⭐

Suitable for some images having annotations, need to add annotations for remaining images

Scenario 3: Correct Error Annotations

Suitable for existing annotations needing correction

Scenario 4: Batch Review

Suitable for checking and validating all annotations correctness

🎓 Video Tutorial (Recommended Recording)

Suggested recording videos for following operations:

1. Basic annotation flow demonstration
2. Auto calibration function usage
3. Category management
4. Data validation and saving

---

Development Version: v2.0 Advanced Update Date: 2025-10-13

Support: Contact development team if issues encountered