+ All Categories
Home > Documents > Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New...

Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New...

Date post: 15-Jul-2020
Category:
Upload: others
View: 0 times
Download: 0 times
Share this document with a friend
12
1 Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016) New datasets are always welcome for Science On a Sphere ® ! Here are a few simple guidelines to assist in the creation of content. The SOS team has significant experience with technical and aesthetic issues when creating content for spherical display systems, and is happy to provide feedback and suggestions during production to ensure quality content. Part 1 covers useful information for creating content Part 2 outlines the steps for adding a new dataset to the SOS catalog Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image Can be displayed on the sphere and animated, as in a planetary rotation. An example of this is a global image of the Earth's topography and bathymetry. It’s a static image that can be manipulated and rotated in real time from the user interface or remote control Time Series - Image Sequence or MPEG4 Animates through time. An example of this would be a loop of satellite data. For an image sequence, SOS will display the images in sequence and play them like a movie across the entire sphere surface. Image sequences can be of any arbitrary length, limited mainly by disk space and can be animated at frame rates up to 30 frames per second (fps). MPEG4's allow for higher resolution and faster frame rates than image sequences. Transitions, special effects, and other computer graphics techniques can be added to a sequence through the use of off the shelf software like Final Cut Pro. Map Projection – Equatorial Cylindrical Equidistant Projection This is a simple latitude/longitude grid with the lines evenly spaced where the image is twice as wide as it is tall. To be consistent with the SOS Data Catalog, it is recommended that the 0° line go through the middle of the map, with the +/-180° lines at the edges.
Transcript
Page 1: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

1

ContentCreationGuidelinesUpdatedforSOS5.1.0+(08/2016)

NewdatasetsarealwayswelcomeforScienceOnaSphere®!Hereareafewsimpleguidelinestoassistinthecreationofcontent.TheSOSteamhassignificantexperiencewithtechnicalandaestheticissueswhencreatingcontentforsphericaldisplaysystems,andishappytoprovidefeedbackandsuggestionsduringproductiontoensurequalitycontent.

Part1coversusefulinformationforcreatingcontentPart2outlinesthestepsforaddinganewdatasettotheSOScatalog

Part1–CreatingNewContent

DataFormatTherearetwobasictypesofdatasetsforSOS:

Texture-SingleImageCanbedisplayedonthesphereandanimated,asinaplanetaryrotation.AnexampleofthisisaglobalimageoftheEarth'stopographyandbathymetry.It’sastaticimagethatcanbemanipulatedandrotatedinrealtimefromtheuserinterfaceorremotecontrolTimeSeries-ImageSequenceorMPEG4Animatesthroughtime.Anexampleofthiswouldbealoopofsatellitedata.Foranimagesequence,SOSwilldisplaytheimagesinsequenceandplaythemlikeamovieacrosstheentirespheresurface.Imagesequencescanbeofanyarbitrarylength,limitedmainlybydiskspaceandcanbeanimatedatframeratesupto30framespersecond(fps).MPEG4'sallowforhigherresolutionandfasterframeratesthanimagesequences.Transitions,specialeffects,andothercomputergraphicstechniquescanbeaddedtoasequencethroughtheuseofofftheshelfsoftwarelikeFinalCutPro.

MapProjection–EquatorialCylindricalEquidistantProjectionThisisasimplelatitude/longitudegridwiththelinesevenlyspacedwheretheimageistwiceaswideasitistall.TobeconsistentwiththeSOSDataCatalog,itisrecommendedthatthe0°linegothroughthemiddleofthemap,withthe+/-180°linesattheedges.

Page 2: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

2

ImageFormat–JPEGorPNGforsingleimagesandimagesequencesSOSwillacceptmostcommonformats(JPEG,PNG,GIF,TIFF,etc.),butJPEGandPNGarepreferred.VideoFormat–MPEG4RenderthevideowiththeMPEG4videocodecataminimumof25mbps.Justbecauseafilehasa.mp4extensiondoesnotmeanitwillplayperfectlyonSOS.Besuretocheckthecodecthatwasusedtorenderthefile.TheH.264codecshouldnotbeusedbecauseitcancauseerrorsintheSOSsoftware.AlternativeFormat–KMLThesoftwarealsohastheabilitytodisplayKML(KeyholeMarkupLanguage)filesonScienceOnaSphere.KMLisapopularspecificationandactivelyusedwithGoogleEarthfordisplayingdataonasphere.TheinitialSOSKMLcapabilitysupportsalimitedsetoftheentirespecification,whichincludesmanyofthecommonlyusedKMLfeaturesyouwouldtypicallydisplayinGoogleEarth.AnSOSplaylistcanreferencebothKMLandthecompressedKMZformatsusingthelayerdatakeyword.AlternativeFormat–WMSSOShasanexperimentalcapabilitytospecifyandloadimagesdirectlyfromanOpenGeoSpatialConsortium(OGC)WebMappingService(WMS).ThisfeaturerequiresaninternetconnectionandwillnotworkunlesstheSOSsystemhasaccesstotheinternetandthereferencedWMSServer.AWMSprovidesaserviceallowinguserstorequestdatathroughURLsusingspecifickeyvaluepairsdefiningtermssuchasthewidth,height,imagetype,etc.AuniquefeatureoftheWMSstandardallowsuserstorequestsubsetsofimagerybydefiningaboundingboxusingalowerleftandupperrightlatitudeandlongitudecoordinates.Thecombinationofthesefeaturesallowsuserstohostverylargehighresolutionimageryanduserscanrequestsmallerversionsorsubsetsoftheoriginalimagery.SOStakesadvantageofthisfunctionalitythroughthemagnifyingglass,allowinguserstoseemoredetailasyouincreasethezoomlevelonthesphere.AtutorialspecificallyforusingWMSwithSOScanbefoundhere:http://sos.noaa.gov/Docs/WMS-tutorial.pdf.AudioFormat–MP3,MPEG4,WAV,OGG,AIF…TheaudioplayerforSOSisfairlyversatileandmostcommonformatswillworkwithSOS.TheaudiofilecaneitherbeastandalonefileorembeddedinthesameMPEG4fileasthevideo.Resolution–2048x1024foranimations,4096x2048fortexturesThosearetherecommendedresolutions,thoughother2x1resolutions,suchas3000x1500willwork.Higherresolutionsarepossiblefortheanimations,butnotallSOSsystemsintheSOSUsersCollaborativeNetworkareabletoanimateat30framespersecondforhigherresolutions.Makesuretorenderthevideoswithsquare(1:1)pixelsforproperplayback.Ifpossible,thehighestresolutionoftheanimationthatisgeneratedshouldalsobeprovided,inadditiontothe2048x1024file,sothatitisavailableinthefutureasthecomputers,softwareandprojectorsimprove.Ifanimagesequenceisprovided,itwillberenderedintoaMPEG4file

Page 3: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

3

thatis2048x1024unlessthereisaspecificreasontokeeptheanimationasanimagesequence.Forsingleimages,resolutionsabove4096x2048arepossible,thoughloadtimeincreaseswithresolutionsize.Asofrelease5.0,theSOSsoftwareiscapableofrunninghigherresolution4Kprojectors.Ifyouwishtocreatehigherresolutionimagesandmoviestotakeadvantageofthehigherresolutionqualityof4Kprojection,thesame2:1ratiorulesapply.Movieswith4096x2048resolutionwillworkonsuchsystems,althoughdecreasedfpsratesmaybenecessaryandtheloadtimewillbelonger.Singleimagesof8192x4096willdisplaywellon4Kprojectorsandimagesaslargeas16384x8192shouldstillwork,althoughresolutionsabove8192x4096willresultinonlyslightlyincreasedquality.Werecommendthatyoutestanyhighresolutionimagesandmoviesyoucreateonafull4Kprojectorsystemtoensuretheywilldisplayasyouexpect.ContentConsiderationsFileNames–BasedonResolution,TimeStamp,andContentSingleimagesaretypicallynamedfortheirresolution,suchas4096.jpg.Imagesequencesarekeptinfoldersthatarenamedfortheirresolution,andtheimagesthemselvesshouldbenamedtosortinascendingorderfromearliesttolatest.Thiscaneitherbedonewithatimestampinthefilename,oraframenumberinthefilenamewithasufficientnumberofleadingzerosinensurepropersorting,shownintheexamplebelow.Videosshouldbenamedbasedoncontentandresolution,suchashurricanes_2048.mp4.Byincludingtheresolutioninthefilenames,SOSusersareabletoeasilydeterminewhatisavailableandappropriatefortheirsystem.LinuxandtheSOSsoftwaredonothandlespacesandspecialcharactersinfilenameswell.Donotusespacesandspecialcharactersinfilenames!

NamedbydateNamedbyframecount

Thedatashouldtakeupthewholeimage,withnobordersorextraspacearoundtheedges.Evenapixelborderwillshowupasaseam!Inmostcases,asimple1%stretchinthehorizontalwillfixtheproblem.Thedatashouldmatchupattheedgesoftheimage.Ifitdoesn’t,aseamwillappearwherethemismatchhappensanditwon’tlookseamlessonthesphere.Examplesofseamsproblemsareshownbelow.Inadditiontomakingsurethatthedatafillstheentireframe,from180°Westto180°East,alsomakesurethatthedatafillstheentireframefrom90°Southto90°North.Ifthereismissingdataatthepoles,fillintheareawithasolidcolororabasicland/oceanbackgroundtoensurethatthedatasetwrapsproperlyaroundthespherewithoutstretchingvertically.

snow_ice_2048_20110730.png snow_ice_2048_20110731.png snow_ice_2048_20110801.png snow_ice_2048_20110802.png snow_ice_2048_20110803.png snow_ice_2048_20110804.png snow_ice_2048_20110805.png snow_ice_2048_20110806.png

sos_jpl_4096.0001.jpg sos_jpl_4096.0002.jpg sos_jpl_4096.0003.jpg sos_jpl_4096.0004.jpg sos_jpl_4096.0005.jpg sos_jpl_4096.0006.jpg sos_jpl_4096.0007.jpg sos_jpl_4096.0008.jpg

Page 4: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

4

ExamplesofSeams–Aproblemtobeavoided

Labels–IdentifyingthedatasetLabelsandlegendsareimportant.Foreverydatasetthatneedsatimestamp,afilecalledlabels.txtshouldbegeneratedthatcontainsonelineforeachframeintheanimation.Alabels.txtfilecannotbeusedwithasingleimage.Typicallythelabelsincludethedate,butcancontainanydesiredinformation,asseenbelow.

Labelsshouldnotbe“burnedin”theimagesthemselvesduetowarping.Also,whenlabelsare“burnedin”theycanberotatedoutofviewandtiltedatoddangleswhenapresenterisinteractingwiththesphere.Thepositionofthelabelsthatappearfromthelabels.txtfileremainsstationaryasthesphereisrotated.Whilethepositionandcolorofthelabelscanbeadjustedintheplaylist.sosfile,thefontandsizecannotbeadjusted.Inadditiontousingthelabels.txtfile,thereareotherwaysoflabelingthecontentthatisonthesphere.Colorbarsandlegendscanbeaddedusingthepicture-in-a-picturefeature.Aswiththetimestamps,donot“burnin”colorbarsandlegends.Makesuretotestthesizeandfontsofcolorbarsandlegendsonthespheretoensurelegibility.Itseemsthatmostcolorbarsandlegendsaretoosmallandhavetobeincreasedinsizewhenactuallydisplayedonthesphere.Alsomakesuretotestthesizetoensurethatthecolorbarsaren’tsolargethattheyhindertheaudiencefromseeingtheunderlyingdataset.

07/24/2004 06:45 07/24/2004 07:15 07/24/2004 07:45 07/24/2004 08:15 07/24/2004 08:45 07/24/2004 09:15 07/24/2004 09:45 07/24/2004 10:15 07/24/2004 10:45 07/24/2004 11:15 07/24/2004 11:45 07/24/2004 12:15

SSEC 08/31/2005 Katrina SSEC 08/31/2005 Katrina SSEC 08/31/2005 Katrina SSEC 08/31/2005 Katrina SSEC 08/31/2005 Maria Katrina SSEC 09/01/2005 Maria SSEC 09/01/2005 Maria SSEC 09/01/2005 Maria SSEC 09/01/2005 Maria SSEC 09/01/2005 Maria SSEC 09/01/2005 Maria SSEC 09/01/2005 Maria

Page 5: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

5

Thepurposeofaddinglabelstothesphereistoaidthevisitorinunderstandingthedataset.Considerusingpictographsforscalesbecausetheyhavebeenfoundtobeintuitiveandbeneficialforvisitorunderstanding.Also,usingcountryorcitylabelscanhelpvisitorsorientthemselvesinaglobalcontext.Anothersuggestionistouseverticaltemperaturecolorbarsbecausethatishowmostvisitorsareaccustomedtoreadingthermometers.Size,orientationandplacementofcolorbarsandlegendsareimportantforimprovingthevisitor’sunderstandingofthedataset.Picture-in-a-Picture–EnhancingthedatasetAPicture-in-a-Picture,orPIP,canbeusedtoenhanceanexistingdatasetorprovidesupplementarydocumentation.Logos,images,colorbarsandlegendsareaddedasPIPs.Whenusedforacolorbar,aPIPcanhelplabeladataset,asseenatright.Aswiththelabels,itisnotrecommendedto“burnin”thePIPs.Leaveitasanadditionalimagefilethatcanbeaddedintheplaylist.sosfile.ThisgivestheusercompletecontroloverthepositionandsizeofthePIP.Ingeneral,nothingshouldbe“burnedin”totheframesforadatasetbecausePIPsprovideabetterwayoflabelingthedataset.APIPcanalsobeusedtoprovideaclose-upviewofaregionorgivethevieweradditionalcontextforwhattheyareseeing.Intheexampleatright,theunderlyingdatasetshowsthetracksofelephantsealsinred,andthePIPisapictureofactualelephantseals.MultiplePIPscanbeshownatthesametime,orstaggeredtocreateaslideshoweffect.MakesuretoconsidertheplacementofthePIPinordertonotblockinformationintheunderlyingdataset,especiallyifthePIPisdisplayedforanextendedperiodoftime.ByusingPIPsthatarePNG’swithatransparentbackground,manydifferentshapescanbeprojectedonthespherewiththeunderlyingdatasetasabackground.PIPscanbesettodisplayinspecificlocationsonthesphereasmarkers,asseenatright.HereeachpushpinisaPIPthatidentifiesthelocationofaSOSinstallation.

StandardPIPsshouldn’tbeanylargerthan1024x1024inresolutionsize.However,PIPsthataresettowraparoundtheentirespherecanbeupto4096x2048.BeawarethatoverlappingandwarpingcanoccurifthedisplaysizeofaPIPissettoolarge.Makesuretotesteachdatasetbeforedistributingittoothersites,checkingthePIPsize,placementandtiming.Thedisplaysizecanbeadjustedusingpipheightandpipwidth.PIPscanalsobeMPEG4filesorimagesequences.APIPcanalsobesettobeaSharedPIP,whichmeansthePIPwillremainactiveacrossmultipledatasetsinapresentationplaylist.Inaddition,areal-timevideofeedcanbeplayedinaPIP.ThisfeaturemaybeusefulforsitesreceivingSphereCasts,where,insteadofneedingaseparate

Page 6: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

6

displayintheSOSroomtoshowvideoofthehostsite’spresenter,thevideocanbeshowndirectlyontothesphere.Thisfeaturemayalsobeusefulifasitewantstoshowareal-timevideofeedofaremotepresenterontotheirsphereforaparticularin-housepresentation.

FulldocumentationofthePIPoptionscanbefoundinthePlaylistFormat:http://sos.noaa.gov/Docs/Playlist.html.AnnotationandIcons–InteractivelylabelingdatasetsTheSOSRemoteapp,throughtheannotationfeature,givespresenterstheabilitytodrawonthesphereandplaceiconsonthesphere.ThereisasetofdefaulticonsthatcomewiththeSOSRemoteapp.Inaddition,siteshavetheabilitytocreatecustomicons.Ifyouwouldliketocreateyourownicons,useatransparentPNGwithaminimumresolutionof256x256.Totherightisanexampleofoneofthedefaulticons.Customiconscaneitherbespecifiedforspecificdatasets,ormadeavailableinthedefaulticonlibrary.Layers–AddingflexibilitytothedatasetThelayeringcapabilityinSOSallowspresenterstodynamicallyturnlayersonandoff.Amulti-layerdisplaycanbecreatedeitherstaticallyinthedatasetdefinition,orinteractivelyusingSOSRemote.ByusingthenewLayerstabinSOSRemote,theusercantoggleindividuallayersonandoff,adjusttheleveloftransparencyofeachlayer,ordeletealayer.AnylabelsorPIPsassociatedwithacliparenowautomaticallyplacedindedicatedlayersnamedLabelsandPIPs.Thesecanbeinteractivelymanipulatedlikeanyotherlayer.Thereisanoverlaysdirectorythatincludescommonlyusedlayers,suchascountryborders.Belowisanexampleofadjustingthetransparencybetweentwolayereddatasets.

Warping–SomethingtobeawareofWhenworkingwithasphericalsurface,warpingisalwayssomethingtoconsider.Theleastamountofwarpingoccursneartheequator,whilethemostwarpingoccursatthepoles.Becauseofthis,itisrecommendedthatanytextandlabelsareplacedneartheequator.Supplementarytext,labelsandimagesthataredisplayedasPIPsdon’twarpiftheirpositionissetwiththepipcoordskeywordintheplaylist.DatasetscanbetestedforwarpingissuesusingCCSphereinAdobeAfterEffectsor3DSphereinPhotoshop.TherearesomepluginsforAfter

Page 7: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

7

EffectssuchasCycoreEffect’sSphereUtilitiesthatcanalsohelpwithsphericalwarping.Inaddition,theseprogramscanbeusedtocheckforseams.

ColorSuggestions Acolorscalecandramaticallychangetheemphasisandmessageofadataset.Becauseofthis,theScienceOnaSphereUsersCollaborativeNetworkhashadmanydiscussionsonthecolorscalesthatareusedforSOSdatasets.Thegoalistocreatedatasetswithwell-chosencolorscalesthataremeaningful,intuitive,andscientificallyaccurate.Severalconclusionsaretheresultofthesediscussions:

1. Itcanbeconfusingtouserswhenthesamecolorschemeandtheirassociatedcolorbarsareusedfortwocompletelyunrelateddatasets.

2. Thesamecolorshouldnotbeusedtorepresentmorethanonething.i.e.ificeisshadedwhite,thenwhiteshouldnotalsobeusedforareasofmissingdata.

3. Usingrainbow-coloredlegendsandcolorschemesisoftenconfusingtotheaudienceandhardtoparse.Instead,considerusingshadesofgreentorepresentphytoplankton,andblueandredgradationstorepresenttemperatureanomalies.i.e.use“meaningful”colors

4. Avoidusingfullspherebackgroundsthatarecompletelyorpre-dominantlywhite.Theseamsbetweenprojectorsbecomemoreapparentwhenusingsolidwhite/brightbackgrounds.Ifusingbrightbackgroundcolors,consideraddingsomenoise/texturetothem.SamegoesforPIPs,especiallythosedisplayedattheseamsbetweenprojectors.

ToolsUsed–TocreateScienceOnaSphere®visualizations

• BecauseScienceOnaSphere®usesbasicimageformatslikeJPEG,andPNGasitsmaininputformat,therearemanytoolsavailableforcreatingSOSdatasets.CommonexamplesarePhotoshop®,ImageMagick®,GIMP,etc.

• TheSOSsystemcomeswithascriptcalled“convert2mpeg4”toconvertanimagesequencetoanMPEG4

• ForcreatingMPEG4fileswithtransitions,specialeffectsandnarration,programssuchasFinalCutPro®andAdobeAfterEffects®areuseful.

• ToolslikeIDL,AWIPS,McIDAS,andotherimageanalysisapplicationsaretypicallyusedtocreateimageryfromscientificdatasets.Graphicsdesignerscanusea3Dmodelingapplications,like3DStudio®,tocreateadvancedvisualizations.

• GISprogramssuchasArcGISorQuantumGIScanbeusedtocreatemaps.AtutorialforcreatingSOSdatasetswithQuantumGISisavailablehere:http://sos.noaa.gov/Docs/qgis_tutorial.pdf.

Page 8: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

8

Part2–AddingaDataset

ContentMaterialsEverydatasetthatisaddedbytheusertotheSOSDataCatalogshouldbeinitsownindividualfolderinthedirectory/shared/sos/media/site-custom.AlldatasetsprovidedbyNOAAwillbeinthedirectoriesorganizedbycategory.Donotputyoursite-createdcontentintothefolderscreatedbyNOAA.Complimentaryorsimilardatasetscanbegroupedtogetherinafolderthatcontainsindividualfoldersforeachdataset.Eachfolder,atveryminimumshouldcontainaplaylist.sosfileandeitheranimage,imagesequenceorvideo.Inadditiontothoserequiredpieces,folderscanalsocontain:

• Image,ImageSequenceorVideo–required• Playlist.sosfile–required• Labelsandcolorbars• Audiofile• Picture-in-a-Pictureimages,imagesequences,and/orvideos• Scriptsorsupplementarymaterials• Mediafolderwiththumbnailsandvideos(typicallycreatedbytheSOSteam)

Page 9: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

9

IntheaboveexampleofaNOAAprovideddataset,therearethreedatasetsthatarerelatedandallfromthesamesource.Tokeepthemtogether,afolderwascreatedintheatmospherecategorycalledaerosol.Intheaerosolfolder,eachdatasetwasgivenitsownfolder:sulfate,blackcarbon,andblackcarbon_and_sulfate.Noticethattherearenospacesinthenames!Ineachoftheindividualdatasetfoldersthereisanimagesequencenamedfortheresolutionoftheframes,aMPEG4video,amediafolderwiththumbnails,acolorbar,labels,andaplaylist.sos.

Playlist.sosFileEverydatasetfoldermustcontainataminimumafilethatisnamed“playlist.sos”.Playlist.sosfilescanbegeneratedusingatexteditor,suchasNotepadorgedit.Therecanbemultipleplaylist.sosfilesinthesamefolder,suchasplaylist.sosandplaylist_audio.sos,aslongastheyreferencethesamedataset.Whenworkingwithmultipledatasets,theyshouldeachbeintheirownfolderwiththeirownplaylist.sosfile,asshownintheaerosolexample.Noplaylist.sosfileshouldpointtomultipledatasets.Inthisblue_marbleexample,therearetwoplaylist.sosfilesinthefolderfortheblue_marble

dataset,playlist.sosandplaylist_audio.sos.Bothplaylistspointtothesamedata,andtheonlydifferenceisthatoneincludesaudioandatimerandtheotherdoesn’t.Theplaylist.sosfilenamemuststartwithplaylistandendwith.sos,butanythingcanbeaddedbetween,suchas_audioor_with_PIPs.Noticethattheaudiofileshavebeenputintotheirownfolder.IftherearemultipleaudiofilesorPIPs,afoldercanbecreatedinthedatasetfolderthatcontainsthosefiles.Whilethisisn’trequired,ithelpstokeepthefolderuncluttered.Whenfilesthatarereferencedintheplaylist.sosaren’tinthesamedirectoryastheplaylist.sos,thepathtothefileneedstobeincluded.Takenoteintheplaylist_audio.sosfilehowtheaudiopointstoaudio/BlueMarble.mp3sincethemp3fileisn’tinthesamedirectoryastheplaylist.sos.Eitherrelativepaths(audio/BlueMarble.mp3)orfullpaths(/shared/sos/media/land/blue_marble/blue_marble/audio/BlueMarble.mp3)canbeusedintheplaylist.sosfiles.Becarefultoavoidtypos,asthedatasetwon’tworkifanythingiswrong!

Page 10: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

10

Therearemanyoptionalsettingsthatcanbeincludedintheplaylist.sosfile.Foradatasetaddedbyasiteintothesite-customfolder,atminimumtheplaylist.sosfileshouldcontainthefollowingelements:

name=MyCustomDatasetdata=4096.jpgcreator=MyMuseumsubcategory=landkeywords=land,Earth,MyMuseumdescription={{AdescriptionformydatasetthatwillappearontheiPad.Thedescriptionisallowedtospanmultiplelinesandmustusebeenclosedwiththebracescharacters.}}

Theplaylist.sosfileshouldbeformattedaccordingtothespecificationsfoundhere:http://sos.noaa.gov/Docs/Playlist.html.Inorderforanewdatasettoshowupinthesite-customlibraryonthelocalSOScomputer,makesuretoupdatethelibrarybyclicking“Library”>“UpdateLibrary…”intheSOSStreamGUI.Afteryouhaveupdatedthelibrary,youhavetoclickthe“UpdateNow”buttonintheSettingstaboftheiPadinorderforittoshowupontheiPad.ItwillnotappearontheiPadifitisnotstoredinthesite-customfolderonthecomputer.IntheDataCatalogtaboftheiPadyouwillbeabletofindthenewdatasetinthesubcategorythatyouassignedunderthesite-custommaincategory.Youcancreateasmanydifferentsubcategoriesasyoulikewithinsite-custom.Note:Inyoursite-customdatasetfolder,ifyouhaveadatasetplaylist.sosfileANDvariationdatasetplaylists,suchasplaylist_audio.sos,thesubcategorykeywordisignoredforvariationplaylists.Youmustincludethesubcategorykeywordintheplaylist.sosfileifyouwantthisdatasetanditsvariationstobedisplayedinaparticularSubCategoryoftheSite-CustomMajorCategoryontheiPad.Withoutthesubcategorykeywordintheplaylist.sosfile,thisdatasetandanyofitsvariationscontainedinitsfolderwillappearunderthe“Uncategorized”SubCategoryoftheSite-CustomMajorCategoryontheiPad.AcompletelistoftheNOAA-createdcategories,subcategoriesandkeywordscanbefoundhere:http://sos.noaa.gov/_downloads/docs/main-categories-subcategories-sos.pdf.IfyouwanttocontributedatasetstotheNOAAcatalog,youmustselectcategoriesandsubcategoriesfromthislist.Additionalkeywordscanbeaddedtothelistasnecessary.Asitecanalsoaddtheirowncustomthumbnailstoacustomdataset.Simplycreateafoldercalledmediaandputitinthesamefolderwherethedataset’splaylist.sosfileislocated.Themediafoldershouldcontaintwoimagesinthe.jpgformatwiththefollowingnamesandresolutions: thumbnail_small.jpg(128x128) thumbnail_big.jpg(800x800)

CustomOverlayDatasetsTheSOSDataCatalogincludesanumberofOverlaydatasets,suchasCityNames,CountryBordersandAtmosphericGeneralCirculation.Overlaysaredatasetswithtransparent

Page 11: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

11

backgroundsthatcontainforegrounddatausedtoaugmentotherSOSdatasets.Overlayscanhelpprovidecontextforyouraudienceandmakethedatasetseasiertounderstand,aswellasprovideinformationthatmaybeusefultoillustraterelatedglobalideas.Inversion5.1+oftheSOSRemoteApp,youcannowhaveyourcustomoverlaysappearintheOverlaysdialogoftheiPadappjustastheNOAA-managedoverlaysappearforeasy,dynamiclayering.Todothis:

1. Inyourplaylist.sosfile,addthefollowingkeyword-valuepair(thisisoptional;itallowsyouroverlaytoshowupintheoverlayscategoryinSOSStreamGUI’sLibrarymenu):category=overlays

2. Inyourplaylist.sosfile,addthefollowingkeyword-valuepair(thisiswhatmakesyouroverlayappearintheiPadapp’sOverlaysdialog):subcategory=Overlays

3. OntheSOScomputer’sSOSStreamGUIapplication,selecttheLibrarymenu>UpdateLibrarymenuoptiontoupdatetheDataCatalogwithyournewoverlaydataset.Oncethisiscomplete,ontheiPadapp’sSettingstab,selecttheUpdateNowbutton,andyouroverlaydatasetwillappearintheOverlaysdialogoftheiPad.

NotethatOverlaysmayalsobepre-programmedintoadataset’splaylist.sosfilebyusingthelayerkeywords.

WrittenMaterialInadditiontotheabovematerial,awrittendescriptionofthedataset,alistof“NotableFeatures,”andalistofcreditsarealsorequested.AllofthisdocumentationisusedtocreateanentryintheSOSDatasetCatalog,asseenatright.Thewrittendescriptionshouldbeasimpleoverviewofthedatasetthathighlightsthesourceofthedata,whetheritismodeledormeasured,whatitshows,andwhyit’simportant.Itshouldbeanon-technicaldescriptionthatiseasilyunderstood.The“NotableFeatures”isabulletedsummaryofthehighlightsfromthedescriptionthatpresenterscanusewhenshowingthedatasettoviewers.Thecreditsareusedtofillinthecolumnontheright-handside.Thecreditslistedare:

• DatasetSource• DatasetDeveloper• DatasetVisualizationDeveloper• Contact(optional)

Thesecanbethesameforeachlisting,oralldifferentandcanincludelinkstotheoriginalsources.Forexamples,visittheSOSDatasetCatalog:http://sos.noaa.gov/Datasets/index.html.

Page 12: Content Creation Guidelines Updated for SOS 5.1.0+ (08/2016)€¦ · Part 1 – Creating New Content Data Format There are two basic types of datasets for SOS: Texture - Single Image

12

PresentationPlaylistsTogroupmultipledatasetstogether,createaplaylist,suchashurricanes.sos,thatpointstoeachindividualplaylist.sosfilewiththefullpathincluded.Theseplaylistsaretobestoredin/home/sos/sosrcor/home/sosdemo/sosrc.Hereisanexampleplaylistthatgroupsmultipledatasetstogether:

Presentationplayliststhatgroupmultipledatasetstogethercanbenamedanythingaslongastheyendwith.sos.Playlistscaneitherbetypedbyhand,orcreatedusingthePlaylistEditorontheSOScomputer,thePlaylistBuilderonthewebsite,orthePlaylistBuilderontheiPad.InordertoseenewdatasetsinthePlaylistEditor,theupdatethelibraryintheSOSStreamGUI.

Anewfeaturefor4.3.0istheabilitytoaddpresenternotestoyourplaylists.PresenternotesareaccessedfromtheiPad’sSOSRemoteapp’sPresentationtab,andcanbeeditedeitherfromtheapp’sPlaylistBuildertab,ormanuallyusingatexteditor.Ifeditingaplaylistfilemanually,eachlinethatistobeapresenternoteshouldbeginwith“#>”.Presenternotelinesshouldgoattheverybottomofthepresentationplaylistasshownhere:include = /shared/sos/media/land/blue_marble/blue_marble/playlist.sos include = /shared/sos/media/astronomy/mars/original/playlist.sos #> Features to note about blue marble: #> - Shading done in true color: gives Earth's appearance from space #> #> Features to note about mars: #> - Olympus Mons: highest point in the solar system at 88,500 feet

MoreInformationonVisualizationConsiderationsThefollowingarticle,researchingthepublicunderstandingofsciencecontent,waswrittenbySOSUsersCollaborativeNetworkmembers:

Phipps,M.andRowe,S.(2010)SeeingsatellitedataPublicUnderstandingofScience.doi:10.1177/0963662508098684

include = /shared/sos/media/land/blue_marble/playlist.sos include = /shared/sos/media/atmosphere/carbon_tracker/playlist.sos include = /shared/sos/media/astronomy/mars/playlist.sos


Recommended