the main module¶
- class pNbody.main.Nbody(p_name=None, pos=None, vel=None, mass=None, num=None, tpe=None, ftype='default', status='old', byteorder='little', pio='no', local=False, unitsfile=None, skipped_io_blocks=[], ptypes=None, verbose=0, arrays=None, **kws)¶
This is the reference Nbody class.
This is the constructor for the Nbody object. Optional arguments are:
- p_namename of the file
in case of multiple files, files must be included in a list [“file1”,”file2”]
pos : positions (3xN array) vel : positions (3xN array) mass : positions (1x array) num : id of particles (1xN array) tpe : type of particles (1xN array)
ftype : type of input file (swift,gh5,gadget)
- status‘old’open an old file
‘new’ : create a new object
byteorder : ‘little’ or ‘big’ pio : parallel io : ‘yes’ or ‘no’
local : True=local object, False=global object (paralellized) Not implemeted Yet
unitsfile : define the type of units
verbose : Verbose level (0: None, 1: general info, 2: details)
ptypes : type of particle to read
arrays : arrays to read
by default this class initialize the following variables :
self.p_name : name of the file(s) to read or write
self.pos : array of positions self.vel : array of velocities self.mass : array of masses self.num : array of id self.tpe : array of types
self.ftype : type of the file self.status : object status (‘old’ or ‘new’) self.byteorder : byter order (‘little’ or ‘big’) self.pio : parallel io (‘yes’ or ‘no’)
self.ptypes : type of particle to read
self.arrays : arrays to read
# new variables
self.nbody : local number of particles self.nbody_tot : total number of particles self.mass_tot : total mass self.npart : number of particles of each type self.npart_tot : total number of particles of each type self.spec_vars : dictionary of variables specific for the format used self.spec_vect : dictionary of vector specific for the format used
- Accel(x, eps)¶
Return the acceleration at a given position, using the softening length eps.
x : position (array vector) eps : softening
- CombiMap(*arg, **kw)¶
Return an image in form of a matrix (nx x ny float array). Contrary to ComputeMap, CombiMap compose different output of ComputeMap.
pos : position of particles (moment 0)
sr : dispertion in r (with respect to xp) svr : dispertion in vr
vxyr : mean velocity in the plane svxyr: dispertion in vxy
vtr : mean tangential velocity in the plane svtr : dispertion in vt
szr : ratio sigma z/sigma r
- ComputeDensityAndHsml(pos=None, Hsml=None, DesNumNgb=None, MaxNumNgbDeviation=None, Tree=None)¶
Compute Density and Hsml (for a specific place)
- ComputeHisto(bins, mode, space)¶
Compute and histogram
- ComputeMap(*arg, **kw)¶
Return an image in form of a matrix (nx x ny float array)
obs : position of observer x0 : eye position xp : focal position alpha : angle of the head view : ‘xy’ ‘xz’ ‘yz’
eye : ‘right’ ‘left’ dist_eye : distance between eyes
mode : mode of map space : pos or vel
persp : ‘on’ ‘off’ clip : (near,far) size : (maxx,maxy)
cut : ‘yes’ ‘no’
frsp : factor for rsp shape : shape of the map
- ComputeMeanHisto(bins, mode1, space)¶
Compute the mean map of an observable.
- ComputeMeanMap(*arg, **kw)¶
Compute the mean map of an observable.
- ComputeObjectMap(*arg, **kw)¶
IN DEVELOPPEMENT : allow to draw an object like a box, a grid… * * *
Return an image in form of a matrix (nx x ny float array)
obs : position of observer x0 : eye position xp : focal position alpha : angle of the head view : ‘xy’ ‘xz’ ‘yz’
eye : ‘right’ ‘left’ dist_eye : distance between eyes
mode : mode of map space : pos or vel
persp : ‘on’ ‘off’ clip : (near,far) size : (maxx,maxy)
cut : ‘yes’ ‘no’
frsp : factor for rsp shape : shape of the map
- ComputeRsp(Nngb=5)¶
Compute a value for self.rsp base on the distance to the Nngb neighbours This function is not paralellised.
- ComputeSigmaHisto(bins, mode1, mode2, space)¶
Compute the histogram of an observable.
- ComputeSigmaMap(*arg, **kw)¶
Compute the sigma map of an observable.
- ComputeSph(DesNumNgb=None, MaxNumNgbDeviation=None, Tree=None)¶
Compute self.Density and self.Hsml using sph approximation
- Ekin()¶
Return the total kinetic energy
- Epot(eps)¶
Return the total potential energy using the softening length eps.
eps : softening
WARNING : THIS FUNCTION DO NOT WORK IN MPI MODE
- ExchangeParticles()¶
Exchange particles betwee procs, using peano-hilbert decomposition computed in ptree
- Get_Velocities_From_AdaptativeSpherical_Grid(select=None, eps=0.1, n=1000, UseTree=True, Tree=None, phi=None, ErrTolTheta=0.5)¶
Computes velocities using the jeans equation in spherical coordinates. An adaptative grid is set automatically.
- Get_Velocities_From_Cylindrical_Grid(select='disk', disk=('gas', 'disk'), eps=0.1, nR=32, nz=32, nt=2, Rmax=100, zmin=- 10, zmax=10, params=[None, None, None], UseTree=True, Tree=None, Phi=None, ErrTolTheta=0.5, AdaptativeSoftenning=False, g=None, gm=None, NoDispertion=False)¶
Computes velocities using the jeans equation in cylindrical coordinates.
- Get_Velocities_From_Spherical_Grid(select=None, eps=0.1, nr=128, rmax=100.0, beta=0, UseTree=True, Tree=None, phi=None, ErrTolTheta=0.5, g=None, gm=None, NoDispertion=False, omega=None, vmax_limit=True)¶
Computes velocities using the jeans equation in spherical coordinates.
- Get_Velocities_From_Virial_Approximation(select=None, vf=1.0, eps=0.1, UseTree=True, Tree=None, ErrTolTheta=0.5)¶
This routine does not work ! Do not use it, or check !
- IntegrateUsingRK(tstart=0, dt=1, dt0=1e-05, epsx=1e-13, epsv=1e-13)¶
Integrate the equation of motion using RK78 integrator.
tstart : initial time dt : interval time dt0 : inital dt epsx : position precision epsv : velocity precision
tmin,tmax,dt,dtout,epsx,epsv,filename
- L()¶
Return the angular momentum in x,y,z of all particles. The output is an 3xn float array.
- Ltot()¶
Return the total angular momentum. The output is an 3x1 float array.
- Map(*arg, **kw)¶
Return 2 final images (float and int)
- Mr_Spherical(nr=25, rmin=0, rmax=50)¶
Return the mass inside radius r (supposing a spherical density distribution). The output is 2 n x 1 float arrays.
nr : number of bins (size of the output) rmin : minimal radius (this must be zero, instead it is wrong…) rmax : maximal radius
- Pot(x, eps)¶
Return the potential at a given position, using the softening length eps.
x : position (array vector) eps : softening
- R()¶
Return a 1xn float array that corresponds to the projected distance from the center of each particle.
- SendAllToAll()¶
Send all particles to all nodes at the end of the day, all nodes have the same nbody object
- SphEvaluate(val, pos=None, vel=None, hsml=None, DesNumNgb=None, MaxNumNgbDeviation=None, Tree=None)¶
Return an sph evaluation of the variable var
- TreeAccel(pos, eps, Tree=None)¶
Return the acceleration at a given position, using the softening length eps and using a tree.
pos : position (array vector) eps : softening Tree: gravitational tree if already computed
WARNING : this function do not work in parallel
- TreePot(pos, eps, Tree=None)¶
Return the potential at a given position, using the softening length eps and using a tree.
pos : position (array vector) eps : softening Tree: gravitational tree if already computed
WARNING : this function do not work in parallel
- VR()¶
Return the norm of the radial (cylindrical) velocities of particles The output is an 1xn float array.
- VT()¶
Return the norm of the tangiancial (cylindrical) velocities of particles The output is an 1xn float array.
- Vphi()¶
Return the norm of the phi component of the velocities of particles The output is an 1xn float array.
- Vr()¶
Return the norm of the radial (spherical) velocities of particles The output is an 1xn float array.
- Vrxy()¶
Return the radial velocities (in the z=0 plane) of particles The output is an 3xn float array.
- Vt()¶
Return the norm of the tangential velocities of particles The output is an 1xn float array.
- Vtheta()¶
Return the norm of the theta component of the velocities of particles The output is an 1xn float array.
- Vtxy()¶
Return the tangential velocities (in the z=0 plane) of particles The output is an 3xn float array.
- Vz()¶
Return a 1xn float array containing z velocity
- align(axis, mode='a', sgn='+', fact=None)¶
Rotate the object in order to align the axis ‘axis’ with the z axis.
axis : [x,y,z] mode : ‘p’ : only position
‘v’ : only velocities ‘a’ : both (default)
- sgn‘+’normal rotation
‘-’ : reverse sense of rotation
fact : int : factor to increase the angle
- align2(axis1=[1, 0, 0], axis2=[0, 0, 1], point=[0, 0, 0])¶
Rotate the object in order to align the axis ‘axis’ with the z axis.
axis1 : [x,y,z] axis2 : [x,y,z] point : [x,y,z]
- align_with_main_axis(mode='a')¶
Rotate the object in order to align it’s major axis with the axis of its inertial tensor.
- mode‘p’only position
‘v’ : only velocities ‘a’ : both (default)
- append(solf, do_not_sort=False, do_init_num=True, do_not_change_num=False)¶
Add to the current N-body object, particles form the N-body object “new”.
solf : Nbody object
- cart2sph(pos=None)¶
Transform carthesian coodinates x,y,z into spherical coordinates r,p,t Return a 3xn float array.
- check_arrays()¶
check if the array contains special values like NaN or Inf
- check_ftype()¶
check the file format
- clone_empty(local=False)¶
create a new empty object using the same class
- cm()¶
Return the mass center of the model. The output is an 3x1 float array.
- cmcenter()¶
Move the N-body object in order to center the mass center at the origin.
- cv()¶
Return the center of the velocities of the model. The output is an 3x1 float array.
- cvcenter()¶
Center the center of velocities at the origin.
- debug(msg)¶
print warning
- dens(r=None, nb=25, rm=50)¶
Return the number density at radius r (supposing a spherical density distribution). If r is not specified, it is computed with nb and rm. The output is an n x 1 float array.
!!! This routine do not use masses !!!
r : radius nb : number of bins (size of the output) rm : maximal radius
- display(*arg, **kw)¶
Display the model
- dmodes(nr=32, nm=16, rm=32)¶
Compute the density modes of a model
nm = 16 : number of modes nr = 32 : number of radius rm = 50 : max radius
return
r : the radius used m : the modes computed m1 : the matrix of the amplitude m2 : the matrix of the phases
- dump(aname=None)¶
Dump the array aname to a file
- dumpToHDF5(aname=None)¶
Dump the array aname to a file
- dv_mean()¶
Return the average relative speed between particles.
- dx_mean()¶
Return the average distance between particles.
- ekin()¶
Return the total specific kinetic energy
- epot(eps)¶
Return the total specific potential energy using the softening length eps.
eps : softening
WARNING : THIS FUNCTION DO NOT WORK IN MPI MODE
- error(msg, verbosity=0)¶
print error
- expose(obs, eye=None, dist_eye=None, foc=None, space='pos', pos=None, vel=None)¶
Rotate and translate the object in order to be seen as if the observer was in x0, looking at a point in xp.
obs : observer matrix eye : ‘right’ or ‘left’ dist_eye : distance between eyes (separation = angle) space : pos or vel foc : focal
- extend_format()¶
Extend format with format file (e.g. gh5) and extensions (config/extension)
- find_format(default)¶
Test the default format and if not good, test a few. :returns: format name
- find_vars()¶
This function return a list of variables defined in the current object
- gather_mass()¶
Gather in a unique array all mass of all nodes.
- gather_num()¶
Gather in a unique array all num of all nodes.
- gather_pos()¶
Gather in a unique array all positions of all nodes.
- gather_vec(vec)¶
Gather in a unique array all vectors vec of all nodes.
- gather_vel()¶
Gather in a unique array all velocites of all nodes.
- getAccelerationInCylindricalGrid(eps, z, Rmax, nr=32, nt=32, UseTree=False)¶
Compute the Acceleration in cells of a cylindrical grid
- getNumberParticlesInCylindricalGrid(Rmax, nr=32, nt=32)¶
Compute the number of particles in cells of a cylindrical grid
- getPotentialInCylindricalGrid(eps, z, Rmax, nr=32, nt=32, UseTree=False)¶
Compute the potential in cells of a cylindrical grid
- getRadialVelocityDispersionInCylindricalGrid(Rmax, nr=32, nt=32)¶
Compute the radial velocity dispersion in cells of a cylindrical grid
- getRadiusInCylindricalGrid(z, Rmax, nr=32, nt=32)¶
Compute the radius in cells of a cylindrical grid
- getSurfaceDensityInCylindricalGrid(Rmax, nr=32, nt=32)¶
Compute the surface density in cells of a cylindrical grid
- getTree(force_computation=False, ErrTolTheta=0.8)¶
Return a Tree object
- get_arrays_memory_footprint()¶
Return the memory footprint of each array
- get_default_arrays_props()¶
return default arrays properties for the class
- get_default_spec_array()¶
return specific array default values for the class
- get_default_spec_vars()¶
return specific variables default values for the class
- get_excluded_extension()¶
Return a list of file to avoid when extending the default class.
- get_ext_methods()¶
get the list of extensions methods together with their origin
- get_format_file()¶
return the format file
- get_ftype(ftype='swift')¶
get the current used format
- get_histocenter(rbox=50, nb=500, center=[0, 0, 0], fromBoxSize=False)¶
Return the position of the higher density region in x,y,z (not good) found by the function “histocenter”.
rbox : size of the box nb : number of bins in each dimension fromBoxSize : compute the histograms from the boxsize information center : center of the box
- get_histocenter2(rbox=50, nb=64)¶
Return the position of the higher density region in x,y,z (not good) found by the function “histocenter”.
rbox : size of the box nb : number of bins in each dimension
- get_histocenter3D(rbox=50, nb=256, center=[0, 0, 0], fromBoxSize=False)¶
Return the position of the higher density region in x,y,z (not good) found by the function “histocenter”.
rbox : size of the box nb : number of bins in each dimension fromBoxSize : compute the histograms from the boxsize information center : center of the box
- get_list_of_arrays()¶
Return the list of numpy vectors of size nbody.
- get_list_of_methods()¶
Return the list of instance methods (functions).
- get_list_of_vars()¶
Get the list of vars that are linked to the model
- get_mass_tot()¶
Return the total mass of system.
- get_mxntpe()¶
Return the max number of type for this format
- get_nbody()¶
Return the local number of particles.
- get_nbody_tot()¶
Return the total number of particles.
- get_npart()¶
Return the local number of particles of each types, based on the variable tpe
- get_npart_all(npart_tot, NTask)¶
From npart_tot, the total number of particles per type, return npart_per_proc, an array where each element corresponds to the value of npart of each process.
- get_npart_and_npart_all(npart)¶
From npart (usually read for the header of a file), compute :
npart : number of particles in each type npart_tot : total number of particles in each type npart_all : npart for each process.
- get_npart_tot()¶
Return the total number of particles of each types.
- get_ns()¶
Return in an array the number of particles of each node.
- get_ntype()¶
return the number of paticles types
- get_num()¶
Compute the num variable in order to be consistent with particles types
- get_potcenter(ptype=None, eps=0.1, force=False)¶
Return the centre defined as the position of the particle having the minimal potential
- get_read_fcts()¶
returns the functions needed to read a snapshot file.
- get_rotation_matrix_to_align_with_main_axis()¶
Get the rotation matrix used to rotate the object in order to align it’s main axis with the axis of its inertial tensor.
- get_rsp_approximation(DesNumNgb=None, MaxNumNgbDeviation=None, Tree=None)¶
Return an aproximation of rsp, based on the tree.
- get_write_fcts()¶
returns the functions needed to write a snapshot file.
- getindex(num)¶
Return an array of index of a particle from its specific number id. The array is empty if no particle corresponds to the specific number id.
num : Id of the particle
- has_array(name)¶
Return true if the object pNbody has an array called self.name
- has_var(name)¶
Return true if the object pNbody has a variable called self.name
- hdcenter()¶
Move the N-body object in order to center the higher density region found.
- histocenter(rbox=50, nb=500, fromBoxSize=False)¶
Move the N-body object in order to center the higher density region found near the mass center. The higher density region is determined with density histograms.
rbox : box dimension, where to compute the histograms nb : number of bins for the histograms fromBoxSize : compute the histograms from the boxsize information
- histocenter2(rbox=50, nb=64)¶
Move the N-body object in order to center the higher density region found near the mass center. The higher density region is determined whith density histograms.
rbox : box dimension, where to compute the histograms nb : number of bins for the histograms
- histocenter3D(rbox=50, nb=500, center=[0, 0, 0], fromBoxSize=False)¶
Move the N-body object in order to center the higher density region found near the mass center. The higher density region is determined with a 3D histograms.
rbox : box dimension, where to compute the histograms nb : number of bins for the histograms center : center of the box fromBoxSize : compute the histograms from the boxsize information
- histovel(nb=100, vmin=None, vmax=None, mode='n')¶
Return or plot the histrogram of the norm of velocities or of the radial velocities.
The output is a list (r,h) of 2 nx1 float arrays, where r is the radius and h the values of the histogram.
nb : number of bins (size of the output) vmax : maximum velocity vmin : minimum velocity mode : ‘n’ (norme of the velocities)
‘r’ (radial velocities)
- import_check_ftype(filename)¶
Import check_spec_ftype from the format file.
- inertial_tensor()¶
Return the inertial tensor.
- info()¶
Write info
- init()¶
Initialize normal and specific class variables
- init_units()¶
This function is responsible for the units initialization.
It will create :
self.unitsparameters
- that contains parameters like
the hydrogen mass fraction,
the metalicity ionisation flag
the adiabatic index
…
and
self.localsystem_of_units
a UnitSystem object that really defines the system of units in the Nbody object. It uses the values :
UnitLength_in_cm UnitMass_in_g UnitVelocity_in_cm_per_s
All physical values computed in pNbody should use self.localsystem_of_units to be converted in other units. self.unitsparameters is usefull if other parameters needs to be known, like the adiabatic index, etc.
- l()¶
Return the specific angular momentum in x,y,z of all particles. The output is an 3xn float array.
- load(name=None, ptypes=None, force=False)¶
Load array from the file. This function relays on the info stored in self._AM.arrays_props Here, we assume that npart is known and correct
name : the array name ptypes : the list of particles types to read force : for reloading the array
- loadFromHDF5(name=None, ptypes=None, force=False)¶
Load array from the hdf5 file. This function relays on the info stored self.arrays_props Here, we assume that npart is known and correct
name : the array name ptypes : the list of particles types to read force : for reloading the array
- ltot()¶
Return the specific total angular momentum. The output is an 3x1 float array.
- make_default_vars_global()¶
Make specific variables global
- mdens(r=None, nb=25, rm=50)¶
Return the density at radius r (supposing a spherical density distribution). If r is not specified, it is computed with nb and rm. The output is an n x 1 float array.
r : radius nb : number of bins (size of the output) rm : maximal radius
- memory_info()¶
Write info on memory size of the current object (only counting arrays size)
- message(msg, verbosity=1, color=None)¶
print message
- minert()¶
Return the diagonal of the intertial momentum.
- mr(r=None, nb=25, rm=50)¶
Return the mass inside radius r (supposing a spherical density distribution). If r is not specified, it is computed with nb and rm. The output is an n x 1 float array.
r : radius nb : number of bins (size of the output) rm : maximal radius
- msdens(r=None, nb=25, rm=50)¶
Return the mass surface density at radius r. If r is not specified, it is computed with nb and rm. The output is an nx1 float array.
r : radius nb : number of bins (size of the output) rm : maximal radius
- nodes_info()¶
Write info on nodes
- object_info()¶
Write class(object) info
- open_and_read(name, readfct)¶
open and read file name
name : name of the input readfct : function used to read the file
- open_and_write(name, writefct)¶
Open and write file
name : name of the output writefct : function used to write the file
- phi_xy()¶
Return a 1xn float array that corresponds to the azimuth in cylindrical coordinate of each particle.
- phi_xyz()¶
Return a 1xn float array that corresponds to the azimuth in spherical coordinate of each particle.
- potcenter(ptype=None, eps=0.1)¶
center the model according to the potential center (position of the particle having the minimal potential).
ptype : particle type on which the potential is computed eps : gravitational softening length
- print_filenames()¶
Print files names
- r(center=None)¶
Return a 1xn float array that corresponds to the distance from the center of each particle.
- read()¶
Read the particle file(s)
- read_arrays(ptypes=None)¶
Read arrays that must be loaded.
- read_num(name)¶
Read a num file
name : name of the input
- real_numngb(num)¶
number of particles wor wich r<h
- rebox(boxsize=None, mode=None, axis='xyz')¶
Translate the positions of the object in order that all particles being contained in a box of size boxsize.
- boxsizesize of the box
if boxsize is not defined, we try first to see if self.boxsize is defined.
- modetype of reboxing
None : -> [0,boxsize] centred : -> [-boxsize/2,boxsize/2] [x,y,z] :
- redistribute()¶
This function redistribute particles amoung all nodes in order to have a similar number of particles per nodes
- reduc(n, mass=False)¶
Return an N-body object that contain a fraction 1/n of particles.
n : inverse of the fraction of particule to be returned
- rename(p_name=None)¶
Rename the files
p_name : new name(s)
- rotate(angle=0, axis=[1, 0, 0], point=[0, 0, 0], mode='a')¶
Rotate the positions and/or the velocities of the object around a specific axis defined by a vector and an point.
angle : rotation angle in radian axis : direction of the axis point : center of the rotation
- mode‘p’rotate only position
‘v’ : rotate only velocities ‘a’ : rotate both (default)
- rotateR(R, mode='a')¶
Rotate the model using the matrix R
- mode‘p’only position
‘v’ : only velocities ‘a’ : both (default)
- rotate_old(angle=0, mode='a', axis='x')¶
Rotate the positions and/or the velocities of the object around a specific axis.
angle : rotation angle in radian axis : ‘x’ : around x
‘y’ : around y ‘z’ : around z
: [x,y,z] : around this axis
- mode‘p’rotate only position
‘v’ : rotate only velocities ‘a’ : rotate both (default)
- rxy()¶
Return a 1xn float array that corresponds to the projected distance from the center of each particle.
- rxyz(center=None)¶
Return a 1xn float array that corresponds to the distance from the center of each particle.
- sdens(r=None, nb=25, rm=50)¶
Return the surface density at radius r. If r is not specified, it is computed with nb and rm. The output is an nx1 float array.
!!! This routine do not uses masses !!!
r : radius nb : number of bins (size of the output) rm : maximal radius
- selectc(c, local=False)¶
Return an N-body object that contain only particles where the corresponding value in c is not zero. c is a nx1 Nbody array.
c : the condition vector local : local selection (True) or global selection (False)
- selecti(i, local=False)¶
Return an N-body object that contain only particles having their index (not id) in i.
i : vector containing indexes local : local selection (True) or global selection (False)
- selectp(lst=None, file=None, reject=False, local=False, from_num=True)¶
Return an N-body object that contain only particles with specific number id.
The list of id’s is given either by lst (nx1 int array) or by the name (“file”) of a file containing the list of id’s.
lst : vector list (integer)
reject : True/False : if True, reject particles in lst (default = False) local : local selection (True) or global selection (False)
- frum_numif True, use self.num to select particules
if False, use arange(self.nbody)
- set_command_line()¶
Set the command line
- set_date()¶
Set a date
- set_filenames(p_name, pio=None)¶
Set the local and global names
p_name : new name(s) pio : ‘yes’ or ‘no’
- set_ftype(ftype='swift')¶
Change the type of the file
ftype : type of the file
- set_gittag()¶
Set the git tag
- set_local_system_of_units(params='default', UnitLength_in_cm=None, UnitVelocity_in_cm_per_s=None, UnitMass_in_g=None, unitparameterfile=None, gadgetparameterfile=None)¶
Set local system of units using UnitLength_in_cm,UnitVelocity_in_cm_per_s,UnitMass_in_g
if nothing is given, we use self.unitsparameters to obtain these values
2a) if UnitLength_in_cm, UnitVelocity_in_cm_per_s, UnitMass_in_g are given, we use them
2b) if UnitLength_in_cm, UnitVelocity_in_cm_per_s, UnitMass_in_g are given in a dictionary
if unitparameterfile is given we read the parameters from the file (units parameter format)
if gadgetparameterfile is given we read the parameters from the file (gadget param format)
- set_npart(npart)¶
Set the local number of particles of each types. This function modifies the variable self.tpe
- set_parameters(params)¶
Set parameters for the class
- set_pio(pio)¶
Set parallel input/output or not io
pio : ‘yes’ or ‘no’
- set_tpe(tpe)¶
Set all particles to the type tpe
- set_unitsparameters(unitsparams)¶
Set units parameters for the class.
- set_username()¶
Set a username
- show(*arg, **kw)¶
Display the model this is an alias to display
- sigma(r=None, nb=25.0, rm=50.0)¶
Return the 3 velocity dispersion (in cylindrical coordinates) and the mean azimuthal velocity curve. If r is not specified, it is computed with nb and rm.
The output is a list (r,sr,st,sz,mt) of 5 $n imes 1$ float arrays, where r is the radius, sr the radial velocity dispersion, st, the azimuthal velocity dispersion, sz, the vertical velocity dispersion and mt, the mean azimuthal velocity curve.
!!! This routine works only if particles have equal masses !!!
r : radius where to compute the values nb : number of bins (size of the output) rm : maximal radius
return : r,sr,st,sz,mt
- sigma_vz(r=None, nb=25, rm=50)¶
Return the vertical dispertion in z at radius r. If r is not specified, it is computed with nb and rm. The output is an nx1 float array.
r : radius nb : number of bins (size of the output) rm : maximal radius
- sigma_z(r=None, nb=25, rm=50)¶
Return the vertical dispertion in z at radius r. If r is not specified, it is computed with nb and rm. The output is an nx1 float array.
r : radius nb : number of bins (size of the output) rm : maximal radius
- size()¶
Estimate the model size, using the inertial momentum
- sort(vec=None, local=False)¶
sort particles according to the vector vec
vec : vector on which to sort (default=self.num)
- sort_type(local=False)¶
Contrary to sort, this fonction sort particles respecting their type.
- spec_info()¶
Write specific info
- sph2cart(pos=None)¶
Transform spherical coordinates r,p,t into carthesian coodinates x,y,z Return a 3xn float array.
- sphericalvel2pos()¶
Replace the position by velocities in spherical coordinates
- spin(omega=None, L=None, j=None, E=None)¶
Spin the object with angular velocity “omega” (rigid rotation). Omega is a 1 x 3 array object
If L (total angular momentum) is explicitely given, compute Omega from L (1 x 3 array object).
omega : angular speed (array vector) L : desired angular momentum j : desired energy fraction in rotation E : Total energy (without rotation)
- sub(n1=0, n2=None)¶
Return an N-body object that have particles whith indicies in the range [n1:n2].
n1 : number of the first particule n2 : number of the last particule
Note : the first particle is 0
- take(vec=None, local=False)¶
extract particles according to the vector vec
vec : vector (default=self.num)
- theta_xyz()¶
Return a 1xn float array that corresponds to the elevation angle in spherical coordinate of each particle.
- tork(acc)¶
Return the total tork on the system due to the force acting on each particle (acc). The output is an 3xn float array.
acc : 3xn float array
- translate(dx, mode='p')¶
Translate the positions or the velocities of the object.
dx : shift (array vector) mode : ‘p’ : translate positions
‘v’ : translate velocities
- update_creation_info()¶
Update creation info
- usual_numngb(num)¶
usual way to compute the number of neighbors
- v_sigma()¶
Return the norm of the velocity dispersions.
- vel2pos()¶
Replace the position by velocities in Cartesian coordinates
- vel_cart2cyl()¶
Transform velocities in carthesian coordinates vx,vy,vz into cylindrical coodinates vr,vz,vz. Pos is the position of particles in cart. coord. Vel is the velocity in cart. coord. Return a 3xn float array.
- vel_cyl2cart(pos=None, vel=None)¶
Transform velocities in cylindrical coordinates vr,vt,vz into carthesian coodinates vx,vy,vz. Pos is the position of particles in cart. coord. Vel is the velocity in cylindrical coord. Return a 3xn float array.
- vn()¶
Return a 1xn float array that corresponds to the norm of velocities
- vrxyz()¶
Return a 1xn float array that corresponds to the radial velocity in spherical system
- vx()¶
Return a 1xn float array containing x velocity
- vy()¶
Return a 1xn float array containing y velocity
- vz()¶
Return a 1xn float array containing z velocity
- warning(msg, verbosity=1)¶
print warning
- weighted_numngb(num)¶
num = particle where to compute weighted_numngb see Springel 05
- write(name=None)¶
Write the particle file(s)
- write_num(name)¶
Write a num file
name : name of the output
- x(center=None)¶
Return a 1xn float array containing x coordinate
- x_sigma()¶
Return the norm of the position dispersions.
- y(center=None)¶
Return a 1xn float array containing y coordinate
- z(center=None)¶
Return a 1xn float array containing z coordinate
- zmodes(nr=32, nm=16, rm=32)¶
Compute the vertical modes of a model
nm = 16 : number of modes nr = 32 : number of radius rm = 50 : max radius
return
r : the radius used m : the modes computed m1 : the matrix of the amplitude m2 : the matrix of the phases
- zprof(z=None, r=2.5, dr=0.5, nb=25, zm=5.0)¶
Return the z-profile in a vector for a given radius
!!! This routine works only if particles have equal masses !!!
z : bins in z (optional) r : radius of the cut dr : width in r of the cut nb : number of bins (size of the output) zm : maximal height