|
|
| (3 intermediate revisions by one other user not shown) |
| Line 1: |
Line 1: |
| [[Category:Language]]{{NoTitle}} | | #REDIRECT [[Language - Python]] |
| {|
| |
| |style="vertical-align:middle; width: 60%;"|
| |
| <font size=6>'''Language - Python'''
| |
| | |
| '''Windows with PyCharm'''</font>
| |
| | |
| Welcome to using Phidgets with Python! By using Python, you will have access to the complete Phidget22 API, including events.
| |
| | |
| PyCharm is an integrated development environment for Python by JetBrains.
| |
| | |
| |{{TOC limit|2}}
| |
| |}
| |
| | |
| {{Language_-_Python_Intro_Windows|
| |
| <tabber>
| |
| PIP=
| |
| The recommended way to install the '''Phidget22 Python module''' is using the '''PIP package manager'''.
| |
| <br><br>
| |
| To install the Phidget22 libraries for your current PyCharm project with PIP, first open '''File > Settings'''
| |
| [[File:PyCharm_Settings.png|link=|center|800px]]
| |
| <br><br>
| |
| Next, navigate to '''Project > Project Interpreter''' and click on the '''+''' symbol located on the right hand side:
| |
| [[File:PyCharm_Interpreter.png|link=|center|800px]]
| |
| <br><br>
| |
| Type Phidget22 into the search bar, select the package named '''Phidget22''' and click Install Package:
| |
| <br>''Ensure you select the package named '''Phidget22'''. Other PIP users have created non-official packages for Phidgets.''
| |
| [[File:PyCharm_Install_Phidget22.png|link=|center|800px]]
| |
| |-|
| |
| PIP Global=
| |
| The recommended way to install the '''Phidget22 Python module''' is using the '''PIP package manager'''.
| |
| <br><br>
| |
| Python versions '''2.7.9+''' and '''3.4+''' include PIP by default.
| |
| | |
| To install the Phidget22 Python module with PIP, simply open the '''Command Prompt''' (press the Windows key and search for "cmd"), and enter the command:
| |
| <syntaxhighlight lang=python>
| |
| python -m pip install Phidget22
| |
| </syntaxhighlight>
| |
| | |
| To install the Phidget22 libraries to a specific Python version, you can use the '''Python Windows Launcher''' from the Command Prompt as follows (replace -X.X with your Python version, e.g. -2.7 or -3.6):
| |
| <syntaxhighlight lang=python>
| |
| py -X.X -m pip install Phidget22
| |
| </syntaxhighlight>
| |
| | |
| To use the global Phidget22 library in your PyCharm project, select '''Inherit global site-packages''' when creating a new project.
| |
| | |
| [[File:PyCharm_Inherit_Global_Packages.png|center|link=]]
| |
| |-|
| |
| Manual Install=
| |
| To install the Phidget22 Python module without PIP, you will need to download the [{{SERVER}}/downloads/phidget22/libraries/any/Phidget22Python.zip Phidget22 Python module].
| |
| | |
| After unpacking the Phidget22 Python module, open the '''Command Prompt''' (press the Windows key and search for "cmd") Locate the folder where you downloaded the Python module and enter the following command:
| |
| <syntaxhighlight lang=python>
| |
| python setup.py install
| |
| </syntaxhighlight>
| |
| | |
| This will build the module and install the Python module files into your site-packages directory.
| |
| | |
| [[File:Python_install.png|link=|center]]
| |
| </tabber>
| |
| }}
| |
| | |
| ==Use our examples==
| |
| One of the best ways to start programming with Phidgets is to use our example code as a guide. Before we get started, make sure you have read [[#Install Phidget Python module for Windows | how to install the Phidget Python module]] section above. You will also need to download [https://www.jetbrains.com/pycharm/ PyCharm] if you have not already.
| |
| | |
| Now that you have Python and the Phidget Python module installed, as well as PyCharm, select an example that will work with your Phidget:
| |
| *{{SampleCode|Python|Python Examples}}
| |
| | |
| | |
| Next, create a new Python project:
| |
| [[Image:Python_pycharm_newproject.PNG|link=|center]]
| |
| | |
| | |
| Add the example you just downloaded by dragging it into the project. Be sure to include ''PhidgetHelperFunctions.py'', as it is used by the example code:
| |
| [[Image:Python_pycharm_import.png|link=|center|850px]]
| |
| | |
| Finally, run the project:
| |
| [[Image:Python_pycharm_run.png|link=|center|850px]]
| |
| | |
| If prompted, select the example file to be run:
| |
| [[Image:Python_pycharm_select_python_file.png|link=|center|850px]]
| |
| | |
| {{Edit_the_Examples}}
| |
| | |
| {{Language_-_Python_Editing_The_Examples}}
| |
| | |
| ==Setting Up a New Project==
| |
| When you are building a project from scratch, or adding Phidget functionality to an existing project, you'll need to configure your development environment to properly link the Phidget Python library.
| |
| | |
| To start, create a new Python project:
| |
| [[Image:Python_pycharm_newproject.PNG|link=|center]]
| |
| | |
| | |
| Next, add a new file to the project:
| |
| [[Image:Python_pycharm_newfile.PNG|link=|center|850px]]
| |
| | |
| Name the new file with a fitting name:
| |
| [[Image:Python_pycharm_newfile_2.PNG|link=|center]]
| |
| | |
| To include the Phidget Python library, add the following imports to your code:
| |
| | |
| <syntaxhighlight lang=python>
| |
| from Phidget22.PhidgetException import *
| |
| from Phidget22.Phidget import *
| |
| </syntaxhighlight>
| |
| | |
| Then, you will also have to import the class for your particular Phidget. For example, you would include the following line for a DigitalInput:
| |
| | |
| <syntaxhighlight lang=python>
| |
| from Phidget22.Devices.DigitalInput import *
| |
| </syntaxhighlight>
| |
| | |
| [[Image:Python_pycharm_newfile_3.PNG|link=|center|850px]]
| |
| | |
| The project now has access to Phidgets.
| |
| | |
| {{Language Page What's Next}}
| |
