Skip to main content
An agent that compares 40 trials reads their abstracts, because abstracts are short. The abstract says that the treatment “significantly reduced events”. The numbers that a meta-analysis needs, the events and the size of each group, are in Table 2 on page 6. This page builds a run that takes each value from the table it is printed in, and the formula from the method.

The run in 5 steps

Find the paper by its DOI

A title finds several versions of a paper and the articles that cite it. A DOI finds the paper. This search has no words at all, and fetches the paper in the same call.
Request body of search
Replace PAPER_DOI with the DOI of the paper. With max_characters set to 0, the paper comes back as its outline: one row for each section, with its size. Your agent sees “Methods” and “Results” with their sizes before it reads a word. A DOI can resolve to a page that has only the abstract. The full text is then a file that the page links to. List the links of the record that have the kind file, and fetch the PDF.

Check which version you have

A result can have declared, which is what the datasource states about the item. This part of the result is cut to 4 of its fields.
Part of the result
A preprint and the published article can differ in their numbers. version_label says which of them this is, in the datasource’s own words. status says what the datasource states about the item’s standing, for example that it was retracted, where the datasource states that.

Take the results from the table

Ask the record for its tables. This response is cut to the table of one block.
Part of the response
The table has 2 merged headings, and the text of each is in both slots it covers. So the number 31 is read with its 3 headings: primary endpoint, treatment, events. As plain text the same row is “31 263 58 266”, and nothing says which number is which.

Take the formula from the method

Ask for the blocks of the kinds math and code. A formula comes as TeX, and a code listing comes with its language.
Part of the response
Your agent now has the formula and its 4 inputs, and can compute the relative risk itself: 31 of 263 against 58 of 266 is 0.54. If the paper prints another value, that is a finding. The arithmetic of a paper is not checked for you, and the cells are there so that your code can check it.

Cite each value by its cell

Each row of your comparison then names where its values come from.
What your agent stores for one value
CONTENTS_ID and BLOCK_ID are the ids of the record and of the table’s block, as the responses return them.

What the statistician can check

Know the limits

A table comes cell by cell where the file says what its rows and columns are. The tables of a scan and of a PDF without structure come as text, and basis on a table says which it is. A formula is a math block where the file has the structure of the formula. A formula that is only a picture comes as flat text or not at all. Text inside a figure is not read on a paper that has text of its own. A paper behind a paywall is not fetched. The result says that the page asks for payment or a sign-in, and a person with access can upload the PDF. For the calls, see Get every table, cell by cell and Find the exact paper, case, or company by its identifier.