This page documents the structure of the research export files (.json and .csv) generated at the end of an evaluation. These files form a stable contract: their structure and column names are versioned so that external research teams can reliably integrate them into their databases.

Current structure version: v2.11

Download a blank .json (structure) Download a blank .csv (structure) Download the codebook (Excel)

  • Two formats are provided: .json (full nested structure) and .csv (flattened structure, one row per evaluation).
  • The CSV is UTF-8 encoded with a BOM and uses the semicolon (;) as the delimiter, for direct compatibility with Excel and REDCap.
  • In CSV, nested paths are flattened into underscore-joined column names (e.g. operative_report.incision.approach → operative_report_incision_approach). Lists of simple values are joined with commas in a single column.
  • Files are named CRS-Data-<TYPE>-<date>.json (JSON export) and CRS-Report_Data-<TYPE>-<date>.csv (CSV export).
  • Labels are provided in French (_fr fields) and English (_en fields) for clinical items. This dictionary is itself bilingual: it is displayed according to the site language.

0. File metadata

Column name Data type Description Possible values / Example
meta_generated_at ISO 8601 datetime Date and time the export file was generated (ISO 8601 format) e.g. "2026-06-08T14:32:05+02:00"
meta_version Text Version of the export file structure (see the Changelog tab of the Developers page) e.g. "2.11"
meta_language_codes List of strings Language codes present in the bilingual labels (fr, en) — in CSV: values joined by commas in a single column ["fr", "en"]

1. Evaluation metadata

Column name Data type Description Possible values / Example
evaluation_meta_evaluation_type Single choice (Radio) Evaluation type
ct, petct, fapipetct, spectratdm, mri, surgery, pathology
evaluation_meta_evaluation_date Date Evaluation date YYYY-MM-DD
evaluation_meta_hospital Text Hospital name free text
evaluation_meta_hospital_service Text Hospital department name free text
evaluation_meta_practitioner Text Surgeon / practitioner name free text
evaluation_meta_patient_name Text Patient name or identifier free text
evaluation_meta_patient_sex Single choice (Radio) Patient sex male, female
evaluation_meta_primary_tumor Single choice (Radio) Primary tumour
colorectalCancer, ovarianCancer, appendixCancer, gastricCancer, pseudomyxomaPeritonei, mesothelioma, other
evaluation_meta_primary_tumor_other Text Specification when tumour = "other" free text
evaluation_meta_primary_tumor_grade Single choice (Radio) Tumour histotype / grade — shown only for ovarian cancer serous, mucinous, clearCell, granulosa, others
evaluation_meta_ecog_status Single choice (Radio) Preoperative ECOG/WHO performance status score 0, 1, 2, 3, 4
evaluation_meta_ca125_preop Single choice (Radio) Elevated preoperative CA-125 (yes/no) — shown only for ovarian cancer yes, no
evaluation_meta_procedure_title Single choice (Radio) Type of procedure performed surgery_alone, surgery_hipec, laparoscopy_pipac
evaluation_meta_procedure_duration Numeric Total duration of the procedure in minutes integer (minutes)
evaluation_meta_aim_of_surgery JSON array (multi-choice) Aim(s) of the surgery (multiple values possible) — shown except for a laparoscopy procedure (procedure_title = laparoscopy_pipac) cytoreduction, diagnosis, recidive, staging, emergency, palliative
evaluation_meta_aim_of_surgery_details Long text Free-text details on the aim of the surgery free text
evaluation_meta_indication Text Free text describing the surgical indication free text
evaluation_meta_laparoscopy_aim_of_surgery Single choice (Radio) Aim of the exploratory laparoscopy — shown only for a laparoscopy procedure (procedure_title = laparoscopy_pipac) diagnostic_biopsies, evaluation_chemo_neoadjuvant, emergency, pipac, other
evaluation_meta_laparoscopy_aim_other Text Specification when laparoscopy aim = "other" free text
evaluation_meta_laparoscopy_chemo_cycles Numeric Number of chemotherapy cycles received before the laparoscopy — shown only if laparoscopy_aim_of_surgery = evaluation_chemo_neoadjuvant integer
evaluation_meta_laparoscopy_chemo_name Text Name / protocol of neoadjuvant chemotherapy before the laparoscopy (e.g. FOLFOX, FOLFIRI, carboplatin-paclitaxel) — shown only if laparoscopy_aim_of_surgery = evaluation_chemo_neoadjuvant free text
evaluation_meta_laparoscopy_pipac_number Numeric Number of the PIPAC cycle performed during this procedure — shown only if laparoscopy_aim_of_surgery = pipac integer
comment Text Free-text summary comment entered by the practitioner free text

2. Global scores

Column name Data type Description Possible values / Example
scores_pci_total Numeric Total PCI score (0 to 39) 0 to 39
scores_pci_max Numeric Maximum evaluable PCI score given the non-evaluable regions (0 to 39) 0 to 39
scores_pci_regions_vector List (13) Vector of PCI scores per region R0 to R12 (values 0 to 3, or "X" if non-evaluable) — in CSV: values joined by commas in a single column [0, 3, 1, 0, 2, "X", 0, 0, 1, 0, 0, 0, 0]
scores_fagotti Numeric Total Fagotti score (0 to 14) 0 to 14
scores_fagotti_modified Numeric Total Modified Fagotti score (0 to 10) 0 to 10
scores_figo Text FIGO classification
IA, IB, IC, IC1, IC2, IC3, IIA, IIB, IIIA, IIIA1, IIIA2, IIIB, IIIC, IVA, IVB
scores_figo_stage_iv_reason Text Justification for FIGO stage IV classification, where applicable free text
scores_cc_score Single choice (Radio) CC Score (Completeness of Cytoreduction) — available only for surgery-type evaluations cc0, cc1, cc2, cc3
scores_pci_residual_applicable Boolean Whether a residual PCI applies (incomplete cytoreduction CC-1/2/3) true, false
scores_pci_residual_total Numeric Total residual PCI score after an incomplete cytoreduction (0 if not applicable) 0 to 39
scores_pci_residual_max Numeric Theoretical maximum residual PCI score (39) 0 to 39
scores_pci_residual_regions_vector List (13) Vector of residual PCI scores per region R0 to R12 after an incomplete cytoreduction [0, 1, 0, 0, "NE", 0, 0, 0, 0, 0, 0, 0, 0]

2b. Aletti Surgical Complexity Score

Column name Data type Description Possible values / Example
scores_aletti_total Numeric Total Aletti Surgical Complexity Score (SCS) — ovarian cancer evaluations only integer
scores_aletti_complexity_class Numeric (1-3) Aletti complexity class: 1 = low, 2 = intermediate, 3 = high 1, 2, 3
scores_aletti_complexity_label Text Aletti complexity class label (Low, Intermediate, High) Low, Intermediate, High
aletti_details_X_label_key Text Translation key of the Aletti complexity category free text
aletti_details_X_points Numeric Aletti points awarded for this category (0 if not triggered) integer
aletti_details_X_max_points Numeric Maximum possible Aletti points for this category integer
aletti_details_X_triggered Boolean Whether the Aletti category was triggered by at least one performed procedure true, false
aletti_details_X_triggering_procedures List of strings Identifiers (slugs) of the procedures that triggered this Aletti category ["splenectomy", "diaphragm_stripping"]

3. PCI (R0–R12 matrix)

Column name Data type Description Possible values / Example
pci_details_X_region_id Numeric (0-12) PCI region identifier (R0 to R12) 0 to 12
pci_details_X_is_evaluable Boolean Region X evaluable — 1 (Yes), 0 (No). X = 0 to 12. true, false
pci_details_X_non_evaluable_reason Text Reason why region X is non-evaluable free text
pci_details_X_nodules_count Numeric Number of nodules observed in region X integer
pci_details_X_nodules_size_mm Numeric Size of region X nodules in millimetres numeric (mm)
pci_details_X_nodules_morpheus2 List of strings MORPHEUS 2 morphological features selected for the region nodules — in CSV: values joined by commas in a single column ["nodule", "plaque", "discolouration"]
pci_details_X_nodules_morpheus_extras List of strings Additional MORPHEUS 2 sub-features (qualifiers, consistencies) of the region nodules ["nodule_q_micronodule", "nodule_c_mucinous"]
pci_details_X_nodules_morpheus_details JSON object Grouping of morpheus_extras by parent MORPHEUS 2 term (dynamic keys = selected terms) {"nodule": ["nodule_q_micronodule", "nodule_c_mucinous"]}
pci_details_X_infiltration_present Boolean Infiltration present in region X — 1 (Yes), 0 (No) true, false
pci_details_X_infiltration_retractile Boolean Retractile infiltration in region X — 1 (Yes), 0 (No) true, false
pci_details_X_infiltration_diffuse_retractile Boolean Diffuse retractile infiltration in region X — 1 (Yes), 0 (No) true, false
pci_details_X_ascites_minimal_volume Boolean Minimal-volume ascites in region X — 1 (Yes), 0 (No) true, false
pci_details_X_ascites_significant_volume Boolean Significant-volume ascites (> 50 cc) in region X — 1 (Yes), 0 (No) true, false
pci_details_X_ascites_free Boolean Free ascitic fluid in region X — 1 (Yes), 0 (No) true, false
pci_details_X_ascites_loculated Boolean Loculated ascitic fluid in region X — 1 (Yes), 0 (No) true, false
pci_details_X_involved_structures_Y_name_fr Text Name of anatomical structure Y of region X (French) free text
pci_details_X_involved_structures_Y_name_en Text Name of anatomical structure Y of region X (English) free text
pci_details_X_involved_structures_Y_is_involved Boolean Anatomical structure Y involved in region X — 1 (Yes), 0 (No) true, false
pci_details_X_involved_structures_Y_diaphragm_score Numeric Diaphragmatic involvement score for structure Y (0 to 3) — applicable only to diaphragmatic structures 0 to 3, null

4. Resectability criteria & Fagotti

Column name Data type Description Possible values / Example
criteria_0_key Text Criteria category key (0 = non-resectability, 1 = lymph nodes, 2 = extra-peritoneal locations) non_resecability_reasons, abdominal_lymph_nodes, extra_peritoneal_locations
criteria_0_items_Y_name_fr Text Name of non-resectability criterion Y (French) free text
criteria_0_items_Y_name_en Text Name of non-resectability criterion Y (English) free text
criteria_0_items_Y_is_involved Boolean Non-resectability criterion Y present — 1 (Yes), 0 (No) true, false
criteria_0_items_Y_precision Text Precision or comment associated with criterion Y free text
criteria_1_items_Y_is_involved Boolean Lymph node Y involved — 1 (Yes), 0 (No) true, false
criteria_2_items_Y_is_involved Boolean Extra-peritoneal location Y involved — 1 (Yes), 0 (No) true, false
fagotti_details_X_key Text Fagotti criterion identifier omentalCake, peritonealCarcinomatosis, diaphragmaticCarcinomatosis, mesentericRetraction, bowelInfiltration, stomachInfiltration, liverMetastases
fagotti_details_X_name_fr Text Name of Fagotti criterion X (French) free text
fagotti_details_X_name_en Text Name of Fagotti criterion X (English) free text
fagotti_details_X_score Numeric Score of Fagotti criterion X — 0 or 2 0, 2
fagotti_modified_details_X_key Text Modified Fagotti criterion identifier diaphragmaticCarcinomatosis, mesentericRetraction, stomachInfiltration, liverMetastases
fagotti_modified_details_X_name_fr Text Name of Modified Fagotti criterion X (French) free text
fagotti_modified_details_X_name_en Text Name of Modified Fagotti criterion X (English) free text
fagotti_modified_details_X_score Numeric Score of Modified Fagotti criterion X — 0 or 2 0, 2

5. Operative report — Free text

Column name Data type Description Possible values / Example
operative_report_anamnesis Long text Relevant context, history and background (free text) free text
operative_report_remarks Long text End-of-procedure remarks and particularities (free text) free text

5. Operative report — Incision

Column name Data type Description Possible values / Example
operative_report_incision_approach Single choice (Radio) Main surgical approach — open (laparotomy), laparoscopy open, laparoscopy
operative_report_incision_robot_assisted Boolean Robotic assistance — 1 (Yes), 0 (No) true, false
operative_report_incision_pre_peritoneal Boolean Pre-peritoneal dissection performed — 1 (Yes), 0 (No) true, false
operative_report_incision_adhesiolysis Boolean Adhesiolysis performed — 1 (Yes), 0 (No) true, false
operative_report_incision_ascites_at_opening Boolean Ascites present on opening — 1 (Yes), 0 (No) true, false
operative_report_incision_ascites_quantity Numeric Quantity of ascites measured on opening (cc) numeric (cc)

5. Operative report — Visceral resections

Column name Data type Description Possible values / Example
operative_report_visceral_resections_organs_X_organ_key Text Organ X identifier (e.g. stomach, colon, liver...)
pancreas, spleen, gall_bladder, liver, stomach, right_diaphragmatic, left_diaphragmatic, appendix, ascending_colon, caecum, transverse_colon, descending_colon, sigmoid_colon, colon_global, rectum, kidneys, ureters, bladder, uterus_vagina, adnexa, male_reproductive, lungs, pleural, testicle
operative_report_visceral_resections_organs_X_label_fr Text Organ X name (French) free text
operative_report_visceral_resections_organs_X_label_en Text Organ X name (English) free text
operative_report_visceral_resections_organs_X_comment Text Free-text comment associated with organ X free text
operative_report_visceral_resections_organs_X_items_Y_key Text Procedure Y identifier for organ X
distal_pancreatectomy, pancreatectomie_totale, duodenopancreatectomie_cephalique, splenectomy, cholecystectomy, wedge_resection, multiple_wedge, segment_resection, right_hepatectomy, left_hepatectomy, radiofrequency_ablation, microwave_ablation, wedge_resection_stomach, distal_gastrectomy, subtotal_gastrectomy, total_gastrectomy, tendinous_right, muscle_right, tendinous_left, muscle_left, appendicectomy, right_hemicolectomy, caecectomy, partial_caecectomy, transverse_colectomy, segmental_resection_trans, extended_right_hemi, extended_left_hemi, left_hemicolectomy, sigmoid_colectomy, subtotal_colectomy, total_colectomy, anterior_resection, low_anterior_resection, abdomino_perineal, right_nephrectomy, right_partial_nephrectomy, left_nephrectomy, left_partial_nephrectomy, right_ureter_proximal, right_ureter_mid, right_ureter_distal, left_ureter_proximal, left_ureter_mid, left_ureter_distal, partial_cystectomy, total_cystectomy, total_hysterectomy, subtotal_hysterectomy, vaginectomy, right_oophorectomy, right_salpingectomy, left_oophorectomy, left_salpingectomy, bilateral_salpingo_ovariectomies, prostatectomy, right_seminal_vesicle, left_seminal_vesicle, right_spermatic_cord, left_spermatic_cord, solitary_wedge_right, solitary_wedge_left, multiple_wedge_right, multiple_wedge_left, right_diaphragmatic, right_anterior, right_lateral, right_apical, right_costophrenic, left_diaphragmatic, left_anterior, left_lateral, left_apical, left_costophrenic, right_testicle, left_testicle
operative_report_visceral_resections_organs_X_items_Y_label_fr Text French label of the visceral resection item free text
operative_report_visceral_resections_organs_X_items_Y_label_en Text English label of the visceral resection item free text
operative_report_visceral_resections_organs_X_items_Y_is_performed Boolean Procedure Y performed on organ X — 1 (Yes), 0 (No) true, false
operative_report_visceral_resections_organs_X_items_Y_segments Text Liver segments involved (e.g. "2,3,4b") — applicable to liver resections e.g. "2,3,4b"
operative_report_visceral_resections_organs_X_items_Y_sub_option Text Sub-option of procedure Y (e.g. anastomosis type, technical variant) free text
operative_report_visceral_resections_organs_X_items_Y_measure Numeric Size or measurement associated with resection Y (cm or mm depending on context)
operative_report_visceral_resections_organs_X_items_Y_lymph_dredging Boolean Lymph node dissection associated with procedure Y — 1 (Yes), 0 (No) true, false
operative_report_visceral_resections_organs_X_items_Y_comment Text Free-text comment associated with procedure Y of organ X free text
operative_report_visceral_resections_small_bowel_details JSON Small bowel resection details (length, mesentery, anastomosis, stoma...)
operative_report_visceral_resections_section_comments_c1 Text Comment for the supramesocolic visceral section (c1) free text
operative_report_visceral_resections_section_comments_c2 Text Comment for the inframesocolic visceral section (c2) free text
operative_report_visceral_resections_section_comments_c3 Text Comment for the urinary section (c3) free text
operative_report_visceral_resections_section_comments_c4 Text Comment for the genital organs section (c4) free text
operative_report_visceral_resections_section_comments_c5 Text Comment for the extra-abdominal section (c5) free text
operative_report_visceral_resections_section_comments_visceral_perito Text Comment for the visceral peritoneum section free text

5. Operative report — Abdominal wall

Column name Data type Description Possible values / Example
operative_report_abdominal_wall_X_category_key Text Parietal resection category X identifier scar, port_site, rectus_muscle, posterior_sheath
operative_report_abdominal_wall_X_label_fr Text Parietal resection category X name (French) free text
operative_report_abdominal_wall_X_label_en Text Parietal resection category X name (English) free text
operative_report_abdominal_wall_X_items_Y_key Text Parietal resection Y identifier in category X
midline, paramedian, subcostal, pfannenstiel, lateral, right, left
operative_report_abdominal_wall_X_items_Y_label_fr Text Parietal resection Y name (French) free text
operative_report_abdominal_wall_X_items_Y_label_en Text Parietal resection Y name (English) free text
operative_report_abdominal_wall_X_items_Y_is_resected Boolean Parietal resection Y performed — 1 (Yes), 0 (No) true, false
operative_report_abdominal_wall_X_items_Y_comment Text Details / comment of parietal resection Y free text

5. Operative report — Reconstruction

Column name Data type Description Possible values / Example
operative_report_reconstructive_anastomoses_X_type Text Anastomosis X type (e.g. ileo-colic, colorectal, esogastric...) free text
operative_report_reconstructive_anastomoses_X_method Single choice (Radio) Anastomosis X technique — manual, stapled manual, stapled
operative_report_reconstructive_stomas_X_type Text Stoma X type (e.g. ileostomy, colostomy...) free text
operative_report_reconstructive_stomas_X_duration Single choice (Radio) Stoma X nature — temporary, permanent temporary, permanent
operative_report_reconstructive_urinary_X_type Text Urinary reconstruction X type free text
operative_report_reconstructive_urinary_X_comment Text Free-text comment associated with urinary reconstruction X free text

5. Operative report — Peritonectomies

Column name Data type Description Possible values / Example
operative_report_peritonectomy_groups_X_category_key Text Peritonectomy group X identifier
right_antero_parietal, left_antero_parietal, right_upper_quadrant, left_upper_quadrant, ancillary, pelvic_peritonectomy, glisson_capsulectomy, greater_omentectomy, lesser_sac, mesocolic, small_bowel
operative_report_peritonectomy_groups_X_label_fr Text Peritonectomy group X name (French) free text
operative_report_peritonectomy_groups_X_label_en Text Peritonectomy group X name (English) free text
operative_report_peritonectomy_groups_X_items_Y_key Text Peritonectomy procedure Y identifier in group X
right_anterior_ventral, right_paracolic, left_anterior_ventral, left_paracolic, right_subphrenic, morrisons_pouch, winslow_anterior, winslow_posterior, left_subphrenic, falciform_ligament, umbilical_round_ligament, left_gastric_vessels, right_inguinal, left_inguinal, treitz, bladder, pouch_of_douglas, right_pararectal, left_pararectal, right_iliac_fossa, left_iliac_fossa, false_pelvis, right_lobe_total, right_lobe_subtotal, left_lobe_total, left_lobe_subtotal, left_caudate_lobe, infracolic, supracolic_arch_preserving, supracolic_gastroepiploic, gastrosplenic_ligament, lesser_omentectomy, hepatoduodenal_ligament, total_pancreatic, subpyloric_space, ascending, transverse, descending, sigmoid, partial_sb, subtotal_sb, total_sb, focal_atypical
operative_report_peritonectomy_groups_X_items_Y_label_fr Text Peritonectomy procedure Y name (French) free text
operative_report_peritonectomy_groups_X_items_Y_label_en Text Peritonectomy procedure Y name (English) free text
operative_report_peritonectomy_groups_X_items_Y_status Single choice (Radio) Peritonectomy procedure Y status — complete, partial, not_performed complete, partial, not_performed
operative_report_peritonectomy_comments_parietal Text Comment on anterior parietal peritonectomies free text
operative_report_peritonectomy_comments_pelvis Text Comment on pelvic peritonectomies free text
operative_report_peritonectomy_comments_glisson Text Comment on Glisson's capsulectomies free text
operative_report_peritonectomy_comments_meso Text Comment on mesenteric / mesocolic peritonectomies free text

5. Operative report — Nodules & visceral peritoneum (A7)

Column name Data type Description Possible values / Example
operative_report_visceral_peritoneum_nodules_groups_X_group_key Text Visceral peritoneum resection group X identifier resection_nodules, resection_peritoneum
operative_report_visceral_peritoneum_nodules_groups_X_label_fr Text Group X name (French) free text
operative_report_visceral_peritoneum_nodules_groups_X_label_en Text Group X name (English) free text
operative_report_visceral_peritoneum_nodules_groups_X_items_Y_key Text Procedure Y identifier in group X
nodule_parietal, nodule_liver, nodule_small_bowel, nodule_colon, nodule_spleen, nodule_gastric, nodule_wall, perito_stomach, perito_ascending, perito_rectosigmoid
operative_report_visceral_peritoneum_nodules_groups_X_items_Y_label_fr Text Procedure Y name (French) free text
operative_report_visceral_peritoneum_nodules_groups_X_items_Y_label_en Text Procedure Y name (English) free text
operative_report_visceral_peritoneum_nodules_groups_X_items_Y_is_selected Boolean Procedure Y selected in group X — 1 (Yes), 0 (No) true, false
operative_report_visceral_peritoneum_nodules_groups_X_items_Y_comment Text Precision / comment of procedure Y free text
operative_report_visceral_peritoneum_nodules_global_comment Text Global comment of the visceral peritoneum & nodules section (section A7) free text

5. Operative report — Lymphadenectomies

Column name Data type Description Possible values / Example
operative_report_lymphadenectomy_regions_X_region_key Text Lymph node region X identifier
right_pelvic, left_pelvic, retro_infra, retro_supra, celiac_axis, sup_mesenteric, porta_hepatis, omenta, left_gastric, splenic_hilum, para_cardiac, inguinal, supradiaphragmatic, mediastinal, cervical, axillary
operative_report_lymphadenectomy_regions_X_label_fr Text Lymph node region X name (French) free text
operative_report_lymphadenectomy_regions_X_label_en Text Lymph node region X name (English) free text
operative_report_lymphadenectomy_regions_X_items_Y_key Text Lymph node group Y identifier in region X
ext_iliac_r, int_iliac_r, obturator_r, common_iliac_r, ext_iliac_l, int_iliac_l, obturator_l, common_iliac_l, paraaortic, paracaval, interaortocaval, retrocaval, retro_supra_global, celiac_global, sup_mesenteric_global, common_bile_duct, common_hepatic_artery, hepatic_hilar, greater_omental, lesser_omental, left_gastric_global, splenic_hilum_global, para_cardiac_r, para_cardiac_l, inguinal_r, inguinal_l, cardiophrenic_r, cardiophrenic_l, subxiphoid, mediastinal_global, cervical_r, cervical_l, axillary_r, axillary_l
operative_report_lymphadenectomy_regions_X_items_Y_label_fr Text Lymph node group Y name (French) free text
operative_report_lymphadenectomy_regions_X_items_Y_label_en Text Lymph node group Y name (English) free text
operative_report_lymphadenectomy_regions_X_items_Y_enlarged Boolean Enlarged lymph node in group Y of region X — 1 (Yes), 0 (No) true, false
operative_report_lymphadenectomy_regions_X_items_Y_template Boolean Systematic (template) lymph node dissection performed in group Y — 1 (Yes), 0 (No) true, false
operative_report_lymphadenectomy_global_comment Text Global comment of the lymphadenectomy section free text

5. Operative report — Occult peritoneal spaces

Column name Data type Description Possible values / Example
operative_report_occult_spaces_groups_X_category_key Text Occult spaces category X identifier natural_spaces, tunnels, difficult_sites
operative_report_occult_spaces_groups_X_label_fr Text Category X name (French) free text
operative_report_occult_spaces_groups_X_label_en Text Category X name (English) free text
operative_report_occult_spaces_groups_X_items_Y_key Text Occult space Y identifier in category X
sup_paraduodenal, inf_paraduodenal, right_subhepatic, sup_recess_lesser, subpyloric, hepatocaval, liver_scissurae, inguinal_canal, hepatic_bridge, winslow, splenic_hilum, post_edge_spleen, ileocaecal, sigmoid_recess, small_bowel_folds, greater_omental, right_psoas
operative_report_occult_spaces_groups_X_items_Y_label_fr Text Occult space Y name (French) free text
operative_report_occult_spaces_groups_X_items_Y_label_en Text Occult space Y name (English) free text
operative_report_occult_spaces_groups_X_items_Y_status Single choice (Radio) Occult space Y check status — yes (involved), no (clear) yes, no
operative_report_occult_spaces_previous_planes_X_name Text Previous surgical plane X name (free text entered by the practitioner) free text
operative_report_occult_spaces_previous_planes_X_status Single choice (Radio) Previous surgical plane X status — yes (recurrence), no (clear) yes, no
operative_report_occult_spaces_global_comment Text Global comment of the occult peritoneal spaces section free text

5. Operative report — Drains

Column name Data type Description Possible values / Example
operative_report_drains_X_type Single choice (Radio) Drain X type — lame, redon, drain_plat, drain_aspiration, sonde, autre
blake, chest, kehr, lame, multi_perf, penrose, pezzer, redon
operative_report_drains_X_type_fr Text Drain X type label (French) free text
operative_report_drains_X_type_en Text Drain X type label (English) free text
operative_report_drains_X_location Single choice (Radio) Drain X location — right_subphrenic, left_subphrenic, pelvis, other...
right_thoracic, left_thoracic, right_hypochondrium, left_hypochondrium, stomach, pancreatic, subhepatic, right_flank, left_flank, lomboaortic, right_fossa, left_fossa, pelvic, subcutaneous, other
operative_report_drains_X_location_fr Text Drain X location label (French) free text
operative_report_drains_X_location_en Text Drain X location label (English) free text
operative_report_drains_X_location_other Text Location specification when location = "other" free text
operative_report_drains_X_comment Text Free-text comment associated with drain X free text

5. Operative report — Biopsies & cytologies

Column name Data type Description Possible values / Example
operative_report_biopsies_X_region Numeric Anatomical region (PCI 0-12) the biopsy X comes from 0 to 12
operative_report_biopsies_X_count Numeric Number of samples for biopsy X integer
operative_report_biopsies_cytologies_X_type Single choice (Radio) Cytological examination X type — on_ascites, on_lavage on_ascites, on_lavage
operative_report_biopsies_cytologies_X_comment Text Free-text comment associated with cytological examination X free text
operative_report_biopsies_laparo JSON Biopsies and cytologies performed during a laparoscopy — available only for laparoscopy-type evaluations {"cytologies": [{"type": "on_ascites", "comment": "..."}]}
operative_report_biopsies_laparo_cytologies_X_type Single choice (Radio) Cytological examination X type (laparo) — on_ascites, on_lavage on_ascites, on_lavage
operative_report_biopsies_laparo_cytologies_X_comment Text Free-text comment associated with cytological examination X (laparo) free text

5. Operative report — HIPEC

Column name Data type Description Possible values / Example
operative_report_hipec_performed Boolean HIPEC performed — 1 (Yes), 0 (No) true, false
operative_report_hipec_technique Single choice (Radio) Perfusion technique — open (open abdomen), closed (closed abdomen) open, closed
operative_report_hipec_protocol Text Selected HIPEC protocol code (e.g. oxaliplatin, folfox, cisplatindoxo...)
CHIP1, CHIP2, CHIP3, CHIP4, CHIP5, CHIP6, CHIP7, CHIP8
operative_report_hipec_protocol_label_fr Text Full HIPEC protocol label (French) free text
operative_report_hipec_protocol_label_en Text Full HIPEC protocol label (English) free text
operative_report_hipec_details_duration Numeric HIPEC perfusion duration in minutes numeric (minutes)
operative_report_hipec_details_temp Numeric HIPEC perfusion temperature in degrees Celsius numeric (°C)
operative_report_hipec_comment Text Free-text comment on the HIPEC free text

5. Operative report — PIPAC

Column name Data type Description Possible values / Example
operative_report_pipac_performed Boolean PIPAC performed — 1 (Yes), 0 (No) true, false
operative_report_pipac_protocol Text Selected PIPAC protocol code (pipac1, pipac2, pipac3...) pipac1, pipac2, pipac3, pipac4
operative_report_pipac_protocol_label_fr Text PIPAC protocol label (French) free text
operative_report_pipac_dose Numeric Total dose administered during the PIPAC numeric
operative_report_pipac_comment Text Free-text comment on the PIPAC free text

5. Operative report — Laparoscopy

Column name Data type Description Possible values / Example
operative_report_surgical_procedures_laparo JSON Surgical procedures performed during a laparoscopy (free structure) — available only for laparoscopy-type evaluations {"adhesiolysis": true, "...": "..."}
operative_report_planned_treatment_laparo JSON Treatment planned following the laparoscopy (multidisciplinary decision) — available only for laparoscopy-type evaluations {"decision": "neoadjuvant_chemo", "...": "..."}

5. Operative report — Complications

Column name Data type Description Possible values / Example
operative_report_complications_text Long text Description of intraoperative complications (free text) free text
operative_report_complications_blood_loss Numeric Intraoperative blood loss in cc numeric (cc)
v2.11 2026-06-08

Residual PCI for incomplete cytoreductions, Aletti Surgical Complexity Score for ovarian cancer, and formal documentation of file metadata.

  • scores.pci.residual.{applicable,total,max,regions_vector} — residual PCI after an incomplete cytoreduction (CC-1/2/3).
  • scores.aletti_total, scores.aletti_complexity_class, scores.aletti_complexity_label — Aletti SCS (ovarian cancer evaluations only).
  • aletti_details[] — per-category Aletti breakdown (ovarian cancer evaluations only).
  • meta.generated_at, meta.version, meta.language_codes — file metadata now formally documented in the codebook.
v2.10 2026-05-04

Laparoscopy (PIPAC) workflow fields and patient sex.

  • evaluation_meta.patient_sex, evaluation_meta.laparoscopy_chemo_name and related laparoscopy fields.
  • operative_report.biopsies_laparo, surgical_procedures_laparo, planned_treatment_laparo.
v2.0 2026-03-23

First versioned codebook of the structured surgery/imaging export.

  • Initial published structure: evaluation_meta, scores, pci_details, fagotti, criteria and the full operative_report tree.