File: README

package info (click to toggle)
lorene 0.0.0~cvs20161116%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster, stretch
  • size: 26,444 kB
  • ctags: 13,953
  • sloc: cpp: 212,946; fortran: 21,645; makefile: 1,750; sh: 4
file content (119 lines) | stat: -rw-r--r-- 3,416 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

	      *************************************************
 	      *	Lorene codes for rotating relativistic stars  *
	      *************************************************

	$Id: README,v 1.7 2010/02/01 17:58:13 e_gourgoulhon Exp $


1/ Description of the various codes
   ================================

rotstar:            Code for rigidly rotating stars in GR 
                    (quasi-isotropic gauge) 
		    ** OBSOLETE : use Lorene/Codes/Nrotstar/nrotstar instead **

rotdiff:            Code for differentially rotating stars in GR 
                    (quasi-isotropic gauge)

rotseq:             Code for computing sequences of either rigidly or 
                    differentially rotating stars in GR (quasi-isotropic gauge)

rotstar_dirac:      Code for rigidly rotating stars in GR in the Dirac gauge.

rotstar_dirac_diff: Code for differentially rotating stars in GR 
                    in the Dirac gauge.

2/ Compilation
   ===========

Typing

	gmake name_of_main_code

where name_of_main_code = rotstar, rotdiff, rotseq or rotstar_dirac, 
rotstar_dirac_diff will produce the executable in a non-optimized version 
for debugging purposes.  To get an optimized version for production purposes 
type instead

	gmake -f Makefile_O2 name_of_main_code

You can clear everything by

	gmake uninstall


3/ Input parameters
   ================

rotstar / rotstar_dirac / rotstar_dirac_diff:
-----------------------

The code rotstar needs two input files:

parrot.d :  parameters of the computation
par_eos.d : description of the equation of state

Templates files are provided in the directory Parameters. For instance
to compute a relativistic polytropic (gamma=2) star rotating at the
Keplerian limit, do

	cp Parameters/Kepler_GR/parrot.d .
	cp Parameters/Kepler_GR/par_eos.d .

Sample parameters (parrotdiff.d, par_eos.d) for rotstar_dirac_diff are
stored under the directory of "Parameters/Rotstar_dirac_diff".  Since 
rotdiff and rotstar_dirac_diff require the same parameters, the sample 
parameters are useful to compare the numerical difference between two 
codes.

Note: rotstar_dirac and rotstar_dirac_diff runs only for relativistic models.



rotseq:
------
The code rotseq needs two input files:

parrotseq.d :  parameters of the computation (includes the definition
                of the sequence)
par_eos.d : description of the equation of state

Templates files are provided in the directory Parameters/Rotseq.
To use them, simply type

	cp Parameters/Rotseq/parrotseq.d .
	cp Parameters/Rotseq/par_eos.d .

A constant baryon number sequence can be constructed either

(i) either by varying the central enthalpy (parameters
   [entc_min, entc_max] of the input file parrotseq.d); the code then
   automatically adjusts the rotation frequency to get a fixed baryon
   mass

(ii) or by varying the rotation frequency (parameters
   [freq_min_si,freq_max_si] of the input file parrotseq.d);
   the code then automatically adjusts the central enthalpy to get
   a fixed baryon mass

The choice of the type of sequence is performed by setting

-- entc_min != entc_max and freq_min_si  = freq_max_si for
   a sequence of type (i)
-- entc_min  = entc_max and freq_min_si != freq_max_si for
   a sequence of type (ii)



4/ Running
   =======

Simply type

	rotstar / rotstar_dirac / rotstar_dirac_diff

or
        rotseq

The output files like convergence.d can be visualized via xmgrace.