INSTALLING ILWISPy - QUICK INSTALL. -------------------------------------------------------------- Installation instructions for Windows, for Python version 3.8. -------------------------------------------------------------- ILWISPy versions are provided for Python 3.6 and higher. 1) Download the ILWISPy Python wheel corresponding to your Python version, here as example Python version 3.8 is used. To download ILWISPy, check: 'https://filetransfer.itc.nl/pub/52n/ilwis_py/wheels/windows/', navigate to the folder having the most recent date, here as example: '20230403/' Download the wheel to a temporary folder on your local system, here as example: 'c:\temp\ilwis-1.0.20230403-cp38-cp38-win_amd64.whl' Press the keyboard button with the 'Windows' icon, together with 'r', ensure that you open the Windows Command Line Shell, type:'CMD', press 'OK'. In the command line shell window, navigate to your Python folder, e.g. for 'c:\python38', type the following command: 'cd c:\python38' 2) Install ILWISPy: c:\python38> python -m pip install c:\temp\ilwis-1.0.20230403-cp39-cp39-win_amd64.whl Processing c:\temp\ilwis-1.0.20230403-cp39-cp39-win_amd64.whl Installing collected packages: ilwis Successfully installed ilwis-1.0.20230403 Assume you get an 'error logging' because of an older 'PIP' version, to upgrade 'PIP', type following command: c:\python38> python -m pip install --upgrade pip Then you can, just to make sure that the logging error was related to an older 'PIP' versions, reinstall ILWISPy: c:\python38> python -m pip install c:\temp\ilwis-1.0.20230403-cp39-cp39-win_amd64.whl --force-reinstall Processing c:\temp\ilwis-1.0.20230403-cp39-cp39-win_amd64.whl Installing collected packages: ilwis Attempting uninstall: ilwis Found existing installation: ilwis 1.0.20230403 Uninstalling ilwis-1.0.20230403: Successfully uninstalled ilwis-1.0.20230403 Successfully installed ilwis-1.0.20230403 If you want to upgrade your ILWISPy version download the most recent version and repeat the instructions above, as during upgrade the same procedure can be followed, e.g.: c:\python38> python -m pip install c:\temp\ilwis-1.0.'new_version'-cp39-cp39-win_amd64.whl Note: 'new_version' in the file name is representing the date of the latest release! The older version will be removed and the new version installed, see example below: c:\Python38> python -m pip install c:\temp\ilwis-1.0.20230403-cp39-cp39-win_amd64.whl Processing c:\temp\ilwis-1.0.20230403-cp39-cp39-win_amd64.whl Installing collected packages: ilwis Attempting uninstall: ilwis Found existing installation: ilwis 1.0.20230330 Uninstalling ilwis-1.0.20230330: Successfully uninstalled ilwis-1.0.20230330 Successfully installed ilwis-1.0.20230403 3) Check if installation was successful, starting a new Python session: In the 'CMD' shell, in the python folder (see above), type on the command line: C:\python38> python Python 3.8.10 (tags/v3.8.10:bb3fdcf, Nov 5 2021, 20:48:33) [MSC v.1929 64 bit (AMD64)] on win32 Type "help", "copyright", "credits" or "license" for more information. >>> import ilwis gdal connector: ilwis3 connector: Organizing data: >>> ilwis.version() '1.0 build 20230403' >>> quit() Keep checking for updates, these will be posted if additional functionality is added to the ILWISPy Library or if software issues have been addressed. Further details on a release and issues addressed are provided in: 'https://filetransfer.itc.nl/pub/52n/ilwis_py/wheels/whatsnew.txt' -------------------------------------------------------------- Installation instructions for LINUX, for Python version 3.8. -------------------------------------------------------------- To install ILWISPy use the following set of commands. Open a "Terminal" session and type on the command line: 1) Download the ILWISPy wheel for Linux, using e.g. wget: >> wget https://filetransfer.itc.nl/pub/52n/ilwis_py/wheels/linux_ubuntu_20.04/20230403/ilwis-1.0.20230403-cp38-cp38-linux_x86_64.whl The wheel file will be transferred to your active "Terminal" folder. Note that here the wheel file of release date '20230403' for python linux version 3.8 is downloaded. Ensure that you download the version from the folder having the most recent date. If you want to upgrade your ILWISPy version download the most recent version and follow the instructions below, as during upgrade the same procedure can be followed. 2) Install ILWISPy (in you own user account): >> python3.8 -m pip install ilwis-1.0.20230403-cp38-cp38-linux_x86_64.whl Defaulting to user installation because normal site-packages is not writeable Processing ./ilwis-1.0.20230403-cp38-cp38-linux_x86_64.whl Installing collected packages: ilwis Successfully installed ilwis-1.0.20230403 Could be that you see a logging error, this is likely due to an older version of 'PIP', to upgrade 'PIP' type: >> python3.8 -m pip install --upgrade pip If you want to re-install ILWISPy, using the upgraded PIP version, type: >>python3.8 -m pip install ilwis-1.0.20230403-cp38-cp38-linux_x86_64.whl --force-reinstall Defaulting to user installation because normal site-packages is not writeable Processing ./ilwis-1.0.20230403-cp38-cp38-linux_x86_64.whl Installing collected packages: ilwis Attempting uninstall: ilwis Found existing installation: ilwis 1.0.20230403 Uninstalling ilwis-1.0.20230403: Successfully uninstalled ilwis-1.0.20230403 Successfully installed ilwis-1.0.20230403 3) Check if installation was successful, starting a new Python session: Restart the python kernel and you can use ILWISPy: In the 'Terminal', type on the command line: $ python3.8 Python 3.8.10 (default, Jun 22 2022, 20:18:18) [GCC 9.4.0] on linux Type "help", "copyright", "credits" or "license" for more information. >>> import ilwis gdal connector: ilwis3 connector: Organizing data: >>> ilwis. version() #check version installed 1.0 build 20230403 >>> quit() Keep checking for updates, these will be posted if additional functionality is added to the ILWISPy Library or if software issues have been addressed. Further details on a release and issues addressed are provided in: 'https://filetransfer.itc.nl/pub/52n/ilwis_py/wheels/whatsnew.txt'