documentation for info.json

[FreakyBytes]

Trac Ticket #7

component: code
owner: martinP
reporter: martin
created: 2015-05-23 16:21:11
milestone:
type: task
version:
keywords:

i'm not sure I understand the info.json files. example $STORAGE/models.cellml.org/w/andre/VPH-MIP/info.json:

{ 
  "fileId" : "urn:model:models.cellml.org:w:andre:VPH-MIP:!:experiments:periodic-IStim-protocol.xml",
  "versions" : [ "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "25a4d94fdf146e3e5325a0250283ab25b4af010a", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198", "30ab778d03a1aac5f3d62594a11c1757f5e35198" ]
}

the corresponding directory contains:

l $STORAGE/models.cellml.org/w/andre/VPH-MIP/
total 16K
drwxr-xr-x 4 martin martin 4.0K May 23 17:38 25a4d94fdf146e3e5325a0250283ab25b4af010a/
drwxr-xr-x 4 martin martin 4.0K May 23 17:38 30ab778d03a1aac5f3d62594a11c1757f5e35198/
drwxr-xr-x 4 martin martin 4.0K May 23 17:38 6e2bed224b4a37b5a92f3e5031f8917f4c69fc8f/
-rw-r--r-- 1 martin martin 1.4K May 23 17:38 info.json

and if i look into commit 25a4d94fdf146e3e5325a0250283ab25b4af010a:

find $STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/experiments
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/experiments/periodic-IStim-protocol.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/IK-gating-rates.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/IK.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/gating-variable.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/INa.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/units.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/Ileak.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/default-variable-values.xml
$STORAGE/models.cellml.org/w/andre/VPH-MIP/25a4d94fdf146e3e5325a0250283ab25b4af010a/components/INa-gating-rates.xml

questions:

• what is the fileId value? i guess urn:model:models.cellml.org:w:andre:VPH-MIP:!:experiments:periodic-IStim-protocol.xml identifies one model file? but why aren't there entries for e.g. INa-gating-rates.xml oder units.xml?
• what is the value of versions? are that all commits? are they somehow sorted? and why does the array contain so many commits but i can just see 3 directories on my disk? does that mean only in those 3 something relevant happened?
• is it somehow possible to find out which file was changed in which commit?

could you please add some documentation for the info.json files?