====== SOD/Breqfast: Guia de Uso ====== ===== SOD Comand Line Tools (CLT's) ===== **SUGESTÃO:** antes de realizar qualquer tarefa com o SOD/BreqFast crie um diretório de trabalho. Essa prática ajuda a manter organizados seus arquivos de dados, visto que o SOD cria logs e outros arquivos secundários. ==== Ferramentas: ==== === find_events --> retorna uma lista de eventos de acordo com as opções selecionadas === $ find_events --help ^ Atributo ^ Descrição ^ | -v | Print SOD's version and exit | | -r | Print the created recipe to stdout instead of running it | | -p | Use an additional props file | | --allow-duplicates | Without this, very similar events are rejected | | -S / | The event server to use | | -R / | Event constraining box as west/east/south/north | | -d / | Event constraining donut as lat/lon/minRadius/maxRadius | | -b / | The earliest time for an accepted event | | -e / | The latest time for an accepted event | | -m / | The range of acceptable magnitudes | | -t / t1,t2,...,tn | The types of magnitudes to retrieve | | -D / | The range of acceptable depths in kilometers | | -o / | The format for output to standard out | | -c / c1,c2,...,cn | A comma separated list of catalogs to search | **Exemplo de uso:** $ find_events -b 2010-01-12 -e 2010-01-13 -m 6.5 === find_stations --> retorna uma lista de estações de acordo com as opções selecionadas === $ find_stations --help ^ Atributo ^ Descrição ^ | -v | Print SOD's version and exit | | -r | Print the created recipe to stdout instead of running it | | -p | Use an additional props file | | -S / | The network server to use | | -R / | Event constraining box as west/east/south/north | | -d / | Event constraining donut as lat/lon/minRadius/maxRadius | | -n / networks n1,n2,...,nn | The codes of networks to retrieve | | -s / stations s1,s2,...,sn | The codes of stations to retrieve | | -o / | The format for output to standard out | **Exemplo de uso:** $ find_stations -n GT -s PLCA === find_seismograms --> efetua o download de sismogramas do banco de dados do IRIS === Como todas as CLT's do SOD, o find_seismograms também possui a ajuda quando digitamos: $ find_seismograms --help ^ Atributo ^ Descrição ^ | -v | Print SOD's version and exit | | -r | Print the created recipe to stdout instead of running it | | -p | Use an additional props file | | -S / | Set the seismogram server to use for this search | | -B / | Phase name and offset for the seismogram's begin | | -E / | Phase name and offset for the seismogram's end | | -l / l1,l2,...,ln | The codes of sites(location codes) to retrieve | | -c / c1,c2,...,cn | The codes of channels to retrieve | | -f / | Filename template for seismograms | | --mark-phases 1,2,...,n | Phase arrival times to record in the SAC t headers | | -o / | The format for output to standard out | Este CLT deve ser usado de modo "concatenado" com os CLT's anteriores.Para isso, devemos adicionar além do pipe '|' ao fim de cada CLT, também as opções -r e -o none. Assim, a saída do primeiro CLT será usada como entrada do segundo, e assim por diante...\\ **OBS:** Os sismogramas obtidos através das CLT's do SOD estarão no formato **SAC**. **Exemplo de uso:** $ find_events -b 2010-01-12 -e 2010-01-13 -m 6.5 -r -o none | find_stations -n GT -s PLCA -r -o none | find_seismograms Para mais informações visite a página oficial do [[http://www.seis.sc.edu/sod/index.html|SOD]] =) --- //[[bruno@iag.usp.br|bruno collaço]] 2010/07/20 12:40// ===== BRbFast: SOD + BreqFast ===== Solicitar dados pelo BreqFast torna a requisição mais ágil quando tratamos grande volume de dados.\\ A requisição de dados pelo BreqFast nada mais é do que o envio de um email especificamente formatado ao DMC (Data Management Center) do IRIS. A requisição é processada e após um intervalo de tempo (a depender da “fila” de requisições no momento) recebemos um link FTP para download dos arquivos. **OBS:** Os sismogramas obtidos através do BreqFast estarão no formato **SEED**. Com o objetivo de agilizar o processo de envio do email e download dos dados por FTP, foram criadas as ferramentas BRbFast: === BRbFast_geraRequisicoes --> cria arquivos formatados seguindo o padrão do BreqFast. === **NOTA:** Como vamos usar as CLT's do SOD, não deixe de criar uma pasta de trabalho antes de iniciar o processo de requisição de dados. O programa **BRbFast_geraRequisicoes** deve ser usado como uma alternativa ao comando //find_seismograms// do SOD. Para tanto, devemos utilizá-lo de modo "concatenado" aos demais CLT's do SOD. **Exemplo de uso:** $ find_events -b 2010-01-12 -e 2010-01-13 -m 6.5 -r -o none | find_stations -n GT -s PLCA -r -o none | BRbFast_geraRequisicoes **OBS:** Você pode visualizar suas requisições na pasta **BRbFast**, criada após rodar o "geraRequisicoes" Com as requisições prontas, o próximo passo é enviá-las. Isto pode ser feito com o auxílo da ferramenta a seguir: === BRbFast_enviaRequisicoes --> envia os arquivos .request contidos na pasta BRbFast === **Exemplos de uso:** $ BRbFast_enviaRequisicoes # se já existirem os arquivos .request $ find_events -b 2010-01-12 -e 2010-01-13 -m 6.5 -r -o none | find_stations -n GT -s PLCA -r -o none | BRbFast_geraRequisicoes; BRbFast_enviaRequisicoes Neste ponto os dados foram requisitados e estão sendo processados pelo DMC do IRIS. Como dito antes, os sismogramas estarão prontos para serem baixados de acordo com a demanda de dados que o DMC processa naquele instante.\\ Solicitar o download dos arquivos é bem simples, basta usar a seguinte ferramenta: === BRbFast_baixaArquivos --> conecta-se ao FTP do IRIS e solicita os arquivos da pasta BRbFast === **Exemplos de uso:** $ BRbFast_baixaArquivos Se os arquivos já estiverem disponíveis o download começa imediatamente, se não, tente novamente mais tarde. =) --- //[[bruno@iag.usp.br|bruno collaço]] 2010/07/19 20:09// ===== CSV Source Files: Requisitando Dados de Eventos Recentes ===== Até agora vimos diferentes maneiras de requisitar sismogramas contidos nos catálogos das diferentes redes mundiais. Como solicitar dados de eventos recentes, que ainda não foram catalogados?\\ Uma alternativa é usar um catálogo local, um arquivo do tipo **//.csv//** (comma-separeted-values) criado pelo próprio usuário. Este arquivo irá substituir o comando **find_events** do SOD.\\ Para solicitar dados de eventos não catalogados é necessário conhecer apenas o seu tempo de origem, como veremos a seguir. ==== Criando um catálogo local (.csv) ==== Um catálogo local pode conter diversas informações de um determinado sismo, tais como: tempo de origem, latitude, longitude, magnitude, profundidade, etc... Dentre elas, apenas o //tempo de origem// é **obrigatório** e deve estar no padrão ISO 8601, como a seguir:\\ 2010-07-21T20:30:00.000Z **NOTA:** Não esqueça de salvar o catálogo criado com a extensão **.csv** --> 'nome_do_catálogo.csv'\\ Um exemplo de catálogo local pode ser encontrado [[http://www.seis.sc.edu/sod/ingredients/events.csv|aqui]] ==== Lendo um catálogo local (.csv) ==== Com o catálogo devidamente criado, vamos utilizar mais uma ferramenta BRbFast: === BRbFast_leCatalogoCSV --> substitui o find_events por um catálogo local === **Exemplos de uso:** BRbFast_leCatalogoCSV catalogo_local.csv BRbFast_leCatalogoCSV /home/ingrid/petrobras.csv | find_stations -n GT -s PLCA -r -o none | find_seismograms Mais detalhes de como utilizar um arquivo .csv [[http://www.seis.sc.edu/sod/ingredients/csvEvents.html|aqui]] =) --- //[[bruno@iag.usp.br|bruno collaço]] 2010/07/20 14:41//