Analysis Sessions
Every analysis launched in the Prospection module is automatically saved as a session. Sessions allow you to retrieve previous work contexts, compare successive analyses on the same borehole, and access results via Python scripts.
Automatic Saving
As soon as an analysis is successfully executed, a session is created in workflows.db. No action is required. The session contains all entered values and calculated results.
Consulting Sessions
| Parameter | Default | Description |
|---|---|---|
| limit | 20 | Number of returned sessions. |
| offset | 0 | Offset for pagination. |
To retrieve full inputs and results for a specific session:
To delete a session (irreversible):
Session Statuses
| Status | Meaning |
|---|---|
| done | Analysis calculated and full results available. |
| pending | Session created without calculation (advanced API use case). |
| error | Error during calculation. Inputs are preserved. |
Python Example - Exporting Sessions to a DataFrame
import requests
import pandas as pd
BASE = "http://127.0.0.1:8001"
HEADERS = {"X-IsoFind-Token": "<your_token>"}
# Retrieve all sessions (automatic pagination)
sessions, offset = [], 0
while True:
data = requests.get(
f"{BASE}/api/prospection/sessions",
params={"limit": 50, "offset": offset},
headers=HEADERS
).json()
sessions.extend(data["sessions"])
if len(sessions) >= data["total"]: break
offset += 50
df = pd.DataFrame(sessions)
df = df[df["project"] == "Andes Campaign 2025"]
df = df.sort_values("score_global", ascending=False)
print(df[["name", "score_global", "best_match", "maturity_stage"]])
Data Location
Prospection sessions are stored in:
This database is included in standard IsoFind backups. See Backing Up and Restoring the Database.
