normMCFS - Scale maps using Median/Mean Contact Frequency¶
This method can be used to normalize contact map with expected values. These expected values could be either Median or Average contact values for particular distance between two locations/coordinates. At first, Median/Average distance contact frequency for each distance is calculated. Subsequently, the observed contact frequency is either divided (‘o/e’) or subtracted (‘o-e’) by median/average contact frequency obtained for distance between the two locations.
usage: gcMapExplorer normMCFS [-h] [-i input.gcmap] [-fi gcmap] [-o output.gcmap] [-fo gcmap] [-s median] [-vmax VMAX] [-vmin VMIN] [-st o/e] [-ptnd 99] [-tdo 0.8] [-cmeth lzf] [-wd /home/rajendra/deskForWork/scratch]
-h, --help show this help message and exit -i input.gcmap, --input input.gcmap Input ccmap or gcmap file. -fi gcmap, --format-input gcmap Input format: 'ccmap' or 'gcmap'. -o output.gcmap, --output output.gcmap Output ccmap or gcmap file. When input file is ccmap, output file can be gcmap. However, when a input file is gcmap, output file will be only in gcmap. -fo gcmap, --format-output gcmap Input format: 'ccmap' or 'gcmap'. When input file is ccmap, output file can be gcmap. However, when a input file is gcmap, output file will be only in gcmap. -s median, --stats median Statistics to be considered for scaling. It may be either “mean” or “median”. By default, it is “median”. -vmax VMAX, --maximum-value VMAX Minimum threshold value for normalization. If contact frequency is less than or equal to this threshold value, this value is discarded during normalization. -vmin VMIN, --minimum-value VMIN Maximum threshold value for normalization. If contact frequency is greater than or equal to this threshold value, this value is discarded during normalization. -st o/e, --stype o/e Type of scaling. It may be either 'o/e' or 'o-e'. In case of 'o/e', Observed/Expected will be calculated while (Observed - Expected) will be calculated for 'o-e'. -ptnd 99, --percentile-threshold-no-data 99 It can be used to filter the map, where rows/columns with largest numbers of missing data can be discarded. Its value should be between 1 and 100. This options discard the rows and columns which are above this percentile. For example: if this value is 99, those rows or columns will be discarded which contains larger than number of zeros (missing data) at 99 percentile. To calculate percentile, all blank rows are removed, then in all rows, number of zeros are counted. Afterwards, number of zeros at input percentile is obtained. In next step, if a row contain number of zeros larger than this percentile value, the whole row and column is assigned to have missing data. This percentile indicates highest numbers of zeros (missing data) in given rows/columns. -tdo 0.8, --threshold-data-occupancy 0.8 It can be used to filter the map, where rows/columns with largest numbers of missing data can be discarded.This ratio is: (number of bins with data) / (total number of bins in the given row/column) For example: if -tdo = 0.8, then all rows containing more than 20% of missing data will be discarded. -cmeth lzf, --compression-method lzf Data compression method for output gcmap file. -wd /home/rajendra/deskForWork/scratch, --work-dir /home/rajendra/deskForWork/scratch Directory where temporary files will be stored.