معرفی شرکت ها
Rackio-1.0.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A modern Python Framework for microboard automation and control applications development
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | Rackio-1.0.3 |
| نام | Rackio |
| نسخه کتابخانه | 1.0.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Nelson Carrasquel |
| ایمیل نویسنده | rackio.framework@outlook.com |
| آدرس صفحه اصلی | https://github.com/rack-io/rackio-framework |
| آدرس اینترنتی | https://pypi.org/project/Rackio/ |
| مجوز | MIT |
# Rackio Framework
A modern Python Framework for microboard automation and control applications development.
[Github-Rackio Framework](https://github.com/rack-io/rackio-framework)
# Documentation
The complete Rackio documentation can be found in Read the Docs
[Rackio Framework Documentation](https://rackio-framework.readthedocs.io/)
## Requirements
- Python 3.6+
- falcon
- pyBigParser
# Installation
```
pip install Rackio
```
# Examples
## Basic Setup
```python
from rackio import Rackio, TagEngine
app = Rackio()
tag_engine = TagEngine()
# Tags definitions
tag_engine.set_tag("RAND1", "float")
tag_engine.set_tag("RAND2", "float")
tag_engine.set_tag("T1", "float")
tag_engine.set_tag("T2", "float")
tag_engine.set_tag("T3", "float")
if __name__ == "__main__":
app.run()
```
Rackio comes with some built-in features that let you start creating rapid and fast coding prototypes.
# Adding controls
Controls are objects that interact with the tags, changing their values accordingly to a condition
### Value Actions
These actions only change tags values with a defined constant value.
```python
from rackio.controls import Condition, ValueAction, Control
# Conditions definitions
cond1 = Condition("T1",">=", "T2")
cond2 = Condition("T1","<", "T2")
# Actions definitions
act1 = ValueAction("T3", 40)
act2 = ValueAction("T3", 80)
# Controls Definitions
control1 = Control("C1", cond1, act1)
control2 = Control("C2", cond2, act2)
app.append_control(control1)
app.append_control(control2)
```
### Math Actions
These actions change tags values with a defined mathematical expression, and defined tags can be used inside these expressions.
```python
from rackio.controls import MathAction
# Conditions definitions
cond1 = Condition("T1",">=", "T2")
cond2 = Condition("T1","<", "T2")
# Actions definitions
act1 = MathAction("T3", "T1 + T2")
act2 = MathAction("T3", "T2 - T1")
# Controls Definitions
control1 = Control("C1", cond1, act1)
control2 = Control("C2", cond2, act2)
app.append_control(control1)
app.append_control(control2)
```
Once Rackio is up and running, will trigger some actions if the associated condtions are met, by observing continously all the tags values for changes.
## Supported functions within expressions
You can define your mathematical expression following the same arithmetic rules that python can handle, but only a set of math functions and constants are supported.
* ```cos```
* ```sin```
* ```abs```
* ```log10```
* ```log```
* ```exp```
* ```tan```
* ```pi```
* ```e```
## Adding continous tasks
Rackio can be extended to add custom continous tasks and operations
```python
@app.rackit(1)
def writer1():
tag_engine.write_tag("T1", 15)
tag_engine.write_tag("T2", 40)
direction = 1
while True:
time.sleep(0.5)
value = 24 + 2 * random()
tag_engine.write_tag("RAND1", value)
T1 = tag_engine.read_tag("T1")
T1 += direction
tag_engine.write_tag("T1", T1)
if T1 >= 60:
direction *= -1
if T1 <= 5:
direction *= -1
```
You can register a defined function as a continous task to be perform by Rackio. You can also provide functions as tasks lists
```python
@app.rackit_on(period=1)
def reader():
rand1 = tag_engine.read_tag("RAND1")
rand2 = tag_engine.read_tag("RAND2")
T1 = tag_engine.read_tag("T1")
T2 = tag_engine.read_tag("T2")
T3 = tag_engine.read_tag("T3")
print("")
print("RAND1: {}".format(rand1))
print("RAND2: {}".format(rand2))
print("T1 : {}".format(T1))
print("T2 : {}".format(T2))
print("T3 : {}".format(T3))
```
By specify its ```period```, you can keep control of the time execution for these tasks.
# Testing the RESTful API
Once your application is up and running, it will deploy a RESTful API with ```falcon```, and the ```json``` format is the standard supported by this API.
## Reading tags with httpie
Once your application is up and running you can access through the API, if you want to try with ```httpie```, you can install it with the following command:
```
pip install httpie
```
Now execute the next command in your terminal
```
http localhost:8000/api/tags
```
you will get the following
```http
HTTP/1.0 200 OK
Date: Tue, 11 Jun 2019 23:54:55 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 177
content-type: application/json
```
```json
[
{
"tag": "RAND1",
"value": 25.597755601381692
},
{
"tag": "RAND2",
"value": 49.12890172456638
},
{
"tag": "T1",
"value": 57
},
{
"tag": "T2",
"value": 40
},
{
"tag": "T3",
"value": 97
}
]
```
if you want to access an specific tag, for example tag ```T2```
```
http localhost:8000/api/tags/T2
```
you will get the following
```http
HTTP/1.0 200 OK
Date: Tue, 11 Jun 2019 23:58:40 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 26
content-type: application/json
```
```json
{
"tag": "T2",
"value": 40
}
```
## Writing tags with httpie
You can change this tag value by executing
```
http POST localhost:8000/api/tags/T2 value=50
```
And you will get the following
```http
HTTP/1.0 200 OK
Date: Wed, 12 Jun 2019 00:01:21 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 16
content-type: application/json
```
```json
{
"result": true
}
```
## Reading tags history
You can read tags history using the API also
```
http localhost:8000/api/tags/history/RAND1
```
And you will get the following
```http
HTTP/1.0 200 OK
Date: Tue, 18 Jun 2019 02:52:43 GMT
Server: WSGIServer/0.2 CPython/3.7.1
content-length: 4917
content-type: application/json
```
```json
{
"tag": "RAND1",
"value": [
0.0,
24.628376069489793,
25.757258388362462,
25.55412553374292,
24.555658954786043,
25.06933481716872,
25.40130983961439,
25.689521224514724,
25.81125032707667,
25.639558206736673,
25.349485473327377,
24.799801913324295,
25.227466610598572,
25.27254049615728,
25.105421823573916,
24.82832764778826,
24.65831512999663,
25.26014559203846,
25.216187451359872,
25.151243977491735
]
}
```
This way you can create your custom HMTL and Javascript Views to perform ```AJAX``` requests on Rackio.
# Things to do
Rackio is work in progress framework, some features are still in development and they will be release soon for better applications, these features are listed below:
* Finish RESTful API
* Capability for users to add custom HTML files for HMI
* Token Based Authentication for API access
* Web Based Monitoring and Admin
* Alarms definitions
* Modbus and MQTT protocols
* Automatic Datalogging
* Trends and Historical data
نیازمندی
| مقدار | نام |
|---|---|
| - | falcon |
| - | falcon-multipart |
| - | falcon-auth |
| - | falcon-cors |
| - | pyBigParser |
| - | peewee |
| - | python-statemachine |
| - | APScheduler |
| - | waitress |
| - | Jinja2 |
| - | PyYAML |
| - | psycopg2 |
نحوه نصب
نصب پکیج whl Rackio-1.0.3:
pip install Rackio-1.0.3.whl
نصب پکیج tar.gz Rackio-1.0.3:
pip install Rackio-1.0.3.tar.gz