JUICE Cosmographia Configuration Readme File
==============================================

Created by Marc Costa Sitja (ESAC/ESA).
Last modified on July 22, 2022.


Introduction
----------------------------------------------

This document is meant to clarify some aspects of the JUICE Cosmographia
configuration that might be obscure or unclear. The following sections
are present:

   - JUICE Cosmo Plugin
   - JUICE PEP sensor file
   - JUICE magnetosphere and aurora model files
   - JUICE minor moons file


JUICE Cosmo Plugin
----------------------------------------------

The JUICE Sience Operations Center offers a Cosmographia plugin aimed to
support the visualization of different assets used by the JUICE SGS.
This plugin generates a set of adhoc Cosmographia configuration files on
the flies that might differ or conflict with the files provided here.

An effort has been made to coordinate the configuration files of the plug
in and the ones provided in this repository.

More information on the JUICE Cosmo Plugin is available hereunder:

https://www.cosmos.esa.int/web/juice/cosmographia-plugin

If you experience any issues please do not hesitate to get in touch with
the JUICE SOC (marc.costa@ext.esa.int)


JUICE PEP sensor file
----------------------------------------------

Cosmographia has problems with field of views that are "degenerated" cones
and therefore using some PEP FOVs as defined in the Instrument Kernel is
not workable.

Because of this a number of half-domes (a set of concentric half-domes at
different distances) are defined. These half-dome(s) are positioned at the
spacecraft and oriented following the boresight in the 'JUICE_PEP_JDC' frame:

   pep_sensors.json


JUICE magnetosphere and aurora model files
----------------------------------------------

There are a number of configuration files aimed for presentation and
papers visualizations from the PEP instrument team to visualize Jupiter's
magentosphere and auroras:

   jupiter_belts_inner.json
   jupiter_belts_inner_45deg.json
   jupiter_belts_inner_45deg_double.json
   jupiter_belts_inner_90deg.json
   jupiter_belts_middle.json
   jupiter_belts_middle_45deg.json
   jupiter_belts_middle_45deg_double.json
   jupiter_belts_middle_90deg.json
   jupiter_belts_outer.json
   jupiter_belts_outer_45deg.json
   jupiter_belts_outer_45deg_double.json
   jupiter_belts_outer_90deg.json
   jupiter_main_aurora.json


The magnetosphere files are split into “_inner” (up to about 4 radii / inner
radiation belts), “_middle” (outer radiation belts, up to Ganymede), “_outer”
(up to about 30-40 Jupiter radii).

The split is for making files smaller and for giving the option to visualize
different parts of the system. Each has a different colour.

Other groupings (e.g _45deg, _90 deg, _45_deg_double) indicate different cross
section sizes of the magnetosphere that could be visualized. Eg. _45deg
indicates that a continuous 45 deg range of longitudes of the magnetosphere
is shown. 45deg_double has two such segments, centered 180 deg in longitude apart.

Both the magnetosphere and aurora should rotate with the planet.
Orientation is validated (checked with SPICE kernels).


JUICE minor moon files
----------------------------------------------

There is a configuration file that loads all the Jupiter Minor Moons: Inner Moons
and Irregular Moons. When loading the file:

   jupiter_minor_moons.json

All the minor moons are loaded along with their trajectories.


End of aareadme file.