novainsilico/jinko-skills

jinko-data-table

Create or inspect Jinkō data tables via the jinko-sdk.

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/novainsilico/jinko-skills --skill jinko-data-table

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

Jinkō Data Table SDK Workflows

Use this skill for data-table mechanics through the SDK. Data tables can support trial overlays and calibration objectives; the row schema is the same, and fitness-function compatibility is reported by metadata when available.

PREREQUISITE: This skill needs an initialized jinko-sdk connection and an SDK satisfying its metadata.requires_sdk range. Run the jinko-sdk-setup skill (../jinko-sdk-setup/SKILL.md) and proceed only once its check passes. Use JINKO_API_KEY when it is set. Only without a key, call get_session_code again before this skill's own SDK process, because a session code can be exchanged only once. If that skill is not found, install it from novainsilico/jinko-skills.

Scope

  • Use client.create_data_table_from_csv() for CSV files or bytes.
  • Use client.create_data_table_from_sqlite() for SQLite files or bytes.
  • Use client.create_data_table_from_dataframe() for pandas DataFrames.
  • Inspect existing data tables with get_data_table(), content(), summary(), validate(), and export().
  • Update an existing data table with data_table.replace_csv(...), data_table.replace_sqlite(...), or data_table.update_mappings(...). See "Update an existing data table".
  • Check metadata.public.validForFitnessFunction after creation or inspection when available if the data table needs to be attached through trial/calibration dataTableDesigns.
  • For trial workflows that attach data tables through jinko-trial, use a data table with validForFitnessFunction: True; point-value overlay tables may upload successfully but fail trial launch sanity.

Update an existing data table

When you correct or extend the observed data of the same experiment, update the existing data table. Do not create a new data table for each attempt.

  • data_table.replace_csv(csv_text, version="<short name>") replaces the data with new CSV content. replace_sqlite(sqlite_bytes, version=...) does the same for SQLite. The SID, mappings, and earlier versions stay.
  • data_table.update_mappings(mappings, version=...) changes only the mappings.
  • Check metadata.public.validForFitnessFunction again after the update.
  • A Trial or Calibration keeps the data-table Snapshot that it was given. Call trial.set_components(data_tables=[data_table], version=...) or the same method on the Calibration to use the new version. data_tables replaces the complete list.
  • Create a new data table only for a different dataset, for example another study or endpoint.

Project Folder Hygiene

  • Prefer creating data tables inside a dedicated Jinkō folder instead of the project root. At the start of a workflow, ask for or propose a folder name, for example YYYY-MM-DD-<experiment-name>.
  • Reuse an existing exact-match folder when possible: client.get_folder_by_name(name, exact_match_only=True).
  • If the folder does not exist, create it only after user confirmation or when a script is run with --apply.
  • Resolve one folder object or folder id, then pass folder=folder to SDK creation calls that support it.

Row Schema

Read assets/data-table.json before changing CSV structure.

Supported row shapes:

  • Point-value row: obsId, time, value, plus optional unit, armScope, ranges, weight, and reference.
  • Range row: obsId, time, narrowRangeLowBound, narrowRangeHighBound, plus optional unit, armScope, wide ranges, weight, and reference.

Use ISO-8601 duration strings for time, for example PT0S, PT6H, or P1D.

Bundled Assets

  • assets/toy_data_table_values.csv: point-value observations for trial overlays.
  • assets/toy_data_table_ranges.csv: range observations suitable for calibration objective workflows.
  • assets/data-table.json: schema subset for supported data-table rows.

SDK Scripts

These are on PATH as console scripts once the SDK is installed, and also runnable via python -m as shown below.

  • jinko.cli.create_data_table: dry-run-validates every CSV row and creates a

data table with --apply; use --allowed-obs-id, --require-unit, --require-experiment-ref, and --require-fitness for calibration inputs.

  • jinko.cli.create_data_table --data-table-sid dt-...: replaces the data of

an existing data table and saves a new version named with --version-name. It runs the same row checks.

  • jinko.cli.inspect_data_table: inspects existing data tables and can enforce

fitness compatibility with --require-fitness.

Examples:

bash
python -m jinko.cli.create_data_table --source skills/jinko-data-table/assets/toy_data_table_ranges.csv --method csv
python -m jinko.cli.create_data_table --source extracted.csv --allowed-obs-id Drug --require-unit --require-experiment-ref --require-fitness --apply
python -m jinko.cli.create_data_table --source skills/jinko-data-table/assets/toy_data_table_ranges.csv --method csv --apply
python -m jinko.cli.create_data_table --source skills/jinko-data-table/assets/toy_data_table_ranges.csv --method csv --folder 2026-06-15-fit-data --create-folder --apply
python -m jinko.cli.create_data_table --source skills/jinko-data-table/assets/toy_data_table_values.csv --method dataframe --apply
python -m jinko.cli.create_data_table --source corrected.csv --data-table-sid dt-... --version-name "fix Drug units" --require-fitness --apply
python -m jinko.cli.inspect_data_table --data-table-sid dt-... --fitness --validate

Reference Routing

  • Read references/data-table-schema.md for row shape and fitness-function notes.
  • Read assets/data-table.json when checking required columns.
aus demselben Repository

Weitere Skills

Alle Skills
novainsilico
Community

jinko-sdk-setup

Authenticate and configure access to a Jinkō project via the jinko-sdk. Use this skill whenever the user wants to connect to Jinkō, install the SDK, set up credentials or a .env file, verify API access, fail-fast check that a JINKOAPIKEY (preferred) or a JINKOSESSIONCODE works, choose the JINKOPROJECTID when the key reaches several projects, obtain a session code from the Jinko MCP getsessioncode tool when no API key is set, tell a project key from an organization key, choose between JinkoClient

Installationen / 1h
2
GitHub Stars
4
Aktualisiert
16. Nov.
novainsilico
Community

jinko-task-cmaes

Execute a CMA-ES calibration from confirmed Jinkō inputs: assemble the model, protocol, output sets, fitness data tables, parameter priors, and optimizer options; create and run the Calibration; and return the supported results. Optionally, on request, qualify the parameter uncertainty of a completed CMA-ES calibration: identifiability, compensations, and prediction bands, in a Jinkō document. Use when the user wants to perform a CMA-ES calibration, or to check which calibrated parameters the da

Installationen / 1h
2
GitHub Stars
4
Aktualisiert
16. Nov.
novainsilico
Community

jinko-context

Explain core Jinkō context, navigation, version management, and domain language for agents and users. Use this skill whenever the user needs a mental model of Jinkō projects, folders, project items, snapshots, references, extracts, highlights, protocols, trials, calibration, virtual populations, traceability links, or modeling context; when translating between generic terms and Jinkō terminology; or when an agent needs orientation before navigating or modifying Jinkō artifacts. It includes a saf

Installationen / 1h
1
GitHub Stars
4
Aktualisiert
16. Nov.
novainsilico
Community

jinko

- Discover and route Jinkō QSP and mechanistic-modeling requests to the public Jinkō skill that owns the work. Use when the user is starting a Jinkō session, asks what capability or skill to use, describes a multi-area modeling request, or has not yet identified the relevant jinko- or jinko-task- skill. This skill does not make scientific decisions, plan workflows, execute SDK calls, or decide that a task step is complete.

Installationen / 1h
1
GitHub Stars
1
Aktualisiert
7. Sept.