Écrire des messages evenementsServeurEtatsPatient depuis des tables
Source:R/etat_patient.R
write_evenements_etat_patient.RdUn fichier par événement. evenements : patient, venue, intervention, et le repère :
date_observation, heure_observation (élément dateObservation), ou
recueil_id, recueil_date, recueil_heure, recueil_uf (élément recueil : date et
UF où les états ont été observés, le repère le plus précis) ; les colonnes-chemins
sont relatives à la racine du message (ex. igs2/@age). diagnostics : une ligne par
diagnostic, evt_id, type (dp, dr, da, ds, dd, fpc, mm, ae), code, et en option
date_action, action.
Usage
write_evenements_etat_patient(
evenements,
diagnostics = NULL,
entete = NULL,
out_dir,
filename = "{evt_id}.xml",
version = NULL,
xmlns = HPRIM_NS,
encoding = "UTF-8",
validate_xsd = "error",
colmap = NULL,
identifiant_egal_nom_fichier = TRUE,
fichier_ok = FALSE,
par_diagnostic = FALSE
)Arguments
- evenements, diagnostics
Tables.
- entete
Liste :
emetteur,destinataire, et en optionversion,mode_traitement,acquittement_attendu,commentaire,date_heure_production,emetteur_categorie,destinataire_categorie. Chaque clé peut aussi être une colonne deevenements(prioritaire).- out_dir
Dossier de sortie.
- filename
Gabarit (
"{evt_id}.xml") ou fonction ligne -> nom.- version
Version du schéma ; sinon
entete$versionou colonneversion, sinon 2.4.- xmlns
HPRIM_NS(défaut),NULL(pas de namespace) ou""(xmlns="").- encoding
Encodage des fichiers.
- validate_xsd
"error"(défaut),"warn"ouFALSE.- colmap
Renommage de colonnes
list(ancien = "nouveau").- identifiant_egal_nom_fichier
L'identifiantMessage est le nom du fichier sans extension (défaut) ; une colonne
identifiant_messagecontradictoire est une erreur.- fichier_ok
Dépose un
.okvide une fois chaque.xmlécrit intégralement.- par_diagnostic
Un message par diagnostic (unité atomique) au lieu d'un par événement. Le contexte (patient, venue, repère) est répété ;
evt_idvaut{evt_id}_{rang}, et le gabaritfilenamedispose aussi de{evt_origine}et{rang}.
Details
Le XSD impose un repère (intervention, dateObservation ou recueil) et un contenu exclusif :
diagnostics, ou IGS2, ou dépendances… En 2.4, un élément <divers/> est émis.
Unité atomique des états patient (pour les diagnostics) : le diagnostic, porteur de
l'attribut action et d'un identifiant. par_diagnostic = TRUE écrit un message par
diagnostic. L'IGS2, unique par message, est atomique par construction.
Examples
# Les exemples écrivent dans un dossier temporaire
ancien <- setwd(tempdir())
# IGS2 détaillé dans un message états patient (evenementsServeurEtatsPatient).
# Des mesures brutes (pires valeurs des 24 premières heures), on déduit pour chaque item
# la classe attendue par le XSD (attribut de <igs2>) et ses points, puis le score global.
# Un fichier par patient : l'élément <igs2> n'est pas répétable dans un message.
library(hprimxml)
library(tibble)
ts <- function(x) as.POSIXct(x, tz = "UTC")
entete <- list(
version = "2.00", # version HPRIM XML des messages
emetteur = "REA",
destinataire = "DIM",
date_heure_production = ts("2024-03-06 09:00:00")
)
# Pires valeurs des 24 premières heures, une ligne par patient
mesures <- tibble(
evt_id = c("IGS240001", "IGS240002"),
age = c(67, 82),
frequence_cardiaque = c(128, 105), # /min
pas = c(85, 210), # pression artérielle systolique, mmHg
temperature = c(38.2, 39.4), # °C
ventile = c(TRUE, FALSE), # ventilation mécanique ou CPAP
pao2_fio2 = c(180, NA), # mmHg, si ventilé
diurese = c(0.8, 1.6), # L/24 h
uree = c(18, 8), # mmol/L
leucocytes = c(14, 22), # 10³/mm³
kaliemie = c(4.1, 5.4), # mmol/L
natremie = c(132, 147), # mmol/L
hco3 = c(17, 22), # mmol/L
bilirubine = c(25, 110), # µmol/L
ictere = c(FALSE, TRUE), # la bilirubine ne compte que si ictère
glasgow = c(13, 15),
maladie_chronique = c("aucune", "cancerMetastatique"),
mode_admission = c("medecine", "chirUrgente")
)
# Barème IGS2 : attribut XSD -> mesure, bornes, points par classe XSD
# Source : grille et définitions de la SFAR, https://sfar.org/scores/igs2.php
# (Le Gall JR et coll., JAMA 1993; 270: 2957-2963). Recueil sur les 24 heures suivant
# l'admission : valeur la plus défavorable de chaque item ; Glasgow estimé avant sédation ;
# diurèse ramenée à 24 h si le séjour est plus court ; en cas d'arrêt cardiaque, FC 0,
# PAS 0 et Glasgow < 6. Unités : urée en mmol/L (seuils SFAR en g/L : 0,6 et 1,8),
# leucocytes en 10³/mm³, bilirubine en µmol/L (seuils en mg/L : 40 et 60).
# Les bornes sont fermées à gauche : 40 tombe dans « 40A59 ».
BAREME <- list(
age = list("age", c(40, 60, 70, 75, 80),
c(inferieurA40 = 0, `40A59` = 7, `60A69` = 12, `70A74` = 15, `75A79` = 16,
superieurEgalA80 = 18)),
frequenceCardiaque = list("frequence_cardiaque", c(40, 70, 120, 160),
c(inferieurA40 = 11, `40A69` = 2, `70A119` = 0, `120A159` = 4, superieurEgalA160 = 7)),
tensionArterielleSystolique = list("pas", c(70, 100, 200),
c(inferieurA70 = 13, `70A99` = 5, `100A199` = 0, superieurEgalA200 = 2)),
temperature = list("temperature", 39, c(inferieurA39 = 0, superieurEgalA39 = 3)),
paO2_FIO2 = list("pao2_fio2", c(100, 200), c(inferieurA100 = 11, `100A199` = 9, superieurEgalA200 = 6)),
diurese = list("diurese", c(0.5, 1), c(`inferieurA0,5` = 11, `0,5A0,999` = 4, superieurA1 = 0)),
ureeSanguine = list("uree", c(10, 30), c(inferieurA10 = 0, `10A29,9` = 6, superieurA30 = 10)),
leucocytes = list("leucocytes", c(1, 20), c(inferieurA1 = 12, `1A19,9` = 0, superieurEgalA20 = 3)),
kaliemie = list("kaliemie", c(3, 5), c(inferieurA3 = 3, `3A4,9` = 0, superieurEgalA5 = 3)),
natremie = list("natremie", c(125, 145), c(inferieurA125 = 5, `125A144` = 0, superieurEgalA145 = 1)),
HCO3 = list("hco3", c(15, 20), c(inferieurA15 = 6, `15A19` = 3, superieurEgalA20 = 0)),
bilirubine = list("bilirubine", c(68.4, 102.6),
c(`inferieurA68,4` = 0, `68,4A102,5` = 4, `superieurA102,6` = 9)),
scoreGlasgow = list("glasgow", c(6, 9, 11, 14),
c(inferieurA6 = 26, `6A8` = 13, `9A10` = 7, `11A13` = 5, `14A18` = 0))
)
POINTS_QUALITATIFS <- list(
maladieChronique = list("maladie_chronique",
c(aucune = 0, cancerMetastatique = 9, maladieHematologiqueMaligne = 10, sida = 17)),
modeAdmission = list("mode_admission", c(chirProgrammee = 0, medecine = 6, chirUrgente = 8))
)
# Classe d'une mesure : libelles[i] si bornes[i-1] <= mesure < bornes[i]
classer <- function(x, bornes, libelles) {
as.character(cut(x, c(-Inf, bornes, Inf), labels = libelles, right = FALSE))
}
igs2 <- mesures
for (attr in names(BAREME)) {
b <- BAREME[[attr]]
classe <- classer(mesures[[b[[1]]]], b[[2]], names(b[[3]]))
if (attr == "paO2_FIO2") classe <- ifelse(mesures$ventile, classe, "rien") # ni ventilé ni CPAP
if (attr == "bilirubine") classe <- ifelse(mesures$ictere, classe, "inferieurA68,4") # non ictérique
igs2[[attr]] <- classe
igs2[[paste0("points_", attr)]] <- as.integer(c(b[[3]], rien = 0)[classe])
}
for (attr in names(POINTS_QUALITATIFS)) {
q <- POINTS_QUALITATIFS[[attr]]
igs2[[attr]] <- mesures[[q[[1]]]]
igs2[[paste0("points_", attr)]] <- as.integer(q[[2]][mesures[[q[[1]]]]])
}
igs2$valeurGlobale <- as.integer(rowSums(igs2[grep("^points_", names(igs2))]))
attributs <- c(names(BAREME), names(POINTS_QUALITATIFS))
# Patient et venue, une ligne par message
evenements <- tibble(
evt_id = c("IGS240001", "IGS240002"),
ipp = c("190101337", "190101338"), sexe = c("M", "F"),
date_naissance = as.Date(c("1956-05-14", "1941-11-02")),
nda = c("240000123", "240000124"), venue_date_entree = as.Date("2024-03-05"),
# repère du message : le recueil, avec sa date et l'UF de réanimation où les états ont
# été observés (le récepteur retrouve ainsi le RUM, même un jour de mutation)
recueil_id = c("REC240001", "REC240002"),
recueil_date = as.Date("2024-03-06"),
recueil_uf = "4501"
)
# L'IGS2 passe par des colonnes-chemins relatives à la racine du message
evenements$`igs2/@action` <- "creation"
for (a in attributs) evenements[[paste0("igs2/@", a)]] <- igs2[[a]]
evenements$`igs2/dateAction` <- ts("2024-03-06 08:00:00")
evenements$`igs2/valeurGlobale` <- igs2$valeurGlobale
fichiers <- write_evenements_etat_patient(
evenements, NULL, # pas de table de diagnostics ici
entete = entete,
out_dir = "sortie/igs2", # -> sortie/igs2/IGS240001.xml, IGS240002.xml
xmlns = NULL
)
# Contrôle : une ligne par item, avec la classe et les points de chaque patient
controle <- tibble(item = attributs)
for (i in seq_len(nrow(igs2))) {
controle[[paste0("classe_", igs2$evt_id[i])]] <- unlist(igs2[i, attributs])
}
for (i in seq_len(nrow(igs2))) {
controle[[paste0("points_", igs2$evt_id[i])]] <- unlist(igs2[i, paste0("points_", attributs)])
}
# Régénère data/xml_tests/etat_patient/00001.xml : diagnostics DP et DR.
library(hprimxml)
library(tibble)
ts <- function(x) as.POSIXct(x, tz = "UTC")
entete <- list(
version = "2.00", # version HPRIM XML des messages
emetteur = "TEST",
destinataire = NULL,
acquittement_attendu = "non",
commentaire = "HPRIM-TEST",
date_heure_production = ts("2024-01-01 01:01:01")
)
# Une ligne par événement : patient, venue, intervention
# (ici, les colonnes-chemins sont relatives à la racine du message)
evenements <- tibble(
evt_id = "00001_esep",
ipp = "123456789", ipp_recepteur = "123456789",
sexe = "M", nom_usuel = "SANDWICK", prenom = "JOHN",
date_naissance = as.Date("1970-01-01"),
nda = "987654321", nda_recepteur = "987654321",
venue_date_entree = as.Date("2024-01-01"), venue_heure_entree = hms::as_hms("08:00:00"),
venue_uf_responsable = "4321",
intervention_id = "000000000001", intervention_uf = "4321",
`patient/@confidentiel` = "non", `venue/@prive` = "non",
`patient/identifiant/emetteur/@etat` = "permanent",
`patient/identifiant/emetteur/@portee` = "local",
`patient/identifiant/emetteur/@referent` = "non",
`patient/identifiant/recepteur/@etat` = "permanent",
`patient/identifiant/recepteur/@portee` = "local",
`patient/identifiant/recepteur/@referent` = "non"
)
# Une ligne par diagnostic ; type dans dp, dr, da, ds, dd, fpc, mm, ae
diagnostics <- tibble(
evt_id = "00001_esep",
type = c("dp", "dr"),
code = c("Z511", "C10"),
date_action = ts("2024-01-01 08:10:00")
)
fichiers <- write_evenements_etat_patient(
evenements, diagnostics,
entete = entete,
out_dir = "sortie/etat_patient", # -> sortie/etat_patient/00001_esep.xml
validate_xsd = "warn"
)
#> Warning: XML non conforme au XSD :
#> Element '{http://www.hprim.org/hprimXML}agent': Missing child element(s). Expected is ( {http://www.hprim.org/hprimXML}code ).
# IGS2 : classe et points de chaque item, par patient
print(controle, width = Inf)
#> # A tibble: 15 × 5
#> item classe_IGS240001 classe_IGS240002
#> <chr> <chr> <chr>
#> 1 age 60A69 superieurEgalA80
#> 2 frequenceCardiaque 120A159 70A119
#> 3 tensionArterielleSystolique 70A99 superieurEgalA200
#> 4 temperature inferieurA39 superieurEgalA39
#> 5 paO2_FIO2 100A199 rien
#> 6 diurese 0,5A0,999 superieurA1
#> 7 ureeSanguine 10A29,9 inferieurA10
#> 8 leucocytes 1A19,9 superieurEgalA20
#> 9 kaliemie 3A4,9 superieurEgalA5
#> 10 natremie 125A144 superieurEgalA145
#> 11 HCO3 15A19 superieurEgalA20
#> 12 bilirubine inferieurA68,4 superieurA102,6
#> 13 scoreGlasgow 11A13 14A18
#> 14 maladieChronique aucune cancerMetastatique
#> 15 modeAdmission medecine chirUrgente
#> points_IGS240001 points_IGS240002
#> <int> <int>
#> 1 12 18
#> 2 4 0
#> 3 5 2
#> 4 0 3
#> 5 9 0
#> 6 4 0
#> 7 6 0
#> 8 0 3
#> 9 0 3
#> 10 0 1
#> 11 3 0
#> 12 0 9
#> 13 5 0
#> 14 0 9
#> 15 6 8
igs2$valeurGlobale
#> [1] 54 56
setwd(ancien)