{"doi":"10.1136/bmjopen-2022-066671","title":"Cohort profile: the South African National Health Laboratory Service (NHLS) National HIV Cohort","abstract":"PURPOSE: South Africa's National Health Laboratory Service (NHLS) National HIV Cohort was established in 2015 to facilitate monitoring, evaluation and research on South Africa's National HIV Treatment Programme. In South Africa, 84.8% of people living with HIV know their HIV status; 70.7% who know their status are on ART; and 87.4% on ART are virologically suppressed. PARTICIPANTS: The NHLS National HIV Cohort includes the laboratory data of nearly all patients receiving HIV care in the public sector since April 2004. Patients are included in the cohort if they have received a CD4 count or HIV RNA viral load (VL) test. Using an anonymised unique patient identifier that we have developed and validated to linked test results, we observe patients prospectively through their laboratory results as they receive HIV care and treatment. Patients in HIV care are seen for laboratory monitoring every 6-12 months. Data collected include age, sex, facility location and test results for CD4 counts, VLs and laboratory tests used to screen for potential treatment complications. FINDINGS TO DATE: From April 2004 to April 2018, 63 million CD4 count and VL tests were conducted at 5483 facilities. 12.6 million unique patients had at least one CD4 count or VL, indicating they had accessed HIV care, and 7.1 million patients had a VL test indicating they had started antiretroviral therapy. The creation of NHLS National HIV Cohort has enabled longitudinal research on all lab-monitored patients in South Africa's national HIV programme, including analyses of (1) patient health at presentation; (2) care outcomes such as 'CD4 recovery', 'retention in care' and 'viral resuppression'; (3) patterns of transfer and re-entry into care; (4) facility-level variation in care outcomes; and (5) impacts of policies and guideline changes. FUTURE PLANS: Continuous updating of the cohort, integration with available clinical data, and expansion to include tuberculosis and other lab-monitored comorbidities.","journal":"BMJ Open","year":2022,"id":252142,"datarank":0.7389113108592205,"base_score":3.2188758248682006,"endowment":3.2188758248682006,"self_citation_contribution":0.48283137373023016,"citation_network_contribution":0.2560799371289903,"self_endowment_contribution":0.48283137373023016,"citer_contribution":0.2560799371289903,"corpus_percentile":72.77017096000618,"corpus_rank":3521,"citation_count":24,"citer_count":10,"citers_with_citation_signal":6,"citers_with_endowment":6,"datacite_reuse_total":0,"is_dataset":true,"is_dataset_confidence":0.9293,"is_data_producer":false,"deposit_databanks":null,"is_oa":true,"file_count":0,"downloads":0,"has_version_chain":false,"published_date":"2022-01-01","fair_score":22.9167,"fair_percentile":40.53806175481504,"algorithm_id":"datarank_citation_only_1hop_v6","ranking_scope":"data_only","authors":[{"id":231224,"name":"Jacob Bor","orcid":"0000-0002-5112-8536","position":1,"is_corresponding":false},{"id":896609,"name":"Sue Candy","orcid":null,"position":2,"is_corresponding":false},{"id":363993,"name":"Mhairi Maskew","orcid":"0000-0003-4238-0200","position":3,"is_corresponding":false},{"id":87357,"name":"Matthew P. Fox","orcid":"0000-0001-9887-0634","position":4,"is_corresponding":false},{"id":377731,"name":"Katia Bulekova","orcid":null,"position":5,"is_corresponding":false},{"id":426664,"name":"Alana T. Brennan","orcid":"0000-0002-7746-0668","position":6,"is_corresponding":false},{"id":896108,"name":"James J. Potter","orcid":"0000-0003-3073-6361","position":7,"is_corresponding":false},{"id":363991,"name":"Cornelius Nattey","orcid":"0000-0002-8272-9529","position":8,"is_corresponding":false},{"id":706366,"name":"Dorina Onoya","orcid":"0000-0002-2664-7342","position":9,"is_corresponding":false},{"id":426666,"name":"Koleka Mlisana","orcid":"0000-0002-8436-3268","position":10,"is_corresponding":false},{"id":592033,"name":"Wendy Stevens","orcid":"0000-0002-1684-908X","position":11,"is_corresponding":false},{"id":426665,"name":"Sergio Carmona","orcid":"0000-0002-6792-4748","position":12,"is_corresponding":false},{"id":377116,"name":"William MacLeod","orcid":"0000-0001-8003-8874","position":0,"is_corresponding":true}],"reference_count":32,"raw_metadata":null,"created_at":"2026-07-19T00:24:46.226372Z","pmid":"36261238","pmcid":"PMC9582381","fwci":null,"citation_percentile":null,"influential_citations":0,"oa_status":null,"license":null,"views":0,"total_file_size_bytes":0,"version_count":0,"fair_f":44.4444,"fair_a":50.0,"fair_i":0.0,"fair_r":29.1667,"fair_zscore":-0.4565,"fair_rationale":{"fair_score":22.92,"has_llm":true,"taxonomy_version":"fair_taxonomy_v5","dimensions":{"F":{"name":"Findable","score":44.44,"criteria":[{"key":"f_dataset_pid","label":"Persistent identifier for the data","kind":"llm","weight":2.0,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"The paper does not provide any persistent identifier (DOI, Handle, ARK, or repository accession) for the dataset. [majority verdict 'no' (3/5 passes agreed)]","anchors":["RDA-F1-01D — FAIR Data Maturity Model: 'Data is identified by a persistent identifier' (priorit","RDA-F1-02D — FAIR Data Maturity Model: 'Data is identified by a globally unique identifier'","FsF-F1-02D — F-UJI/FAIRsFAIR: 'Data is assigned a persistent identifier'"],"scored":true,"signal":null},{"key":"f_repository_named","label":"Named repository","kind":"llm","weight":2.0,"fraction":0.5,"verdict":"partial","evidence":"Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za )","grounded":true,"rationale":"The data holder is the National Health Laboratory Service, a non-repository host. [majority verdict 'partial' (4/5 passes agreed)]","anchors":["RDA-F4-01M — FAIR Data Maturity Model: metadata is offered so it can be harvested and indexed (","NIH DMS Policy Element 4 (NOT-OD-21-014) — name the repository where data will be archived","NSTC Desirable Characteristics of Data Repositories (2022) — 'Long-Term Sustainability', 'Reten"],"scored":true,"signal":null},{"key":"f_data_availability_statement","label":"Data-availability statement","kind":"llm","weight":2.0,"fraction":0.5,"verdict":"partial","evidence":"Data may be obtained from a third party and are not publicly available. Access to primary data is subject to restrictions owing to privacy and ethics policies set by the South African Government. Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za ) and require a full protocol submission.","grounded":true,"rationale":"The data-availability statement points to a third party (NHLS) with a request process, not a repository record.","anchors":["Colavizza, Hrynaszkiewicz, Staden, Whitaker & McGillivray (2020), 'The citation advantage of li","Springer Nature research data policy — Data Availability Statements: standard statement templat","RDA-F3-01M — metadata clearly and explicitly includes the identifier of the data it describes"],"scored":false,"signal":null},{"key":"f_discovery_metadata","label":"Description of the dataset as an object","kind":"llm","weight":2.0,"fraction":1.0,"verdict":"yes","evidence":"Table 4 Variables in the NHLS National HIV Cohort Variable Description Per cent completeness of variable (%)","grounded":true,"rationale":"The paper includes an itemised inventory of the dataset's variables in a table (Table 4), which is a structured description.","anchors":["RDA-F2-01M — 'Rich metadata is provided to allow discovery' (priority Essential)","FsF-F2-01M — F-UJI: 'Metadata includes descriptive core elements to support data findability'","FsF-R1-01MD — F-UJI: 'Metadata specifies the content of the data'"],"scored":false,"signal":null},{"key":"f_dataset_cited","label":"Dataset formally cited","kind":"llm","weight":1.0,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"No identifier for the dataset appears anywhere in the reference list or body text. [majority verdict 'no' (3/5 passes agreed)]","anchors":["FORCE11 Joint Declaration of Data Citation Principles (2014) — data should be cited as a first-","RDA-F3-01M — metadata clearly and explicitly includes the identifier of the data it describes","FsF-F3-01M — F-UJI: 'Metadata includes the identifier of the data it describes'"],"scored":true,"signal":null}]},"A":{"name":"Accessible","score":50.0,"criteria":[{"key":"a_data_openly_accessible","label":"Access route free of preconditions","kind":"llm","weight":2.0,"fraction":0.5,"verdict":"partial","evidence":"Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za ) and require a full protocol submission.","grounded":true,"rationale":"The access route carries a stated precondition (a full protocol submission), which is a specified, followable process.","anchors":["RDA-A1.1-01D — 'Data is accessible through a free access protocol'","FsF-A1-01M — F-UJI: 'Metadata contains access level and access conditions of the data'","NSTC Desirable Characteristics of Data Repositories (2022) — 'Free and Easy Access'"],"scored":true,"signal":null},{"key":"a_access_conditions_stated","label":"Access level labelled","kind":"llm","weight":1.0,"fraction":0.5,"verdict":"partial","evidence":"Data may be obtained from a third party and are not publicly available.","grounded":true,"rationale":"The paper states the data are not publicly available but does not apply a standard access-level label; the access level must be inferred from the description. [majority verdict 'partial' (3/5 passes agreed)]","anchors":["FsF-A1-01M — F-UJI: 'Metadata contains access level and access conditions of the data'","RDA-A1-01M — metadata contains information to enable the user to get access to the data","COAR Controlled Vocabularies — Access Rights v1.0 (open / embargoed / restricted / metadata-onl"],"scored":false,"signal":null},{"key":"a_controlled_access_for_sensitive","label":"Gatekeeper for sensitive data","kind":"llm","weight":0.5,"fraction":1.0,"verdict":"yes","evidence":"Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za ) and require a full protocol submission.","grounded":true,"rationale":"The paper names the National Health Laboratory Service (NHLS) as the institutional gatekeeper that requires a full protocol submission, which is a formal application process.","anchors":["NIH Genomic Data Sharing Policy (NOT-OD-14-124) — controlled-access via a Data Access Committee","RDA-A1.2-01D — 'Data is accessible through an access protocol that supports authentication and ","NIH DMS Policy Element 5 (NOT-OD-21-014) — Access, Distribution, or Reuse Considerations (conse"],"scored":false,"signal":null},{"key":"a_timeline_retention","label":"Availability timing & retention","kind":"llm","weight":0.5,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"The paper does not state any timeline for availability or persistence of the data.","anchors":["NIH DMS Plan Element 4 (NOT-OD-21-014) — Data Preservation, Access, and Associated Timelines","NSTC Desirable Characteristics (2022), Organizational Infrastructure: 'Retention Policy'","RDA-A2-01M — 'Metadata is guaranteed to remain available after data is no longer available'"],"scored":false,"signal":null}]},"I":{"name":"Interoperable","score":0.0,"criteria":[{"key":"i_open_nonproprietary_format","label":"Open file format","kind":"llm","weight":1.0,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"No file format is named for the released data.","anchors":["FsF-R1.3-02D — F-UJI: 'Data is available in a file format recommended by the target research co","RDA-R1.3-02D — data is expressed in a machine-understandable community standard","RDA-I1-01D — data uses a knowledge representation expressed in a standardised format"],"scored":true,"signal":null},{"key":"i_community_standard_vocabulary","label":"Community standard / vocabulary","kind":"llm","weight":1.0,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"No data or metadata community standard is named in the paper.","anchors":["RDA-R1.3-01M — 'Metadata complies with a community standard' (priority Essential)","RDA-R1.3-01D — 'Data complies with a community standard'","RDA-I2-01M — '(Meta)data use vocabularies that follow FAIR principles'"],"scored":false,"signal":null},{"key":"i_qualified_references","label":"Identifiers for the resources the data depend on","kind":"llm","weight":0.5,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"The paper does not provide an identifier for any external resource that the data depend on or derive from.","anchors":["RDA-I3-01M — '(meta)data include references to other (meta)data'","RDA-I3-03M — 'metadata includes qualified references to other metadata'","FsF-I3-01M — F-UJI: 'Metadata includes links between the data and its related entities'"],"scored":false,"signal":null}]},"R":{"name":"Reusable","score":29.17,"criteria":[{"key":"r_reuse_license","label":"Reuse licence","kind":"llm","weight":2.0,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"No licence or terms document is named for the data; the article's CC BY-NC licence applies to the paper, not the data.","anchors":["RDA-R1.1-01M — 'Metadata includes information about the licence under which the data can be reu","RDA-R1.1-02M — 'Metadata refers to a standard reuse licence'","RDA-R1.1-03M — 'Metadata refers to a machine-understandable reuse licence'"],"scored":true,"signal":null},{"key":"r_provenance_methods","label":"Provenance of the data","kind":"llm","weight":1.0,"fraction":0.5,"verdict":"partial","evidence":"Specimens for testing are collected from patients at their care facility and sent to 1 of 16 laboratories for processing and testing.","grounded":true,"rationale":"The paper describes data collection in generic terms without naming specific instruments, kits, or software versions. [majority verdict 'partial' (4/5 passes agreed)]","anchors":["RDA-R1.2-01M — 'Metadata includes provenance information according to community- specific standa","FsF-R1.2-01M — F-UJI: 'Metadata includes provenance information about data creation or generati","W3C PROV-O (W3C Recommendation, 2013) — the entity/activity/agent model of provenance"],"scored":false,"signal":null},{"key":"r_documentation_codebook","label":"Documentation / codebook","kind":"llm","weight":1.0,"fraction":0.5,"verdict":"partial","evidence":"Table 4 Variables in the NHLS National HIV Cohort Variable Description Per cent completeness of variable (%)","grounded":true,"rationale":"Variable definitions are provided in a table inside the article, not in a separate documentation object shipped with the data.","anchors":["RDA-R1-01M — '(Meta)data are richly described with a plurality of accurate and relevant attribu","FsF-R1-01MD — F-UJI: 'Metadata specifies the content of the data'","NIH DMS Policy Element 3 (NOT-OD-21-014) — Standards (documentation and metadata to accompany t"],"scored":false,"signal":null},{"key":"r_versioning","label":"Snapshot identified","kind":"llm","weight":0.5,"fraction":0.5,"verdict":"partial","evidence":"From April 2004 to April 2018, 63 million CD4 count and VL tests were conducted at 5483 facilities.","grounded":true,"rationale":"The snapshot is identified by a date range (the period of data collection), not a version token. [majority verdict 'partial' (3/5 passes agreed)]","anchors":["DataCite Metadata Schema 4.6 — the 'Version' property","RDA-R1.2-01M — provenance information (which version was used is provenance)","NSTC Desirable Characteristics of Data Repositories (2022) — 'Provenance', 'Retention Policy'"],"scored":true,"signal":null},{"key":"x_code_availability","label":"Analysis code available","kind":"llm","weight":1.0,"fraction":0.0,"verdict":"no","evidence":null,"grounded":false,"rationale":"The paper does not mention any code availability for the study's own code.","anchors":["NIH DMS Policy Element 2 (NOT-OD-21-014) — 'Related Tools, Software and/or Code'","FAIR4RS Principles v1.0 (Chue Hong et al., 2022; RDA/FORCE11/ReSA) — FAIR Principles for Resear","FORCE11 Software Citation Principles (Smith, Katz & Niemeyer, 2016, PeerJ CS 2:e86)"],"scored":true,"signal":null},{"key":"x_funding_attribution","label":"Funder and award number","kind":"llm","weight":0.5,"fraction":1.0,"verdict":"yes","evidence":"This work was supported by grants R01AI115979, R01AI152149, K01MH105320, K01DK116929-01 and R01HD084233 from the National Institutes of Health.","grounded":true,"rationale":"The paper provides specific award/grant numbers from the National Institutes of Health.","anchors":["DataCite Metadata Schema 4.6 — 'FundingReference' property (funderName, funderIdentifier, award","Crossref Funder Registry — canonical funder identifiers for funding metadata","RDA-F2-01M — rich metadata provided to allow discovery (funding is part of the descriptive reco"],"scored":true,"signal":null}]}},"actions":[{"key":"f_dataset_pid","dimension":"F","label":"Persistent identifier for the data","action":"Mint or cite a persistent identifier for the dataset — a repository DOI or an accession from a registered repository — and print it in the paper. A bare URL is not persistent: it is the single most common cause of a dead data link five years after publication. For clinical / human-subjects data, deposit in dbGaP or the European Genome-phenome Archive (EGA).","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"The paper does not provide any persistent identifier (DOI, Handle, ARK, or repository accession) for the dataset. [majority verdict 'no' (3/5 passes agreed)]","gain":16.67,"priority":"essential","scored":true},{"key":"r_reuse_license","dimension":"R","label":"Reuse licence","action":"Attach a standard, machine-readable open licence to the deposit — CC0 or CC BY, which is what Horizon Europe and most funders expect — and print the licence identifier in the paper. 'Free to use' is not a licence: it grants nothing a reuser's institution can rely on.","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"No licence or terms document is named for the data; the article's CC BY-NC licence applies to the paper, not the data.","gain":16.67,"priority":"essential","scored":true},{"key":"f_repository_named","dimension":"F","label":"Named repository","action":"Deposit the data in a repository registered in re3data/FAIRsharing (a domain repository such as GEO, SRA, dbGaP, PRIDE, or a generalist such as Zenodo, Dryad, Dataverse) and name it explicitly in the paper. A lab website is not an archive: it has no retention commitment and no accession. For clinical / human-subjects data, deposit in dbGaP or the European Genome-phenome Archive (EGA).","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za )","why":"The data holder is the National Health Laboratory Service, a non-repository host. [majority verdict 'partial' (4/5 passes agreed)]","gain":8.33,"priority":"essential","scored":true},{"key":"a_data_openly_accessible","dimension":"A","label":"Access route free of preconditions","action":"Remove the precondition or justify it. Release the data at publication with no embargo, no registration wall, and no approval step — NIH's zero-embargo public- access rule (NOT-OD-25-101) has already made 'available at publication' the federal baseline for the article; the data should not lag behind it. For clinical / human-subjects data, deposit in dbGaP or the European Genome-phenome Archive (EGA).","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za ) and require a full protocol submission.","why":"The access route carries a stated precondition (a full protocol submission), which is a specified, followable process.","gain":8.33,"priority":"essential","scored":true},{"key":"f_dataset_cited","dimension":"F","label":"Dataset formally cited","action":"Cite the dataset in the reference list like a publication — creator, year, title, repository, DOI/accession — and cite it in-text where it is used. Only a reference- list entry is machine-readable to Crossref/DataCite, and only a citation lets the data earn credit. Cite the clinical / human-subjects repository accession (e.g. from dbGaP or the European Genome-phenome Archive (EGA)) in the reference list.","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"No identifier for the dataset appears anywhere in the reference list or body text. [majority verdict 'no' (3/5 passes agreed)]","gain":8.33,"priority":"important","scored":true},{"key":"i_open_nonproprietary_format","dimension":"I","label":"Open file format","action":"Release the data in an open, community-standard format (CSV/TSV, JSON, HDF5, NetCDF, FASTQ, VCF, NIfTI…) instead of — or alongside — any proprietary or instrument-native format, and name the format in the paper. A dataset that needs a €2,000 licence to open is not reusable.","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"No file format is named for the released data.","gain":8.33,"priority":"important","scored":true},{"key":"x_code_availability","dimension":"R","label":"Analysis code available","action":"Publish the analysis code in a public forge, archive a tagged release with a DOI (Zenodo/Software Heritage), and cite that DOI in the paper. NIH DMS Element 2 asks for the tools and code, not only the data — and 'available on request' is not a locator. Archive the analysis code in a versioned repository (GitHub + a Zenodo release DOI).","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"The paper does not mention any code availability for the study's own code.","gain":8.33,"priority":"important","scored":true},{"key":"r_versioning","dimension":"R","label":"Snapshot identified","action":"Version the deposit and cite the exact version analysed (a version-specific DOI, or an accession with its version suffix). A reader reproducing your work against 'the current release' is reproducing it against a different dataset.","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"From April 2004 to April 2018, 63 million CD4 count and VL tests were conducted at 5483 facilities.","why":"The snapshot is identified by a date range (the period of data collection), not a version token. [majority verdict 'partial' (3/5 passes agreed)]","gain":2.08,"priority":"useful","scored":true},{"key":"f_data_availability_statement","dimension":"F","label":"Data-availability statement","action":"Replace the statement with the repository template: name the repository and give the accession or DOI (Colavizza category 3). This is the only DAS class associated with a measured citation advantage; 'available on reasonable request' and 'within the article' are not.","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"Data may be obtained from a third party and are not publicly available. Access to primary data is subject to restrictions owing to privacy and ethics policies set by the South African Government. Requests for access to the data can be made to the National Health Laboratory Service (NHLS) directly ( http://www.aarms.nhls.ac.za ) and require a full protocol submission.","why":"The data-availability statement points to a third party (NHLS) with a request process, not a repository record.","gain":0.0,"priority":"essential","scored":false},{"key":"a_access_conditions_stated","dimension":"A","label":"Access level labelled","action":"State the access level in words, using the standard vocabulary: 'These data are open access' / 'These data are controlled access'. A reader — and a harvester — should not have to infer the access level from the presence of a download link.","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"Data may be obtained from a third party and are not publicly available.","why":"The paper states the data are not publicly available but does not apply a standard access-level label; the access level must be inferred from the description. [majority verdict 'partial' (3/5 passes agreed)]","gain":0.0,"priority":"important","scored":false},{"key":"i_community_standard_vocabulary","dimension":"I","label":"Community standard / vocabulary","action":"Adopt and NAME your domain's data standard — the minimum-information checklist, metadata schema, or ontology your community uses (MIAME/MINSEQE, ISA-Tab, BIDS, an OBO ontology, HL7 FHIR/OMOP) — and say which one you followed. A reporting checklist standardises your paper; it does nothing for your data. In clinical / human-subjects, describe the data with OMOP CDM, CDISC SDTM or HL7 FHIR.","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"No data or metadata community standard is named in the paper.","gain":0.0,"priority":"important","scored":false},{"key":"r_provenance_methods","dimension":"R","label":"Provenance of the data","action":"Name the instruments, kits, and software — with versions — that produced the data, not just the verbs. 'Reads were aligned' is not provenance; 'aligned with STAR v2.7.9a to GRCh38' is, because someone else can rerun it.","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"Specimens for testing are collected from patients at their care facility and sent to 1 of 16 laboratories for processing and testing.","why":"The paper describes data collection in generic terms without naming specific instruments, kits, or software versions. [majority verdict 'partial' (4/5 passes agreed)]","gain":0.0,"priority":"important","scored":false},{"key":"r_documentation_codebook","dimension":"R","label":"Documentation / codebook","action":"Ship a README and a data dictionary IN the deposit — every file, every variable, its units, its allowed values, its missing-value codes. It is the cheapest single thing that makes a dataset usable by someone who was not in the lab, and a table buried in the article does not travel with the data.","anchors":["yes","partial","no"],"verdict":"partial","current":0.5,"evidence":"Table 4 Variables in the NHLS National HIV Cohort Variable Description Per cent completeness of variable (%)","why":"Variable definitions are provided in a table inside the article, not in a separate documentation object shipped with the data.","gain":0.0,"priority":"important","scored":false},{"key":"i_qualified_references","dimension":"I","label":"Identifiers for the resources the data depend on","action":"Cite by identifier every resource the data depend on — the source datasets' accessions, the reference build (GRCh38 / GCA_000001405.28), the cohort application number, the code DOI — and register those relations on the dataset record (IsDerivedFrom, IsSupplementTo). A name is not a link: it cannot be resolved, versioned, or followed by a machine.","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"The paper does not provide an identifier for any external resource that the data depend on or derive from.","gain":0.0,"priority":"useful","scored":false},{"key":"a_timeline_retention","dimension":"A","label":"Availability timing & retention","action":"State when the data become available AND how long they will be retained — cite the repository's preservation policy. NIH DMS Element 4 asks for both; most papers give neither.","anchors":["yes","partial","no"],"verdict":"no","current":0.0,"evidence":null,"why":"The paper does not state any timeline for availability or persistence of the data.","gain":0.0,"priority":"useful","scored":false}],"suggestions":["Mint or cite a persistent identifier for the dataset — a repository DOI or an accession from a registered repository — and print it in the paper. A bare URL is not persistent: it is the single most common cause of a dead data link five years after publication. For clinical / human-subjects data, deposit in dbGaP or the European Genome-phenome Archive (EGA).","Attach a standard, machine-readable open licence to the deposit — CC0 or CC BY, which is what Horizon Europe and most funders expect — and print the licence identifier in the paper. 'Free to use' is not a licence: it grants nothing a reuser's institution can rely on.","Deposit the data in a repository registered in re3data/FAIRsharing (a domain repository such as GEO, SRA, dbGaP, PRIDE, or a generalist such as Zenodo, Dryad, Dataverse) and name it explicitly in the paper. A lab website is not an archive: it has no retention commitment and no accession. For clinical / human-subjects data, deposit in dbGaP or the European Genome-phenome Archive (EGA).","Remove the precondition or justify it. Release the data at publication with no embargo, no registration wall, and no approval step — NIH's zero-embargo public- access rule (NOT-OD-25-101) has already made 'available at publication' the federal baseline for the article; the data should not lag behind it. For clinical / human-subjects data, deposit in dbGaP or the European Genome-phenome Archive (EGA).","Cite the dataset in the reference list like a publication — creator, year, title, repository, DOI/accession — and cite it in-text where it is used. Only a reference- list entry is machine-readable to Crossref/DataCite, and only a citation lets the data earn credit. Cite the clinical / human-subjects repository accession (e.g. from dbGaP or the European Genome-phenome Archive (EGA)) in the reference list."],"model":"deepseek/deepseek-v4-flash","agent_version":"fair_agent_v8","fulltext_source":"epmc_xml"},"fair_model":"deepseek/deepseek-v4-flash","fair_agent_version":"fair_agent_v8","fair_fulltext_source":"epmc_xml","fair_has_llm":true,"fair_computed_at":"2026-07-20T11:46:18.396564Z","clinical_trials":[],"software_tools":[],"db_accessions":[],"linked_datasets":[],"topics":[]}