Utsusemi4 Installation (Anaconda)
==================================

Download of Anaconda
--------------------------------------
`Anaconda <https://www.anaconda.com/>`_  is most famous Python execution environment  for a first step of larning python.

The installer enable to be downloaded from `page for Anaconda Individual Edition <https://www.anaconda.com/products/individual>`_  .

.. warning::
    The version of Python installed is depended on the version of Anaconda. Latest Anaconda includes Python 3.8.

Available Anaconda versions, on which we've confirmed Utsusemi4 execution, are shown below. 

+------------------+------------------------------------+------------------------+
|Anaconda ver.     |Dawnloaded File                     |Installed Python ver.   |
+==================+====================================+========================+
|2021.05 (Latest)  |Anaconda3-2021.05-Windows-x86_64.exe|3.8                     |
+------------------+------------------------------------+                        |
|2020.11           |Anaconda3-2020.11-Windows-x86_64.exe|                        |
+------------------+------------------------------------+------------------------+
|2019.03           |Anaconda3-2019.03-Windows-x86_64.exe|3.7                     |
+------------------+------------------------------------+------------------------+


Installation of Anaconda
--------------------------
As we omit some details about Anaconda installation please check it on Web.

    |image01conda|

    |image02conda|


**[Home Folder]/Anaconda3** is the defalt installation directory.

    |image03conda|

Usually you should choose the default settings.

    |image04conda|

After installation, you should update Anaconda itself by executing the command as below on the Anaconda terminal application (ex. *Anaconda Powershell Prompt* ).
On ommitting this step, there is a possiblity of some troubles at installing of Utsusemi4.

.. code-block:: shell
    
    > conda install anaconda


Utsusemi4 Installation
--------------------------
If the previous version of Utsusemi has been installed, you must uninstall it at first.
    
Next, download the Utsusemi4 installer from Utsusemi portal site.

.. warning::
    Installer file depends on the version of Anaconda. 

+------------------+------------------------+----------------------------------------------------+
|Anaconda ver.     |Installed Python ver.   |Utsusemi4 Installer.                                |
+==================+========================+====================================================+
|2021.05 (Latest)  |3.8                     |Utsusemi4_Anaconda2020.11.4.0.210713.PY38.x86_64.msi|
+------------------+                        |                                                    |
|2020.11           |                        |                                                    |
+------------------+------------------------+----------------------------------------------------+
|2019.03           |3.7                     |Utsusemi4_Anaconda2019.03.4.0.210713.PY37.x86_64.msi|
+------------------+------------------------+----------------------------------------------------+

Double click on the installer of Utsusemi4 downloaded to install.

    |image14|

Installation steps is normally same as one of Python.org version. However, after installation of Anaconda, you must install **PySide2** individual by yourself as shown below.
If you omit this step, Utsusemi4 GUI software cannot be launched.




1. Installation wizard window comes up
    If the dialog to show "Python executable was not found." as below, check whether correct version of Python is installed or not.

    |image01err|
    
    If normal installation wizard window comes up, basically push "Next" button to progress installation. 

    |image01|

2. End-User License Agreement
    Accept the terms in the License Agreement and push "Next" button.

    |image02|

3. Destination Folder
    Choose destination folder ( Default is "C:¥¥Program Files¥Utsusemi¥" ) and push "Next" button.

    |image03|

4. Ready to install Utsusemi
    Push "Install" button.

    |image04|

5. During installation, the dialog for "User Account Control"
    Push "Yes" button.

    |image05en|

6. Finished (Completed the Utsusemi Setup Wizard)
    It takes about 2 or 3 minutes to finish installation.

    |image07|

7. Installation of PySide2
    We prepare the PySide2 installation script on Anaconda  **InstallPyside2_forAnaconda.bat** which is placed in Utsusemi folder ( *C://Program Files/Utsusemi*  as default ). Execute this script with **the administrator privilege** .

    |image15|

    
    .. warning::
        This script can be executed without the administrator privilege, but Utsusemi4 software will not be launched. So you must execute with the privilege.

    |image16|

    Wait a moment ( a few minites ) for script finished.

    |image17|

8. Confirmation of PySide2 installation
    If the log on command prompt shows like below, the installation is successfully finished.

    |image18|


9. Confirmation of installation
    Installed software can be found in "Start" menu.

    |image08|



.. |image01| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install01.png
    :width: 400px
    
.. |image01err| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install01err.png
    :width: 400px

.. |image02| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install02.png
    :width: 400px

.. |image03| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install03.png
    :width: 400px

.. |image04| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install04.png
    :width: 400px

.. |image05en| image:: media/win_Utsusemi4Install05en.png
    :width: 400px

.. |image06| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install06.png
    :width: 400px

.. |image07| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install07.png
    :width: 400px

.. |image08| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install08.png
    :width: 200px

.. |image14| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install14.png
    :width: 140px

.. |image15| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install15.png
    :width: 400px

.. |image16| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install16.png
    :width: 400px

.. |image17| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install17.png
    :width: 400px

.. |image18| image:: ../../../ja/01UsersManual/Install/media/win_Utsusemi4Install18.png
    :width: 400px

.. |image01conda| image:: ../../../ja/01UsersManual/Install/media/win_AnacondaInstall01.png
    :width: 100px

.. |image02conda| image:: ../../../ja/01UsersManual/Install/media/win_AnacondaInstall02.png
    :width: 200px

.. |image03conda| image:: ../../../ja/01UsersManual/Install/media/win_AnacondaInstall03.png
    :width: 200px

.. |image04conda| image:: ../../../ja/01UsersManual/Install/media/win_AnacondaInstall04.png
    :width: 200px