1.1. Installing the Client¶
xGT is a two-part tool: a client and a server. The xGT server is an engine for analyzing large-scale graph datasets which typically runs on a powerful machine equipped with a large memory. The client is a thin Python library that can control the server from anywhere. This allows xGT to be integrated easily into existing data analysis pipelines regardless of their location.
xGT requires Python 3.7+.
Additional PyPi packages are installed when installing xGT. A list of these packages can be found here: Python Environment.
1.1.1. Installing from PyPi¶
pip install xgt
or
python -m pip install xgt
To get a specific version, say 1.4.0:
pip install xgt==1.4.0
1.1.2. Installing from a Distribution Tarball¶
pip install /path/to/dist/xgt-X.Y.Z.tar.gz
1.1.3. Recommended Packages¶
If a user has the pandas
package installed, the xGT client will use it when requested.
Pandas DataFrames can be used by the xGT client to pass data to and from a frame in the xGT server.
pip install pandas
1.1.4. Verifying Installation¶
For a quick verification, this should be run on the same system as the xGT server.
import xgt
print('Client version: {}'.format(xgt.__version__))
server = xgt.Connection(host = '127.0.0.1')
print('Server version: {}'.format(server.server_version))
A much more thorough verification of both the xGT server and the client can be done by running from the quick start guide: Quick Start Guide. It uses the xGT client to create a graph, load data to it, run a query, extract results, and finally remove the graph.
The full API reference for the xgt
package is also available here: Python API.