diff --git a/_quarto.yml b/_quarto.yml index aee23f1..fb78fda 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -9,6 +9,7 @@ website: - href: index.qmd text: Home - minutes.qmd + - references/problem_statement.qmd - aboutus.qmd format: diff --git a/docs/aboutus.html b/docs/aboutus.html index 3e61455..59930b8 100644 --- a/docs/aboutus.html +++ b/docs/aboutus.html @@ -95,6 +95,10 @@ +
  • Joel Laxamana
  • Nicholas Masel
  • - +
    diff --git a/docs/index.html b/docs/index.html index 459542f..9ed079a 100644 --- a/docs/index.html +++ b/docs/index.html @@ -95,6 +95,10 @@ + +
  • ddmmmyyyy
  • - +
    diff --git a/docs/references/osdocumeta_proposal_fda_qtrly.html b/docs/references/osdocumeta_proposal_fda_qtrly.html index c457a98..118edf4 100644 --- a/docs/references/osdocumeta_proposal_fda_qtrly.html +++ b/docs/references/osdocumeta_proposal_fda_qtrly.html @@ -1,191 +1,361 @@ - - - - + + + + + + + + + + - + + PHUSE WG : Open-Source Metadata Documentation (OSDocuMeta) – ADRG Template Update Proposal : An Open-Source Edition + + + + + + + + + + + + + .callout.callout-style-simple { + padding: 0em 0.5em; + border-left: solid #acacac .3rem; + border-right: solid 1px silver; + border-top: solid 1px silver; + border-bottom: solid 1px silver; + display: flex; + } + .callout.callout-style-default { + border-left: solid #acacac .3rem; + border-right: solid 1px silver; + border-top: solid 1px silver; + border-bottom: solid 1px silver; + } - - - - - - - - - - - - - - - - - - - - - + .callout .callout-body-container { + flex-grow: 1; + } - + .callout.callout-style-simple .callout-body { + font-size: 1rem; + font-weight: 400; + } -
    -
    - -
    - -
    - - - - -
    + .callout.callout-style-default .callout-body { + font-size: 0.9rem; + font-weight: 400; + } -
    -
    -

    ADRG Template Update Proposal : An Open-Source Edition

    -
    + .callout.callout-titled.callout-style-simple .callout-body { + margin-top: 0.2em; + } + .callout:not(.callout-titled) .callout-body { + display: flex; + } + .callout:not(.no-icon).callout-titled.callout-style-simple .callout-content { + padding-left: 1.6em; + } -
    + .callout.callout-titled .callout-header { + padding-top: 0.2em; + margin-bottom: -0.2em; + } -
    -
    Author
    -
    -

    OSDocuMeta Working Group

    -
    -
    + .callout.callout-titled .callout-title p { + margin-top: 0.5em; + margin-bottom: 0.5em; + } - + .callout.callout-titled.callout-style-simple .callout-content p { + margin-top: 0; + } + + .callout.callout-titled.callout-style-default .callout-content p { + margin-top: 0.7em; + } + + .callout.callout-style-simple div.callout-title { + border-bottom: none; + font-size: .9rem; + font-weight: 600; + opacity: 75%; + } + + .callout.callout-style-default div.callout-title { + border-bottom: none; + font-weight: 600; + opacity: 85%; + font-size: 0.9rem; + padding-left: 0.5em; + padding-right: 0.5em; + } + + .callout.callout-style-default div.callout-content { + padding-left: 0.5em; + padding-right: 0.5em; + } + + .callout.callout-style-simple .callout-icon::before { + height: 1rem; + width: 1rem; + display: inline-block; + content: ""; + background-repeat: no-repeat; + background-size: 1rem 1rem; + } + + .callout.callout-style-default .callout-icon::before { + height: 0.9rem; + width: 0.9rem; + display: inline-block; + content: ""; + background-repeat: no-repeat; + background-size: 0.9rem 0.9rem; + } + + .callout-title { + display: flex + } -
    - + .callout-icon::before { + margin-top: 1rem; + padding-right: .5rem; + } + + .callout.no-icon::before { + display: none !important; + } + + .callout.callout-titled .callout-body > .callout-content > :last-child { + padding-bottom: 0.5rem; + margin-bottom: 0; + } + + .callout.callout-titled .callout-icon::before { + margin-top: .5rem; + padding-right: .5rem; + } + + .callout:not(.callout-titled) .callout-icon::before { + margin-top: 1rem; + padding-right: .5rem; + } + + /* Callout Types */ + + div.callout-note { + border-left-color: #4582ec !important; + } + + div.callout-note .callout-icon::before { + background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAEU0lEQVRYCcVXTWhcVRQ+586kSUMMxkyaElstCto2SIhitS5Ek8xUKV2poatCcVHtUlFQk8mbaaziwpWgglJwVaquitBOfhQXFlqlzSJpFSpIYyXNjBNiTCck7x2/8/LeNDOZxDuEkgOXe++553zfefee+/OYLOXFk3+1LLrRdiO81yNqZ6K9cG0P3MeFaMIQjXssE8Z1JzLO9ls20MBZX7oG8w9GxB0goaPrW5aNMp1yOZIa7Wv6o2ykpLtmAPs/vrG14Z+6d4jpbSKuhdcSyq9wGMPXjonwmESXrriLzFGOdDBLB8Y6MNYBu0dRokSygMA/mrun8MGFN3behm6VVAwg4WR3i6FvYK1T7MHo9BK7ydH+1uurECoouk5MPRyVSBrBHMYwVobG2aOXM07sWrn5qgB60rc6mcwIDJtQrnrEr44kmy+UO9r0u9O5/YbkS9juQckLed3DyW2XV/qWBBB3ptvI8EUY3I9p/67OW+g967TNr3Sotn3IuVlfMLVnsBwH4fsnebJvyGm5GeIUA3jljERmrv49SizPYuq+z7c2H/jlGC+Ghhupn/hcapqmcudB9jwJ/3jvnvu6vu5lVzF1fXyZuZZ7U8nRmVzytvT+H3kilYvH09mLWrQdwFSsFEsxFVs5fK7A0g8gMZjbif4ACpKbjv7gNGaD8bUrlk8x+KRflttr22JEMRUbTUwwDQScyzPgedQHZT0xnx7ujw2jfVfExwYHwOsDTjLdJ2ebmeQIlJ7neo41s/DrsL3kl+W2lWvAga0tR3zueGr6GL78M3ifH0rGXrBC2aAR8uYcIA5gwV8zIE8onoh8u0Fca/ciF7j1uOzEnqcIm59sEXoGc0+z6+H45V1CvAvHcD7THztu669cnp+L0okAeIc6zjbM/24LgGM1gZk7jnRu1aQWoU9sfUOuhrmtaPIO3YY1KLLWZaEO5TKUbMY5zx8W9UJ6elpLwKXbsaZ4EFl7B4bMtDv0iRipKoDQT2sNQI9b1utXFdYisi+wzZ/ri/1m7QfDgEuvgUUEIJPq3DhX/5DWNqIXDOweC2wvIR90Oq3lDpdMIgD2r0dXvGdsEW5H6x6HLRJYU7C69VefO1x8Gde1ZFSJLfWS1jbCnhtOPxmpfv2LXOA2Xk2tvnwKKPFuZ/oRmwBwqRQDcKNeVQkYcOjtWVBuM/JuYw5b6isojIkYxyYAFn5K7ZBF10fea52y8QltAg6jnMqNHFBmGkQ1j+U43HMi2xMar1Nv0zGsf1s8nUsmUtPOOrbFIR8bHFDMB5zL13Gmr/kGlCkUzedTzzmzsaJXhYawnA3UmARpiYj5ooJZiUoxFRtK3X6pgNPv+IZVPcnwbOl6f+aBaO1CNvPW9n9LmCp01nuSaTRF2YxHqZ8DYQT6WsXT+RD6eUztwYLZ8rM+rcPxamv1VQzFUkzFXvkiVrySGQgJNvXHJAxiU3/NwiC03rSf05VBaPtu/Z7/B8Yn/w7eguloAAAAAElFTkSuQmCC'); + } + + div.callout-note.callout-style-default .callout-title { + background-color: #dae6fb + } + + div.callout-important { + border-left-color: #d9534f !important; + } + + div.callout-important .callout-icon::before { + background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAEKklEQVRYCcVXTWhcVRS+575MJym48A+hSRFr00ySRQhURRfd2HYjk2SSTokuBCkU2o0LoSKKraKIBTcuFCoidGFD08nkBzdREbpQ1EDNIv8qSGMFUboImMSZd4/f9zJv8ibJMC8xJQfO3HPPPef7zrvvvnvviIkpC9nsw0UttFunbUhpFzFtarSd6WJkStVMw5xyVqYTvkwfzuf/5FgtkVoB0729j1rjXwThS7Vio+Mo6DNnvLfahoZ+i/o32lULuJ3NNiz7q6+pyAUkJaFF6JwaM2lUJlV0MlnQn5aTRbEu0SEqHUa0A4AdiGuB1kFXRfVyg5d87+Dg4DL6m2TLAub60ilj7A1Ec4odSAc8X95sHh7+ZRPCFo6Fnp7HfU/fBng/hi10CjCnWnJjsxvDNxWw0NfV6Rv5GgP3I3jGWXumdTD/3cbEOP2ZbOZp69yniG3FQ9z1jD7bnBu9Fc2tKGC2q+uAJOQHBDRiZX1x36o7fWBs7J9ownbtO+n0/qWkvW7UPIfc37WgT6ZGR++EOJyeQDSb9UB+DZ1G6DdLDzyS+b/kBCYGsYgJbSQHuThGKRcw5xdeQf8YdNHsc6ePXrlSYMBuSIAFTGAtQo+VuALo4BX83N190NWZWbynBjhOHsmNfFWLeL6v+ynsA58zDvvAC8j5PkbOcXCMg2PZFk3q8MjI7WAG/Dp9AwP7jdGBOOQkAvlFUB+irtm16I1Zw9YBcpGTGXYmk3kQIC/Cds55l+iMI3jqhjAuaoe+am2Jw5GT3Nbz3CkE12NavmzN5+erJW7046n/CH1RO/RVa8lBLozXk9uqykkGAyRXLWlLv5jyp4RFsG5vGVzpDLnIjTWgnRy2Rr+tDKvRc7Y8AyZq10jj8DqXdnIRNtFZb+t/ZRtXcDiVnzpqx8mPcDWxgARUqx0W1QB9MeUZiNrV4qP+Ehc+BpNgATsTX8ozYKL2NtFYAHc84fG7ndxUPr+AR/iQSns7uSUufAymwDOb2+NjK27lEFocm/EE2WpyIy/Hi66MWuMKJn8RvxIcj87IM5Vh9663ziW36kR0HNenXuxmfaD8JC7tfKbrhFr7LiZCrMjrzTeGx+PmkosrkNzW94ObzwocJ7A1HokLolY+AvkTiD/q1H0cN48c5EL8Crkttsa/AXQVDmutfyku0E7jShx49XqV3MFK8IryDhYVbj7Sj2P2eBxwcXoe8T8idsKKPRcnZw1b+slFTubwUwhktrfnAt7J++jwQtLZcm3sr9LQrjRzz6cfMv9aLvgmnAGvpoaGLxM4mAEaLV7iAzQ3oU0IvD5x9ix3yF2RAAuYAOO2f7PEFWCXZ4C9Pb2UsgDeVnFSpbFK7/IWu7TPTvBqzbGdCHOJQSxiEjt6IyZmxQyEJHv6xyQsYk//moVFsN2zP6fRImjfq7/n/wFDguUQFNEwugAAAABJRU5ErkJggg=='); + } + div.callout-important.callout-style-default .callout-title { + background-color: #f7dddc + } + + div.callout-warning { + border-left-color: #f0ad4e !important; + } + + div.callout-warning .callout-icon::before { + background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAETklEQVRYCeVWW2gcVRg+58yaTUnizqbipZeX4uWhBEniBaoUX1Ioze52t7sRq6APio9V9MEaoWlVsFasRq0gltaAPuxms8lu0gcviE/FFOstVbSIxgcv6SU7EZqmdc7v9+9mJtNks51NTUH84ed889/PP+cmxP+d5FIbMJmNbpREu4WUkiTtCicKny0l1pIKmBzovF2S+hIJHX8iEu3hZJ5lNZGqyRrGSIQpq15AzF28jgpeY6yk6GVdrfFqdrD6Iw+QlB8g0YS2g7dyQmXM/IDhBhT0UCiRf59lfqmmDvzRt6kByV/m4JjtzuaujMUM2c5Z2d6JdKrRb3K2q6mA+oYVz8JnDdKPmmNthzkAk/lN63sYPgevrguc72aZX/L9C6x09GYyxBgCX4NlvyGUHOKELlm5rXeR1kchuChJt4SSwyddZRXgvwMGvYo4QSlk3/zkHD8UHxwVJA6zjZZqP8v8kK8OWLnIZtLyCAJagYC4rTGW/9Pqj92N/c+LUaAj27movwbi19tk/whRCIE7Q9vyI6yvRpftAKVTdUjOW40X3h5OXsKCdmFcx0xlLJoSuQngnrJe7Kcjm4OMq9FlC7CMmScQANuNvjfP3PjGXDBaUQmbp296S5L4DrpbrHN1T87ZVEZVCzg1FF0Ft+dKrlLukI+/c9ENo+TvlTDbYFvuKPtQ9+l052rXrgKoWkDAFnvh0wTOmYn8R5f4k/jN/fZiCM1tQx9jQQ4ANhqG4hiL0qIFTGViG9DKB7GYzgubnpofgYRwO+DFjh0Zin2m4b/97EDkXkc+f6xYAPX0KK2I/7fUQuwzuwo/L3AkcjugPNixC8cHf0FyPjWlItmLxWw4Ou9YsQCr5fijMGoD/zpdRy95HRysyXA74MWOnscpO4j2y3HAVisw85hX5+AFBRSHt4ShfLFkIMXTqyKFc46xdzQM6XbAi702a7sy04J0+feReMFKp5q9esYLCqAZYw/k14E/xcLLsFElaornTuJB0svMuJINy8xkIYuL+xPAlWRceH6+HX7THJ0djLUom46zREu7tTkxwmf/FdOZ/sh6Q8qvEAiHpm4PJ4a/doJe0gH1t+aHRgCzOvBvJedEK5OFE5jpm4AGP2a8Dxe3gGJ/pAutug9Gp6he92CsSsWBaEcxGx0FHytmIpuqGkOpldqNYQK8cSoXvd+xLxXADw0kf6UkJNFtdo5MOgaLjiQOQHcn+A6h5NuL2s0qsC2LOM75PcF3yr5STuBSAcGG+meA14K/CI21HcS4LBT6tv0QAh8Dr5l93AhZzG5ZJ4VxAqdZUEl9z7WJ4aN+svMvwHHL21UKTd1mqvChH7/Za5xzXBBKrUcB0TQ+Ulgkfbi/H/YT5EptrGzsEK7tR1B7ln9BBwckYfMiuSqklSznIuoIIOM42MQO+QnduCoFCI0bpkzjCjddHPN/F+2Yu+sd9bKNpVwHhbS3LluK/0zgfwD0xYI5dXuzlQAAAABJRU5ErkJggg=='); + } + + div.callout-warning.callout-style-default .callout-title { + background-color: #fcefdc + } + + div.callout-tip { + border-left-color: #02b875 !important; + } + + div.callout-tip .callout-icon::before { + background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAADr0lEQVRYCe1XTWgTQRj9ZjZV8a9SPIkKgj8I1bMHsUWrqYLVg4Ue6v9BwZOxSYsIerFao7UiUryIqJcqgtpimhbBXoSCVxUFe9CTiogUrUp2Pt+3aUI2u5vdNh4dmMzOzHvvezuz8xNFM0mjnbXaNu1MvFWRXkXEyE6aYOYJpdW4IXuA4r0fo8qqSMDBU0v1HJUgVieAXxzCsdE/YJTdFcVIZQNMyhruOMJKXYFoLfIfIvVIMWdsrd+Rpd86ZmyzzjJmLStqRn0v8lzkb4rVIXvnpScOJuAn2ACC65FkPzEdEy4TPWRLJ2h7z4cArXzzaOdKlbOvKKX25Wl00jSnrwVxAg3o4dRxhO13RBSdNvH0xSARv3adTXbBdTf64IWO2vH0LT+cv4GR1DJt+DUItaQogeBX/chhbTBxEiZ6gftlDNXTrvT7co4ub5A6gp9HIcHvzTa46OS5fBeP87Qm0fQkr4FsYgVQ7Qg+ZayaDg9jhg1GkWj8RG6lkeSacrrHgDaxdoBiZPg+NXV/KifMuB6//JmYH4CntVEHy/keA6x4h4CU5oFy8GzrBS18cLJMXcljAKB6INjWsRcuZBWVaS3GDrqB7rdapVIeA+isQ57Eev9eCqzqOa81CY05VLd6SamW2wA2H3SiTbnbSxmzfp7WtKZkqy4mdyAlGx7ennghYf8voqp9cLSgKdqNfa6RdRsAAkPwRuJZNbpByn+RrJi1RXTwdi8RQF6ymDwGMAtZ6TVE+4uoKh+MYkcLsT0Hk8eAienbiGdjJHZTpmNjlbFJNKDVAp2fJlYju6IreQxQ08UJDNYdoLSl6AadO+fFuCQqVMB1NJwPm69T04Wv5WhfcWyfXQB+wXRs1pt+nCknRa0LVzSA/2B+a9+zQJadb7IyyV24YAxKp2Jqs3emZTuNnKxsah+uabKbMk7CbTgJx/zIgQYErIeTKRQ9yD9wxVof5YolPHqaWo7TD6tJlh7jQnK5z2n3+fGdggIOx2kaa2YI9QWarc5Ce1ipNWMKeSG4DysFF52KBmTNMmn5HqCFkwy34rDg05gDwgH3bBi+sgFhN/e8QvRn8kbamCOhgrZ9GJhFDgfcMHzFb6BAtjKpFhzTjwv1KCVuxHvCbsSiEz4CANnj84cwHdFXAbAOJ4LTSAawGWFn5tDhLMYz6nWeU2wJfIhmIJBefcd/A5FWQWGgrWzyORZ3Q6HuV+Jf0Bj+BTX69fm1zWgK7By1YTXchFDORywnfQ7GpzOo6S+qECrsx2ifVQAAAABJRU5ErkJggg=='); + } + + div.callout-tip.callout-style-default .callout-title { + background-color: #ccf1e3 + } + + div.callout-caution { + border-left-color: #fd7e14 !important; + } + + div.callout-caution .callout-icon::before { + background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAACV0lEQVRYCdVWzWoUQRCuqp2ICBLJXgITZL1EfQDBW/bkzUMUD7klD+ATSHBEfAIfQO+iXsWDxJsHL96EHAwhgzlkg8nBg25XWb0zIb0zs9muYYWkoKeru+vn664fBqElyZNuyh167NXJ8Ut8McjbmEraKHkd7uAnAFku+VWdb3reSmRV8PKSLfZ0Gjn3a6Xlcq9YGb6tADjn+lUfTXtVmaZ1KwBIvFI11rRXlWlatwIAAv2asaa9mlB9wwygiDX26qaw1yYPzFXg2N1GgG0FMF8Oj+VIx7E/03lHx8UhvYyNZLN7BwSPgekXXLribw7w5/c8EF+DBK5idvDVYtEEwMeYefjjLAdEyQ3M9nfOkgnPTEkYU+sxMq0BxNR6jExrAI31H1rzvLEfRIdgcv1XEdj6QTQAS2wtstEALLG1yEZ3QhH6oDX7ExBSFEkFINXH98NTrme5IOaaA7kIfiu2L8A3qhH9zRbukdCqdsA98TdElyeMe5BI8Rs2xHRIsoTSSVFfCFCWGPn9XHb4cdobRIWABNf0add9jakDjQJpJ1bTXOJXnnRXHRf+dNL1ZV1MBRCXhMbaHqGI1JkKIL7+i8uffuP6wVQAzO7+qVEbF6NbS0LJureYcWXUUhH66nLR5rYmva+2tjRFtojkM2aD76HEGAD3tPtKM309FJg5j/K682ywcWJ3PASCcycH/22u+Bh7Aa0ehM2Fu4z0SAE81HF9RkB21c5bEn4Dzw+/qNOyXr3DCTQDMBOdhi4nAgiFDGCinIa2owCEChUwD8qzd03PG+qdW/4fDzjUMcE1ZpIAAAAASUVORK5CYII='); + } + + div.callout-caution.callout-style-default .callout-title { + background-color: #ffe5d0 + } + + + + + +
    +
    -
    +
    +

    ADRG Template Update Proposal : An Open-Source Edition

    +
    +
    +
    +OSDocuMeta Working Group +
    +
    +
    -
    +
    +
    +

    About the WG

    -
    -

    Add background and mission statement - see Home page of website.

    + +
    +
    +

    Add background and mission statement - see Home page of website.

    • Background
    • Mission
    -
    -
    -
    +
    +
    +

    About Us

    -
    -

    Pics of us and 2 sentences about each of us

    + +
    +
    +

    Pics of us and 2 sentences about each of us

    • Lovemore Gavaka (Co-Lead)

    • Joel Laxamana (Co-Lead)

    • @@ -194,477 +364,458 @@

      +

    +
    +

    Where we are

    -
    -

    Share the current ADRG template we have now and how we want to update the template to include open-source metadata - Lovemore

    + +
    +
    +

    Share the current ADRG template we have now and how we want to update the template to include open-source metadata - Lovemore

    • Current ADRG Template
    • How we want to update the template
    -
    -

    Current ADRG from Pinnacle 21 vs an ADRG where Open-source submission was used,

    -
    -
    -

    list out the differences and note these differecnes as the updates we want to make to the current ADRG template to be Open-Source friendly.

    -
    +
    +

    Current ADRG from Pinnacle 21 vs an ADRG where Open-source submission was used,

    -
    +
    +

    list out the differences and note these differecnes as the updates we want to make to the current ADRG template to be Open-Source friendly.

    +
    +
    +

    Where we’re going

    -
    -

    List out all of the tables in this ADRG, here, that we can automate and generate sourcing available metadata

    + +
    +
    +

    List out all of the tables in this ADRG, here, that we can automate and generate sourcing available metadata

    • 1.2 Study Data Standards and Dictionary Inventory (Can this come from the TS SDTM domain?)

    • 3.1 Core Variables (come from the define.xml specificaions) -4.2 Data Dependencies (may need to some code scraping to read through each ADaM program and identify any other ADaMs being sourced in to create the ADaM) -5.2 Analysis Datasets (read in all of the .xpts in the submission package to extract the metadata for each ADaM to fill in this table) -6.2 Issues Summary (extract report from P21) -7.2 ADaM Programs (read in all of the .xpts in the submission package to extract the list of ADaMs and it’s label for each ADaM to fill in this table) -7.3 Analysis Output Programs (this one may be tricky as there are many study specific Selection Criteria to include) -7.4 Proprietary R Packages (Joel has some code for this, in R, essentially using SessionInfo() and {renv}) eCTD structure.

    • With these listed updates we want to make, we can utilize metadata to help fill in this information in the ADRG

    -
    -

    Challenge the file format delivered to the FDA, not only .pdf, but can we additionally submit .qmd files (or other file formats) as well so that the ADRG can be reproduced on the Agency side to help better click on code from the ADRG to help execute. Note : eCTD specifications say we can submit .qmd for analysis, but can we also submit it as a form of ADRG documentation.

    -
    -
    -
    +
    +

    Challenge the file format delivered to the FDA, not only .pdf, but can we additionally submit .qmd files (or other file formats) as well so that the ADRG can be reproduced on the Agency side to help better click on code from the ADRG to help execute. Note : eCTD specifications say we can submit .qmd for analysis, but can we also submit it as a form of ADRG documentation.

    +
    +
    +

    A new tool to automate ADRG generation

    -
    -

    Do we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.

    + +
    +
    +

    Do we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.

    • {osdocumeta}
    -
    -
    -
    +
    +

    The End. Questions?

    +
    + +
    +
    + -
    - + + + + + + + + + + + + + + + + + - - - - + } else { + return undefined; + } + }; + var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]'); + for (var i=0; i + \ No newline at end of file diff --git a/docs/references/problem_statement.html b/docs/references/problem_statement.html new file mode 100644 index 0000000..64b24f4 --- /dev/null +++ b/docs/references/problem_statement.html @@ -0,0 +1,657 @@ + + + + + + + + + + +Problem Statement – PHUSE WG : Open-Source Metadata Documentation (OSDocuMeta) + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    + +
    + + + + +
    + +
    +
    +

    Problem Statement

    +
    + + + +
    + +
    +
    Author
    +
    +

    OSDocuMeta Working Group

    +
    +
    + + + +
    + + + +
    + + +
    +

    PHUSE Working Group Proposal - Mission

    +

    This project aims to develop a new template, or enhance an existing one such as the Study Data Standardization Plan (SDSP) or Analysis Data Reviewer’s Guide (ADRG), to ensure that metadata pertaining to the versions of statistical packages and procedures is consistently documented in alignment with health authority expectations. This standardized template will streamline the submission of clinical study metadata to health authorities as part of the regulatory review process.

    +
    +
    +

    Introduction and review of problem statement

    +

    Note: In the following discussion for Proprietary Statistical Programming Languages, SAS will be used as an example and for Open Source, R will be used as an example.

    +

    As per the Study Data Technical Conformance Guide (version 5.7) section 4.1.2.10 on software Programs, Sponsors are required to provide the source code used to generate all ADaM datasets, tables, and figures linked to primary and secondary efficacy analyses. The source code should be submitted in single byte ASCII text format, with details of the specific software (version and operating system) specified in the ADRG.

    +

    Section 2.3 of the Study Data Technical Conformance Guide (version 5.7) highlights the significance of the Analysis Data Reviewer’s Guide (ADRG) as a crucial component of a standards-compliant analysis data submission for clinical trials. The ADRG offers FDA reviewers essential context for analysis datasets and terminology within regulatory product submissions. While the guide does not specify a specific template, an example can be accessed at https://advance.phuse.global/display/WEL/Deliverables. It’s important to note that the ADRG intentionally replicates key information from other submission documents (e.g., protocol, statistical analysis plan (SAP), clinical study report, define.xml) to provide FDA reviewers with a centralized reference for the analysis datasets. Additionally, some sponsors also outline the software used for analysis in the SAP.

    +
    +

    Proprietary Statistical Programming Languages

    +

    When using Proprietary Statistical Programming Languages such as SAS, specifying the SAS version is adequate. Each SAS version validates and includes all procedures and functions within that version, obviating the need to detail versions of individual functions/procedures. The specified SAS version is deemed comprehensive, enabling regulatory authorities to rerun the submitted programs. Additionally, any custom functions developed by the sponsor should also be submitted.

    +

    ADRG Example1: PhUSE ADRG Template Version

    +

    PhUSE ADRG Template Version 2019-07-18 - section 7: Submission of Programs.

    +

    supporting text: All SAS programs for analysis datasets and primary and secondary efficacy results are submitted. They were all created on a SAS platform using version 9.3. The internal reference date used to create dates in ADaM datasets is January 1, 1960.

    +

    ADRG Example1:

    +

    Section 7: Submission of Programs supporting text: All programs for analysis datasets as well as primary safety and efficacy results are submitted as shown below. All programs were created on a SAS platform using 9.4.

    +
    +
    +

    Open-Source software

    +

    The emergence of Open-Source software brings new complexities. For instance, in R, while each version comes with base packages/functions, there can be distinct versions of non-base functions/packages. This presents two key issues:

    +
      +
    1. Documenting the version of R and non-base packages used in the delivery (base R packages need not be specified as they are inherent to the R version). This also provides an opportunity to document custom functions, which is comparatively easier than in SAS.
    2. +
    3. Recreating the programming environment.
    4. +
    +

    Given that the submission using open source is still relatively new, it would greatly benefit the industry to have a common approach through industry guidance on the optimal way to submit this information.

    +

    ADRG Example1: R Submission Pilot 3

    +

    In the R Submission Pilot 3 ADRG, section 7 addresses challenge 1 as follows:

    +

    7.1 Description: The sponsor has provided all programs for analysis results. They are all created on a Linux platform using R version 4.2.3.

    +

    7.4 Proprietary R Packages and 7.5 Open-source R Analysis Packages

    +

    Challenge 2 is covered in 9.1 Appendix 1: Pilot 3 Installation and Usage.

    +

    ADRG Example2: Novo Nordisk R submission

    +

    Novo Nordisk has furnished a separate document, Instructions to programs in R, containing details on Submission files, Software requirements, Recreation of the R environment, and running the programs.

    +
    +
    +

    Questions/Mission for the WG

    +
    +

    Main

    +

    Regarding Challenge 1 and Challenge 2:

    +
      +
    • Is the ADRG the appropriate document to include the version of R and associated packages?
    • +
    • Should this information be documented in the SAP as well?
    • +
    • Do we require a separate document to complement the ADRG, addressing Challenge 1 and 2 as illustrated in the Novo Nordisk example?
    • +
    +
    +
    +

    Other

    +

    Situation: As per the Study Data Technical Conformance Guide, the ADRG for clinical data should be named ‘adrg.pdf’ and submitted in PDF format.

    +

    Question: Given that the document contains nonbinding recommendations, are regulatory authorities open to alternative submission formats such as Quarto/Rmd/md for document generation and accepting rendered documents in formats like html?

    +

    Situation: Once challenges 1 and 2 have been addressed, the regulator will require analysis results metadata for all tables in the submission, available in the define.xml. This metadata includes essential information for recreating specific analysis results, presented in a standard format, encompassing the analysis dataset, selection criteria, primary variable, and model statements.

    +

    Question: Is it within the purview of this group to tackle challenges 1 and 2 and devise methods to provide the analysis metadata (essentially creating a new ADRG template)?

    +

    Situation: It is essential to review the requirements of other regulatory agencies regarding software and programs.

    +

    Question: We should also verify the requirements of other agencies such as the European Medicines Agency (EMA), the Chinese National Medical Products Administration (NMPA), the Japanese Pharmaceuticals and Medical Devices Agency (PMDA), and so forth.

    +
    +
    +
    +

    References

    +
      +
    1. FDA Study Data Technical Conformance Guide (version 5.7): FDA Study Data Technical Conformance Guide
    2. +
    3. Analysis Data Reviewer’s Guide (ADRG) Package: Analysis Data Reviewer’s Guide (ADRG) Package
    4. +
    5. R Consortium Pilot 3 ADRG: R Consortium Pilot 3 ADRG
    6. +
    7. Instructions to Programs in R: Instructions to Programs in R
    8. +
    + + +
    +
    + +
    + +
    + + + + + \ No newline at end of file diff --git a/docs/search.json b/docs/search.json index 716526f..5cf0e22 100644 --- a/docs/search.json +++ b/docs/search.json @@ -20,89 +20,12 @@ "section": "", "text": "This project aims to develop a new template, or enhance an existing one such as the Study Data Standardization Plan (SDSP) or Analysis Data Reviewer’s Guide (ADRG), to ensure that metadata pertaining to the versions of statistical packages and procedures is consistently documented in alignment with health authority expectations. This standardized template will streamline the submission of clinical study metadata to health authorities as part of the regulatory review process.\nGithub" }, - { - "objectID": "minutes.html", - "href": "minutes.html", - "title": "Minutes", - "section": "", - "text": "Introduce ourselves and what we want to get out of this WG.\nDiscuss and decide how we want to start this off and pick a template document we want to work with first (e.g. ADRG).\nHow we want to track our work (e.g. github project board - create issues and self-assign to the work we feel comfortable doing)\nFrequency of our catch-ups to get status updates on work.\nDiscuss FDA quarterly meeting presentation :\n\nHope this time works for you. If not, please let me know. First action is to create a set of slides to present at FDA quarterly meeting : 16 October at 14:00 BST. I was thinking we can create quarto md slides.\n\n\n\n\nKO meeting 04Sep2024.\nFirst draft of slides due 13Sep2024 (or sooner).\n\n\nIntro : List out the current ADRG template we have now and how we want to update the template to include open-source metadata - Lovemore\nWithin the current ADRG from Pinnacle 21 vs an ADRG where Open-source submission was used, list out the differences and note these differecnes as the updates we want to make to the current ADRG template to be Open-Source friendly.\n\ne.g., List out all of the tables in this ADRG, here, that we can automate and generate sourcing available metadata\n\n1.2 Study Data Standards and Dictionary Inventory (Can this come from the TS SDTM domain?)\n3.1 Core Variables (come from the define.xml specificaions)\n4.2 Data Dependencies (may need to some code scraping to read through each ADaM program and identify any other ADaMs being sourced in to create the ADaM)\n5.2 Analysis Datasets (read in all of the .xpts in the submission package to extract the metadata for each ADaM to fill in this table)\n6.2 Issues Summary (extract report from P21)\n7.2 ADaM Programs (read in all of the .xpts in the submission package to extract the list of ADaMs and it’s label for each ADaM to fill in this table)\n7.3 Analysis Output Programs (this one may be tricky as there are many study specific Selection Criteria to include)\n7.4 Proprietary R Packages (Joel has some code for this, in R, essentially using SessionInfo() and {renv})\neCTD structure.\n\n\nWith these listed updates we want to make, we can utilize metadata to help fill in this information in the ADRG (Let’s list write out specifications as to where )\nChallenge the file format delivered to the FDA, not only .pdf, but can we additionally submit .qmd files (or other file formats) as well so that the ADRG can be reproduced on the Agency side to help better click on code from the ADRG to help execute. Note : eCTD specifications say we can submit .qmd for analysis, but can we also submit it as a form of ADRG documentation.\nDo we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.\n\n\nReview and Feedback due 20Sep2024.\n\n\nThings to think about :\n\nWe want this template to be able to support multiple open-source languages. Currently, R is the go-to in Clinical Trial submission now in the industry for open-source. Do we want to create an ADRG based on R as first go or do we want to add the complexity of having to think about multiple open-source programming languages? It would be good to keep the template as simple and user-friendly as possible. Have a think offline.\n\n\n\nUpdate and finalize slides due 27Sep2024.\nPractice presentation due TBD (anytime between 4 & 6)\nPresent 16Oct2024\n\n\n\n\n\nNicholas Masel to\n\nfind someone from CDISC as a POC for any questions we may have during this project.\nadd Steven H. from JnJ to this WG - Haesendonckx, Steven [JRDBE] shaesen2@ITS.JNJ.com\n\nHanming to\n\nfind out who from the FDA can get us invited to the next FDA quarterly meeting.\nwho will be the assigned FDA person(s) moving forward to collaborate with us on this project.\n\nJoel to create base .qmd slides for FDA meeting.\nAll to contribute to the .qmd slides per the timelines above.\n\n——– copy below and paste above, then update accordingly ———" - }, - { - "objectID": "minutes.html#sep2024", - "href": "minutes.html#sep2024", - "title": "Minutes", - "section": "", - "text": "Introduce ourselves and what we want to get out of this WG.\nDiscuss and decide how we want to start this off and pick a template document we want to work with first (e.g. ADRG).\nHow we want to track our work (e.g. github project board - create issues and self-assign to the work we feel comfortable doing)\nFrequency of our catch-ups to get status updates on work.\nDiscuss FDA quarterly meeting presentation :\n\nHope this time works for you. If not, please let me know. First action is to create a set of slides to present at FDA quarterly meeting : 16 October at 14:00 BST. I was thinking we can create quarto md slides.\n\n\n\n\nKO meeting 04Sep2024.\nFirst draft of slides due 13Sep2024 (or sooner).\n\n\nIntro : List out the current ADRG template we have now and how we want to update the template to include open-source metadata - Lovemore\nWithin the current ADRG from Pinnacle 21 vs an ADRG where Open-source submission was used, list out the differences and note these differecnes as the updates we want to make to the current ADRG template to be Open-Source friendly.\n\ne.g., List out all of the tables in this ADRG, here, that we can automate and generate sourcing available metadata\n\n1.2 Study Data Standards and Dictionary Inventory (Can this come from the TS SDTM domain?)\n3.1 Core Variables (come from the define.xml specificaions)\n4.2 Data Dependencies (may need to some code scraping to read through each ADaM program and identify any other ADaMs being sourced in to create the ADaM)\n5.2 Analysis Datasets (read in all of the .xpts in the submission package to extract the metadata for each ADaM to fill in this table)\n6.2 Issues Summary (extract report from P21)\n7.2 ADaM Programs (read in all of the .xpts in the submission package to extract the list of ADaMs and it’s label for each ADaM to fill in this table)\n7.3 Analysis Output Programs (this one may be tricky as there are many study specific Selection Criteria to include)\n7.4 Proprietary R Packages (Joel has some code for this, in R, essentially using SessionInfo() and {renv})\neCTD structure.\n\n\nWith these listed updates we want to make, we can utilize metadata to help fill in this information in the ADRG (Let’s list write out specifications as to where )\nChallenge the file format delivered to the FDA, not only .pdf, but can we additionally submit .qmd files (or other file formats) as well so that the ADRG can be reproduced on the Agency side to help better click on code from the ADRG to help execute. Note : eCTD specifications say we can submit .qmd for analysis, but can we also submit it as a form of ADRG documentation.\nDo we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.\n\n\nReview and Feedback due 20Sep2024.\n\n\nThings to think about :\n\nWe want this template to be able to support multiple open-source languages. Currently, R is the go-to in Clinical Trial submission now in the industry for open-source. Do we want to create an ADRG based on R as first go or do we want to add the complexity of having to think about multiple open-source programming languages? It would be good to keep the template as simple and user-friendly as possible. Have a think offline.\n\n\n\nUpdate and finalize slides due 27Sep2024.\nPractice presentation due TBD (anytime between 4 & 6)\nPresent 16Oct2024\n\n\n\n\n\nNicholas Masel to\n\nfind someone from CDISC as a POC for any questions we may have during this project.\nadd Steven H. from JnJ to this WG - Haesendonckx, Steven [JRDBE] shaesen2@ITS.JNJ.com\n\nHanming to\n\nfind out who from the FDA can get us invited to the next FDA quarterly meeting.\nwho will be the assigned FDA person(s) moving forward to collaborate with us on this project.\n\nJoel to create base .qmd slides for FDA meeting.\nAll to contribute to the .qmd slides per the timelines above.\n\n——– copy below and paste above, then update accordingly ———" - }, - { - "objectID": "minutes.html#ddmmmyyyy", - "href": "minutes.html#ddmmmyyyy", - "title": "Minutes", - "section": "ddmmmyyyy", - "text": "ddmmmyyyy\n\nAgenda :\n\nitem 1\nitem 2\netc…\n\n\n\nActions/Issues & Timelines :\n\naction/issue 1 & planned due date\naction/issue 2 & planned due date\netc…\n\n\n\nOther Notes or Actions :\n\nadd any other business here\netc…" - }, - { - "objectID": "aboutus.html", - "href": "aboutus.html", - "title": "About Us", - "section": "", - "text": "add mini-bio here" - }, - { - "objectID": "aboutus.html#lovemore-gavaka", - "href": "aboutus.html#lovemore-gavaka", - "title": "About Us", - "section": "", - "text": "add mini-bio here" - }, - { - "objectID": "aboutus.html#joel-laxamana", - "href": "aboutus.html#joel-laxamana", - "title": "About Us", - "section": "Joel Laxamana", - "text": "Joel Laxamana\nadd mini-bio here" - }, - { - "objectID": "aboutus.html#nicholas-masel", - "href": "aboutus.html#nicholas-masel", - "title": "About Us", - "section": "Nicholas Masel", - "text": "Nicholas Masel\nadd mini-bio here" - }, - { - "objectID": "references/osdocumeta_proposal_fda_qtrly.html#getting-up", - "href": "references/osdocumeta_proposal_fda_qtrly.html#getting-up", - "title": "ADRG Template Update Proposal : An Open-Source Edition", - "section": "Getting up", - "text": "Getting up\n\nTurn off alarm\nGet out of bed" - }, - { - "objectID": "references/osdocumeta_proposal_fda_qtrly.html#breakfast", - "href": "references/osdocumeta_proposal_fda_qtrly.html#breakfast", - "title": "ADRG Template Update Proposal : An Open-Source Edition", - "section": "Breakfast", - "text": "Breakfast\n\nEat eggs\nDrink coffee" - }, - { - "objectID": "references/osdocumeta_proposal_fda_qtrly.html#dinner", - "href": "references/osdocumeta_proposal_fda_qtrly.html#dinner", - "title": "ADRG Template Update Proposal : An Open-Source Edition", - "section": "Dinner", - "text": "Dinner\n\nEat spaghetti\nDrink wine" - }, - { - "objectID": "references/osdocumeta_proposal_fda_qtrly.html#going-to-sleep", - "href": "references/osdocumeta_proposal_fda_qtrly.html#going-to-sleep", - "title": "ADRG Template Update Proposal : An Open-Source Edition", - "section": "Going to sleep", - "text": "Going to sleep\n\nGet in bed\nCount sheep" - }, { "objectID": "references/osdocumeta_proposal_fda_qtrly.html#add-background-and-mission-statement---see-home-page-of-website.", "href": "references/osdocumeta_proposal_fda_qtrly.html#add-background-and-mission-statement---see-home-page-of-website.", "title": "ADRG Template Update Proposal : An Open-Source Edition", - "section": "", - "text": "Background\nMission" + "section": "Add background and mission statement - see Home page of website.", + "text": "Add background and mission statement - see Home page of website.\n\nBackground\nMission" }, { "objectID": "references/osdocumeta_proposal_fda_qtrly.html#pics-of-us-and-2-sentences-about-each-of-us", @@ -154,10 +77,73 @@ "text": "Do we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.\n\n{osdocumeta}" }, { - "objectID": "references/osdocumeta_proposal_fda_qtrly.html", - "href": "references/osdocumeta_proposal_fda_qtrly.html", - "title": "ADRG Template Update Proposal : An Open-Source Edition", + "objectID": "minutes.html", + "href": "minutes.html", + "title": "Minutes", + "section": "", + "text": "Introduce ourselves and what we want to get out of this WG.\nDiscuss and decide how we want to start this off and pick a template document we want to work with first (e.g. ADRG).\nHow we want to track our work (e.g. github project board - create issues and self-assign to the work we feel comfortable doing)\nFrequency of our catch-ups to get status updates on work.\nDiscuss FDA quarterly meeting presentation :\n\nHope this time works for you. If not, please let me know. First action is to create a set of slides to present at FDA quarterly meeting : 16 October at 14:00 BST. I was thinking we can create quarto md slides.\n\n\n\n\nKO meeting 04Sep2024.\nFirst draft of slides due 13Sep2024 (or sooner).\n\n\nIntro : List out the current ADRG template we have now and how we want to update the template to include open-source metadata - Lovemore\nWithin the current ADRG from Pinnacle 21 vs an ADRG where Open-source submission was used, list out the differences and note these differecnes as the updates we want to make to the current ADRG template to be Open-Source friendly.\n\ne.g., List out all of the tables in this ADRG, here, that we can automate and generate sourcing available metadata\n\n1.2 Study Data Standards and Dictionary Inventory (Can this come from the TS SDTM domain?)\n3.1 Core Variables (come from the define.xml specificaions)\n4.2 Data Dependencies (may need to some code scraping to read through each ADaM program and identify any other ADaMs being sourced in to create the ADaM)\n5.2 Analysis Datasets (read in all of the .xpts in the submission package to extract the metadata for each ADaM to fill in this table)\n6.2 Issues Summary (extract report from P21)\n7.2 ADaM Programs (read in all of the .xpts in the submission package to extract the list of ADaMs and it’s label for each ADaM to fill in this table)\n7.3 Analysis Output Programs (this one may be tricky as there are many study specific Selection Criteria to include)\n7.4 Proprietary R Packages (Joel has some code for this, in R, essentially using SessionInfo() and {renv})\neCTD structure.\n\n\nWith these listed updates we want to make, we can utilize metadata to help fill in this information in the ADRG (Let’s list write out specifications as to where )\nChallenge the file format delivered to the FDA, not only .pdf, but can we additionally submit .qmd files (or other file formats) as well so that the ADRG can be reproduced on the Agency side to help better click on code from the ADRG to help execute. Note : eCTD specifications say we can submit .qmd for analysis, but can we also submit it as a form of ADRG documentation.\nDo we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.\n\n\nReview and Feedback due 20Sep2024.\n\n\nThings to think about :\n\nWe want this template to be able to support multiple open-source languages. Currently, R is the go-to in Clinical Trial submission now in the industry for open-source. Do we want to create an ADRG based on R as first go or do we want to add the complexity of having to think about multiple open-source programming languages? It would be good to keep the template as simple and user-friendly as possible. Have a think offline.\n\n\n\nUpdate and finalize slides due 27Sep2024.\nPractice presentation due TBD (anytime between 4 & 6)\nPresent 16Oct2024\n\n\n\n\n\nNicholas Masel to\n\nfind someone from CDISC as a POC for any questions we may have during this project.\nadd Steven H. from JnJ to this WG - Haesendonckx, Steven [JRDBE] shaesen2@ITS.JNJ.com\n\nHanming to\n\nfind out who from the FDA can get us invited to the next FDA quarterly meeting.\nwho will be the assigned FDA person(s) moving forward to collaborate with us on this project.\n\nJoel to create base .qmd slides for FDA meeting.\nAll to contribute to the .qmd slides per the timelines above.\n\n——– copy below and paste above, then update accordingly ———" + }, + { + "objectID": "minutes.html#sep2024", + "href": "minutes.html#sep2024", + "title": "Minutes", + "section": "", + "text": "Introduce ourselves and what we want to get out of this WG.\nDiscuss and decide how we want to start this off and pick a template document we want to work with first (e.g. ADRG).\nHow we want to track our work (e.g. github project board - create issues and self-assign to the work we feel comfortable doing)\nFrequency of our catch-ups to get status updates on work.\nDiscuss FDA quarterly meeting presentation :\n\nHope this time works for you. If not, please let me know. First action is to create a set of slides to present at FDA quarterly meeting : 16 October at 14:00 BST. I was thinking we can create quarto md slides.\n\n\n\n\nKO meeting 04Sep2024.\nFirst draft of slides due 13Sep2024 (or sooner).\n\n\nIntro : List out the current ADRG template we have now and how we want to update the template to include open-source metadata - Lovemore\nWithin the current ADRG from Pinnacle 21 vs an ADRG where Open-source submission was used, list out the differences and note these differecnes as the updates we want to make to the current ADRG template to be Open-Source friendly.\n\ne.g., List out all of the tables in this ADRG, here, that we can automate and generate sourcing available metadata\n\n1.2 Study Data Standards and Dictionary Inventory (Can this come from the TS SDTM domain?)\n3.1 Core Variables (come from the define.xml specificaions)\n4.2 Data Dependencies (may need to some code scraping to read through each ADaM program and identify any other ADaMs being sourced in to create the ADaM)\n5.2 Analysis Datasets (read in all of the .xpts in the submission package to extract the metadata for each ADaM to fill in this table)\n6.2 Issues Summary (extract report from P21)\n7.2 ADaM Programs (read in all of the .xpts in the submission package to extract the list of ADaMs and it’s label for each ADaM to fill in this table)\n7.3 Analysis Output Programs (this one may be tricky as there are many study specific Selection Criteria to include)\n7.4 Proprietary R Packages (Joel has some code for this, in R, essentially using SessionInfo() and {renv})\neCTD structure.\n\n\nWith these listed updates we want to make, we can utilize metadata to help fill in this information in the ADRG (Let’s list write out specifications as to where )\nChallenge the file format delivered to the FDA, not only .pdf, but can we additionally submit .qmd files (or other file formats) as well so that the ADRG can be reproduced on the Agency side to help better click on code from the ADRG to help execute. Note : eCTD specifications say we can submit .qmd for analysis, but can we also submit it as a form of ADRG documentation.\nDo we want to bring up the possibility of creating an open-source package for this to help automate the use of metadata in the ADRG documentation.\n\n\nReview and Feedback due 20Sep2024.\n\n\nThings to think about :\n\nWe want this template to be able to support multiple open-source languages. Currently, R is the go-to in Clinical Trial submission now in the industry for open-source. Do we want to create an ADRG based on R as first go or do we want to add the complexity of having to think about multiple open-source programming languages? It would be good to keep the template as simple and user-friendly as possible. Have a think offline.\n\n\n\nUpdate and finalize slides due 27Sep2024.\nPractice presentation due TBD (anytime between 4 & 6)\nPresent 16Oct2024\n\n\n\n\n\nNicholas Masel to\n\nfind someone from CDISC as a POC for any questions we may have during this project.\nadd Steven H. from JnJ to this WG - Haesendonckx, Steven [JRDBE] shaesen2@ITS.JNJ.com\n\nHanming to\n\nfind out who from the FDA can get us invited to the next FDA quarterly meeting.\nwho will be the assigned FDA person(s) moving forward to collaborate with us on this project.\n\nJoel to create base .qmd slides for FDA meeting.\nAll to contribute to the .qmd slides per the timelines above.\n\n——– copy below and paste above, then update accordingly ———" + }, + { + "objectID": "minutes.html#ddmmmyyyy", + "href": "minutes.html#ddmmmyyyy", + "title": "Minutes", + "section": "ddmmmyyyy", + "text": "ddmmmyyyy\n\nAgenda :\n\nitem 1\nitem 2\netc…\n\n\n\nActions/Issues & Timelines :\n\naction/issue 1 & planned due date\naction/issue 2 & planned due date\netc…\n\n\n\nOther Notes or Actions :\n\nadd any other business here\netc…" + }, + { + "objectID": "references/problem_statement.html", + "href": "references/problem_statement.html", + "title": "Problem Statement", + "section": "", + "text": "This project aims to develop a new template, or enhance an existing one such as the Study Data Standardization Plan (SDSP) or Analysis Data Reviewer’s Guide (ADRG), to ensure that metadata pertaining to the versions of statistical packages and procedures is consistently documented in alignment with health authority expectations. This standardized template will streamline the submission of clinical study metadata to health authorities as part of the regulatory review process." + }, + { + "objectID": "references/problem_statement.html#phuse-working-group-proposal---mission", + "href": "references/problem_statement.html#phuse-working-group-proposal---mission", + "title": "Problem Statement", + "section": "", + "text": "This project aims to develop a new template, or enhance an existing one such as the Study Data Standardization Plan (SDSP) or Analysis Data Reviewer’s Guide (ADRG), to ensure that metadata pertaining to the versions of statistical packages and procedures is consistently documented in alignment with health authority expectations. This standardized template will streamline the submission of clinical study metadata to health authorities as part of the regulatory review process." + }, + { + "objectID": "references/problem_statement.html#introduction-and-review-of-problem-statement", + "href": "references/problem_statement.html#introduction-and-review-of-problem-statement", + "title": "Problem Statement", + "section": "Introduction and review of problem statement", + "text": "Introduction and review of problem statement\nNote: In the following discussion for Proprietary Statistical Programming Languages, SAS will be used as an example and for Open Source, R will be used as an example.\nAs per the Study Data Technical Conformance Guide (version 5.7) section 4.1.2.10 on software Programs, Sponsors are required to provide the source code used to generate all ADaM datasets, tables, and figures linked to primary and secondary efficacy analyses. The source code should be submitted in single byte ASCII text format, with details of the specific software (version and operating system) specified in the ADRG.\nSection 2.3 of the Study Data Technical Conformance Guide (version 5.7) highlights the significance of the Analysis Data Reviewer’s Guide (ADRG) as a crucial component of a standards-compliant analysis data submission for clinical trials. The ADRG offers FDA reviewers essential context for analysis datasets and terminology within regulatory product submissions. While the guide does not specify a specific template, an example can be accessed at https://advance.phuse.global/display/WEL/Deliverables. It’s important to note that the ADRG intentionally replicates key information from other submission documents (e.g., protocol, statistical analysis plan (SAP), clinical study report, define.xml) to provide FDA reviewers with a centralized reference for the analysis datasets. Additionally, some sponsors also outline the software used for analysis in the SAP.\n\nProprietary Statistical Programming Languages\nWhen using Proprietary Statistical Programming Languages such as SAS, specifying the SAS version is adequate. Each SAS version validates and includes all procedures and functions within that version, obviating the need to detail versions of individual functions/procedures. The specified SAS version is deemed comprehensive, enabling regulatory authorities to rerun the submitted programs. Additionally, any custom functions developed by the sponsor should also be submitted.\nADRG Example1: PhUSE ADRG Template Version\nPhUSE ADRG Template Version 2019-07-18 - section 7: Submission of Programs.\nsupporting text: All SAS programs for analysis datasets and primary and secondary efficacy results are submitted. They were all created on a SAS platform using version 9.3. The internal reference date used to create dates in ADaM datasets is January 1, 1960.\nADRG Example1:\nSection 7: Submission of Programs supporting text: All programs for analysis datasets as well as primary safety and efficacy results are submitted as shown below. All programs were created on a SAS platform using 9.4.\n\n\nOpen-Source software\nThe emergence of Open-Source software brings new complexities. For instance, in R, while each version comes with base packages/functions, there can be distinct versions of non-base functions/packages. This presents two key issues:\n\nDocumenting the version of R and non-base packages used in the delivery (base R packages need not be specified as they are inherent to the R version). This also provides an opportunity to document custom functions, which is comparatively easier than in SAS.\nRecreating the programming environment.\n\nGiven that the submission using open source is still relatively new, it would greatly benefit the industry to have a common approach through industry guidance on the optimal way to submit this information.\nADRG Example1: R Submission Pilot 3\nIn the R Submission Pilot 3 ADRG, section 7 addresses challenge 1 as follows:\n7.1 Description: The sponsor has provided all programs for analysis results. They are all created on a Linux platform using R version 4.2.3.\n7.4 Proprietary R Packages and 7.5 Open-source R Analysis Packages\nChallenge 2 is covered in 9.1 Appendix 1: Pilot 3 Installation and Usage.\nADRG Example2: Novo Nordisk R submission\nNovo Nordisk has furnished a separate document, Instructions to programs in R, containing details on Submission files, Software requirements, Recreation of the R environment, and running the programs.\n\n\nQuestions/Mission for the WG\n\nMain\nRegarding Challenge 1 and Challenge 2:\n\nIs the ADRG the appropriate document to include the version of R and associated packages?\nShould this information be documented in the SAP as well?\nDo we require a separate document to complement the ADRG, addressing Challenge 1 and 2 as illustrated in the Novo Nordisk example?\n\n\n\nOther\nSituation: As per the Study Data Technical Conformance Guide, the ADRG for clinical data should be named ‘adrg.pdf’ and submitted in PDF format.\nQuestion: Given that the document contains nonbinding recommendations, are regulatory authorities open to alternative submission formats such as Quarto/Rmd/md for document generation and accepting rendered documents in formats like html?\nSituation: Once challenges 1 and 2 have been addressed, the regulator will require analysis results metadata for all tables in the submission, available in the define.xml. This metadata includes essential information for recreating specific analysis results, presented in a standard format, encompassing the analysis dataset, selection criteria, primary variable, and model statements.\nQuestion: Is it within the purview of this group to tackle challenges 1 and 2 and devise methods to provide the analysis metadata (essentially creating a new ADRG template)?\nSituation: It is essential to review the requirements of other regulatory agencies regarding software and programs.\nQuestion: We should also verify the requirements of other agencies such as the European Medicines Agency (EMA), the Chinese National Medical Products Administration (NMPA), the Japanese Pharmaceuticals and Medical Devices Agency (PMDA), and so forth.\n\n\n\nReferences\n\nFDA Study Data Technical Conformance Guide (version 5.7): FDA Study Data Technical Conformance Guide\nAnalysis Data Reviewer’s Guide (ADRG) Package: Analysis Data Reviewer’s Guide (ADRG) Package\nR Consortium Pilot 3 ADRG: R Consortium Pilot 3 ADRG\nInstructions to Programs in R: Instructions to Programs in R" + }, + { + "objectID": "aboutus.html", + "href": "aboutus.html", + "title": "About Us", "section": "", - "text": "Background\nMission" + "text": "add mini-bio here" + }, + { + "objectID": "aboutus.html#lovemore-gavaka", + "href": "aboutus.html#lovemore-gavaka", + "title": "About Us", + "section": "", + "text": "add mini-bio here" + }, + { + "objectID": "aboutus.html#joel-laxamana", + "href": "aboutus.html#joel-laxamana", + "title": "About Us", + "section": "Joel Laxamana", + "text": "Joel Laxamana\nadd mini-bio here" + }, + { + "objectID": "aboutus.html#nicholas-masel", + "href": "aboutus.html#nicholas-masel", + "title": "About Us", + "section": "Nicholas Masel", + "text": "Nicholas Masel\nadd mini-bio here" } ] \ No newline at end of file diff --git a/references/problem_statement.qmd b/references/problem_statement.qmd new file mode 100644 index 0000000..ecc6bc6 --- /dev/null +++ b/references/problem_statement.qmd @@ -0,0 +1,84 @@ +--- +title: "Problem Statement" +author: "OSDocuMeta Working Group" +--- + +## PHUSE Working Group Proposal - Mission + +This project aims to develop a new template, or enhance an existing one such as the Study Data Standardization Plan (SDSP) or Analysis Data Reviewer’s Guide (ADRG), to ensure that metadata pertaining to the **versions of statistical packages and procedures** is consistently documented in alignment with health authority expectations. This standardized template will streamline the submission of clinical study metadata to health authorities as part of the regulatory review process. + +## Introduction and review of problem statement + +*Note: In the following discussion for Proprietary Statistical Programming Languages, SAS will be used as an example and for Open Source, R will be used as an example.* + +As per the [Study Data Technical Conformance Guide (version 5.7)](https://www.fda.gov/regulatory-information/search-fda-guidance-documents/study-data-technical-conformance-guide-technical-specifications-document) section 4.1.2.10 on software Programs, Sponsors are required to provide the source code used to generate all ADaM datasets, tables, and figures linked to primary and secondary efficacy analyses. The source code should be submitted in single byte ASCII text format, with details of the specific software (version and operating system) specified in the ADRG. + +Section 2.3 of the Study Data Technical Conformance Guide (version 5.7) highlights the significance of the Analysis Data Reviewer’s Guide (ADRG) as a crucial component of a standards-compliant analysis data submission for clinical trials. The ADRG offers FDA reviewers essential context for analysis datasets and terminology within regulatory product submissions. While the guide does not specify a specific template, an example can be accessed at It's important to note that the ADRG intentionally replicates key information from other submission documents (e.g., protocol, statistical analysis plan (SAP), clinical study report, define.xml) to provide FDA reviewers with a centralized reference for the analysis datasets. Additionally, some sponsors also outline the software used for analysis in the SAP. + +### Proprietary Statistical Programming Languages + +When using Proprietary Statistical Programming Languages such as SAS, specifying the SAS version is adequate. Each SAS version validates and includes all procedures and functions within that version, obviating the need to detail versions of individual functions/procedures. The specified SAS version is deemed comprehensive, enabling regulatory authorities to rerun the submitted programs. Additionally, any custom functions developed by the sponsor should also be submitted. + +**ADRG Example1: PhUSE ADRG Template Version** + +[PhUSE ADRG Template Version 2019-07-18](https://advance.phuse.global/display/WEL/Analysis+Data+Reviewer%27s+Guide+(ADRG)+Package) - section 7: Submission of Programs. + +supporting text: *All SAS programs for analysis datasets and primary and secondary efficacy results are submitted. They were all created on a SAS platform using version 9.3. The internal reference date used to create dates in ADaM datasets is January 1, 1960.* + +**ADRG Example1:** + +Section 7: Submission of Programs supporting text: *All programs for analysis datasets as well as primary safety and efficacy results are submitted as shown below. All programs were created on a SAS platform using 9.4.* + +### Open-Source software + +The emergence of Open-Source software brings new complexities. For instance, in R, while each version comes with base packages/functions, there can be distinct versions of non-base functions/packages. This presents two key issues: + +1. Documenting the version of R and non-base packages used in the delivery (base R packages need not be specified as they are inherent to the R version). This also provides an opportunity to document custom functions, which is comparatively easier than in SAS. +2. Recreating the programming environment. + +Given that the submission using open source is still relatively new, it would greatly benefit the industry to have a common approach through industry guidance on the optimal way to submit this information. + +**ADRG Example1: R Submission Pilot 3** + +In the [R Submission Pilot 3 ADRG](https://github.com/RConsortium/submissions-pilot3-adam-to-fda/blob/main/m5/datasets/rconsortiumpilot3/analysis/adam/datasets/adrg.pdf), section 7 addresses challenge 1 as follows: + +*7.1 Description*: The sponsor has provided all programs for analysis results. They are all created on a Linux platform using R version 4.2.3. + +*7.4 Proprietary R Packages and 7.5 Open-source R Analysis Packages* + +Challenge 2 is covered in 9.1 Appendix 1: Pilot 3 Installation and Usage. + +**ADRG Example2: Novo Nordisk R submission** + +Novo Nordisk has furnished a separate document, [Instructions to programs in R](https://github.com/NNaikp/phuse-css-2023/blob/main/submission-files/instructions-to-programs-in-r.Rmd), containing details on Submission files, Software requirements, Recreation of the R environment, and running the programs. + +### Questions/Mission for the WG + +#### Main + +Regarding Challenge 1 and Challenge 2: + +- Is the ADRG the appropriate document to include the version of R and associated packages? +- Should this information be documented in the SAP as well? +- Do we require a separate document to complement the ADRG, addressing Challenge 1 and 2 as illustrated in the Novo Nordisk example? + +#### Other + +***Situation***: As per the Study Data Technical Conformance Guide, the ADRG for clinical data should be named 'adrg.pdf' and submitted in PDF format. + +***Question***: Given that the document contains nonbinding recommendations, are regulatory authorities open to alternative submission formats such as Quarto/Rmd/md for document generation and accepting rendered documents in formats like html? + +***Situation***: Once challenges 1 and 2 have been addressed, the regulator will require analysis results metadata for all tables in the submission, available in the define.xml. This metadata includes essential information for recreating specific analysis results, presented in a standard format, encompassing the analysis dataset, selection criteria, primary variable, and model statements. + +***Question***: Is it within the purview of this group to tackle challenges 1 and 2 and devise methods to provide the analysis metadata (essentially creating a new ADRG template)? + +***Situation***: It is essential to review the requirements of other regulatory agencies regarding software and programs. + +***Question***: We should also verify the requirements of other agencies such as the European Medicines Agency (EMA), the Chinese National Medical Products Administration (NMPA), the Japanese Pharmaceuticals and Medical Devices Agency (PMDA), and so forth. + +### References + +1. FDA Study Data Technical Conformance Guide (version 5.7): [FDA Study Data Technical Conformance Guide](https://www.fda.gov/regulatory-information/search-fda-guidance-documents/study-data-technical-conformance-guide-technical-specifications-document) +2. Analysis Data Reviewer's Guide (ADRG) Package: [Analysis Data Reviewer's Guide (ADRG) Package](https://advance.phuse.global/display/WEL/Analysis+Data+Reviewer%27s+Guide+(ADRG)+Package) +3. R Consortium Pilot 3 ADRG: [R Consortium Pilot 3 ADRG](https://github.com/RConsortium/submissions-pilot3-adam-to-fda/blob/main/m5/datasets/rconsortiumpilot3/analysis/adam/datasets/adrg.pdf) +4. Instructions to Programs in R: [Instructions to Programs in R](https://github.com/NNaikp/phuse-css-2023/blob/main/submission-files/instructions-to-programs-in-r.Rmd)