Skip to content

Commit

Permalink
add image to sib resource page
Browse files Browse the repository at this point in the history
Add a SIB dashboard screenshot to the SIB resource page.

Add sample code for downloading raw BMF files to the BMF data page.
  • Loading branch information
lecy committed Dec 2, 2024
1 parent dc7f0f8 commit f4c4698
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 1 deletion.
58 changes: 57 additions & 1 deletion _datasets/bmf.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,61 @@ The team is currently developing a research guide to accompany this BMF. While t
style = "primary"
%}

## Raw IRS BMF Files

Starting in June, 2023, we began archiving monthly snapshots of IRS BMF files released on their [Exempt Organizations Business Master File Extract (EO BMF)](https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf) page.

Note that it will use a separate [Data Dictionary](https://www.irs.gov/pub/irs-soi/eo-info.pdf) and it will not include all of the variables in the NCCS BMF files. For the typical user these will not be as useful, but we include them here for those that need to replicate a workflow built using raw IRS files from a specific point a time.


```r
# install.packages( "curl" )
# install.packages( "data.table" )
# install.packages( "readr" )

library( curl )
library( data.table )
library( readr )

# ------------------

base <- "https://nccsdata.s3.us-east-1.amazonaws.com/raw/bmf/"
YYYYMM <- format( Sys.time(), "%Y-%m-" ) # "2024-12-" current month
filename <- paste0( YYYYMM, "BMF.csv" ) # "2024-12-BMF.csv"
URL <- paste0( base, filename ) # "https://.../2024-12-BMF.csv"

# ------------------

dir.create("bmf")
setwd("bmf")

# SLIGHTLY FASTER DOWNLOAD FUNCTION
curl::curl_download( url=URL, destfile=filename, mode="wb" )
bmf <- read.csv( filename )

# ------------------

# DEFAULT DOWNLOAD FUNCTION
download.file( url=URL, destfile=filename, method="curl" )
bmf <- read.csv( filename )

# ------------------

# FASTER READ CSV OPTIONS
bmf <- data.table::fread( filename )
bmf <- readr::read_csv( filename )

# ------------------

# ARCHIVED VERSIONS FROM JUNE 2023 ONWARD:
filename <- "2023-06-BMF.csv"
URL <- paste0( base, filename )
curl::curl_download( url=URL, destfile=filename, mode="wb" )
bmf <- read.csv( filename )
```

<br>

Users are encouraged to submit any questions and comments regarding this data set on our [contact page](https://nccs.urban.org/nccs/contact/).

## Version Control

Expand All @@ -63,6 +116,9 @@ Users are encouraged to submit any questions and comments regarding this data se
| 1.0 | July 4th 2024 | Research Guide Complete |
| 1.1 | July 18th 2024 | State-level Data Marts |

Users are encouraged to submit any questions and comments regarding this data set on our [contact page](https://nccs.urban.org/nccs/contact/).


## BMF Overview

The IRS 990 Business Master File, often referred to as the "BMF," is a database maintained by the Internal Revenue Service (IRS). It contains information about tax-exempt organizations and other entities that are required to file various forms of the IRS Form 990 series. These organizations include:
Expand Down
7 changes: 7 additions & 0 deletions _resources/sector-in-brief-dashboard.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,3 +44,10 @@ pubs:
href: https://www.urban.org/sites/default/files/publication/28606/412085-The-Nonprofit-Sector-in-Brief.PDF
link-text: PDF
---


<br>

![](../../_resources/sector-in-brief.png)

<br>
Binary file added public/img/resources/sector-in-brief.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f4c4698

Please sign in to comment.