Argus proporciona los siguientes archivos de documentación de suscriptor en formato CSV:
- latestCodes.csv: Una lista de todos los commodities que Argus publica o publicó con sus propiedades, tal como frecuencia de publicación, información de plazos, unidades de medida, etc. El código es un descriptor de evaluación básico y no incluye ninguna información sobre los tipos de puntos de datos evaluados para un commodity, o cuándo se realizan esas evaluaciones, etc.
- latestModules.csv: La lista de módulos que Argus publica con sus descripciones, nombres cortos y ubicaciones.
- latestPricetype.csv: Una lista de descriptores que aclara el tipo de valor publicado, por ejemplo: Alto, Bajo, Promedio, etc. También se conoce como PriceType o PT.
- latestTimestamp.csv: Lista de períodos de tiempo en los que Argus publica sus evaluaciones. También se conoce como TimeStamp o TS.
- latestQuotes.csv: Una lista de todas las combinaciones Código-TS-PT-CFWD (CFWD: a plazo continuo; se explica a continuación) que Argus alguna vez evaluó con sus fechas de inicio y finalización y otros parámetros. Junto con la fecha, esa combinación representa una clave de punto de datos única.
- latestModuleDetails.csv: describe el contenido de cada módulo en forma de combinación Código-TS-PT-CFWD (tenga en cuenta que dentro de un módulo, los datos pueden publicarse diariamente y semanalmente, semanalmente y mensualmente, etc., por lo tanto, no todos los archivos CSV contienen todas las evaluaciones solo cuando caducan).
- latestCategory.csv: Una lista de todos los códigos asignados a sus categorías específicas, que se muestran en un formato de árbol.
- latestDoc.csv: Una lista combinada de toda la documentación anterior en un formato decodificado.
- latestUnits.csv: Una lista de unidades de medida y monedas.
- latestRVP_Code_reference.csv: Este archivo es específico para la gasolina de Argus US Products y representa la proyección entre la serie de precios y la serie RVP.
Las relaciones entre las tablas se muestran aquí.
El archivo latestDoc.csv contiene detalles de la carpeta y el nombre de archivo que usted encontrará en el sitio FTP. Por ejemplo, usted puede encontrar el índice Coal API2 (vea la segunda fila del archivo a continuación) en una carpeta llamada «DAMCOAL» (vea la columna C) y en un archivo cuyo nombre contiene «dcm» (vea la columna D y la convención de nomenclatura que se describe a continuación). Todos los datos relacionados que se publican juntos están contenidos en un solo archivo.
El archivo anterior también indica la frecuencia de publicación de cada dato (vea la columna V).
El archivo latestModules.csv contiene detalles de la hora a la que se publica cada archivo. Tenga en cuenta que todas las marcas de tiempo del archivo están en UTC (tiempo universal coordinado).
La convención de nomenclatura para los archivos es la siguiente (donde FFF se reemplaza por el nombre de archivo en la columna D del archivo latestDoc.csv):
Formato Filename | Ejemplo | Explicación de los contenidos y la metodología de nomenclatura |
---|---|---|
latestFFF.csv | latestdcm.csv | Los datos más recientes se publican en este archivo con la frecuencia más frecuente. También tenga en cuenta que, en las raras ocasiones en que se requieren correcciones a los datos para períodos anteriores o la publicación de datos faltantes, estos se incluirán en este archivo y se marcarán como una corrección (consulte la definición de la columna «Estado»). Esto debería permitir que los datos se actualicen o inserten en su conjunto de datos históricos. Además, tenga en cuenta que cuando se identifica una corrección antes del cierre del negocio, publicaremos una corrección en este archivo y, más tarde, nuevamente en el último archivo el siguiente día hábil, cuando se genera el nuevo archivo. Esto garantiza que los clientes que solo leen el archivo una vez al día recibirán la corrección al día siguiente. |
previousFFF.csv | previousdcm.csv | Cuando los precios se publican para ese mismo día, los datos del día anterior se transfieren a este archivo. |
yyyymmddFFF.csv | 20130909dcm.csv | Cuando se publican los precios de ese mismo día, los datos del día anterior se copian en un nuevo archivo con una marca de fecha en el nombre del archivo. Por lo general, se retienen alrededor de 10 días hábiles de archivos para informes diarios, 5 para informes semanales y 2 para informes mensuales. |
En la captura de pantalla a continuación, verá un ejemplo de la carpeta DAMCOAL después de su publicación el 9 de septiembre de 2013. Esta instancia de FTP está alojada en un servidor que ejecuta la zona horaria EST, por lo tanto, las marcas de tiempo son cinco horas menos que la hora del Reino Unido. Argus aloja servidores FTP en diferentes zonas horarias. Para evitar ambigüedades, recomendamos utilizar el comando MDTM FTP como se describe en RFC-3659.
La carpeta DAMCOAL contiene dos archivos, el archivo «dcm» contiene precios publicados diarios y semanales (p. ej. API2) y el archivo «dcm2» contiene precios semanales y mensuales, por lo tanto, se actualiza una vez por semana, en este caso, un viernes.
Formato de archivo DATA CSV
Los archivos de datos CSV contienen considerablemente más información que tan solo el nombre, la fecha, el valor y una marca de tiempo para cada evaluación. La información adicional se relaciona con el momento de la evaluación y la base sobre la cual se calcula el precio. Por ejemplo, Argus North Sea Dated se calcula a partir de un mes a futuro del Mar del Norte, el archivo CSV incluirá datos para indicar a partir de qué mes se calculó el precio. Algunas series son precios de futuros y basados en otra serie y el archivo csv tendrá toda esta información de plazos.
Además (usando el mismo ejemplo), todos los meses del Mar del Norte (actualmente hay cuatro meses a futuro del Mar del Norte de Argus) reciben el mismo código, por lo tanto, el archivo CSV tiene un campo de «plazo continuo». El valor de plazo continuo contiene el número de secuencia de cada período a futuro. Por ejemplo, Argus publica los precios del mes 1 del Mar del Norte, el mes 2 del Mar del Norte, el mes 3 del Mar del Norte y el mes 4 del Mar del Norte; el período a futuro podría ser 10, 11, 12, 1 (octubre, noviembre, diciembre, enero), pero los períodos siempre serán 1, 2, 3, 4 para el primer, segundo, tercer y cuarto mes.
Al utilizarse junto con la fecha, el período a futuro y los campos de plazo continuo permiten que las bases de datos extraigan datos por mes efectivo, es decir, agosto o primer mes, según lo que requiera el usuario. El año permite que estos campos se utilicen para generar una consulta de agosto de 2003.
Un campo final indica si un registro de datos es nuevo o una corrección. Esto permite a Argus colocar correcciones en un archivo de datos diario regular junto con los nuevos datos. Esto permite al usuario acceder a nuevos datos y correcciones en una descarga, lo que debería garantizar que las bases de datos del usuario se mantengan tan actualizadas como la base de datos maestra de Argus.
Ejemplo de archivo CSV:
Código, Tipo de TS, Código de PT, Fecha, Valor, Plazo a futuro, Base dif. renovable, Año, Plazo continuo, Estado de registro |
PA0001723,6,1,06-JUN-2006,68.19,0,7,2006,0,N |
PA0001723,6,2,06-JUN-2006,68.25,0,7,2006,0,N |
PA0001723,6,3,06-JUN-2006,-1.800,0,7,2006,0,N |
PA0002654,6,1,06-JUN-2006,68.62,6,0,2006,1,N |
PA0002654,1,1,06-JUN-2006,70.28,6,0,2006,1,N |
PA0002654,1,2,06-JUN-2006,70.36,6,0,2006,1,N |
PA0002654,6,2,06-JUN-2006,68.72,6,0,2006,1,N |
PA0002654,1,1,06-JUN-2006,71.36,7,0,2006,2,N |
PA0002654,6,1,06-JUN-2006,69.99,7,0,2006,2,N |
PA0002654,6,2,06-JUN-2006,70.05,7,0,2006,2,N |
PA0002654,1,2,06-JUN-2006,71.42,7,0,2006,2,N |
PA0002654,6,1,06-JUN-2006,71.32,8,0,2006,3,N |
PA0002654,1,1,06-JUN-2006,72.42,8,0,2006,3,N |
PA0002654,1,2,06-JUN-2006,72.50,8,0,2006,3,N |
PA0002654,6,2,06-JUN-2006,71.42,8,0,2006,3,N |
PA0002654,1,1,06-JUN-2006,73.13,9,0,2006,4,N |
PA0002654,6,1,06-JUN-2006,72.09,9,0,2006,4,N |
PA0002654,6,2,06-JUN-2006,72.17,9,0,2006,4,N |
PA0002654,1,2,06-JUN-2006,73.21,9,0,2006,4,N |
PA0002654,1,1,05-JUN-2006,70.43,7,0,2006,1,C |
PA0002654,1,2,05-JUN-2006,70.49,7,0,2006,1 |
Nota: la primera línea contiene los encabezados de campo.
Código (columna 1)
Un campo de secuencia de caracteres. Este es el identificador del commodity. El identificador se vincula con la tabla de descripción de códigos que proporciona información como commodity, unidades, etc.
Por ejemplo: PA0002654Código: PA0002654
Nombre: Mes del Mar del Norte
Modo de entrega: FOB
Unidad: dólares estadounidenses por barril
Plazo: Mes
Descripción de período a futuro: valor mensual
Frecuencia: diaria
Tipo de marca de tiempo (columna 2)
Un campo entero numérico. El tipo de TS (Marca de tiempo) es el momento en que se fija la evaluación, el valor es un identificador que se asigna a un momento específico. Un código puede tener varias marcas de tiempo; por ejemplo, Argus produce evaluaciones de crudo de mes del Mar del Norte al mediodía de Londres y al cierre de Londres (consulte la metodología correspondiente para conocer los valores de tiempo exactos). Al usar un código y varios modificadores de marca de tiempo, todos los datos (en este ejemplo, fecha del Mar del Norte) se mantienen juntos. Descargar la lista de marcas de tiempo
Código de tipo de precio (columna 3)
Un campo entero numérico. PT (Tipo de precio), es un identificador que describe el tipo de precio que es la evaluación. Un código puede tener varios tipos de precios; por ejemplo, Argus produce evaluaciones de crudo con fecha del Mar del Norte para BID, ASK y MIDPOINT. Al usar un código y varios modificadores de tipo de precio, todos los datos (en este ejemplo, fecha del Mar del Norte) se mantienen juntos. Descargar la lista de tipos de precio
Fecha (columna 4)
Un campo de fecha en formato DD-MMM-AAAA. Un campo autoexplicativo: la fecha de evaluación.
Valor (columna 5)
Un campo numérico no entero. Este es el valor de evaluación, como el anterior, un campo autoexplicativo. La tabla de descripción de código describe las unidades de este valor.
Periodo a futuro (columna 6)
Un campo entero numérico. El periodo a futuro (Fwd), (a veces denominado período de entrega) describe el período de tiempo al que se aplica la evaluación. El valor de este campo puede representar años, meses, semanas, días según las definiciones en el archivo codes.csv.
Base dif. renovable (columna 7)
Un campo entero numérico. La base diferencial (dif.) renovable es principalmente un campo que se utiliza en las evaluaciones de crudo (pero no exclusivamente) que se evalúan en relación con otro crudo (o producto si no es un crudo). Argus North Sea Dated es una evaluación de crudo que se evalúa en relación con un mes a futuro de la serie de meses a futuro del Mar del Norte. Para poder realizar un seguimiento del mes de base, la base diferencial renovable almacena el valor del mes. La base diferencial renovable son los valores de mes en un rango del 1 al 12.
Año (columna 8)
Este es el año efectivo de la evaluación. Si la serie es un precio puntual o fechado, entonces el año es el mismo que el año de la fecha de evaluación en la columna 4. Si la serie es para un precio de entrega a futuro o un precio futuro, o incluso, un período de tiempo anterior, entonces el valor de este año es para el año real del período a futuro. En el archivo de muestra anterior hay 10 filas de datos para el código PA0002731, que es el gas natural Bacton de meses a futuro. Esto representa 2004 en este momento, porque los precios son desde febrero de 2004 hasta junio de 2004. Alrededor de agosto, los datos podrían ser los siguientes:
Código, Tipo de TS, Código de PT, Fecha, Valor, Plazo a futuro, Base dif. renovable, Año, Plazo continuo, Estado de registro |
PA0002731,6,1,17-AGO-2004,29.6,9,0,2004,1,N |
PA0002731,6,2,17-AGO-2004,29.8,9,0,2004,1,N |
PA0002731,6,1,17-AGO-2004,23.4,10,0,2004,2,N |
PA0002731,6,2,17-AGO-2004,23.6,10,0,2004,2,N |
PA0002731,6,1,17-AGO-2004,21.6,11,0,2004,3,N |
PA0002731,6,2,17-AGO-2004,21.8,11,0,2004,3,N |
PA0002731,6,1,17-AGO-2004,18.85,12,0,2004,4,N |
PA0002731,6,2,17-AGO-2004,18.95,12,0,2004,4,N |
PA0002731,6,1,17-AGO-2004,18,1,0,2005,5,N |
PA0002731,6,2,17-AGO-2004,18.1,1,0,2005,5,N |
O tabulados, para una mejor representación:
Código | Tipo de TS | Código de PT | Fecha | Valor | Período a futuro | Base dif. renovable | Año | Plazo cont. | Estado de registro |
---|---|---|---|---|---|---|---|---|---|
PA0002731 | 6 | 1 | 17-ago 2004 | 29,6 | 9 | 0 | 2004 | 1 | N |
PA0002731 | 6 | 2 | 17-ago 2004 | 29,8 | 9 | 0 | 2004 | 1 | N |
PA0002731 | 6 | 1 | 17-ago 2004 | 23,4 | 10 | 0 | 2004 | 2 | N |
PA0002731 | 6 | 2 | 17-ago 2004 | 23,6 | 10 | 0 | 2004 | 2 | N |
PA0002731 | 6 | 1 | 17-ago 2004 | 21,6 | 11 | 0 | 2004 | 3 | N |
PA0002731 | 6 | 2 | 17-ago 2004 | 21,8 | 11 | 0 | 2004 | 3 | N |
PA0002731 | 6 | 1 | 17-ago 2004 | 18,85 | 12 | 0 | 2004 | 4 | N |
PA0002731 | 6 | 2 | 17-ago 2004 | 18,95 | 12 | 0 | 2004 | 4 | N |
PA0002731 | 6 | 1 | 17-ago 2004 | 18 | 1 | 0 | 2005 | 5 | N |
PA0002731 | 6 | 2 | 17-ago 2004 | 18,1 | 1 | 0 | 2005 | 5 | N |
En las últimas dos filas, el año se extendió hasta 2005. Esto se debe a que el período a futuro de este precio ahora es 1 (enero) para este código, lo cual traslada el período a futuro al próximo año (2005).
A plazo continuo (columna 9)
El plazo continuo está estrechamente relacionado con el período a futuro y el año. Para continuar con el ejemplo anterior, el código PA0002731 tiene 10 filas de datos. Hay cinco pares de datos. Las diferencias entre cada par son los tipos de precios, valores, períodos a futuro y periodos continuos. Los tipos de precios indican que estos son pares de oferta y demanda. Los períodos a futuro indican que estos son para los meses de septiembre a enero. Los periodos continuos muestran que estos son los precios de futuros del mes 1, mes 2, mes 3, mes 4 y mes 5.
Estado (columna 10)
El indicador de estado señala si el precio es un punto de datos nuevo o un punto de datos corregido. Los valores son «N» para nuevo, «C» para corregido o «H» para dato corregido históricamente (ver a continuación). A veces, las correcciones proporcionan datos que se omitieron anteriormente. Este indicador resalta que los datos son adicionales a los datos diarios normales debido a un problema anterior con ese registro en particular. El indicador se puede usar para ubicar un registro existente para sobrescribir los datos, siempre y cuando una «búsqueda» sin éxito no detenga la creación de un nuevo registro a partir de la corrección.
Argus limpia y audita continuamente los datos de series de tiempo y corrige las discrepancias cuando se descubren. Si los datos son «antiguos» (es decir, después de seis meses), entonces normalmente no se emitiría una nueva corrección, a menos que el número fuera un índice significativo como «Fecha de Mar del Norte» en el cual se basan una gran cantidad de otros precios. Argus puede emitir correcciones para los datos «antiguos» a su discreción.
Nota: los delimitadores consecutivos se tratan como uno.