Mapping Image Structures

From DLXS Documentation

(Difference between revisions)
Jump to: navigation, search
Current revision (14:11, 31 August 2007) (edit) (undo)
(→University of Michigan, [http://images.umdl.umich.edu/a/apis/ Advanced Papyrological Information System])
 
(5 intermediate revisions not shown.)
Line 1: Line 1:
[[DLXS Wiki|Main Page]] > [[Mounting Collections: Class-specific Steps]] > [[Mounting an Image Class Collection]] > Mapping Image Structures
[[DLXS Wiki|Main Page]] > [[Mounting Collections: Class-specific Steps]] > [[Mounting an Image Class Collection]] > Mapping Image Structures
 +
 +
 +
==Overview==
<p>Most often each record of a database has a single digital image associated
<p>Most often each record of a database has a single digital image associated
Line 27: Line 30:
<p>Note that structures apply to entire collections and cannot vary per record.</p>
<p>Note that structures apply to entire collections and cannot vary per record.</p>
-
<h2>Definitions</h2>
+
==Definitions==
<p>A <b>filename field</b> is a field of a database that
<p>A <b>filename field</b> is a field of a database that
Line 44: Line 47:
<table border="2" cellpadding="5" cellspacing="0">
<table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
   <tr>
   <tr>
       <th>
       <th>
Line 90: Line 92:
       </td>
       </td>
   </tr>
   </tr>
-
</tbody>
 
</table>
</table>
Line 105: Line 106:
               <th>
               <th>
                   <p >Image Filename Field 1</p>
                   <p >Image Filename Field 1</p>
-
 
               </th>
               </th>
               <td>
               <td>
Line 114: Line 114:
               <th>
               <th>
                   <p >Image Caption Field 1</p>
                   <p >Image Caption Field 1</p>
-
 
+
</th>
-
              </th>
+
               <td>
               <td>
-
                  <p>Front view of sculpture (overview)</p>
+
<p>Front view of sculpture (overview)</p>
-
              </td>
+
</td>
-
            </tr>
+
</tr>
-
    </tbody>
+
</table>
-
        </table>
+
<br>
-
        <br>
+
<table border="2" cellpadding="5" cellspacing="0">
-
 
+
-
        <table border="2" cellpadding="5" cellspacing="0">
+
-
    <tbody>
+
             <tr>
             <tr>
               <th>
               <th>
Line 167: Line 163:
       </td>
       </td>
-
 
   </tr>
   </tr>
-
 
</table>
</table>
Line 190: Line 184:
caption fields that together make
caption fields that together make
up a structure. A record can have more than one structure. This
up a structure. A record can have more than one structure. This
-
<a href="http://images.umdl.umich.edu/cgi/i/image/image-idx?evl=other-views;lasttype=boolean;view=entry;subview=detail;cc=apis;entryid=X-2544;viewid=1;sstrt=1521;hits=2083;q1=bmp;op2=And;op3=And;rgn1=All+Categories;rgn2=All+Categories;rgn3=All+Categories;c=apis;thsz=12;txsz=100;slsz=1">papyrus
+
[http://images.umdl.umich.edu/cgi/i/image/image-idx?evl=other-views;lasttype=boolean;view=entry;subview=detail;cc=apis;entryid=X-2544;viewid=1;sstrt=1521;hits=2083;q1=bmp;op2=And;op3=And;rgn1=All+Categories;rgn2=All+Categories;rgn3=All+Categories;c=apis;thsz=12;txsz=100;slsz=1 papyrus example] has two structures. The first structure ties all of the
-
example</a> has two structures. The first structure ties all of the
+
-
 
+
&quot;front&quot; views together, and the second ties all of the &quot;back&quot; views
&quot;front&quot; views together, and the second ties all of the &quot;back&quot; views
together. This causes the structural display online of thumbnail
together. This causes the structural display online of thumbnail
Line 198: Line 190:
summary to back detail. This flow can be changed through configuration.</p>
summary to back detail. This flow can be changed through configuration.</p>
-
 
+
==Rules==
-
<h2>Rules</h2>
+
<ol>
<ol>
   <li>A record may have many filename fields, which may have repetitions.</li>
   <li>A record may have many filename fields, which may have repetitions.</li>
Line 227: Line 218:
   of the image caption field is associated with each of the
   of the image caption field is associated with each of the
   repetitions of the image filename field.</li>
   repetitions of the image filename field.</li>
-
 
    
    
   <li>Structures can only be specified at the collection level. It
   <li>Structures can only be specified at the collection level. It
Line 234: Line 224:
</ol>
</ol>
-
 
+
==Syntax==
-
 
+
-
<h2>Syntax</h2>
+
<p>Simple situations (one image per record) can be handled with a simple  
<p>Simple situations (one image per record) can be handled with a simple  
Line 253: Line 241:
<table border="2" cellpadding="5" cellspacing="0">
<table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
   <tr>
   <tr>
       <th>
       <th>
Line 285: Line 272:
       summary images.</p></td>
       summary images.</p></td>
   </tr>
   </tr>
-
</tbody>
 
</table>
</table>
Line 292: Line 278:
<table border="2" cellpadding="5" cellspacing="0">
<table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
   <tr>
   <tr>
       <th>
       <th>
Line 362: Line 347:
       </td>
       </td>
   </tr>
   </tr>
-
</tbody></table>
+
</table>
Line 381: Line 366:
   with the  X attribute, allow for a matrix of images to be stored
   with the  X attribute, allow for a matrix of images to be stored
   in the data.</p>
   in the data.</p>
 +
<p><b>X Attribute (not configurable)</b></p>
<p><b>X Attribute (not configurable)</b></p>
<p>The fifth attribute, &quot;X&quot;, is not configurable. It is calculated as the data
<p>The fifth attribute, &quot;X&quot;, is not configurable. It is calculated as the data
Line 390: Line 376:
   each repetition represents a column (X) and each field a row (Y).</p>
   each repetition represents a column (X) and each field a row (Y).</p>
<p>The Y attribute must be specified in the configuration file. The X attribute,
<p>The Y attribute must be specified in the configuration file. The X attribute,
-
   on the other hand,  is calculuated automatically at the time of loading and
+
   on the other hand,  is calculated automatically at the time of loading and
-
   depends on the number of repetitions there are. A good example is
+
   depends on the number of repetitions there are. A good example is [http://images.umdl.umich.edu/cgi/i/image/image-idx?evl=other-views;view=entry;subview=detail;entryid=x-2881;viewid=658R.BMP;c=apis;cc=apis;corig=apis;lasttype=boolean;lastview=thumbnail this papyrus example].</p>  
-
  <a href="http://images.umdl.umich.edu/cgi/i/image/image-idx?evl=other-views;view=entry;subview=detail;entryid=x-2881;viewid=658R.BMP;c=apis;cc=apis;corig=apis;lasttype=boolean;lastview=thumbnail">this
+
-
  papyrus example</a>.</p>  
+
<table border="2" cellpadding="5" cellspacing="0">
<table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
   <tr>
   <tr>
       <th colspan="2">
       <th colspan="2">
Line 410: Line 393:
       </td>
       </td>
       <td>
       <td>
-
         <table border="2" cellpadding="5" cellspacing="0">
+
         <table border="2" cellpadding="5" cellspacing="0">      
-
<tbody>       
+
   <tr>
   <tr>
               <td>
               <td>
Line 421: Line 403:
               </td>
               </td>
             </tr>
             </tr>
-
</tbody>
 
         </table>
         </table>
          
          
Line 432: Line 413:
       </td>
       </td>
       <td>
       <td>
-
         <table border="2" cellpadding="5" cellspacing="0">
+
         <table border="2" cellpadding="5" cellspacing="0">      
-
<tbody>       
+
   <tr>
   <tr>
               <td>
               <td>
Line 443: Line 423:
               </td>
               </td>
             </tr>
             </tr>
-
</tbody>
 
         </table>
         </table>
          
          
       </td>
       </td>
   </tr>
   </tr>
-
 
-
</tbody>
 
</table>
</table>
Line 459: Line 436:
<p>For an image filename field:  
<p>For an image filename field:  
-
<br/>
 
IC_fn-type=summ.face=front.stid=1.y=1</p><p>For the caption field that corresponds with the above filename field:  
IC_fn-type=summ.face=front.stid=1.y=1</p><p>For the caption field that corresponds with the above filename field:  
-
<br/>
 
IC_vi-type=summ.face=front.stid=1.y=1</p>
IC_vi-type=summ.face=front.stid=1.y=1</p>
Line 473: Line 448:
IC_vi-type=summ.face=front.stid=1.y=1:::captionfield</p>
IC_vi-type=summ.face=front.stid=1.y=1:::captionfield</p>
<p>(filenamefield and captionfield need to be actual fields)</p>
<p>(filenamefield and captionfield need to be actual fields)</p>
-
<h2>Examples</h2>
 
-
<h3>University of Michigan, <a href="http://images.umdl.umich.edu/b/bhl/">Bentley
+
==Examples==
-
Historical Library</a>.</h3>
+
-
<p>View an <a href="http://images.umdl.umich.edu/cgi/i/image/image-idx?lasttype=simple;view=entry;subview=detail;cc=bhl;entryid=X-bl000037;viewid=1;sstrt=604;hits=1152;q1=Bentley;rgn1=All+Categories;c=bhl;med=1;thsz=12;txsz=50;slsz=1">example record</a> online.</p>
+
===University of Michigan, Bentley Historical Library===
 +
 
 +
[http://images.umdl.umich.edu/b/bhl/ Bentley Historical Library]
 +
 
 +
<p>View an [http://images.umdl.umich.edu/cgi/i/image/image-idx?lasttype=simple;view=entry;subview=detail;cc=bhl;entryid=X-bl000037;viewid=1;sstrt=604;hits=1152;q1=Bentley;rgn1=All+Categories;c=bhl;med=1;thsz=12;txsz=50;slsz=1 example record] online.</p>
  <table border="2" cellpadding="5" cellspacing="0">
  <table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
    <tr>
    <tr>
       <td>
       <td>
Line 518: Line 494:
       </td>
       </td>
   </tr>
   </tr>
-
</tbody>
+
 
</table>
</table>
Line 525: Line 501:
<table border="2" cellpadding="5" cellspacing="0">
<table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
   <tr>
   <tr>
       <th>
       <th>
Line 570: Line 545:
       <td>IC_vi:::bhl_it</td>
       <td>IC_vi:::bhl_it</td>
   </tr>
   </tr>
-
</tbody>
 
</table>
</table>
Line 576: Line 550:
<p>How it looks in Collmgr <strong>admin_field_maps</strong>...</p>
<p>How it looks in Collmgr <strong>admin_field_maps</strong>...</p>
-
<pre>IC_fn:::bhl_itno<br>IC_vi:::bhl_it</pre>
+
<pre>IC_fn:::bhl_itno
 +
IC_vi:::bhl_it</pre>
-
<h3>University of Michigan, <a href="http://images.umdl.umich.edu/m/musart/">Museum
+
===University of Michigan, Museum of Art.===
-
of Art</a>.</h3>
+
-
<p>View an <a href="http://images.umdl.umich.edu/cgi/i/image/image-idx?lasttype=simple;view=entry;subview=detail;cc=musart;entryid=X-1942.6;viewid=12;sstrt=1;hits=1;q1=Processional+Cross;rgn1=All+Categories;c=musart;thsz=12;txsz=50;slsz=1"> example record</a> online.</p>
+
[http://images.umdl.umich.edu/m/musart/ Museum of Art]
 +
 
 +
<p>View an [http://images.umdl.umich.edu/cgi/i/image/image-idx?lasttype=simple;view=entry;subview=detail;cc=musart;entryid=X-1942.6;viewid=12;sstrt=1;hits=1;q1=Processional+Cross;rgn1=All+Categories;c=musart;thsz=12;txsz=50;slsz=1 example record online.]</p>
  <table border="2" cellpadding="5" cellspacing="0">
  <table border="2" cellpadding="5" cellspacing="0">
-
<tbody>
 
   <tr>
   <tr>
Line 643: Line 618:
       <td>IC_vi-type=det.face=front.stid=2.y=1</td>
       <td>IC_vi-type=det.face=front.stid=2.y=1</td>
     </tr>
     </tr>
-
</tbody>
 
</table>
</table>
Line 654: Line 628:
ic_vi-type=det.face=unspec.stid=2.y=1:::musart_rimc
ic_vi-type=det.face=unspec.stid=2.y=1:::musart_rimc
     </pre>
     </pre>
-
<h3>University of Michigan, <a href="http://images.umdl.umich.edu/a/apis/">Advanced Papyrological Information System</a></h3>
 
-
<p>View the <a href="http://images.umdl.umich.edu/cgi/i/image/image-idx?evl=other-views;lasttype=boolean;view=entry;subview=detail;cc=apis;entryid=X-2544;viewid=1;sstrt=1521;hits=2083;q1=bmp;op2=And;op3=And;rgn1=All+Categories;rgn2=All+Categories;rgn3=All+Categories;c=apis;thsz=12;txsz=100;slsz=1">example
+
 
-
    record</a> online. Note that the apis structure has the potential to have
+
===University of Michigan, Advanced Papyrological Information System===
 +
 
 +
[http://images.umdl.umich.edu/a/apis/ Advanced Papyrological Information System]
 +
 
 +
<p>View the [http://images.umdl.umich.edu/cgi/i/image/image-idx?evl=other-views;lasttype=boolean;view=entry;subview=detail;cc=apis;entryid=X-2544;viewid=1;sstrt=1521;hits=2083;q1=bmp;op2=And;op3=And;rgn1=All+Categories;rgn2=All+Categories;rgn3=All+Categories;c=apis;thsz=12;txsz=100;slsz=1 example record] online. Note that the apis structure has the potential to have
     a large number of images, but the example record happens to only have 6.</p>
     a large number of images, but the example record happens to only have 6.</p>
<table border="2" cellpadding="5" cellspacing="0">
<table border="2" cellpadding="5" cellspacing="0">
-
  <tbody>
 
     <tr>
     <tr>
       <td><strong>Field Name</strong></td>
       <td><strong>Field Name</strong></td>
Line 679: Line 655:
     <tr>
     <tr>
       <td><p>Full SizeFront R1 (apis_fsfr1)<br>
       <td><p>Full SizeFront R1 (apis_fsfr1)<br>
-
          <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 696: Line 672:
     <tr>
     <tr>
       <td>Full SizeFront R2 (apis_fsfr2)<br>
       <td>Full SizeFront R2 (apis_fsfr2)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
Line 713: Line 689:
     <tr>
     <tr>
       <td>Full SizeFront R3 (apis_fsfr3)<br>
       <td>Full SizeFront R3 (apis_fsfr3)<br>
-
 
+
<span class="style9">Inventory Number (apis_inv)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 730: Line 705:
       <td>Full SizeFront R4 (apis_fsfr4)<br>
       <td>Full SizeFront R4 (apis_fsfr4)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 746: Line 721:
       <td>_600DPIFront R1 (apis_600fr1)<br>
       <td>_600DPIFront R1 (apis_600fr1)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 762: Line 737:
       <td><p>_600DPIFront R2 (apis_600fr2)<br>
       <td><p>_600DPIFront R2 (apis_600fr2)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
   Section/Side (apis_ss)</span></p>
   Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 778: Line 753:
     <tr>
     <tr>
-
       <td><p>_600DPIFront R3 (apis_600fr3)<br><span class="style9">Inventory Number (apis_inv)<br>
+
       <td><p>_600DPIFront R3 (apis_600fr3)<br>
 +
<span class="style9">Inventory Number (apis_inv)<br>
   Section/Side (apis_ss)</span></p></td>
   Section/Side (apis_ss)</span></p></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 795: Line 771:
     <tr>
     <tr>
       <td>_600DPIFront R4 (apis_600fr4)<br>
       <td>_600DPIFront R4 (apis_600fr4)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 811: Line 787:
     </tr>
     </tr>
     <tr>
     <tr>
-
       <td><p>_600DPIFront R5 (apis_600fr5)<br><span class="style9">Inventory Number (apis_inv)<br>
+
       <td><p>_600DPIFront R5 (apis_600fr5)<br>
 +
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p></td>
Section/Side (apis_ss)</span></p></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 826: Line 803:
     </tr>
     </tr>
     <tr>
     <tr>
-
       <td><p>_600DPIFront R6 (apis_600fr6)<br><span class="style9">Inventory Number (apis_inv)<br>
+
       <td><p>_600DPIFront R6 (apis_600fr6)<br>
 +
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p></td>
Section/Side (apis_ss)</span></p></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 841: Line 819:
     <tr>
     <tr>
-
       <td><p>_600DPIFront R7 (apis_600fr7)<br><span class="style9">Inventory Number (apis_inv)<br>
+
       <td><p>_600DPIFront R7 (apis_600fr7)<br>
 +
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p></td>
Section/Side (apis_ss)</span></p></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 857: Line 836:
     <tr>
     <tr>
       <td>_600DPIFront R8 (apis_600fr8)<br>
       <td>_600DPIFront R8 (apis_600fr8)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 874: Line 853:
     <tr>
     <tr>
       <td><p>Full SizeBack R1 (apis_fsbr1)<br>
       <td><p>Full SizeBack R1 (apis_fsbr1)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 891: Line 870:
     <tr>
     <tr>
       <td>Full SizeBack R2 (apis_fsbr2)<br>
       <td>Full SizeBack R2 (apis_fsbr2)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style2">Caption</span></td>
       <td><span class="style2">Caption</span></td>
Line 908: Line 887:
     <tr>
     <tr>
       <td><p>Full SizeBack R3 (apis_fsbr3)<br>
       <td><p>Full SizeBack R3 (apis_fsbr3)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
Line 927: Line 906:
       <td><p>Full SizeBack R4 (apis_fsbr4)<br>
       <td><p>Full SizeBack R4 (apis_fsbr4)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 945: Line 924:
     <tr>
     <tr>
       <td><p>_600DPIBack R1 (apis_600br1)<br>
       <td><p>_600DPIBack R1 (apis_600br1)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
   Section/Side (apis_ss)</span></p>
   Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 977: Line 956:
     <tr>
     <tr>
       <td><p>_600DPIBack R2 (apis_600br3)<br>
       <td><p>_600DPIBack R2 (apis_600br3)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 995: Line 974:
     <tr>
     <tr>
       <td><p>_600DPIBack R2 (apis_600br4)<br>
       <td><p>_600DPIBack R2 (apis_600br4)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 1,056: Line 1,035:
       <td><p>_600DPIBack R2 (apis_600br8)<br>
       <td><p>_600DPIBack R2 (apis_600br8)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></p>
Section/Side (apis_ss)</span></p>
       </td>
       </td>
Line 1,073: Line 1,052:
     <tr>
     <tr>
       <td>alternativeImages (apis_alt)<br>
       <td>alternativeImages (apis_alt)<br>
-
        <span class="style9">Inventory Number (apis_inv)<br>
+
<span class="style9">Inventory Number (apis_inv)<br>
Section/Side (apis_ss)</span></td>
Section/Side (apis_ss)</span></td>
       <td><span class="style1"><span class="style2">Caption</span></span></td>
       <td><span class="style1"><span class="style2">Caption</span></span></td>
Line 1,081: Line 1,060:
       </td>
       </td>
     </tr>
     </tr>
-
  </tbody>
 
</table>
</table>
 +
 +
<p>How it looks in CollMgr <strong>admin_field_maps</strong>...</p>
<p>How it looks in CollMgr <strong>admin_field_maps</strong>...</p>
<pre>ic_fn-type=summ.face=front.stid=1.y=1:::apis_fsfr1
<pre>ic_fn-type=summ.face=front.stid=1.y=1:::apis_fsfr1

Current revision

Main Page > Mounting Collections: Class-specific Steps > Mounting an Image Class Collection > Mapping Image Structures


Contents

[edit] Overview

Most often each record of a database has a single digital image associated with it. In such situations, configuration is relatively simple and described fully in the data preparation documentation. It is important to read the general data preparation documenation first before proceeding with more complicated structures.

MySQL: Image Class Data Loading: MySQL

The instructions in this document are for less common situations. When a record has multiple images associated with it, for example, several views of an sculpture. Each of the views might be of equal standing, or, perhaps there is one that alone does a reasonable job of summarizing the object, while the others provide valuable details difficult to see in the summary. These are just a couple of the possible structural configurations one might encounter.

The key factors for the accurate representation of image structures in the Iimage Class are:

  • Representation of the relationship between image filenames and associated image captions within the fields of a record.
  • Mapping of the fields for Image Class ingest.

Note that structures apply to entire collections and cannot vary per record.

[edit] Definitions

A filename field is a field of a database that contains image (or other media) filenames and nothing else. A filename field may have any number of repetitions.

A caption field is a field of a database that contains text that typically describes the image in a very specific way. For example, "View of steeple from the north." A record with multiple image filenames will often have a corresponding caption for each.

A record with a filename field that has 5 repetitions will often have a corresponding image caption field with 5 repetitions. The values in each are synchronized.

Image Filename Field

image01.tif

image02.tif

image03.tif

image04.tif

image05.tif

Image Caption Field

View from the north

View from the south

View from the east

View from the west

View from the sky


A record may also have multiple filename fields, and multiple image caption fields. Together they might represent a hierarchical structure.

Image Filename Field 1

image01.tif

Image Caption Field 1

Front view of sculpture (overview)


Image Filename Field 2

imageF.tif

imageB.tif

imageR.tif

imageL.tif

Image Caption Field 2

Front view of sculpture (detail)

Back of sculpture

Right side of sculpture

Left side of Sculpture


To get an idea of a more complicated example, look at the this example from the Advanced Papyrological Information System at the University of Michigan.

Administrative metadata field mappings are used to identify filename and caption fields for the purpose of loading data. In addition to the very basic mappings IC_fn and IC_vi there is a complex set of mappings that can be used to represent complex structures. Generically the new mappings are referred to as IC_fn* and IC_vi* (the "*" suggests a longer, more complex, mapping).

A structure is a group filename and caption fields that together make up a structure. A record can have more than one structure. This papyrus example has two structures. The first structure ties all of the "front" views together, and the second ties all of the "back" views together. This causes the structural display online of thumbnail images to flow from front summary images to front detail to back summary to back detail. This flow can be changed through configuration.

[edit] Rules

  1. A record may have many filename fields, which may have repetitions.
  2. Each filename field must be mapped to only one administrative metadata filename mapping (IC_fn, IC_fn-st).
  3. A record may have many caption fields, and the fields may have repetitions.
  4. Each caption field may be mapped with any number of administrative metadata caption mappings (IC_vi, IC_vi-st).
  5. Each caption field mapped to plain IC_vi will be associated with all image filename fields mapped to IC_fn (but not fields mapped to IC_fn-st).
  6. Fields mapped to IC_vi or IC_vi-st may have one or more repetitions, which may be independent of the number of repetitions in the associated IC_fn or IC_fn-st mapped field.
  7. If the filename field has repetitions but the corresponding image caption field does not, then the single value of the image caption field is associated with each of the repetitions of the image filename field.
  8. Structures can only be specified at the collection level. It is not currently possible to have the structure change per record.

[edit] Syntax

Simple situations (one image per record) can be handled with a simple mapping of the filename field to "IC_fn" and the caption field to "IC_vi".

More complex situations rely on the structural mappings so far referred to as IC_fn* and IC_vi*. These are not the actual mappings, they are only generic and simplified representations to aid discussion. The actual mappings consist of a base (IC_fn and IC_vi) plus four attributes. When structural mappings are used, all four attributes are required to have values.

The base: IC_fn and IC_vi

Type Attribute

Type Attribute Value

Description

type="summ"

summary

For fields that represent images that summarize all the images of the record or are otherwiser representative of the entire record.

type="det"

detail

For fields that represent images that provide greater detail or extended view than what is depicted in the summary images.


Face Attribute

Face Attribute Value

Description

face="front"

For fields that represent images that provide views of the front.

face=" back"

For fields that represent images that provide views of the back.

face=" right"

For fields that represent images that provide views of the right.

face=" left"

For fields that represent images that provide views of the left.

face=" top"

For fields that represent images that provide views of the top.

face=" bottom"

For fields that represent images that provide views of the bottom.


Structural ID (STID) Attribute

stid=1 .. N

Each structure must be given a numeric ID. Be sure to read the definition of structure given above. Structural IDs can be assigned somewhat arbitrarily, though there needs to be at least one.

Y Attribute

y=1 .. N

Sometimes the images of a record represent cells of a two dimensional matrix, which can also be thought of as a table or tiles. The Y attribute, together with the X attribute, allow for a matrix of images to be stored in the data.

X Attribute (not configurable)

The fifth attribute, "X", is not configurable. It is calculated as the data is loaded based on the number of repetitions.

 

Database systems typically only offer the ability to have field repetitions in one dimension. That is, a 1xN field of repetitions can be built. To simulate a two dimensional matrix involves working with multiple repeating fields where each repetition represents a column (X) and each field a row (Y).

The Y attribute must be specified in the configuration file. The X attribute, on the other hand, is calculated automatically at the time of loading and depends on the number of repetitions there are. A good example is this papyrus example.


These two discrete fields can be combined to form a two dimensional matrix.

Image Filename Field 1 (2 repetitions)

X=1, Y=1

X=2, Y=1

Image Filename Field 2 (2 repetitions)

X=1, Y=2

X=2, Y=2


Combining the Base with the Attributes

All attributes are required in all cases and the components must be joined with a period (".") as demonstrated below.

For an image filename field: IC_fn-type=summ.face=front.stid=1.y=1

For the caption field that corresponds with the above filename field: IC_vi-type=summ.face=front.stid=1.y=1

Configuring the Fields

Once the structural attributes are determined the mappings for the filename and caption fields are entered into CollMgr (MySQL) or the collection configuration (XPat). Mapping is handled similarly to all other field mapping, the only difference being the long length of structural attributes.

In Collmgr the example above looks like...

IC_fn-type=summ.face=front.stid=1.y=1:::filenamefield
IC_vi-type=summ.face=front.stid=1.y=1:::captionfield

(filenamefield and captionfield need to be actual fields)

[edit] Examples

[edit] University of Michigan, Bentley Historical Library

Bentley Historical Library

View an example record online.

Image Filename Fields per Record

1

Image Filename Field Repetitions

1

Image Caption Fields per Record

1

Image Caption Field Repetitions

1


 

Field Name

Field Type

 Repetitions

Administrative Metadata Mapping

 Collmgr admin_field_maps

Item Number (bhl_itno)

Filename

 1

IC_fn

 IC_fn:::bhl_itno

Item Title (bhl_it)

Caption

 1

IC_vi

 IC_vi:::bhl_it


How it looks in Collmgr admin_field_maps...

IC_fn:::bhl_itno
IC_vi:::bhl_it

[edit] University of Michigan, Museum of Art.

Museum of Art

View an example record online.


Field Name

Field Type

Repetitions

 Administrative Metadata Mapping
ShortName (musart_sn)

Filename

1

 IC_fn-type=summ.face=front.stid=1.y=1
Details (musart_rim)

Filename

20

 IC_fn-type=det.face=front.stid=2.y=1
Title (musart_ti)

Caption

1

 IC_vi-type=summ.face=front.stid=1.y=1
Details_caption (musart_rimc)

Caption

20

 IC_vi-type=det.face=front.stid=2.y=1


How it looks in CollMgr admin_field_maps...

ic_vi:::musart_ti
ic_fn-type=summ.face=unspec.stid=1.y=1:::musart_sn
ic_fn-type=det.face=unspec.stid=2.y=1:::musart_rim
ic_vi-type=det.face=unspec.stid=2.y=1:::musart_rimc


[edit] University of Michigan, Advanced Papyrological Information System

Advanced Papyrological Information System

View the example record online. Note that the apis structure has the potential to have a large number of images, but the example record happens to only have 6.

Field Name

Field Type

Repetitions

 Administrative Metadata Mapping
Full SizeFront R1 (apis_fsfr1)

Filename

2

 ic_fn-type=summ.face=front.stid=1.y=1

Full SizeFront R1 (apis_fsfr1)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 2 ic_vi-type=summ.face=front.stid=1.y=1
Full SizeFront R2 (apis_fsfr2) Filename 2 ic_fn-type=summ.face=front.stid=1.y=2
Full SizeFront R2 (apis_fsfr2)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 2

ic_vi-type=summ.face=front.stid=1.y=2
Full SizeFront R3 (apis_fsfr3) Filename 2 ic_fn-type=summ.face=front.stid=1.y=3
Full SizeFront R3 (apis_fsfr3)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 2 ic_vi-type=summ.face=front.stid=1.y=3
Full SizeFront R4 (apis_fsfr4) Filename 2 ic_fn-type=summ.face=front.stid=1.y=4
Full SizeFront R4 (apis_fsfr4)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 2 ic_vi-type=summ.face=front.stid=1.y=4
_600DPIFront R1 (apis_600fr1) Filename 8 ic_fn-type=det.face=front.stid=1.y=1
_600DPIFront R1 (apis_600fr1)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 8 ic_vi-type=det.face=front.stid=1.y=1
_600DPIFront R2 (apis_600fr2) Filename 8 ic_fn-type=det.face=front.stid=1.y=2

_600DPIFront R2 (apis_600fr2)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=front.stid=1.y=2
_600DPIFront R3 (apis_600fr3) Filename 8 ic_fn-type=det.face=front.stid=1.y=3

_600DPIFront R3 (apis_600fr3)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8

ic_vi-type=det.face=front.stid=1.y=3
_600DPIFront R4 (apis_600fr4) Filename 8 ic_fn-type=det.face=front.stid=1.y=4
_600DPIFront R4 (apis_600fr4)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 8

ic_vi-type=det.face=front.stid=1.y=4
_600DPIFront R5 (apis_600fr5) Filename 8 ic_fn-type=det.face=front.stid=1.y=5

_600DPIFront R5 (apis_600fr5)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=front.stid=1.y=5
_600DPIFront R6 (apis_600fr6) Filename 8 ic_fn-type=det.face=front.stid=1.y=6

_600DPIFront R6 (apis_600fr6)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=front.stid=1.y=6
_600DPIFront R7 (apis_600fr7) Filename 8 ic_fn-type=det.face=front.stid=1.y=7

_600DPIFront R7 (apis_600fr7)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=front.stid=1.y=7
_600DPIFront R8 (apis_600fr8) Filename 8 ic_fn-type=det.face=front.stid=1.y=8
_600DPIFront R8 (apis_600fr8)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 8

ic_vi-type=det.face=front.stid=1.y=8
Full SizeBack R1 (apis_fsbr1) Filename 2 ic_fn-type=summ.face=back.stid=2.y=1

Full SizeBack R1 (apis_fsbr1)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 2 ic_vi-type=summ.face=back.stid=2.y=1
Full SizeBack R2 (apis_fsbr2) Filename 2 ic_fn-type=summ.face=back.stid=2.y=2
Full SizeBack R2 (apis_fsbr2)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 2

ic_vi-type=summ.face=back.stid=2.y=2
Full SizeBack R3 (apis_fsbr3) Filename 2 ic_fn-type=summ.face=back.stid=2.y=3

Full SizeBack R3 (apis_fsbr3)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 2

ic_vi-type=summ.face=back.stid=2.y=3
Full SizeBack R4 (apis_fsbr4) Filename 2 ic_fn-type=summ.face=back.stid=2.y=4

Full SizeBack R4 (apis_fsbr4)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 2

ic_vi-type=summ.face=back.stid=2.y=4
_600DPIBack R1 (apis_600br1) Filename 8 ic_fn-type=det.face=back.stid=1.y=1

_600DPIBack R1 (apis_600br1)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=back.stid=1.y=1
_600DPIBack R2 (apis_600br2) Filename 8 ic_fn-type=det.face=back.stid=1.y=2
_600DPIBack R2 (apis_600br2) Caption 8

ic_vi-type=det.face=back.stid=1.y=2
_600DPIBack R2 (apis_600br3) Filename 8 ic_fn-type=det.face=back.stid=1.y=3

_600DPIBack R2 (apis_600br3)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8

ic_vi-type=det.face=back.stid=1.y=3
_600DPIBack R2 (apis_600br4) Filename 8 ic_fn-type=det.face=back.stid=1.y=4

_600DPIBack R2 (apis_600br4)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=back.stid=1.y=4
_600DPIBack R2 (apis_600br5) Filename 8 ic_fn-type=det.face=back.stid=1.y=5
_600DPIBack R2 (apis_600br5) Caption 8 ic_vi-type=det.face=back.stid=1.y=5
_600DPIBack R2 (apis_600br6) Filename 8 ic_fn-type=det.face=back.stid=1.y=6
_600DPIBack R2 (apis_600br6) Caption 8

ic_vi-type=det.face=back.stid=1.y=6
_600DPIBack R2 (apis_600br7) Filename 8 ic_fn-type=det.face=back.stid=1.y=7
_600DPIBack R2 (apis_600br7) Caption 8

ic_vi-type=det.face=back.stid=1.y=7
_600DPIBack R2 (apis_600br8) Filename 8 ic_fn-type=det.face=back.stid=1.y=8

_600DPIBack R2 (apis_600br8)

Inventory Number (apis_inv)

Section/Side (apis_ss)

 Caption 8 ic_vi-type=det.face=back.stid=1.y=8
alternativeImages (apis_alt) Filename 1 ic_fn-type=det.face=unspec.stid=3.y=1
alternativeImages (apis_alt)

Inventory Number (apis_inv)

Section/Side (apis_ss)		 Caption 1

ic_vi-type=det.face=unspec.stid=3.y=1


How it looks in CollMgr admin_field_maps...

ic_fn-type=summ.face=front.stid=1.y=1:::apis_fsfr1
   ic_fn-type=summ.face=front.stid=1.y=2:::apis_fsfr2
   ic_fn-type=summ.face=front.stid=1.y=3:::apis_fsfr3
   ic_fn-type=summ.face=front.stid=1.y=4:::apis_fsfr4
   ic_vi-type=summ.face=front.stid=1.y=1:::apis_fsfr1 apis_inv apis_inv apis_ss
   ic_vi-type=summ.face=front.stid=1.y=2:::apis_fsfr2 apis_inv apis_ss
   ic_vi-type=summ.face=front.stid=1.y=3:::apis_fsfr3 apis_inv apis_ss
   ic_vi-type=summ.face=front.stid=1.y=4:::apis_fsfr4 apis_inv apis_ss
   ic_fn-type=det.face=front.stid=1.y=1:::apis_600fr1
   ic_fn-type=det.face=front.stid=1.y=2:::apis_600fr2
   ic_fn-type=det.face=front.stid=1.y=3:::apis_600fr3
   ic_fn-type=det.face=front.stid=1.y=4:::apis_600fr4
   ic_fn-type=det.face=front.stid=1.y=5:::apis_600fr5
   ic_fn-type=det.face=front.stid=1.y=6:::apis_600fr6
   ic_fn-type=det.face=front.stid=1.y=7:::apis_600fr7
   ic_fn-type=det.face=front.stid=1.y=8:::apis_600fr8
   ic_vi-type=det.face=front.stid=1.y=1:::apis_600fr1 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=2:::apis_600fr2 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=3:::apis_600fr3 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=4:::apis_600fr4 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=5:::apis_600fr5 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=6:::apis_600fr6 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=7:::apis_600fr7 apis_inv apis_ss
   ic_vi-type=det.face=front.stid=1.y=8:::apis_600fr8 apis_inv apis_ss
   ic_fn-type=summ.face=back.stid=2.y=1:::apis_fsbr1
   ic_fn-type=summ.face=back.stid=2.y=2:::apis_fsbr2
   ic_fn-type=summ.face=back.stid=2.y=3:::apis_fsbr3
   ic_fn-type=summ.face=back.stid=2.y=4:::apis_fsbr4
   ic_vi-type=summ.face=back.stid=2.y=1:::apis_fsbr1 apis_inv apis_ss
   ic_vi-type=summ.face=back.stid=2.y=2:::apis_fsbr2 apis_inv apis_ss
   ic_vi-type=summ.face=back.stid=2.y=3:::apis_fsbr3 apis_inv apis_ss
   ic_vi-type=summ.face=back.stid=2.y=4:::apis_fsbr4 apis_inv apis_ss
   ic_fn-type=det.face=back.stid=2.y=1:::apis_600br1
   ic_fn-type=det.face=back.stid=2.y=2:::apis_600br2
   ic_fn-type=det.face=back.stid=2.y=3:::apis_600br3
   ic_fn-type=det.face=back.stid=2.y=4:::apis_600br4
   ic_fn-type=det.face=back.stid=2.y=5:::apis_600br5
   ic_fn-type=det.face=back.stid=2.y=6:::apis_600br6
   ic_fn-type=det.face=back.stid=2.y=7:::apis_600br7
   ic_fn-type=det.face=back.stid=2.y=8:::apis_600br8
   ic_vi-type=det.face=back.stid=2.y=1:::apis_600br1 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=2:::apis_600br2 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=3:::apis_600br3 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=4:::apis_600br4 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=5:::apis_600br5 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=6:::apis_600br6 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=7:::apis_600br7 apis_inv apis_ss
   ic_vi-type=det.face=back.stid=2.y=8:::apis_600br8 apis_inv apis_ss
   ic_fn-type=det.face=unspec.stid=3.y=1:::apis_alt
 ic_vi-type=det.face=unspec.stid=3.y=1:::apis_alt apis_inv apis_ss


dlxs-help@umich.edu

Top

Retrieved from "http://webservices.itcs.umich.edu/mediawiki/dlxs14/index.php/Mapping_Image_Structures"
Personal tools