Pandeia Backgrounds

When running Pandeia as a scriptable python module, different background options are used than with the web client.

On this page

The Background API

Within Pandeia, the background is defined by two values in the configuration dictionary: background and background_level. The two values are used in concert to either load a background, or identify a pre-computed background to use in the calculation.

background: is either a string defining the name of a background ("ecliptic" or "minzodi", or you can conceivably create your own), or the word "none" for no background, or a list of arrays forming a spectrum

background_level: is either "low", "medium", or "high" (or, for the "minzodi" case, "benchmark"). It does not need to be specified at all if background is none, or a list of arrays.



Canned backgrounds

Canned backgrounds have been pre-generated by the JWST Backgrounds Tool at two locations: along the ecliptic at ecliptic coordinates Lat = 90, Lon = 0; and at the Minzodi location (Lat = 266.3, Lon = -50). The canned backgrounds have been generated at low (10% of max), medium (50% of max), and high (90% of max) background levels as determined from estimating the combined interstellar cirrus, zodiacal light, and internal straylight contributions over the entire period that the locations are in the JWST field of regard.

calculation['background'] = 'ecliptic'
calculation['background_level'] = 'high'

For the Minzodi location, we have also defined a "benchmark" level, which is the Minzodi location on June 19, 2020.

calculation['background'] = 'minzodi'
calculation['background_level'] = 'benchmark'

The option for no background is also available:

calculation['background'] = 'none'


Custom backgrounds

Custom backgrounds are a list containing wavelength and flux arrays (denoted by square brackets) that define the background. You can define them yourself, use the JWST Backgrounds Tool to generate them (as the Web version of the ETC does), or download a calculation from the web ETC that will have a background filled in, and can be run through Pandeia directly.

The below example is of a JSON-formatted numerical background (as it would appear in the input.json file in a web ETC download) for 1 September 2020, pointing at RA = 18:36:56.2, Dec = -36:46:56.2. The first array contains wavelength values. The second array contains the corresponding background values.

JSON-formatted numerical background from input.json
{
    "background":[
        [
            0.5,
            0.6000000238418579,
            0.699999988079071,
            0.800000011920929,
            0.8999999761581421,
            1.0,
            1.100000023841858,
            1.2000000476837158,
            1.2999999523162842,
            1.399999976158142,
            1.5,
            1.600000023841858,
            1.7000000476837158,
            1.7999999523162842,
            1.899999976158142,
            2.0,
            2.0999999046325684,
            2.200000047683716,
            2.299999952316284,
            2.4000000953674316,
            2.5,
            2.5999999046325684,
            2.700000047683716,
            2.799999952316284,
            2.9000000953674316,
            3.0,
            3.0999999046325684,
            3.200000047683716,
            3.299999952316284,
            3.4000000953674316,
            3.5,
            3.700000047683716,
            4.0,
            4.25,
            4.5,
            4.75,
            5.0,
            5.099999904632568,
            5.199999809265137,
            5.300000190734863,
            5.400000095367432,
            5.5,
            5.699999809265137,
            5.900000095367432,
            6.099999904632568,
            6.300000190734863,
            6.5,
            6.699999809265137,
            6.900000095367432,
            7.099999904632568,
            7.300000190734863,
            7.5,
            7.699999809265137,
            7.900000095367432,
            8.100000381469727,
            8.300000190734863,
            8.5,
            8.699999809265137,
            8.899999618530273,
            9.100000381469727,
            9.300000190734863,
            9.5,
            9.699999809265137,
            9.899999618530273,
            10.100000381469727,
            10.300000190734863,
            10.5,
            10.699999809265137,
            10.899999618530273,
            11.100000381469727,
            11.300000190734863,
            11.5,
            11.699999809265137,
            11.899999618530273,
            12.100000381469727,
            12.300000190734863,
            12.5,
            12.699999809265137,
            12.899999618530273,
            13.100000381469727,
            13.300000190734863,
            13.5,
            13.699999809265137,
            13.899999618530273,
            14.100000381469727,
            14.300000190734863,
            14.5,
            14.699999809265137,
            14.899999618530273,
            15.100000381469727,
            15.300000190734863,
            15.5,
            16.5,
            17.5,
            18.5,
            19.5,
            20.5,
            21.5,
            22.5,
            23.5,
            24.5,
            25.5,
            26.5,
            27.5,
            28.5,
            29.5,
            30.5,
            31.0
        ],
        [
            0.3234064961021021,
            0.44711509850663467,
            0.5020510111050431,
            0.5207099344084257,
            0.5209173924655185,
            0.5365018142887178,
            0.5121783360603387,
            0.4787080590138417,
            0.452294151189057,
            0.43304516574877805,
            0.413969180749854,
            0.39545108842578935,
            0.37760783219835425,
            0.3601246439276564,
            0.3442466530430669,
            0.3296061208071046,
            0.31683442133518414,
            0.30509823296731403,
            0.29221901822164575,
            0.280415411584087,
            0.2695422269438195,
            0.2595840270098485,
            0.2504405781612673,
            0.23895378451855756,
            0.21262553886527807,
            0.2023423325262952,
            0.1952970510787696,
            0.1928414697120171,
            0.202138412927988,
            0.17760487726741936,
            0.19072200946421947,
            0.2007775061208944,
            0.23694224805696162,
            0.2859007218947191,
            0.3784486167064963,
            0.5111638958808028,
            0.6825369409231646,
            0.7825179598924725,
            0.8918038795675787,
            1.0286818655967291,
            1.1503507916072981,
            1.3087336954282431,
            1.6840875602458776,
            2.076638369708245,
            2.6464542784452223,
            3.4140950261720686,
            3.7401941939243253,
            4.336139014396712,
            5.0549176875994,
            5.82648056225817,
            6.738956066707226,
            7.837643409257359,
            8.886969825835259,
            9.678569449082602,
            10.45553537662783,
            11.41183165438888,
            12.490207588827149,
            13.520597746497847,
            14.446693173210432,
            15.505134134795075,
            16.608235974747316,
            17.73880882532778,
            18.897666495032542,
            20.067366579560915,
            21.222554723825027,
            22.384148420447772,
            23.591550153357904,
            24.80169023900541,
            26.047713508916967,
            27.449603787951496,
            28.943505001717305,
            30.058390067398744,
            31.057954807876026,
            32.29168145319162,
            33.704540471771566,
            35.28032815576408,
            36.899800008896904,
            38.565843882997115,
            40.229229819766246,
            41.92192858986771,
            43.72644165366869,
            45.648220554388665,
            47.64055046361585,
            49.716197591798775,
            51.92201035187685,
            54.22563568253073,
            56.650722483299624,
            59.19990666930128,
            61.90851318367346,
            64.77509809312998,
            67.80334376011245,
            73.90170809134807,
            90.76499329297445,
            117.47997986360203,
            154.33241007352657,
            205.0719805824268,
            274.3900967887293,
            367.91350772925347,
            492.25834358298226,
            654.971959025412,
            864.5674727642153,
            1129.4599976223687,
            1459.9264624388652,
            1866.4283361872292,
            2359.0988620875173,
            2948.461093140296,
            3549.316148968764,
            2373.8025740624157
        ]
    ],



Published

 

Latest updates
  •  
    Updated for ETC v1.5.


  • Fixed incorrect link.