fin-paper-figure

fin-paper-figure

Generate academic-quality figures (>=300 DPI) for economics and finance papers. Reads FIGURE_PLAN.md and actual data, then produces publication-ready figures using FinancialChartFactory.

Step 0: Environment Check

Before generating any figures, verify the environment:

# Check required packages
python -c "import matplotlib; import seaborn; import pandas; print('OK')"

# Check data availability
ls -la data/processed/
ls -la output/fin-experiments/

# Verify output directories exist
import os
output_base = "output/fin-manuscript/draft_v1"
figure_dir = f"{output_base}/figures"
os.makedirs(figure_dir, exist_ok=True)
print(f"Figure output directory: {figure_dir}")

Step 1: Read Input Files

Read the figure plan and actual data:

import pandas as pd
from pathlib import Path

# Read FIGURE_PLAN.md
outline_path = Path("output/fin-manuscript/draft_v1/FIGURE_PLAN.md")
if outline_path.exists():
    figure_plan = outline_path.read_text(encoding="utf-8")
    print("Read FIGURE_PLAN.md")

# Read TABLE_PLAN.md for reference
table_plan_path = Path("output/fin-manuscript/draft_v1/TABLE_PLAN.md")
if table_plan_path.exists():
    table_plan = table_plan_path.read_text(encoding="utf-8")

# Read PAPER_OUTLINE.md to determine journal style
outline_path = Path("output/fin-manuscript/draft_v1/PAPER_OUTLINE.md")
if outline_path.exists():
    paper_outline = outline_path.read_text(encoding="utf-8")
    # Extract target journal
    # target_journal = extract_journal(paper_outline)

Step 2: Configure Chart Settings

Set up the ChartConfig based on the target journal:

from dataclasses import dataclass
from typing import List, Optional
from enum import Enum


class JournalStyle(Enum):
    CHINESE_TOP = "chinese_top"      # 经济研究/金融研究/管理世界
    AEA = "aea"                       # AER/JF/JFE/RFS
    CHICAGO = "chicago"               # JPE
    IEEE = "ieee"                     # 通用英文


@dataclass
class ChartConfig:
    """Configuration for academic figure generation."""
    # Canvas
    figsize: tuple = (8, 5.5)          # width, height in inches
    dpi: int = 300                     # dots per inch (publication standard)
    tight_layout: bool = True
    
    # Font (critical for Chinese journals)
    font_family: str = "Times New Roman"  # English journals
    font_size: int = 10
    title_fontsize: int = 12
    label_fontsize: int = 10
    legend_fontsize: int = 9
    tick_fontsize: int = 9
    
    # Colors
    color_palette: str = "colorblind"  # "Set2" for Chinese printing
    primary_color: str = "#2E86AB"      # Blue
    secondary_color: str = "#F6AE2D"   # Orange
    accent_color: str = "#E94F37"      # Red for policy year
    ci_color: str = "#2E86AB"          # Confidence interval fill
    
    # Output
    output_formats: List[str] = None   # ["pdf", "png", "svg"]
    style: str = "seaborn-v0_8-paper"
    
    # Grid
    grid_alpha: float = 0.3
    grid_linestyle: str = "--"
    
    # Line styles
    line_width: float = 1.5
    marker_size: float = 5
    ci_alpha: float = 0.2
    
    def __post_init__(self):
        if self.output_formats is None:
            self.output_formats = ["pdf", "png"]


# Chinese journal configuration (经济研究/金融研究/管理世界)
CHINESE_CONFIG = ChartConfig(
    figsize=(8, 5.5),
    dpi=300,
    font_family="SimHei",
    font_size=10,
    title_fontsize=12,
    label_fontsize=10,
    legend_fontsize=9,
    tick_fontsize=9,
    color_palette="Set2",      # Better for Chinese printing
    primary_color="#2E86AB",
    secondary_color="#F6AE2D",
    accent_color="#E94F37",
    ci_color="#2E86AB",
    output_formats=["pdf", "png"],
    style="seaborn-v0_8-paper",
    grid_alpha=0.3,
    grid_linestyle="--",
    line_width=1.5,
    marker_size=5,
    ci_alpha=0.2,
)

# English top journal configuration (JF/JFE/RFS/AER)
ENGLISH_CONFIG = ChartConfig(
    figsize=(7, 5),
    dpi=300,
    font_family="Times New Roman",
    font_size=10,
    title_fontsize=12,
    label_fontsize=10,
    legend_fontsize=9,
    tick_fontsize=9,
    color_palette="colorblind",
    primary_color="#4472C4",
    secondary_color="#ED7D31",
    accent_color="#C00000",
    ci_color="#4472C4",
    output_formats=["pdf", "png"],
    style="seaborn-v0_8-paper",
    grid_alpha=0.3,
    grid_linestyle="--",
    line_width=1.5,
    marker_size=5,
    ci_alpha=0.2,
)