Skip to content

Commit

Permalink
Merge pull request #74 from ayushpatnaikgit/main
Browse files Browse the repository at this point in the history
Add citation information
  • Loading branch information
ayushpatnaikgit committed Mar 3, 2023
2 parents c7f04df + c51dee4 commit f0ab22b
Showing 1 changed file with 14 additions and 2 deletions.
16 changes: 14 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@

National Oceanic and Atmospheric Administration (NOAA) releases nighttime lights images produced using the Visible Infrared Imaging Radiometer Suite (VIIRS) since April 2012. Nighttime lights data had emerged as a useful tool to measure economic activity. Many researchers have established a correlation between prosperity and the brightness of a region. In many situations, nighttime lights generates measures with accuracy, latency and geographical resolution that are superior to conventional methods of measurement, such as GDP.

Using nighttime lights for economic analysis require cleaning of data and aggregating measurements of pixels over regions of interest. This package provides functions to clean nighttime lights data and well as some other niche functions used by reseachers in this field.
Using nighttime lights for economic analysis require cleaning of data and aggregating measurements of pixels over regions of interest. This package provides functions to clean nighttime lights data and well as some other niche functions used by reseachers in this field.

This package was a foundation for a research paper, ["But clouds got in my way: bias and bias correction of VIIRS nighttime lights data in the presence of clouds"](https://xkdr.org/wp2021-07.html) by Ayush Patnaik, Ajay Shah, Anshul Tayal, Susan Thomas. This paper diagnoses a source of bias in the data and responds to this problem with a bias correction scheme. Along with other mainstream methods of data cleaning, this method is also implemented in the package.
This package was a foundation for a research paper, ["But clouds got in my way: bias and bias correction of VIIRS nighttime lights data in the presence of clouds"](https://xkdr.org/wp2021-07.html). This paper diagnoses a source of bias in the data and responds to this problem with a bias correction scheme. Along with other mainstream methods of data cleaning, this method is also implemented in the package. A detailed description of the functions of the package used for data cleaning is in the paper ["Foundations for nighttime lights data analysis"](https://papers.xkdr.org/papers/2022Patnaiketal_foundationsforNighttimelightsDataanalysis.pdf).

This package is build on top of [Rasters.jl](https://github.com/rafaqz/Rasters.jl/). Nighttime lights tif/nc files can be read using `Rasters.Raster()`.

Expand All @@ -31,6 +31,18 @@ ncfobs = Raster("sample_ntl_ncfobs.nc")
clean_complete(radiance, ncfobs)
```

## Citing NighttimeLights.jl

To cite NighttimeLights.jl, please reference the [paper](https://papers.xkdr.org/papers/2022Patnaiketal_foundationsforNighttimelightsDataanalysis.pdf). Sample Bibtex is given below:

```bibtex
@techreport{patnaik2022foundations,
title={Foundations for nighttime lights data analysis},
author={Patnaik, Ayush and Shah, Ajay and Thomas, Susan and others},
year={2022}
}
```

## Support

We gratefully acknowledge the JuliaLab at MIT for financial support for this project.

0 comments on commit f0ab22b

Please sign in to comment.