Updating NEURON instruction installation on windows #2998
Conversation
|
✔️ 4c1f128 -> Azure artifacts URL |
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## master #2998 +/- ##
=======================================
Coverage 67.28% 67.28%
=======================================
Files 572 572
Lines 104967 104961 -6
=======================================
+ Hits 70622 70627 +5
+ Misses 34345 34334 -11 ☔ View full report in Codecov by Sentry. |
This comment has been minimized.
This comment has been minimized.
There was a problem hiding this comment.
Very nice! thank you @ceciliaromaro!
I just have added a few nitpicks / minor comments.
| Once the installer is downloaded, you can install it by double clicking like any other Windows application. | ||
| Follow the installation box steps. | ||
|
|
||
| PS: The `pip install neuron` will not work properly in Windows. |
There was a problem hiding this comment.
@ceciliaromaro : just to clarify - there is no wheel available for Windows, right?
There was a problem hiding this comment.
That is correct. There is no wheel available for Windows.
| A PATH problem that I'm not sure how to reproduce all error possibilities. But it seems to be correlated with the python installation process (from Windows Microsoft Store (as an app) or by Python Webpage and/or Conda) and/or neuron/python order (I've stalled neuron before python and didn’t get this problem) | ||
|
|
There was a problem hiding this comment.
a nitpick: As this is inside README, I think it better to write this differently:
There can be PATH-related issues that may result in errors during the runtime.
These issues often stem from how Python is installed, whether it's through the Windows
Microsoft Store, the Python website, or via Conda. Additionally, the order of installation
(Neuron before Python, for example) can also affect the setup.
By the way, stalled -> installed.
| #### Step 2: Install conda by [miniconda](https://docs.anaconda.com/free/miniconda/) | ||
| Follow the installation box steps. Select "Add Miniconda3 to my PATH environment variable" option, otherwise you will need do it manually after. | ||
| This picture: | ||
|
|
||
|  | ||
|
|
||
| Or this one: | ||
|
|
||
|  | ||
|
|
||
| #### Step 3: Open a Windows PowerShell terminal (or CDM) | ||
|
|
||
| ---------------------- | ||
|
|
||
| #### Step 4: Install Python via conda | ||
|
|
||
| `conda install python=3.#` | ||
| where # (the last compatible version) | ||
|
|
||
| ```bash | ||
| conda install python=3.11 | ||
| ``` | ||
| We recommend installing Python via conda and not via Microsoft Store to avoid manually changing the PATH file. | ||
|
|
||
| ---------------------- | ||
|
|
||
| #### Step 5: check python version | ||
|
|
||
| ```bash | ||
| python --version | ||
| ``` | ||
| If the version is not compatible with neuron do: | ||
|
|
||
| `conda install python=X.XX` ( See Step 4) | ||
|
|
||
| (X.XX the last python version compatible with neuron. Yes, it may be a downgrade) |
There was a problem hiding this comment.
This could be greatly simplified with
winget install Python.Python.3.11
and the user will get an official Python, not the Conda interpretation. The winget command should be available on modern Windows, and would avoid having to install and buy into the Conda ecosystem as a default recommendation.
| conda install panda | ||
| ``` | ||
|
|
||
| PS: `pip install matplotlib` may also works |
There was a problem hiding this comment.
Why one or the other? This should not be left ambiguous.
Co-authored-by: Matthias Wolf <[email protected]>
|
|
✔️ 1185b18 -> Azure artifacts URL |
No description provided.