.. _State_No_Conserve_Functions:

*************************************************
State enumeration **without** number conservation
*************************************************

All functions have the name tag **_NoU1** which means that the total :ref:`particle number<eq:state_functions_particle_number>` is **not** conserved.
The number of possible states is simply :math:`Q^{\textbf{end}-\textbf{start}}` which is returned by :ref:`get_dim_NoU1(end-start)<State_No_Conserve_Functions_get_dim_NoU1>`.
The :ref:`constructor<State_Index_Constructors_No_Conserve>` can be found in :ref:`Constructors with indexing<State_Index_Constructors>`.
We provide functions for :ref:`forward<State_No_Conserve_Functions_increment_NoU1>` and :ref:`backward<State_No_Conserve_Functions_decrement_NoU1>` iteration as well as mappings from :ref:`indices to the physical state<State_No_Conserve_Functions_set_state_from_index_NoU1>` and :ref:`vice versa<State_No_Conserve_Functions_get_index_NoU1>`.

An equivalent set of functions of functions of an inhomogeneous local Hilbert space dimensions can be found :ref:`below<State_No_Conserve_Functions_IHQ>`.

*   **Example code**:

    .. code-block:: cpp

        using State = danceq::internal::State<5,2>;

        uint64_t start = 1;
        uint64_t end = 4;

        State state(0UL, start, end);
        uint64_t dim = state.get_dim_NoU1(end-start);
        std::cout << "[main] - dim  = " << dim << std::endl;

        for(uint64_t i = 0; i < dim; i++){
            std::cout << "[main] - |Psi_" << i << "> = " << state << std::endl;
            state.increment_NoU1(start,end);
        }


*   **Output**:

    .. code-block:: console

        [main] - dim = 8
        [main] - |Psi_0> = |0;0;0;0;0>
        [main] - |Psi_1> = |0;1;0;0;0>
        [main] - |Psi_2> = |0;0;1;0;0>
        [main] - |Psi_3> = |0;1;1;0;0>
        [main] - |Psi_4> = |0;0;0;1;0>
        [main] - |Psi_5> = |0;1;0;1;0>
        [main] - |Psi_6> = |0;0;1;1;0>
        [main] - |Psi_7> = |0;1;1;1;0>



.. _State_No_Conserve_Functions_set_state_from_index_NoU1:

.. doxygenfunction:: danceq::internal::State::set_state_from_index_NoU1(const uint64_t index, const uint64_t start = 0, const uint64_t end = MaxSites)



.. _State_No_Conserve_Functions_get_index_NoU1:

.. doxygenfunction:: danceq::internal::State::get_index_NoU1(const uint64_t start = 0, const uint64_t end = MaxSites) const

.. _State_No_Conserve_Functions_increment_NoU1:

.. doxygenfunction:: danceq::internal::State::increment_NoU1(const uint64_t start = 0, const uint64_t end = MaxSites, bool* overflow = nullptr);

.. _State_No_Conserve_Functions_decrement_NoU1:

.. doxygenfunction:: danceq::internal::State::decrement_NoU1(const uint64_t start = 0, const uint64_t end = MaxSites, bool* underflow = nullptr);

.. _State_No_Conserve_Functions_get_dim_NoU1:

.. doxygenfunction:: danceq::internal::State::get_dim_NoU1(const uint64_t length = MaxSites)

.. _State_No_Conserve_Functions_IHQ:

Inhomogeneous Hilbert space dimensions
--------------------------------------

.. _State_No_Conserve_Functions_set_state_from_index_NoU1_IHQ:

.. doxygenfunction:: danceq::internal::State::set_state_from_index_NoU1_IHQ(const uint64_t index, const std::vector<uint64_t>& Q_list, const uint64_t start = 0)


.. _State_No_Conserve_Functions_get_index_NoU1_IHQ:

.. doxygenfunction:: danceq::internal::State::get_index_NoU1_IHQ(const std::vector<uint64_t>& Q_list, const uint64_t start = 0) const

.. _State_No_Conserve_Functions_get_dim_NoU1_IHQ:

.. doxygenfunction:: danceq::internal::State::get_dim_NoU1_IHQ(const std::vector<uint64_t>& Q_list)