Standard Block Comparison Method
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).
- Prepare a CSV file like
example_data.csv(can be generated via AI prompts). - 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)
| File | Size | Uploaded | |
|---|---|---|---|
| standard_block_auditor-0.1.3.tar.gz | 15.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|