Metadata-Version: 2.1
Name: semantic-link
Version: 0.3.1
Summary: Semantic link for Microsoft Fabric
Home-page: https://learn.microsoft.com/en-us/fabric/data-science/semantic-link-overview
Author: Microsoft
Author-email: semanticdatascience@service.microsoft.com
License: proprietary and confidential
Platform: Microsoft Fabric
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8
License-File: ../LICENSE.txt
Requires-Dist: semantic-link-sempy ==0.3.1
Requires-Dist: semantic-link-functions-geopandas ==0.3.1
Requires-Dist: semantic-link-functions-holidays ==0.3.1
Requires-Dist: semantic-link-functions-meteostat ==0.3.1
Requires-Dist: semantic-link-functions-phonenumbers ==0.3.1
Requires-Dist: semantic-link-functions-validators ==0.3.1

Semantic Link is a feature that allows you to establish a connection between [Power BI datasets](https://learn.microsoft.com/en-us/power-bi/connect-data/service-datasets-understand) and [Synapse Data Science in Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/data-science/data-science-overview).  

The primary goals of Semantic Link are to facilitate data connectivity, enable the propagation of semantic information, and seamlessly integrate with established tools used by data scientists, such as notebooks.  

Semantic Link helps you to preserve domain knowledge about data semantics in a standardized way that can speed up data analysis and reduce errors.

[Package (PyPi)](https://pypi.org/project/semantic-link/) | [API reference documentation](https://learn.microsoft.com/en-us/python/api/semantic-link-sempy/) | [Product documentation](https://learn.microsoft.com/en-us/fabric/data-science/semantic-link-overview) | [Samples](https://github.com/microsoft/fabric-samples/tree/main/docs-samples/data-science/semantic-link-samples)

By downloading, installing, using or accessing this distribution package for Semantic Link, you agree to the [Terms of Service](https://github.com/microsoft/semantic-link-functions/blob/main/sempy/LICENSE.txt).

This package has been tested with Microsoft Fabric.

# Getting started
## Prerequisites

* A [Microsoft Fabric subscription](https://learn.microsoft.com/en-us/fabric/enterprise/licenses). Or sign up for a free [Microsoft Fabric (Preview) trial](https://learn.microsoft.com/en-us/fabric/get-started/fabric-trial).
* Sign in to [Microsoft Fabric](https://fabric.microsoft.com/).
* Go to the Data Science experience in Microsoft Fabric.
* Create [a new notebook](https://learn.microsoft.com/en-us/fabric/data-engineering/how-to-use-notebook#create-notebooks) to copy/paste code into cells.

## Install the package
* Install the `SemPy` Python library in your notebook kernel by executing this code in a notebook cell:

```python
%pip install semantic-link
```

Please note that Semantic Link is split into multiple packages to allow for a modular installation.
If you want to install only a subset of the Semantic Link functionality, you can install the individual packages instead of the meta-package `semantic-link`.
This can help solve dependency issues.
The following packages are available:

* [semantic-link-sempy](https://pypi.org/project/semantic-link-sempy/) - The core package that contains the Semantic Link functionality.
* [semantic-link-functions-holidays](https://pypi.org/project/semantic-link-functions-holidays/) - A package that contains semantic functions for holidays and dependence on [holidays](https://pypi.org/project/holidays).
* [semantic-link-functions-geopandas](https://pypi.org/project/semantic-link-functions-geopandas/) - A package that contains semantic functions for geospatial data and dependence on [geopandas](https://pypi.org/project/geopandas).
* ...
* [semantic-link](https://pypi.org/project/semantic-link/) - A meta-package that depends on all the Semantic Link packages and serves as a convenient way to install all the Semantic Link packages.

# Key concepts
SemPy offers the following capabilitites:

* Connectivity to Power BI
* Connectivity through Power BI Spark native connector
* Data augmentation with Power BI measures
* Semantic propagation for pandas users
* Built-in and custom semantic functions

# Next steps
View our [Samples](https://github.com/microsoft/fabric-samples/tree/main/docs-samples/data-science/semantic-link-samples)

# Release History

## 0.3.0 (2023-08-28)

