Python und R Laufzeiten

Öffnen Sie Settings → Runtimes, um die Python- und R-Umgebungen auszuwählen, die für Notebooks und den Agenten verfügbar sind. Der Ready-Status einer Umgebung zeigt eine erfolgreiche Erkennung/Einrichtung an; Der Enable-Switch steuert die Verfügbarkeit für den Agenten separat.

Wählen Sie eine App-verwaltete Umgebung oder einen vorhandenen Interpreter. Überprüfen Sie den Pfad, die Version, den Ready-Zustand und den Schalter vor der Verwendung. System R und App-verwalteter R können nebeneinander existieren.

Plattform

macOSWindowsLinux

Ihre Wahl wird über Kapitel hinweg gehalten.

Wählen Sie eine Umgebung für Ihr Projekt

Geben Sie den Interpreternamen, den Pfad und die Version auf. Für eine erste Python-Analyse sollten Sie die isolierte App-verwaltete Umgebung bevorzugen, damit Paketänderungen eine nicht verwandte Forschungsumgebung nicht verändern. Überprüfen Sie Packages auf erforderliche Bibliotheken, bevor Sie die Installation anfordern. Eine erfolgreiche Paketauflistung ist eine Read-Only-Prüfung; es erteilt dem Agenten nicht die Erlaubnis, einen externen Dolmetscher zu modifizieren.

Unterscheiden Sie nach einem Ausführungsfehler einen nicht verfügbaren Interpreter, ein fehlendes Paket, eine abgelehnte Anforderung und einen Codefehler. Die Neuinstallation ist für eine defekte verwaltete Laufzeit geeignet, nicht für jede fehlgeschlagene Analyse. Wenn Sie ein Ergebnis reproduzieren müssen, behalten Sie die Eingabeversion und den Code zusammen mit den Laufzeitdetails bei.

Verstehen der Hauptkontrollen

Kontrolle	Zweck und Grenze
Recheck	Refresh entdeckte Dolmetscher und ihren Status. Das Panel zeigt die Last-Check-Zeit. Nicht verfügbar bei widersprüchlichen Setup-Arbeiten.
Network settings	Offene Konfiguration für Notebook-Netzwerkschutz. Das Banner erklärt, ob Sitzungen und Paket-Downloads auf genehmigte Domains beschränkt sind.
Let the Agent create environments	Kontrollieren Sie, ob der Agent Umgebungen erstellen und fehlende Laufzeiten einrichten kann. Wenn Sie dies deaktivieren, werden keine expliziten Benutzereinstellungen oder Reparaturkontrollen entfernt.
Add interpreter…	Öffnen Sie den systemausführbaren Picker für einen vorhandenen Interpreter. Wählen Sie die tatsächliche ausführbare Datei aus und bestätigen Sie dann den erkannten Pfad und den Ready-Status.
Download and set up	Bereiten Sie eine App-verwaltete Umgebung vor, wenn sie fehlt.
Cancel während des Aufbaus	Fordern Sie die Stornierung des laufenden Setups an. Warten Sie, bis sich die Operation erledigt hat, bevor Sie eine andere beginnen.
Retry setup	Versuchen Sie erneut ein erfolgloses Setup, nachdem Sie die Ursache behoben haben.
Aktivieren [Umwelt]	Stellen Sie die Umgebung für die Agentenauswahl zur Verfügung. Das Deaktivieren einer In-Use-Umgebung kann eine Aufprallbestätigung erfordern.
Allow package install	Separate Zustimmung für eine aktivierte externe Python- oder R-Umgebung. Die R-Zustimmung ist auf eine ausgewählte persönliche Bibliothek beschränkt. Listing-Pakete erfordern keine Installationsgenehmigung.
Pakete [count]	Öffnen Sie das Installationspaket-Inventar für diesen Interpreter.
Reinstall	Öffnen Sie die Bestätigung, bevor Sie eine App-verwaltete Umgebung neu erstellen.

Installieren einer App-verwalteten Umgebung

App-verwalteter Python installieren

1. Finde Python → App-managed environment.
2. Wählen Sie Download and set up.
3. Lesen Sie die Fortschrittsnachricht und warten Sie. Cancel wird verfügbar, während das Setup ausgeführt wird.
4. Beim Erfolg bestätigen Sie conda: Standard-Python, App-managed und Ready.
5. Überprüfen Sie den Interpreterpfad und den Conda aktivieren: Default-Python-Switch.

Bestätigen Sie Ready, den ausgewählten Interpreterpfad und den aktivierten Zustand. Paketanzahl und -versionen können je nach Installationsquelle variieren; Verwenden Sie den temporären Pfad des Screenshots nicht als permanenten Umgebungsstandort.

App-verwalteter R installieren

1. Öffnen Sie Settings → Runtimes und scrollen Sie zu R.
2. Wählen Sie unter App-managed environment Download and set up aus. Ein vorhandenes System R hindert Sie nicht daran, diese separate Umgebung zu installieren.
3. Warten Sie, bis der Download und die Erstellung der Umgebung abgeschlossen sind. Halten Sie die Anwendung offen und lesen Sie jeden Fehler, bevor Sie es erneut versuchen.
4. Bestätigen Sie conda: Standard-r, App-managed, Ready und einen aktivierten Switch.
5. Öffnen Sie Packages. Geben Sie r-base in Filter packages ein, um die installierte R-Version und den installierten Kanal zu überprüfen; Löschen Sie den Filter, um alle Pakete zu sehen.

Bestätigen Sie, dass das Filtern von r-base das installierte R-Paket mit seiner Version und seinem Kanal zurückgibt. Die Gesamtsumme des Pakets spiegelt Ihre Umgebung wider und kann vom Screenshot abweichen.

Verbinden Sie einen vorhandenen Interpreter

Verwenden Sie R bereits auf Ihrem Computer installiert

Wählen Sie Recheck und prüfen Sie den erkannten R-Pfad und die Version. Wenn Ihr Interpreter abwesend ist, verwenden Sie Add interpreter…, um die ausführbare Datei auszuwählen. Ready und Enable haben unterschiedliche Bedeutungen: Die Erkennung bestätigt, dass der Interpreter verfügbar ist; enableing macht es vom Agenten auswählbar.

In einem R Notebook überprüfen Sie R.home(), um die verwendete Umgebung zu bestätigen. Um Abhängigkeiten zu installieren, autorisieren Sie eine persönliche Bibliothek mit dem Externe R Installationsschritte.

Ein erkannter Pfad wie /opt/homebrew/bin/R identifiziert eine Systeminstallation.

Registrieren und Verwenden von externem Python

1. Bereiten Sie die Python-Umgebung vor, die Sie verwenden möchten.
2. Wählen Sie Add interpreter…, wählen Sie die ausführbare Python-Datei aus und überprüfen Sie Ready, den Pfad und die Version.
3. Verwenden Sie Recheck, um die Erkennung zu überprüfen, und aktivieren Sie dann diese bestimmte Umgebung.
4. Bitten Sie den Agenten, es explizit für den Notebook auszuwählen.
5. Drucken Sie sys.executable und die Python-Version, bevor Sie sich auf die installierten Bibliotheken verlassen.

Wenn ein Symlink-Interpreter im macOS-Datei-Picker nicht ausgewählt werden kann, wählen Sie die tatsächliche ausführbare Datei der beabsichtigten Umgebung aus. Bestätige sys.executable nach der Bindung. Verwenden Sie einen stabilen Installationspfad anstelle des temporären Beispielpfads des Screenshots.

Paketberechtigung und Installationsergebnis

Für ein neues Paket in einer externen Python-Umgebung, überprüfen Sie zuerst Allow package install. Warten Sie nach Erteilung der Genehmigung auf den Abschluss der Installation und überprüfen Sie den Import in derselben Umgebung, bevor Sie fortfahren.

Wenn die Installation 403 Forbidden oder destination resolves to a non-public network address meldet, prüfen Sie den betroffenen Hostnamen und folgen Sie Netzwerk, bevor Sie erneut versuchen. Diese Fehler betreffen den Netzzugang und beweisen nicht, dass das Paket nicht verfügbar ist. Halten Sie den Netzwerkschutz aktiviert.

Deaktivieren einer Umgebung, die von einem Notebook verwendet wird

Wählen Sie den Enable-Switch aus und lesen Sie die Anzahl der aktiven / leeren Kernel, bevor Sie bestätigen. Das Deaktivieren kann den Kernel schließen; Wählen Sie nach dem erneuten Aktivieren erneut eine verfügbare Laufzeit für die Sitzung aus. Dieses Panel bietet Aktivierungs- / Deaktivierungssteuerungen anstelle einer separaten Dolmetscher entfernen-Aktion.

Installieren Sie Pakete in externen R

Verwenden Sie dies, wenn Ihr vorhandener R-Interpreter funktioniert, aber ein zusätzliches Paket benötigt. Die App gewährt Installationszugriff auf eine vorhandene persönliche Bibliothek, nicht auf System- oder Site-Bibliotheken.

1. Aktivieren Sie in Settings → Runtimes die beabsichtigte externe R-Umgebung und bestätigen Sie deren Pfad/Version.
2. Überprüfen Sie unter Personal R package library den erkannten Standort oder wählen Sie eine berechtigte Bibliothek aus. Wenn keine erkannt wird, verwenden Sie Advanced options → Choose library folder…, um eine vorhandene beschreibbare persönliche Bibliothek auszuwählen, die für diesen R-Interpreter sichtbar ist. Diese Aktion erstellt keinen Ordner.
3. Allow package install aktivieren. Lesen Sie den ausgewählten Pfad vor der Autorisierung: Bei anderen Projekten, die diese Bibliothek verwenden, werden möglicherweise die installierten Paketänderungen angezeigt.
4. Fordern Sie das gewünschte Paket über den Paketverwaltungsvorgang der App an und benennen Sie diese R-Umgebung. Befolgen Sie das Installationsergebnis und alle Anweisungen zum Neustart des Kernels.
5. Führen Sie R.home(), .libPaths(), library(PACKAGE_NAME) und packageVersion("PACKAGE_NAME") in dieser Umgebung aus und ersetzen Sie den Paketplatzhalter. Bestätigen Sie, dass die beabsichtigte Bibliothek verwendet wird, bevor Sie die Analyse fortsetzen.

Deaktivieren Sie Allow package install, um die zukünftige Installationsgenehmigung zu widerrufen. Es deinstalliert keine bereits geschriebenen Pakete. Widerrufen Sie die Zustimmung, bevor Sie eine andere Bibliothek auswählen. Wenn kein berechtigter Ordner vorhanden ist, erstellen Sie eine persönliche R-Bibliothek außerhalb der App oder verwenden Sie eine von der App verwaltete Umgebung; Wählen Sie die Systembibliothek nicht aus, um eine fehlgeschlagene Überprüfung zu umgehen.

Pakete aus erfassten Schlössern wiederherstellen

Um ein gespeichertes Ergebnis zu erhalten, öffnen Sie Provenance → Environment und inspizieren Sie die erfasste Sperre. Verwenden Sie Download bundle, wenn angeboten. Lesen Sie die Anweisungen und Voraussetzungen des Pakets, bevor Sie etwas wiederherstellen.

Externes R erfordert eine verfügbare renv-Installation und ein unterstütztes renv.lock; Externes Python benötigt eine bestehende unterstützte Anforderungssperre mit Pinned Hashes. Ein Dolmetscherpfad und eine Liste von Paketnamen allein reichen nicht aus. Die erfassten Interpreter-, Plattform-, Architektur- und Paketmanager-Anforderungen müssen der Wiederherstellungsumgebung entsprechen.

Extrahieren Sie das Paket, wählen Sie ein neues beschreibbares Ziel, das Sie besitzen, und führen Sie das enthaltene restore-packages.py mit dem tatsächlichen Interpreter und Zielpfaden aus, indem Sie die gebündelten Anweisungen befolgen. Das Skript prüft Voraussetzungen und Prüfsummen, bevor es Pakete wiederherstellt, und überprüft dann deren effektive Versionen und Pfade. Wenn eine Überprüfung fehlschlägt, lösen Sie diese Bedingung, anstatt die Sperre zu bearbeiten, um den Erfolg zu erzwingen. Open-Science übernimmt oder löscht dieses externe Ziel nicht.

Dies ist eine bedingte Paketwiederherstellung, kein Klon mit vollständiger Umgebung. Öffnen Sie das Ergebnis erneut und verwenden Sie Reproduzierbarkeit, wenn ein unterstütztes erfasstes Rezept zum Vergleichen von Ausgaben verfügbar ist.

Prüfen Sie installierte Pakete

Wählen Sie Packages auf der beabsichtigten Python-Karte. Der Dialog zeigt den Pfad, die Paketquelle und den Status dieser Umgebung an.

Geben Sie einen Paketnamen wie numpy in Filter packages ein, überprüfen Sie die Version und den Kanal und löschen Sie dann den Filter, um die Liste wiederherzustellen. Verwenden Sie Close, um zurückzukehren.

Die Tabellenspalten sind Name, Version, Build und Channel. Ein Dash in Build bedeutet, dass kein Build-Wert angezeigt wird. Dieser Dialog ist ein Inventar: Es gibt keine Schaltflächen zum Installieren oder Deinstallieren von Paketen. Suchen Sie nicht nach einem „Paket installieren-Feld in diesem Dialog.

Überprüfen Sie die Umwelt mit einer echten Analyse

Führen Sie eine kleine Berechnung in der ausgewählten Umgebung aus, öffnen Sie die Ausgabe erneut und vergleichen Sie sie mit dem Gemeinsame Baseline. Folgen Sie R Notebook für Ausführung und Export.

Der Workflow in Datenqualität bietet eine Python-Route unter Verwendung vorhandener Abhängigkeiten. Eine erfolgreiche Berechnung zeigt nicht, dass neue Pakete installiert oder ein Kernel neu gestartet werden können.

Wenn ein Import fehlschlägt, überprüfen Sie die ausgewählte Laufzeit und die installierten Pakete. Für einen Download, der abgelehnt wurde, weil ein Hostname zu einer reservierten Adresse aufgelöst wird, folgen Sie Netzwerk. Durch das Ausführen von Code mit vorhandenen Paketen wird nicht festgelegt, dass zusätzliche Pakete installiert werden können.

Überprüfen Sie vor einer anderen Analyse die erforderlichen Pakete in der ausgewählten Umgebung. Verwenden Sie bei Bedarf den unterstützten Paketverwaltungsvorgang, lesen Sie das tatsächliche Ergebnis, befolgen Sie alle Neustartanforderungen und überprüfen Sie den Import. Eine Berechtigungsgenehmigung, eine Fortschrittskarte oder ein Ready-Interpreter ist kein Importtest.

Um ein gespeichertes Ergebnis mit unvollständigen Umgebungs- oder Ausführungsnachweisen zu erhalten, öffnen Sie Provenance und prüfen Sie die fehlenden Informationen. Um eine neue Version für eine Reproduzierbarkeitsprüfung vorzubereiten, folgen Sie Vorbereitung der Umgebung. Die Übereinstimmung mit einem numerischen Ergebnis füllt die fehlende Herkunft nicht aus.

Bestätigen Sie den aktiven Dolmetscher

Nachdem Sie Python oder R vorbereitet haben, führen Sie die folgenden Befehle in der entsprechenden Notebook-Sprache aus, um die tatsächliche Version und den Pfad zu überprüfen. Einstellungen können mehrere Umgebungen auflisten; Verwenden Sie die Ausgabe des aktuellen Laufs, um den verwendeten zu identifizieren.

Python:

import sys
print(sys.version)
print(sys.executable)

R:

R.version.string
R.home()

Lesen Sie als nächstes eine kleine Projekttabelle, überprüfen Sie die Anzahl der Zeilen und speichern Sie das Ergebnis. Nach dem erneuten Öffnen der App führen Sie den Check erneut aus, bevor Sie eine Analyse fortsetzen. Ein lesbarer historischer Bericht bedeutet nicht, dass die vorherigen In-Memory-Variablen noch existieren. Siehe Notebook und Ausführungsnachweise für Notebook-Steuerelemente.

Wartung und Reparatur von Umgebungen

Setup und Retry abbrechen

Während Download and set up, wählen Cancel und warten auf Runtime Setup abgesagt. Wählen Sie Retry setup, warten Sie auf Ready und öffnen Sie Packages, um die Umgebung zu inspizieren. Starten Sie kein zweites Setup, während sich der erste Vorgang noch erledigt.

Installieren einer verwalteten Umgebung

1. Speichern Sie benötigte Berichte und notieren Sie alle Pakete, die Sie hinzugefügt haben.
2. Wählen Sie Reinstall in der vorgesehenen verwalteten Umgebung aus.
3. Lesen Sie den Aufprallhinweis und wählen Sie dann Reinstall runtime.
4. Warten Sie auf Ready und prüfen Sie Packages.
5. Starten Sie eine neue Notebook-Zelle und öffnen Sie Ihre gespeicherten Ein- und Ausgänge erneut.

Die Neuinstallation löscht und erstellt die Umgebung neu. Bei der ausgeübten Wiederherstellung wurde eine aktive Zelle mit Run canceld: Die Laufzeit wurde gestoppt, während diese Zelle ausgeführt wurde. abgebrochen Die alte Notebook-Historie blieb sichtbar, aber ihr Namespace existierte nicht mehr. Eine neue Zelle bestätigte, dass eine frühere Variable fehlte; Der unveränderte CSV gab immer noch 12-Zeilen zurück und 269,027,617 zählt, und der gespeicherte Bericht wurde wieder geöffnet.

Behaltene Dateien und beibehaltener Kernelspeicher sind unterschiedlich. Erstellen Sie Variablen, indem Sie den erforderlichen Code erneut ausführen. Zusätzliche Pakete müssen möglicherweise neu installiert werden; Eine erfolgreiche Wiederherstellung der Basisumgebung stellt nicht die Wiederherstellung jeder zusätzlichen Abhängigkeit dar.

Development Build: Micromamba nicht gefunden

Der erste Versuch im Quell-Build scheiterte vor der Bereitstellung, weil der Entwicklungsprozess Micromamba nicht lokalisieren konnte.

Die verpackte Anwendung enthält diese Binärdatei. Punkt OPEN_SCIENCE_MICROMAMBA_BIN für einen Quellaufbau auf eine gültige Mikromamba-Ausführbarkeit in der Startumgebung dieses Prozesses und Neustart der Entwicklungsinstanz. Verwenden Sie den binären Pfad von einer kompatiblen Installation und bestätigen Sie, dass er vor dem Neustart ausführbar ist.

Diese Umgebungsvariable ist ein Entwicklungs-Setup-Detail, kein Feld auf der Laufzeitseite. Löschen Sie kein Umgebungsverzeichnis, um diesen Entdeckungsfehler zu umgehen.