Chapter A1
Functions Alphabetically

CCTK_Abort

[A45] Causes abnormal Cactus termination

CCTK_ActivatingThorn

[A50] Finds the thorn which activated a particular implementation

CCTK_ActiveTimeLevels

[A52] Returns the number of active timelevels from a group name

CCTK_ActiveTimeLevelsGI

[A52] Returns the number of active timelevels from a group index

CCTK_ActiveTimeLevelsGN

[A52] Returns the number of active timelevels from a group name

CCTK_ActiveTimeLevelsVI

[A52] Returns the number of active timelevels from a variable index

CCTK_ActiveTimeLevelsVN

[A52] Returns the number of active timelevels from a variable name

CCTK_ArrayGroupSize

[A55] Returns a pointer to the local size for a group, given by its group name

CCTK_ArrayGroupSizeI

[A58] Returns a pointer to the local size for a group, given by its group index

CCTK_Barrier

[A60] Synchronizes all processors

CCTK_ClockRegister

[A62] Registers a new named clock with the Flesh.

CCTK_Cmplx

[A63] Turns two real numbers into a complex number (only C) [deprecated]

CCTK_CmplxAbs

[A65] Returns the absolute value of a complex number (only C) [deprecated]

CCTK_CmplxAdd

[A67] Returns the sum of two complex numbers (only C) [deprecated]

CCTK_CmplxConjg

[A69] Returns the complex conjugate of a complex number (only C) [deprecated]

CCTK_CmplxCos

[A71] Returns the Cosine of a complex number (only C) [deprecated]

CCTK_CmplxDiv

[A73] Returns the division of two complex numbers (only C) [deprecated]

CCTK_CmplxExp

[A75] Returns the Exponentiation of a complex number (only C) [deprecated]

CCTK_CmplxImag

[A77] Returns the imaginary part of a complex number (only C) [deprecated]

CCTK_CmplxLog

[A79] Returns the Logarithm of a complex number (only C) [deprecated]

CCTK_CmplxMul

[A81] Returns the multiplication of two complex numbers (only C) [deprecated]

CCTK_CmplxReal

[A83] Returns the real part of a complex number (only C) [deprecated]

CCTK_CmplxSin

[A85] Returns the Sine of a complex number (only C) [deprecated]

CCTK_CmplxSqrt

[A87] Returns the square root of a complex number (only C) [deprecated]

CCTK_CmplxSub

[A89] Returns the subtraction of two complex numbers (only C) [deprecated]

CCTK_CommandLine

[A91] Gets the command line arguments.

CCTK_CompileDate

[A92] Returns a formatted string containing the date stamp when Cactus was compiled

CCTK_CompileDateTime

[A93] Returns a formatted string containing the datetime stamp when Cactus was compiled

CCTK_CompileTime

[A94] Returns a formatted string containing the time stamp when Cactus was compiled

CCTK_CompiledImplementation

[A95] Return the name of the compiled implementation with given index

CCTK_CompiledThorn

[A97] Return the name of the compiled thorn with given index

CCTK_CoordDir

[A99] Give the direction for a given coordinate name (deprecated)

CCTK_CoordIndex

[A103] Give the grid variable index for a given coordinate (deprecated)

CCTK_CoordRange

[A107] Return the global upper and lower bounds for a given coordinate name on a cctkGH (deprecated)

CCTK_CoordRegisterData

[A111] Register a coordinate as belonging to a coordinate system, with a given name and direction, and optionally with a grid variable (deprecated)

CCTK_CoordRegisterRange

[A115] Saves the global upper and lower bounds for a given coordinate name on a cctkGH (deprecated)

CCTK_CoordRegisterSystem

[A119] Registers a coordinate system with a given dimension (deprecated)

CCTK_CoordSystemDim

[A123] Provides the dimension of a given coordinate system (deprecated)

CCTK_CoordSystemHandle

[A127] Get the handle associated with a registered coordinate system (deprecated)

CCTK_CoordSystemName

[A131] Provides the name of the coordinate system identified by its handle (deprecated)

CCTK_CreateDirectory

[A133] Creates a directory

CCTK_DeclaredTimelevels

[A137] Gives the maximum number of timelevels for a group

CCTK_DeclaredTimelevelsGI

[A141] Gives the maximum number of timelevels for a group

CCTK_DeclaredTimelevelsGN

[A145] Gives the maximum number of timelevels for a group

CCTK_DeclaredTimelevelsVI

[A146] Gives the maximum number of timelevels for a variable

CCTK_DeclaredTimelevelsVN

[A150] Gives the maximum number of timelevels for a variable

CCTK_DecomposeName

[A154] Given the full name of a variable/group, separates the name returning both the implementation and the variable/group

CCTK_DisableGroupComm

[A156] Disable the communication for a group

CCTK_DisableGroupCommI

[A157] Disable the communication for a group

CCTK_DisableGroupStorage

[A159] Disable the storage for a group

CCTK_DisableGroupStorageI

[A160] Disable the storage for a group

CCTK_EnableGroupComm

[A161] Enable the communication for a group

CCTK_EnableGroupCommI

[A163] Enable the communication for a group

CCTK_EnableGroupStorage

[A165] Enable the storage for a group

CCTK_EnableGroupStorageI

[A166] Enable the storage for a group

CCTK_Equals

[A167] Check a STRING or KEYWORD parameter for equality equality with a given string

CCTK_ERROR

[A172] Macro to print a single string as error message to standard error and stop the code

CCTK_Error

[A177] Function to print a single string as error message to standard error and stop the code

CCTK_Exit

[A180] Causes normal Cactus termination

CCTK_FirstVarIndex

[A183] Given a group name returns the first variable index in the group

CCTK_FirstVarIndexI

[A186] Given a group index returns the first variable index in the group

CCTK_FortranString

[A189] Copy the contents of a C string into a Fortran string variable

CCTK_FullName

[A196] Given a variable index, returns the full name of the variable

CCTK_FullVarName

[??] Given a variable index, returns the full name of the variable

CCTK_GetClockName

[A199] Given a pointer to a clock cTimerVal structure, returns the name of the clock.

CCTK_GetClockResolution

[A200] Given a pointer to a clock cTimerVal structure, returns the resolution of the clock.

CCTK_GetClockSeconds

[A201] Given a pointer to a clock cTimerVal structure, returns the elapsed time.

CCTK_GetClockValue

[A202] Given the name of a clock, returns a pointer to the corresponding cTimerVal structure within the cTimerData structure.

CCTK_GetClockValueI

[A203] Given the index of a clock, returns a pointer to the corresponding cTimerVal structure within the cTimerData structure.

CCTK_GHExtension

[A204] Get the pointer to a registered extension to the Cactus GH structure

CCTK_GHExtensionHandle

[A206] Get the handle associated with a extension to the Cactus GH structure

CCTK_GridArrayReductionOperator

[A210] The name of the implementation of a grid array reduction operator, or NULL if the handle is invalid

CCTK_GroupbboxGI

[A211] Given a group index, return an array of the bounding box of the group for each face

CCTK_GroupbboxGN

[A211] Given a group name, return an array of the bounding box of the group for each face

CCTK_GroupbboxVI

[A215] Given a variable index, return an array of the bounding box of the variable for each face

CCTK_GroupbboxVN

[A215] Given a variable name, return an array of the bounding box of the variable for each face

CCTK_GroupData

[A218] Given a group index, returns information about the variables held in the group

CCTK_GroupDimFromVarI

[A222] Given a variable index, returns the dimension of all variables in the group associated with this variable

CCTK_GroupDimI

[A224] Given a group index, returns the dimension of variables in that group

CCTK_GroupDynamicData

[A227] Given a group index, returns information about the variables held in the group

CCTK_GroupGhostsizesI

[A230] Given a group index, returns the ghost size array of that group

CCTK_GroupgshGI

[A231] Given a group index, return an array of the global size of the group in each dimension

CCTK_GroupgshGN

[A231] Given a group name, return an array of the global size of the group in each dimension

CCTK_GroupgshVI

[A235] Given a variable index, return an array of the global size of the variable in each dimension

CCTK_GroupgshVN

[A235] Given a variable name, return an array of the global size of the variable in each dimension

CCTK_GroupIndex

[A238] Get the index number for a group name

CCTK_GroupIndexFromVar

[A242] Given a variable name, returns the index of the associated group

CCTK_GroupIndexFromVarI

[A246] Given a variable index, returns the index of the associated group

CCTK_GrouplbndGI

[A250] Given a group index, return an array of the lower bounds of the group in each dimension

CCTK_GrouplbndGN

[A250] Given a group name, return an array of the lower bounds of the group in each dimension

CCTK_GrouplbndVI

[A253] Given a variable index, return an array of the lower bounds of the variable in each dimension

CCTK_GrouplbndVN

[A253] Given a variable name, return an array of the lower bounds of the variable in each dimension

CCTK_GrouplshGI

[A256] Given a group index, return an array of the local size of the group in each dimension

CCTK_GrouplshGN

[A256] Given a group name, return an array of the local size of the group in each dimension

CCTK_GrouplshVI

[A259] Given a variable index, return an array of the local size of the variable in each dimension

CCTK_GrouplshVN

[A259] Given a variable name, return an array of the local size of the variable in each dimension

CCTK_GroupashGI

[A262] Given a group index, return an array of the local allocated size of the group in each dimension

CCTK_GroupashGN

[A262] Given a group name, return an array of the local allocated size of the group in each dimension

CCTK_GroupashVI

[A265] Given a variable index, return an array of the local allocated size of the variable in each dimension

CCTK_GroupashVN

[A265] Given a variable name, return an array of the local allocated size of the variable in each dimension

CCTK_GroupName

[A268] Given a group index, returns the group name

CCTK_GroupNameFromVarI

[A270] Given a variable index, return the name of the associated group

CCTK_GroupnghostzonesGI

[A272] Given a group index, return an array with the number of ghostzones in each dimension of the group

CCTK_GroupnghostzonesGN

[A272] Given a group name, return an array with the number of ghostzones in each dimension of the group

CCTK_GroupnghostzonesVI

[A275] Given a variable index, return an array with the number of ghostzones in each dimension of the variable’s group

CCTK_GroupnghostzonesVN

[A275] Given a group variable, return an array with the number of ghostzones in each dimension of the variable’s group

CCTK_GroupSizesI

[A278] Given a group index, returns the size array of that group

CCTK_GroupStorageDecrease

[A279] Decrease the active number of timelevels for a list of groups

CCTK_GroupStorageIncrease

[A282] Increase the active number of timelevels for a list of groups

CCTK_GroupTagsTable

[A284] Given a group name, return the table handle of the group’s tags table.

CCTK_GroupTagsTableI

[A287] Given a group index, return the table handle of the group’s tags table.

CCTK_GroupTypeFromVarI

[A290] Provides a group’s group type index given a variable index

CCTK_GroupTypeI

[A294] Provides a group’s group type index given a group index

CCTK_GroupubndGI

[A295] Given a group index, return an array of the upper bounds of the group in each dimension

CCTK_GroupubndGN

[A295] Given a group name, return an array of the upper bounds of the group in each dimension

CCTK_GroupubndVI

[A299] Given a variable index, return an array of the upper bounds of the variable in each dimension

CCTK_GroupubndVN

[A299] Given a variable name, return an array of the upper bounds of the variable in each dimension

CCTK_ImpFromVarI

[A302] Given a variable index, returns the implementation name for a public or protected variable, the thorn name otherwise.

CCTK_ImplementationRequires

[A304] Return the ancestors for an implementation

CCTK_ImplementationThorn

[A306] Returns the name of one thorn providing an implementation

CCTK_ImpThornList

[A308] Return the thorns for an implementation

CCTK_INFO

[A310] Macro to print a single string as an information message to screen

CCTK_Info

[A315] Function to print a single string as an information message to screen

CCTK_InfoCallbackRegister

[A319] Register one or more routines for dealing with information messages in addition to printing them to screen

CCTK_InterpGridArrays

[A322] Performs an interpolation on a list of CCTK grid variables, using a chosen external local interpolation operator

CCTK_InterpHandle

[A331] Returns the handle for a given interpolation operator

CCTK_InterpLocalUniform

[A335] Interpolate a list of processor-local arrays which define a uniformly-spaced data grid

CCTK_InterpRegisterOpLocalUniform

[A342] Registers a routine as a CCTK_InterpLocalUniform interpolation operator

CCTK_IsFunctionAliased

[A345] Reports whether an aliased function has been provided

CCTK_IsImplementationActive

[A347] Reports whether an implementation was activated in a parameter file

CCTK_IsImplementationCompiled

[A349] Reports whether an implementation was compiled into a configuration

CCTK_IsThornActive

[A351] Reports whether a thorn was activated in a parameter file

CCTK_IsThornCompiled

[A353] Reports whether a thorn was compiled into a configuration

CCTK_LocalArrayReduceOperator

[A356] Returns the name of a registered reduction operator

CCTK_LocalArrayReduceOperatorImplementation

[A358] Provide the implementation which provides an local array reduction operator

CCTK_LocalArrayReductionHandle

[A360] Returns the handle of a given local array reduction operator

CCTK_MaxActiveTimeLevels

[A362] Returns the maximum number of timeleves that were ever active from a group name

CCTK_MaxActiveTimeLevelsGI

[A362] Returns the maximum number of timeleves that were ever active from a group index

CCTK_MaxActiveTimeLevelsGN

[A362] Returns the maximum number of timeleves that were ever active from a group name

CCTK_MaxActiveTimeLevelsVI

[A362] Returns the maximum number of timeleves that were ever active from a variable index

CCTK_MaxActiveTimeLevelsVN

[A362] Returns the maximum number of timeleves that were ever active from a variable name

CCTK_MaxDim

[A365] Get the maximum dimension of any grid variable

CCTK_MaxGFDim

[A369] Get the maximum dimension of all grid functions

CCTK_MaxTimeLevels

[A373] Decprecated. Use CCTK_DeclaredTimeLevels instead.

CCTK_MyProc

[A373] Get the local processor number

CCTK_nProcs

[A374] Get the total number of processors used

CCTK_NullPointer

[A376] Returns a C-style NULL pointer value

CCTK_NumCompiledImplementations

[A378] Return the number of implementations compiled in

CCTK_NumCompiledThorns

[A380] Return the number of thorns compiled in

CCTK_NumGridArrayReductionOperators

[A382] The number of grid array reduction operators registered

CCTK_NumGroups

[A384] Get the number of groups of variables compiled in the code

CCTK_NumIOMethods

[A388] Returns the total number of I/O methods registered with the flesh

CCTK_NumLocalArrayReduceOperators

[A390] The number of local reduction operators registered

CCTK_NumReductionArraysGloballyOperators

[A392] The number of global array reduction operators registered

CCTK_NumTimerClocks

[A393] Returns the number of clocks in a cTimerData structure.

CCTK_NumVars

[A395] Get the number of grid variables compiled in the code

CCTK_NumVarsInGroup

[A399] Provides the number of variables in a group from the group name

CCTK_NumVarsInGroupI

[A403] Provides the number of variables in a group from the group index

CCTK_OutputGH

[A407] Conditional output of all variables on a GH by all I/O methods

CCTK_OutputVar

[A409] Output of a single variable by all I/O methods

CCTK_OutputVarAs

[A411] Output of a single variable as an alias by all I/O methods

CCTK_OutputVarAsByMethod

[A414] Output of a single variable as an alias by a single I/O method

CCTK_OutputVarByMethod

[A417] Output of a single variable by a single I/O method

CCTK_ParallelInit

[A420] Initializes the parallel subsystem

CCTK_ParameterData

[A422] Get parameter properties for given parameter/thorn pair

CCTK_ParameterGet

[A426] Get the data pointer to and type of a parameter’s value

CCTK_ParameterFilename

[A424] Returns the parameter filename

CCTK_ParameterLevel

[A429] Return the parameter checking level

CCTK_ParameterQueryTimesSet

[A430] Return number of times a parameter has been set

CCTK_ParameterSet

[A432] Sets the value of a parameter

CCTK_ParameterSetNotifyRegister

[A435] Registers a parameter set operation notify callback

CCTK_ParameterSetNotifyUnregister

[A440] Unregisters a parameter set operation notify callback

CCTK_ParameterValString

[A443] Get the string representation of a parameter’s value

CCTK_ParameterWalk

[A446] Walk through the list of parameters

CCTK_PARAMWARN

[A448] Prints a warning from parameter checking, and possibly stops the code

CCTK_PointerTo

[A453] Returns a pointer to a Fortran variable.

CCTK_PrintGroup

[A455] Prints a group name from its index

CCTK_PrintString

[A459] Prints a Cactus string to screen (from Fortran)

CCTK_PrintVar

[A463] Prints a variable name from its index

CCTK_QueryGroupStorage

[A467] Queries storage for a group given by its group name

CCTK_QueryGroupStorageB

[A469] Queries storage for a group given by its group name or index

CCTK_QueryGroupStorageI

[A470] Queries storage for a group given by its group index

CCTK_ReduceArraysGlobally

[A473] Reduces a list of local arrays globally

CCTK_ReduceGridArrays

[A479] Reduces a list of local arrays (new grid array reduction API)

CCTK_ReduceLocalArrays

[A485] Reduces a list of local arrays (new local array reduction API) Returns the address of a variable passed in by reference from a Fortran routine

CCTK_ReductionHandle

[A494] Get the handle for a registered reduction operator

CCTK_RegexMatch

[A498] Perform a regular expression match of string against pattern

CCTK_RegisterBanner

[A500] Register a banner for a thorn

CCTK_RegisterGHExtension

[A504] Register the name of an extension to the Cactus GH

CCTK_RegisterGHExtensionInitGH

[A505] Register a routine for providing initialisation for an extension to the Cactus GH

CCTK_RegisterGHExtensionScheduleTraverseGH

[A506] Register a GH extension schedule traversal routine

CCTK_RegisterGridArrayReductionOperator

[A508] Registers a function as a grid array reduction operator of a certain name

CCTK_RegisterGHExtensionSetupGH

[A507] Register a routine for setting up an extension to the Cactus GH

CCTK_RegisterIOMethod

[A510] Registers a new I/O method

CCTK_RegisterIOMethodOutputGH

[A512] Registers an I/O method’s routine for conditional output

CCTK_RegisterIOMethodOutputVarAs

[A513] Registers an I/O method’s routine for unconditional output

CCTK_RegisterIOMethodTimeToOutput

[A514] Register a routine for deciding if it is time to output for an IO method

CCTK_RegisterIOMethodTriggerOutput

[A515] Register a routine for dealing with trigger output for an IO method

CCTK_RegisterLocalArrayReductionOperator

[A516] Registers a function as a reduction operator of a certain name

CCTK_RegisterReduceArraysGloballyOperator

[A518] Register a function as providing a global array reduction operation

CCTK_RegisterReductionOperator

[A520] Register a function as providing a reduction operation

CCTK_RunTime

[A521] Return the number of seconds since the run started

CCTK_SchedulePrintTimes

[A522] Output the timing results for a certain schedule item to stdout

CCTK_SchedulePrintTimesToFile

[A524] Output the timing results for a certain schedule item to a file

CCTK_SetupGH

[A528] Sets up a CCTK grid hierarchy

CCTK_SyncGroup

[A529] Synchronize the ghost zones for a group of variables (identified by the group name)

CCTK_SyncGroupI

[A533] Synchronize the ghost zones for a group of variables (identified by the group index)

CCTK_SyncGroupsI

[A537] Synchronize the ghost zones for a list of groups of variables (identified by their group indices)

CCTK_TerminateNext

[A543] Causes a Cactus simulation to terminate after the next iteration

CCTK_TerminationReached

[A545] Returns true if CCTK_TerminateNext has been called.

CCTK_ThornImplementation

[A547] Returns the implementation provided by the thorn

CCTK_Timer

[A550] Fills a timer cTimerData structure with current values of all clocks of a timer with a given name.

CCTK_TimerCreate

[A551] Create a timer with a given name, returns a timer index.

CCTK_TimerCreateData

[A552] Allocates a timer cTimerData structure.

CCTK_TimerCreateI

[A553] Create an unnamed timer, returns a timer index.

CCTK_TimerDestroy

[A554] Reclaims resources for a timer with a given name.

CCTK_TimerDestroyData

[A555] Reclaims resources of a timer cTimerData structure.

CCTK_TimerDestroyI

[A556] Reclaims resources for a timer with a given index.

CCTK_TimerI

[A557] Fills a timer cTimerData structure with current values of all clocks of a timer with a given index.

CCTK_TimerReset

[A558] Initialises the timer with a given name.

CCTK_TimerResetI

[A559] Initialises the timer with a given index.

CCTK_TimerStart

[A560] Initialises the timer with a given name.

CCTK_TimerStartI

[A561] Initialises the timer with a given index.

CCTK_TimerStop

[A562] Gets current values for all clocks of the timer with a given name.

CCTK_TimerStopI

[A563] Gets current values for all clocks of the timer with a given index.

CCTK_TraverseString

[A568] Traverse through all variables and/or groups whose names appear in the given string.

CCTK_VarDataPtr

[A570] Returns the data pointer for a grid variable

CCTK_VarDataPtrB

[A574] Returns the data pointer for a grid variable from the variable index or name

CCTK_VarDataPtrI

[A576] Returns the data pointer for a grid variable from the variable index

CCTK_VarIndex

[A580] Get the index for a variable

CCTK_VarName

[A584] Given a variable index, returns the variable name

CCTK_VarTypeI

[A587] Provides variable type index from the variable index

CCTK_VarTypeSize

[A591] Provides variable type size in bytes from the variable type index

CCTK_VError

[A593] Prints a formatted string with a variable argument list as error message to standard error and stops the code

CCTK_VInfo

[A596] Prints a formatted string with a variable argument list as an information message to screen

CCTK_VParamWarn

[A599] Prints a formatted string with a variable argument list as a warning from parameter checking, and possibly stops the code

CCTK_VWarn

[A601] Prints a formatted string with a variable argument list as a warning message to standard error and possibly stops the code

CCTK_WARN

[A605] Macro to print a single string as a warning message to standard error and possibly stop the code

CCTK_Warn

[A610] Function to print a single string as a warning message to standard error and possibly stop the code

CCTK_WarnCallbackRegister

[A613] Register one or more routines for dealing with warning messages in addition to printing them to standard error