Classe Op_Diff_negligeable This class represents a negligible diffusion operator. More...

#include <Op_Diff_negligeable.h>

Inheritance diagram for Op_Diff_negligeable:

Collaboration diagram for Op_Diff_negligeable:

Public Member Functions
DoubleTab &	ajouter (const DoubleTab &, DoubleTab &) const override
	Adds the contribution of the operator to an array passed as parameter.
DoubleTab &	calculer (const DoubleTab &, DoubleTab &) const override
	Initializes the array parameter with the contribution of the negligible operator: initializes the array to ZERO.
void	contribuer_a_avec (const DoubleTab &, Matrice_Morse &) const override
	Time update of a negligible operator: DOES NOTHING. Simple call to Operateur_negligeable::mettre_a_jour(double).
void	contribuer_au_second_membre (DoubleTab &) const override
	Adds the contribution to the right-hand side.
void	modifier_pour_Cl (Matrice_Morse &, DoubleTab &) const override
	DOES NOTHING - to override in derived classes.
void	dimensionner (Matrice_Morse &) const override
	DOES NOTHING - to override in derived classes.
void	mettre_a_jour (double) override
	DOES NOTHING - to override in derived classes.
void	associer_diffusivite (const Champ_base &) override
	Associates the diffusivity to the operator.
const Champ_base &	diffusivite () const override
	Returns the field representing the diffusivity.
void	associer_champ_masse_volumique (const Champ_base &) override
	Method to be called during problem preparation to ask the object to take into account the density field passed as parameter.
void	calculer_pour_post (Champ_base &espace_stockage, const Nom &option, int comp) const override
Motcle	get_localisation_pour_post (const Nom &option) const override
void	ajouter_flux (const DoubleTab &inconnue, DoubleTab &contribution) const override
void	calculer_flux (const DoubleTab &inconnue, DoubleTab &flux) const override
int	has_interface_blocs () const override
void	dimensionner_blocs (matrices_t matrices, const tabs_t &semi_impl={ }) const override
void	ajouter_blocs (matrices_t matrices, DoubleTab &resu, const tabs_t &semi_impl={ }) const override
void	check_multiphase_compatibility () const override
Public Member Functions inherited from Operateur_negligeable
DoubleTab &	ajouter (const DoubleTab &, DoubleTab &) const
	Adds the contribution of a negligible operator to an array.
DoubleTab &	calculer (const DoubleTab &, DoubleTab &) const
	Initializes the array parameter with the contribution of the negligible operator: initializes the array to ZERO.
void	mettre_a_jour (double)
	Time update of a negligible operator: DOES NOTHING.
Public Member Functions inherited from Operateur_Diff_base
virtual void	associer_diffusivite_pour_pas_de_temps (const Champ_base &)
	Associates the true diffusivity in m^2/s (in QC for example, the operator is applied to rho*u, and the dynamic viscosity is then associated to.
virtual void	associer_diffusivite_volumique (const Champ_base &)
virtual void	calculer_borne_locale (DoubleVect &, double, double) const
virtual void	init_op_ext () const
virtual bool	is_turb () const
virtual const Correlation_base *	correlation_viscosite_turbulente () const
virtual void	calculer_von_mises (const DoubleTab &deplacement, DoubleTab &deformation, DoubleTab &contraintes, DoubleTab &von_mises) const
Public Member Functions inherited from Operateur_base
virtual void	associer_champ (const Champ_Inc_base &, const std::string &nom_ch)
virtual void	associer_domaine_cl_dis (const Domaine_Cl_dis_base &)
virtual void	dimensionner_bloc_vitesse (Matrice_Morse &matrice) const
virtual void	contribuer_bloc_vitesse (const DoubleTab &, Matrice_Morse &) const
void	tester_contribuer_a_avec (const DoubleTab &, const Matrice_Morse &)
virtual void	dimensionner_termes_croises (Matrice_Morse &, const Probleme_base &autre_pb, int nl, int nc) const
virtual void	ajouter_termes_croises (const DoubleTab &inco, const Probleme_base &autre_pb, const DoubleTab &autre_inco, DoubleTab &resu) const
virtual void	contribuer_termes_croises (const DoubleTab &inco, const Probleme_base &autre_pb, const DoubleTab &autre_inco, Matrice_Morse &matrice) const
virtual double	calculer_dt_stab () const
	Computes dt_stab.
virtual void	calculer_dt_local (DoubleTab &) const
virtual void	completer ()
	Associates the operator with the domaine_dis, the domaine_Cl_dis, and the unknown of its equation.
virtual void	abortTimeStep ()
virtual void	resetTime (double time)
virtual int	impr (Sortie &os) const
	DOES NOTHING - to override in derived classes.
void	associer_eqn (const Equation_base &)
	Associates an equation with the operator.
int	get_decal_temps () const
int	set_decal_temps (int)
int	get_nb_ss_pas_de_temps () const
int	set_nb_ss_pas_de_temps (int)
const Matrice &	get_matrice () const
Matrice &	set_matrice ()
const SolveurSys &	get_solveur () const
SolveurSys &	set_solveur ()
Entree &	lire_solveur (Entree &)
virtual int	systeme_invariant () const
virtual void	ajouter_contribution_explicite_au_second_membre (const Champ_Inc_base &inconnue, DoubleTab &derivee) const
const Champ_Inc_base &	mon_inconnue () const
bool	has_champ_inco () const
const std::string &	nom_inconnue () const
void	ouvrir_fichier (SFichier &os, const Nom &, const int flag=1) const
	Opening/creation of a file for printing an operator. To override in derived classes.
void	ouvrir_fichier_partage (EcrFicPartage &, const Nom &, const int flag=1) const
	Opening/creation of a shared file for printing an operator. To override in derived classes.
void	set_fichier (const Nom &)
const Nom	fichier () const
void	set_description (const Nom &nom)
const Nom	description () const
DoubleTab &	flux_bords ()
DoubleTab &	flux_bords () const
void	creer_champ (const Motcle &motlu) override
const Champ_base &	get_champ (const Motcle &nom) const override
bool	has_champ (const Motcle &nom, OBS_PTR(Champ_base) &ref_champ) const override
bool	has_champ (const Motcle &nom) const override
void	get_noms_champs_postraitables (Noms &nom, Option opt=NONE) const override
void	calculer_pour_post (Champ_base &espace_stockage, const Nom &option, int comp) const override
Motcle	get_localisation_pour_post (const Nom &option) const override
virtual void	preparer_calcul ()
bool	has_impr_file () const
Public Member Functions inherited from Objet_U
	~Objet_U () override
	Destructor. Removes the object from the list of objects registered in "memory".
int	numero () const
	Returns the index of the object in Memoire::data.
virtual int	duplique () const =0
virtual Sortie &	printOn (Sortie &) const
	Writes the object to an output stream. Virtual method to override.
virtual Entree &	readOn (Entree &)
	Reads an Objet_U from an input stream. Virtual method to override.
virtual unsigned	taille_memoire () const =0
virtual int	est_egal_a (const Objet_U &) const
	Returns 1 if x and *this are the same instance (same memory address).
virtual const Nom &	le_nom () const
	Returns the name of the Objet_U. Virtual method to override: returns "neant" in this implementation.
virtual void	nommer (const Nom &)
	Assigns a name to the Objet_U. Virtual method to override.
virtual int	reprendre (Entree &)
	Restores an Objet_U from an input stream. Virtual method to override.
virtual int	sauvegarder (Sortie &) const
	Saves an Objet_U to an output stream. Virtual method to override.
int	get_object_id () const
	Returns the unique identifier of the object (object_id_).
virtual const Type_info *	get_info () const
	Returns type information for the Objet_U.
const Nom &	que_suis_je () const
	Returns the string identifying the class.
const char *	le_type () const
	Returns the type name of the Objet_U.
virtual int	change_num (const int *const)
	Changes the internal number of the Objet_U.
virtual int	lire_motcle_non_standard (const Motcle &motlu, Entree &is)
	Reads non-simple-type parameters of an Objet_U from an input stream.
virtual int	associer_ (Objet_U &)
	Associates the Objet_U with another Objet_U. Virtual method to override.
const Interprete &	interprete () const
Interprete &	interprete ()
Public Member Functions inherited from Process
virtual	~Process ()
Public Member Functions inherited from MorEqn
void	associer_eqn (const Equation_base &)
	Associates an equation with the object.
const Equation_base &	equation () const
	Returns the reference to the equation pointed to by MorEqn::mon_equation.
Equation_base &	equation ()
	Returns the reference to the equation pointed to by MorEqn::mon_equation.
int	mon_equation_non_nul () const
Public Member Functions inherited from Champs_compris_interface
virtual	~Champs_compris_interface ()
virtual bool	has_champ (const Motcle &nom, OBS_PTR(Champ_base)&ref_champ) const =0
Public Member Functions inherited from Support_Champ_Masse_Volumique
	Support_Champ_Masse_Volumique ()
	Constructor of the class.
virtual	~Support_Champ_Masse_Volumique ()
	Virtual destructor (to avoid warnings).
virtual void	dissocier_champ_masse_volumique ()
	Cancels the reference to the density field.
virtual int	has_champ_masse_volumique () const
	Returns 1 if the density field has been associated, 0 otherwise.
virtual const Champ_base &	get_champ_masse_volumique () const
	Returns the density field.
const int &	support_ok () const

Protected Member Functions
	OBS_PTR (Champ_base) la_diffusivite
void	associer (const Domaine_dis_base &, const Domaine_Cl_dis_base &, const Champ_Inc_base &) override
	Associates various objects to a negligible operator: DOES NOTHING Simple call to Operateur_negligeable::associer(const Domaine_dis_base&,.
Protected Member Functions inherited from Operateur_negligeable
void	associer (const Domaine_dis_base &, const Domaine_Cl_dis_base &, const Champ_Inc_base &)
	Associates various objects to a negligible operator: DOES NOTHING.
Protected Member Functions inherited from Operateur_Diff_base
virtual const Champ_base &	diffusivite_pour_pas_de_temps () const
	Returns the field corresponding to the true diffusivity of the medium used for the time step computation.
	OBS_PTR (Champ_base) diffusivite_pour_pas_de_temps_
Protected Member Functions inherited from Operateur_base
	OBS_PTR (Champ_Inc_base) le_champ_inco
Protected Member Functions inherited from Objet_U
	Objet_U ()
	Default constructor: assigns a unique identifier to the object (object_id_) and registers the object in "memory" by giving it a num_obj number.
	Objet_U (const Objet_U &)
	Copy constructor.
const Objet_U &	operator= (const Objet_U &)
	Assignment operator: does nothing (the number and identifier are preserved).
virtual void	set_param (Param &) const
Protected Member Functions inherited from MorEqn
	OBS_PTR (Equation_base) mon_equation
virtual	~MorEqn ()
Protected Member Functions inherited from Support_Champ_Masse_Volumique
virtual void	declare_support_masse_volumique (int ok)
	The constructor of a derived class that uses the density field must call this function with the value 1.

Additional Inherited Members
Static Public Member Functions inherited from Objet_U
static const Nom &	nom_du_cas ()
	Returns a constant reference to the case name. This method is static.
static Nom &	get_set_nom_du_cas ()
	Returns a non-constant reference to the case name (to allow modification). This method is static.
static const Type_info *	info ()
	Returns type information for the Objet_U (static version).
static const Objet_U &	self_cast (const Objet_U &)
	Method added for casting in Python.
static Objet_U &	self_cast (Objet_U &)
Static Public Member Functions inherited from Process
static int	me ()
	Returns the rank of the local processor in the current communication group. See Comm_Group::rank() and PE_Groups::current_group().
static int	nproc ()
	Returns the number of processors in the current group. See Comm_Group::nproc() and PE_Groups::current_group().
static bool	is_parallel ()
static void	exit (int exit_code=-1)
	Exit routine for TRUST within a Kokkos region.
static double	mp_sum (double)
	Computes the sum of x over all processors in the current group.
static float	mp_sum (float)
static trustIdType	mp_sum (trustIdType)
	Computes the sum of x over all processors in the current group.
static double	mp_max (double)
static double	mp_min (double)
static int	mp_max (int)
	Returns the maximum value of x across all processors in the current group.
static int	mp_min (int)
	Returns the minimum value of x across all processors in the current group.
static double	mp_sum_as_double (int v)
static trustIdType	mppartial_sum (trustIdType i)
	Computes the partial sum of x over processors 0 to me()-1 (returns 0 on processor 0).
template<typename T>
static void	mp_sum_for_each (T &arg1, T &arg2)
	C++14 compatible mp_sum_for_each: combine multiple mp_sum calls into one collective operation Usage: mp_sum_for_each(a, b); mp_sum_for_each(a, b, c); mp_sum_for_each(a, b, c, d); mp_sum_for_each(a, b, c, d, e); All arguments must be of the same type (double or int) and are modified in place. Supports 2-5 parameters.
template<typename T>
static void	mp_sum_for_each (T &arg1, T &arg2, T &arg3)
template<typename T>
static void	mp_sum_for_each (T &arg1, T &arg2, T &arg3, T &arg4)
template<typename T>
static void	mp_sum_for_each (T &arg1, T &arg2, T &arg3, T &arg4, T &arg5)
template<typename T>
static void	mp_max_for_each (T &arg1, T &arg2)
	C++14 compatible mp_max_for_each: combine multiple mp_max calls into one collective operation.
template<typename T>
static void	mp_max_for_each (T &arg1, T &arg2, T &arg3)
template<typename T>
static void	mp_max_for_each (T &arg1, T &arg2, T &arg3, T &arg4)
template<typename T>
static void	mp_max_for_each (T &arg1, T &arg2, T &arg3, T &arg4, T &arg5)
template<typename T>
static void	mp_min_for_each (T &arg1, T &arg2)
	C++14 compatible mp_min_for_each: combine multiple mp_min calls into one collective operation.
template<typename T>
static void	mp_min_for_each (T &arg1, T &arg2, T &arg3)
template<typename T>
static void	mp_min_for_each (T &arg1, T &arg2, T &arg3, T &arg4)
template<typename T>
static void	mp_min_for_each (T &arg1, T &arg2, T &arg3, T &arg4, T &arg5)
template<typename _TYPE_>
static void	mp_sum_for_each_item (TRUSTArray< _TYPE_ > &x, int n=-1)
template<typename _TYPE_>
static void	mp_max_for_each_item (TRUSTArray< _TYPE_ > &x, int n=-1)
template<typename _TYPE_>
static void	mp_min_for_each_item (TRUSTArray< _TYPE_ > &x, int n=-1)
static bool	mp_and (bool)
	Computes the logical AND of b across all processors in the current group.
static bool	mp_or (bool)
static int	check_int_overflow (trustIdType)
static int	je_suis_maitre ()
	Returns 1 if on the master processor of the current group (i.e. me() == 0), 0 otherwise.
static KOKKOS_INLINE_FUNCTION void	Kokkos_exit (const char *)
	Exit routine for TRUST within a Kokkos region.
static int	node_master ()
	Returns 1 if on the NUMA node master processor, 0 otherwise.
static void	exit (const Nom &message, int exit_code=-1)
static bool	is_sequential ()
static void	barrier ()
	Synchronizes all processors in the current group (waits until all processors have reached the barrier).
static void	abort ()
	Abort routine for TRUST on a fatal error.
static Sortie &	Journal (int message_level=0)
	Returns a static Sortie object used as an event journal.
static double	ram_processeur ()
static void	imprimer_ram_totale (int all_process=0)
static bool	force_single_file (const int ranks, const Nom &filename)
Public Attributes inherited from Operateur_Diff_base
std::vector< const Operateur_Diff_base * >	op_ext
Public Attributes inherited from Operateur_base
int	col_width_
Static Public Attributes inherited from Objet_U
static double	precision_geom = 1e-10
static constexpr bool	HAS_POINTER = false
static int	dimension =0
static int	format_precision_geom =11
static int	axi =0
static int	bidim_axi =0
static int	DEACTIVATE_SIGINT_CATCH =0
static Type_info	info_obj
static bool	disable_TU =false
	Flag to disable or not the writing of the .TU files.
static bool	stat_per_proc_perf_log =false
	Flag to enable the writing of the statistics detailed per processor in _csv.TU file.
Static Public Attributes inherited from Process
static int	exception_sur_exit =0
static int	multiple_files =5120
Protected Attributes inherited from Operateur_base
int	decal_temps
int	nb_ss_pas_de_temps
SolveurSys	solveur
Matrice	matrice_
Nom	out_
Nom	description_
DoubleTab	flux_bords_
Champs_compris	champs_compris_
std::string	nom_inco_

Detailed Description

Classe Op_Diff_negligeable This class represents a negligible diffusion operator.

When an operator of this type is used in an equation, it amounts to neglecting the diffusion term. The methods for modifying and participating in a computation of the operator are in fact calls to the same methods of Operateur_negligeable which do nothing.

See also: Operateur_Diff_base Operateur_negligeable

Definition at line 37 of file Op_Diff_negligeable.h.

Member Function Documentation

◆ ajouter()

DoubleTab & Op_Diff_negligeable::ajouter	(	const DoubleTab &	x,
		DoubleTab &	y ) const

inlineoverridevirtual

Adds the contribution of the operator to an array passed as parameter.

Simple call to Operateur_negligeable::ajouter(const DoubleTab&,DoubleTab&)

Parameters

(DoubleTab&	x) the array on which the operator is applied
(DoubleTab&	y) array to which the operator contribution is added

Returns: (DoubleTab&) the input parameter y unchanged

Reimplemented from Operateur_base.

Definition at line 89 of file Op_Diff_negligeable.h.

◆ ajouter_blocs()

void Op_Diff_negligeable::ajouter_blocs	(	matrices_t	matrices,
		DoubleTab &	resu,
		const tabs_t &	semi_impl = { } ) const

inlineoverridevirtual

Reimplemented from Operateur_base.

Definition at line 65 of file Op_Diff_negligeable.h.

◆ ajouter_flux()

void Op_Diff_negligeable::ajouter_flux	(	const DoubleTab &	inconnue,
		DoubleTab &	contribution ) const

overridevirtual

Reimplemented from Operateur_base.

Definition at line 72 of file Op_Diff_negligeable.cpp.

◆ associer()

void Op_Diff_negligeable::associer	(	const Domaine_dis_base &	z,
		const Domaine_Cl_dis_base &	zcl,
		const Champ_Inc_base &	ch )

inlineoverrideprotectedvirtual

Associates various objects to a negligible operator: DOES NOTHING Simple call to Operateur_negligeable::associer(const Domaine_dis_base&,.

                                                const Domaine_Cl_dis_base&,
                                                const Champ_Inc_base&)

Parameters

(Domaine_dis_base&	z)
(Domaine_Cl_dis_base&	zcl)
(Champ_Inc_base&	ch)

Implements Operateur_base.

Definition at line 159 of file Op_Diff_negligeable.h.

◆ associer_champ_masse_volumique()

void Op_Diff_negligeable::associer_champ_masse_volumique ( const Champ_base & ch )

inlineoverridevirtual

Method to be called during problem preparation to ask the object to take into account the density field passed as parameter.

Reimplemented from Support_Champ_Masse_Volumique.

Definition at line 167 of file Op_Diff_negligeable.h.

◆ associer_diffusivite()

void Op_Diff_negligeable::associer_diffusivite ( const Champ_base & ch )

overridevirtual

Associates the diffusivity to the operator.

Parameters

(Champ_Don_base& ch) the field representing the diffusivity

Implements Operateur_Diff_base.

Definition at line 36 of file Op_Diff_negligeable.cpp.

◆ calculer()

DoubleTab & Op_Diff_negligeable::calculer	(	const DoubleTab &	x,
		DoubleTab &	y ) const

inlineoverridevirtual

Initializes the array parameter with the contribution of the negligible operator: initializes the array to ZERO.

Simple call to Operateur_negligeable::(calculer(const DoubleTab&, DoubleTab&)

Parameters

(DoubleTab&	x) the array on which the operator is applied
(DoubleTab&	y) array in which the operator contribution is stored

Returns: (DoubleTab&) the input array y set to zero

Reimplemented from Operateur_base.

Definition at line 104 of file Op_Diff_negligeable.h.

◆ calculer_flux()

void Op_Diff_negligeable::calculer_flux	(	const DoubleTab &	inconnue,
		DoubleTab &	flux ) const

overridevirtual

Reimplemented from Operateur_base.

Definition at line 77 of file Op_Diff_negligeable.cpp.

◆ calculer_pour_post()

void Op_Diff_negligeable::calculer_pour_post	(	Champ_base &	espace_stockage,
		const Nom &	option,
		int	comp ) const

overridevirtual

Reimplemented from MorEqn.

Definition at line 50 of file Op_Diff_negligeable.cpp.

◆ check_multiphase_compatibility()

void Op_Diff_negligeable::check_multiphase_compatibility ( ) const

inlineoverridevirtual

Reimplemented from MorEqn.

Definition at line 66 of file Op_Diff_negligeable.h.

◆ contribuer_a_avec()

void Op_Diff_negligeable::contribuer_a_avec	(	const DoubleTab &	inco,
		Matrice_Morse &	amatrice ) const

inlineoverridevirtual

Time update of a negligible operator: DOES NOTHING. Simple call to Operateur_negligeable::mettre_a_jour(double).

Parameters

(double temps) the current time

Assembles the matrix.

Reimplemented from Operateur_base.

Definition at line 118 of file Op_Diff_negligeable.h.

◆ contribuer_au_second_membre()

void Op_Diff_negligeable::contribuer_au_second_membre ( DoubleTab & resu ) const

inlineoverridevirtual

Adds the contribution to the right-hand side.

Reimplemented from Operateur_base.

Definition at line 128 of file Op_Diff_negligeable.h.

◆ diffusivite()

const Champ_base & Op_Diff_negligeable::diffusivite ( ) const

overridevirtual

Returns the field representing the diffusivity.

Returns: (Champ_Don_base&) the field representing the diffusivity

Implements Operateur_Diff_base.

Definition at line 45 of file Op_Diff_negligeable.cpp.

◆ dimensionner()

void Op_Diff_negligeable::dimensionner ( Matrice_Morse & mat ) const

inlineoverridevirtual

DOES NOTHING - to override in derived classes.

Parameters

(Matrice_Morse&) a matrix in Morse format

Exceptions

method to override

Reimplemented from Operateur_base.

Definition at line 139 of file Op_Diff_negligeable.h.

◆ dimensionner_blocs()

void Op_Diff_negligeable::dimensionner_blocs	(	matrices_t	matrices,
		const tabs_t &	semi_impl = { } ) const

inlineoverridevirtual

Reimplemented from Operateur_base.

Definition at line 64 of file Op_Diff_negligeable.h.

◆ get_localisation_pour_post()

Motcle Op_Diff_negligeable::get_localisation_pour_post ( const Nom & option ) const

overridevirtual

Reimplemented from MorEqn.

Definition at line 61 of file Op_Diff_negligeable.cpp.

◆ has_interface_blocs()

int Op_Diff_negligeable::has_interface_blocs ( ) const

inlineoverridevirtual

Reimplemented from Operateur_base.

Definition at line 60 of file Op_Diff_negligeable.h.

◆ mettre_a_jour()

void Op_Diff_negligeable::mettre_a_jour ( double temps )

inlineoverridevirtual

DOES NOTHING - to override in derived classes.

Update of the operator

Parameters

(double) a time step

Reimplemented from Operateur_base.

Definition at line 144 of file Op_Diff_negligeable.h.

◆ modifier_pour_Cl()

void Op_Diff_negligeable::modifier_pour_Cl	(	Matrice_Morse &	,
		DoubleTab &	) const

inlineoverridevirtual

DOES NOTHING - to override in derived classes.

Parameters

(Matrice_Morse&)	a matrix in Morse format
(DoubleTab&)	a double-valued array

Exceptions

method to override

Reimplemented from Operateur_base.

Definition at line 134 of file Op_Diff_negligeable.h.

◆ OBS_PTR()

Op_Diff_negligeable::OBS_PTR ( Champ_base )

protected

The documentation for this class was generated from the following files:

/home/docs/trust-code/src/Kernel/Operateurs/Op_Diff_negligeable.h
/home/docs/trust-code/src/Kernel/Operateurs/Op_Diff_negligeable.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ ajouter()

◆ ajouter_blocs()

◆ ajouter_flux()

◆ associer()

◆ associer_champ_masse_volumique()

◆ associer_diffusivite()

◆ calculer()

◆ calculer_flux()

◆ calculer_pour_post()

◆ check_multiphase_compatibility()

◆ contribuer_a_avec()

◆ contribuer_au_second_membre()

◆ diffusivite()

◆ dimensionner()

◆ dimensionner_blocs()

◆ get_localisation_pour_post()

◆ has_interface_blocs()

◆ mettre_a_jour()

◆ modifier_pour_Cl()

◆ OBS_PTR()