Chris.Hansen: /* 4. Prediction Client (AutoML Predictions) */

2024-09-13T17:11:19Z

4. Prediction Client (AutoML Predictions)

← Older revision		Revision as of 17:11, 13 September 2024
Line 68:		Line 68:
	# Fetch a prediction using input data		# Fetch a prediction using input data
	input_data = {"feature1": 1.5, "feature2": 3.4}		input_data = {"feature1": 1.5, "feature2": 3.4}
	predicted_value = predictions.fetch("~~model_id~~", input_data)		predicted_value = predictions.fetch("configuration_id", input_data)

	# Fetch multiple predictions		# Fetch multiple predictions
	input_data_list = [{"feature1": 1.5, "feature2": 3.4}, {"feature1": 2.1, "feature2": 4.0}]		input_data_list = [{"feature1": 1.5, "feature2": 3.4}, {"feature1": 2.1, "feature2": 4.0}]
	predicted_values = predictions.fetch("~~model_id~~", input_data_list)		predicted_values = predictions.fetch("configuration_id", input_data_list)

	# Print predictions		# Print predictions

Chris.Hansen: Created page with "The Foji Python client is designed to interact with various services within the FojiSoft application suite, including relational data access, metric services, dataset management, and predictive analytics. This guide explains how to use key methods available for these functionalities in Notebook Servers. ==== Installation ==== The `foji` package is already available in your Notebook Server. ==== Key Components ==== The "Foji" Python client consists of four pr..."

2024-09-13T17:09:49Z

Created page with "The Foji Python client is designed to interact with various services within the FojiSoft application suite, including relational data access, metric services, dataset management, and predictive analytics. This guide explains how to use key methods available for these functionalities in Notebook Servers. ==== Installation ==== The <code>foji</code> package is already available in your Notebook Server. ==== Key Components ==== The "Foji" Python client consists of four pr..."

New page

The Foji Python client is designed to interact with various services within the FojiSoft application suite, including relational data access, metric services, dataset management, and predictive analytics. This guide explains how to use key methods available for these functionalities in Notebook Servers.

==== Installation ====
The <code>foji</code> package is already available in your Notebook Server.

==== Key Components ====
The "Foji" Python client consists of four primary modules that facilitate the following tasks:

# '''Relational (ClickHouse Client)''': Execute queries against a relational data store.
# '''Metrics (Cortex Client)''': Fetch real-time and time-series metrics from the Cortex service.
# '''DataSets''': Fetch datasets from the Forge AI platform.
# '''Predictions (AutoML Client)''': Retrieve predictions from pre-trained Forge AI models.

==== How to Use ====

===== 1. ClickHouse Client (Relational Data Access) =====
The ClickHouse client provides access to a relational data store using SQL queries. It also supports date parsing.<syntaxhighlight lang="python">
from foji import relational

# Execute a SQL query with optional parameters
query = "SELECT * FROM users WHERE age > {age:Int32}"
params = {"age": 25}
results = relational.query(query, params)

# Print results
for row in results:
print(row)
</syntaxhighlight>'''Key Method''':

* <code>query(query: str, params: dict[str, Any] = None) -> list[dict]</code>: Executes an SQL query with optional parameters and returns the results as a list of dictionaries.

===== 2. Cortex Client (Metrics Service) =====
The Cortex client provides interfaces to query real-time and historical metrics using the Cortex API.<syntaxhighlight lang="python">
from foji import metrics

# Query for an instant metric value
result = metrics.instant("up")

# Query for a range of metrics
result_range = metrics.range("up", "2023-01-01T00:00:00Z", "2023-01-01T01:00:00Z", "60s")

# Print results
print(result)
print(result_range)
</syntaxhighlight>'''Key Methods''':

* <code>instant(query: str, time: int | str = None) -> CortexResult</code>: Queries metrics at a specific point in time.
* <code>query(query: str, time: int | str = None) -> CortexResult</code>: Queries metrics at a specific point in time.
* <code>range(query: str, start: int | str, end: int | str, step: float | str = None) -> CortexResult</code>: Queries time-series metrics for a given time range.

===== 3. DataSets Client (Dataset Management) =====
The DataSets client allows you to fetch datasets stored within Foji.<syntaxhighlight lang="python">
from foji import dataSets

# Fetch a dataset by its ID
data = dataSets.fetch("dataset_id", "2023-01-01T00:00:00Z", "2023-01-01T01:00:00Z", "60s")

# Print data
print(data)
</syntaxhighlight>'''Key Method''':

* <code>fetch(id: str, start: str, end: str, step: str = "1m") -> list[dict[str, Any]]</code>: Fetches data from a Data Set

===== 4. Prediction Client (AutoML Predictions) =====
The Predictions client enables you to retrieve predictions from pre-trained Forge AI models.<syntaxhighlight lang="python">
from foji import predictions

# Fetch a prediction using input data
input_data = {"feature1": 1.5, "feature2": 3.4}
predicted_value = predictions.fetch("model_id", input_data)

# Fetch multiple predictions
input_data_list = [{"feature1": 1.5, "feature2": 3.4}, {"feature1": 2.1, "feature2": 4.0}]
predicted_values = predictions.fetch("model_id", input_data_list)

# Print predictions
print(predicted_value)
for prediction in predicted_values:
print(prediction)
</syntaxhighlight>'''Key Method''':

* <code>fetch(id: str, data: dict | list[dict]) -> float | str | list[Prediction]</code>: Fetches single or multiple predictions based on the input data.

==== Conclusion ====
The "Foji" Python client provides seamless integration with Foji services, enabling efficient access to relational data, metrics, datasets, and prediction models. By leveraging these key methods, you can streamline data processing and predictive analysis within the Forge AI Notebook Server environment.
[[Category:ForgeAI]]

Using the Foji Python Client in Notebook Servers - Revision history

Chris.Hansen: /* 4. Prediction Client (AutoML Predictions) */