f u t u r e ra
Docs: time series / Toc / Data structure

SUMMARY

-Data structure of a time serie

An overview of the structure of a time serie.

You can upload and save a time serie in JSON or CSV format. Examples of filenames for uploading and saving are: filename.json, Filename.Json or filename.csv etc.

Atttributes / Fields for a time serie:

periodicty is a required field.
decimal is a number
observations is a list of observation

An observation has two Atttributes / Fields:

date is a ISO date format (YYYY-MM-DD)
If periodicity is quarter then MM is 01, 04, 07 or 10
value is a number

JSON

JSON (JavaScript Object Notation) is a lightweight, human-readable text-based data interchange format. It's widely used for transmitting data between a server and a client, especially in web applications. JSON is based on a subset of the JavaScript programming language standard and is easy for both humans and machines to read and write, as well as parse and generate. JSON uses key-value pairs and arrays to represent data.

An example:

{

"decimal": 1,
"description": "Demand for big city product",
"dimension": "Dollars",
name": "city_demand",
"observations": [
{
"date": "1979-01-01",
"value": 27.0
},
{
"date": "1980-01-01",
"value": 23.0
},
{
"date": "1981-01-01",
"value": 31.0
}
],
"periodicity": "year",
"reference": "Forecasting systems for operations manegement (Stephen A. Delurgio, Carl D. Bhame)",
"short_title": "Demand",
"title": "Demand for a product",
"unit": "$000s"
}

CSV

Comma-separated values (CSV) is a text file format that uses commas to separate values, and newlines to separate records. A CSV file stores data (numbers and text) in plain text, where each line of the file typically represents one data record.
Each record are separated by commas in the CSV file. If the field delimiter itself may appear within a field, fields can be surrounded with quotation marks.

The CSV file format is one type of delimiter-separated file format.[4] Delimiters frequently used include the comma, tab, space, and semicolon. Delimiter-separated files are often given a ".csv" extension even when the field separator is not a comma.

An example:

name,example
periodicity,year
short_title,test
title;the great ocean
dimension,cubic
unit,(1000)m3
description,"the whale, and fishes"
description,the clouds and waves
description,
description,the last line
reference,my-site
observations,2024-01-01,345
observations,2025-01-01,555
observations,2023-01-01,234
observations,2021-01-01,111
observations,2020-01-01,111
observations,2022-01-01,222

BETA