bluemira.fuel_cycle.timeline
============================

.. py:module:: bluemira.fuel_cycle.timeline

.. autoapi-nested-parse::

   Partially randomised fusion reactor load signal object and tools



Classes
-------

.. autoapisummary::

   bluemira.fuel_cycle.timeline.Timeline


Module Contents
---------------

.. py:class:: Timeline(phase_names: list[str], phase_durations: list[float], load_factors: list[float], n_pulses: list[int], t_rampups: list[float], t_flattops: list[float], t_rampdowns: list[float], t_min_downs: list[float], n_DTs: list[int], n_DDs: list[int], plasma_currents: list[float], load_factor: float, blk_dmg: float, blk_1_dpa: float, blk_2_dpa: float, div_dmg: float, div_dpa: float, tf_ins_nflux: float, tf_fluence: float, vv_dmg: float, vv_dpa: float, availability_strategy: bluemira.fuel_cycle.timeline_tools.OperationalAvailabilityStrategy, rng: numpy.random.BitGenerator)

   A Timeline is a compilation of OperationPhase and MaintenancePhase objects

   :param phase_names: The names of all the phases, from: ['Phase P X.x', 'Phase M X.x']
   :param phase_durations: The durations of all the phases [y]
   :param load_factors: The load factors of the operational phases only
   :param n_pulses: The number of pulses of the operational phases only
   :param t_rampups: The ramp-up duration of each pulse during each operation phase [s]
   :param t_flattops: The flat-top duration of each pulse during each operation phase [s]
   :param t_rampdowns: The ramp-down duration of each pulse during each operation phase [s]
   :param t_min_downs: The minimum downtime between pulses during each operation phase [s]
   :param n_DTs: The D-T reaction rate at full power during each operation phase [1/s]
   :param n_DDs: The D-D reaction rate at full power during each operation phase [1/s]
   :param plasma_currents: The plasma current at full power during each operation phase [A]
   :param load_factor: The global timeline load factor 0 < float < 1
   :param blk_dmg: The rate of neutron damage to the blankets [dpa/yr]
   :param blk_1_dpa: The 1st blanket life limit [dpa]
   :param blk_2_dpa: The second blanket life limit [dpa]
   :param div_dmg: The rate of neutron damage to the divertors [dpa/yr]
   :param div_dpa: The divertor life limit [dpa]
   :param tf_ins_nflux: The neutron flux at the TF coil insulation [1/m^2/s]
   :param tf_fluence: The peak neutron fluence the TF coil insulation can handle [1/m^2]
   :param vv_dmg: The rate of neutron damage to the vacuum vessel [dpa/yr]
   :param vv_dpa: The vacuum vessel life limit [dpa]
   :param availability_strategy: Operational availability strategy
   :param rng: Operational outages random number generator

   .. attribute:: t

      Reactor calendar time [yr]

   .. attribute:: ft

      Reactor fusion time [yr]

   .. attribute:: I

      Plasma current signal vector [A]

   .. attribute:: DT_rate

      D-T fusion rate signal [1/s]

   .. attribute:: DD_rate

      D-D fusion rate signal [1/s]

   .. attribute:: bci

      The blanket change index


   .. py:attribute:: A_global


   .. py:attribute:: blk_dmg


   .. py:attribute:: blk_1_dpa


   .. py:attribute:: blk_2_dpa


   .. py:attribute:: div_dmg


   .. py:attribute:: div_dpa


   .. py:attribute:: tf_ins_nflux


   .. py:attribute:: tf_fluence


   .. py:attribute:: vv_dmg


   .. py:attribute:: vv_dpa


   .. py:attribute:: mci
      :value: None



   .. py:attribute:: phases
      :value: []



   .. py:method:: build_arrays(phases: list[Phase])

      Build the time arrays based on phases.

      :param phases: The list of phases objects to be concatenated



   .. py:method:: to_dict() -> dict[str, numpy.ndarray | int]

      Convert the timeline to a dictionary object for use in FuelCycle.

      :returns: Dictionary of fuel cycle object



   .. py:method:: component_damage()

      Calculates the blanket change index and creates largely superficial
      damage timelines



   .. py:method:: plot_damage()

      Plots the damage in the various components over the Timeline. Das hast
      du ein Mal in einem Paper benutzt

      :returns: The plot axis