Skip to contents

Query consultas clínicas HIV

Source: R/calc_consults.R
calc_consults.Rd

calc_consults() devolve uma listagem das consultas clínicas do HIV realizadas por um grupo de clientes definido pelo utilizador (activos em TARV ou todos clientes)

Usage

calc_consults(
  con,
  client_status = "All",
  defaulter_tolerance = 28,
  opendate = NULL,
  enddate = Sys.Date(),
  filter_by_location = TRUE,
  location_uuid = "e5f01eee-2392-49b4-a5bf-5cf593fc8f21"
)

Arguments

con

Ligação à base de dados MozART 2.0

client_status

Estado do cliente em TARV

  • "All", por defeito, devolve todos clientes tendo realizado consultas clínicas

  • "Active", devolve apenas os clientes activos em TARV

defaulter_tolerance

Número de dias de tolerância antes dos faltosos serem considerados inactivos (abandonos)

  • "28" por defeito

opendate

Data da abertura do período (introduzir como “AAAA-MM-DD”)

enddate

Data do fecho do período usado para avialar o estado activo do client

  • "Sys.Date" Por defeito

  • Data customizada em formato (introduzir como “AAAA-MM-DD”)

  • Número customizado (por exemplo "59" na definição de MISAU)

filter_by_location

Se TRUE, o query corre sobre uma unidade sanitária específica. Se FALSE, o query corre sobre todas as unidade sanitária contidas no MozART 2.0

location_uuid

location_uuid da unidade sanitária a filtrar quando filter_by_location é definido como TRUE

Value

Um quadro de dados contendo uma listagem das consultas clínicas HIV realizadas

Examples

if (FALSE) { # \dontrun{
 # Caso de uso simples executado sobre todas US
 df <- calc_consults(con)

 # Caso de uso de activos, tolerância 59 dias, executado sobre uma US
 df <- calc_consults(
          con,
          enddate = '2024-09-20',
          client_status = "Active",
          defaulter_tolerance = 59,
          filter_by_location = TRUE,
          location_uuid = 'e3eb1a1b-be07-4af2-9360-5d7046910576')

 # Caso de uso de activos, limitando as consultas a 2022 para frente
 df <- calc_consults(
          con,
          client_status = "Active",
          enddate = '2024-09-20',
          opendate = '2022-01-10',
          filter_by_location = FALSE)} # }