citHeader(
  "countryatlas is a join layer over other people's data. Citing the package",
  "alone under-credits the sources it reconciles, so please cite the package",
  "and whichever of the data sources your analysis actually used."
)

bibentry(
  bibtype  = "Manual",
  title    = "{countryatlas}: Join World Bank Data, Country Codes and Maps on the ISO Spine",
  author   = person("Youzhi", "Yu"),
  # Not `meta$Date %||% ...`: `%||%` only entered base R in 4.4.0 and this
  # file is evaluated by readCitationFile() outside the package namespace,
  # so NAMESPACE's importFrom(rlang, "%||%") does not reach it -- on the
  # R (>= 4.1.0) that DESCRIPTION declares, citation() would error. The
  # release year is fixed rather than taken from Sys.Date(), which would
  # otherwise drift to whenever the user happens to call citation().
  year     = "2026",
  note     = paste("R package version", meta$Version),
  url      = "https://pursuitofdatascience.github.io/countryatlas/",
  header   = "To cite the package:"
)

bibentry(
  bibtype  = "Article",
  title    = "countrycode: An {R} package to convert country names and country codes",
  author   = c(person("Vincent", "Arel-Bundock"),
               person("Nils", "Enevoldsen"),
               person("CJ", "Yetman")),
  journal  = "Journal of Open Source Software",
  volume   = "3",
  number   = "28",
  pages    = "848",
  year     = "2018",
  doi      = "10.21105/joss.00848",
  header   = "Country-name reconciliation rests on countrycode:"
)

bibentry(
  bibtype      = "Manual",
  title        = "World Development Indicators",
  author       = person("World Bank"),
  organization = "The World Bank",
  year         = "2024",
  url          = "https://datatopics.worldbank.org/world-development-indicators/",
  header       = "Indicators fetched with world_data() / country_data() come from the World Bank:"
)

bibentry(
  bibtype      = "Manual",
  title        = "Natural Earth: Free vector and raster map data",
  author       = person("Natural Earth"),
  organization = "Natural Earth",
  year         = "2024",
  url          = "https://www.naturalearthdata.com/",
  header       = "Both geometry backends draw Natural Earth (public domain); the bundled polygons are its 1:50m admin-0 countries, version 5.1.1:"
)

bibentry(
  bibtype = "Article",
  title   = "The Equal Earth map projection",
  author  = c(person("Bojan", "Savric"), person("Tom", "Patterson"),
              person("Bernhard", "Jenny")),
  journal = "International Journal of Geographical Information Science",
  volume  = "33",
  number  = "3",
  pages   = "454--465",
  year    = "2019",
  doi     = "10.1080/13658816.2018.1504949",
  header  = "The default projection is Equal Earth:"
)

bibentry(
  bibtype = "Article",
  title   = "Evaluation of methods for classifying epidemiological data on choropleth maps in series",
  author  = c(person("Cynthia A.", "Brewer"), person("Linda", "Pickle")),
  journal = "Annals of the Association of American Geographers",
  volume  = "92",
  number  = "4",
  pages   = "662--681",
  year    = "2002",
  doi     = "10.1111/1467-8306.00310",
  header  = "The classification guidance in world_map() / classify_compare() follows:"
)

bibentry(
  bibtype = "Article",
  title   = "Value-by-alpha maps: an alternative technique to the cartogram",
  author  = c(person("Robert E.", "Roth"), person("Andrew W.", "Woodruff"),
              person("Zachary F.", "Johnson")),
  journal = "The Cartographic Journal",
  volume  = "47",
  number  = "2",
  pages   = "130--140",
  year    = "2010",
  doi     = "10.1179/000870409X12488753453372",
  header  = "value_by_alpha_map() implements:"
)

bibentry(
  bibtype = "Article",
  title   = "Notes on continuous stochastic phenomena",
  author  = person("P. A. P.", "Moran"),
  journal = "Biometrika",
  volume  = "37",
  number  = "1/2",
  pages   = "17--23",
  year    = "1950",
  doi     = "10.2307/2332142",
  header  = "morans_i() implements:"
)

bibentry(
  bibtype      = "Manual",
  title        = "World Bank Country and Lending Groups; Historical classification by income",
  author       = person("World Bank"),
  organization = "The World Bank",
  year         = "2026",
  note         = "CLASS and OGHIST files; licence CC BY 4.0",
  url          = "https://datahelpdesk.worldbank.org/knowledgebase/articles/906519",
  header       = "classify_countries() and country_classifications use the World Bank's dated classifications:"
)

bibentry(
  bibtype = "Article",
  title   = "A revised list of independent states since the congress of Vienna",
  author  = c(person("Kristian S.", "Gleditsch"), person("Michael D.", "Ward")),
  journal = "International Interactions",
  volume  = "25",
  number  = "4",
  pages   = "393--413",
  year    = "1999",
  doi     = "10.1080/03050629908434958",
  header  = "audit_time_coverage() dates independence with:"
)

bibentry(
  bibtype = "Article",
  title   = "Mapping the international system, 1886-2019: the CShapes 2.0 dataset",
  author  = c(person("Guy", "Schvitz"), person("Seraina", "R\u00fcegger"),
              person("Luc", "Girardin"), person("Lars-Erik", "Cederman"),
              person("Nils", "Weidmann"), person("Kristian Skrede", "Gleditsch")),
  journal = "Journal of Conflict Resolution",
  volume  = "66",
  number  = "1",
  pages   = "144--161",
  year    = "2022",
  doi     = "10.1177/00220027211013563",
  header  = "historical_geometry() draws CShapes 2.0:"
)

bibentry(
  bibtype   = "InProceedings",
  title     = "Value-suppressing uncertainty palettes",
  author    = c(person("Michael", "Correll"), person("Dominik", "Moritz"),
                person("Jeffrey", "Heer")),
  booktitle = "Proceedings of the 2018 CHI Conference on Human Factors in Computing Systems",
  pages     = "1--11",
  year      = "2018",
  doi       = "10.1145/3173574.3174216",
  header    = "world_map(uncertainty = ) draws a value-suppressing palette:"
)

bibentry(
  bibtype = "Article",
  title   = "Local indicators of spatial association -- LISA",
  author  = person("Luc", "Anselin"),
  journal = "Geographical Analysis",
  volume  = "27",
  number  = "2",
  pages   = "93--115",
  year    = "1995",
  doi     = "10.1111/j.1538-4632.1995.tb00338.x",
  header  = "local_morans() and lisa_map() implement:"
)

bibentry(
  bibtype = "Article",
  title   = "Controlling the false discovery rate: a new application to account for multiple and dependent tests in local statistics of spatial association",
  author  = c(person("Marcia", "Caldas de Castro"), person("Burton H.", "Singer")),
  journal = "Geographical Analysis",
  volume  = "38",
  number  = "2",
  pages   = "180--208",
  year    = "2006",
  doi     = "10.1111/j.0016-7363.2006.00682.x",
  header  = "Their false-discovery-rate control follows:"
)

bibentry(
  bibtype = "Article",
  title   = "A new proposal to adjust Moran's I for population density",
  author  = c(person("Renato M.", "Assuncao"), person("Edna A.", "Reis")),
  journal = "Statistics in Medicine",
  volume  = "18",
  number  = "16",
  pages   = "2147--2162",
  year    = "1999",
  doi     = "10.1002/(SICI)1097-0258(19990830)18:16<2147::AID-SIM179>3.0.CO;2-I",
  header  = "eb_morans_i() implements:"
)

bibentry(
  bibtype = "Article",
  title   = "Mapping disease and mortality rates using empirical Bayes estimators",
  author  = person("R. J.", "Marshall"),
  journal = "Journal of the Royal Statistical Society, Series C",
  volume  = "40",
  number  = "2",
  pages   = "283--294",
  year    = "1991",
  doi     = "10.2307/2347593",
  header  = "smooth_rates() implements:"
)

bibentry(
  bibtype = "Article",
  title   = "Funnel plots for comparing institutional performance",
  author  = person("David J.", "Spiegelhalter"),
  journal = "Statistics in Medicine",
  volume  = "24",
  number  = "8",
  pages   = "1185--1202",
  year    = "2005",
  doi     = "10.1002/sim.1970",
  header  = "rate_funnel() implements:"
)

bibentry(
  bibtype = "Article",
  title   = "Empirical cross-section dynamics in economic growth",
  author  = person("Danny", "Quah"),
  journal = "European Economic Review",
  volume  = "37",
  number  = "2-3",
  pages   = "426--434",
  year    = "1993",
  doi     = "10.1016/0014-2921(93)90031-5",
  header  = "transition_matrix() implements:"
)

bibentry(
  bibtype = "Article",
  title   = "Spatial empirics for economic growth and convergence",
  author  = person("Sergio J.", "Rey"),
  journal = "Geographical Analysis",
  volume  = "33",
  number  = "3",
  pages   = "195--214",
  year    = "2001",
  doi     = "10.1111/j.1538-4632.2001.tb00444.x",
  header  = "spatial_markov() implements:"
)

bibentry(
  bibtype = "Article",
  title   = "On the measurement of inequality",
  author  = person("Anthony B.", "Atkinson"),
  journal = "Journal of Economic Theory",
  volume  = "2",
  number  = "3",
  pages   = "244--263",
  year    = "1970",
  doi     = "10.1016/0022-0531(70)90039-6",
  header  = "inequality() computes the Atkinson index of:"
)

bibentry(
  bibtype = "Article",
  title   = "Head/tail breaks: a new classification scheme for data with a heavy-tailed distribution",
  author  = person("Bin", "Jiang"),
  journal = "The Professional Geographer",
  volume  = "65",
  number  = "3",
  pages   = "482--494",
  year    = "2013",
  doi     = "10.1080/00330124.2012.700499",
  header  = "world_map(style = \"headtails\") implements:"
)

bibentry(
  bibtype = "Article",
  title   = "Accessible visualization via natural language descriptions: a four-level model of semantic content",
  author  = c(person("Alan", "Lundgard"), person("Arvind", "Satyanarayan")),
  journal = "IEEE Transactions on Visualization and Computer Graphics",
  volume  = "28",
  number  = "1",
  pages   = "1073--1083",
  year    = "2022",
  doi     = "10.1109/TVCG.2021.3114770",
  header  = "map_alt_text() follows the four-level model of:"
)

bibentry(
  bibtype = "Article",
  title   = "The centered ternary balance scheme: a technique to visualize surfaces of unbalanced three-part compositions",
  author  = person("Jonas", "Sch\u00f6ley"),
  journal = "Demographic Research",
  volume  = "44",
  number  = "19",
  pages   = "443--458",
  year    = "2021",
  doi     = "10.4054/DemRes.2021.44.19",
  header  = "ternary_map() centres its colours as in:"
)

bibentry(
  bibtype = "Article",
  title   = "A physiologically-based model for simulation of color vision deficiency",
  author  = c(person("Gustavo M.", "Machado"), person("Manuel M.", "Oliveira"),
              person("Leandro A. F.", "Fernandes")),
  journal = "IEEE Transactions on Visualization and Computer Graphics",
  volume  = "15",
  number  = "6",
  pages   = "1291--1298",
  year    = "2009",
  doi     = "10.1109/TVCG.2009.113",
  header  = "check_palette() simulates colour-vision deficiency with:"
)
