Skip to main content

Standard Block Comparison Method

PyPI version License: MIT DOI DOI

A quantitative auditing framework to break free from "number magic" and measure the true effectiveness of administrative measures.


📖 Overview

Huge figures announced by governments and corporations, such as "cumulative total of X people" or "budget of Y billion yen," are often used to obscure the reality (ROI). This project provides the "Standard Block Comparison Method (SBCM)," a technique to mathematically determine whether a measure functions as social infrastructure or is merely a statistical "error" by breaking these numbers down to the smallest unit: the "Standard Block" (Basic Municipality).

This repository contains the SBCM calculation tools and a Python library for detecting "budgetary distortion" in financial data.

🚀 Installation

This tool is available as a Python package. You can install it using pip:

pip install standard-block-auditor

(Note: If you registered it under a different name, please replace the package name accordingly.)

⚡ Quick Start

After installation, you can use the following commands directly from your terminal.

1. Verify a Single Metric (sbcm-calc)

Calculate the impact of a number (users or budget) announced by the government on a national scale.

# Example: "3,000 users" (Target: Total population)
sbcm-calc --value 3000 --target_ratio 1.0

# Example: "10 Billion JPY Budget"
sbcm-calc --value 10000000000

2. Audit Financial Statements (sbcm-audit)

Load financial data and automatically detect projects that are "High Cost but Low Reach" (Quadrant 4).

  1. Prepare a CSV file like example_data.csv (can be generated via AI prompts).
  2. Run the command:
# Specify city population (e.g., Kashiwa City: 435,000)
sbcm-audit example_data.csv --pop 435000

This outputs an analysis file (distortion_analysis_result.csv) and a visualization graph (distortion_matrix.png).

3. Statistical Verification (sbcm-verify)

Verify the robustness of the results using Monte Carlo simulations to counter arguments about estimation errors.

# Example: 3,000 users, Target ratio 15% (±3% uncertainty)
sbcm-verify --value 3000 --target_ratio 0.15 --ratio_sd 0.03

📐 Methodology

Effectiveness Impact ($I$)

The index measuring the reach of a policy.

$$ I = \frac{V}{B} $$

The Standard Block ($B$) is defined based on Japan's demographics and administrative structure:

$$ B = \frac{P \times R}{N} $$

  • $P$: Total Population of Japan (124 Million)
  • $N$: Total Municipalities (1,718)
  • $R$: Target Attribute Ratio
  • $B \approx 72,176 \times R$ (people)

The Verdict Criteria

Impact ($I$) Verdict Benchmark
$I < 1.0$ Error Level Out of scope. Cannot even cover one standard municipality.
$1.0 \le I < 17$ Localized Experimental phase. Not even reaching early adopters.
$172 \le I < 859$ Infrastructure Becoming a foundational public service (e.g., Water, Electricity).
$I \ge 859$ Social OS Majority adoption. A prerequisite for modern society.

📊 Budget Portfolio Analysis

An extension of SBCM that visualizes the balance between "Invested Tax (Budget)" and "Achieved Outcome (Coverage)."

Budget Distortion Index ($D_{index}$)

$$ D_{index} = \frac{I_{budget}}{I_{coverage}} $$

Based on this index, projects are classified into four quadrants:

Quadrant Status Verdict
Q1 (High Cost / High Reach) Infrastructure Appropriate. Expensive but used by everyone (Roads, Waste collection).
Q2 (Low Cost / High Reach) Innovation Excellent. Low budget, high impact (Digital transformation).
Q4 (High Cost / Low Reach) 【Distortion】 Audit Required. Huge taxes vanishing into the pockets of a few.

📂 Directory Structure

Standard-Block-Comparison-Method/
├── sbcm/                  # Python Package Source Code
│   ├── __init__.py
│   ├── block_calculator.py
│   ├── budget_distortion_analyzer.py
│   ├── sensitivity_analysis.py
│   ├── config.py          # Shared Constants
│   └── visualizer.py      # Graph Plotting Module
│
├── prompts/               # AI Auditor Prompts
├── reports/               # Case Studies & Reports
├── example_data.csv       # Sample Data
├── google_sheets_script.js # Google Apps Script
├── pyproject.toml         # Package Configuration
└── README_EN.md           # This Document

📝 License

This project is released under the MIT License. Feel free to use it for administrative verification and auditing.


Author

Melnus (GitHub: Melnus)

📝 Citation

If you use SBCM in your research or auditing, please cite the following paper:

Koyama, H. (2025). Proposal for the Standard Block Comparison Method (SBCM) in the Quantitative Evaluation of Administrative Measures. Zenodo. https://doi.org/10.5281/zenodo.17762960

Metadata

Release files for standard-block-auditor 0.1.3

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

Source distribution (sdist)

Source distribution for standard-block-auditor 0.1.3
File Size Uploaded
standard_block_auditor-0.1.3.tar.gz 15.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for standard-block-auditor 0.1.3
File Interpreter ABI Platform
standard_block_auditor-0.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 29.5 kB

Release files / standard_block_auditor-0.1.3.tar.gz

Download URL standard_block_auditor-0.1.3.tar.gz
Size 15.8 kB
Tags Source
SHA-256 checksum
How to use checksums
708b7ba66ad6c86342a216402d8a9d71a0d93340025f936be0aeee4b20e2e2f0
BLAKE2b-256 checksum
How to use checksums
ce69eacb72250413f3293108f3e8660292515f6a4bf7b64ab54d6960a5864831
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / standard_block_auditor-0.1.3-py3-none-any.whl

Download URL standard_block_auditor-0.1.3-py3-none-any.whl
Size 13.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cfd9f6699bef01840b472fc9e84ba0d217a583b190c931dff031f5ae2b41db7f
BLAKE2b-256 checksum
How to use checksums
f494975b491561f5f592e95c7dd33751ee7dc2f50510c9705c4486096e8a5e7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files

0.1.2

2 release files

0.1.1

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