GNU Astronomy Utilities


Previous: , Up: Invoking astcosmiccal   [Contents][Index]


9.1.3.2 CosmicCalculator specific calculations

By default, when no specific calculations are requested, CosmicCalculator will print a complete set of all its calculators (one line for each calculation, see Invoking CosmicCalculator). The full list of calculations can be useful when you don’t want any specific value, but just a general view. In other contexts (for example in a batch script or during a discussion), you know exactly what you want and don’t want to be distracted by all the extra information.

You can use any number of the options described below in any order. When any of these options are requested, CosmicCalculator’s output will just be a single line with a single space between the (possibly) multiple values. In the example below, only the tangential distance along one arcsecond (in kpc), absolute magnitude conversion, and age of the universe at redshift 2 are printed (recall that you can merge short options together, see Options).

$ astcosmiccal -z2 -sag
8.585046 44.819248 3.289979

Here is one example of using this feature in scripts: by adding the following two lines in a script to keep/use the comoving volume with varying redshifts:

z=3.12
vol=$(astcosmiccal --redshift=$z --volume)

In a script, this operation might be necessary for a large number of objects (several of galaxies in a catalog for example). So the fact that all the other default calculations are ignored will also help you get to your result faster.

If you are indeed dealing with many (for example thousands) of redshifts, using CosmicCalculator is not the best/fastest solution. Because it has to go through all the configuration files and preparations for each invocation. To get the best efficiency (least overhead), we recommend using Gnuastro’s cosmology library (see Cosmology library (cosmology.h)). CosmicCalculator also calls the library functions defined there for its calculations, so you get the same result with no overhead. Gnuastro also has libraries for easily reading tables into a C program, see Table input output (table.h). Afterwards, you can easily build and run your C program for the particular processing with BuildProgram.

If you just want to inspect the value of a variable visually, the description (which comes with units) might be more useful. In such cases, the following command might be better. The other calculations will also be done, but they are so fast that you will not notice on modern computers (the time it takes your eye to focus on the result is usually longer than the processing: a fraction of a second).

$ astcosmiccal --redshift=0.832 | grep volume

The full list of CosmicCalculator’s specific calculations is present below. In case you have forgot the units, you can use the --help option which has the units along with a short description.

-G
--agenow

The current age of the universe (given the input parameters) in Giga-years (Gyr).

-C
--criticaldensitynow

The current critical density (given the input parameters) in grams per centimeter-cube (\(g/cm^3\)).

-d
--properdistance

The proper distance (at current time) to object at the given redshift in Megaparsecs (Mpc). See Distance on a 2D curved space for a description of the proper distance.

-A
--angulardimdist

The angular diameter distance to object at given redshift in Megaparsecs (Mpc).

-s
--arcsectandist

The tangential distance covered by 1 arcseconds at the given redshift in kiloparsecs (Kpc). This can be useful when trying to estimate the resolution or pixel scale of an instrument (usually in units of arcseconds) at a given redshift.

-L
--luminositydist

The luminosity distance to object at given redshift in Megaparsecs (Mpc).

-u
--distancemodulus

The distance modulus at given redshift.

-a
--absmagconv

The conversion factor (addition) to absolute magnitude. Note that this is practically the distance modulus added with \(-2.5\log{(1+z)}\) for the the desired redshift based on the input parameters. Once the apparent magnitude and redshift of an object is known, this value may be added with the apparent magnitude to give the object’s absolute magnitude.

-g
--age

Age of the universe at given redshift in Giga-years (Gyr).

-b
--lookbacktime

The look-back time to given redshift in Giga-years (Gyr). The look-back time at a given redshift is defined as the current age of the universe (--agenow) subtracted by the age of the universe at the given redshift.

-c
--criticaldensity

The critical density at given redshift in grams per centimeter-cube (\(g/cm^3\)).

-v
--onlyvolume

The comoving volume in Megaparsecs cube (Mpc\(^3\)) until the desired redshift based on the input parameters.


Previous: , Up: Invoking astcosmiccal   [Contents][Index]