Submission Process
Before submitting a model to the Electronic Geometry Model archive
carefully read the instructions for authors.
A model is represented by a master file which provides a unique and
well-defined description of the model. This master file is the reference data
set of the geometry model, it may be generated with an arbitrary software. An
author submits a model in the form of a
 | a master data file in any of the formats listed below |
 | a description file of the model with author, content and references
information, see below |
 | optionally, files may be supplied for preview, printing, or explanatory
purposes, see below. |
Put all files in a compressed ZIP or TAR.GZ
archive and complete your submission by uploading the archive:
After an instant preview of your submission you can acknowledge with your e-mail address and thereby complete your submission. If you cannot resolve problems occurring in the upload or
automatic validation process, please, contact the eg-models
administrator at eg-admin@eg-models.de and send your
submission by email. We will help to analyse the problem.
For example, a valid submission of a geometry might consist of the
following set of files:
 | Pretzel.xml |
 | Pretzel_Master.jvx |
 | Pretzel_Applet.obj |
 | Pretzel_Preview.gif |
Description File
It is essential that a model submission includes a completed description
file in XML format. The format of a description file must follow exact rules.
But note, there is no need to know about XML or to type any XML by hand.
Here are different way to generate an XML file either by
 | completing a submission from within JavaView
version 2.00 and later (recommended), e.g. import any
geometry and automatically generate a master file, an applet file, a
preview image, and the description file by pressing the "submit"
button in the FILE menu. |
 | completing a template file using this online submission form:
|
 | downloading and completing an XML template
file with an editor. |
 | For multiple submissions it might be easier to use an application.
Additional to JavaView there
exists a windows executable for generating
and displaying submission forms. |
A real-world example of a completed description file is available here. A note for experts, any XML description
file is formatted according to the data type dictionary eg-model.dtd.
Data Formats of the Master File and Other Files
The following table lists different file types (most are supplemental). A
detailed specification of the data formats is given on the page data formats:
Purpose
|
Description
|
Format
|
|
| Description |
Complete description of model
submission. Review decision is based on master file and this
description. |
XML |
required |
| Master |
The major geometry data file
which is the reference data set. All other geometry files have minor
importance and are usually derived from this unique file. |
JVX,OBJ,
POLY,BYU |
required |
| Applet |
Small sized version of the
geometry for online display in an interactive applet. If this Master
file is small you may reference the Master file as Applet file. |
JVX,OBJ,
BYU |
recommended |
| Preview |
Small image for fast preview of
the model. Recommended image size is 240*240 pixels. |
GIF,JPG |
recommended |
|
| Readme |
Additional instructions for
editors and administrators of data base. This file will not be
included in the public presentation of the model. Instructions to
readers of EG-Models should be placed in the model decription. |
TXT |
optional |
| Print |
Image of model for inclusion in
publications. Note, users of this file must correctly cite the model as
being published in this data base.
PostScript files must be ASCII without preview image. TIF files must
have IBM byte-encoding and LZW compression (loss-less). |
PS,EPS,TIF |
optional |
| Original |
If master file has been
generated by a software package from this original source, then this
original file may also be supplied although there is no guarantee that
the EG-Models archive supplies any tools operating on this file. |
arbitrary |
optional |
|
| Other |
Other supplemental files
although there is no guarantee that the EG-Models archive
supplies any tools operating on this files. |
arbitrary |
optional |
Animations
Keyframe animations may be supplied by enumerating the keyframe files
similar to
basename_Master.IND.obj
where IND runs from 1 to number of keyframes. The preview image may be an
animation even for static geometry models.
|