{"id":33293479,"url":"https://github.com/chokzb/covid19_vaccination_analysis","last_synced_at":"2026-05-07T02:31:53.150Z","repository":{"id":324672180,"uuid":"1098041238","full_name":"ChokZB/covid19_vaccination_analysis","owner":"ChokZB","description":"An EDA project examining global COVID-19 vaccination progress. The notebook investigates vaccination trends by country, daily vaccination rates, timeline patterns, and dose distribution. The project includes visualisations created with Matplotlib, Seaborn, and Plotly.","archived":false,"fork":false,"pushed_at":"2025-11-17T07:47:39.000Z","size":2555,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-17T09:14:46.601Z","etag":null,"topics":["covid-19","data-analysis","data-visualization","jupyter-notebook","matplotlib","numpy","pandas","plotly","python","seaborn","vaccination"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChokZB.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-17T07:18:47.000Z","updated_at":"2025-11-17T07:55:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ChokZB/covid19_vaccination_analysis","commit_stats":null,"previous_names":["chokzb/covid19_vaccination_analysis"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ChokZB/covid19_vaccination_analysis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokZB%2Fcovid19_vaccination_analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokZB%2Fcovid19_vaccination_analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokZB%2Fcovid19_vaccination_analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokZB%2Fcovid19_vaccination_analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChokZB","download_url":"https://codeload.github.com/ChokZB/covid19_vaccination_analysis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChokZB%2Fcovid19_vaccination_analysis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284982746,"owners_count":27095048,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-17T02:00:06.431Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["covid-19","data-analysis","data-visualization","jupyter-notebook","matplotlib","numpy","pandas","plotly","python","seaborn","vaccination"],"created_at":"2025-11-18T01:00:26.710Z","updated_at":"2026-05-07T02:31:53.143Z","avatar_url":"https://github.com/ChokZB.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Global COVID-19 Vaccination Data Analysis and Visualisation\n\n![License](https://img.shields.io/badge/License-MIT-blue)\n![Python](https://img.shields.io/badge/Python-3.8+-yellow)\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/ChokZB/covid19_vaccination_analysis/blob/main/covid19_vaccination_analysis.ipynb)\n\nA data-analysis project examining global COVID-19 vaccination progress through dataset cleaning, exploration, and visualisation.\n\n\n---\n\n## 🎯 Objectives\n\n* Analyse worldwide vaccination trends and compare progress across regions and income groups.\n* Clean, validate, and transform raw vaccination data to enable reliable insights.\n* Produce visual representations that highlight coverage differences, rollout speed, and vaccine usage patterns.\n* Incorporate external socioeconomic information to uncover broader relationships and disparities.\n\n\n---\n\n## 🗃️ Dataset\n\n**File:** [`data/country_vaccinations.csv`](data/country_vaccinations.csv)\n\n\nThe dataset can be downloaded from Kaggle via this [link](https://www.kaggle.com/datasets/gpreda/covid-world-vaccination-progress).\n\nThe data in the dataset is a comprehensive collection of daily COVID-19 vaccination data by country, gathered from [Our World in Data’s GitHub repository](https://github.com/owid/covid-19-data). Country-level vaccination data is compiled into a single file. This file is then merged with location data files to include vaccination source information before the author uploads it on Kaggle.\n\nThe data contains the following information:\n\n| No. | Attribute Name                      | Description                                                                                                            |\n| --- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |\n| 1.  | country                             | Country for the vaccination data.                                                                                      |\n| 2.  | iso_code                            | ISO code for the country.                                                                                              |\n| 3.  | date                                | Date of the data entry.                                                                                                |\n| 4.  | total_vaccinations                  | Absolute number of total immunisations.                                                                                |\n| 5.  | people_vaccinated                   | Number of people who received at least one dose.                                                                       |\n| 6.  | people_fully_vaccinated             | Number of people who received all doses prescribed by the vaccination protocol.                                        |\n| 7.  | daily_vaccinations_raw              | Raw number of vaccinations administered for that date. This column will not be used in favour of `daily_vaccinations`. |\n| 8.  | daily_vaccinations                  | Number of vaccinations administered for that date.                                                                     |\n| 9.  | total_vaccinations_per_hundred      | Ratio (in percent) vaccination number and total population.                                                            |\n| 10. | people_vaccinated_per_hundred       | Ratio (in percent) between vaccinated people and total population.                                                     |\n| 11. | people_fully_vaccinated_per_hundred | Ratio (in percent) between fully vaccinated people and total population.                                               |\n| 12. | daily_vaccinations_per_million      | Ratio (in parts per million) between daily vaccination number and total population.                                    |\n| 13. | vaccines                            | Total number of vaccines used in the country.                                                                          |\n| 14. | source_name                         | The source of the information.                                                                                         |\n| 15. | source_website                      | The website of the information source.                                                                                 |\n\n\n---\n\n## 📡 External Data Sources \u0026 APIs\n\nAdditional contextual information is incorporated using two public APIs:\n\n* **World Bank Country API**: Supplies country income-level classifications (Low, Lower Middle, Upper Middle, High). These classifications are merged into the dataset using ISO country codes to support comparative socioeconomic analysis.\n\n* **REST Countries API**: Provides population figures for each country. A mapping layer is included to correct naming inconsistencies between the dataset and the API.\n\nThese external datasets enhance the main vaccination data by enabling population-based grouping and income-level comparisons.\n\n\n---\n\n## 📁 Project Structure\n\n```\ncovid19_vaccination_analysis/\n│\n├── data/\n│   └── country_vaccinations.csv                        # Dataset\n│\n├── figures/                                            # Folder for exported visualisations\n│   ├── Top_10_Countries_by_Vaccination_Rate.png\n│   ├── Bottom_10_Countries_by_Vaccination_Rate.png\n│   ├── Global_Usage_of_Different_Vaccines.png\n│   └── ...\n│\n├── .gitignore                                          # Files/folders excluded from Git\n│\n├── LICENSE                                             # MIT License\n|\n├── README.md                                           # Project overview and instructions\n│\n├── covid19_vaccination_analysis.ipynb                  # Main notebook\n│\n└── requirements.txt                                    # Dependency list for reproducibility\n```\n\n\n---\n\n## 🔧 Setup \u0026 Execution\n\n1. **Clone the repository**\n\n   ```\n   git clone https://github.com/ChokZB/covid19_vaccination_analysis.git\n   ```\n\n2. **Create a virtual environment (optional but recommended)**\n\n   ```\n   python -m venv venv\n   source venv/bin/activate        # macOS / Linux\n   venv\\Scripts\\activate           # Windows\n   ```\n\n3. **Install dependencies**\n\n   Install all required packages using the provided `requirements.txt`:\n\n   ```\n   pip install -r requirements.txt\n   ```\n\n4. **Run the notebook**\n\n   ```\n   jupyter notebook covid19_vaccination_analysis.ipynb\n   ```\n    or open it directly in Colab.\n\n    [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/ChokZB/covid19_vaccination_analysis/blob/main/covid19_vaccination_analysis.ipynb)\n\n\n---\n\n## 📷 Visual Outputs\n\nSome previews of visualisations produced during the analysis, exported from the notebook for reference.\n\n\n![Top 10 Countries by Vaccination Rate](figures/Top_10_Countries_by_Vaccination_Rate.png)\n\n![Bottom 10 Countries by Vaccination Rate](figures/Bottom_10_Countries_by_Vaccination_Rate.png)\n\n\n---\n\n## 📈 Results \u0026 Insights\n\n* Income-group comparisons, supported by classifications obtained from the World Bank API, reveal clear disparities in average vaccinations per hundred people, with higher-income economies consistently achieving substantially greater coverage than lower-income groups.\n\n* Population-based analysis, informed by population figures retrieved through the REST Countries API, shows that smaller countries exhibit the widest spread in vaccination rates, whereas medium and large population groups display more stable and clustered distributions.\n\n* Scatter-plot patterns indicate no strong linear association between the number of vaccine types administered and national vaccination coverage.\n\n* Global daily vaccination activity reached its highest point on 27 June 2021, reflecting intensified rollout phases, strategic dose-interval adjustments, and improved supply during mid-2021.\n\n* Vaccine-usage distributions highlight uneven reliance on specific vaccine brands, demonstrating varied national strategies and availability conditions across regions.\n\n\n---\n\n## 🧑‍💻 Author\n\n**Chok Zu Bing**\n\nGitHub: [@ChokZB](https://github.com/ChokZB)\n\n\n---\n\n## 🪪 Licence\n\nThis project is released under the [MIT License](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchokzb%2Fcovid19_vaccination_analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchokzb%2Fcovid19_vaccination_analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchokzb%2Fcovid19_vaccination_analysis/lists"}