Skip to content

Tutorial: getting started with conda#116

Open
baharmon wants to merge 2 commits intoOSGeo:mainfrom
baharmon:conda
Open

Tutorial: getting started with conda#116
baharmon wants to merge 2 commits intoOSGeo:mainfrom
baharmon:conda

Conversation

@baharmon
Copy link
Copy Markdown
Contributor

@baharmon baharmon commented May 6, 2026

A new quick start tutorial on GRASS for Conda. Covers installing the miniforge distribution of Conda, creating an environment for GRASS and Jupyter, downloading the Natural Earth Dataset, and then displaying maps in a Jupyter Notebook. This pull request should be merged after PR #115 since it expects acm.csl to be in the root directory.

@baharmon baharmon changed the title tutorial: getting started with conda Tutorial: getting started with conda May 6, 2026
Comment on lines +201 to +202
# Set GRASS database
gisdbase = Path.home() / "grassdata"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's omit using gisdbase and grassdata... We are trying to put projects in the spotlight and avoid the traditional directory structure. We can have projects anywhere, so perhaps just download the zip in the current directory, no need to create a grassdata for a zip file.

Copy link
Copy Markdown
Contributor Author

@baharmon baharmon May 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@veroandreo Okay. gs.setup.init and gj.init require a project path though. So I think I need to include a path in the call: session = gj.init(Path.cwd() / "natural_earth_dataset"). Is there a better way?

Alternatively, we could create a temporary directory and project like in many of the other tutorials. Perhaps just using the current directory, however, is a little simpler and an example of a different way to work.

Comment on lines +104 to +107
For {{< fa brands microsoft >}} Windows,
download and run the binary installer.
See [here](https://github.com/conda-forge/miniforge#install)
for more detailed instructions.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shall we wait to merge this tutorial until the conda package for Windows is ready? Or maybe we say something like "Conda package for Windows is coming soon!"?

Copy link
Copy Markdown
Contributor Author

@baharmon baharmon May 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@veroandreo After some reflection, I think I'd prefer publishing this now and then updating it. I commented out the Windows instructions and replaced it with a coming soon statement. I don't know how long it will be before the Windows package is released. When GRASS 8.5 for Conda is out, I will update the tutorial to use the new GRASS Tools API. I also plan to write another, more in-depth tutorial.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants