RubyGems - conceptql - Versions diffs - 0.6.0 → 0.7.0 - Mend

conceptql 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (126) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +176 -0
data/README.md +4 -2
data/assets/diagram/diagram.css +331 -0
data/assets/diagram/fonts/OFL.txt +93 -0
data/assets/diagram/fonts/Roboto-400.ttf +0 -0
data/assets/diagram/fonts/Roboto-700.ttf +0 -0
data/assets/diagram/fonts/Roboto-Italic-400.ttf +0 -0
data/assets/diagram/fonts/Roboto-Italic-Latin.woff2 +0 -0
data/assets/diagram/fonts/Roboto-Normal-Latin.woff2 +0 -0
data/assets/diagram/operators.svg +224 -0
data/config/vocabularies.csv +85 -85
data/docs/spec/README.md +2624 -0
data/docs/spec/examples/after-operator.json +562 -0
data/docs/spec/examples/any-overlap-operator.json +106 -0
data/docs/spec/examples/before-operator.json +437 -0
data/docs/spec/examples/co-reported-operator.json +168 -0
data/docs/spec/examples/contains-operator.json +97 -0
data/docs/spec/examples/date-range-operator.json +275 -0
data/docs/spec/examples/death-operator.json +103 -0
data/docs/spec/examples/during-operator.json +178 -0
data/docs/spec/examples/episode-operator.json +80 -0
data/docs/spec/examples/equal-operator.json +79 -0
data/docs/spec/examples/ethnicity-operator.json +86 -0
data/docs/spec/examples/except-operator.json +536 -0
data/docs/spec/examples/filter-operator.json +218 -0
data/docs/spec/examples/first-operator.json +148 -0
data/docs/spec/examples/gender-operator.json +257 -0
data/docs/spec/examples/hospice-operator.json +40 -0
data/docs/spec/examples/hospitalization-operator.json +131 -0
data/docs/spec/examples/information-periods-operator.json +131 -0
data/docs/spec/examples/last-operator.json +148 -0
data/docs/spec/examples/match-operator.json +186 -0
data/docs/spec/examples/nth-occurrence-operator.json +300 -0
data/docs/spec/examples/numeric-filter-operator.json +77 -0
data/docs/spec/examples/one-in-two-out-operator.json +158 -0
data/docs/spec/examples/person-filter-operator.json +919 -0
data/docs/spec/examples/person-operator.json +274 -0
data/docs/spec/examples/place-of-service-filter-operator.json +57 -0
data/docs/spec/examples/provenance-operator.json +148 -0
data/docs/spec/examples/provider-filter-operator.json +77 -0
data/docs/spec/examples/race-operator.json +131 -0
data/docs/spec/examples/recall-operator.json +289 -0
data/docs/spec/examples/snf-operator.json +40 -0
data/docs/spec/examples/time-window-operator.json +736 -0
data/docs/spec/examples/trim-date-end-operator.json +201 -0
data/docs/spec/examples/trim-date-start-operator.json +201 -0
data/docs/spec/examples/union-operator.json +547 -0
data/docs/spec/examples/vocabulary-operator.json +232 -0
data/lib/conceptql/behaviors/metadatable.rb +68 -2
data/lib/conceptql/behaviors/provenanceable.rb +4 -1
data/lib/conceptql/behaviors/utilizable.rb +3 -0
data/lib/conceptql/code_case_mismatch_error.rb +50 -0
data/lib/conceptql/data_model/gdm.rb +23 -2
data/lib/conceptql/diagram_renderer/app.rb +59 -0
data/lib/conceptql/diagram_renderer/configuration.rb +87 -0
data/lib/conceptql/diagram_renderer/diagram_data.rb +80 -0
data/lib/conceptql/diagram_renderer/drawing.rb +255 -0
data/lib/conceptql/diagram_renderer/geometry.rb +380 -0
data/lib/conceptql/diagram_renderer/input_error.rb +11 -0
data/lib/conceptql/diagram_renderer/js_format.rb +112 -0
data/lib/conceptql/diagram_renderer/resvg.rb +120 -0
data/lib/conceptql/diagram_renderer/sprite.rb +73 -0
data/lib/conceptql/diagram_renderer/static.rb +70 -0
data/lib/conceptql/diagram_renderer/svg.rb +73 -0
data/lib/conceptql/diagram_renderer/tree_layout.rb +287 -0
data/lib/conceptql/diagram_renderer.rb +82 -0
data/lib/conceptql/lexicon/lexicon_strategy.rb +16 -0
data/lib/conceptql/lexicon.rb +63 -11
data/lib/conceptql/nodifier.rb +5 -3
data/lib/conceptql/operators/after.rb +15 -1
data/lib/conceptql/operators/any_overlap.rb +6 -1
data/lib/conceptql/operators/before.rb +11 -1
data/lib/conceptql/operators/binary_operator_operator.rb +12 -2
data/lib/conceptql/operators/co_reported.rb +9 -4
data/lib/conceptql/operators/contains.rb +6 -1
data/lib/conceptql/operators/count.rb +2 -0
data/lib/conceptql/operators/date_range.rb +15 -3
data/lib/conceptql/operators/death.rb +5 -1
data/lib/conceptql/operators/dedup.rb +2 -0
data/lib/conceptql/operators/during.rb +6 -1
data/lib/conceptql/operators/episode.rb +13 -2
data/lib/conceptql/operators/equal.rb +11 -1
data/lib/conceptql/operators/ethnicity.rb +19 -7
data/lib/conceptql/operators/except.rb +10 -1
data/lib/conceptql/operators/filter.rb +6 -1
data/lib/conceptql/operators/first.rb +19 -9
data/lib/conceptql/operators/from.rb +3 -0
data/lib/conceptql/operators/gender.rb +10 -2
data/lib/conceptql/operators/hospice.rb +7 -1
data/lib/conceptql/operators/hospitalization.rb +6 -1
data/lib/conceptql/operators/information_periods.rb +26 -7
data/lib/conceptql/operators/invalid.rb +4 -0
data/lib/conceptql/operators/last.rb +19 -9
data/lib/conceptql/operators/match.rb +6 -1
data/lib/conceptql/operators/multiple_vocabularies.rb +17 -3
data/lib/conceptql/operators/numeric.rb +4 -0
data/lib/conceptql/operators/numeric_filter.rb +13 -3
data/lib/conceptql/operators/occurrence.rb +33 -12
data/lib/conceptql/operators/one_in_two_out.rb +22 -5
data/lib/conceptql/operators/operator.rb +8 -4
data/lib/conceptql/operators/person.rb +5 -1
data/lib/conceptql/operators/person_filter.rb +14 -1
data/lib/conceptql/operators/place_of_service_filter.rb +14 -3
data/lib/conceptql/operators/provenance.rb +17 -8
data/lib/conceptql/operators/provider_filter.rb +18 -6
data/lib/conceptql/operators/race.rb +14 -9
data/lib/conceptql/operators/read.rb +11 -1
data/lib/conceptql/operators/recall.rb +34 -2
data/lib/conceptql/operators/snf.rb +7 -1
data/lib/conceptql/operators/sum.rb +4 -0
data/lib/conceptql/operators/temporal_operator.rb +4 -2
data/lib/conceptql/operators/time_window.rb +27 -4
data/lib/conceptql/operators/trim_date.rb +6 -14
data/lib/conceptql/operators/trim_date_end.rb +9 -3
data/lib/conceptql/operators/trim_date_start.rb +9 -3
data/lib/conceptql/operators/union.rb +13 -1
data/lib/conceptql/operators/vocabulary.rb +80 -6
data/lib/conceptql/paths.rb +9 -1
data/lib/conceptql/version.rb +1 -1
data/lib/conceptql/vocabularies/drg_systems.rb +3 -2
data/lib/conceptql/vocabularies/entry.rb +14 -11
data/lib/conceptql/vocabularies/vocabulary_class_factory.rb +2 -1
data/lib/conceptql.rb +3 -0
metadata +75 -2
data/doc/spec.md +0 -2091

data/docs/spec/examples/equal-operator.json ADDED Viewed

@@ -0,0 +1,79 @@
+{
+  "spec_id": "equal-operator",
+  "examples": [
+    {
+      "title": "HbA1c results (LOINC 4548-4) with the same value as an HbA1c result by HPLC (LOINC 17856-6) of the same patient",
+      "statement": [
+        "equal",
+        {
+          "left": ["loinc", "4548-4"],
+          "right": ["loinc", "17856-6"]
+        }
+      ],
+      "help": false,
+      "columns": [
+        "person_id",
+        "criterion_id",
+        "criterion_table",
+        "criterion_domain",
+        "start_date",
+        "end_date",
+        "source_value"
+      ],
+      "rows": [],
+      "tree": {
+        "format": "conceptql-diagram/v1",
+        "statements": [
+          {
+            "name": "equal",
+            "base": "filter",
+            "humanName": "Equal",
+            "outputTypes": ["observation"],
+            "parameters": {},
+            "values": [],
+            "children": [
+              {
+                "name": "loinc",
+                "base": "selection",
+                "humanName": "Logical Observation Identifiers Names and Codes (Regenstrief Institute)",
+                "vocabularyId": "LOINC",
+                "outputTypes": ["observation"],
+                "parameters": {},
+                "values": ["4548-4"],
+                "children": [],
+                "counts": {
+                  "observation": {
+                    "rows": 1,
+                    "n": 1
+                  }
+                }
+              },
+              {
+                "name": "loinc",
+                "base": "selection",
+                "humanName": "Logical Observation Identifiers Names and Codes (Regenstrief Institute)",
+                "vocabularyId": "LOINC",
+                "outputTypes": ["observation"],
+                "parameters": {},
+                "values": ["17856-6"],
+                "children": [],
+                "counts": {
+                  "observation": {
+                    "rows": 0,
+                    "n": 0
+                  }
+                }
+              }
+            ],
+            "counts": {
+              "observation": {
+                "rows": 0,
+                "n": 0
+              }
+            }
+          }
+        ]
+      }
+    }
+  ]
+}

data/docs/spec/examples/ethnicity-operator.json ADDED Viewed

@@ -0,0 +1,86 @@
+{
+  "spec_id": "ethnicity-operator",
+  "examples": [
+    {
+      "title": "All patients recorded as Hispanic",
+      "statement": ["ethnicity", "Hispanic"],
+      "help": true,
+      "columns": [
+        "person_id",
+        "criterion_id",
+        "criterion_table",
+        "criterion_domain",
+        "start_date",
+        "end_date",
+        "source_value"
+      ],
+      "rows": [
+        [
+          4,
+          4,
+          "patients",
+          "person",
+          "1941-06-01",
+          "1941-06-01",
+          "00021CA6FF03E670"
+        ],
+        [
+          22,
+          22,
+          "patients",
+          "person",
+          "1942-08-01",
+          "1942-08-01",
+          "000D6D88463D8A76"
+        ],
+        [
+          72,
+          72,
+          "patients",
+          "person",
+          "1933-04-01",
+          "1933-04-01",
+          "002354398A00234E"
+        ],
+        [
+          76,
+          76,
+          "patients",
+          "person",
+          "1938-03-01",
+          "1938-03-01",
+          "00242FF5E7A3F2D9"
+        ],
+        [
+          181,
+          181,
+          "patients",
+          "person",
+          "1939-11-01",
+          "1939-11-01",
+          "005E0AB5172E715F"
+        ]
+      ],
+      "tree": {
+        "format": "conceptql-diagram/v1",
+        "statements": [
+          {
+            "name": "ethnicity",
+            "base": "selection",
+            "humanName": "Ethnicity",
+            "outputTypes": ["person"],
+            "parameters": {},
+            "values": ["Hispanic"],
+            "children": [],
+            "counts": {
+              "person": {
+                "rows": 5,
+                "n": 5
+              }
+            }
+          }
+        ]
+      }
+    }
+  ]
+}

data/docs/spec/examples/except-operator.json ADDED Viewed

@@ -0,0 +1,536 @@
+{
+  "spec_id": "except-operator",
+  "examples": [
+    {
+      "title": "All males who are not white",
+      "statement": [
+        "except",
+        {
+          "left": ["gender", "male"],
+          "right": ["race", "white"]
+        }
+      ],
+      "help": true,
+      "columns": [
+        "person_id",
+        "criterion_id",
+        "criterion_table",
+        "criterion_domain",
+        "start_date",
+        "end_date",
+        "source_value"
+      ],
+      "rows": [
+        [
+          4,
+          4,
+          "patients",
+          "person",
+          "1941-06-01",
+          "1941-06-01",
+          "00021CA6FF03E670"
+        ],
+        [
+          6,
+          6,
+          "patients",
+          "person",
+          "1943-10-01",
+          "1943-10-01",
+          "0002DAE1C81CC70D"
+        ],
+        [
+          21,
+          21,
+          "patients",
+          "person",
+          "1932-08-01",
+          "1932-08-01",
+          "000C7486B11E7030"
+        ],
+        [
+          22,
+          22,
+          "patients",
+          "person",
+          "1942-08-01",
+          "1942-08-01",
+          "000D6D88463D8A76"
+        ],
+        [
+          50,
+          50,
+          "patients",
+          "person",
+          "1941-08-01",
+          "1941-08-01",
+          "001AEDD510C92C87"
+        ],
+        [
+          68,
+          68,
+          "patients",
+          "person",
+          "1954-11-01",
+          "1954-11-01",
+          "0021D4CDAFC0609F"
+        ],
+        [
+          69,
+          69,
+          "patients",
+          "person",
+          "1925-05-01",
+          "1925-05-01",
+          "00225409819CF5F6"
+        ],
+        [
+          71,
+          71,
+          "patients",
+          "person",
+          "1931-01-01",
+          "1931-01-01",
+          "0022CC1943D038E2"
+        ],
+        [
+          72,
+          72,
+          "patients",
+          "person",
+          "1933-04-01",
+          "1933-04-01",
+          "002354398A00234E"
+        ],
+        [
+          75,
+          75,
+          "patients",
+          "person",
+          "1932-08-01",
+          "1932-08-01",
+          "00241223F034F97B"
+        ]
+      ],
+      "tree": {
+        "format": "conceptql-diagram/v1",
+        "statements": [
+          {
+            "name": "except",
+            "base": "filter",
+            "humanName": "Except",
+            "outputTypes": ["person"],
+            "parameters": {},
+            "values": [],
+            "children": [
+              {
+                "name": "gender",
+                "base": "selection",
+                "humanName": "Gender",
+                "outputTypes": ["person"],
+                "parameters": {},
+                "values": ["male"],
+                "children": [],
+                "counts": {
+                  "person": {
+                    "rows": 124,
+                    "n": 124
+                  }
+                }
+              },
+              {
+                "name": "race",
+                "base": "selection",
+                "humanName": "Race",
+                "outputTypes": ["person"],
+                "parameters": {},
+                "values": ["white"],
+                "children": [],
+                "counts": {
+                  "person": {
+                    "rows": 204,
+                    "n": 204
+                  }
+                }
+              }
+            ],
+            "counts": {
+              "person": {
+                "rows": 27,
+                "n": 27
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "title": "All Conditions that are MI",
+      "statement": [
+        "except",
+        {
+          "left": ["icd9", "412"],
+          "right": ["cpt", "99214"]
+        }
+      ],
+      "help": true,
+      "columns": [
+        "person_id",
+        "criterion_id",
+        "criterion_table",
+        "criterion_domain",
+        "start_date",
+        "end_date",
+        "source_value"
+      ],
+      "rows": [
+        [
+          11,
+          82614,
+          "observations",
+          "condition_occurrence",
+          "2008-10-29",
+          "2008-10-29",
+          "412"
+        ],
+        [
+          17,
+          27269,
+          "observations",
+          "condition_occurrence",
+          "2008-08-25",
+          "2008-08-25",
+          "412"
+        ],
+        [
+          17,
+          46165,
+          "observations",
+          "condition_occurrence",
+          "2009-04-30",
+          "2009-04-30",
+          "412"
+        ],
+        [
+          38,
+          40556,
+          "observations",
+          "condition_occurrence",
+          "2010-02-12",
+          "2010-02-12",
+          "412"
+        ],
+        [
+          54,
+          74606,
+          "observations",
+          "condition_occurrence",
+          "2008-06-05",
+          "2008-06-05",
+          "412"
+        ],
+        [
+          60,
+          986,
+          "observations",
+          "condition_occurrence",
+          "2009-07-19",
+          "2009-07-22",
+          "412"
+        ],
+        [
+          66,
+          16171,
+          "observations",
+          "condition_occurrence",
+          "2009-07-25",
+          "2009-07-25",
+          "412"
+        ],
+        [
+          73,
+          52843,
+          "observations",
+          "condition_occurrence",
+          "2008-11-16",
+          "2008-11-16",
+          "412"
+        ],
+        [
+          77,
+          58165,
+          "observations",
+          "condition_occurrence",
+          "2010-10-06",
+          "2010-10-06",
+          "412"
+        ],
+        [
+          81,
+          1405,
+          "observations",
+          "condition_occurrence",
+          "2009-01-28",
+          "2009-01-30",
+          "412"
+        ]
+      ],
+      "tree": {
+        "format": "conceptql-diagram/v1",
+        "statements": [
+          {
+            "name": "except",
+            "base": "filter",
+            "humanName": "Except",
+            "outputTypes": ["condition_occurrence"],
+            "parameters": {},
+            "values": [],
+            "children": [
+              {
+                "name": "icd9",
+                "base": "selection",
+                "humanName": "ICD-9 CM",
+                "vocabularyId": "ICD9CM",
+                "outputTypes": ["condition_occurrence"],
+                "parameters": {},
+                "values": ["412"],
+                "children": [],
+                "counts": {
+                  "condition_occurrence": {
+                    "rows": 48,
+                    "n": 37
+                  }
+                }
+              },
+              {
+                "name": "cpt",
+                "base": "selection",
+                "humanName": "CPT",
+                "vocabularyId": "CPT4",
+                "outputTypes": ["procedure_occurrence"],
+                "parameters": {},
+                "values": ["99214"],
+                "children": [],
+                "counts": {
+                  "procedure_occurrence": {
+                    "rows": 1073,
+                    "n": 175
+                  }
+                }
+              }
+            ],
+            "counts": {
+              "condition_occurrence": {
+                "rows": 48,
+                "n": 37
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "title": "Passes two types downstream: Conditions that are MI (unaffected by the right-hand stream) and People that are Male but not White",
+      "statement": [
+        "except",
+        {
+          "left": ["union", ["icd9", "412"], ["gender", "Male"]],
+          "right": ["race", "White"]
+        }
+      ],
+      "help": true,
+      "columns": [
+        "person_id",
+        "criterion_id",
+        "criterion_table",
+        "criterion_domain",
+        "start_date",
+        "end_date",
+        "source_value"
+      ],
+      "rows": [
+        [
+          4,
+          4,
+          "patients",
+          "person",
+          "1941-06-01",
+          "1941-06-01",
+          "00021CA6FF03E670"
+        ],
+        [
+          6,
+          6,
+          "patients",
+          "person",
+          "1943-10-01",
+          "1943-10-01",
+          "0002DAE1C81CC70D"
+        ],
+        [
+          11,
+          82614,
+          "observations",
+          "condition_occurrence",
+          "2008-10-29",
+          "2008-10-29",
+          "412"
+        ],
+        [
+          17,
+          27269,
+          "observations",
+          "condition_occurrence",
+          "2008-08-25",
+          "2008-08-25",
+          "412"
+        ],
+        [
+          17,
+          46165,
+          "observations",
+          "condition_occurrence",
+          "2009-04-30",
+          "2009-04-30",
+          "412"
+        ],
+        [
+          21,
+          21,
+          "patients",
+          "person",
+          "1932-08-01",
+          "1932-08-01",
+          "000C7486B11E7030"
+        ],
+        [
+          22,
+          22,
+          "patients",
+          "person",
+          "1942-08-01",
+          "1942-08-01",
+          "000D6D88463D8A76"
+        ],
+        [
+          38,
+          40556,
+          "observations",
+          "condition_occurrence",
+          "2010-02-12",
+          "2010-02-12",
+          "412"
+        ],
+        [
+          50,
+          50,
+          "patients",
+          "person",
+          "1941-08-01",
+          "1941-08-01",
+          "001AEDD510C92C87"
+        ],
+        [
+          54,
+          74606,
+          "observations",
+          "condition_occurrence",
+          "2008-06-05",
+          "2008-06-05",
+          "412"
+        ]
+      ],
+      "tree": {
+        "format": "conceptql-diagram/v1",
+        "statements": [
+          {
+            "name": "except",
+            "base": "filter",
+            "humanName": "Except",
+            "outputTypes": ["condition_occurrence", "person"],
+            "parameters": {},
+            "values": [],
+            "children": [
+              {
+                "name": "union",
+                "base": "set",
+                "humanName": "Union",
+                "outputTypes": ["condition_occurrence", "person"],
+                "parameters": {},
+                "values": [],
+                "children": [
+                  {
+                    "name": "icd9",
+                    "base": "selection",
+                    "humanName": "ICD-9 CM",
+                    "vocabularyId": "ICD9CM",
+                    "outputTypes": ["condition_occurrence"],
+                    "parameters": {},
+                    "values": ["412"],
+                    "children": [],
+                    "counts": {
+                      "condition_occurrence": {
+                        "rows": 48,
+                        "n": 37
+                      }
+                    }
+                  },
+                  {
+                    "name": "gender",
+                    "base": "selection",
+                    "humanName": "Gender",
+                    "outputTypes": ["person"],
+                    "parameters": {},
+                    "values": ["Male"],
+                    "children": [],
+                    "counts": {
+                      "person": {
+                        "rows": 124,
+                        "n": 124
+                      }
+                    }
+                  }
+                ],
+                "counts": {
+                  "condition_occurrence": {
+                    "rows": 48,
+                    "n": 37
+                  },
+                  "person": {
+                    "rows": 124,
+                    "n": 124
+                  }
+                }
+              },
+              {
+                "name": "race",
+                "base": "selection",
+                "humanName": "Race",
+                "outputTypes": ["person"],
+                "parameters": {},
+                "values": ["White"],
+                "children": [],
+                "counts": {
+                  "person": {
+                    "rows": 204,
+                    "n": 204
+                  }
+                }
+              }
+            ],
+            "counts": {
+              "condition_occurrence": {
+                "rows": 48,
+                "n": 37
+              },
+              "person": {
+                "rows": 27,
+                "n": 27
+              }
+            }
+          }
+        ]
+      }
+    }
+  ]
+}