Other Catalog Files

<< Previous: Catalog List Catalog

Next: Scripting Overview >>

Cosmographia can load the following additional kinds of catalogs:
This section does not attempt to describe these catalogs in detail but simply provides an example for each of them.

Annotations Catalogs

The Annotations Catalogs define time-dependent messages that are displayed at the top of the Cosmographia window. This is an example of an Annotations Catalog:
{
   "version": "1.0",
   "name": "Cosmographia CASSINI Example",
   "items": [
      {
         "name": "CASSINI RADAR Annotations",
         "type": "AnnotationScript",
         "color": "white",
         "script": [
            {
               "startTime": "2004-10-26 15:23",
               "endTime": "2004-10-26 15:25",
               "text": "Preparing for observation ..."
            },
            {
               "startTime": "2004-10-26 15:26",
               "endTime": "2004-10-26 15:49",
               "text": "Sending radar pulses ..."
            },
            {
               "startTime": "2004-10-26 15:50 UTC",
               "endTime": "2004-10-26 15:55 UTC",
               "text": "Finishing up ..."
            }
         ]
      }
   ]
}

Visualizers Catalogs

The Visualizers Catalogs define graphical primitives (visualizers). Planes are the only visualizers that can be currently defined using these catalogs. This is an example of a Visualizers Catalog defining the XY and XZ planes of the Titan body-fixed frame (SPICE name ‘IAU_TITAN’) centered at Titan:
{
   "version": "1.0",
   "name": "Plane Visualizer Example",
   "items": [
      {
         "type": "Visualizer",
         "tag": "Titan XY plane",
         "body": "Titan",
         "style": {
            "type": "Plane",
            "frame": {
               "type": "Spice",
               "name": "IAU_TITAN"
            },
            "size": 5000,
            "gridSubdivision": 20,
            "color": [ 1, 1, 0 ],
            "opacity": 0.1
         }
      },
      {
         "type": "Visualizer",
         "tag": "Titan XZ plane",
         "body": "Titan",
         "style": {
            "type": "Plane",
            "frame": {
               "type": "TwoVector",
               "primaryAxis": "z",
               "primary": {
                  "type": "ConstantVector",
                  "direction": [ 0, 1, 0 ],
                  "frame": {
                     "type": "Spice",
                     "name": "IAU_TITAN"
                  }
               },
               "secondaryAxis": "x",
               "secondary": {
                  "type": "ConstantVector",
                  "direction": [ 1, 0, 0 ],
                  "frame": {
                     "type": "Spice",
                     "name": "IAU_TITAN"
                  }
               }
            },
            "size": 5000,
            "gridSubdivision": 20,
            "color": [ 1, 0, 1 ],
            "opacity": 0.1
         }
      }
   ]
}
Note that a plane is always defined to be aligned with the XY plane of the frame specified in the definition (see XY plane in the example above). To define a plane at a different orientation a special frame should be defined such that its XY plane is aligned with the desired orientation, for example using the “TwoVector” frame style (see XZ plane in the example above).

Surface Features Catalogs

The Surface Features Catalogs define names and locations of features on surfaces of natural bodies. A few such catalogs named “[body]-features.json” are included in the Cosmographia package. This is the top portion of the “mars-features.json” catalog:
{
  "version": "1.0",
  "name": "Martian Surface Features",

  "items":
  [
    {
      "type": "FeatureLabels",
      "name": "Mars Surface Features",
      "body": "Mars",

      "features": [
        {
          "origin": "American colonial town (North Carolina).", 
          "diameter": 1.72692, 
          "code": "AA", 
          "name": "New Bern", 
          "longitude": 310.8478007026, 
          "link": "http://planetarynames.wr.usgs.gov/Feature/4229", 
          "latitude": 21.5334358064
        }, 
        {
          "origin": "Town in Italy.", 
          "diameter": 86.982, 
          "code": "AA", 
          "name": "Novara", 
          "longitude": 349.3122103786, 
          "link": "http://planetarynames.wr.usgs.gov/Feature/4347", 
          "latitude": -24.8979410153
        }, 
...
      ]
    }
  ]
}

View Point Catalog

The View Point Catalog defines the initial view point of the camera when the program is launched without any command line arguments. A single View Point Catalog named “start-viewpoints.json” is included in the Cosmographia package. This is the top portion of this catalog defining the starting view point:
{
    "version": "1.0",
    "name": "Starting Viewpoints",
    "items": [
        {
          "type": "Viewpoint",
          "name": "Default Start",
          "center": "Sun",
          "altitude": 1.5e9,
          "reference": "Earth",
          "azimuth": -60.0,
          "elevation": 30.0,
          "up": "EclipticNorth"
        },
...
    ]
}

Add-ons Catalog

The Add-ons Catalog defines add-ons that appear in the Visualization Setting Add-ons panel. A single Add-ons Catalog named “addons.js” is included in the Cosmographia package. This is the top portion of this catalog:
var InstalledAddons =
[
    {
    name: "ISS and Hubble",
    description: "View the International Space Station and the Hubble Space Telescope",
    source: "earthorbiting.json"
    },
    {
    name: "Aurora Borealis",
    description: "A curtain of aurora above the Earth's arctic region",
    source: "addons/aurora.json"
    },
...
];