-
Notifications
You must be signed in to change notification settings - Fork 3
Expand file tree
/
Copy pathREADME.Rmd
More file actions
159 lines (119 loc) · 5.4 KB
/
README.Rmd
File metadata and controls
159 lines (119 loc) · 5.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
---
output: github_document
editor_options:
chunk_output_type: console
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r}
#| label: setup
#| include: FALSE
knitr::opts_chunk$set(
collapse = TRUE,
echo = TRUE,
message = TRUE,
warning = FALSE,
error = TRUE,
comment = "",
fig.path = "man/figures/README-",
out.width = "100%"
)
library(tibble)
```
# <b>provider</b> <a href="https://andrewallenbruce.github.io/provider/"><img src="man/figures/logo.svg" align="right" height="139" alt="provider website" /></a>
> <b>Tidy Healthcare Provider API Interface</b>
<!-- badges: start -->
[](https://deepwiki.com/andrewallenbruce/provider)
[](https://zread.ai/andrewallenbruce/provider)
[](https://app.codecov.io/gh/andrewallenbruce/provider?branch=main)
[](https://www.codefactor.io/repository/github/andrewallenbruce/provider)
[](https://github.com/andrewallenbruce/provider)
<!-- badges: end -->
You can install `provider` from [GitHub](https://github.com/) with:
```r
# install.packages("pak")
pak::pak("andrewallenbruce/provider")
```
## Overview
The `provider` package is a high-level interface designed to streamline access
to publicly available healthcare provider data from the Centers for Medicare and
Medicaid Services (CMS) and other federal sources. It provides a unified, tidy
framework for querying complex datasets that are essential for medical coding,
billing, and healthcare revenue cycle management.
### :rocket: Basic Usage Patterns
Most functions in `provider` follow a similar pattern: they accept identifiers
(like an `npi`) or search criteria (like an `org_name`) and return a `tibble`.
```{r}
#| label: load
#| echo: TRUE
#| message: TRUE
#| warning: FALSE
library(provider)
```
#### :office: Facility Affiliations
```{r}
#| label: affiliation
affiliations(last = "Bruce")
```
#### :handshake: Reassignment of Benefits
```{r}
#| label: reassignment
reassignments(
state = "GA",
employers = greater(40, equal = TRUE))
```
#### :-1: Revoked Medicare Providers
```{r}
#| label: revoked
revocations(
state = "GA",
org_name = not_blank())
```
#### :identification_card: Clinician Demographics
```{r}
#| label: clinician
clinicians(
state = "GA",
school = not("OTHER"),
org_name = not_blank(),
grad_year = 2025)
```
##### :outbox_tray: Opt-Out Affidavits
```{r}
#| label: opted_out
opt_out(city = "Atlanta", state = "GA")
```
##### :receipt: Order & Referral Eligibility
```{r}
#| label: order_refer
order_refer(first = "Jennifer", last = "Smith")
```
##### :health_worker: Medicare Enrollments
```{r}
#| label: enrolled
providers(state = "GA", org_name = contains("West"))
```
##### :calendar: Pending Enrollments
```{r}
#| label: pending
pending(first = starts("E"), last = ends("A"))
```
##### :hospital: Medicare Hospitals
```{r}
#| label: hospital
hospitals(city = "Valdosta", state = "GA")
```
##### :test_tube: CLIA Laboratories
```{r}
#| label: clia
clia(fac_name = starts("SGMC"), state = "GA")
```
##### :mag_right: Hospital Transparency Enforcement
```{r}
#| label: transparency
transparency(action = "cap", state = "GA")
```
------------------------------------------------------------------------------
### :balance_scale: Code of Conduct
Please note that the **`provider`** project is released with a [Contributor Code of Conduct](https://andrewallenbruce.github.io/provider/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.
### :classical_building: Governance
This project is primarily maintained by [Andrew Bruce](https://github.com/andrewallenbruce). Other authors may occasionally assist with some of these duties.