Skip to contents

Core IO

Read, validate and write theory objects.

tf_read()
Read a theory object from a YAML or JSON file
tf_validate()
Validate a theory object
tf_write()
Write a theory object to YAML or JSON

Builder (BUILDING mode)

Construct a theory incrementally with provenance tracking.

tf_theory()
Start a new, empty theory object (BUILDING mode entry point)
tf_add_construct()
Add a construct to a theory (BUILDING mode)
tf_add_proposition()
Add a proposition to a theory (BUILDING mode)
tf_add_prediction()
Add a prediction to a theory (BUILDING mode)
tf_add_alternative()
Add an alternative theory (BUILDING mode)
tf_add_assumption()
Add an auxiliary assumption (BUILDING mode)
tf_set_formal_model()
Set the formal model (BUILDING mode)

Rigour

Score a theory against the versioned rigour checklist.

tf_check()
Compute the rigour checklist report
tf_report()
Render the rigour report as a string
tf_severity()
Per-prediction risk and computed severity

Redundancy

Deterministic lexical redundancy screen.

tf_tokens()
Tokenise a string into a set of content tokens
tf_jaccard()
Jaccard similarity of two token sets
tf_redundancy_check()
Pairwise lexical similarity of construct definitions
tf_embedding_redundancy()
Embedding-based pairwise construct-redundancy screen

Diagram

Byte-identical diagram intermediate representations, and native rendering.

tf_diagram()
Render a diagram intermediate representation
tf_lit_diagram()
Render a literature-layer diagram intermediate representation
tf_render_diagram()
Render a diagram in the viewer or as SVG

Develop

Lakatosian amendment appraisal.

tf_appraise_amendment()
Appraise an amendment as progressive, degenerating, or neutral

Testing and review

Preregistration, SEM compilation and the audit dossier.

tf_preregister()
Render a preregistration document
tf_compile_sem()
Compile a theory to lavaan model syntax
tf_dossier()
Render a theory audit dossier (Markdown)

Simulation

Integrate the construct network as a dynamical system.

tf_simulate()
Simulate a theory's construct network as a linear dynamical system

Reporting and deposit

Render a report and deposit it.

tf_render_report()
Write a Quarto report for a theory
tf_osf_push()
Deposit a theory's audit dossier to OSF storage

Literature layer

Bibliometric mapping of a literature corpus.

tf_read_corpus()
Read a literature corpus from a YAML or JSON file
tf_litmap()
Bibliometric map of a literature corpus (deterministic)
tf_landscape()
Map a theory and its alternatives onto a literature landscape (deterministic)
tf_fetch_corpus()
Build a corpus from the OpenAlex API (network call)
tf_new_evidence_dois()
DOIs not already cited by a theory (deterministic)