ioam / topographica

A general-purpose neural simulator focusing on topographic maps.
topographica.org
BSD 3-Clause "New" or "Revised" License
53 stars 32 forks source link

from topo.analysis.featureresponses import pattern_response missing in 0.9.8 #669

Open kevroy314 opened 7 years ago

kevroy314 commented 7 years ago

When you install via pip, you get version 0.9.8. The documentation online (https://ioam.github.io/topographica/Tutorials/som_retinotopy.html) references:

from topo.analysis.featureresponses import pattern_response

Which doesn't appear to be present in featureresponses in 0.9.8.

Also, is there a quick/easy way on windows to get the online documentation to run? Nothing I do seems to work as the newer version from github don't want to build on windows and the older versions don't contain the necessary class.

kevroy314 commented 7 years ago

In fact, in running other steps, it looks like there's a huge disconnect between the example in the documentation and the 0.9.8 version available via pip. Maybe I'm doing something very wrong, but it seems like there's an import error every few cells...

jbednar commented 7 years ago

If you install the 0.9.8 release, you should also get a copy of the documentation that corresponds to it, though I'm not sure where pip puts it -- maybe /usr/share/topographica/? I believe that the help menu within 0.9.8 will find the documentation wherever it ends up on your system. So if you are using 0.9.8, you should ignore the web documentation at topographica.org.

That said, I can't in good faith recommend anyone use 0.9.8 at this point. The online documentation is for github master, which diverged massively from 0.9.8 as my latest PhD students finished up their PhD theses. One of those theses is now published and the other one is in the finishing stages, so we totally should make a new release now that captures what we have achieved. Meanwhile, I would personally recommend trying to get github master working; none of us remember 0.9.8 anymore! So can you report the problems you have on Windows with github master? We can probably figure those out, though I don't personally have any Windows machine to debug it on.

kevroy314 commented 7 years ago

Thanks for the quick response! I'll avoid 0.9.8. You might want to remove the pip install recommendations from the website to avoid confusion in the future. When you go to the main downloads page on the website, it's all recommending 0.9.8 (https://ioam.github.io/topographica/Downloads/index.html). Looking forward to getting a chance to try out the master branch! It's a bit difficult to build on windows, unfortunately, but that's a separate issue.