Network input file standards 2.0

April 2014

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

The SimCo-Net-Generator 2 produces well formated files.

generally: Please care about the quotation marks and slashes!

Summary
Network input file standards 2.0April 2014
OverviewA SimCo network file (Extension “.snf”) is a Zip directory containing
“globals”-file“number-dimensions” “3” “short-time-limit” “24” “long-time-limit” “365” Look at documentation of variables (file “variables.nls”) to get an overview.
“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.
“agents”-fileHere you define the properties of the agents in your network.
“seu-values”-fileHere you define the u-values for the agents types.
“p-calculations”-filenameHere you define the p-calculation formulas for the agents seu calculation.

Overview

A SimCo network file (Extension “.snf”) is a Zip directory containing

  • 1 “globals”-file
  • 1 “technologies”-file
  • 1 “nodes”-file
  • 1 “edges”-file
  • 1 “agents”-file
  • 1 “seu-values”-file
  • 1 “p-calculations”-file

All these files should be named like this: <filename>.txt

“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” Look at documentation of variables (file “variables.nls”) to get an overview.

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”

“agents”-file

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

  • id: an integer
  • location: an integer; the given id has to exist in the “nodes”-file
  • destinaton: see location; to define no destination use -1
  • edge-delay: an integer
  • limits-short-time: see “nodes”-file -> limits-short-time
  • limits-long-time: see “nodes”-file -> limits-short-time
  • pay-offs: see “nodes”-file -> pay-offs-nodes
  • technologies-available: see “nodes”-file -> right-of-use
  • technology-in-use: a string in qutation marks; has to exist in the “technologies”-file
  • type: a string to identify the agents type (used for seu calculation)

An example line would be

28 2 nobody 0 “[0 100] [0 100] [0 100]” “[0 1000] [0 1000] [0 1000]” “0 0 0” “\”A\”” “A” “b”

“seu-values”-file

Here you define the u-values for the agents types.  At the moment you have to keep an eye to stay consisten with the used agent types Each line is one row of the u-values table:

  • type: a string to identify the agents type
  • u-values: list of integers, one for each aim
  • destinations: list of node numbers, prioritizing the aims

An example line would be

”a” “1000 100 0.5 1” “1 2 3 4”

“p-calculations”-filename

Here you define the p-calculation formulas for the agents seu calculation.  Each line is one aim:

  • edge-p-formula: a string giving the calculation specification for the edge p value
  • node-p-formula: a string giving the calculation specification for the node p value

An example line would be

”calculate-p \”reciprocal\” 2 edge-technology-vector 1” “calculate-p \”reciprocal\” 2 node-technology-vector 1”

Close