community
cancel
Showing results for 
Search instead for 
Did you mean: 

Alteryx Designer Knowledge Base

Definitive answers from Designer experts.

Python Tool Libraries - An Introduction to Python

Alteryx
Alteryx
Created on

With the Python Tool, Alteryx can manipulate your data using everyone’s favorite programming language - Python! Included with the tool are a few of pre-built libraries that extend past even the native Python download. This allows you to extend your data manipulation even further than one could ever imagine. The libraries installed are listed here - and below I’ll go into a bit more detail on what and why these libraries are so useful.

 

Each library is well documented, and there’s usually an introduction or examples on their sites to get you started on how a basic function in their library works.

 

neo

 

ayx – Alteryx API – simply enough, we’re using Alteryx, sooo yea, kind of a requirement for the translation between Alteryx and Python.

 

jupyter – Jupyter metapackage – If you’ve used a Jupyter notebook in the past, you’ll notice the interface for the Python Tool is similar. This interface allows you to run sections of code outside of actually running the workflow, which makes understanding and testing your data that much easier.

http://jupyter.org/index.html

 

matplotlib – Python plotting package – Any charting, plotting, or graphical needs you would want will be in this package. This provides a great deal of flexibility for whatever you want to visualize.

https://matplotlib.org/

 

numPy – NumPy, array processing for numbers, strings, records, and objects – Native Python processes data in what some would call a cumbersome way. For instance, if you wanted to make a matrix, a.k.a. a 4x4 table, you would need to create a list within a list, which can slow processing a bit. However, NumPy has its own “array” type that fits the data in this matrix pattern that allows for faster processing. Additionally, it has a bunch of methods of handling numbers, strings, and objects that make processing a whole lot easier and a whole lot faster.

http://www.numpy.org/

 

pandas – Powerful data structures for data analysis, time series, and statistics – This is your staple for handling data within Alteryx. Those who have used Python, but never pandas, will enter a whole new beautiful world of data handling and structure. Data manipulation within Python is faster, cleaner, and easier to code with. The best part about it is that the Python Tool will read in your Alteryx data as a pandas data frame! Understanding this library should be one of the first things to know when tackling the Python code.

https://pandas.pydata.org/

 

requests – Python HTTP for Humans – for all the connector/Download Tool fans out there. If any of you are familiar with making HTTP requests (API calls and the like), then you should introduce yourselves to this package and explore how Python performs these requests.

http://docs.python-requests.org/en/master/

 

scikit-learn – a set of Python modules for machine learning and data mining – Welcome to the world of machine learning in Python! This library is your go-to for statistical and predictive modeling and evaluation. Any crazy and wild methods you’ve learned for machine learning will most likely be found here and can really push the boundaries of data science.

http://scikit-learn.org/stable/

 

scipy – Scientific Library for Python – all your scientific and technical computing can be found here. This library builds off the packages already installed here, like numPy, pandas, and matplotlib. Dealing with mathematical models and formulae are usually located within this library and can help provide that higher level analysis of your data.

https://www.scipy.org/

 

six – Python 2 and 3 compatibility utilities – For those who are unfamiliar, Python versions come in 2 forms, version 2.x and 3.x (with 3.x being the most recent). Now, even though Python 3 is supposed to be the latest and greatest, there are still many users out there who prefer using Python 2. Therefore, integration between the two is a bit tricky with syntax differences, etc. The six module provides functions that are usable between the two so everyone can remain calm and happy! Their documentation is usually coupled with which version the functions most closely align to, so a user can get a better idea to its functionality.

https://pypi.org/project/six/

 

SQLAlchemy – Database Abstraction Library – SQL in Python! Covers all your database needs from connecting to and extracting data, allowing it to interact with your Python code and thus, Alteryx itself.

https://www.sqlalchemy.org/

 

statsmodels – statistical computations and models for Python – This library builds off sci-kit learn but focuses more on statistical tests and data exploration. Additionally, it utilizes R-style formulae with pandas data frames to fit models!

https://www.statsmodels.org/stable/index.html

 

These are the libraries installed with the Python Tool, which can do almost any data function imaginable. Of course, if you’re looking to do something that these libraries don’t provide, there are myriad other Python libraries that I’m sure will help you with your use case. Most of these are also well documented in how to use so search away and let your mind float away in the beautiful cosmos created by Python.

Comments
Alteryx Partner

Thanks for this excellent post.  Can someone direct me to where I can find documentation on the Alteryx API?

Fireball

Has anyone had any luck installing GeoPandas library using Alteryx.installPackages("geopandas") ?  I get errors and can't find workaround no matter what I do.  I would love to throw some spatial objects at Python but am held up by this library.  I was able to install Shapely library which can interact with a geopandas (http://geopandas.org/) dataframe but currently am stuck.

 

 

Meteoroid
Has anyone installed packages from a mirrored PyPI repository? I have a pip.conf file that prompts me for my credentials when I install via pip on the command line in a vanilla python environment, is there a way to have Alteryx call the same function?
Alteryx Partner

How to import packages from GitHub as well? any examples...

Bolide

If you are pushing the python tool, your site deserves a dedicated python area with more examples. It's like crickets here... 

 

Any one able to push a yxzp or its blob to Alteryx.read("#1")? 

Alteryx
Alteryx

@simon Please check out our DevSpace. This is a more detailed conversation board for advanced users of different programming languages.

Meteor

Can anyone clarify how python environments are managed when publishing a workflow to the server/gallery?  That is, if I have a workflow that uses the new python tool and I've installed a package using Package.installPackages(), how do I install that package on the server so that the workflow runs within gallery?  E.g., is there something like a requirements.txt file?  I thought this would maybe be embedded as a workflow asset, but that doesn't appear to be the case.  Or is there no environment management on server, and I just have to open designer on the server and install the pacakages there (and manage all packages globally - which seems like it will become an issue if the user base grows)? 

I couldn't find any documentation or community posts that specifically address this.  Thank you.  

Meteor

Hi i tried to install ayx package, but got an error as no module found like follows,

Any one please help to install this package.

ModuleNotFoundError                       Traceback (most recent call last)
<ipython-input-1-ec9eff74ca39> in <module>()
----> 1 from ayx import Alteryx

ModuleNotFoundError: No module named 'ayx'