Qctrl

class Qctrl(email=None, password=None, api_root=None, oidc_url=None, env_namespace=None, skip_version_check=False, client=None, verbosity='VERBOSE', organization=None)

A mediator class. Used to authenticate with Q-CTRL and access Q-CTRL features.

Creating an instance of this class requires authentication with Q-CTRL’s API.

The recommended method of authentication is through the interactive authentication method. This method can be invoked by simply calling Qctrl() without any arguments. This method will also create an authentication file that will be used for subsequent authentications when using the package.

qctrl = Qctrl()

You can also access toolkits provided by Boulder Opal through the corresponding namespaces of the Qctrl object. See the reference for details.

Deprecated since version 15.4.4: Email and password based authentication has been removed in favour of url based authentication. To authenticate simply call qctrl = Qctrl() without any additional arguments.

Parameters:

  • email (str, optional) – The email address for a Q-CTRL account. [This field has been deprecated] (Default value = None)

  • password (str, optional) – The password for a Q-CTRL account. [This field has been deprecated] (Default value = None)

  • api_root (str, optional) – The URL of the Q-CTRL API. (Default value = None)

  • oidc_url (str, optional) – The URL of the Q-CTRL OIDC. (Default value = None)

  • env_namespace (str, optional) – The environment namespace of the Q-CTRL stack. (Default value = None)

  • skip_version_check (bool, optional) – Option for disabling the version check. (Default value = False)

  • client (gql.Client, optional) – A GraphQL client that provides access to a Q-CTRL GraphQL endpoint. You can pass this parameter to use Q-CTRL features provided by a non-standard Q-CTRL API implementation, for example, one running locally or in a private cloud. If you pass this parameter, do not pass email, password, or api_root. (Default value = None)

  • verbosity (str, optional) – The verbosity of messages when running calculations. Possible values are: “VERBOSE” (showing task status messages and progress bars) and “QUIET” (not showing them). (Default value = “VERBOSE”)

  • organization (str, optional) – The organization slug to allocate tenant resources.

Variables:
Raises:

QctrlApiException –

Methods

activity_monitor

Prints a list of previously run actions to the console and their statuses.

cite

Prints the BibTeX information for citing Boulder Opal, with the possibility to save it into a BibTeX file.

create_graph

Creates a graph object for representing remote computations.

get_result

This function is used to return the results of a previously run function.

is_collecting

Checks if the object is in collection mode.

parallel

Context manager for executing multiple function calls in parallel.

request_machines

Requests a minimum number of machines to be online.

set_verbosity

Set the verbosity mode.

start_collection_mode

Starts collection mode.

stop_collection_mode

Stops collection mode.