nest / nestml

A domain specific language for neuron and synapse models in spiking neural network simulation
GNU General Public License v2.0
45 stars 46 forks source link

Instruction Update re Basic Ubuntu on WSL #998

Closed pippowell closed 3 months ago

pippowell commented 7 months ago

Added the cmake package to the conda install command. The cmake package is not installed by default and will result in errors if missing (confirmed on MacOS and Linux).

Also added information relevant to installing on Windows Linux Subsystem installations of Linux.

clinssen commented 7 months ago

@pippowell hi, thanks for the contribution! Do you think it makes sense to just include the "make" package in the conda install line, regardless of whether it is already installed or not?

pippowell commented 7 months ago

@clinssen In general I would say go ahead and include it, since it should just recognize that "make" is already installed and simply install the other packages. The caveat though is that conda is notoriously problematic with environment solving the more packages you include that it has to check dependencies and conflicts for. The "cxx-compiler" and "wxpython" packages were already making the installation tricky when I set up my environment and the addition of the boost packages to the list (which was done Monday) seemed to already make matters worse. Adding "make" could potentially add to the issue and make it even more likely that fresh installations will hang on solving. But if there is a switch to a new installation scheme, such as mamba etc., perhaps that would work. Conda switched to the mamba background installer in the last couple of updates and when I created a Miniconda environment and used the latest conda with that background, it managed to install the previous list (everything including boost, but not cmake or make) without issue as long as you entered the entire list on the first installation. It still didn't like installing "wxpython" after the fact though, which I had tried in an earlier installation attempt.

Perhaps if you add "make" and make an additional note that new users should make sure they have the latest conda installed and that they create their new environment with the command on the website, i.e. installing all packages together at the start versus installing one by one? Some may still have issues, but it would be a good place for them to start and they can troubleshoot from there.

clinssen commented 6 months ago

@pippowell : thanks for your feedback! Could you review the proposed changes?

pippowell commented 6 months ago

@clinssen Looks good. The new list should (fingers crossed) create a functional environment for NEST regardless of platform. With all packages installing at once, nothing worse should happen than conda noting that one of the packages is already there and the user doesn't have to give anything a second thought. If anyone does encounter issues, they'll at least have a good foundation to start from. I'd say these changes can be committed now. 👍