ReadMe for 2nd edition Fusion Software

The 2nd edition of THERMONUCLEAR FUSION IN STARS is being provided with software on 3 diskettes. All supporting materials required to introduce a change and recompile using the Borland 3.1 C/C++ compiler have been provided. The inclusion of source code allows the user to check the algorithms behind computed results and to review embedded theoretical notes. The idea here is to understand precisely how everything is computed and modeled, so that we can compare, in some cases, the results we get using different techniques or algorithms to compute stellar parameters. Code and data may be obtained for free on-line for CHANDRA, STAREXP, DEPTHSTA, and FUSION or from the diskettes for the more advanced STAR8 software. The diskettes should be copied to clean diskettes and the originals saved for backup purposes. If desired, programs may be run directly from the diskettes, with output to files on the diskette. On the other hand, the contents of each diskette may be written to hard disk and run from hard disk, taking care to create a \z6 sub-directory to contain all \z6 supporting data files in the diskette \z6 sub-directories. The \z6 directories on both diskettes contain the same data, and include the 15 files

abundan.txt (spare), abundan2.txt (alt), z6astcal.txt, z6bocal.txt, z6brite.txt, z6dwarf.txt, z6giants.txt, z6help.txt, z6listm.txt, z6mnseq.txt, z6near.txt, z6sketch.txt, z6spect.txt, z6superg.txt, and z6tsurf.txt.

All other source code, output files, input abundance files, and executable modules should reside in the parent directory for \z6. This may be virtually any directory in a PC, preferably one you have created just to hold these programs, say the STARCAL directory. Then the STARCAL directory would contain the sub-directory \z6 with its supporting data files, and all output will be written to the STARCAL directory, the same one from which the application programs are executed. Some of the supporting code (CHANDRA, FUSION, DEPTHSTA, STAREXP) and supporting data files are available as free downloads from http://greenwdks.tripod.com/thelostchord.html. The associated textbook theoretical analysis with the complete software set including STAR8 and data files on 2 diskettes is available for $50.00 from Greenwood Research at http://greenwdks.tripod.com.

DISKETTE 1 CONTENTS:

1) fusion.exe - The executable module for the fusion process investigator, based on the project file fusion.prj, a current ZAMS model abundances file abundan.txt accounting for the last model abundances of the elements used by the investigator, 15 supporting data files in the z6 directory, and the component source code files

starz7.cpp, starz7ab.cpp, starz7ag.cpp, starz7au.cpp, starz7bo.cpp, and starz7fn.cpp, starz7fu.cpp, and starz7op.cpp.

This program may be run by invoking fusion.exe, and leaves fusion.txt in the same directory as its primary output, along with abundan.txt, the users last set of model abundances of the elements. All components of the system are present in the root directory and in directory \z6, and may be recompiled with the Borland C\Cplus-plus 3.1 compiler anytime. This program is used to investigate the relative performance of models for fusion energy generation available from different astrophysicists. For example, we may compare the figures we obtain for energy from the Carbon Cycle based on a formula from Hubert Reeves with results obtained from a formula by Martin Schwarzschild when modeling the star Sirius. Corrections to the abundances of the elements in the star due to stellar evolution are given to a low order of approximation, and the corresponding age of the star is computed along with many other details.

2) depthsta.exe - The executable module for the stellar depth ranger, based on the project file depthsta.prj, and the source files

starz5.cpp, starz5ag.cpp, starz5au.cpp, starz5bo.cpp, starz5fu.cpp, starzop.cpp, and starz5sc.cpp.

This program does not need to access the z6 directory. It leaves the output file depthsta.txt as its sole output, other than its console remarks. The depth ranger works by computing the Zero-Age-Main-Sequence model associated with star, varying it in steps over a distance range around a distance point. When the computed ZAMS distance luminosity is equal to the observed luminosity, the range shown at that point would be the correct range for a Zero-Age-Main-Sequence star at that point. The program is primarily useful for estimating the distance to young hydrogen-burning stars, although the fusion calculations include H-burning, carbon-cycle H-burning, and helium burning. The program may be recompiled at anytime with mods using Borland's 3.1 C/C++ compiler. All source code and the project file have been made available.

DISKETTE 2 CONTENTS:

1) star8.exe - The executable code for the STAR8 stellar abundance structure investigator, which accounts for evolution of abundances in the core of the star by using higher-order approximations based on the physics of thermonuclear burning in the stellar core. This includes the project file star8.prj and

starz8.cpp, starz8ab.cpp, starz8ag.cpp, starz8au.cpp, starz8bo.cpp, starz8fn.cpp, starz8fu.cpp, and starz8op.cpp

the current ZAMS abundance file abundan.txt for the model for abundances of the elements in the star, and the 15 supporting data files in the \z6 directory. The principle output file is the report file star8.txt. The file abundan.txt is also an output file that may be changed for a new investigation. This is done from inside the program. This is the most sophisticated modeler for details of the stellar evolution of the star. It computes the age of the star based on the hydrogen depletion, but uses a higher-order approach that models the evolution of internal structure more precisely than it is done in fusion.exe.

2) starexp.exe - The executable code for the starexp.cpp program, which is compiled without any supporting data files, leaving only the output file starexp.txt. STAREXP includes a Supernova Report Generator for stars above 6.23 solar masses providing many details and forecasting regarding the associated supernova. It is less useful for fusion and stellar evolution.

3) bolometr.exe - Code for computing the bolometric correction for a star when the visual magnitude of the star is known at the zenith and at some angle away from the zenith. It is also necessary to know the spectral type of the star. It is contained in the single source code file bolometr.cpp and displays all of its output on the terminal screen.

DISKETTE 3 CONTENTS:

1) chandra.exe (executable) and chandra.cpp source code. This software integrates the equation of state for chosen density from the center to the surface to compute properties of collapsed objects, including white dwarfs. This is the method of Chandrasekhar and Fowler. CHANDRA also includes rotating objects.
2) chanread.txt - Instructions for CHANDRA.
3) chandra.txt - Sample output file.