Package: taxfilingfusion
TaxFilingFusion stands as the solution for effortlessly accessing and navigating IRS tax filing data. This package transforms complexity into simplicity, empowering users to delve deep into federal tax data. TaxFilingFusion makes historical IRS data accessible and searchable by ZIP code, city, county, and state.FeaturesIt provides:a variety of functions to smoothly search through large volumes of dataa connection between tax filing data and geographical dataDetailed Package InfoThis Python package provides access to individual income tax statistics for various ZIP codes using data obtained from the IRS. The data spans the years between 2015 and 2020. Each year's data may have a different format as some attributes may be dropped in certain years, while new attributes may be added.The data is ingested into Google BigQuery, where all individual year tables are combined normalized into a comprehensive table. To enrich the ZIP code data and provide more detailed information, the package utilizes crosswalk files from HUD USPS, which establishes links between ZIP codes, state FIPS codes, county FIPS codes, and city FIPS codes. This enriched data allows users to obtain additional details about each ZIP code, such as county, state, region, and other associated information.Several views, table query functions, and single-valued functions are implemented to support various data needs for the API. These functions are designed to expose the cleansed data for public access. By building and leveraging these APIs, we have created an easy-to-use PyPI package that allows the public to interact with and analyze the IRS individual income tax statistics for different ZIP codes, intertwined with valuable geographic information.Call for ContributionsThe TaxFilingFusion project welcomes everyone's passions, thoughts, ideas, and contributions.Small improvements or fixes are greatly appreciated.
If you have any questions, please email:vedrathi10@gmail.comOur GitHub repository may be small and simple, but the functionality it provides is still powerful. Our goal is to continue adding new features and datasets to make this data more accessible for users and include integration from various data sources.
To help contribute to our project, you can:review the code and create pull requests via forking the repodevelop tutorials, presentations, and other educational materialshelp with outreach and publicityPackage UsageTo download the package on a command-line interface, run:pip install taxfilingfusionTo download the package on Jupyter Notebooks or IPython environments, run:!pip install taxfilingfusionTo upgrade the package version (CLI), run:pip install taxfilingfusion --upgrade.To use the functions provided by this package, after downloading, run:from taxfilingfusion import ff_fusionThen a method can be accessed using the dot operator, like:ff_fusion.{function_name(parameters...)}Refer toTaxFilingFusion Functionsto get a high-level overview of the key functions available in this package.Special NoteIn cases when a ZIP code encompasses multiple counties, we implement a ZIP code data multiplier. This multiplier is utilized to evenly distribute data among these counties, ensuring proportional representation. For example, if a ZIP code is associated with three counties and there was a total of 999 filings, each county's dataset would display 333 filings for that specific zip code (a multiplier of 0.33). Through the application of this multiplier approach, we achieve an equitable allocation of data across the different counties. This multiplier concept is similarly employed in city statistics.SourcesIRS tax filing statistics:https://www.irs.gov/statistics/soi-tax-stats-individual-income-tax-statistics-zip-code-data-soiZip code data crosswalk files:https://www.huduser.gov/portal/datasets/usps_crosswalk.html