Add bibliography and citation (#47)

* Add bibliography and citation

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

CITATION.cff

@@ -0,0 +1,22 @@
+authors:
+  - affiliation: World Bank
+    family-names: Stefanini Vicente
+    given-names: Gabriel
+    orcid: 0000-0001-6530-3780
+  - affiliation: World Bank
+    family-names: Delgado Blasco
+    given-names: José Manuel
+cff-version: 1.2.0
+date-released: "2024-02-20"
+keywords:
+  - Gaza
+  - Copernicus Sentinel
+  - NASA Black Marble
+  - Nighttime Lights
+  - Synthetic Aperture Radar
+license:
+  - mpl-2.0
+repository-code: https://github.com/datapartnership/blackmarblepy/tree/v2024.1.0
+title: "Gaza-Israel 2023 Conflict Impact Analysis"
+type: software
+version: v2024.1.0

README.md

@@ -1,9 +1,15 @@
 # Gaza-Israel Conflict Impact Analysis
 
-> Using Alternative Data to Understand Economic Impacts of the 2023 Gaza-Israel Conflict
+> Using Alternative Data to Understand Economic Impacts of the Gaza-Israel 2023 Conflict
 
 The 2023 Gaza-Israel Conflict had profound economic implications that extend beyond conventional measures. This project aims to explore alternative data sources, such as synthetic-aperture radar and nighttime lights, to better comprehend the multifaceted economic impacts on the Gaza Strip. Leveraging alternative data sources can provide a more nuanced understanding of the economic landscape during and after such events, when traditional economic indicators may not fully capture the complex dynamics and localized effects of conflicts.
 
+The following reports features insights from our project's data and analyses.
+
+- [World Bank Support for Emergency Relief to Gaza](https://www.worldbank.org/en/news/press-release/2023/12/12/world-bank-support-for-emergency-relief-to-gaza)
+
+- [Impacts of the Conflict in the Middle East on the Palestinian Economy - December 2023 Update](https://documents1.worldbank.org/curated/en/099721412142313834/pdf/IDU043992ccb0c283048bd0941e073dbfc46633b.pdf)
+
 ## Contributing
 
 We welcome contributions to improve this documentation. If you find errors, have suggestions, or want to add new content, please follow our [contribution guidelines](docs/CONTRIBUTING.md).

docs/bibliography.bib

@@ -25,3 +25,15 @@ @article{BITTNER201734
 keywords = {OpenStreetMap, Israel, Palestine, Critical cartography, Web 2.0 cartographies, Volunteered geographic information},
 abstract = {In Israel and Palestine, map-making practices were always entangled with contradictive spatial identities and imbalanced power resources. Although an Israeli narrative has largely dominated the ‘cartographic battlefield’, the latest chapter of this story has not been written yet: collaborative forms of web 2.0 cartographies have restructured power relations in mapping practices and challenged traditional monopolies on map and spatial data production. Thus, we can expect web 2.0 cartographies to be a ‘game changer’ for cartography in Palestine and Israel. In this paper, I review this assumption with the popular example of OpenStreetMap (OSM). Following a mixed methods approach, I comparatively analyze the genesis of OSM in Israel and Palestine. Although nationalist motives do not play a significant role on either side, it turns out that the project is dominated by Israeli and international mappers, whereas Palestinians have hardly contributed to OSM. As a result, social fragmentations and imbalances between Israel and Palestine are largely reproduced through OSM data. Discussing the low involvement of Palestinians, I argue that OSM's ground truth paradigm might be a watershed for participation. Presumably, the project's data are less meaningful in some local contexts than in others. Moreover, the seemingly apolitical approach to map only ‘facts on the ground’ reaffirms present spatio-social order and thus the power relations behind it. Within a Palestinian narrative, however, many aspects of the factual material space might appear not as neutral physical objects but as results of suppression, in which case, any ‘accurate’ spatial representation, such as OSM, becomes objectionable.}
 }
+
+@misc{10.5281/zenodo.10667925,
+  title = {{BlackMarblePy: Georeferenced Rasters and Statistics of Nighttime Lights from NASA Black Marble}},
+  author = {Gabriel {Stefanini Vicente} and Robert Marty},
+  month        = feb,
+  year         = 2024,
+  publisher    = {World Bank},
+  version      = {v0.2.3},
+  doi          = {10.5281/zenodo.10667925},
+  url          = {https://doi.org/10.5281/zenodo.10667925}
+}
+g

notebooks/nighttime-lights/nighttime-lights.ipynb

@@ -313,7 +313,7 @@
    "source": [
     "### Black Marble \n",
     "\n",
-    "[NASA's Black Marble](https://blackmarble.gsfc.nasa.gov) VIIRS (Visible Infrared Imaging Radiometer Suite) Nighttime Lights product suite represents a remarkable advancement in our ability to monitor and understand nocturnal light emissions on a global scale. By utilizing cutting-edge satellite technology and image processing techniques, the Black Marble VIIRS dataset offers a comprehensive and high-resolution view of the Earth's nighttime illumination patterns. "
+    "[NASA's Black Marble](https://blackmarble.gsfc.nasa.gov) product suite represents a remarkable advancement in our ability to monitor and understand nocturnal light emissions on a global scale. By utilizing cutting-edge satellite technology and image processing techniques, the Black Marble VIIRS dataset offers a comprehensive and high-resolution view of the Earth's nighttime illumination patterns. To obtain the raster data conveniently and calculate zonal statistics, we use the [BlackMarblePy](https://worldbank.github.io/blackmarblepy/README.html) {cite}`10.5281/zenodo.10667925` package developed by the World Bank."
    ]
   },
   {

pyproject.toml

@@ -8,7 +8,7 @@ description = "Using Alternative Data to Understand Economic Impacts of the 2023
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { file = "LICENSE" }
 keywords = [
-	"sentinel",
+	"copernicus sentinel",
 	"synthetic aperture radar",
 	"nighttime lights",
 	"black marble",
@@ -17,6 +17,7 @@ keywords = [
 authors = [{ name = "World Bank Data Lab", email = "[email protected]" }]
 maintainers = [
 	{ name = "Gabriel Stefanini Vicente", email = "[email protected]" },
+	{ name = "José Manuel Delgado Blasco", email = "[email protected]" },
 ]
 classifiers = [
 	"Development Status :: 3 - Alpha",
@@ -42,7 +43,7 @@ ignore-regex = '^\s*"image\/png":\s.*'
 ignore-words-list = "gost,"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/gaza-israel-conflict-impact-analysis"]
+packages = ["src/*"]
 
 [tool.hatch.version]
 source = "vcs"

reports/README.md

@@ -0,0 +1,7 @@
+# Reports
+
+This section contains information about the reports generated from our project's data and analyses.
+
+- [World Bank Support for Emergency Relief to Gaza](https://www.worldbank.org/en/news/press-release/2023/12/12/world-bank-support-for-emergency-relief-to-gaza)
+
+- [Impacts of the Conflict in the Middle East on the Palestinian Economy - December 2023 Update](https://documents1.worldbank.org/curated/en/099721412142313834/pdf/IDU043992ccb0c283048bd0941e073dbfc46633b.pdf)