Skip to content

journal-of-economic-surveys

JES Style Analysis Package for Mutual Fund Style Drift Survey Paper

View on GitHub Homepage

Information

Property Value
Language Python
Stars 0
Forks 0
Watchers 0
Open Issues 78
License No License
Created 2025-12-26
Last Updated 2026-02-19
Last Push 2026-01-20
Contributors 1
Default Branch main
Visibility private

Reproducibility

This repository includes reproducibility tools:

  • Python requirements.txt

Status

  • Issues: Enabled
  • Wiki: Enabled
  • Pages: Enabled

README

JES Verification Toolkit

Pre-submission quality assurance for Journal of Economic Surveys papers.

Features

  • 18 Automated Checks - Structure, citations, content quality, writing analytics
  • 3 API Integrations - CrossRef, Semantic Scholar, OpenAlex for DOI verification
  • Interactive Dashboard - Visual results with Chart.js
  • CI/CD Ready - GitHub Actions workflow included

Quick Start

# Run all checks on your manuscript
python scripts/verification/run_all_checks.py manuscript.tex

# With API-powered citation verification
python scripts/verification/run_all_checks.py manuscript.tex --api

# Generate JSON report
python scripts/verification/run_all_checks.py manuscript.tex --json -o results.json

# Create interactive dashboard
python scripts/dashboard/generate_dashboard.py results.json -o dashboard.html

JES Requirements

Requirement Target Check
Word count 10,000-15,000 check_word_count.py
Abstract Max 200 words check_abstract.py
Keywords Max 6 check_keywords.py
Passive voice <25% check_passive_voice.py
Hedging 15-40 per 1000 words check_hedging.py
Readability Grade 12-14 check_readability.py
Citations 100-200+ check_citations.py

Check Categories

Category Checks
Structure word_count, abstract, keywords, sections, tables
Citations citations, bibliography, citations_enriched (API)
Content accessibility, synthesis, transitions
Writing readability, passive_voice, hedging, jargon
Additional figures, data_availability, methodology

Literature Retrieval

Retrieve academic papers from OpenAlex for survey research:

# Retrieve mutual fund style drift literature (1995-2025)
python scripts/literature/retrieve_style_drift_papers.py --email you@example.com

# Custom year range
python scripts/literature/retrieve_style_drift_papers.py --email you@example.com --year-start 2000 --year-end 2025

# Resume from checkpoint
python scripts/literature/retrieve_style_drift_papers.py --email you@example.com --resume output/checkpoint.json

Output formats: - papers.json - Full metadata for all papers - papers.csv - Tabular summary for filtering/analysis - papers.bib - BibTeX file ready for LaTeX - statistics.json - Summary statistics

Project Structure

scripts/
  verification/     # 18 check scripts + runner + 50 tests
  api/              # CrossRef, Semantic Scholar, OpenAlex clients
  literature/       # Literature retrieval for survey research
  dashboard/        # HTML dashboard generator
  utils/            # Utility scripts (convert_md_to_html, etc.)
docs/               # Toolkit documentation site
guides/             # JES writing guides (.md + html/)
examples/           # Sample manuscripts + output/
archive/            # Legacy files (node_modules, old HTML)

Documentation

Open docs/index.html locally or see: - Checks Reference - All 18 checks documented - API Reference - API client usage - Demo Dashboard - Sample verification results

Installation

git clone https://github.com/Digital-AI-Finance/journal-of-economic-surveys.git
cd journal-of-economic-surveys

# Install dependencies (optional, for API checks)
pip install requests

# Run tests
python scripts/verification/test_checks.py

Style Guides

The guides/ folder contains writing resources:

File Description
JES_Style_Guide.md Comprehensive style conventions
JES_Checklist.md Pre-submission verification
JES_Template.md Section-by-section template
JES_Annotated_Examples.md Patterns from published papers
Style_Drift_Survey_Guide.md Topic-specific guidance

Journal Statistics

  • Impact Factor: 8.78 (2024)
  • Quartile: Q1
  • H-index: 121
  • Publisher: Wiley

License

Private repository - Digital-AI-Finance