diff --git a/.github/ISSUE_TEMPLATE/project-setup.yaml b/.github/ISSUE_TEMPLATE/project-setup.yaml index e94b798..7ff826a 100644 --- a/.github/ISSUE_TEMPLATE/project-setup.yaml +++ b/.github/ISSUE_TEMPLATE/project-setup.yaml @@ -45,4 +45,3 @@ body: attributes: label: Project Assignment description: Please provide a summary of the project and assignment. - diff --git a/README.md b/README.md index 8601215..7c2fe55 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ## Assignment -The Red Sea shipping crisis is a global crisis that began in October 2023, when missile attacks on ships and tankers traversing the Red Sea caused hundreds of vessels to avoid the Suez Canal. The attacks are concentrated near the Bab al-Mandab Strait, a 20-mile-wide chokepoint for maritime traffic. The World Bank Country Economics teams in Egypt, Yemen, and Djibouti seek to monitor the status and impacts of the crisis on their respective and regional economies. +The Red Sea shipping crisis is a global crisis that began in October 2023, when missile attacks on ships and tankers traversing the Red Sea caused hundreds of vessels to avoid the Suez Canal. The attacks are concentrated near the Bab al-Mandab Strait, a 20-mile-wide chokepoint for maritime traffic. The World Bank Country Economics teams in Egypt, Yemen, and Djibouti seek to monitor the status and impacts of the crisis on their respective and regional economies. diff --git a/docs/1-intro-to-data-lab.md b/docs/1-intro-to-data-lab.md index 2d0b375..37c74d9 100644 --- a/docs/1-intro-to-data-lab.md +++ b/docs/1-intro-to-data-lab.md @@ -1,6 +1,6 @@ # Introduction to the Data Lab -The Data Lab supports World Bank operations -- lending, technical assistance, and economic reporting -- by coordinating ad-hoc teams of data analysts and specialists from across our organization. Through the Lab, teams solve global challenges using best practices in coding, code documentation, and data visualization. +The Data Lab supports World Bank operations -- lending, technical assistance, and economic reporting -- by coordinating ad-hoc teams of data analysts and specialists from across our organization. Through the Lab, teams solve global challenges using best practices in coding, code documentation, and data visualization. Unlike a traditional data analysis, which results in a single-use report or visualization, Data Lab products are designed to be customized, reused, and updated, thereby building the capacity of the World Bank and partner organizations to quickly deliver complex data science solutions to pressing global challenges. @@ -18,29 +18,29 @@ Data Lab-supported projects may include: 2. **Analytics**. Leveraging curated datasets, the team conducts analytics across a range of topics (e.g., understanding population movement in response to a crisis or monitoring trends in nighttime lights). Each analysis will include original code, documentation, links to original data sources (and/or information on how to access them), and a description of their limitations. Reference resources are also cited, where relevant. - + 3. **Additional Resources.** Links and descriptions of additional resources for each project may include: - - Description of common baseline data used to support the analyses -- administrative boundaries, population, infrastructure, etc. + - Description of common baseline data used to support the analyses -- administrative boundaries, population, infrastructure, etc. - Project SharePoint where original data and documents are maintained. - - Additional static images and data visualizations. + - Additional static images and data visualizations. + + - +4. **Project Team**. For each project, the [World Bank Data Lab](https://wbdatalab.org/) recruits colleagues from throughout the World Bank, pooling our collective data talents in support of our lending and technical assistance operations. Project packages include names and contact information for the unique teams that prepared the analytics. -4. **Project Team**. For each project, the [World Bank Data Lab](https://wbdatalab.org/) recruits colleagues from throughout the World Bank, pooling our collective data talents in support of our lending and technical assistance operations. Project packages include names and contact information for the unique teams that prepared the analytics. - ## How Data Lab Projects are Managed 1. **Dynamic, Web-Hosted Documentation**. Unless specified otherwise, all code and documentation used to produce the analytics is hosted in a project GitHub repository to facilitate reuse for future updates and projects, as well as to support collaboration and capacity building activities. - + 2. **Data Catalogue**. Where possible, all datasets used in the production of Data Goods are added as entries to the World Bank’s [Development Data Hub](https://datacatalog.worldbank.org/home), where they are tagged with meta data, license attributes, and access information. - + 3. **Internal Project Management and File Sharing System**. To facilitate project management across teams, the Lab creates a Project SharePoint, which includes project management information (work plan, milestones, check-in slides, log of hours charged, final report), related literature, data files, indicator tables, and links to resources, such as this documentation. The advantage of SharePoint for World Bank usage is that all contents are automatically encrypted and tagged as Official Use Only. The project SharePoint is accessible to project team members and, with permission, can be replicated as a basis for future project updates or for similar projects. diff --git a/docs/2-analytics.md b/docs/2-analytics.md index d4aa072..1b67850 100644 --- a/docs/2-analytics.md +++ b/docs/2-analytics.md @@ -4,9 +4,9 @@ All Data Lab analytics include information on data sources, as well as original 1. **Overview** - Summary of the analytical challenge. + Summary of the analytical challenge. + - 2. **Data Description** Everything a user would need to access and use the data that supports the analysis. For each source, we include: @@ -21,23 +21,23 @@ All Data Lab analytics include information on data sources, as well as original - Point of Contact - + 3. **Methodology** - All analytses include step-by-step directions, code snippets, links to complete code, and notes on any critical dependencies. The user should be able to fully understand how the analytical results were achieved and be able to replicate them by following the methodology. + All analytses include step-by-step directions, code snippets, links to complete code, and notes on any critical dependencies. The user should be able to fully understand how the analytical results were achieved and be able to replicate them by following the methodology. + - 4. **Findings** - This section includes initial results, including statistics, graphs, and maps to illustrate findings. + This section includes initial results, including statistics, graphs, and maps to illustrate findings. + - 5. **Limitations** - It is critical that all analyses are accompanied by a detailed description of limitations of the data and methodology for interpreting or reproducing results. + It is critical that all analyses are accompanied by a detailed description of limitations of the data and methodology for interpreting or reproducing results. + - 6. **References and Works Cited** diff --git a/docs/3-add-resources.md b/docs/3-add-resources.md index 17bf129..b04af97 100644 --- a/docs/3-add-resources.md +++ b/docs/3-add-resources.md @@ -2,16 +2,16 @@ **Project Data** -Official-Use-Only original and derived datasets used in the project analytics are made available only to the project team. To request access, World Bank staff can write: datalab@worlldbank.org. Open datasets can be made available thorugh the World Bank's [open data catalog](https://datacatalog.worldbank.org/), at the request of the project team. +Official-Use-Only original and derived datasets used in the project analytics are made available only to the project team. To request access, World Bank staff can write: datalab@worlldbank.org. Open datasets can be made available thorugh the World Bank's [open data catalog](https://datacatalog.worldbank.org/), at the request of the project team. * [Project SharePoint](https://worldbankgroup.sharepoint.com/:f:/t/DevelopmentDataPartnershipCommunity-WBGroup/EoPKGdniEgNOsFM15KKAipAB1Zt35TWLhfnS51oSwvuJRQ) **Project Data Visualiztaions** -For some projects, additional static visualizations are created to support presentation and publication. To request access, World Bank staff can write: datalab@worlldbank.org. +For some projects, additional static visualizations are created to support presentation and publication. To request access, World Bank staff can write: datalab@worlldbank.org. * *Project SharePoint Link (if applicable)* **Other Resources** -​ Additional links or resources are sometimes provided to supplement analytical work. +​ Additional links or resources are sometimes provided to supplement analytical work. diff --git a/notebooks/chokepoints/red-sea-chokepoints.ipynb b/notebooks/chokepoints/red-sea-chokepoints.ipynb index 8d149b9..18ed315 100644 --- a/notebooks/chokepoints/red-sea-chokepoints.ipynb +++ b/notebooks/chokepoints/red-sea-chokepoints.ipynb @@ -1294,12 +1294,12 @@ "outputs": [], "source": [ "df.loc[:, \"period\"] = \"\"\n", - "df.loc[\n", - " (df.date >= start_reference_date) & (df.date < crisis_date), \"period\"\n", - "] = \"Reference\"\n", - "df.loc[\n", - " (df.date >= conflict_date) & (df.date < crisis_date), \"period\"\n", - "] = \"Middle East Conflict\"\n", + "df.loc[(df.date >= start_reference_date) & (df.date < crisis_date), \"period\"] = (\n", + " \"Reference\"\n", + ")\n", + "df.loc[(df.date >= conflict_date) & (df.date < crisis_date), \"period\"] = (\n", + " \"Middle East Conflict\"\n", + ")\n", "df.loc[(df.date >= crisis_date), \"period\"] = \"Red Sea Crisis\"" ] }, diff --git a/notebooks/ports/red-sea-ports.ipynb b/notebooks/ports/red-sea-ports.ipynb index d3ca837..861f888 100644 --- a/notebooks/ports/red-sea-ports.ipynb +++ b/notebooks/ports/red-sea-ports.ipynb @@ -1428,12 +1428,12 @@ "outputs": [], "source": [ "df.loc[:, \"period\"] = \"\"\n", - "df.loc[\n", - " (df.date >= start_reference_date) & (df.date < crisis_date), \"period\"\n", - "] = \"Reference\"\n", - "df.loc[\n", - " (df.date >= conflict_date) & (df.date < crisis_date), \"period\"\n", - "] = \"Middle East Conflict\"\n", + "df.loc[(df.date >= start_reference_date) & (df.date < crisis_date), \"period\"] = (\n", + " \"Reference\"\n", + ")\n", + "df.loc[(df.date >= conflict_date) & (df.date < crisis_date), \"period\"] = (\n", + " \"Middle East Conflict\"\n", + ")\n", "df.loc[(df.date >= crisis_date), \"period\"] = \"Red Sea Crisis\"\n", "df = df.merge(ports_red_sea[[\"portid\", \"country\"]], on=\"portid\")" ] diff --git a/notebooks/routes/3-process-routes.ipynb b/notebooks/routes/3-process-routes.ipynb index e073a52..751451f 100644 --- a/notebooks/routes/3-process-routes.ipynb +++ b/notebooks/routes/3-process-routes.ipynb @@ -1735,12 +1735,12 @@ "outputs": [], "source": [ "df_filt.loc[df_filt.Port == \"Suez Canal\", \"Country\"] = \"Chokepoint Suez Canal\"\n", - "df_filt.loc[\n", - " df_filt.Port == \"Cape of Good Hope\", \"Country\"\n", - "] = \"Chokepoint Cape of Good Hope\"\n", - "df_filt.loc[\n", - " df_filt.Port == \"Bab el-Mandeb Strait\", \"Country\"\n", - "] = \"Chokepoint Bab el-Mandeb Strait\"" + "df_filt.loc[df_filt.Port == \"Cape of Good Hope\", \"Country\"] = (\n", + " \"Chokepoint Cape of Good Hope\"\n", + ")\n", + "df_filt.loc[df_filt.Port == \"Bab el-Mandeb Strait\", \"Country\"] = (\n", + " \"Chokepoint Bab el-Mandeb Strait\"\n", + ")" ] }, { @@ -1750,12 +1750,12 @@ "outputs": [], "source": [ "df_filt.loc[df_filt.prev_port == \"Suez Canal\", \"prev_country\"] = \"Chokepoint Suez Canal\"\n", - "df_filt.loc[\n", - " df_filt.prev_port == \"Cape of Good Hope\", \"prev_country\"\n", - "] = \"Chokepoint Cape of Good Hope\"\n", - "df_filt.loc[\n", - " df_filt.prev_port == \"Bab el-Mandeb Strait\", \"prev_country\"\n", - "] = \"Chokepoint Bab el-Mandeb Strait\"" + "df_filt.loc[df_filt.prev_port == \"Cape of Good Hope\", \"prev_country\"] = (\n", + " \"Chokepoint Cape of Good Hope\"\n", + ")\n", + "df_filt.loc[df_filt.prev_port == \"Bab el-Mandeb Strait\", \"prev_country\"] = (\n", + " \"Chokepoint Bab el-Mandeb Strait\"\n", + ")" ] }, {