Documentação de dados Argus

A Argus fornece os seguintes arquivos de documentação no formato CSV:

• latestCodes.csv: uma lista de todas as commodities que a Argus publica ou publicou com suas propriedades como frequência, informação sobre timing, unidades de medida, etc. O código é um descritor básico de indicador e não inclui nenhuma informação sobre tipos de pontos de dados avaliados para uma commodity, ou quando estas avaliações são realizadas, etc.
• latestModules.csv: a lista de módulos que a Argus publica com suas descrições, nomes curtos e locais.
• latestPricetype.csv: uma lista dos descritores que esclarece o tipo de valor publicado, por exemplo Alto, Baixo, Médio, etc. Também conhecido por PriceType ou PT.
• latestTimestamp.csv: lista de horários em que a Argus publica os indicadores. Também conhecido por TimeStamp ou TS.
• latestQuotes.csv: uma lista das combinações de todos os Code-TS-PT-CFWD(CFWD = contínuo à frente - explicado abaixo) que a Argus já mapeou com datas de início e fim e outros parâmetros. Junto com a data, essa combinação representa um ponto de dados exclusivo e essencial.
• latestModuleDetails.csv: descreve o conteúdo de cada módulo na forma de combinação de Code-TS-PT-CFWD (observe que é possível ter dados publicados diariamente e semanalmente, semanalmente e mensalmente, etc. dentro de um módulo, logo, nem todo arquivo csv contém todos os indicadores apenas quando finalizados).
• latestCategory.csv: uma lista de todos os códigos mapeados para suas categorias específicas, apresentados em um formato de árvore.
• latestDoc.csv: uma lista combinada de toda a documentação acima, em formato decodificado.
• latestUnits.csv: uma lista das unidades de medida e moedas
• latestRVP_Code_reference.csv: este arquivo é específico para gasolina de produtos dos Estados Unidos da Argus e representa o mapeamento entre a série de preços e a série de pressão de vapor Reid (RVP, na sigla em inglês).

As relações entre as tabelas estão apresentadas aqui

O arquivo latestDoc.csv contém dados da pasta e do nome do arquivo que você encontrará no site FTP. Por exemplo, você pode encontrar o índice para Carvão API2 (veja a segunda linha do arquivo abaixo) em uma pasta chamada "DAMCOAL" (veja a coluna C) e em um arquivo cujo nome contém "dcm" (veja a coluna D e a convenção do nome esboçada abaixo). Todos os dados relacionados que são publicados juntos estão contidos em um único arquivo.

O arquivo acima também indica a frequência da publicação de cada dado (veja a coluna V).

O arquivo latestModules.csv contém detalhes da hora em que cada arquivo é publicado. Observe que todos os horários do arquivo estão em UTC.

A convenção dos nomes para os arquivos é a seguinte (onde FFF é substituído pelo Nome do Arquivo na coluna D do arquivo latestDoc.csv):

Na imagem de tela abaixo você verá um exemplo da pasta DAMCOAL após a publicação em 9 de setembro de 2013. Este FTP é hospedado em um servidor que segue o fuso horário EST; logo, ele está 5 horas atrás em relação ao Reino Unido. A Argus hospeda servidores FTP em diferentes fusos horários. Para evitar ambiguidade, recomendamos o uso do comando MDTM FTP conforme descrito em RFC-3659.

A pasta DAMCOAL contém dois arquivos, onde o arquivo "dcm" contém preços publicados diária e semanalmente (isto é, API2) e o arquivo "dcm2" contém preços semanais e mensais. Logo, ele é atualizado uma vez por semana; neste caso, na sexta-feira.

Formato de arquivo DATA CSV

Os arquivos de dados CSV contêm consideravelmente mais informações do que apenas o nome, data, valor e uma hora para cada indicador. As informações extras se relacionam ao horário do indicador e a base pela qual ele é precificado. Por exemplo, o Argus North Sea Dated é calculado a partir de um mês futuro. O arquivo csv North Sea incluirá dados para dizer com base em que mês ele foi precificado. Algumas séries também são preços futuros e baseados em outra série e o arquivo csv terá todas estas informações sobre horário.

Além disso, (usando o mesmo exemplo), todos os meses do North Sea (atualmente há quatro meses no Argus Forward North Sea) recebem o mesmo código, então o arquivo csv tem um campo "continuous forward" (futuro contínuo). O valor futuro contínuo tem o número de sequência de capa período futuro. Por exemplo, a Argus posta os preços para o mês 1 North Sea, mês 2 North Sea, mês 3 North Sea e mês 4 North Sea, o período futuro pode ser 10,11,12,1 (out, nov, dez, jan) mas os períodos futuro contínuo sempre serão 1,2,3,4 para o 1º, 2º, 3º e 4º mês.

Usados em conjunto com a data, os campos de período futuro e futuro contínuo permitem que os bancos de dados extraiam dados pelo mês efetivo, ou seja, agosto, ou pelo primeiro mês, dependendo do que o usuário precise. O Ano permite que esses campos sejam usados para produzir uma consulta sobre agosto de 2003.

Um campo final indica se um registro de dados é novo ou uma correção. Isso permite que a Argus coloque correções em um arquivo de dados diário junto com os novos dados, permitindo que o usuário acesse os novos dados e correções em um download, o que deve garantir que os bancos de dados do usuário sejam mantidos tão atualizados quanto o banco de dados mestre da Argus.

Exemplo de arquivo CSV:

Nota: a primeira linha contém os cabeçalhos do campo.

Código - coluna 1

Um campo de sequência de caracteres. Este é o identificador da commodity. O identificador está ligado à tabela de descrição dos códigos, fornecendo informações como commodity, unidades, etc.

Por exemplo: PA0002654
Código: PA0002654
DisplayName: North Sea month
DeliveryMode: fob
Unity: dólares americanos por barril
Timing: Mês
ForwardPeriodDescription: valor do mês
Frequency: diária

Tipo de autenticação de horário - coluna 2

Um campo de integer numérico. Tipo TS (autenticação de horário) é a hora em que o indicador é fixado; o valor é um identificador designado para um horário específico. Um Código pode ter múltiplas autenticações de horário, por exemplo: a Argus produz indicadores mensais para o petróleo do Mar do Norte ao meio-dia de Londres e no fechamento de Londres (Consulte a metodologia relevante para os valores exatos de horário). Usando-se um código e múltiplos modificadores de horário de autenticação, todos os dados (neste exemplo, o North Sea Dated) são mantidos juntos. Faça o download da lista de autenticações de horário

Código de Tipo de Preço - coluna 3

Um campo de integer numérico. PT (Tipo de preço) é um identificador que descreve o tipo de preço do indicador. Um Código pode ter múltiplos tipos de preço, por exemplo: a Argus produz indicadores para petróleo North Sea Dated para Bid, Ask e Midpoint. Usando-se um código e múltiplos modificadores de tipos de preços, todos os dados (neste exemplo, o North Sea Dated) são mantidos juntos. Faça o download da lista de tipos de preço

Data - coluna 4

Um campo para data no formato DD-MMM-AAAA. Um campo autoexplicativo - data do indicador.

Valor - coluna 5

Um campo não-integer numérico. Este é o valor do indicador, novamente um campo autoexplicativo. A tabela de descrição do código descreve as unidades deste valor.

Período Futuro - coluna 6

Um campo de integer numérico. O Período Futuro (Fwd), (às vezes referido como período de entrega) descreve o período de tempo aplicado ao indicador. O valor deste campo pode representar anos, meses, semanas, dias, dependendo das definições no arquivo codes.csv.

Diff Base Roll - coluna 7

Um campo de integer numérico. O Differential (Diff) Base Roll é um campo usado principalmente para indicadores de petróleo (mas não exclusivamente) avaliados com relação a outra commodity de petróleo (ou commodity, se não for petróleo). O Argus North Sea Dated é um indicador de petróleo avaliado com relação ao mês futuro da série de meses futuros do North Sea. Para ser capaz de acompanhar o mês base, o Diff Base Roll armazena o valor do mês. Diff Base Roll são valores de meses que vão de 1 a 12.

Ano - coluna 8

Este é o ano efetivo do indicador. Se uma série for um preço imediato ou datado, o ano será o mesmo ano da data do indicador na coluna 4. Se a série for para uma entrega futura ou preço futuro, ou até mesmo um período anterior de tempo, este valor de ano será para o ano real do período futuro. No arquivo de amostra acima, há 10 linhas de dados para o código PA0002731, que são meses futuros para gás natural Bacton. Isso representa 2004 no momento porque os preços são de fevereiro de 2004 até junho de 2004. Por volta de agosto, os dados podem ficar assim:

ou tabulados para melhor representação: 

Para as duas últimas linhas, o ano chegou perto de 2005. Isso aconteceu porque o período futuro deste preço agora é 1 (janeiro) para este código, que leva o período futudo para o ano seguinte (2005).

Fututo cont. - coluna 9

O período contínuo está intimamente relacionado ao período futuro e ao ano. Continuando o exemplo acima, o código PA0002731 tem 10 linhas de dados. Há cinco pares de dados. As diferenças entre cada par são os tipos de preços, valores, períodos futuros e contínuos. Os tipode de preço indicam que estes são pares bid/ask. Os períodos futuros indicam que estes são para os meses de setembro a janeiro. Os períodos contínuos mostram que estes são preços futuros do mês 1, mês 2, mês 3, mês 4 e mês 5.

Estado - coluna 10

A bandeira de estado indica se o preço é um ponto de dados novo ou um ponto de dados corrigido. Os valores são “N” para os novos, “C” para as correções ou "H" para dados corrigidos historicamente (veja abaixo). As correções às vezes fornecem dados que foram omitidos anteriormente. Esta bandeira destaca que os dados são adicionais aos dados diários normais devido a um problema anterior com aquele registro em particular. A bandeira pode ser usada para localizar um registro existente para substituir os dados, contanto que uma falha de "busca"não impeça que um novo registro seja criado devido à correção.

A Argus limpa e audita continuamente os dados de série cronológica e corrige discrepâncias quando elas são descobertas. Se os dados são “antigos” (isto é, após 6 meses), nenhuma correção seria normalmente emitida, a não ser que o número fosse um índice importante, tal como o “North Sea Dated”, com base no qual um grande número de outros preços são baseados. A Argus pode emitir correções para dados “antigos” a critério próprio.

Nota: os delimitadores consecutivos são tratados como um.