Frequently Asked Questions¶
Note
Don’t see your question here? Please open an issue on GitHub and ask your question there.
Theoretical¶
How are retinal coordinates mapped to visual field coordinates?¶
Studies often assume a linear mapping between retinal and visual field
coordinates (e.g., [Hayes2003], [Thompson2003]).
A more exact transformation is given in [Watson2014], which corresponding code
in the watson2014 submodule.
In any case, note that stimulation of the inferior (superior) retina leads to
phosphenes appearing in the upper (lower) visual field.
This is why visualization functions such as
plot_fundus provide an option to flip the image
upside down.
Practical¶
Why Python?¶
Python is free, well-designed, painless to read, and easy to use. True, sometimes Python can be slow, but that is why we use Cython under the hood, which takes execution up to C speed.
How can I contribute to pulse2percept?¶
If you found a bug or want to request a feature, simply open an issue in our Issue Tracker on GitHub. Make sure to label your issue appropriately.
If you would like to contribute some code, great! We appreciate all contributions, but those accepted fastest will follow a workflow similar to the one described in our Contribution Guidelines.
The code I downloaded does not match the documentation. What gives?¶
Make sure you are reading the right version of the documentation:
- If you installed pulse2percept with pip, you are using the latest stable release, for which you can find documentation at pulse2percept.readthedocs.io/en/stable.
- If you installed pulse2percept from source, you are using the bleeding-edge version, for which you can find documentation at pulse2percept.readthedocs.io/en/latest.
- Unfortunately, pulse2percept < 0.5 is incompatible with ReadTheDocs. Please refer to the Installation Guide for information on how to upgrade your code to the latest version.