citros 0.0.1

A cli entrypoint for the citros system.

cli

CITROS cli

Commands

• citros init
• citros doctor
• citros run
• citros batch
• citros data
• citros report
• citros observability

---

initialization

analyze the ROS2 project and initialize the .citros folder with all the files needed to operate citros

citros init 
    [-d | --destination] <repository folder>

doctor

checks for problems in .citros folder and suggests fixes

citros doctor
    [-d | --destination] <repository folder>

Run

starts a simulation locally or on remote

citros run
    [-gh | --github] #iniate an action that will runs the simulation on github as a workflow. 

    [-c] #completions

    [-o] #destination folder defaults to .citros/runs

    [-D] #dockerized - we will run dockerzed version of the simulation (can run parallel simulations on the same machine)

    [-p] #parallelism ? do we need it or can we know how many cpu available and devide it by the requested number of cpus per cpu 8 (available cpu) / 2 (requested cpu) = 4 (number of parallel runs)

    [-r] #remote run

    [-s] #simulation name

    [-t] #time limit

    [-v] #verbose

    [-w] #workflow

Batch

all batch operations

#get the data for a batch run
citros batch get <id>

#lists all batches + status
citros batch list

# delete a batch run
citros batch delete <id> | <simulation>/<name>

Data access

This DB will be used wo store the indexed bags for the

# starts server to listen for data access requests.
citros data access
    [-p] #port
    [-v] #verbose
    [-D] #dockerized

# prints the available data (db status) size, mem, how many batches loaded, etc...
citros data status

# create a new DB instance 
# creates all permissions and tables needed for CITROS
citros data create
    [-n] #name of the DB
    [-p] #port of the DB
    [-u] #user of the DB
    [-P] #password of the DB
    [-v] #verbose
    [-D] #dockerized

# clean the DB from data that wasend used for more then -d days -h hours -m minutes
citros data clean
    [-d] #days
    [-h] #hours
    [-m] #minutes
    [-v] #verbose
    [-D] #dockerized

REST API details

The user can check the availability of the data in a rest api that will be created by the service.

check the availability of the data

GET http://{domain}:{port}/{batch run name}

{
    "status": "unloaded",
    "last access": "2020-01-01 00:00:00",
    ...
}

request access for batch run

POST http://{domain}:{port}/{batch run name}

{
    "status": "loading",
    "last access": "2020-01-01 00:00:00",
    ...
}

Reports

A report is a signed set of generated notebooks with batch run data. this report can be shared trough CITROR or sent as a file.

# generate a signed report from a list of notebooks and use the data from the batch run specified.
citros report generate notebook.ipynb simulation/batch_run_name

# generate a report from report_name as specified unser .citros/reports/report_name.json
citros report generator report_name

Observability

start a node that will measue system / ros metrics and publish all to a topic

citros observability
    [-c] #channel
    [-t] #topic
    [-v] #verbose

CITROS CLI Overview

Welcome to Citros CLI. Citros serves as an innovative platform for executing ROS project simulations, automating integration, and conducting in-depth performance analysis.

The Citros CLI offers ROS 2 developers a seamless interface to launch multiple ROS simulations for a specific project with just a single command. Beyond setting static parameter values, it empowers users with the flexibility to utilize function objects. This means you can craft dynamic simulation environments where each execution produces unique parameter values, whether they're sourced from standard numpy functions or tailored via user-defined computations. Moreover, these operations can be executed offline without relying on any external dependencies.

Citros takes its capabilities a notch higher when the user logs in. Once logged in, users can tap into the full potential of Citros, ranging from running parallel simulations in the cloud to utilizing advanced data analysis tools for performance examination. Additionally, automatic report generation is a standout feature, aiding in effortless documentation of your work. Beyond these technical perks, logging in also paves the way for collaborative work, allowing you to engage and exchange ideas with team members.

For additional information, please refer to the Citros documentation. This will provide you with comprehensive insights and detailed instructions for effective usage of Citros in general and Citros CLI in particular, and their full suite of features.

We are dedicated to enriching your ROS project simulation experience, and this package is our contribution to that cause.

Table of Contents

1. Quick Start
2. Installation
3. CLI Commands
4. Citros Repository directory and file Structure
5. Citros Repository Configuration
6. User Templates