Skip to content

How Post cleans a take ​

A take is one recorded motion-capture performance: one file, one shot, one or more performers. Kapnetix Post cleans takes, and it does that in four moments, always in this order: diagnose, plan, run, review. Each moment has a page of its own below.

Diagnose ​

Every take you upload is diagnosed automatically. A diagnosis is a read-only pass over the file. Post reads the take, finds the gaps, swaps, merges and jitter in it, and writes down what it found. Nothing in your file is changed by a diagnosis.

The diagnosis gives the take two figures.

The first is a confidence figure. It says how cleanly Post expects to be able to fix the take. It is not a measure of how broken the take is.

The second is a Cleanup forecast. It says how much work the take is going to be, in one of four words: OK, Review (predicted), Significant effort or Manual. Those four words are called bands. Each shoot day gets a line above the take list that adds the bands up, so you can see how much work a day needs before you spend any time on it. See Cleanup forecast.

The Diagnose screen is where you read a diagnosis. It shows what was found, before anything has been changed.

Plan ​

The Clean screen is where you launch a cleanup. It has two modes. Auto cleans every take in To clean without asking you anything. Assisted is the mode where you choose the options for each take yourself.

Tick a take on the Clean screen in Assisted mode and a third column appears. It is that take's Cleanup Plan: the list of steps Post will take on the take, in the order it will attempt them, and what each step is waiting on. The plan is built from that take's own diagnosis, so no two takes get the same one. See The Cleanup Plan.

Run ​

Launch the run and the same plan lights up as steps finish. Your raw capture is the file you uploaded, and it is never touched. Every run lands beside it as a new version, named Clean v1, then Clean v2, and so on.

The two things the run is most often asked about have a page each.

  • Jitter: cut, not smoothed over covers what the jitter sensitivity does. That is the setting on the Clean screen which decides how small a jitter has to be before Post leaves it alone. The page also covers the two rules that never move.
  • Fills, seams and holes covers how a gap is filled, how the joins are conditioned, and when Post leaves a hole open on purpose. A fill is the motion Post writes into a gap. A seam is the join at the edge of a stretch of frames Post wrote.

Review ​

The Review screen shows the measured result. On it you get a verdict, the Cleanup Plan filled in with what actually happened, an Audit block, and a section headed What the AI changed · per region. A region is one span of frames on one marker that Post worked on, and that section gives you one card per region. Each card says what changed, names the model that produced it, and carries a Revert button.

Deciding each region and approving the take ​

The regions you should look at are listed first, under Needs your eyes. A region is listed there when Post could not finish the repair on its own, when the repair needs checking by eye, or when the repair scored in the Manual band (under 55). The word Manual always means that a person has to look at the region, so a repaired region with a Manual score is listed here too and counted in every "regions that need eyes" figure.

The Review screen has three columns. On the left is the queue: the take you are reviewing, with Previous take, Next take and All takes, which lists every cleaned take with what is left to do on it. Under the take, its regions are listed in groups. Needs your eyes comes first. Repaired and verified is closed until you open it, and the screen keeps it the way you left it until you close the browser tab. The group headings stay at the top of the list while you scroll. In the middle is the viewer. When you open a region, the viewer frames its marker and loops the region with 10 frames before and after it, so you see the result inside the motion around it. Space plays and pauses the loop, and Whole take plays the whole take instead. The timeline under the viewer marks every region of the take, the ones that need your eyes in the colour of their band and the repaired ones in grey, with the loop drawn over them. Under the viewer, the trajectory of the selected marker shows the region shaded and the loop marked.

On the right is the panel for the selected region. It names the marker, the performer and the frames, shows the band, and says what the cleanup did. Under that is one line saying what to do with the region. For a region to check, it reads Look for: and names what to look at in the viewer, such as a kink where the repair joins the captured frames. For a region to fix by hand, it is a plain instruction, such as Fill the open frames by hand. Why? opens the details behind the result, such as how far a fill moved the captured frames next to it. About this clean, further down, holds what is said about the clean as a whole, and Approve is at the bottom of the panel.

Each region under Needs your eyes takes one decision, in the panel on the right:

  • Accept (key A) means the region is fine as it is in the cleaned take.
  • Mark for hand fix (key H) means someone will fix it by hand. The export notes list these regions with their frame ranges.
  • Revert puts the captured frames back over the region. It is offered only where the cleanup changed something.

A decided region says Accepted as is, Marked for hand fix or Reverted to raw, in the list and in the panel. Hold the pointer over it to see who decided and when. Change takes the decision back. Decisions are saved for the whole workspace, so a colleague who opens the take sees them too. They belong to one Clean version: cleaning the take again starts every region of the new version undecided.

The heading of the list counts how many regions are checked, for example 1 of 3 checked, with a bar under it. After each decision, Post opens the next undecided region further down the list. It never jumps from the last region back to the first. When you open the take again, Post opens the first region you have not decided yet. [ and ] move to the previous or next region, and Space plays the take. A and H work only without Shift, Ctrl, Alt or Cmd. [ and ] also work with AltGr or Option, which some keyboard layouts need to type them. The keys do nothing while a dialog is open or while a text field or another button has keyboard focus. A region's own title in the list, the decision buttons in the panel, the group headings, Show all and the take switcher are the exception, so you can click a region and then press A or ]. [ and ] walk the list as it is shown: the regions under Needs your eyes first, then the ones under Repaired and verified while that group is open, then the ones under Left as captured. A region inside a folded run counts only while the run is shown. The keys stop at the first and the last region, and they never open a closed group. If you close the group that holds the selected region, ] goes on to the first region shown after that group and [ to the last region shown before it. The list scrolls so the selected region is in view below its group heading, outlined in dark purple. Previous take and Next take walk the takes in the order All takes lists them, and that order stays the same while you work, also when you reload the page in the same browser tab.

When every region is decided, the list says All regions checked and the keyboard focus moves to Approve Clean v2 at the bottom of the panel. Until then that button is disabled and says how many regions are left to check. Any member of the workspace may approve. Once approved, the take shows the Approved state on Data and Review, Export becomes the main button, and Undo approval takes the approval back, on Review, in the take's panel on Data and in the take's actions menu. Once every region of the newest Clean version is decided, the screens say All regions checked instead of counting regions that need eyes.

Decisions belong to the newest Clean version. When you keep the raw capture, or choose an earlier Clean version as the current one, there is nothing to decide: the take is not listed under Needs your eyes on Review, and its panel on Data says Raw capture kept or Clean v1 is the current version. Decisions apply to the newest clean. Once approved, such a take reads Approved as captured or Approved Clean v1. Cleaning the take again clears the approval. A take that arrived clean, with nothing to repair, can be approved as captured from its panel on Data, and so can a take whose current version is the raw capture or an earlier clean. You can export a take before it is approved: the export warns you about regions still to check and never blocks it.

Props ​

A prop is an object a performer handles during a take, such as a box, a staff or a rifle, tracked with markers of its own. Post repairs props as well as performers.

A prop does not bend, so Post first checks that it keeps its shape: the distances between its markers have to stay the same through the take. When they do, a missing prop marker is placed from the prop's other markers.

  • If at least 3 of the prop's other markers were visible on every frame of the gap, they fix the prop's position throughout the gap, and the card says so. Its model line reads Model · Rigid body. The placed marker is as close as the prop's rigidity check (1 cm) and the noise in the other markers allow, so the card does not call it exact. Sometimes the filled frames sit on the prop's rigid body, but the captured frames next to the gap still make a step where the fill meets them. The card then starts with that join and asks you to check it by eye, and the region is listed under Needs your eyes. The note about where the filled frames sit moves behind Details, because the step is in the captured frames and not in the fill.
  • If fewer than 3 were visible on some frames, Post interpolates the prop's pose across the gap. The card says so and asks you to check those frames by eye, and the region counts as still needing your eyes.
  • If the distances between the prop's markers change during the take, the prop is not rigid, so Post cannot place a marker from the others. The card says the prop is not rigid and what Post did instead: it filled the gap from that marker's own path, or it left the gap open.

Two prop markers that swapped labels are put back the same way as a performer's, and the card names the marker each one swapped with. Open Details on a prop's card to read the rigidity check behind it.

On the Diagnose and Review screens, each prop is drawn in the viewer in one neutral colour and listed beside the performers as Prop followed by its name, with its own count of regions. Its regions are listed under it, worst first. Points that belong to no performer and no prop, such as unlabelled markers or calibration clusters, are counted in one line of the list and are not repaired. The Projects screen and the Audit block on the Review screen say how many props a take has, how many of their regions were repaired and how many of their regions need your eyes, such as 6 props · 62 regions repaired · 20 need eyes. The two region counts are the same regions that are listed under Repaired and Needs your eyes on the Review screen.

Label breaks ​

Sometimes a group of a performer's markers swap labels at one frame and keep them for the rest of the take, for example the left and right arm. That is not a swap Post can safely undo, so it keeps those frames exactly as they were recorded. The region card reads Label break, held as recorded, says how many markers are involved and lists them under Details, so that you can fix the labels in your capture software. It has no score, and it counts as needing your eyes.

What Post does not do ​

  • It does not solve skeletons. Post is a marker-space cleaner, which means it corrects the marker cloud rather than the rig. A solved skeleton carried through an export is the one you uploaded, and it needs a re-solve in your own tool.
  • It does not invent capture that was never recorded. A performer who walked out of the capture volume, or a capture dropout, stays a hole. See Holes left open.
  • It does not convert formats on export yet. Use Keep original.
  • It does not overwrite your raw file, ever.

What to do next ​

New to the product? Walk the quick start end to end on one small take. Already running takes? Start with Cleanup forecast. It is the page that changes how you plan a day.

Ask us ​

Something looks wrong on a take? Write to support@kapnetix.ai and send the take id, or the take's name and the project it sits in.