Spécification de Carte AprilTag

La fonctionnalité de localisation dans l'espace du terrain de Limelight utilise des fichiers .fmap pour calculer une pose de robot à utiliser par les estimateurs de pose de WPILIB. Nos fichiers fmap prennent en charge des cartes composées de différentes tailles de cibles et de différentes familles.

Vous pouvez utiliser les fmaps pour définir des "environnements" tels que des terrains FRC, ou des "objets" tels que des objets ayant plusieurs AprilTags attachés. Pour utiliser un fmap, il vous suffit de le téléverser sur votre Limelight en utilisant l'interface ou l'API REST de téléversement.

Le fichier .fmap est un fichier JSON contenant un seul tableau "fiducial". Chaque entrée dans le tableau fiducial a la structure suivante :

family	Famille AprilTag/Fiducial
id	ID du Tag
size	Taille du tag en mm
transform	Matrice de transformation 4x4 de la cible. Ordre ligne-majeur, unités SI.
unique	Spécifie si la cible est unique dans cette carte ou présente plusieurs fois

De plus, l'objet de niveau supérieur possède une chaîne "type" spécifiant le type de carte.

type	Type de terrain, par ex. frc, ftc, ftcd (ftc diamant)

Carte AprilTag pour FRC 2024 Crescendo - Crédit à Kevin Hjelstrom

{
    "type": "frc",
    "fiducials": [
        {
            "family": "apriltag3_36h11_classic",
            "id": 1,
            "size": 165.1,
            "transform": [
                -0.5,
                -0.866025,
                0,
                6.808597,
                0.866025,
                -0.5,
                0,
                -3.859403,
                0,
                0,
                1,
                1.355852,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 2,
            "size": 165.1,
            "transform": [
                -0.5,
                -0.866025,
                0,
                7.914259,
                0.866025,
                -0.5,
                0,
                -3.221609,
                0,
                0,
                1,
                1.355852,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 3,
            "size": 165.1,
            "transform": [
                -1.0,
                0,
                0,
                8.308467,
                0,
                -1.0,
                0,
                0.877443,
                0,
                0,
                1,
                1.451102,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 4,
            "size": 165.1,
            "transform": [
                -1.0,
                0,
                0,
                8.308467,
                0,
                -1.0,
                0,
                1.442593,
                0,
                0,
                1,
                1.451102,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 5,
            "size": 165.1,
            "transform": [
                0,
                1.0,
                0,
                6.429883,
                -1.0,
                0,
                0,
                4.098925,
                0,
                0,
                1,
                1.355852,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 6,
            "size": 165.1,
            "transform": [
                0,
                1.0,
                0,
                -6.429375,
                -1.0,
                0,
                0,
                4.098925,
                0,
                0,
                1,
                1.355852,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 7,
            "size": 165.1,
            "transform": [
                1.0,
                -0.0,
                0,
                -8.308975,
                0.0,
                1.0,
                0,
                1.442593,
                0,
                0,
                1,
                1.451102,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 8,
            "size": 165.1,
            "transform": [
                1.0,
                -0.0,
                0,
                -8.308975,
                0.0,
                1.0,
                0,
                0.877443,
                0,
                0,
                1,
                1.451102,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 9,
            "size": 165.1,
            "transform": [
                0.5,
                -0.866025,
                0,
                -7.914767,
                0.866025,
                0.5,
                0,
                -3.221609,
                0,
                0,
                1,
                1.355852,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 10,
            "size": 165.1,
            "transform": [
                0.5,
                -0.866025,
                0,
                -6.809359,
                0.866025,
                0.5,
                0,
                -3.859403,
                0,
                0,
                1,
                1.355852,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 11,
            "size": 165.1,
            "transform": [
                0.5,
                0.8660254,
                0,
                3.633851,
                -0.8660254,
                0.5,
                0,
                -0.392049,
                0,
                0,
                1,
                1.3208,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 12,
            "size": 165.1,
            "transform": [
                0.5,
                -0.866025,
                0,
                3.633851,
                0.866025,
                0.5,
                0,
                0.393065,
                0,
                0,
                1,
                1.3208,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 13,
            "size": 165.1,
            "transform": [
                -1.0,
                0,
                0,
                2.949321,
                0,
                -1.0,
                0,
                -0.000127,
                0,
                0,
                1,
                1.3208,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 14,
            "size": 165.1,
            "transform": [
                1.0,
                -0.0,
                0,
                -2.950083,
                0.0,
                1.0,
                0,
                -0.000127,
                0,
                0,
                1,
                1.3208,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 15,
            "size": 165.1,
            "transform": [
                -0.5,
                -0.866025,
                0,
                -3.629533,
                0.866025,
                -0.5,
                0,
                0.393065,
                0,
                0,
                1,
                1.3208,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        },
        {
            "family": "apriltag3_36h11_classic",
            "id": 16,
            "size": 165.1,
            "transform": [
                -0.5,
                0.866025,
                0,
                -3.629533,
                -0.866025,
                -0.5,
                0,
                -0.392049,
                0,
                0,
                1,
                1.3208,
                0,
                0,
                0,
                1
            ],
            "unique": 1
        }
    ]
}