Condividi tramite


Come convertire un file SEG-Y in oVDS

Questo articolo illustra come convertire i dati formattati SEG-Y nel formato OVDS (Open VDS). I dati sismici archiviati nel formato SEG-Y standard del settore possono essere convertiti in formato oVDS per l'uso nelle applicazioni tramite il SERVIZIO DMS Seismic. Per la community OSDU®, vedere qui: Conversazione da SEG-Y a oVDS. Questa esercitazione è un'indicazione dettagliata su come eseguire la conversione. Si noti che il flusso di lavoro di produzione effettivo può variare e usarlo come guida per il set di passaggi necessario per ottenere la conversione.

Prerequisiti

Ottenere i dettagli dell'istanza di Data Manager di Azure per l'energia

Il primo passaggio consiste nell'ottenere le informazioni seguenti dall'istanza di Data Manager di Azure per l'energia nel portale di Azure:

Parametro Valore Esempio
client_id ID applicazione (client) 00001111-aaaa-2222-bbbb-3333cccc44444
client_secret Segreti client _fl******************
tenant_id ID della directory (tenant) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Partizioni dati <data-partition-name>

Queste informazioni verranno usate più avanti nell'esercitazione.

Impostazione di Postman

Successivamente, configurare Postman:

  1. Scaricare e installare l'app desktop Postman.

  2. Importare i file seguenti in Postman:

    Per importare i file:

    1. Selezionare Importa in Postman.

    Screenshot che mostra il pulsante di importazione in Postman.

    1. Incollare l'URL di ogni file nella casella di ricerca.

    Screenshot che mostra l'importazione di file di raccolta e ambiente in Postman tramite URL.

  3. Nell'ambiente Postman aggiornare VALORE CORRENTE con le informazioni fornite dall'istanza di Data Manager di Azure per l'energia

    1. In Postman, nel menu a sinistra, selezionare Ambienti e quindi selezionare SEGYtoVDS Environment (Ambiente SEGYtoVDS).

    2. Nella colonna VALORE CORRENTE, immettere le informazioni descritte nella tabella in 'Ottenere i dettagli dell'istanza di Azure Data Manager for Energy'.

    Screenshot che mostra dove immettere i valori correnti nell'ambiente SEGYtoVDS.

Procedura dettagliata per convertire il file SEG-Y in oVDS

La raccolta Postman fornita include tutte le chiamate di esempio da usare come guida. È anche possibile recuperare il comando URL equivalente per una chiamata Postman facendo clic sul pulsante Codice.

Screenshot che mostra il pulsante Codice in Postman.

Screenshot della creazione di un tag legale.

Preparare i file del set di dati

Questo file contiene il mapping di intestazione vettoriale di esempio e questo file contiene i record di archiviazione di esempio per la conversione VDS.

Token accesso

L'utente deve far parte del gruppo users.datalake.admins. Convalidare i diritti correnti per l'utente usando la chiamata seguente:

Screenshot che mostra la chiamata API per ottenere i gruppi di utenti in Postman.

Più avanti in questa esercitazione è necessario almeno uno owner e almeno un viewer. Questi gruppi di utenti hanno un aspetto simile a data.default.owners e data.default.viewers. Assicurarsi di annotare uno di ognuno di essi nell'elenco.

Se l'utente non fa parte del gruppo richiesto, è possibile aggiungere il diritto richiesto usando la chiamata di esempio seguente: email-id: è il valore "ID" restituito dalla chiamata precedente.

Screenshot che mostra la chiamata API per ottenere la registrazione di un utente come amministratore in Postman.

Se non sono ancora stati creati gruppi di diritti, seguire le istruzioni descritte in Come gestire gli utenti. Per visualizzare i gruppi disponibili, usare Ottieni gruppi di diritti per un determinato utente. L'isolamento dell'accesso ai dati viene ottenuto con questo ACL dedicato (elenco di controllo di accesso) per oggetto all'interno di una determinata partizione di dati.

Preparare un sottoprogetto

1. Registrare la partizione di dati in Seismic

Screenshot che mostra la chiamata API per registrare una partizione di dati come tenant sismico in Postman.

2. Creare un sottoprogetto

Usare i gruppi di diritti creati in precedenza da aggiungere come amministratori e visualizzatori ACL (elenco di controllo di accesso). I diritti di partizione dati non vengono necessariamente convertiti nei sottoprogetti al suo interno, quindi è importante essere espliciti sugli ACL per ogni sottoprogetto, indipendentemente dalla partizione di dati in cui si trova.

Screenshot che mostra la chiamata API per creare un sottoprogetto sismico in Postman.

3. Creare un set di dati

Nota

Questo passaggio è obbligatorio solo se non si usano sdutil per caricare i file sismici.

Screenshot che mostra la chiamata API per creare un set di dati sismico in Postman.

Caricare il file

Esistono due modi per caricare un file SEGY. Un'opzione consiste nell'usare il sasurl tramite postman/curl call. È necessario scaricare Postman o configurare Curl nel sistema operativo. Il secondo metodo consiste nell'usare SDUTIL. Per accedere all'istanza di ADME tramite lo strumento è necessario generare un token di aggiornamento per l'istanza. Vedere Come generare token di autenticazione. In alternativa, è possibile modificare il codice di SDUTIL in modo da usare le credenziali client per l'accesso. Se non è già stato fatto, è necessario configurare SDUTIL. Scaricare la codebase e modificare config.yaml nella radice. Sostituire il contenuto di questo file di configurazione con il codice yaml seguente.

seistore:
    service: '{"azure": {"azureEnv":{"url": "<instance url>/seistore-svc/api/v3", "appkey": ""}}}'
    url: '<instance url>/seistore-svc/api/v3'
    cloud_provider: azure
    env: glab
    auth-mode: JWT Token
    ssl_verify: false
auth_provider:
    azure: '{ 
        "provider": "azure", 
        "authorize_url": "https://login.microsoftonline.com/", "oauth_token_host_end": "/oauth2/v2.0/token", 
        "scope_end":"/.default openid profile offline_access",
        "redirect_uri":"http://localhost:8080",
        "login_grant_type": "refresh_token",
        "refresh_token": "<RefreshToken acquired earlier>" 
        }'
azure:
    empty: none

Metodo 1: Postman

Ottenere il sasurl:

Screenshot che mostra la chiamata API per ottenere un URL di caricamento GCS in Postman.

Caricare il file:

È necessario selezionare il file da caricare nella sezione Corpo della chiamata API.

Screenshot che mostra la chiamata API per caricare un file in Postman.

Screenshot che mostra la chiamata API per caricare un file binario in Postman.

Verificare il caricamento

Screenshot che mostra la chiamata API per verificare che un file binario sia caricato in Postman.

Metodo 2: SDUTIL

sdutil è un'utilità desktop OSDU per accedere al servizio sismico. Viene usato per caricare/scaricare file. Usare il tag azure-stable di SDUTIL.

Nota

Quando si esegue python sdutil config init, non è necessario immettere alcun elemento quando richiesto con Insert the azure (azureGlabEnv) application key:.

python sdutil config init
python sdutil auth login
python sdutil ls sd://<data-partition-id>/<subproject>/

Caricare il file sismico nell'archivio Sismico. Ecco un esempio con un file in formato SEGY denominato source.segy:

python sdutil cp <local folder>/source.segy sd://<data-partition-id>/<subproject>/destination.segy

Ad esempio:

python sdutil cp ST10010ZC11_PZ_PSDM_KIRCH_FULL_T.MIG_FIN.POST_STACK.3D.JS-017536.segy sd://<data-partition-id>/<subproject>/destination.segy

Creare il mapping dei vettori di intestazione

Generare il mapping del vettore di intestazione

Screenshot che mostra la chiamata API per creare il mapping del vettore di intestazione in Postman.

Creare record di archiviazione

Screenshot che mostra la chiamata API per creare record di archiviazione in Postman.

Run Converter

  1. Attivare il dag di conversione VDS per convertire i dati usando i valori del contesto di esecuzione salvati in precedenza.

    Recuperare il token ID da sdutil per il file caricato o usare un token di accesso/connessione da Postman.

python sdutil auth idtoken

Screenshot che mostra la chiamata API per avviare il flusso di lavoro di conversione in Postman.

  1. Consentire l'esecuzione del dag allo stato succeeded. È possibile controllare lo stato usando la chiamata di stato del flusso di lavoro. L'ID esecuzione si trova nella risposta della chiamata precedente

Screenshot che mostra la chiamata API per controllare lo stato del flusso di lavoro di conversione in Postman.

  1. È possibile verificare se il file convertito è presente usando il comando seguente in sdutil o nella chiamata API Postman:

    python sdutil ls sd://<data-partition-id>/<subproject>
    

Screenshot che mostra la chiamata API per verificare se il file è stato convertito.

  1. Verificare che i file convertiti siano presenti nel percorso specificato nel trigger DAG o meno

    python sdutil ls sd://<data-partition-id>/<subproject>/
    
  2. Se si vuole scaricare ed esaminare i file VDS, non usare il cp comando perché non funzionerà. La conversione VDS comporta più file, pertanto il cp comando non sarà in grado di scaricarli tutti in un unico comando. Usare invece lo strumento SEGYExport o VDSCopy . Questi strumenti usano una serie di chiamate REST che accedono a uno schema di denominazione per recuperare informazioni su tutti i file VDS risultanti.

OSDU® è un marchio di The Open Group.

Passaggi successivi