org.ranksys.fast.preference

Class IteratorsAbstractFastPreferenceData<U,I>

java.lang.Object

es.uam.eps.ir.ranksys.fast.preference.AbstractFastPreferenceData<U,I>

org.ranksys.fast.preference.IteratorsAbstractFastPreferenceData<U,I>

Type Parameters:

U - user type

I - item type

All Implemented Interfaces:

ItemIndex<I>, UserIndex<U>, PreferenceData<U,I>, FastItemIndex<I>, FastUserIndex<U>, FastPreferenceData<U,I>, Serializable

Direct Known Subclasses:

AbstractCODECPreferenceData

public abstract class IteratorsAbstractFastPreferenceData<U,I>
extends AbstractFastPreferenceData<U,I>

Extends AbstractFastPreferenceData and implements the data access stream-based methods using the iterator-based ones. Avoids duplicating code where iterator-based methods are preferred.

Author:

Saúl Vargas (Saul@VargasSandoval.es)

See Also:

Serialized Form

Field Summary

Fields inherited from class es.uam.eps.ir.ranksys.fast.preference.AbstractFastPreferenceData

ii, iPrefFun, ui, uPrefFun

Constructor Summary

Constructors

Constructor and Description
IteratorsAbstractFastPreferenceData(FastUserIndex<U> userIndex, FastItemIndex<I> itemIndex) Constructor with default IdxPref to IdPref converter.
IteratorsAbstractFastPreferenceData(FastUserIndex<U> userIndex, FastItemIndex<I> itemIndex, Function<IdxPref,IdPref<I>> uPrefFun, Function<IdxPref,IdPref<U>> iPrefFun) Constructor with custom IdxPref to IdPref converter.

Method Summary

Modifier and Type	Method and Description
Stream<? extends IdxPref>	getIidxPreferences(int iidx) Gets the preferences of an item.
protected Stream<IdxPref>	getPreferences(int n, it.unimi.dsi.fastutil.ints.IntIterator idxs, it.unimi.dsi.fastutil.doubles.DoubleIterator vs) Converts the int and double iterators to a stream of IdxPref.
Stream<? extends IdxPref>	getUidxPreferences(int uidx) Gets the preferences of a user.
boolean	useIteratorsPreferentially() Use methods returning IntIterator or DoubleIterator over streams of IdxPref?

Methods inherited from class es.uam.eps.ir.ranksys.fast.preference.AbstractFastPreferenceData

containsItem, containsUser, getAllItems, getAllUsers, getItemPreferences, getItemsWithPreferences, getUserPreferences, getUsersWithPreferences, iidx2item, item2iidx, numItems, numItems, numItemsWithPreferences, numUsers, numUsers, numUsersWithPreferences, uidx2user, user2uidx

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface es.uam.eps.ir.ranksys.fast.preference.FastPreferenceData

getIidxUidxs, getIidxVs, getIidxWithPreferences, getUidxIidxs, getUidxVs, getUidxWithPreferences, numItems, numUsers

Methods inherited from interface es.uam.eps.ir.ranksys.core.preference.PreferenceData

numPreferences

Methods inherited from interface es.uam.eps.ir.ranksys.fast.index.FastUserIndex

getAllUidx, uidx2user, uidx2user, user2uidx, user2uidx

Methods inherited from interface es.uam.eps.ir.ranksys.fast.index.FastItemIndex

getAllIidx, iidx2item, iidx2item, item2iidx, item2iidx

Constructor Detail

IteratorsAbstractFastPreferenceData

public IteratorsAbstractFastPreferenceData(FastUserIndex<U> userIndex,
                                           FastItemIndex<I> itemIndex)

Constructor with default IdxPref to IdPref converter.

Parameters:

userIndex - user index

itemIndex - item index

IteratorsAbstractFastPreferenceData

public IteratorsAbstractFastPreferenceData(FastUserIndex<U> userIndex,
                                           FastItemIndex<I> itemIndex,
                                           Function<IdxPref,IdPref<I>> uPrefFun,
                                           Function<IdxPref,IdPref<U>> iPrefFun)

Constructor with custom IdxPref to IdPref converter.

Parameters:

userIndex - user index

itemIndex - item index

uPrefFun - user IdxPref to IdPref converter

iPrefFun - item IdxPref to IdPref converter

Method Detail

getUidxPreferences

public Stream<? extends IdxPref> getUidxPreferences(int uidx)

Description copied from interface: FastPreferenceData

Gets the preferences of a user.

Parameters:

uidx - user index

Returns:

preferences of the user

getIidxPreferences

public Stream<? extends IdxPref> getIidxPreferences(int iidx)

Description copied from interface: FastPreferenceData

Gets the preferences of an item.

Parameters:

iidx - item index

Returns:

preferences of the item

getPreferences

protected Stream<IdxPref> getPreferences(int n,
                                         it.unimi.dsi.fastutil.ints.IntIterator idxs,
                                         it.unimi.dsi.fastutil.doubles.DoubleIterator vs)

Converts the int and double iterators to a stream of IdxPref.

Parameters:

n - length of iterators

idxs - iterator of user/item indices

vs - interator of user/item values

Returns:

stream of IdxPref

useIteratorsPreferentially

public boolean useIteratorsPreferentially()

Description copied from interface: FastPreferenceData

Use methods returning IntIterator or DoubleIterator over streams of IdxPref?

Returns:

yes/no