[Bio] / Sprout / SproutDBD.xml Repository:
ViewVC logotype

Diff of /Sprout/SproutDBD.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.12, Tue Sep 13 03:50:59 2005 UTC revision 1.29, Fri Jun 30 18:31:34 2006 UTC
# Line 111  Line 111 
111                  </Field>                  </Field>
112              </Fields>              </Fields>
113          </Entity>          </Entity>
114          <Entity name="Feature" keyType="name-string">          <Entity name="Feature" keyType="id-string">
115              <Notes>A [i]feature[/i] is a part of a genome that is of special interest. Features              <Notes>A [i]feature[/i] is a part of a genome that is of special interest. Features
116              may be spread across multiple contigs of a genome, but never across more than              may be spread across multiple contigs of a genome, but never across more than
117              one genome. Features can be assigned to roles via spreadsheet cells,              one genome. Features can be assigned to roles via spreadsheet cells,
# Line 121  Line 121 
121                      <Notes>Code indicating the type of this feature.</Notes>                      <Notes>Code indicating the type of this feature.</Notes>
122                      <DataGen>RandParam('peg','rna')</DataGen>                      <DataGen>RandParam('peg','rna')</DataGen>
123                  </Field>                  </Field>
124                  <Field name="alias" type="name-string" relation="FeatureAlias">                  <Field name="alias" type="medium-string" relation="FeatureAlias">
125                      <Notes>Alternative name for this feature. A feature can have many aliases.</Notes>                      <Notes>Alternative name for this feature. A feature can have many aliases.</Notes>
126                      <DataGen testCount="3">StringGen('Pgi|99999', 'Puni|XXXXXX', 'PAAAAAA999')</DataGen>                      <DataGen testCount="3">StringGen('Pgi|99999', 'Puni|XXXXXX', 'PAAAAAA999')</DataGen>
127                  </Field>                  </Field>
# Line 159  Line 159 
159                  </Index>                  </Index>
160              </Indexes>              </Indexes>
161          </Entity>          </Entity>
162            <Entity name="SynonymGroup" keyType="id-string">
163                <Notes>A [i]synonym group[/i] represents a group of features. Substantially identical features
164                are mapped to the same synonym group, and this information is used to expand similarities.</Notes>
165            </Entity>
166          <Entity name="Role" keyType="string">          <Entity name="Role" keyType="string">
167              <Notes>A [i]role[/i] describes a biological function that may be fulfilled by a feature.              <Notes>A [i]role[/i] describes a biological function that may be fulfilled by a feature.
168              One of the main goals of the database is to record the roles of the various features.</Notes>              One of the main goals of the database is to record the roles of the various features.</Notes>
169              <Fields>              <Fields>
170                  <Field name="name" type="string" relation="RoleName">                  <Field name="EC" type="string" relation="RoleEC">
171                      <Notes>Expanded name of the role. This value is generally only available for roles                      <Notes>EC code for this role.</Notes>
                     that are encoded as EC numbers.</Notes>  
172                      <DataGen testCount="1">StringGen(IntGen(20,40)) . "(" . $this->{id} . ")"</DataGen>                      <DataGen testCount="1">StringGen(IntGen(20,40)) . "(" . $this->{id} . ")"</DataGen>
173                  </Field>                  </Field>
174                    <Field name="abbr" type="name-string">
175                        <Notes>Abbreviated name for the role, generally non-unique, but useful
176                        in column headings for HTML tables.</Notes>
177                    </Field>
178              </Fields>              </Fields>
179                <Indexes>
180                    <Index>
181                        <Notes>This index allows the user to find the role corresponding to
182                        an EC number.</Notes>
183                        <IndexFields>
184                            <IndexField name="EC" order="ascending" />
185                        </IndexFields>
186                    </Index>
187                </Indexes>
188          </Entity>          </Entity>
189          <Entity name="Annotation" keyType="name-string">          <Entity name="Annotation" keyType="name-string">
190              <Notes>An [i]annotation[/i] contains supplementary information about a feature. Annotations              <Notes>An [i]annotation[/i] contains supplementary information about a feature. Annotations
191              are currently the only objects that may be inserted directly into the database. All other              are currently the only objects that may be inserted directly into the database. All other
192              information is loaded from data exported by the SEED.              information is loaded from data exported by the SEED.</Notes>
             [p]Each annotation is associated with a target [b]Feature[/b]. The key of the annotation  
             is the target feature ID followed by a timestamp.</Notes>  
193              <Fields>              <Fields>
194                  <Field name="time" type="date">                  <Field name="time" type="date">
195                      <Notes>Date and time of the annotation.</Notes>                      <Notes>Date and time of the annotation.</Notes>
# Line 184  Line 198 
198                      <Notes>Text of the annotation.</Notes>                      <Notes>Text of the annotation.</Notes>
199                  </Field>                  </Field>
200              </Fields>              </Fields>
201                <Indexes>
202                    <Index>
203                        <Notes>This index allows the user to find recent annotations.</Notes>
204                        <IndexFields>
205                            <IndexField name="time" order="descending" />
206                        </IndexFields>
207                    </Index>
208                </Indexes>
209            </Entity>
210            <Entity name="Reaction" keyType="key-string">
211                <Notes>A [i]reaction[/i] is a chemical process catalyzed by a protein. The reaction ID
212                is generally a small number preceded by a letter.</Notes>
213                <Fields>
214                    <Field name="url" type="string" relation="ReactionURL">
215                        <Notes>HTML string containing a link to a web location that describes the
216                        reaction. This field is optional.</Notes>
217                    </Field>
218                    <Field name="rev" type="boolean">
219                        <Notes>TRUE if this reaction is reversible, else FALSE</Notes>
220                    </Field>
221                </Fields>
222            </Entity>
223            <Entity name="Compound" keyType="name-string">
224                <Notes>A [i]compound[/i] is a chemical that participates in a reaction.
225                All compounds have a unique ID and may also have one or more names.</Notes>
226                <Fields>
227                    <Field name="name-priority" type="int" relation="CompoundName">
228                        <Notes>Priority of a compound name. The name with the loweset
229                        priority is the main name of this compound.</Notes>
230                    </Field>
231                    <Field name="name" type="name-string" relation="CompoundName">
232                        <Notes>Descriptive name for the compound. A compound may
233                        have several names.</Notes>
234                    </Field>
235                    <Field name="cas-id" type="name-string" relation="CompoundCAS">
236                        <Notes>Chemical Abstract Service ID for this compound (optional).</Notes>
237                    </Field>
238                    <Field name="label" type="name-string">
239                        <Notes>Name used in reaction display strings.
240                        It is the same as the name possessing a priority of 1, but it is placed
241                        here to speed up the query used to create the display strings.</Notes>
242                    </Field>
243                </Fields>
244                <Indexes>
245                    <Index>
246                        <Notes>This index allows the user to find the compound corresponding to
247                        the specified name.</Notes>
248                        <IndexFields>
249                            <IndexField name="name" order="ascending" />
250                        </IndexFields>
251                    </Index>
252                    <Index>
253                        <Notes>This index allows the user to find the compound corresponding to
254                        the specified CAS ID.</Notes>
255                        <IndexFields>
256                            <IndexField name="cas-id" order="ascending" />
257                        </IndexFields>
258                    </Index>
259                    <Index>
260                        <Notes>This index allows the user to access the compound names in
261                        priority order.</Notes>
262                        <IndexFields>
263                            <IndexField name="id" order="ascending" />
264                            <IndexField name="name-priority" order="ascending" />
265                        </IndexFields>
266                    </Index>
267                </Indexes>
268          </Entity>          </Entity>
269          <Entity name="Subsystem" keyType="string">          <Entity name="Subsystem" keyType="string">
270              <Notes>A [i]subsystem[/i] is a collection of roles that work together in a cell. Identification of subsystems              <Notes>A [i]subsystem[/i] is a collection of roles that work together in a cell. Identification of subsystems
271              is an important tool for recognizing parallel genetic features in different organisms.</Notes>              is an important tool for recognizing parallel genetic features in different organisms.</Notes>
272                <Fields>
273                    <Field name="curator" type="string">
274                        <Notes>Name of the person currently in charge of the subsystem.</Notes>
275                    </Field>
276                    <Field name="notes" type="text">
277                        <Notes>Descriptive notes about the subsystem.</Notes>
278                    </Field>
279                    <Field name="classification" type="string" relation="SubsystemClass">
280                        <Notes>General classification data about the subsystem.</Notes>
281                    </Field>
282                </Fields>
283          </Entity>          </Entity>
284          <Entity name="SSCell" keyType="name-string">          <Entity name="RoleSubset" keyType="string">
285                <Notes>A [i]role subset[/i] is a named collection of roles in a particular subsystem. The
286                subset names are generally very short, non-unique strings. The ID of the parent
287                subsystem is prefixed to the subset ID in order to make it unique.</Notes>
288            </Entity>
289            <Entity name="GenomeSubset" keyType="string">
290                <Notes>A [i]genome subset[/i] is a named collection of genomes that participate
291                in a particular subsystem. The subset names are generally very short, non-unique
292                strings. The ID of the parent subsystem is prefixed to the subset ID in order
293                to make it unique.</Notes>
294            </Entity>
295            <Entity name="SSCell" keyType="hash-string">
296              <Notes>Part of the process of locating and assigning features is creating a spreadsheet of              <Notes>Part of the process of locating and assigning features is creating a spreadsheet of
297              genomes and roles to which features are assigned. A [i]spreadsheet cell[/i] represents one              genomes and roles to which features are assigned. A [i]spreadsheet cell[/i] represents one
298              of the positions on the spreadsheet.</Notes>              of the positions on the spreadsheet.</Notes>
# Line 270  Line 373 
373                      </Field>                      </Field>
374                  </Fields>                  </Fields>
375          </Entity>          </Entity>
376          <Entity name="Coupling" keyType="medium-string">          <Entity name="Coupling" keyType="id-string">
377              <Notes>A coupling is a relationship between two features. The features are              <Notes>A coupling is a relationship between two features. The features are
378              physically close on the contig, and there is evidence that they generally              physically close on the contig, and there is evidence that they generally
379              belong together. The key of this entity is formed by combining the coupled              belong together. The key of this entity is formed by combining the coupled
# Line 286  Line 389 
389                  </Field>                  </Field>
390              </Fields>              </Fields>
391          </Entity>          </Entity>
392          <Entity name="PCH" keyType="string">          <Entity name="PCH" keyType="hash-string">
393              <Notes>A PCH (physically close homolog) connects a clustering (which is a              <Notes>A PCH (physically close homolog) connects a clustering (which is a
394              pair of physically close features on a contig) to a second pair of physically              pair of physically close features on a contig) to a second pair of physically
395              close features that are similar to the first. Essentially, the PCH is a              close features that are similar to the first. Essentially, the PCH is a
# Line 328  Line 431 
431                  </IndexFields>                  </IndexFields>
432              </ToIndex>              </ToIndex>
433          </Relationship>          </Relationship>
434            <Relationship name="IsSynonymGroupFor" from="SynonymGroup" to="Feature" arity="1M">
435                <Notes>This relation connects a synonym group to the features that make it
436                up.</Notes>
437            </Relationship>
438            <Relationship name="HasFeature" from="Genome" to="Feature" arity="1M">
439                <Notes>This relationship connects a genome to all of its features. This
440                relationship is redundant in a sense, because the genome ID is part
441                of the feature ID; however, it makes the creation of certain queries more
442                convenient because you can drag in filtering information for a feature's
443                genome.</Notes>
444                <Fields>
445                    <Field name="type" type="key-string">
446                        <Notes>Feature type (eg. peg, rna)</Notes>
447                    </Field>
448                </Fields>
449                <ToIndex>
450                    <Notes>This index enables the application to view the features of a
451                    Genome sorted by type.</Notes>
452                    <IndexFields>
453                        <IndexField name="type" order="ascending" />
454                    </IndexFields>
455                </ToIndex>
456            </Relationship>
457          <Relationship name="IsEvidencedBy" from="Coupling" to="PCH" arity="1M">          <Relationship name="IsEvidencedBy" from="Coupling" to="PCH" arity="1M">
458              <Notes>This relationship connects a functional coupling to the physically              <Notes>This relationship connects a functional coupling to the physically
459              close homologs (PCHs) which affirm that the coupling is meaningful.</Notes>              close homologs (PCHs) which affirm that the coupling is meaningful.</Notes>
# Line 398  Line 524 
524              <Notes>This relationship connects subsystems to the genomes that use              <Notes>This relationship connects subsystems to the genomes that use
525              it. If the subsystem has been curated for the genome, then the subsystem's roles will also be              it. If the subsystem has been curated for the genome, then the subsystem's roles will also be
526              connected to the genome features through the [b]SSCell[/b] object.</Notes>              connected to the genome features through the [b]SSCell[/b] object.</Notes>
527                <Fields>
528                    <Field name="variant-code" type="key-string">
529                        <Notes>Code indicating the subsystem variant to which this
530                        genome belongs. Each subsystem can have multiple variants. A variant
531                        code of [b]-1[/b] indicates that the genome does not have a functional
532                        variant of the subsystem. A variant code of [b]0[/b] indicates that
533                        the genome's participation is considered iffy.</Notes>
534                    </Field>
535                </Fields>
536                <ToIndex>
537                    <Notes>This index enables the application to find all of the genomes using
538                    a subsystem in order by variant code, which is how we wish to display them
539                    in the spreadsheets.</Notes>
540                    <IndexFields>
541                        <IndexField name="variant-code" order="ascending" />
542                    </IndexFields>
543                </ToIndex>
544          </Relationship>          </Relationship>
545          <Relationship name="OccursInSubsystem" from="Role" to="Subsystem" arity="MM">          <Relationship name="OccursInSubsystem" from="Role" to="Subsystem" arity="MM">
546              <Notes>This relationship connects roles to the subsystems that implement them. </Notes>              <Notes>This relationship connects roles to the subsystems that implement them. </Notes>
547                <Fields>
548                    <Field name="column-number" type="int">
549                        <Notes>Column number for this role in the specified subsystem's
550                        spreadsheet.</Notes>
551                    </Field>
552                </Fields>
553                <ToIndex>
554                    <Notes>This index enables the application to see the subsystem roles
555                    in column order. The ordering of the roles is usually significant,
556                    so it is important to preserve it.</Notes>
557                    <IndexFields>
558                        <IndexField name="column-number" order="ascending" />
559                    </IndexFields>
560                </ToIndex>
561          </Relationship>          </Relationship>
562          <Relationship name="IsGenomeOf" from="Genome" to="SSCell" arity="1M">          <Relationship name="IsGenomeOf" from="Genome" to="SSCell" arity="1M">
563              <Notes>This relationship connects a subsystem's spreadsheet cell to the              <Notes>This relationship connects a subsystem's spreadsheet cell to the
# Line 413  Line 570 
570          <Relationship name="ContainsFeature" from="SSCell" to="Feature" arity="MM">          <Relationship name="ContainsFeature" from="SSCell" to="Feature" arity="MM">
571              <Notes>This relationship connects a subsystem's spreadsheet cell to the              <Notes>This relationship connects a subsystem's spreadsheet cell to the
572              features assigned to it.</Notes>              features assigned to it.</Notes>
573                <Fields>
574                    <Field name="cluster-number" type="int">
575                        <Notes>ID of this feature's cluster. Clusters represent families of
576                        related proteins participating in a subsystem.</Notes>
577                    </Field>
578                </Fields>
579            </Relationship>
580            <Relationship name="IsAComponentOf" from="Compound" to="Reaction" arity="MM">
581                <Notes>This relationship connects a reaction to the compounds that participate
582                in it.</Notes>
583                <Fields>
584                    <Field name="product" type="boolean">
585                        <Notes>TRUE if the compound is a product of the reaction, FALSE if
586                        it is a substrate. When a reaction is written on paper in
587                        chemical notation, the substrates are left of the arrow and the
588                        products are to the right. Sorting on this field will cause
589                        the substrates to appear first, followed by the products. If the
590                        reaction is reversible, then the notion of substrates and products
591                        is not at intuitive; however, a value here of FALSE still puts the
592                        compound left of the arrow and a value of TRUE still puts it to the
593                        right.</Notes>
594                    </Field>
595                    <Field name="stoichiometry" type="key-string">
596                        <Notes>Number of molecules of the compound that participate in a
597                        single instance of the reaction. For example, if a reaction
598                        produces two water molecules, the stoichiometry of water for the
599                        reaction would be two. When a reaction is written on paper in
600                        chemical notation, the stoichiometry is the number next to the
601                        chemical formula of the compound.</Notes>
602                    </Field>
603                    <Field name="main" type="boolean">
604                        <Notes>TRUE if this compound is one of the main participants in
605                        the reaction, else FALSE. It is permissible for none of the
606                        compounds in the reaction to be considered main, in which
607                        case this value would be FALSE for all of the relevant
608                        compounds.</Notes>
609                    </Field>
610                    <Field name="loc" type="key-string">
611                        <Notes>An optional character string that indicates the relative
612                        position of this compound in the reaction's chemical formula. The
613                        location affects the way the compounds present as we cross the
614                        relationship from the reaction side. The product/substrate flag
615                        comes first, then the value of this field, then the main flag.
616                        The default value is an empty string; however, the empty string
617                        sorts first, so if this field is used, it should probably be
618                        used for every compound in the reaction.</Notes>
619                    </Field>
620                    <Field name="discriminator" type="int">
621                        <Notes>A unique ID for this record. The discriminator does not
622                        provide any useful data, but it prevents identical records from
623                        being collapsed by the SELECT DISTINCT command used by ERDB to
624                        retrieve data.</Notes>
625                    </Field>
626                </Fields>
627                <ToIndex>
628                    <Notes>This index presents the compounds in the reaction in the
629                    order they should be displayed when writing it in chemical notation.
630                    All the substrates appear before all the products, and within that
631                    ordering, the main compounds appear first.</Notes>
632                    <IndexFields>
633                        <IndexField name="product" order="ascending" />
634                        <IndexField name="loc" order="ascending" />
635                        <IndexField name="main" order="descending" />
636                    </IndexFields>
637                </ToIndex>
638          </Relationship>          </Relationship>
639          <Relationship name="IsLocatedIn" from="Feature" to="Contig" arity="MM">          <Relationship name="IsLocatedIn" from="Feature" to="Contig" arity="MM">
640              <Notes>This relationship connects a feature to the contig segments that work together              <Notes>This relationship connects a feature to the contig segments that work together
# Line 512  Line 734 
734              If no trusted users are specified in the database, the user              If no trusted users are specified in the database, the user
735              also implicitly trusts the user [b]FIG[/b].</Notes>              also implicitly trusts the user [b]FIG[/b].</Notes>
736          </Relationship>          </Relationship>
737            <Relationship name="ConsistsOfRoles" from="RoleSubset" to="Role" arity="MM">
738                <Notes>This relationship connects a role subset to the roles that it covers.
739                A subset is, essentially, a named group of roles belonging to a specific
740                subsystem, and this relationship effects that. Note that will a role
741                may belong to many subsystems, a subset belongs to only one subsystem,
742                and all roles in the subset must have that subsystem in common.</Notes>
743            </Relationship>
744            <Relationship name="ConsistsOfGenomes" from="GenomeSubset" to="Genome" arity="MM">
745                <Notes>This relationship connects a subset to the genomes that it covers.
746                A subset is, essentially, a named group of genomes participating in a specific
747                subsystem, and this relationship effects that. Note that while a genome
748                may belong to many subsystems, a subset belongs to only one subsystem,
749                and all genomes in the subset must have that subsystem in common.</Notes>
750            </Relationship>
751            <Relationship name="HasRoleSubset" from="Subsystem" to="RoleSubset" arity="1M">
752                <Notes>This relationship connects a subsystem to its constituent
753                role subsets. Note that some roles in a subsystem may not belong to a
754                subset, so the relationship between roles and subsystems cannot be
755                derived from the relationships going through the subset.</Notes>
756            </Relationship>
757            <Relationship name="HasGenomeSubset" from="Subsystem" to="GenomeSubset" arity="1M">
758                <Notes>This relationship connects a subsystem to its constituent
759                genome subsets. Note that some genomes in a subsystem may not belong to a
760                subset, so the relationship between genomes and subsystems cannot be
761                derived from the relationships going through the subset.</Notes>
762            </Relationship>
763            <Relationship name="Catalyzes" from="Role" to="Reaction" arity="MM">
764                <Notes>This relationship connects a role to the reactions it catalyzes.
765                The purpose of a role is to create proteins that trigger certain
766                chemical reactions. A single reaction can be triggered by many roles,
767                and a role can trigger many reactions.</Notes>
768            </Relationship>
769      </Relationships>      </Relationships>
770  </Database>  </Database>

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.29

MCS Webmaster
ViewVC Help
Powered by ViewVC 1.0.3