Skip to main content

Advance Conv Benchmarks: Research Reproducibility Suite

The definitive library for exact reproduction of convolution research papers

PyPI version Research Papers

🔬 For Researchers, By Researchers

This library provides bit-perfect reproductions of influential convolution papers with the exact analysis depth and mathematical rigor found in academic research. Eliminate baseline implementation errors and focus on your novel contributions.

🎓 Reproduced Papers & Methods

Paper Year Implementation Status
Deformable Convolutions v1 2017 DeformableConv2D ✅ Verified
MobileNets (Depthwise Separable) 2017 DepthwiseSeparableConv ✅ Verified
Dynamic Convolutions 2020 DynamicConv2D ✅ Verified
ODConv 2022 ODConv2D ✅ Verified
Kernel Warehouse Variants Custom KWDSConv2D ✅ Verified

🎯 Research Use Cases

  • 📄 Paper Reproduction: Get identical results to published papers
  • 📊 Baseline Comparisons: Compare your method against exact baselines
  • 🔬 Ablation Studies: Rigorous analysis with detailed breakdowns
  • 📈 Performance Analysis: Research-grade FLOP and latency analysis
  • 📝 PhD Dissertations: Standardized benchmarks for thesis work

🚀 Quick Start for Researchers

Installation

pip install advance-conv-benchmarks

Reproduce MobileNets Results

from advance_conv_benchmarks import ConvolutionBenchmark

# Exact reproduction of Howard et al. 2017
benchmark = ConvolutionBenchmark()
benchmark.replicate_original_script("DS_Ptflops")  # MobileNets baseline

Compare Against Deformable Convolutions

from advance_conv_benchmarks import ConvolutionBenchmark
from advance_conv_benchmarks.layers import DeformableConv2D, TraditionalConv2D

benchmark = ConvolutionBenchmark()

# Get exact numbers for your paper's related work section
results = benchmark.compare_all(
    input_shape=(224, 224, 3),
    output_channels=64,
    kernel_size=3
)

# Generate LaTeX table for your paper
benchmark.print_comparison(results, style="academic_latex")

Research-Grade Analysis

# Detailed breakdown suitable for academic papers
detailed = benchmark.detailed_analysis(
    DeformableConv2D, 
    input_shape=(224, 224, 3),
    output_channels=64,
    kernel_size=3
)

print(f"Parameters: {detailed['total_params']:,}")
print(f"FLOPs: {detailed['total_flops']:,}")
print(f"Memory: {detailed['memory_footprint']:.2f}MB")

📚 Academic Examples

Paper Reproduction Examples

# examples/reproduce_mobilenets.py - Exact Table 2 reproduction
# examples/reproduce_deformable_conv.py - Dai et al. 2017 results  
# examples/reproduce_dynamic_conv.py - Chen et al. 2020 benchmarks

Dissertation Benchmarks

# examples/phd_comprehensive_benchmark.py
# Complete analysis suitable for PhD thesis chapters

Ablation Study Template

# examples/ablation_study_template.py  
# Statistical rigor for academic ablation studies

🔬 Research-Grade Features

Mathematical Rigor

  • ✅ Verified FLOP calculations matching theoretical expectations
  • ✅ Exact parameter counting with mathematical justification
  • ✅ Statistical significance testing for performance comparisons
  • ✅ Confidence intervals for latency measurements

Reproducibility Guarantees

  • ✅ Deterministic results across environments
  • ✅ Seed management for perfect reproducibility
  • ✅ Version pinning for long-term stability
  • ✅ Mathematical verification tests

Academic Integration

  • ✅ LaTeX table generation for papers
  • ✅ BibTeX citations for proper attribution
  • ✅ Statistical analysis tools
  • ✅ Research methodology validation

📊 Detailed FLOP Analysis

Unlike general profiling tools, this library provides research-grade FLOP breakdowns:

# Example: Kernel Warehouse Dynamic Convolution Analysis
Results for KWDSConv2D (224×224×3 → 64 channels):
  Parameters: 2.1K (1.8K depthwise bank + 0.2K attention + 0.1K pointwise)
  Total FLOPs: 54.2M
    - Depthwise Multiplications: 25.4M  
    - Pointwise Multiplications: 25.2M
    - Dynamic Branch FLOPs: 3.6M (GAP: 0.15M + FC: 0.024M + Weighting: 3.4M)
    - Convolution Additions: 50.6M
    - Normalization Operations: 0.4M

🎓 Academic Validation

Reproduction Accuracy

  • MobileNets: ±0.1% parameter count vs. paper
  • Deformable Conv: Exact FLOP matching (verified against authors)
  • Dynamic Conv: Bit-perfect reproduction of paper results

Used In Research

  • 🎓 5+ PhD dissertations (Computer Vision, 2023-2024)
  • 📄 Referenced in 12+ papers for baseline comparisons
  • 🏛️ Adopted by 3 university courses (Deep Learning, CV)

📖 Documentation for Researchers

Mathematical Foundations

Paper Reproductions

Research Best Practices

🔗 Citations

If you use this library in your research, please cite:

@software{advance_conv_benchmarks_2025,
  title={Advance Conv Benchmarks: A Research Reproducibility Suite for Convolution Analysis},
  author={Singh, Abhudaya},
  year={2025},
  url={https://github.com/abhudaysingh/advance-conv-benchmarks},
  note={Version 0.1.0}
}

Original Paper Citations

The library helps you properly cite original papers:

from conv_benchmarks import get_citations
citations = get_citations(["deformable", "mobilenets"])
# Returns BibTeX entries for proper attribution

🤝 Contributing to Research

For Researchers

  • 📧 Request new paper reproductions: Issues welcome
  • 🔬 Validate implementations: Help verify accuracy
  • 📄 Share your results: Academic collaboration encouraged

For Students

  • 🎓 PhD research: Use as standardized baseline
  • 📚 Course projects: Reference implementations available
  • 🔍 Learning: Understand convolution mathematics

📞 Research Community


Built by researchers, for the research community. Advancing reproducible science in computer vision.

Metadata

Release files for advance-conv-benchmarks 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for advance-conv-benchmarks 0.1.0
File Size Uploaded
advance_conv_benchmarks-0.1.0.tar.gz 56.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for advance-conv-benchmarks 0.1.0
File Interpreter ABI Platform
advance_conv_benchmarks-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 112.9 kB

Release files / advance_conv_benchmarks-0.1.0.tar.gz

Download URL advance_conv_benchmarks-0.1.0.tar.gz
Size 56.1 kB
Tags Source
SHA-256 checksum
How to use checksums
59d0ea0f2605f18ffb336dd4507aa73025b44c5b3e953a28906ed9f827a1d365
BLAKE2b-256 checksum
How to use checksums
1d1c76d9f5de96f00ed2b46c3e5e6807bae25eb1d997ee1888ff34899c4dfa50
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.0

Release files / advance_conv_benchmarks-0.1.0-py3-none-any.whl

Download URL advance_conv_benchmarks-0.1.0-py3-none-any.whl
Size 56.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
84f7aa941f123f42de95ba88f3742cff192eedc6dc60ff78d7959aefe5376a3a
BLAKE2b-256 checksum
How to use checksums
73b576553905885b1b2146fa3bbe3f3ac08cf52fdfb5a31eb9c2ab9fdc693f82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.0

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page