user guide dln:capturecontext - cultural heritage...

User Guide DLN:CaptureContext

Version 1.0 Beta

DLN_CaptureContext_1_0-Beta_Guide.docx Page1of30

LicenseUserGuideDLN:CaptureContext,version1.0Beta

©2018CulturalHeritageImaging

ThisworkislicensedundertheCreativeCommonsAttribution-Noncommercial-NoDerivativeWorks3.0UnitedStatesLicense.Toviewacopyofthislicense,visithttp://creativecommons.org/licenses/by-nc-nd/3.0/us/orsendalettertoCreativeCommons,171SecondStreet,Suite300,SanFranciscoCalifornia94105USA.

AttributionshouldbemadetoCulturalHeritageImaging,http://CulturalHeritageImaging.org.

TheDLN:CaptureContextversion1.0Betasoftwaredescribedinthisguideis©CulturalHeritageImaging2013–2018andismadeavailableundertheGnuGeneralPublicLicenseversion3.

AcknowledgmentsWiththeBetareleaseofthefirsttwosoftwaretoolsintheDigitalLabNotebook(DLN)suite,CHIgratefullyacknowledgesthecontributedexpertiseandfundingthathavemadethisworkpossibletodate.

SoftwareDevelopmentDLN:CaptureContext:ThistoolwasdevelopedbyCarlaSchroerandMarkMudgeofCHI,alongwithMartinDoerrandErichLeischfromtheFoundationforResearchandTechnologyHellas(FORTH).MartinDoerrledthedevelopmentofthesemanticknowledgemanagementstructure.ErichLeischwrotetheDLN:CaptureContextsoftware.Allmembersoftheteamcontributedtothedesignofthesoftwarerequirementsandspecificationsdocuments.

DLN:Inspector:MarkMudgeandCarlaSchroerofCHIandseniorsoftwareengineerRonBourretdesignedtheInspectortoolincoordinationwithMartinDoerrandErichLeischofFORTH.RonBourretwrotetheDLN:Inspectorsoftware.

FundingFinalizing the 1.0 Beta release for the DLN tools is funded by a current and ongoing National Endowment for the Humanities Preservation and Access Research and Development grant: The Democratization of Scientific Imaging through Metadata Management and Archival Submission Support. The Centre for Cultural Informatics of ICS FORTH is CHI’s partner in this grant. The grant period is from January 2018 – June 2020. (Award # PR-258746-18)

A grant from the National Park Service’s National Center for Preservation Technology and Training (NCPTT), Applying Scientific Rigor to Photogrammetric 3D Documentation for Cultural Heritage and Natural Science Materials. This grant paid for the addition of photogrammetry support to the tools. This project was completed in December 2017.


A Digital Humanities start-up grant from the National Endowment for the Humanities, Data Sustainability and Advanced Metadata Management for Scientific Imaging. This funding paid for development of the DLN:Inspector tool, refinements to the DLN:CaptureContext tool, and an initial case study. This project was completed in December 2015. (Award # HD-51978-14)

Funds from earlier grants were used for initial investigations into approaches for process metadata in computational photography. This work included reviews of metadata strategies and use of the CIDOC Conceptual Reference Model, as well as early prototypes of the DLN:CaptureContext tool:

A Cyber-enabled Discover and Innovation grant from the National Science Foundation (NSF), Automated Documentation and Illustration of Material Culture through the Collaborative Algorithmic Rendering Engine (CARE), in partnership with Princeton University. Completed in September 2014. (Award # IIS-1027962)

A National Leadership Grant from the Institute of Museum and Library Services, Developing Advanced Technologies for the Imaging of Cultural Heritage Objects, in partnership with University of Southern California. This project was completed in December 2009. (Award # LG-25-06-0107-06)

Additional funding came from public contributions to Cultural Heritage Imaging.

CollaboratorsOver the history of Digital Lab Notebook development, many CHI collaborators, too many to name here, have contributed valuable advice and insights to the project. CHI is particularly grateful to these key collaborators:

Steve Stead, Tom Malzbender, Judy Bogart, Dominic Oldman, Adam Rabinowitz, Neffra Matthews, Tom Noble, Julian Richards, Kieron Niven, Chris Edwards, Dale Kronkright, Mary Elings, Stuart Snydman, Susan Kane, Mohammed Elfarargy, Andrew G. Vaughn, Diane Manning

AdditionalResourcesDownload the software and User Guide from CulturalHeritageImaging.org/downloads

See demonstrations of the software as part of the instructional video series “Simplifying Scientific Imaging” here: https://vimeo.com/channels/digitallabnotebook

Ask questions and take part in the conversation about these tools on the Free CHIForums: http://forums.culturalheritageimaging.org


TableofContentsIntroduction..............................................................................................................................4

OverviewandParameterizationofDLN:CaptureContext.........................................................4

SomeGeneralRemarksRegardingtheGUI-Forms...............................................................4

InitialParameterizationofDLN:CaptureContext..................................................................5

InitialParameterizationofProjects....................................................................................11

WorkingwithImages..............................................................................................................13

DocumentingCaptureSetup..............................................................................................14

RTIversusPhotogrammetry...............................................................................................15

GroupsofImageSets..........................................................................................................16

GroupsOverviewForm...................................................................................................16

GroupDetailsForm.........................................................................................................16

ImageSets..........................................................................................................................18

ImageSetsOverviewForm.............................................................................................18

ImageSetDetailsForm...................................................................................................20

PuttingImagesintoContext...............................................................................................21

AssociatingEquipmentwithaGivenImageSet..............................................................21

AssociatingStakeholderswithaGivenGroupofImageSets.........................................22

CreatingRDF-output...............................................................................................................23

Appendix:Glossary.................................................................................................................25


Introduction

ThisQuickStartGuideforusingDLN:CaptureContext(DLNCC)describesthemajorfunctionality.InstallationofDLNCCisnotcoveredbythisguide,asitisassumedthatyoustartwithanexistingdemodatabase.Thepurposeofthisdocumentistogetacquaintedwiththetoolanditsmostlyusedfunctions,withoutdealingwithafullrangeofscenarios.

Itshouldbementionedthatthescreensshowninthisguidemaynotbeup-to-datewithregardtothelatestreleaseofthetool;nevertheless,theyareconsideredappropriateforillustratingthehandlingofthetool.

OverviewandParameterizationofDLN:CaptureContextTheGUIofDLN:CaptureContextconsistsofanumberofformsformanagingtheinformationmaintainedbythetool.Therearethefollowingtypesofforms:

• Themainwindow(dashboard)thatallowsdirectorindirectaccesstotheremainingGUI-forms.• TheGUI-formsformanagingtheentitiesandtheirattributesareeitherdirectlyaccessiblebythe

dashboard,orindirectlyviaoneoftheotherforms,e.g.anentity’sdetailsformisalwaysaccessibleviatheentity’soverviewform.

• Someoftheentitieshaveadditionalsubformsthatappearontheentity’sdetailsformastabs.Two-panesubformsareusuallyusedformanagingassociatedentities,e.g.theequipmentusedforaspecificimageset.

• Whenrequired,popup-formsareusedduringtheassociationofentities,forenteringormodifyingadditionalinformationabouttherelationshipoftheassociatedentities,e.g.thedescriptionoftheactualrightsstatementwhenassociatingastakeholderwithanimageset.

SomeGeneralRemarksRegardingtheGUI-FormsTheformsofDLN:CaptureContextGUIhavesomecommoncharacteristicsthatshouldbementionedbeforedescribingspecificforms:

• Onalltheoverviewforms,thereis(usually)thesamesetofbuttons(New,Details,Duplicate,Delete),wherethefirstthreeofthemresultinopeningtheassociateddetailsform.

• Similarly,thedetailsformshave(usually)acommonsetofbuttons(Save,Close)forclosingtheformwithorwithoutsavingpossiblechanges.Notethatchangesregardingtheassociationoftheentitywithotherentities(e.g.equipmentofthecurrentimageset)aresavedinstantlyinthedatabasewhenchangingassociationsonatwo-panesubform.

• Inanylistofentities,itispossibletosortthelistdynamicallybyclickingononeofthefieldlabelsontopofthelist.

• Incertainlistsofentities,itispossibletoselectmorethanoneentity,eitherbySHIFT-click(forconsecutiveentitiesinthelist)orbyCTRL-click(formultiplelistentries,independentoftheirlocationinthelist).


• Two-paneformsareusedforassociating“secondary”entitieswithagiven“primary”entity1,wheretheleftpanecontainseligiblesecondaryentities,andtherightpanecontainsthesecondaryentitiesalreadyassociatedwiththeprimaryentity.Search/filtercriteriaforthelistofsecondaryentities(leftpane)canbespecifiedintheupperpartoftheform,whereasthecurrentprimaryentityappearsontopoftheform.Viaacheckbox,itispossibletoshow/hideentitiesintheleftpanethatarealreadyassociatedwiththeprimaryentity,thusallowingorpreventingmultipleassociationofthesametwoentities.

• Beawareofthefactthatassociationsaresavedinstantlyinthedatabase;therefore,the[Save]-buttonwillbeonlyenabled,ifthereareunsavedchangesregardingtheattributesonthe[General]-tab.Incaseofassociatedequipment,itwillbepossibletousesubassemblies,whenassigningsuchentitiestothecurrentimageset.

• Incaseof“qualified”associations,i.e.associationswithattributesdescribingtherelationshipbetweenentities,apopup-formwillappearafterclickingthe“>>”-button,promptingforthequalifyingattributes.Double-clickingonanentryintherightpanewillbringupthesamepopup-form,thusallowingviewingormodifyingtheattributesdescribingtherelationship.

InitialParameterizationofDLN:CaptureContextBeforeusingDLN:CaptureContextforthefirsttimeina“productionenvironment”,itisrecommendedtoenteralltheproject-independentparameterizationdatathatshouldbealreadyavailablewhenstartingtorecordinformationregardingaspecificproject.Inthefigurebelow,thebuttonsforaccessingthisfunctionalityhavebeenmarkedwitharedborder.

Asitisassumedinthisguidethattherequiredinitialparameterizationdataarealreadystoredinthedatabase,thereadercouldskiptheremainingpartofthissubchapter,andcontinuewiththe“InitialParameterizationofProjects”.

1Theterms“primary”and“secondary”entitiesareusedtodistinguishbetweenaninitiallyselectedentity(e.g.asubassembly)andtheentities(e.g.equipment)thatcouldbeassociatedwiththeformer.


Figure1:DLNCCDashboard–Buttonsforinitialparameterization

Itisprobablyagoodideatostartwithenteringinformationaboutyourequipment.Thisincludes:

• EquipmentCategories:AlthoughDLN:CaptureContextcomeswithapre-loadedlistofequipmentcategories,youmaywanttoaddorremoveanequipmentcategory,accordingtoyourspecificneeds.

• EquipmentOverview:Thisdashboard-buttonwillopenaformdisplayingtheequipmentalreadyenteredintoDLN:CaptureContext.Initially,thislistwillbeempty.Afterenteringequipment,itwilllookasillustratedinthefigurebelow.

1

2 3

3

4


Figure2:EquipmentOverviewform

Thebuttonsatthebottomoftheform(New,Details,Duplicate,Delete)canbeusedtobuildandmaintainyourlistofequipment,whereastheareaabovethelistallowsspecifyingsearch/filtercriteriafortheequipmenttobeshowninthelist.

• EquipmentDetails:Thisformisopenedafterclickingthe[New]-,[Details]-,or[Duplicate]-button.Itallowsviewingoreditingequipmentdetails.Inordertoclosetheform,youhavetoclickeitheronthe[Save]-buttonorthe[Close]-button,thussavingordiscardingyourchanges,respectively.


Figure3:EquipmentDetailsform

• SubassembliesOverview:Thisdashboard-buttonwillopenaformdisplayingthesubassembliesalreadyenteredintoDLN:CaptureContext.Initially,thislistwillbeempty.Notethatsubassembliesarepredefinedgroupsofequipmentthatcanbeusedasashortcutforassigningequipmenttoaspecificimageset.

Figure4:SubassembliesOverviewform


Thebuttonsatthebottomoftheform(New,Details,Duplicate,Delete)canbeusedtobuildandmaintainyourlistofsubassemblies,whereastheareaabovethelistallowsspecifyingsearch/filtercriteria(e.g.IDorname)forthesubassembliestobeshowninthelist.Inordertoshoworchangetheequipmentbelongingtotheselectedsubassembly,youhavetousethe[Details]-buttonthatwillopenatwo-paneassociationformasshownbelow.

Figure5:SubassemblyDetailsform

Theleftpaneshowstheeligibleequipment,whereastherightpaneshowstheequipmentalreadyassociatedwiththesubassembly.Thearrow-buttonsareusedforaddingorremovingequipmentto/fromthesubassembly,whereastheareaatthetopoftheformallowsspecifyingsearch/filtercriteriafortheeligibleequipment(leftpane).Notethattheuseofsubassembliesisoptional,althoughitmaybeveryusefulwhenassigningequipmenttoanimageset.

Afteryouaredonewithyourequipmentincludingsubassemblies,itisrecommendedthatyouenterinformationabouttheoperatorsusuallyinvolvedinyourimagesets.Thisincludesenteringinformationaboutthepersonsactingasoperators,aswellasdefiningoperatorroles,staffroles,stakeholderrolesandstakeholdertypes(explainedbelow).

• PersonsOverview:Thisdashboard-buttonwillopenaformdisplayingthepersonsalreadyenteredintoDLN:CaptureContext.Initially,thislistwillbeempty.Thelook-and-feeloftheformsusedformaintainingthelistofpersonsisprettymuchthesameasforequipment.Itshouldbementionedthatthelistofpersonswillnotonlycontainoperators,butalsopersonsrelatedtostakeholders,e.g.thedirectorofamuseum.However,duringtheinitialparameterizationphase,onlypersonsactingasoperatorshavetobeconsidered.

• OperatorRoles:AsDLN:CaptureContextdoesnotcomewithapre-loadedlistofoperatorroles,youwillhavetoentertheoperatorrolestobeused,accordingtoyourspecificneeds.Notethat


operatorrolesareusedtospecifyaperson’sroleinacaptureteam,aswellasregardingaspecificimageset.Ifyouwanttopostponethedefinitionandassignmentofspecificoperatorroles,youcanalwaysusetheonlypredefinedoperatorrole,i.e.“UNDEFINED”.

• StaffRoles:Althoughusedinthecontextofprojects,atleastsomestaffrolesshouldbedefinedduringtheinitialparameterization.Notethatstaffrolesareusedtospecifyaperson’sroleorpositionwithregardtoaspecificstakeholder,e.g.withinanorganization.Ifyouwanttopostponethedefinitionofstaffroles,youcanalwaysusetheonlypredefinedstaffrole,i.e.“UNDEFINED”.

• StakeholderRoles:Alsoatleastsomestakeholderrolesshouldbedefinedduringinitialparameterization.Stakeholderrolesareusedtospecifyastakeholder’sroleinaspecificproject,groupofimagesets,orimageset.

• StakeholderTypes:Alsostakeholdertypesshouldbedefinedduringinitialparameterization,asfaraspossible.StakeholdertypesareusedtodistinguishbetweenIndividuals,Organizations,Custodians,etc.,independentfromaparticularactionorproject.

• DocumentReferenceStyles:Alsothemostwidelyuseddocumentreferencestylesshouldbedefinedduringinitialparameterization,asfaraspossible.ExamplesforreferencestylesareBibTexandURL.

• RightsStatements:Thisdashboard-buttonwillopenaformdisplayingthe12RightsStatements,asgivenbyhttp://rightsstatements.org/en/.Therelationshipofaspecificstakeholderwithasubject,imagesetorgroupofimagesetscanbecharacterizedwithoneofthoserightsstatements.Notethatthelistofavailablerightsstatementscomespre-loadedwithDLNCC,andcannotbemodified.

Figure6:Listofpre-definedRightsStatementsaccordingtohttp://rightsstatements.org/en/


Figure7:DetailsofaRightsStatementaccordingto

http://rightsstatements.org/en/

AfterhavingdescribedtheinitialparameterizationofDLN:CaptureContext,theparameterizationatthebeginningofprojectswillbeillustratedinthefollowingsubchapter.Ofcourse,itisalwayspossibletoupdateorenteradditionalinformationofthekinddescribedabove,inanyphaseofaproject,ifrequired.

InitialParameterizationofProjectsWhenstartinganewproject,informationabouttheinvolvedstakeholders,theirstaff,thesubjectstobephotographed,aswellasaboutrelatedlocationsshouldbeentered,beforestartingtorecordinformationaboutindividualimagesetsorgroups.Inthefigurebelow,thebuttonsforaccessingthisfunctionalityhavebeenmarkedwitharedborder.

Figure8:DLNCCDashboard–Buttonsforprojectinitialization

5

6

7

9

8


Thefollowingsequenceofformsusedfordataentryisrecommended,althoughnotmandatory,inthesensethatinformationnotyetavailablefordataentrycanbeenteredalsoatalaterpointintime,usingtheappropriateforms:

• LocationsOverview:Thisdashboard-buttonwillopenaformdisplayingthelocationsalreadyenteredintoDLN:CaptureContext.Youshouldenteranylocationsrelatedtothenewproject,e.g.theshootinglocations,thelocationoftheinvolvedstakeholders,etc.

• PersonsOverview:Thisdashboard-buttonwillopenaformdisplayingthepersonsalreadyenteredintoDLN:CaptureContext.Thislistwillprobablyalreadycontainyouroperators.Youshouldenternowtheothertypesofpersonsrelatedtothenewproject,e.g.thepersonsrepresentingthefunderoftheproject,theownerofthesubjectstobephotographed,etc.

• SubjectsOverview:Thisdashboard-buttonwillopenaformdisplayingthesubjectsalreadyenteredintoDLN:CaptureContext.Youshouldenternowthesubjectstobephotographedduringthenewproject.

• StakeholdersOverview:Thisdashboard-buttonwillopenaformdisplayingthestakeholdersalreadyenteredintoDLN:CaptureContext.Initially,thislistwillbeempty.Inadditiontoenteringinformationaboutthestakeholdersinvolvedinyourproject,youwillbeabletoassociatethepersonsandsubjectsenteredinthepreviousstepwiththestakeholders,specifyingalsoinformationregardingrolesofpersons,rightsonsubjects,etc.

Figure9:StakeholderDetailsform,[Persons]-tab

Afterselectingthe[Persons]-tabonthe“StakeholderDetails”-form,atwo-paneassociationformispresented,whichallowsassociatingpersonswiththecurrentstakeholder,e.g.theDirectorofanorganization.Duringtheassociation,theuserispromptedtoenterthestaffroleofthepersoninrelationtothestakeholder,his/hertitle,andtheindication,whetherthisassociationis“current”ornot.

Inasimilarway,associationswithsubjectsanddocumentsaremanagedforagivenstakeholder.


• ProjectsOverview:Thisdashboard-buttonwillopenaformdisplayingtheprojectsalreadyenteredintoDLN:CaptureContext.Initially,thislistwillbeempty.

• ProjectDetails:Thisformisopenedafterclickingthe[New]-,[Details]-,or[Duplicate]-button.Itallowsviewingoreditingprojectdetails.Inadditiontothe[General]-tabwiththeproject-specificattributes,therearetabsforassociatingstakeholdersanddocumentswiththeproject.Inordertoclosetheform,youhavetoclickeitheronthe[Save]-buttonorthe[Close]-button,thussavingordiscardingyourchanges,respectively.

Figure10:ProjectDetailsform,[Stakeholders]-tab

Afterhavingdescribedtheinitialparameterizationofaspecificproject,therecordingofimagesetswillbeillustratedinthefollowingsubchapter.Ofcourse,itisalwayspossibletoupdateorenteradditionalinformationofthekinddescribedabove,inanyphaseofaproject,ifrequired.

WorkingwithImagesDLNCCisdesignedandstructuredinawaythatallowssupportingnotonlyasingle,butawholerangeofimageprocessingtechniques.Althougheachimagingtechniquerequiresadaptationofthedatamodelaswellastheuserinterface,thelargerpartofDLNCCisofgenericuse,andthereforeisnotaffectedwhenaddinganotherimagingtechnique.ThecurrentversionofDLNCCsupportsRTIandPhotogrammetry.OnlytheformsusedforhandlingimagesetsandgroupsofimagesetsareslightlydifferentforRTIandPhotogrammetry.Notethatamixofdifferentimageprocessingtechniquesmaybeusedinthesameproject.

Dependingontheselectedimagingtechnology,wearedealingwithindividualimagesets(incaseofRTI),orwithgroupsofimagesets(incaseofphotogrammetry).Inanidealscenario,therecordingofimagesetswouldrequirelittleextradataentry,asinformationaboutavailableequipment,operators,stakeholders,subjects,rightsetc.hasalreadybeenenteredpreviously,asdescribedabove.Inthe“real”world,ofcourse,youwillprobablyhavetoenterorupdatealsoinformation,youcouldnotorforgottoprovideduringtheinitialparameterizationofDLN:CaptureContextortheproject.Anyway,let’scontinueourideal(maybenotcompletelyrealistic)scenariobyshowingtheway,howanimagesetorgroupofimagesetsisrecorded.


Figure11:DLNCCDashboard–Recordinganimagesetorgroupofimagesets

DocumentingCaptureSetupStartingfromtheDashboard,youmaywanttotakephotosofthesetupusedforcapturingtheimagesandstoretheminthedatabase.Later,youwillbeabletoassociatethosephotoswithimagesetsorgroupsofimagesets.

• PhotosofSetups:Thisdashboard-buttonwillopenaformdisplayingthesetupphotosalreadyenteredintoDLN:CaptureContext.Initially,thislistwillbeempty.

Figure12:SetupPhotosOverviewform

11 10


• SetupPhotoDetails:Thisformisopenedafterclickingthe[New]-,[Details]-,or[Duplicate]-button.Itallowsviewingoreditingsetupphotodetails.Inordertoclosetheform,youhavetoclickeitheronthe[Save]-buttonorthe[Close]-button,thussavingordiscardingyourchanges,respectively.

Figure13:SetupPhotoDetailsform

RTIversusPhotogrammetryBeforepointingoutthedifferencesbetweenRTIandPhotogrammetryregardingimagesetsandgroupsofimagesets,someintroductorynotesmaybehelpful.

Eachimagesetbelongstoexactlyonegroupofimagesets,andeachgroupofimagesetsbelongsexactlytooneproject.

WithRTI,eachimagesetisprocessedindependentlyoftheotherimagesets,andresultsinoneRTI-outputperimageset.AlthoughRTIimagesetsmaybeassignedtodifferentgroupsofimagesets,inmostcasesonestandardRTI-groupperprojectisrecommended.Therefore,forthesakeofyourconvenience,theformusedforcreatinganewprojectofferstheoption(viaadropdownlist)ofimplicitlycreatingagroupofimagesetswiththesamenameastheproject.

WithPhotogrammetry(PG),theoutputoftheimageprocessingisbasedonalltheimagesetsbelongingtothesamegroupofimagesets.

DuetothedifferencesbetweenRTIandPhotogrammetry,theformsusedforimagesetsandgroupsofimagesetsarespecificforeachimagingtechnique,asshowninthefollowingsubchapters.


GroupsofImageSetsAgroupofimagesetsalwaysbelongstoaproject,andmayincludeoneormoreimagesets,inotherwordsthereisastricthierarchyformedbyprojects,groupsandimagesets.

Whencreatingagroupofimagesets,theuserhastodecide,whetheritwillbeanRTI-grouporaPG-group.Thatdecisioncannotbechangedafterwards.

GroupsOverviewFormThisformisaccessiblefromtheapplication’sdashboard,anditprovidestherequiredfunctionalityformanaging“GroupsofImageSets”,orshortly“Groups”.

Ascanbeseeninthenextfigure,theGroupsOverviewformmaycontaingroupsofeitherimageprocessingtechnique.

Figure14:GroupsOverviewform

Notethatthebutton[SaveRDF…]isonlyenabledwhenthefocusisonaPG-group,whereasitisdisabledforRTI-groups.ThereasonisthattheresultofPG-processingusestheimagesofallsetsbelongingtothePG-group,whereastheresultofRTI-processingisbasedononespecificimageset.

GroupDetailsFormThisformisaccessiblefromtheGroupsOverviewform,anditprovidestherequiredfunctionalityforcreatingorediting“GroupsofImageSets”,viathe[New],[Details]and[Duplicate]buttonsonthatoverviewform.


TheGroupofImageSetDetailsformshowsallthedetailsoftheselectedgroup.Itisalsousedformodifyinginformationorforcreatinganewrecord.Datashownontheformisgroupedbymeansoftabs.Whereasthe[General]-tabisusedtomanageattributesoftheselectedgroupofimagesets,theremainingtabsonthedetailsformareusedformanagingtheassociationsoftheselectedgroupwithstakeholders,subjects,documents,andsetupphotos,includingdetailedinformationabouteachassociation,e.g.arightsstatementforastakeholderaboutthegroup’simages.

Asshowninthefollowingscreenshots,thelayoutandfieldsofthe[General]-tabaredifferentforeachimagingtechnique.

Figure15:DetailsformofanRTI-group

Thepreviousandthenextfiguresshowthedetailsformsofthecurrentlysupportedtechniques,theformsofanRTI-groupandaPhotogrammetry-group,respectively.


Figure16:DetailsformofaPhotogrammetry-group

ImageSetsWhencreatinganimageset,theuserhastodecide,whetheritwillbeanRTI-setoraPG-set.Thatdecisioncannotbechangedafterwards.

ImageSetsOverviewFormThisformisaccessiblefromtheapplication’sdashboard,anditprovidestherequiredfunctionalityformanaging“ImageSets”.

Ascanbeseeninthenextfigure,theImageSetsOverviewformmaycontainsetsofeitherimageprocessingtechnique.


Figure17:ImageSetsOverviewform,w/ofilter

Notethatthebutton[SaveRDF…]isonlyenabledwhenthefocusisonanRTI-group,whereasitisdisabledforPG-groups.

Ofcourse,itispossibletoshowonlythesetsbelongingtoaspecificgroup,orsetsofaspecifictechnique,asshownbelow.

Figure18:ImageSetsOverviewformforspecificgroup


Figure19:ImageSetsOverviewform,restrictedtoRTI-sets

ImageSetDetailsFormThisformisaccessiblefromtheImageSetsOverviewForm,anditprovidestherequiredfunctionalityforcreatingorediting“ImageSets”,viathe[New],[Details]and[Duplicate]buttonsonthatoverviewform.

TheImageSetDetailsformshowsallthedetailsoftheselectedimageset.Itisalsousedformodifyinginformationorforcreatinganewrecord.Datashownontheformisgroupedbymeansoftabs.Whereasthe[General]-tabisusedtomanageattributesoftheselectedImageSet,theremainingtabsonthedetailsformareusedformanagingtheassociationsoftheselectedsetwithstakeholders,subjects,operator,equipment,andsetupphotos,includingdetailedinformationabouteachassociation,e.g.arightsstatementforastakeholderabouttheset’simages.

Asshowninthefollowingscreenshots,thelayoutandfieldsofthe[General]-tabaredifferentforeachimagingtechnique.

Figure20:DetailsformofanRTI-set


Thepreviousandthenextfiguresshowthedetailsformsofthecurrentlysupportedtechniques,theformsofanRTI-setandaPhotogrammetry-set,respectively.

Figure21:DetailsformofaPhotogrammetry-set

Independentofthechosenimageprocessingtechnique,imagesetsandgroupofimagesetscanbeassociatedwithotherentities,viathetabsonthedetailsformsshownabove.

PuttingImagesintoContextImagesetsandgroupsofimagesetscanandshouldbeassociatedwith:

• Stakeholders• Subjects• SetupPhotos• Documents(groupsofimagesetsonly)• Equipment(imagesetsonly)• Operators(imagesetsonly)

Thecorrespondingtabsonthegrouporimagesetdetailsformallowviewingormodifyingassociations.Inthefollowing,twoexamplesforassociatingequipmentwithanimagesetandforassociatingastakeholderwithagroup,respectively,areusedtoillustratehowassociationsarehandledbyDLNCC.

AssociatingEquipmentwithaGivenImageSetThelistofequipmentassociatedwithaspecificimagesetisaccessibleviathe[Equipment]-tab,asshowninthefollowingfigure.


Figure22:ImageSetDetailsform,[Equipment]-tab

Theequipment(already)associatedwiththespecificimagesetisshownintherightpaneofthe[Equipment]-tab,whereasequipmenteligibleforassociationisshownintheleftpane.Notethatthelistofeligibleequipmentcanbefilteredinthefollowingways:

• Byprovidingsearchcriteriainthefieldslabeled“ID”or“Equipment”• Byhidingorshowingtheequipmentalreadyassociatedviathecheckbox“Showassociated”• Byselectinga“Subassembly”fromthelistofpre-definedsubassemblies,thusrestrictingthelist

ofeligibleequipmenttothemembersoftheselectedsubassembly,asshownaboveforsubassembly“BigTripodPlatform”

Ofcourse,anycombinationoftheabovecanbeusedtofilterthelistofeligibleequipmentshownintheleftpane.Notethatmulti-selectissupportedintheleftpane,asshownabove,fortheequipmenttobeassociatedwiththeimageset.

AssociatingStakeholderswithaGivenGroupofImageSetsThelistofstakeholdersassociatedwithaspecificgroupofimagesetsisaccessibleviathe[Stakeholders]-tabonthegroup’sdetailsform.Thissubformisusedtomanipulatethelistofstakeholdersassociatedwithaspecificgroupofimagesets,e.g.byaddingorremovingstakeholders,aswellasbymodifyingthecharacteristicsoftheassociation(e.g.rightsstatement).


Figure23:GroupDetailsform,[Stakeholders]-tab

Thestakeholders(already)associatedwiththespecificgroupofimagesetsareshownintherightpaneofthe[Stakeholders]-tab,whereasstakeholderseligibleforassociationareshownintheleftpane.Notethatinthisexamplethereisapopup-formforadditionalinformationdescribingtherelationshipbetweenthegroupandthestakeholder.Thepopupformappearswhencreatinganewassociationorbydouble-clickingonanexistingstakeholderintherightpane.

Therelationshipbetweenagroupofimagesetsandastakeholderismainlyaboutthestakeholder’scopyrightontheinitialandprocessedimagesofthegroup,usingoneofthepre-definedRightsStatementsincombinationwithsomefreetextfields(RightType,Licensetext,etc.).

CreatingRDF-outputAlthoughDLNCCprovidesseveralwaysofexportingtheinformationmaintainedinitsdatabaseasRDF-files,onlythefollowingoptionsshallbementionedinthisQuickStartGuide:

• AfterselectingaphotogrammetrygroupofimagesetsintheGroupsofImageSetsOverviewform,the[SaveRDF…]-buttoncanbeusedtocreateanRDF-filewithalltheinformationdirectlyorindirectlyrelatedtotheselectedgroup.Twofilesnamed“dln-cptsess.xml”and“dln-cptsess.rdf”,respectively,willbecreatedinthegroup’sfolder.WhiletheformerwillcontainanXML-representationofthedatabasecontentsbeingexported,thelatterwillcontaintheRDF-representationofthatinformation,basedonDLNCC’sstandardmappingfile(X3ML),whichformallydescribesthemappingoftheDLNCCdatabaseschematoCRM-CIDOC.


• Similarly,afterselectinganRTIimagesetintheImageSetsOverviewform,the[SaveRDF…]-buttoncanbeusedtocreateanRDF-filewithalltheinformationdirectlyorindirectlyrelatedtotheselectedimageset.Twofilesnamed“dln-cptset.xml”and“dln-cptset.rdf”,respectively,willbecreatedintheimageset’sfolder.


Appendix:GlossaryThisappendixcontainsaglossaryexplainingthemeaningandpurposeofDLN:CaptureContextentitiesandtheirrelationships.Itisorganizedinalphabeticalorder.

Term/Entity

Explanation Examples Relatedentities

Document Thisentityusuallycontainsonlymeta-informationaboutdocumentsdirectlyorindirectlyrelatedtoaproject.Itmay,however,containalsothedocumentitself.

Projectcontract

Publications

Notes

Project

GroupofImageSets

Stakeholder

Person

Subject

DocumentReferenceStyle

Thedocumentreferencestyledenotesthestyleandformatofthedocumentreference.

BibTeX n/a

Equipment Theterm“equipment”isusedforcameras,filters,andtripodsetc.,usedinthecourseofaimageset.Eachpieceofequipmentbelongstoaspecificequipmentcategory.Asubassemblyisapredefinedgroupofequipment,tobeusedasshortcutwhenassociatingequipmentwithaspecificimageset.

CanonMarkII

16GBCFcard

Macro100mmf/2.8

Subassembly

ImageSet

EquipmentCategory

Theequipmentcategoryisusedcategorizetheequipment.

Camera

Imagestoragedevice

Lens

Illuminationsource

n/a


Term/Entity


GroupofImageSets

AgroupofimagesetsispartofaProject.

RequiredforPhotogrammetry,optionalforRTI.

DeYoungShoot Location

SetupPhoto

Document

Subject

Stakeholder[withStakeholder

Role]

ImageSet Animagesetispartofagroupofimagesets.

VenetianGirlbyDuveneck

Location

Equipment

SetupPhoto

Stakeholder

[withStakeholderRole]

Person/Operator

[withOperatorRole]

Subject[withRightsStatement]

Location Locationscanbespecifiedindifferentways.Itis,however,recommendedtouseTGN-URIs.

http://vocab.getty.edu/tgn/7010879

GroupofImageSets

Imageset

Stakeholder

Subject

Operator Anoperatorisapersoninvolvedintheimplementationofanimageset.His/herspecificroleisdescribedbytheoperatorrole.

MarkMudge

CarlaSchroerImageset[withOperatorRole]

OperatorRole

Theroleofapersonasamemberofacaptureteamworkingonanimageset.

Supervisor

Objecthandler

Videographer

Lightperson

Computerperson

n/a


Term/Entity


Person(incl.Operators)

Therearetwocategoriesofpersons:operatorsandrepresentativesofstakeholders.Theformerarerelatedtoimagesets,whereasthelatterarerelatedtostakeholders.Theserelationshipsaredescribedbytheoperatorroleorthestaffrole,respectively.

MarkMudge

CarlaSchroer

MartinDoerr

ErichLeisch

Imageset[withOperatorRole]

Stakeholder[withStaffRole]

Document

Project AprojectisthecentralreferencepointforcollectingandstoringDLN-data,althoughmostassociationsareimplementedviatheunderlyingimagesets.

ConservationCasestudiesdocumentary

Stakeholder[withStakeholder

Role]

Document

RightsStatement

Supportofthe12RightsStatements,asgivenbyhttp://rightsstatements.org/en/.

InCopyright-EducationalUsePermitted

n/a

SetupPhoto Aphotoshowingthesetupwhencapturinganimagesetorgroupofimagesets.

n/a GroupofImageSets

ImageSet


Term/Entity


StaffRole Thestaffroledescribestheroleofapersonasmemberofanorganizationorasarepresentativeofanindividual.Notethatinbothcases,thestaffroledescribestherelationshipbetweenapersonandastakeholder.

Director

IT-Manager

PR-Manager

Contactperson

n/a

Stakeholder Astakeholderisanorganizationorindividualrelatedtoaproject.Independentofitsproject-specificrelationships,astakeholderischaracterizedbyitsstakeholdertype,whereasthestakeholderroleisusedtodescribeitsrelationshipswithprojects,groupsofimagesetsorsets.

Theownerorcustodianofthesubjectstobephotographed.

Theorganizationfundingtheproject.

Location

Project[withStakeholder

Role]

GroupofImageSets[withStakeholder

Role]

Imageset[withStakeholder

Role]

Document

StakeholderRole

Stakeholderrolesareusedtodescribetherelationshipsbetweenstakeholdersversusprojects,groupsofimagesets,andsets.

Owner

Custodian

CopyrightHolder

Client

Sponsor

n/a


Term/Entity


StakeholderType

Stakeholdertypesareusedtocharacterizestakeholdersindependentofaspecificproject,groupofimagesets,orset.

Foundation

PrivateCompany

PublicInstitution

Non-profitOrganization

Individual

n/a

Subassembly Asubassemblyisapredefinedgroupofequipment,tobeusedasshortcutwhenassociatingequipmentwithaspecificimageset.

Mark_II+Plate+32CFCard

MarkII+Plate+32CF+100mmL

MarkII+Plate+32CF+100mmL+TT1

Equipment

Subject Asubjectisanitemtobephotographed,inordertocreatedigitalimagesforfurtherprocessing.Subjectsmayberelatedtostakeholders,groupsandimagesets.

VenetianGirlbyDuveneck

Location

Stakeholder[withRightsStatement]

Imageset[withRightsStatement]

Groupofimagesets[withRightsStatement]

Document