Network input file standards

March 2013

This file defines a standard to network input files for SimCo.

The SimCo-Net-Generator produces well formated files.

generally: Please care about the quotation marks and slashes!

Summary
Network input file standardsMarch 2013
OverviewA SimCo network consists of
“setup”-fileSimCo loads the “setup”-file (the user has to choose it) at first.
“globals”-file“number-dimensions” “3” “short-time-limit” “24” “long-time-limit” “365”
“technologies”-fileHere you define the properties of the technologies in your network.
“nodes”-fileHere you define the properties of the nodes in your network.
“edges”-fileHere you define the properties of the edges in your network.

Overview

A SimCo network consists of

  • 1 “setup”-file
  • 1 “globals”-file
  • 1 “technologies”-file
  • 1 “nodes”-file
  • 1 “edges”-file
  • 1 “agents”-file

All these files should be named like this: <name of the network>-xxx.txt

An example: aTest-setup.txt

“setup”-file

SimCo loads the “setup”-file (the user has to choose it) at first.  This has to contain the names of all the other files line by line like this: “nodes-file” “aTest-nodes.txt” “edges-file” “aTest-edges.txt” “agents-file” “aTest-agents.txt” “technologies-file” “aTest-technologies.txt” “globals-file” “aTest-globals.txt” “description” “This is an example network.”

Once again: Please care about the quotation marks!

“globals”-file

This file contains data for global varibales in SimCo.  At the moment these are

”number-dimensions” “3” “short-time-limit” “24” “long-time-limit” “365”

Please note that the “number-dimensions” must suit to the number of dimensions in the other files (technologies, nodes, edges and agents)!

“technologies”-file

Here you define the properties of the technologies in your network.  Each line is a new technology, consisting of:

  • id: an integer
  • name: a string in quotation marks
  • purchase-price: a rational number
  • lifetime: a rational number > 0
  • factor: a list surrounded by quotation marks, one entry per dimension; rational numbers for entries

An example line would be

2 “C” 1000 100 “1 1 1”

“nodes”-file

Here you define the properties of the nodes in your network.  Each line is a new node, consisting of:

  • id: an integer
  • lifetime: a rational number > 0
  • right-of-use: a list surrounded by quotation marks, one entry per allowed technology; each entry must be surrounded by slahes and quotation marks (see below) and gives the name of the technology the given names must exist in the “technologies”-file
  • limits-short-time: a list surrounded by quotation marks, one entry per dimension; each entry must be surrounded by squared brackets and consists of 2 rational numbers (lower and upper limit); give Euler’s number e for one or both value(s) to undefine these limit(s)
  • limits-long-time: see limits-short-time
  • pay-offs-nodes: a list surrounded by qutation marks, one entry per dimension; rational numbers for entries
  • pay-offs-agents: see pay-offs-node
  • pay-offs-external: see pay-offs-node

An example line would be

0 100 “\”blue1\” \”blue2\”” “[0.0 2] [3 4] [5 6]” “[e 2] [3 4] [5 0.0]” “-5 6 -3” “1 3 4” “4 7 -6”

“edges”-file

Here you define the properties of the edges in your network.  Each line is a new edge, consisting of:

  • from-node: an integer; the given id has to exist in the “nodes”-file
  • to-node: see from-node
  • lifetime: a rational number > 0
  • right-of-use: see “nodes”-file -> right-of-use
  • limits-short-time: see “nodes”-file -> limits-short-time
  • limits-long-time: see “nodes”-file -> limits-short-time
  • duration: a rational number > 0
  • pay-offs-edges: see “nodes”-file -> pay-offs-nodes
  • pay-offs-agents: see “nodes”-file -> pay-offs-nodes
  • pay-offs-external: see “nodes”-file -> pay-offs-nodes

An example line would be

1 26 99.53828435821863 “\”A\” \”B\” \”C\”” “[0 100] [0 100] [0 100]” “[0 500] [0 500] [0 500]” 11.040009893873712 “1 1 1” “1 1 1” “1 1 1”

Close