Package org.biojava.nbio.structure.io
Class PDBFileReader
- java.lang.Object
-
- org.biojava.nbio.structure.io.LocalPDBDirectory
-
- org.biojava.nbio.structure.io.PDBFileReader
-
- All Implemented Interfaces:
StructureIOFile
,StructureProvider
public class PDBFileReader extends LocalPDBDirectory
The wrapper class for parsing a PDB file.
Several flags can be set for this class
-
#setAutoFetch(boolean)
- if the PDB file can not be found locally, should it be fetched from the PDB ftp servers? (default:false) - Other parameters can be set using the
LocalPDBDirectory.setFileParsingParameters(FileParsingParameters)
Example
Q: How can I get a Structure object from a PDB file?
A:
public
Access PDB files from a directory, take care of compressed PDB filesStructure
loadStructure(String pathToPDBFile){PDBFileReader
pdbreader = newPDBFileReader
();Structure
structure = null; try{ structure = pdbreader.getStructure(pathToPDBFile); System.out.println(structure); } catch (IOException e) { e.printStackTrace(); } return structure; }public
Structure
loadStructureById() { String path = "/path/to/PDB/directory/";PDBFileReader
pdbreader = newPDBFileReader
(); pdbreader.setPath(path);Structure
structure = null; try { structure = pdbreader.getStructureById("5pti"); } catch (IOException e){ e.printStackTrace(); } return structure; }- Author:
- Andreas Prlic
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.biojava.nbio.structure.io.LocalPDBDirectory
LocalPDBDirectory.FetchBehavior, LocalPDBDirectory.ObsoleteBehavior
-
-
Field Summary
Fields Modifier and Type Field Description static String[]
PDB_OBSOLETE_DIR
static String[]
PDB_SPLIT_DIR
-
Fields inherited from class org.biojava.nbio.structure.io.LocalPDBDirectory
DEFAULT_BCIF_FILE_SERVER, DEFAULT_PDB_FILE_SERVER, LAST_REMEDIATION_DATE, lineSplit, MIN_PDB_FILE_SIZE, PDB_FILE_SERVER_PROPERTY
-
-
Constructor Summary
Constructors Constructor Description PDBFileReader()
Constructs a new PDBFileReader, initializing the extensions member variable.PDBFileReader(String path)
Constructs a new PDBFileReader, initializing the extensions member variable.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected String
getFilename(String pdbId)
Converts a PDB ID into a filename with the proper extensionprotected String[]
getObsoleteDirPath()
Location of obsolete files within the directory, as an array of paths.protected String[]
getSplitDirPath()
Location of split files within the directory, as an array of paths.Structure
getStructure(InputStream inStream)
Handles the actual parsing of the file into a Structure object.-
Methods inherited from class org.biojava.nbio.structure.io.LocalPDBDirectory
addExtension, checkFileExists, checkFileExists, clearExtensions, deleteStructure, deleteStructure, downloadStructure, getDir, getExtensions, getFetchBehavior, getFileParsingParameters, getInputStream, getLocalFile, getLocalFile, getObsoleteBehavior, getPath, getServerName, getStructure, getStructure, getStructure, getStructureById, getStructureById, initPaths, prefetchStructure, setFetchBehavior, setFileParsingParameters, setObsoleteBehavior, setPath
-
-
-
-
Field Detail
-
PDB_SPLIT_DIR
public static final String[] PDB_SPLIT_DIR
-
PDB_OBSOLETE_DIR
public static final String[] PDB_OBSOLETE_DIR
-
-
Constructor Detail
-
PDBFileReader
public PDBFileReader()
Constructs a new PDBFileReader, initializing the extensions member variable. The path is initialized in the same way asUserConfiguration
, i.e. to system property/environment variableUserConfiguration.PDB_DIR
. Both autoFetch and splitDir are initialized to false
-
PDBFileReader
public PDBFileReader(String path)
Constructs a new PDBFileReader, initializing the extensions member variable. The path is initialized to the given path, both autoFetch and splitDir are initialized to false.If path is null, initialize using the system property/environment variable
UserConfiguration.PDB_DIR
.- Parameters:
path
- Path to the PDB file directory
-
-
Method Detail
-
getFilename
protected String getFilename(String pdbId)
Description copied from class:LocalPDBDirectory
Converts a PDB ID into a filename with the proper extension- Specified by:
getFilename
in classLocalPDBDirectory
- Returns:
- The filename, e.g. "4hhb.pdb.gz"
-
getStructure
public Structure getStructure(InputStream inStream) throws IOException
Description copied from class:LocalPDBDirectory
Handles the actual parsing of the file into a Structure object.- Specified by:
getStructure
in classLocalPDBDirectory
- Returns:
- Throws:
IOException
-
getSplitDirPath
protected String[] getSplitDirPath()
Description copied from class:LocalPDBDirectory
Location of split files within the directory, as an array of paths. These will be joined with either slashes (for the URL) or the file separator (for directories). The returned results should be constant, to allow for caching.- Specified by:
getSplitDirPath
in classLocalPDBDirectory
- Returns:
- A list of directories, relative to the /pub/pdb directory on the server
-
getObsoleteDirPath
protected String[] getObsoleteDirPath()
Description copied from class:LocalPDBDirectory
Location of obsolete files within the directory, as an array of paths. These will be joined with either slashes (for the URL) or the file separator (for directories). The returned results should be constant, to allow for caching.- Specified by:
getObsoleteDirPath
in classLocalPDBDirectory
- Returns:
- A list of directories, relative to the /pub/pdb directory on the server
-
-