//==============================================================================
//	
//	Copyright (c) 2014-
//	Authors:
//	* Joachim Klein <klein@tcs.inf.tu-dresden.de> (TU Dresden)
//	
//------------------------------------------------------------------------------
//	
//	This file is part of PRISM.
//	
//	PRISM is free software; you can redistribute it and/or modify
//	it under the terms of the GNU General Public License as published by
//	the Free Software Foundation; either version 2 of the License, or
//	(at your option) any later version.
//	
//	PRISM 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 General Public License
//	along with PRISM; if not, write to the Free Software Foundation,
//	Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//	
//==============================================================================

package acceptance;

import java.util.BitSet;

import jdd.JDDVars;

/**
 * Generic interface for an omega-regular acceptance condition (BitSet-based).
 */
public interface AcceptanceOmega extends Cloneable
{
	/** Returns true if the bottom strongly connected component (BSSC)
	 *  given by bscc_states is accepting for this acceptance condition.
	 **/
	public boolean isBSCCAccepting(BitSet bscc_states);

	/** Get the acceptance signature for state i.
	 **/
	public String getSignatureForState(int i);

	/**
	 * Get a string describing the acceptance condition's size,
	 * i.e. "x Rabin pairs", etc.
	 */
	public String getSizeStatistics();

	/** Returns the AcceptanceType of this acceptance condition */
	public AcceptanceType getType();

	/** Returns the type of this acceptance condition as a String,
	 * i.e., "R" for Rabin
	 */
	public String getTypeAbbreviated();

	/** Returns a full name for this acceptance condition */
	public String getTypeName();

	/** Make a copy of the acceptance condition. */
	public AcceptanceOmega clone();

	/** Abstract functor for use with the lift function. */
	public static abstract class LiftBitSet {
		public abstract BitSet lift(BitSet states);
	};

	/**
	 * Lift the state sets in the acceptance condition.
	 * For each state set {@code states} in the condition,
	 * {@code lifter.lift(states)} is called and the state set is
	 * replaced by the result.
	 **/
	public void lift(LiftBitSet lifter);

	/**
	 * Convert this BitSet based acceptance condition to the corresponding BDD based acceptance condition.
	 * @param ddRowVars JDDVars of the row variables corresponding to the bits in the bitset
	 */
	public AcceptanceOmegaDD toAcceptanceDD(JDDVars ddRowVars);
	
	/**
	 * Convert this acceptance condition to an AcceptanceGeneric condition.
	 */
	public AcceptanceGeneric toAcceptanceGeneric();
}