schema/power_array.json at main · scienceverse/schema · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://scienceverse.org/schema/power_array.json",
  "title": "Power Analyses",
  "description": "A collection of power analyses reported in a document.",
  "type": "object",
  "properties": {
    "power_analyses": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "description": "The specific text that contains all of the information used to determine this object's properties.",
            "type": ["string", "null"]
          },
          "power_type": {
            "description": "The type of power analysis. An 'apriori' power analysis is used to calculate the required sample size to achieve a desired level of statistical power given an effect size, statistical test, and alpha level. A 'sensitivity' analysis is used to estimate, given a sample size, which effect sizes a design has sufficient power (e.g., 80% or 90%) to detect, given a statistical test and alpha level. A 'posthoc' power analysis (also referred to as observed power, or retrospective power) uses an empirically observed effect size, and computes the achieved power for that empirically observed effect size, given a statistical test and alpha level.",
            "type": ["string", "null"],
            "enum": ["apriori", "sensitivity", "posthoc", null]
          },

          "statistical_test": {
            "description": "The statistical test used. Use null if unclear.",
            "type": ["string", "null"],
            "enum": [
              "paired t-test",
              "unpaired t-test",
              "one-sample t-test",
              "1-way ANOVA",
              "2-way ANOVA",
              "3-way ANOVA",
              "MANOVA",
              "regression",
              "chi-square",
              "correlation",
              "other",
              null
            ]
          },

          "statistical_test_other": {
            "description": "Free-text description if statistical_test is 'other', otherwise null.",
            "type": ["string", "null"]
          },

          "sample_size": {
            "description": "The sample size determined by or used in the power analysis. Give the total number if this is expressed as number per group.",
            "type": ["number", "null"],
            "minimum": 0
          },

          "alpha_level": {
            "description": "The alpha threshold used to determine significance.",
            "type": ["number", "null"],
            "exclusiveMinimum": 0,
            "maximum": 1
          },

          "power": {
            "description" : "The statistical power, expressed as a number between 0 and 1.",
            "type": ["number", "null"],
            "minimum": 0,
            "maximum": 1
          },

          "effect_size": {
            "description": "The numeric effect size used in or determined from the power analysis.",
            "type": ["number", "null"]
          },

          "effect_size_metric": {
            "description": "The effect size metric. Use 'unstandardised' for raw/non-standardized effects.",
            "type": ["string", "null"],
            "enum": [
              "Cohen's d",
              "Hedges' g",
              "Cohen's f",
              "partial eta squared",
              "eta squared",
              "unstandardised",
              "other",
              null
            ]
          },

          "effect_size_metric_other": {
            "description": "Free-text description if effect_size_metric is 'other', otherwise null.",
            "type": ["string", "null"]
          },

          "software": {
            "description": "The software used to conduct the power analysis.",
            "type": ["string", "null"],
            "enum": [
              "G*Power",
              "Superpower",
              "Pangea",
              "Morepower",
              "PASS",
              "pwr",
              "simr",
              "PowerUpR",
              "simulation",
              "InteractionPoweR",
              "pwrss",
              "other",
              null
            ]
          }
        },

        "required": [
          "text",
          "power_type",
          "statistical_test",
          "statistical_test_other",
          "sample_size",
          "alpha_level",
          "power",
          "effect_size",
          "effect_size_metric",
          "effect_size_metric_other",
          "software"
        ],

        "additionalProperties": false
      }
    }
  },

  "required": ["power_analyses"],
  "additionalProperties": false
}