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

OSGEO Installer workflow #90

Open
MattReimer opened this issue Nov 2, 2022 · 5 comments
Open

OSGEO Installer workflow #90

MattReimer opened this issue Nov 2, 2022 · 5 comments
Assignees
Labels
documentation Improvements or additions to documentation enhancement New feature or request 🌐 Viewer QGIS

Comments

@MattReimer
Copy link
Member

MattReimer commented Nov 2, 2022

When the user installs QGIS through the OSGEO installer they are able to pick and choose which python modules they can install.

The user should NOT use pip to install these modules. They should navigate to the C:\OSGEO4W\bin folder (or wherever they installed it) and use the osgeo12-setup.exe tool to install the modules.

There are some simple mitigation steps we can do to make sure OSGEO installer users aren't left out in the cold.

  1. Let's make a list of recommended python modules across all our tools (lxml, scipy, shapely etc) and document it on our website for OSGEO users so they can go through and install them all before working with any of our plugins
  2. look into better import error handling inside QRave so that the user receives better errors and instructions inside QRave when things go wrong.

So far, the list of modules that we needed to install is as follows:

lxml
@MattReimer MattReimer added documentation Improvements or additions to documentation enhancement New feature or request labels Nov 2, 2022
@MattReimer MattReimer added this to the QRAVE 0.9.0 milestone Nov 2, 2022
@MattReimer MattReimer self-assigned this Nov 2, 2022
@MattReimer
Copy link
Member Author

Note: Re: #86 I installed QGIS using the OSGEO4W installer (QGIS and QGIS-LTR) and it installed all the right modules.

This ticket only applies to non-default, custom installs

@joewheaton
Copy link

@MattReimer I removed scipy and shapely as those were not needed to get QRAVE working. They were needed to get QRiS working. Riverscapes/QRiS#152

@MattReimer
Copy link
Member Author

I think, given that my standard OSGEO4W install did the right thing this ticket's importance drops almost to zero. We can handle the 1% custom cases with a little documentation and some phone calls.

@joewheaton
Copy link

Agreed. Maybe we update the QGIS installation instructions to discourage using OSGEO4W, and then have a buried sub-section or page showing that if someone does that form, and doesn't select the right stuff, what to do to fix it.

Can we still improve the error message it throws?

@MattReimer
Copy link
Member Author

For now I'd say no. Too many variations on what could be thrown with a custom installer. Might be worth an investigation task at some point but right now we have bigger 🐟 to 🔥

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 🌐 Viewer QGIS
Projects
None yet
Development

No branches or pull requests

2 participants