UBI Trials Outcomes Catalog Lookup

Build a caller-supplied universal-basic-income trial outcomes catalog and report missing outcome coverage.

Description

A universal basic income (UBI) trial catalog needs both study design and reported outcomes.

A universal basic income (UBI) trial catalog needs both study design and reported outcomes. Record coverage is separate from evidence of policy impact.1

The returned values include Outcome coverage complete, Catalog entries, Trials with outcomes, Trials without outcomes. The How section below explains the calculation, input rules and interpretation.

When to use UBI Trials Outcomes Catalog Lookup

Use UBI Trials Outcomes Catalog Lookup when you need to evaluate the supplied records under the calculation and evidence rules below. No trial findings are fetched, verified or pooled into a treatment effect.

Define the question, evidence and scenario assumptions first. Supply the chosen score scales, time horizons or reference selection explicitly. Interpret generated text as a discussion template and screen labels as the stated rules.

How to use UBI Trials Outcomes Catalog Lookup and understand its results

  1. Define the question, evidence and scenario assumptions first. Supply the chosen score scales, time horizons or reference selection explicitly. Interpret generated text as a discussion template and screen labels as the stated rules.
  2. Enter reportedOutcomes, studyDesigns, trialNames using the field table and calculation rules, then run the tool.
  3. Read catalogComplete, catalogEntries, outcomeCoverageCount, trialsWithoutOutcomes. The explanation below defines the units, signs, ordering and any flags or placeholder values.
  4. If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
Input fieldMeaningValue type; see rules belowRequirement
reportedOutcomesOne outcome string per trial, using an empty string when unavailable.list of stringRequired
studyDesignsStudy designslist of stringRequired
trialNamesTrial nameslist of stringRequired

Require unique trimmed nonblank trial names, matching nonblank designs and matching outcome strings. Trim outcomes; blanks become not supplied in formatted entries. Return missing-outcome trial names, coverage count and complete flag.

coverage=trials−blankOutcomeRecords

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output fieldMeaningValue type
catalogCompleteOutcome coverage completeboolean
catalogEntriesCatalog entrieslist of string
outcomeCoverageCountTrials with outcomesinteger; minimum: 0
trialsWithoutOutcomesTrials without outcomeslist of string
json
{
  "input": {
    "reportedOutcomes": [
      "Wages and employment tracked",
      ""
    ],
    "studyDesigns": [
      "Pilot",
      "RCT"
    ],
    "trialNames": [
      "City A",
      "Region B"
    ]
  },
  "output": {
    "catalogComplete": false,
    "catalogEntries": [
      "City A | design=Pilot | outcome=Wages and employment tracked",
      "Region B | design=RCT | outcome=not supplied"
    ],
    "outcomeCoverageCount": 1,
    "trialsWithoutOutcomes": [
      "Region B"
    ]
  }
}

Limitations and assumptions

No trial findings are fetched, verified or pooled into a treatment effect.

Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Core numeric and string lists are limited to 100,000 entries; text entries are subject to the general large-text limit. Follow any smaller calculation limits above. Missing fields without a declared default, extra fields, wrong value types and violations of the calculation rules are input errors. A successfully returned false flag is an evaluated outcome; its meaning is explained above.

Alternative or Complementary methods

Use Four-Day Week Trial Productivity Comparison: A four-day-week comparison separates total output from output per hour. Both require comparable baseline and trial measures. For a complementary task, use Participatory Foresight Citizen Panel Design Checklist: A participatory foresight panel needs a purpose, representation criteria and accessibility measures. Counting declared dimensions is an initial design screen.

References

  1. UBI Trials Outcomes Catalog Lookup — tool.io

Similar or alternative tools

Don't forget to set a bookmark for tool.io!
Privacy | Imprint | Cookies