{"id":497,"date":"2019-04-12T19:29:45","date_gmt":"2019-04-12T19:29:45","guid":{"rendered":"https:\/\/ccsb.scripps.edu\/agfr\/?page_id=497"},"modified":"2019-04-25T23:40:08","modified_gmt":"2019-04-25T23:40:08","slug":"overview","status":"publish","type":"page","link":"https:\/\/ccsb.scripps.edu\/agfr\/overview\/","title":{"rendered":"Overview"},"content":{"rendered":"<p class=\"last-modified\">This page was last updated on April 25th, 2019 at 11:40 pm<\/p><div class=\"fusion-fullwidth fullwidth-box fusion-builder-row-1 nonhundred-percent-fullwidth non-hundred-percent-height-scrolling\" style=\"--awb-border-radius-top-left:0px;--awb-border-radius-top-right:0px;--awb-border-radius-bottom-right:0px;--awb-border-radius-bottom-left:0px;--awb-flex-wrap:wrap;\" ><div class=\"fusion-builder-row fusion-row\"><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-0 fusion_builder_column_1_1 1_1 fusion-one-full fusion-column-first fusion-column-last\" style=\"--awb-bg-size:cover;\"><div class=\"fusion-column-wrapper fusion-flex-column-wrapper-legacy\"><div class=\"fusion-title title fusion-title-1 fusion-sep-none fusion-title-text fusion-title-size-one\" style=\"--awb-margin-top-small:10px;--awb-margin-right-small:0px;--awb-margin-bottom-small:10px;--awb-margin-left-small:0px;\"><h1 class=\"fusion-title-heading title-heading-left\" style=\"margin:0;\"><h3>AutoGridFR overview<\/h3><\/h1><\/div><div class=\"fusion-section-separator section-separator triangle fusion-section-separator-1\" style=\"--awb-border-top:1px solid #f6f6f6;--awb-spacer-height:1px;--awb-svg-margin-left:0;--awb-svg-margin-right:0;--awb-icon-color:#ffffff;\"><div class=\"fusion-section-separator-svg\"><div class=\"divider-candy-arrow top\" style=\"bottom:0px;border-bottom-color: #f6f6f6;\"><\/div><div class=\"divider-candy top\" style=\"top:-21px;border-bottom:1px solid #f6f6f6;border-left:1px solid #f6f6f6;\"><\/div><\/div><div class=\"fusion-section-separator-spacer\"><div class=\"fusion-section-separator-spacer-height\"><\/div><\/div><\/div><div class=\"fusion-text fusion-text-1\"><p><em>AutoGridFR<\/em> (<em>AGFR<\/em>) is a software program for generating target files, <em>i.e.<\/em>\u00a0a single file defining a binding site targeted for docking on a\u00a0biological macro-molecule. Target files\u00a0simplifies the management of maps and support data provenance and reproducibility. They can be unzipped and the maps extracted for use with AutoDock4. We plan to add direct support for target files in the next release of AutoDock4.<\/p>\n<p><em>AGFR<\/em>\u00a0can be run form the command line of through a graphical user interface show in the figure below.<\/p>\n<\/div><div class=\"fusion-image-element in-legacy-container\" style=\"--awb-caption-title-font-family:var(--h2_typography-font-family);--awb-caption-title-font-weight:var(--h2_typography-font-weight);--awb-caption-title-font-style:var(--h2_typography-font-style);--awb-caption-title-size:var(--h2_typography-font-size);--awb-caption-title-transform:var(--h2_typography-text-transform);--awb-caption-title-line-height:var(--h2_typography-line-height);--awb-caption-title-letter-spacing:var(--h2_typography-letter-spacing);\"><span class=\" fusion-imageframe imageframe-dropshadow imageframe-1 hover-type-none\" style=\"-webkit-box-shadow: 3px 3px 7px rgba(0,0,0,0.3);box-shadow: 3px 3px 7px rgba(0,0,0,0.3);\"><img decoding=\"async\" width=\"1156\" height=\"878\" title=\"OverviewPic\" src=\"https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/OverviewPic.png\" alt class=\"img-responsive wp-image-493\" srcset=\"https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/OverviewPic-200x152.png 200w, https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/OverviewPic-400x304.png 400w, https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/OverviewPic-600x456.png 600w, https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/OverviewPic-800x608.png 800w, https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/OverviewPic.png 1156w\" sizes=\"(max-width: 800px) 100vw, 1156px\" \/><\/span><\/div><div class=\"fusion-clearfix\"><\/div><\/div><\/div><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-1 fusion_builder_column_2_3 2_3 fusion-two-third fusion-column-first\" style=\"--awb-bg-size:cover;width:66.666666666667%;width:calc(66.666666666667% - ( ( 4% ) * 0.66666666666667 ) );margin-right: 4%;\"><div class=\"fusion-column-wrapper fusion-flex-column-wrapper-legacy\"><div class=\"fusion-text fusion-text-2\"><p>For the impatient you can skip the the <a href=\"https:\/\/ccsb.scripps.edu\/agfr\/documentation\/\">use cases tutorials<\/a>, or read on for a brief overview of the GUI.<\/p>\n<p>The title of the GUI window displays the program version along with the names of the currently loaded receptor and ligand. In addition, if OpenMP is enabled, the number of hardware threads available will appear in the title.<\/p>\n<p>The GUI has 4 main areas: 1) On the left,\u00a0 the &#8220;controls&#8221; panel provides vertically stacked boxed containing widgets for performing the tasks comprised in the workflow of computing target files for a given receptor; 2) On the right side a 3D view provides the user with real time visual feed back; 3) In the middle a toolbar presents buttons for altering the visual representation in the 3D view; and finally, 4) at the bottom, a status bar provides textual feedback about computations being performed or the next possible step in the workflow, as well as status lights (red or green) informing the user about that validity of the current docking box definition.<\/p>\n<p>Below we give a quick overview of the function of the widgets in the control panel.<\/p>\n<p>The input boxes entitled &#8220;<strong>receptor<\/strong>&#8221; and &#8220;<strong>ligand<\/strong>&#8221; are located at the top. They allows loading a receptor in the PDBQT file format, or open an existing target file which will configure all the widget according to the way the target file was generated. Optionally a crystallographic ligand can be loaded to help the user position the docking box and\/or define the list of atom types for which to compute affinity maps.<\/p>\n<p>Below, the widget \u201c<strong><em>docking box<\/em><\/strong>\u201d presents a group of buttons to set up the docking box (<em>i.e.<\/em>\u00a0the rectilinear region of space for over which affinity maps will be computed). The choices are to size and position the box to encompass: the entire receptor, the ligand (enabled if one is loaded), a given pocket (enabled if pockets have been identified, see the &#8220;<em>ligand binding pockets&#8221;<\/em> section below), a user selected set of receptor amino acids, or by manually specify the position and size of the box, respectively. Any of these buttons (except the manual specification of the box) will calculate the bounding box corresponding to the pressed button and add the current padding values to each side of the bounding box. The box needs to overlap with the receptor for the <strong><em>BOX<\/em><\/strong> status light in the status bar to turn red.<\/p>\n<p>Optionally, flexible receptor side chains can be specified using the third group of widgets &#8220;<strong>[0 flexible residue(s)]<\/strong>&#8220;. A selection string can\u00a0be types\u00a0or residues can be selected in a tree-widget. The syntax for a selection string is a chain ID followed by a colon an a comma separated list of residues,\u00a0<em>e.g. A:LYS33,LYS89;B:ARG12<\/em>. The docking box is required to cover flexible residues or else\u00a0 the <strong><em>FR<\/em><\/strong> status light in the status bar will be red. A button is provide to adjust the box size to fulfill this requirement. More details are given in the tutorial &#8220;<a href=\"https:\/\/ccsb.scripps.edu\/agfr\/flexible-receptor-sidechains\/\">Affinity maps for docking with flexible receptor side-chains<\/a>&#8220;.<\/p>\n<p>The widgets in the \u201c<strong><em>covalent Docking<\/em><\/strong>\u201d section allow to optionally specify 2 atoms forming a covalent bond between the receptor and the ligand. these atoms can be picked in in the 3D view or specified by typing in their full names (<em>e.g. A:CYS164:SG<\/em>). The covalent ligand (if present in the loaded receptor) will be displayed with dashed lines and can be edited by adding or removing atoms. More details are available in the &#8220;<a href=\"https:\/\/ccsb.scripps.edu\/agfr\/covalent-docking\/\">Affinity maps for covalent docking<\/a>&#8221; tutorial.<\/p>\n<p>&#8220;<strong>ligand binding pockets<\/strong>&#8220;: The table widget in this section lists the various pockets identified by <em>AutoSite<\/em>\u00a0on the current docking box. Fills can be selected to participate in the definition of the binding pocket. Both the original version 1.0 as well as version 1.1 of the <em>AutoSite<\/em> algorithm are available. Version 1.1 is slower but provides better pocket descriptors, in particular for larger ligands such as peptides.<\/p>\n<p>The final group of widgets (&#8220;<strong>affinity maps<\/strong>&#8220;) is used to specify the list of atom types for which affinity maps are computed. Maps can be computed for all known <em>AutoDock<\/em> atom types which is the preferred option as it creates a target file usable for any ligand.\u00a0<em>AGFR<\/em> also automatically computes the water maps for hydrated docking. The parameters associated with the calculation of water maps can be set here.\u00a0Finally, the user can specify whether gradients are added to the maps, and specify options for their calculation.<\/p>\n<p>Most buttons in the interface are only enabled once prerequisites for performing the associated task are met. For instance, the \u201c<strong><em>generate target files \u2026<\/em><\/strong>\u201d button will only be enabled after a receptor is loaded, a box that overlaps with the receptor is defined, at least one fill defining a pocket is selected and the selected fill overlaps with the box. The 4 buttons at the bottom right, will be red initially, and turn green gradually as conditions become satisfied, thus guiding the user through the process.<\/p>\n<p>The actual calculation of the maps is performed by an optimized, and OpenMP enable version of <em>AutoGrid4<\/em>, bundled with the application.<\/p>\n<\/div><div class=\"fusion-clearfix\"><\/div><\/div><\/div><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-2 fusion_builder_column_1_3 1_3 fusion-one-third fusion-column-last\" style=\"--awb-bg-size:cover;width:33.333333333333%;width:calc(33.333333333333% - ( ( 4% ) * 0.33333333333333 ) );\"><div class=\"fusion-column-wrapper fusion-flex-column-wrapper-legacy\"><div class=\"fusion-image-element in-legacy-container\" style=\"--awb-caption-title-font-family:var(--h2_typography-font-family);--awb-caption-title-font-weight:var(--h2_typography-font-weight);--awb-caption-title-font-style:var(--h2_typography-font-style);--awb-caption-title-size:var(--h2_typography-font-size);--awb-caption-title-transform:var(--h2_typography-text-transform);--awb-caption-title-line-height:var(--h2_typography-line-height);--awb-caption-title-letter-spacing:var(--h2_typography-letter-spacing);\"><span class=\" fusion-imageframe imageframe-none imageframe-2 hover-type-none\"><img decoding=\"async\" src=\"https:\/\/ccsb.scripps.edu\/agfr\/wp-content\/uploads\/sites\/33\/2019\/04\/Picture1-200x175.png\" alt class=\"img-responsive\"\/><\/span><\/div><div class=\"fusion-clearfix\"><\/div><\/div><\/div><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"<p>This page was last updated on April 25th, 2019 at  [&#8230;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-497","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/pages\/497","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/comments?post=497"}],"version-history":[{"count":7,"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/pages\/497\/revisions"}],"predecessor-version":[{"id":859,"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/pages\/497\/revisions\/859"}],"wp:attachment":[{"href":"https:\/\/ccsb.scripps.edu\/agfr\/wp-json\/wp\/v2\/media?parent=497"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}