nci-cidc-api-modules 1.2.34__py3-none-any.whl → 1.2.53__py3-none-any.whl

cidc_api/models/pydantic/stage1/participant.py

@@ -0,0 +1,63 @@
+from cidc_api.models.pydantic.base import forced_validator, forced_validators
+
+from cidc_api.models.errors import ValueLocError
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import YNU
+from cidc_api.models.types import OffStudyReason
+
+
+@forced_validators
+class Participant(Base):
+    __data_category__ = "participant"
+    __cardinality__ = "one"
+
+    # The unique internal identifier for the participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The participant identifier assigned by the clinical trial team overseeing the study
+    native_participant_id: str | None = None
+
+    # The globally unique participant identifier assigned by the CIMAC network. e.g. C8P29A7
+    cimac_participant_id: str | None = None
+
+    # The unique identifier for the associated trial that the participant is participating in
+    trial_id: str | None = None
+
+    # The version number of the trial dataset. e.g. "1.0"
+    version: str | None = None
+
+    # Indicates if the individual is no longer actively participating in the clinical trial.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14834973%20and%20ver_nr=1
+    off_study: YNU
+
+    # An explanation describing why an individual is no longer participating in the clinical trial.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13362265%20and%20ver_nr=1
+    off_study_reason: OffStudyReason | None = None
+
+    # Additional information if "Other" is selected for off_study_reason. e.g. "Transfer to another study"
+    off_study_reason_other: str | None = None
+
+    @forced_validator
+    @classmethod
+    def off_study_reason_cr(cls, data, info) -> None:
+        off_study = data.get("off_study", None)
+        off_study_reason = data.get("off_study_reason", None)
+
+        if off_study == "Yes" and not off_study_reason:
+            raise ValueLocError(
+                'If "off_study" is "Yes" then "off_study_reason" is required.',
+                loc="off_study_reason",
+            )
+
+    @forced_validator
+    @classmethod
+    def off_study_reason_other_cr(cls, data, info) -> None:
+        off_study_reason_other = data.get("off_study_reason_other", None)
+        off_study_reason = data.get("off_study_reason", None)
+
+        if off_study_reason == "Other" and not off_study_reason_other:
+            raise ValueLocError(
+                'If "off_study_reason" is "Other" then "off_study_reason_other" is required.',
+                loc="off_study_reason_other",
+            )

cidc_api/models/pydantic/stage1/prior_treatment.py

@@ -0,0 +1,45 @@
+from typing import Self, Annotated, List
+
+from pydantic import NonPositiveInt, NegativeInt, model_validator, BeforeValidator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import ConditioningRegimenType, StemCellDonorType
+
+
+class PriorTreatment(Base):
+    __data_category__ = "prior_treatment"
+    __cardinality__ = "many"
+
+    # A unique internal identifier for the prior treatment record
+    prior_treatment_id: int | None = None
+
+    # A unique internal identifier for the associated participant record
+    participant_id: str | None = None
+
+    # Number of days from the enrollment date to the first recorded administration or occurrence of
+    # the treatment modality.
+    prior_treatment_days_to_start: NonPositiveInt | None = None
+
+    # Number of days from the enrollment date to the last recorded administration or occurrence of
+    # the treatment modality.
+    prior_treatment_days_to_end: NonPositiveInt | None = None
+
+    # Specifies the category or kind of prior treatment modality a participant received.
+
+    # Description of the prior treatment such as its full generic name if it is a type of therapy agent,
+    # radiotherapy procedure name and location, or surgical procedure name and location.
+    prior_treatment_description: str
+
+    # Best response from any response assessment system to the prior treatment if available or applicable.
+    prior_treatment_best_response: str | None = None
+
+    # If the prior treatment is "Conditioning therapy" received before a stem cell transplant, specifies what
+    # type of conditioning regimen used.
+    prior_treatment_conditioning_regimen_type: ConditioningRegimenType | None = None
+
+    # If prior treatment is "Stem cell transplant", indicates what stem cell donor type used.
+    prior_treatment_stem_cell_donor_type: StemCellDonorType | None = None
+
+    # If prior treatment is "Stem cell transplant", indicates the number of days from enrollment
+    # to the prior transplant. This must be a negative number.
+    prior_treatment_days_from_transplant_to_treatment_initiation: NegativeInt | None = None

cidc_api/models/pydantic/stage1/radiotherapy_dose.py

@@ -0,0 +1,92 @@
+from pydantic import NonNegativeInt, NonNegativeFloat
+from cidc_api.models.pydantic.base import forced_validator, forced_validators
+
+from cidc_api.models.errors import ValueLocError
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    YNU,
+    RadiotherapyProcedure,
+    UberonAnatomicalTerm,
+    RadiotherapyDoseUnits,
+    RadiationExtent,
+)
+
+
+@forced_validators
+class RadiotherapyDose(Base):
+    __data_category__ = "radiotherapy_dose"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the radiotherapy dose record
+    radiotherapy_dose_id: int | None = None
+
+    # The unique internal identifier for the associated treatment record
+    treatment_id: int | None = None
+
+    # Number of days from enrollment date to the start of the radiotherapy dose.
+    days_to_start: NonNegativeInt
+
+    # Number of days from enrollment date to the end of the radiotherapy dose.
+    days_to_end: NonNegativeInt
+
+    # The term that describes the kind of radiotherapy procedure administered.
+    procedure: RadiotherapyProcedure
+
+    # The Uberon anatomical term for the site of surgery.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14461856%20and%20ver_nr=1
+    anatomical_location: UberonAnatomicalTerm | None = None
+
+    # Indicates whether the record represents the total dose for a radiotherapy treatment course (which may be either
+    # a multi-fractionated or a single-fraction dose).
+    is_total_dose: bool
+
+    # The number of fractions a participant received to deliver the radiation dose.
+    number_of_fractions: NonNegativeInt | None = None
+
+    # The dose amount received by the participant.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13433490%20and%20ver_nr=1
+    received_dose: NonNegativeFloat
+
+    # Unit of measure for the dose of the radiotherapy to be received by the participant.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13383458%20and%20ver_nr=1
+    received_dose_units: RadiotherapyDoseUnits
+
+    # The planned dose amount for the participant.
+    planned_dose: NonNegativeFloat | None = None
+
+    # Unit of measure for the planned total dose of the radiotherapy to be received by the participant.
+    planned_dose_units: RadiotherapyDoseUnits | None = None
+
+    # Indicates if the radiotherapy dose was changed, missed, or delayed.
+    dose_changes_delays: YNU
+
+    # Description of the radiotherapy dose changes, misses, or delays.
+    changes_delays_description: str | None = None
+
+    # The extent of radiation exposure administered to the patient's body during radiation therapy.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=7063755%20and%20ver_nr=1
+    radiation_extent: RadiationExtent
+
+    @forced_validator
+    @classmethod
+    def validate_changes_delays_description_cr(cls, data, info) -> None:
+        dose_changes_delays = data.get("dose_changes_delays", None)
+        changes_delays_description = data.get("changes_delays_description", None)
+
+        if dose_changes_delays == "Yes" and not changes_delays_description:
+            raise ValueLocError(
+                'If dose_changes_delays is "Yes", please provide changes_delays_description.',
+                loc="changes_delays_description",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_planned_dose_units_cr(cls, data, info) -> None:
+        planned_dose = data.get("planned_dose", None)
+        planned_dose_units = data.get("planned_dose_units", None)
+
+        if planned_dose and not planned_dose_units:
+            raise ValueLocError(
+                "If planned_dose is provided, please provide planned_dose_units.",
+                loc="planned_dose_units",
+            )

cidc_api/models/pydantic/stage1/response.py

@@ -0,0 +1,84 @@
+from pydantic import NonNegativeInt
+from cidc_api.models.pydantic.base import forced_validator, forced_validators
+
+from cidc_api.models.errors import ValueLocError
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import SurvivalStatus, YNUNA, CauseOfDeath
+
+
+@forced_validators
+class Response(Base):
+    __data_category__ = "response"
+    __cardinality__ = "one"
+
+    # The unique internal identifier for the response record
+    response_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The response to a question that describes a participant's survival status.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=2847330%20and%20ver_nr=1
+    survival_status: SurvivalStatus
+
+    # Number of days from enrollment date to death date.
+    overall_survival: NonNegativeInt
+
+    # Indicator for whether there was an abscopal effect on disease after local therapy.
+    abscopal_response: YNUNA | None = None
+
+    # Indicates if pathological complete response (pCR) occurred.
+    pathological_complete_response: YNUNA | None = None
+
+    # Number of days between enrollment date and date of death, if applicable.
+    days_to_death: NonNegativeInt | None = None
+
+    # The circumstance or condition of greatest rank or importance that results in the death of the participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=4783274%20and%20ver_nr=1
+    cause_of_death: CauseOfDeath | None = None
+
+    # Indicates whether participant was evaluable for toxicity (adverse events, DLT, etc.) overall.
+    evaluable_for_toxicity: bool
+
+    # Indicates whether participant was evaluable for efficacy (for example, response, PFS, OS, etc.) overall.
+    evaluable_for_efficacy: bool
+
+    # Days from enrollment date to the last time the patient's vital status was verified.
+    days_to_last_vital_status: NonNegativeInt | None = None
+
+    @forced_validator
+    @classmethod
+    def validate_cause_of_death_cr(cls, data, info) -> None:
+        survival_status = data.get("survival_status", None)
+        cause_of_death = data.get("cause_of_death", None)
+
+        if survival_status == "Dead" and not cause_of_death:
+            raise ValueLocError(
+                'If survival_status is "Dead" then cause_of_death is required.',
+                loc="cause_of_death",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_cause_of_death_cr2(cls, data, info) -> None:
+        survival_status = data.get("survival_status", None)
+        cause_of_death = data.get("cause_of_death", None)
+
+        if survival_status == "Alive" and cause_of_death:
+            raise ValueLocError(
+                'If survival_status is "Alive", please leave cause_of_death blank.',
+                loc="cause_of_death",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_death_cr(cls, data, info) -> None:
+        survival_status = data.get("survival_status", None)
+        days_to_death = data.get("days_to_death", None)
+
+        if survival_status in ["Alive", "Unknown"] and days_to_death:
+            raise ValueLocError(
+                "If survival_status does not indicate death, please leave days_to_death blank.",
+                loc="days_to_death",
+            )

cidc_api/models/pydantic/stage1/response_by_system.py

@@ -0,0 +1,220 @@
+from typing import Self
+
+from pydantic import PositiveInt, NonNegativeInt, model_validator
+from cidc_api.models.pydantic.base import forced_validator, forced_validators
+
+from cidc_api.models.errors import ValueLocError
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.pydantic.stage1.response import Response
+from cidc_api.models.types import ResponseSystem, ResponseSystemVersion, BestOverallResponse, YNUNA
+
+
+negative_response_values = [
+    "Progressive Disease",
+    "Stable Disease",
+    "immune Unconfirmed Progressive Disease",
+    "immune Confirmed Progressive Disease",
+    "immune Stable Disease",
+    "Not available",
+    "Not assessed",
+]
+
+
+@forced_validators
+class ResponseBySystem(Base):
+    __data_category__ = "response_by_system"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for this ResponseBySystem record
+    response_by_system_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The linked parent response for the participant. Used for cross-model validation.
+    response: Response | None = None
+
+    # A standardized method used to evaluate and categorize the participant’s clinical response to treatment based on predefined criteria.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13381490%20and%20ver_nr=1
+    response_system: ResponseSystem
+
+    # The release version of the clinical assessment system used to evaluate a participant’s response to treatment.
+    response_system_version: ResponseSystemVersion
+
+    # Confirmed best overall response to study treatment by the corresponding response system.
+    best_overall_response: BestOverallResponse
+
+    # Days from first response to progression.
+    response_duration: PositiveInt | None = None
+
+    # The number of days from the start of the treatment to the first signs of disease progression.
+    duration_of_stable_disease: NonNegativeInt | None = None
+
+    # Indicates whether a patient achieved a durable clinical benefit.
+    durable_clinical_benefit: bool | None = None
+
+    # Number of days between enrollment date and the date of first response to trial treatment.
+    days_to_first_response: PositiveInt | None = None
+
+    # Number of days between enrollment date and the date of the best response to trial treatment.
+    days_to_best_response: PositiveInt | None = None
+
+    # Indicates whether a participant's disease progressed.
+    progression: YNUNA
+
+    # Number of days between enrollment date and date of disease progression.
+    days_to_disease_progression: PositiveInt | None = None
+
+    # Indicator to identify whether a patient had a Progression-Free Survival (PFS) event.
+    progression_free_survival_event: YNUNA
+
+    # The number of days from the date the patient was enrolled in the study to the date the patient was last verified to be free of progression.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=5143957%20and%20ver_nr=1
+    progression_free_survival: PositiveInt | None = None
+
+    @forced_validator
+    @classmethod
+    def validate_response_duration_cr(cls, data, info) -> None:
+        best_overall_response = data.get("best_overall_response", None)
+        response_duration = data.get("response_duration", None)
+
+        if best_overall_response in negative_response_values and response_duration:
+            raise ValueLocError(
+                "If best_overall_response does not indicate a positive response, "
+                "please leave response_duration blank.",
+                loc="response_duration",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_first_response_cr(cls, data, info) -> None:
+        best_overall_response = data.get("best_overall_response", None)
+        days_to_first_response = data.get("days_to_first_response", None)
+
+        if best_overall_response in negative_response_values and days_to_first_response:
+            raise ValueLocError(
+                "If best_overall_response does not indicate a positive response, "
+                "please leave days_to_first_response blank.",
+                loc="days_to_first_response",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_best_response_cr(cls, data, info) -> None:
+        best_overall_response = data.get("best_overall_response", None)
+        days_to_best_response = data.get("days_to_best_response", None)
+
+        if best_overall_response in negative_response_values and days_to_best_response:
+            raise ValueLocError(
+                "If best_overall_response does not indicate a positive response, "
+                "please leave days_to_best_response blank.",
+                loc="days_to_best_response",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_disease_progression_cr(cls, data, info) -> None:
+        progression = data.get("progression", None)
+        days_to_disease_progression = data.get("days_to_disease_progression", None)
+
+        if progression in ["No", "Unknown", "Not Applicable"] and days_to_disease_progression:
+            raise ValueLocError(
+                "If progression does not indicate confirmed progression of the disease, "
+                "please leave days_to_disease_progression blank.",
+                loc="days_to_disease_progression",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_progression_free_survival_cr(cls, data, info) -> None:
+        progression_free_survival_event = data.get("progression_free_survival_event", None)
+        progression_free_survival = data.get("progression_free_survival", None)
+
+        if progression_free_survival_event in ["Unknown", "Not Applicable"] and progression_free_survival:
+            raise ValueLocError(
+                "If progression_free_survival_event is not known, " "please leave progression_free_survival blank.",
+                loc="progression_free_survival",
+            )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_best_response_chronology(cls, data, info) -> None:
+        days_to_first_response = data.get("days_to_first_response", None)
+        days_to_best_response = data.get("days_to_best_response", None)
+
+        if days_to_best_response is not None and days_to_first_response is not None:
+            if int(days_to_best_response) < int(days_to_first_response):
+                raise ValueLocError(
+                    'Violate "days_to_best_response" >= days_to_first_response"',
+                    loc="days_to_best_response",
+                )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_disease_progression_chronology(cls, data, info) -> None:
+        days_to_disease_progression = data.get("days_to_disease_progression", None)
+        days_to_first_response = data.get("days_to_first_response", None)
+
+        if days_to_first_response is not None and days_to_disease_progression is not None:
+            if int(days_to_first_response) >= int(days_to_disease_progression):
+                raise ValueLocError(
+                    'Violate "days_to_first_response" < "days_to_disease_progression"',
+                    loc="days_to_first_response",
+                )
+
+    @forced_validator
+    @classmethod
+    def validate_days_to_best_response_progression_chronology(cls, data, info) -> None:
+        days_to_disease_progression = data.get("days_to_disease_progression", None)
+        days_to_best_response = data.get("days_to_best_response", None)
+
+        if days_to_best_response is not None and days_to_disease_progression is not None:
+            if int(days_to_best_response) >= int(days_to_disease_progression):
+                raise ValueLocError(
+                    'Violate "days_to_best_response" < "days_to_disease_progression"',
+                    loc="days_to_best_response",
+                )
+
+    @model_validator(mode="after")
+    def validate_days_to_last_vital_status_chronology(self) -> Self:
+        if not self.response:
+            return self
+
+        if not self.response.days_to_last_vital_status:
+            return self
+
+        max_value = max(
+            self.response.days_to_last_vital_status or 0,
+            self.days_to_first_response or 0,
+            self.days_to_best_response or 0,
+            self.days_to_disease_progression or 0,
+        )
+        if (self.response.days_to_last_vital_status or 0) != max_value:
+            raise ValueLocError(
+                '"days_to_last_vital_status" is not the max of all events. Rule: days_to_last_vital_status '
+                ">= max(days_to_first_response,days_to_best_response,days_to_disease_progression)",
+                loc="days_to_last_vital_status,days_to_first_response,days_to_best_response,days_to_disease_progression",
+            )
+        return self
+
+    @model_validator(mode="after")
+    def validate_days_to_death_chronology(self) -> Self:
+        if not self.response:
+            return self
+        if not self.response.days_to_death:
+            return self
+
+        max_value = max(
+            self.response.days_to_death or 0,
+            self.days_to_first_response or 0,
+            self.days_to_best_response or 0,
+            self.days_to_disease_progression or 0,
+        )
+        if (self.response.days_to_death or 0) != max_value:
+            raise ValueLocError(
+                '"days_to_death" is not the max of all events. Rule: days_to_death'
+                ">= max(days_to_first_response,days_to_best_response,days_to_disease_progression)",
+                loc="days_to_death,days_to_first_response,days_to_best_response,days_to_disease_progression",
+            )
+        return self

cidc_api/models/pydantic/stage1/specimen.py

@@ -0,0 +1,31 @@
+from datetime import datetime
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import UberonAnatomicalTerm
+
+
+class Specimen(Base):
+    __data_category__ = "specimen"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the specimen record
+    specimen_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The unique specimen identifier assigned by the CIMAC-CIDC Network.
+    # Formatted as CTTTPPPSS.AA for trial code TTT, participant PPP, sample SS, and aliquot AA.
+    cimac_id: str
+
+    # Categorical description of timepoint at which the sample was taken.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=5899851%20and%20ver_nr=1
+    # Note: CIDC doesn't conform to this CDE's PVs
+    collection_event_name: str
+
+    # Days from enrollment date to date specimen was collected.
+    days_to_specimen_collection: int
+
+    # The location within the body from which a specimen was originally obtained as captured in the Uberon anatomical term.
+    organ_site_of_collection: UberonAnatomicalTerm

cidc_api/models/pydantic/stage1/stem_cell_transplant.py

@@ -0,0 +1,35 @@
+from pydantic import NonNegativeInt
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    StemCellDonorType,
+    AllogeneicDonorType,
+    StemCellSource,
+    ConditioningRegimenType,
+)
+
+
+class StemCellTransplant(Base):
+    __data_category__ = "stem_cell_transplant"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the stem cell transplant record
+    stem_cell_transplant_id: int | None = None
+
+    # The unique internal identifier for the associated Treatment record
+    treatment_id: int | None = None
+
+    # Indicates the stem cell donor type.
+    stem_cell_donor_type: StemCellDonorType
+
+    # If "stem_cell_donor_type" is "Allogeneic", specifies the relationship and
+    # compatibility of the donor relative to the receipient
+    allogeneic_donor_type: AllogeneicDonorType | None = None
+
+    # Source of the stem cells used for transplant.
+    stem_cell_source: StemCellSource
+
+    # Days from the enrollment date to the date of the stem cell transplant.
+    days_to_transplant: NonNegativeInt
+
+    # Specifies what type of conditioning regimen was used for the stem cell transplant if applicable.
+    conditioning_regimen_type: ConditioningRegimenType | None = None

cidc_api/models/pydantic/stage1/surgery.py

@@ -0,0 +1,57 @@
+from pydantic import NonNegativeInt
+from cidc_api.models.pydantic.base import forced_validator, forced_validators
+
+
+from cidc_api.models.errors import ValueLocError
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import SurgicalProcedure, UberonAnatomicalTerm, YNU
+
+
+@forced_validators
+class Surgery(Base):
+    __data_category__ = "surgery"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the surgery record
+    surgery_id: int | None = None
+
+    # The unique internal identifier for the associated treatment record
+    treatment_id: int | None = None
+
+    # The term that describes the kind of surgical procedure administered.
+    procedure: SurgicalProcedure
+
+    # The name of surgical procedure if the value provided for procedure is "Other, specify".
+    procedure_other: str | None = None
+
+    # Number of days from enrollment date to surgical procedure date.
+    days_to_procedure: NonNegativeInt
+
+    # The Uberon identifier for the location within the body targeted by a procedure that
+    # is intended to alter or stop a pathologic process.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14980609%20and%20ver_nr=1
+    anatomical_location: UberonAnatomicalTerm
+
+    # An indication as to whether the surgical procedure in question was performed with therapeutic intent.
+    therapeutic: YNU
+
+    # A narrative description of any significant findings observed during the surgical procedure in question.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14918773%20and%20ver_nr=1
+    findings: str | None = None
+
+    # A textual description of evidence for remaining tumor following primary treatment that is only
+    # apparent using highly sensitive techniques.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13362284%20and%20ver_nr=1
+    extent_of_residual_disease: str | None = None
+
+    @forced_validator
+    @classmethod
+    def validate_procedure_other_cr(cls, data, info) -> None:
+        procedure = data.get("procedure", None)
+        procedure_other = data.get("procedure_other", None)
+
+        if procedure == "Other, specify" and not procedure_other:
+            raise ValueLocError(
+                'If procedure is "Other, specify", please provide procedure_other.',
+                loc="procedure_other",
+            )