Skip to content

Commit 5a56a84

Browse files
committed
more formal text
1 parent 56e9631 commit 5a56a84

File tree

1 file changed

+4
-5
lines changed

1 file changed

+4
-5
lines changed

docs/source/user_guide/map_alignment.rst

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,9 @@ Map Alignment
22
===============
33

44
The pyOpenMS map alignment algorithms transform different maps (:term:`peak maps`, :term:`feature maps`) to a common retention time axis.
5-
This is useful, since chromatographic columns are usually less stable, i.e. the RT of identical compounds will vary when repeating the
6-
experiment or running another sample.
7-
We want to correct for this, usually by finding common landmarks across runs and adjusting the RT of all features to minimize the distance
8-
of landmarks across feature maps.
5+
Because chromatographic columns are less stable, retention times of identical compounds can vary across runs.
6+
To correct for RT drift, map alignment attempts to find common landmarks across runs and adjusts the RT of all features to minimize the distance
7+
of landmarks across feature maps (runs).
98

109

1110
.. image:: img/map_alignment_illustration.png
@@ -276,6 +275,6 @@ We can also inspect the underlying transformation and the landmarks it is based
276275
# Example usage:
277276
plot_transformed_rt_with_trafo(feature_maps, trafos)
278277
279-
While we do not know the underlying features using just this information, we can see that features in corresponding maps are now nicely aligned horizontally (the new RT). Also, it seems a linear model nicely fits all the data points in each feature map. Using a more flexible model like LOWESS will likely result in a worse alignment (try and see for yourself).
278+
While we do not know the underlying features using just this information, we can see that features in corresponding maps are now nicely aligned horizontally (the new RT). Also, it seems a linear model nicely fits all the data points in each feature map. More flexible models (e.g., LOWESS) may overfit and degrade performance—feel; free to experiment.
280279

281280
.. image:: img/map_alignment_trafos.png

0 commit comments

Comments
 (0)