SwanseaUniversityMedical · JackScanlon · Feb 23, 2026 · Feb 9, 2026
@@ -0,0 +1,37 @@
+# Generated by Django 5.1.8 on 2026-02-09 14:32
+
+import datetime
+import django.contrib.postgres.indexes
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('clinicalcode', '0133_omop_codes'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='omop_codes',
+            name='valid_end_date',
+            field=models.DateField(blank=True, default=datetime.date(2099, 12, 31)),
+        ),
+        migrations.CreateModel(
+            name='OMOPRelationships',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False)),
+                ('relationship', models.CharField(max_length=64)),
+                ('valid_start_date', models.DateField(auto_now_add=True)),
+                ('valid_end_date', models.DateField(blank=True, default=datetime.date(2099, 12, 31))),
+                ('invalid_reason', models.CharField(blank=True, choices=[('D', 'Deprecated'), ('U', 'Upgraded')], default=None, max_length=1, null=True)),
+                ('code0', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='source_relationships', to='clinicalcode.omop_codes', to_field='code')),
+                ('code1', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='destination_relationships', to='clinicalcode.omop_codes', to_field='code')),
+            ],
+            options={
+                'indexes': [models.Index(fields=['code0'], name='clinicalcod_code0_i_9f4db1_idx'), models.Index(fields=['code1'], name='clinicalcod_code1_i_fbd524_idx'), models.Index(fields=['code0', 'code1'], name='clinicalcod_code0_i_634ab7_idx'), models.Index(fields=['code0', 'relationship', 'invalid_reason'], name='clinicalcod_code0_i_bea734_idx'), django.contrib.postgres.indexes.GinIndex(fields=['code0'], name='omop_e0_trgm_idx', opclasses=['gin_trgm_ops']), django.contrib.postgres.indexes.GinIndex(fields=['code0', 'relationship', 'invalid_reason'], name='omop_e0t_tgbt_idx', opclasses=['', 'gin_trgm_ops', ''])],
+                'unique_together': {('code0', 'code1', 'relationship')},
+            },
+        ),
+    ]
@@ -2,6 +2,8 @@
 from django.utils.translation import gettext_lazy as _
 from django.contrib.postgres.indexes import GinIndex
 
+import datetime
+
 class StandardFlag(models.TextChoices):
 	"""
 	See `standard_concept` column of `CONCEPT` table found in `OHDSI docs`_.
@@ -11,6 +13,7 @@ class StandardFlag(models.TextChoices):
 	STANDARD = 'S', _('Standard Concept')
 	CLASSIFICATION = 'C', _('Classification Concept')
 
+
 class InvalidFlag(models.TextChoices):
 	"""
 	See `invalid_reason` column of `CONCEPT` table found in `OHDSI docs`_.
@@ -20,106 +23,181 @@ class InvalidFlag(models.TextChoices):
 	DEPRECATED = 'D', _('Deprecated')
 	UPGRADED = 'U', _('Upgraded')
 
+
 class OMOP_CODES(models.Model):
-		"""
-		Represents a standardised `OMOP`_ code from its Common Data Model, related to :model:`clinicalcode.CodingSystem`.
-
-		Version
-		-------
-		Vocabulary version: `v20250827`
-
-		Reference
-		---------
-		See `OHDSI Single-page docs`_.
-
-		Mapping
-		----------
-		| Attribute            | Table->Column                    |
-		|:---------------------|:---------------------------------|
-		| `code`               | `CONCEPT->concept_id`            |
-		| `description`        | `CONCEPT->concept_name`          |
-		| `is_code`            | `N/A`                            |
-		| `is_valid`           | `N/A`                            |
-		| `standard_concept`   | `CONCEPT->standard_concept`      |
-		| `coding_name`        | `N/A`                            |
-		| `coding_system_id`   | `N/A`                            |
-		| `domain_name`        | `CONCEPT->domain_id`             |
-		| `class_name`         | `CONCEPT->concept_class_id`      |
-		| `vocabulary_name`    | `CONCEPT->vocabulary_id`         |
-		| `vocabulary_code`    | `CONCEPT->concept_code`          |
-		| `vocabulary_version` | `VOCABULARY->vocabulary_version` |
-		| `valid_start_date`   | `CONCEPT->valid_start_date`      |
-		| `valid_end_date`     | `CONCEPT->valid_end_date`        |
-		| `invalid_reason`     | `CONCEPT->invalid_reason`        |
-		| `created`            | `N/A`                            |
-		| `modified`           | `N/A`                            |
-
-		.. _OMOP: https://www.ohdsi.org/data-standardization/
-		.. _OHDSI Single-page docs: https://www.ohdsi.org/web/wiki/doku.php?id=documentation:cdm:single-page
-		"""
-		id = models.BigAutoField(auto_created=True, primary_key=True)
-		code = models.CharField(max_length=64, null=True, blank=True, unique=True, default='')
-		description = models.CharField(max_length=256, null=True, blank=True, default='')
-		is_code = models.BooleanField(null=False, default=True)
-		is_valid = models.BooleanField(null=False, default=True)
-		standard_concept = models.CharField(
-			# 'S', 'C' or NULL
-			null=True,
-			blank=True,
-			choices=StandardFlag.choices,
-			default=None,
-			max_length=1,
-		)
-		coding_name = models.CharField(max_length=256, null=True, blank=True, default='')
-		coding_system = models.ForeignKey(
-			'clinicalcode.CodingSystem',
-			on_delete=models.SET_NULL,
-			null=True,
-			blank=True,
-			default=None,
-			related_name='omop_code'
-		)
-		domain_name = models.CharField(max_length=256, null=True, blank=True, default='')
-		class_name = models.CharField(max_length=256, null=True, blank=True, default='')
-		vocabulary_name = models.CharField(max_length=64, null=True, blank=True, default='')
-		vocabulary_code = models.CharField(max_length=64, null=True, blank=True, default='')
-		vocabulary_version = models.CharField(max_length=256, null=True, blank=True, default='')
-		valid_start_date = models.DateField(null=True, blank=True)
-		valid_end_date = models.DateField(null=True, blank=True)
-		invalid_reason = models.CharField(
-			# 'D', 'U' or NULL
-			null=True,
-			blank=True,
-			choices=InvalidFlag.choices,
-			default=None,
-			max_length=1,
-		)
-		created = models.DateTimeField(auto_now_add=True, editable=True)
-		modified = models.DateTimeField(auto_now_add=True, editable=True)
-
-		class Meta:
-			ordering = ('id',)
-			indexes = [
-				models.Index(fields=['id']),
-				models.Index(fields=['created']),
-				GinIndex(
-					name='omop_cd_trgm_idx',
-					fields=['code'],
-					opclasses=['gin_trgm_ops']
-				),
-				GinIndex(
-						name='omop_desc_trgm_idx',
-						fields=['description'],
-						opclasses=['gin_trgm_ops']
-				),
-				GinIndex(
-					name='omop_cs_trgm_idx',
-					fields=['coding_name'],
-					opclasses=['gin_trgm_ops']
-				),
-				GinIndex(
-						name='omop_vscd_trgm_idx',
-						fields=['vocabulary_code'],
-						opclasses=['gin_trgm_ops']
-				),
-			]
+	"""
+	Represents a standardised `OMOP`_ code from its Common Data Model, related to :model:`clinicalcode.CodingSystem`.
+
+	Version
+	-------
+	Vocabulary version: `v20250827`
+
+	Reference
+	---------
+	See `OHDSI Single-page docs`_.
+
+	Mapping
+	-------
+	| Attribute            | Table->Column                    |
+	|:---------------------|:---------------------------------|
+	| `code`               | `CONCEPT->concept_id`            |
+	| `description`        | `CONCEPT->concept_name`          |
+	| `is_code`            | `N/A`                            |
+	| `is_valid`           | `N/A`                            |
+	| `standard_concept`   | `CONCEPT->standard_concept`      |
+	| `coding_name`        | `N/A`                            |
+	| `coding_system_id`   | `N/A`                            |
+	| `domain_name`        | `CONCEPT->domain_id`             |
+	| `class_name`         | `CONCEPT->concept_class_id`      |
+	| `vocabulary_name`    | `CONCEPT->vocabulary_id`         |
+	| `vocabulary_code`    | `CONCEPT->concept_code`          |
+	| `vocabulary_version` | `VOCABULARY->vocabulary_version` |
+	| `valid_start_date`   | `CONCEPT->valid_start_date`      |
+	| `valid_end_date`     | `CONCEPT->valid_end_date`        |
+	| `invalid_reason`     | `CONCEPT->invalid_reason`        |
+	| `created`            | `N/A`                            |
+	| `modified`           | `N/A`                            |
+
+	.. _OMOP: https://www.ohdsi.org/data-standardization/
+	.. _OHDSI Single-page docs: https://www.ohdsi.org/web/wiki/doku.php?id=documentation:cdm:single-page
+	"""
+	id = models.BigAutoField(auto_created=True, primary_key=True)
+	code = models.CharField(max_length=64, null=True, blank=True, unique=True, default='')
+	description = models.CharField(max_length=256, null=True, blank=True, default='')
+	is_code = models.BooleanField(null=False, default=True)
+	is_valid = models.BooleanField(null=False, default=True)
+	standard_concept = models.CharField(
+		# 'S', 'C' or NULL
+		null=True,
+		blank=True,
+		choices=StandardFlag.choices,
+		default=None,
+		max_length=1,
+	)
+	coding_name = models.CharField(max_length=256, null=True, blank=True, default='')
+	coding_system = models.ForeignKey(
+		'clinicalcode.CodingSystem',
+		on_delete=models.SET_NULL,
+		null=True,
+		blank=True,
+		default=None,
+		related_name='omop_code'
+	)
+	domain_name = models.CharField(max_length=256, null=True, blank=True, default='')
+	class_name = models.CharField(max_length=256, null=True, blank=True, default='')
+	vocabulary_name = models.CharField(max_length=64, null=True, blank=True, default='')
+	vocabulary_code = models.CharField(max_length=64, null=True, blank=True, default='')
+	vocabulary_version = models.CharField(max_length=256, null=True, blank=True, default='')
+	valid_start_date = models.DateField(blank=True, null=True)
+	valid_end_date = models.DateField(blank=True, default=datetime.date(2099,12,31))
+	invalid_reason = models.CharField(
+		# 'D', 'U' or NULL
+		null=True,
+		blank=True,
+		choices=InvalidFlag.choices,
+		default=None,
+		max_length=1,
+	)
+	created = models.DateTimeField(auto_now_add=True, editable=True)
+	modified = models.DateTimeField(auto_now_add=True, editable=True)
+
+	class Meta:
+		ordering = ('id',)
+		indexes = [
+			models.Index(fields=['id']),
+			models.Index(fields=['created']),
+			GinIndex(
+				name='omop_cd_trgm_idx',
+				fields=['code'],
+				opclasses=['gin_trgm_ops']
+			),
+			GinIndex(
+				name='omop_desc_trgm_idx',
+				fields=['description'],
+				opclasses=['gin_trgm_ops']
+			),
+			GinIndex(
+				name='omop_cs_trgm_idx',
+				fields=['coding_name'],
+				opclasses=['gin_trgm_ops']
+			),
+			GinIndex(
+				name='omop_vscd_trgm_idx',
+				fields=['vocabulary_code'],
+				opclasses=['gin_trgm_ops']
+			),
+		]
+
+
+class OMOPRelationships(models.Model):
+	"""
+	Represents the edges, or `relationships`_, between OMOP concepts stored in :model:`clinicalcode.OMOP_CODES`.
+
+	Version
+	-------
+	Vocabulary version: `v20250827`
+
+	Reference
+	---------
+	See:
+	- `Concept Relationship Data Model Conventions`_.
+	- `CONCEPT_RELATIONSHIP table`_.
+
+	Mapping
+	-------
+	| Attribute            | Table->Column                            |
+	|:---------------------|:-----------------------------------------|
+	| `code0_id`           | `CONCEPT_RELATIONSHIP->concept_id_1`     |
+	| `code1_id`           | `CONCEPT_RELATIONSHIP->concept_id_2`     |
+	| `relationship`       | `CONCEPT_RELATIONSHIP->relationship_id`  |
+	| `valid_start_date`   | `CONCEPT_RELATIONSHIP->valid_start_date` |
+	| `valid_end_date`     | `CONCEPT_RELATIONSHIP->valid_end_date`   |
+	| `invalid_reason`     | `CONCEPT_RELATIONSHIP->invalid_reason`   |
+
+	.. _relationships: https://www.ohdsi.org/web/wiki/doku.php?id=documentation:cdm:concept_relationship
+	.. _Concept Relationship Data Model Conventions: https://ohdsi.github.io/CommonDataModel/dataModelConventions.html#Concept_Relationships
+	.. _CONCEPT_RELATIONSHIP table: https://www.ohdsi.org/web/wiki/doku.php?id=documentation:cdm:concept_relationship
+	"""
+	id = models.BigAutoField(auto_created=True, primary_key=True)
+	code0 = models.ForeignKey(
+		to='OMOP_CODES',
+		to_field='code',
+		related_name=f'source_relationships',
+		on_delete=models.CASCADE,
+	)
+	code1 = models.ForeignKey(
+		to='OMOP_CODES',
+		to_field='code',
+		related_name=f'destination_relationships',
+		on_delete=models.CASCADE,
+	)
+	relationship = models.CharField(max_length=64)
+	valid_start_date = models.DateField(blank=True, auto_now_add=True)
+	valid_end_date = models.DateField(blank=True, default=datetime.date(2099,12,31))
+	invalid_reason = models.CharField(
+		# 'D', 'U' or NULL
+		null=True,
+		blank=True,
+		choices=InvalidFlag.choices,
+		default=None,
+		max_length=1,
+	)
+
+	class Meta:
+		unique_together = ('code0', 'code1', 'relationship',)
+		indexes = [
+			models.Index(fields=['code0']),
+			models.Index(fields=['code1']),
+			models.Index(fields=['code0', 'code1']),
+			models.Index(fields=['code0', 'relationship', 'invalid_reason']),
+			GinIndex(
+				name='omop_e0_trgm_idx',
+				fields=['code0'],
+				opclasses=['gin_trgm_ops']
+			),
+			GinIndex(
+				name='omop_e0t_tgbt_idx',
+				fields=['code0', 'relationship', 'invalid_reason'],
+				opclasses=['', 'gin_trgm_ops', '']
+			),
+		]
@@ -56,7 +56,7 @@
 from .ATCDDD_CODES import ATCDDD_CODES
 from .ICD10CA_CODES import ICD10CA_CODES
 from .ICD10CM_CODES import ICD10CM_CODES
-from .OMOP_CODES import OMOP_CODES
+from .OMOP_CODES import OMOP_CODES, OMOPRelationships
 
 # need to restore EMIS/Vision when deploy. to prod.
 #from .EMIS_CODES import EMIS_CODES