/******************************************************************************* * This file is part of SWIFT. * Copyright (c) 2025 Darwin Roduit (darwin.roduit@alumni.epfl.ch) * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published * by the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this program. If not, see . * ******************************************************************************/ /* Include header */ #include "cosmology.h" #include "engine.h" #include "hydro_properties.h" #include "part.h" #include "stellar_evolution.h" #include "units.h" /** * @brief Computes the time-step length of a given star particle from feedback * physics * * @param sp Pointer to the s-particle data. * @param feedback_props Properties of the feedback model. * @param phys_const The #phys_const. * @param us The #unit_system. * @param with_cosmology Are we running with cosmological time integration. * @param cosmo The current cosmological model (used if running with * cosmology). * @param ti_current The current time (in integer). * @param time The current time (in double, used if running without cosmology). * @param time_base The time base. */ float feedback_compute_spart_timestep( const struct spart* const sp, const struct feedback_props* feedback_props, const struct phys_const* phys_const, const struct unit_system* us, const int with_cosmology, const struct cosmology* cosmo, const integertime_t ti_current, const double time, const double time_base) { const float dt = FLT_MAX; /* If the star is dead, do not limit its timestep */ if (sp->feedback_data.is_dead) { return FLT_MAX; } else { return dt; } } /** * @brief Will this star particle want to do feedback during the next time-step? * * This is called in the time step task. * * In GEAR, we compute the full stellar evolution here. * * @param sp The particle to act upon * @param feedback_props The #feedback_props structure. * @param cosmo The current cosmological model. * @param us The unit system. * @param phys_const The #phys_const. * @param ti_current The current time (in integer) * @param time_base The time base. * @param time The physical time in internal units. */ void feedback_will_do_feedback( struct spart* sp, const struct feedback_props* feedback_props, const int with_cosmology, const struct cosmology* cosmo, const double time, const struct unit_system* us, const struct phys_const* phys_const, const integertime_t ti_current, const double time_base) { /* Zero the energy of supernovae */ sp->feedback_data.energy_ejected = 0; sp->feedback_data.will_do_feedback = 0; /* quit if the birth_scale_factor or birth_time is negative */ if (sp->birth_scale_factor < 0.0 || sp->birth_time < 0.0) return; /* Pick the correct table. (if only one table, threshold is < 0) */ const float metal = chemistry_get_star_total_iron_mass_fraction_for_feedback(sp); const float threshold = feedback_props->metallicity_max_first_stars; /* If metal < threshold, then sp is a first star particle. */ const int is_first_star = metal < threshold; const struct stellar_model* model = is_first_star ? &feedback_props->stellar_model_first_stars : &feedback_props->stellar_model; /* Compute the times */ double star_age_beg_step = 0; double dt_enrichment = 0; integertime_t ti_begin = 0; compute_time(sp, with_cosmology, cosmo, &star_age_beg_step, &dt_enrichment, &ti_begin, ti_current, time_base, time); #ifdef SWIFT_DEBUG_CHECKS if (sp->birth_time == -1.) error("Evolving a star particle that should not!"); if (star_age_beg_step + dt_enrichment < 0) { error("Negative age for a star"); } #endif /* Ensure that the age is positive (rounding errors) */ const double star_age_beg_step_safe = star_age_beg_step < 0 ? 0 : star_age_beg_step; /* A single star */ if (sp->star_type == single_star) { /* If the star has completely exploded, do not continue. This will also avoid NaN values in the liftetime if the mass is set to 0. Correction (28.04.2024): A bug fix in the mass of the star (see stellar_evolution.c in stellar_evolution_compute_X_feedback_properties, X=discrete, continuous) has changed the mass of the star from 0 to discrete_star_minimal_gravity_mass. Hence the fix is propagated here. */ if (sp->mass <= model->discrete_star_minimal_gravity_mass) { return; } /* Now, compute the stellar evolution state for individual star particles. */ stellar_evolution_evolve_individual_star(sp, model, cosmo, us, phys_const, ti_begin, star_age_beg_step_safe, dt_enrichment); } else { /* Compute the stellar evolution including SNe energy. This function treats the case of particles representing the whole IMF (star_type = star_population) and the particles representing only the continuous part of the IMF (star_type = star_population_continuous_IMF) */ stellar_evolution_evolve_spart(sp, model, cosmo, us, phys_const, ti_begin, star_age_beg_step_safe, dt_enrichment); } /* Apply the energy efficiency factor */ sp->feedback_data.energy_ejected *= feedback_props->supernovae_efficiency; /* Set the particle as doing some feedback */ sp->feedback_data.will_do_feedback = sp->feedback_data.energy_ejected != 0. || !sp->feedback_data.is_dead; } /** * @brief Compute the times for the stellar model. * * This function assumed to be called in the time step task. * * @param sp The #spart to act upon * @param with_cosmology Are we running with the cosmological expansion? * @param cosmo The current cosmological model. * @param star_age_beg_of_step (output) Age of the star at the beginning of the * step. * @param dt_enrichment (output) Time step for the stellar evolution. * @param ti_begin_star (output) Integer time at the beginning of the time step. * @param ti_current The current time (in integer) * @param time_base The time base. * @param time The current time (in double) */ void compute_time(struct spart* sp, const int with_cosmology, const struct cosmology* cosmo, double* star_age_beg_of_step, double* dt_enrichment, integertime_t* ti_begin_star, const integertime_t ti_current, const double time_base, const double time) { const integertime_t ti_step = get_integer_timestep(sp->time_bin); *ti_begin_star = get_integer_time_begin(ti_current, sp->time_bin); /* Get particle time-step */ double dt_star; if (with_cosmology) { dt_star = cosmology_get_delta_time(cosmo, *ti_begin_star, *ti_begin_star + ti_step); } else { dt_star = get_timestep(sp->time_bin, time_base); } /* Calculate age of the star at current time */ double star_age_end_of_step; if (with_cosmology) { if (cosmo->a > (double)sp->birth_scale_factor) star_age_end_of_step = cosmology_get_delta_time_from_scale_factors( cosmo, (double)sp->birth_scale_factor, cosmo->a); else star_age_end_of_step = 0.; } else { star_age_end_of_step = max(time - (double)sp->birth_time, 0.); } /* Get the length of the enrichment time-step */ *dt_enrichment = feedback_get_enrichment_timestep(sp, with_cosmology, cosmo, time, dt_star); *star_age_beg_of_step = star_age_end_of_step - *dt_enrichment; } /** * @brief Returns the length of time since the particle last did * enrichment/feedback. * * @param sp The #spart. * @param with_cosmology Are we running with cosmological time integration on? * @param cosmo The cosmological model. * @param time The current time (since the Big Bang / start of the run) in * internal units. * @param dt_star the length of this particle's time-step in internal units. * @return The length of the enrichment step in internal units. */ double feedback_get_enrichment_timestep(const struct spart* sp, const int with_cosmology, const struct cosmology* cosmo, const double time, const double dt_star) { return dt_star; } /** * @brief Prepare the feedback fields after a star is born. * * This function is called in the functions sink_copy_properties_to_star() and * star_formation_copy_properties(). * * @param sp The #spart to act upon. * @param feedback_props The feedback perties to use. * @param star_type The stellar particle type. */ void feedback_init_after_star_formation( struct spart* sp, const struct feedback_props* feedback_props, const enum stellar_type star_type) { feedback_init_spart(sp); /* Zero the energy of supernovae */ sp->feedback_data.energy_ejected = 0; /* Activate the feedback loop for the first step */ sp->feedback_data.will_do_feedback = 1; /* Give to the star its appropriate type: single star, continuous IMF star or single population star */ sp->star_type = star_type; } /** * @brief Initialises the s-particles feedback props for the first time * * This function is called only once just after the ICs have been * read in to do some conversions. * * @param sp The particle to act upon. * @param feedback_props The properties of the feedback model. */ void feedback_first_init_spart(struct spart* sp, const struct feedback_props* feedback_props) { /* Initialize the feedback struct for the first time */ feedback_init_spart(sp); /* Zero the energy of supernovae */ sp->feedback_data.energy_ejected = 0; /* Activate the feedback loop for the first step */ sp->feedback_data.will_do_feedback = 1; } /** * @brief Write a feedback struct to the given FILE as a stream of bytes. * * @param feedback the struct * @param stream the file stream */ void feedback_struct_dump(const struct feedback_props* feedback, FILE* stream) { restart_write_blocks((void*)feedback, sizeof(struct feedback_props), 1, stream, "feedback", "feedback function"); stellar_evolution_dump(&feedback->stellar_model, stream); if (feedback->metallicity_max_first_stars != -1) { stellar_evolution_dump(&feedback->stellar_model_first_stars, stream); } } /** * @brief Restore a feedback struct from the given FILE as a stream of * bytes. * * @param feedback the struct * @param stream the file stream */ void feedback_struct_restore(struct feedback_props* feedback, FILE* stream) { restart_read_blocks((void*)feedback, sizeof(struct feedback_props), 1, stream, NULL, "feedback function"); stellar_evolution_restore(&feedback->stellar_model, stream); if (feedback->metallicity_max_first_stars != -1) { stellar_evolution_restore(&feedback->stellar_model_first_stars, stream); } } /** * @brief Clean the allocated memory. * * @param feedback the #feedback_props. */ void feedback_clean(struct feedback_props* feedback) { stellar_evolution_clean(&feedback->stellar_model); if (feedback->metallicity_max_first_stars != -1) { stellar_evolution_clean(&feedback->stellar_model_first_stars); } }