Feature/issue/4

[Dirack]

📤 Pull Request

Descrição

Programa para gerar os arquivos de interfaces lidos pelo programa geomodel no formato '.itf'.

Resolve #4

Tipo da modificação

• Correção de Bug (modificação que corrige uma problema)
• Nova feature (modificação que adiciona uma funcionalidade)
• Atualização de documentação
• Outros (Descrever aqui)

Adicione imagens abaixo e o contexto se necessário

O programa interfaceBuilder tem as seguintes opções:

• -h --help Exibe essa tela de ajuda e sai
• -v --version Exibe a versão do programa e sai
• -c --create Criar um novo modelo
• -a --add Adicionar interface
• -s --see Ver interfaces geradas
• -r --remove Remover última interface

O usuário poderá criar um novo arquivo de interfaces do zero com o seguinte comando:

~$ interfaceBuilder -c arquivo.itf

Este comando cria o arquivo de interfaces 'arquivo.itf' a partir de parâmetros do modelo solicitados ao usuário no momento da criação do modelo.

O comando a seguir cria uma nova interface:

~$ interfaceBuilder -a <arquivo.itf> x=x1,x2,x3...xn y=y1,y2,y3...yn sfill=p1,s1

Esta nova interface é criada abaixo da última interface do 'arquivo.itf', estas duas interfaces formarão uma camada com slooth (1/v²) de vallor s1. O ponto p1 é um ponto na camada (entre as duas interfaces) para o programa atribuir o valor s1.

O usuário poderá visualizar as informações do arquivo de interfaces com a opção -s:

~$ interfaceBuilder -s <arquivo.itf>

A opção para remover a última interface é -r a seguir:

~$ interfaceBuilder -r <arquivo.itf>

Esta opção remove sempre a última interface da pilha (a última interface do arquivo). Não é permitido remover a primeira interface do modelo (esta é a superfície de aquisição, definida no momento da criação do modelo com a opção -a)

Os arquivos '.itf' manipulados por este programa são arquivos de texto normais e podem ser editados manualmente pelo usuário. Este tipo de arquivo é um parser para o programa geomodel e
estabelece as interfaces no formato lido pelo programa triseis do SU que realiza a modelagem através do traçamento do raio.

Este programa facilita o processo de escrita dos arquivos '.itf'.
A seguir um exemplo de arquivo .itf criado e editado por este programa (Modelo com apenas duas interfaces):

# Arquivo de interfaces para o programa geomodel
# As linhas iniciadas com '#' serão ignoradas!
# As linhas marcadas '< >' representam entradas de
# parâmetros dos programas 

# Parâmetros do spsplot para gerar uma imagem eps do modelo
<sp>
gedge=0.5 gtri=2.0 gmin=0.2 gmax=1.0
titlesize=20
labelsize=18 dxnum=1.0 dznum=0.5 wbox=15 hbox=8
title="Modelo de camadas curvas"
labelz="Profundidade (km)" labelx="Distancia (km)"
</sp>

# Parâmetros do programa trimodel
<tm>
xmin=0 zmin=0 xmax=12.0 zmax=3.5 
1 xedge=0,2,4,6,8,10,12 
zedge=0,0,0,0,0,0,0 
sedge=0,0,0,0,0,0,0 
2 xedge=0,2,4,8,10,12
zedge=3.5,3.5,3.5,3.5,3.5,3.5
sedge=0,0,0,0,0,0
sfill=0,1.0,0,0,0.3,0,0
kedge=1,2
</tm>

Esta modificação contém uma suíte de testes que roda a partir de um Makefile, demonstrando como o programa funciona. Basta rodar o Seguinte comando:

~$ make test

Também possui alguns exemplos de arquivos .itf no diretório 'su_test_models' que podem ser carregados e visualizados pelo interfaceBuiler, exemplo:

~$ ./interfaceBuilder ./su_test_models/modelo.itf