YAML syntax for Targets

ScopeSim-Targets is built from the groud up to define targets in YAML files. Instantiation from YAML is identical to creating the object in Python directly. This pages lists a few examples of the syntax used to define targets in YAML.

Stellar

Some examples for stellar objects or groups of such. For detailed explanations of the parameters, see defining positions, defining spectra and defining brightness respectively.

Single stars

Simple single star offset from field center

!Star
position: [2, 3]
spectrum: A0V
brightness: ["R", 15 mag]

Simple single star with alternative position syntax

!Star
position:
  x: 2 arcmin
  y: 1 arcmin
spectrum: A0V
brightness: ["R", 15 mag]

Simple single star with full coordinates

!Star
position:
  !Coord
  ra: 2 deg
  dec: 1 deg
spectrum: A0V
brightness: ["R", 15 mag]

Binaries

Binary with physical separation and distance

!Binary
position:
  distance: 100 pc
offset:
  separation: 0.1 AU
  position_angle: 50 deg  # explicit angle from x+ axis
spectra: [F0V, M2V]
brightness:
  - ["R", 15 mag]
  - ["R", 20 mag]

Binary with angular separation

!Binary
# position implicitly (0, 0) center of field
offset:
  separation: 5 arcsec
  # position angle implicitly along x+ axis
spectra: [F0V, M2V]
brightness: ["R", 15 mag]  # Primary
contrast: 100.0  # F_pri / F_sec

Binaries with explicit positions can be defined simply as a star field with just two stars

!StarField
positions:
  - !Coord
    ra: 2 deg
    dec: 1 deg
  - !Coord
    ra: 2.002 deg
    dec: 1.01 deg
spectra: [F0V, M2V]
brightnesses:
  - ["R", 15 mag]
  - ["R", 20 mag]

Star field

Star field

!StarField
band: R  # Default for brightnesses
positions:
  - [0, 1]
  - [2, -3]
  - [-2, 1]
  - [3, 0]
spectra:
  - G2V
  - A0V
  - M0III
  - K5V
brightnesses:
  - ["V", 12 mag]
  - 15 mag
  - 8 mag
  - 10 mag

Exoplanetary

Simply system with two exoplanets

!PlanetarySystem
position:  # Central star
  x: 2 arcmin
  y: 4 arcmin
  distance: 20 pc
primary:
  !Star
  spectrum: G2V
  brightness: ["V", 12 mag]
components:
  - !Exoplanet
    offset:
      separation: .3 AU
      position_angle: 50 deg  # explicit angle from x+ axis
    contrast: 1.0e+4
    # spectrum taken from default planetary spectrum
  - !Exoplanet
    offset:
      separation: 2 AU
      position_angle: 0.7 cycle  # phase
    contrast: 5.0e+5
    spectrum: "file://path/to/custom/spectrum.fits"

P-type system with an exoplanet around a close binary

!PlanetarySystem
position:
  !Coord
  ra: 2 deg
  dec: 1 deg
  distance: 100 pc
primary:
  !Binary
  offset:
    separation: .1 AU
  spectra: [G0V, M2V]
  brightness: ["R", 15 mag]  # Primary
  contrast: 1.0e+2
components:
  - !Exoplanet
    offset:
      separation: 3 AU
      position_angle: 50 deg  # explicit angle from x+ axis
    contrast: 1.0e+4

Disk example

!Disk
spectrum: "blackbody:2000 K"
brightness: ["R", 20]
radius: 0.5 arcsec # inner radius
width: 0.3 arcsec # width of disk

Star Cluster

Simple young cluster based on IMF

!ZeroAgeCluster
position:
  !Coord
    ra: 0 deg
    dec: 0 deg
    distance: 1 kpc
pop_class: IMFPopulation
pop_params:
  n_stars: 1000
morph_class: KingProfileMorphology
morph_params:
  n_stars: 1000
  r_core: 1 pc
  r_tide: 10 pc

Extragalactic

Simplified model of M59

!Sersic
position:
  !Coord
  ra: 190.5 deg
  dec: 11.6 deg
spectrum: "spex:brown/NGC4621"
brightness: ["V", 9.6 mag]  # total brightness
params:
  r_eff: 2.9 arcsec  # effective (half-light) radius.
  n: 5.98  # sersic index
  ellip: 0.5  # E5
  theta: 163.3 deg  # position angle
  c: -0.35  # disky/boxy shape