ndi.fun.docTable.subject

 SUBJECT Creates a summary table of subjects and their associated metadata.

    subjectTable = subject(SESSION)

    This function queries an NDI session to find all subject documents. For each
    subject, it then finds and integrates information from associated 'openminds'
    documents related to 'Strain', 'Species', and 'BiologicalSex', as well as
    'treatment' documents.

    The function aggregates properties from these dependent documents, such as
    species name, strain, biological sex, and treatment details. It then
    formats this aggregated information into a single summary table. Each row
    in the output table represents a unique subject, and the columns contain
    the subject's identifiers along with details from its linked documents.
    Metadata from associated documents is joined using 'SubjectDocumentIdentifier'.

    Inputs:
        SESSION - An active and connected ndi.session or ndi.dataset object.

    Outputs:
        subjectTable - A MATLAB table where each row corresponds to a subject.
                       Common columns include 'SubjectDocumentIdentifier',
                       'SubjectLocalIdentifier', 'StrainName', 'SpeciesName',
                       'BiologicalSexOntology', and various fields from 'treatment'
                       documents, depending on the available data.

    See also: ndi.session, ndi.query, table, outerjoin, 
    ndi.fun.docTable.openminds, ndi.fun.docTable.treatment, 
    ndi.fun.table.identifyValidRows