Nothing
R/hospitals.R
In hospitals: Portuguese 'NHS' Hospitals
#' Portuguese NHS hospitals
#'
#' A dataset of the Portuguese National Health Service hospitals.
#'
#' The concept of \emph{hospital} here adopted is that of a legal entity
#' providing hospital services. Depending on the organisational structure of the
#' entity, it may be a single hospital unit (H), several hospital units that
#' have been merged into one Hospital Centre (CH), or a merge of hospital units
#' and health centres into the so called \emph{Unidades Locais de Saúde (ULS)};
#' the column \code{hospital_integration} indicates which case is which.
#'
#' @md
#'
#' @format A data frame with `r ncol(hospitals)` variables:
#' \describe{
#' \item{\code{hospital_id}}{A surrogate identifier created by this R package to
#' identify unambiguously each hospital institution.}
#' \item{\code{hospital_acronym}}{The acronym or initialism of the hospital name.}
#' \item{\code{hospital_legal_status}}{Legal entity status: either an administrative public
#' sector (SPA) entity, a corporate public entity (EPE) or a public-private
#' partnership (PPP) entity. The legal status of SPA and EPE entities can be
#' found in
#' \href{https://data.dre.pt/eli/dec-lei/18/2017/02/10/p/dre/pt/html}{Decree-law
#' 18/2017}. For information about the legal status of the PPP entities see
#' \href{https://data.dre.pt/eli/dec-lei/23/2020/05/22/p/dre}{Decree-law
#' 23/2020}. The Portuguese government may also establish contracts with
#' hospitals owned by social enterprises, namely Private Institutions of
#' Social Solidarity (IPSS). In this case, these hospitals become effectively
#' part of the National Health Service. There are three types of contracts
#' that can be established with IPSS which are regulated by the
#' \href{https://data.dre.pt/eli/dec-lei/138/2013/10/09/p/dre/pt/html}{Decree-law
#' 138/2013}: Management Agreement (IPSS-MA), Cooperative Agreement (IPSS-CA)
#' and Convention (IPSS-CN).}
#' \item{\code{hospital_integration}}{The integration level of the hospital
#' institution: a single hospital unit (\code{'H'}); \emph{Centro Hospitalar}
#' (\code{'CH'}), comprising two or more individual Hospital units (a case of
#' \href{https://en.wikipedia.org/wiki/Horizontal_integration}{horizontal
#' integration}); and \emph{Unidade Local de Saúde} (\code{'ULS'}), comprising
#' both Hospital entities and primary care health centres (a case of
#' \href{https://en.wikipedia.org/wiki/Vertical_integration}{vertical
#' integration}).}
#' \item{\code{hospital_group}}{One of the groups defined by
#' \href{https://data.dre.pt/eli/port/82/2014/04/10/p/dre/pt/html}{Ordinance
#' 82/2014}: I, II, III, IV-a, IV-b or IV-c. This classification is based on
#' the hospital catchment area and the scope of medical specialities provided.
#' Broadly speaking, group I includes local hospitals, group II corresponds to
#' regional hospitals, and group III to central hospitals. Group IV
#' corresponds to specialised hospitals: IV-a, oncology institutes; IV-b,
#' physical medicine and rehabilitation hospitals; and IV-c, psychiatry and
#' mental health hospitals.}
#' \item{\code{hospital_short_name}}{An abbreviated version of the hospital name.}
#' \item{\code{hospital_full_name}}{The name of the hospital.}
#' \item{\code{hospital_region_full_name}}{The name of the Portuguese health region.}
#' \item{\code{hospital_region_short_name}}{A shortened version of \code{hospital_region_full_name}.}
#' \item{\code{hospital_vatin}}{VAT identification number (VATIN). In Portuguese, \emph{Número
#' de Identificação de Pessoa Colectiva} (NIPC).}
#' \item{\code{hospital_latitude}}{Latitude of the location of the hospital entity expressed
#' in decimal degrees.}
#' \item{\code{hospital_longitude}}{Longitude of the location of the hospital entity expressed
#' in decimal degrees.}
#' \item{\code{hospital_region_colour}}{Colour associated with the \code{region}. These
#' colours are assigned by this package and are provided as a convenience
#' colour palette for plotting in R.}
#' \item{\code{hospital_bh_group}}{One of the groups defined by the project Benchmarking of
#' Hospitals. Source:
#' \href{https://benchmarking-acss.min-saude.pt/BH_Enquadramento/GrupoInstituicoes}{BH | Grupos
#' e Instituições}.}
#' \item{\code{hospital_bh_group_colour}}{Colour associated with the \code{bh_group}. These
#' colours are assigned by this package and are provided as a convenience
#' colour palette for plotting in R.}
#' \item{\code{hospital_regex}}{A regular expression that can be used to identify hospitals
#' from their names, even when the names are not exactly as in
#' \code{hospital_full_name}.}
#' }
#'
#'
#' @source
#'
#' The set of hospitals included in this dataset was created by manual
#' inspection of the hospital institutions referred in
#' \url{https://www.sns.gov.pt/institucional/entidades-de-saude/}, namely those
#' under the sections: \emph{Serviço Nacional de Saúde---Setor Público
#' Empresarial}, \emph{Serviço Nacional de Saúde---Setor Público
#' Administrativo}, \emph{Hospitais em parceria público-privada (PPP)} and
#' \emph{Hospitais geridos pelas Misericórdias}.
#'
#' Here are the sources per variable (column) in the dataset:
#'
#' \describe{
#' \item{\code{hospital_id}}{Own work.}
#' \item{\code{hospital_acronym}}{Own work.}
#' \item{\code{hospital_legal_status}}{Obtained from
#' \url{https://www.sns.gov.pt/institucional/entidades-de-saude/} as the
#' hospitals were grouped according to its legal status. In the case of the partnerships with IPSS, the information on the precise type of contract was obtained from inspection of the contracts themselves. In all cases they are Cooperative Agreements (IPSS-CA):
#' \describe{
#' \item{Hospital Luciano de Castro, Anadia}{\href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Acordo_Cooperacao_Hospital_Jose_Luciano_Castro_-Anadia1.pdf}{data-raw/source/Acordo_Cooperacao_Hospital_Jose_Luciano_Castro_-Anadia1.pdf}}
#' \item{Hospital São José, Fafe}{\href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Acordo_Coop_Hosp_Sao_Jose_Fafe.pdf}{data-raw/source/Acordo_Coop_Hosp_Sao_Jose_Fafe.pdf}}
#' \item{Hospital de São Paulo, Serpa}{\href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Acordo_Cooperacao_-Hospital_Sao_Paulo_Serpa.pdf}{data-raw/source/Acordo_Cooperacao_-Hospital_Sao_Paulo_Serpa.pdf}}
#' }
#' }
#' \item{\code{hospital_integration}}{The classification in Hospital unit (H), Hospital
#' Centre (CH) or Unidade Local de Saúde (ULS) could be easily inferred from the
#' name of the hospitals. Hospital Centres always start with \emph{Centro
#' Hospitalar} (CH), and ULS hospitals always start with \emph{Unidade Local de
#' Saúde} (ULS). The remaining hospitals are therefore single Hospital (H)
#' units.}
#'
#' \item{\code{hospital_group}}{
#'
#' \describe{
#'
#' \item{Hospitals mentioned in
#' \href{https://data.dre.pt/eli/port/82/2014/04/10/p/dre/pt/html}{Ordinance
#' 82/2014}}{For the majority of the hospitals this grouping was obtained from
#' the ordinance where these are first defined, i.e., the table annexed to
#' Ordinance 82/2014.}
#'
#' \item{Instituto de Oftalmologia Dr. Gama Pinto}{The hospital \emph{Instituto
#' de Oftalmologia Dr. Gama Pinto} was not assigned to any group in the
#' Ordinance 82/2014. But given that this hospital is exclusively specialised in
#' ophthalmology, we have decided to assign it generically to group IV (for
#' specialised hospitals), following the criteria given in Ordinance 82/2014.}
#'
#' \item{Hospital Dr. Francisco Zagalo, Ovar}{The hospital \emph{Hospital Dr.
#' Francisco Zagalo, Ovar} was not assigned to any group in the Ordinance
#' 82/2014. It was included in group I however in a work by Luís Pereira, which we followed, see
#' Table 15 in the Appendix 1, page 71 of
#' \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Pereira.Unpublished.2019.pdf}{data-raw/source/Pereira.Unpublished.2019.pdf}.}
#'
#' \item{Hospital Luciano de Castro, Anadia}{The hospital \emph{Hospital Luciano
#' de Castro, Anadia} was not assigned to any group in the Ordinance 82/2014. It
#' was included in group I however in a work by Luís Pereira, which we followed,
#' see Table 15 in the Appendix 1, page 71 of
#' \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Pereira.Unpublished.2019.pdf}{data-raw/source/Pereira.Unpublished.2019.pdf}.}
#' }
#' }
#'
#' \item{\code{hospital_short_name}}{Own work.}
#'
#' \item{\code{hospital_full_name}}{Obtained from \url{https://www.sns.gov.pt/institucional/entidades-de-saude/}.}
#'
#' \item{\code{hospital_region_full_name}}{Obtained from \href{https://dre.pt/legislacao-consolidada/-/lc/73609575/202009301829/diploma}{Decree-law 11/93}.}
#' \item{\code{hospital_region_short_name}}{Own work.}
#'
#' \item{\code{hospital_vatin}}{From the search engine \url{https://codigopostal.ciberforma.pt/}
#' and from
#' \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Infarmed_lista_hospitais.pdf}{data-raw/source/Infarmed_lista_hospitais.pdf}.}
#'
#' \item{\code{hospital_latitude} and \code{hospital_longitude}}{By searching each hospital in Google Maps and retrieving its coordinates.}
#'
#' \item{\code{hospital_region_colour}}{Own work.}
#'
#' \item{\code{hospital_bh_group}}{
#' The ACSS groups defined in the project \href{https://benchmarking-acss.min-saude.pt/}{Hospitals' Benchmarking} were collected from these sources:
#' \describe{
#' \item{ACSS Hospitals' Benchmarking website}{\href{https://benchmarking-acss.min-saude.pt/BH_Enquadramento/GrupoInstituicoes}{ACSS BH | Grupos
#' e Instituições}}
#' \item{\emph{Relatório de Benchmarking | hospitais EPE e
#' PPP}}{Page 7 of \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Lourenco.TechReport.2013.pdf}{data-raw/source/Lourenco.TechReport.2013.pdf}}
#' \item{\emph{Termos de Referência para contratualização de cuidados desaúde no SNS para 2021}}{Page 25 of \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/ACSS.TechReport.2020.pdf}{data-raw/source/ACSS.TechReport.2020.pdf}}
#' }
#' }
#'
#' \item{\code{hospital_bh_group_colour}}{Own work.}
#'
#' \item{\code{hospital_regex}}{Own work.}
#' }
#'
#' @examples
#' hospitals
#'
"hospitals"
Try the hospitals package in your browser
Any scripts or data that you put into this service are public.
hospitals documentation built on Nov. 26, 2021, 9:06 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
#' Portuguese NHS hospitals
#'
#' A dataset of the Portuguese National Health Service hospitals.
#'
#' The concept of \emph{hospital} here adopted is that of a legal entity
#' providing hospital services. Depending on the organisational structure of the
#' entity, it may be a single hospital unit (H), several hospital units that
#' have been merged into one Hospital Centre (CH), or a merge of hospital units
#' and health centres into the so called \emph{Unidades Locais de Saúde (ULS)};
#' the column \code{hospital_integration} indicates which case is which.
#'
#' @md
#'
#' @format A data frame with `r ncol(hospitals)` variables:
#' \describe{
#' \item{\code{hospital_id}}{A surrogate identifier created by this R package to
#' identify unambiguously each hospital institution.}
#' \item{\code{hospital_acronym}}{The acronym or initialism of the hospital name.}
#' \item{\code{hospital_legal_status}}{Legal entity status: either an administrative public
#' sector (SPA) entity, a corporate public entity (EPE) or a public-private
#' partnership (PPP) entity. The legal status of SPA and EPE entities can be
#' found in
#' \href{https://data.dre.pt/eli/dec-lei/18/2017/02/10/p/dre/pt/html}{Decree-law
#' 18/2017}. For information about the legal status of the PPP entities see
#' \href{https://data.dre.pt/eli/dec-lei/23/2020/05/22/p/dre}{Decree-law
#' 23/2020}. The Portuguese government may also establish contracts with
#' hospitals owned by social enterprises, namely Private Institutions of
#' Social Solidarity (IPSS). In this case, these hospitals become effectively
#' part of the National Health Service. There are three types of contracts
#' that can be established with IPSS which are regulated by the
#' \href{https://data.dre.pt/eli/dec-lei/138/2013/10/09/p/dre/pt/html}{Decree-law
#' 138/2013}: Management Agreement (IPSS-MA), Cooperative Agreement (IPSS-CA)
#' and Convention (IPSS-CN).}
#' \item{\code{hospital_integration}}{The integration level of the hospital
#' institution: a single hospital unit (\code{'H'}); \emph{Centro Hospitalar}
#' (\code{'CH'}), comprising two or more individual Hospital units (a case of
#' \href{https://en.wikipedia.org/wiki/Horizontal_integration}{horizontal
#' integration}); and \emph{Unidade Local de Saúde} (\code{'ULS'}), comprising
#' both Hospital entities and primary care health centres (a case of
#' \href{https://en.wikipedia.org/wiki/Vertical_integration}{vertical
#' integration}).}
#' \item{\code{hospital_group}}{One of the groups defined by
#' \href{https://data.dre.pt/eli/port/82/2014/04/10/p/dre/pt/html}{Ordinance
#' 82/2014}: I, II, III, IV-a, IV-b or IV-c. This classification is based on
#' the hospital catchment area and the scope of medical specialities provided.
#' Broadly speaking, group I includes local hospitals, group II corresponds to
#' regional hospitals, and group III to central hospitals. Group IV
#' corresponds to specialised hospitals: IV-a, oncology institutes; IV-b,
#' physical medicine and rehabilitation hospitals; and IV-c, psychiatry and
#' mental health hospitals.}
#' \item{\code{hospital_short_name}}{An abbreviated version of the hospital name.}
#' \item{\code{hospital_full_name}}{The name of the hospital.}
#' \item{\code{hospital_region_full_name}}{The name of the Portuguese health region.}
#' \item{\code{hospital_region_short_name}}{A shortened version of \code{hospital_region_full_name}.}
#' \item{\code{hospital_vatin}}{VAT identification number (VATIN). In Portuguese, \emph{Número
#' de Identificação de Pessoa Colectiva} (NIPC).}
#' \item{\code{hospital_latitude}}{Latitude of the location of the hospital entity expressed
#' in decimal degrees.}
#' \item{\code{hospital_longitude}}{Longitude of the location of the hospital entity expressed
#' in decimal degrees.}
#' \item{\code{hospital_region_colour}}{Colour associated with the \code{region}. These
#' colours are assigned by this package and are provided as a convenience
#' colour palette for plotting in R.}
#' \item{\code{hospital_bh_group}}{One of the groups defined by the project Benchmarking of
#' Hospitals. Source:
#' \href{https://benchmarking-acss.min-saude.pt/BH_Enquadramento/GrupoInstituicoes}{BH | Grupos
#' e Instituições}.}
#' \item{\code{hospital_bh_group_colour}}{Colour associated with the \code{bh_group}. These
#' colours are assigned by this package and are provided as a convenience
#' colour palette for plotting in R.}
#' \item{\code{hospital_regex}}{A regular expression that can be used to identify hospitals
#' from their names, even when the names are not exactly as in
#' \code{hospital_full_name}.}
#' }
#'
#'
#' @source
#'
#' The set of hospitals included in this dataset was created by manual
#' inspection of the hospital institutions referred in
#' \url{https://www.sns.gov.pt/institucional/entidades-de-saude/}, namely those
#' under the sections: \emph{Serviço Nacional de Saúde---Setor Público
#' Empresarial}, \emph{Serviço Nacional de Saúde---Setor Público
#' Administrativo}, \emph{Hospitais em parceria público-privada (PPP)} and
#' \emph{Hospitais geridos pelas Misericórdias}.
#'
#' Here are the sources per variable (column) in the dataset:
#'
#' \describe{
#' \item{\code{hospital_id}}{Own work.}
#' \item{\code{hospital_acronym}}{Own work.}
#' \item{\code{hospital_legal_status}}{Obtained from
#' \url{https://www.sns.gov.pt/institucional/entidades-de-saude/} as the
#' hospitals were grouped according to its legal status. In the case of the partnerships with IPSS, the information on the precise type of contract was obtained from inspection of the contracts themselves. In all cases they are Cooperative Agreements (IPSS-CA):
#' \describe{
#' \item{Hospital Luciano de Castro, Anadia}{\href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Acordo_Cooperacao_Hospital_Jose_Luciano_Castro_-Anadia1.pdf}{data-raw/source/Acordo_Cooperacao_Hospital_Jose_Luciano_Castro_-Anadia1.pdf}}
#' \item{Hospital São José, Fafe}{\href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Acordo_Coop_Hosp_Sao_Jose_Fafe.pdf}{data-raw/source/Acordo_Coop_Hosp_Sao_Jose_Fafe.pdf}}
#' \item{Hospital de São Paulo, Serpa}{\href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Acordo_Cooperacao_-Hospital_Sao_Paulo_Serpa.pdf}{data-raw/source/Acordo_Cooperacao_-Hospital_Sao_Paulo_Serpa.pdf}}
#' }
#' }
#' \item{\code{hospital_integration}}{The classification in Hospital unit (H), Hospital
#' Centre (CH) or Unidade Local de Saúde (ULS) could be easily inferred from the
#' name of the hospitals. Hospital Centres always start with \emph{Centro
#' Hospitalar} (CH), and ULS hospitals always start with \emph{Unidade Local de
#' Saúde} (ULS). The remaining hospitals are therefore single Hospital (H)
#' units.}
#'
#' \item{\code{hospital_group}}{
#'
#' \describe{
#'
#' \item{Hospitals mentioned in
#' \href{https://data.dre.pt/eli/port/82/2014/04/10/p/dre/pt/html}{Ordinance
#' 82/2014}}{For the majority of the hospitals this grouping was obtained from
#' the ordinance where these are first defined, i.e., the table annexed to
#' Ordinance 82/2014.}
#'
#' \item{Instituto de Oftalmologia Dr. Gama Pinto}{The hospital \emph{Instituto
#' de Oftalmologia Dr. Gama Pinto} was not assigned to any group in the
#' Ordinance 82/2014. But given that this hospital is exclusively specialised in
#' ophthalmology, we have decided to assign it generically to group IV (for
#' specialised hospitals), following the criteria given in Ordinance 82/2014.}
#'
#' \item{Hospital Dr. Francisco Zagalo, Ovar}{The hospital \emph{Hospital Dr.
#' Francisco Zagalo, Ovar} was not assigned to any group in the Ordinance
#' 82/2014. It was included in group I however in a work by Luís Pereira, which we followed, see
#' Table 15 in the Appendix 1, page 71 of
#' \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Pereira.Unpublished.2019.pdf}{data-raw/source/Pereira.Unpublished.2019.pdf}.}
#'
#' \item{Hospital Luciano de Castro, Anadia}{The hospital \emph{Hospital Luciano
#' de Castro, Anadia} was not assigned to any group in the Ordinance 82/2014. It
#' was included in group I however in a work by Luís Pereira, which we followed,
#' see Table 15 in the Appendix 1, page 71 of
#' \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Pereira.Unpublished.2019.pdf}{data-raw/source/Pereira.Unpublished.2019.pdf}.}
#' }
#' }
#'
#' \item{\code{hospital_short_name}}{Own work.}
#'
#' \item{\code{hospital_full_name}}{Obtained from \url{https://www.sns.gov.pt/institucional/entidades-de-saude/}.}
#'
#' \item{\code{hospital_region_full_name}}{Obtained from \href{https://dre.pt/legislacao-consolidada/-/lc/73609575/202009301829/diploma}{Decree-law 11/93}.}
#' \item{\code{hospital_region_short_name}}{Own work.}
#'
#' \item{\code{hospital_vatin}}{From the search engine \url{https://codigopostal.ciberforma.pt/}
#' and from
#' \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Infarmed_lista_hospitais.pdf}{data-raw/source/Infarmed_lista_hospitais.pdf}.}
#'
#' \item{\code{hospital_latitude} and \code{hospital_longitude}}{By searching each hospital in Google Maps and retrieving its coordinates.}
#'
#' \item{\code{hospital_region_colour}}{Own work.}
#'
#' \item{\code{hospital_bh_group}}{
#' The ACSS groups defined in the project \href{https://benchmarking-acss.min-saude.pt/}{Hospitals' Benchmarking} were collected from these sources:
#' \describe{
#' \item{ACSS Hospitals' Benchmarking website}{\href{https://benchmarking-acss.min-saude.pt/BH_Enquadramento/GrupoInstituicoes}{ACSS BH | Grupos
#' e Instituições}}
#' \item{\emph{Relatório de Benchmarking | hospitais EPE e
#' PPP}}{Page 7 of \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/Lourenco.TechReport.2013.pdf}{data-raw/source/Lourenco.TechReport.2013.pdf}}
#' \item{\emph{Termos de Referência para contratualização de cuidados desaúde no SNS para 2021}}{Page 25 of \href{https://github.com/nhs-pt/hospitals/blob/master/data-raw/source/ACSS.TechReport.2020.pdf}{data-raw/source/ACSS.TechReport.2020.pdf}}
#' }
#' }
#'
#' \item{\code{hospital_bh_group_colour}}{Own work.}
#'
#' \item{\code{hospital_regex}}{Own work.}
#' }
#'
#' @examples
#' hospitals
#'
"hospitals"
Try the hospitals package in your browser
Any scripts or data that you put into this service are public.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.