Commit 30564256 by Maarten L. Hekkelman

split out web server

generating documentation
version bump
parent fedc1c0e
...@@ -212,6 +212,37 @@ install(TARGETS ${PROJECT_NAME} ...@@ -212,6 +212,37 @@ install(TARGETS ${PROJECT_NAME}
) )
# manual # manual
find_program(PANDOC pandoc)
if(PANDOC)
add_custom_command(OUTPUT ${PROJECT_SOURCE_DIR}/doc/mkdssp.md
DEPENDS ${PROJECT_SOURCE_DIR}/doc/mkdssp.1
COMMAND ${PANDOC} -o mkdssp.md mkdssp.1
WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}/doc/
VERBATIM)
add_custom_command(OUTPUT ${PROJECT_SOURCE_DIR}/doc/mkdssp.html
DEPENDS ${PROJECT_SOURCE_DIR}/doc/mkdssp.1
COMMAND ${PANDOC} -o mkdssp.html mkdssp.1
WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}/doc/
VERBATIM)
add_custom_command(OUTPUT ${PROJECT_SOURCE_DIR}/doc/mkdssp.pdf
DEPENDS ${PROJECT_SOURCE_DIR}/doc/mkdssp.1
COMMAND ${PANDOC} -o mkdssp.pdf mkdssp.1 -t html
WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}/doc/
VERBATIM)
add_custom_target(doc_files DEPENDS
${PROJECT_SOURCE_DIR}/doc/mkdssp.html
${PROJECT_SOURCE_DIR}/doc/mkdssp.pdf
${PROJECT_SOURCE_DIR}/doc/mkdssp.md)
add_dependencies(mkdssp doc_files)
else()
message(STATUS "Could not find pandoc, cannot recreate documentation files")
endif()
if(UNIX) if(UNIX)
install(FILES doc/mkdssp.1 install(FILES doc/mkdssp.1
DESTINATION ${CMAKE_INSTALL_DATADIR}/man/man1) DESTINATION ${CMAKE_INSTALL_DATADIR}/man/man1)
......
Version 4.3.2
- Packaging (split out the web server again)
- Added markdown doc file, all doc files are now created from mkdssp.1
using pandoc, if that is installed.
Version 4.3.1.1 Version 4.3.1.1
- Check to see if data will fit in old format before starting calculations - Check to see if data will fit in old format before starting calculations
......
.TH mkdssp 1 "2021-08-31" "version 4.0.5" "User Commands" .TH mkdssp 1 "2023-06-13" "version 4.3.2" "User Commands"
.if n .ad l .if n .ad l
.nh .nh
.SH NAME .SH NAME
......
Content-type: text/html; charset=UTF-8 <h1>NAME</h1>
<p>mkdssp - Assign secondary structure to proteins</p>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <h1>SYNOPSIS</h1>
<HTML><HEAD><TITLE>Man page of mkdssp</TITLE> <p>mkdssp [OPTION] input [output]</p>
</HEAD><BODY> <h1>DESCRIPTION</h1>
<H1>mkdssp</H1> <p>The DSSP program was designed by Wolfgang Kabsch and Chris Sander to standardize secondary structure assignment. DSSP is a database of secondary structure assignments (and much more) for all protein entries in the Protein Data Bank (PDB). mkdssp is the program that calculates DSSP entries from PDB entries. mkdssp does <strong>not</strong> predict secondary structure.</p>
Section: User Commands (1)<BR>Updated: 2021-08-31<BR><A HREF="#index">Index</A> <p>The original DSSP program wrote output in a fixed format, this version by default writes annotated mmCIF files, storing the secondary structure information in the _struct_conf category.</p>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR> <p>Since version 4.0 the mkdssp program also assigns PPII helices.</p>
<h1>OPTIONS</h1>
<p>The input file can be either mmCIF or PDB format and the file may be gzip compressed. Note that input files must be formatted correctly. E.g. PDB files must have a CRYST1 record. More info: https://www.wwpdb.org/documentation/file-format-content/format33/sect8.html#CRYST1</p>
<p>The output is optional, if omitted the output is written to <em>stdout</em>. If the name of the output file ends with either <em>.gz</em> or <em>.bz2</em> the output is compressed accordingly.</p>
<dl>
<A NAME="lbAB">&nbsp;</A> <dt><strong>--output-format</strong>=[dssp|mmcif]</dt>
<H2>NAME</H2> <dd><p>If an output file is specified, the extension of the filename is used to choose to output format, but if it is unclear, mmcif is the default. Use this option to force output in either the old fixed column DSSP format or the new annotated mmCIF format.</p>
</dd>
mkdssp - Assign secondary structure to proteins <dt><strong>--no-dssp-categories</strong></dt>
<A NAME="lbAC">&nbsp;</A> <dd><p>When writing mmCIF files, suppress the output of all dssp_ categories.</p>
<H2>SYNOPSIS</H2> </dd>
<dt><strong>--min-pp-stretch</strong></dt>
mkdssp [OPTION] input [output] <dd><p>This option can be used to define the minimal number of residues with PHI/PSI angles within the range required to assing a PP helix.</p>
<A NAME="lbAD">&nbsp;</A> </dd>
<H2>DESCRIPTION</H2> <dt><strong>--write-other</strong></dt>
<dd><p>By default the new format does not write the structure information for OTHER. Use this flag to change that.</p>
The DSSP program was designed by Wolfgang Kabsch and Chris Sander to </dd>
standardize secondary structure assignment. DSSP is a database of <dt><strong>--components</strong></dt>
secondary structure assignments (and much more) for all protein entries <dd><p>The knowledge of compounds is loaded from the CCD file <em>components.cif</em> that should have been installed by <em>libcifpp</em>. You can override that file by using this option.</p>
in the Protein Data Bank (PDB). mkdssp is the program that calculates </dd>
DSSP entries from PDB entries. mkdssp does <B>not</B> predict secondary structure. <dt><strong>--extra-compounds</strong></dt>
<P> <dd><p>As an addition to the standard <em>components.cif</em> file, you can add more files using this option. Files should be either in CCD format or should be CCP4 restraints files.</p>
The original DSSP program wrote output in a fixed format, this version </dd>
by default writes annotated mmCIF files, storing the secondary structure <dt><strong>--mmcif-dictionary</strong></dt>
information in the _struct_conf category. <dd><p>The default mmCIF dictionary file is installed by the <em>libcifpp</em> library but you can override it using this option.</p>
<P> </dd>
Since version 4.0 the mkdssp program also assigns PPII helices. </dl>
<A NAME="lbAE">&nbsp;</A> <h1>DETAILS</h1>
<H2>OPTIONS</H2> <p>The DSSP algorithm assings secondary structure based on the energy calculated for H-bonds.<br />
<strong>Table 1. Secondary Structures recognized</strong></p>
The input file can be either mmCIF or PDB format and the file may be <table>
gzip compressed. Note that input files must be formatted correctly. <tbody>
E.g. PDB files must have a CRYST1 record. More info: <tr class="odd">
<A HREF="https://www.wwpdb.org/documentation/file-format-content/format33/sect8.html#CRYST1">https://www.wwpdb.org/documentation/file-format-content/format33/sect8.html#CRYST1</A> <td style="text-align: center;">DSSP Code</td>
<P> <td style="text-align: center;">mmCIF Code</td>
The output is optional, if omitted the output is written to <I>stdout</I>. If <td style="text-align: center;">Description</td>
the name of the output file ends with either <I>.gz</I> or <I>.bz2</I> the </tr>
output is compressed accordingly. <tr class="even">
<DL COMPACT> <td style="text-align: center;">H</td>
<DT><B>--output-format</B>=[dssp|mmcif]<DD> <td style="text-align: center;">HELX_RH_AL_P</td>
If an output file is specified, the extension of the filename is used to <td style="text-align: center;">Alphahelix</td>
choose to output format, but if it is unclear, mmcif is the default. Use </tr>
this option to force output in either the old fixed column DSSP format or <tr class="odd">
the new annotated mmCIF format. <td style="text-align: center;">B</td>
<DT><B>--min-pp-stretch</B><DD> <td style="text-align: center;">STRN</td>
This option can be used to define the minimal number of residues with PHI/PSI <td style="text-align: center;">Betabridge</td>
angles within the range required to assing a PP helix. </tr>
<DT><B>--write-other</B><DD> <tr class="even">
By default the new format does not write the structure information for OTHER. <td style="text-align: center;">E</td>
Use this flag to change that. <td style="text-align: center;">STRN</td>
</DL> <td style="text-align: center;">Strand</td>
<A NAME="lbAF">&nbsp;</A> </tr>
<H2>DETAILS</H2> <tr class="odd">
<td style="text-align: center;">G</td>
The DSSP algorithm assings secondary structure based on the energy calculated <td style="text-align: center;">HELX_RH_3T_P</td>
for H-bonds. <td style="text-align: center;">Helix_3</td>
<BR> </tr>
<tr class="even">
<B>Table&nbsp;1.&nbsp;Secondary&nbsp;Structures&nbsp;recognized</B> <td style="text-align: center;">I</td>
<td style="text-align: center;">HELX_RH_PI_P</td>
<TABLE BORDER> <td style="text-align: center;">Helix_5</td>
<TR VALIGN=top><TD ALIGN=center><B>DSSP Code</B></TD><TD ALIGN=center><B>mmCIF Code</B></TD><TD ALIGN=center><B>Description</B><BR></TD></TR> </tr>
<TR VALIGN=top><TD>H</TD><TD>HELX_RH_AL_P</TD><TD>Alphahelix<BR></TD></TR> <tr class="odd">
<TR VALIGN=top><TD>B</TD><TD>STRN</TD><TD>Betabridge<BR></TD></TR> <td style="text-align: center;">P</td>
<TR VALIGN=top><TD>E</TD><TD>STRN</TD><TD>Strand<BR></TD></TR> <td style="text-align: center;">HELX_LH_PP_P</td>
<TR VALIGN=top><TD>G</TD><TD>HELX_RH_3T_P</TD><TD>Helix_3<BR></TD></TR> <td style="text-align: center;">Helix_PPII</td>
<TR VALIGN=top><TD>I</TD><TD>HELX_RH_PI_P</TD><TD>Helix_5<BR></TD></TR> </tr>
<TR VALIGN=top><TD>P</TD><TD>HELX_LH_PP_P</TD><TD>Helix_PPII<BR></TD></TR> <tr class="even">
<TR VALIGN=top><TD>T</TD><TD>TURN_TY1_P</TD><TD>Turn<BR></TD></TR> <td style="text-align: center;">T</td>
<TR VALIGN=top><TD>S</TD><TD>BEND</TD><TD>Bend<BR></TD></TR> <td style="text-align: center;">TURN_TY1_P</td>
<TR VALIGN=top><TD> <td style="text-align: center;">Turn</td>
' ' (space) </tr>
</TD><TD>OTHER</TD><TD>Loop<BR></TD></TR> <tr class="odd">
</TABLE> <td style="text-align: center;">S</td>
<td style="text-align: center;">BEND</td>
<A NAME="lbAG">&nbsp;</A> <td style="text-align: center;">Bend</td>
<H2>BUGS</H2> </tr>
<tr class="even">
The mmCIF format currently lacks a lot of information that was available <td style="text-align: center;">' ' (space)</td>
in the old format like information about the bridge pairs or the span <td style="text-align: center;">OTHER</td>
of the various helices recognized. Also the accessibility information <td style="text-align: center;">Loop</td>
is left out. </tr>
<P> </tbody>
If you think this information should be part of the output, please contact </table>
the author. <h1>BUGS</h1>
<A NAME="lbAH">&nbsp;</A> <p>The mmCIF format currently lacks a lot of information that was available in the old format like information about the bridge pairs or the span of the various helices recognized. Also the accessibility information is left out.</p>
<H2>AUTHOR</H2> <p>If you think this information should be part of the output, please contact the author.</p>
<h1>AUTHOR</h1>
Written by Maarten L. Hekkelman &lt;<A HREF="mailto:maarten@hekkelman.com">maarten@hekkelman.com</A>&gt; <p>Written by Maarten L. Hekkelman &lt;maarten@hekkelman.com&gt;</p>
<A NAME="lbAI">&nbsp;</A> <h1>REPORTING BUGS</h1>
<H2>REPORTING BUGS</H2> <p>Report bugs at https://github.com/PDB-REDO/dssp/issues</p>
Report bugs at <A HREF="https://github.com/PDB-REDO/dssp/issues">https://github.com/PDB-REDO/dssp/issues</A>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">DETAILS</A><DD>
<DT><A HREF="#lbAG">BUGS</A><DD>
<DT><A HREF="#lbAH">AUTHOR</A><DD>
<DT><A HREF="#lbAI">REPORTING BUGS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 13:56:55 GMT, August 31, 2021
</BODY>
</HTML>
NAME
====
mkdssp - Assign secondary structure to proteins
SYNOPSIS
========
mkdssp \[OPTION\] input \[output\]
DESCRIPTION
===========
The DSSP program was designed by Wolfgang Kabsch and Chris Sander to
standardize secondary structure assignment. DSSP is a database of
secondary structure assignments (and much more) for all protein entries
in the Protein Data Bank (PDB). mkdssp is the program that calculates
DSSP entries from PDB entries. mkdssp does **not** predict secondary
structure.
The original DSSP program wrote output in a fixed format, this version
by default writes annotated mmCIF files, storing the secondary structure
information in the \_struct\_conf category.
Since version 4.0 the mkdssp program also assigns PPII helices.
OPTIONS
=======
The input file can be either mmCIF or PDB format and the file may be
gzip compressed. Note that input files must be formatted correctly. E.g.
PDB files must have a CRYST1 record. More info:
https://www.wwpdb.org/documentation/file-format-content/format33/sect8.html\#CRYST1
The output is optional, if omitted the output is written to *stdout*. If
the name of the output file ends with either *.gz* or *.bz2* the output
is compressed accordingly.
**\--output-format**=\[dssp\|mmcif\]
: If an output file is specified, the extension of the filename is
used to choose to output format, but if it is unclear, mmcif is the
default. Use this option to force output in either the old fixed
column DSSP format or the new annotated mmCIF format.
**\--no-dssp-categories**
: When writing mmCIF files, suppress the output of all dssp\_
categories.
**\--min-pp-stretch**
: This option can be used to define the minimal number of residues
with PHI/PSI angles within the range required to assing a PP helix.
**\--write-other**
: By default the new format does not write the structure information
for OTHER. Use this flag to change that.
**\--components**
: The knowledge of compounds is loaded from the CCD file
*components.cif* that should have been installed by *libcifpp*. You
can override that file by using this option.
**\--extra-compounds**
: As an addition to the standard *components.cif* file, you can add
more files using this option. Files should be either in CCD format
or should be CCP4 restraints files.
**\--mmcif-dictionary**
: The default mmCIF dictionary file is installed by the *libcifpp*
library but you can override it using this option.
DETAILS
=======
The DSSP algorithm assings secondary structure based on the energy
calculated for H-bonds.\
**Table 1. Secondary Structures recognized**
--------------- ----------------- -------------
DSSP Code mmCIF Code Description
H HELX\_RH\_AL\_P Alphahelix
B STRN Betabridge
E STRN Strand
G HELX\_RH\_3T\_P Helix\_3
I HELX\_RH\_PI\_P Helix\_5
P HELX\_LH\_PP\_P Helix\_PPII
T TURN\_TY1\_P Turn
S BEND Bend
\' \' (space) OTHER Loop
--------------- ----------------- -------------
BUGS
====
The mmCIF format currently lacks a lot of information that was available
in the old format like information about the bridge pairs or the span of
the various helices recognized. Also the accessibility information is
left out.
If you think this information should be part of the output, please
contact the author.
AUTHOR
======
Written by Maarten L. Hekkelman \<maarten\@hekkelman.com\>
REPORTING BUGS
==============
Report bugs at https://github.com/PDB-REDO/dssp/issues
No preview for this file type
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment