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.

Name your sessions before launching the analysis—it significantly improves searchability. The Name and Project fields are the only searchable fields available in the session list.

Consulting Sessions

GET /api/prospection/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:

GET /api/prospection/sessions/{id}

To delete a session (irreversible):

DELETE /api/prospection/sessions/{id}

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"]])

See Python Integration for authentication token management and other examples of session exploitation.

Data Location

Prospection sessions are stored in:

AppData\Local\IsoFind\workflows.db → Table prospection_sessions

This database is included in standard IsoFind backups. See Backing Up and Restoring the Database.