Package io.jenetics
Class LongChromosome
- java.lang.Object
-
- io.jenetics.AbstractChromosome<G>
-
- io.jenetics.LongChromosome
-
- All Implemented Interfaces:
BoundedChromosome<Long,LongGene>
,Chromosome<LongGene>
,NumericChromosome<Long,LongGene>
,BaseSeq<LongGene>
,Factory<Chromosome<LongGene>>
,Verifiable
,Serializable
,Iterable<LongGene>
,RandomAccess
public class LongChromosome extends AbstractChromosome<G> implements NumericChromosome<Long,LongGene>, Serializable
Numeric chromosome implementation which holds 64 bit integer numbers.- Since:
- 1.6
- Version:
- 6.1
- See Also:
LongGene
, Serialized Form- Implementation Note:
- This class is immutable and thread-safe.
-
-
Field Summary
-
Fields inherited from class io.jenetics.AbstractChromosome
_genes, _valid
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
LongChromosome(ISeq<LongGene> genes, IntRange lengthRange)
Create a new chromosome from the givengenes
and the allowed length range of the chromosome.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
equals(Object obj)
int
hashCode()
IntRange
lengthRange()
Return the allowed length range of the chromosome.LongStream
longStream()
Returns a sequential stream of the alleles with this chromosome as its source.LongChromosome
map(Function<? super long[],long[]> f)
Maps the gene alleles of this chromosome, given aslong[]
array, by applying the given mapper functionf
.A
max()
Return the maximum value of thisBoundedChromosome
.A
min()
Return the minimum value of thisBoundedChromosome
.LongChromosome
newInstance()
Create a new instance of type T.LongChromosome
newInstance(ISeq<LongGene> genes)
A factory method which creates a newChromosome
of specific type and the givengenes
.static LongChromosome
of(long min, long max)
Create a new randomLongChromosome
of length one.static LongChromosome
of(long min, long max, int length)
Create a new randomLongChromosome
.static LongChromosome
of(long min, long max, IntRange lengthRange)
Create a new random chromosome.static LongChromosome
of(LongGene... genes)
Create a newLongChromosome
with the given genes.static LongChromosome
of(LongRange range)
Create a new randomLongChromosome
of length one.static LongChromosome
of(LongRange range, int length)
Create a new randomLongChromosome
.static LongChromosome
of(LongRange range, IntRange lengthRange)
Create a new random chromosome.static LongChromosome
of(Iterable<LongGene> genes)
Create a newLongChromosome
with the given genes.long[]
toArray()
Returns an long array containing all of the elements in this chromosome in proper sequence.long[]
toArray(long[] array)
Returns an long array containing all of the elements in this chromosome in proper sequence.-
Methods inherited from class io.jenetics.AbstractChromosome
get, isValid, length, toString
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface io.jenetics.util.BaseSeq
get, isEmpty, iterator, length, listIterator, nonEmpty, spliterator, stream
-
Methods inherited from interface io.jenetics.BoundedChromosome
max, min
-
Methods inherited from interface io.jenetics.Chromosome
as, gene, isValid
-
Methods inherited from interface io.jenetics.NumericChromosome
byteValue, byteValue, doubleValue, doubleValue, floatValue, floatValue, intValue, intValue, longValue, longValue, shortValue, shortValue
-
-
-
-
Constructor Detail
-
LongChromosome
protected LongChromosome(ISeq<LongGene> genes, IntRange lengthRange)
Create a new chromosome from the givengenes
and the allowed length range of the chromosome.- Parameters:
genes
- the genes that form the chromosome.lengthRange
- the allowed length range of the chromosome- Throws:
NullPointerException
- if one of the arguments isnull
.IllegalArgumentException
- if the length of the gene sequence is empty, doesn't match with the allowed length range, the minimum or maximum of the range is smaller or equal zero or the given range size is zero.- Since:
- 4.0
-
-
Method Detail
-
newInstance
public LongChromosome newInstance(ISeq<LongGene> genes)
Description copied from interface:Chromosome
A factory method which creates a newChromosome
of specific type and the givengenes
.- Specified by:
newInstance
in interfaceChromosome<LongGene>
- Parameters:
genes
- the genes of the new chromosome. The given genes array is not copied.- Returns:
- A new
Chromosome
of the same type with the given genes.
-
newInstance
public LongChromosome newInstance()
Description copied from interface:Factory
Create a new instance of type T.- Specified by:
newInstance
in interfaceFactory<Chromosome<LongGene>>
- Returns:
- a new instance of type T
-
map
public LongChromosome map(Function<? super long[],long[]> f)
Maps the gene alleles of this chromosome, given aslong[]
array, by applying the given mapper functionf
. The mapped gene values are then wrapped into a newly created chromosome.final LongChromosome chromosome = ...; final LongChromosome halved = chromosome.map(Main::half); static long[] half(final long[] values) { for (int i = 0; i < values.length; ++i) { values[i] /= 2; } return values; }
- Parameters:
f
- the mapper function- Returns:
- a newly created chromosome with the mapped gene values
- Throws:
NullPointerException
- if the mapper function isnull
.IllegalArgumentException
- if the length of the mappedlong[]
array is empty or doesn't match with the allowed length range- Since:
- 6.1
-
longStream
public LongStream longStream()
Returns a sequential stream of the alleles with this chromosome as its source.- Returns:
- a sequential stream of alleles
- Since:
- 4.3
-
toArray
public long[] toArray(long[] array)
Returns an long array containing all of the elements in this chromosome in proper sequence. If the chromosome fits in the specified array, it is returned therein. Otherwise, a new array is allocated with the length of this chromosome.- Parameters:
array
- the array into which the elements of this chromosomes are to be stored, if it is big enough; otherwise, a new array is allocated for this purpose.- Returns:
- an array containing the elements of this chromosome
- Throws:
NullPointerException
- if the givenarray
isnull
- Since:
- 3.0
-
toArray
public long[] toArray()
Returns an long array containing all of the elements in this chromosome in proper sequence.- Returns:
- an array containing the elements of this chromosome
- Since:
- 3.0
-
of
public static LongChromosome of(LongGene... genes)
Create a newLongChromosome
with the given genes.- Parameters:
genes
- the genes of the chromosome.- Returns:
- a new chromosome with the given genes.
- Throws:
NullPointerException
- if the givengenes
arenull
IllegalArgumentException
- if the length of the genes array is empty or the givengenes
doesn't have the same range.
-
of
public static LongChromosome of(Iterable<LongGene> genes)
Create a newLongChromosome
with the given genes.- Parameters:
genes
- the genes of the chromosome.- Returns:
- a new chromosome with the given genes.
- Throws:
NullPointerException
- if the givengenes
arenull
IllegalArgumentException
- if the of the genes iterable is empty or the givengenes
doesn't have the same range.- Since:
- 4.3
-
of
public static LongChromosome of(long min, long max, IntRange lengthRange)
Create a new random chromosome.- Parameters:
min
- the min value of theLongGene
s (inclusively).max
- the max value of theLongGene
s (inclusively).lengthRange
- the allowed length range of the chromosome.- Returns:
- a new
IntegerChromosome
with the given parameter - Throws:
IllegalArgumentException
- if the length of the gene sequence is empty, doesn't match with the allowed length range, the minimum or maximum of the range is smaller or equal zero or the given range size is zero.NullPointerException
- if the givenlengthRange
isnull
- Since:
- 4.0
-
of
public static LongChromosome of(long min, long max, int length)
Create a new randomLongChromosome
.- Parameters:
min
- the min value of theLongGene
s (inclusively).max
- the max value of theLongGene
s (inclusively).length
- the length of the chromosome.- Returns:
- a new
LongChromosome
with the given gene parameters. - Throws:
IllegalArgumentException
- if thelength
is smaller than one.
-
of
public static LongChromosome of(LongRange range, IntRange lengthRange)
Create a new random chromosome.- Parameters:
range
- the integer range of the chromosome.lengthRange
- the allowed length range of the chromosome.- Returns:
- a new
LongChromosome
with the given parameter - Throws:
IllegalArgumentException
- if the length of the gene sequence is empty, doesn't match with the allowed length range, the minimum or maximum of the range is smaller or equal zero or the given range size is zero.NullPointerException
- if the givenlengthRange
isnull
- Since:
- 4.0
-
of
public static LongChromosome of(LongRange range, int length)
Create a new randomLongChromosome
.- Parameters:
range
- the long range of the chromosome.length
- the length of the chromosome.- Returns:
- a new random
LongChromosome
- Throws:
NullPointerException
- if the givenrange
isnull
IllegalArgumentException
- if thelength
is smaller than one.- Since:
- 3.2
-
of
public static LongChromosome of(long min, long max)
Create a new randomLongChromosome
of length one.- Parameters:
min
- the minimal value of this chromosome (inclusively).max
- the maximal value of this chromosome (inclusively).- Returns:
- a new
LongChromosome
with the given gene parameters.
-
of
public static LongChromosome of(LongRange range)
Create a new randomLongChromosome
of length one.- Parameters:
range
- the long range of the chromosome.- Returns:
- a new random
LongChromosome
of length one - Throws:
NullPointerException
- if the givenrange
isnull
- Since:
- 3.2
-
min
public A min()
Description copied from interface:BoundedChromosome
Return the minimum value of thisBoundedChromosome
.- Specified by:
min
in interfaceBoundedChromosome<A extends Comparable<? super A>,G extends BoundedGene<A,G>>
- Returns:
- the minimum value of this
BoundedChromosome
.
-
max
public A max()
Description copied from interface:BoundedChromosome
Return the maximum value of thisBoundedChromosome
.- Specified by:
max
in interfaceBoundedChromosome<A extends Comparable<? super A>,G extends BoundedGene<A,G>>
- Returns:
- the maximum value of this
BoundedChromosome
.
-
hashCode
public int hashCode()
-
equals
public boolean equals(Object obj)
-
lengthRange
public IntRange lengthRange()
Return the allowed length range of the chromosome. The minimum value of the range is included and the maximum value is excluded.- Returns:
- the allowed length range of the chromosome
-
-