Page History

...

Overview

In The programming in many of your projects , the programming will consist of C# or VB.Net 100% managed code that is designed to run in the Microsoft .NET framework.

FactoryStudio now includes Python as an additional a programming language you can use in Code Behind, Scripts, Tasks, and interactively via external Python code. 

Python is an interpreted, high-level, general purpose language. Among its many uses, it is also It is a popular language for machine learning, which is useful for things like Predictive Maintenance algorithms.

Factory Studio can use any version of Python even , 3.x or the older and past end-of-life 2.x. 

...

Python Interpreter

The first step required to enable use Python programming is to include an interpreter to this language. An interpreter is a program that reads and executes code.

Interpreters and compilers are similar, since they both recognize and process source code. However, a compiler does not execute the code like an interpreter does. Instead, a compiler simply converts the source code into machine code, which can be run directly by the operating system as an executable program. Interpreters bypass the compilation process and execute the code directly.

a link to the version of the Python interpreter you want to use for your project. 

You can download Python hereTo download the interpreter, use this link.

During the installation of the Python Engine, we strongly recommend choosing the option to “Install for all users”.

Now you need to include add the interpreter to your project. Navigate to Info > Settings tab and search for the Python field. Click on the button, browse to find the installed Python Engine that was installed, and select the python.exe file.

...

Python for .NET is a package that gives Python programmers nearly seamless integration with the .NET Common Language Runtime (CLR) and provides a powerful application scripting tool for .NET developers..

Python for .NET allows It allows Python code to interact with the CLR and may also be used to embed Python into a .NET application. The installation files and documentation are available in this linkhere.

Check to see whether your Python Engine version, and if your Windows version is versions are 32-bit or 64-bit before choosing you download Python for .NET installation file. This is only required only if you intend to use the Python namespace in the Studio Scripts and Display CodeBehinds.

...

To create scripts based on the Python programming language, navigate to Scripts > Tasks, select a new, blank new row, and double-click on the Code column. You should see Python available for selection in the ComboBox.. After clicking Code, a combobox will appear. Select Python from the combobox. 

...

After creating a new script task, you need to edit it through in the CodeEditor tab.

The configurations settings are detailed below:

...

...

Python Namespace

Must use for .Net developers, the The Python namespace can be used in any script editor inside your project environment (Tasks, Classes and , or CodeBehind) . Basically, all you need is to install Python for .NETinside your project environment. To use the Python namespace, you simply need to install the Python.NET package, available on github.

The Python namespace provides several .Net methods to that interact with Python codes and objects. See some of those methods below:                        

...

• Convert a Python value to a .NET value

public static object FromPython(object value)

object value = Python value
object returns = NET value

...

• Dump a python object to a string to send it to a TraceWindow

public static string DumpPythonObjectToString(object pythonObject)

object pythonObject = Python object.
string returns = Dump information of object.

...

TKDataAccess.py

Must use for Python developers, you You can create code in the Python environment and use the TKDataAccess.py file to interact with the projects. 

Below are some methods from TKDataAccess.py that you can use:

...

Connect(runtimeHostAddress, userName, password):

runtimeHostAddress  =  IP address or server name
userName  = User name.
password = Password

• Get a Status of Server Connectionserver connection status

GetConnectionStatus ()                 

• Check whether is connected to your script's connection to the server

IsConnected ()

...

Disconnect()

• Set a flag waiting value from server

SetSyncFlag(flag):

flag = True wait value from server, false does not wait value from server.

• Retrieve a current value

GetObjectValue(name)

name = TagName

• Set a new value for an object

SetObjectValue(name, newValue)

name = TagName
newValue = new value to set in the tag.

...

Using Namespace in CodeBehind

In this first example, there are two input parameters called val1 and val2 that will be summarized and the result will be stored in the result variable.

...

In this scenario, we configure a task for the Python language. In the Python file name field, you need to set the Python file that will be to be executed. In this example, we used the Main2.py.

...

In the Standard Output field, we selected a tag called output. This tag type must be text. In the Arguments field, we selected another type of tag called script.

The Using the print method, the Python file called Main2.py gets the retrieves the input data and outputs its value inside a string, using the print method. Where the . The sys.argv will receive the Tag.script and the output tag will receive all the values from the print() method.

import sys

value = sys.argv[1] print("Value: " + value) print("That’s  all  folks!")

...

Using TKDataAccess.Py

In this example, we will you need to call a file named Main.py, which contains code that copies the content from tag1 (source) to tag2 (target).

The Python code using the TKDataAccess.py module in Main.py is described below:

import sys
from Extensions.TKDataAccess import TKDataAccess dataAccess = TKDataAccess()
connectionStatus = dataAccess.Connect("127.0.0.1:3101", "guest", "") print("Connection: " + connectionStatus)

if dataAccess.IsConnected() :
ret  =  dataAccess.GetObjectValue("Tag.tag1") print("Value: " + str(ret)) dataAccess.SetObjectValue("Tag.tag2",  ret)

dataAccess.Disconnect()

Then, in your project, you need to create a the code that is shown below or create a Python Script Task that executes the Main.py file, which contains the calling for TKDataAccess shown above. So here, we will use the Python namespace as previously described.

...