jbf-replication-and-data-policy

Replication & Data Policy (jbf-replication-and-data-policy)

When to trigger

• The paper uses CRSP, Compustat, BankFocus, Dealscan, TRACE, Call Reports, hand-collected data, or simulations
• You need a data availability statement for Elsevier/JBF submission
• You want a legal and useful replication package despite proprietary data

Policy stance

JBF follows Elsevier Option C research-data instructions. At submission, authors

must state data availability. For shareable data, deposit the research data in a

relevant repository and cite/link it in the article. If data cannot be shared,

state why (for example, proprietary, sensitive, confidential, or licensing limits).

JBF does not operate a dedicated journal-run replication archive, so the practical

package should combine a repository deposit where rights allow, code, metadata,

and a precise access route for restricted inputs.

Package structure

README.md
data_access/          # licensed-data instructions, not raw proprietary files
code/
  00_setup.*
  01_build_sample.*
  02_main_tables.*
  03_figures.*
  04_robustness.*
output/
  tables/
  figures/
requirements.*        # renv.lock / requirements.txt / Stata package list

Data availability statements

• Public data: name source, URL, access date, and archive copy if permitted.
• Proprietary data: identify vendor, product, access terms, and exact query or

extraction instructions; do not redistribute restricted files.

• Hand-collected data: share the dataset if rights allow, with coding rules.
• No external data / simulation: state that no external data were used and

provide simulation code and seeds.

Code expectations

• One master script regenerates all tables and figures.
• Random seeds and software versions are recorded.
• Output files match manuscript numbering.
• Confidential paths and author identity are removed before double-anonymized submission.

Proprietary-data audit

For licensed banking/finance sources, add a data_access/README.md that records:

• vendor/product, query filters, identifiers, and date accessed;
• variables needed to recreate the analysis;
• any hand-cleaning or link-table rules;
• whether a pseudo dataset can exercise the full code path;
• who can legally access the raw data and under what license.

Source-by-source sharing matrix

| Typical JBF source | Redistribution | What the package carries instead |

| --- | --- | --- |

| US Call Reports / FDIC SDI | public — share extracts | pull scripts with vintage, date, and series mnemonics |

| Orbis Bank Focus / BankScope legacy | licensed — do not share | query filters, consolidation codes, variable list, access date |

| DealScan | licensed — do not share | extraction steps, facility/package level, link-table code |

| CRSP / Compustat (when used) | licensed — do not share | WRDS query description and merge keys |

| Hand-collected regulatory events | usually shareable | coding manual, per-event sources, inter-coder checks |

| Confidential supervisory data | cannot leave the authority | aggregate descriptives plus the access route for replicators |

Worked statement draft (illustrative)

Data availability. Bank balance-sheet data come from US Call Reports (FFIEC,
public; pull scripts and vintages in /code/01). Loan-facility data are from
DealScan under license; we provide extraction filters and borrower link-table
code but not raw files. Hand-collected deregulation dates and coding rules are
deposited with the package. All tables and figures regenerate from run_all
with the licensed inputs in place; a synthetic sample exercises the full
pipeline without them.

Pre-submission package audit

• [ ] run_all executes on a clean machine with only the licensed inputs mounted
• [ ] every manuscript exhibit maps to exactly one output file, with matching numbering
• [ ] the synthetic or masked sample passes every script end to end
• [ ] vendor vintages and download dates recorded for Bank Focus, DealScan, and any WRDS pulls
• [ ] no author-identifying paths or initials in code comments (double-anonymized review)
• [ ] repository deposit linked and cited where rights allow, or non-sharing reason stated clearly

A package failing two or more boxes usually signals deeper pipeline debt; route back to jbf-data-analysis before drafting the statement.

Editor pushbacks on data

• "The package cannot run without DealScan." → ship a synthetic or masked sample that exercises every script end to end.
• "Which Bank Focus vintage?" → record vendor vintage and download date; bank coverage shifts across vintages.
• "Confidential supervisory data make this unreviewable." → document the authority's access procedure and provide all code plus aggregate moments; the data statement must explain the access limits.

Output format

[Data status] public / proprietary / confidential / simulated / mixed
[Statement draft] ...
[Shareable files] ...
[Restricted files] ...
[Reproducibility gaps] ...
[Next step] jbf-submission