Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[FEATURE] Create a blog post to explain how to read and display IPUMS NHGIS extract using the IPUMS.jl package. #29

Open
5 tasks
00krishna opened this issue May 20, 2024 · 1 comment
Assignees
Labels
documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers help wanted Extra attention is needed

Comments

@00krishna
Copy link
Collaborator

Issue Description

Create a blog post that demonstrates to a user, how to load an IPUMS NHGIS data extract and display the output in a Makie GIS plot. The user should understand how to load the NHGIS data using the appropriate IPUMS.jl functions. Once the data is loaded, the user should understand how to obtain summaries of the data. Finally, the user should see how to plot a variable on a GIS plot--often called a chloropleth map.

Difficulty: Beginner

Time: 6 - 8 hours

Requirements

  • Explain to the user how to pull the NHGIS data from IPUMs -- or refer the user to the post that shows how to do this.
  • Show the user how to load the NHGIS data into Julia using the IPUMS.jl package.
  • Show the user how to obtain summary information for the variables in the dataset.
  • Show the user how to plot a variable in a simple chloropleth map.
  • Open and submit a PR

Expected Outcomes

The output from this task should be a markdown blog post that contains both the explanation and code to implement the items listed in the checklist above.

Additional Notes

Definition of a chloropleth map: https://en.wikipedia.org/wiki/Choropleth_map

Julia package for manipulating geospatial data - https://github.com/evetion/GeoDataFrames.jl

Julia package for creating chloropleth maps - https://github.com/MakieOrg/GeoMakie.jl

Other Resources

Julia Slack:

  • documentation channel - you should post here first
  • helpdesk channel - this would be to get more attention to your issue but maybe not as precise as you need.
  • health-and-medicine channel - this is where most of JuliaHealth is located these days.

Julia Discourse - I would advise posting here if you have an issue that you feel is long or requires a lot of time to explain as you might lose it within Julia Slack. Consider cross-posting your forum post to the Julia Slack in helpdesk and/or documentation.

@00krishna 00krishna added documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers help wanted Extra attention is needed labels May 20, 2024
@TheCedarPrince
Copy link
Member

Similar to another comment, could you find an example of what should be the expected outcome for this particular issue? Otherwise, I still think that this should go into the documentation as some sort of small example and then should go into perhaps a larger extended blog post.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

2 participants