Kyazma Home
Kyazma Home
JoinMap 5 Release Notes
=========================

=== 19 January 2024 ===
Maintenance release of JoinMap 5
  (Build: 19jan2024.28jul2023)

Correction:
- In the situation with a locus that has one or more identicals, where
  the representative locus is excluded while an identical locus is
  included, combined with having the locus or one of its identicals
  in a fixed order, then the map calculations will lead to a runtime
  error (Access violation at ...). This is fixed.


=== 7 October 2022 ===
Maintenance release of JoinMap 5
  (Build: 7oct2022.12jan2022)

Correction:
- In some instances a change of the Windows Theme and/or the use of
  the lock screen could corrupt the navigation tree. One of the
  symptoms was that many nodes are shown as marked (red). Subsequent
  use of the navigation tree (i.e. change of the selected node)
  resulted in runtime errors (Access violation at ...). This is fixed.


=== 21 March 2022 ===
Maintenance release of JoinMap 5
  (Build: 21mar2022.12jan2022)

Corrections:
- With the preceding release the SQLite library was updated as well.
  However, this update introduced a very subtle change in the
  behaviour of SQLite regarding the automatic ROWID variable in
  subqueries. This caused the inability of JoinMap to show the tables
  of several tabsheets, with error messages like 'Failed to prepare
  statement for query: ...'. This is fixed.

- ML maps of CP type populations did not show the plausible positions
  of P1, only those of P2. This is fixed.


=== 14 March 2022 ===
Maintenance release of JoinMap 5
  (Build: 14mar2022.12jan2022)

Correction:
- Calculating the linkages of data of CP type populations could result
  in an incorrect error message 'error in determine_phasecomb()', if
  dominant observations (h-, k-) are present. This bug was introduced
  in the maintenance release of 30 March 2021. It is now fixed.


=== 22 July 2021 ===
Maintenance release of JoinMap 5
  (Build: 22jul2021.22jul2021)

Correction:
- With very large datasets (over 50,000 loci), the function 'Create
  Groups Using the Groupings Tree' would sometimes not finish. This
  is fixed.

- The determination of the strongest cross links did not show its
  progress. This is fixed.

Minor enhancement:
- Similar to the progress of some database actions being shown with
  sequences of '>' symbols on the progress bar, this is now also shown
  in the Windows task bar element of the program with sequences of dot
  characters.


=== 30 March 2021 ===
Maintenance release of JoinMap 5
  (Build: 30mar2021.26mrt2021)

Correction:
- The ML mapping algorithm applied to population type RIx with dense
  regions on the map could result in tiny negative estimates of
  recombination frequencies and map distances, to be seen in the
  Session Log as -0.000. An attempt to invert the resulting map order
  would result in the error message:
    'ReadLoci_SQLite() map position of locus X before that of Y'.
  This problem is solved.

Enhancements:
- The chart title, axis titles and map chart title are enhanced to
  accept unicode.

- Various minor user interface elements are improved.


=== 1 October 2019 ===
Maintenance release of JoinMap 5
  (Build: 1oct2019.19aug2019)

Enhancements:
- The software is enhanced to accept unicode characters in file and
  directory names instead of just the limited set of ASCII characters.

  This means e.g. that if you have an MS-Windows user name consisting
  of non-ASCII characters, JoinMap will now be able to access your
  MS-Windows personal folder 'Documents' (which is accessed internally
  as 'C:\Users\<username>\Documents'). As a result, JoinMap can now
  access its program settings in the 'Documents\JoinMap5' subdirectory
  and can also place projects there. Another advantage is that JoinMap
  can load data into a project from files with names consisting of
  non-ASCII characters; note, however, that the data in these files
  must still be in ASCII.

  However, it is not clear if this works correctly for languages with
  right-to-left directionality.

  The remarks on pages 4 and 17 of the User Manual about ASCII
  characters can now be ignored.

- The various notes tabsheets are also enhanced to accept unicode.

  Although it is not perfect, it works fine under most practical
  circumstances for languages with left-to-right directionality, e.g.
  typing, copying, pasting, exporting and printing. Only under extreme
  conditions the odd character can become corrupted, e.g. an extended
  character at the end of a very long line (lines are limited in
  length to 1024 basic [BMP] characters, while extended [non-BMP]
  characters take up the space of two characters and thus reduce the
  maximum line length). Another aspect is that notes tabsheets are
  based on fixed width fonts and despite of this many non-ASCII
  characters are wider than ASCII characters, which all occupy the
  same width. Due to this, the notes tabsheets may not look very
  elegant.

  When notes tabsheets are exported to file, the file format will be
  'UTF-8-BOM', which preserves all unicode characters. This format is
  recognized properly by most MS-Windows software, e.g. by the text
  editors Notepad++ and MS-Windows Notepad.

  [BMP: Unicode characters are grouped into so-called planes, one of
   which is the Basic Multilingual Plane. This plane contains the
   characters for nearly all modern languages and many symbols.]

- The file with release notes can be viewed using a new option of the
  Help menu.


=== 22 March 2019 ===
Maintenance release of JoinMap 5
  (Build: 22mar2019.21dec2018)

Corrections:
- Computing the linkages of groups of DH and HAP population types
  resulted in 'Access violation' errors. This is corrected.

- Computing the Genotype Probabilities of map nodes of population type
  CP would change the genotype data: the genotypes in linkage phases
  other than {00} would become their genetic equivalents in linkage
  phases {00}. These changed data would be visible on the data
  tabsheets. Also, any further computation (Genotype Probabilities,
  Plausible Positions, Locus Genot. Freq.) would be based on the
  modified data. The change would not be permanent, i.e. re-selecting
  the map node, would reload the correct genotype data.
    This is corrected.

- The print preview and print of colorized data tabsheets of DH, HAP
  and CP population types did not take the linkage phases into
  account. Now they do.


=== 5 January 2019 ===
Final edition of JoinMap 5
  (Build: 5jan2019.21dec2018)

This version is the final release of version 5.

The User Manual is completely rewritten so that it will present all
essential information regarding version 5.

Enhancements:
- The function 'Exclude Marked Loci in Group Node' will now also check
  the Exclude checkboxes of the loci that are identical.

- The marking of nodes in the navigation tree and the groupings tree
  is improved and made more consistent. Pressing the F8 and the space
  key will mark a node, while the Esc key will clear all marks.

- The effect of using of the keys PageUp, PageDown, Home and End,
  possibly in combination with holding a Shift or Ctrl key, is made
  more consistent.

- A Print Setup button was added to the tool bar.

Various minor errors and glitches were corrected.


=== 8 October 2018 ===
Update and maintenance release of JoinMap 5
  (Build: 8oct2018.30apr2018)

This release is the last before the final release. The only planned
addition for the final release is the new User Manual, which will be a
full revision for this version number 5.

Enhancement:
- What was achieved previously for all other population types, is now
  also accomplished for population type CP: the time consuming Gibbs
  sampling method (a Monte Carlo EM algorithm) for the multipoint
  recombination frequency estimation in the ML mapping procedure is
  replaced by a much faster deterministic EM algorithm. The estimates
  are obtained not only faster but also with greater accuracy.

Adjustments:
- The labels on the buttons of the three options dialogs (environment,
  calculation and map chart options) were changed so that their
  meaning is more intuitive.

Correction:
- When computing the linkages of a group of population type CP, the
  linkage phase determination may be unsuccessful. In this case, the
  groups between which the linkage phases could not be determined,
  were printed as a single list of loci without indicating the groups.
  The indicator 'group' is now printed as intended.


=== 21 August 2018 ===
Update and maintenance release of JoinMap 5
  (Build: 21aug2018.30apr2018)

Added functionality:
- The Find tool is enabled for all tables and plain text windows. The
  tool is available from the Edit menu and with the usual key
  combination Ctrl+F. Searching can be done case sensitive or case
  insensitive. Pressing the F3 key will search again for a text
  entered previously in the Find tool.

Corrections:
- Computing the groupings and the linkages for population type CP,
  where the data contain dominant h- or k- genotypes for <hkxhk> type
  markers, could result in the error 'error in determine_phasecomb()'.
  This bug is repaired.

- The Population menu function 'Exclude Similar Loci' always excluded
  the second locus in a pair with a similarity above or equal to the
  given value, regardless whether or not the first locus was excluded
  previously due to similarity with another locus. This could result
  e.g. in excluding locus C if locus B is similar to locus A, and
  locus C to B but not to A. The function works now as intended.


=== 12 June 2018 ===
Update and maintenance release of JoinMap 5
  (Build: 12jun2018.30apr2018)

Added functionality:
- Printing is enabled for most tables and plain text windows.
    In order to print something, first the to be printed range must
  be marked in the regular way (key combination Ctrl+A will mark the
  entire content). Next, pressing key combination Ctrl+P will open the
  Print Preview window, from which the result can be judged prior to
  printing.
    The Preview window's toolbar contains buttons for zooming in or
  out, for fitting page, width or height, and for opening the dialogs
  for the page setup, the print setup and the printing.
    Moving through the preview page(s) can be done by dragging the
  mouse pointer and with the usual keys and key combinations. In
  addition, the numeric keypad plus and minus keys as well as left and
  right double-clicking with the mouse all act on the zoom state.
  Rolling the mouse wheel will scroll the current page, rolling
  combined with pressing the Ctrl key will zoom the page, while
  rolling combined with the Shift key will move through the pages.
    Clicking the Print button or using key combination Ctrl+P (from
  the Preview window) will open the print dialog.
    Pressing key combination Shift+Ctrl+P from the main program window
  will open the print dialog directly without showing the Print
  Preview window. The File menu contains the page setup, print setup,
  the print preview and the print functions.
    Whenever the required width of a print is wider than is available
  on one page, then the remaining parts will automatically be printed
  on a next page or even next pages. In this case for tables, the
  first column is always repeated on such pages to facilitate an easy
  alignment.
    If the number of pages you are starting to print is larger than
  100, then a warning will be issued and you are prompted whether to
  continue or cancel the printing. Also, during the actual printing
  (i.e. sending the data to the MS-Windows print spooler), the print
  job may be cancelled by pressing the Esc or Break key (similar to
  cancelling computations).
    The Data tabsheet's print will not show the 'frozen' top row(s),
  because their contents are usually not very legible anyway (they do
  not fit inside a column).
    It is not possible to print the dataset node's Dataset tabsheet,
  because this is considered not very useful. If you do wish to obtain
  a print of a Dataset tabsheet, then you can copy the content, paste
  it into MS-Excel and print it from there.


=== 2 May 2018 ===
Update and maintenance release of JoinMap 5
  (Build: 2may2018.30apr2018)

Added functionality:
- Charts can be created for the data in the tabsheets, for which it
  can be considered useful (i.e. Individual Genot. Freq., Locus Genot.
  Freq., Mean Chisquare Contribs., Genot. Probs.: Indiv. Means, Genot.
  Probs.: Locus Means, Expected Rec. Count, Fit & Stress).
    If the relevant tabsheet is selected, then click on the 'Create
  Chart' button on the tool bar or use the 'Create Chart' function of
  the Calculate menu. This will result in a chart node being created
  in the navigation tree. The corresponding Chart Control tabsheet has
  many (self explaining) options to set the chart to your preference.
  The available chart types are: bar, stacked bar, stacked area and XY
  chart. Identical loci, if present, will not be shown in the charts.
    Charts can be copied to the clipboard for pasting with other
  software and they can be exported to file in the enhanced metafile
  format (emf).

Correction:
- Combining maps from several nodes could result in a runtime error
  and also mess up the marking of nodes in the navigation tree. This
  is corrected.


=== 21 February 2018 ===
Update and maintenance release of JoinMap 5
  (Build: 21feb2018.11oct2017)

Added functionality:
- Map nodes resulting directly from mapping contain various tabsheets
  with diagnostics about the loci, such as the N.N. Fit and Stress. In
  these tabsheets, rows can be marked and subsequently the Map menu
  function 'Exclude Marked Loci in Group Node' can be applied. In the
  map node's grandparental group node this will check the Exclude
  checkboxes of the loci that correspond to the marked rows.

- Marked regions in the Dataset tabsheet and in editable plain text
  tabsheets (e.g. Notes) can be deleted with key combination Ctrl+Del
  and with an option of the Edit menu.

- A new menu function 'Flip Marked Genotypes' was added for the
  dataset node. Sometimes genotypes may have been coded erroneously,
  e.g. the A was used instead of the B and vice versa; this may result
  in recombination frequency estimates larger than 0.5, showing up in
  a group node's Suspect Linkages tabsheet. This 'Flip' function will
  allow easy correction of such genotype data in the dataset node.
  The function will replace genotype codes in the marked region in
  their opposite codes. The type of replacement depends on the
  population type.
    In a BC1, the A's will be replaced by H's and v.v. if there are
  A's in the marked range, while if there are B's in the marked range
  then B's will be replaced by H's and v.v..
    For population types DH, HAP, HAP1, DH1 and DH2 the A's will be
  replaced by B's and v.v..
    For population types BCpxFy, RIx, IMxFy and F2 the same happens,
  and in addition C's will be replaced by D's and v.v..
    For population type CP the following genotype mutual replacements
  take place:  ad <=> bc,  ef <=> eg,  ll <=> nn,  lm <=> np,
  while in addition the segregation types <lmxll> and <nnxnp> will be
  replaced by each other as well as their corresponding phase and
  classification types.
    In all cases the replacement is case-insensitive and also the
  genotype code must be a correct one, incorrect codes are left
  unchanged. Therefore, it is advised to apply (and pass succesfully)
  the 'Check for Coding Errors' function in advance to the flip.

- Another function was added to the Dataset menu: 'Create Dataset from
  Data Tabsheet'. This function creates a new dataset node and fills
  it with the genotype data of a marked population, group or map node
  that has a Data tabsheet with genotype data. The data of loci and
  individuals that are checked as excluded on the Loci and Individuals
  tabsheets, if present, will not be transfered to the new dataset
  node.

Adjusted:
- The color of marked regions in the tables is changed to red. (Marked
  regions in plain text remains the MS-Windows default, usually blue.)

- The system of marking nodes in the navigation panel is improved.


=== 8 January 2018 ===
Update and maintenance release of JoinMap 5
  (Build: 8jan2018.11oct2017)

Corrections in the ML mapping algorithm:
- The expected recombination counts, the map distances and possibly
  the map order were estimated erroneously for population type BCbxFy.
- The N.N. Stress was computed erroneously for a few population types:
  BC1 (only if coded with H's and B's), BCbxFy, DH and HAP.
  These errors were present since the first pre-release.


=== 20 December 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 20dec2017.11oct2017)

Adjusted functionality:
- The map building approach of the ML mapping algorithm was adjusted
  to become more reliable for high density maps. Spatial sampling is
  still being used for gradually building the map. After the sampling
  threshold becomes 0, then now the building proceeds with adding
  batches of loci instead of adding all remaining loci in one go.
  The loci in each batch are selected at random. The batches are of a
  fixed size, which can be adjusted in the Calculation Options. Three
  of the map optimization (simulated annealing) parameters are now
  specific to each spatial sampling level (now called S1 to S5) and to
  the building with batches after the sampling threshold of 0 is
  reached (called T0). This is meant to be able to speed up the first
  map building levels. The three parameters are: (1) the number of
  optimization rounds per sample, (2) the chain length with constant
  acceptance probability and (3) the stop criterion (stop after #
  chains without improvement).
- The history of the status bar is increased to 50 messages.
- Two parameters used in the true EM approach with the multipoint
  recombination frequency estimation are adjustable in the Calculation
  Options: the maximum number of iterations and the recombination
  frequency tolerance. These parameters determine when the EM
  iterations should stop.

Correction:
- When applying the 'Invert Map' function of a map node, the Plausible
  Positions tabsheet did invert the map, but failed to show the
  position counts at their inverted positions and a recalculation
  would be required. This is now working as expected.


=== 6 November 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 6nov2017.11oct2017)

Added functionality:
- The 'Colorize' function for graphical genotypes takes the linkage
  phases (if available) into account for population types CP, DH and
  HAP.

The following adjustment was made:
- The new (more efficient) locus replacement strategy in the map order
  optimization method (i.e. simulated annealing) turned out to work
  not very well if the number of loci that is added after the last
  spatial sampling threshold is large. For the time being the strategy
  is returned to that of JoinMap v4.1.
  Remark: This does not apply to population type CP. Here the new
  strategy is not yet applied.


=== 27 October 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 27oct2017.11oct2017)

Added functionality:
- Export Map tabsheets from multiple marked map nodes as one joint
  map-file (e.g. for use with MapQTL).
- Export Data tabsheets from multiple marked nodes (population, group
  or map nodes) as one joint loc-file (e.g. for use with MapQTL).

The following corrections were made:
- Individual Genot. Freq. tabsheet would compute all frequencies to
  be 0 for certain individuals if some loci were excluded.
- Assigning ungrouped loci to their SCL-groups at a grouping node
  could lead to an 'access violation' error if a threshold value other
  than the default is used.
- In extreme situations the multipoint recombination frequecy
  estimation procedure could result in a floating point error
  (division by zero).
- Using the 'Move Marked Loci' of grouping nodes did not adjust the
  corresponding group nodes correctly.


=== 7 October 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 7oct2017.2jun2017)

Added functionality:
- Export Map tabsheets as map-files.

The following corrections were made:
- Selecting another node after a map node was selected could lead to
  an 'access violation' error causing the program to stop working.
- Repeatedly doing computations that are done in parallel, like
  calculating groupings, could make the program appear to freeze.


=== 25 September 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 25sep2017.2jun2017)

Added functionality:
- Map charts.
- Copying marked regions in the Further Information window.

The following corrections were made:
- In the computations of pairwise data, numerical problems could lead
  to tiny negative LOD values instead of exactly 0.
- The new, true EM algorithm for multipoint recombination frequency
  estimation could result in some runtime errors ('root not
  bracketed ...', 'division by zero', 'rec.freq. larger than 0.5'),
  preventing the computation of the map or the plausible positions.

NB:
  Because some parameter settings had to be changed, the first time
  the new release is run JoinMap will show two error messages about
  reading the program and page setup; these can be ignored.


=== 11 August 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 11aug2017.2jun2017)

Added functionality:
- Copying and cutting marked regions in plain text tabsheets
  (previously the entire text was taken).

The following corrections were made:
- Due to repeated rounding errors, the interpolation to compute the
  integrated map with population type CP could result in map positions
  of <lmxll> and <nnxnp> markers just outside their interval (less
  than 1e-14 cM). This would result in the next type of error message
  when trying to view the Data tabsheet of or do computations with a
  map node:
    'ReadLoci_SQLite() map position of locus X before that of Y'.
  This is now prevented.
- Fixed and Start order tabsheets were made tolerant for the type of
  newline characters (CR, LF, CR+LF, LF+CR) used with pasted orders.
  Previously this could lead to unrecognized locus names.
- Pasting into plain text tabsheets was made tolerant for the type of
  newline character and for lines longer than the maximum of 1024
  characters. This applies to the Notes, Start and Fixed order
  tabsheets.
- The Dataset node function 'Check for Coding Errors' did not accept
  correct phase type codes for segregation type <nnxnp>; repaired.


=== 14 July 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 14jul2017.2jun2017)

Added functionality:
- 'Move Marked Loci' menu function for grouping nodes.

The following corrections were made:
- The Individual Genotypes Frequencies were determined without taking
  the exclusion of loci into account. Now they are.
- In fields of floating point parameters (e.g. in the Calculation
  Options) the decimal point could not be entered. Now it is possible.
- The reporting about any incompleteness in linkage phase
  determination in the population node computations of groupings was
  poor. Now identicals are not reported anymore and the status whether
  loci are excluded is given.

The Help menu document with the new features of v5 is updated.


=== 3 June 2017 ===
Update and maintenance release of JoinMap 5
  (Build: 3jun2017.26apr2017)

Added functionality:
- marking regions in tables for functions on the marked loci or
  individuals;
- 'Exclude Marked Items' menu function for Individual Genot. Freq. and
  Locus Genot. Freq. tabsheets of population nodes;
- 'Set X2-Test Classification for Marked Loci' menu function for Locus
  Genot. Freq. tabsheet of population and map nodes;
- checking or un-checking a range of checkboxes in marked rows;
- copying and exporting marked rows of tables;
- toggling a checkbox with the Enter key.

The Help menu document with the new features of v5 is updated.

Some bugs were removed, one of which is the 'Invalid floating point
operation' obtained when computing a maximum likelihood map for
population type CP.


=== 16 May 2017 ===
Maintenance release of JoinMap 5
  (Build: 16may2017.26apr2017)

The computations of locus pairs did not deal correctly with
situations, where a locus has all observations missing. This
would lead to the error message
  'Par_Task_Interface->Status not completed'.
This is corrected.


=== 26 April 2017 ===
Early release of JoinMap 5
  (Build: 26apr2017.26apr2017)

= First public release. The final edition of JoinMap v5 is
  several months in the future. Because of the demand, a
  first stable early edition is released. Following this
  first release, subsequent updates with the remaining to be
  added functions will be released in the coming months.



JoinMap 4 & 4.1 Release notes
=============================


=== 31 July 2013 ===
Maintenance releases of JoinMap 4 and 4.1
  (Build: 31jul13.4feb11)

= A function is added to the Grouping node menu:
  'Assign Identical Loci to Their Groups'. The procedure to
  create a grouping node (see 6 and 19 March 2013) assigns
  sets of identical loci to group number 0, with the
  exception of one representing locus for each set. The new
  function will assign the identicals with group number 0 to
  the groups of their representing loci.


=== 19 March 2013 ===
Maintenance release of JoinMap 4
  (Build: 19mar13.4feb11)

= The same changes are applied to JoinMap 4 as in the recent
  maintenance release of JoinMap 4.1 of 6 March 2013.
  See below.


=== 6 March 2013 ===
Maintenance release of JoinMap 4.1
  (Build: 6mar13.4feb11)

= The grouping procedure of sets of loci into linkage
  groups used to be limited to sets of roughly 4000 loci due
  to available RAM memory. As the program is 32-bit it is
  limited by the maximum addressable amount of RAM. A new
  algorithm is implemented that is designed to store
  intermediate results on hard disk rather than in RAM. The
  program can now accommodate sets of up to ~50,000 loci,
  while keeping computation time within acceptable limits.
  On a typical present-day PC, the grouping procedure of
  50,000 loci takes about one hour. The speed of the hard
  disk is an important limiting factor. As the computations
  scale quadratically with the number of loci, groupings of
  smaller sets are still quite fast: 10,000 loci in about
  three minutes, 5000 loci in just about twenty seconds and
  1000 loci in a second.

  Beware that such oversized datasets require extreme file
  sizes: the 50,000 loci require a file of ~30 GB for the
  pairwise data. When creating the grouping node and group
  nodes, this file with pairwise data will be duplicated.
  Thus, ensure that the hard disk in use has sufficient free
  space when dealing with such datasets.

  In large datasets there will often be some redundancy (in
  fact, in most cases there should be). As an new feature
  the grouping procedure determines which loci are
  identical. Being identical is based on the entire set of
  genotype observations of all included (not excluded)
  individuals, including the missing observations. Sets of
  identical loci will be represented by one of them (the
  first not excluded locus). Identical loci will be
  specified at the bottom part of the 'Groupings (text)'
  tabsheet, while a numerical summary is given with the blue
  'Further information' tool bar button. One advantage is
  that the pairwise data will only be calculated for the
  loci that represent their identicals, thus reducing the
  computations.

  When determining a grouping node and group nodes, only the
  representing loci of sets of identical loci will be
  grouped, while in the grouping node tabsheet the identical
  loci will automatically obtain group number 0 (i.e. will
  not be part of a group), with 'identical' as Node name.

  The determination of the SCL-Values takes the identicals
  into account and will list 'identical' as SCL-Value to
  link them to their representing locus. The
  representing loci will obtain a regular SCL-Value.

  The procedure 'Assign Ungrouped Loci to SCL-Groups' will
  leave the identicals assigned to group 0.

  The procedure for determining a grouping based on a map or
  another grouping node will take the identicals into
  account and assign them to group 0.

  The grouping procedure may also be done based on the
  recombination frequency or the linkage LOD. For
  population types CP, DH and HAP, this means that the
  linkage phases must be determined to obtain these values.
  In the original procedure the pairs were sorted to their
  independence LOD value prior to the linkage phase
  determination. To be able to deal with very large datasets
  this sorting is not done anymore. The independence LOD
  threshold for pairs subject to phase determination, which
  used to be internally set at a LOD value 1.0, is now a
  Calculation Options parameter at the Population tabsheet:
  'Determine linkage phases ...'. When in doubt about the
  linkage phase determination you can increase this
  parameter value.

= The navigation panel could disappear after resizing it to
  the smallest size (by dragging the splitter between the
  navigation and the contents-and-results panel).
  Disappearing is now prevented.


=== 11 June 2012 ===
Maintenance release of JoinMap 4
  (Build: 11jun12.4feb11)

= In text tabsheets, like the 'Map (text)' tabsheet,
  sometimes a non-printable character got inserted at a
  random position (visible as a square character). It
  prevented copying the area around it. It is corrected.


=== 14 March 2012 ===
Maintenance releases of JoinMap 4 and 4.1
  (Build: 14mar12.4feb11)

= For population types DH, HAP and CP, the Linkage LODs for
  the Groupings (text and tree) tabsheet as well as the
  corresponding SCL-values of derived Grouping nodes were
  calculated erroneously. This is corrected.

= The calculation option 'Determine linkage phases (CP, DH,
  HAP) with a LOD larger than' was reset to the value 1.0
  each time the groupings of a population node were
  (re)calculated. This is corrected.


=== 4 August 2011 ===
Maintenance release of JoinMap 4.1
  (Build: 4aug11.4feb11)

= The Population menu functions 'Exclude Identicals' and
  'Exclude Similar Loci' could lead to runtime errors with
  larger datasets. The functions have been recoded and are
  now also much faster.

= Renaming the project file without renaming the project
  directory would lead to a rewritten, empty project file.
  This is corrected.


=== 3 August 2011 ===
Maintenance release of JoinMap 4
  (Build: 3aug11.4feb11)

= The Population menu functions 'Exclude Identicals' and
  'Exclude Similar Loci' could lead to runtime errors with
  larger datasets. The functions have been recoded and are
  now also much faster.

= The following minor errors were corrected:

  The heading in the Genotype Probabilities tabsheet had
  'R.Genotype' instead of 'Genotype' for the central
  genotype.

  Long group and map node names were made shorter than the
  allowed 20 characters when closing the project.

  Map charts would inexplicably draw some 'homologs' lines
  between loci that did not have identical names.

  The simulated annealing sometimes appeared to continue
  too long.

  For map nodes the 'Info on Tabsheet Contents' button and
  function in the File menu should be active for several
  tabsheets while they were not.

  Any fixed order used in the determination of plausible
  orders was not reported in the
  'Info on Tabsheet Contents'.

  The name of the HTTP Host of the proxy settings in the
  environment options was not saved.

  Sometimes the decimal separator (the point) was reset to
  the preference in the MS-Windows Regional Options. This
  would lead to error messages like
  '0.000 is not a valid floating point value'.

  Renaming the project file without renaming the project
  directory would lead to a rewritten, empty project file.


=== 20 July 2011 ===
Final version of JoinMap 4.1
  (Build: 20jul11.4feb11)

= The only, but very important, enhancement of version 4.1
  of JoinMap is the ability to use the multipoint maximum
  likelihood mapping algorithm on populations of type CP,
  i.e. the outbreeding species full-sib family. The new
  method is described in a paper that was accepted for
  publication:

  Van Ooijen, J.W. (2011). Multipoint maximum likelihood
    mapping in a full-sib family of an outbreeding species.
    Genetics Research, accepted June 2011.


=== 7 February 2011 ===
Maintenance release of JoinMap 4
  (Build: 7feb11.4feb11)

= The Colorize function to show graphical genotypes now
  takes the linkage phases into account for DH and HAP
  population types. For instance, genotype a of a marker
  with phase {1} is shown in the same color as genotype b
  of a marker with phase {0}.

= A function was added to work on the Similarity of Loci
  tabsheet: Population menu > Exclude Similar Loci.
  It works like the Exclude Identicals function, but instead
  of using a similarity value of 1.0 this function prompts
  for a similarity value to use. If two loci have a
  similarity above the given value, the second locus will be
  excluded on the Loci tabsheet, unless the first locus is
  already excluded (to prevent excluding locus C if locus B
  is similar to locus A, and locus C to B but not to A).
  This function allows spatial sampling of the loci.

= The grouping process was given a somewhat higher speed.


=== 6 October 2010 ===
Maintenance release of JoinMap 4
  (Build: 6oct10.9feb10)

= In recent maintenance releases JoinMap was set to use
  Windows Desktop Themes. Several users experienced runtime
  errors due to this. The use of themes by JoinMap is
  stopped.

= Clicking on the 'no data' header of an empty Data tabsheet
  resulted in an 'OLE error' message. This is repaired.


=== 20 April 2010 ===
Maintenance release of JoinMap 4
  (Build: 20apr10.9feb10)

= When creating maternal and paternal population nodes of a
  CP type dataset node, now loci with a <hkxhk> segregation
  type are also exported, unless the classification type is
  (hh,k-) or (h-,kk). The genotypes hk, h- and k- are all
  exported as unknowns --; genotypes hh and kk are exported
  as ll and lm, respectively, for the first (=maternal)
  parent, and as nn and np, respectively, for the second
  (=paternal) parent.


=== 19 Februay 2010 ===
Maintenance release of JoinMap 4
  (Build: 19feb10.9feb10)

= Creating a population node of a CP type dataset node
  resulted in an error. A similar bug resulted with the
  exporting as loc-file from Data tabsheets in minor
  errors in the loc-file. The bugs were repaired.


=== 16 Februay 2010 ===
Maintenance release of JoinMap 4
  (Build: 16feb10.9feb10)

= To make working with large marker datasets of a population
  a bit faster, new options are introduced:
  -A checkbox option on the tool bar controls whether or not
  the various Data tabsheets are loaded; it can also be set
  in the Options menu.
  -Large datasets create huge tables of pairwise linkages
  and if they are not going to be inspected things are
  faster if the tables are left out altogether. Therefore,
  in the Group tabsheet of the calculation options two new
  checkboxes control whether or not weak and strong linkages
  tables are created when the linkages are calculated.

= The Colorize function to show graphical genotypes now
  takes the linkage phases into account (if available) for
  all segregation types except <hkxhk>. For instance,
  genotype lm of a marker with phase {1-} is shown in the
  same color as genotype ll of a marker with phase {0-}. The
  default colors are modified for a better correspondence
  between the segregation types.

= An option is added that controls whether the current
  selection or the entire tabsheet contents must be printed,
  copied, or exported; it is a check box on the tool bar and
  is also available in the Options menu.

= The Highlight Errors function now also allows
  classification types (a,h) and (h,b) for population types
  BCpxFy. And when the y-generation is zero (i.e. it is a
  normal BC1), only genotypes a and h (BCAxFy), or h and b
  (BCBxFy) are allowed.

= With an added option in the Help menu you can now check
  via the internet whether a newer release is available.
  If your internet connection requires the use of a proxy,
  you can supply the proxy name and port in the environment
  options.

= Several internal actions that may take a while now change
  the cursor temporarily into the hourglass cursor.

= Map-files or pwd-files in which the comma is used as
  decimal separator (instead of the point) will be loaded
  correctly.

= Maps with multiple linkage groups are now inverted
  group by group with the Invert Map function of the
  Map menu.

= The time stamp now also shows the seconds.


=== 11 August 2008 ===
Maintenance release of JoinMap 4
  (Build: 11aug08.7apr08)

= In the ML mapping algorithm the fixed order was not always
  maintained; this is corrected.

= The tabsheet with the Locus Means of the Genotype
  Probabilities is sorted on the map position of the loci.
  This will result in a proper chart when plotted against
  the map position.

= The tabsheet with the Individual Means of the Genotype
  Probabilities is given in the original order of the
  individuals.


=== 23 July 2008 ===
Maintenance release of JoinMap 4
  (Build: 23jul08.7apr08)

= If the grouping cannot be calculated for a population
  type CP, better information will now be shown.

= The situation with three (or more) loci at the same map
  position could lead to a floating point error in the ML
  map calculations. This is corrected.

= The cooling control parameter of the ML Mapping algorithm
  had a lower limit of 0.001 which is now reduced to
  0.00001; the upper limit is now set to 1.0.

= The tabsheet with the Locus Means of the Genotype
  Probabilities now also shows the map position of the loci.

= When no project is open, pressing the OK button on the
  Environment and the Calculation Options dialogs will save
  the options as default options that will apply to all
  future projects (similar to the 'Save as default' button).

= The About box was renewed.


=== 8 April 2008 ===
Maintenance release of JoinMap 4
  (Build: 8apr08.7apr08)

= For a BCpxFy the genotype probabilities given the map
  given two heterozygous or dominant flanking markers were
  not completely right. This is corrected.

= The map chart options dialog can be opened when no map
  chart is visible; changing the options will have the same
  effect as 'Save as Default Map Chart Options'. Any future
  map chart will be drawn according to these options.

= Also, when no map chart is visible the 'Reset to Preset
  Map Chart Options' can be activated, which will affect
  all future map charts.

= The loading of MAPMAKER raw data is slightly improved.

= Various minor (internal) improvements were made.


=== 4 May 2007 ===
Maintenance release of JoinMap 4
  (Build: 4may07.4oct06)

Changes:
= JoinMap 4 was enabled to run under Windows Vista.
  For installation of the user license under Windows Vista,
  please see the 'Installation ReadMe' file on the CDROM or
  in the program directory after running the program
  installation 'setup.exe'
  (typically: 'C:\Program Files\JoinMap4').


=== 18 April 2007 ===
Maintenance release of JoinMap 4
  (Build: 18apr07.4oct06)

Changes:
= When exporting the Data tabsheet of a Map node of a CP
  type population as a loc-file, the map position of
  markers was given at the wrong place in the file.
  This is corrected.

= The exporting of a Dataset tabsheet of a Dataset node as
  a loc-file did not function properly. This is corrected.


=== 5 March 2007 ===
Maintenance release of JoinMap 4
  (Build: 5mar07.4oct06)

Changes:
= When calculating the linkages for groups of population
  type CP, it is possible that the linkage phases cannot
  be determined and thus also no recombination frequencies
  can be calculated. In such instances the program could
  generate an unclear runtime error message: 'unknown error
  in sclastype()'.
  This problem is corrected and the information given in
  the 'Info on Tabsheet Contents' has become more complete
  about the linkage phases determination status.


=== 4 October 2006 ===
Maintenance release of JoinMap 4
  (Build: 2oct06.4oct06)

Changes:
= For extremely large values of the chisquare distribution
  the P-value in the Grouping tabsheet could not be
  calculated and resulted in the freezing of the program.
  The P-value is calculated irrespective of the Grouping
  parameter chosen.

  A new algorithm to calculate the P-value is now used.

= For very large linkage groups the computations of the
  linkages may appear to take extremely long. Actually,
  it is not the computations that take a long time but
  the loading of the resulting data into the Linkages
  tabsheets. For such large linkage groups there may
  be very, very many pairs to display on the Weak and
  Strong linkages tabsheets, depending on the chosen
  corresponding thresholds.

  To allow for more precision here, the recombination
  frequency thresholds on the Group tabsheet of the
  Calculation Options now have up to four decimals.

  Unfortunately the loading of the data into the
  tabsheets cannot be shown on the progress bar, but the
  progress of the program is now shown with some simple
  comments on the status bar:
    'loading table "Weak Linkages"'
    'loading table "Strong Linkages"'
    'loading table "Suspect Linkages"'
  together with the numbers of rows that must be loaded,
  allowing the user to see and estimate the progress.
  These comments are usually only visible with very large
  groups.


=== 25 July 2006 ===
Final edition of JoinMap 4
  (Build: 25jul06.16jun06)