Configuration ============= Main config ----------- ``requests`` (bool): Whether to use Web-based API to retrieve data. ``apiKey`` (str): API key for IllustrisTNG, required if ``requests`` is True. ``simulation`` (str): Simulation name. TNG50, TNG100, TNG300, etc. ``hydrodynamicSolver`` (str): hydrodynamic solver for gas particles, can be VoronoiMesh (TNG) or smoothParticle (EAGLE) ``TNGPath`` (str): Path to simulation data in local. ``postprocessingPath`` (str): Path to postprocessing data in local. Offset for each snapshot is required to read data from TNG locally. ``workingDir`` (str): Working directory for running SKIRT code. ``simulationMode`` (str): Simulation mode. NoMedium or DustEmission. ``includeDust`` (bool): Whether to include dust particles. Be True if simulationMode is DustEmission ``dustEmissionType`` (str): Dust emission type. Equilibrium or Stochastic. ``dustModel`` (str): Dust model. ZubkoDustMix, DraineLiDustMix or ThemisDustMix. ``minWavelength``, ``maxWavelength`` (float): Wavelength range in rest frame, in micron. ``boxLengthScale`` (float): Particles are retrieved from the box with length ``halfStellarMassRadius * boxLengthScale``. ``maxBoxLength`` (float): Maximum box length. ``fieldOfView`` (float) Field of view in arcsec, equals to box length if 0. ``wavelengthGrid`` (str): Wavelength grid type. Linear or Log. ``numWavelengths`` (int): Number of wavelengths bins. ``minLevel``, ``maxLevel`` (int): Octree min/max level refinement for dust calculation of SKIRT. ``numPackets`` (float): Number of photon packets. Main parameter to affect the SNR of SKIRT calculation. ``SEDFamily`` (str): SED family for quenched star particles. BC03 or FSPS. ``initialMassFunction`` (str): Initial mass function for quenched star particles. Chabrier or Salpeter for BC03 SED family. Chabrier, Kroupa or Salpeter for FSPS family. ``minStellarMass``, ``maxStellarMass`` (float): Stellar mass range for subhalos in Msun, inf for infinite. ``estimateMorph`` (bool): Estimate the morphology of current galaxy using S/T ratios, either a spiral or non-spiral. ``faceAndEdge`` (bool): Whether to use face-on and edge-on angles derived by angular momentum. ``numViews`` (int): Number of instrument views. ``randomViews`` (bool): Whether to use random viewing angles. ``inclinations``, ``azimuths`` (list): Inclinations and azimuths for instrument views. ``postProcessing`` (bool): Whether to perform postprocessing. ``spatialResol`` (float): Base spatial resolution, must be provided if postprocessing is False. ``imageUnit`` (str): Unit type of bandpass image output. electron or flux. ``surveys`` (list): Surveys considered. ``displaySED`` (bool): Whether to display SED. ``displaySEDxlogscale`` (bool): Whether to display SED in logscale for wavelength. ``outputSEDOnly`` (bool): If only output SED. ``snapNum`` (int): Snapshot ID. ``snapRedshift`` (float): Snapshot redshift of Snapshot with ID. ``viewRedshift`` (float): viewing redshift, should be close to snapRedshift. For generating galaxies at continous redshift with a small offset on snapRedshift. For example, viewRedshift can be 0.105 for snapshot-91 at 0.1. ``inLocal`` (bool): if use local cosmology. ``viewDistance`` (float): viewing distance, in Mpc, must be provided if inLocal is True. ``numThreads`` (int): Number of threads. No speedup for threads larger than 24. ``recordComponents`` (bool): Whether to record individual components including transparent, primary direct, primary scattered and secondarytransparent, secondarydirect, secondaryscattered, apart from total components. Memory cosumptions will be 7 times if True. ``ageThreshold`` (float): Age threshold for discriminating star-forming regions and quenched star particles, in Myr. ``logCompactnessMean``, ``logCompactnessStd`` (float): Logarithmic mean and standard deviation of compactness for star-forming star particles, see `Kapoor et al. 2021 `_. ``logPressure`` (float): Logarithmic pressure for star-forming star particles. log10[(Pressure/k_B)/cm^-3 K] = logPressure ``constantCoveringFactor`` (bool): Whether to use constant covering factor. ``coveringFactor`` (float): Constant covering factor, if constantCoveringFactor is True, see `Groves et al. 2008 `_. ``PDRClearingTimescale`` (float): PDR clearing timescale, in Myr, if constantCoveringFactor is False, see `Baes et al. 2024 `_. ``temperatureThreshold`` (float): Temperature threshold for creating dusts from gas particles, in K. ``massFraction`` (float): Fraction of the metallic gas locked up in dust. ``DISMModel`` (str): Dust ISM recipe. `Camps_2016 `_ or `Torrey_2012 `_. ``numSilicateSizes``, ``numGraphiteSizes``, ``numPAHSizes``, ``numHydrocarbonSizes`` (int): Number of bins for dust grains. Survey config ------------- ``filters`` (list): Considered filters for survey. ``resolFromPix`` (bool): Whether to use resolution derived from pixel scale. ``resolution`` (float): Spatial resolution, in pc, must be provided if resolFromPix is False, override spatialResol in config.ini. ``pixelScales`` (float, list): Pixel scale for considered filters, in arcsec. ``numExposure`` (float, list): Number of exposure for considered filters. ``exposureTime`` (float): Exposure time, in second. ``aperture`` (float): Aperture size for instrument, in meter. ``includePSF`` (bool): Whether to include PSF effects. ``PSFFromFile`` (bool): Whether to use PSF from file. ``PSFFWHM`` (list): FWHM of PSF, in arcsec. ``includeBkg`` (bool): Whether to include background. ``noiseType`` (str): By what parameters noise levels are calculated, can be instrument or limitingMagnitude. For noiseType == instrument, skyBkg, darkCurrent, readOut are required. For noiseType == limitingMagnitude, limitMag, limitSNR, limitAperture and zeroPoint are required. ``skyBkg`` (list): Background level for considered filters. Please refer to notebook `calc_sky_bkg.ipynb `_ for calculating skyBkg. ``darkCurrent`` (float, list): Dark current. ``readOut`` (float, list): Readout noise. ``limitMag`` (float, list): limiting magnitudes. ``limitSNR`` (float, list): SNR for the limiting magnitude. ``limitAperture`` (float, list): The aperture used to measure the limiting magnitude, in arcsec. ``zeroPoint`` (float): Zero point for magnitude system. ``imgDisplay`` (bool): Whether to display image. ``RGBImg`` (bool): Whether to create and display RGB image. RGB image is created from `astropy.visualization.make_rgb`, a new feature added in version 7.0.0. The RGB image may not be as one expected, feel free to edit the `convert_to_rgb` function in `utils.py`. ``RGBFilters`` (list, 3): Considered three filters for RGB image. ``displayFilter`` (str): Filter for displaying image if RGBImg is False.