# ARTS built-in documentation server

## Workspace Method DoitGetIncoming

### Description

Calculates incoming radiation field of the cloudbox by repeated radiative transfer calculations. The method performs monochromatic pencil beam calculations for all grid positions on the cloudbox boundary, and all directions given by scattering angle grids (aa_grid). Found radiances are stored in cloudbox_field which can be used as boundary conditions when scattering inside the cloud box is solved by the DoitCalc method. Note that cloudbox_field will always hold intensity in terms of radiances, regardless of the setting of iy_unit (unit conversion is done within yCalc or iyCalc, which will provide their output in terms of the specified iy_unit; no explicit unit conversion by the user necessary.).

**Authors: **Sreerekha T.R., Claudia Emde

### Synopsis

DoitGetIncoming( | cloudbox_field, atmfields_checked, atmgeom_checked, cloudbox_checked, doit_is_initialized, iy_main_agenda, atmosphere_dim, lat_grid, lon_grid, z_field, nlte_field, cloudbox_on, cloudbox_limits, f_grid, stokes_dim, za_grid, aa_grid, rigorous, maxratio ) |

### Variables

OUT+IN | cloudbox_field | (Tensor7) | The spectral radiance field inside the cloudbx. |

IN | atmfields_checked | (Index) | OK-flag for atmospheric grids and (physical) fields. |

IN | atmgeom_checked | (Index) | OK-flag for the geometry of the model atmosphere. |

IN | cloudbox_checked | (Index) | OK-flag for variables associated with the cloudbox. |

IN | doit_is_initialized | (Index) | Flag to determine if DoitInit was called. |

IN | iy_main_agenda | (Agenda) | Calculation of a single monochromatic pencil beam spectrum. |

IN | atmosphere_dim | (Index) | The atmospheric dimensionality (1-3). |

IN | lat_grid | (Vector) | The latitude grid. |

IN | lon_grid | (Vector) | The longitude grid. |

IN | z_field | (Tensor3) | The field of geometrical altitudes. |

IN | nlte_field | (EnergyLevelMap) | The field of NLTE temperatures and/or ratios. |

IN | cloudbox_on | (Index) | Flag to activate the cloud box. |

IN | cloudbox_limits | (ArrayOfIndex) | The limits of the cloud box. |

IN | f_grid | (Vector) | The frequency grid for monochromatic pencil beam calculations. |

IN | stokes_dim | (Index) | The dimensionality of the Stokes vector (1-4). |

IN | za_grid | (Vector) | Zenith angle grid. |

IN | aa_grid | (Vector) | Azimuthal angle grid. |

GIN | rigorous | (Index, Default: 1) | Fail if incoming field is not safely interpolable. |

GIN | maxratio | (Numeric, Default: 100) | Maximum allowed ratio of two radiances regarded as interpolable. |