v3.0.0
MIToS v3.0.0
MIToS v3.0.0 requires Julia v1.9 or higher, dropping support for older versions. This
release introduces several breaking changes to improve the usability of the package.
When possible, deprecation warnings are used to inform you of the changes.
MIToS.MSA
The MSA module now includes ways to read, write, and work with unaligned protein sequences:
-
The
MSA
module now exports theAnnotatedSequence
type to represent a single protein
sequence with annotations. This type is a subtype of the newAbstractSequence
type,
a subtype of the newAbstractResidueMatrix
type. -
The
MSA
module now exports thesequence_id
function to get the identifier of a
sequence object. -
The
MSA
module now defines theFASTASequences
,PIRSequences
, andRawSequences
file formats to read and write (unaligned) protein sequences in FASTA, PIR, and raw
formats, respectively. -
[Breaking change] The behavior of the
getannotresidue
,getannotsequence
,
setannotresidue!
, andsetannotsequence!
functions have changed for sequences objects,
such asAnnotatedSequence
,AnnotatedAlignedSequence
, andAlignedSequence
. Now, these
functions take the feature name, rather than the sequence name, as the second
positional argument. As an example of migration,
getannotsequence(sequence, "sequence_name", "feature_name")
should be replaced by
getannotsequence(sequence, "feature_name")
. You still need to specify the sequence name
when working with MSA objects.
Other changes in the MSA module are:
-
[Breaking change] The
join
function forAnnotatedMultipleSequenceAlignment
objects
is deprecated in favor of thejoin_msas
function. -
[Breaking change] The
Clusters
type is no longer a subtype ofClusteringResult
from
theClustering.jl
package. Instead, theClusters
type is now a subtype of the new
AbstractCluster
type. Support for theClustering.jl
interface is still available
through package extensions. You now need to load theClustering.jl
package to use the
assignments
,nclusters
, andcounts
functions.
MIToS.PDB
The PDB module now depends on the BioStructures
package. The main changes in the PDB
module are:
-
The
PDB
module now exports theMMCIFFile
file format to read and write PDB files in
the mmCIF format (usingBioStructures
under the hood). -
[Breaking change] The
download_alphafold_structure
function can now download the
predicted structures from the AlphaFold Protein Structure Database using the mmCIF
format (format=MMCIFFile
). This is the new default format. Therefore, you should use
format=PDBFile
to get a PDB file like before. For example,
download_alphafold_structure("P00520")
in previous versions is the same as
download_alphafold_structure("P00520", format=PDBFile)
in this version. -
[Breaking change] The
downloadpdb
function now returns a mmCIF file by default.
Therefore, you should useformat=PDBML
to get a PDBML file. As an example of migration,
downloadpdb("1IVO")
should be replaced bydownloadpdb("1IVO", format=PDBML)
, unless
you want to get a mmCIF file. -
[Breaking change] The
PDBAtom
type now adds two extra fields:alt_id
andcharge
to represent the alternative location indicator and the atom's charge, respectively.
This improves the compatibility with the mmCIF format and theBioStructures
package. -
[Breaking change] The
query_alphafolddb
function now returns the EntrySummary object
of the returned JSON response instead of the Root list. Therefore, there is no need to
take the first element of the list to get the required information. For example,
query_alphafolddb("P00520")[1]["uniprotId"]
would be replaced by
query_alphafolddb("P00520")["uniprotId"]
.
MIToS.Utils.Scripts
- [Breaking change] The
MIToS.Utils.Scripts
module and the MIToS scripts have been
moved to their package at MIToS_Scripts.jl.
Therefore, theMIToS.Utils.Scripts
module is no longer exported. This allows for a
reduction in the number of MIToS dependencies, and improved load time.