Shira Dome Console User Guide Ver2.0 EN
Shira Dome Console User Guide Ver2.0 EN
Shira Dome Console User Guide Ver2.0 EN
2023
Sureyyasoft
Planetarium
Shira Dome Console v2.0
Technologies
User Guide
Asaf Yurdakul
Shira Dome Console User Guide 2023
Contents
Introduction ........................................................................................................................................... 3
Key Features....................................................................................................................................... 5
Controls of All Objects Are Provided on a Single Screen ..........................................................................5
Detailed Location Selection and Time Control on the Online Map ......................................................5
Existing and User Addable Bookmarks ...........................................................................................................6
Examining Space Missions via Profiles ............................................................................................................6
Display of current data from Data2Dome and APOD provided by ESO .............................................7
Ability to record and replay all events ............................................................................................................7
Software Installatıon ............................................................................................................................. 8
System Requırements ........................................................................................................................ 8
File Download .................................................................................................................................... 8
Loading ............................................................................................................................................... 8
Lıcence and Terms of Use.................................................................................................................. 8
Preview Window ................................................................................................................................. 8
The information in the upper left corner shows the distance to the target object, the latitude
longitude height on the spherical object and the simulation time. .................................................. 10
Control Window ................................................................................................................................ 11
Settings .............................................................................................................................................. 11
License Manager................................................................................................................................ 12
Manager Windows ................................................................................................................................ 13
Open Space........................................................................................................................................ 13
Display Options ...................................................................................................................................................... 13
Exoplanets ................................................................................................................................................................ 26
DateTime & Location Settings .......................................................................................................................... 32
Bookmarks – Scale ............................................................................................................................. 35
Bookmarks ............................................................................................................................................................... 35
Scale ............................................................................................................................................................................ 37
Profıl and Mıssıons ............................................................................................................................ 38
Data2Dome........................................................................................................................................ 39
Script Manager .................................................................................................................................. 43
Open Space Recoring Utilty ............................................................................................................................... 43
Shira Javascript based command files .......................................................................................................... 44
2
Shira Dome Console User Guide 2023
INTRODUCTION
Shira Dome Console is a total solution application especially for stationary planetariums.
"Shira Presenter" 8K Fulldome Player and "OpenSpace" Space Engine (MIT License) were
combined under a single program, resulting in "Shira Dome Console".
The application uses the Shira Presenter sub-application to achieve media playback, various
visual effects and projector output. For detailed information about Shira Presenter
https://www.sureyyasoft.com/index.php/en/planetarium-shiraproject/domeplayer
3
Shira Dome Console User Guide 2023
It uses OpenSpace infrastructure for application for space studies and astronomy education.
OpenSpace is open source interactive data visualization software designed to visualize the
entire known universe and depict our ongoing efforts to explore the universe.
The foremost “Science Board Partner” of the application is the American Museum of Natural
History (AMNH).
The American Museum of Natural History (AMNH) is one of the largest natural history
museums in the world. The museum has a full-time scientific staff of 200 active researchers,
collections of more than 33 million plant, animal, mineral and cultural artifacts, and digital
collections that include astrophysical data, molecular and genomic sequences, and satellite
imagery. AMNH has a distinguished history as a leader in science visualization technology
designed to convey sophisticated science concepts to a general audience. The museum also
has a long history of successful partnerships with NASA, advancing science education for
local and international audiences.
https://www.openspaceproject.com/
Control of all the features provided by the OpenSpace program can be done from within the
Shira Dome Console.
In this user manual, explanations will be made on the Shira Dome Console interfaces, which
mainly manage the OpenSpace application. Help information about the Dome Player can be
accessed from the owner's manual in Shira Presenter.
Note: The abbreviation SDC will be used instead of Shira Dome Console in the following
pages of the document.
4
Shira Dome Console User Guide 2023
KEY FEATURES
5
Shira Dome Console User Guide 2023
6
Shira Dome Console User Guide 2023
Display of current data from Data2Dome and APOD provided by ESO
7
Shira Dome Console User Guide 2023
SOFTWARE INSTALLATION
SYSTEM REQUIREMENTS
Operating System: Windows 7 / 8.1 / 10 / 11, 64-bit
Display Card: min. for best performance. 2GB RAM NVIDIA / Quadro or GeoForce
series recommended. There have been trials with the ATI Radeon/FireGL series.
However, the results on ATI may not be known in advance, as NVIDIA compatible
commands are used as the shader language.
FILE DOWNLOAD
In general, all Shira products must be registered on SureyyaSoft site, follow the
activation mail and download the relevant program from the Downloads menu.
("ShiraDomeConsole.rar for SDC")
LOADING
The downloaded "ShiraDomeConsole.rar" compressed file is unpacked as a folder.
The opened files are available in the following files:
- The "bin" file path contains all necessary files for the "Shira Dome Console" to
work.
The Shira Dome Console requires a commercial license for use in the planetarium
dome. While SDC is running, SureyyaSoft logo is displayed on the projector screen.
SDC has two types of licensing features: single and multiple projector licenses. This
logo displayed in the background indicates that the product is not yet licensed by
SureyyaSoft.
PREVIEW WINDOW
8
Shira Dome Console User Guide 2023
There are two preview windows in SDC, the first is the main screen offered by OpenSpace. Here the
image is taken for a single compass direction. Rotation, Zoom, Roll effects cannot be applied with
mouse control.
With these three controls, movements initiated by the mouse are allowed to be
damped by the effect of friction, or by deselecting (by clicking) the effect of
friction is removed.
9
Shira Dome Console User Guide 2023
With the compass direction buttons, the view direction angle is changed with the flight movement
effect.
The second preview screen is the one presented by Shira Presenter. There are 4 types of previews
available. Mouse controls here will not affect the Open Space screen.
The information in the upper left corner shows the distance to the target object, the latitude
longitude height on the spherical object and the simulation time.
10
Shira Dome Console User Guide 2023
CONTROL WINDOW
Stops OpenSpace rendering. Its purpose is to stop the GPU operations that
would be unnecessary when any video playback starts by “Shira Presenter” so
that the video performance is not affected. This is done automatically when the
video is started with “Shira Presenter”. At the end of the video, if the loop
option is not selected, it is automatically clicked to start the OpenSpace
rendering process.
SETTINGS
11
Shira Dome Console User Guide 2023
Open Space
Output Quality : Open Space determines the output render resolution. Selection is made
between 1K and 8K. The performance of the hardware should be taken into account when
selecting the value.
Tilt Angle: A value between 0-45 degrees can be given according to the tilt angle of the
projection dome. When 0 degrees is selected, the output performance will be higher.
WMS Cache Enabled: In OpenSpace, the data received from the Web Map Title service is
selected to be kept in the cache.
Offline Mode: Allows OpenSpace to continue running without a request to retrieve data over
the internet. In this case, the cached data is shown.
Web Remote Control: Activates the SDC to be controlled on another device (PC, Table, IPAD,
phone) over the network via the web interface.
Map Control
Use Software OpenGL : When this option is selected, the map control on the "Date, Time and
Layout" screen in SDC is enabled to use software-based screen commands, not hardware. This
option has been added because some computers have problems with remote access controls.
This option should be selected in order to save the last states of the features
when exiting the SDC and start with these states at power-on again. (Some
features are exempted from status registration processes.)
LICENSE MANAGER
12
Shira Dome Console User Guide 2023
The license file provided by Sureyyasoft is installed in this management window or the existing
licenses are removed. Multi-projector applications require a license for each projector. A single
license file contains licenses for all projectors.
MANAGER WINDOWS
OPEN SPACE
Display Options
General Features
Take Off /Landing:
Spaceflight mode is a viewing format that allows viewing target objects from
space. On the other hand, the ground mode is the display format that makes
the observation point to be the sky over the target point by landing on the
target objects. Earth mode only applies to planets and Moon.
Compass Marks
13
Shira Dome Console User Guide 2023
Planet Zoom Rate
There are five different zoom options to
make the planets look closer when looking at
the entire Solar system
Grids
OOrt Grid: It is the grid drawn centered on the comet cluster (OOrt) orbiting
the Sun.
14
Shira Dome Console User Guide 2023
Planes
15
Shira Dome Console User Guide 2023
Sun
Sun simulation is provided by a star globe (Sun Disk) representation and a flash of light (Sun Glare).
Also, as can be seen on some other settings screen, there are Target selection button,
Current target name and Information button under the "Target Properties" group.
Target Button: When clicked, a flight is made to the relevant object and the
camera is positioned in a close position.
16
Shira Dome Console User Guide 2023
Gezegenler
High Resolution: With the button, high resolution topology and texture
information of Mars and Mercury is activated.
Color Shaded: Makes the surface texture appear mixed with color
shadows for Mars, Mercury, and the Moon.
17
Shira Dome Console User Guide 2023
Global Illumination: The general lighting feature for Earth, Mars, Venus,
Saturn and Titan satellites is turned on.
Planet Settings
18
Shira Dome Console User Guide 2023
Landscape type and type-dependent landscape view selection for the world is also made
from this window. Landscape Type is two. Panorama and Terrain view.
With the Panorama option, panoramic views that the user can upload themselves can be
selected.
Under the "Target Properties" group are the Target selection button, Current target name
and Information button.
Satellites
Artificial satellites
19
Shira Dome Console User Guide 2023
Artificial satellite settings
20
Shira Dome Console User Guide 2023
Dwarf Planets
Here, the orbital characteristics of six Dwarf planets can be changed, as well as the target object
selection.
Comets
Note :
In the "Profile and Missions" section, which will be explained in the next sections, it is seen
that this field is active when the "Load on boot" option of the "Asteroids & Comets" profile is
selected and the SDC is restarted.
Comets Settings
When the Settings button is clicked, the orbital colour and orbital line thickness of the
selected comet group in the list and the maximum upper limit number to be displayed are
set in the window that opens.
Asteroids
22
Shira Dome Console User Guide 2023
Interstellar Objects
2 separate interstellar objects "Oumuamua" and "C2019Q4 Borisov" display and settings are
made in this section.
Interstellar Settings
Milkyway
The signs and labels of the following other objects in the Milky Way are shown.
Brown Dwarfs:
Global Clusters:
HII Region:
OB Assoc.(Young Star groups)
Open Star Clusters:
Planetary Nebulae:
Pulsars:
Supernova Remnant:
23
Shira Dome Console User Guide 2023
Constellations
Artistic images of constellations, line views, labels and border lines can be made collectively
through these controls.
Constellations Settings
By clicking the
Settings button, 3
different
constellation views
can be selected in
the window
opened, as well as
Color, Line
thickness and
Transparency values
can be adjusted.
In addition,
selections can be
made with 4
different group
buttons.
24
Shira Dome Console User Guide 2023
Johannes Hevelius
Western Color
25
Shira Dome Console User Guide 2023
James Hedberg
Exoplanets
26
Shira Dome Console User Guide 2023
Exoplanets Settings
Exoplanet Options:
Color settings of Exoplanet
and Kepler Planet Candidates
signs and labels are adjusted.
27
Shira Dome Console User Guide 2023
Stars
Tags with asterisks, tags and alternative names are controlled here.
The orbits of the Sun, Bernard, Kapteyn, Lacaille, LSR1826, LSRJ0822 and PM_J13420, which are the
closest stars to the Earth, are displayed with these controls.
Stars Settings
Universe
28
Shira Dome Console User Guide 2023
Quasar settings
29
Shira Dome Console User Guide 2023
30
Shira Dome Console User Guide 2023
6dF : Six Degree Field Galaxy Survey
Gökada Etiketleri
31
Shira Dome Console User Guide 2023
DateTime & Location Settings
With this window, settings such as date time settings, time speed and location mode location
selection are made.
DateTime Window
The desired date and time are set in the program. Time information must be entered as UTC. The
way to move to the selected date is done immediately if "Interpolation" is not selected. If selected,
the time flow is accelerated and access to the desired date is provided.
32
Shira Dome Console User Guide 2023
Speed
In this window, the flow direction and speed of the simulation history are determined. It is stopped if
necessary.
Time stops.
Date and Time takes the location information from the system clock and
sets it to the current UTC time.
33
Shira Dome Console User Guide 2023
Location
In the Landing Mode, the coordinates of the observation point on the target object are
determined in this window. Manual selection can be made from the Latitude and Longitude
drop-down box controls, or it can be selected by searching for the desired location from the
search text box. In addition, latitude/longitude selection can be made by clicking the mouse
on the map. With the World selected as the target, detailed zoom can be made on the map.
The earth map changes according to the target object. When the target object is Planets or
the moon, the relevant object's map is displayed. In other cases, a blank map screen results.
34
Shira Dome Console User Guide 2023
The location changed with the Flight or Fast pass option can be
reached in two different ways.
BOOKMARKS – SCALE
Bookmarks
This window is used for quick access to certain objects..
Groups as Earth, Earth, Moon, Europa, Messier, Stars, Galaxies have been defined ready-made by the
system and related targets have been placed.
Users can place their own quick access targets under the groups they want or add new groups they
will create.
The button is used for this. When the Add button is clicked, the relevant fields are filled in the
window that opens on the screen.
35
Shira Dome Console User Guide 2023
Group Name: The group name
where the target shortcut will
reside.
When other selection is made (star etc.), X, Y and Z coordinates are entered.
When the “OK” button is pressed, the new destination is added to the Shortcut list and the list is
updated.
If the target is a spherical object (planet, satellite, etc.), the current latitude,
longitude and altitude values of the camera are taken automatically.
Shortcuts are actually a global grid created for the specified target.
The globe bounds selection box also provides the appearance of this
spherical grid..
36
Shira Dome Console User Guide 2023
The appearance of the spherical grid created by the shortcut
Scale
Within the scaling window, there are buttons that can be scaled from
1 light day to 20 G-light years.
Note: When the scaling button is clicked, the World is targeted and
the world referenced scaling is performed.
37
Shira Dome Console User Guide 2023
Different profile definitions that come with OpenSpace have been developed and
implemented in SDC.
A little different from the way it works in OpenSpace, the profiler in SDC has been developed
in a structure that allows access to the actions of the loaded profile after the planetarium is
opened with the location mode in the general usage features. Extra was only allowed to load
on boot to one additional profile.
When any profiling "Load on startup" feature is selected, a message is displayed on the
screen and a warning is given that the profiling program will be active when it is restarted.
38
Shira Dome Console User Guide 2023
1. Asteroids & Comets : When the Meteors and Comets profile is selected, the
corresponding buttons in the View settings become active. Meteorites and comets
are displayed.
2. Mars2020: Simulates the landing of the rover called Perseverance, designed for Mars,
to the Martian surface.
3. Insight (Discovery Mission): Simulates the landing of the Insight rover on the surface
of Mars.
4. James Web Telescope : Contains animations of JWT space telescope's orbital
placement and positioning of its panels.
5. Apollo Missions : Simulates the missions of Apollo 8,11 and 17 from earth to launch
and landing on the lunar surface.
6. Dawn Mission : Includes mission simulation of Dawn satellite reaching Vesta
meteorite.
7. Juno Mission: Simulates the mission of the Juno satellite sent to gather detailed
information about Jupiter.
8. Messenger Mission: Simulates the mission of the Messenger satellite orbiting
Mercury to gain detailed information about Mercury.
9. New Horizons : Simulates the mission of the satellite vehicle that has provided us
with information about Pluto and nearby dwarf planets.
10. Osiris-Rex : Simulates the mission of the satellite craft, which was produced to take a
sample by landing on the meteorite named Bennu.
11. Voyager missions: Simulates the space mission of the Voyager 1 and 2 spacecraft,
which has provided us with information about our solar system over 40 years.
Detailed information about profile and tasks. can be obtained by clicking the buttons.
Note: During the use of profiles, a computer with memory hardware higher than 16GB ram
may be required.
DATA2DOME
The Data2Dome service is a data standard for dome display developed by the European
Southern Observatory (ESO). (https://www.eso.org/public/outreach/data2dome/).
The Data2Dome feature is a content distribution and publishing standard for seamlessly
bringing astronomy data to planetarium systems in real time. Detailed information on the
subject can be found on the website of the International Union of Planetariums (IPS). (
http://www.ips-planetarium.org/?page=data2dome )
39
Shira Dome Console User Guide 2023
Sureyyasoft company integrated Data2Dome (D2D) work into ShiraUniverse (other product)
and became one of the developers supporting Data2Dome work. This feature was also
integrated into SDC and its contribution to the D2D project was continued.
Content supported by D2D
- Flat, Fisheye and Panoramic (Equirectangular) images
- Flat and Fisheye videos.
Warning: "Data2Dome" feature requires active internet connection.
SDC is in D2D content list tree view and gets online from the service addresses in the web
file specified in the "d2dFeeds.txt" file in the "Data2Dome" folder. Web services that will
provide other Data2Dome services in the future can be added to this list.
The separation bar on the right of the list can be pulled to the left to increase the usage area
40
Shira Dome Console User Guide 2023
Each sub-branch data list clicked in the content list is pulled from the web service. 100
records are displayed on each page. Records include "Title, Creator, Upload Date, and
Projection Type" fields.
: For retrieving data. Daily data can be obtained by clicking this button.
By selecting the data row that you want to be displayed, you go to the "Playback options"
section.
41
Shira Dome Console User Guide 2023
42
Shira Dome Console User Guide 2023
SCRIPT MANAGER
OpenSpace's own recording tool is available here. As soon as the recording is started, all
operations performed on the openspace screen are recorded as text files in a readable
format.
43
Shira Dome Console User Guide 2023
Export the selected record's execution commands to the "Shira javascript Console".
When you want to start the recording process with the start recording button, the name of
the new recording file that will be uniquely entered should be entered in the window that
opens.
"Record name" and "Record duration" information is displayed on the file icon that occurs
when the recording is completed. To run this record again, it is sent as a code to the
Javascript field with the selected record button . The posted code block is executed
there.
44
Shira Dome Console User Guide 2023
This tool is obtained by rebuilding the script library using OpenSpace Lua language using
Javascipt language.
All commands in the Open Space Lua script library are supported.
However, for OpenSpace, firstly, register with "Open Space Recorder" and
core.runARecordSession('Rec1'); We recommend playing the OpenSpace recording related
to the command. At the points where this file is insufficient, javascript commands can be
used in between.
The Open Space scripting language library html-based help file can be accessed from the
following file path in the folder where the SDC is located..
ShiraDomeConsole\Packages\OpenSpace\documentation\index.html
Except for the OpenSpace library, the following commands are supported.
core. runARecordSession(‘RecordName’) : The OpenSpace log file is run, after the time
expires, the next script is passed.
- Existing script files in the "\scripts" folder are listed in the list on the left. The script file
extension is ".sds".
- User can create user-defined buttons and assign events in "Script Frame" using script
commands.
45
Shira Dome Console User Guide 2023
function buttonClick(isChecked)
{
if(isChecked) {
openspace.setPropertyValue("Scene.Constellations.Renderable.Fade",0);
openspace.setPropertyValue("Scene.Constellations.Renderable.Enabled",true);
openspace.setPropertyValue("Scene.Constellations.Renderable.DrawElements",true);
openspace.setPropertyValue("Scene.Constellations.Renderable.Fade",1,2);
}
else {
openspace.setPropertyValue("Scene.Constellations.Renderable.Fade",0,2);
}
}
btn.clicked.connect(buttonClick);
Constellation lines are opened and closed with the button created with this script command.
Asaf Yurdakul
www.SureyyaSoft.com
46