From 4b228bd11327aeb211310b5f9d89da79cb83acf2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Sun, 17 Mar 2024 21:57:30 +0100 Subject: [PATCH 01/52] docs: :sparkles: init overview of functions to create osdc population --- vignettes/images/functions-overall.png | Bin 0 -> 71796 bytes vignettes/images/functions-overall.puml | 104 ++++++++++++++++++++++++ 2 files changed, 104 insertions(+) create mode 100644 vignettes/images/functions-overall.png create mode 100644 vignettes/images/functions-overall.puml diff --git a/vignettes/images/functions-overall.png b/vignettes/images/functions-overall.png new file mode 100644 index 0000000000000000000000000000000000000000..a2032a95ca845d3d325382619b4a678175d8885d GIT binary patch literal 71796 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%0ALI!Vs}>;ycDRRj8d>OPS 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 data.table; +:**Inclusion Criteria** + +**HbA1c Tests (=>48 mmol/mol) (RLRR)** + - Function: include_hba1c_tests_over_threshold( + data: data.table, threshold: int = 48) -> data.table + +**Purchase of Glucose Lowering Drugs (GLDs) (Lægemiddelsdatabasen)**: + - Function: include_gld_purchases(data: data.table) -> data.table + +**Hospital Diagnosis of Diabetes (DNPR) ** + - Function: include_diabetes_diagnoses(data: data.table) -> data.table + - include_diabetes_diagnoses_icd_10(data: data.table) -> data.table + - include_diabetes_diagnoses_icd_8(data: data.table) -> data.table + +**Health Services (Diabetes-specific Podiatrist Services)** + - Function: include_podiatrist_services(data: data.table) -> data.table + - placeholder helper functions; + +:**Exclusion Criteria** + +**HbA1c and GLD: Events during pregnancies (potential GDM) (DNPR)** + - Function: exclude_events_during_pregnancy_windows(data: data.table) -> data.table + - extract_pregnancy_index_dates(data: data.table) + -> data.table + - calculate_pregnancy_index_date_for_mc_visits_wo_end_dates( + data.table) -> data.table + - extract_pregnancy_end_dates(data: data.table) -> data.table + - extract_maternal_care_visit_dates_without_end( + data: data.table) -> data.table + +**GLD: Metformin purchase for women below age 40 (potential PCOS)** + - Functions: exclude_potential_pcos(data: data.table, + sex: str = "F", age: int = 40) -> data.table + +**Weight Loss Drugs: Purchase of brand drugs for weight loss, e.g., Saxenda.** +'GLD only? + - Function: exclude_weight_loss_drugs(data: data.table) -> data.table; + +:**Classification Date:** + - Functions: + - join_inclusion_events(data: list[data.table]) -> data.table + - extract_second_inclusion_event_date(data: data.table) -> data.table; + +#darkgrey:**Classify Diabetes Type** +User-Facing Function: classify_diabetes_type(data: data.table) -> data.table; + + +:**Type 2 Diabetes** + +**Inclusion Criteria:** + +**Any purchases of Non-Insulin GLDs** +- Function: include_any_non_insulin_gld_purchases(data: data.table) -> data.table + +**Most recent type-specific diabetes diagnosis is hospital diagnosis of type 2 diabetes** +- Function: include_latest_diabetes_diagnosis_is_type_2(data: data.table) -> data.table + +**Exclusion Criteria:** + +**Women that have purchased only metformin and have any diagnoses of PCOS or have** +**purchases of clomifene or combination drugs containing antiandrogens and oestrogens** +- Functions: + - exclude_women_with_only_metformin_purchases(data: data.table) -> data.table + - exclude_women_with_psoc_diagnoses(data: data.table) -> data.table + - exclude_women_with_combination_drug_purchases(data: data.table) -> data.table + +**No recorded inclusion events in the last 10 years prior to the most recent date** +**available for the individual (index date)** +; + +:**Type 1 Diabetes** + +**Inclusion Criteria:** + +**Any purchases of insulin drugs.** + +**A hospital diagnosis of type 1 diabetes as the most recent** + +**type-specific diabetes diagnosis.** + +**Exclusion criteria:** + +**Women with any diagnoses of gestational diabetes mellitus, who have purchased** +**glucose-lowering drugs only in the period from 280 days prior to their first** +**diagnosis of gestational diabetes mellitus until 280 days after their last diagnosis.** + +**No purchases of glucose-lowering drugs or only one purchase and no hospital records of** +**type 1 diabetes.** + +**No insulin drug purchases in the last 10 years prior to the index date.** +; + +#palegreen:OSDC Population Created; +kill + +'Do we want to support export? (e.g. to csv, parquet, SASS?) + +@enduml From 0f6856dab4f333936a33baabfc87a4baa278e1c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Sun, 17 Mar 2024 22:08:31 +0100 Subject: [PATCH 02/52] docs: alternative visualisation of functions used for extracting diabetes population --- .../images/diabetes-population-functions.png | Bin 0 -> 90686 bytes .../images/diabetes-population-functions.puml | 70 ++++++++++++++++++ 2 files changed, 70 insertions(+) create mode 100644 vignettes/images/diabetes-population-functions.png create mode 100644 vignettes/images/diabetes-population-functions.puml diff --git a/vignettes/images/diabetes-population-functions.png b/vignettes/images/diabetes-population-functions.png new file mode 100644 index 0000000000000000000000000000000000000000..ced3a53f08a7850d97fd1b16fac5397c579657a3 GIT binary patch literal 90686 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�K?WojVz9LR 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¿z{{z=r`oOOd{SIi8FBlM1 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 WFDagZ6W57P&Wg*3rJTBa{r>@GOdEOt literal 0 HcmV?d00001 diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/diabetes-population-functions.puml new file mode 100644 index 0000000..c54476d --- /dev/null +++ b/vignettes/images/diabetes-population-functions.puml @@ -0,0 +1,70 @@ +@startuml diabetes-population-functions + +title Functions for Extracting a Diabetes Population Using OSDC + +' :Based on the following five data sources: +' - Lægemiddelsdatabasen / Medicine DB (not correct name) +' - Landspatient Registeret (LPR) (2 and 3) +' - Register of Laboratory Results for Research (RLRR) / Laboratoriedatabasens Forskertabel +' - Health Service Register / Sygesikringsregisteret +' - BEF: CPR-registerets befolkningstabel; + +#darkgrey:**Extract Diabetes Population** +User-Facing Function: extract_diabetes_population(index_date: date, data_sources: list[data.table]) -> data.table; + +switch (Extract Dates of Inclusion Events) +case ( Dates of\n HbA1c Tests) + :**Include Events of HbA1c Tests =>48 mmol/mol** + - Data Source: RLRR + - include_hba1c_tests_over_threshold(data: data.table, + threshold: int = 48) -> data.table; + :**Exclude Tests During Pregnancy** + - Data Source: DNPR + - exclude_events_during_pregnancy_windows( + data: data.table) -> data.table + - extract_pregnancy_index_dates(data: data.table) + -> data.table + - calculate_pregnancy_index_date_for_mc_visits_wo_end_dates( + data.table) -> data.table + - extract_pregnancy_end_dates(data: data.table) -> data.table + - extract_maternal_care_visit_dates_without_end( + data: data.table) -> data.table + + For further explanation, see functions-exclusion-pregnancy.puml; +case ( Dates of\n GLD Purchases) + :**Include Events of GLD Purchases** + - Data Source: Lægemiddelsdatabasen + - extract_gld_purchases(data: data.table) -> data.table; + :**Exclude Purchases During Pregnancy** + - Data Source: DNPR + - Functions: Same as for HbA1c Tests; + :**Exclude Women <40 Purchasing Metformin** + - Data Source: BEF + - exclude_potential_pcos(data: data.table, sex: str = "F", + age: int = 40) -> data.table; + :**Exclude Purchases of Brand Drugs for Weight Loss** + - exclude_weight_loss_drugs(data: data.table) -> data.table;; + +case ( Dates of\n Diabetes Diagnosis) + :**Include Hospital Diagnoses of Diabetes** + - Data Source: DNPR (Hospital Contacts) + - extract_diabetes_diagnoses_icd_10(data: data.table) + -> data.table + - extract_diabetes_diagnoses_icd_8(data: data.table) + -> data.table; + +case ( Dates of\n Diabetes-Specific Podiatrist Services) + :**Include Diabetes-Specific Podiatrist Services** + - Data Source: Health Service Register + - extract_diabetes_specific_podiatrist_services(data: data.table) + -> data.table; +endswitch + +:**Join Inclusion Events** +- join_inclusion_events(data: list[data.table]) -> data.table; +:**Extract Diagnosis Classification Date** +- extract_second_inclusion_event_date(data: data.table) -> data.table; + +center footer \n DNPR = The Danish National Patient Registry; GDM = Gestational Diabetes Mellitus; GLD = Glucose Lowering Drug;\nPCOS = Polycystic Ovary Syndrome; ICD = International Classification of Diseases; RLRR = Register of Laboratory Results for Research; + +@enduml \ No newline at end of file From abdb47784f0fdea1271e9c9c66ee6ffd108b384b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Sun, 17 Mar 2024 22:10:13 +0100 Subject: [PATCH 03/52] docs: flow chart expanding on exclusion based on pregnancy window --- .../functions-exclusion-pregnancy-window.png | Bin 0 -> 39622 bytes .../functions-exclusion-pregnancy-window.puml | 21 ++++++++++++++++++ 2 files changed, 21 insertions(+) create mode 100644 vignettes/images/functions-exclusion-pregnancy-window.png create mode 100644 vignettes/images/functions-exclusion-pregnancy-window.puml diff --git a/vignettes/images/functions-exclusion-pregnancy-window.png b/vignettes/images/functions-exclusion-pregnancy-window.png new file mode 100644 index 0000000000000000000000000000000000000000..44982e5b63cbe6359f9332bc73b00bcfa6a33f62 GIT binary patch literal 39622 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 Exclude Event During Pregnancy\nData Source: DNPR; +#darkgrey:**exclude_events_during_pregnancy_windows(data: data.table) -> data.table**; +:**extract_pregnancy_index_dates(data: data.table) -> data.table** +- This function will extract pregnancy index dates using diagnoses (ICD 8 and 10?) from DNPR; + +:**Helper function: extract_pregnancy_end_dates(data: data.table) -> data.table** +- This might be removed with the inclusion of birth register; + +:**Helper function: extract_maternal_care_visit_dates_without_end(data: data.table) -> data.table** +- Extract mc visits with end date (visits between 40 weeks before end date to 12 weeks after end date) +- Use these to identify mc visits without end dates to be used in the function below; + +:**Helper function: calculate_pregnancy_index_date_based_mc_visits_wo_end_dates(data.table) -> data.table**; +stop + +@enduml \ No newline at end of file From 7d24d9c4aaccc02739c09171d43cf3b0b49f7ac9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 22 Mar 2024 16:10:10 +0100 Subject: [PATCH 04/52] docs: simplify functionality flow of d population to only include function names --- .../images/diabetes-population-functions.png | Bin 90686 -> 36860 bytes .../images/diabetes-population-functions.puml | 70 ++++-------------- 2 files changed, 14 insertions(+), 56 deletions(-) diff --git a/vignettes/images/diabetes-population-functions.png b/vignettes/images/diabetes-population-functions.png index ced3a53f08a7850d97fd1b16fac5397c579657a3..72473cb04206064143431104dd9c8a468b39e5d5 100644 GIT binary patch literal 36860 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 lj^%4#NN{k0N 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 VzUQiM#4vG*g6u(=l>Nr%{}-p*qp1J@ literal 90686 zcmdSBby!vH_BOguF;GDiP^6I(5L85@5m36jmF})ZD<~ie2rfDl0qI6cK%`r`7Tqn~ z@QsCgfA9Xz{+;vZxz6!=FJGK%%{iYKagTf45B{>!B3E&4;~)@-t74+U@(9HFHweU; z!;5F&N@^w3Mfe}1{WDd2Ju7RZxq+cQLd3w*!1krRfj*@!lG51T-rA0fmDSq(rKP=t zg*l6!m4#zl69oc+eZfRg)&Aet5m@jX=a^;HA?Z6J*WBZ?87#i{!BMu!P(9K;m#|TAJ5a zJHA{satRZk@lhUUP(t&oUOYn|BRr?5^L+4UV>#RVk)B((3NB;+&L;TzVXL6|X&K=; zenI;dW;%h<;d5fIKJB-4iRcCf->?6<&~06S|G@Y6(d_C2>1QFI3*xwFOt8y-R|{Kz zxi(lYt1yVwS4Zjexu0OMgh9bS7XQ2=Zk9E3hLAU|>F}`}TH1y_%4xJRP_D}f8@%6a0si*76LR;l|4W!`2~>CLj&xCGKU-tcxzFp%G9 z6UNgVd@D)xS=V3mgLja%bHRi=*4`AKZ;X)nH@>0Y-wGI$cXfH2w!=OAuiLHNVhft2 z2@Ntza+7Qgo#WPE^5T7VcuuK`P#LMisBSovwX4N?^wy}`hOUH_L^J(<^0EInp18|Q z4ZhrDU&V10P`bM^DdF!%7WY0SzSn&?)A9oMUY{_P!;M(3?1Q^M!msFObRXRpzuNj( zD9kV5 z6AKLo<*s0(e!X8*3U^;wxs%f-8}B*i#_$$FqStfiYK3>1cA%0`rONm0>bn+_Q}hVPv|7VNX_o#p-l;Ni2yrwru0{p8vg=xf zs8bXhS-zg-DSU&)*wZOse)+7GLv*rQMWDBrTk&tfO!Jq&ZvWB|_J1aJcU$`9RL_T# zU7SXytLhxJm_|TqcYuN z(Nkw{kLl@lrSH}_Y%;Gy3U8A|D7LmPiBi3CB26Oj zZU6LQkaF|SN$f`ShMk>E1(i3CHZP+!i+*-3K3y&ty?4AP5zbUAazz0zi(E5@(>wjs+o@0Q zc5L4+BpkW!VM%vu-pVv4C>xtFvugaa@zR-jU73=#V*B;uz*{frFG;`2sKZxV^$~d* zo@x_yRZ(5!o|H@LYh&**owvN19N+Xf^AHFxgqZMCMQ81$VW${^XZyQrRI|mD&DU=d zJblecCHB*2;uXE_lczPiY%k9E+`y8{^YgT4*z7#BdaWQ0K4axdZgwH?R?#WQgx1DZ6vFh-# zv2FD01@$DEzQ794%5<uxsO_XJSg1jC_b)l{We<`))C`K)$(qmSq_0?0HecljEblY#r8~$ChY@So;<9 zK*m{wzylRyr?Uuzu=r1*JPrMsl+CX}e2jPn?55o*YWapcE5jTXgNaO)C&vfnt~+fl zEzBxe=nfHzBUp)f<*1=d=l%I_LxpDFMyhQ)#poN8S>)M|9QXHT<9C*aiad_?^XiwD z%#kmS>-mqr3`K1RQHD3YFB?sg2#<4~@JBH!bxKJZswBe~#VT5Uu2!C~M6d5O+zI*= zBf(m}88p25bs@c=EL$v;uGV%m?v8@X-gLO<&ajiq%|@w0@dK%3)tnbkyOO001OvGi zQeg2SEwr$z*-B#V7ki~_XIdgB)vB^Jl%$^1>V@JrJ(+Ef&(`qwJl=@cDs#+)rRzyk z8v1T=P;)~j;%Z^>)()MA)_f}-|Do(-jRNB@b`#oq9wPc%=F_T4aiPfz#&K6CaaqSq zAE*tNMq(+LDhHHx{RyAz&(%ws+h5G)U^^K-Iq(d*`^+@|srUK361!RH{JvZ2ofz}9OZfE^oQNlD z`gTbxVS%0DC?axQSMDgi_5J%R1Li$xJwIQaRmsvc$-G+@s}Y`c+e<&n0pe-xLA)sf z@s4CG*relGk~qqiDSBQ-$6d+73Pc2K6voMt}_1j2_!2@m^yY7cI;8+=tdu~|4 zFk7NLxRqAv4!~gXXGqF2Uiu8IMq5>+E|w{h1u&{tdboqlnDwO5`rl?ZRZLg5sD69Z zF#V|9r@zmt@`#S`_G9yu$DwhisO{*MP#Hc>LuQtSjM8#s-diIZ?tv0JqZZWyTP6nO zqO>SJoseKD;{3s--(S4VE5M~qHx{!i!&(hnqarPo)GuXG9GB*~9FKY9>DC=g{?Y_n zB)Gh$`$&SYU5t$>g7f9uS*Jo(G@06|Eh?B)#?smQhq3Btzq7TqZE1nwJPtdM@-(#@ z$TKK3>r;+RA&Z4wv3-ytUu3t~iSjXD87ypuD1cxdIZ-@|kVO~cMXEE`T=zO&phadq zmN-i;)oN-P$U`EbPX423#%a|3CL4K#l2m2vce6fei>8sFClh`UTin)aZ>BXEJVujP zR#qPGr)RC^aTPRtt@zZNA}4grqEn$cTb9YQvo-%MetV&ZiH%L+h|-*Sr^_#mVLnya zq_Po$tYJ&!H7(Oix8iD-_3H!4LKITvX^R8}icGt1Yd?Sfc2Lnyx8r91pyK@ft!f>W zv?y__fxO!NLUR03-A8(OYJ$md6iA1pumBJt=2uQY4QCFC&g zMhn|bEqghLJc?FEu?}I3w%kQ5!(J-X2*mGyJhQO>RXXFkqPemoNfhTohdsnWLu}gO zFNF-BNAPd_nYqhmwAh<@w7;dGb0%rdX{R_N>-umuQ*m33|Ba+aOiU8TffW4OFljVt zM}@m<<-zu{X_xNy z*K>V%o?7!bxoA{IZ>EM!^kbh}Tp~;<=;3ugCI)TYyXHGWaPv%I) z>fZ}pgjs8_Ezi){`@h}$kv3m6>QS~*x|mo1S&XrM8C_~mi$A%MhCtLz9?7sH5Vao; zf>TlVG?d?Y9IlBJ?hTq{N1}$`8cNT$#nP7BPK)QimQN7&_j=pwJJbDbn zU2f46eV4t=!Rh7Sb>O`au>Zs~Q@yY|d8ou;e%%!pf$$msXa1?IJ-2yXHZf6lrEE1# z2fGKe1c5v>;jB6pa$lcA>_bCV_|wL{8soZBk|tU%vIL28-8`j2@i;M5dN9u*U|-pF zM`GGRh-nt$vSz707`w+l1QwpXsnC$oLNk^8yv7B_j-%4Ug@z?Ew?9?#n}4eDnrD8! zxlDVHb75%0+enCe+~)?3!l317#nC4P=?9B6yge&{Eu>opdt}^>p9cI64EC_9^XC#U z0Aj0G15$EWD^vE5&deN+91Yat_HgqowfyI(ip@?5gXXZ-wzjawy|sFZzDx}cy}I{$ zft=4#rCrxGG0`{hH{s0f4eo?LtaV;uc6ey!t86^Ozu82hd60Pov5tc#6rP7`kQSId z4eDq_)|K9P{j;D=TfG(T2N2z5A|Fl}(&l@f9541|hg(h~PPU6G9p*c0PjSfX-`$YpO2Fu1>?&hEO%yu$%Y)d3Aw2XMu(Twjm=1`!dlZi$O)hN!Yje2YSz2 z_HfwlIXlxSDJBSCnpbX9Y>(rGRRi!TegUl5Znh1TE2c6qFt9%>i{cn@{wfkgPE1S; zJHxv><_&&+0H7hA+DZNOqHkqZ2A`Hq_JhhhI48PSA|CDhY~38WR^1gH$C>O);h|a@ z(h^~readgP%Sj=2_)mrQqBF9_3E(NMe};GFcw0T8@=+ktU;t!yO93< zF_YArpZ^yw3iy~07R&>LCVOH%_5pV09s(gSa^=?jF^FR1JkEbwBH4mm`Uw^Q zrzM8dE~|7Q?ViT>{vBE<4PWx&B5+zE8q!NfycoR$4jKao9*ETFdK20!fcp^Wv-Ph0&%wr)|ucnVBV{wPkvXho<|@=zrbiJAx>;t z;2=JaN#%z0$)jJr8ym4a)ZJ)MlrhD`m1cNhdk3ib;K)w;wAKPS@H#A*^ z^@4=<-AWlq#P={~(ZX+WE(>3L$@8pyF;7@IK3I+Cb1!wzhbO!^eS%cP{g;47wwLe2 z6JFkWWE}h-AATTatE<3gQP(Y5(uC^nnOLW9jJ*&7F;Ti!N3tAEh!DWigVm5N6NKwZkE8r{K3B-L%Bgb08V#mlQ|j2VWOcT9^mpz| z7IaBRb30{e-HrDl{h`s?iiM!8)N~ql*lvYY@WQM@>SNm}(SzsxAAj#l2%>~=Rusae zqaSC&bD;`sZfTL+lvsQ1G)`ZljAie8nTUC}EB=^fzAct}2(>QOQ01F(9wAUMMz4%T zxuqI()=N>sg?9xK0y7}}eT!Zyp|_%?7DM0Dl9Nqc47caI=)(?Jau#~hogfan-R!^0 zfwulrbwMRVHCH;8t54JJgOOb*%CqCy%|^q%EG=G%qwTWngOgOvl67LEm|WuyYNY}w zewnh06JA!og%PH!WRE0;Ycp~xhxS)!?J5yDjUbHzi0(}lGb*Lo*WimdA7^9^^eheJ z(`pr(Diz*6+Fb0D*;nM%v2CO+HL|I9!7*4Kyh<8xQXyv@9Qc}^P zP5Kt=7}d1emmO~od13~P!*lG_1!)M{!`_x=x#Hg>BdMdI@chHPHI$u3R~F6d`uz~K z3AJSQyZxP2)@U*=`{1>BsJcTc4%eGol^My3Y-70`^zFuezLI}r-k+nKsUCTiFkh&U zoIW(;F$7qq=;2a_t~)=bLL^$0!OLZTATd286$D-mI6GY(aP2? zKPpEc#@=8InHL<2vgcQJeWcwR4+75 zZS}_G5`Bzu^j@2TM`}r66@JqdRL%K{`P=DfynlY44GF6Z$qWC0IAfI&nZ~`BS{^JtKFHWfa+x*E@-qf zY{4;5Aq2Sx|FWn*8+WN#2i`#UK)`@8)VsiA1DQSOM-> zDAuy2Jiw2sEnE%@bA*zimb7O>h3#>VJ*(r`@i*L8Dj zgck*75&t?tbF&K?rJ_yTd?b)`h$?8ZXDZ`_iX<$i%KHMVdV%rC52WFnAC>$ouP?Ls z?YVhs{`629+_-0GD!SmVO_YCu_Vaot+Nm4@M6%QBh&*_5HOuybtb#;5)~fIZ=?`@s zh0%GsuMZD6y8iEm0Dfq>zc~-UKTY9VAk9>EVh_E1x?(Cd3hXYythANw;X|6)Y|o=b zh``<9f%7=~2b1K^V4)Olf4UW9v=(~4iE->4x+~>xcpaq`=r1IUl)I)=ZxNb+KgU9D zcu&lB9+$NL2hvVy3YYowI=%=gRX(rP$Pd8ZOpasGIP7+!VH@rI{7{rxxcKC;DiPdw z-a>YgSQfv8a0Ql(89x@=B>7jh+fIscnFz!mOoB`#hYS>KI^H)a8G=OH)T3Y%*()al zxoPfkO4xb+{tPIoG|JL)v&g>25C6k$c6kb^9{YJOth2a$yJI+ni~!5EA;w9R?>|aC z1nNyZ^!(M^G49(C&D+0=D{;N3G?WG}2T$C5bNS|ibQaWbVB+E@Q0a2dMCffMB5_-? z*K=N0V`zg|2u^D`)wm>VhVLyC)U+ar?x}Z|Ijw?)0Tb~U2r-#>zPL(#)2kl9$9*8- zzJ3Q%{Zf_M*)*1kBot+WQ}O zR1IP}1JMUTK#WNx3#TSuhXD|Nxc@v3BGcU)$5L+NX31X_$%la;OZPCQy@dUs?e!d+ zK*xxdK4A?Hfp9$4-tr*pXnSrw`B1tFD>ugp4Og7oRFPTbVex-NxE7ZfSBd4BDY+#9 zN1Ka{g?Ur%w>&aN){8cLrY5s)EQ|LA4c)iImPpvTtb*>C>Faq2U=%D&5~?)|x{~?Wk|NTs;L8VmVcCqsN{)8Ye4Q>M(6@+N^h+2O`C~%OlTYZqGNw zL9v7~4RjtohwGENn4}kUnqcQL>Ic-`d>MNyXU$8`NFfqptTMjno1IFdUTIxRW`V|` z+M4hBCK1l!XlcC1enkPzH>oTtiXNHx*WV1c1<8{k?{%Dc_owX``7#%>n$n zJ6ngJjh>>GOy+-&slN6f^FwL|0jH!2Tuw7=Gepb9tTJf>7PY)Y@JR6GEXC9i9uJo@;OdbdKgt0rMtv1AuXo37DE(-C8hQOCaVLJv$PfVVF4JQk2SFwvLYu z(j|wzX|hUYqV~5I!;;EK++IRR#F{6oFT2R z2!Sp%3LX*aW4?eB7kjW4v+>ws@Cq51qS7rsw_Q0AvT4ri8;L&gc128m5ZPpSw-lY) z9DZ3j$v<6?NQcdefnujKsA-2s(upRnCv0Cci>0#sLJV{Jes7BpkK2y5J@pGjoQeeG zxwlt{6FSq>t=%g(ra9wRdXhScD*1%S%Vx9ACiboHq$AgV*q_bvJ-Ua-vpN$n>@LT; z6_3@9wfkTv<+`Pv)8m$XiOU|A)g1n{uCETHqSQo)fwui&-9j2JDF?+v{d;1)n@`@= z5g`9#%XzZuds5^klcOy|W`6<^8f)Jv#<(#Nz-kHnm;25z2VkA;<)L_oUbWJm2lb?1 z`FV|Oov46^at6%W9?$Oyxfp6u7bxhJD$u zu&ubfo3bd+HqKd6n;QHs+r}FoXUVJe>xSk2{K=3)l0)^db+$zPyEzibXUu}T23n`K z#{`jZWC4jAVB1)o!y|sr!6ipp+}3VI1Xm<*rRoBOqKJ`ntoZJ-G-JwJ!Rz}H;XHU< zOZSVTW~Ud{hg^R)u4k-D7osjcaYN-iK6`!)S*Vz)?ojuhm@zXAyKjeECvIaN=}>aG ze+9V|SLT>*f?dGPk3`4nu!qkkky!ICSs}-e96C#JtfrO3e@MMX)$YTBQ$aaXe{fi_`uYGk~9%Q_inJgV!S{X;>NLl7Q-wAYYQ-vZI8(Wuq zWrQW|CFBpqc_`hAfr)3-`X)_=Bv70$Tdf$fV~wlMF^$@b1DO2U3;Y_JC13sS}L{J?&x4L2h81l{ldtSS`mVpE#n*>H@CK^ciGH z>ESlHbso=RnZj~pwyLic5v_aSCq^Yx@Ge-rc^@N;t#W{^POmR^5m+yIlx;5=nY>zV zlOcC9dYE3q!#eD>_|h}!YL95p+;t;nU{Z-t@+;S%Ig{9Er|81^n#nxYb zFt)}Z^0GJDxU+30>y*-!w=|iVZYxar{}ZWyWz;urcpvXJcAkxAs0$=>UCOOjPL)pr zgWRm&4j>Pb%M zgi}PX=wTXC`(OTCiLtI~(h70aXsolcm(1A4j%>KP(3{*k9vk!8S}doYJeqX`o_v^w zSr_4K-~Lyuj_o%KN3S^J{tPM+LH#ke{Ls}TR)v0Rem!94%ue*9{J@Ew<0pk8>FdKz zqr+uRR)yqF>y7l$&&2;vQzA0tWnp8p`{i@V#SSQvbxDIyC#&f%&*PD6mb*9yE3_Xzv$^%&bkrSnJiG{CwMZrG6oB~u|#L!^>ceq^}RibNYRR&sLSjoLYd+$UKu zS>u*8qw(k=ShRK6Tjm|pNA?D}PVbUcjB?`K@`4pwpK@EwEGpge*g9$pA9X8L32)AB z53XM+GUJ~wz)ozF)D77J^~c+$rJ*7#AYP|eG~+HoadFQYXYT1fGv5@<3cZZ@E&8CSm+xp^xu_z`8U zPM9Ipj?c0cX@?9B{YHtj27C$>;D_#nv{BJdJ~QZrrmb226SZV@&(vU70*|s#A4`Uy z?EQdT9z45Lw(FIqapCFBR;yU_&G{Z^rux-CM{ROH5%val`2dV&hD^~|s?i>^&31ge z*(~8Y@l-*>c6}1DLccrBoIH9ox32B{QsB|)_Fx<1L{wsxxo(=ToWGV|eI`o7 z?&f&3bHz^w>`F1VMTT{krJJieN{c<|eP2cJ=IdFk2|nCiulXlyzwDiyLLU6sXoJd? zSt0rT;qq`<(Xo6QbTrh+Yax>l728Y>SygIbGPy80=hT-3%@SLws7J(4tUosu#YsxW zJu4b*VT>jbxV0U-$-?KAj| zOmZiG7+(KVxedlTjhKvHyr~6{CYsNEA4)-uLQ{vCNTb18fh^&h*w-`hekwp4J^K5* z{_(_40QgJ)kRlcs>gR)XM-LEJ;AddUK&?LW9OYbp{yDOw00s92+6~2ZPFgT1 z3Ko!9P_$u~h$1U-pvf?fLy!mLI#gL?VD?Ov#h|yt>4r+#vSd1Jx*4W(2jSI?L1)zC z(A^{EvY-3>)Ei)c=_ogbEIz zXhwrL*VNKdkdGJ>fQjFRZY*?<;$0R}bv*WJD>i`WyAE{?0?{dNXqX&}4NGGG69$M7 zP{+Io}X2A7lhfQ_6pkbFV1U$5dhLm8W*OdMa_yaU%*_ryF5B!jg4JfYY z*jTM1ORdJDbl_Jh)BaA59>fGzorz+~%F3`7G*g%)unaqf@VozaIE}E6uouB4GRn%m zQ;nhj=Z7#>JkF_Ls8G|kilO%XBLVA&n8#2(usU|jg?$(`f+=sH4%iG3)PF}72_xGA zEka963vf$Rl~eFpu;bqW@xy@Hr@}GpbtlIC;b}&IS0f`M4?|!#1h`IDPlR-mj4YW5~fO)c0 z#XL^#bOZeuh$e#{g~2ccKAmoTf?w^EDg0AA&pRE~$7)^Db?nm%QKuI=e!+#m-*|m` z0UvXL?DQL^rx)a^bTxCJ>NhknsMUQ?M)?%EO0}Fr1BOL?x;)n|RR!4Oo*k$?I7jei zs?U4SYHxj7Ky+T!UJX}c}4sHn($!2D$tbPI{-8>^JF;6K9B~O!z_4qgB<^Q!yU#h zuIK3$;t?k8x%2W)FVeb)vm0-3K;@+l?hW#zR4K8BnVHsT-r1&Qx6wz3GJ)-0M}Jqy z>vV-8elgcglNO)*s{GP%slOvvuO4(od}}o~FvO>nQmc6<#C93JJ>l7l1F_v!y%~{% zJc}9mSrAOXedlou@#xq*G4QB4oC9asvbAY8&UM8bkFVJMU|WR3y#OZ2m=BQ#9x=rM zoe0RYqS#t$+>`IwEKBFb&{M@@umcL0)@RVoXKEBJwAPcmX21a9Khz=6lc_C`!7K*yp7k}Z z4al{<+M98SF)A{gj$$`k(Re$kGY)-fULYF|c2+B)Nv+jIb5_ASd|WA8Tg#x1ESjd` zc;8HHX|OOIcvVKWv0JUU4uf{)rQKF9Ry?Fu8X&|@XJll=ayzZ`=L%g1`l59$lBvC| z6_@t{=@LN5@7aO~0Xcnsqcb0&c|!f}_odGfl<4WHsVk&U?zbFFE@i~T0PE4)wgs}C zbkcTgI$9uGMb%PWO&7-#QBO5U)eJs&CKFq?zi#C1?g7jXxudRzX&>=BppEr6`bPA0- zCagRUhJf7!7Vqnbpb}7ipgECI%8BaEP}}gQj{{)FnpLrHs?`ng2yCJ1kontyw;220 zdNZp^rn)E!(^XvSb*31=G+Dc>G5FvPs}s7+n$V1O0|z0H`TA zGhBhr&_Dq)SO1qUE?HUtXeauhS^dzUX^u4iLg=6sG>(D3z{IcE)q%``Mlf;LtpyAP z1+LK=%^{-{@z6lr(a{kT=n9N;t;Yq2qqi{_0jxx~_FZo~9jWRf9@l8bHS70WxnN&l zNDu_xlk=+oGqIi}6GmtN$8OoC?#xZ^w!ns+&g=%vOyqxycoCAY=z$KWh6k40IQrvPi?Gf<0B=H|zK?BTRgP-!K3}ivMixoUG)v6`tuF z8sEd8x|$Vt{@ZqD>EWeQR|9OYU;X!pw7f9SWhR=$x%l5BDtp1n+(>1^Tt`UyKa9u* zoaj9%r!CL5L1;}w`oa1i4EF+N2@r|+fSrjJtazo(3)8exjgFtk`E9C%T{M#u{ zt^U8}c6#%FEywB2|FwdcoBwOk$uKwnUrbQ=QS~t7l!d-*iU6B<#25nqidqd5!h`x& z9^!*%(O*0DAz9HafmY-waOfso$!bYqXI#!%bS5@p8pN|_7`8KlpZz#<&0s}~=o%UJ zdJuK66UMyZw(dKN&_>&7VQUASfjv+_%Ge56yrahSBuDKgCBjKAgH__&q&EshIDwt2(=yn zcN9Y*M-%}u<+isDY5`TCbymcOpmPDrE1+r7zy?ACddZ;_8_{aVD@~=1<#&6B<+2~{ z@vz`uv$HH_i)Vy~-U~{8K0X31?V~q0wV{twGWdu|2fPz(e;6txh!X?JQY0vdT&)ll z*8rHS6@Nvc+ev$yv@RI+?q@yzfO_$A+FS*xO?* zae%6;2b3>|K^? z%XNG?%J7@PPH|uCSaoh)`P{H}*$J~ekhof`!#{pp`*oRB^cLy;7hZw3fI?99DyRyE zJ|J+5EQizh7aVE{RWfuckNb2yQNVE`lp~V?LykHQS#&N3Qwi-J-t>AAcRG!ZDW~vS zA=-q`0xYbQtA~Q$e!)61Jmjg4Wl+hA+2SvPEy#p7Ks6~6NSb=K!w>(?6uyeZ3c6$i z#*hJgN=-GS+f*Ek4s=NBlGF7~&}@8h?czJyRJh~>owCkxORHDIUS~v|R$NHea0K*` zBL?%2@K6kznpl1*W2ZaA@DOc%0rBw}##PY4m;re&BJc_M?APB^Av&W-RuGhV7^n3k z$#YH-wznpuOn5Csf4VZ()no`^B24_S5hB7v`Qc`r75=0%H+9(?i{OD}@ma41YD`$N zY=BkmsB-Y~TfY+fpyK{5fsd1K%NXulIa8}y;loUQ$*bG?pZiI;us(~fUvYvBbc6Vd zX*z(>lzcci7(K~aA0~O?pmCSub+1K|SkGNBacBS?K*`$7BJINsVz_sNd540s))^OB z*xzK&)0f~A`E;-1d(DEY;vc4a{f(+<>mtL}+l`vgmVjE)adqVAaHAblxTQ6?$0%@u z2M@Eg^XPdj{YqSbM*A$_TVBA2%M-%IAhOITUbJzYd_$?SD|)>mIezN-#m~mpt9f2? z4U3i50$5a-xQ(`kN~nxhB1|>%-GQ;`OoWbvd8Y$pN?&N_sYV*AUkCIn3;IKePYhJi z@$TDd@cm{KlaX@q!AhAyi~KC4^ZTyBbRa$gRa8NfT7?@DyrvnVQo^$U!24+}{}mL@ zn4a;YYu|cOd*!LJPws^G6s8IWy%GkQ9b3|I@YP(2Biw#_k+SiFHDLaFQoHx>W$RMS z>VBLVgCq)=MzzG&V58bN?rZ0fbJ!V%i>DE8+k*ER{=Whoqhd;qUOg_8!UGD*;TT{` zo6p9{?Osrtg}Crwl){KNV4=n!T#F8`+!P}oz<|^s{$t}_(#Pigpufw3h$V!}DLfnS zp8*HNqcZ`l6%5=^H^v?h>WQ@gtb=X}z+8RcFEGN5-vHE!F1>q7fnJi|srclDvX!f~8nFt~)F8BBr?HJgS~*WwR;v{BcPLoY$DB z>+7z8CoH`Cd!8@$447`U)*Bo`#}#yHXRiC^%(08K^iLN}=ADDdK!8Y~6%sOvBD5Fe z>e%Z^R{kB#v+bs6pR9cQTYS2SMza9yJ&BARECj zsZvkfkq3~5vCB@el%ic8fn8PJEFMTK);ah$g~h+F7OP@;hnTsDKmAsEk=9~_Byw*M z;#8vOO0K>1%F)ott-{xH`*daUpM@9CGQ0(=1bY`DN7l4-RMmW71R+9udeqcQdGfoo zYry60ZLOA&&n8dTL1#*7Jz^i?XCxsINRI$(amEC&l!{JckS6TaZ^B1KbY8|dszDov zk5Y`>{E(UT$hr&ppd@#l#15W%K37Ek?Yg0Qc73BxIeAf^nPSyAzQ9v(6Wx;QM<2q+ zBY!BwDGfKwBV;cr}d)99q4etlccLJYdm zjA{#L_z?)>UVh(fD}WzkH|yPXS1K72Cj})ZcowE81nvBIpC?$}g{!wgg3musn*UlF zHt)xuUzgVzxL^E4#3KJAybtjq-zi7loE`*t3NPCFR={KS*8@4uVb}YruFNXYb{+mm zGja>Qz<7jhhuLXZntsUPn5ygH$$np@%X86K%&`+bq9deIyBxN!$murAXV(aOPS%z_ z#kmF{=1vfg?Nr0Z>x&=@SI*WR1`&GMbMjCBMinHYWO51omx*l21(ogg*qMJ1G&_yd zBM7)Ef6rUi{iwLU3#AIAi#kw3$U-bd4x&d}=If8X+lDIt+5IBW%QJj#SRY zQL`O-Y%@^;@an@9fp%Y7<+6872ZCPppr8O7-;Vm@1=ElH4 ztNmiMBKx9I6_01r^Kza3BU)0FEZV>4S?*a+CCQt}wuqk084lOD8wM-6K&gO8B)q8- zIx)05O0t|Q1W3m@&Ta(87D~r{n_z6=^%O=5Q)-_|1E7?8-u=UI3TDWGQ~x#OwM%LX zk7eTWfbqRoc10k{S}1JKYX;)O9tmq)P)wZ68%*rtiN|qZFDwC-7-X3xkXM^`B-BDZ znYQRd>V4po?%I2aZMl~twJkFqd*kqKH2C>EeyQtbv?@y0qzBEo9{nKpyK`IItZ<~O z+ia{8)Sx@@Cx^2b_*4VU)^x@cd8cyntAKjoZ4zMj< zDLuJ!ync*tJnF)PVd<7s@14wvJ%z_ri#8rN(yuEI4%!>F*eMd(ZS&AKEhGXJ13f*A zatok#CJttei~Gz{uqG(Z$}+qb`c^`0S8?4Lx`amuJALdJ-If0h`URF$}dl98dyGo3vgXROSAQ z9j^vs7Cb5yU=(#N_B(T&xij`^+?~;JY=(~??X|*Us=2yNeH007- zE(MFnkjU@MX;6sCK4;mL+zOFA#Y|k?J%QViQfa|MqokP;=fvUHO!zfd(1dcJu>|z- zF;yIgeky$x1SHxS9@~{IBxB1#_HQ0IiGeXB`J{JCE8vYMz_2NL>^>-#DYpD2S+*q= z7a7NI@YSRJ>GQcgSKPQ8X42t>cgp8E^$dkVN0*S&pL!1YPxfTIH7k#{qm`;+soQaR zeQ*CH2ee^1cg~C2-}+xg9yo zII)OpUjM%7|3j50A%+d&$oy@BIwP=8jsBtb1I_2ntdoMcu zQ|5liA@@z`FL!l4L1Ic5Ip0xE@=MeKjnA;wicF*N#UeAE<_d#8aOUBiYLQvi=ZWdI3 z!He7R5ESrrA4rT=?wB;@GGPhq-@&XC_>c--0i%AbO&u{LlN|Wqk#+c+0%)To7(j0Z z3d7DX3Y~8AbpJ9J^WjpZ`t+rxC15DQa)pVU)I=`>4`U08Bo)X?{?Y54lDvBR39e7?#BVpfe0poS=9iC!w~h@BFaa)!v2Q9M-j|!b!T&7 zS{I#XoYee^FJ{&sL8}0C_P6*w4xx=(m*7nDK-ULeYj*Q<#7E=%e0>U_b^_L+U+zvU z{@UkjEB7C}>&Cuc2G(2gRY1QI&s8$6Pr*t&sVe0^4k=uh9+ddzeia(IrXec;L#SvT zeR0cws~Gwh7`_H#Qg->aI&SbHP?tsdvhT|QWL-a|5hr*R|D1ZFO0d|QXh4;I@?%;1 z1HHOKIFM9u;e+nmV5OGE;b!P;iF~-d1uyRZNNrO?MDR$E2uHNyT(zKf&;hhPrYkl; zCWOw_^L2MaSbxS;-#}}t=jy&86Yo5Sk0)?TF2Dh*m+&DeVid0|q85d21d*KuC@Fv! z%@ulXTtkGIX9=pxx!*U5Q3q>SmKb0v%x-s zK@M=_R3qQ;11~e8Uu4AsWMLt53Jkf}0{Eet_nBk1iZQ1jL47~oK_JixwzLIQdw&&e zh@UeeMAzatn11Twy)>t6PnptQW- zEniN)14oL>p<%e~j751DbNHwlkKg=4R0HJ%R>RG^feyeXh4Bu0BfJExD)weTx3%P@ ziy1ZU#Cf56J&QI!l+FnphotEK>lW73_YQF2=DQOfV$BT(UZtZiZH^^NT66WSx|~K( zz;vG7q*#{HpxO^-8z6guxxc~Nulta{_9<3u)0u_GiHdw*>E8LN_=N;Iw3Z7GdX*vHr;lFFKHFsF2u>|=t^U}6 zHY$c6^Q0|@Abgf2=`}kQ#C|gfNOEzBzoLwuCA=duruO!`sa@eja&4^!)SUkk{5DDC z0ly9I&I7!m(#KIzkZAFV*O&n$gL4U#vHd99)F?O$cpc97LBYO+KEhmHP`ol1Jx zTkCGv*6a|WIYgsgB884Q)ZLExt$oOt?pEnF*_SqV$!}`!;WMgqwGcBU$#eX#iIV!| z^|Q)B697%B5@6gIp?wG76^@i%EPL*8U&OLJ>joEt5@%SE2D4od)ed>G`p6=|T*<`| z_H`}m``xNR2k|uOv>h~Zdldm*xWm+J_4nAJOw&-h1|r;Caqpq?qNQK%>Trqu!W{7d zQZUMuADU^j?$G5khc#WFY77aB`MW|GZjw+%^W`V{)SMYLv1vBb1V88T=>wKCT!+x? z$ji@%IQsupjz?)}?*mMHA(WvqHZ$dj^~S$t_bkogf91BoNF&2@ocs z&=&(;EjXi(Ip2ZIivpdek%ra)8iH#*#2vM-&#$6Ph}@ygy6)4PXCQ%8G=olJ%h#zn z=|}ng)N-mHWGy^EdT0PzPHlns8AQw3M;m$vjs?JZA$31ZW@?w0{@^=-vwNv-UBFFF zQ@jOPmEy5Qusdv~w5_chS2tRc&B!xfRg!KwEj=sbQa3y1XkMdLSMrBLUg$R3SHSt! z68g63$5$erw?__eO!1%VmTY+GOZM1p_Ya)H9A)XBjWmh_8oCX_Q|nRFd~kuw$!9n^ zKw66hp*p7<4r5k>oIn=pz`X-Nsc*9Fg37*RC8_-NOs^YxcElq92$ng04Fer|Ln0!**e3dFriw)Df*%-#WwcBs8|#do z=*22jdOwV=5!4KQY51Ap5?De=F70qOZz^Ru^0@77Nm;PB;+eL_9|AEZs0ZPYP`!CXes%>qRkT52o*UvKpp0;zb4`C71hvlsV7><=xjJ=Ay`=&x zsy)S@dg2+|L{FxM%DY45o}=69dvIbq%UoRLIf_4m9Xch{^U(fZq^|5r?1b~UnS7&;unb4h1pkbcYhNBhsH1^ zBan?|zDn78U$Jwv9~|5?H+#sWQKX9Xk!CD0dOpT^RzjtVbH*ZCt=?*V*h3O)miomn zrFa(_kDb|>EZ$kp7dJh8y%AMavJxQA+LF=$!o+WyMI}7}SjEN}IQo}Gvarvk1)ODj z0{oVb;bjmR=o5*34&Ma05}R+;Q4Vy>!G6CC`vb8VI4!JK!s;OA1izT0bD>oP%RTLT z+=Y~~9yk)kB2r*I{tJ(9_h$M zVmAgp)!!4V1k%xv3AN2*Ce|YPlX%Tc7pMO#r(wW<*aEukEaSgzfuWYDJaVOPWPQ51 z=R|=KP6oPyvQF`1lbC(*%eFvijp#TFsnR^x0K#ixXQWFbA0y*f^ItbTuo`ON@(5ks z*28&n6YEA6Hf(G3WWd4$1XGrLc{%?cbyb;mLa?&dkD$r|Ds_;QU zlOrPOoy%ev(m3SnJ2WnP5&UuhlXkwIz64A%?_BWA0>xfgcF>VUE9pN0AtmNWYqw9b z4eSDQR>6+->g`9n(1uYOY~kPPR?xfP;TbcPLfx7XA8y}Z_F2dm7Y;&xi(U=K9k5tP zS|?_g6Xu~c#g}<|duZoy2>!>Q%u6uaXqJYxUiZp^C-5{WJm$XPL4N3`!N(<7RlABTl z=`avM8Zjv8Qjtdbw{G;&^PKm6$M`c(SlD>S!BPdra_X<3Qu0CjM2Yv?d8el1$f?hfI8|t>VvZIe`;h@6DEl zHk{LLk<5KEK_X(J4i4VW1&TU&%Z*9`6iA%=p~q@1um75BAgjMWP4Ji6V@b|ccAMi~ z{*HQUX>$Q4Kk0}tvGHWN9zr1@(WC45;)7gCp(e*s(PwPt4~;#F!!VOnRqWGEOZyZI zt#H@vHm*B*FIhk<<%Ndjz#Y^jph=Wy^#LWQu{`%Ms;@)SZtL*!w4L6iY>q*uwjb>J zE8;HP%|RIhNmG1$j;tb*0;=eEW&KZ3IDmM5m zWM{Een#xF9MB#!hZ7%%Tn(3dkfA;2mTLuJi=P8Sgg#g5;<|wQ-21pNVXDQ-+uJQxj z#b9YzSZenh-&elr#n?HdlM1AoDgg$7?(nNlKeakp@}YjFO^&Zv+!-KQ>eq>g<|sBp z>Qz?>{tu9WIJsb8h;dtE%ME}RrWaf8T~9OGy;v)69jRmnjqY_l!;bY_HeaNq;Md9= z^Gr9-U5R`z;@Fe%J9KMKR&*q~R}@vGG<-cu;ubKFKWw!ncgos+EKAS*0YoQAtW}dQ z%J+lOlzLLvmd2V$q2fV|K6tj~ecmK21t2qhl@SU?6w$1GX!dLxNH4L<}WOd8J)U)-2-@KLvPkzV%TT zC{oT?g@NNu!=;V$3HxhPLs}DZT)rbc2>>Q}!uvgU`XcFn;9CTAcy+kIXQndf_>L~* z-wh8~o9S-2x;Xn&wP`qt{U|OIBk9?7dzSJ~gKF16&k8+pZcwEFilKa9){b-4)oZ|D zfQX(OX!{-f;gIvD0+iDLwL-_}B=C~Z*~UCd@7^n8li`(b>|3Y6M`PFp)l$#T;-DfD zvDkFS(4ngfG7>1LyzAU4(twh3R zOP#59LVu#HHvg9rK5jpHO6@b&zEz)SekBtCp}D+^1d+7NyYB7`DgUPQ)Qn#SkUn59 zro(`8E4kKl)pu5raxwVW*Y`!&DN)-TKZ)Z$#hCVs&SN~_1g8uHSp}ye-^;3G0Jr#o zQ<_TttSu^;k^xrsAo$1451w1wqd) zs^92W&V}{J3~r;RHSVLd@hcht@>nqb_Y;;MTia#0-t5ceh@*We9&1`(icJpoO`NYF z(a5Q>3X1Qy9QkuSmPLTy8bm~AKgX!Ce2(oY^YJ~?c)x8_%qd!eDtE&u?H@^8P(%QV z3!s48{mK_U3(zXwkKg$E5iuap(+cGUCCEO21Y-A*P23(=4iE-)vG0{Y?pK~;FyJlB zw~>6*^lPb2O_^MTab7r`4xPQ>!kILw7ilDef0a-(p~E0?osaJ>r#UXuVbb+T-o+)U zTZ0@4K0c5-3hmP@SvP%g7zUm%N8ZkrVUNs|)L6>8>PMqHx;{`ufoM~=$#?q|k=RXO z-rRB#_Dc^Y&i@XiWJ^b&{Mb{rm>s>D-O@yj$l2}2uvhL$KeWlL3tqghB0dojdks5^ zsfNrM2YhzdhbdQA|N4EzSOc9LFq6rH_l_jxX~44D1}5?_bZ7&y-~fO$kNMsgWtyJr z6K@+oLW2S#F~w;XZZyz=*RTI;i{6DZ5wXVa1ed!!r^6qOdh7Xs*9E`Q z2z*JAdx-c66vDq#Pk7#<*LwRL(b$1j4D-2{|9sop=r*?jZR`Rzm9)-!o>;7;zpwZxGsEIjLkA8slf_lQc<}F}a#4okQ z)|Ovr`k8a-!Ewi?)G7Ue&cBOQ9#SB_`|TMdIPO3TefI2GrtfMysBT=U10eDPz$)9o z-!Bxs_#R{nbt3D)GF03c4gE5f7dQ>#OZq`|o+}o$?-HMbNsm47z=?lkVhpWQS{y!^ z{B~L+djS&Y*YH6|d%ergU!-$uXQvFCwWzgp&a4zP`?IrdT0o%#2Vkt8Xm+RPDGqJl z`oh5A?Kc41KV5Y%U5#!={NK;c65^Upsz;1o9*9&?GpZ}P@cyF$V-abgFF&4_LY);r z^pB|@P@S~R+bh0}ZN7m)i>m1tQ@J0O@9H#4RfQtJKRR{YUsxxLcid4ic;~ z=OHu$KAAVE3yxGEiP0+O^CS^JlWn>R`*}6Z&aV%wS5g_9d6Try3JHGk+b!)#ynjCt z^0dW9Rte?V&Lo%q^3pF4bJS}3TGBb2ySt`zMcAGroBigi3)m(#XeLvFBzqMq3tu2o z1XIPLZo6}cUkVNIDhSXfKGX<;nR-pwA<)uT`fd;?6CfQ??0bW9R@v|%y_bREG&H9} zzGc}7g{vQ5nwvY~{9~uN7a<5429OKbk4W*Nm^8fm3nY8cSus=lzT@NMhsxEv>+u~n z@8yVBR+%U5Kq4o8cGW-_G+@{V8%;bX9_(=XF;%2P)r(;+CYWthv1JU3vKPHjO#l!~ zb8E9G#%J6nt&voXxVEKIFTNy()g%(?Ymz97F)A0bQ_Y56UHI8ZL>T`_}Eb zK2Iid&5W99@G> zZr}?fZ%DLJILo-stHXwa5|T$+#ph9u0XA@GiCv_nQyfY+n0J?J`rRIIX?K8w<5}cOf%LKGB~d z{9cT91$f2K9&nt9C^8~qnZ;UivQ>dN09$u*Fk(W|2&q|ucuB4!xyDDQG z1_(8juZ^F}2Ch5dSL=svWIco>{!T6wX59M_x8J@{lydHbp~#yTkFLM*O*_7D(V)_n z_|Ro5BqRhVgo$x+?*|9t6B1mN7gC2g_{f3XG*`Z?v48zO_d-X95(_0I<&6t=xF$VA zasE0waZAmjx*>NUo8;!_j}wnuC$Kp$FM%2hXWc3+3k+fHPYP*!Vpt0GHr`QjlUmmY z_8vak`@`A-b;4m~oj8W~p@w#`HY=+odn}pQVN>ia@WM6tt>tx{(2p0UWmxatR(|*L zWMN0f+3nfs2&g#n<7Y&85N&mGds%yHmz(N9Weg@+PqW zx=cq~k1KldlJ;5d=nlN1SSVpOfRTlg=nio1xTtCxl_pPFr0G=Yj$MlJ4`TigT2$z?=>a4gwEQO;K?||B`~jvF2nR9@5b8 z@L{0JUA;>6eapHt30h1}QFAK0|RccmeMueHzG|z>mR^#~5UW;OFJ1PX^Tb zdrIP^xEqS}T5MmcofrgcyiM9}Qtu;i8gQI!Hw+(k#C*kAHWjbE;z2Igz!Kpp=j`n4 z=;-L>wf%Etifi*W&C@ZYjD5J*b7(0zE#lAhc6s8J7i)J!8K>J>F0O~7mNzb$h`=%D zWoHkKwA0lkA6*8%<()T;MUnZjc%v4F*RFiv`p&go@1(O?*Cdh_?MTc|4qNkZgzud5 zLRr8kO9+K4>2$qbMz7aZJ3!|ml*MQ-*w;@|5AMvH{-BWWb>3*P+kg7m->eEyd8m8k zIPiUM0iH8^zP=Zm$0Yh>-4#9i;`(FQr4D*}6c;dqPdmvF8&Ojkx&PfIQcbR-T>{4{ zFE0;vIJ{Y*`=_X`2PY%pi>X|6>Eh++6Lr5fsV*GXkQI*ol-0Iy_`ar59S@XY(i0Qg zik~}yOaZx~^ zDx8kw=USyZ4X^XK^yZ24K!hGrPSMoX=DYFXeDR=C_gZEgy1blKDChCxA}`3^gq+4Y z*Xtrb^Y1|4uK0SdtO{a#it$=}R;K9(bx*BOQ?1A;JoDbLudB_icOGh6`qG?9i>US% zRRbmV{!+35r|SkZK^!9>_}2Fr&p~^8%OIV~M1S^D)$%=Ke)eGR;B$_jo@9fPoDK~s zX>4rl^^w#?TT!oGuFXuPT!HM21;Of_O(B7Q?bl~Mqf<3xoM!~>Y;8|N+dv0tWbVgC z2Tpc&d?F(5y8R7x2Yutme_a9V$+Qm)xHt~fl~B5Z|MuUR9lVU=IGLwrydksoR>{GG z@~&R|hv$`*apZUTer*}4kq))4KAOEaL4o>`SdMC=90x7WN2n$qkZpCAlavZKWjx!zEM{^G6$H!7m!biwR5~0RNe;awOmq-w8Z0rj-(9fSg zk(QA%+!nDF%aT_aRA(6QMqVM-0J9V2NOl*GhbV}4dJ2Uad-%(sePrydFe?23xJDF% zR7SHc70RhC_9>B%b$~Ce^T{bLHj5KHST&m1^ew`tT^~W`w5L$U$m6=>jP$4@R{&pu z8mB*cJd`x&3-~2pDTcYl!!6^g>Y~)b^%jSe>xw4dwXH5J&UK|0c*lmLz4#_3CggNv zi`N~e+9lA%o|2PQWawAuej!qN`pCOqNAu|o^X4L`1<+T`dZv5t&dLf@D*ZU6{zml6 z7@wH`v9#)SRKDvQKK}1<#KjJa*}C45Yfp!cES~dNzw+lAm&b$l4$*ec-)4>B1ZJyB zR4Vn@p^w%*?bTpk>!4oQ(C~Xz9dGi4;kV@76SriIriKJLW3G2i6cpbausXsW>5SSC@cg7EH6yfikv?PsBR{9}`EP>K>#*8)oiI}?4cyzYX7Zp!WVVbh7 z;lfTGZ=&7pmlYKkYjZ-K=L2N1xYPtSlZ)1gU`N(kGCqIz=$*9J9~rwQ8;na*HdKFq z%`ufKF-?f)`N-vdA%1>Dq@=eS8nk~p2{Y>P=~#0}v~3$WG~meJye7>5$a%0SZ`>~^ zIQYkCy}p)rP`>E#heZyqDbB*!vOygxd2{@_Jky@qlHC%tWkvUkHw8UN-|vkyen+l!0qRPeI|!bSx;vtErfZa@wfl4mkhIEG$rLO8a64SMz43>4-S4d;obZY zzJ-zs7&p+oZ|Oif(Tfp`YnXO3=c4uk9h~8hN}HWTE@Lqh=tgD!8*{U-C*rDb5ky56 z%HFoY_aSKJm9P+ywaV`g7p5wHSe+HZMKH%jRW?*Dd~k3ePP23^&5U!7tBOD0;a#Bl zTMbw{MpY65k+Ha_sbbknz&-($OiWBnP>)N>%?CfkLU3+d3r~^sM zEVNJt1_m-RG6Eg?#RmL~`8CsR>&g4tE zOv))K9e)TM(6;I6X{5VrL3ye`mG=UEIBKA9?+b7PRa6LShd{y&$=IF`4$W(sm`Fg! z^eP(cK9j}@K=V0P(<_PCDSoD=868yA(T?#Ydc~QUU()@Y9(#1=nA$&O7<8^%)7mIX zr>nLJTuiu%%YM=X}G(_J0wdz?oXf$h>nnv;cQ+F?WXB2R4?a$6zxD5#f&>|_@x z7D+OWj!UHK;@J|63H2B71~K|^DID|-=P!X`DCWlHD+z|7_b$qK;MzYG7M0D-nOX9( z+qV&{OMGTe?0!9PsiQc;rO{1!>T!{wt_AR4LPJ9v3YFd6*P%Ovh*tQFzU}fufxgz* zr`_Kro-O4XiaQr|ALlL%dd5bSv&3JOF`x38?1fzTupDu{y(P_a+JoiiCs&P~g1N6^UCJ}fOEV>g*rQ2V^{X7$jem@E{Mljz{rVtiZF-JKg2!Hi#ZdVLR>GAi!{?;7qKY z3l=735>iS#XqJrpq@>S4OzblKmY7A`tt=`sQqpfvIM%MO-s9^VOD+z7g&rSnHnyz0 zN$0gpO&zNY`M~>#a!ZieS-1D;O?e4y{jjz653V+2X$Dy>Q zwO#Hb5*`wsMMJ8?S$-qpYkE6TRKC5g!=`@%j39`le3;!0*xew&36C7v0Q&T*9n$|G zM+v^QdaDzySaow;E1kTKFkK`BZKp(s?sUHwN>M#3c>h;||F6B2DTz@dH!U{gep)DB z9dFOun(a~D|K>k;nx$BcZ_Ky~{hZ}^5G~*A)cNYZMP?Zes3A3>(Mly1wV%SU%L<0$ z1aHkh9_{IgI=I+Kq1(e0A~7JXGS=+xZ)|J~hCY?0S>N22wM^^+mzHe&A*3L*Fopt> z2TMyP|6DWs;v0|U4MhcC{7Et~eLiP{$^Q6r1`}NsAEqURo^YSbThzXN3m4Z|yflIakDcKhYf{CchS(x~lTh;m{R zv&)i;xv9#N=6Mo5Qf)Q8a>8^TiX2xNmtWDDs6x+7Ce+P8*W$_-u3XX^@+8z9UEB#U ze+ze-^`E<@vpg6LOeUDY(u8r>$78Zh`;`w|! zUW#cs!|udc>lG*wnP_Qg>Feto8lvsH```vP*PFet{w8Iz268I+goIY|MO?BKeK|Wq ztw75Kjq!)TKi-Ea0@l>=d_(O@3Xw%0l=_Q_#d&4!`-wMc zGY$#ZSqk+s&QeWz+jtN5P2=JgFLvG#p1)-eRm%5@&}^!$txecezDRQ;C!F4Nf(``(8F>bDK1#|bRA+KC@%6H0hLd7HVCNNB>ufUZ$?BOe5(l ze7MTH2rv-;MoxTmqrIyu zFFagQ)BeVdU64ghOtcxGCAP!R#ZwS^qF`c|{WY*TAtbVVlRz{5uAz=i2#21s$->Ts z&&xUg2#oj|XEGp`aY^6q7@A&UM9QLsuRjl$v3?`BK$w8U- z>G`Ttp&cqhNwzM-4#9T~Ina)t?)x{Vb0bdX*>`YM;zBH`v){yFQKfoE$qj38rAmad z*dg*cguf%wThjAt1Nkd*Rz!F{4QdNEMH}qYn+5?_0FIF94-bs?w*${;jg-2#}QR#%qF(BMr0)tO?bw_T_ zNqt;Z$0mznkSZr^P)on=Kv|HeN9#|p(-67@cNDFgm-iUwJQtT$>zgU88#yokJJ_v0 z34yKywK~AEM}e*w!Fw&u-#*aFmrYmugGDV(S%Fv&_~yLWbdV8VqtSeAKPCrpE-rfN zt8a7yYr8?p48;?hoXv(wEMkWlW2)sx~2O?++^{R>j z&$gwmx}ZEy06fs%-d;f=9Ly0|yo{hN3EUtrJ$F&m9stisO?4&@eD@FwPWM4Ng@oOvY>Xbc(q)%>5P+EOy#&b1Bo40hI>n;2-P~89wK8TXsQ6S>&3ffvqo-vqWcDa13uFtWaxGX{mM8 zFTjQeS!B=CpY5uKado?bzop$CV*qt^!9y9oYqSI+Z$U7ufrf8x3dsF4u~Ba^P~x4y zOnvw6-OQ+4ivAvVCEtNm$yC zb>U^_w(ukrs>+LsqSHatPu~E#LuidtViQLBs>iQ9v$u_>N1ZwHrqLP;7^tyGm!ouC z?YKb~akKH!$GTBFjg!a*5fF=s-`QD*TE(X*^=N7Nd>biBEj_(AT&Wbnv97jRt?euv zeDU<2#4J5+H8yIHJCJo^JMpiuY-U=w~{=_G3T7NECy z+covhRqFALN zmE$h}K{qKa&3C4QJaw$Zqf0K$=@Kpg2q)o(h$utc>!Qe;4Hb=a)|R~_DTb}B=EFPS zxFE}`_zJraf=oXGl)%-%&N{`iC!!t)Wq9@o2!jqELwp3671$O|J@v%X<##q35FZ`Q z3vEbc>Pkv=&J&oNS|d?WQ5Vji2O9)Q=Qof`Njd-@Y1Hf|@%_<);B5fW-`vU1L!2qu zXDZO^gMRN?2~rS`V5N3$oaVd2-%F=C*sE&_+#hJ!cy;S`Fd*hksuOU+t*orTxn?t# zBc=3zrF0zU&))>DM{RBGucU6UV*UHD5G!jzMMaD+s5x~2rk-q?Qq`gIx}C-H4a~KX zkVyZUoF%Fru+8f)841mExDSYPL0OL*gkH=_K**GctxG-jTe3?vpn$Itn-KU3^A{f2 zAjZ(vjColzN@`ku2TY0Uv-$aXxbS@2FcJ%xDA!#fJOUnRccxSim&2mut5>h0XhmL5 z@9ph{gdB71!R`;iHNLRjNlfT|MMt3WbFq8$_itM((97BbN6F##ZG}wiN}>{SeDT|M z&kh-iAev~fRgsZ-0Wi!CG|2|tzb_6veAg=Pt8yLh-j(Wc#(EH*&Pfi5Rec-bbII{W zRMw(6#%vqsDxCF#Y3rU0RhvX{P+aW24i5&@@Mzi4E4DEbe0aA{pr9y%z*U0C7ULmX zJi0AB$_UXYp)td$Q@w8@o12?6Ga2@+c0gq;l3IX6SXlVtMOV134O~ua6rjr3!*KKL z-LN;fxY@~Py}w3`Nr1kh`?pWLEa7x4OiajqY?g`)Yf#$oO`8$SiILR*9rU^3?6?-wybUc}!ezTpl~?v}%gQ79~1$}9CB z;E27Id97X3Xk*RL)PIFIay53>hl`*QCTZqn4J-nGgGIbgU1)tmLM1N)PW6n1K0+8 zJ`~VOnwm@_>F8er6m<-F>IeVxsn4E0EB@&7`{eVA>gQk`HC{o99Rk&dv?4JJu`w}F zK-AIItpfQTz-pq{b?FWOed(CK#8!EInueZCTc1r+I! z{FaQURDl~5{&sXLkb1$bTFK$=>+4%*R|sdRtBN%o@(p#6^bLJ|JAr%>3#WzIt2I!lQrXIA} z!Abl3j?iLh%Z%7np_wVRz}t)O6@|#c3x^k01Z%4PkWR7|1BQT7zow zkl9;Z#894J>4xe?8mzLq9!75te|yGfFXw7hK#w_+U&`FX$ci@yx17=421GQSO|qmQ z09k=(3-yoM>_SF7YE;AV>8XIv%gab%;a9l@Jo8=9e);gH0s&6l32$52T=0nvE~+MY zg@PYOBszkqsALw~UEe{P66d+ZR9U$oS zrl*d88}|(dlLX+fQDlI(rzit3hq=TV@lduL5cwLJnsWbnFbI8+g2#3ZG@AAQ=WjtB z>`R@8@~^+W(g5ozARtij4!ndYGWAB505yiY>e6!a=PgM!U&?ykZX<7$w#XFKNa`v8 z)iJTLR;6@XqV6;&PqOAv|1N$+|A-OnZrlHHc<=-2>(hepVY2Vvzwf;hM|(h4DJ@x6 zQ}YwpI5iZ?DTI!nn zug3mFB7cevr31p9ZTme?e#ItWsmhLHzSB{2yAFj(dQB z_~V!Xl!3^$JI+ll{v-I19valw(Rt(w?TNrn!{>Y3)pZ9t?9XGWsK5LhuBfL8N5{mF zkdeLrQxM>JHZ(L;Sy}ny$&=pRUfBC*L0bBTj$;iXcKu9?T#Ss+6-qvtrJ_N21(#px zPjR7$A^&4~{s&SMJ`3oj=jG+az`%egNYFDeVb~FX4)r9SyX(^;+ZO~oVK(wW!AU|1 zsKp*ckbG887mZJ-JSr|kFL)p+Wewkutev*{)f0s7f5M%1DC~lRnX^U{c_gX{2VAzs z<==Ad7JAC2W-_MXK^qE|l!=99HK$nk88H_d8;`Ie3e}=qghr(na z-m(nCD+Q1w9T^A7iYyS|EkTW^Ln*N{Xn0%L{xk!FnSp_Up`j?qu7YA;^eWg+2xN=k zr?m88Xeh*2_f^-@h{(b6{`^P)-4Lm(l z^|^`$FO2@VfB!zC7&M>EY#Jl0*Kigek{y+DG1aHC*ZJzEfxDr;)$$8ukN70_+M#-` zGkFcV`puriCMB^60=D-a2$&ok9FX_GsDRFOcUf+t*O?~$zp4}S^h$$qRmgM*`1o*+NrbdL3Jpc=FmQ|V{95~6miC75Bj$j#$Bt03ns-32K#XsMsWBSSS%Aa}r7 zjDeDl?#|v%7nT7+Q{b{Dsn8ri%K;w@$_B32HEQ-!=~f7k!l>1}ylMyStz3Z-TIH0X z#e78=LS7K1yLM54a!vbogyT6PSet7yG8h}LEC>1Xh;*$X>gnp}5cNOUqtlicxg{np zz6Y_XNZiOJ^`7KQ{p2M1w;L@1mG_Gx@{N>}!lI>dyp ze^7Z9D*X9%jg*Rno6sLTDCqiP1htNXJjgi?m~7Tcx!Kee}8Xp z{=$G0bU=bWB2@9j)tRdDEM#S|E&yfVH%IE>CAy2?&c9cgmG;)1J^P&T?y#GT0ByU4 z>|$^`K-C$Aogh6X3{$wr$H(8keG82gp{jBtw^FHBf21u6#{CNc{Sfo$5s%xf%E5s! z$HhAe3L!r;{d9xTd9jyul8csGoYe%6E{(AVtwV;lWaLx$YKX7zEiFx(B3GucsOTyP zJL%~qD4S`|R60vW%D5bYt_J{R5{@PXR~RVnO(SY3e^BbcQ^q_QQE}h z(rYW!jW-SKw8SGAC8HMsjI8&@7FS=p`t3fQ>X+8 z$HuMoc}*5dGP32dnk?!_?6F5nn%lCMf4%%^h(LeAqVb%LQ_qKSd)jzqIM5kU*A)=h z_f4>tfE5?+kEr1~56)i)ec>3oQ^(U>m^HOf&BW2%nO0)?K$y6${PEjm7@Q3X$_h&- zP$(4wdHpa?Cm;-gnVadI1@-DnTyNe=kmm! ziJ?VzAU=9RVVsbZlyp0M(7nKJz%%EfvXT;HO&YqogYZD}t8<$qj`bi{e-rk7QD#_! zBSymiqk*yU2#EY9nSSiKtk&@psa09^X30#m`bav${oOP1{LS_G$GSy&nG4UQ&S%sC zghh*QC|$QPDX;G$z|fZE(*Rv(WW&~LU{GNrLIKRnIgwSfL(uG|Z4@nAtLs`%ZHxFX0 zztOrREhymX>*_Xw;M(20cc;Cqty%mjlPcwM?f`&DDaN$?Lu7I1^IJtK2E=aqLcej8 z#HPU&F=(6l3F&!KQ*JJkuy75S5prERbb^{_AOIHE=}&iWv(y!E3u(|@F%&gyfpe_q zj+tj`dmB@vETVes7px6clmzyW%g zFX?z_#!{o6**@Y@3H|2&c+|AQGIY=$qQo`Gb~!mYXY8ZSsJD+Qwl~%cpIjzDPVC+K z^X7=nV!_EKMfECy43hOLpEVe>mVkpqpU#Omodgip<(_fJgpB{#?UtLBHzmt(7y`5q zs0hXMe>`{)z$$+ttpEGh;QdHABv8_r|Kq!SVO{5gLiZ!8t^4=a*WJr(FiTZ@eSN_z*x4cltBlcAnuYL?Tn*vVnerFBqv><~0g#0cKUodR|89^ZyEY#_v zbD_%2!w3I}4eZ57EnfoxML99AgqZ6Sk(T|BOa*aTrfSlou7AOgk1+$UoeYbqqN1Xp z@YbzIf>n=qsM^U)SGU!Y#B&Yqd|PWP4lZtmB#7m{TGu)Rh912BdGAY+E)t}`arsO3 zRXK?=M?x@M!T7&7p(U7|jjaY+ozF2cg5hKv=`)K_l=c2hhKibkT*DHGdQe%52n$<; zMYgv`zu3}Un3nQhXNz4R8E?PP529yvxw-eLf%o9r2*3qt1fXCyFJW$h{^7ZyxhY#w zAP`);h>|{mq%Z%y`!E#>S0n2&q12%=_2**&30aD(E?~;w`@phi8fOFT^2j)sI*4zR zQ&S^N9)RkB2!26st}{5@V?8NUNf0c~r8=vVkdgvM^=?DOpu!U0OTk1}Pp|*|2g@pc^b!mXDWV&KJ>i-kR^bmj*-g7?ItEgU`APR|x_WfLI_JO$LCI0CC(c`6NkH z@DD|qd2G~A!OEwA5YBB2$E+w5wJ>=KGvJ|?37hsejsEBFipR33RzL^f()MhYNr*y4{)EBlNA@9A>936$UxSBV2h!(Dy8YG*BB(Vuv<${I&N5^65Ne%mi(&xW zw3=1}Wvlt52>Ty~6l1fP=qEFtIY$|6=&kRDUd8YoK`^-iArHGsV`Ry{_~$EB;(|g8 z`^ZEhZ9vga=ozYl8B#}o0%qSHnlWZ>zaT6nWj5vvPa6n;EAZJBiI`E9{GW6%{}^L_(#kf|8s`aU zE%Jd#Xxovx5?e$>q~drbHe~9a(B1(!PyZKD4nImd>(}L%0BG13zv`kb-7 zk+a?DyD-1|oeVaL6u6E@_xTw#I0ZE{h?|nhvMv-QP{Idl=;;YMjfwAYez}5$S~q~G z9k>%`%oIu^;0S{3ma!={3RR;DNvF5B=z$B73UW~pN7Z@h&Ye2|D0nGF2CMZy%CP^D zgo!eqMwA}JZaX?Sl=?CdqBM}{?yyd86SX<71KAe|suLlz_-3Z9s;n$~5ypVRkxGV& zOi~EgbO4YZ=1m*SGbQuqCaPkf%AUYLV{t0H0GjF9S!6InQ;s1O(rJZ^tAZ^lCqiXa z0R{wce0qHRgYqKGSi~bDri)ZlL&F)CIyg9ZZe~VvKDU`EHfX(q9o1qtuk})F3gw&% z)$b33gY6%6IUhGQWeAQrHEw(WL~aHL6IIC)Nh`7nlN^wC9T*~=a1IAG3y{OnNuHgA z`SaOXRK&zD4r4A0VxnqZf@~)ZHT5)&Ju1Kr?jv+ZK}WYCGa^a@*VtA7u4Y2uhvTEE z?Hs+LStl~N4nMyO-Brr zDfT6bqct6XHSL8m_Mbm$@9d1zhA5hH``2X;xZA~rY6+Kq`zr>z{Ha`Y9A@I!iXU#6 z9WobCq)>;`UHy7&%TR#9daa;ndC622>dmxlQU`cN?Mj=|F!lr&rN`<~WKPTF8zmOT`5aL4U-Qc@jadXZkW#d#5!b3Ly zyXr2i42hYU%~1FQ43Dz;GhRwmS{m(D9BEP)i1`7Y@CT~{_j>mTSQ7s7ve9=07$lHA zLR&Lw3?vh3tDxW4ik5^^1+EDJ)q(pdCN_NQ_DL-#i>LYdEP%?fv4ya=qM@(^G*k#d zwm?k_szb;W9mQ8-6CtXA8!Hguo;3(2JvYL5EGj)oBDhg;Anzj8+BC{(e1SN4DBM_ z-C^<-+Q(f^u5sz?_$LC&7v{p6Q+s!L9GU4I4OK)l6|EiAGsG2D-%2=^K-l-sT{nK$ z20H1tk&U1$@lAxWQ>F^PiX7g6D2RO8KD9J61=fEEt}UQaaI)_Yoh4j=!pd7uK)4WT zcMc9ERn>U!C!dbA?jfd4I2Vv#lVr3Sp{uNH^69MIP;@DXuMcf6Sjzj z=sgC(KZgLb*(|*(k3I< zE(~dd=!U$Wj)9?P9T!=eYu(F}P%JM(4E>tn9BXmuVEPmwoQ1-Go*8}uWiid0%#4dw z!7Z*^y}04#JhZVM>6Jw%@5^w0pP=Wpz_$C8Cqo=CjTGF^>VTz1VWk=Y4gpg)IwMYO z3)i)!3pvs6$2)0apjuL4dcu*#4i-0i0Vnm?fYVTA=rr_04SWG-mBbDjNHVQZ&ls~S zZ~qAexXaZXjEsTPIXR3mFbej9-p0~s>NE`G9deZNKw4gg?~L3P>hrtWpF^M64m#I_ zqF$ z8em5d=LwhwzmxV6jUdsug4HP01QQY{9f{MOIuO)rnc9xER_ zND7dbC}ZQJ?Y_i;jC6q19cs|!&COB+YsNht@ti+ENjX0vBxF2P`5skKO2`vKQ_G&V zzBn&Wsqrz46TW}GRsoZHoyg;FcCKJhgQ`LtwZ-zXVR0mnQtl zlQ;i5dfMAH5IQvQL3v>9yh&YUS(#d7fN7-9b`3zB(1rUTI5_qcF|o|WU3x|za(xSn z$?dhd@USpYqh#A?Y03dPF@}WrcnN5mwt!%wuJz!c1|T=ZA5lgS6Sp_-43@*tE#L*` zfu`R6BxSR?E~5o0{ymqfQe=M&OZ8$v@w;ea51G*oFe3DkLPwNx`11Me7ZEzDaz9U1 zejECt?_pPg3kHc94+IIVQXa?th>GpiqdFh>!dXkoqHkRKbY;K9h^YTJOP2i*BFh@+l>m)8mw-2F%b4vY5m>B3URG0=>MN?20ecM!nR(juWT zykyU4!BghQIdxT`6`9Qd{XpMtMA7PPR5$N)@$x`vh}=${QB>>Oy_`B=w)^`7BV+vR%&j2w-snt6tB9&`O(=e)Rk%F030rzR964#ICL zDB7@8^P~RT^wQ2vad2`X4z!~>4=M}cy$QP@$CEgfB?QhFF93UY;(c$gMs1E4@PX5M zBzGg;+<{q})5mcj&}wO!r2y5@GnO!@UYMa8M9LsRdi(2hKqb}^FkV;Mbp&NlTZKV3 zX)qZH$%hNnstnFIZ+AIahO@N3dZh?7U?HHGuWfDhbalmlCHvRmoAMn29SG(xv6!fU zC|4+6F${a0W57$Zgdhr#dHiF?=AjqT+uPg2qv~c~F7&EI4-FZHx02A(?iEPwE0$?b zU5~~!zLytv;X=;WLEF?r!pE?mlSM?}+f42jw^*o8sc(>; zC{nL$yERH5GJ&eZ^*w(PH7@u!E=xJX&_*JA6tWB~M*81AH!KqD<8YPJ-~W&S zmiZ(Mb_ckxHM7$Ve~VV*h4(q&0+i@|1*cMO*31q0p6K#Zlj>Ke%K}^PL;E{&X268Q z^ztV+vtK;Sf?lXSSjziA9+~ew3#3n|L|4eayY>V#*B=xnu!qIm4x7#G4@HqA7fPB{ zJFGCz5cJua22OioNm5XuoN4|BcB%_0M8?DX(KS1*N*ITDw={`x)(AIVX^-K^N0*Q?UXr`~|8?7NG z2kpAe;V%c9z=N2XnE@Xg5gs1PWk__7900sm!R1EPY8NRU0JNtedc27p=(Y6j}=?);22>=B_Hpj?2;Wuk6h zj%vE7?(IG~xjPVHv_pa3g1pVT#u)ciD0RCcBaHpF@OS0m=XVD|#k~dbDZR;Bxp2h- zs`e7D@0msTwQUbEoJrsqi$zRuoWI=`24xslW@g@P=-&V!*gbE6JnlMdO26P>~JUA-b@hn~gRf^91rY66G zy=~wg6|hMF%p4YWd@PC^ms4672v*V2(a_>JO|5taNF#QEh7u2o0sb$~gcp@9(u9#4C_k7qrMugBDQm?{x==pM`bIoL7Wi zlxGIaL=I126L_zFRI~s}D=^|q&}eT6EsN~oj1n2y_2dzsyZk69{VDKgINAZPnUh70 zGyOiy%i)PGP_^^<(U{nd0DbN4MI|MY#oIDEV*B9)Mwx1zErui9>BaZlcmjcL9H5d#+1RL`?GE!pfSA_RA zgpdli3&79zOmL#$%=B*N{91d!4Jtk{>`qppYx%Yz$>uGz;sj>*^`}y{Z_wVG-xOP+ zE)wkv`Q_92V;^rcmv^9FXA>s8GZ$w0D#{LQ_A9yoWtP}NP{%zpI~$V^`wrb}VDM1w zkTZ#t0W3DP|3L`gmmc}15Tw`qg$wU^lF#ZOPCpna4MpPyu_|1Yrsi*I=ba;2Wp#Q!Nc)*wu)iVg>4MN3GJ-^+O_VY`2bjf3;> zH18x(K4LPmjAX+eshn)U`Imi9W_j1vZYT!#K}X)dHb{^!7b?aiB} zC2WVALRRdz{+Qt@V=!xNB@dS7^cW`-(a+5RCxFa0s>1yuko0a!cKQ6>w@UTfW`IeSEB>*o9h&_7-RF!fT19MTm`=I=#y*rZenyk{P(?w zo|J>-U@3!dWGfF$kug>*ekg!E6~_cb4Ay3cL@W-lusXE+&rKot^VO^E)4=K+D|qi^X_>pZ4J915#0(`q0}NC7?p_1POQ6x6 zcmuM=6NH4VJqA9M|8|RA@llT*w4jsAR#qPK`(p)bGf&GOdrB%Q;t(EcY7+aDMt#EC z<(`IM&OlFZ6QaQ|U8v<#?CwrM*v--?h13F>4j1*C>s)6#AZdlcN9*Bcdx5%k#55NP zQluc829YX=*xw+!MZ_5!^+@ly=gzv_SZIgV{gbN2+52~N@70D^=$#u3lTV;UW_#N8 zrTO}&-T%9KVECs2aI=ppL5@-A^ZoPnS3m$MT?o6y>-W-`e>8M(_zvYP7-9?XD+H=% z_5R@1_F;Fy+w7qU@bQVYr#bkdYifk+HreMj#gjou0Vd2P`60~=`!1Fc*3srOhrui*Lvi&zTP17y^qerK84W>mbAb^O3IET7$ z%mGOL^LzHN^PK(nf-0PqZ^7d~v1P&n(Nk~fi1j_){w|{8~q7;>8 za8E;CVJ1cA<&*9}L~Waud9Yr9XjR$Su|wip&vrvVtJHx1=L>D(__6##Ew03)Gy)lJ z^&QHLy9ex7Zsc>>_b^Ywj2cE7t<^6Q*nf_!c_K|KXI&JPgtxn?DSi1btey;~82Stn zsBFBc!!6ESKzGW)2p@6=hQrv*z59&z(3$JAo7;6jHwaWH?pq4uW|Cb!Jq*Im<`9bk z+6qcj$dZ$V|LT5d-v)7>i&k(UYrzt#b|KSm5whHW7CtBl_qZIg?0�K?WojVz9LR z+o#|IqHARSg%WN;JZB2t$&+o{aGGsL3NpNv%1|vLaEuqrXZ3|>4xgxS4L$j4s#xs)zz z6(-3yZ;mRrH&eXQ^?D=ad*-2ZTH7CwzdCD5U|RRTI`6Y1qF7Ll#``G|8PCn#g47Z{ zy^zzDHX9O2>Z@7ATv04-`Oxh&Ta-987ZNK>7{5E-| z1V}HO4;%oPL<(MmgUGMG>Ycjx#oYj!zXg`yHrSQD_a$Fo>gMvBLVK@$$PC5XCcI>o6HeMGyMG7Ge>Az<)mfT{vmaf4n2y;mk_xTft}u)lz-_-0f3s~8czI+ zWTt}~p-FA8p60IQN$`&l8_|I$ZrkRuf~!f3+?%)A>a)E9zZQbmlF4L3LkIt2RP%N< z7CJKZre0H+954>LPv)`^i^|Bx!{u({JSQJaORiD2OZxo$ngFH8iM8TSB-5{NX5Q7z zFt3m^)YoTPzdmmis@*C@lT*SqqNzGjSILK~_1DD1sLVF>$FMl0C+5qy9nB@}{#6Yh zwH|5gI5jva7#Z}2n6l*V9Z(0P;yT?EJ5{zFN;15ua%HgCUb|+LYQb{!HQde5v(Y2W ztX-vm$N)6{L2~W(Ag7AhpRU%ppq`?D@kY|5#M0~(uW{aA4gE)*FTGxADIdiA{ngpK zSMTy}Rt7GJH+h1LncOdE@&}R^juozp{kwO624j@?=B7|roEV2>RQW?FFz<^hvlfd_ zSNh$%*t_oFmHOvNU0d5YRs|lOsi&FBF|p^*@}AI8QhMd`^-C@_M(ctOhzWCMI=SUe ze)+`Mv@PMVMVtYvFMj>a)Fx1IpP8#f*nIT zr%!Y2UhpA%7j0L%RaCVm>*%G)ROS>xPri$mePCO@PEA!B79DtP^k+I&5zaZW3;ZFJ zI5#;-B>9WDtnag5{mia@@jAVoNjy(MSziC2=7C6`MOB_xdOf5V)imuttvguzT%tUG z?drh8W4?ms`I4(CGGBfxbe}0Cs{f8;?Dxd3DWiQ7A0h^B)o$Id#u+?t=_nEjM7;jE z^5xcbw5uI;r~<1Xqo8ooMp7~l*(XphA|+>8z*(->7#h&oewxAzZ-b- zIajXRVEZEZTR9P$C94>{G4Z$Ps%gAj5N}nvUU4QJsBSfRF%aYZaTS}yPVU|Um0dOG zOw=1S?8;Ci;4GlLBB^YCWAa$U^nhPh3f z2e2_p&mp%X8|wlimy=NB=PRAw>!LNq*E3VpR*p4l(LRNSo|RQu=@FUSfalV5S~`P< zOifw4!l&LZDe>nG5b0mCHS!Tn*M8T@Gj+Pg##>z&m_oM$c}z4Dw`vrabymG^;EA-U z`KvRNa%(7CCSO?IpN);v$XU9t@6L5^+VEQo_ERn~`Ax{DHeQv@KrP6tuOVZ%nAj|v z_!LFcvudj@@CG$1ym80Pw9xe{K^7s-k_+F zg3x!P!<(Rc_h8;)jMq3cHh*%yRtBht|FxA|W+zI&_Q*d+XThW32OR)Z#;Glq-M|H` ztdh(W4-embe;pAdxEF>cGtB*S?f9Rq*935HaGcAWZiBNHaGRMVR>CAuUeKWUiKqf{C$)09a>uZ7vb&X-6WmeKSAA_ey8Yy^MZEtEahD%?`8`X2`EzTQwL>R zL4gn}KX4-ibWxDbT!MmQ+CYxtk?X-mpPn0gh9lV&LmT3f!^f z@Tw__3@xSjBkRXBL!@O3tC-^uxGTV2D_5@czIIJ3#dz7f&%O!Q>xPLao@O*m_ZCqA zC2?|c(vdxRz~iK;=|oR8+vd$iFh%!KtiMj;`LGb{^L`Wo+^vTd$Q$D|E)YpYIKJZI z;?l`u-f>AuVMMf!qJN}aU?yz@`@YR-3w?{fi5|CaoDN;>0rtZ0QoC`~PdNnzsF1u< zUfRBf%efJdS(ZA$5?bKJrQRWcm6*ldLN22-7!DWpg1EO5E$#hv39&*#yzeoF-DX3Y zFsx!!g;k;~=%Yb!mmRN2o$P3Sfq22qlO&SuFVcNOWm3BF&r`vRw8>2{?b81mX%i)a z>jFN1LgaJm6b#$=V-FTDqom6#C_vdGFLXVL&vQ@Lz?Je3Zg=OiU19Cvcf%2$%ndJH z_<67){vFYg1Vq0bC`HaN{8OsR%7BOFt&OIOJtAKLYUp_~i#FDz;KtenNi`moMXra3jbxc`MO=7yHp4QRBRBu{prx2eA0Pk()FzW_RhQka$GL zrT4}HWZ>V!Sv0tL5GqAQ0V}9kOEx0!=UjHoed5na5lnF=KlBd_+|m19^=N@fPZ%|@ zXB=4LeP-IO`&f=(8zaK5yM|9MBCXshQ(ee%p0DT~4e8M@nE%^*e%F0{Px}4!zRz%? zyY3N#Kjy=)*c^t${p{i5-E!4Plj(oq!+7!`BnHsJygqJGHby?1(XCUZ;fk+P4w;~{ zw?&gE|F+tdH_wdsY3sjC(!>eH zuQA!Tdb{23L+XtPuUc$#<8%I6^^(Xg}S7cOSQu z`Ox(3R0MnFI*T`BZP&;!Tu0fQ28E5B2&j|kgli&>Z>F_VyoW5?VMw>wCL$vv%~r71 zHuM!`V2A*Gzv&v)DJ7*f=9vzIWjC0F;)R56hdl}y(#q_TfZot@?%paLIu_WNe$hxN zGLVd7Aq^207T&#^(ol8T0s5a8qx{YPE!Ypn>*_I&rj=Lk#?Y%r#0q_v=%0CMp~uNy z@_W?gTV8fq^?|D|4df$H@!+>cT$xS2CGmD#u&@m<7^@GaBe#X!jGlCDWZE{C8n;|U zQ0m))LNh8UDJea@CgSA)#R!&lP$Ae5^A}O@)$*PCQVJn9$;iu-y#G!8>UMzM?TN)7 zACMnD{OTI=_6)~WTd};tLevg*UJ~aO>#p`|(8@x+561H|#`fWkMP~U*dtyt%tw>zp zvJClt=amXv8*j79;yOSZrlYO>94yhTZATjVaz3u1r3KxhsjK?|yd21H6(r`N9U2D< zmO1Fh@Cz2U#qRYOGTL%Isk;UR+MS!u+9_*eP22U5zS;zO_gf*wDgiH`F8KJIVJl`a zBt=0`2R}o^wO3;_#9e$~f2NE$A>7yD-*j}}x(N0GX>>hvC#2%NEVR{@#4`e%X?k|n z1R!hZ5&(8o{dS5Q+5q0Ne#4y4pL9zL$+~#CpxBVVZC-fT1_7K2HUe?I-4(~D2sdpT zsF2*z<-~3AUGDFHu%vBdN}zyReC9D`9au*zgPyNX-?@IpaoR5&wzL%)2f}ATZr|pn zCB16;t&}mkEZrs~B(!<+1IYVenS1h{#g|yRHlNvsCvG`Dc(pWme~Cp#Rc$JSsv0FD zOrV^Wte`qBE)^6S`gW|%&rxM}(mN(i`hXJ>5)ux=GcSVXPY>NAB6i~$bc$e-l|Rh) zKq11b2c(FbBu+}R2d+;8#Bjq~55@zv9EADU^(S*Rm`)?Mf z07nK^c}p9D6}#>;TQk{KrGPt8xvie*b9xoJbwT9z9lb&=qPiE9m6e4*=uN|iqk{1T zMj}ep_~6C3s7iDO;Vu^y6x6O;><4w?mp#u^m(Ksoe}pX^?KSB6jWMg1JVl%(mzh^t8fIs#k}0Xd*NSxXWgrHhR@QiPQ7A!>*dfLahP&a zbRMD6NAVSz(^r1P)@N-}K~*Ru8)uTf8-rM*@Zkk1)ORVPIbL2YqhON{2C}_= z?b;L|x?xWLk$)h{ox67r&x7Zl=dvj_LN_de{{#da!3cJ2c*hg*gDIt6wF(&5|XM_-cJNzK$MAw-~kQm>Y9DED0=O=$O}8!E-Yp@@{?&V z+P8o8C1brF<<0VnI@R96j@x#G(Q>c7@?eL&46R3048445wDO^Z0?CI(@oW@%l=R#_ zmni6JE^K)ICZFHDu2(zZRA|eHORR5hpXk@7S1#{$bHc^-0Bn|q1-%T)8tHfmb*oCD zqnIr2?r;&O+tElnfFY=?imFSv0p|ayh`kmwSo#RxgsYZTJz7}xCT0tw?&te~pnWg0kbD1x1WU-JGVLfNgJPua{?5CBz{=G7->d@;> zIgN<)`gOe<%1ym6F}W!KZN^(M%3b0R*TPcBwZ-lMBFVYAxnW*KgakUjwq2h--CIZE zmJp%JT9v$h(JQIP#}{4jF)CWTd&EeD3$*~|8V-HXP20HdOZ(T$Z z+fAQ?dz<2J=I*}BV|Zm^`~LlQm~lkHS@}-a9}ta-(b3TXRg9T^=r8ths;{}D+Hf8SoF@#$|zJybx9F0hvv8ymwh?btzV z%U)<(K>x#vBNEQVi{y{H`FTb+-%#QYhz83cBor)^2Ic+y^G-_QVrRjB>(}$5qXXU* zXsD|T(R4$7{Tr&U13U1P2mkviQ#rHa0_Eq|EL%nzJoN7`0{@EifFZB_Rmm5bwe#m; z{>eSwmxnPk^WguZfAD}|=;@}${B@Szu*Ug^g>iKWIZap5a2qN_Wu~)-FN`UmJoM25)`m@uw$J9 zm#)3`gClxRKBZm=EMg}clU;qkkq5yIcC354=RZHd0|rI8J0*PjbbD?Be}GV5a6;%V z=L?RCZCtwNv=5XVr&Zspp1qTY=N#5v+6-{68WQ-jFH2?V{8u;sf+Uu%7wcoydi_ssWz3~*eETQ<+io+Rj zv=o*hCg%mY;$BG@{;aFi=ue7>2VrOJA4rz>P;QA!e8wA*Z;Ly0pR$4 zpB)t80ssaP8i&52p*TkAz%UTEl-yZ3dUG|ZiYbh{XbyU!Rir)l42{GQNy*2fK+dP` z=Lo2aTzR+{EiG{qZe(C68Ogs+7DArmxwbrtz!>|<&YjAdnuS&A`M7nA&2QB^sXM{M znUL@>GP2>rhh3tubtBwRU!>%DABE2y>JYBKOA@5WFXeT}e21&z@>R*QU~}l!uSX6L zJ-@dQBYb71{;x)ds$g|8>`XbiHeckTmh7c$=#22O8lLDWlHU^uD8L zI<MlYV~DCq zvxR_qy#MeG@(7I8FO-i8sM#5)8#pKt!zHm=0J*~GS7l=b?sBRsPQHT0)G6B{s^LRa zw1w(^i=KfvuD5y!69zqo+oEp|D=SenW=^wkKVpw*yHXOA*w)p%i0_^{1Px1ZZC%34 zbmZ{il$(q$(MQdTBV3>FBwd(ytt@SjGOUvL5x3q zXo8$CP)k%@y5Wx3{*Lh42~F~EbuwK4sTE>3X-;^zu(0iqK3q%qEwkNlL(JDoLynja zPQ%zrKQid|&^~Wxkx%jK2=WMdIMZV*#2MV3#L`ufBW-CA=gTh5$mt-XHr7Kb-p=h<)CU@w?l5{u3cvZ zTI|N)XHQv7ET7=B49=ZeJqmWEZneryB6Dose2EcA*<kP)i$yGe+-=|daprO>_N{DUWR&CV=;|7=Zof?)kx=ha@3dQSxY_Ni zWpR|j5TjQ~V7}qi=s>6Jf3Bt4xab!TUCdK~gF@7zd=hsj0?D*aV!i_pVrj`K+}9qh zo*(tT9WBv_`VAJN+Qh1w%B6gKe5n#=a4|LSLvEQ)mHAlfoQkjBU!+&_fZswB;^7#w zKYlUSOC?Atn3y=boTZeND+y_Kqb_hr1?b5`C_h!yKy+68{3#z^5n%(T&H!*8?k|0- z?rfu9OnSTlxCha{T@2X5JfV2ruTT`r%Wz}kMw6G8CRSc|Rx?-B)bKiwn$6bjA)TQl zehl8U`VVazWZGe5dNoa8NArJ>{qBPH8D6azy(CZcSJ1uhg{}sSaJ*Z8jZa)I8cWni zV_(Ug1G|P{D{uw>NoO|mnwNMYF*I(aTWDx+(2H>h6DKj#~`5W{PBQU!W(&k z^T+?9G-*hHC7W8-&RkuLR8NUgCf}#Y^hK76WJLete7rDkKg&gF7L*vt9#g!6dN(Da6LlJuDJmyhq@vCw{y9@A6jw}Z$agkGo5Ow+!y0~Z#n={=h4y4dR2>4#!e3~2Tp9hY`}x6X-AU}Z3$J(vMHU!lqC+$>fm*KA!w^h<@tZdf zW{`su9UE(yCKjIng*131O$DxzOz8oA*chq`R&rT?nfOz@G-- z3j5#QB&@pd?%0otQ#d5xJDvdTNGUF`+}E$+(A*tvFMtOIOhYR(GV+jj=w6r&eL+K; zH!Z%QC3ie^C2hNCgq7-ljY%XU$^q{}ONZOKD@fe|XhuRpLJ*--bZYelho8T6#gM>w zkkYP66z2eh2Hv~3fsT$3O0J>xJVviB)YWMO#w<-XK+*@OCPv26hCaxeO71pj(xP`b zWS+uSvp1}q2G`BE5XcD;X3}Fg|EU8V8}WUJPj_#7Zce%&hKmd7Lf@u8CwJ1Wcy;~9 zTk;97E$pkOkr#w%0T?<4v*qEMJ}@&Nm0VU+Lu0s=zOy>}X+*?DcH9HQuI}#cfqS@i z?9;wNlf{NV8U?BH462ycCerEH!J%hRV+?$Fs%S+|dQgsY3+;%YQ{|#BTYntxDFJ4B z78WSGykYE`x-4aHKMslHX*23iKV!yMg!3;6|aT)%F~xlajS!lGhg zU@!~rO3S;tnjy}!Mom_haQVtf<=?K4}XJusyeq8rSXRd#E;lSrc6lcVnOIqZ(?8lpn*@e^{!#(s2xZfA}3vI5GNLIv(U5sQ-ixz)b z`Qu4$VO~M1kT+~Qi}}vx9ErqyAi?K<{47A`#cvmp97&J(h8HhwrTzJrIg2RFyj(Wo ztVvlqlDEnwQa%O(LyQ>b`aSlJ@K|RbA4G$@LsV41toE^+NLjgbnO(F)#;b>oE~<{>xvM>G9?5DO>bEBhIAf5A4;}?qf*8l z$u=!hWez|f-X|9_13ytvUi94eiar8y`s!1vM6$q-pi0L?ROVp%p!c3zw_6b}2I?yG zm6EDk=zBTidCqru)qx?*FNI>EYe#YJ=Z z9X@-9JOhns`f@o2(0z3}S$WIrnpa&$8{IeXP z74!A=#a)VEa}X1+Umpr|f=KDcjT<=oKkoZmog?oCGBeVX$D%J=rJa`DY_$r-6e$i; zH#V$gWDE%kdf(VsI-C)=QeSk(jva7HK;VlU#m*@JZ(i4~J?IaSXfi@qZ8;MsUb8r3 zo4q6Kv7p?bAqy5bYYdF8m*=w zOcT)n!ee0On&FP+rRA07{pdTudGwK&=O`QD!l-_;FJEAhv@@v# zpiH9<3Geb~v^U?975qeo|6)?v5gNHTaeLEsIP5AfSEs9bU?hlQw3o>e3jNkRk%10Gw9r_$MnC)q=z|D;{>S)g1*9C!3S6vclyx5)Eh>r999codXogYS!a^s@aj!cArMu-L z-Rt22AO%mPt@61w-iuXls7F{jsgr3N@2DY38!H#2@>$Xg1u;yV$k0+2Q1^faF&L5> z!PuG_wUk`^y!4Bwt*px4z76Fyrzzp@&arap=TLrxc`79hi$Iguc|WDH!J7JU382k= z+{waKxH5b<@?3r53Je9onWvKzqAjY8YWUfAb3KwxycZhEX=hMbSE6`t^ZdX;rU z)9c&76Y03#gXV@e(G3!bw9$4y@c|{pD}fedm+5q~c$x8`jTNCG$oRw7Am9m~{2d!1 zL>Gi|6t6UlAZOT$&kDF7y0sEW(AY@1c&v7$3wuUu*9;@8^%0T7{8y^LH4wpa>gyF# zy1Tadi5%jQ`+PfmjrKZa)9xBJ2A{j5}GrU3Koq{Q}M4GGqT{#lwsSx{jsVJM4pglXJTpUOo;M*VzWnQ zbs8_Y3F!NeOziT8<(F5KJ#keuz+<p+?(TG3J3957pE0~Ox4~BAw!Rd`_SkEk*Ug(gw(z378WJYM z1y~vg6CtD;d{}7*Ll)wG13x7{vO6`DRuyrlyqm8C(0AI?wSplZ1pD1?jI0~S8y(Qb z*NV)Btb62x4U!1Ax)l9h>TdL|1^k39%5uBx^{Cm;f$z#_`X3Pd@Q7RwFdr;C{M@Ep zc0$oC%C*&&!oXmE6?)vtlV0{#ilSrdODa_|cGtkv-A2m=dGS`SMf&?cE_9wv6vuM)qUb;%7@+9^CLk zC9k>QIpg5siphg@tQ!?gX_kvGlfEirr)Q|~JIm9j;SFJztq!MFA6<7zd-=Cx>RKhX zE53yc(woFe=6r1$gih9+9hA&PS10v zqzyo4pT3_-a>ulD3OWzVxsSwdXlbQ7?u6rK|&)i@B`~77k;`?&b zCvIQC2Fq0bZP%bMMQ-YQ2CkXQOjOB9y0R7_EW?*eP6o{*R-?|L2JacNEGAyeDy;N8 zXD#)zZK^HyrP^v0r`h-eP-hZQ`R=64|K?y^c zO1K#)l~?$y+cY<(|Lu z-3kf_)C30UQ*6=fRao>~q2`!SzL-+!<=W^<+*SfkoI+h9nQt+Pg4Qmvz^er-#x?f$LKK|v?1xLoo zl|OoFkqv&T5szZVEhW<*)}!f0n`vsw_VvJ;k}irSo%HzDMKPI~LYAEBX;luFA*I03 zdQFhs?ez-=+_QNOnoT>StSYbsg@0vGcMdsgfa5&C2q0_|xW$my%^BLJ_e4(gYA8Vc7_|E?~Vo0oitSw%}Et!`2}7< z;OiJ_2Mi>`liSX6=gg#rkEGok<&M^l`TIUuD|p$ddV1^Hx;pPzNF{ z60t60U&*oXjEQq@MmOnAZb^Df2yKjAJ-v;tn%O4jTfa5xY*qQxEYa?C!#+bZH?bsv z^{n39tiThF>KwPEY;gtSJyQ)jT-MRH0+3nD%=IX`TUcA?Ky;>-3J@0grss!w_w7^B z)o15sPMs)Bd2f$=ZqE_b%%{T2he{nrI||It$%*kagoMRpc=E3Ro}>BeY}%M<_ZdDi z@O<0c-qQ64VR4VS$H6IxVB2IZJamA{7r%XL2{~m_(n&)uu3DA-40Lomth~Dqb6R%n z^c=SaX3+3$!x2uo`+Se;y!fKqp89#^tF0D;*=go$dmNLcXS9U+9Dp-ZFG3%82k_zG z2mze|uAF*hZYE;r5Cv2MzUa^Brn|d0fO>Xv60}x|0)*O|-MBw2M)y_DV-7(bwWg{dlSpLTfOk&qtvBbh`+Z!79xw9uP zo%9mbF{bQW;(-a{69_BfRE8B76%Czp6W2rl)9AOeeF-mSN5tnwVEMzW;f}x=_b(nS zk5zADQ>4bNBQ4z##)5#3DY&J|b8I=qXxr@6&Cy}zr+eO>o_6kShVS`Xi1iZ);N7<0 z?QUND^?WUIBGZ8k%#KY=%n>=!1NlBlX8#cbOxUD;ZW)!t8D z%sd7*TZZmiRdoTGJvOD|R@S2FO9N z4U?YDy`~^9p$NSo!ssb z>>S&jG3VxdZW-bQ!!yZNN9-VOA9i0oA;00!r@m-p}q0YG3U|jC8 zK8C2%^kz3$JsNtAb%ah277Zp8KM!`T_4$zH#Pd~;hnqv4cdFFvoO5s;b2H<=+P5d4 z3g|~M;UW0XCdqU?EiHmy<;s>l%SWvHm(6zoKM&nkXrFCh{hUtDg%+(l=M=(w zp6M;-p#JTIZefni6KmdT9AxvHIg-8tp~-+ckOmai`%ao1_QsJ-&kzL%Ld z8zqxBoqd+f541OaYKbWfB)#yBjkqA7dP14tAeHXgoxE>X+c+72>-(LS= zIVNNGu22UttWXBE8X#*n+D832DQN&9Y82GeIqkl}z*TXfvEBU=>YjbBs(cXXV~Pq2 zpK><;JtEjN!?1c$eNk_@^)t7JpILX8>C8W@xY&jBQ+t@Z&diQ? znuec$f)?{{j};>=Z`FG8Sz1AU&wb9BO~}rkh3p)ABn*)3qW9Wi@=TmHUZaWC3$iS>yy*(Y1Xd&I5?>2`Gaw< zSv>c;_*Wjkx}hHM$%jf-gX=6nedB1n|n>`X=*-&N+eKvZVCp$_@pGO)2BngJR=|{T57w<95n9E^gmt!<~NcfDFfu$o&=w z(y+C_WkReLcRawkV@C{`>>Z8FF~WVXlettpDi5Qk(<~VAcslXp5VXUNS5#%&grt+S zbn*wcOGp#^hSs#fRf>O3N`my1^jkY}GQyG3axSmw!N4c7AA_>LdfbLV=@TcS?G4Ed z$Av-$&0zfR@GOWMG7WP&iAWKE#{_7n*urscu@QHeZ=pUlOOd;?N*OeV<|mALkgb3# z3Kj>A6eJ397?ME?5w0^(1oAR6#-2aqQgLFti>Y^=g)J?NTcZmSjcLJUOP9jqRh^@< zh{8GxhRfON+^;dAyQTi~d`Z7Jm|dyTzsDtI?SAbmRRv#FJmh0~(GSq5tU!AUybs~0 z=I=!3Nr!Xu&)HFkIdSA4xk>f?csfLwp_uIhecPAud2HEhiHuT_i z$05oA9Hcc%1X+mtE1b}Hq?11kwc?%o_dhf?>S3?4Nx`bK@ZVhfOy~ZZQVZ(^Mk+H!qb~O95$U(8puLm%ZfK||B!jc7Pq;peZa5a) zc+H!EZ$#Zu5pQxv%c-P>$?zJfK|vu6+1<7#Y}bvW{Q1bEI=1o37EDQZ0IDhcutt9hT-=AVf z?L(EW34-B6i6G44_=4c3fiMa1Uf<(Et4o559y6gPkw~SGjQxH|HZ85Hu0{-9ryl7s zEp%hArhhv`|FZ<*e?{tEJ|sYTEcV;m3>_Wm06(8kp;rr~xs+mwZg{d(Iz0Qxd=`9H zRH8pT+$l+xO&E?C{PXu1<;`dmyB0P7?fWhwdqHwG(#_A1`Ms?2FBuYW=xJw->LmnV zuhtP5AzmDU6=e(2voAVvk@@WV;F85UI}+l&f=gs;%sa6{kFH{$_F;9o0Bax?1675x zqv_6yB`*%Uxy=G!>}dS_zkjVA_m+U3U4K5A4SU6{=SdBcuz?hQE_ZQhX=A#%f5_(@ zT*9qCv~fJHw0@s|p@sJ}C4c&KvY1E^!x}a1i;y{peR;Ly4naPamH9#(OHGYsW5-RW zZbqk!R-S7Ls$rsf4_FX_eY<^I zwj9G62M!)q*3M9e=40lb&bRHpCNe#=+Pfqy8`2Lq?~R{m)g25EJ3O&tsQkvDT*;Tf zwC!ibZ+T>+__!{Q??ouxK0C#ri@!Bou4}MW%(Fn|di`(H@3XG3&l;#7f@NV|E!XS)8@Vs|Nitt^NI>Uwk1}EzewOE5BOnk*9c0|w z)BmanN2Jh+g_{0T3TIS1b<^pPkRIT57}hO9cPNIHj@Tt9Tql2_+j-01KX=&Njz$;q z_Wj)M4^yWPsbN*zqnMbh0}9ywj{WwIvyk9?#FaqJC{R&VRaH}yj&*O$iFb>ytBJk~ zm99P0J=O^7OGj51i)@DAj7}?EfV9)nB}9vMd_A4Ip(~=qOHM=i?HO)n9;tsG``dd~ zX$@?a7)Zzt$0vNr;^+VMs6UT=Ht%6gwa|Ri-e5gH}lbtgEu zn7b>s-jpnq%%04&zElt#E95 zEIoXhHTBu-ao`z+LDdp>>bvHE)HyniPhLD1tZ$-m` zrN?$d9I?dnJZbN6Bk1<>uLsl%ZTV&Ehf>r3RxPF>YugF5RMKtO@P^t)x&04)MYcB1 zZuPv@&vlxouWS99HLd8Y=Tc`-z%O53I_=VRy%Zb?4v=+?ZQE)Y&Jl?eI#$Q*-b@{} z!>2E9I&L0+B8+=X(r$~or}`8O4RD^q*>HMO{K5DOfk9#C$R8QSTm>LV1Az$z9Ws56 z1_DyNkd=CyNaFje16%dJ;-oK`%4)krV-MRKI@2eMSU`!@E>w=yPCxtKP*1kbbS zzvld{5)g{^zWmJb{c%(8stdSpslQm<^ex~C1C98Y!J(`;@`zfPd*RJzyQ-)zvZ_H# z`;Mswc{q~|r;?Q?@W~+dj!L^h&OOPsok|ioUPpx*Q*{%^vBHw;@nI@~N^i*$-)05u zDdLwvV*%SJ7%AQn>{DE;xEF0t9MPa1a(@HL&n7AN)}1@)a0h|ohb||Tar*O~$s8(P z3fF^}YTKuFX(8nrTVsp zoV6w@X=FC}62*gDvBzTM6n~Qg%xfM?bHe!Cyb>E|y9bh^V$x^y`dK%qcdc$_ad@ay zKH*>BF%6IU0MxaZoUxuuS13PTC^7S-bMw}%En=&(9!u7u0;#Pw#Z88gG;>SK=$swSmW71yF#leL z#clQTfdz5wF`I&+BhB_6ST(YE$DmlO@P|yF?pdGFIPF^hPf{lvcvYn?|Etu@IX6sx zzyEFrSJ^zjYh)`tcxIqw5<63W=U)D` zY85s}L@v)*mj1n{06&wSbBZiu+pz;B7fEs3$q;#pEB>W_BlGyw#TaNPvEuVz4)WY z-P@Yr7&7L?|HeS1VFZ#eqT{459qN9RayLw2+3%FoL6Ndx=V_t(1GoWfZPP}=@hzOUnq2bTRdd(0~-TOR$Nl$1$(=arOpYXN5bWq-MC#H zOZ=G2n`__DoUG11UoP^Zuw73ql8bWm4KNHgK1ZktaP2J<<}}O>q0$!ns(cGA@zCvo zP8+44I?H*H=ucANWRGJA13!<|X_>a?frp!)%lK_@@Cx7071NoTRkC;>a?_<3Laj;m zYK~uj8bdO}SFjSl+onBj;%f^if|j}L`c^Fd8GSi;KDoh*26C8>u}~B7TQ=lTH7=2LUgHk{>xJf z(?`=4*j<$`Q8_sUuA$C&YY~4nruTxy4pkMEW~VNuz~ww5OnwYlodGNabseflI&Oo~ zhta=kQruRUuZ_8{rLW&qUoQaN2`HLW*V^3NkzKa}12t4tC8!mxthlIs;@QV*Ot9k$ znYY53{Epyvzbxy5*aWlGr&uhHM5I|UwcQWltZyCfv~c7cqpiJt@s$vuY&;-Nbz+Gu zE3vp3%}p8PdvAUR+l2r6w^&S|DYOV^cj1kV)y>V#m6f;d-E-`%+2whXThbE%N(aje zRZAc2A-#X+jx88Sh{Q0$f63&CIJ69b2#!!rK$zkL(@o80*%rHZ`iU2MZB$A!ADZOn zl_iW9?MU8Q#gu$d*qC4KWq|9TOUs8GcX8Rl4^RExQVh~OI*TU<^||QTwmgtTrTf6* zhw+?mR7<$};KOcd4UIayX_8(rky3Bi(~4a&`(+7(In~%2H6%U@>oUFpa_Kb15K#N$ zi-EX_Sms=1bTzj9>{cC9L?mblAu5bnGcbuvZgbcpCKk5Lm#OS#9pFA~ow2{X$~SOQ zLRugLA+5?HPVr^WLvn|Pz(db{Z5izCwXwC{vw8Cc4V%CiN!S%9<1xA-jCfeW1agq? z{cO)7V5Ui~4Ii%|YEj#`2h(nof_HU-?uE72G2KKMXR*~-&O^AhOiQ~7<@(P{i6}i5 zru%R#=nWjVh>Op~$A%dTRvBEQLb~(rPiNZd%-~s=VUh^>`-ykNVyxPu>Ut59H){E` zX$O66UtXRnxl%fGLbcET@N&(yJ-(XTp~aJ^)h$AZ*<^(Tb;>9asy~|~5%_a_(Bqz+ z8%kR)YC8QaUSsvar<%8M89Y{M0)Tv%Q+Iq`HO8wlZndwLc+NX^NHJcsSL9;q^;L`7 z6ii-14(h{hL_fa^8-Z-%DJ(c}z6uUqt3|Uu`GH+mS9gjjO1H6m*XGTy;8&YHF~v?c zl?!MQCNf$5n7vnzw|zT%nmNj#GB@OR;j={b;k3M}Hrx0ZO$$SHLS!ACA2yE|jgC?+ zzW4ha2x{L%n9f|hU1?Cx`}*~DG&GpgY$qK1Zn|4kMKo{ny3ecdVYQdm0scpsAvLKM zwklm25+)S>#B+N0fGLH6+$@7FBa$wClnQr@a&EqPVf(A!XK2u;&2+VM+2~o-N1HBL zC2z+Z0bx9@SzFpoYRGixyn&#LS-UvT2SRt2M>hG(dUBac?dMhZAP23Yq)bRoHZ|Xq zTRrrwz8(v_o}y2|t4au|g`=I_p*)`Vn%<9aE|}c%^;sqtaqytn6pN~dWxnB+hI{1oISU#}( zDR5i=m8fsGElxq8wX^?g{;Kit8}-kubnFD!6n~f|9Nsvm4dvXnoQ)RtpW5nR>y_O%@+N*->fQtzf92= z4aNNKJ91_VwG$lq=Z<@X$&G3gZ#NM=IEsg@XwJ;7q_1o@NW^x{j#*-$MJX|!`c>`_ zGY}tKtFl_Yc2TX|r>?HgZjIDxs6t2);{UcE``lnDsvId8TrZl0^hh&UHXvkg+CQs) ziqNog{H9?ybfysqOLkT>Q%890W3n^%HFPtWUe&6g>J!cLuc<@y?6^YTf z`#ym=Y2x7imsN4<`FSb#l2x>{jym`VNnC$C{!~xxe?3(wXo(F6^F06r|BS&eZ>GDb zS^B_VsF|dPWlaa&UDBmZg19Ea+jcdjFI13qANGo=>E}P_`sX~R$1{J-b9k2(j|2r@ z27X_iqX_&x(|Wq`)Pv%l1fX6E5T zNQw~py~<{`>N7BKwI8(uj^{%X5-9xEHH##0w*?(6KTfpXr%VwZOfaZiq*1y*yL2j2 z76&FmLM6ZKN_Jj5vP*aJzgvgEC`nX&&`xL-!d!=?r+7)P?9v)mh7e3LhrfYr}0s~3G6mn-i)^=y#c=EcCN_p7EF znqOw_eQv7J`++kK)&baXhQh~4q%SvtJNIKRm%#;6*5V(e<5Oe8j&K0Z0W55>yqFNa zW*MpbAw+2XK)U|$2Uv-el~}L+2M&Lpp3dv%CZ1VB<>=d6MRq0e_sWX+68e??{(hT> zB+|eLmed!?QeSxbV zZ{rpvHUBUcz&So!^vlotUvw|=!zSFz4DEn~_%6IbU$bk=1nx9x9|av_ux;MXI^use4o5}b->N+#wPbqL8iz|Wq|_PqePvAV7RlujVANeN!=Mx2@viMXK>#gtjk}~{}8W%E!I1Ix)07X?M!$Ej~MI> zw@*Xk25AkD0Ff4SM65TifB%CnO+=B&GG7fIgZB;¿z{{z=r`oOOd{SIi8FBlM1 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 WFDagZ6W57P&Wg*3rJTBa{r>@GOdEOt diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/diabetes-population-functions.puml index c54476d..552c2dc 100644 --- a/vignettes/images/diabetes-population-functions.puml +++ b/vignettes/images/diabetes-population-functions.puml @@ -1,70 +1,28 @@ @startuml diabetes-population-functions -title Functions for Extracting a Diabetes Population Using OSDC +title Functions for extracting a diabetes population using OSDC -' :Based on the following five data sources: -' - Lægemiddelsdatabasen / Medicine DB (not correct name) -' - Landspatient Registeret (LPR) (2 and 3) -' - Register of Laboratory Results for Research (RLRR) / Laboratoriedatabasens Forskertabel -' - Health Service Register / Sygesikringsregisteret -' - BEF: CPR-registerets befolkningstabel; +#darkgrey: Extract_diabetes_population; -#darkgrey:**Extract Diabetes Population** -User-Facing Function: extract_diabetes_population(index_date: date, data_sources: list[data.table]) -> data.table; switch (Extract Dates of Inclusion Events) case ( Dates of\n HbA1c Tests) - :**Include Events of HbA1c Tests =>48 mmol/mol** - - Data Source: RLRR - - include_hba1c_tests_over_threshold(data: data.table, - threshold: int = 48) -> data.table; - :**Exclude Tests During Pregnancy** - - Data Source: DNPR - - exclude_events_during_pregnancy_windows( - data: data.table) -> data.table - - extract_pregnancy_index_dates(data: data.table) - -> data.table - - calculate_pregnancy_index_date_for_mc_visits_wo_end_dates( - data.table) -> data.table - - extract_pregnancy_end_dates(data: data.table) -> data.table - - extract_maternal_care_visit_dates_without_end( - data: data.table) -> data.table - - For further explanation, see functions-exclusion-pregnancy.puml; -case ( Dates of\n GLD Purchases) - :**Include Events of GLD Purchases** - - Data Source: Lægemiddelsdatabasen - - extract_gld_purchases(data: data.table) -> data.table; - :**Exclude Purchases During Pregnancy** - - Data Source: DNPR - - Functions: Same as for HbA1c Tests; - :**Exclude Women <40 Purchasing Metformin** - - Data Source: BEF - - exclude_potential_pcos(data: data.table, sex: str = "F", - age: int = 40) -> data.table; - :**Exclude Purchases of Brand Drugs for Weight Loss** - - exclude_weight_loss_drugs(data: data.table) -> data.table;; - + :include_dates_of_hba1c_tests_over_48_mmol_per_mol; + :exclude_dates_during_pregnancy_windows; case ( Dates of\n Diabetes Diagnosis) - :**Include Hospital Diagnoses of Diabetes** - - Data Source: DNPR (Hospital Contacts) - - extract_diabetes_diagnoses_icd_10(data: data.table) - -> data.table - - extract_diabetes_diagnoses_icd_8(data: data.table) - -> data.table; - + :include_dates_of_diabetes_diagnoses (ICD 8 and 10); case ( Dates of\n Diabetes-Specific Podiatrist Services) - :**Include Diabetes-Specific Podiatrist Services** - - Data Source: Health Service Register - - extract_diabetes_specific_podiatrist_services(data: data.table) - -> data.table; + :include_dates_of_diabetes_specific_podiatrist_services; +case ( Dates of\n GLD Purchases) + :include_dates_of_gld_purchases; + :exclude_dates_during_pregnancy_windows; + :exclude_dates_of_potential_pcos; + :exclude_dates_of_weight_loss_drug_purchases; endswitch -:**Join Inclusion Events** -- join_inclusion_events(data: list[data.table]) -> data.table; -:**Extract Diagnosis Classification Date** -- extract_second_inclusion_event_date(data: data.table) -> data.table; +:join_inclusion_events; +:extract_classification_dates; -center footer \n DNPR = The Danish National Patient Registry; GDM = Gestational Diabetes Mellitus; GLD = Glucose Lowering Drug;\nPCOS = Polycystic Ovary Syndrome; ICD = International Classification of Diseases; RLRR = Register of Laboratory Results for Research; +center footer \nDark grey box: User-facing functions; Light grey boxes: Internal functions; @enduml \ No newline at end of file From 2969292b05f05d55cf5e1ed492992180f39db719 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 22 Mar 2024 16:10:44 +0100 Subject: [PATCH 05/52] docs: :sparkles: initialise functionality flow post --- vignettes/functionality-flow.Rmd | 50 ++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 vignettes/functionality-flow.Rmd diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd new file mode 100644 index 0000000..d459c61 --- /dev/null +++ b/vignettes/functionality-flow.Rmd @@ -0,0 +1,50 @@ +--- +title: "Functionality Flow" +output: rmarkdown::html_vignette +bibliography: references.bib +csl: vancouver.csl +vignette: > + %\VignetteIndexEntry{Functionality Flow} + %\VignetteEngine{knitr::rmarkdown} + %\VignetteEncoding{UTF-8} +--- + + + +```{r, include = FALSE} +knitr::opts_chunk$set( + collapse = TRUE, + comment = "#>" +) +library(dplyr) +``` + +## Overview + +The OSDC algorithm - and thereby, the osdc package - contains two main components: + +- Extracting the diabetes population +- Classifying the diabetes type (type 1 and type 2) + +## Extracting the diabetes population + +This component extracts the diabetes population based on the following four data sources: + +- The Register of Laboratory Results for Research (RLRR) (Laboratoriedatabasens Forskertabel) +- The Danish National Patient Registry (DNPR) (Landspatient Registeret, LPR) +- Lægemiddelsdatabasen +- CPR-registerets befolkningstabel (BEF) +- The Health Service Register (Sygesikringsregisteret) + + + +This component will have one user-facing function: `extract_diabetes_population` which takes an `index_date` and the data sources as arguments. + +As described in `vignette("design")`, inclusion date is the date of the second inclusion criteria. Inclusion events include HbA1c measurements of ≥48 mmol/mol, hospital diagnoses of diabetes, diabetes-specific services received at podiatrist, and purchase of glucose-lowering drugs (GLD), while HbA1c samples and GLD purchases during pregnancies* are excluded, as are glucose-lowering brand drugs for weight loss and metformin purchases for women below age 40. + +This results in the following functionality flow: + +![Functions for extracting the diabetes population using the osdc package](images/diabetes-population-functions.png) + +Note: All functions take a `data.frame` as input and outputs a `data.frame`. + From d1dea768cbc3b37b29371ed28f7bb34b99b31b09 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:49:25 +0200 Subject: [PATCH 06/52] docs: :art: update overview section w. hyperlinks --- vignettes/functionality-flow.Rmd | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index d459c61..bc2f42b 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -21,10 +21,14 @@ library(dplyr) ## Overview -The OSDC algorithm - and thereby, the osdc package - contains two main components: +The OSDC algorithm - and thereby, the `osdc` package - contains two main +components: -- Extracting the diabetes population -- Classifying the diabetes type (type 1 and type 2) +- [Extracting the diabetes population](#extracting-diabetes-population) +- [Classifying the diabetes type (type 1 and type2)](#classifying-diabetes-type) + +In the following sections, we will go through each of these components +and the functions they contain. ## Extracting the diabetes population From 0237ba17c1fa346171632384af77d58b6f73ca28 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:50:27 +0200 Subject: [PATCH 07/52] docs: :lipstick: simplify and add colours to inclusion and exclusion functions --- .../images/diabetes-population-functions.png | Bin 36860 -> 30423 bytes .../images/diabetes-population-functions.puml | 33 ++++++++---------- 2 files changed, 15 insertions(+), 18 deletions(-) diff --git a/vignettes/images/diabetes-population-functions.png b/vignettes/images/diabetes-population-functions.png index 72473cb04206064143431104dd9c8a468b39e5d5..2d722caf730848369d2752001627a5f7b2e5d417 100644 GIT binary patch literal 30423 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Ʒ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 E7wfmEHUIzs literal 36860 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 lj^%4#NN{k0N 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 VzUQiM#4vG*g6u(=l>Nr%{}-p*qp1J@ diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/diabetes-population-functions.puml index 552c2dc..3a9cf10 100644 --- a/vignettes/images/diabetes-population-functions.puml +++ b/vignettes/images/diabetes-population-functions.puml @@ -1,28 +1,25 @@ @startuml diabetes-population-functions -title Functions for extracting a diabetes population using OSDC - #darkgrey: Extract_diabetes_population; +switch (Extract dates of inclusion events) +case ( HbA1c tests) + #lightgreen:include_hba1c_tests_over_48_mmol_per_mol; + #pink:exclude_events_during_pregnancy_windows; + +case ( Hospital diabetes\n diagnosis) + #lightgreen:include_diabetes_diagnoses; -switch (Extract Dates of Inclusion Events) -case ( Dates of\n HbA1c Tests) - :include_dates_of_hba1c_tests_over_48_mmol_per_mol; - :exclude_dates_during_pregnancy_windows; -case ( Dates of\n Diabetes Diagnosis) - :include_dates_of_diabetes_diagnoses (ICD 8 and 10); -case ( Dates of\n Diabetes-Specific Podiatrist Services) - :include_dates_of_diabetes_specific_podiatrist_services; -case ( Dates of\n GLD Purchases) - :include_dates_of_gld_purchases; - :exclude_dates_during_pregnancy_windows; - :exclude_dates_of_potential_pcos; - :exclude_dates_of_weight_loss_drug_purchases; +case ( Diabetes-specific\n podiatrist services) + #lightgreen:include_diabetes_specific_podiatrist_services; + +case ( GLD purchases) + #lightgreen:include_gld_purchases; + #pink:exclude_events_during_pregnancy_windows; + #pink:exclude_potential_pcos; + #pink:exclude_purchases_of_weight_loss_drugs; endswitch -:join_inclusion_events; :extract_classification_dates; -center footer \nDark grey box: User-facing functions; Light grey boxes: Internal functions; - @enduml \ No newline at end of file From 287a3d952651ea4d18dc94acee89f2d72914f2c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:50:58 +0200 Subject: [PATCH 08/52] docs: update extracting the diabetes population section --- vignettes/functionality-flow.Rmd | 53 ++++++++++++++++++++++++-------- 1 file changed, 41 insertions(+), 12 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index bc2f42b..7685e01 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -30,25 +30,54 @@ components: In the following sections, we will go through each of these components and the functions they contain. -## Extracting the diabetes population +## Extracting the diabetes population {#extracting-diabetes-population} -This component extracts the diabetes population based on the following four data sources: +This component extracts the diabetes population based on the following +five data sources (Danish names in parantheses): -- The Register of Laboratory Results for Research (RLRR) (Laboratoriedatabasens Forskertabel) -- The Danish National Patient Registry (DNPR) (Landspatient Registeret, LPR) -- Lægemiddelsdatabasen -- CPR-registerets befolkningstabel (BEF) +- The Register of Laboratory Results for Research, *RLRR* + (Laboratoriedatabasens Forskertabel) +- The Danish National Patient Registry, *DNPR* (Landspatient + Registeret, *LPR*) +- (Lægemiddelsdatabasen) +- (CPR-registerets befolkningstabel, *BEF*) - The Health Service Register (Sygesikringsregisteret) - + -This component will have one user-facing function: `extract_diabetes_population` which takes an `index_date` and the data sources as arguments. +This component will have one user-facing function: +`extract_diabetes_population`. This function takes the data sources and +an `index_date` (i.e., the day of the wanted classification) as +arguments. -As described in `vignette("design")`, inclusion date is the date of the second inclusion criteria. Inclusion events include HbA1c measurements of ≥48 mmol/mol, hospital diagnoses of diabetes, diabetes-specific services received at podiatrist, and purchase of glucose-lowering drugs (GLD), while HbA1c samples and GLD purchases during pregnancies* are excluded, as are glucose-lowering brand drugs for weight loss and metformin purchases for women below age 40. +As described in `vignette("design")`, inclusion date is the date of the +second inclusion criteria. Inclusion events include: -This results in the following functionality flow: + -![Functions for extracting the diabetes population using the osdc package](images/diabetes-population-functions.png) +- HbA1c measurements of ≥48 mmol/mol +- Hospital diagnoses of diabetes +- Diabetes-specific services received at podiatrists +- Purchase of glucose-lowering drugs (GLD) -Note: All functions take a `data.frame` as input and outputs a `data.frame`. +Note that HbA1c tests and GLD purchases during pregnancies are excluded, +as are glucose-lowering brand drugs for weight loss and metformin +purchases for women below age 40. See section \[Exclusion: HbA1c tests +and GLD purchases during estimated pregnancy +windows\](#exclusion-pregnancy-windows) for how pregnancy windows are +estimated. + +This results in the functionality flow for extracting the diabetes +population seen below. All functions take a `data.frame` as input and +outputs a `data.frame`. + +![Flow of functions for extracting a diabetes population using the osdc +package. The dark grey box denotes the user-facing function, while the +remaining boxes are internal functions. Green and red boxes represent +filtering functions (inclusion and exclusion events, +respectively).](images/diabetes-population-functions.png) + + + + From 2de0d12a77e42833e30fcd285ebad389108ffaf4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:52:50 +0200 Subject: [PATCH 09/52] docs: init hba1c tests section --- vignettes/functionality-flow.Rmd | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 7685e01..a097513 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -81,3 +81,18 @@ respectively).](images/diabetes-population-functions.png) +### Inclusion event: HbA1c tests above 48 mmol/mol + +The function `include_hba1c_tests_over_48_mmol_per_mol` uses RLRR as +data source to extract all events of tests above 48 mmol/mol before the +index date. + + + + + + + + + + From ffa2dc2c741dc50fd070e2eb4934ac476dda65d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:53:46 +0200 Subject: [PATCH 10/52] docs: init diagnosis section --- vignettes/functionality-flow.Rmd | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index a097513..e13a4fc 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -91,6 +91,23 @@ index date. +### Inclusion event: Hospital diagnosis of diabetes + +The function `include_diabetes_diagnoses` uses the hospital contacts +from DNPR to include all dates of diabetes diagnoses before the index +date. Diabetes diagnoses from both ICD 8 and ICD 10 are included. + +This function contains two helper functions: + +- `extract_diabetes_diagnoses_icd_10` +- `extract_diabetes_diagnoses_icd_8` + + + + + + + From b2a67e66711621d9246e6a28b02645bb223cad5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:54:17 +0200 Subject: [PATCH 11/52] docs: init podiatrist services section --- vignettes/functionality-flow.Rmd | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index e13a4fc..e86a458 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -108,6 +108,17 @@ This function contains two helper functions: +### Inclusion event: Diabetes-specific podiatrist services + +The function `include_diabetes_specific_podiatrist_services` uses the +Health Service Register to extract the dates of all diabetes-specific +podiatrist services before the index date. + + + + + +### Inclusion event: GLD purchases From 128ce5c1751d9a1568932eb2051bda81d5e54148 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:54:37 +0200 Subject: [PATCH 12/52] docs: init gld purchases section --- vignettes/functionality-flow.Rmd | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index e86a458..19552bf 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -120,6 +120,16 @@ podiatrist services before the index date. ### Inclusion event: GLD purchases +The function `include_gld_purchases` uses Lægemiddelsdatabasen to +extract the dates of all GLD purchases before the index date. + + + + + + + + From 26499191f9b63627e948fa896e2c86d902ab279e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:55:08 +0200 Subject: [PATCH 13/52] docs: init excl events during pregnancy windows section --- vignettes/functionality-flow.Rmd | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 19552bf..1524c3c 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -129,6 +129,36 @@ extract the dates of all GLD purchases before the index date. +### Exclusion: HbA1c tests and GLD purchases during estimated pregnancy windows {#exclusion-pregnancy-windows} + +The function `exclude_events_during_pregnancy_windows` uses diagnoses +from DNPR as a data source and is used to exclude both HbA1c tests and +GLD purchases during estimated pregnancy windows. + +Under the hood, this relies on the function +`extract_pregnancy_index_dates` and contains the following three helper +functions: + +- `calculate_pregnancy_index_date_for_mc_visits_wo_end_date` (this + might be removed with the inclusion of ) +- `extract_pregnancy_end_dates` +- `extract_maternal_care_visit_dates_without_end_date` + +`calculate_pregnancy_index_date_for_mc_visits_wo_end_date` might be +removed with the inclusion of the birth register. + +`extract_pregnancy_end_dates` extracts maternal care visits with an end +date and exclude visits between 40 weeks before end date to 12 weeks +after end date. + +`extract_maternal_care_visit_dates_without_end_date` uses the output +from `extract_pregnancy_end_dates` which identifies maternal care visits +*with* end dates to derive maternal care visits *without* end dates. +below. + + + + From c241be2062aa78bbecc20f42a74fe81b5ef720cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:56:00 +0200 Subject: [PATCH 14/52] docs: init gld drugts for weight loss section --- vignettes/functionality-flow.Rmd | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 1524c3c..6b354c9 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -159,6 +159,13 @@ below. +### Exclusion: Glucose-lowering brand drugs for weight loss + +The function `exclude_weight_loss_drugs` uses \*\* as a data source and +excludes **which brands**? + + + From ed742b7ad4e35c4cbfc7c6b1f650b1ffa782bbbb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:58:19 +0200 Subject: [PATCH 15/52] docs: init metformin purchases for women below 40 section --- vignettes/functionality-flow.Rmd | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 6b354c9..7b4bdaa 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -166,6 +166,18 @@ excludes **which brands**? +### Exclusion: Metformin purchases for women below age 40 + +The function `exclude_potential_pcos` uses BEF to exclude all purchases +of metformin by women below age 40 (i.e., <= 39 years old) at the date of +purchase. + +This function contains two helper functions: + +- `exclude_women` +- `exclude_age_40_or_younger` + + From 700efafd023a6c854e2df40d1af863bc402580e7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 15:59:45 +0200 Subject: [PATCH 16/52] docs: init extract diagnosis classification date section --- vignettes/functionality-flow.Rmd | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 7b4bdaa..e8f81d7 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -181,5 +181,13 @@ This function contains two helper functions: +### Extract diagnosis classification date + +Finally, the inclusion events from each inclusion criteria are joined in +the function `extract_classification_dates`. For each individual with +inclusion events, the date of the *second* event is extracted as the +classification date, i.e., the date the OSDC algorithm defines as the +diagnosis date. + From 6fcd10a25a00459b99f40c638624c4b5ea06e144 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 16:00:15 +0200 Subject: [PATCH 17/52] style: remove old comment and white spaces --- vignettes/functionality-flow.Rmd | 5 ----- 1 file changed, 5 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index e8f81d7..515de40 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -9,8 +9,6 @@ vignette: > %\VignetteEncoding{UTF-8} --- - - ```{r, include = FALSE} knitr::opts_chunk$set( collapse = TRUE, @@ -188,6 +186,3 @@ the function `extract_classification_dates`. For each individual with inclusion events, the date of the *second* event is extracted as the classification date, i.e., the date the OSDC algorithm defines as the diagnosis date. - - - From 46cb5ef4b1da440dc4806bb9108e5110b722d6d1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 3 Apr 2024 16:14:19 +0200 Subject: [PATCH 18/52] docs: :fire: remove old/irrelevant figures --- .../functions-exclusion-pregnancy-window.png | Bin 39622 -> 0 bytes .../functions-exclusion-pregnancy-window.puml | 21 ---- vignettes/images/functions-overall.png | Bin 71796 -> 0 bytes vignettes/images/functions-overall.puml | 104 ------------------ 4 files changed, 125 deletions(-) delete mode 100644 vignettes/images/functions-exclusion-pregnancy-window.png delete mode 100644 vignettes/images/functions-exclusion-pregnancy-window.puml delete mode 100644 vignettes/images/functions-overall.png delete mode 100644 vignettes/images/functions-overall.puml diff --git a/vignettes/images/functions-exclusion-pregnancy-window.png b/vignettes/images/functions-exclusion-pregnancy-window.png deleted file mode 100644 index 44982e5b63cbe6359f9332bc73b00bcfa6a33f62..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 39622 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 Exclude Event During Pregnancy\nData Source: DNPR; -#darkgrey:**exclude_events_during_pregnancy_windows(data: data.table) -> data.table**; -:**extract_pregnancy_index_dates(data: data.table) -> data.table** -- This function will extract pregnancy index dates using diagnoses (ICD 8 and 10?) from DNPR; - -:**Helper function: extract_pregnancy_end_dates(data: data.table) -> data.table** -- This might be removed with the inclusion of birth register; - -:**Helper function: extract_maternal_care_visit_dates_without_end(data: data.table) -> data.table** -- Extract mc visits with end date (visits between 40 weeks before end date to 12 weeks after end date) -- Use these to identify mc visits without end dates to be used in the function below; - -:**Helper function: calculate_pregnancy_index_date_based_mc_visits_wo_end_dates(data.table) -> data.table**; -stop - -@enduml \ No newline at end of file diff --git a/vignettes/images/functions-overall.png b/vignettes/images/functions-overall.png deleted file mode 100644 index a2032a95ca845d3d325382619b4a678175d8885d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 71796 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%0ALI!Vs}>;ycDRRj8d>OPS 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 data.table; -:**Inclusion Criteria** - -**HbA1c Tests (=>48 mmol/mol) (RLRR)** - - Function: include_hba1c_tests_over_threshold( - data: data.table, threshold: int = 48) -> data.table - -**Purchase of Glucose Lowering Drugs (GLDs) (Lægemiddelsdatabasen)**: - - Function: include_gld_purchases(data: data.table) -> data.table - -**Hospital Diagnosis of Diabetes (DNPR) ** - - Function: include_diabetes_diagnoses(data: data.table) -> data.table - - include_diabetes_diagnoses_icd_10(data: data.table) -> data.table - - include_diabetes_diagnoses_icd_8(data: data.table) -> data.table - -**Health Services (Diabetes-specific Podiatrist Services)** - - Function: include_podiatrist_services(data: data.table) -> data.table - - placeholder helper functions; - -:**Exclusion Criteria** - -**HbA1c and GLD: Events during pregnancies (potential GDM) (DNPR)** - - Function: exclude_events_during_pregnancy_windows(data: data.table) -> data.table - - extract_pregnancy_index_dates(data: data.table) - -> data.table - - calculate_pregnancy_index_date_for_mc_visits_wo_end_dates( - data.table) -> data.table - - extract_pregnancy_end_dates(data: data.table) -> data.table - - extract_maternal_care_visit_dates_without_end( - data: data.table) -> data.table - -**GLD: Metformin purchase for women below age 40 (potential PCOS)** - - Functions: exclude_potential_pcos(data: data.table, - sex: str = "F", age: int = 40) -> data.table - -**Weight Loss Drugs: Purchase of brand drugs for weight loss, e.g., Saxenda.** -'GLD only? - - Function: exclude_weight_loss_drugs(data: data.table) -> data.table; - -:**Classification Date:** - - Functions: - - join_inclusion_events(data: list[data.table]) -> data.table - - extract_second_inclusion_event_date(data: data.table) -> data.table; - -#darkgrey:**Classify Diabetes Type** -User-Facing Function: classify_diabetes_type(data: data.table) -> data.table; - - -:**Type 2 Diabetes** - -**Inclusion Criteria:** - -**Any purchases of Non-Insulin GLDs** -- Function: include_any_non_insulin_gld_purchases(data: data.table) -> data.table - -**Most recent type-specific diabetes diagnosis is hospital diagnosis of type 2 diabetes** -- Function: include_latest_diabetes_diagnosis_is_type_2(data: data.table) -> data.table - -**Exclusion Criteria:** - -**Women that have purchased only metformin and have any diagnoses of PCOS or have** -**purchases of clomifene or combination drugs containing antiandrogens and oestrogens** -- Functions: - - exclude_women_with_only_metformin_purchases(data: data.table) -> data.table - - exclude_women_with_psoc_diagnoses(data: data.table) -> data.table - - exclude_women_with_combination_drug_purchases(data: data.table) -> data.table - -**No recorded inclusion events in the last 10 years prior to the most recent date** -**available for the individual (index date)** -; - -:**Type 1 Diabetes** - -**Inclusion Criteria:** - -**Any purchases of insulin drugs.** - -**A hospital diagnosis of type 1 diabetes as the most recent** - -**type-specific diabetes diagnosis.** - -**Exclusion criteria:** - -**Women with any diagnoses of gestational diabetes mellitus, who have purchased** -**glucose-lowering drugs only in the period from 280 days prior to their first** -**diagnosis of gestational diabetes mellitus until 280 days after their last diagnosis.** - -**No purchases of glucose-lowering drugs or only one purchase and no hospital records of** -**type 1 diabetes.** - -**No insulin drug purchases in the last 10 years prior to the index date.** -; - -#palegreen:OSDC Population Created; -kill - -'Do we want to support export? (e.g. to csv, parquet, SASS?) - -@enduml From ca809c29f8a245850239d2f9840936086ed76745 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 12 Apr 2024 13:10:54 +0200 Subject: [PATCH 19/52] fix: remove all mentions of "before index date" since these filters are based on all data --- vignettes/functionality-flow.Rmd | 19 +++++-------------- 1 file changed, 5 insertions(+), 14 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 515de40..1be770a 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -82,18 +82,15 @@ respectively).](images/diabetes-population-functions.png) ### Inclusion event: HbA1c tests above 48 mmol/mol The function `include_hba1c_tests_over_48_mmol_per_mol` uses RLRR as -data source to extract all events of tests above 48 mmol/mol before the -index date. +data source to extract all events of tests above 48 mmol/mol. - - ### Inclusion event: Hospital diagnosis of diabetes The function `include_diabetes_diagnoses` uses the hospital contacts -from DNPR to include all dates of diabetes diagnoses before the index -date. Diabetes diagnoses from both ICD 8 and ICD 10 are included. +from DNPR to include all dates of diabetes diagnoses. Diabetes +diagnoses from both ICD 8 and ICD 10 are included. This function contains two helper functions: @@ -104,29 +101,23 @@ This function contains two helper functions: - - ### Inclusion event: Diabetes-specific podiatrist services The function `include_diabetes_specific_podiatrist_services` uses the Health Service Register to extract the dates of all diabetes-specific -podiatrist services before the index date. +podiatrist services. - - ### Inclusion event: GLD purchases The function `include_gld_purchases` uses Lægemiddelsdatabasen to -extract the dates of all GLD purchases before the index date. +extract the dates of all GLD purchases. - - ### Exclusion: HbA1c tests and GLD purchases during estimated pregnancy windows {#exclusion-pregnancy-windows} The function `exclude_events_during_pregnancy_windows` uses diagnoses From 2d02224d8f7b317de08c47a35e9f382dae329149 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 12 Apr 2024 13:11:31 +0200 Subject: [PATCH 20/52] fix: typo --- vignettes/functionality-flow.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 1be770a..168d4d5 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -31,7 +31,7 @@ and the functions they contain. ## Extracting the diabetes population {#extracting-diabetes-population} This component extracts the diabetes population based on the following -five data sources (Danish names in parantheses): +five data sources (Danish names in parentheses): - The Register of Laboratory Results for Research, *RLRR* (Laboratoriedatabasens Forskertabel) From 23268cf58027959b4b1e5e72c22712c8e8a97b10 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 12 Apr 2024 13:53:25 +0200 Subject: [PATCH 21/52] docs: add that gld purchases are only from 1997 and onwards --- vignettes/functionality-flow.Rmd | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 168d4d5..2eae528 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -118,6 +118,10 @@ extract the dates of all GLD purchases. +Note: GLD purchases only include purchases from 1997 and onwards. + + + ### Exclusion: HbA1c tests and GLD purchases during estimated pregnancy windows {#exclusion-pregnancy-windows} The function `exclude_events_during_pregnancy_windows` uses diagnoses From 445a118f4bf761ca7a4aec4e4eaf4d2d4f97dad2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 12 Apr 2024 13:58:12 +0200 Subject: [PATCH 22/52] docs: add TODO note to remember to update whether function will be removed in the future with the inclusion of the birth register --- vignettes/functionality-flow.Rmd | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 2eae528..07aeece 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -133,12 +133,11 @@ Under the hood, this relies on the function functions: - `calculate_pregnancy_index_date_for_mc_visits_wo_end_date` (this - might be removed with the inclusion of ) + might be removed with the inclusion of the birth register) - `extract_pregnancy_end_dates` - `extract_maternal_care_visit_dates_without_end_date` -`calculate_pregnancy_index_date_for_mc_visits_wo_end_date` might be -removed with the inclusion of the birth register. + `extract_pregnancy_end_dates` extracts maternal care visits with an end date and exclude visits between 40 weeks before end date to 12 weeks From 56cc88f9e62d7583c48e8eaa53b33771ca5b31c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Fri, 12 Apr 2024 14:00:56 +0200 Subject: [PATCH 23/52] docs: remove comment on adding arguments to functions at this point in time, it's better to keep things simple --- vignettes/functionality-flow.Rmd | 2 -- 1 file changed, 2 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 07aeece..e7adaa7 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -77,8 +77,6 @@ respectively).](images/diabetes-population-functions.png) - - ### Inclusion event: HbA1c tests above 48 mmol/mol The function `include_hba1c_tests_over_48_mmol_per_mol` uses RLRR as From 9b62a7d528df1749cc0bf9733af6934bdfc39113 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 17 Apr 2024 14:21:40 +0200 Subject: [PATCH 24/52] style: :lipstick: format text --- vignettes/functionality-flow.Rmd | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index e7adaa7..ec8130c 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -22,8 +22,10 @@ library(dplyr) The OSDC algorithm - and thereby, the `osdc` package - contains two main components: -- [Extracting the diabetes population](#extracting-diabetes-population) -- [Classifying the diabetes type (type 1 and type2)](#classifying-diabetes-type) +- [Extracting the diabetes + population](#extracting-diabetes-population) +- [Classifying the diabetes type (type 1 and + type2)](#classifying-diabetes-type) In the following sections, we will go through each of these components and the functions they contain. @@ -34,9 +36,9 @@ This component extracts the diabetes population based on the following five data sources (Danish names in parentheses): - The Register of Laboratory Results for Research, *RLRR* - (Laboratoriedatabasens Forskertabel) -- The Danish National Patient Registry, *DNPR* (Landspatient - Registeret, *LPR*) + (Laboratoriedatabasens Forskertabel) +- The Danish National Patient Registry, *DNPR* + (Landspatient Registeret, *LPR*) - (Lægemiddelsdatabasen) - (CPR-registerets befolkningstabel, *BEF*) - The Health Service Register (Sygesikringsregisteret) @@ -60,9 +62,9 @@ second inclusion criteria. Inclusion events include: Note that HbA1c tests and GLD purchases during pregnancies are excluded, as are glucose-lowering brand drugs for weight loss and metformin -purchases for women below age 40. See section \[Exclusion: HbA1c tests +purchases for women below age 40. See section $$Exclusion: HbA1c tests and GLD purchases during estimated pregnancy -windows\](#exclusion-pregnancy-windows) for how pregnancy windows are +windows$$(#exclusion-pregnancy-windows) for how pregnancy windows are estimated. This results in the functionality flow for extracting the diabetes @@ -87,8 +89,8 @@ data source to extract all events of tests above 48 mmol/mol. ### Inclusion event: Hospital diagnosis of diabetes The function `include_diabetes_diagnoses` uses the hospital contacts -from DNPR to include all dates of diabetes diagnoses. Diabetes -diagnoses from both ICD 8 and ICD 10 are included. +from DNPR to include all dates of diabetes diagnoses. Diabetes diagnoses +from both ICD 8 and ICD 10 are included. This function contains two helper functions: @@ -131,7 +133,7 @@ Under the hood, this relies on the function functions: - `calculate_pregnancy_index_date_for_mc_visits_wo_end_date` (this - might be removed with the inclusion of the birth register) + might be removed with the inclusion of the birth register) - `extract_pregnancy_end_dates` - `extract_maternal_care_visit_dates_without_end_date` @@ -159,8 +161,8 @@ excludes **which brands**? ### Exclusion: Metformin purchases for women below age 40 The function `exclude_potential_pcos` uses BEF to exclude all purchases -of metformin by women below age 40 (i.e., <= 39 years old) at the date of -purchase. +of metformin by women below age 40 (i.e., \<= 39 years old) at the date +of purchase. This function contains two helper functions: From 4d222cd1715d11949a869f367b2409bd7e1c38f4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 17 Apr 2024 14:34:51 +0200 Subject: [PATCH 25/52] fix: minor text edits and change "classification date" to "inclusion date" --- vignettes/functionality-flow.Rmd | 86 +++++++++--------- .../images/diabetes-population-functions.png | Bin 30423 -> 31471 bytes .../images/diabetes-population-functions.puml | 2 +- 3 files changed, 42 insertions(+), 46 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index ec8130c..219de01 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -19,12 +19,12 @@ library(dplyr) ## Overview -The OSDC algorithm - and thereby, the `osdc` package - contains two main +The OSDC algorithm - and thereby, the `osdc` package - contains two components: -- [Extracting the diabetes +- [Extracting the diabetes population](#extracting-diabetes-population) -- [Classifying the diabetes type (type 1 and +- [Classifying the diabetes type (type 1 and type2)](#classifying-diabetes-type) In the following sections, we will go through each of these components @@ -35,50 +35,44 @@ and the functions they contain. This component extracts the diabetes population based on the following five data sources (Danish names in parentheses): -- The Register of Laboratory Results for Research, *RLRR* +- The Register of Laboratory Results for Research, *RLRR* (Laboratoriedatabasens Forskertabel) -- The Danish National Patient Registry, *DNPR* - (Landspatient Registeret, *LPR*) -- (Lægemiddelsdatabasen) -- (CPR-registerets befolkningstabel, *BEF*) -- The Health Service Register (Sygesikringsregisteret) +- The Danish National Patient Registry, *DNPR* + (Landspatientregisteret, *LPR*) +- (Lægemiddelsdatabasen) +- (CPR-registerets befolkningstabel, *BEF*) +- The Health Service Register (Sygesikringsregisteret) This component will have one user-facing function: -`extract_diabetes_population`. This function takes the data sources and -an `index_date` (i.e., the day of the wanted classification) as -arguments. +`extract_diabetes_population`. All five data sources are used as input +for this function. -As described in `vignette("design")`, inclusion date is the date of the -second inclusion criteria. Inclusion events include: +As described in the [design](design.Rmd) vignette, inclusion date is the +date of the second inclusion criteria. Inclusion events include: - +- HbA1c measurements of ≥48 mmol/mol +- Hospital diagnoses of diabetes +- Diabetes-specific services received at podiatrists +- Purchase of glucose-lowering drugs (GLD) -- HbA1c measurements of ≥48 mmol/mol -- Hospital diagnoses of diabetes -- Diabetes-specific services received at podiatrists -- Purchase of glucose-lowering drugs (GLD) - -Note that HbA1c tests and GLD purchases during pregnancies are excluded, -as are glucose-lowering brand drugs for weight loss and metformin -purchases for women below age 40. See section $$Exclusion: HbA1c tests -and GLD purchases during estimated pregnancy -windows$$(#exclusion-pregnancy-windows) for how pregnancy windows are -estimated. +Note that HbA1c tests and GLD purchases during pregnancies are excluded. +See section [Exclusion: HbA1c tests and GLD purchases during estimated +pregnancy windows](#exclusion-pregnancy-windows) for how pregnancy +windows are estimated. Glucose-lowering brand drugs for weight loss and +metformin purchases for women below age 40 are excluded as well. This results in the functionality flow for extracting the diabetes population seen below. All functions take a `data.frame` as input and outputs a `data.frame`. -![Flow of functions for extracting a diabetes population using the osdc -package. The dark grey box denotes the user-facing function, while the -remaining boxes are internal functions. Green and red boxes represent -filtering functions (inclusion and exclusion events, +![Flow of functions for extracting a diabetes population using the +`osdc` package. The dark grey box denotes the user-facing function, +while the remaining boxes are internal functions. Green and red boxes +represent filtering functions (inclusion and exclusion events, respectively).](images/diabetes-population-functions.png) - - ### Inclusion event: HbA1c tests above 48 mmol/mol The function `include_hba1c_tests_over_48_mmol_per_mol` uses RLRR as @@ -94,8 +88,8 @@ from both ICD 8 and ICD 10 are included. This function contains two helper functions: -- `extract_diabetes_diagnoses_icd_10` -- `extract_diabetes_diagnoses_icd_8` +- `extract_diabetes_diagnoses_icd_10` +- `extract_diabetes_diagnoses_icd_8` @@ -129,15 +123,15 @@ from DNPR as a data source and is used to exclude both HbA1c tests and GLD purchases during estimated pregnancy windows. Under the hood, this relies on the function -`extract_pregnancy_index_dates` and contains the following three helper +`extract_pregnancy_index_dates` that contains the following three helper functions: -- `calculate_pregnancy_index_date_for_mc_visits_wo_end_date` (this +- `calculate_pregnancy_index_date_for_mc_visits_wo_end_date` (this might be removed with the inclusion of the birth register) -- `extract_pregnancy_end_dates` -- `extract_maternal_care_visit_dates_without_end_date` +- `extract_pregnancy_end_dates` +- `extract_maternal_care_visit_dates_without_end_date` - + `extract_pregnancy_end_dates` extracts maternal care visits with an end date and exclude visits between 40 weeks before end date to 12 weeks @@ -147,7 +141,7 @@ after end date. from `extract_pregnancy_end_dates` which identifies maternal care visits *with* end dates to derive maternal care visits *without* end dates. below. - + @@ -158,6 +152,8 @@ excludes **which brands**? + + ### Exclusion: Metformin purchases for women below age 40 The function `exclude_potential_pcos` uses BEF to exclude all purchases @@ -166,17 +162,17 @@ of purchase. This function contains two helper functions: -- `exclude_women` -- `exclude_age_40_or_younger` +- `exclude_women` +- `exclude_age_40_or_younger` -### Extract diagnosis classification date +### Extract inclusion date Finally, the inclusion events from each inclusion criteria are joined in -the function `extract_classification_dates`. For each individual with +the function `extract_inclusion_dates`. For each individual with inclusion events, the date of the *second* event is extracted as the -classification date, i.e., the date the OSDC algorithm defines as the +inclusion date, i.e., the date the OSDC algorithm defines as the diagnosis date. diff --git a/vignettes/images/diabetes-population-functions.png b/vignettes/images/diabetes-population-functions.png index 2d722caf730848369d2752001627a5f7b2e5d417..4372e76473e68243ce9197fd12427ad4c5838e5a 100644 GIT binary patch literal 31471 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Ʒ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 E7wfmEHUIzs diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/diabetes-population-functions.puml index 3a9cf10..575625e 100644 --- a/vignettes/images/diabetes-population-functions.puml +++ b/vignettes/images/diabetes-population-functions.puml @@ -20,6 +20,6 @@ case ( GLD purchases) #pink:exclude_purchases_of_weight_loss_drugs; endswitch -:extract_classification_dates; +:extract_inclusion_dates; @enduml \ No newline at end of file From 0807c62005e96b5ed398592885b425898762e7c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 17 Apr 2024 14:44:55 +0200 Subject: [PATCH 26/52] docs: add the notion of "raw" vs "stable" inclusion dates to text and flow chart --- vignettes/functionality-flow.Rmd | 20 ++++++++++++------ .../images/diabetes-population-functions.png | Bin 31471 -> 34118 bytes .../images/diabetes-population-functions.puml | 3 ++- 3 files changed, 16 insertions(+), 7 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 219de01..eb8c905 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -49,8 +49,9 @@ This component will have one user-facing function: `extract_diabetes_population`. All five data sources are used as input for this function. -As described in the [design](design.Rmd) vignette, inclusion date is the -date of the second inclusion criteria. Inclusion events include: +As described in the [design](design.Rmd) vignette, the inclusion +date is the date of the second inclusion criteria. Inclusion events +include: - HbA1c measurements of ≥48 mmol/mol - Hospital diagnoses of diabetes @@ -169,10 +170,17 @@ This function contains two helper functions: -### Extract inclusion date +### Extract raw inclusion dates -Finally, the inclusion events from each inclusion criteria are joined in -the function `extract_inclusion_dates`. For each individual with +Then, the inclusion events from each inclusion criteria are joined in +the function `extract_raw_inclusion_dates`. For each individual with inclusion events, the date of the *second* event is extracted as the -inclusion date, i.e., the date the OSDC algorithm defines as the +*raw* inclusion date, i.e., the date the OSDC algorithm defines as the diagnosis date. + +### Add stable inclusion dates + +Finally, from the raw inclusion dates, a stable inclusion date column is +added. The column censors inclusion dates from time-periods of +insufficient data coverage. For details on this, see the [Description of +algorithm contents & logic](algorithm_logic.Rmd) vignette. diff --git a/vignettes/images/diabetes-population-functions.png b/vignettes/images/diabetes-population-functions.png index 4372e76473e68243ce9197fd12427ad4c5838e5a..1996f496c2caf92ccde742ed1669b2fb929c602d 100644 GIT binary patch delta 10669 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 H7(e|V_HE|) delta 8008 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 LZKcB7*3bSA*_XuD diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/diabetes-population-functions.puml index 575625e..88a1ddb 100644 --- a/vignettes/images/diabetes-population-functions.puml +++ b/vignettes/images/diabetes-population-functions.puml @@ -20,6 +20,7 @@ case ( GLD purchases) #pink:exclude_purchases_of_weight_loss_drugs; endswitch -:extract_inclusion_dates; +:extract_raw_inclusion_dates; +:add_stables_inclusion_dates; @enduml \ No newline at end of file From 2c7ab628171c7dcb565c21e4d906006d4a60f34a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Wed, 17 Apr 2024 15:23:12 +0200 Subject: [PATCH 27/52] style: format text --- vignettes/functionality-flow.Rmd | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index eb8c905..6eedede 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -49,9 +49,8 @@ This component will have one user-facing function: `extract_diabetes_population`. All five data sources are used as input for this function. -As described in the [design](design.Rmd) vignette, the inclusion -date is the date of the second inclusion criteria. Inclusion events -include: +As described in the [design](design.Rmd) vignette, the inclusion date is +the date of the second inclusion criteria. Inclusion events include: - HbA1c measurements of ≥48 mmol/mol - Hospital diagnoses of diabetes From 5df493d9166737cd60ba67423c8026758a07abc2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Signe=20Kirk=20Br=C3=B8db=C3=A6k?= Date: Thu, 25 Apr 2024 16:35:26 +0200 Subject: [PATCH 28/52] docs: :zap: add english translations of register names based on #69 --- vignettes/functionality-flow.Rmd | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 6eedede..88f4a5a 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -37,13 +37,13 @@ five data sources (Danish names in parentheses): - The Register of Laboratory Results for Research, *RLRR* (Laboratoriedatabasens Forskertabel) -- The Danish National Patient Registry, *DNPR* +- The Danish National Patient Register, *DNPR* (Landspatientregisteret, *LPR*) -- (Lægemiddelsdatabasen) -- (CPR-registerets befolkningstabel, *BEF*) -- The Health Service Register (Sygesikringsregisteret) - - +- The Register of Pharmaceutical Sales (Lægemiddelstatistikregisteret) +- The Danish Civil Registration System (CPR-registerets + befolkningstabel, *BEF*) +- The National Health Insurance Service Register + (Sygesikringsregisteret) This component will have one user-facing function: `extract_diabetes_population`. All five data sources are used as input From f52b3947fa09019b02e752002d1245c919c53d07 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 26 Apr 2024 12:17:08 +0200 Subject: [PATCH 29/52] docs: apply suggestions from review --- vignettes/functionality-flow.Rmd | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 88f4a5a..26b8e91 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -20,17 +20,12 @@ library(dplyr) ## Overview The OSDC algorithm - and thereby, the `osdc` package - contains two -components: - -- [Extracting the diabetes - population](#extracting-diabetes-population) -- [Classifying the diabetes type (type 1 and - type2)](#classifying-diabetes-type) +components: Extracting the diabetes population and classifying diabetes type (type 1 and type2). In the following sections, we will go through each of these components and the functions they contain. -## Extracting the diabetes population {#extracting-diabetes-population} +## Extracting the diabetes population This component extracts the diabetes population based on the following five data sources (Danish names in parentheses): From 9603f76ba07fe1b72dab8e664ceb50b5689ab62c Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 26 Apr 2024 12:20:32 +0200 Subject: [PATCH 30/52] docs: remove redundant information and link instead to the design doc --- vignettes/functionality-flow.Rmd | 59 ++++++++++---------------------- 1 file changed, 18 insertions(+), 41 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 88f4a5a..d44a2e9 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -30,47 +30,24 @@ components: In the following sections, we will go through each of these components and the functions they contain. -## Extracting the diabetes population {#extracting-diabetes-population} - -This component extracts the diabetes population based on the following -five data sources (Danish names in parentheses): - -- The Register of Laboratory Results for Research, *RLRR* - (Laboratoriedatabasens Forskertabel) -- The Danish National Patient Register, *DNPR* - (Landspatientregisteret, *LPR*) -- The Register of Pharmaceutical Sales (Lægemiddelstatistikregisteret) -- The Danish Civil Registration System (CPR-registerets - befolkningstabel, *BEF*) -- The National Health Insurance Service Register - (Sygesikringsregisteret) - -This component will have one user-facing function: -`extract_diabetes_population`. All five data sources are used as input -for this function. - -As described in the [design](design.Rmd) vignette, the inclusion date is -the date of the second inclusion criteria. Inclusion events include: - -- HbA1c measurements of ≥48 mmol/mol -- Hospital diagnoses of diabetes -- Diabetes-specific services received at podiatrists -- Purchase of glucose-lowering drugs (GLD) - -Note that HbA1c tests and GLD purchases during pregnancies are excluded. -See section [Exclusion: HbA1c tests and GLD purchases during estimated -pregnancy windows](#exclusion-pregnancy-windows) for how pregnancy -windows are estimated. Glucose-lowering brand drugs for weight loss and -metformin purchases for women below age 40 are excluded as well. - -This results in the functionality flow for extracting the diabetes -population seen below. All functions take a `data.frame` as input and -outputs a `data.frame`. - -![Flow of functions for extracting a diabetes population using the -`osdc` package. The dark grey box denotes the user-facing function, -while the remaining boxes are internal functions. Green and red boxes -represent filtering functions (inclusion and exclusion events, +## Classify diabetes status + +This component classifies those with diabetes (type 1 or 2) based on the +Danish registers described in the `vignette("design")`. This component +will have one user-facing function: `classify_diabetes()`. All data +sources are used as input for this function. The specific inclusion and +exclusion details are also described in the `vignette("design")`. + +This results in the functionality flow for classifying diabetes status +seen below. All functions take a `data.frame` type object as input and +outputs the same type of object as the input object (a `data.frame` +type). For instance, if the input is a `data.table` object, the output +will also be a `data.table`. + +![Flow of functions for classifying diabetes status using the `osdc` +package. The dark grey box denotes the user-facing function, while the +remaining boxes are internal functions. Green and red boxes represent +filtering functions (inclusion and exclusion events, respectively).](images/diabetes-population-functions.png) ### Inclusion event: HbA1c tests above 48 mmol/mol From 2d6181d71abfc405fc98fb32619c2da7e5ab81c8 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 26 Apr 2024 12:25:46 +0200 Subject: [PATCH 31/52] docs: simplify the headers --- vignettes/functionality-flow.Rmd | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 94d9167..98e881a 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -46,14 +46,16 @@ remaining boxes are internal functions. Green and red boxes represent filtering functions (inclusion and exclusion events, respectively).](images/diabetes-population-functions.png) -### Inclusion event: HbA1c tests above 48 mmol/mol +## Inclusion events + +### HbA1c tests above 48 mmol/mol The function `include_hba1c_tests_over_48_mmol_per_mol` uses RLRR as data source to extract all events of tests above 48 mmol/mol. -### Inclusion event: Hospital diagnosis of diabetes +### Hospital diagnosis of diabetes The function `include_diabetes_diagnoses` uses the hospital contacts from DNPR to include all dates of diabetes diagnoses. Diabetes diagnoses @@ -68,7 +70,7 @@ This function contains two helper functions: -### Inclusion event: Diabetes-specific podiatrist services +### Diabetes-specific podiatrist services The function `include_diabetes_specific_podiatrist_services` uses the Health Service Register to extract the dates of all diabetes-specific @@ -76,7 +78,7 @@ podiatrist services. -### Inclusion event: GLD purchases +### GLD purchases The function `include_gld_purchases` uses Lægemiddelsdatabasen to extract the dates of all GLD purchases. @@ -89,7 +91,9 @@ Note: GLD purchases only include purchases from 1997 and onwards. -### Exclusion: HbA1c tests and GLD purchases during estimated pregnancy windows {#exclusion-pregnancy-windows} +## Exclusion events + +### HbA1c tests and GLD purchases during pregnancy {#exclusion-pregnancy-windows} The function `exclude_events_during_pregnancy_windows` uses diagnoses from DNPR as a data source and is used to exclude both HbA1c tests and @@ -118,7 +122,7 @@ below. -### Exclusion: Glucose-lowering brand drugs for weight loss +### Glucose-lowering brand drugs for weight loss The function `exclude_weight_loss_drugs` uses \*\* as a data source and excludes **which brands**? @@ -127,7 +131,7 @@ excludes **which brands**? -### Exclusion: Metformin purchases for women below age 40 +### Metformin purchases for women below age 40 The function `exclude_potential_pcos` uses BEF to exclude all purchases of metformin by women below age 40 (i.e., \<= 39 years old) at the date @@ -142,7 +146,7 @@ This function contains two helper functions: -### Extract raw inclusion dates +## Extract raw inclusion dates Then, the inclusion events from each inclusion criteria are joined in the function `extract_raw_inclusion_dates`. For each individual with @@ -150,10 +154,9 @@ inclusion events, the date of the *second* event is extracted as the *raw* inclusion date, i.e., the date the OSDC algorithm defines as the diagnosis date. -### Add stable inclusion dates +## Add stable inclusion dates Finally, from the raw inclusion dates, a stable inclusion date column is added. The column censors inclusion dates from time-periods of insufficient data coverage. For details on this, see the [Description of algorithm contents & logic](algorithm_logic.Rmd) vignette. - From ac9bf8a00aa5a50f414fb149e54a19bea94d331d Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 26 Apr 2024 13:37:59 +0200 Subject: [PATCH 32/52] docs: use `()` to indicate object is function, small renaming of functions --- vignettes/functionality-flow.Rmd | 81 ++++++++++++++------------------ 1 file changed, 34 insertions(+), 47 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 98e881a..d5359ff 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -50,21 +50,21 @@ respectively).](images/diabetes-population-functions.png) ### HbA1c tests above 48 mmol/mol -The function `include_hba1c_tests_over_48_mmol_per_mol` uses RLRR as -data source to extract all events of tests above 48 mmol/mol. +The function `include_hba1c()` uses `lab_forsker` as the input data to +extract all events of tests above 48 mmol/mol. ### Hospital diagnosis of diabetes -The function `include_diabetes_diagnoses` uses the hospital contacts -from DNPR to include all dates of diabetes diagnoses. Diabetes diagnoses -from both ICD 8 and ICD 10 are included. +The function `include_diabetes_diagnoses()` uses the hospital contacts +from LPR2 and 3 to include all dates of diabetes diagnoses. Diabetes +diagnoses from both ICD 8 and ICD 10 are included. This function contains two helper functions: -- `extract_diabetes_diagnoses_icd_10` -- `extract_diabetes_diagnoses_icd_8` +- `extract_diabetes_diagnoses_icd_10()` +- `extract_diabetes_diagnoses_icd_8()` @@ -72,60 +72,49 @@ This function contains two helper functions: ### Diabetes-specific podiatrist services -The function `include_diabetes_specific_podiatrist_services` uses the -Health Service Register to extract the dates of all diabetes-specific -podiatrist services. +The function `include_podiatrist_services()` uses `sysi` or `sssy` as +input to extract the dates of all diabetes-specific podiatrist services. ### GLD purchases -The function `include_gld_purchases` uses Lægemiddelsdatabasen to -extract the dates of all GLD purchases. - - +The function `include_gld_purchases()` uses `lmdb` to extract the dates +of all GLD purchases (from 1997 onwards). -Note: GLD purchases only include purchases from 1997 and onwards. - ## Exclusion events ### HbA1c tests and GLD purchases during pregnancy {#exclusion-pregnancy-windows} -The function `exclude_events_during_pregnancy_windows` uses diagnoses -from DNPR as a data source and is used to exclude both HbA1c tests and -GLD purchases during estimated pregnancy windows. +The function `exclude_pregnancy_events()` uses diagnoses from LPR2 or +LPR3 as input and is used to exclude both HbA1c tests and GLD purchases +during pregnancy. -Under the hood, this relies on the function -`extract_pregnancy_index_dates` that contains the following three helper -functions: +Internally, this relies on the function `extract_pregnancy_dates()` that +contains the following three helper functions: -- `calculate_pregnancy_index_date_for_mc_visits_wo_end_date` (this +- `calculate_pregnancy_index_date_for_mc_visits_wo_end_date()` (this might be removed with the inclusion of the birth register) -- `extract_pregnancy_end_dates` -- `extract_maternal_care_visit_dates_without_end_date` - - +- `extract_pregnancy_end_dates()`: Extracts maternal care visits with + an end date and exclude visits between 40 weeks before end date and + 12 weeks after end date. +- `extract_maternal_care_visit_dates_without_end_date()`: Uses the + output from `extract_pregnancy_end_dates()` which identifies + maternal care visits *with* end dates to derive maternal care visits + *without* end dates. below. -`extract_pregnancy_end_dates` extracts maternal care visits with an end -date and exclude visits between 40 weeks before end date to 12 weeks -after end date. - -`extract_maternal_care_visit_dates_without_end_date` uses the output -from `extract_pregnancy_end_dates` which identifies maternal care visits -*with* end dates to derive maternal care visits *without* end dates. -below. ### Glucose-lowering brand drugs for weight loss -The function `exclude_weight_loss_drugs` uses \*\* as a data source and -excludes **which brands**? +The function `exclude_weight_loss_drugs()` uses REGISTER as input and +excludes BRANDS. @@ -133,23 +122,21 @@ excludes **which brands**? ### Metformin purchases for women below age 40 -The function `exclude_potential_pcos` uses BEF to exclude all purchases -of metformin by women below age 40 (i.e., \<= 39 years old) at the date -of purchase. +The function `exclude_pcos()` uses `bef` as input to exclude all +purchases of metformin by women below age 40 (i.e., \<= 39 years old) at +the date of purchase. This function contains two helper functions: -- `exclude_women` -- `exclude_age_40_or_younger` - - +- `exclude_men()` +- `exclude_age_40_below()` ## Extract raw inclusion dates Then, the inclusion events from each inclusion criteria are joined in -the function `extract_raw_inclusion_dates`. For each individual with +the function `extract_raw_inclusion_dates()`. For each individual with inclusion events, the date of the *second* event is extracted as the *raw* inclusion date, i.e., the date the OSDC algorithm defines as the diagnosis date. @@ -158,5 +145,5 @@ diagnosis date. Finally, from the raw inclusion dates, a stable inclusion date column is added. The column censors inclusion dates from time-periods of -insufficient data coverage. For details on this, see the [Description of -algorithm contents & logic](algorithm_logic.Rmd) vignette. +insufficient data coverage. For details on this, see the +`vignette("algorithm-logic")`. From 024e758f1f30a0b3af4afed176857a64de38b0da Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Sat, 27 Apr 2024 19:08:50 +0200 Subject: [PATCH 33/52] chore: :wrench: set tabsize to 2 for R and qmd files --- .vscode/settings.json | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/.vscode/settings.json b/.vscode/settings.json index d197774..c764ea7 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -23,8 +23,9 @@ "r.session.levelOfObjectDetail": "Detailed", "r.session.data.rowLimit": 1000, "r.plot.useHttpgd": true, - "[r]": { - "editor.defaultFormatter": "REditorSupport.r" + "[r,quarto]": { + "editor.defaultFormatter": "REditorSupport.r", + "editor.tabSize": 2, }, "cSpell.language": "en-GB", "cSpell.words": [ From 6fcbaf1d70b995835f4859f24ca93f51088be6cb Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Sat, 27 Apr 2024 19:10:48 +0200 Subject: [PATCH 34/52] build: :bug: the newest version of PlantUML has an error with building the image --- justfile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/justfile b/justfile index a9b77b4..7ebb6cf 100644 --- a/justfile +++ b/justfile @@ -3,8 +3,8 @@ # Generate PNG images from all PlantUML files generate-puml-all: - docker run --rm -v $(pwd):/puml -w /puml ghcr.io/plantuml/plantuml:latest -tpng "**/*.puml" + docker run --rm -v $(pwd):/puml -w /puml ghcr.io/plantuml/plantuml:1.2024.3 -tpng "**/*.puml" # Generate PNG image from specific PlantUML file generate-puml name: - docker run --rm -v $(pwd):/puml -w /puml ghcr.io/plantuml/plantuml:latest -tpng "**/{{name}}.puml" \ No newline at end of file + docker run --rm -v $(pwd):/puml -w /puml ghcr.io/plantuml/plantuml:1.2024.3 -tpng "**/{{name}}.puml" From 084485c4e5aa4d8442bfd3c39fed9a272991266b Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Sat, 27 Apr 2024 19:11:23 +0200 Subject: [PATCH 35/52] docs: :memo: update puml file to use flowchart instead and to include input registers --- .../images/diabetes-population-functions.puml | 97 +++++++++++++++---- 1 file changed, 79 insertions(+), 18 deletions(-) diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/diabetes-population-functions.puml index 88a1ddb..4e5a1bd 100644 --- a/vignettes/images/diabetes-population-functions.puml +++ b/vignettes/images/diabetes-population-functions.puml @@ -1,26 +1,87 @@ @startuml diabetes-population-functions +!theme cerulean-outline + -#darkgrey: Extract_diabetes_population; +hide <> stereotype +hide <> stereotype -switch (Extract dates of inclusion events) -case ( HbA1c tests) - #lightgreen:include_hba1c_tests_over_48_mmol_per_mol; - #pink:exclude_events_during_pregnancy_windows; +card classify_diabetes() as cd { + together { + database sssy + database sysi + database lpr_diag + database lpr_adm + database lmdb + database lab_forsker + database kontakter + database diagnoser + database bef + } -case ( Hospital diabetes\n diagnosis) - #lightgreen:include_diabetes_diagnoses; + action "get_pregnancy_dates()" as pregnancy + action "get_pcos()" as pcos + action "get_initial_diagnosis_date()" as first_date + action "get_final_diagnosis_date()" as final_date + action "join()" as join -case ( Diabetes-specific\n podiatrist services) - #lightgreen:include_diabetes_specific_podiatrist_services; + together { + action "exclude_pregnancy()" as ex_pregnancy <> + action "exclude_purchases_weight_loss_drugs()" as ex_wld <> + action "exclude_pcos()" as ex_pcos <> + } -case ( GLD purchases) - #lightgreen:include_gld_purchases; - #pink:exclude_events_during_pregnancy_windows; - #pink:exclude_potential_pcos; - #pink:exclude_purchases_of_weight_loss_drugs; -endswitch + together { + action "include_hba1c()" as in_hba1c <> + action "include_diabetes_diagnosis()" as in_diagnosis <> + action "include_podiatrist_services()" as in_podiatrist <> + action "include_purchases_gld()" as in_gld <> + } -:extract_raw_inclusion_dates; -:add_stables_inclusion_dates; + lab_forsker --> in_hba1c + in_hba1c --> ex_pregnancy -@enduml \ No newline at end of file + lpr_diag --> pregnancy + lpr_adm --> pregnancy + kontakter --> pregnancy + diagnoser --> pregnancy + pregnancy -> ex_pregnancy + + lpr_diag --> in_diagnosis + lpr_adm --> in_diagnosis + kontakter --> in_diagnosis + diagnoser --> in_diagnosis + + sssy --> in_podiatrist + sysi --> in_podiatrist + + lmdb --> in_gld + in_gld --> ex_pregnancy + in_gld --> ex_wld + + bef --> pcos + in_gld --> ex_pcos + pcos --> ex_pcos + + ex_wld --> first_date + ex_pregnancy --> first_date + ex_pcos --> first_date + in_podiatrist --> first_date + in_diagnosis --> first_date + + first_date -> join + join -> final_date +} +@enduml From aaccf541b3ce68668f8941054b6e545962892310 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Sat, 27 Apr 2024 19:11:58 +0200 Subject: [PATCH 36/52] docs: :memo: include some guidelines for writing functions --- vignettes/functionality-flow.Rmd | 40 ++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index d5359ff..82b8eee 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -9,29 +9,33 @@ vignette: > %\VignetteEncoding{UTF-8} --- -```{r, include = FALSE} -knitr::opts_chunk$set( - collapse = TRUE, - comment = "#>" -) -library(dplyr) -``` +## Function conventions -## Overview +The below conventions are *ideals* only, to be used as a guidelines to +help with development and understanding of the code. They are not hard +rules. -The OSDC algorithm - and thereby, the `osdc` package - contains two -components: Extracting the diabetes population and classifying diabetes -type (type 1 and type2). +### Naming -In the following sections, we will go through each of these components -and the functions they contain. +- First word is an action verb, later words are objects or conditions. +- Exclusion criteria are prefixed with `exclude_`. +- Inclusion criteria are prefixed with `include_`. +- Helpers that get or extract a condition ("pregnancy" or "date of + visit") are prefixed with `get_`. +- Helpers that drop or keep a specific condition are prefixed with + `drop_` or `keep_` ("first visit date to maternal care for pregnancy + after 40 weeks"). These types of helpers likely are contained in the + `get_` functions. -## Classify diabetes status +### Input and output + +- Few arguments, with one or two core required argument. +- `include_` functions take a register as the first argument. + - One input register database at a time. +- `exclude_` functions can take a register as the first argument or + take the output from an `include_` function. +- Second argument can be an output data from another function. -This component classifies those with diabetes (type 1 or 2) based on the -Danish registers described in the `vignette("design")`. This component -will have one user-facing function: `classify_diabetes()`. All data -sources are used as input for this function. The specific inclusion and exclusion details are also described in the `vignette("design")`. This results in the functionality flow for classifying diabetes status From d650c22f97d8bc1acaa1370594df1d284d53d610 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Sat, 27 Apr 2024 19:13:26 +0200 Subject: [PATCH 37/52] docs: :memo: revise function flow doc to match flowchart --- vignettes/functionality-flow.Rmd | 80 ++++++++++++++++++-------------- 1 file changed, 44 insertions(+), 36 deletions(-) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/functionality-flow.Rmd index 82b8eee..aa6aea0 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/functionality-flow.Rmd @@ -36,6 +36,14 @@ rules. take the output from an `include_` function. - Second argument can be an output data from another function. +## Function flow + +The OSDC algorithm - and thereby, the `osdc` package - contains one main +function that will classify individuals into those with either type 1 or +type 2 diabetes using the Danish registers: `classify_diabetes()`. This +function classifies those with diabetes (type 1 or 2) based on the +Danish registers described in the `vignette("design")`. All data sources +are used as input for this function. The specific inclusion and exclusion details are also described in the `vignette("design")`. This results in the functionality flow for classifying diabetes status @@ -44,11 +52,10 @@ outputs the same type of object as the input object (a `data.frame` type). For instance, if the input is a `data.table` object, the output will also be a `data.table`. -![Flow of functions for classifying diabetes status using the `osdc` -package. The dark grey box denotes the user-facing function, while the -remaining boxes are internal functions. Green and red boxes represent -filtering functions (inclusion and exclusion events, -respectively).](images/diabetes-population-functions.png) +![Flow of functions, as well as their required input registers, for +classifying diabetes status using the `osdc` package. Light blue and +orange boxes represent filtering functions (inclusion and exclusion +events, respectively).](images/diabetes-population-functions.png) ## Inclusion events @@ -67,8 +74,8 @@ diagnoses from both ICD 8 and ICD 10 are included. This function contains two helper functions: -- `extract_diabetes_diagnoses_icd_10()` -- `extract_diabetes_diagnoses_icd_8()` +- `keep_diabetes_icd10()` +- `keep_diabetes_icd8()` @@ -92,24 +99,24 @@ of all GLD purchases (from 1997 onwards). ## Exclusion events -### HbA1c tests and GLD purchases during pregnancy {#exclusion-pregnancy-windows} +### HbA1c tests and GLD purchases during pregnancy -The function `exclude_pregnancy_events()` uses diagnoses from LPR2 or -LPR3 as input and is used to exclude both HbA1c tests and GLD purchases -during pregnancy. +The function `exclude_pregnancy()` uses diagnoses from LPR2 or LPR3 as +input and is used to exclude both HbA1c tests and GLD purchases during +pregnancy. -Internally, this relies on the function `extract_pregnancy_dates()` that +Internally, this relies on the function `get_pregnancy_dates()` that contains the following three helper functions: - `calculate_pregnancy_index_date_for_mc_visits_wo_end_date()` (this might be removed with the inclusion of the birth register) -- `extract_pregnancy_end_dates()`: Extracts maternal care visits with - an end date and exclude visits between 40 weeks before end date and - 12 weeks after end date. -- `extract_maternal_care_visit_dates_without_end_date()`: Uses the - output from `extract_pregnancy_end_dates()` which identifies - maternal care visits *with* end dates to derive maternal care visits - *without* end dates. below. +- `get_pregnancy_end_dates()`: Keep maternal care visits with an end + date and drop visits between 40 weeks before end date and 12 weeks + after end date. +- `get_maternal_care_visit_dates_without_end_date()`: Uses the output + from `get_pregnancy_end_dates()` which identifies maternal care + visits *with* end dates to derive maternal care visits *without* end + dates. below. @@ -117,8 +124,8 @@ contains the following three helper functions: ### Glucose-lowering brand drugs for weight loss -The function `exclude_weight_loss_drugs()` uses REGISTER as input and -excludes BRANDS. +The function `exclude_purchases_weight_loss_drugs()` uses REGISTER as +input and excludes BRANDS. @@ -126,28 +133,29 @@ excludes BRANDS. ### Metformin purchases for women below age 40 -The function `exclude_pcos()` uses `bef` as input to exclude all -purchases of metformin by women below age 40 (i.e., \<= 39 years old) at -the date of purchase. +The function `exclude_pcos()` as input to exclude all purchases of +metformin by women below age 40 (i.e., \<= 39 years old) at the date of +purchase. This function contains two helper functions: -- `exclude_men()` -- `exclude_age_40_below()` +- `keep_women()` +- `drop_age_40_below()` -## Extract raw inclusion dates +## Get initial diagnosis date -Then, the inclusion events from each inclusion criteria are joined in -the function `extract_raw_inclusion_dates()`. For each individual with -inclusion events, the date of the *second* event is extracted as the -*raw* inclusion date, i.e., the date the OSDC algorithm defines as the -diagnosis date. +Then, the first inclusion and exclusion events from the function outputs +are dropped with `drop_first_event()` so that only those with two or +more events are kepts. This is then used to assign an initial diagnosis +date with `get_initial_diagnosis_date()`. Then all the outputs are +joined together at the end. -## Add stable inclusion dates +## Drop diagnosis dates outside of coverage -Finally, from the raw inclusion dates, a stable inclusion date column is -added. The column censors inclusion dates from time-periods of -insufficient data coverage. For details on this, see the +Finally, from the raw initial diagnosis dates, those dates outside of +the data coverage period are dropped to end with a final diagnosis date +using `get_final_diagnosis_date()`. For details on this censoring based +on the periods with insufficient data coverage, see the `vignette("algorithm-logic")`. From 49a661010b3f754c4ad9e47e2f1935d04c329908 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Sat, 27 Apr 2024 19:14:56 +0200 Subject: [PATCH 38/52] chore: :truck: rename to function-flow --- vignettes/{functionality-flow.Rmd => function-flow.Rmd} | 4 ++-- ...{diabetes-population-functions.puml => function-flow.puml} | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) rename vignettes/{functionality-flow.Rmd => function-flow.Rmd} (98%) rename vignettes/images/{diabetes-population-functions.puml => function-flow.puml} (97%) diff --git a/vignettes/functionality-flow.Rmd b/vignettes/function-flow.Rmd similarity index 98% rename from vignettes/functionality-flow.Rmd rename to vignettes/function-flow.Rmd index aa6aea0..a6c0151 100644 --- a/vignettes/functionality-flow.Rmd +++ b/vignettes/function-flow.Rmd @@ -1,10 +1,10 @@ --- -title: "Functionality Flow" +title: "Function Flow" output: rmarkdown::html_vignette bibliography: references.bib csl: vancouver.csl vignette: > - %\VignetteIndexEntry{Functionality Flow} + %\VignetteIndexEntry{Function Flow} %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- diff --git a/vignettes/images/diabetes-population-functions.puml b/vignettes/images/function-flow.puml similarity index 97% rename from vignettes/images/diabetes-population-functions.puml rename to vignettes/images/function-flow.puml index 4e5a1bd..c805028 100644 --- a/vignettes/images/diabetes-population-functions.puml +++ b/vignettes/images/function-flow.puml @@ -1,4 +1,4 @@ -@startuml diabetes-population-functions +@startuml function-flow !theme cerulean-outline