5. Frequently Asked Questions¶
5.1. General¶
5.1.1. Who is behind this? Who to contact?¶
The immediate involved persons is described in the Development team section. The author is a participating member in the GS Task-Force on behalf of the EU Commission (JRC). The contact-emails to use are ...[TBD]
5.1.2. What is the status of the project? Is it “official”?¶
[TBD]
5.1.3. What is the roadmap for this project?¶
5.1.4. Can I copy/extend it? What is its License, in practical terms?¶
I’m not a lawyer, but in a broad view, the core algorithm of the project is “copylefted” with the EUPL-1.1+ license, and it includes files from other “non-copyleft” open source licenses like MIT MIT License and Apache License, appropriately marked as such. So in an nutshell, you can study it, copy it, modify or extend it, and distrbute it, as long as you always distribute the sources of your changes.
5.2. Technical¶
5.2.1. I followed the instructions but i still cannot install/run/do X. What now?¶
If you have no previous experience in python, setting up your environment and installing a new project is a demanding, but manageable, task. Here is a checklist of things that might go wrong:
Did you send each command to the appropriate shell/interpreter?
You should enter sample commands starting $ into your shell (cmd or bash), and those starting with >>> into the python-interpreter (but don’t include the previous symbols and/or the output of the commands).
Is python contained in your PATH ?
To check it, type python in your console/command-shell prompt and press [Enter]. If nothing happens, you have to inspect PATH and modify it accordingly to include your python-installation.
Under Windows type path in your command-shell prompt. To change it, run regedit.exe and modify (or add if not already there) the PATH string-value inside the following registry-setting:
HKEY_CURRENT_USER\Environment\
You need to logoff and logon to see the changes.
Note that WinPython does not modify your path! if you have registed it, so you definetely have to perform the the above procedure yourself.
Under Unix type echo $PATH$ in your console. To change it, modify your “rc’ files, ie: ~/.bashrc or ~/.profile.
Is the correct version of python running?
Certain commands such as pip come in 2 different versions python-2 & 3 (pip2 and pip3, respectively). Most programs report their version-infos with --version. Use --help if this does not work.
Have you upgraded/downgraded the project into a more recent/older version?
This project is still in development, so the names of data and functions often differ from version to version. Check the Changes for point that you have to be aware of when upgrading.
Did you search whether a similar issue has already been reported?
Did you ask google for an answer??
If the above suggestions still do not work, feel free to open a new issue and ask for help. Write down your platform (Windows, OS X, Linux), your exact python distribution and version, and include the print-out of the failed command along with its error-message.
This last step will improve the documentation and help others as well.
5.2.2. I do not have python / cannot install it. Is it possible to try a demo?¶
[TBD]