07Singularity Hub
Questions and fixes
The questions people ask most, answered plainly. Click a question to open it. If yours is not here, write to us: there are no silly questions.
Getting started
Where do I download Singularity?
From the Microsoft Store, free: Singularity by Antiproton (opens in a new tab). Or open the Microsoft Store app and search for “Singularity by Antiproton”.
Does it need the internet?
Only to download it. After that it works fully offline, with no account.
Does it run on Mac, Linux, phones or tablets?
Version 1.0 is for Windows 10 (1809 or newer) and Windows 11, 64-bit, on a computer with a keyboard and mouse.
It says “Starting Python 1/3… 3/3” for a while. Is it stuck?
No. Python is loading inside the app. The first start takes a few seconds; after that it is quicker. Wait for “Python ready”.
It feels slow on my old laptop.
World tab → Graphics → Fast. Close the windows you are not using (Camera, Plot). The simulation stays correct even on a slow computer; it just runs slower than real time (the number under the clock shows how fast).
Do I need to know Python first?
No. Lesson 01 starts from zero. If you know a little Python already, you will move faster.
Running programs
I pressed Run and the robot jumped back to the start.
That is on purpose: every test starts the same way. To start from where the robot is, choose World tab → When you press Run → Keep going from here.
My program does nothing, then ends.
A motion command starts the motors and the next line runs at once. Give it time: robot.forward(0.3) then robot.wait(2).
Is “while True:” safe? Will it freeze?
It is safe. Every time a loop that uses the robot goes round, the world takes one small step (1/120 s). Stop always works.
Stop did not work straight away.
If a program is busy somewhere it cannot be interrupted, Stop restarts the simulator after a moment. Your code is kept.
Where are my programs saved?
Automatically, on your computer, in the Files tab. ☰ → Save a copy (.py) writes a normal Python file you can keep or share.
Can I open a .py file from my computer?
☰ → Open program (.py), or Ctrl+O in the desktop app.
Sensors
What does inf mean in the LiDAR list?
Nothing was hit within range (3.5 m). It does not mean “very close”. Watch out when you use min().
The ultrasonic sensor says 2.0 but there is a wall right there.
Sound bounces off a wall hit at a steep angle and never comes back, so the sensor thinks nothing is there. Real ultrasonic sensors do the same. Face the wall more squarely, or use the LiDAR.
Why does the LiDAR not see the chair feet?
The LiDAR measures a thin flat slice 17.5 cm above the floor (21.5 cm on the Ranger). Anything lower is invisible to it. The ultrasonic sensors sit lower, and the bumper catches the rest.
robot.camera() gives None.
The camera switches on the first time you ask for a picture, so the very first call is None. Wait a moment and ask again. Also check the camera is on in the Robot tab.
find_color never finds my object.
Is it in view? The camera starts tilted 40° down at the floor; robot.tilt_camera(10) looks ahead. Is there light? Dim rooms need robot.headlights(1). Is the color right? Purple and blue, or orange and red, are neighbours: try both.
How far can the camera turn?
Pan from −150° (right) to +150° (left), tilt from −25° (up) to +70° (down). The servos move about 120° per second, so wait before you trust the picture.
My LED does not change.
One call works and the color stays. The usual reasons it seems not to: the LED starts teal-green (so "green" looks the same), Run and Reset set it back to teal, and it is small, so use the Chase view. Try robot.led("red"). See LED and headlights.
How accurate is robot.heading()?
Very, by default: there is no drift unless you add some in the Robot tab (Heading drift). Real IMUs drift, so try adding a little.
What is the difference between odometry, GPS, SLAM pose and true pose?
Odometry: from wheel turns, drifts slowly. GPS: a noisy position from outside. SLAM: matches the LiDAR to the map, small error. True pose: the exact answer, which only a simulator can give you, to check the others.
Maps, SLAM and A*
How do I turn SLAM on?
Map window → SLAM, or type ros2 launch singularity slam.launch.py in the Terminal.
Can I save the map?
There is no save button in version 1.0. The map stays in memory while SLAM is on. To keep it, print it as text and paste it back later: Saving a map and loading it later.
My map disappeared when I pressed Run.
In the default Start over mode, Run sends the robot back to its start, so SLAM starts a fresh map. Use Keep going from here to keep it.
How big is one map cell?
5 cm × 5 cm. A 5 × 5 m world gives a 130 × 130 cell map.
Is there a built-in path planner?
A built-in lesson is still in development, but a complete A* navigation program that works today is on page 03.
The A* robot says “No path”.
The goal may be too close to a wall, or the way there narrower than the robot plus its safety margin. Click somewhere more open, or lower ROBOT_RADIUS a little (not below 0.2 for the Scout).
ROS
Is this real ROS?
It is a built-in message bus that behaves like ROS 2 and ROS 1, with the same topic names, message types and commands. It is not a ROS installation, so you cannot connect real ROS computers to it, but your node code moves to a real robot almost unchanged.
ROS 1 or ROS 2?
Both work. Use ROS 2 (rclpy) unless your course uses ROS 1 (rospy): ROS 1 has reached its end of life.
Where do I see my nodes and topics?
The Graph tab, or ros2 node list and ros2 topic list in the Terminal.
Can I use OpenCV or SciPy?
Not in version 1.0 (NumPy is included). They are planned for a later version.
Real robots
Can I control a real robot from Singularity?
No. Singularity is for learning and testing. You take your code and your understanding to the real robot: see page 06.
Which real robot is closest to the Scout?
A TurtleBot3 Burger, or any small two-wheel robot with a LiDAR. Singularity uses the same topic names as the TurtleBot3.
What should I buy first?
For a first robot: an Arduino, two gear motors with a driver board, an HC-SR04 and a battery. For ROS 2 and SLAM: a Raspberry Pi 4 or 5, a small LiDAR (RPLIDAR A1 or LD06) and motors with encoders.
Contact
Something is wrong, or I have an idea.
Email antiprotontechnologies@gmail.com. In Singularity, ☰ → Help & Support → Copy details for support, and paste that into your email.
Does Singularity collect my data?
No. Nothing leaves your computer. Read the privacy policy.
Stuck on something this page did not answer? Write to us at antiprotontechnologies@gmail.com. Paste what you tried and what happened (the Copy details for support button in Singularity’s Help & Support window helps us a lot).