There appears to have been a major change in the CPT hierarchy starting with the January 2023 release.
As an example, this CPT classification code subsumes the 4 Office or Outpatient visits (99202 - 99205). As expected, in the v5.0 22-JUN-22 and v5.0 31-OCT-22 Athena vocabulary releases, the ancestor_concept_id (45889484) in concept_ancestor has the expected 4 values for descendant_concept_id.
However, in the v5.0 23-JAN-23 release, that concept has no descendant concepts. Moreover, the domain_id has changed. In the 2022 releases, the concept is in the Procedure domain, but in the 2023 release, it is an Observation.
Here are greps of the raw downloaded files from the v5.0 22-JUN-22 release:
$ grep None VOCABULARY.csv
None OMOP Standardized Vocabularies OMOP generated v5.0 22-JUN-22 44819096
$ grep 2414392 CONCEPT_CPT4.csv
2414392 Procedure CPT4 CPT4 S 99203 19700101 20991231
$ grep 45889484 CONCEPT_ANCESTOR.csv
45889484 2414391 1 1
45889484 2414394 1 1
45889484 2414393 1 1
45889484 2414392 1 1
45888946 45889484 1 1
45889197 45889484 3 3
45888982 45889484 2 2
45889484 45889484 0 0
And here is the same information from the v5.0 23-JAN-23 release:
$ grep None VOCABULARY.csv
None OMOP Standardized Vocabularies OMOP generated v5.0 23-JAN-23 44819096
$ grep 45888946 CONCEPT_CPT4.csv
45888946 Observation CPT4 CPT4 Hierarchy C 1013626 20141010 20991231
$ grep 45889484 CONCEPT_RELATIONSHIP.csv
45889484 45888946 Is a 19700101 20991231
45889484 2414391 Subsumes 19700101 20991231
45889484 2414394 Subsumes 19700101 20991231
45889484 2414392 Subsumes 19700101 20991231
45889484 2414393 Subsumes 19700101 20991231
45888946 45889484 Subsumes 19700101 20991231
2414391 45889484 Is a 19700101 20991231
2414394 45889484 Is a 19700101 20991231
2414392 45889484 Is a 19700101 20991231
2414393 45889484 Is a 19700101 20991231
These changes are breaking some of my concept sets (e.g. ones looking for new patient doctorsā visits). However, there appear to be hundreds of cases now where Concept Hierarchy codes that used to have descendants no longer do. There are also many where the domain has changed.
Is this an error or intentional? If intentional, where can I find the documentation about those changes, and how will future proposed changes like these be communicated so that users can remediate their concept sets and cohorts accordingly?
-Tom