User Documentation Open App โ†—

Reading Your Results

A guide to interpreting every output type โ€” Batch Query table, Detailed Report, and Bioscientist Agent white paper.

Batch Query results

The results table

Each row in the Batch Query results table corresponds to one entity from your input list. The columns provide different angles on relevance and evidence quality:

Column What it means
Entity name The gene symbol, drug name, disease term, or other identifier from your submitted list.
Effect score A relevance score (0โ€“1 range) indicating the strength of published evidence linking this entity to your research question. Higher scores indicate stronger, more consistent evidence. Entities with no evidence score near 0.
Novelty score Indicates how underexplored the entity is relative to your question. A high novelty score combined with a high effect score marks a potentially important but understudied candidate โ€” worth investigating further.
Precision The fraction of retrieved papers that are genuinely relevant to your question for this entity. High precision means fewer false-positive citations.
Recall Estimates how much of the available relevant literature was captured. High recall means comprehensive coverage.
Answer / Evidence A brief AI-generated summary of the evidence found for this entity. Read this to understand why the entity received its score.
References (PMIDs) PubMed IDs of the papers cited as evidence. Click any PMID to open the abstract directly on PubMed. Always verify key claims against the primary literature.

The scatter plot

The scatter plot visualises your results in a two-dimensional space. Use the X axis and Y axis dropdowns to select any two numeric columns. Common useful combinations:

  • Effect score (X) ร— Novelty score (Y): top-right quadrant contains high-relevance, understudied candidates.
  • Precision (X) ร— Recall (Y): top-right quadrant contains entities with both comprehensive and accurate coverage.
  • Effect score (X) ร— Your own fold-change data (Y): if you uploaded a CSV and merged it, you can correlate AI relevance with your experimental data.

Click or lasso-select points on the scatter to filter the table to those entities. Click an empty area to reset the filter.

CSV export structure

The downloaded CSV contains all table columns plus a references column with PMIDs as a semicolon-separated list. If you merged your own data, those columns appear at the right-hand side. The file uses UTF-8 encoding and comma delimiters.


Detailed Report

Document structure

A Detailed Report is a formal scientific document. The PDF version is formatted with a title page, numbered sections, embedded figures, and a reference list. The DOCX version has the same content in an editable Word format.

Typical section order:

  1. Introduction / Background โ€” frames the research question, provides disease/pathway context, and defines the scope of the analysis.
  2. Regulatory and functional analysis โ€” the core narrative. For each gene or functional cluster, covers molecular function, canonical pathway membership, known protein interactions, and published regulatory relationships. Evidence is cited throughout.
  3. Disease associations โ€” published evidence linking each gene to the disease or condition you specified, including clinical data where available.
  4. Key uncertainties โ€” honest gaps in the literature and areas of conflicting evidence.
  5. Novel hypotheses โ€” mechanistically grounded, testable research directions generated by the AI.
  6. Conclusion โ€” a synthesis paragraph drawing together the main themes and implications.
  7. References โ€” numbered citations in the order of first appearance.

Figures in the report

Two types of figures appear in Detailed Reports:

  • Quantitative figures โ€” bar charts, scatter plots, heatmaps, or volcano plots generated from data retrieved during the analysis (e.g. expression databases, pathway enrichment). Each figure has a numbered caption explaining what is shown and what the key finding is.
  • Schematic diagrams โ€” conceptual diagrams illustrating pathway relationships, mechanistic models, or gene interaction networks. These are AI-generated illustrations, not reproductions of published figures.

All figures are numbered sequentially (Figure 1, Figure 2, โ€ฆ) and referenced by number in the running text. Read the figure legend carefully for axis definitions, data sources, and interpretation notes.


Bioscientist Agent white paper

Pipeline phases and what they produce

The agent runs a structured multi-phase pipeline. Understanding each phase helps you interpret what appears in the session log and why the archive contains each file.

Status / Phase What the pipeline is doing Key files produced
INITIALIZING Worker provisioned; research protocol loaded; session directory created. Session directory with timestamp
Phase 1: Decomposition The question is decomposed into structured sub-questions covering different facets (mechanistic, clinical, therapeutic, etc.). 00-decomposition.md
Phase 2: Literature retrieval Systematic PubMed and preprint searches for each sub-question. PRISMA-S 2021 protocol written. 01-retrieval-*.md, 10-prisma-search-protocol.md, 20-prisma-flow.md
Phase 3โ€“5: Synthesis & reasoning Evidence synthesised into sub-question answers. Full-text retrieved where needed. Data mining (pathway enrichment, expression databases) for quantitative figures. 50-answer-sq*.md, 50-citation-registry.json
Phase 6: Hypothesis generation Novel testable hypotheses generated via five reasoning modes and refined through an adversarial critique loop (โ‰ฅ3 rounds). 55-hypotheses.md
Phases 7โ€“9: Report planning & block writing Report outline generated competitively (3 candidate plans, 3-judge panel, โ‰ฅ3 review rounds). Each section written as a structured content block with embedded figures. 60-report-plan.md, 70-block-*.md, figures/*.png
Phases 10โ€“11: Synthesis & rendering Sections synthesised and revised. References resolved and compacted. Validation gate. PDF and DOCX rendered. 99-final-report.pdf, 99-final-report.docx, 99-references.ris
SUCCESS All files complete. Archive uploaded. Download available. Full archive (.tar.gz containing all above)

PRISMA search protocol

Every Bioscientist Agent white paper includes a PRISMA-S 2021 compliant search protocol (10-prisma-search-protocol.md in the archive). PRISMA-S is a reporting standard for literature searches in systematic reviews, requiring 16 structured items including the databases searched, search strategies used (verbatim queries), date ranges, and inclusion/exclusion criteria.

The PRISMA flow diagram (20-prisma-flow.md) shows the record counts at each stage: records identified โ†’ records screened โ†’ records included. This documentation makes Formaticon's search process transparent and reproducible โ€” suitable for inclusion in the methods section of a manuscript.

Hypotheses section

The hypotheses document (55-hypotheses.md in the archive, also included in the white paper's "Novel Hypotheses and Research Directions" section) contains AI-generated, mechanistically grounded research proposals.

Each hypothesis is:

  • Grounded in evidence โ€” derived from the retrieved literature, not invented without basis.
  • Testable โ€” phrased so that an experimental design could confirm or refute it.
  • Scored by priority โ€” each hypothesis carries a composite priority score on a 7โ€“21 scale: HIGH (17โ€“21), MEDIUM (12โ€“16), or LOW (7โ€“11). This score reflects novelty, mechanistic strength, and experimental feasibility.
  • Refined through adversarial review โ€” before finalisation, hypotheses go through at least three rounds of independent critique by a fresh adversarial reviewer. Only hypotheses that survive this review appear in the final document.

Citation format in the white paper

The white paper uses numbered citations in the format [1], [2], etc., appearing inline in the text at the point of claim. Each number maps to a full reference in the References section at the end of the document.

Internally, the pipeline uses content-bound citation handles (e.g. [[PMID:37938563]]) during writing, which are deterministically resolved to numbered citations before rendering. This prevents citation drift โ€” a common problem in AI-generated documents where a number is assigned at writing time and silently maps to the wrong paper later. Every citation in a Formaticon white paper traces reliably to the exact paper cited.

The session log

The session log (session-log-0.jsonl, downloadable separately from the task result page) is the raw pipeline execution transcript. It contains every step the agent took: tool calls, search queries issued, papers retrieved, text generated, and error messages. It is not intended for casual reading but is invaluable for:

  • Auditing which specific PubMed queries were run and how many papers were retrieved
  • Identifying the root cause of a FAILED run
  • Verifying that a specific paper was considered during the synthesis
  • Academic transparency: documenting AI methods for a publication

Quality signals โ€” what a good run looks like

A high-quality Bioscientist Agent run will have:

  • Zero open claims โ€” every factual claim in the report is traceable to a cited source. The pipeline runs a claim audit before rendering and will not produce a final report with unverified claims.
  • All figures present โ€” at least one quantitative figure and at least one schematic diagram per major section. A report with zero figures is a pipeline failure.
  • PRISMA files complete โ€” 10-prisma-search-protocol.md, 20-prisma-flow.md, and 21-prisma-flow-summary.md all present in the archive.
  • Validated report โ€” the pipeline runs a programmatic validation gate before rendering. If validation fails, the render is blocked and the run may be marked FAILED.

If your run completed successfully, all of these conditions were met. If you notice a gap in the white paper (a section with no figures, or a claim without a citation), it is worth checking the session log for any logged warnings.