Package 'DataTidyACSClinical'

Title: Provision ACS clinical data
Description: Provision ACS clinical data
Authors: Miguel Rodo [aut, cre]
Maintainer: Miguel Rodo <[email protected]>
License: CC BY 4.0
Version: 1.0.3
Built: 2026-06-04 11:02:05 UTC
Source: https://github.com/SATVILab/DataTidyACSClinical

Help Index


The clinical variables for the ACS cohort.

Description

The clinical variables for the ACS cohort, including both fixed and time-varying variables.

Format

a tbl_df containing the following fields:

SubjectID

Participant ID

PID

New participant ID.

ProgressorOrControl

Whether an individual was a progressor OR matched control ("yes") or not ("no").

Progressor

Whether an individual was a progressor ("yes") or a matched control ("no"). If neither, then the value 999 is given.

Zak2016Progressor

Whether an individual was a progressor ('yes') or not ("no") as per the Zak (2016) Lancet paper. No information as to whether an individual is a matched control is provided by this column.

Scriba2018ProgressorOrControl

Whether an individual was a progress("progressor"), a matched control ("control") or neither ("neither") as per the Scriba (2018) PLOS Pathogens paper. This column was used to decide whether subjects that did not develop TB during the study and had assay data were matched controls or not.

TBCase

Labelled "yes" if the subject either had TB at study entry or developed it during the study.

TBCaseType

Whether TB case was prevalent (TB already at study entry) or incident (TB developed during study).

EndOfStudyStatus

Follow-up status of subject at end of study.

EnrolmentDate

Date of enrolment.

DateAWOL

If applicable, date of leaving study for no known reason.

DateConsentWithdrawn

Date consent was withdrawn.

DateDeath

If applicable, date of death.

DateCensor

If applicable, date of censoring.

TreatmentStart

Date of initiating TB treatment, if begun during study.

TreatmentEnd

Date of ending TB treatment, if ended during study.

timeToTB

Number of days to TB diagnosis. Negative values indicate diagnosis in the past.

DateOfLstVisitOrDeath

Date of last visit or death.

DateSurvExit

Date of exit from a survival analysis study.

EverInfected

Whether an individual ever had either QFT>0.35 or TST>5 at any visit.

StudyGroup

Study arm.

HIVPositive

Whether an individual was found to be HIV+ during the study.

Pregnant

Whether an individual was found to be pregnant during the study.

Sex

Gender.

AgeAtLastBirthday

Age at last birthday in years at study entry.

Ethnicity

Ethnicity.

VaccinatedWithBCG

Whether subject was vaccinated with BCG.

BCGScar

Whether subject had a BCG scar.

Height

Height in metres at study entry.

Weight

Weight in kilograms at study entry.

PreviousDiagnosisOfTB

Whether participant had been diagnosed with TB before entering study.

YearPreviousDiagnosisOfTB

Year of previous diagnosis of TB, if diagnosed with TB before entering study.

CurrentlyOnTBTreatment

Whether participant was on TB treatment at study entry.

TBTreatmentStarted

When treatment was started, if subject was on TB treatment at study entry.

HouseholdMemberOnTBTreatment

Whether a household member was on TB treatment at study entry.

LivedInHouseWithTBPatient

Whether the subject had lived in a house with a TB patient at study entry.

TBContactYear

Year of contact with a household TB contact, if the subject had a household TB contact before study entry.

TBContactYearFinal

Last year of contact with a household TB contact, if the subject had a household TB contact before study entry.

SchoolCode

Code indicating school at study entry. Anonymised.

SchoolGrade

School grade at study entry.

MotherGrossMonthlyIncome, FatherGrossMonthlyIncome, GuardianGrossMonthlyIncome

Gross monthly income of mother, father and guardian, respectively, at study entry.

PastMedicalHistory

Whether subject had a past medical history at study entry.

ChronicIllness

Whether subject had a chronic illness at study entry.

ChronicIllnessDetails

Type of chronic illness at study entry.

ConfirmedInformationWithSubject

Whether information provided was confirmed by parent or guardian.

SampleID

Concatenation of SubjectID and VisitType.

SampleAvailable

Whether a sample was available from that subject at that visit.

VisitType

The type of the visit.

VisitTypeDaysSinceEntry

Number of days planned between visit and enrolment date.

VisitDate

The date of the visit.

DaysSinceEntry

Number of days between actual visit date and enrolment date.

WasSubjectSeen

When subject was seen at that visit.

ReasonNotSeen

If subject was not seen at that visit, the reason why.

OrigReasonNotSeen

Unformatted reason not seen originally provided. These reasons were combiend to form the ReasonNotSeen column.

CurrentlyInfected

Whether the individual had either QFT>0.35 or TST>5 at this visit.

InfectedNowOrBefore

Whether the individual had either QFT>0.35 or TST>5 at either this visit or a previous visit.

Cough

Presence of cough.

CoughTime

Length of cough history in weeks.

Fever

Presence of fever.

FeverTime

Length of fever history in weeks.

Haemoptysis

Presence of haemoptysis.

HaemoptysisTime

Length of haemoptysis history in weeks.

WeightLoss

Presence of weight loss.

WeightLossTime

Length of weight loss history in weeks.

NightSweats

Presence of night sweats.

NightSweatsTime

Length of night sweats history in weeks.

OtherSymptoms1

Presence of first additional symptom.

OtherSymptoms1Details

Type of first additional symptom.

OtherSymptoms1Time

Length of first additional symptom history in weeks.

OtherSymptoms2

Presence of second additional symptom.

OtherSymptoms2Details

Type of second additional symptom.

OtherSymptoms2Time

Length of second additional symptom history in weeks.

DateOfTSTAdministered

Date of TST administration.

DateTSTRead

Date of TST reading.

TSTResult

Measurement of Mantoux induration in transverse diameter.

QuantiferonInTubeResult

Qualitative QFT result.

QFT_TBAg_Nil

Quantitative QFT reading.

SPnDTC

Date of sputum count "n", for n from 1 to 4.

SputumTypen

Whether sputum was induced or taken normally for sputum "n".

CULnRST

Culture positivity result for sputum "n".

DIFnRST

Test indicating if bacterium is Mtb or another Mycobacterium for sputum "n".

SINHn

First test indicating drug resistance for sputum "n".

SRIFn

Second test indicating drug resistance (of a different type to first) for sputum "n".

SubjectPutOnTBRxSinceLastVisit

Whether subject was placed on TB treatment since last visit.

DateTBRx

Date of beginning TB treatment, if begun since last interview.

SubjectHospitilisedSinceLastVisit

Whether subject was hospitalised since last visit.

NewHousholdContactSinceLastVisit

Whether subject had a new household TB contact since last visit.

NewOrWorseningSymptoms

Whether the subject developed new or worse symptoms since last visit.

HouseholdTBContactSinceLastInterview

Whether anyone in subject's household was diagnosed with TB since last interview.

BloodTakenQuantiferon, BloodTakenImmunology, BloodTakenPaxgene

Whether blood was taken for QFT, immunology and Paxgene, respectively.

DateOfQuantiferon

Date on which QFT was performed.

SeverityOfReaction

Severity of reaction to TST test.

ReasonBloodNotTaken

If blood was not taken for QFT, immmunology or Paxgene, why.

ReferredForTBInvestigation

Whether subject was referred for TB investigation at that visit.

ReasonForTBReferral

Reason for subject being referred for TB investigation, if they were.

DateOfReferral

Date of referral for TB investigation.

ReasonNotRead

Reason for TST not being read.

ReasonNoMicroResults

Reason no microbiological tests.

Details

For missing data, a "999" indicates that the element was structurally missing (e.g. there was no cough history length when the participant had no cough). A "998" indicates that the element was accidentally missing (e.g. the participant was seen at that visit, but it is not indicated whether they had a cough.)

Source

The data comes from SATVI.

See Also

TuberculomicsCompendium