Previous: CosmicCalculator input options, Up: Invoking astcosmiccal [Contents][Index]

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: CosmicCalculator input options, Up: Invoking astcosmiccal [Contents][Index]

JavaScript license information

GNU Astronomy Utilities 0.7 manual, August 2018.