معرفی شرکت ها

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

توضیحات

A library for working with the Brick ontology for buildings (brickschema.org)

ویژگی	مقدار
سیستم عامل	-
نام فایل	brickschema-0.7.1a3
نام	brickschema
نسخه کتابخانه	0.7.1a3
نگهدارنده	[]
ایمیل نگهدارنده	[]
نویسنده	Gabe Fierro
ایمیل نویسنده	gtfierro@mines.edu
آدرس صفحه اصلی	https://brickschema.org
آدرس اینترنتی	https://pypi.org/project/brickschema/
مجوز	BSD-3-Clause

# Brick Ontology Python package ![Build](https://github.com/BrickSchema/py-brickschema/workflows/Build/badge.svg) [![Documentation Status](https://readthedocs.org/projects/brickschema/badge/?version=latest)](https://brickschema.readthedocs.io/en/latest/?badge=latest) [![PyPI version](https://badge.fury.io/py/brickschema.svg)](https://badge.fury.io/py/brickschema) Documentation available at [readthedocs](https://brickschema.readthedocs.io/en/latest/) ## Installation The `brickschema` package requires Python >= 3.6. It can be installed with `pip`: ``` pip install brickschema ``` The `brickschema` package offers several installation configuration options for reasoning. The default bundled [OWLRL](https://pypi.org/project/owlrl/) reasoner delivers correct results, but exhibits poor performance on large or complex ontologies (we have observed minutes to hours) due to its bruteforce implementation. The [Allegro reasoner](https://franz.com/agraph/support/documentation/current/materializer.html) has better performance and implements enough of the OWLRL profile to be useful. We execute Allegrograph in a Docker container, which requires the `docker` package. To install support for the Allegrograph reasoner, use ``` pip install brickschema[allegro] ``` The [reasonable Reasoner](https://github.com/gtfierro/reasonable) offers even better performance than the Allegro reasoner, but is currently only packaged for Linux and MacOS platforms. To install support for the reasonable Reasoner, use ``` pip install brickschema[reasonable] ``` ## Quickstart The main `Graph` object is just a subclass of the excellent [RDFlib Graph](https://rdflib.readthedocs.io/en/stable/) library, so all features on `rdflib.Graph` will also work here. Brief overview of the main features of the `brickschema` package: ```python import brickschema # creates a new rdflib.Graph with a recent version of the Brick ontology # preloaded. g = brickschema.Graph(load_brick=True) # OR use the absolute latest Brick: # g = brickschema.Graph(load_brick_nightly=True) # OR create from an existing model # g = brickschema.Graph(load_brick=True).from_haystack(...) # load in data files from your file system g.load_file("mbuilding.ttl") # ...or by URL (using rdflib) g.parse("https://brickschema.org/ttl/soda_brick.ttl", format="ttl") # perform reasoning on the graph (edits in-place) g.expand(profile="owlrl") g.expand(profile="shacl") # infers Brick classes from Brick tags # validate your Brick graph against built-in shapes (or add your own) valid, _, resultsText = g.validate() if not valid: print("Graph is not valid!") print(resultsText) # perform SPARQL queries on the graph res = g.query("""SELECT ?afs ?afsp ?vav WHERE { ?afs a brick:Air_Flow_Sensor . ?afsp a brick:Air_Flow_Setpoint . ?afs brick:isPointOf ?vav . ?afsp brick:isPointOf ?vav . ?vav a brick:VAV }""") for row in res: print(row) # start a blocking web server with an interface for performing # reasoning + querying functions g.serve("localhost:8080") # now visit in http://localhost:8080 ``` ## Features `brickschema` supports a number of optional features: - `[all]`: Install all features below - `[brickify]`: install `brickify` tool for converting metadata from existing sources - `[web]`: allow serving of Brick models over HTTP + web interface - `[merge]`: initial support for merging Brick models with different identifiers together - `[persistence]`: support for saving and loading Brick models to/from disk - `[allegro]`: use Allegrograph reasoner - `[reasonable]`: use Reasonable reasoner ### Inference `brickschema` makes it easier to employ reasoning on your graphs. Simply call the `expand` method on the Graph object with one of the following profiles: - `"rdfs"`: RDFS reasoning - `"owlrl"`: OWL-RL reasoning (using 1 of 3 implementations below) - `"vbis"`: add VBIS tags to Brick entities - `"shacl"`: infer Brick classes from Brick tags, among other things ```python from brickschema import Graph g = Graph(load_brick=True) g.load_file("test.ttl") g.expand(profile="owlrl") print(f"Inferred graph has {len(g)} triples") ``` The package will automatically use the fastest available reasoning implementation for your system: - `reasonable` (fastest, Linux-only for now): `pip install brickschema[reasonable]` - `Allegro` (next-fastest, requires Docker): `pip install brickschema[allegro]` - OWLRL (default, native Python implementation): `pip install brickschema` To use a specific reasoner, specify `"reasonable"`, `"allegrograph"` or `"owlrl"` as the value for the `backend` argument to `graph.expand`. ### Haystack Translation `brickschema` can produce a Brick model from a JSON export of a Haystack model. Then you can use this package as follows: ```python import json from brickschema import Graph model = json.load(open("haystack-export.json")) g = Graph(load_brick=True).from_haystack("http://project-haystack.org/carytown#", model) points = g.query("""SELECT ?point ?type WHERE { ?point rdf:type/rdfs:subClassOf* brick:Point . ?point rdf:type ?type }""") print(points) ``` ### VBIS Translation `brickschema` can add [VBIS](https://vbis.com.au/) tags to a Brick model easily ```python from brickschema import Graph g = Graph(load_brick=True) g.load_file("mybuilding.ttl") g.expand(profile="vbis") vbis_tags = g.query("""SELECT ?equip ?vbistag WHERE { ?equip <https://brickschema.org/schema/1.1/Brick/alignments/vbis#hasVBISTag> ?vbistag }""") ``` ### Web-based Interaction `brickschema` now supports interacting with a Graph object in a web browser. Executing `g.serve(<http address>)` on a graph object from your Python script or interpreter will start a webserver listening (by default) at http://localhost:8080 . This uses [Yasgui](https://yasgui.triply.cc/) to provide a simple web interface supporting SPARQL queries and inference. To use this feature, install `brickschema` with the `web` feature enabled: ``` pip install brickschema[web] ``` ### Brick model validation The module utilizes the [pySHACL](https://github.com/RDFLib/pySHACL) package to validate a building ontology against the Brick Schema, its default constraints (shapes) and user provided shapes. ```python from brickschema import Graph g = Graph(load_brick=True) g.load_file('myBuilding.ttl') valid, _, _ = g.validate() print(f"Graph is valid? {valid}") # validating using externally-defined shapes external = Graph() external.load_file("other_shapes.ttl") valid, _, _ = g.validate(shape_graphs=[external]) print(f"Graph is valid? {valid}") ``` The module provides a command `brick_validate` similar to the `pyshacl` command. The following command is functionally equivalent to the code above. ```bash brick_validate myBuilding.ttl -s other_shapes.ttl ``` ## `Brickify` To use `brickify`, install `brickschema` with the `[brickify]` feature enabled: ``` pip install brickschema[brickify] ``` **Usage**: ```console $ brickify [OPTIONS] SOURCE ``` **Arguments**: * `SOURCE`: Path/URL to the source file [required] **Options**: * `--input-type TEXT`: Supported input types: rac, table, rdf, haystack-v4 * `--brick PATH`: Brick.ttl * `--config PATH`: Custom configuration file * `--output PATH`: Path to the output file * `--serialization-format TEXT`: Supported serialization formats: turtle, xml, n3, nt, pretty-xml, trix, trig and nquads [default: turtle] * `--minify / --no-minify`: Remove inferable triples [default: False] * `--input-format TEXT`: Supported input formats: xls, csv, tsv, url, turtle, xml, n3, nt, pretty-xml, trix, trig and nquads [default: turtle] * `--building-prefix TEXT`: Prefix for the building namespace [default: bldg] * `--building-namespace TEXT`: The building namespace [default: https://example.com/bldg#] * `--site-prefix TEXT`: Prefix for the site namespace [default: site] * `--site-namespace TEXT`: The site namespace [default: https://example.com/site#] * `--install-completion`: Install completion for the current shell. * `--show-completion`: Show completion for the current shell, to copy it or customize the installation. * `--help`: Show this message and exit. Usage examples: [brickify](tests/data/brickify). ## Development Brick requires Python >= 3.6. We use [pre-commit hooks](https://pre-commit.com/) to automatically run code formatters and style checkers when you commit. Use [Poetry](https://python-poetry.org/docs/) to manage packaging and dependencies. After installing poetry, install dependencies with: ```bash poetry install ``` Enter the development environment with the following command (this is analogous to activating a virtual environment. ```bash poetry shell ``` On first setup, make sure to install the pre-commit hooks for running the formatting and linting tools: ```bash # from within the environment; e.g. after running 'poetry shell' pre-commit install ``` Run tests to make sure build is not broken ```bash # from within the environment; e.g. after running 'poetry shell' make test ``` ### Docs Docs are written in reStructured Text. Make sure that you add your package requirements to `docs/requirements.txt`

نیازمندی

مقدار	نام
>=6.2,<7.0	rdflib
>=6.0,<7.0	owlrl
>=6.2,<7.0	pytest
>=0.20,<0.21	pyshacl
>=2.25.0,<3.0.0	requests
>=3.3.0,<4.0.0	importlib-resources
>=0.1.10,<0.2.0)	click-spinner
>=0.8.7,<0.9.0)	tabulate
==3.0.3)	Jinja2
>=1.2.0,<2.0.0)	xlrd
>=5.3.1,<6.0.0)	PyYAML
>=0.4.1,<0.5.0)	typer
>=2.0,<3.0)	Flask
>=0.4.4,<0.5.0)	colorama
>=2.0,<3.0)	dedupe
>=0.2.2a4,<0.3.0)	reasonable
>=1.4,<2.0)	sqlalchemy
>=0.5,<0.6)	rdflib_sqlalchemy
>=21.12.3,<22.0.0)	BAC0
>=2.6,<3.0)	networkx

زبان مورد نیاز

مقدار	نام
>=3.7,<4.0	Python

نحوه نصب

نصب پکیج whl brickschema-0.7.1a3:

pip install brickschema-0.7.1a3.whl

نصب پکیج tar.gz brickschema-0.7.1a3:

pip install brickschema-0.7.1a3.tar.gz