The function get_releases() gets you information about PGS Catalog releases; namely, the number of newly released polygenic scores, publications and performance metrics, as well as their respective associated identifiers (i.e., new pgs_ids, pgp_ids and ppm_ids).
Latest release of the PGS Catalog
To get information about the latest release, run get_releases() with default argument values:
get_releases() # Or get_releases(date = 'latest')
#> An object of class "releases"
#> Slot "releases":
#> # A tibble: 1 × 5
#> date n_pgs n_ppm n_pgp notes
#> <date> <int> <int> <int> <chr>
#> 1 2022-08-03 7 77 12 This release contains 7 new Score(s), 12 new Pub…
#>
#> Slot "pgs_ids":
#> # A tibble: 7 × 2
#> date pgs_id
#> <date> <chr>
#> 1 2022-08-03 PGS002738
#> 2 2022-08-03 PGS002739
#> 3 2022-08-03 PGS002740
#> 4 2022-08-03 PGS002741
#> # … with 3 more rows
#> # ℹ Use `print(n = ...)` to see more rows
#>
#> Slot "ppm_ids":
#> # A tibble: 77 × 2
#> date ppm_id
#> <date> <chr>
#> 1 2022-08-03 PPM014838
#> 2 2022-08-03 PPM014839
#> 3 2022-08-03 PPM014840
#> 4 2022-08-03 PPM014841
#> # … with 73 more rows
#> # ℹ Use `print(n = ...)` to see more rows
#>
#> Slot "pgp_ids":
#> # A tibble: 12 × 2
#> date pgp_id
#> <date> <chr>
#> 1 2022-08-03 PGP000345
#> 2 2022-08-03 PGP000346
#> 3 2022-08-03 PGP000347
#> 4 2022-08-03 PGP000348
#> # … with 8 more rows
#> # ℹ Use `print(n = ...)` to see more rowsRelease by date
You can use the argument date to select a specific date (if a release exists for this day) in the format "YYYY-MM-DD", e.g., "2020-11-20":
get_releases(date = '2020-11-20')
#> An object of class "releases"
#> Slot "releases":
#> # A tibble: 1 × 5
#> date n_pgs n_ppm n_pgp notes
#> <date> <int> <int> <int> <chr>
#> 1 2020-11-20 4 50 5 This release contains 4 new Score(s), 5 new Publ…
#>
#> Slot "pgs_ids":
#> # A tibble: 4 × 2
#> date pgs_id
#> <date> <chr>
#> 1 2020-11-20 PGS000340
#> 2 2020-11-20 PGS000341
#> 3 2020-11-20 PGS000342
#> 4 2020-11-20 PGS000343
#>
#> Slot "ppm_ids":
#> # A tibble: 50 × 2
#> date ppm_id
#> <date> <chr>
#> 1 2020-11-20 PPM000923
#> 2 2020-11-20 PPM000924
#> 3 2020-11-20 PPM000925
#> 4 2020-11-20 PPM000926
#> # … with 46 more rows
#> # ℹ Use `print(n = ...)` to see more rows
#>
#> Slot "pgp_ids":
#> # A tibble: 5 × 2
#> date pgp_id
#> <date> <chr>
#> 1 2020-11-20 PGP000107
#> 2 2020-11-20 PGP000108
#> 3 2020-11-20 PGP000109
#> 4 2020-11-20 PGP000110
#> # … with 1 more row
#> # ℹ Use `print(n = ...)` to see more rowsAll releases
(all_releases <- get_releases(date = 'all'))
#> An object of class "releases"
#> Slot "releases":
#> # A tibble: 51 × 5
#> date n_pgs n_ppm n_pgp notes
#> <date> <int> <int> <int> <chr>
#> 1 2022-08-03 7 77 12 This release contains 7 new Score(s), 12 new Pub…
#> 2 2022-07-21 8 33 6 This release contains 8 new Score(s), 6 new Publ…
#> 3 2022-07-05 1 10 1 This release contains 1 new Score(s), 1 new Publ…
#> 4 2022-06-29 8 73 8 This release contains 8 new Score(s), 8 new Publ…
#> # … with 47 more rows
#> # ℹ Use `print(n = ...)` to see more rows
#>
#> Slot "pgs_ids":
#> # A tibble: 2,652 × 2
#> date pgs_id
#> <date> <chr>
#> 1 2022-08-03 PGS002738
#> 2 2022-08-03 PGS002739
#> 3 2022-08-03 PGS002740
#> 4 2022-08-03 PGS002741
#> # … with 2,648 more rows
#> # ℹ Use `print(n = ...)` to see more rows
#>
#> Slot "ppm_ids":
#> # A tibble: 12,608 × 2
#> date ppm_id
#> <date> <chr>
#> 1 2022-08-03 PPM014838
#> 2 2022-08-03 PPM014839
#> 3 2022-08-03 PPM014840
#> 4 2022-08-03 PPM014841
#> # … with 12,604 more rows
#> # ℹ Use `print(n = ...)` to see more rows
#>
#> Slot "pgp_ids":
#> # A tibble: 350 × 2
#> date pgp_id
#> <date> <chr>
#> 1 2022-08-03 PGP000345
#> 2 2022-08-03 PGP000346
#> 3 2022-08-03 PGP000347
#> 4 2022-08-03 PGP000348
#> # … with 346 more rows
#> # ℹ Use `print(n = ...)` to see more rows