pyHRM


NamepyHRM JSON
Version 0.1.8 PyPI version JSON
download
home_page
SummaryA library for processing DNA Melting signal with feature extraction and thresholding.
upload_time2023-04-23 14:33:21
maintainer['RajagopalS rajag2001416@gmail.com', 'Vignesh_R mail2vikivignesh06@gmail.com', 'SenthilKumarN senthilkumarnallendran@gmail.com']
docs_urlNone
authorRajagopalS
requires_python
licenseMIT
keywords hrm melt pcr
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![y](https://user-images.githubusercontent.com/80576855/233824868-99358619-cc04-415c-9f55-94d105fa8d3d.png)
<div align="center">
    <br>
        <a href="" width="250px" height="250px" alt="Software_E-logo"></a>
      <br>
    <h1>PyHRM</h1>
    <h2><b>A library for processing DNA Melting signal with feature extraction and thresholding.</b></h2>
        <h4>
        <a href="#system-requirements">Requirements</a>
        •
        <a href="#getting-started">Getting Started</a>
        •
        <a href="#features">Features</a>
        •
        <a href="#demo">Demo</a>
    </h4>
    <h3>
        <a href="#meet-the-team">
            <img src="https://img.shields.io/badge/maintainers-The Team-cyan" alt="Maintainers">
        </a>
        <a href="https://github.com/FEUSION/Extractor/releases/latest/tags/v0.0.1">
            <img src="https://img.shields.io/badge/launched-April%202023-teal" alt="Release">
        </a>
        <a href="https://github.com/FEUSION/Extractor/releases/latest">
        <img src="https://img.shields.io/github/release/MLRS-dev/Extractor?color=brightgreen&label=version" alt="Version">
        </a>
        <a href="https://www.microsoft.com/en-in/software-download/">
        <img src="https://img.shields.io/badge/platform-Windows-blue" alt="Operating system">
      </a>
      <a href="https://github.com/FEUSION/Extractor/commits/main">
      <img src="https://img.shields.io/github/last-commit/FEUSION/Extractor?color=blueviolet&label=updated">
      </a>
    </h3>
</div>

# PyHRM
[PyHRM]([https://github.com/FEUSION/Extractor](https://feusion.github.io/PyHRM/)) is a python based library for processing High Resolution Melting (HRM) data, especially, DNA melting signals to extact features like 'Melting Temperatures', 'Take-off and Touch-down points of melting signal (Temperature at which peak start rising and temperature at which peak falls down)','Peak prominences',and 'Area Under the curve'. Additionally, the library offers interactive visualization for DNA melting singal and vision based filtering, to eliminate noisy signals from the data and provides only genuine peaks with all the above mentioned features.


## Installing with PIP

```
python -m pip install PyHRM
```
or
```
pip3 install PyHRM
```

## Classifiers


<table>
  <tr>
    <td nowrap><strong>Development Status</strong></td><td href = "https://pypi.org/search/?c=Development+Status+%3A%3A+5+-+Production%2FStable"><i >5 - Production/Stable </i></td>
  </tr>
  <tr>
    <td nowrap><strong>Intened Audience</strong></td><td><i>Education</i></td>
  </tr>
  <tr>
    <td nowrap><strong>License</strong></td><td><i>OSI Approved :: MIT License </i></td>
  </tr>
  <tr>
    <td nowrap><strong>Operating System</strong></td><td><i>Microsoft :: Windows :: Windows 10 </i></td>
  </tr>
  <tr>
    <td nowrap><strong>Programming Language</strong></td><td><i>Python 3</i></td>
  </tr>
</table>

## Features
- Rapid preprocessing.
- Feature Extraction
    - Tm (Melting Temperature (Max 2))
    - Tstart (Starting temperature point)
    - Tend (Ending Temperature)
    - Prominence
    - Area Under the curve
- Interactive Visulization.
- Computer Vision based thresholding for eliminating noisy signals.
- Report Generation.

## Input Data format

<p align="center">
<b>Format</b><br />
    The input format should be as followed below. 'Text','X','Y'.... 
</p>


![dataformat](https://user-images.githubusercontent.com/80576855/233830128-279608f2-42f4-4bca-84b1-1063922956db.png)

The current release only support .xls and .xlsx formats. Further updates on multiple file supports will be released in the upcoming versions.

# Documentation

## Import
```
from PyHRM import melt
```
## Creating the class Instance
```
obj = melt.MeltcurveInterpreter()
```
## PyHRM.melt.MeltcurveInterpreter.data_read

<b>PyHRM.melt.MeltcurveInterpreter.data_read(<i>data = None, path = None, labels =False, index = False, figure = False</i>)</b>

The function takes either a pandas dataframe or the path of the file (.xls, .xlsx). The method could read CT, MELT and raw fluorescence data as well.

<b>Parameters:</b>&emsp;<b>data : </b><i><b>pandas dataframe object</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A pandas dataframe with the specified input format of HRM data extracted from machines.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>path : </b></b><i><b>path of the file (.xls or .xlsx)</b></i><br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A path of the HRM data file extracted from machines.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>labels : </b></b><i><b>bool : default False</b></i><br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns a list containing dataframe and label of the samples given in the 'Text' attribute based on a boolean value.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>index : </b></b><i><b>bool : default False</b></i><br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to remove the index (if the HRM data has.)
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>figure : </b></b><i><b>bool : default False</b></i><br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to render a interactive plot in the browser.
<br>
<br>
<b>Returns: &emsp;&nbsp;</b>&emsp;<b>x, y cordinates : </b><i><b>pandas.core.frame.DataFrame</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A pandas dataframe with the temperature co-ordinates as 'X' and the signal co-ordinates as 'Y','Y.1'..'Y.n'
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>x,y cordinates and labels : </b></b><i><b>list</b></i><br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;If <i>lables</i> is True, returns a list containing a dataframe and lables
<br>
<br>
<b>Warns: &emsp;&nbsp;</b>&emsp;<b>ValueError</b>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Raised when unsupported data format passed.

<br>

### Example
```
from PyHRM import melt
obj = melt.MeltcurveInterpreter()

#reading the HRM data
hrmdata = obj.data_read(path = './path/file.xls', figure = True)
```
Alternatively,
```
import pandas as pd
import openpyxl
from PyHRM import melt
obj = melt.MeltcurveInterpreter()

#reading data with pandas
data = pd.read_excel('./path/file.xls', engine = 'xlrd')

#passing the dataframe to the function
hrmdata = obj.data_read(data = data, figure = True)
```
## PyHRM.melt.MeltcurveInterpreter.plot
<b>PyHRM.melt.MeltcurveInterpreter.plot(<i>data,save = False</i>)</b>

The function takes a pandas dataframe contains signal values and render back the respective figure. The plot function takes any data like CT, MELT and as well as raw fluorescence, and gives back the corresponding visulazation.

<b>Parameters:</b>&emsp;<b>data : </b><i><b>pandas dataframe object</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A pandas dataframe contains signal values.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>save : </b></b><i><b>bool : default False</b></i><br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to save the plot in a figure object.
<br>
<br>
<b>Returns: &emsp;&nbsp;</b>&emsp;<b>figure: </b><i><b>plotly.graph_objs._figure.Figure</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns an interactive plotly figure object.

<br>

### Example
```
from PyHRM import melt
obj = melt.MeltcurveInterpreter()

#reading the HRM data
hrmdata = obj.data_read(path = './path/file.xls')

#visualizing the data
fig = obj.plot(data = hrmdata, save = True)
fig.show()
```
## PyHRM.melt.MeltcurveInterpreter.melt_conversion
<b>PyHRM.melt.MeltcurveInterpreter.plot(<i>figure = False, return_value =False, download = False</i>)</b>

This methods only works for raw fluorescence data, and the input of this method is the class member itself. It converts the raw fluorescence signals into melting signals with signal smoothening. 
<br>
<b>NOTE : This method is the beta version of the library, the results may not be acuratae or appropriate and this is still in development</b>

<b>Parameters:</b>&emsp;<b>figure : </b><i><b>bool : default False</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp; Required a boolean value to render the resultant values as a plot.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>return_value : </b></b><i><b>bool : default False</b></i><br>   
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to return the result as dataframe.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>download : </b></b><i><b>bool : default False</b></i><br> 
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to save the resultant values as comma separated values.
<br>
<br>
<b>Returns: &emsp;&nbsp;</b>&emsp;<b>melt signal co-ordinates: </b><i><b>pandas.core.frame.DataFrame</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns a dataframe, contains melting signal co-ordinates.

<br>

### Example
```
from PyHRM import melt
obj = melt.MeltcurveInterpreter()

#reading the raw fluorescence data
rfdata = obj.data_read(path = './path/file.xls')

meltdata = obj.melt_conversion(return_value = True, figure = True, download = True)
```
## PyHRM.melt.MeltcurveInterpreter.feature_detection
<b>PyHRM.melt.MeltcurveInterpreter.plot(<i>return_values =False, download = False</i>)</b>

This methods performs feature extraction process on melting signal data, that extracts features like <i>'Tm','Tstart','Tend','Prominence','Area under the curve'</i>. This also performs noise elimination using a trained CNN model embedded in the package. The input of the method is the class member itself.
<br>

<b>Parameters:</b>&emsp;<b>return_values : </b><i><b>bool : default False</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to return the result as dataframe.
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>download : </b></b><i><b>bool : default False</b></i><br> 
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to save the resultant values as comma separated values.
<br>
<br>
<b>Returns: &emsp;&nbsp;</b>&emsp;<b>Features of the signal: </b><i><b>pandas.core.frame.DataFrame</b></i>
<br>
<br>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns a dataframe, contains features of melting signals
<br>

### Example
```
from PyHRM import melt
obj = melt.MeltcurveInterpreter()

#reading the HRM data
hrmdata = obj.data_read(path = './path/file.xls')

#Extracting features of the melt signals
features = obj.feature_detection(return_values = True)
```
<br>

## PyHRM.melt.MeltcurveInterpreter.report
<b>PyHRM.melt.MeltcurveInterpreter.plot()</b>

The method generates a report with the feature extracting data and it's corresponding melting signal figures.

<b>Parameters:</b>&emsp;<b>None</b>
<br>
### Example
```
from PyHRM import melt
obj = melt.MeltcurveInterpreter()

#reading the HRM data
hrmdata = obj.data_read(path = './path/file.xls')

#Extracting features of the melt signals
features = obj.feature_detection(return_values = True)

#Generating the report
obj.report()
```

# Getting Help

If you need to get in touch with the team, please contact through email address: [feusion.ai@gmail.com](mailto:feusion.ai@gmail.com?subject=Extractor%20Application)

# Meet the Team

   The developers in this project are post graduate students in the [Department of Computer Applications](https://b-u.ac.in/23/department-computer-applications) @ [Bharathiar University](https://b-u.ac.in/)
<table style="width:25%">
  <tbody>
    <tr>
      <td align="center" valign="top"><a href="https://github.com/rajag0pal"><img src="https://avatars.githubusercontent.com/u/80576855?v=4" width="50px;" alt="Rajagopal S"/><br /><sub><b><a href="https://www.linkedin.com/in/rajagopal-s/">Rajagopal S</a></b></sub></a><br /></td>
      <td align="center" valign="top"><a href="https://github.com/VIGNESH-R-06"><img src="https://avatars.githubusercontent.com/u/94525493?v=4" width="50px;" alt="Vignesh R"/><br /><sub><b><a href="https://www.linkedin.com/in/vignesh-r-31b5601b8/">Vignesh R</a></b></sub></a><br /></td>
      <td align="center" valign="top"><a href="https://github.com/IamSenthilKumar"><img src="https://avatars.githubusercontent.com/u/89689985?v=4" width="50px;" alt="Senthil Kumar N"/><br /><sub><b><a href="https://www.linkedin.com/in/senthilkumar-n/">N.S.K</a></b></sub></a><br /></td>
    </tr>
  </tbody>
</table>

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "pyHRM",
    "maintainer": "['RajagopalS rajag2001416@gmail.com', 'Vignesh_R mail2vikivignesh06@gmail.com', 'SenthilKumarN senthilkumarnallendran@gmail.com']",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "HRM,Melt,PCR",
    "author": "RajagopalS",
    "author_email": "rajag2001416@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/34/c6/bab7720bde32cb53f82aa7516f74fa76ae4b59c4e6124f7732d26356cc51/pyHRM-0.1.8.tar.gz",
    "platform": null,
    "description": "![y](https://user-images.githubusercontent.com/80576855/233824868-99358619-cc04-415c-9f55-94d105fa8d3d.png)\r\n<div align=\"center\">\r\n    <br>\r\n        <a href=\"\" width=\"250px\" height=\"250px\" alt=\"Software_E-logo\"></a>\r\n      <br>\r\n    <h1>PyHRM</h1>\r\n    <h2><b>A library for processing DNA Melting signal with feature extraction and thresholding.</b></h2>\r\n        <h4>\r\n        <a href=\"#system-requirements\">Requirements</a>\r\n        \u2022\r\n        <a href=\"#getting-started\">Getting Started</a>\r\n        \u2022\r\n        <a href=\"#features\">Features</a>\r\n        \u2022\r\n        <a href=\"#demo\">Demo</a>\r\n    </h4>\r\n    <h3>\r\n        <a href=\"#meet-the-team\">\r\n            <img src=\"https://img.shields.io/badge/maintainers-The Team-cyan\" alt=\"Maintainers\">\r\n        </a>\r\n        <a href=\"https://github.com/FEUSION/Extractor/releases/latest/tags/v0.0.1\">\r\n            <img src=\"https://img.shields.io/badge/launched-April%202023-teal\" alt=\"Release\">\r\n        </a>\r\n        <a href=\"https://github.com/FEUSION/Extractor/releases/latest\">\r\n        <img src=\"https://img.shields.io/github/release/MLRS-dev/Extractor?color=brightgreen&label=version\" alt=\"Version\">\r\n        </a>\r\n        <a href=\"https://www.microsoft.com/en-in/software-download/\">\r\n        <img src=\"https://img.shields.io/badge/platform-Windows-blue\" alt=\"Operating system\">\r\n      </a>\r\n      <a href=\"https://github.com/FEUSION/Extractor/commits/main\">\r\n      <img src=\"https://img.shields.io/github/last-commit/FEUSION/Extractor?color=blueviolet&label=updated\">\r\n      </a>\r\n    </h3>\r\n</div>\r\n\r\n# PyHRM\r\n[PyHRM]([https://github.com/FEUSION/Extractor](https://feusion.github.io/PyHRM/)) is a python based library for processing High Resolution Melting (HRM) data, especially, DNA melting signals to extact features like 'Melting Temperatures', 'Take-off and Touch-down points of melting signal (Temperature at which peak start rising and temperature at which peak falls down)','Peak prominences',and 'Area Under the curve'. Additionally, the library offers interactive visualization for DNA melting singal and vision based filtering, to eliminate noisy signals from the data and provides only genuine peaks with all the above mentioned features.\r\n\r\n\r\n## Installing with PIP\r\n\r\n```\r\npython -m pip install PyHRM\r\n```\r\nor\r\n```\r\npip3 install PyHRM\r\n```\r\n\r\n## Classifiers\r\n\r\n\r\n<table>\r\n  <tr>\r\n    <td nowrap><strong>Development Status</strong></td><td href = \"https://pypi.org/search/?c=Development+Status+%3A%3A+5+-+Production%2FStable\"><i >5 - Production/Stable </i></td>\r\n  </tr>\r\n  <tr>\r\n    <td nowrap><strong>Intened Audience</strong></td><td><i>Education</i></td>\r\n  </tr>\r\n  <tr>\r\n    <td nowrap><strong>License</strong></td><td><i>OSI Approved :: MIT License </i></td>\r\n  </tr>\r\n  <tr>\r\n    <td nowrap><strong>Operating System</strong></td><td><i>Microsoft :: Windows :: Windows 10 </i></td>\r\n  </tr>\r\n  <tr>\r\n    <td nowrap><strong>Programming Language</strong></td><td><i>Python 3</i></td>\r\n  </tr>\r\n</table>\r\n\r\n## Features\r\n- Rapid preprocessing.\r\n- Feature Extraction\r\n    - Tm (Melting Temperature (Max 2))\r\n    - Tstart (Starting temperature point)\r\n    - Tend (Ending Temperature)\r\n    - Prominence\r\n    - Area Under the curve\r\n- Interactive Visulization.\r\n- Computer Vision based thresholding for eliminating noisy signals.\r\n- Report Generation.\r\n\r\n## Input Data format\r\n\r\n<p align=\"center\">\r\n<b>Format</b><br />\r\n    The input format should be as followed below. 'Text','X','Y'.... \r\n</p>\r\n\r\n\r\n![dataformat](https://user-images.githubusercontent.com/80576855/233830128-279608f2-42f4-4bca-84b1-1063922956db.png)\r\n\r\nThe current release only support .xls and .xlsx formats. Further updates on multiple file supports will be released in the upcoming versions.\r\n\r\n# Documentation\r\n\r\n## Import\r\n```\r\nfrom PyHRM import melt\r\n```\r\n## Creating the class Instance\r\n```\r\nobj = melt.MeltcurveInterpreter()\r\n```\r\n## PyHRM.melt.MeltcurveInterpreter.data_read\r\n\r\n<b>PyHRM.melt.MeltcurveInterpreter.data_read(<i>data = None, path = None, labels =False, index = False, figure = False</i>)</b>\r\n\r\nThe function takes either a pandas dataframe or the path of the file (.xls, .xlsx). The method could read CT, MELT and raw fluorescence data as well.\r\n\r\n<b>Parameters:</b>&emsp;<b>data : </b><i><b>pandas dataframe object</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A pandas dataframe with the specified input format of HRM data extracted from machines.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>path : </b></b><i><b>path of the file (.xls or .xlsx)</b></i><br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A path of the HRM data file extracted from machines.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>labels : </b></b><i><b>bool : default False</b></i><br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns a list containing dataframe and label of the samples given in the 'Text' attribute based on a boolean value.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>index : </b></b><i><b>bool : default False</b></i><br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to remove the index (if the HRM data has.)\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>figure : </b></b><i><b>bool : default False</b></i><br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to render a interactive plot in the browser.\r\n<br>\r\n<br>\r\n<b>Returns: &emsp;&nbsp;</b>&emsp;<b>x, y cordinates : </b><i><b>pandas.core.frame.DataFrame</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A pandas dataframe with the temperature co-ordinates as 'X' and the signal co-ordinates as 'Y','Y.1'..'Y.n'\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>x,y cordinates and labels : </b></b><i><b>list</b></i><br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;If <i>lables</i> is True, returns a list containing a dataframe and lables\r\n<br>\r\n<br>\r\n<b>Warns: &emsp;&nbsp;</b>&emsp;<b>ValueError</b>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Raised when unsupported data format passed.\r\n\r\n<br>\r\n\r\n### Example\r\n```\r\nfrom PyHRM import melt\r\nobj = melt.MeltcurveInterpreter()\r\n\r\n#reading the HRM data\r\nhrmdata = obj.data_read(path = './path/file.xls', figure = True)\r\n```\r\nAlternatively,\r\n```\r\nimport pandas as pd\r\nimport openpyxl\r\nfrom PyHRM import melt\r\nobj = melt.MeltcurveInterpreter()\r\n\r\n#reading data with pandas\r\ndata = pd.read_excel('./path/file.xls', engine = 'xlrd')\r\n\r\n#passing the dataframe to the function\r\nhrmdata = obj.data_read(data = data, figure = True)\r\n```\r\n## PyHRM.melt.MeltcurveInterpreter.plot\r\n<b>PyHRM.melt.MeltcurveInterpreter.plot(<i>data,save = False</i>)</b>\r\n\r\nThe function takes a pandas dataframe contains signal values and render back the respective figure. The plot function takes any data like CT, MELT and as well as raw fluorescence, and gives back the corresponding visulazation.\r\n\r\n<b>Parameters:</b>&emsp;<b>data : </b><i><b>pandas dataframe object</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;A pandas dataframe contains signal values.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>save : </b></b><i><b>bool : default False</b></i><br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to save the plot in a figure object.\r\n<br>\r\n<br>\r\n<b>Returns: &emsp;&nbsp;</b>&emsp;<b>figure: </b><i><b>plotly.graph_objs._figure.Figure</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns an interactive plotly figure object.\r\n\r\n<br>\r\n\r\n### Example\r\n```\r\nfrom PyHRM import melt\r\nobj = melt.MeltcurveInterpreter()\r\n\r\n#reading the HRM data\r\nhrmdata = obj.data_read(path = './path/file.xls')\r\n\r\n#visualizing the data\r\nfig = obj.plot(data = hrmdata, save = True)\r\nfig.show()\r\n```\r\n## PyHRM.melt.MeltcurveInterpreter.melt_conversion\r\n<b>PyHRM.melt.MeltcurveInterpreter.plot(<i>figure = False, return_value =False, download = False</i>)</b>\r\n\r\nThis methods only works for raw fluorescence data, and the input of this method is the class member itself. It converts the raw fluorescence signals into melting signals with signal smoothening. \r\n<br>\r\n<b>NOTE : This method is the beta version of the library, the results may not be acuratae or appropriate and this is still in development</b>\r\n\r\n<b>Parameters:</b>&emsp;<b>figure : </b><i><b>bool : default False</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp; Required a boolean value to render the resultant values as a plot.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>return_value : </b></b><i><b>bool : default False</b></i><br>   \r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to return the result as dataframe.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>download : </b></b><i><b>bool : default False</b></i><br> \r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to save the resultant values as comma separated values.\r\n<br>\r\n<br>\r\n<b>Returns: &emsp;&nbsp;</b>&emsp;<b>melt signal co-ordinates: </b><i><b>pandas.core.frame.DataFrame</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns a dataframe, contains melting signal co-ordinates.\r\n\r\n<br>\r\n\r\n### Example\r\n```\r\nfrom PyHRM import melt\r\nobj = melt.MeltcurveInterpreter()\r\n\r\n#reading the raw fluorescence data\r\nrfdata = obj.data_read(path = './path/file.xls')\r\n\r\nmeltdata = obj.melt_conversion(return_value = True, figure = True, download = True)\r\n```\r\n## PyHRM.melt.MeltcurveInterpreter.feature_detection\r\n<b>PyHRM.melt.MeltcurveInterpreter.plot(<i>return_values =False, download = False</i>)</b>\r\n\r\nThis methods performs feature extraction process on melting signal data, that extracts features like <i>'Tm','Tstart','Tend','Prominence','Area under the curve'</i>. This also performs noise elimination using a trained CNN model embedded in the package. The input of the method is the class member itself.\r\n<br>\r\n\r\n<b>Parameters:</b>&emsp;<b>return_values : </b><i><b>bool : default False</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to return the result as dataframe.\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&nbsp;<b>download : </b></b><i><b>bool : default False</b></i><br> \r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Required a boolean value to save the resultant values as comma separated values.\r\n<br>\r\n<br>\r\n<b>Returns: &emsp;&nbsp;</b>&emsp;<b>Features of the signal: </b><i><b>pandas.core.frame.DataFrame</b></i>\r\n<br>\r\n<br>\r\n&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Returns a dataframe, contains features of melting signals\r\n<br>\r\n\r\n### Example\r\n```\r\nfrom PyHRM import melt\r\nobj = melt.MeltcurveInterpreter()\r\n\r\n#reading the HRM data\r\nhrmdata = obj.data_read(path = './path/file.xls')\r\n\r\n#Extracting features of the melt signals\r\nfeatures = obj.feature_detection(return_values = True)\r\n```\r\n<br>\r\n\r\n## PyHRM.melt.MeltcurveInterpreter.report\r\n<b>PyHRM.melt.MeltcurveInterpreter.plot()</b>\r\n\r\nThe method generates a report with the feature extracting data and it's corresponding melting signal figures.\r\n\r\n<b>Parameters:</b>&emsp;<b>None</b>\r\n<br>\r\n### Example\r\n```\r\nfrom PyHRM import melt\r\nobj = melt.MeltcurveInterpreter()\r\n\r\n#reading the HRM data\r\nhrmdata = obj.data_read(path = './path/file.xls')\r\n\r\n#Extracting features of the melt signals\r\nfeatures = obj.feature_detection(return_values = True)\r\n\r\n#Generating the report\r\nobj.report()\r\n```\r\n\r\n# Getting Help\r\n\r\nIf you need to get in touch with the team, please contact through email address: [feusion.ai@gmail.com](mailto:feusion.ai@gmail.com?subject=Extractor%20Application)\r\n\r\n# Meet the Team\r\n\r\n   The developers in this project are post graduate students in the [Department of Computer Applications](https://b-u.ac.in/23/department-computer-applications) @ [Bharathiar University](https://b-u.ac.in/)\r\n<table style=\"width:25%\">\r\n  <tbody>\r\n    <tr>\r\n      <td align=\"center\" valign=\"top\"><a href=\"https://github.com/rajag0pal\"><img src=\"https://avatars.githubusercontent.com/u/80576855?v=4\" width=\"50px;\" alt=\"Rajagopal S\"/><br /><sub><b><a href=\"https://www.linkedin.com/in/rajagopal-s/\">Rajagopal S</a></b></sub></a><br /></td>\r\n      <td align=\"center\" valign=\"top\"><a href=\"https://github.com/VIGNESH-R-06\"><img src=\"https://avatars.githubusercontent.com/u/94525493?v=4\" width=\"50px;\" alt=\"Vignesh R\"/><br /><sub><b><a href=\"https://www.linkedin.com/in/vignesh-r-31b5601b8/\">Vignesh R</a></b></sub></a><br /></td>\r\n      <td align=\"center\" valign=\"top\"><a href=\"https://github.com/IamSenthilKumar\"><img src=\"https://avatars.githubusercontent.com/u/89689985?v=4\" width=\"50px;\" alt=\"Senthil Kumar N\"/><br /><sub><b><a href=\"https://www.linkedin.com/in/senthilkumar-n/\">N.S.K</a></b></sub></a><br /></td>\r\n    </tr>\r\n  </tbody>\r\n</table>\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A library for processing DNA Melting signal with feature extraction and thresholding.",
    "version": "0.1.8",
    "split_keywords": [
        "hrm",
        "melt",
        "pcr"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "34c6bab7720bde32cb53f82aa7516f74fa76ae4b59c4e6124f7732d26356cc51",
                "md5": "1273b2023020373e95c7a12853a8c3a7",
                "sha256": "99b4aee8479617a2adf9a2a248210d26f1bdb04c9e69e4e8d4201e112021de48"
            },
            "downloads": -1,
            "filename": "pyHRM-0.1.8.tar.gz",
            "has_sig": false,
            "md5_digest": "1273b2023020373e95c7a12853a8c3a7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 192418,
            "upload_time": "2023-04-23T14:33:21",
            "upload_time_iso_8601": "2023-04-23T14:33:21.344040Z",
            "url": "https://files.pythonhosted.org/packages/34/c6/bab7720bde32cb53f82aa7516f74fa76ae4b59c4e6124f7732d26356cc51/pyHRM-0.1.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-04-23 14:33:21",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "pyhrm"
}
        
Elapsed time: 0.06897s