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:
- Implementation Note:
- This class is immutable and thread-safe.
-
Field Summary
Fields inherited from class io.jenetics.AbstractChromosome
_genes, _valid
-
Constructor Summary
ModifierConstructorDescriptionprotected
LongChromosome
(ISeq<LongGene> genes, IntRange lengthRange) Create a new chromosome from the givengenes
and the allowed length range of the chromosome. -
Method Summary
Modifier and TypeMethodDescriptionboolean
int
hashCode()
Return the allowed length range of the chromosome.Returns a sequential stream of the alleles with this chromosome as its source.Maps the gene alleles of this chromosome, given aslong[]
array, by applying the given mapper functionf
.max()
Return the maximum value of thisBoundedChromosome
.min()
Return the minimum value of thisBoundedChromosome
.Create a new instance of type T.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
Create a new random chromosome.static LongChromosome
Create a newLongChromosome
with the given genes.static LongChromosome
Create a new randomLongChromosome
of length one.static LongChromosome
Create a new randomLongChromosome
.static LongChromosome
Create a new random chromosome.static LongChromosome
Create a newLongChromosome
with the given genes.long[]
toArray()
Returns an long array containing all the elements in this chromosome in proper sequence.long[]
toArray
(long[] array) Returns an long array containing all 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
forEach, 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 Details
-
LongChromosome
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 Details
-
newInstance
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
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
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
Returns a sequential stream of the alleles with this chromosome as its source.- Returns:
- a sequential stream of alleles
- Since:
- 4.3
-
toArray
Returns an long array containing all 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 these 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
Returns an long array containing all the elements in this chromosome in proper sequence.- Returns:
- an array containing the elements of this chromosome
- Since:
- 3.0
-
of
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
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
Create a new random chromosome.- Parameters:
min
- the min value of theLongGene
s (inclusively).max
- the max value of theLongGene
s (exclusively).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.IllegalArgumentException
- ifmax
is greater than or equal tomin
NullPointerException
- if the givenlengthRange
isnull
- Since:
- 4.0
-
of
Create a new randomLongChromosome
.- Parameters:
min
- the min value of theLongGene
s (inclusively).max
- the max value of theLongGene
s (exclusively).length
- the length of the chromosome.- Returns:
- a new
LongChromosome
with the given gene parameters. - Throws:
IllegalArgumentException
- if thelength
is smaller than one.IllegalArgumentException
- ifmax
is greater than or equal tomin
-
of
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.IllegalArgumentException
- ifmax
is greater than or equal tomin
NullPointerException
- if the givenlengthRange
isnull
- Since:
- 4.0
-
of
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.IllegalArgumentException
- ifmax
is greater than or equal tomin
- Since:
- 3.2
-
of
Create a new randomLongChromosome
of length one.- Parameters:
min
- the minimal value of this chromosome (inclusively).max
- the maximal value of this chromosome (exclusively).- Returns:
- a new
LongChromosome
with the given gene parameters. - Throws:
IllegalArgumentException
- ifmax
is greater than or equal tomin
-
of
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
IllegalArgumentException
- ifmax
is greater than or equal tomin
- Since:
- 3.2
-
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
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
-
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
-