inspectomop.queries.person.patient_counts_by_gender

inspectomop.queries.person.patient_counts_by_gender(inspector, person_ids=None, return_columns=None)

Returns patient counts grouped by gender for the database or alternativily, for a supplied list of person_ids.

Parameters:

  • person_ids (list of int, optional) – list of person_ids [int]. If None (default), get the gender distribution for all individuals in the person table

  • inspector (inspectomop.inspector.Inspector)

  • return_columns (list of str, optional) –

    • optional subset of columns to return from the query

    • columns : [‘gender_concept_id’,’gender’,’count’]

Returns:

results

Return type:

sqlalchemy.sql.expression.Executable

Notes

Original SQL

PE03: Number of patients grouped by gender:

SELECT
    person.GENDER_CONCEPT_ID,
    concept.CONCEPT_NAME AS gender_name,
    COUNT(person.person_ID) AS num_persons_count
FROM
    person
INNER JOIN
    concept ON person.GENDER_CONCEPT_ID = concept.CONCEPT_ID
GROUP BY
    person.GENDER_CONCEPT_ID, concept.CONCEPT_NAME;