export_robvis
Combine risk-of-bias assessment records from multiple runs into a robvis-ready CSV, converting V2 judgements to V1 layout for accurate Cochrane-style figures.
Instructions
Combine assessment RECORDS from any number of runs into a CSV for robvis (McGuinness & Higgins), the standard tool for Cochrane-style risk-of-bias figures.
A review of 200 studies is 200 separate runs — each assessment costs a
session, and nothing in this server survives between them. So pass
records: the record object each submit_answers(domain=0) returns. They
are small, flat and JSON-native, so a whole review's worth fits in one
context, and they carry their own provenance so every row stays traceable
to a document and an algorithm fingerprint. Omit records to use only what
was assessed in THIS session (convenient, but session-scoped).
READ THE RETURNED losses BEFORE PUBLISHING THE FIGURE. It reports records
that are not yet ratified, mixed C4 variants, equal weighting, and records
built under differing algorithm transcriptions — each of which would make
the figure claim more than the assessments support.
This is not a column dump, because robvis's ROBINS-I template is ROBINS-I V1 and V2 is not drop-in compatible:
V1 has SEVEN domains and orders selection of participants BEFORE classification of interventions. V2 has six and swaps that pair. Writing V2's columns out in order loses no data and raises no error — it just prints your classification judgement under the heading "Bias due to selection of participants". layout='robins_i' (the default) places each V2 judgement into its correct V1 SLOT and marks the dropped deviations domain NA. Upload it with tool='ROBINS-I'.
layout='generic' writes six columns headed with V2's own domain names, for tool='Generic'. The headings are then right, but robvis relabels the judgements into ROB1's vocabulary — Moderate becomes "Some concerns", Serious becomes "High". Prefer 'robins_i'.
Neither layout can carry 'Low, except for concerns about uncontrolled confounding': robvis reduces every cell to its first initial over a five-fill palette, so it collapses to Low whatever string is written. Say so in the figure caption.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labels | No | ||
| layout | No | robins_i | |
| records | No | ||
| weights | No | ||
| review_id | No | ||
| result_ids | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | No | ||
| rows | No | ||
| usage | No | ||
| header | No | ||
| layout | No | ||
| losses | No | ||
| summary | No | ||
| filename | No | ||
| n_results | No | ||
| review_id | No | ||
| robvis_tool | No | ||
| content_type | No | ||
| slot_mapping | No | ||
| content_base64 | No |