docs(readme): Updated
Updated readme and docs to reflect new output (neutrino)
This commit is contained in:
68
README.md
68
README.md
@@ -15,53 +15,6 @@
|
||||
|
||||
---
|
||||
|
||||
# Table of Contents
|
||||
- [Introduction](#introduction)
|
||||
- [Design Philosophy and Workflow](#design-philosophy-and-workflow)
|
||||
- [Funding](#funding)
|
||||
- [Usage](#usage)
|
||||
- [Python installation](#python-installation)
|
||||
- [pypi](#pypi)
|
||||
- [source](#source)
|
||||
- [source for developers](#source-for-developers)
|
||||
- [patching shared object files](#patching-shared-object-files)
|
||||
- [Automatic Build and Installation](#automatic-build-and-installation)
|
||||
- [Script Build and Installation Instructions](#script-build-and-installation-instructions)
|
||||
- [Currently, known good platforms](#currently-known-good-platforms)
|
||||
- [Manual Build Instructions](#manual-build-instructions)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Install Scripts](#install-scripts)
|
||||
- [Dependency Installation on Common Platforms](#dependency-installation-on-common-platforms)
|
||||
- [Building the C++ Library](#building-the-c-library)
|
||||
- [Installing the Library](#installing-the-library)
|
||||
- [Minimum compiler versions](#minimum-compiler-versions)
|
||||
- [Code Architecture and Logical Flow](#code-architecture-and-logical-flow)
|
||||
- [Engines](#engines)
|
||||
- [GraphEngine](#graphengine)
|
||||
- [GraphEngine Configuration Options](#graphengine-configuration-options)
|
||||
- [Available Partition Functions](#available-partition-functions)
|
||||
- [AutoDiff](#autodiff)
|
||||
- [Reaclib in GridFire](#reaclib-in-gridfire)
|
||||
- [Engine Views](#engine-views)
|
||||
- [A Note about composability](#a-note-about-composability)
|
||||
- [Numerical Solver Strategies](#numerical-solver-strategies)
|
||||
- [NetworkSolverStrategy<EngineT>](#networksolverstrategyenginet)
|
||||
- [NetIn and NetOut](#netin-and-netout)
|
||||
- [DirectNetworkSolver (Implicit Rosenbrock Method)](#directnetworksolver-implicit-rosenbrock-method)
|
||||
- [Algorithmic Workflow in DirectNetworkSolver](#algorithmic-workflow-in-directnetworksolver)
|
||||
- [Future Solver Implementations](#future-solver-implementations)
|
||||
- [Python Extensibility](#python-extensibility)
|
||||
- [Usage Examples](#usage-examples)
|
||||
- [C++](#c)
|
||||
- [GraphEngine Initialization](#graphengine-initialization)
|
||||
- [Adaptive Network View](#adaptive-network-view)
|
||||
- [Composition Initialization](#composition-initialization)
|
||||
- [Common Workflow Example](#common-workflow-example)
|
||||
- [Callback Example](#callback-example)
|
||||
- [Python](#python)
|
||||
- [Common Workflow Example](#common-workflow-example-1)
|
||||
- [Python callbacks](#python-callbacks)
|
||||
- [Related Projects](#related-projects)
|
||||
|
||||
# Introduction
|
||||
GridFire is a C++ library designed to perform general nuclear network
|
||||
@@ -564,11 +517,11 @@ A `NetIn` struct contains
|
||||
A `NetOut` struct contains
|
||||
- The final composition after evolving to `tMax` (`NetOut::composition`)
|
||||
- The number of steps the solver took to evolve to `tmax` (`NetOut::num_steps`)
|
||||
- The final energy generated by the network while evolving to `tMax`
|
||||
(`NetOut::energy`)
|
||||
|
||||
>**Note:** Currently `GraphEngine` only considers energy due to nuclear mass
|
||||
>defect and not neutrino loss.
|
||||
- The final specific energy generated by the network while evolving to `tMax` (`NetOut::energy`) [erg/g]
|
||||
- The derivative of energy with respect to temperature at the end of the evolution (`NetOut::dEps_dT`)
|
||||
- The derivative of energy with respect to density at the end of the evolution (`NetOut::dEps_dRho`)
|
||||
- The total specific energy lost to neutrinos while evolving to `tMax` (`NetOut::total_neutrino_loss`) [erg/g]
|
||||
- The total flux of neutrinos while evolving to `tMax` (`NetOut::total_neutrino_flux`)
|
||||
|
||||
### CVODESolverStrategy
|
||||
|
||||
@@ -962,6 +915,8 @@ int main() {
|
||||
double energy_out;
|
||||
double dEps_dT;
|
||||
double dEps_dRho;
|
||||
double neutrino_energy_loss;
|
||||
double neutrino_flux;
|
||||
double mass_lost;
|
||||
|
||||
ret = gf_evolve(
|
||||
@@ -975,7 +930,10 @@ int main() {
|
||||
Y_out,
|
||||
&energy_out,
|
||||
&dEps_dT,
|
||||
&dEps_dRho, &mass_lost
|
||||
&dEps_dRho,
|
||||
&neutrino_energy_loss,
|
||||
&neutrino_flux,
|
||||
&mass_lost
|
||||
);
|
||||
|
||||
GF_CHECK_RET_CODE(ret, gf_context, "Evolution");
|
||||
@@ -1058,7 +1016,7 @@ program main
|
||||
|
||||
! Output buffers
|
||||
real(c_double), dimension(8) :: Y_out
|
||||
real(c_double) :: energy_out, dedt, dedrho, dmass
|
||||
real(c_double) :: energy_out, dedt, dedrho, nu_E_loss, nu_flux, dmass
|
||||
|
||||
! Thermodynamic Conditions (Solar Core-ish)
|
||||
real(c_double) :: T = 1.5e7 ! 15 Million K
|
||||
@@ -1082,7 +1040,7 @@ program main
|
||||
|
||||
! --- 5. Evolve ---
|
||||
print *, "Evolving system (dt =", dt, "s)..."
|
||||
call net%evolve(Y_in, T, rho, dt, Y_out, energy_out, dedt, dedrho, dmass, ierr)
|
||||
call net%evolve(Y_in, T, rho, dt, Y_out, energy_out, dedt, dedrho, nu_E_loss, nu_flux, dmass, ierr)
|
||||
|
||||
if (ierr /= 0) then
|
||||
print *, "Evolution Failed with error code: ", ierr
|
||||
|
||||
68
docs/static/mainpage.md
vendored
68
docs/static/mainpage.md
vendored
@@ -15,53 +15,6 @@
|
||||
|
||||
---
|
||||
|
||||
# Table of Contents
|
||||
- [Introduction](#introduction)
|
||||
- [Design Philosophy and Workflow](#design-philosophy-and-workflow)
|
||||
- [Funding](#funding)
|
||||
- [Usage](#usage)
|
||||
- [Python installation](#python-installation)
|
||||
- [pypi](#pypi)
|
||||
- [source](#source)
|
||||
- [source for developers](#source-for-developers)
|
||||
- [patching shared object files](#patching-shared-object-files)
|
||||
- [Automatic Build and Installation](#automatic-build-and-installation)
|
||||
- [Script Build and Installation Instructions](#script-build-and-installation-instructions)
|
||||
- [Currently, known good platforms](#currently-known-good-platforms)
|
||||
- [Manual Build Instructions](#manual-build-instructions)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Install Scripts](#install-scripts)
|
||||
- [Dependency Installation on Common Platforms](#dependency-installation-on-common-platforms)
|
||||
- [Building the C++ Library](#building-the-c-library)
|
||||
- [Installing the Library](#installing-the-library)
|
||||
- [Minimum compiler versions](#minimum-compiler-versions)
|
||||
- [Code Architecture and Logical Flow](#code-architecture-and-logical-flow)
|
||||
- [Engines](#engines)
|
||||
- [GraphEngine](#graphengine)
|
||||
- [GraphEngine Configuration Options](#graphengine-configuration-options)
|
||||
- [Available Partition Functions](#available-partition-functions)
|
||||
- [AutoDiff](#autodiff)
|
||||
- [Reaclib in GridFire](#reaclib-in-gridfire)
|
||||
- [Engine Views](#engine-views)
|
||||
- [A Note about composability](#a-note-about-composability)
|
||||
- [Numerical Solver Strategies](#numerical-solver-strategies)
|
||||
- [NetworkSolverStrategy<EngineT>](#networksolverstrategyenginet)
|
||||
- [NetIn and NetOut](#netin-and-netout)
|
||||
- [DirectNetworkSolver (Implicit Rosenbrock Method)](#directnetworksolver-implicit-rosenbrock-method)
|
||||
- [Algorithmic Workflow in DirectNetworkSolver](#algorithmic-workflow-in-directnetworksolver)
|
||||
- [Future Solver Implementations](#future-solver-implementations)
|
||||
- [Python Extensibility](#python-extensibility)
|
||||
- [Usage Examples](#usage-examples)
|
||||
- [C++](#c)
|
||||
- [GraphEngine Initialization](#graphengine-initialization)
|
||||
- [Adaptive Network View](#adaptive-network-view)
|
||||
- [Composition Initialization](#composition-initialization)
|
||||
- [Common Workflow Example](#common-workflow-example)
|
||||
- [Callback Example](#callback-example)
|
||||
- [Python](#python)
|
||||
- [Common Workflow Example](#common-workflow-example-1)
|
||||
- [Python callbacks](#python-callbacks)
|
||||
- [Related Projects](#related-projects)
|
||||
|
||||
# Introduction
|
||||
GridFire is a C++ library designed to perform general nuclear network
|
||||
@@ -564,11 +517,11 @@ A `NetIn` struct contains
|
||||
A `NetOut` struct contains
|
||||
- The final composition after evolving to `tMax` (`NetOut::composition`)
|
||||
- The number of steps the solver took to evolve to `tmax` (`NetOut::num_steps`)
|
||||
- The final energy generated by the network while evolving to `tMax`
|
||||
(`NetOut::energy`)
|
||||
|
||||
>**Note:** Currently `GraphEngine` only considers energy due to nuclear mass
|
||||
>defect and not neutrino loss.
|
||||
- The final specific energy generated by the network while evolving to `tMax` (`NetOut::energy`) [erg/g]
|
||||
- The derivative of energy with respect to temperature at the end of the evolution (`NetOut::dEps_dT`)
|
||||
- The derivative of energy with respect to density at the end of the evolution (`NetOut::dEps_dRho`)
|
||||
- The total specific energy lost to neutrinos while evolving to `tMax` (`NetOut::total_neutrino_loss`) [erg/g]
|
||||
- The total flux of neutrinos while evolving to `tMax` (`NetOut::total_neutrino_flux`)
|
||||
|
||||
### CVODESolverStrategy
|
||||
|
||||
@@ -962,6 +915,8 @@ int main() {
|
||||
double energy_out;
|
||||
double dEps_dT;
|
||||
double dEps_dRho;
|
||||
double neutrino_energy_loss;
|
||||
double neutrino_flux;
|
||||
double mass_lost;
|
||||
|
||||
ret = gf_evolve(
|
||||
@@ -975,7 +930,10 @@ int main() {
|
||||
Y_out,
|
||||
&energy_out,
|
||||
&dEps_dT,
|
||||
&dEps_dRho, &mass_lost
|
||||
&dEps_dRho,
|
||||
&neutrino_energy_loss,
|
||||
&neutrino_flux,
|
||||
&mass_lost
|
||||
);
|
||||
|
||||
GF_CHECK_RET_CODE(ret, gf_context, "Evolution");
|
||||
@@ -1058,7 +1016,7 @@ program main
|
||||
|
||||
! Output buffers
|
||||
real(c_double), dimension(8) :: Y_out
|
||||
real(c_double) :: energy_out, dedt, dedrho, dmass
|
||||
real(c_double) :: energy_out, dedt, dedrho, nu_E_loss, nu_flux, dmass
|
||||
|
||||
! Thermodynamic Conditions (Solar Core-ish)
|
||||
real(c_double) :: T = 1.5e7 ! 15 Million K
|
||||
@@ -1082,7 +1040,7 @@ program main
|
||||
|
||||
! --- 5. Evolve ---
|
||||
print *, "Evolving system (dt =", dt, "s)..."
|
||||
call net%evolve(Y_in, T, rho, dt, Y_out, energy_out, dedt, dedrho, dmass, ierr)
|
||||
call net%evolve(Y_in, T, rho, dt, Y_out, energy_out, dedt, dedrho, nu_E_loss, nu_flux, dmass, ierr)
|
||||
|
||||
if (ierr /= 0) then
|
||||
print *, "Evolution Failed with error code: ", ierr
|
||||
|
||||
Reference in New Issue
Block a user