https://github.com/pedrohdosanjos/economic-data-analysis

This project aims to analyze the export data from various states in the United States to Brazil over time. The data is sourced from the FRED (Federal Reserve Economic Data) API and processed to identify the top 5 exporting states for each year, as well as the states with the highest total export value across all years.
https://github.com/pedrohdosanjos/economic-data-analysis

api data-analysis data-visualization jupyter-notebook python

Last synced: about 2 months ago
JSON representation

This project aims to analyze the export data from various states in the United States to Brazil over time. The data is sourced from the FRED (Federal Reserve Economic Data) API and processed to identify the top 5 exporting states for each year, as well as the states with the highest total export value across all years.

• Host: GitHub
• URL: https://github.com/pedrohdosanjos/economic-data-analysis
• Owner: pedrohdosanjos
• Created: 2025-06-06T17:21:33.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-07T02:31:04.000Z (about 1 year ago)
• Last Synced: 2025-07-01T23:36:15.632Z (12 months ago)
• Topics: api, data-analysis, data-visualization, jupyter-notebook, python
• Language: Jupyter Notebook
• Homepage:
• Size: 1 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Brazil Exports Analysis

This project retrieves export data to Brazil from FRED (Federal Reserve Economic Data) and analyzes the top 5 american states that export to Brazil each year.

![Top 5 Exporters by Year](assets/linechart.png)

![Top 5 Exporters All Time](assets/top5.png)

![Export Trends](assets/top5at.png)

## Steps:

1. **Data Retrieval**:

   - The data is retrieved using the FRED API, with the specific search term "Value of Exports to Brazil from".

   - The data includes state-wise exports to Brazil for multiple years.

2. **Data Preprocessing**:

   - The results are cleaned by removing rows where all values are NaN.

   - The index is updated to represent the year.

3. **Visualization**:

   - **Top 5 Exporters by Year**: For each year, the top 5 states are plotted in subplots as a bar chart. Each bar represents a state, and the height of the bar is the export value.

   - **Top 5 Exporters of All Time**: A bar plot is generated showing the states with the highest total export value to Brazil across all years.

## Requirements:

- pandas

- plotly

- matplotlib

- fredapi

You can install these dependencies with the following:

```

pip install -r requirements.txt

```

## Running the Code:

1. Fetch the data from FRED using the API key.

2. Preprocess and clean the data.

3. Visualize the results using **matplotlib** and **plotly** for line plots and bar plots.

## Notes:

- Ensure you replace the `api_key` variable with your own key from FRED API.

- The code uses **matplotlib** to generate subplots and bar charts, and **plotly** to create line charts.