Workspace functions related to simulation of radiation fluxes. More...

#include "matpack_concepts.h"
#include "messages.h"
#include "physics_funcs.h"
#include "arts.h"
#include "auto_md.h"
#include "geodetic.h"
#include "sun.h"
#include <iostream>

Functions
void	sunsAddSingleBlackbody (ArrayOfSun &suns, Index &suns_do, const Vector &f_grid, const Index &stokes_dim, const Numeric &radius, const Numeric &distance, const Numeric &temperature, const Numeric &latitude, const Numeric &longitude, const Verbosity &)
	WORKSPACE METHOD: sunsAddSingleBlackbody.

void	sunsAddSingleFromGrid (ArrayOfSun &suns, Index &suns_do, const Vector &f_grid, const Index &stokes_dim, const GriddedField2 &sun_spectrum_raw, const Numeric &radius, const Numeric &distance, const Numeric &temperature, const Numeric &latitude, const Numeric &longitude, const String &description, const Verbosity &verbosity)
	WORKSPACE METHOD: sunsAddSingleFromGrid.

void	sunsAddSingleFromGridAtLocation (ArrayOfSun &suns, Index &suns_do, const Vector &f_grid, const Index &stokes_dim, const Vector &refellipsoid, const GriddedField2 &sun_spectrum_raw, const Numeric &radius, const Numeric &distance, const Numeric &temperature, const Numeric &zenith, const Numeric &azimuth, const String &description, const Numeric &location_latitude, const Numeric &location_longitude, const Numeric &location_altitude, const Verbosity &verbosity)
	WORKSPACE METHOD: sunsAddSingleFromGridAtLocation.

void	sunsOff (Index &suns_do, ArrayOfSun &suns, const Verbosity &)
	WORKSPACE METHOD: sunsOff.

Detailed Description

Workspace functions related to simulation of radiation fluxes.

Author: Jon Petersen jon.p.nosp@m.eter.nosp@m.sen@s.nosp@m.tudi.nosp@m.um.un.nosp@m.i-ha.nosp@m.mburg.nosp@m..de Manfred Brath <manfred.brath.uni-hamburg.de>

Date: 2021-02-08

These functions are listed in the doxygen documentation as entries of the file auto_md.h.

Definition in file m_sun.cc.

Function Documentation

◆ sunsAddSingleBlackbody()

void sunsAddSingleBlackbody	(	ArrayOfSun &	suns,
		Index &	suns_do,
		const Vector &	f_grid,
		const Index &	stokes_dim,
		const Numeric &	radius,
		const Numeric &	distance,
		const Numeric &	temperature,
		const Numeric &	latitude,
		const Numeric &	longitude,
		const Verbosity &	verbosity
	)

WORKSPACE METHOD: sunsAddSingleBlackbody.

Adds a single blackbody to suns

Important note: For a Sol-like sun there are huge differences in the UV-range between the actual sun spectrum and the blackbody spectrumwith the effective temperature of the sun. The blackbody sun"strongly overestimates the UV radiation. \author Jon Petersen @param [in,out] suns WS Input/Output @param [out] suns_do WS Output @param [in] f_grid WS Input @param [in] stokes_dim WS Input @param [in] radius Generic Input (Default: "6.963242e8") @param [in] distance Generic Input (Default: "1.495978707e11") @param [in] temperature Generic Input (Default: "5772") @param [in] latitude Generic Input (Default: "0") @param [in] longitude Generic Input (Default: "0")

Definition at line 35 of file m_sun.cc.

References ARTS_USER_ERROR_IF, Sun::description, Sun::distance, Sun::latitude, Sun::longitude, planck(), Sun::radius, and Sun::spectrum.

Referenced by sunsAddSingleBlackbody_g().

◆ sunsAddSingleFromGrid()

void sunsAddSingleFromGrid	(	ArrayOfSun &	suns,
		Index &	suns_do,
		const Vector &	f_grid,
		const Index &	stokes_dim,
		const GriddedField2 &	sun_spectrum_raw,
		const Numeric &	radius,
		const Numeric &	distance,
		const Numeric &	temperature,
		const Numeric &	latitude,
		const Numeric &	longitude,
		const String &	description,
		const Verbosity &	verbosity
	)

WORKSPACE METHOD: sunsAddSingleFromGrid.

Extracts a sun spectrum from a field of such data and adds it to suns.

The method allows to obtain the sun spectrum by interpolation from a field of such data. The sun spectrum is expected to be stored as the irradiance at the suns photosphere.

Unit: GriddedField2: [W m-2 Hz-1] <br> Vector f_grid[Hz] <br> Vector stokes_dim[1]

Dimensions: [f_grid, stokes_dim]

This method performs an interpolation onto the f_grid. The point of f_grid that are outside the data frequency grid are initialized according to planck's law of the temperature variable. Hence, a temperature of 0 means 0s the edges of the f_grid.

Author: Jon Petersen

Parameters

[in,out]	suns	WS Input/Output
[out]	suns_do	WS Output
[in]	f_grid	WS Input
[in]	stokes_dim	WS Input
[in]	sun_spectrum_raw	Generic Input
[in]	radius	Generic Input (Default: "6.963242e8")
[in]	distance	Generic Input (Default: "1.495978707e11")
[in]	temperature	Generic Input (Default: "-1")
[in]	latitude	Generic Input (Default: "0")
[in]	longitude	Generic Input (Default: "0")
[in]	description	Generic Input (Default: "Sun spectrum from Griddedfield.")

Definition at line 72 of file m_sun.cc.

References ARTS_USER_ERROR_IF, Sun::description, Sun::distance, Sun::latitude, Sun::longitude, Sun::radius, regrid_sun_spectrum(), and Sun::spectrum.

Referenced by sunsAddSingleFromGrid_g().

◆ sunsAddSingleFromGridAtLocation()

void sunsAddSingleFromGridAtLocation	(	ArrayOfSun &	suns,
		Index &	suns_do,
		const Vector &	f_grid,
		const Index &	stokes_dim,
		const Vector &	refellipsoid,
		const GriddedField2 &	sun_spectrum_raw,
		const Numeric &	radius,
		const Numeric &	distance,
		const Numeric &	temperature,
		const Numeric &	zenith,
		const Numeric &	azimuth,
		const String &	description,
		const Numeric &	location_latitude,
		const Numeric &	location_longitude,
		const Numeric &	location_altitude,
		const Verbosity &	verbosity
	)

WORKSPACE METHOD: sunsAddSingleFromGridAtLocation.

Extracts a sun spectrum measured at the given location adds it to suns.

The method allows to obtain the sun spectrum by interpolation from a field of such data. The sun spectrum is expected to be stored as irradiance. It is coverted to the irradiance at the suns photosphere.

Unit: GriddedField2: [W m-2 Hz-1] <br> Vector f_grid[Hz] <br> Vector stokes_dim[1]

Dimensions: [f_grid, stokes_dim]

This method performs an interpolation onto the f_grid. The point of f_grid that are outside the data frequency grid are initialized according to planck's law of the temperature variable. Hence, a temperature of 0 means 0s the edges of the f_grid.

Author: Jon Petersen

Parameters

[in,out]	suns	WS Input/Output
[out]	suns_do	WS Output
[in]	f_grid	WS Input
[in]	stokes_dim	WS Input
[in]	refellipsoid	WS Input
[in]	sun_spectrum_raw	Generic Input
[in]	radius	Generic Input (Default: "6.963242e8")
[in]	distance	Generic Input (Default: "1.495978707e11")
[in]	temperature	Generic Input (Default: "-1")
[in]	zenith	Generic Input (Default: "0")
[in]	azimuth	Generic Input (Default: "0")
[in]	description	Generic Input (Default: "Sun spectrum from Griddedfield.")
[in]	location_latitude	Generic Input (Default: "0")
[in]	location_longitude	Generic Input (Default: "0")
[in]	location_altitude	Generic Input (Default: "1e5")

Definition at line 106 of file m_sun.cc.

References ANGTOL, ARTS_USER_ERROR_IF, cart2sph(), Sun::description, Sun::distance, Sun::latitude, Sun::longitude, poslos2cart(), Sun::radius, refell2r(), regrid_sun_spectrum(), and Sun::spectrum.

Referenced by sunsAddSingleFromGridAtLocation_g().

◆ sunsOff()

void sunsOff	(	Index &	suns_do,
		ArrayOfSun &	suns,
		const Verbosity &	verbosity
	)

WORKSPACE METHOD: sunsOff.

Turns all calculations with suns off

Author: Jon Petersen

Parameters

[out]	suns_do	WS Output
[out]	suns	WS Output

Definition at line 193 of file m_sun.cc.

Referenced by sunsOff_g().

Functions

Detailed Description

Function Documentation

◆ sunsAddSingleBlackbody()

◆ sunsAddSingleFromGrid()

◆ sunsAddSingleFromGridAtLocation()

◆ sunsOff()