Installation

The aindo.rdml package is a Python package and is available for Linux and for a few versions of Python. It is recommended to have the venv module available, to install the package in an isolated virtual environment. The name of the provided wheel file has the following structure: aindo_rdml-{version}-cp{py_version}-cp{py_version}-linux_x86_64.whl, where {version} is the package version (e.g. 3.0.0) and {py_version} is the Python version (e.g. 310 for Python 3.10).

Once the wheel is located, open a terminal and move to the folder where to create the virtual environment, then type the following commands:

path/to/dir$ python -m venv venv
path/to/dir$ source venv/bin/activate
(venv) path/to/dir$ python -m pip install -U pip setuptools
(venv) path/to/dir$ python -m pip install -U "path/to/aindo_rdml-{version}-cp{py_version}-cp{py_version}-linux_x86_64.whl"

Note that in the above example the command python is used in the first line to create the virtual environment, but the user should specify the command to launch the required Python version (e.g. python3 for Python 3.10 in some Linux distributions). Once the virtual environment is activated, the command python will invoke the correct Python version.

Once the installation is complete, the package aindo.rdml will be available in the virtual environment:

path/to/dir$ source venv/bin/activate
(venv) path/to/dir$ python
Python 3.10.15 (main, Sep  7 2024, 18:35:33) [GCC 9.4.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from aindo.rdml.relational import RelationalData
>>>

Optional dependencies

The procedure discussed above will install the library and its main dependencies. There are also a few optional dependencies that can be installed. They can be specified by adding them to the last command described above as follows:

(venv) path/to/dir$ python -m pip install -U "path/to/aindo_rdml-{version}-cp310-cp310-linux_x86_64.whl[opt1,opt2,...]"

The available optional dependencies are:

• db: Allow for DB reading/writing (the supported dialects are the ones supported by sqlalchemy, but the user may have to install the appropriate DBAPI driver).
• excel: Allow for reading from Excel files.
• dev: Includes a few packages that may be useful to track the progression of the model training (e.g. tensorboard).

License

Along with the wheel, a license key will also be provided. The aindo.rdml library will search for the license key in three possible locations:

1. The AINDO_LICENSE environment variable.
2. The .aindo file in the current working directory.
3. The .aindo file in the user’s home directory (~).

The user can place the key in any of these locations. Alternatively, the license can be activated manually at runtime using the activate() function, by providing the license key directly as a string.

Regardless of the method used to provide the license, its activation and validity can be verified with the assert_active() function.

from aindo.rdml.license.utils import activate, assert_active

lic = "__the_provided_licence_as_a_string__"

activate(lic=lic)
assert_active()